Tutorial: Incorporación de .NET Aspire a una aplicación de .NET existente

1. Inicie Visual Studio y seleccione Archivo>Abrir>proyecto o solución.

2. Vaya a la carpeta de nivel superior de la solución que ha clonado, seleccione eShopLite.slny, a continuación, seleccione Abrir.

3. En el Explorador de soluciones de , haga clic con el botón derecho en la solución eShopLite y, a continuación, seleccione Configurar Proyectos de Inicio.

4. Seleccione varios proyectos de inicio.

5. En la columna Acción, seleccione Inicio para los proyectos Productos y Tienda.

6. Seleccione Aceptar.

7. Para iniciar la depuración de la solución, presione F5 o seleccione Iniciar.

8. Dos páginas abiertas en el explorador:

   • Una página muestra productos en el formato JSON a partir de una llamada a la Products Web API.
   • Una página muestra la página principal del sitio web. En el menú de la izquierda, seleccione Productos para ver el catálogo obtenido de la API web.

9. Para detener la depuración, cierre el navegador.

1. Inicie Visual Studio Code y abra la carpeta que ha clonado. Desde el terminal donde ha clonado el repositorio, ejecute el siguiente comando:

   code .
   

2. Seleccione la opción del menú Ejecutar y Depurar , o presione Ctrl+Shift+D.

3. Seleccione el vínculo crear un archivo launch.json.

   

4. Copie y pegue el siguiente JSON en este archivo y guarde:

   • Unix
   • Windows

   {
       "version": "0.2.0",
       "compounds": [
           {
               "name": "Run all",
               "configurations": [
                   "Run products",
                   "Run store",
               ]
           }
       ],
       "configurations": [
           {
               "name": "Run products",
               "type": "dotnet",
               "request": "launch",
               "projectPath": "${workspaceFolder}/Products/Products.csproj"
           },
           {
               "name": "Run store",
               "type": "dotnet",
               "request": "launch",
               "projectPath": "${workspaceFolder}/Store/Store.csproj"
           }
       ]
   }
   

5. Para iniciar la depuración de la solución, presione F5 o seleccione Iniciar.

6. Dos páginas abiertas en el explorador:

   • Una página muestra productos en el formato JSON a partir de una llamada a la Products Web API.
   • Una página muestra la página principal del sitio web. En el menú de la izquierda, seleccione Productos para ver el catálogo obtenido de la API web.

7. Para detener la depuración, cierre el explorador y, a continuación, seleccione el botón Detener dos veces (una para cada instancia de depuración en ejecución).

1. Abra una ventana de terminal y cambie los directorios al repositorio recién clonado.

2. Para iniciar la aplicación Productos, ejecute el siguiente comando:

   dotnet run --project ./Products/Products.csproj
   

3. Se abre una página del navegador que muestra el JSON para los productos.

4. En una ventana de terminal independiente, cambie de nuevo los directorios al repositorio clonado.

5. Inicie la aplicación Store ejecutando el siguiente comando:

   dotnet run --project ./Store/Store.csproj
   

6. El explorador abre una página que muestra la página principal del sitio web. En el menú de la izquierda, seleccione Productos para ver el catálogo obtenido de la API web.

7. Para detener la depuración, cierre el explorador y presione Ctrl+C en ambos terminales.

1. En Visual Studio, en el Explorador de soluciones, haga clic derecho en el proyecto Store, seleccione Agregar, y a continuación, seleccione .NET.NET AspireSoporte de Orchestrator.

2. En el cuadro de diálogo Agregar .NET.NET Aspire compatibilidad con el orquestador, seleccione Aceptar.

   

Ahora debería tener dos proyectos nuevos, ambos agregados a la solución:

• eShopLite.AppHost: un proyecto de orquestador diseñado para conectarse y configurar los diferentes proyectos y servicios de la aplicación. El orquestador está configurado como proyecto de inicio y depende del proyecto eShopLite.Store.
• eShopLite.ServiceDefaults: un proyecto compartido de .NET.NET Aspire para administrar configuraciones que se reutilizan en los proyectos de la solución relacionados con la resiliencia , la detección de servicios y la telemetría .

En el proyecto eShopLite.AppHost , abra el archivo Program.cs. Observa esta línea de código, que registra el proyecto de Tienda en la orquestación .NET.NET Aspire.

builder.AddProject<Projects.Store>("store");

Para obtener más información, consulte AddProject.

Para agregar el proyecto Products a .NET.NET Aspire:

1. En Visual Studio, en el Explorador de Soluciones, haga clic con el botón derecho en el proyecto Productos, seleccione Agregar, y luego seleccione .NET.NET Aspire Soporte de Orchestrator.

2. Un cuadro de diálogo indica que el proyecto del Orchestrator .NET.NET Aspire ya existe, seleccione Aceptar.

   

En el proyecto eShopLite.AppHost , abra el archivo Program.cs. Observe esta línea de código, que registra el proyecto Products en la orquestación de .NET.NET Aspire:

builder.AddProject<Projects.Products>("products");

Observe también que el proyecto eShopLite.AppHost ahora depende tanto del proyecto Store como del proyecto Products.

Creación de un proyecto host de aplicación

Para organizar los proyectos existentes, debe crear un nuevo proyecto de host de aplicación . Para crear un nuevo proyecto de host de aplicación a partir de las plantillas disponibles, use el siguiente comando de CLI:

dotnet new aspire-apphost -o eShopLite.AppHost

Agregue el proyecto host de aplicación a la solución existente.

