Ampliar um pipeline para usar vários modelos

Neste laboratório, explore a importância de estender um pipeline para vários modelos e como fazê-lo usando o Azure DevOps. O laboratório aborda conceitos fundamentais e práticas recomendadas para criar um pipeline de várias fases, criar um modelo de variáveis, criar um modelo de trabalho e criar um modelo de fase.

Estes exercícios levam aproximadamente 20 minutos.

Antes de começar

Você precisará de uma assinatura do Azure, da organização do Azure DevOps e do aplicativo eShopOnWeb para acompanhar os laboratórios.

Instruções

Exercício 1: criar um pipeline YAML de vários estágios

Tarefa 1: criar um pipeline YAML principal de vários estágios

  1. Navegue até o portal do Azure DevOps em https://dev.azure.com e abra sua organização.

  2. Abra o projeto eShopOnWeb.

  3. Acesse Pipelines > Pipelines.

  4. Selecione Criar pipeline.

  5. Selecione Git do Azure Repos (Yaml).

  6. Selecione o repositório eShopOnWeb.

  7. Selecione Pipeline de início.

  8. Substitua o conteúdo do azure-pipelines.yml pelo seguinte código:

    trigger:
- main

pool:
  vmImage: 'windows-latest'

stages:
- stage: Dev
  jobs:
  - job: Build
    steps:
    - script: echo Build
- stage: Test
  jobs:
  - job: Test
    steps:
    - script: echo Test
- stage: Production
  jobs:
  - job: Deploy
    steps:
    - script: echo Deploy

  9. Selecione Salvar e executar. Escolha fazer commit diretamente na ramificação principal e selecione Salvar e executar novamente.

  10. Você verá o pipeline em execução com os três estágios (Desenvolvimento, Teste e Produção) e os trabalhos correspondentes. Aguarde até que o pipeline seja concluído e volte para a página Pipelines.

    Captura de tela do pipeline em execução com as três etapas e os trabalhos correspondentes

  11. Selecione … (Mais opções) no lado direito do pipeline que você acabou de criar e selecione Renomear/mover.

  12. Renomeie o pipeline para eShopOnWeb-MultiStage-Main e selecione Salvar.

Tarefa 2: criar um modelo de variáveis

  1. Vá para Repos > Arquivos.

  2. Expanda a pasta .ado e clique em Novo arquivo.

  3. Nomeie o arquivo como eshoponweb-variables.yml e clique em Criar.

  4. Adicione o seguinte código ao arquivo:

    variables:
  resource-group: 'YOUR-RESOURCE-GROUP-NAME'
  location: 'southcentralus' #name of the Azure region you want to deploy your resources
  templateFile: '.azure/bicep/webapp.bicep'
  subscriptionid: 'YOUR-SUBSCRIPTION-ID'
  azureserviceconnection: 'YOUR-AZURE-SERVICE-CONNECTION-NAME'
  webappname: 'YOUR-WEB-APP-NAME'

  5. Substitua os valores das variáveis pelos valores do seu ambiente:

    • substitua YOUR-RESOURCE-GROUP-NAME pelo nome do grupo de recursos que você deseja usar neste laboratório, por exemplo, rg-eshoponweb-multi.
    • defina o valor da variável location como o nome da região do Azure onde você deseja implantar seus recursos, por exemplo, southcentralus.
    • substitua YOUR-SUBSCRIPTION-ID por sua ID de assinatura do Azure.
    • substitua YOUR-AZURE-SERVICE-CONNECTION-NAME por azure subs
    • substitua YOUR-WEB-APP-NAME por um nome globalmente exclusivo do aplicativo Web a ser implantado, por exemplo, a cadeia de caracteres eshoponweb-lab-multi- seguida por um número aleatório de seis dígitos.

  6. Selecione Commit, na caixa de texto de comentário de commit, insira [skip ci] e selecione Fazer commit.

    [!NOTE] Ao adicionar o comentário [skip ci] ao commit, você impedirá a execução automática do pipeline, que, neste ponto, é executado por padrão após cada alteração no repositório.

Tarefa 3: preparar o pipeline para usar modelos

  1. No portal do Azure DevOps, na página do projeto eShopOnWeb, acesse Repositórios.

  2. No diretório raiz do repositório, selecione azure-pipelines.yml, que contém a definição do pipeline eShopOnWeb-MultiStage-Main.

  3. Selecione Editar.

  4. Substitua o conteúdo do azure-pipelines.yml pelo seguinte código:

    trigger:
- main
variables:
- template: .ado/eshoponweb-variables.yml
   
stages:
- stage: Dev
  jobs:
  - template: .ado/eshoponweb-ci.yml
- stage: Test
  jobs:
  - template: .ado/eshoponweb-cd-webapp-code.yml
- stage: Production
  jobs:
  - job: Deploy
    steps:
    - script: echo Deploy to Production or Swap

  5. Selecione Commit, na caixa de texto de comentário de commit, insira [skip ci] e selecione Fazer commit.

Tarefa 4: atualização de modelos de CI/CD

  1. Nos Repositórios do projeto eShopOnWeb, selecione o diretório .ado e selecione o arquivo eshoponweb-ci.yml.

  2. Remova tudo o que estiver acima da seção trabalhos.

    #NAME THE PIPELINE SAME AS FILE (WITHOUT ".yml")
