Voltar
Workflow lockfiles do GitHub Actions entram em public preview

Workflow lockfiles do GitHub Actions chegam em public preview

Aprofundamento CEVIU

Aprofundamento

Os workflow lockfiles do GitHub Actions entraram em public preview para GitHub Enterprise Cloud, Enterprise Cloud com data residency, Team e Free. O problema que atacam é conhecido: tags e branches podem se mover depois da revisão de um workflow, e uma execução posterior pode rodar código diferente. Se uma action for comprometida, uma tag movida basta para injetar código malicioso sem nenhuma mudança no repositório.

A solução usa a extensão gh actions-lock do GitHub CLI, que gera o arquivo .github/workflows/actions.lock com commits revisáveis para actions, dependências transitivas e dependências de reusable workflows. A adoção é gradual, workflow a workflow. Depois de onboarded, o workflow exige entradas no lockfile para todas as dependências e o Actions executa o commit registrado, mesmo que a tag ou branch tenha mudado. Há também uma verificação de lockfile desatualizado que não altera arquivos e roda em CI. A política Require lockfile deixa administradores de enterprise, organização e repositório obrigarem o uso. O Dependabot, ao abrir update de versão de uma action num workflow já onboarded, regenera a entrada do lockfile no mesmo pull request. A fonte avisa: travar não diz se a dependência é segura, então a revisão continua necessária.

Por que isso importa

Para quem opera pipelines, isso permite manter tags legíveis no YAML sem abrir mão de execução determinística. A política Require lockfile pode virar controle central de supply chain em organizações grandes. O custo prático é revisar os commits travados e tratar o PR do Dependabot como ponto de revisão real, não só de merge automático.

Perguntas frequentes

O que são workflow lockfiles do GitHub Actions?

São um arquivo, o .github/workflows/actions.lock, que registra os commits exatos das actions e de suas dependências transitivas. O workflow continua usando tags legíveis, mas o Actions executa os commits travados. Assim, uma tag ou branch que se mova depois não muda o que roda.

Como gerar o lockfile?

Instale a extensão gh actions-lock do GitHub CLI, a partir do repositório público gh-actions-lock. Ela gera o lockfile e as mudanças no workflow. Revise e faça commit de tudo.

O lockfile garante que a action é segura?

Não. A própria fonte diz que travar não determina se a dependência é segura. Ele só impede mudanças inesperadas depois da revisão, então analise a dependência antes de travar.

Como o Dependabot e as políticas entram nisso?

Em workflows já onboarded, o Dependabot atualiza a action e regenera a entrada do lockfile no mesmo PR. A política Require lockfile permite a administradores exigir lockfiles em enterprise, organização ou repositório.

Fontes

Avalie este artigo:
Categoria
CEVIU DevOps
Publicado
23 de outubro de 2026
Editoria
CEVIU DevOps

Quer receber mais sobre CEVIU DevOps?

Conteúdo curado diariamente, direto no seu e-mail.

Conteúdo curado diariamenteDiversas categoriasCancele quando quiser