tye .NET (Jak to działa dla programistów)

1. Wykrywanie usług i zarządzanie zależnościami

Tye automatycznie wykrywa i zarządza zależnościami między usługami w ramach aplikacji .NET. Wykorzystuje metadane projektu i kontenery Docker do wnioskowania o relacjach między usługami, ułatwiając koordynację komunikacji i orkiestracji między mikrousługami. Ułatwia to tworzenie mikrousług w ramach wielu projektów.

2. Zintegrowane środowisko programistyczne

Tye płynnie integruje się z Visual Studio i Visual Studio Code, zapewniając znane środowisko programistyczne dla programistów .NET. Oferuje narzędzia do debugowania, rejestrowania i monitorowania komponentów aplikacji, umożliwiając szybką iterację i rozwiązywanie problemów podczas tworzenia oprogramowania.

3. Konteneryzacja Docker

Tye wykorzystuje kontenery Docker jako jednostkę wdrażania aplikacji .NET. Automatycznie generuje pliki Dockerfile dla każdej usługi na podstawie konfiguracji projektu, ułatwiając spójne i powtarzalne tworzenie kontenerów w środowiskach programistycznych i produkcyjnych, co ułatwia testowanie i wdrażanie mikrousług.

4. Lokalne środowisko programistyczne

Tye upraszcza lokalny rozwój oprogramowania poprzez koordynację zależności i usług w ramach jednego środowiska. Programiści mogą uruchomić cały stos aplikacji za pomocą jednego polecenia, co eliminuje konieczność ręcznej instalacji i konfiguracji zależności.

5. Wdrożenie w Kubernetes

Tye zapewnia wbudowaną obsługę wdrażania aplikacji .NET w klastrach Kubernetes. Generuje manifesty Kubernetes i wykresy Helm na podstawie specyfikacji projektu, usprawniając proces wdrażania i promując najlepsze praktyki w zakresie orkiestracji kontenerów w środowiskach natywnych dla chmury.

6. Monitorowanie i obserwowalność

Tye integruje się z popularnymi narzędziami do monitorowania, takimi jak Prometheus i Grafana, aby zapewnić wgląd w wydajność i stan aplikacji. Udostępnia metryki i logi z komponentów aplikacji, umożliwiając programistom monitorowanie wykorzystania zasobów, identyfikowanie wąskich gardeł i diagnozowanie problemów w czasie rzeczywistym.

Przyjrzyjmy się kilku praktycznym scenariuszom, w których Tye może usprawnić tworzenie i wdrażanie aplikacji .NET:

1. Lokalne środowisko programistyczne

# Start Tye in local development mode with the tye run command
tye run

# Start Tye in local development mode with the tye run command
tye run

2. Konteneryzacja Docker

# Build Docker images for Tye services with the available solution file
tye build

# Build Docker images for Tye services with the available solution file
tye build

3. Wdrożenie w Kubernetes

# Deploy Tye application to Kubernetes cluster 
tye deploy --interactive # deploy microservices and distributed applications

# Deploy Tye application to Kubernetes cluster 
tye deploy --interactive # deploy microservices and distributed applications

Schemat konfiguracji Tye'a

Tye posiada opcjonalny plik konfiguracyjny, tye.yaml, który umożliwia dostosowanie ustawień. Ten plik YAML zawiera wszystkie Twoje projekty i zależności zewnętrzne. Jeśli posiadasz już istniejące rozwiązanie, Tye automatycznie wypełni je wszystkimi Twoimi bieżącymi projektami.

Aby zainicjować ten plik YAML, przejdź do katalogu microservices i uruchom następujące polecenie, aby wygenerować domyślny plik tye.yaml:

tye init

tye init

Plik tye.yaml jest tworzony w sposób pokazany poniżej:

name: myawesomeapplication
services:
- name: backendtest
  project: backend/backend.csproj
  bindings:
  - port: 7000
- name: frontendtest
  project: frontend/frontend.csproj
  replicas: 2
  bindings:
  - port: 8000
- name: workertest
  project: worker/worker.csproj
- name: rabbit
  image: rabbitmq:3-management
  bindings:
    - port: 5672
      protocol: rabbitmq

name: myawesomeapplication
services:
- name: backendtest
  project: backend/backend.csproj
  bindings:
  - port: 7000
