跳至页脚内容
.NET 帮助

tye .NET(开发人员如何使用)

在现代软件开发领域,构建和部署分布式应用程序可能是复杂且具有挑战性的。 管理多个服务、依赖项和部署环境通常需要大量的努力和协调。 为了解决这些挑战,微软推出了Project Tye,这是一种开发者工具,旨在简化 .NET 应用程序的开发、测试和部署。 在本文中,我们将深入探讨Tye的世界,探索其功能、优势以及对 .NET 开发者的实际应用。 我们还将了解IronPDF,这是一款来自Iron Software的 PDF 生成库,并在实际示例中使用TyeIronPDF

理解 Project Tye .NET

Tye 是一个开源的实验性开发者工具,通过最少的配置简化 .NET 项目应用程序的构建、测试和部署过程。 由微软工程团队开发,Tye 旨在通过提供一致的、意见化的方法来简化开发工作流程,以管理微服务及其依赖。 在其核心,Tye 采用了容器化、编排和开发者生产力的原则,以实现无缝的应用程序开发和部署。

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 的实际应用

让我们探讨一些 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
SHELL

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
SHELL

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
SHELL

开始使用 Tye

开始使用 Tye:

  1. 在您的机器上安装 .NET Core 3.1(不支持更高版本)。

  2. 使用以下命令将 Tye 安装为全局工具:
dotnet tool install -g Microsoft.Tye --version "0.2.0-alpha.20258.3"
dotnet tool install -g Microsoft.Tye --version "0.2.0-alpha.20258.3"
SHELL
  1. 为您的微服务创建一个新文件夹。

  2. 导航到该文件夹并创建一个前端项目(例如,Razor Pages):
mkdir microservices
cd microservices
dotnet new razor -n frontend  # frontend service
mkdir microservices
cd microservices
dotnet new razor -n frontend  # frontend service
SHELL
  1. 运行前端项目,启动 Tye 仪表板:
tye run frontend  # run frontend project
tye run frontend  # run frontend project
SHELL

这将构建、运行并监控前端应用程序。 您可以通过http://localhost:8000访问Tye仪表板以查看您的服务状态。

Tye 的配置架构

Tye有一个可选的配置文件tye.yaml,允许定制设置。 这个 YAML 文件包括所有项目和外部依赖。 如果您有现有解决方案,Tye 将自动填充您当前的所有项目。

要初始化此YAML文件,导航到微服务目录并运行以下命令以生成默认的tye.yaml文件:

tye init
tye init
SHELL

会创建一个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
YAML

使用 Tye 的好处

  1. 简化的开发工作流程: Tye通过提供构建、本地测试和调试.NET应用程序的统一工具集简化了开发工作流程。
  2. 加速上市时间: 通过自动化常见任务,如服务发现、依赖管理和容器化,Tye减少了将应用程序部署到生产环境所需的时间和精力。
  3. 改善协作: Tye通过提供一个用于管理应用程序依赖项和部署配置的通用平台,促进开发、运维和DevOps团队之间的协作。
  4. 云原生准备: Tye为.NET应用程序配备了在Kubernetes等云原生环境中运行所需的工具和实践,使组织能够自信地接受现代基础设施模式。
  5. 社区支持与贡献: 作为一个由微软支持的开源项目,Tye受益于活跃的贡献者和用户社区,他们积极为其开发、文档和生态系统做出贡献。

Project Tye 许可证

Project Tye 附有 MIT 许可证,可免费用于开发和商业用途。

IronPDF 简介

tye .NET(对开发人员的工作原理):图1 - IronPDF for .NET:C# PDF库

IronPDF 是一个强大的 C# 库,旨在从 HTML、CSS、图像和 JavaScript 创建、编辑和签署 PDF。 它提供商业级性能,并具有低内存占用。

IronPDF 的主要功能

1. HTML到PDF转换

转换HTML文件、HTML字符串和URL为PDF。 例如,使用Chrome PDF渲染器将网页呈现为PDF。

2. 跨平台支持

兼容各种.NET平台,包括.NET Core、.NET Standard和.NET Framework。 它支持Windows、Linux和macOS。

