Tutorial: Integração contínua de modelos do ARM com o Azure Pipelines

Artigo
09/26/2024

No tutorial anterior, você implantou um modelo vinculado. Neste tutorial, você aprende a usar o Azure Pipelines para criar e implantar continuamente projetos de modelo do ARM (Azure Resource Manager).

O Azure DevOps fornece serviços de desenvolvedor para capacitar as equipes a fim de planejar o trabalho, colaborar com o desenvolvimento de código e criar e implantar aplicativos. Os desenvolvedores podem trabalhar na nuvem usando o Azure DevOps Services. O Azure DevOps fornece um conjunto integrado de recursos que pode ser acessado por meio do seu navegador da Web ou do cliente do IDE. O Azure Pipelines é um desses recursos. O Azure Pipelines é um serviço CI (integração contínua) e CD (entrega contínua) cheio de recursos. Ele funciona com seu provedor Git de preferência e pode ser implantado na maioria dos principais serviços de nuvem. É possível automatizar o build, o teste e a implantação do seu código para Microsoft Azure, Google Cloud Platform ou Amazon Web Services.

Observação

Escolha um nome de projeto. Ao percorrer o tutorial, substitua qualquer ARMPipelineProj pelo nome do projeto. Esse nome do projeto é usado para gerar nomes de recurso. Um dos recursos é uma conta de armazenamento. Os nomes da conta de armazenamento devem ter entre 3 e 24 caracteres, usar números e apenas letras minúsculas. O nome deve ser exclusivo. No modelo, o nome da conta de armazenamento é o nome do projeto com store acrescentado e o nome do projeto deve ter entre 3 e 11 caracteres. Portanto, o nome do projeto deve atender aos requisitos de nome da conta de armazenamento e ter menos de 11 caracteres.

Este tutorial cobre as seguintes tarefas:

Preparar um repositório GitHub
Criar um projeto de DevOps do Azure
Criar um pipeline do Azure
Verificar a implantação do pipeline
Atualizar o modelo e reimplantar
Limpar os recursos

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Pré-requisitos

Para concluir este artigo, você precisa do seguinte:

Uma conta do GitHub, em que você a usa para criar um repositório para seus modelos. Se não tiver uma, poderá criá-la gratuitamente. Para saber mais sobre como usar os repositórios GitHub, confira Criar repositórios GitHub.
Instalar o Git. Essa instrução tutorial usa o Git Bash ou o Git Shell. Para obter instruções, confira Instalar o Git.
Uma organização do Azure DevOps. Se não tiver uma, poderá criá-la gratuitamente. Confira Criar uma coleção de projeto ou organização.
(opcional) Visual Studio Code com a extensão de Ferramentas do Resource Manager. Confira Início Rápido: Criar modelos do ARM com o Visual Studio Code.

Preparar um repositório GitHub

O GitHub é usado para armazenar o código-fonte do seu projeto incluindo modelos do Resource Manager. Para ver outros repositórios compatíveis, confira repositórios compatíveis com o Azure DevOps.

Criar um repositório GitHub

Se você não tiver uma conta do GitHub, confira Pré-requisitos.

Entre no GitHub.
Selecione sua imagem de conta no canto superior direito e, em seguida, selecione Seus repositórios.
Selecione Novo, um botão verde.
No Nome do repositório, insira um nome do repositório. Por exemplo, ARMPipeline-repo. Substitua qualquer ARMPipeline pelo nome do projeto. É possível selecionar público ou privado para percorrer este tutorial. E, em seguida, selecione Criar repositório.
Anote a URL. A URL do repositório é o seguinte formato: https://github.com/[YourAccountName]/[YourRepositoryName] .

Esse repositório é conhecido como um repositório remoto. Cada um dos desenvolvedores do mesmo projeto pode clonar o próprio repositório local e mesclar as alterações no repositório remoto.

Clonar o repositório remoto

Abra o Git Shell ou o Git Bash. Consulte Pré-requisitos.
Verifique se sua pasta atual é GitHub.
Execute o comando a seguir:
```
git clone https://github.com/[YourAccountName]/[YourGitHubRepositoryName]
cd [YourGitHubRepositoryName]
mkdir create_web_app
cd create_web_app
pwd
```
Substitua o [YourAccountName] pelo nome da conta do GitHub e [YourGitHubRepositoryName] pelo nome do repositório criado no procedimento anterior.

