Compartilhar via


Conectar-se aos serviços do Azure, gRPC, OpenAPI e muito mais

Os desenvolvedores estão criando aplicativos com um número crescente de serviços, mas as tecnologias de serviço estão evoluindo tão rápido quanto.

Com os Serviços Conectados do Visual Studio, você obtém uma experiência de consumo de serviço moderna, que permite que cada serviço adapte a experiência de consumo lhe fazendo perguntas relevantes necessárias para você começar rapidamente.

Os Serviços Conectados incluem uma coleção de ferramentas no Visual Studio que ajudam você a conectar seu aplicativo ao seguinte:

  • serviços do Azure
  • Pontos de extremidade OpenAPI
  • Pontos de extremidade gRPC (Chamada de Procedimento Remoto)
  • Pontos de extremidade do WCF (Windows Communication Foundation)
  • Bancos de dados e provedores de dados

Comece clicando com o botão direito do mouse no nó Serviços Conectados no Gerenciador de Soluções e selecione Gerenciar Serviços Conectados.

Comece clicando com o botão direito do mouse no nó do projeto e escolhendo Adicionar > Serviço Conectado. Você também pode clicar com o botão direito do mouse no nó Serviços Conectados no do Gerenciador de Soluções e escolher um serviço específico a ser adicionado.

Os tipos de projeto com suporte variam de acordo com o tipo de serviço. Você verá as opções que se aplicam ao tipo de projeto nas seleções listadas.

Várias assinaturas do Visual Studio incluem créditos de Desenvolvimento/Teste individual do Azure. Se você for assinante do Visual Studio, poderá usar esses créditos para experimentar vários serviços do Azure sem custo. Se você não for assinante e não tiver uma assinatura do Azure, poderá criar uma conta gratuita.

Conectar seu aplicativo aos serviços do Azure

Use os Serviços Conectados para conectar seu aplicativo a emuladores de serviços do Azure dinâmicos e outras alternativas locais aos serviços do Azure. No momento, o Visual Studio dá suporte ao seguinte:

Nome Descrição
Configuração de Aplicativos Azure Acessar configurações de chave-valor e sinalizadores de recursos que são gerenciados de maneira centralizada no Azure.
Azure App Insights Fornece gerenciamento extensível de desempenho de aplicativos e monitoramento para aplicativos Web dinâmicos.
Serviço de Aplicativo do Azure Fornece hospedagem de serviço completo e escalonável para aplicativos web em tempo real.
Azure Functions Fornece serviços escalonáveis de computação sob demanda para APIs Web e muito mais.
Armazenamento do Azure Armazenamento em nuvem escalonável com suporte para blobs, tabelas, filas, discos.
Serviço SignalR do Azure Funcionalidade da Web em tempo real via HTTP.
Azure Key Vault Proteja o armazenamento em nuvem para chaves criptográficas e outros segredos usados por seus aplicativos do Azure.
Banco de Dados SQL do Azure Banco de Dados SQL hospedado na nuvem.
Cache do Azure para Redis Armazenamento de dados na memória com base no software Redis.
Azure Cosmos DB Um banco de dados NoSQL totalmente gerenciado para desenvolvimento de aplicativos modernos.
Plataforma de Identidade da Microsoft Autenticação com identidades e contas sociais da Microsoft.

Nota

Usando o Publish, você pode implantar seu aplicativo em serviços de hospedagem do Azure, como VMs do Azure, Serviço de Aplicativo do Azure, Azure Functions e Registro de Contêiner do Azure

Bancos de dados e provedores de dados

O Visual Studio fornece opções para se conectar a bancos de dados locais, versões emuladas localmente de provedores de dados, bem como serviços de banco de dados do Azure.

Nome Descrição
Emulador do Azure Cosmos DB no contêiner Emulador do Azure Cosmos DB em execução em um contêiner local.
MongoDB em contêiner Os bancos de dados de documentos do MongoDB fornecem alta confiabilidade e escalabilidade fácil. Essa opção a disponibiliza em um contêiner local.
PostgreSQL em contêiner O PostgreSQL é um sistema de banco de dados relacional de objeto que fornece confiabilidade e integridade de dados. Essa opção a disponibiliza em um contêiner local.
SQLite O SQLite é uma biblioteca interna que fornece um mecanismo de banco de dados SQL transacional independente sem necessidade de configuração.
Banco de dados SQL Server Banco de Dados do SQL Server local.

Suporte para emuladores do Azure e alternativas locais

