Compartilhar via

.NET .NET Aspire configuração e ferramentas

  • Artigo

.NET .NET Aspire inclui ferramentas para ajudá-lo a criar e configurar aplicativos nativos de nuvem. As ferramentas incluem modelos úteis de projeto iniciais e outros recursos para simplificar a inicialização com .NET Aspire para fluxos de trabalho de Visual Studio, Visual Studio Codee CLI. Nas seções a seguir, você aprenderá a trabalhar com ferramentas de .NET.NET Aspire e explorar as seguintes tarefas:

  • Instalar .NET.NET Aspire e suas dependências
  • Criar modelos de projeto inicial usando Visual Studio, Visual Studio Codeou a CLI de .NET
  • Instalar .NET.NET Aspire integrações
  • Trabalhar com o painel .NET.NET Aspire

Instalar .NET.NET Aspire

Para trabalhar com .NET.NET Aspire, você precisa do seguinte instalado localmente:

Visual Studio 2022 17.9 ou superior inclui o SDK de .NET.NET Aspire mais recente por padrão quando você instala a carga de trabalho do Web & Cloud.

Se você tiver uma versão anterior do Visual Studio 2022, poderá atualizar para o Visual Studio 2022 17.9 ou instalar o SDK do .NET Aspire usando as seguintes etapas:

Para instalar a carga de trabalho .NET Aspire no Visual Studio 2022, use o instalador Visual Studio.

  1. Abra o instalador do Visual Studio.

  2. Selecione e depois Modificar ao lado de Visual Studio 2022.

  3. Selecione a carga de trabalho de ASP.NET e desenvolvimento web.

  4. No painel de detalhes da instalação , selecione .NETSDK.NET Aspire.

  5. Selecione Modificar para instalar a integração .NET.NET Aspire.

    Uma captura de tela mostrando como instalar a carga de trabalho .NET Aspire com o instalador Visual Studio.

Para garantir que você instale a versão mais recente do SDK .NET.NET Aspire, ...

Runtime do contêiner

.NET .NET Aspire projetos são projetados para serem executados em contêineres. Você pode usar Docker Desktop ou Podman como runtime de contêiner. Docker Desktop é o runtime de contêiner mais comum. Podman é uma alternativa sem daemon de código aberto para Docker, que pode criar e executar contêineres OCI (Open Container Initiative). Se o ambiente do host tiver Docker e Podman instalados, .NET Aspire usará por padrão Docker. Você pode instruir .NET Aspire a usar Podman, definindo a variável de ambiente DOTNET_ASPIRE_CONTAINER_RUNTIME como podman:

export DOTNET_ASPIRE_CONTAINER_RUNTIME=podman

Para obter mais informações, consulte Instalar Podman no Linux.

modelos de .NET.NET Aspire

.NET .NET Aspire fornece um conjunto de modelos de solução e projeto. Esses modelos estão disponíveis em seu ambiente integrado de desenvolvedor favorito .NET. Você pode usar esses modelos para criar soluções de .NET Aspire completas ou adicionar projetos individuais a soluções de .NET Aspire existentes. Para obter mais informações, consulte .NET.NET Aspire modelos.

painel .NET.NET Aspire

.NET .NET Aspire modelos que expõem o projeto de host de aplicativo também incluem um painel de desenvolvedor útil usado para monitorar e inspecionar vários aspectos do seu aplicativo, como logs, traços e configurações de ambiente. Este painel foi projetado para melhorar a experiência de desenvolvimento local e fornece uma visão geral do estado geral e da estrutura do seu aplicativo.

O painel .NET.NET Aspire só fica visível enquanto o aplicativo é executado e inicia automaticamente quando você inicia o projeto *.AppHost. Visual Studio e Visual Studio Code lançam automaticamente seu aplicativo e o painel do .NET Aspire no navegador para você. Se você iniciar o aplicativo usando a CLI do .NET, copie e cole a URL do painel da saída para o navegador, ou mantenha Ctrl e selecione o link (se o terminal oferecer suporte a hiperlinks).

Uma captura de tela mostrando como iniciar o painel usando a CLI.

A navegação à esquerda fornece links para as diferentes partes do painel, cada uma das quais você explora nas seções a seguir.

Uma captura de tela da página de projetos do painel .NET.NET Aspire.

O painel .NET.NET Aspire também está disponível em um modo independente. Para obter mais informações, consulte .NET painel .NET Aspireautônomo.

ferramentas de Visual Studio

Visual Studio fornece recursos adicionais para trabalhar com integrações .NET Aspire e o projeto do orquestrador do Host de Aplicativo. Nem todos esses recursos estão disponíveis no momento em Visual Studio Code ou por meio da CLI.

