tye .NET (Geliştiriciler İçin Nasıl Çalışır)

1. Hizmet Keşfi ve Bağımlılık Yönetimi

Tye, bir .NET uygulaması içindeki hizmetler arasındaki bağımlılıkları otomatik olarak algılar ve yönetir. Proje meta verilerini ve Docker kapsayıcılarını kullanarak hizmet ilişkilerini çıkarır, mikro hizmetler arasındaki iletişimi ve orkestrasyonu koordine etmeyi kolaylaştırır. Bu, birden fazla projeyle mikro hizmetleri geliştirmeyi kolaylaştırır.

2. Entegre Geliştirme Deneyimi

Tye, .NET geliştiricilerine tanıdık bir geliştirme ortamı sağlayarak Visual Studio ve Visual Studio Code ile sorunsuz bir şekilde entegre olur. Geliştirme sırasında hızlı yineleme ve hata ayıklama sağlamak için uygulama bileşenleri için hata ayıklama, günlüğe kaydetme ve izleme araçları sunar.

3. Docker Kapsayıcılaştırması

Tye, .NET uygulamalarının dağıtım birimi olarak Docker kapsayıcılarını benimser. Proje yapılandırmaları temelinde her hizmet için Dockerfile'lar otomatik olarak oluşturur, geliştirme ve üretim ortamları arasında tutarlı ve tekrarlanabilir kapsayıcı yerleşimlerini kolaylaştırır, test etmeyi ve mikro hizmetleri dağıtmayı kolaylaştırır.

4. Yerel Geliştirme Ortamı

Tye, tek bir ortamda bağımlılıkları ve hizmetleri organize ederek yerel geliştirmeyi basitleştirir. Geliştiriciler tüm uygulama yığınını tek bir komutla başlatabilir, bağımlılıkların elle kurulum ve yapılandırma gerekliliğini ortadan kaldırır.

5. Kubernetes'e Dağıtım

Tye, .NET uygulamalarını Kubernetes kümelerine dağıtmak için yerleşik destek sağlar. Proje özellikleri temelinde Kubernetes manifestoları ve Helm tabloları oluşturur, dağıtım sürecini basitleştirir ve bulut tabanlı ortamlar için kapsayıcı orkestrasyonunun en iyi uygulamalarını teşvik eder.

6. İzleme ve Görselleştirme

Tye, Prometheus ve Grafana gibi popüler izleme araçlarıyla entegre olarak uygulama performansı ve sağlığı hakkında içgörü sağlar. Uygulama bileşenlerinden metrikler ve günlükler sağlar, geliştiricilerin kaynak kullanımını izlemelerini, darboğazları tanımlamalarını ve sorunları gerçek zamanlı olarak teşhis etmelerini sağlar.

Tye'nın .NET uygulama geliştirme ve dağıtımını nasıl kolaylaştırabileceği üzerine bazı pratik senaryoları keşfedelim:

1. Yerel Geliştirme Ortamı

# 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. Docker Kapsayıcılaştırması

# 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. Kubernetes'e Dağıtım

# 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

Tye'ın Yapılandırma Şeması

Tye'nin ayarların özelleştirilmesine izin veren isteğe bağlı bir yapılandırma dosyası olan tye.yaml vardır. Bu YAML dosyası, tüm projelerinizi ve harici bağımlılıklarınızı içerir. Mevcut bir çözümünüz varsa, Tye tüm geçerli projelerinizle otomatik olarak dolduracaktır.

Bu YAML dosyasını başlatmak için mikro hizmetler dizinine gidin ve varsayılan bir tye.yaml dosyası oluşturmak için aşağıdaki komutu çalıştırın:

tye init

tye init

Aşağıda gösterildiği gibi bir tye.yaml dosyası oluşturulur:

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

IronPDF'in Temel Özellikleri

Önce bir Visual Studio Razor uygulaması oluşturalım. Visual Studio'yu açın, yeni bir proje oluşturun ve aşağıda gösterildiği gibi Razor uygulamasını seçin.

Proje adını ve konumunu sağlayın.

Bir sonraki adımda, .NET Framework sürümünü seçin ve Oluştur'a tıklayın. Tye yalnızca .NET 3.1'de çalıştığı için aynı sürümü seçeceğiz.

Visual Studio Paket Yöneticisi'nden NuGet Paketi'nden IronPDF'i kurun.

Sonra, Dosya Tarayıcısını açın ve çözüm klasörüne gidin. Ardından CMD istemcisini açın.

Tye'ı aşağıdaki komutu kullanarak yükleyin:

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"

VEYA zaten Tye'ınız varsa ve güncellemek istiyorsanız aşağıdaki komutu kullanın:

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"

Aşağıdaki komutu kullanarak Tye'ı başlatın:

tye init

tye init

Bu, aşağıda gösterildiği gibi bir şablon YAML dosyası oluşturacaktır:

# 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

Aşağıdaki komutu kullanarak Tye'ı çalıştırın:

tye run frontend

tye run frontend

Uygulamanın çalıştığını görmek için http://127.0.0.1:8000/ adresindeki Tye kontrol paneli açılacaktır.

Tye Pano

Bir web sitesi URL'sinden bir PDF belgesi oluşturmak için projeye aşağıdaki kodu ekleyin.

Aşağıdaki kodu Index.cshtml dosyasına ekleyin:

@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>

Sonra aşağıdaki kodu Index.cshtml.cs dosyasına ekleyin:

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

Şimdi Tye'ı aşağıda gösterildiği gibi çalıştırın:

Bu, Tye panosunu başlatacaktır.

PDF oluşturucu uygulamasını açmak ve örnek bir PDF üretimi URL'si girmek için bağlantılar bölümündeki herhangi bir bağlantıya tıklayın.

PDF'i çıktı olarak almak için oluştur düğmesine tıklayın:

Kod Açıklaması

1. Index.cshtml alanı, web sitesi URL'sini yakalamak ve PDF oluşturma işlemini başlatmak için giriş alanı ve düğmeyi içerir.
2. Index.cshtml.cs dosyası, IronPDF kullanarak PDF belgesini oluşturmak için gerekli mantığı içeren kodun arka plan dosyasıdır.
3. URL'den PDF oluşturmak için ChromePdfRenderer sınıfı ve RenderUrlAsPdf() yöntemi kullanılır.
4. Oluşturulan URL, POST metoduna yanıt olarak döner.
5. tye run komutu, tüm çalışan hizmetlerinizi görebileceğiniz Tye kontrol panelini başlatır.
6. Uygulamayı açmak ve PDF dökümanlarını oluşturmak için Tye kontrol panelindeki Frontend servisine tıklayın.