Compartilhar via

.NET .NET Aspire configuração e ferramentas

.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:

  • Instale .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
  • Trabalhe com o painel .NET.NET Aspire

Instalar .NET.NET Aspire prerequisitos

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

Dica

Como alternativa, você pode desenvolver soluções .NET.NET Aspire usando Codespaces GitHub ou contêineres de desenvolvimento.

2022 17.9 ou superior inclui por padrão o mais recente SDK de quando você instala o workload de Web & Nuvem. 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.

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.

Instalar os modelos de .NET.NET Aspire

Para instalar os modelos de .NET Aspire no Visual Studio, você precisará instalá-los manualmente, a menos que esteja usando Visual Studio 17.12 ou posterior. Para Visual Studio 17.9 a 17.11, siga estas etapas:

  1. Abra Visual Studio.
  2. Vá para Tools>NuGet Package Manager>Console do Gerenciador de Pacotes.
  3. Execute o seguinte comando para instalar os modelos:
dotnet new install Aspire.ProjectTemplates

Para Visual Studio 17.12 ou posterior, os modelos de .NET Aspire são instalados automaticamente.

Para instalar esses modelos, utilize o comando dotnet new install, passando o identificador do NuGet Aspire.ProjectTemplates.

dotnet new install Aspire.ProjectTemplates

Para instalar uma versão específica, acrescente o número de versão ao nome do pacote:

dotnet new install Aspire.ProjectTemplates::9.3.0

Dica

Se você já tiver o pacote de trabalho .NET.NET Aspire instalado, precisará passar a flag --force para substituir os modelos existentes. Fique à vontade para desinstalar o workload .NET.NET Aspire.

Liste os modelos .NET.NET Aspire

Os modelos de .NET Aspire são instalados automaticamente quando você instala o Visual Studio 17.9 ou posterior. Para ver quais modelos de .NET.NET Aspire estão disponíveis, selecione Arquivo>Novo>Projeto no Visual Studioe pesquise "Aspire" no campo de busca (Alt+S). Você verá uma lista de modelos de projeto disponíveis .NET.NET Aspire :

Visual Studio: crie um novo projeto e pesquise 'Aspire'.

Para exibir os modelos disponíveis no Visual Studio Code com o Kit de Desenvolvimento do C# instalado, selecione o botão Criar .NET Projeto quando nenhuma pasta for aberta no modo de exibição do Explorer:

Visual Studio Code: botão Criar Projeto .NET.

Em seguida, pesquise "Aspire" na barra de pesquisa para ver os modelos de projeto de .NET Aspire disponíveis:

Visual Studio Code: crie um novo projeto e pesquise 'Aspire'.

Para verificar se os modelos de .NET.NET Aspire estão instalados, use o comando nova lista dotnet, passando o nome do modelo aspire:

dotnet new list aspire

A saída do console deve ser semelhante à seguinte:

dotnet new list aspire
These templates matched your input: 'aspire'

Template Name                      Short Name              Language  Tags
---------------------------------  ----------------------  --------  -------------------------------------------------------
.NET Aspire App Host               aspire-apphost          [C#]      Common/.NET Aspire/Cloud
.NET Aspire Empty App              aspire                  [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service
.NET Aspire Service Defaults       aspire-servicedefaults  [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service
.NET Aspire Starter App            aspire-starter          [C#]      Common/.NET Aspire/Blazor/Web/Web API/API/Service/Cloud
.NET Aspire Test Project (MSTest)  aspire-mstest           [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
.NET Aspire Test Project (NUnit)   aspire-nunit            [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
.NET Aspire Test Project (xUnit)   aspire-xunit            [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test

Para obter mais informações, consulte .NET.NET Aspire modelos.

Runtime do contêiner

.NET Aspire pode executar contêineres usando vários runtimes compatíveis com OCI, incluindo Docker Desktop e Podman. Embora alguns usuários tenham relatado êxito usando o Rancher Desktop , especialmente quando configurados para usar a Docker CLI, este não é um cenário oficialmente compatível ou testado regularmente. Pode ser possível usar o Rancher Desktop com a instalação padrão, mas não é uma abordagem oficialmente compatível ou validada. Se você encontrar problemas com o Rancher Desktop, informe-nos, mas esteja ciente de que as correções podem não ser priorizadas.

  • Docker Desktop é o runtime de contêiner mais popular entre .NET.NET Aspire desenvolvedores, oferecendo um ambiente familiar e amplamente suportado para criar e executar contêineres.
  • Podman é uma alternativa de software livre e sem daemon para Docker. Ele dá suporte à criação e execução de contêineres OCI (Open Container Initiative), tornando-se uma opção flexível para desenvolvedores que preferem uma solução leve.

Se o ambiente do host tiver Docker e Podman instalados, .NET Aspire padroniza-se a usar Docker. Você pode instruir .NET Aspire a usar Podman, definindo a variável de ambiente DOTNET_ASPIRE_CONTAINER_RUNTIME como podman:

export ASPIRE_CONTAINER_RUNTIME=podman

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

.NET .NET Aspire painel

.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.

Visual Studio ferramentas

Visual Studio fornece recursos extras para trabalhar com integrações .NET Aspire e o orquestrador do projeto App Host. 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 que 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, clique com o botão direito no projeto *.AppHost e selecione Adicionar>.NET.NET Aspire pacote....

    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.

Participar da orquestração

Visual Studio fornece a opção de Inscrever-se na orquestração Aspire 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 Escreva seu primeiro .NET.NET Aspire teste.

Visual Studio Code ferramentas

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