Exercício – Criar e executar um pipeline básico

  • 7 minutos

Importante

É preciso ter uma assinatura do Azure para fazer esse exercício, e isso pode gerar encargos. Caso ainda não tenha uma assinatura do Azure, crie uma conta gratuita antes de começar.

Você deseja automatizar a implantação de atualizações no site da sua empresa de brinquedos. Como primeira etapa, você cria um pipeline básico no Azure DevOps.

Neste exercício, você vai:

  • Criar uma organização e um projeto do Azure DevOps.
  • Crie um pipeline básico.
  • Execute seu pipeline básico.

Criar um projeto no Azure DevOps

  1. Em um navegador, acesse dev.azure.com. Entre ou crie uma nova conta.

  2. Se você criou uma nova conta, siga os prompts para criar uma organização do Azure DevOps. O Azure DevOps solicitará que você crie um novo projeto. Prossiga para a próxima etapa para definir o projeto.

    Se você entrou em uma organização existente do Azure DevOps, selecione Novo projeto para criar um projeto.

    Captura de tela do Azure DevOps com o botão Novo projeto realçado.

  3. No painel Criar um projeto para começar, insira os seguintes detalhes do novo projeto:

    • Nome do projeto: use um nome relevante, mas curto. Para este exercício, insira toy-website.
    • Descrição: insira uma descrição da finalidade do projeto. Neste exercício, insira Site da empresa Toy.
    • Visibilidade: você pode usar o Azure DevOps para criar repositórios públicos e privados. Nesse caso, o repositório deve ser privado, pois os arquivos do site da empresa devem ser acessados somente por pessoas da organização. Posteriormente você pode conceder acesso a outros usuários.

    A configuração do projeto deve ser semelhante a este exemplo:

    Captura de tela do painel Criar um projeto para começar do Azure DevOps que mostra o nome do projeto e as opções de visibilidade realçadas.

  4. Selecione Criar projeto.

Clonar o repositório

  1. No painel de boas-vindas ou, no menu de recursos, selecione Repos.

    Captura de tela do painel de boas-vindas que mostra os ícones do Repos realçados no painel e no menu de recursos.

  2. Se você estiver usando o macOS, precisará de uma senha especial para clonar o repositório Git. Selecione Gerar credenciais do Git e copie o nome de usuário e a senha exibidos para um local seguro.

  3. Na seção Clonar no computador, selecione Clonar no VS Code. Se um prompt aparecer solicitando a abertura do Visual Studio Code, selecione Abrir.

    Captura de tela mostrando as configurações do repositório com o botão Clonar no VS Code realçado.

  4. Se uma caixa de diálogo for exibida solicitando que você permita que uma extensão abra o URI do repositório, selecione Abrir.

  5. Crie uma pasta no dispositivo local a ser usada para esse repositório e escolha Selecionar como Local do Repositório.

  6. Se estiver usando esse repositório pela primeira vez, será solicitado que você entre.

    No Windows, insira as mesmas credenciais que você usou para entrar no Azure DevOps antes neste exercício.

    No macOS, insira o nome de usuário e a senha do Git que você gerou agora há pouco.

  7. O Visual Studio Code solicita que você abra o repositório. Selecione Abrir.

    Captura de tela da caixa de diálogo do Visual Studio Code para abrir o repositório clonado, com o botão Abrir realçado.

Instalar a extensão do Azure Pipelines

A Microsoft publica uma extensão do Azure Pipelines para Visual Studio Code. A extensão pode ajudá-lo a escrever arquivos YAML de pipeline. É uma boa ideia instalar essa extensão para que os arquivos YAML sejam validados enquanto você trabalha.

  1. No Visual Studio Code, selecione Exibir>Extensões (o atalho é Ctrl+Shift+x).

  2. Na caixa de Pesquisa, insira Azure Pipelines e selecione a extensão do Azure Pipelines publicada pela Microsoft. Selecione Instalar.

    Captura de tela do menu Extensões do Visual Studio Code com a extensão 'Azure Pipelines' da Microsoft e o botão Instalar realçados.

Criar uma definição de pipeline YAML

Agora que você criou sua organização, seu projeto e seu repositório, você já pode criar uma definição básica de pipeline.

  1. No Visual Studio Code, abra o Explorer.

  2. No Explorer, passe o mouse sobre a pasta do projeto TOY-WEBSITE e selecione o ícone Nova Pasta. Nomeie a pasta como implantar.

  3. Selecione a pasta implantar e selecione o ícone Novo Arquivo no projeto TOY-WEBSITE. Nomeie o arquivo como azure-pipelines.yml.

    Captura de tela do Gerenciador do Visual Studio Code mostrando a pasta implantar e o arquivo azure-pipelines.yml que acabou de ser criado.

  4. O arquivo YML é aberto no painel principal. Cole o seguinte código de definição de pipeline no arquivo:

    trigger: none

pool:
  vmImage: ubuntu-latest

jobs:
- job:
  steps:
  - script: echo Hello world!
    displayName: 'Placeholder step'

  5. Salve as alterações no arquivo.

  6. Abra uma janela do terminal do Visual Studio Code selecionando Terminal>Novo Terminal.

    Uma janela do terminal será aberta, geralmente na metade inferior da tela.

  7. Para fazer commit do arquivo azure-pipelines.yml e enviá-lo por push ao repositório Git, cole esse código no painel Terminal e pressione Enter.

    git add deploy/azure-pipelines.yml
git commit -m "Add initial pipeline definition"
git push

Configurar o pipeline no Azure Pipelines

