github/gh-actions-lock

O que é?

Recursos principais

• 01Fixa actions diretas e transitivas do GitHub Actions em commits exatos no actions.lock.
• 02Oferece o modo verify para CI e o modo offline verify-local para verificações de pre-commit.
• 03Pode atualizar refs flutuantes, como main ou v4, para os commits atuais no upstream.
• 04Tem suporte a github.com e ao GitHub Enterprise Cloud com residência de dados.
• 05Gera resultados legíveis por máquina com --json.

Casos de uso

• Fixar as versões das actions em um repositório para que a CI use commits revisados.
• Adicionar uma etapa de verificação do lockfile às verificações de pull request.
• Executar uma verificação offline de cobertura antes de fazer commit de alterações nos workflows.

Início rápido

1. 1

   Instale a extensão do GitHub CLI

   gh extension install github/gh-actions-lock
2. 2

   No checkout do seu repositório, fixe todas as actions e grave o arquivo de lock

   gh actions-lock
3. 3

   Adicione o diretório do workflow à área de stage para que o arquivo de lock seja incluído no controle de versão

   git add .github/workflows/

Antes de usar

• !Requer um gh CLI autenticado.
• !O GitHub Enterprise Server não é compatível.
• !Workflows reutilizáveis chamados de outro repositório não são bloqueados.
• !Imagens de contêiner sem um digest @sha256 geram avisos e não são bloqueadas.

Em coleções

Tópicos

Perguntas frequentes

O que é gh-actions-lock?

Uma extensão do GitHub CLI que fixa cada action usada nos workflows em um commit exato e verifica o lockfile na CI. gh-actions-lock é uma extensão do GitHub CLI que gera e verifica um lockfile para dependências do GitHub Actions. Ela resolve todas as actions diretas e transitivas referenciadas nos workflows e registra o commit exato ao qual cada uma aponta em .github/workflows/actions.lock, impedindo que uma tag ou branch alterada mude silenciosamente o que a CI executa.

gh-actions-lock é gratuito? Qual é a licença?

gh-actions-lock é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

gh-actions-lock ainda é mantido?

Manutenção ativa. O último commit de gh-actions-lock foi em 6 de nov. de 2026.

Para que posso usar gh-actions-lock?

Fixar as versões das actions em um repositório para que a CI use commits revisados. Adicionar uma etapa de verificação do lockfile às verificações de pull request. Executar uma verificação offline de cobertura antes de fazer commit de alterações nos workflows.

Como instalar gh-actions-lock?

Instale a extensão do GitHub CLI: gh extension install github/gh-actions-lock No checkout do seu repositório, fixe todas as actions e grave o arquivo de lock: gh actions-lock Adicione o diretório do workflow à área de stage para que o arquivo de lock seja incluído no controle de versão: git add .github/workflows/

Onde consigo gh-actions-lock?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/github/gh-actions-lock