3. 编辑和签署

设置属性,使用密码和权限增加安全性,并应用数字签名到您的PDF。

4. 页面模板和设置

通过页眉、页脚、页码和可调节边距自定义PDF。 支持响应式布局和自定义纸张大小。

5. 标准符合性

遵循PDF标准,如PDF/A和PDF/UA。 支持UTF-8字符编码,并处理图像、CSS和字体等资产。

现在让我们看一下使用这两个库的实际示例。

使用 IronPDF 生成 PDF 文档并通过 Tye 运行

首先,让我们创建一个 Visual Studio Razor 应用程序。 打开 Visual Studio,创建一个新项目并选择 Razor 应用,如下所示。

tye .NET(对开发人员的工作原理):图2 - 打开Visual Studio并创建一个新的ASP.NET Core Web App(Razor Pages)。

提供项目名称和位置。

tye .NET(开发者如何使用):图 3 - 通过指定项目名称和位置来配置项目。 然后点击下一步.

在下一个步骤中,选择 .NET Framework 版本并点击创建。 由于 Tye 仅适用于 .NET 3.1,我们将选择相同的版本。

tye .NET(对开发人员的工作原理):图4 - 选择.NET Core 3.1框架,然后单击创建。

tye .NET(开发者如何运作):图 5 - 使用解决方案管理 NuGet 包安装 IronPDF,搜索 IronPDF,然后选择项目并点击安装按钮。

tye .NET (How It Works For Developers): Figure 5 - Install IronPDF using the Manage NuGet Package for Solution by searching IronPDF in the search bar of NuGet Package Manager, then select the project and click on the Install button.

接下来,打开文件浏览器并导航到解决方案文件夹。 然后打开 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"
SHELL

使用以下命令初始化 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"
SHELL

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

tye init
tye init
SHELL

这将创建一个如下所示的模板 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
YAML

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

tye run frontend
tye run frontend
SHELL

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

tye .NET(开发者如何运作):图 6 - 使用 Tye 在本地主机运行的 Razor 应用程序

tye .NET(对开发人员的工作原理):图6 - 使用Tye在本地主机上运行Razor应用程序

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");
        }
    }
}
$vbLabelText   $csharpLabel

现在按如下方式运行 Tye:

tye .NET(对开发人员的工作原理):图7 - 使用命令运行tye:tye run frontend

tye .NET(开发者如何运作):图 8 - Tye 仪表板

tye .NET(对开发人员的工作原理):图8 - Tye仪表板

tye .NET(开发者如何运作):图 9 - 使用 IronPDF 的 URL 到 PDF 生成器

tye .NET(对开发人员的工作原理):图9 - 使用IronPDF的PDF生成器URL

tye .NET(开发者如何运作):图 10 - 使用 IronPDF 的 HTML URL 到 PDF 转换

tye .NET(对开发人员的工作原理):图10 - 使用IronPDF的HTML到PDF转换URL

代码说明

  1. Index.cshtml包含用于捕获网站URL并触发PDF生成的输入字段和按钮。
  2. Index.cshtml.cs是包含使用IronPDF生成PDF文档逻辑的后台代码文件。
  3. 使用RenderUrlAsPdf()方法从URL生成PDF。
  4. 生成的 URL 被作为 POST 方法的响应返回。
  5. tye run命令将启动Tye仪表板,您可以在其中查看所有正在运行的服务。
  6. 在 Tye 仪表板中点击前端服务以打开应用并生成 PDF 文档。

IronPDF 许可证

将许可证密钥放置在 appSettings.json 文件中,如下所示:

将许可证密钥放在如下所示的appSettings.json文件中:

{
  "IronPdf.License.LicenseKey": "The Key Here"
}

结论

无论您是经验丰富的 .NET 开发者,还是容器化和微服务的新手,Tye 都为您提供了一个用户友好的平台,以便采纳现代开发实践,加快您向云原生架构迈进的步伐。 IronPDF 是一个 .NET 库,允许开发者轻松地从 HTML 内容创建、操作和渲染 PDF 文档。

