Compartir a través de

.NET .NET Aspire configuración y herramientas

  • Artículo

.NET .NET Aspire incluye herramientas para ayudarle a crear y configurar aplicaciones nativas de la nube. Las herramientas incluyen útiles plantillas de proyectos de inicio y otras características para simplificar el inicio con .NET Aspire para los flujos de trabajo de Visual Studio, Visual Studio Code, y la CLI. En las secciones siguientes, aprenderá a trabajar con herramientas de .NET.NET Aspire y a explorar las siguientes tareas:

  • Instalación de .NET.NET Aspire y sus dependencias
  • Creación de plantillas de proyecto de inicio mediante Visual Studio, Visual Studio Codeo la CLI de .NET
  • Instalación de integraciones de .NET.NET Aspire
  • Trabajar con el panel de .NET.NET Aspire

Instalar .NET.NET Aspire

Para trabajar con .NET.NET Aspire, necesita lo siguiente instalado localmente:

Visual Studio 2022 17.9 o posterior incluye el SDK de .NET.NET Aspire más reciente de forma predeterminada al instalar la carga de trabajo Web & Cloud. Si tiene una versión anterior de Visual Studio 2022, puede actualizar a Visual Studio 2022 17.9 o puede instalar el SDK de .NET Aspire mediante los pasos siguientes:

Para instalar la carga de trabajo de .NET Aspire en Visual Studio 2022, use el instalador de Visual Studio.

  1. Abra el instalador de Visual Studio.

  2. Seleccione Modificar junto a Visual Studio 2022.

  3. Seleccione la carga de trabajo ASP.NET y desarrollo web.

  4. En el panel Detalles de Instalación del , seleccione .NET.NET Aspire SDK.

  5. Seleccione Modificar para instalar la integración de .NET.NET Aspire.

    Captura de pantalla que muestra cómo instalar la carga de trabajo de .NET Aspire con el instalador de Visual Studio.

Tiempo de ejecución del contenedor

.NET .NET Aspire proyectos están diseñados para ejecutarse en contenedores. Puede usar Docker Escritorio o Podman como entorno de ejecución del contenedor. Docker Desktop es el entorno de ejecución de contenedor más común. Podman es una alternativa de código abierto sin demonios a Docker, que puede construir y ejecutar contenedores de la Open Container Initiative (OCI). Si el entorno de host tiene Docker y Podman instalados, .NET Aspire usa de forma predeterminada Docker. En su lugar, puede indicar a .NET Aspire usar Podman estableciendo la variable de entorno DOTNET_ASPIRE_CONTAINER_RUNTIME en podman:

export DOTNET_ASPIRE_CONTAINER_RUNTIME=podman

Para obtener más información, consulte Instalar Podman en Linux.

plantillas de .NET.NET Aspire

.NET .NET Aspire proporciona un conjunto de plantillas de solución y proyecto. Estas plantillas están disponibles en su entorno de desarrollo integrado favorito .NET. Puede usar estas plantillas para crear soluciones de .NET Aspire completas o agregar proyectos individuales a soluciones de .NET Aspire existentes. Para obtener más información, consulte plantillas de .NET.NET Aspire.

panel de control .NET.NET Aspire

.NET .NET Aspire plantillas que exponen el host de la aplicación proyecto incluyen además un útil panel de desarrollador que se usa para supervisar e inspeccionar varios aspectos de la aplicación, como registros, seguimientos y configuraciones de entorno. Este panel está diseñado para mejorar la experiencia de desarrollo local y proporciona información general sobre el estado general y la estructura de la aplicación.

El panel de .NET.NET Aspire solo está visible mientras se ejecuta la aplicación y se inicia automáticamente al iniciar el *. AppHost proyecto. Visual Studio y Visual Studio Code inician automáticamente la aplicación y el panel de .NET Aspire para ti en el navegador. Si inicia la aplicación con la CLI de .NET, copie y pegue la dirección URL del panel de la salida en el explorador, o mantenga presionado Ctrl y seleccione el vínculo (si el terminal admite hipervínculos).

Captura de pantalla que muestra cómo iniciar el panel mediante la CLI.

El panel de navegación izquierdo proporciona vínculos a las distintas partes del panel, cada una de las cuales explora en las secciones siguientes.

Una captura de pantalla de la página de Proyectos en el panel de .NET.NET Aspire.

El panel de .NET.NET Aspire también está disponible en modo independiente. Para obtener más información, consulte el panel .NET.NET Aspire independiente.

herramientas Visual Studio

Visual Studio proporciona características adicionales para trabajar con integraciones de .NET Aspire y el proyecto de orquestador de host de aplicaciones. No todas estas características están disponibles actualmente en Visual Studio Code o a través de la CLI.

Adición de un paquete de integración

