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 버전을 선택하고 '생성'을 클릭하세요. Tye는 .NET 3.1에서만 작동하므로 동일한 버전을 선택합니다.

Visual Studio 패키지 관리자에서 IronPDF를 NuGet 패키지에서 설치합니다.

다음으로 파일 브라우저를 열고 솔루션 폴더로 이동합니다. 그런 다음 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");
        }
    }
}

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 생성 앱을 열고 샘플 URL을 입력하여 PDF를 생성합니다.

생성 버튼을 클릭하여 다음 PDF를 출력으로 받습니다:

코드 설명

1. Index.cshtml에는 웹사이트 URL를 캡처하고 PDF 생성을 트리거하는 입력 필드와 버튼이 포함되어 있습니다.
2. Index.cshtml.cs는 IronPDF를 사용하여 PDF 문서를 생성하는 로직이 포함된 코드 비하인드 파일입니다.
3. URL에서 PDF를 생성하기 위해 ChromePdfRenderer 클래스와 RenderUrlAsPdf() 메서드가 사용됩니다.
4. 생성된 URL은 POST 메서드에 대한 응답으로 반환됩니다.
5. tye run 명령어는 Tye 대시보드를 실행하여 모든 실행 중인 서비스를 볼 수 있습니다.
6. Tye 대시보드에서 프런트엔드 서비스를 클릭하여 앱을 열고 PDF 문서를 생성합니다.