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 manifests 和 Helm charts，简化了部署过程，并促进了云原生环境中容器编排的最佳实践。

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"

这将创建一个模板 YAML 文件如下所示：

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

这将在 URL：http://127.0.0.1:8000/ 打开 Tye 仪表板以查看运行中的应用程序。

tye run frontend

tye run frontend

Tye 仪表板

向 Index.cshtml 文件添加以下代码：

将以下代码添加到 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：

代码解释

代码说明

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 文档。