Como configurar CI/CD GitHub Actions do zero

Resultados esperados

Ao final deste guia, você terá um pipeline de CI/CD funcional utilizando GitHub Actions. Isso permitirá que seu projeto seja automaticamente construído, testado e implantado sempre que houver alterações no código.

Pré-requisitos

Antes de começar, certifique-se de que você possui:

• Uma conta no GitHub.
• Um repositório onde o código do seu projeto está hospedado.
• Conhecimento básico de YAML, pois os workflows do GitHub Actions são escritos nesse formato.

Passo 1: Criar um repositório no GitHub

O primeiro passo é criar um repositório no GitHub, caso ainda não tenha um. Acesse sua conta no GitHub e clique no botão "New". Preencha as informações solicitadas, como nome do repositório e descrição. Selecione se deseja que o repositório seja público ou privado.

Dica

Certifique-se de inicializar o repositório com um arquivo README para fornecer informações sobre o seu projeto.

Passo 2: Criar um arquivo de workflow

Após criar seu repositório, o próximo passo é criar um arquivo de workflow. Navegue até a aba "Actions" do seu repositório e clique em "Set up a workflow yourself". Isso irá criar um arquivo YAML chamado .github/workflows/main.yml.

Erro comum a evitar

Não esqueça de nomear corretamente o arquivo. O caminho deve ser .github/workflows/ para que o GitHub reconheça o workflow automaticamente.

Passo 3: Definir as etapas do workflow

No arquivo de workflow, você começará a definir as etapas do seu pipeline. Um exemplo básico pode incluir as etapas de build, test e deploy. Abaixo está um exemplo de configuração:

name: CI/CD Pipeline

on: push: branches:

• main

jobs: build: runs-on: ubuntu-latest steps:

• name: Checkout code

uses: actions/checkout@v2

• name: Setup Node.js

uses: actions/setup-node@v2 with: node-version: '14'

• name: Install dependencies

run: npm install

• name: Run tests

run: npm test

Dica

Utilize ações pré-configuradas do GitHub para simplificar seu workflow, como actions/checkout para fazer o checkout do código.

Passo 4: Testar o workflow

Com o arquivo de workflow configurado, é hora de testar. Faça uma alteração no seu código e envie para o repositório. Acesse a aba "Actions" e você verá seu workflow sendo executado. Verifique se todas as etapas foram concluídas com sucesso.

Erro comum a evitar

Se o workflow falhar, verifique os logs de execução para identificar o que deu errado. Muitas vezes, um erro de sintaxe no YAML pode causar falhas.

Passo 5: Adicionar etapas de deploy

Após garantir que as etapas de build e test estão funcionando, você pode adicionar etapas de deploy. Isso pode ser feito adicionando um novo job no seu arquivo YAML. Um exemplo de configuração para deploy poderia ser:

deploy: runs-on: ubuntu-latest steps:

• name: Deploy to Server

run: scp -r ./dist user@server:/path/to/deploy

Dica

Considere utilizar ferramentas de implantação como Docker ou serviços de cloud para facilitar o processo de entrega contínua.

Passo 6: Monitorar e otimizar

Depois que tudo estiver configurado e funcionando, é importante monitorar seu pipeline. Utilize as métricas do GitHub Actions para entender a performance do seu workflow e identificar possíveis melhorias.

Erro comum a evitar

Não subestime a importância da documentação. Tenha um README atualizado e documente cada etapa do seu workflow para facilitar futuras manutenções.

Checklist rápido

• [ ] Criar repositório no GitHub.
• [ ] Criar arquivo de workflow no formato YAML.
• [ ] Definir as etapas de build, test e deploy.
• [ ] Testar o workflow.
• [ ] Adicionar etapas de deploy.
• [ ] Monitorar e otimizar o pipeline.

FAQ

H3: O que é CI/CD?

CI/CD é um conjunto de práticas que visa automatizar a integração e a entrega de software, permitindo que novas alterações sejam implementadas de forma rápida e confiável.

H3: Por que usar GitHub Actions?

GitHub Actions permite automatizar tarefas diretamente no GitHub, facilitando a configuração de CI/CD sem necessidade de infraestrutura adicional.

H3: Posso usar GitHub Actions para qualquer tipo de projeto?

Sim, GitHub Actions pode ser utilizado em projetos de diferentes linguagens de programação e tipos de aplicativo, desde aplicações web até projetos de machine learning.

H3: Como posso ver os logs das execuções?

Você pode acessar os logs das execuções do seu workflow na aba "Actions" do seu repositório, clicando na execução específica que deseja examinar.