Partilhar via

.NET .NET Aspire configuração e ferramentas

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

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

Instalar pré-requisitos .NET.NET Aspire

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

Sugestão

Como alternativa, você pode desenvolver soluções .NET.NET Aspire usando GitHub Codespaces ou Dev Containers.

2022 17.9 ou superior inclui o mais recente SDK por padrão quando instalas o pacote 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 do .NET Aspire no Visual Studio 2022, use o instalador do Visual Studio.

  1. Abra o Visual Studio Installer.

  2. Selecione Modificar ao lado de Visual Studio 2022.

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

  4. No painel 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 do .NET Aspire com o instalador do Visual Studio.

.NET .NET Aspire modelos

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

Instalar os modelos de .NET.NET Aspire

Para instalar os modelos .NET Aspire no Visual Studio, você precisa instalá-los manualmente, a menos que esteja usando o Visual Studio 17.12 ou posterior. Para Visual Studio 17.9 a 17.11, siga estes passos:

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

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

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

dotnet new install Aspire.ProjectTemplates

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

dotnet new install Aspire.ProjectTemplates::9.3.0

Sugestão

Se já tiver a carga de trabalho .NET.NET Aspire instalada, precisa passar o indicador --force para substituir os modelos existentes. Sinta-se à vontade para desinstalar a carga de trabalho .NET.NET Aspire.

Listar os modelos .NET.NET Aspire

Os modelos .NET Aspire são instalados automaticamente quando você instala o Visual Studio 17.9 ou posterior. Para ver quais modelos estão disponíveis, selecione Arquivo Novo Projetono e procure por "" na barra de pesquisa (AltS). Você verá uma lista de modelos de projeto disponíveis .NET.NET Aspire :

Visual Studio: Crie um novo projeto e procure por 'Aspire'.

Para exibir os modelos disponíveis em com o C# DevKit instalado, selecione o botão Create Project quando nenhuma pasta for aberta na visualização do Explorer:

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

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

Visual Studio Code: Crie um novo projeto e procure por 'Aspire'.

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

dotnet new list aspire

A saída do console deve ter a seguinte aparência:

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.

Tempo de execução do contêiner

.NET Aspire pode executar contêineres usando vários tempos de execução compatíveis com OCI, incluindo Docker Desktop e Podman. Embora alguns usuários tenham relatado sucesso usando o Rancher Desktop, particularmente quando configurado para usar a Docker CLI, este não é um cenário oficialmente suportado ou testado regularmente. Pode ser possível usar o Rancher Desktop com a instalação padrão, mas não é uma abordagem oficialmente suportada 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 contentores mais popular entre os desenvolvedores .NET.NET Aspire, oferecendo um ambiente familiar e amplamente suportado para a criação e execução de contentores.
  • Podman é uma alternativa de código aberto e sem daemon ao Docker. Ele suporta a criação e execução de contêineres Open Container Initiative (OCI), tornando-se uma escolha flexível para desenvolvedores que preferem uma solução leve.

Se o seu ambiente de host tiver um Docker e um Podman instalados, .NET Aspire por padrão usará Docker. Você pode instruir .NET Aspire a usar Podman em vez disso, 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 de controlo

.NET .NET Aspire modelos que expõem o projeto anfitrião da aplicação também incluem um painel de controlo útil do desenvolvedor que é usado para monitorizar e inspecionar vários aspectos da sua aplicação, como logs, rastreamentos 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ó é visível enquanto a aplicação está em execução e é iniciado automaticamente quando o utilizador inicia o projeto *.AppHost. Visual Studio e Visual Studio Code iniciam o seu aplicativo e o painel .NET Aspire para si automaticamente no seu navegador. Se iniciar a aplicação usando a CLI .NET, copie e cole o URL do painel a partir da saída no navegador ou mantenha Ctrl pressionada e selecione o link (se o terminal suportar 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 ecrã da página de Projetos do painel .NET.NET Aspire.

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

Ferramentas Visual Studio

Visual Studio fornece recursos extras para trabalhar com .NET Aspire integrações e o projeto orquestrador do App Host. Nem todos esses recursos estão atualmente disponíveis no 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 integrações .NET Aspire diretamente.

  1. No Visual Studio, clique com o botão direito no projeto em que pretende adicionar uma integração .NET Aspire e selecione Adicionar>.NET.NET Aspire pacote....

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

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

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

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

Adicionar pacotes de hospedagem

.NET .NET Aspire Os 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 na medida em que são adicionados ao projeto *.AppHost. 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 escolha Adicionar>.NET.NET Aspire pacote....

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

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

    O menu de contexto Visual Studio exibindo as opções de adicionar 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. No Visual Studio, selecione com o botão direito do mouse 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 para o Orchestrator .NET Aspire.

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

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

  3. Selecione OK e as seguintes alterações serã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 seu projeto original.
    • Uma referência ao seu projeto original será adicionada ao arquivo Program.cs do *. AppHost projeto.

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

Inscreva-se na orquestração

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

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

Criar projeto de teste

Quando usares Visual Studio e selecionares o modelo .NET.NET Aspire Iniciar Aplicação, terás 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 teste de .NET.NET Aspire.

Ferramentas Visual Studio Code

Você pode usar Visual Studio Code, com a extensão C# Dev Kit, para criar e desenvolver .NET.NET Aspire projetos. Para criar um novo projeto de no , selecione o botão Criar Projeto na visualização do Explorador do , e depois selecione um dos modelos .

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

Depois de criar um novo projeto .NET Aspire, você executa e depura o aplicativo, passando por pontos de interrupção e inspecionando variáveis usando o depurador Visual Studio Code:

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

Ver também