O Que É actions/checkout no GitHub Actions?

actions/checkout clona seu repositório no runner. Quase sempre é o primeiro step de um workflow.

Os runners começam vazios. Antes de fazer build ou testar, você precisa do seu código na máquina. actions/checkout é a action oficial que clona o repo no commit certo.

O que é

A action oficial do GitHub que faz o checkout do seu repositório no runner usando o commit da execução. Ela lida com a autenticação usando o token automático por baixo dos panos.

steps:
  - uses: actions/checkout@v4
  - run: ls -la

Como funciona

Por padrão ela faz um clone shallow (depth 1) do commit que disparou a execução, no workspace do runner. Os steps seguintes então operam sobre esses arquivos.

Opções comuns

• fetch-depth: 0 para obter o histórico completo (para tags ou diffs).
• ref: para fazer checkout de uma branch ou tag específica.
• submodules: true para incluir submódulos.

Por que importa

Sem o checkout, seu workflow não tem código sobre o qual agir. Entender suas opções, especialmente o fetch depth, evita surpresas em versionamento e detecção de arquivos alterados.

Conceitos relacionados

É a action mais comum do Marketplace e autentica usando o GITHUB_TOKEN automaticamente.

Principais conclusões

• actions/checkout clona o repo no runner.
• Por padrão faz um clone shallow do commit que disparou a execução.
• Use fetch-depth: 0 quando precisar do histórico completo.

Guias relacionados