Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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 Definições do Projeto>Ligações de serviço.
Selecione a nova conexão de serviço.
Selecione Gerir Service Principal.
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.
Para Função, selecione Leitor de Dados de Configuração da Aplicação. Essa função permite que a tarefa seja lida na App Configuration Store.
Selecione o principal de serviço associado à ligação de serviço que criou na secção anterior.
Selecione Rever + atribuir.
Se o armazenamento contiver referências do Key Vault, aceda ao Key Vault relevante e atribua a função Key Vault Secret User ao service principal criado no passo 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.
Utilização 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.
- Aceda à página do pipeline de compilação clicando em Pipelines>Pipelines. Para consultar a documentação do pipeline de compilação, consulte Crie o seu primeiro pipeline.
- Se estiver a criar um novo pipeline de compilação, na última etapa do processo, no separador Rever, selecione Mostrar assistente à direita do pipeline.
- Se você estiver usando um pipeline de compilação existente, clique no botão Editar no canto superior direito.
- Pesquise por Exportação da Configuração da Aplicação 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.
- Guarde e coloque uma compilação em fila de espera. 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.
- Aceda à página do pipeline de lançamento selecionando Pipelines>Lançamentos. 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 lançamento.
- No menu pendente Tarefas, escolha a Fase à qual pretende adicionar a tarefa. Mais informações sobre estágios podem ser encontradas em Adicionar estágios, dependências, & condições.
- Clique em + ao lado do trabalho ao qual pretende adicionar uma nova tarefa.
- Procure pela tarefa Exportação de Configuração da Aplicação 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.
- Guarde e coloque uma versão em fila. 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 a sua lista de ligações de serviço do Azure disponíveis, prima o botão Atualizar subscrição do Azure à direita da caixa de texto.
- Ponto final da Configuração da Aplicação: Uma lista suspensa que carrega os pontos finais disponíveis dos armazenamentos de configuração na subscrição selecionada. Para atualizar e refrescar a sua lista de pontos finais disponíveis dos repositórios de configuração, prima o botão Atualizar o Ponto Final do App Configuration à 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 sobrepostas: a opção está desmarcada por predefinição. 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 registos de depuração podem ser ativados ao definir a variável de pipeline system.debug 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 dev sobrepõem-se às mesmas chaves com o rótulo predefinido.
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 aprender a criar um snapshot num arquivo App Configuration, consulte o documento seguinte.