Grimpen de GitHub Actions – Estrutura padrão e uma lista das ações mais úteis

GitHub Actions é uma plataforma de automação e CI/CD dentro do GitHub, usada para compilar, testar e implantar seu código com base em eventos como pushes, pull requests ou em um horário agendado.

Além do padrão do GitHub, você pode usar o GitHub Actions em um servidor Gitea auto-hospedado.

As Actions abrangem ferramentas oficiais, da comunidade e de terceiros, apoiando a automação desde compilações e testes até implantação, gerenciamento de lançamentos, QA e notificações.

Este resumo cobre a estrutura do GitHub Actions, uma breve descrição e as ações mais comuns usadas em fluxos de trabalho de código aberto e comerciais. Faz parte de Ferramentas de Desenvolvedor: O Guia Completo para Fluxos de Trabalho de Desenvolvimento Moderno.

Estrutura Básica de Configuração

Os Fluxos de Trabalho (Workflows) do GitHub Actions são definidos em arquivos YAML localizados no diretório .github/workflows dentro do repositório.

name: Workflow Name
on:
  push:
    branches: [ main ]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Set up Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '18'
      - name: Run tests
        run: npm test

• O bloco on especifica os eventos de gatilho.
• Cada job é executado em seu próprio runner.
• steps podem executar comandos de shell ou chamar ações reutilizáveis.

Componentes Principais do Fluxo de Trabalho

Eventos de Gatilho

• push
• pull_request
• schedule (usando sintaxe cron)
• workflow_dispatch (gatilho manual, permite parâmetros de entrada)
• release, issue, etc.

Exemplo:

on:
  push:
    branches: [ main ]
  workflow_dispatch:
    inputs:
      environment:
        description: 'Deployment Environment'
        required: true
        default: 'production'
        type: string

Ações Úteis Integradas

Parâmetros de Ação

Parâmetros Gerais para Qualquer Chamada de Ação:

- name: Some Action or Step
  uses: owner/repo@ref
  with:
    param1: value
    param2: value
  env:
    ENV_VAR: value
  if: ${{ condition }}
  run: command_to_run
  shell: bash|pwsh|python|sh
  continue-on-error: true|false

• with: argumentos passados para a ação (consulte a documentação da ação para todas as opções)
• env: variáveis de ambiente para a etapa
• if: execução condicional
• run: comandos de shell (se não estiver usando uma ação)
• shell: shell usado para executar a etapa
• continue-on-error: prosseguir mesmo que a etapa falhe

Definindo Entradas Personalizadas de Ação

Na metadados da sua ação (action.yml):

inputs:
  example-input:
    description: 'An example input'
    required: false
    default: 'default-value'

Quando usado em um fluxo de trabalho:

- uses: my/action@v1
  with:
    example-input: 'custom-value'

Acessado como variável de ambiente INPUT_EXAMPLE_INPUT quando a ação é executada.

Exemplo: Fluxo de Trabalho com Parâmetros Manuais

name: Deploy
on:
  workflow_dispatch:
    inputs:
      environment:
        description: 'Deployment Environment'
        required: true
        default: 'production'
        type: string
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Deploy to environment
        run: echo "Deploying to ${{ github.event.inputs.environment }}"

Marketplace de Ações

• Milhares de ações reutilizáveis estão disponíveis no GitHub Marketplace.
• As categorias incluem: implantações em nuvem, ferramentas de notificação, frameworks de teste, análise de código e muito mais.
• Explore: actions/checkout, actions/setup-node, docker/build-push-action, actions/cache, actions/upload-artifact e muitos outros.

Dicas Rápidas

• Coloque os arquivos de fluxo de trabalho em .github/workflows.
• Use workflow_dispatch com inputs para execuções manuais e parametrizadas.
• Use a ação cache para acelerar a instalação de dependências.
• Use a matrix de jobs para testar múltiplas versões de SO/ambiente de execução.
• Use segredos para dados sensíveis, referenciados como ${{ secrets.SECRET_NAME }}.

Este cheatsheet cobre os fundamentos de uso, configuração e extensão do GitHub Actions para automação, CI/CD e muito mais. Para mais detalhes e atualizações, consulte sempre a documentação oficial do GitHub e os repositórios de ações.

Ações Comuns do GitHub

Aqui está uma lista prática de Ações do GitHub frequentemente usadas que ajudam a automatizar CI/CD, testes, compilação, implantação e tarefas de fluxo de trabalho:

Ações Oficiais Principais

Ações Populares da Comunidade e de Terceiros

Ações de Teste, QA e Relatórios

Ações de Implantação e Notificação

Utilitários e Gerenciamento de Fluxo de Trabalho

Como Encontrar Mais

Existem muitas Ações do GitHub que permitem a automação de fluxos de trabalho, como testes automatizados, implantação em produção, notificações e integrações com outros serviços. O GitHub Marketplace lista milhares de ações em categorias como teste, segurança, implantação, notificações, qualidade de código e integrações. Listas curadas como “Awesome Actions” também são ótimas para inspiração e descoberta.

Links Úteis

• https://docs.github.com/actions
• https://github.com/marketplace
• https://docs.github.com/en/actions/get-started/quickstart
• https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions
• GIT Cheatsheet
• Gitea - installing and testing
• Backup and restore Gitea server
• Using Gitea Actions deploy Hugo website to AWS S3
• Gitflow: Steps, Alternatives, Pros, and Cons
• DevOps with GitOps - Argo CD, Flux, Jenkins X, Weave GitOps and others