A pasta create_web_app é a pasta em que o modelo é armazenado. O comando pwd mostra o caminho da pasta. O caminho é local em que você salva o modelo no procedimento a seguir.

Baixar um Modelo de início rápido

Em vez de criar os modelos, você pode baixá-los e salvá-los na pasta create_web_app.

O nome da pasta e o nome do arquivo são usados como estão no pipeline. Se você alterar esses nomes, deverá atualizar os nomes usados no pipeline.

Enviar por push o modelo para o repositório remoto

O azuredeploy.json foi adicionado ao repositório local. Em seguida, faça upload do modelo para o repositório remoto.

Abra o Git Shell ou o Git Bash, se ainda não estiver aberto.
Altere o diretório para a pasta create_web_app em seu repositório local.
Verifique se o arquivo azuredeploy.json está na pasta.
Execute o comando a seguir:
```
git add .
git commit -m "Add web app templates."
git push origin main
```
Você pode receber um aviso sobre LF. É possível ignorá-lo. A main é a ramificação principal. Normalmente, você cria um branch para cada atualização. Para simplificar o tutorial, use a ramificação principal diretamente.
Navegue até o repositório GitHub em um navegador. A URL é https://github.com/[YourAccountName]/[YourGitHubRepository]. Você verá a pasta create_web_app e os dois arquivos dentro dela.
Selecione azuredeploy.json para abrir o modelo.
Selecione a botão Bruto. A URL começa com https://raw.githubusercontent.com.
Faça uma cópia da URL. Você precisará fornecer esse valor quando configurar o pipeline posteriormente no tutorial.

Até agora, você criou um repositório GitHub e carregou os modelos para o repositório.

Criar um projeto de DevOps

Uma organização de DevOps é necessária antes de poder passar para o próximo procedimento. Se você não tiver uma, confira Pré-requisitos.

Entre no Azure DevOps.
Selecione uma organização de DevOps à esquerda e selecione Novo projeto. Se você não tiver nenhum projeto, a página criar projeto será aberta automaticamente.
Insira os valores a seguir:
- Nome do projeto: insira um nome para o projeto. É possível usar o nome do projeto selecionado no começo do tutorial.
- Visibilidade: selecione Privado.
Use o valor padrão para outras propriedades.
Selecione Criar.

Crie uma conexão de serviço usada para implantar projetos no Azure.

Selecione as Configurações do projeto na parte inferior do menu esquerdo.
Selecione Conexões de serviço em Pipelines.
Selecione Criar conexão de serviço, Azure Resource Manager e Avançar.
Selecione Service principal (automatic) e Next.
Insira os valores a seguir:
- Nível do escopo: selecione Assinatura.
- Assinatura: selecione sua assinatura.
- Grupo de Recursos: Deixe em branco.
- Nome da conexão: insira um nome para a conexão. Por exemplo, ARMPipeline-conn. Anote esse nome; você precisará dele ao criar seu pipeline.
- Conceder permissão de acesso a todos os pipelines. (selecionado)
Clique em Salvar.

Criar um pipeline

Até agora, você concluiu as seguintes tarefas. Se você ignorar as seções anteriores porque conhece o GitHub e o DevOps, será necessário concluir as tarefas antes de continuar.

Crie um repositório GitHub e salve os modelos na pasta create_web_app no repositório.
Crie um projeto de DevOps e uma conexão de serviço do Azure Resource Manager.

Para criar um pipeline com uma etapa para implantar um modelo:

