Neste artigo
- GitHub Actions travado em 2026: lockfile e 4 práticas que blindam seu CI
- O lockfile actions.lock em 2026
- Verificação no CI e atualizações seguras
- As outras 3 práticas que blindam o workflow
- Quanto tempo leva para aplicar o lockfile num repositório legado
- O lockfile substitui fixar no SHA?
- Preciso pagar pela extensão gh-actions-lock?
- O que acontece se o actions.lock ficar desatualizado?
- zizmor é obrigatório?
GitHub Actions travado em 2026: lockfile e 4 práticas que blindam seu CI
Em novembro de 2026 o GitHub Actions ganhou lockfile de workflow, e junto dele uma forma nova de travar o CI contra ataque de supply chain: antes a recomendação era fixar a action no SHA completo porque tags são mutáveis, e agora o próprio GitHub gera um arquivo actions.lock que verifica cada pin contra o upstream.
Este guia mostra como travar seu GitHub Actions na prática em 2026.
O gatilho dessa mudança foi simples: tags de actions são mutáveis, e um invasor pode apontar uma tag antes segura para código malicioso. O post de 11 de novembro de 2026 no blog do Hugo van Kemenade documenta a configuração completa que este guia resume.
O lockfile actions.lock em 2026
A extensão oficial do gh CLI gera e verifica o lockfile. Os passos são:
- Instale a extensão: gh extension install github/gh-actions-lock.
- No repositório, rode gh actions-lock, que converte as actions para tags com versão e gera o arquivo .github/workflows/actions.lock.
3.
O lockfile registra cada action com ref, commit SHA, owner_id e repo_id, no formato v0.0.3.
- Commite o workflows junto com o actions.lock, que é gerado por máquina e não deve ser editado à mão.
Com o lockfile no repositório, qualquer mudança não verificada falha na hora, porque o pin não bate mais com o commit real da tag.
Verificação no CI e atualizações seguras
O próprio GitHub recomenda rodar a verificação do lockfile no CI, num job separado que roda em paralelo: instale a extensão pinada numa versão (gh extension install github/gh-actions-lock --pin v0.4.1) e rode gh actions-lock --verify. Se o actions.lock estiver desatualizado ou corrompido, o job falha. A documentação oficial está em gh.io/actions-lockfile.
Para atualizar com segurança, Renovate e Dependabot já suportam lockfiles em 2026, e ambos atualizam o actions.lock junto com o workflow. A prática recomendada no post é usar cooldown nas atualizações automáticas, para dar tempo de o lockfile ser revalidado upstream antes do merge.
As outras 3 práticas que blindam o workflow
Além do lockfile, 3 hábitos fecham a segurança do CI em 2026:
- Fixe actions no SHA completo quando não usar lockfile, nunca só na tag.
- Desligue persist-credentials: false no actions/checkout, para o token não vazar para actions de terceiro.
- Restrinja permissions no nível do workflow, como permissions: {}, e abra só o necessário por job.
- Rode análise estática com o zizmor nos workflows, que pega padrões inseguros antes do merge.
Quem cuida de Git no dia a dia também precisa saber sair dos 6 erros que mais travam juniores, como mostra o guia de erros de Git e conflitos de merge em 2026.
Para publicar o projeto com segurança, siga o passo a passo de subir projeto no GitHub, estude no catálogo de cursos do portal e veja as vagas no catálogo de vagas.
Quanto tempo leva para aplicar o lockfile num repositório legado
Num repositório com 5 workflows, o gh actions-lock roda em menos de 1 minuto e gera o actions.lock de todos de uma vez. O trabalho maior é revisar o diff: cada action passa de SHA para tag com versão, e o commit único facilita o review.
Depois disso, o job de verificação com gh actions-lock --verify entra no CI e qualquer workflow novo sem lockfile já falha no primeiro push.
Perguntas frequentes
O lockfile substitui fixar no SHA?
Não, eles se somam. Sem lockfile, fixe no SHA completo porque tags são mutáveis. Com lockfile, o arquivo actions.lock guarda o SHA de cada tag e o --verify garante que a tag ainda aponta para aquele commit, pegando exatamente o ataque de tag mutável.
Preciso pagar pela extensão gh-actions-lock?
Não. É uma extensão oficial do gh CLI, instalada com gh extension install github/gh-actions-lock, e roda de graça em repositórios públicos e privados.
O que acontece se o actions.lock ficar desatualizado?
O job de verificação com gh actions-lock --verify falha no CI, e o certo é rodar gh actions-lock de novo para regenerar o arquivo e commitar junto com a mudança do workflow.
zizmor é obrigatório?
Não é obrigatório, mas em 2026 é a forma mais barata de pegar workflow inseguro antes do merge: análise estática gratuita que aponta permissões amplas demais e actions não pinadas.