GitHub Actions

Automatize fluxos de trabalho de software diretamente no seu repositório GitHub com o GitHub Actions.

Quando Usar Esta Habilidade

Use esta habilidade quando:

• Configurar pipelines de CI/CD para repositórios GitHub
• Automatizar fluxos de trabalho de build, teste e implantação
• Criar componentes de fluxo de trabalho reutilizáveis
• Configurar runners auto-hospedados
• Gerenciar segredos e variáveis de fluxo de trabalho
• Depurar execuções de fluxo de trabalho com falha

Escopo e Pré-requisitos de Fragmento

Os exemplos são fragmentos YAML independentes, não um pipeline completo e implantável. Cada novo job precisa de seu próprio checkout, configuração de ferramenta, instalação de dependência bloqueada e transferência de artefatos; os jobs não compartilham um diretório de trabalho. Revise entradas de eventos não confiáveis, permissões de menor privilégio, ambientes protegidos e exposição de segredos antes da adoção. O push de imagem, a implantação e o registro de runner exigem autorização.

Pré-requisitos

• Repositório GitHub com acesso de escrita
• Compreensão da sintaxe YAML
• Para runners auto-hospedados: servidor com Docker (opcional)

Estrutura do Arquivo de Fluxo de Trabalho

Fluxos de trabalho são definidos no diretório .github/workflows/:

name: CI Pipeline

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '22'
          cache: 'npm'
      - run: npm ci
      - run: npm test

Gatilhos Comuns

Push e Pull Request

on:
  push:
    branches: [main]
    paths:
      - 'src/**'
      - 'package.json'
  pull_request:
    branches: [main]

Execuções Agendadas

on:
  schedule:
    - cron: '0 2 * * *'  # Daily at 2 AM UTC

Despacho Manual

on:
  workflow_dispatch:
    inputs:
      environment:
        description: 'Deployment environment'
        required: true
        default: 'staging'
        type: choice
        options:
          - staging
          - production

Configuração de Job

Builds de Matriz

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [22, 24]
        os: [ubuntu-latest, windows-latest]
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node-version }}
      - run: npm test

Dependências de Job

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - run: npm run build
      
  test:
    needs: build
    runs-on: ubuntu-latest
    steps:
      - run: npm test
      
  deploy:
    needs: [build, test]
    runs-on: ubuntu-latest
    steps:
      - run: ./deploy.sh

Proteção de Ambiente

jobs:
  deploy:
    runs-on: ubuntu-latest
    environment:
      name: production
      url: https://example.com
    steps:
      - run: ./deploy.sh

Segredos e Variáveis

Usando Segredos

steps:
  - name: Deploy
    env:
      AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
      AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
    run: aws s3 sync ./dist s3://my-bucket

Usando Variáveis

steps:
  - name: Build
    env:
      API_URL: ${{ vars.API_URL }}
    run: npm run build

Cache de Dependências

- uses: actions/cache@v4
  with:
    path: ~/.npm
    key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
    restore-keys: |
      ${{ runner.os }}-node-

Artefatos

Upload de Artefatos

- uses: actions/upload-artifact@v4
  with:
    name: build-output
    path: dist/
    retention-days: 5

Download de Artefatos

- uses: actions/download-artifact@v4
  with:
    name: build-output
    path: dist/

Builds Docker

jobs:
  docker:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Login to Docker Hub
        uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_PASSWORD }}
      
      - name: Build and push
        uses: docker/build-push-action@v5
        with:
          context: .
          push: true
          tags: user/app:latest

Fluxos de Trabalho Reutilizáveis

Definir Fluxo de Trabalho Reutilizável

# .github/workflows/reusable-deploy.yml
name: Reusable Deploy

on:
  workflow_call:
    inputs:
      environment:
        required: true
        type: string
    secrets:
      deploy_key:
        required: true

jobs:
  deploy:

…