Visão geral das integrações .NET.NET Aspire

.NET Aspire integrações são um conjunto selecionado de pacotes NuGet selecionados para facilitar a integração de aplicativos nativos da nuvem com serviços e plataformas proeminentes, como Redis e PostgreSQL. Cada integração fornece funcionalidades essenciais nativas da nuvem por meio de provisionamento automático ou padrões de configuração padronizados.

Responsabilidades em matéria de integração

A maioria das integrações .NET.NET Aspire são compostas por duas bibliotecas separadas, cada uma com uma responsabilidade diferente. Um tipo representa recursos dentro do projeto de aplicação host, conhecido como integrações de alojamento . O outro tipo de integração representa client bibliotecas que se conectam aos recursos modelados por integrações de hospedagem, e elas são conhecidas como integrações client.

Integrações de hospedagem

As integrações de hospedagem configuram aplicativos provisionando recursos (como contêineres ou recursos de nuvem) ou apontando para instâncias existentes (como um SQL serverlocal). Esses pacotes modelam vários serviços, plataformas ou recursos, incluindo caches, bancos de dados, registro, armazenamento e sistemas de mensagens.

As integrações de hospedagem estendem a interface IDistributedApplicationBuilder, permitindo que o host do aplicativo projeto expresse recursos em seu modelo de aplicativo . Os pacotes NuGet de integração de hospedagem oficiais de são marcados com aspire, integratione hosting. Além das integrações de hospedagem oficiais, a comunidade criou integrações de hospedagem para vários serviços e plataformas como parte do Kit de Ferramentas da Comunidade.

Para obter informações sobre como criar uma integração de hospedagempersonalizada, veja Criar integração de hospedagem personalizada.

Client integrações

Client integrações conectam client bibliotecas para de injeção de dependência (DI), definem esquema de configuração e adicionam verificações de integridade , de resiliência e de telemetria, quando aplicável. .NET Aspire client bibliotecas de integração são prefixadas com Aspire. e, em seguida, incluem o nome completo do pacote com o qual elas se integram, como Aspire.StackExchange.Redis.

Esses pacotes configuram bibliotecas de client existentes para se conectar a integrações de hospedagem. Estendem a interface IHostApplicationBuilder permitindo que projetos que consomem client, como a sua aplicação web ou API, utilizem o recurso conectado. Os pacotes oficiais de integração NuGet client são marcados com aspire, integratione client. Além das integrações client oficiais, a comunidade criou integrações client para vários serviços e plataformas como parte do Kit de Ferramentas da Comunidade.

Para obter mais informações sobre como criar uma integração de client personalizada, consulte Criar integrações de .NET Aspireclient personalizadas.

Relação entre hospedagem e integrações client

As integrações de hospedagem e client são melhores quando usadas juntas, mas não são acopladas e podem ser usadas separadamente. Algumas integrações de hospedagem não têm uma integração de client correspondente. A configuração é o que faz com que a integração de hospedagem funcione com a integração client.

Considere o diagrama a seguir que descreve a relação entre hospedagem e integrações client:

O projeto de hospedagem de aplicativo é onde são utilizadas as integrações de hospedagem. A configuração, especificamente variáveis de ambiente, é injetada em projetos, executáveis e contêineres, permitindo que integrações client se conectem às integrações de hospedagem.

Recursos de integração

Quando se adiciona uma integração de client a um projeto na solução .NET Aspire, padrões de serviço de são automaticamente aplicados a esse projeto; isto é, o projeto Service Defaults é referenciado e o método de extensão AddServiceDefaults é chamado. Esses padrões são projetados para funcionar bem na maioria dos cenários e podem ser personalizados conforme necessário. Os seguintes parâmetros padrão do serviço são aplicados:

• Observabilidade e telemetria: Configura automaticamente as configurações de registro, rastreamento e métricas:

  • Logging: Uma técnica onde o código é instrumentado para produzir logs de eventos interessantes que ocorreram enquanto o programa estava em execução.
  • Tracing: uma forma especializada de rastreamento em log que ajuda a localizar falhas e problemas de desempenho em aplicações distribuídas em várias máquinas ou processos.
  • Metrics: Medições numéricas registradas ao longo do tempo para monitorar o desempenho e a integridade do aplicativo. As métricas são frequentemente usadas para gerar alertas quando possíveis problemas são detetados.

• Verificações de Saúde: Expõe endpoints HTTP para fornecer informações básicas de disponibilidade e estado sobre um aplicativo. As verificações de integridade são usadas para influenciar decisões tomadas por orquestradores de contêineres, balanceadores de carga, gateways de API e outros serviços de gerenciamento.

• Resiliência: A capacidade do seu sistema de react a falhas e ainda permanecer funcional. A resiliência vai além da prevenção de falhas, incluindo a recuperação e reconstrução do ambiente nativo da nuvem de volta a um estado íntegro.

Integrações oficiais

.NET .NET Aspire fornece muitas integrações para ajudá-lo a criar aplicativos nativos da nuvem. Essas integrações são projetadas para funcionar perfeitamente com as bibliotecas client e o host do aplicativo .NET Aspire. As seções a seguir detalham integrações agnósticas da nuvem, específicas da Azure, da Amazon Web Services (AWS) e do Community Toolkit.

Integrações agnósticas da nuvem

A seção a seguir detalha integrações de .NET.NET Aspire independentes da nuvem com links para seus respetivos documentos e pacotes NuGet e fornece uma breve descrição de cada integração.

Para mais informações sobre integrações de .NET Aspire no Visual Studio, veja a documentação de ferramentas Visual Studio.

Azure integrações

Azure integrações configuram aplicações para utilizar recursos Azure. Essas integrações de hospedagem estão disponíveis nos pacotes Aspire.Hosting.Azure.* NuGet, enquanto suas integrações client estão disponíveis nos pacotes Aspire.* NuGet:

Integrações de hospedagem da Amazon Web Services (AWS)

Para obter mais informações, consulte GitHub: Aspire. Biblioteca Hosting.AWS.

Integrações do Kit de Ferramentas da Comunidade

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