<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

GitHub Actions travado em 2026: lockfile e 4 práticas que blindam seu CI

DA

4 min

Entusiasta das Tecnologias

GitHub Actions travado em 2026: lockfile e 4 práticas que blindam seu CI

Este guia mostra como travar seu GitHub Actions na prática em 2026.

Neste artigo

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:

  1. Instale a extensão: gh extension install github/gh-actions-lock.
  2. 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.

  1. 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.

Produtos relacionados

Este conteúdo tem links de afiliado: se você comprar por eles, podemos receber uma comissão sem custo extra para você. A escolha dos produtos segue critérios próprios e não é influenciada por comissão.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Depois dessa formação...

Veja vagas em tecnologia →

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar Cirino

Entusiasta das Tecnologias

Publicado em

Sou o Cirino, e desenvolvo soluções e produtos utilizando linguagens de programação e ferramentas de analytics e monitoração baseadas em Cloud. Trabalho com tecnologia desde 2010,...

Ver perfil do autor

COMPARTILHAR