Adicionar a Configuração de Aplicativos do Azure usando o Visual Studio Connected Services
Neste tutorial, você aprenderá a adicionar facilmente tudo o que precisa para começar a usar Configuração de Aplicativos do Azure para gerenciar sua configuração e sinalizadores de recursos para projetos Web no Visual Studio. Usando o recurso Serviços Conectados no Visual Studio, você pode fazer com que o Visual Studio adicione automaticamente todo o código, pacotes NuGet e configurações necessárias para se conectar ao recurso de Configuração de Aplicativo no Azure. Para usar esse recurso, você deve usar o Visual Studio 2019 versão 16.9 ou posterior.
Você pode usar o recurso Serviços Conectados de Configuração de Aplicativo nos seguintes tipos de projeto:
- ASP.NET Core
- Console do .NET Core
- Projetos do .NET Framework.
Pré-requisitos
- Visual Studio (consulte [Downloads do Visual Studio] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) com a carga de trabalho de desenvolvimento do Azure instalada.
- Um projeto de um dos tipos com suporte
- Uma conta do Azure. Se você não tiver uma conta Azure, ative seus benefícios do Azure para assinantes do Microsoft Visual Studio ou inscreva-se para uma avaliação gratuita.
Conectar-se a Configuração de Aplicativos do Azure usando serviços conectados
Abra o projeto no Visual Studio.
No Gerenciador de Soluções, clique com o botão direito do mouse no nó Serviços Conectados e, no menu de contexto, selecione Adicionar Serviço Conectado.
Na guia Serviços Conectados, selecione o ícone + para Dependências de Serviço.
Na página Adicionar Dependência, selecione Configuração de Aplicativos do Azure.
Se ainda não estiver conectado, entre em sua conta do Azure. Se não tiver uma conta do Azure, você poderá assinar uma versão de avaliação gratuita.
Na tela Configurar Configuração de Aplicativos do Azure, selecione sua assinatura e um repositório de configuração existente. Em seguida, selecione Avançar.
Se você precisar criar um repositório Configuração de Aplicativos, vá para a próxima etapa. Caso contrário, ignore a etapa 6.
Para criar um repositório de configuração de aplicativos:
Selecione o ícone + à direita do cabeçalho Armazenamentos da Configuração de Aplicativos.
Preencha o Configuração de Aplicativos do Azure: crie uma caixa de diálogo e selecione Criar. Observe que o campo Nome do Recurso precisa ser exclusivo.
Quando a caixa de diálogo Configuração de Aplicativos do Azure é exibida, o novo repositório de configuração aparece na lista. Selecione este novo repositório e selecione Avançar.
Insira um nome de cadeia de conexão e escolha se deseja que a cadeia de conexão seja armazenada em um arquivo de segredos local ou no Azure Key Vault.
A tela Resumo das alterações mostra todas as modificações que serão feitas no projeto se você concluir o processo. Se as alterações parecerem corretas, escolha Concluir.
Depois que o Processo de configuração de dependência for concluído, Configuração de Aplicativos do Azure agora aparecerá no nó Dependências de Serviço do seu projeto.
Abra o projeto no Visual Studio.
No Gerenciador de Soluções, clique com o botão direito do mouse no nó serviço Conectados e, no menu de contexto, selecione Adicionar para abrir o menu de serviços disponíveis.
Escolha Configuração de Aplicativos do Azure. A página Conectar-se à dependência é exibida.
Se ainda não estiver conectado, entre em sua conta do Azure. Se não tiver uma conta do Azure, você poderá assinar uma versão de avaliação gratuita.
Na tela Configurar Configuração de Aplicativos do Azure, selecione sua assinatura e um repositório de configuração existente. Em seguida, selecione Avançar.
Se você precisar criar um repositório Configuração de Aplicativos, vá para a próxima etapa. Caso contrário, ignore a etapa 6.
Para criar um repositório de configuração de aplicativos:
Selecione o ícone + à direita do cabeçalho Armazenamentos da Configuração de Aplicativos.
Preencha o Configuração de Aplicativos do Azure: crie uma caixa de diálogo e selecione Criar. Observe que o campo Nome do Recurso precisa ser exclusivo.
Quando a caixa de diálogo Configuração de Aplicativos do Azure é exibida, o novo repositório de configuração aparece na lista. Selecione este novo repositório e selecione Avançar.
Insira um nome de cadeia de conexão e escolha se deseja que a cadeia de conexão seja armazenada em um arquivo de segredos local ou no Azure Key Vault.
A tela Resumo das alterações mostra todas as modificações que serão feitas no projeto se você concluir o processo. Se as alterações parecerem corretas, escolha Concluir.
Depois que o Processo de configuração de dependência for concluído, Configuração de Aplicativos do Azure agora aparecerá no nó Dependências de Serviço do seu projeto.
No Gerenciador de Soluções, clique duas vezes no nó Serviços Conectados para abrir a guia Serviços Conectados. A conexão é exibida na seção Dependências de Serviço:
Há também uma entrada Secrets.json que dá suporte ao armazenamento seguro da cadeia de conexão localmente. Leia sobre como isso funciona na Captura de tela mostrando o armazenamento seguro de segredos do aplicativo no desenvolvimento em ASP.NET Core.
Se você clicar nos três pontos ao lado das dependências adicionadas, poderá ver várias opções, como Conectar para reabrir o assistente e alterar a conexão e, para Secrets.json, a opção de gerenciar segredos. Você também pode clicar nos três pontos no canto superior direito da janela para ver as opções para iniciar dependências locais, alterar as configurações e muito mais.