# trigger:
# - main
   
resources:
  repositories:
    - repository: self
      trigger: none
   
stages:
- stage: Build
  displayName: Build .Net Core Solution

  3. Selecione Commit, na caixa de texto de comentário de commit, insira [skip ci] e selecione Fazer commit.

  4. Nos Repositórios do projeto eShopOnWeb, selecione o diretório .ado e selecione o arquivo eshoponweb-cd-webapp-code.yml.

  5. Remova tudo o que estiver acima da seção trabalhos.

    #NAME THE PIPELINE SAME AS FILE (WITHOUT ".yml")
   
# Trigger CD when CI executed successfully
resources:
  pipelines:
    - pipeline: eshoponweb-ci
      source: eshoponweb-ci # given pipeline name
      trigger: true

variables:
  resource-group: 'rg-eshoponweb'
  location: 'southcentralus'
  templateFile: '.azure/bicep/webapp.bicep'
  subscriptionid: ''
  azureserviceconnection: 'azure subs'
  webappname: 'eshoponweb-lab'
  # webappname: 'webapp-windows-eshop'
   
stages:
- stage: Deploy
  displayName: Deploy to WebApp`

  6. Substitua o conteúdo existente da etapa #download artifacts por:

        - download: current
      artifact: Website
    - download: current
      artifact: Bicep

  7. Selecione Commit, na caixa de texto de comentário de commit, insira [skip ci] e selecione Fazer commit.

Tarefa 5: executar o pipeline principal

  1. Acesse Pipelines > Pipelines.

  2. Abra o pipeline eShopOnWeb-MultiStage-Main.

  3. Selecione Executar pipeline.

  4. Depois que o pipeline atingir a fase Deploy no ambiente Test, abra o pipeline e observe a mensagem “Este pipeline precisa de permissão para acessar um recurso antes que essa execução possa continuar Test”. Selecione Exibir e, em seguida, Permitir para permitir a execução do pipeline.

    [!NOTE] Se algum trabalho na fase Deploy falhar, vá até a página de execução de pipeline e selecione Executar novamente trabalhos com falha*.

  5. Depois que o pipeline atingir a fase Deploy no ambiente Production, abra o pipeline e observe a mensagem “Este pipeline precisa de permissão para acessar um recurso antes que essa execução possa continuar Production”. Selecione Exibir e, em seguida, Permitir para permitir a execução do pipeline.

  6. Aguarde até que o pipeline termine e verifique os resultados.

    Captura de tela do pipeline em execução com as três etapas e os trabalhos correspondentes

Exercício 2: executar a limpeza dos recursos do Azure e do Azure DevOps

Neste exercício, você removerá os recursos do Azure e do Azure DevOps criados neste laboratório.

Tarefa 1: remover recursos do Azure

  1. No portal do Azure, navegue até o grupo de recursos rg-eshoponweb-multi que contém recursos implantados e selecione Excluir grupo de recursos para excluir todos os recursos criados neste laboratório.

Tarefa 2: remover pipelines do Azure DevOps

  1. Navegue até o portal do Azure DevOps em https://dev.azure.com e abra sua organização.

  2. Abra o projeto eShopOnWeb.

  3. Acesse Pipelines > Pipelines.

  4. Vá para Pipelines > Pipelines e exclua os pipelines existentes.

Tarefa 3: Recriar o repositório do Azure DevOps

  1. No portal do Azure DevOps, no projeto eShopOnWeb, selecione Configurações do projeto no canto inferior esquerdo.

  2. No menu vertical Configurações do projeto ao lado esquerdo, na seção Repositórios, selecione Repositórios.

  3. No painel Todos os Repositórios, passe o mouse sobre a extremidade direita da entrada do repositório eShopOnWeb até que o ícone de reticências Mais opções apareça. Selecione-o e, no menu Mais opções, selecione Renomear.

  4. Na janela Renomear o repositório eShopOnWeb, na caixa de texto Nome do repositório, insira eShopOnWeb_old e selecione Renomear.

  5. De volta ao painel Todos os Repositórios, selecione + Criar.

  6. No painel Criar um repositório, na caixa de texto Nome do repositório, insira eShopOnWeb, desmarque a caixa de seleção Adicionar um LEIAME e selecione Criar.

  7. De volta ao painel Todos os Repositórios, passe o mouse sobre a extremidade direita da entrada do repositório eShopOnWeb_old até que o ícone de reticências Mais opções apareça. Selecione-o e, no menu Mais opções, selecione Excluir.

  8. Na janela Excluir o repositório eShopOnWeb_old, insira eShopOnWeb_old e selecione Excluir.

  9. No menu de navegação esquerdo do portal do Azure DevOps, selecione Repositórios.

  10. No painel O eShopOnWeb está vazio. Adicione um pouco de código!, selecione Importar um repositório.

  11. Na janela Importar um repositório do Git, cole a seguinte URL https://github.com/MicrosoftLearning/eShopOnWeb e selecione Importar:

Revisão

Neste laboratório, você aprendeu a estender um pipeline para vários modelos usando o Azure DevOps. Esse laboratório abordou conceitos fundamentais e melhores práticas para criar um pipeline de várias fases, criando um modelo de variáveis, um modelo de trabalho e um modelo de fase.