Criar instantâneos na Configuração do Aplicativo com o Azure Pipelines

A tarefa de instantâneo da Configuração do Aplicativo do Azure foi projetada para criar instantâneos na Configuração do Aplicativo do Azure.

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.

1. No Azure DevOps, vá para o projeto que contém seu pipeline de destino. No canto inferior esquerdo, selecione Configurações do projeto.

2. Em Pipelines, selecione Ligações do serviço. No canto superior direito, selecione Nova conexão de serviço.

3. Em Nova conexão de serviço, selecione Gerenciador de Recursos do Azure.

   

4. 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.

5. 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.

1. Vá para Conexões do Serviço de Configurações>do Projeto.

2. Selecione a nova conexão de serviço.

3. Selecione Gerenciar entidade de serviço.

4. Observe o valor em Nome para exibição.

   

Adicionar atribuição de função

Atribua a atribuição de função de Configuração de Aplicativo adequada às credenciais que estão sendo usadas na tarefa para que a tarefa possa acessar o repositório de Configuração de Aplicativos.

1. Aceda à sua loja de Configuração de Aplicações de destino.

2. No menu à esquerda, selecione Controle de acesso (IAM).

3. No painel direito, selecione Adicionar atribuição de função.

   

4. Para a Função, selecione Proprietário dos Dados de Configuração do Aplicativo. Essa função permite que a tarefa leia e grave na App Configuration Store.

5. Selecione a entidade de serviço associada à conexão de serviço que você criou na seção anterior.

   

6. Selecione Rever + atribuir.

Uso em compilações

Nesta seção, saiba como usar a tarefa de instantâneo da Configuração do Aplicativo do Azure em um pipeline de compilação do Azure DevOps.

1. Navegue até a página do pipeline de construção clicando em Pipelines>Pipelines. Para obter mais informações sobre pipelines de compilação, acesse 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.

     

2. Procure a Tarefa de instantâneo de Configuração do Aplicativo do Azure.

   

3. Configure os parâmetros necessários para a tarefa criar um instantâneo em uma loja de configuração de aplicativos. Explicações dos parâmetros estão disponíveis na seção Parâmetros abaixo e em dicas de ferramentas ao lado de cada parâmetro.

   

4. 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

Nesta seção, saiba como usar a tarefa de instantâneo da Configuração do Aplicativo do Azure em um pipeline de lançamento do Azure DevOps.

1. Navegue até a página do pipeline de liberação selecionando Pipelines>Releases. Para obter mais informações sobre pipelines de liberação, vá para Criar seu primeiro pipeline.
2. Escolha um pipeline de liberação existente. Se não tiver um, selecione + Novo para criar um novo.
3. Selecione o botão Editar no canto superior direito para editar o pipeline de versão.
4. 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.

   

5. Clique ao + lado do trabalho ao qual você deseja adicionar uma nova tarefa.

   

6. Na caixa de diálogo Adicionar tarefas, digite o instantâneo da Configuração do Aplicativo do Azure na caixa de pesquisa e selecione-o.
7. Configure os parâmetros necessários dentro da tarefa para criar um instantâneo em sua loja de configuração de aplicativos. Explicações dos parâmetros estão disponíveis na seção Parâmetros abaixo e em dicas de ferramentas ao lado de cada parâmetro.
8. 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 de instantâneo de Configuração do Aplicativo:

• 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 os pontos de extremidade de armazenamento de configuração disponíveis na assinatura selecionada. Para atualizar sua lista de pontos de extremidade de armazenamento de configuração disponíveis, pressione o botão Refresh App Configuration Endpoint à direita da caixa de texto.

• Nome do snapshot: especifique o nome do snapshot.

• Tipo de composição: O valor padrão é Key.

  • Chave: Os filtros são aplicados em ordem para este tipo de composição. Cada valor-chave no snapshot é identificado exclusivamente apenas pela chave. Se houver vários valores-chave com a mesma chave e vários rótulos, apenas um valor-chave será retido com base no último filtro aplicável.

  • Key-Label: Os filtros serão aplicados e cada valor-chave no snapshot resultante será identificado exclusivamente pela chave e pelo rótulo juntos.

• Filtros: representa o filtro de chave e rótulo usado para criar um instantâneo de Configuração do Aplicativo. Os filtros devem ter um formato JSON válido. Exemplo [{"key":"abc*", "label":"1.0.0"}]. Pelo menos um filtro deve ser especificado e um máximo de três filtros pode ser especificado.

• Período de retenção: o valor padrão é 30 dias. Refere-se ao número de dias em que o instantâneo será retido após ser arquivado. Os snapshots arquivados podem ser recuperados durante o período de retenção.

• Tags: Um objeto JSON no formato de , que define tags que são adicionadas a cada instantâneo criado em sua loja de Configuração de {"tag1":"val1", "tag2":"val2"}Aplicativos.

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.

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.

Referência da tarefa de instantâneo de configuração do aplicativo do Azure

Para saber como exportar valores-chave da sua loja de Configuração de Aplicativos e defini-los como variáveis de pipeline do Azure, continue para o documento a seguir.

Exportar configurações da Configuração do Aplicativo com pipelines do Azure

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.

Importar configurações para a Configuração do Aplicativo com pipelines do Azure