Exportar definições da Configuração do Aplicativo com o Azure Pipelines
A tarefa Exportar Configuração de Aplicativo do Azure exporta valores-chave do seu repositório de Configuração de Aplicativo e os define como variáveis de pipeline do Azure, que as tarefas subsequentes podem consumir. Esta tarefa complementa a tarefa de Importação de Configuração de Aplicativo do Azure que importa valores-chave de um arquivo de configuração para sua loja de Configuração de Aplicativos. Para obter mais informações, consulte Importar configurações para a Configuração do Aplicativo com o Azure Pipelines.
Pré-requisitos
- Subscrição do Azure - crie uma gratuitamente
- App Configuration store - crie um gratuitamente
- Azure DevOps project - crie um gratuitamente
- Agente do Azure Pipelines versão 2.144.0 ou posterior e Node versão 16 ou posterior para executar a tarefa em agentes auto-hospedados.
Criar uma conexão de serviço
Uma conexão de serviço lhe dá acesso a recursos em sua assinatura do Azure a partir de seu projeto de DevOps do Azure.
No Azure DevOps, vá para o projeto que contém seu pipeline de destino. No canto inferior esquerdo, selecione Configurações do projeto.
Em Pipelines, selecione Ligações do serviço. No canto superior direito, selecione Nova conexão de serviço.
Em Nova conexão de serviço, selecione Gerenciador de Recursos do Azure.
Na caixa de diálogo Método de autenticação , selecione Federação de identidades de carga de trabalho (automática) para criar uma nova federação de identidades de carga de trabalho ou selecione Federação de identidades de carga de trabalho (manual) para usar uma federação de identidades de carga de trabalho existente.
Introduza a sua subscrição, grupo de recursos e um nome para a ligação de serviço.
Se você criou uma nova entidade de serviço, localize o nome da entidade de serviço atribuída à conexão de serviço. Você adicionará uma nova atribuição de função a essa entidade de serviço na próxima etapa.
Vá para Conexões do Serviço de Configurações>do Projeto.
Selecione a nova conexão de serviço.
Selecione Gerenciar entidade de serviço.
Observe o valor em Nome para exibição.
Adicionar atribuição de função
Atribua as atribuições de função de Configuração de Aplicativo adequadas às credenciais que estão sendo usadas na tarefa para que a tarefa possa acessar o repositório de Configuração de Aplicativos.
Aceda à sua loja de Configuração de Aplicações de destino.
No menu à esquerda, selecione Controle de acesso (IAM).
No painel direito, selecione Adicionar atribuições de função.
Em Função, selecione Leitor de Dados de Configuração do Aplicativo. Essa função permite que a tarefa seja lida na App Configuration Store.
Selecione a entidade de serviço associada à conexão de serviço que você criou na seção anterior.
Selecione Rever + atribuir.
Se o repositório contiver referências do Cofre da Chave, vá para o Cofre da Chave relevante e atribua a função Usuário Secreto do Cofre da Chave à entidade de serviço criada na etapa anterior. No menu Cofre da Chave, selecione Políticas de acesso e verifique se o controle de acesso baseado em função do Azure está selecionado como o modelo de permissão.
Uso em compilações
Esta seção aborda como usar a tarefa Exportar Configuração do Aplicativo do Azure em um pipeline de compilação do Azure DevOps.
- Navegue até a página do pipeline de construção clicando em Pipelines>Pipelines. Para obter a documentação do pipeline de compilação, consulte Criar seu primeiro pipeline.
- Se você estiver criando um novo pipeline de compilação, na última etapa do processo, na guia Revisão , selecione Mostrar assistente no lado direito do pipeline.
- Se você estiver usando um pipeline de compilação existente, clique no botão Editar no canto superior direito.
- Procure a Tarefa de Exportação de Configuração do Aplicativo do Azure.
- Para exportar os valores-chave da loja de Configuração de Aplicativos, configure os parâmetros necessários para a tarefa. As descrições dos parâmetros estão disponíveis na seção Parâmetros e em dicas de ferramentas ao lado de cada parâmetro.
- Defina o parâmetro de assinatura do Azure como o nome da conexão de serviço que você criou em uma etapa anterior.
- Defina o Ponto de Extremidade de Configuração do Aplicativo como o ponto de extremidade da sua loja de Configuração de Aplicativo.
- Deixe os valores padrão para os parâmetros restantes.
- Salve e enfileire uma compilação. O log de compilação exibe todas as falhas que ocorreram durante a execução da tarefa.
Utilização em versões
Esta seção aborda como usar a tarefa Exportar Configuração do Aplicativo do Azure em um pipeline de lançamento do Azure DevOps.
- Navegue até a página do pipeline de liberação selecionando Pipelines>Releases. Para obter a documentação do pipeline de liberação, consulte Release pipelines.
- Escolha um pipeline de liberação existente. Se você não tiver um, clique em Novo pipeline para criar um novo.
- Selecione o botão Editar no canto superior direito para editar o pipeline de versão.
- Na lista suspensa Tarefas, escolha o Palco ao qual você deseja adicionar a tarefa. Mais informações sobre estágios podem ser encontradas em Adicionar estágios, dependências, & condições.
- Clique ao + lado do Trabalho ao qual você deseja adicionar uma nova tarefa.
- Procure a Tarefa de Exportação de Configuração do Aplicativo do Azure.
- Para exportar seus valores-chave da sua loja de configuração de aplicativos, configure os parâmetros necessários dentro da tarefa. As descrições dos parâmetros estão disponíveis na seção Parâmetros e em dicas de ferramentas ao lado de cada parâmetro.
- Defina o parâmetro de assinatura do Azure como o nome da conexão de serviço que você criou em uma etapa anterior.
- Defina o Ponto de Extremidade de Configuração do Aplicativo como o ponto de extremidade da sua loja de Configuração de Aplicativo.
- Deixe os valores padrão para os parâmetros restantes.
- Salve e enfileire uma versão. O log de liberação exibe todas as falhas encontradas durante a execução da tarefa.
Parâmetros
Os seguintes parâmetros são usados pela tarefa Exportar Configuração do Aplicativo do Azure:
- Assinatura do Azure: uma lista suspensa que contém suas conexões de serviço do Azure disponíveis. Para atualizar e atualizar sua lista de conexões de serviço do Azure disponíveis, pressione o botão Atualizar assinatura do Azure à direita da caixa de texto.
- Ponto de extremidade de configuração do aplicativo: uma lista suspensa que carrega seus pontos de extremidade de armazenamento de configuração disponíveis sob a assinatura selecionada. Para atualizar e atualizar sua lista de pontos de extremidade de armazenamentos de configuração disponíveis, pressione o botão Refresh App Configuration Endpoint à direita da caixa de texto.
- Modo de seleção: especifica como os valores-chave lidos de um repositório de configuração são selecionados. O modo de seleção 'Padrão' permite o uso de filtros de chave e etiqueta. O modo de seleção 'Snapshot' permite que valores-chave sejam selecionados a partir de um instantâneo. O valor padrão é Default.
- Filtro de chave: o filtro pode ser usado para selecionar quais valores-chave são solicitados na Configuração do Aplicativo do Azure. Um valor de * seleciona todos os valores-chave. Para obter mais informações sobre, consulte Consultar valores-chave.
- Label: especifica qual rótulo deve ser usado ao selecionar valores-chave na App Configuration Store. Se nenhum rótulo for fornecido, os valores-chave com o rótulo no serão recuperados. Os seguintes caracteres não são permitidos: , *.
- Nome do instantâneo: especifica o instantâneo do qual os valores-chave devem ser recuperados na Configuração do Aplicativo do Azure.
- Prefixo da chave de corte: especifica um ou mais prefixos que devem ser cortados das chaves de configuração do aplicativo antes de defini-los como variáveis. Um caractere de nova linha pode ser usado para separar vários prefixos.
- Suprimir aviso para chaves substituídas: o valor padrão está desmarcado. Especifica se os avisos devem ser exibidos quando as chaves existentes forem substituídas. Habilite essa opção quando for esperado que os valores-chave baixados da Configuração do Aplicativo tenham chaves sobrepostas com o que existe nas variáveis de pipeline.
Usar valores-chave em tarefas subsequentes
Os valores-chave que são buscados na Configuração do Aplicativo são definidos como variáveis de pipeline, que são acessíveis como variáveis de ambiente. A chave da variável de ambiente é a chave do valor-chave que é recuperada da Configuração do Aplicativo depois de cortar o prefixo, se especificado.
Por exemplo, se uma tarefa subsequente executar um script do PowerShell, ela poderá consumir um valor-chave com a chave 'myBuildSetting' da seguinte forma:
echo "$env:myBuildSetting"
E o valor é impresso no console.
Nota
As referências do Azure Key Vault na Configuração do Aplicativo serão resolvidas e definidas como variáveis secretas. Nos pipelines do Azure, as variáveis secretas são mascaradas do log. Eles não são passados para tarefas como variáveis de ambiente e, em vez disso, devem ser passados como entradas.
Resolução de Problemas
Se ocorrer um erro inesperado, os logs de depuração podem ser habilitados definindo a variável system.debug de pipeline como true.
FAQ
Como faço para compor minha configuração a partir de várias chaves e rótulos?
Há momentos em que a configuração pode precisar ser composta a partir de vários rótulos, por exemplo, padrão e dev. Várias tarefas de Configuração de Aplicativo podem ser usadas em um pipeline para implementar esse cenário. Os valores-chave obtidos por uma tarefa em uma etapa posterior substituem quaisquer valores das etapas anteriores. No exemplo acima mencionado, uma tarefa pode ser usada para selecionar valores-chave com o rótulo padrão, enquanto uma segunda tarefa pode selecionar valores-chave com o rótulo de desenvolvimento. As chaves com o rótulo de desenvolvimento substituem as mesmas teclas pelo rótulo padrão.
Próximo passo
Para obter uma referência completa dos parâmetros ou para usar essa tarefa de pipeline em pipelines YAML, consulte o seguinte documento.
Para saber como importar valores-chave de um arquivo de configuração para sua loja de configuração de aplicativos, continue para o documento a seguir.
Para saber como criar instantâneo em uma loja de configuração de aplicativos, continue para o documento a seguir.