Selecione Pipelines no menu esquerdo.
Escolha Criar pipeline.
Na guia Conectar, selecione GitHub. Se solicitado, insira suas credenciais do GitHub e siga as instruções. Se você vir a tela a seguir, selecione Selecionar apenas repositórios e verifique se seu repositório está na lista antes de selecionar Aprovar e instalar.
Na guia Selecionar, selecione seu repositório. O nome padrão é [YourAccountName]/[YourGitHubRepositoryName].
Na guia Configurar, selecione Pipeline inicial. Ela mostra o arquivo de pipeline azure-pipelines.yml com duas etapas de script.
Exclua as duas etapas de script do arquivo .yml.
Mova o cursor para a linha após etapas: .
Selecione Mostrar assistente à direita da tela para abrir o painel Tarefas.
Selecione Implantação de modelo do ARM.
Insira os valores a seguir:
- deploymentScope: Selecione Grupo de Recursos. Para saber mais sobre os escopos, confira Escopos de implantação.
- Conexão do Azure Resource Manager: especifique o nome da conexão de serviço criada anteriormente.
- Assinatura: especifique a ID da assinatura de destino.
- Ação: selecionar a ação Criar ou Atualizar Grupo de Recursos executa 2 ações – 1. criar um grupo de recursos se um novo nome de grupo de recursos for fornecido; 2. implantar o modelo especificado.
- Grupo de recursos: insira um nome para o novo grupo de recursos. Por exemplo, ARMPipeline-rg.
- Localização: selecione um local para o grupo de recursos, por exemplo, EUA Central.
- Localização do modelo: selecione a URL do arquivo, o que significa que a tarefa procura o arquivo de modelo usando a URL. Como relativePath é usado no modelo principal e relativePath é compatível apenas com implantações baseadas em URI, você deve usar a URL aqui.
- Link do modelo: insira a URL que você obteve ao final da seção Preparar um repositório GitHub. Começa com https://raw.githubusercontent.com .
- Link dos parâmetros do modelo: deixe este campo em branco. Você especificará os valores de parâmetro em Substituir parâmetros de modelo.
- Substituir parâmetros de modelo: digite -projectName [EnterAProjectName] .
- Modo de implantação: selecione Incremental.
- Nome da implantação: digite DeployPipelineTemplate. Selecione Avançado antes de poder ver o Nome da implantação.
Selecione Adicionar.

Para obter mais informações sobre a tarefa, confira Tarefa de implantação de grupo de recursos do Azure e Tarefa de implantação de modelo do Azure Resource Manager

O arquivo .yml deve ser semelhante a:
Selecione Salvar e executar.
No painel Salvar e executar, selecione Salvar e executar novamente. Uma cópia do arquivo YAML é salva no repositório conectado. É possível ver o arquivo YAML navegando até seu repositório.
Verifique se o pipeline foi executado com êxito.

Verificar a implantação

Entre no portal do Azure.
Abra o grupo de recursos. O nome é o que você especificou no arquivo YAML do pipeline. Você verá uma conta de armazenamento criada. O nome da conta de armazenamento começa com store.
Selecione o nome da conta de armazenamento para abri-la.
Selecione Propriedades. Observe que a Replicação é LRS (armazenamento com redundância local) .

Atualizar e reimplantar

Quando você atualiza o modelo e envia as alterações por push para o repositório remoto, o pipeline atualiza os recursos automaticamente, a conta de armazenamento neste caso.

Abra linkedStorageAccount.json em seu repositório local no Visual Studio Code ou em qualquer editor de texto.
Atualize o defaultValue de storageAccountType para Standard_GRS. Veja a seguinte captura de tela:
Salve as alterações.
Efetue push das alterações para o repositório remoto executando os seguintes comandos do Git Bash/Shell.
```
git pull origin main
git add .
git commit -m "Update the storage account type."
git push origin main
```
O primeiro comando (pull) sincroniza o repositório local com o repositório remoto. O arquivo YAML do pipeline foi adicionado ao repositório remoto. A execução do comando pull baixa uma cópia do arquivo YAML para o branch local.

O quarto comando (push) carrega o arquivo linkedStorageAccount.json revisado para o repositório remoto. Com a ramificação principal do repositório remoto atualizada, o pipeline é disparado novamente.

Para confirmar as alterações, verifique a propriedade Replicação da conta de armazenamento. Confira Verificar a implantação.

Limpar os recursos

Quando os recursos do Azure já não forem necessários, limpe os recursos implantados excluindo o grupo de recursos.

No portal do Azure, escolha Grupos de recursos do menu à esquerda.
No campo Filtrar por nome, insira o nome do grupo de recursos.
Selecione o nome do grupo de recursos.
Escolha Excluir grupo de recursos no menu superior.

Também convém excluir o repositório GitHub e o projeto do Azure DevOps.

Próximas etapas

Parabéns, você concluiu este tutorial de implantação de modelo do Resource Manager. Informe-nos se você tiver comentários e sugestões na seção de comentários. Obrigado! Você está pronto para acessar conceitos mais avançados sobre modelos. O próximo tutorial detalha mais o uso da documentação de referência do modelo para ajudar na definição de recursos a serem implantados.

Utilizar a referência de modelo

Compartilhar via