Exercício - Criar e executar um fluxo de trabalho básico

• 6 minutos

Você deseja automatizar a implantação de atualizações no site da sua empresa de brinquedos. Como primeiro passo, você criará um fluxo de trabalho básico nas Ações do GitHub.

Neste exercício, irá:

Criar um repositório no GitHub

1. Em um navegador, vá para o GitHub. Faça login usando sua conta do GitHub ou crie uma nova conta se não tiver uma.

2. Selecione o ícone de adição (+) no canto superior direito da janela e, em seguida, selecione Novo repositório.

   

3. Insira os detalhes do seu novo repositório:

   • Proprietário: Selecione seu nome de usuário do GitHub no menu suspenso. Na captura de tela, mygithubuser está o nome da conta do GitHub do proprietário do repositório. Você usará o nome da sua conta posteriormente neste módulo.
   • Nome do repositório: insira um nome significativo, mas curto. Para este módulo, use toy-website-workflow.
   • Descrição: inclua uma descrição para ajudar outras pessoas a entender a finalidade do repositório.
   • Privado: Você pode usar o GitHub para criar repositórios públicos e privados. Crie um repositório privado, porque apenas as pessoas dentro da sua organização devem acessar os arquivos do seu site de brinquedos. Você pode conceder acesso a outras pessoas mais tarde.

   Depois de terminar, a configuração do repositório deve se parecer com a seguinte captura de tela:

   

4. Selecione Create repository (Criar repositório).

Clonar o repositório

No Visual Studio Code, clone seu repositório.

1. Na página do repositório, selecione o botão de cópia para copiar o URL para o repositório Git.

   

2. Abra o Visual Studio Code.

3. Abra uma janela de terminal do Visual Studio Code selecionando Terminal New Terminal>. A janela geralmente abre na parte inferior da tela.

4. Navegue no terminal até o diretório onde deseja clonar o repositório GitHub em seu computador local. Por exemplo, para clonar o repositório para a pasta toy-website-workflow , execute o seguinte comando:

   cd toy-website-workflow
   

5. Digite git clone e cole o URL copiado anteriormente, que tem esta aparência:

   git clone https://github.com/mygithubuser/toy-website-workflow
   

   Você receberá um aviso de que clonou um repositório vazio. Você pode ignorar a mensagem.

6. Esta é a primeira vez que utiliza este repositório, pelo que poderá ser-lhe pedido para iniciar sessão.

   No Windows, digite 1 para autenticar usando um navegador da Web e selecione Enter.

   No macOS, selecione Autorizar.

7. É apresentada uma janela do browser. Talvez seja necessário fazer login no GitHub novamente. Selecionar Autorizar.

8. Reabra o Visual Studio Code na pasta do repositório executando o seguinte comando:

   code -r toy-website-workflow
   

Criar uma definição de fluxo de trabalho YAML

Agora que você criou e clonou seu repositório, está pronto para criar uma definição básica de fluxo de trabalho.

1. No Visual Studio Code, abra o Explorer.

2. Na raiz da estrutura de pastas toy-website-workflow , crie uma nova pasta chamada .github.

   Nota

   Certifique-se de incluir o ponto no início do nome da pasta. Isso indica que esta é uma pasta oculta, e o GitHub requer o período para que as Ações do GitHub detetem a definição do fluxo de trabalho.

3. Na pasta .github, crie outra pasta chamada fluxos de trabalho.

4. Na pasta fluxos de trabalho, crie um novo arquivo chamado workflow.yml.

   

5. Copie a seguinte definição de fluxo de trabalho para o arquivo:

   name: deploy-toy-website
   
   on: [workflow_dispatch]
   
   jobs:
     say-hello:
       runs-on: ubuntu-latest
       steps:
         - name: 'placeholder step'
           run: echo "Hello world!"
   

6. Guarde o ficheiro.

7. Confirme e envie o arquivo para o repositório GitHub com os seguintes comandos:

   git add .
   git commit -m "Add initial workflow definition"
   git push
   

Executar o fluxo de trabalho

Você criou uma definição de fluxo de trabalho. O GitHub Actions deteta automaticamente seu arquivo de fluxo de trabalho porque ele está localizado no diretório .github/workflows .

1. No navegador, navegue até o repositório. Talvez seja necessário atualizar a página para ver as alterações.

2. Selecione o separador Ações.

   

3. Selecione o fluxo de trabalho deploy-toy-website .

   

4. Selecione a lista suspensa Executar fluxo de trabalho e, em seguida, selecione o botão Executar fluxo de trabalho.

   

5. O fluxo de trabalho começa a ser executado. Pode levar alguns momentos e você pode atualizar a página, mas ela deve atualizar automaticamente e mostrar uma execução de fluxo de trabalho em fila ou em execução ou até mesmo já concluída.

   

   Observe que o status de execução inicialmente é exibido como Enfileirado. Pode levar algum tempo para que seu fluxo de trabalho seja iniciado. Seu trabalho é adicionado a uma fila para um corredor e, assim que um corredor estiver disponível, o GitHub Actions atribui o corredor e inicia o trabalho. Em seguida, o status do trabalho se torna Executante.

   Cada fluxo de trabalho executado inclui um identificador. Você pode usar esse identificador quando precisar consultar a execução do fluxo de trabalho e ajudar a localizar uma execução de fluxo de trabalho específica.

Verificar a execução do fluxo de trabalho

1. Quando a execução do fluxo de trabalho for iniciada, selecione deploy-toy-website para exibir os detalhes da execução. Atualize a página até que o status do trabalho exiba Êxito.

   

   Além disso, observe que a página inclui um identificador para a confirmação do Git usada pela execução. O identificador de confirmação indica a versão do conteúdo do repositório que o fluxo de trabalho usou.

2. Na lista de trabalhos, selecione say-hello.

   

3. A página de informações do trabalho é exibida, que mostra o log das etapas que o fluxo de trabalho executou para você. Observe que sua etapa de espaço reservado está incluída.

   

   Observe que a lista inclui etapas que você não especificou. Essas etapas são criadas automaticamente pelas Ações do GitHub.

4. Selecione a etapa do espaço reservado.

   

   Os logs para esta etapa incluem o conteúdo do comando conforme especificado no arquivo YAML do seu fluxo de trabalho e o texto Hello world! que o script emitiu.

Vincular a execução do fluxo de trabalho a uma confirmação

É bom entender como fazer referência cruzada de uma execução de fluxo de trabalho com a confirmação contida na execução. Vincular a execução do fluxo de trabalho a uma confirmação pode ajudá-lo a rastrear o histórico de suas implantações e diagnosticar problemas.

1. Selecione Resumo para retornar ao resumo da execução.

2. Selecione o identificador de confirmação. O GitHub exibe os detalhes da confirmação que disparou a execução do fluxo de trabalho.