Você criou uma definição de pipeline. Em seguida, registre o pipeline no Azure Pipelines.

  1. No menu de recursos da sessão do Azure DevOps, selecione Pipelines e, no painel Criar seu primeiro Pipeline, selecione Criar Pipeline.

    Captura de tela do painel Criar seu primeiro pipeline com Pipelines realçado no menu de recursos Criar pipeline com o botão realçado.

  2. Na guia Conectar que está no painel Onde está seu código?, selecione Git do Azure Repos.

    Captura de tela do painel Onde está seu código com a opção Git do Azure Repos selecionada.

  3. Na guia Selecionar que está no painel Selecionar um repositório, escolha toy-website.

    Captura de tela que mostra a guia Configurar pipeline com o repositório toy-website selecionado.

  4. Na guia Configurar que está no painel Configurar o pipeline, selecione Arquivo YAML existente do Azure Pipelines.

    Captura de tela que mostra a opção Arquivo YAML existente do Azure Pipelines realçada.

  5. No painel Selecionar um arquivo YAML existente que está na lista suspensa Caminho, escolha /deploy/azure-pipelines.yml e, em seguida, Continuar.

    Captura de tela do Azure DevOps

    O painel Revisar o YAML do pipeline da guia Revisar mostra a definição do pipeline YAML como um novo pipeline.

    Dica

    A interface da Web do Azure Pipelines fornece um editor que você pode usar para gerenciar sua definição de pipeline. Neste módulo, você trabalha com o arquivo de definição no Visual Studio Code, mas pode explorar o editor do Azure Pipelines para ver como ele funciona.

  6. Selecione Executar.

    Captura de tela que mostra a etapa Examinar do fluxo Criar Pipeline, com o botão Executar realçado.

    O Azure Pipelines cria o pipeline e inicia uma primeira execução.

Verificar a execução de pipeline

Importante

Se esta for a primeira vez que você usa pipelines nesta organização do Azure DevOps, você poderá ver um erro dizendo:

Nenhum paralelismo hospedado foi adquirido ou concedido.

Para se proteger contra o uso indevido, o Azure DevOps exige que as novas organizações sejam aprovadas antes de poderem usar agentes de pipeline hospedados pela Microsoft sem cobrança.

Para solicitar que sua organização do Azure DevOps tenha acesso a agentes de pipeline gratuitos, preencha este formulário.

  1. Quando a execução do pipeline inicia, uma página exibe informações sobre a execução.

    Captura de tela que mostra o pipeline, com o trabalho no estado na fila.

    Cada execução de pipeline inclui um identificador. Você pode usar esse identificador para ajudá-lo a encontrar uma execução de pipeline específica.

    O status do trabalho inicialmente é exibido como Na fila. Seu pipeline pode não iniciar imediatamente. Seu trabalho é adicionado a uma fila para um agente. Quando um agente está disponível, o Azure Pipelines atribui o agente e inicia o trabalho. Em seguida, o status do trabalho se torna Em execução.

    A página inclui o nome da ramificação e o identificador para a confirmação do Git que a execução usou. Essa informação indica a versão do conteúdo do repositório que o pipeline usou.

  2. Atualize a página até que o status do trabalho mude para Êxito. Em Trabalhos, selecione Trabalho.

    Captura de tela que mostra o pipeline, com o trabalho com o status Êxito e o nome do trabalho realçados.

  3. A página de informações do trabalho mostra o log das etapas que o pipeline executou. A Etapa de espaço reservado está listada nas etapas no menu à esquerda.

    Captura de tela que mostra o log do trabalho do pipeline, com a 'Etapa de espaço reservado' realçada.

    A lista de etapas no trabalho inclui as etapas que você não criou. Estas etapas são criadas automaticamente pelo Azure Pipelines. Em algumas organizações, você também pode ver as etapas que sua organização inclui automaticamente em todos os pipelines. Você pode selecionar qualquer etapa para ver o respectivo arquivo de log.

  4. Selecione Confira o toy-website@main para s.

    Captura de tela que mostra o log do trabalho do pipeline, com a etapa 'Check-out' realçada.

    O log de cada etapa fornece detalhes exatos sobre o que aconteceu durante a execução de pipeline. As informações de log serão úteis para diagnosticar problemas com um pipeline. Você não tem acesso direto ao agente que executou as etapas.

    Nesse caso, o conteúdo do repositório foi baixado do Azure Repos para o sistema de arquivos do agente.

  5. Selecione Etapa de espaço reservado.

    Captura de tela que mostra o log de trabalho do pipeline, com a etapa 'Etapa de espaço reservado' realçada e os detalhes mostrados.

    O log dessa etapa inclui o conteúdo do script conforme foi criado no arquivo YAML do pipeline e a saída de texto Hello world! da execução do script.

É bom entender como fazer uma referência cruzada de uma execução de pipeline ao commit que a execução continha. A vinculação de uma execução de pipeline a um commit pode ajudar você a acompanhar o histórico da implantação e diagnosticar problemas. O Azure DevOps fornece várias maneiras de vincular uma execução de pipeline a uma confirmação. Neste procedimento, você inspecionará manualmente o histórico de commit.

  1. Para retornar à visão geral do repositório, no menu de recursos do DevOps, selecione Repos>Commits.

    Captura de tela que mostra o painel de commits, com o identificador de commit e o estado bem-sucedido realçados.

    O identificador de confirmação é o mesmo identificador de confirmação que você anotou da sua execução de pipeline. Além disso, o Azure Pipelines exibe o status da operação de pipeline que é associada à confirmação.

  2. Selecione a confirmação. A lista de arquivos que foram alterados e as alterações do commit são mostradas realçadas em verde, indicando que todo o texto é novo.