Exportar configurações da configuração do aplicativo com pipelines do Azure
A tarefa Exportação de Configuração de Aplicativo do Azure exporta valores-chave do repositório de Configuração de Aplicativos e os define como variáveis de pipeline do Azure, que as tarefas subsequentes podem consumir. Essa tarefa complementa a tarefa Importação de Configuração de Aplicativo do Azure que importa valores-chave de um arquivo de configuração para o repositório de Configuração de Aplicativos. Para obter mais informações, consulte As configurações de importação para a Configuração de Aplicativos com o Azure Pipelines.
Pré-requisitos
- Assinatura do Azure - criar uma gratuitamente
- Repositório da Configuração de Aplicativos - crie um gratuitamente
- Projeto do Azure DevOps: crie um gratuitamente
- O agente do Azure Pipelines versão 2.144.0 ou posterior e o 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 aos recursos na sua assinatura do Azure por meio do projeto do Azure DevOps.
No Azure DevOps, acesse o projeto que contém o pipeline de destino. No canto inferior esquerdo, selecione Configurações do projeto.
Em Pipelines, selecione Conexões de serviço. No canto superior direito, selecione Nova conexão de serviço.
Em Nova conexão de serviço. selecione Azure Resource Manager.
Na caixa de diálogo Método de autenticação, selecione Federação de identidades de carga de trabalho (automática) para criar uma federação de identidades de carga de trabalho ou Federação de identidades de carga de trabalho (manual) para usar uma federação de identidades de carga de trabalho existente.
Insira sua assinatura, grupo de recursos e um nome para a conexão de serviço.
Se você criou uma entidade de serviço, localize o nome da entidade de serviço atribuída à conexão de serviço. Você adicionará uma atribuição de função a essa entidade de serviço na próxima etapa.
Acesse Configurações do Projeto>Conexões de serviço.
Selecione a nova conexão de serviço.
Selecione Gerenciar Entidade de Serviço.
Observe o valor em Nome de exibição.
Adicionar atribuição de função
Designe as atribuições de função de configuração de aplicativo adequadas às credenciais que estão sendo usadas dentro da tarefa para que a tarefa possa acessar o repositório de Configuração de Aplicativos.
Acesse o repositório de destino da Configuração de Aplicativos.
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 da Configuração de Aplicativos. Essa função permite que a tarefa seja lida no repositório da Configuração de Aplicativos.
Selecione a entidade de serviço associada à conexão de serviço criada na seção anterior.
Selecione Examinar + atribuir.
Se o repositório contiver referências ao Key Vault, vá para o Key Vault relevante e atribua a função de Usuário Secreto do Key Vault à entidade de serviço criada na etapa anterior. No menu do Key Vault, selecione Políticas de acesso e verifique se o controle de acesso baseado em função do Azure está selecionado como modelo de permissão.
Uso em builds
Esta seção aborda como usar a tarefa Exportação de Configuração de Aplicativos do Azure em um pipeline de build do Azure DevOps.
- Acesse a página do pipeline de build clicando em Pipelines>Pipelines. Para obter a documentação do pipeline de build, confira Criar seu primeiro pipeline.
- Se você estiver criando um pipeline de build, na última etapa do processo, na guia Examinar, selecione Mostrar assistente no lado direito do pipeline.
- Se você estiver usando um pipeline de build existente, clique no botão Editar no canto superior direito.
- Pesquise a tarefa Exportação de Configuração de Aplicativos do Azure.
- Para exportar os valores-chave do repositório 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 nas dicas de ferramenta ao lado de cada parâmetro.
- Defina o parâmetro de assinatura do Azure com o nome da conexão de serviço que você criou em uma etapa anterior.
- Defina o ponto de extremidade Configuração de Aplicativos como o ponto de extremidade do seu repositório de Configuração de Aplicativos.
- Mantenha os valores padrão nos parâmetros restantes.
- Salve e coloque um build na fila. O log de compilação exibe quaisquer falhas que ocorreram durante a execução da tarefa.
Uso em versões
Esta seção aborda como usar a tarefa Exportação de Configuração de Aplicativos do Azure em um pipeline de versão do Azure DevOps.
- Acesse a página do pipeline de lançamento selecionando Pipelines>Versões. Para obter a documentação do pipeline de lançamento, confira Pipelines de lançamento.
- Escolha um pipeline de lançamento existente. Se não tiver um, clique em Novo pipeline para criar um.
- Selecione o botão Editar no canto superior direito para editar o pipeline de lançamento.
- Na lista suspensa Tarefas, escolha a Fase à qual deseja adicionar a tarefa. Mais informações sobre estágios podem ser encontradas em Adicionar estágios, dependências e condições.
- Clique em + próximo ao trabalho ao qual deseja adicionar uma tarefa.
- Pesquise a tarefa Exportação de Configuração de Aplicativos do Azure.
- Para exportar seus valores-chave do repositório 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 nas dicas de ferramenta ao lado de cada parâmetro.
- Defina o parâmetro de assinatura do Azure com o nome da conexão de serviço que você criou em uma etapa anterior.
- Defina o ponto de extremidade Configuração de Aplicativos como o ponto de extremidade do seu repositório de Configuração de Aplicativos.
- Mantenha os valores padrão nos parâmetros restantes.
- Salve e coloque uma versão na fila. O log de liberação exibe quaisquer falhas encontradas durante a execução da tarefa.
Parâmetros
Os seguintes parâmetros são usados pela tarefa Exportação de Configuração de Aplicativos do Azure:
- Assinatura do Azure: uma lista suspensa que contém as conexões de serviço do Azure disponíveis. Para atualizar a 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 da Configuração de Aplicativos: um menu suspenso que carrega os pontos de extremidade de armazenamento de configuração disponíveis na assinatura selecionada. Para atualizar a lista de pontos de extremidade de armazenamento de configuração disponíveis, pressione o botão Atualizar o ponto de extremidade da Configuração de Aplicativos à 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 rótulo. O modo de seleção "Instantâneo" permite que os valores-chave sejam selecionados de um instantâneo. O valor padrão é Padrão.
- Filtro de Chave: o filtro pode ser usado para selecionar quais valores de chave são solicitados pela Configuração de Aplicativos do Azure. Um valor de * seleciona todos os valores-chave. Para obter mais informações, confira Consultar valores de chave.
- Rótulo: especifica qual rótulo deve ser usado na seleção de valores de chave do repositório da Configuração de Aplicativos. Se nenhum rótulo for fornecido, os valores de chave sem rótulo 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 de Aplicativos do Azure.
- Recortar Prefixo de Chave: especifica um ou mais prefixos que devem ser cortados das chaves da Configuração de Aplicativos antes de configurá-los como variáveis. Um caractere de nova linha pode ser usado para separar vários prefixos.
- Suprimir aviso de chaves substituídas: o valor padrão está desmarcado. Especifica se é necessário mostrar avisos quando as chaves existentes são substituídas. Habilite essa opção quando se espera que os valores-chave baixados da Configuração de Aplicativos tenham chaves sobrepostas com o que existe em variáveis de pipeline.
Usar valores de chave nas tarefas seguintes
Os valores de chave que são buscados na Configuração de Aplicativos 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 de chave recuperada da Configuração de Aplicativos após o recorte do prefixo, se especificado.
Por exemplo, se uma tarefa seguinte executar um script do PowerShell, ela poderá consumir um valor de chave com a chave 'myBuildSetting' desta forma:
echo "$env:myBuildSetting"
E o valor é impresso no console.
Observação
As referências do Azure Key Vault dentro da Configuração de Aplicativos serão resolvidas e definidas como variáveis secretas. No Azure Pipelines, as variáveis secretas são mascaradas do log. Elas não são passadas para tarefas como variáveis de ambiente e, em vez disso, devem ser passadas como entradas.
Solução de problemas
Em caso de um erro inesperado, os logs de depuração podem ser habilitados pela configuração da variável de pipeline system.debug como true.
Perguntas frequentes
Como fazer para compor minha configuração com base em uma variedade de chaves e rótulos?
Há ocasiões em que a configuração pode precisar ser composta com base em vários rótulos, por exemplo, padrão e desenvolvimento. Várias tarefas da Configuração de Aplicativos podem ser usadas em um pipeline para implementar esse cenário. Os valores-chave buscados por uma tarefa em uma etapa posterior substituem todos os valores das etapas anteriores. No exemplo acima, uma tarefa pode ser usada para selecionar valores de chave com o rótulo padrão, enquanto uma segunda tarefa pode selecionar valores de chave com o rótulo de desenvolvimento. As chaves com o rótulo de desenvolvimento substituem as mesmas chaves com o rótulo padrão.
Próxima etapa
Para 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 seu repositório de Configuração de Aplicativos do Azure, continue lendo o documento a seguir.
Para saber como criar um snapshot em um armazenamento de Configuração de Aplicativos do Azure, continue lendo o documento a seguir.