O Visual Studio facilita o desenvolvimento de aplicativos do Azure localmente, facilitando a transição de serviços emulados localmente para serviços em execução na nuvem. Você pode usar os Serviços Conectados para conectar seu aplicativo a emuladores locais, alguns dos quais executados em um contêiner local e outras alternativas locais aos serviços do Azure. No momento, o Visual Studio dá suporte ao seguinte:

O Visual Studio gera qualquer código de cliente ou servidor necessário para facilitar a comunicação.

Nome Descrição
Emulador do Azure Cosmos DB no contêiner Emulador do Azure Cosmos DB em execução em um contêiner local.
Emulador de Armazenamento do Azure O Azurite é um emulador de Armazenamento do Azure executado em seu computador local.
SDK do Application Insights Modo local para o serviço Application Insights.
RabbitMQ no contêiner RabbitMQ é um agente de mensagens multiprotocol de software livre. Essa opção a disponibiliza em um contêiner local.
Cache do Azure para Redis em contêiner Cache do Azure para Redis hospedado em um contêiner local.
Secrets.json Alternativa local para o Key Vault.
LocalDB do SQL Server Express Alternativa local ao Banco de Dados SQL do Azure.

Conectar seu aplicativo a pontos de extremidade gRPC, OpenAPI e WCF

Use os Serviços Conectados para conectar seu aplicativo a qualquer um dos seguintes serviços:

Nome Link do ASP.NET Descrição
Pontos de extremidade OpenAPI Suporte a OpenAPI nos aplicativos de API do ASP.NET Core Um formato padrão para descrever as funcionalidades de um serviço na forma legível por computador e legível por humanos.
Pontos de extremidade gRPC Introdução aos serviços gRPC no .NET Um serviço de chamada de procedimento em tempo real de código aberto.
Pontos de extremidade do WCF N/A Uma solução do .NET Framework que dá suporte à programação com uma rede distribuída de serviços.

Contêineres

Os Serviços Conectados podem ajudá-lo a executar dependências de aplicativo que estão emulando serviços do Azure localmente em um contêiner. Por exemplo, você pode executar o emulador de Armazenamento do Azure chamado Azurite em um contêiner localmente. A próxima seção descreve o suporte que o Visual Studio fornece para fazer a transição de seu aplicativo do modo de desenvolvimento, quando você estiver usando esses serviços fictícios em contêineres, para usar os serviços reais em execução no Azure.

Configurações locais e conectadas

Durante o desenvolvimento, você geralmente usa um emulador local, um banco de dados local ou um serviço fictício em execução em um contêiner local. Quando você usa o processo de publicação no Visual Studio para implantar na nuvem, seja no Azure, no Docker Hub ou em outro ambiente remoto com suporte, o Visual Studio pode orientá-lo durante a transição para se conectar aos serviços e bancos de dados reais. Ao clicar com o botão direito do mouse no nó do projeto no Gerenciador de Soluções e escolher Publicar, você será guiado pela implantação do aplicativo na nuvem, mas depois disso, as dependências de serviço configuradas anteriormente para uso local agora são mostradas na interface do usuário dos Serviços Conectados com um ícone de cuidado amarelo e um link Configurar:

Captura de tela mostrando a opção Configurar na guia Serviços Conectados.

Se você clicar nesses links, o Visual Studio apresentará algumas telas que solicitam as informações de conexão para o serviço "real" em execução na nuvem que seu aplicativo de nuvem usará em vez do serviço local. Por exemplo, se você inicialmente configurou um aplicativo para ser executado com uma instância em execução local do SQL LocalDB, você teria fornecido um nome de cadeia de conexão e um valor inicial que fazia referência a esse banco de dados LocalDB. Depois que seu aplicativo for implantado pela primeira vez em um ambiente de nuvem, você poderá usar o Configurar links para especificar a cadeia de conexão a ser usada na nuvem. Para cenários de implantação do Azure, o Visual Studio também oferece a opção de usar um do Azure Key Vault para armazenar com segurança a cadeia de conexão e outros segredos.

Captura de tela mostrando as opções apresentadas para substituir o serviço SQL LocalDB por uma conexão de banco de dados real.

Como funciona

O Visual Studio cria dois novos arquivos visíveis no Gerenciador de Soluções em Propriedades chamadas serviceDependencies.json e serviceDependencies.local.json. Esses dois arquivos são seguros para serem enviados, pois não contêm segredos.

O Visual Studio também cria um arquivo chamado serviceDependencies.local.json.user que não está visível no Gerenciador de Soluções por padrão. Esse arquivo contém informações que podem ser consideradas um segredo (por exemplo, IDs de recurso no Azure) e não recomendamos que você faça check-in.