- name: frontendtest
  project: frontend/frontend.csproj
  replicas: 2
  bindings:
  - port: 8000
- name: workertest
  project: worker/worker.csproj
- name: rabbit
  image: rabbitmq:3-management
  bindings:
    - port: 5672
      protocol: rabbitmq

Najważniejsze cechy IronPDF

Najpierw utwórzmy aplikację Visual Studio Razor. Otwórz program Visual Studio, utwórz nowy projekt i wybierz aplikację Razor, jak pokazano poniżej.

Podaj nazwę projektu i lokalizację.

W następnym kroku wybierz wersję .NET Framework i kliknij przycisk Utwórz. Ponieważ Tye działa wyłącznie na platformie .NET 3.1, wybierzemy tę wersję.

Zainstaluj IronPDF z pakietu NuGet za pomocą menedżera pakietów Visual Studio.

Następnie otwórz przeglądarkę plików i przejdź do folderu rozwiązania. Następnie otwórz wiersz poleceń CMD.

Zainstaluj Tye za pomocą następującego polecenia:

dotnet tool install -g Microsoft.Tye --version "0.11.0-alpha.22111.1"

dotnet tool install -g Microsoft.Tye --version "0.11.0-alpha.22111.1"

LUB jeśli masz już zainstalowany Tye i chcesz go zaktualizować, użyj poniższego polecenia:

dotnet tool update -g Microsoft.Tye --version "0.11.0-alpha.22111.1"

dotnet tool update -g Microsoft.Tye --version "0.11.0-alpha.22111.1"

Zainicjuj Tye za pomocą następującego polecenia:

tye init

tye init

Spowoduje to utworzenie pliku szablonu YAML, jak poniżej:

# tye application configuration file
# read all about it at https://github.com/dotnet/tye
#
# when you've given us a try, we'd love to know what you think:
#    https://aka.ms/AA7q20u
#
# define global settings here
# name: exampleapp # application name
# registry: exampleuser # dockerhub username or container registry hostname
# define multiple services here
services:
- name: frontend
  project: Frontend\Frontend.csproj # msbuild project path (relative to this file)
  # executable: app.exe # path to an executable (relative to this file)
    args: -f=netcoreapp3.1 # arguments to pass to the process
  # replicas: 5 # number of times to launch the application
  # env: # array of environment variables
  #  - name: key
  #    value: value
  # bindings: # optional array of bindings (ports, connection strings)
    # - port: 8080 # number port of the binding

# tye application configuration file
# read all about it at https://github.com/dotnet/tye
#
# when you've given us a try, we'd love to know what you think:
#    https://aka.ms/AA7q20u
#
# define global settings here
# name: exampleapp # application name
# registry: exampleuser # dockerhub username or container registry hostname
# define multiple services here
services:
- name: frontend
  project: Frontend\Frontend.csproj # msbuild project path (relative to this file)
  # executable: app.exe # path to an executable (relative to this file)
    args: -f=netcoreapp3.1 # arguments to pass to the process
  # replicas: 5 # number of times to launch the application
  # env: # array of environment variables
  #  - name: key
  #    value: value
  # bindings: # optional array of bindings (ports, connection strings)
    # - port: 8080 # number port of the binding

Uruchom Tye za pomocą następującego polecenia:

tye run frontend

tye run frontend

Spowoduje to otwarcie pulpitu nawigacyjnego Tye pod adresem URL: http://127.0.0.1:8000/, gdzie będzie można zobaczyć działającą aplikację.

Pulpit nawigacyjny Tye

Następnie dodaj poniższy kod do projektu, aby jednym kliknięciem wygenerować dokument PDF z dowolnego adresu URL strony internetowej.

Dodaj poniższy kod do pliku Index.cshtml:

@page
@model IndexModel
@{
    ViewData["Title"] = "Generate PDF";
}
<form method="post" class="text-center flex-row">
    <h1 class="display-4">Welcome To URL To PDF Generator</h1>
    <p>Enter Website URL:</p>
    <input type="text" asp-for="UrlInput" />
    <button type="submit">Generate PDF</button>
    @if (Model.Message != null)
    {
        <p>@Model.Message</p>
    }
</form>

Następnie dodaj poniższy kod do Index.cshtml.cs:

using IronPdf;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;
using Microsoft.Extensions.Logging;