Agregas integraciones de .NET Aspire a tu aplicación como cualquier otro paquete NuGet mediante Visual Studio. Sin embargo, Visual Studio también proporciona opciones de interfaz de usuario para agregar directamente integraciones de .NET Aspire.

  1. En Visual Studio, con el botón derecho del ratón haga clic en el proyecto al que desea añadir una integración de .NET Aspire y seleccione Añadir paquete de>.NET.NET Aspire....

    El menú contextual de Visual Studio que muestra la opción Agregar componente de .NET Aspire.

  2. El administrador de paquetes se abre con los resultados de búsqueda preconfigurados (rellenando criterios de filtro) para .NET.NET Aspire integraciones, lo que le permite examinar y seleccionar fácilmente la integración deseada.

    El menú contextual de Visual Studio que muestra las opciones de integración Agregar .NET Aspire.

Para obtener más información sobre las integraciones de .NET.NET Aspire, consulte .NET.NET Aspire integrations overview.

Agregar paquetes de hospedaje

.NET .NET Aspire paquetes de hospedaje se usan para configurar varios recursos y dependencias que una aplicación puede depender o consumir. Los paquetes de hospedaje se diferencian de otros paquetes de integración porque se agregan al proyecto *.AppHost. Para agregar un paquete de hospedaje a la aplicación, siga estos pasos:

  1. En Visual Studio, seleccione con el botón derecho en el *. AppHost proyecto y seleccione Agregar paquete de>.NET.NET Aspire....

    El menú contextual Visual Studio que muestra la opción Agregar .NET Aspire recurso de hospedaje.

  2. El administrador de paquetes se abre con los resultados de búsqueda preconfigurados (rellenando criterios de filtro) para .NET.NET Aspire paquetes de hospedaje, lo que le permite examinar y seleccionar fácilmente el paquete deseado.

    Menú contextual de Visual Studio que muestra las opciones de añadir recursos .NET Aspire.

Agregar proyectos de orquestación

Puede agregar .NET.NET Aspire proyectos de orquestación a una aplicación existente mediante los pasos siguientes:

  1. En Visual Studio, haga clic con el botón derecho en un proyecto existente y seleccione Agregar soporte de Orchestrator de>.NET.NET Aspire..

    El menú contextual Visual Studio que muestra la opción Agregar soporte de Orquestador para .NET Aspire.

  2. Se abre una ventana de diálogo que contiene un resumen de los proyectos *.AppHost y *.ServiceDefaults que se agregan a la solución.

    Captura de pantalla que muestra el resumen de orquestación de Visual Studio añadir .NET Aspire.

  3. Seleccione Aceptar y se aplican los siguientes cambios:

    • Los *.AppHost y *.ServiceDefaults proyectos de orquestación se agregan a la solución.
    • Se agregará una llamada a builder.AddServiceDefaults al archivo Program.cs del proyecto original.
    • Se agregará una referencia al proyecto original al archivo Program.cs del *. AppHost proyecto.

Para obtener más información sobre la orquestación de .NET.NET Aspire, consulte .NET.NET Aspire visión general de la orquestación.

Inscribirse en la orquestación

Visual Studio proporciona la opción de inscribirse en la orquestación de Aspire durante el flujo de trabajo del nuevo proyecto. Seleccione esta opción para que Visual Studio cree proyectos *.AppHost y *.ServiceDefaults junto con la plantilla de proyecto seleccionada.

captura de pantalla que muestra cómo inscribirse en la orquestación de .NET.NET Aspire.

Creación de un proyecto de prueba

Al usar Visual Studioy selecciona la plantilla .NET.NET Aspire Iniciar aplicación, tiene la opción de incluir un proyecto de prueba. Este proyecto de prueba es un proyecto xUnit que incluye una prueba de ejemplo que puede usar como punto de partida para las pruebas.

Captura de pantalla de Visual Studio que muestra la opción para crear un proyecto de prueba.

Para obtener más información, consulte Escriba su primera prueba .NET.NET Aspire.

herramientas Visual Studio Code

Puede usar Visual Studio Code, con la extensión C# Dev Kit, para crear y desarrollar proyectos de .NET.NET Aspire. Para crear un nuevo proyecto .NET Aspire en Visual Studio Code, seleccione el botón Crear proyecto .NET en la vista Explorador y, a continuación, seleccione una de las.NET plantillas .NET Aspire:

Captura de pantalla que muestra cómo crear un nuevo proyecto de .NET Aspire en Visual Studio Code.

Una vez creado un nuevo proyecto de .NET Aspire, ejecute y depure la aplicación, recorra los puntos de interrupción e inspeccione las variables mediante el depurador de Visual Studio Code:

Captura de pantalla que muestra cómo depurar un proyecto de .NET Aspire en Visual Studio Code.

Consulte también