tye .NET（對於開發者的運行原理）

1.服務發現與依賴性管理

Tye 可自動偵測並管理 .NET 應用程式內服務間的依賴關係。 它利用專案元資料和 Docker 容器來推斷服務關係，讓微服務之間的溝通和協調變得更容易。 這可讓多專案的微服務開發變得更容易。

2.整合開發經驗

Tye 可與 Visual Studio 和 Visual Studio Code 無縫整合，為 .NET 開發人員提供熟悉的開發環境。 它提供了調試、日誌和監控應用程式元件的工具，能夠在開發過程中快速迭代和排除故障。

3.Docker 容器化

Tye 接受 Docker 容器作為 .NET 應用程式的部署單位。 它會根據專案組態自動為每個服務產生 Dockerfile，促進開發和生產環境中一致且可重複的容器建置，讓微服務的測試和部署變得更容易。

4.本地開發環境

Tye 透過在單一環境中協調相依性和服務，簡化了本機開發。 開發人員只需一條指令即可啟動整個應用程式堆疊，無需手動設定相依性。

5.部署至 Kubernetes

Tye 提供內建支援，可將 .NET 應用程式部署至 Kubernetes 叢集。 它可根據專案規格產生 Kubernetes 艙單和 Helm 圖表，簡化部署流程，並推廣雲端原生環境中容器協調的最佳實務。

6.監控與可觀察性

Tye 與 Prometheus 和 Grafana 等流行的可觀察性工具整合，提供應用程式效能與健康狀況的深入分析。 它揭露應用程式元件的指標和日誌，讓開發人員能夠即時監控資源利用率、找出瓶頸並診斷問題。

讓我們來探討一些 Tye 可以簡化 .NET 應用程式開發與部署的實際情境：

1.本地開發環境

# 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 容器化

# 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

# 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 的組態模式

Tye 有一個可選的設定檔 tye.yaml，允許自訂設定。 此 YAML 檔案包含所有專案和外部相依性。 如果您有現有的解決方案，Tye 會自動將您目前所有的專案填入其中。

若要初始化此 YAML 文件，請導航至微服務目錄並執行以下命令以產生預設的 tye.yaml 檔案：

tye init

tye init

如下所示，將建立一個 tye.yaml 檔案：

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 的主要功能

首先，讓我們建立一個 Visual Studio Razor 應用程式。 開啟 Visual Studio 並建立新專案，選擇 Razor 應用程式，如下所示。

提供專案名稱和地點。

在下一步中，選擇 .NET Framework 版本，然後按一下建立。 由於 Tye 只在 .NET 3.1 上運作，因此我們將選擇相同的版本。

從 Visual Studio Package Manager 安裝 IronPDF from NuGet Package。

接下來，開啟檔案瀏覽器並導航至解決方案資料夾。 然後開啟 CMD 提示。

使用下列指令安裝 Tye：

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"

或者，如果您已經安裝了 Tye 並想要更新，請使用以下指令：

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：

tye init

tye init

這將創建一個模板 YAML 檔案，如下所示：

# 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：

tye run frontend

tye run frontend

這將在 URL: http://127.0.0.1:8000/ 開啟 Tye 控制面板，以查看應用程式的運作情況。

Tye儀表板

接下來，將以下程式碼加入專案中，只要按一下按鈕，就能從任何網站的 URL 產生 PDF 文件。

將以下程式碼加入 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>

然後將以下程式碼加入 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

現在執行 Tye，如下所示：

這將啟動 Tye 面板。

現在按一下綁定部分中的任何連結，即可開啟 PDF 生成器應用程式，並輸入範例 URL 以生成 PDF。

按一下產生按鈕以獲得以下 PDF 輸出：

程式碼解釋

1. Index.cshtml 包含用於擷取網站 URL 並觸發 PDF 產生的輸入欄位和按鈕。
2. Index.cshtml.cs 是包含使用 IronPDF 產生 PDF 文件邏輯的程式碼隱藏檔案。
3. 使用 ChromePdfRenderer 類別和 RenderUrlAsPdf() 方法從 URL 產生 PDF。 4.生成的 URL 會作為 POST 方法的回應傳回。
4. 使用 tye run 指令將啟動 Tye 控制面板，您可以在其中查看所有正在執行的服務。 6.點選 Tye 面板中的 Frontend 服務，開啟應用程式並產生 PDF 文件。