Introdução e Configuração do GitHub Actions

Introdução

GitHub Actions é uma plataforma de integração contínua e entrega contínua (CI/CD) que permite automatizar seu pipeline de compilação (build), teste e implantação (deployment). Você pode criar fluxos de trabalho (workflows) que compilam e testam cada pull request para o seu repositório, ou implantam pull requests mesclados (merged) em produção.

Neste laboratório, você aprenderá a configuração inicial necessária para começar a usar o GitHub Actions. Você passará pelo processo de criação de um repositório GitHub, cloná-lo para seu ambiente de desenvolvimento local e configurar a estrutura de diretórios específica que o GitHub Actions exige para reconhecer seus fluxos de trabalho.

Pré-requisitos

• Uma conta GitHub (https://github.com). Se você não tiver uma conta GitHub, deverá primeiro registrar-se para uma conta gratuita em https://github.com/signup. Este é um pré-requisito para concluir este laboratório.
• Familiaridade básica com a linha de comando (command line).

Criar um novo repositório no site do GitHub

Nesta etapa, você criará um novo repositório no site do GitHub. Este repositório servirá como armazenamento remoto para o seu projeto e o local onde os fluxos de trabalho (workflows) do GitHub Actions serão executados.

1. Abra seu navegador da web e navegue até https://github.com.
2. Faça login na sua conta do GitHub.
3. No canto superior direito de qualquer página, use o menu suspenso + e selecione New repository (Novo repositório).
4. Na caixa Repository name (Nome do repositório), digite github-actions-demo.
5. Selecione Public (Público) (O GitHub Actions é gratuito para repositórios públicos).
6. Marque a caixa Add a README file (Adicionar um arquivo README). Isso garante que o repositório seja inicializado e esteja pronto para ser clonado.
7. Clique em Create repository (Criar repositório).

Você criou um repositório remoto. Nas próximas etapas, você trará este repositório para o seu ambiente local.

Clonar o repositório para a VM Ubuntu usando o comando git clone

Nesta etapa, você clonará o repositório que acabou de criar para o seu ambiente LabEx local. Isso permite que você edite arquivos e crie fluxos de trabalho (workflows) localmente.

1. Na página do seu repositório no GitHub, clique no botão verde Code.
2. Certifique-se de que a aba HTTPS esteja selecionada e copie a URL. Ela deve ser parecida com https://github.com/your-username/github-actions-demo.git.
3. Abra o terminal no ambiente LabEx. O caminho padrão é ~/project.
4. Use o comando git clone para baixar o repositório. Substitua your-username pelo seu nome de usuário real do GitHub.

cd ~/project
git clone https://github.com/your-username/github-actions-demo.git

Exemplo de Saída:

Cloning into 'github-actions-demo'...
remote: Enumerating objects: 3, done.
remote: Counting objects: 100% (3/3), done.
remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
Receiving objects: 100% (3/3), done.

5. Verifique se o diretório foi criado:

ls -F

Você deverá ver github-actions-demo/ listado.

Criar um diretório .github/workflows no repositório

O GitHub Actions procura por arquivos de configuração de fluxo de trabalho em um diretório específico dentro do seu repositório: .github/workflows. Nesta etapa, você criará essa estrutura de diretórios.

1. Certifique-se de estar dentro do diretório do repositório:

cd ~/project/github-actions-demo

2. Crie o diretório .github e o subdiretório workflows dentro dele usando o comando mkdir com a flag -p (parents):

mkdir -p .github/workflows

3. O Git não rastreia diretórios vazios. Para garantir que possamos commitar esta estrutura na próxima etapa, vamos criar um arquivo de fluxo de trabalho vazio simples chamado main.yml dentro deste diretório.

touch .github/workflows/main.yml

4. Verifique a estrutura:

ls -R .github

Exemplo de Saída:

.github:
workflows

.github/workflows:
main.yml

Esta estrutura é essencial. O GitHub só reconhecerá arquivos YAML colocados em .github/workflows como fluxos de trabalho do Action.

Fazer commit e push das alterações do diretório usando git add, git commit e git push

Nesta etapa, você fará o commit da nova estrutura de diretórios e a enviará (push) para o GitHub.

1. Prepare os novos arquivos para o commit:

git add .

2. Faça o commit das alterações com uma mensagem descritiva:

git commit -m "Setup GitHub Actions workflow directory"

Exemplo de Saída:

[main ... ] Setup GitHub Actions workflow directory
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 .github/workflows/main.yml

3. Envie as alterações para o repositório remoto no GitHub:

git push

Nota sobre Autenticação:
Ao executar git push, o WebIDE solicitará automaticamente a autenticação. Siga estas etapas detalhadas:

1. Um pop-up aparecerá com a mensagem: "The extension 'GitHub' wants to sign in using GitHub." Clique em Allow.
2. Uma nova notificação aparecerá. Clique em "Copy&Continue to GitHub" e, em seguida, clique em "Open" no próximo prompt.
3. Faça login na sua conta do GitHub na janela do navegador que se abrir e insira o código de autorização que foi copiado. Após confirmar a autorização, a página será fechada automaticamente.
4. Aguarde alguns segundos e você verá o terminal concluir a operação de push com sucesso.

Nota de Privacidade: O WebIDE solicitará acesso total à sua conta do GitHub para fins de autenticação. Você não precisa se preocupar com questões de privacidade — a VM LabEx será imediatamente destruída após a conclusão do laboratório atual, e suas credenciais e informações de autorização não serão retidas.

Este processo de autenticação não requer configuração manual de nome de usuário ou Personal Access Token (Token de Acesso Pessoal).

Após seguir as etapas de autenticação, você verá uma saída semelhante à seguinte:

Exemplo de Saída:

Enumerating objects: 6, done.
Counting objects: 100% (6/6), done.
Delta compression using up to 4 threads
Compressing objects: 100% (2/2), done.
Writing objects: 100% (5/5), 388 bytes | 388.00 KiB/s, done.
Total 5 (delta 0), reused 0 (delta 0), pack-reused 0
To https://github.com/your-username/github-actions-demo.git
   2e0917f..a191a97  master -> master

4. Visite seu repositório no GitHub em um navegador da web para confirmar que o diretório .github/workflows e o arquivo main.yml agora estão visíveis na estrutura do repositório.

Resumo

Neste laboratório, você configurou com sucesso a base para usar o GitHub Actions. Você:

1. Criou um novo repositório no GitHub.
2. Clonou o repositório para o seu ambiente local.
3. Criou a estrutura de diretórios obrigatória .github/workflows.
4. Fez o commit e o push dessas alterações de volta para o GitHub.

Com esta estrutura estabelecida, você está agora pronto para definir fluxos de trabalho de CI/CD (Integração Contínua/Entrega Contínua) editando os arquivos YAML dentro do diretório workflows.