GitHub Actions теперь поддерживает lock-файлы для действий

GitHub Actions теперь поддерживает lock-файлы для действий

В заметке на сайте hugovk.dev сообщается, что GitHub Actions теперь поддерживает lock-файлы рабочих процессов. Автор пошагово разбирает, как перевёл на них свой репозиторий.

Предыстория. Действия GitHub Actions подтягиваются из Git, поэтому прежний совет был закреплять их по полному SHA коммита, а не по тегу. Причина: теги изменяемы, и злоумышленник может перенаправить ранее безопасный тег на вредоносный код. Старый workflow в примере выглядит так: actions/checkout подключён по длинному хэшу с комментарием «# v7.0.1», так же закреплён j178/prek-action с комментарием «# v3.1.0».

Как настроить. Сначала нужно установить расширение для gh CLI командой gh extension install github/gh-actions-lock. Затем в репозитории запускается gh actions-lock; в примере автора вывод, «All 1 workflows valid» (в репозитории один workflow). После этого в workflow вместо хэшей стоят теги вида vX.Y.Z (например, actions/checkout@v7.0.1 и j178/prek-action@v3.1.0), а в .github/workflows/actions.lock создаётся файл, сгенерированный машиной и не предназначенный для ручной правки. В нём есть версия формата (в примере 'v0.0.3'), список workflow с используемыми действиями и раздел dependencies, где для каждого действия записаны ref (тег), commit (SHA-1 коммита), а также идентификаторы владельца и репозитория (owner_id, repo_id). Изменённые workflow и новый lock-файл нужно закоммитить.

Renovate и Dependabot. По словам автора, оба инструмента уже поддерживают lock-файлы, и периодические обновления будут обновлять и их. Автор напоминает про использование cooldowns (периодов выдержки перед принятием свежих версий).

Проверка в CI. GitHub рекомендует проверять lock-файл в CI, чтобы он был актуальным и не повреждённым, и предлагает скопировать в репозиторий готовый verify-lockfile.yml. Автор вместо этого добавил в существующий lint-workflow отдельное задание lockfile, чтобы оно шло независимо и параллельно. Оно запускается на лёгком раннере ubuntu-slim, ставит расширение с фиксацией версии (--pin v0.4.1) и выполняет gh actions-lock --verify. Задание падает, если actions.lock не соответствует workflow или закреплённый пин больше не подтверждается в исходном репозитории. Версию v0.4.1 когда-нибудь придётся обновлять или автоматизировать это обновление; автор откладывает вопрос на потом. Кроме того, после добавления нового действия в workflow нужно заново выполнить gh actions-lock; если создан новый файл вроде verify-lockfile.yml, без этого не обойтись, и CI подскажет об этом.

zizmor. Автор настоятельно рекомендует zizmor, анализатор безопасности для GitHub Actions. Версии до v1.32.0 требуют закреплять действия по хэшу, а v1.32.0, первая, которая поддерживает lock-файлы. Автор использует zizmor через prek, поэтому в .pre-commit-config.yaml указывает rev: v1.32.0 для репозитория zizmorcore/zizmor-pre-commit. Затем остаётся закоммитить и отправить изменения.

Ключевые факты

  • GitHub Actions теперь поддерживает lock-файлы рабочих процессов; расширение для gh CLI называется github/gh-actions-lock и ставится командой gh extension install.
  • Вместо закрепления по SHA в workflow остаются теги vX.Y.Z, а точные коммиты записываются в .github/workflows/actions.lock.
  • Прежний совет закреплять по полному SHA объяснялся тем, что теги изменяемы и их можно перенаправить на вредоносный код.
  • GitHub рекомендует проверять lock-файл в CI; автор делает это отдельным заданием на раннере ubuntu-slim с командой gh actions-lock --verify.
  • Renovate и Dependabot уже умеют обновлять lock-файл, а zizmor поддерживает его начиная с v1.32.0.

Почему это важно

Изменяемые теги в GitHub Actions давно считались слабым местом цепочки поставок: атакующий может перенаправить прежде безопасный тег на вредоносный код. Прежнее решение, закрепление по полному SHA, работало, но делало workflow трудночитаемыми: вместо версии в файле стоял длинный хэш с комментарием. Lock-файл позволяет сочетать читаемые теги и закреплённые коммиты, которые записаны отдельно. Заметка не приводит примеров реальных атак: риск описан в общих чертах.

Кому это важно

Всем, кто поддерживает репозитории с workflow на GitHub Actions: разработчикам открытых проектов и командам, которые следят за безопасностью цепочки поставок. Отдельно упомянуты пользователи Renovate, Dependabot и линтера zizmor: их инструменты уже поддерживают lock-файлы.

Как это применить

Порядок из заметки. Первое: gh extension install github/gh-actions-lock. Второе: в репозитории выполнить gh actions-lock, закоммитить изменённые workflow и файл .github/workflows/actions.lock. Третье: добавить в CI задание с gh actions-lock --verify (GitHub предлагает готовый verify-lockfile.yml, автор встроил проверку в свой lint-workflow). Четвёртое: обновить zizmor минимум до v1.32.0, иначе он по-прежнему потребует закреплять действия по хэшу. При добавлении новых действий не забывайте заново запускать gh actions-lock. В заметке не сказано, на каких тарифах доступна функция и в каком она статусе (предварительный доступ или общий).

Можно ли доверять

Это личная заметка в блоге, а не официальная документация GitHub. Она подробна и содержит реальные фрагменты конфигурации и вывода команд, но пересказывает настройку одного автора. Рекомендации GitHub (проверять lock-файл в CI) изложены с его слов, ссылка на документацию в lock-файле, gh.io/actions-lockfile. Дату появления функции заметка не называет, как и устройство серверной проверки.

Риски и подводные камни

Версию расширения в CI-задании (v0.4.1) нужно закреплять и затем вручную или автоматически обновлять; автор оставляет этот вопрос на потом. После любого изменения набора действий в workflow lock-файл надо пересобирать, иначе проверка в CI упадёт. Старые версии zizmor (до v1.32.0) продолжат требовать закрепления по хэшу. При автоматических обновлениях через Renovate или Dependabot автор советует использовать cooldowns.