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 套件管理器中安裝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");
        }
    }
}

現在如下所示運行 Tye：

這將啟動 Tye 儀表板。

現在單擊綁定部分的任何鏈接以打開 PDF 生成器應用程式並輸入用於 PDF 生成的示例 URL。

點擊生成按鈕以獲取以下 PDF 作為輸出：

代碼解釋

1. Index.cshtml 包含輸入字段和按鈕，用於捕捉網站 URL 並觸發 PDF 生成。
2. Index.cshtml.cs 是包含使用 IronPDF 生成 PDF 文件邏輯的後台代碼文件。
3. ChromePdfRenderer 類和 RenderUrlAsPdf() 方法用於從 URL 生成 PDF。
4. 生成的 URL 作為 POST 方法的響應返回。
5. tye run 命令將啟動 Tye 儀表板，您可以在那裡查看所有運行中的服務。
6. 單擊 Tye 儀表板中的前端服務以打開應用程式並生成 PDF 文件。