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

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

Tye, .NET uygulaması içindeki hizmetler arasındaki bağımlılıkları otomatik olarak algılar ve yönetir. Hizmet ilişkilerini çıkarsamak için proje meta verilerini ve Docker konteynerlerini kullanır, böylece mikro servisler arasında iletişim ve orkestrasyonu koordine etmeyi daha kolay hale getirir. Bu, birden fazla proje ile mikro servisler geliştirirken işleri kolaylaştırır.

2. Entegre Geliştirme Deneyimi

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

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

Tye, .NET uygulamalarının dağıtım birimi olarak Docker konteynerlerini benimser. Proje yapılandırmalarına dayanarak her hizmet için Dockerfile'ları otomatik olarak oluşturur, geliştirme ve üretim ortamları arasında tutarlı ve yeniden üretilebilir konteynerler oluşturmayı kolaylaştırır, mikro servislerin test edilmesi ve dağıtılmasını kolaylaştırır.

4. Yerel Geliştirme Ortamı

Tye, bağımlılıkları ve hizmetleri tek bir ortamda düzenleyerek yerel geliştirme sürecini basitleştirir. Geliştiriciler, tüm uygulama yığınını tek bir komutla çalıştırabilir ve bağımlılıkların manuel olarak ayarlanması ve yapılandırılması ihtiyacını 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 özelliklerine göre Kubernetes manifestleri ve Helm chart'ları üreterek dağıtım sürecini kolaylaştırır ve bulut yerli ortamlarda konteyner orkestrasyonu için en iyi uygulamaları teşvik eder.

6. İzleme ve Görselleştirilebilirlik

Tye, Prometheus ve Grafana gibi popüler izleme araçları ile entegre olarak uygulama performansı ve sağlığı hakkında bilgi sağlar. Uygulama bileşenlerinden metrikler ve günlükler alarak kaynak kullanımı izleme, darboğazları belirleme ve sorunları gerçek zamanlı olarak teşhis etme imkanı sağlar.

Tye'nin .NET uygulama geliştirme ve dağıtımını nasıl kolaylaştırabileceği konusunda bazı pratik senaryoları inceleyelim:

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ırma

# 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, ayarların özelleştirilmesine izin veren, özelleştirilebilir bir tye.yaml yapılandırma dosyasına sahiptir. Bu YAML dosyası, tüm projelerinizi ve dış bağımlılıklarınızı içerir. Eğer mevcut bir çözümünüz varsa, Tye otomatik olarak mevcut projelerinizle dolduracaktır.

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

tye init

tye init

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

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'nin Ana Özellikleri

Öncelikle, 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 sadece .NET 3.1'de çalıştığı için aynı sürümü seçeceğiz.

IronPDF'i NuGet Paketi Visual Studio Paket Yöneticisinden yükleyin.

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

Tye'ı şu komutla 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 Tye zaten yüklüyse ve onu 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"

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

tye init

tye init

Bu aşağıda gösterildiği gibi bir taslak 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

Tye'ı şu komutla çalıştırın:

tye run frontend

tye run frontend

Çalışan uygulamayı görmek için URL: http://127.0.0.1:8000/ adresinde Tye kontrol paneli açılacaktır.

Tye Panosu

Bir sonraki adımda, bir düğmeye tıklamayla herhangi bir web sitesi URL'sinden bir PDF belgesi oluşturmak için aşağıdaki kodu projeye 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>

Ardından 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ğıdaki gibi çalıştırın:

Bu, Tye panosunu başlatacaktır.

Şimdi bağlayıcılar bölümündeki herhangi bir bağlantıya tıklayarak PDF üretici uygulamasını açın ve PDF oluşturma için bir örnek URL girin.

PDF çıktısını almak için üret düğmesine tıklayın:

Kod Açıklaması

1. Index.cshtml, web sitesi URL'sini yakalamak ve PDF oluşturumunu başlatmak için giriş alanı ve butonu içerir.
2. Index.cshtml.cs, IronPDF kullanarak PDF belgesini oluşturmak için gerekli mantığı içeren kod-arkası dosyasıdır.
3. URL'den PDF üretmek için ChromePdfRenderer sınıfı ve RenderUrlAsPdf() metodu kullanılır.
4. Üretilen URL, POST metoduna yanıt olarak döner.
5. tye run komutu, tüm çalışan servisleri görüntüleyebileceğiniz Tye kontrol panelini başlatacaktır.
6. PDF belgelerini oluşturmak için Tye panosunda Ön Uç hizmetine tıklayın.