tye .NET (How It Works For Developers)

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 文件，請導航至 microservices 目錄並執行以下命令以產生預設的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 應用，如下所示。

! tye .NET（開發人員的工作方式）：圖 2 - 開啟 Visual Studio 並建立一個新的 ASP.NET Core Web 應用程式（Razor Pages）。

請提供項目名稱和地點。

![tye .NET（開發人員的工作方式）：圖 3 - 透過指定專案名稱和位置來配置專案。 然後點選"下一步"。

下一步，選擇 .NET Framework 版本，然後按一下"建立"。 由於 Tye 只能在 .NET 3.1 上運行，因此我們將選擇 .NET 3.1。

! tye .NET（開發人員的工作方式）：圖 4 - 選擇 .NET Core 3.1 框架，然後按一下"建立"。

透過 Visual Studio 套件管理器從 NuGet 套件安裝 IronPDF 。

! tye .NET（開發人員的操作方法）：圖 5 - 使用 NuGet 套件管理員的搜尋列中搜尋"IronPDF"，然後選擇專案並點擊"安裝"按鈕，即可透過"管理解決方案的 NuGet 套件"安裝 IronPDF。

接下來，打開文件瀏覽器並導航到解決方案資料夾。 然後打開命令提示字元。

使用以下指令安裝 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 儀表板

! tye .NET（開發者使用方法）：圖 6 - 使用 Tye 在本機上執行的 Razor 應用程式

接下來，將以下程式碼新增至專案中，只需點擊一個按鈕即可從任何網站 URL 產生 PDF 文件。

將以下程式碼加入Index.cshtml檔案：

@page
@model IndexModel
@{
    ViewData["Title"] = "Generate PDF";
}
<form method="post" class="text-center flex-row">
    <h1>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 .NET（開發者使用指南）：圖 7 - 使用指令執行 tye：tye run frontend

這將啟動 Tye 控制面板。

Tye .NET（開發者使用指南）：圖 8 - Tye 控制面板

現在點擊綁定部分中的任何鏈接，打開 PDF 生成器應用程序，然後輸入示例 URL 以生成 PDF。

! tye .NET（開發者使用方法）：圖 9 - 使用 IronPDF 的 PDF 產生器 URL

點擊生成按鈕，即可取得以下 PDF 輸出檔：

! tye .NET（開發者使用方法）：圖 10 - 使用 IronPDF 將 HTML 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 文件。