IronPDF 是一个.NET库,允许开发者轻松创建、操作和渲染基于HTML内容的PDF文档。 IronPDF 以使用方便、高质量渲染和与 .NET Core 和 .NET Framework 应用程序的兼容性而闻名。 了解IronPDF库和Tye构建工具,开发人员可以获得高级技能,以开发具有 PDF 生成能力的现代应用程序。 通过了解 IronPDF 库和 Tye 构建工具,开发人员可以获得开发具有 PDF 生成功能的现代应用程序的高级技能。

常见问题解答

Tye 可以如何简化 .NET 应用程序开发?

Tye 通过最少的配置管理微服务及其依赖项来简化 .NET 应用程序开发。它利用如 Docker 和 Kubernetes 的容器化和编排工具来简化构建、测试和部署过程。

使用 Tye 对于 .NET 应用程序的服务发现有什么好处?

Tye 增强了 .NET 应用程序中的服务发现功能,它通过自动检测微服务之间的依赖关系,使用项目元数据和 Docker 容器促进无缝通信和编排。

Tye 如何与 Visual Studio 和 Visual Studio Code 集成?

Tye 与 Visual Studio 和 Visual Studio Code 集成,为开发人员提供调试、日志记录和监控工具,从而提升 .NET 应用程序的开发体验和生产力。

如何与 Tye 配合使用 Docker 容器?

Tye 使用 Docker 容器来部署 .NET 应用程序。它根据项目设置自动为每个服务创建 Docker 文件,确保容器构建在不同环境中保持一致和可复现。

使用 Tye 将 .NET 应用程序部署到 Kubernetes 的步骤是什么?

要使用 Tye 将 .NET 应用程序部署到 Kubernetes,工具会从项目规范生成 Kubernetes 清单和 Helm 图表。通过自动化创建 Kubernetes 集群所需的资源,简化了部署过程。

IronPDF 如何通过 PDF 功能增强 .NET 应用程序?

IronPDF 通过提供创建、操作和渲染来自 HTML 内容的 PDF 的能力来增强 .NET 应用程序。它支持 HTML 到 PDF 转换、PDF 编辑和添加页眉页脚等元素,从而扩展了应用程序的功能。

是什么使 Tye 适合云原生应用程序开发?

Tye 适用于云原生应用程序开发,因为它为 .NET 应用程序提供了在 Kubernetes 等环境中运行的必要工具和做法,促进了现代基础设施和部署模式的采用。

开发人员如何快速使用 Tye 开始工作?

开发人员可以通过安装 .NET Core 3.1、将 Tye 设置为全局工具并使用tye run之类的命令来开始使用 Tye。Tye 的仪表板有助于高效监控和管理服务。

使用 Project Tye 适用哪些许可条款?

Project Tye 在 MIT 许可下分发,允许免费用于开发和商业目的,促进了在各种项目中的广泛采用。

Tye 如何促进 .NET 应用程序更快的上市时间?

Tye 通过自动化常见开发任务、改善团队协作以及增强云原生准备性来加速上市时间,这共同简化了开发工作流程并减少了开销。

Jacob Mellor,Team Iron 的首席技术官
首席技术官

Jacob Mellor 是 Iron Software 的首席技术官,也是一位开创 C# PDF 技术的有远见的工程师。作为 Iron Software 核心代码库的原始开发者,他从公司成立之初就开始塑造公司的产品架构,与首席执行官 Cameron Rimington 一起将公司转变为一家拥有 50 多名员工的公司,为 NASA、特斯拉和全球政府机构提供服务。

Jacob 拥有曼彻斯特大学土木工程一级荣誉工程学士学位(BEng)(1998-2001 年)。他的旗舰产品 IronPDF 和 Iron Suite for .NET 库在全球的 NuGet 安装量已超过 3000 万次,其基础代码继续为全球使用的开发人员工具提供动力。Jacob 拥有 25 年的商业经验和 41 年的编码专业知识,他一直专注于推动企业级 C#、Java 和 Python PDF 技术的创新,同时指导下一代技术领导者。

Iron Support Team

We're online 24 hours, 5 days a week.
Chat
Email
Call Me