tye .NET (Cómo Funciona para Desarrolladores)

1. Descubrimiento de servicios y gestión de dependencias

Tye detecta y gestiona automáticamente las dependencias entre servicios dentro de una aplicación .NET. Aprovecha los metadatos del proyecto y los contenedores Docker para inferir las relaciones de servicio, facilitando la coordinación de comunicación y orquestación entre microservicios. Esto hace que el desarrollo de microservicios sea más fácil con múltiples proyectos.

2. Experiencia en desarrollo integrado

Tye se integra sin problemas con Visual Studio y Visual Studio Code, proporcionando un entorno de desarrollo familiar para los desarrolladores .NET. Ofrece herramientas para depuración, registro y monitoreo de componentes de la aplicación, permitiendo una rápida iteración y solución de problemas durante el desarrollo.

3. Contenedores Docker

Tye adopta los contenedores Docker como unidad de despliegue para aplicaciones .NET. Genera automáticamente Dockerfiles para cada servicio basado en configuraciones de proyecto, facilitando la construcción de contenedores consistentes y reproducibles en entornos de desarrollo y producción, haciendo fácil la prueba y despliegue de microservicios.

4. Entorno de desarrollo local

Tye simplifica el desarrollo local orquestando dependencias y servicios dentro de un único entorno. Los desarrolladores pueden iniciar toda la pila de aplicaciones con un solo comando, eliminando la necesidad de configuraciones e instalaciones manuales de dependencias.

5. Despliegue en Kubernetes

Tye ofrece soporte integrado para desplegar aplicaciones .NET a clústeres de Kubernetes. Genera manifiestos de Kubernetes y gráficos Helm basados en especificaciones del proyecto, agilizando el proceso de despliegue y promoviendo las mejores prácticas para la orquestación de contenedores en entornos nativos de la nube.

6. Monitorización y observabilidad

Tye se integra con herramientas de observabilidad populares como Prometheus y Grafana para proporcionar información sobre el rendimiento y la salud de la aplicación. Expone métricas y registros de los componentes de la aplicación, permitiendo a los desarrolladores monitorear la utilización de recursos, identificar cuellos de botella y diagnosticar problemas en tiempo real.

Exploremos algunos escenarios prácticos donde Tye puede agilizar el desarrollo y despliegue de aplicaciones .NET:

1. Entorno de desarrollo local

# 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. Contenedores 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. Despliegue en 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

Esquema de configuración de Tye

Tye tiene un archivo de configuración opcional, tye.yaml, que permite la personalización de configuraciones. Este archivo YAML incluye todos tus proyectos y dependencias externas. Si tienes una solución existente, Tye la poblará automáticamente con todos tus proyectos actuales.

Para inicializar este archivo YAML, navega al directorio de microservicios y ejecuta el siguiente comando para generar un archivo tye.yaml por defecto:

tye init

tye init

Se crea un archivo tye.yaml como se muestra a continuación:

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

Características principales de IronPDF

Primero, creemos una aplicación Visual Studio Razor. Abre Visual Studio y crea un nuevo proyecto y selecciona la aplicación Razor como se muestra a continuación.

Proporciona el nombre y la ubicación del proyecto.

En el siguiente paso, selecciona la versión del .NET Framework y haz clic en Crear. Dado que Tye solo funciona en .NET 3.1, seleccionaremos el mismo.

Instala IronPDF desde el Paquete NuGet desde el Administrador de Paquetes de Visual Studio.

Luego, abre el Explorador de Archivos y navega a la carpeta de la solución. Luego abre el CMD.

Instala Tye usando el siguiente comando:

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"

O si ya tienes Tye instalado y deseas actualizarlo, usa el siguiente comando:

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"

Inicializa Tye usando el siguiente comando:

tye init

tye init

Esto creará una plantilla de archivo YAML como la de abajo:

# 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

Ejecuta Tye con el siguiente comando:

tye run frontend

tye run frontend

Esto abrirá el tablero de Tye en la URL: http://127.0.0.1:8000/ para ver la aplicación funcionando.

Tye Dashboard

A continuación, agrega el siguiente código al proyecto para generar un documento PDF desde cualquier URL de sitio web con un clic de un botón.

Agrega el siguiente código al archivo 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>

Luego agrega el siguiente código a 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

Ahora ejecuta Tye así:

Esto lanzará el tablero de Tye.

Ahora haz clic en cualquiera de los enlaces en la sección de enlaces para abrir la aplicación generadora de PDF e ingresa una URL de muestra para la generación de PDF.

Haz clic en el botón de generar para obtener el siguiente PDF como salida:

Explicación del Código

1. Index.cshtml contiene el campo de entrada y el botón para capturar la URL del sitio web y desencadenar la generación del PDF.
2. Index.cshtml.cs es el archivo de código detrás que contiene la lógica para generar el documento PDF usando IronPDF.
3. La clase ChromePdfRenderer y el método RenderUrlAsPdf() se utilizan para generar el PDF desde la URL.
4. La URL generada se devuelve como respuesta al método POST.
5. El comando tye run lanzará el tablero de Tye donde podrás ver todos los servicios en ejecución.
6. Haz clic en el servicio Frontend en el tablero de Tye para abrir la aplicación y generar los documentos PDF.