dotnet sln ./eShopLite.sln add ./eShopLite.AppHost/eShopLite.AppHost.csproj

dotnet sln .\eShopLite.sln add .\eShopLite.AppHost\eShopLite.AppHost.csproj

Agregue el proyecto Store como referencia de proyecto al proyecto host de aplicación app host usando el siguiente comando de la CLI: .NET

dotnet add ./eShopLite.AppHost/eShopLite.AppHost.csproj reference ./Store/Store.csproj

dotnet add .\eShopLite.AppHost\eShopLite.AppHost.csproj reference .\Store\Store.csproj

Crear un proyecto de configuración predeterminada de servicio

Una vez creado el proyecto host de la aplicación, debe crear un nuevo proyecto de servicios predeterminados. Para crear un nuevo proyecto de configuraciones predeterminadas del servicio a partir de las plantillas disponibles .NET Aspire, use el siguiente comando de la línea de comandos de .NET:

dotnet new aspire-servicedefaults -o eShopLite.ServiceDefaults

Para agregar el proyecto a la solución, use el siguiente comando .NET CLI:

dotnet sln ./eShopLite.sln add ./eShopLite.ServiceDefaults/eShopLite.ServiceDefaults.csproj

dotnet sln .\eShopLite.sln add .\eShopLite.ServiceDefaults\eShopLite.ServiceDefaults.csproj

Actualice el proyecto host de la aplicación para agregar una referencia de proyecto al proyecto Products

dotnet add ./eShopLite.AppHost/eShopLite.AppHost.csproj reference ./Products/Products.csproj

dotnet add .\eShopLite.AppHost\eShopLite.AppHost.csproj reference .\Products\Products.csproj

Los proyectos de Store y Products necesitan hacer referencia al proyecto de valores predeterminados del servicio para que puedan incluir fácilmente la detección de servicios . Para agregar una referencia al proyecto de service defaults en el proyecto de Store, use el siguiente comando de .NET CLI:

dotnet add ./Store/Store.csproj reference ./eShopLite.ServiceDefaults/eShopLite.ServiceDefaults.csproj

dotnet add .\Store\Store.csproj reference .\eShopLite.ServiceDefaults\eShopLite.ServiceDefaults.csproj

El mismo comando con rutas de acceso ligeramente diferentes debe usarse para agregar una referencia al proyecto configuraciones predeterminadas en el proyecto Products:

dotnet add ./Products/Products.csproj reference ./eShopLite.ServiceDefaults/eShopLite.ServiceDefaults.csproj

dotnet add .\Products\Products.csproj reference .\eShopLite.ServiceDefaults\eShopLite.ServiceDefaults.csproj

Tanto en los proyectos de Store como Products, actualice sus archivos de Program.cs y agregue la siguiente línea inmediatamente después de su línea de var builder = WebApplication.CreateBuilder(args);:

builder.AddServiceDefaults();

Actualización del proyecto host de la aplicación

Abra el archivo del proyecto host de la aplicación de y reemplace su contenido por el siguiente código de C#:

var builder = DistributedApplication.CreateBuilder(args);

builder.AddProject<Projects.Store>("store");

builder.AddProject<Projects.Products>("products");

builder.Build().Run();

El código anterior:

• Crea una nueva instancia de DistributedApplicationBuilder.
• Agrega el proyecto Store al orquestador.
• Agrega el proyecto Products al orquestador.
• Compila y ejecuta el orquestador.

1. En Visual Studio, para iniciar la depuración, presione F5. Visual Studio Compila los proyectos.
2. Si aparece el cuadro de diálogo Inicio de Docker Escritorio, seleccione Sí. Visual Studio inicia el motor de Docker y crea los contenedores necesarios. Una vez completada la implementación, se muestra el panel de control .NET.NET Aspire.
3. En el panel de control, selecciona el endpoint para el proyecto "productos" . Aparece una nueva pestaña del explorador y muestra el catálogo de productos en formato JSON.
4. En el panel, seleccione el punto de conexión para el proyecto de la tienda. Aparece una nueva pestaña del explorador y muestra la página principal de la aplicación web.
5. En el menú de la izquierda, seleccione Productos. Se muestra el catálogo de productos.
6. Para detener la depuración, cierre el navegador.

Elimine el archivo launch.json que creó anteriormente, ya no sirve para un propósito. En su lugar, inicie el proyecto de host de la aplicación, que organiza los demás proyectos:

1. Inicie el proyecto de host de la aplicación haciendo clic derecho en el proyecto eShopLite.AppHost en el Explorador de Soluciones y seleccionando Depurar Iniciar nueva instancia>.

   

   Nota

   Si Docker Escritorio (o Podman) no se está ejecutando, podrías experimentar un error. Inicie el motor de contenedor compatible con OCI e inténtelo de nuevo.

1. Inicie el proyecto del host de la aplicación ejecutando el siguiente comando:

   dotnet run --project ./eShopLite.AppHost/eShopLite.AppHost.csproj
   

   Nota

   Si Docker Desktop (o Podman) no se está ejecutando, tendrás un error. Inicie el motor de contenedor compatible con OCI e inténtelo de nuevo.

2. En el panel de control, selecciona el punto de conexión para el proyecto productos. Aparece una nueva pestaña del explorador y muestra el catálogo de productos en formato JSON.
3. En el panel, seleccione el punto de conexión para el proyecto de la tienda. Aparece una nueva pestaña del explorador y muestra la página principal de la aplicación web.
4. En el menú de la izquierda, seleccione Productos. Se muestra el catálogo de productos.
5. Para detener la depuración, cierre el navegador.