Adicionar um pacote de integração

Você adiciona integrações .NET Aspire ao seu aplicativo como qualquer outro pacote NuGet usando Visual Studio. No entanto, Visual Studio também oferece opções de interface do usuário para adicionar diretamente as integrações .NET Aspire.

  1. No Visual Studio, clique com o botão direito do mouse no projeto ao qual você deseja adicionar uma integração .NET Aspire e selecione Adicionar pacote>.NET.NET Aspire.

    o menu de contexto Visual Studio exibindo a opção Adicionar Componente .NET Aspire.

  2. O gerenciador de pacotes é aberto com resultados de pesquisa pré-configurados (preenchendo critérios de filtro) para integrações de .NET.NET Aspire, permitindo que você navegue facilmente e selecione a integração desejada.

    o menu de contexto Visual Studio exibindo as opções de integração de Adicionar .NET Aspire.

Para obter mais informações sobre integrações de .NET.NET Aspire, consulte .NET.NET Aspire visão geral de integrações.

Adicionar pacotes de hospedagem

.NET .NET Aspire pacotes de hospedagem são usados para configurar vários recursos e dependências dos quais um aplicativo pode depender ou consumir. Os pacotes de hospedagem são diferenciados de outros pacotes de integração, pois são adicionados ao *. AppHost projeto. Para adicionar um pacote de hospedagem ao seu aplicativo, siga estas etapas:

  1. Em Visual Studio, selecione à direita na *. AppHost projeto e selecione Adicionar pacote>.NET.NET Aspire....

    o menu de contexto Visual Studio exibindo a opção Adicionar recurso de hospedagem .NET Aspire.

  2. O gerenciador de pacotes é aberto com resultados de pesquisa pré-configurados (preenchendo critérios de filtro) para .NET.NET Aspire pacotes de hospedagem, permitindo que você navegue facilmente e selecione o pacote desejado.

    o menu de contexto Visual Studio exibindo as opções de adicionar o recurso .NET Aspire.

Adicionar projetos de orquestração

Você pode adicionar .NET.NET Aspire projetos de orquestração a um aplicativo existente usando as seguintes etapas:

  1. Em Visual Studio, clique com o botão direito em um projeto existente e selecione Adicionar>.NET.NET Aspire Suporte ao Orchestrator..

    o menu de contexto Visual Studio exibindo a opção Adicionar suporte ao Orquestrador .NET Aspire.

  2. Uma janela de diálogo é aberta com um resumo dos projetos *.AppHost e *.ServiceDefaults que são adicionados à sua solução.

    Uma captura de tela mostrando a adição do resumo de orquestração Visual Studio.NET Aspire.

  3. Selecione OK e as seguintes alterações são aplicadas:

    • Os projetos de orquestração *.AppHost e *.ServiceDefaults são adicionados à sua solução.
    • Uma chamada para builder.AddServiceDefaults será adicionada ao arquivo Program.cs do projeto original.
    • Uma referência ao seu projeto original será adicionada ao arquivo Program.cs do projeto *.AppHost.

Para obter mais informações sobre a orquestração de .NET.NET Aspire, consulte a visão geral da orquestração de .NET.NET Aspire.

Inscrever-se na orquestração

Visual Studio fornece a opção de Inscrever-se em Aspire de orquestração durante o novo fluxo de trabalho do projeto. Selecione esta opção para que Visual Studio crie os projetos *.AppHost e *.ServiceDefaults junto com o modelo de projeto selecionado.

Uma captura de tela mostrando como se inscrever na orquestração de .NET.NET Aspire.

Criar projeto de teste

Ao usar Visual Studioe selecionar o modelo .NET.NET Aspire Iniciar Aplicativo, você terá a opção de incluir um projeto de teste. Este projeto de teste é um projeto xUnit que inclui um teste de exemplo que você pode usar como ponto de partida para seus testes.

Uma captura de tela de Visual Studio exibindo a opção para criar um projeto de teste.

Para obter mais informações, consulte Escrever seu primeiro teste de .NET.NET Aspire.

ferramentas de Visual Studio Code

Você pode usar Visual Studio Code, com a extensão C# Dev Kit, para criar e desenvolver projetos .NET.NET Aspire. Para criar um novo projeto de no , selecione o botão Criar Project no modo de exibição do Explorer e selecione um dos modelos de :

Uma captura de tela mostrando como criar um novo projeto de .NET Aspire no Visual Studio Code.

Depois de criar um novo projeto .NET Aspire, execute e depure o aplicativo, percorrendo pontos de interrupção e inspecionando variáveis usando o depurador Visual Studio Code:

Uma captura de tela mostrando como depurar um projeto de .NET Aspire no Visual Studio Code.

Consulte também