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

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

Responsabilidades 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 host de aplicativo do projeto, conhecido como integrações de hospedagem . O outro tipo de integração representa client bibliotecas que se conectam aos recursos modelados por integrações de hospedagem e 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 local server). Esses pacotes modelam vários serviços, plataformas ou funcionalidades, incluindo caches, bancos de dados, log, armazenamento e sistemas de mensagens.

As integrações de hospedagem estendem a interface IDistributedApplicationBuilder, permitindo ao host do aplicativo expressar recursos no projeto dentro do seu modelo de aplicativo . Os pacotes NuGet oficiais de integração de hospedagem são marcados com aspire, integratione hosting. Além das integrações oficiais de hospedagem, 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 hospedagem personalizada, consulte Criar integração de hospedagem .NET.NET Aspire personalizada.

integrações Client

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

Esses pacotes configuram bibliotecas de client existentes para se conectarem a integrações de hospedagem. Eles estendem a interface IHostApplicationBuilder permitindo que projetos que consomem client, como seu aplicativo Web ou API, usem o recurso conectado. Os pacotes NuGet de integração client oficiais são marcados com aspire, integratione client. Além das integrações client oficiais, a comunidade criou client integrações 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 de client

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

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

O projeto de hospedagem do aplicativo é onde as integrações de hospedagem são utilizadas. A configuração, especificamente as 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 você adiciona uma integração client a um projeto em sua solução de .NET Aspire, os padrões de serviço são aplicados automaticamente a esse projeto: isso significa que o projeto dos Padrões de Serviço é 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 padrões de serviço são aplicados:

• Observabilidade e Telemetria: configura automaticamente logs, rastreamentos e métricas.

  • registro em log: uma técnica em que o código é instrumentado para produzir logs de eventos interessantes que ocorreram durante a execução do programa.
  • rastreamento: uma forma especializada de registro em log que ajuda você a localizar falhas e problemas de desempenho em aplicativos distribuídos em vários computadores ou processos.
  • Métricas: medidas numéricas registradas ao longo do tempo para monitorar o desempenho e a integridade do aplicativo. As métricas geralmente são usadas para gerar alertas quando possíveis problemas são detectados.

• Verificações de integridade: expõe pontos de extremidade HTTP para fornecer informações básicas de disponibilidade e estado sobre um aplicativo. 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 à falha e ainda permanecer funcional. A resiliência vai além de evitar falhas para incluir a recuperação e a reconstrução de seu ambiente nativo de nuvem de volta a um estado íntegro.

Integrações oficiais

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

Integrações independentes de nuvem

A seção a seguir detalha as integrações .NET.NET Aspire agnósticas à nuvem, com links para suas respectivas documentações e pacotes NuGet, e fornece uma breve descrição de cada integração.

Para obter mais informações sobre como trabalhar com integrações de .NET Aspire no Visual Studio, consulte as ferramentas Visual Studio.

integrações Azure

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

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

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

Integrações do Kit de Ferramentas da Comunidade

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