GitHub Actions: cómo funcionan los lockfiles para dependencias de flujos

Fuentes: GitHub Actions: how workflow dependency lockfiles work

Los lockfiles de dependencias de flujos de trabajo en GitHub Actions son archivos que fijan la versión exacta de las acciones (commit SHA) que ejecutan los flujos de CI/CD. Su objetivo principal es garantizar la reproducibilidad y la seguridad al evitar que el código en ejecución difiera del código revisado por el autor, especialmente ante cambios en las etiquetas o ramas de las acciones de terceros. A diferencia de la fijación manual de SHA en los archivos YAML, estos lockfiles gestionan dependencias transitivas y proporcionan un inventario auditable de las dependencias de las acciones, facilitando la gestión de actualizaciones mediante herramientas como Dependabot.

El archivo se genera automáticamente mediante la extensión CLI gh actions-lock y se almacena en .github/workflows/actions.lock. No debe editarse manualmente. Al activarse, el sistema verifica que cada acción dependiente esté presente en el lockfile y que el commit fijado sea accesible desde la rama o etiqueta registrada en el repositorio de la acción. Los lockfiles cubren las dependencias transitivas de las acciones, pero no las llamadas a flujos de trabajo reutilizables, que deben fijarse manualmente por su SHA completo. Esta estructura permite a GitHub Actions confirmar la identidad del repositorio fuente en tiempo de ejecución, mejorando la seguridad frente a compromisos de cuentas de mantenimiento upstream.