Adicionando a Configuração do Aplicativo do Azure usando o Visual Studio Connected Services
Neste tutorial, você aprenderá como adicionar facilmente tudo o que precisa para começar a usar a Configuração do Aplicativo 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 definições de configuração necessários para se conectar ao seu recurso de Configuração de Aplicativo no Azure. Para usar esse recurso, você deve estar usando 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 Núcleo
- 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 de desenvolvimento do Azure instalada.
- Um projeto de um dos tipos apoiados
- Uma conta do Azure. Se não tiver uma conta do Azure, ative os seus benefícios do Azure para assinantes do Visual Studio ou inscreva-se para uma avaliação gratuita.
Conectar-se à Configuração do Aplicativo do Azure usando os Serviços Conectados
Abra seu projeto no Visual Studio.
No Explorador 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 aba Serviços Conectados, selecione o ícone + para as Dependências de Serviço .
Na página Adicionar Dependência, selecione Configuração de Aplicativos do Azure.
Se ainda não tiver sessão iniciada, inicie sessão na sua conta Azure. Se não tiver uma conta do Azure, pode inscrever-se para uma avaliação gratuita .
Na tela Configurar Configuração do Aplicativo do Azure, selecione sua assinatura e um repositório de configuração existente. Em seguida, selecione Avançar.
Se você precisar criar uma loja de configuração de aplicativos, vá para a próxima etapa. Caso contrário, pule para a etapa 6.
Para criar uma loja de configuração de aplicativos:
Selecione o ícone + à direita do cabeçalho App Configuration stores.
Preencha a caixa de diálogo Configuração do Aplicativo do Azure: Criar novo e selecione Criar. Observe que o campo Nome do recurso precisa ser exclusivo.
Quando a caixa de diálogo Configuração do Aplicativo do Azure é exibida, o novo repositório de configuração surge na lista. Selecione esta nova loja, em seguida selecione Seguinte.
Insira um nome de cadeia de conexão e escolha se deseja que a cadeia de conexão seja armazenada em um arquivo secreto local ou em Azure Key Vault.
A tela Resumo das alterações mostra todas as modificações que serão feitas no seu projeto se você concluir o processo. Se as alterações parecerem OK, escolha Concluir.
Depois que o processo de configuração de Dependência for concluído, a Configuração do Aplicativo do Azure agora aparecerá sob o nó Dependências de Serviço do seu projeto.
Abra seu 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 para abrir o menu de serviços disponíveis.
Escolha Configuração do Aplicativo do Azure. A página Conectar à dependência é exibida.
Se ainda não estiver autenticado, inicie sessão na sua conta do Azure. Se não tiver uma conta do Azure, pode inscrever-se para uma avaliação gratuita .
Na tela Configurar Configuração do Aplicativo do Azure, selecione sua assinatura e um repositório de configuração existente. Em seguida, selecione Avançar.
Se você precisar criar uma loja de configuração de aplicativos, vá para a próxima etapa. Caso contrário, pule para a etapa 6.
Para criar uma loja de configuração de aplicativos:
Selecione o ícone + à direita do cabeçalho App Configuration stores.
Preencha o diálogo Configuração do Aplicativo Azure : Criar novo e selecione Criar . Observe que o campo Nome do recurso precisa ser exclusivo.
Quando a janela de Configuração do Aplicação Azure é exibida, o novo repositório de configuração aparece na lista. Selecione esta nova loja e, em seguida, selecione Seguinte.
Insira um nome de cadeia de conexão e escolha se deseja que a cadeia de conexão seja armazenada em um arquivo secreto local ou em Azure Key Vault.
A tela Resumo das alterações mostra todas as modificações que serão feitas no seu projeto se você concluir o processo. Se as alterações parecerem bem, selecione Concluir.
Depois que o processo de configuração de Dependência for concluído, a Configuração do Aplicativo do Azure agora aparecerá sob o nó Dependências de Serviço do seu projeto.
No Explorador de Soluções, clique duas vezes no nó Serviços Conectados para abrir a aba Serviços Conectados. A conexão aparece na secção Dependências de Serviço:
Há também uma entrada Secrets.json que suporta armazenamento seguro da cadeia de conexão localmente. Leia sobre como isso funciona em Captura de tela mostrando o armazenamento seguro de segredos de aplicativos em desenvolvimento no ASP.NET Core.
Se clicares nos três pontos ao lado das dependências que adicionaste, podes ver várias opções, tais como Connect para reabrir o assistente e alterar a ligação; e para Secrets.json, a opção para gerir 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 configurações e muito mais.