tye .NET（開発者向けの動作方法）

1. サービス発見と依存関係管理

Tyeは自動的に.NETアプリケーション内のサービス間の依存関係を検出し、管理します。 プロジェクトメタデータとDockerコンテナを活用してサービスの関係を推測し、マイクロサービス間の通信とオーケストレーションを調整しやすくします。 これにより、複数のプロジェクトを持つマイクロサービスの開発が容易になります。

2. 統合された開発体験

TyeはVisual StudioおよびVisual Studio Codeとシームレスに統合され、.NET開発者にとって馴染みのある開発環境を提供します。 開発中の迅速な反復とトラブルシューティングを可能にするため、デバッグ、ログ記録、アプリケーションコンポーネントの監視用のツールを提供します。

3. Dockerコンテナ化

Tyeは、.NETアプリケーションのデプロイメント単位としてDockerコンテナを採用しています。 プロジェクトの構成に基づいて各サービスの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のバージョンを選択し、作成をクリックします。

Visual StudioパッケージマネージャーからNuGetパッケージIronPDFをインストールします。

次に、CMDプロンプトを開きます。 次に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

次のコマンドを使用してTyeを実行します：

# 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

これにより、URLhttp://127.0.0.1:8000/でTyeダッシュボードが開き、アプリの実行状況を確認できます。

tye run frontend

tye run frontend

Tyeダッシュボード

Index.cshtmlファイルに以下のコードを追加します：

Index.cshtml.csには次のコードを追加します：

@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生成アプリを開き、PDF生成のためのサンプルURLを入力します。

生成ボタンをクリックして、次のPDFを出力として取得します：

コードの説明

1. Index.cshtmlには、ウェブサイトのURLをキャプチャしPDF生成をトリガーするための入力フィールドとボタンが含まれています。
2. Index.cshtml.csは、IronPDFを使用してPDF文書を生成するロジックを含むコードビハインドファイルです。
3. ChromePdfRendererクラスとRenderUrlAsPdf()メソッドがURLからPDFを生成するために使用されます。
4. コマンドtye runは、すべての実行中のサービスを確認できるTyeダッシュボードを起動します。
5. tye runコマンドは、実行中のサービスを表示するTyeダッシュボードを起動します。
6. Tyeダッシュボードのフロントエンドサービスをクリックしてアプリを開き、PDF文書を生成します。