namespace Frontend.Pages
{
    public class IndexModel : PageModel
    {
        public string Message { get; set; }

        [BindProperty]
        public string UrlInput { get; set; }

        private readonly ILogger<IndexModel> _logger;

        public IndexModel(ILogger<IndexModel> logger)
        {
            _logger = logger;
        }

        public void OnGet()
        {
        }

        public IActionResult OnPost()
        {
            if (string.IsNullOrEmpty(UrlInput))
            {
                ModelState.AddModelError("UrlInput", "Please enter a URL.");
                return Page();
            }

            // Create a PDF from the given URL using ChromePdfRenderer
            var renderer = new ChromePdfRenderer();
            var pdf = renderer.RenderUrlAsPdf(UrlInput);

            // Return the PDF as a file result
            var pdfBytes = pdf.BinaryData;
            return File(pdfBytes, "application/pdf", "GeneratedDocument.pdf");
        }
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;
using Microsoft.Extensions.Logging;

namespace Frontend.Pages
{
    public class IndexModel : PageModel
    {
        public string Message { get; set; }

        [BindProperty]
        public string UrlInput { get; set; }

        private readonly ILogger<IndexModel> _logger;

        public IndexModel(ILogger<IndexModel> logger)
        {
            _logger = logger;
        }

        public void OnGet()
        {
        }

        public IActionResult OnPost()
        {
            if (string.IsNullOrEmpty(UrlInput))
            {
                ModelState.AddModelError("UrlInput", "Please enter a URL.");
                return Page();
            }

            // Create a PDF from the given URL using ChromePdfRenderer
            var renderer = new ChromePdfRenderer();
            var pdf = renderer.RenderUrlAsPdf(UrlInput);

            // Return the PDF as a file result
            var pdfBytes = pdf.BinaryData;
            return File(pdfBytes, "application/pdf", "GeneratedDocument.pdf");
        }
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc
Imports Microsoft.AspNetCore.Mvc.RazorPages
Imports Microsoft.Extensions.Logging

Namespace Frontend.Pages
	Public Class IndexModel
		Inherits PageModel

		Public Property Message() As String

		<BindProperty>
		Public Property UrlInput() As String

		Private ReadOnly _logger As ILogger(Of IndexModel)

		Public Sub New(ByVal logger As ILogger(Of IndexModel))
			_logger = logger
		End Sub

		Public Sub OnGet()
		End Sub

		Public Function OnPost() As IActionResult
			If String.IsNullOrEmpty(UrlInput) Then
				ModelState.AddModelError("UrlInput", "Please enter a URL.")
				Return Page()
			End If

			' Create a PDF from the given URL using ChromePdfRenderer
			Dim renderer = New ChromePdfRenderer()
			Dim pdf = renderer.RenderUrlAsPdf(UrlInput)

			' Return the PDF as a file result
			Dim pdfBytes = pdf.BinaryData
			Return File(pdfBytes, "application/pdf", "GeneratedDocument.pdf")
		End Function
	End Class
End Namespace

Teraz uruchom Tye w następujący sposób:

Spowoduje to uruchomienie pulpitu nawigacyjnego Tye.

Teraz kliknij dowolny link w sekcji powiązań, aby otworzyć aplikację do generowania plików PDF i wprowadź przykładowy adres URL w celu wygenerowania pliku PDF.

Kliknij przycisk generowania, aby uzyskać następujący plik PDF jako wynik:

Wyjaśnienie kodu

1. Index.cshtml zawiera pole wprowadzania danych i przycisk służący do pobrania adresu URL strony internetowej i uruchomienia generowania pliku PDF.
2. Index.cshtml.cs to plik kodu źródłowego zawierający logikę generowania dokumentu PDF przy użyciu IronPDF.
3. Klasa ChromePdfRenderer i metoda RenderUrlAsPdf() służą do generowania pliku PDF na podstawie adresu URL.
4. Wygenerowany adres URL jest zwracany jako odpowiedź na metodę POST.
5. Polecenie tye run uruchomi pulpit nawigacyjny Tye, na którym można wyświetlić wszystkie uruchomione usługi.
6. Kliknij usługę Frontend na pulpicie nawigacyjnym Tye, aby otworzyć aplikację i wygenerować dokumenty PDF.