2 мин на чтение

Lockfile для GitHub Actions: закрепить нужно код, который выполнится

GitHub тестирует lockfile зависимостей Actions. Как сохранить читаемые ссылки на версии, контролировать конкретные коммиты и проверять обновления workflow.

GitHub открыл предварительный доступ к lockfile зависимостей Actions. Файл фиксирует конкретные коммиты используемых действий, тогда как в workflow могут оставаться привычные ссылки на теги или ветки. Изменение анонсировано 14 октября. Его задача — сделать код очередного запуска проверяемым даже тогда, когда имя версии у внешней зависимости позднее указывает на другой коммит.

Читаемое имя не всегда неизменно

Запись с крупной версией удобна человеку: по ней видно семейство инструмента. Однако тег и ветка могут перемещаться. Два запуска одного и того же YAML в таком случае способны получить разный внешний код без изменения самого репозитория. Это осложняет расследование проблем и проверку состава сборочного процесса.

Lockfile переносит результат разрешения зависимости в отдельный проверяемый артефакт. Для подключённых к механизму workflow GitHub использует записанные коммиты. При этом фиксация не означает, что выбранный код безопасен. Она отвечает на вопрос «что выполняется», а оценка содержимого и прав остаётся отдельной задачей.

Официальная карточка gh-actions-lock — расширения GitHub CLI для создания и проверки lockfile.

Обновлять вместе с workflow

Для подготовки файла предназначено расширение gh-actions-lock. Оно создаёт .github/workflows/actions.lock и помогает поддерживать записи в актуальном состоянии. Начинать разумно с небольшого workflow, где легко перечислить внешние действия и проверить diff. Расширение развивается, поэтому его версию и актуальные ограничения тоже стоит учитывать.

gh extension install github/gh-actions-lock
gh actions-lock
gh actions-lock --verify

Первый запуск меняет файлы, а режим проверки нужен для обнаружения несогласованного состояния. Изменение uses: и соответствующий lockfile следует рассматривать вместе. Если обновить только читаемую ссылку, рецензент получит неполную картину того, какой код будет исполняться после слияния.

Полезно назначить владельца проверки таких изменений. В diff важен новый коммит и причина обновления, а не только факт, что генератор успешно завершился. Автоматический инструмент может подготовить точную запись, но решение о переходе на новую зависимость всё равно требует понимания её поведения.

Не путать покрытие с проверкой происхождения

У расширения есть локальная проверка покрытия и проверка с обращением к GitHub. Они решают разные задачи. Быстрый локальный режим помогает рано обнаружить отсутствующую запись; более полная проверка нужна перед слиянием. Ограничения инструмента, включая контейнерные образы и отдельные формы зависимостей, нужно сверять с используемой версией.

Практический результат внедрения — понятный процесс обновления сборочных инструментов. Новый workflow получает lockfile, CI проверяет согласованность, а рецензент видит изменение исполняемого кода. Такой подход дополняет минимальные права токенов и осмысленный выбор действий. Он делает цепочку зависимостей более прозрачной, сохраняя удобные для чтения названия версий в основном файле.

АвторAnthony Fubon

Anthony Fubon — российский музыкант, DJ, музыкальный продюсер, организатор мероприятий и специалист по цифровым продуктам. В музыке он использовал несколько имён, в частности Fubon, TheFubon и yagelProject. Его собственная биография описывает путь от рок-музыки и российской psytrance-сцены к электронной музыке разных направлений и созданию собственной цифровой экосистемы.