قفل کردن GitHub Actions با lockfile
خلاصهٔ کاملتر
GitHub Actions از اکتبر ۲۰۲۶ به طور رسمی از workflow lockfile پشتیبانی میکنه. تا قبل از این، توصیه این بود که اکشنها رو با SHA کامل کامیت pin کنی، نه با تگ. دلیلش اینه که تگها قابل جابهجا شدنن و یه مهاجم میتونه یه تگ قبلاً امن رو به کد مخرب اشاره بده؛ یعنی همون حملهی supply-chain که مثلاً تو ماجرای tj-actions/changed-files اتفاق افتاد. هیوگو ونکمناد تو این پست نشون میده خودش چطور lockfile رو راه انداخته.
ابزارش یه اکستنشن برای gh CLI به اسم gh-actions-lock هست. وقتی تو ریپو gh actions-lock رو اجرا میکنی، SHAهای داخل workflow به تگهای خوانای vX.Y.Z برمیگردن و یه فایل .github/workflows/actions.lock ساخته میشه. این فایل برای هر اکشن، کامیت دقیق و owner_id و repo_id رو نگه میداره. یعنی خوانایی تگ رو داری و امنیت pin کردن رو هم از دست نمیدی:
dependencies:
'actions/checkout@v7.0.1':
ref: 'v7.0.1'
commit: 'sha1-3d3c42e5aac5ba805825da76410c181273ba90b1'
owner_id: 44036562
repo_id: 197814629به گفتهی نویسنده، Renovate و Dependabot هر دو از قبل lockfile رو میشناسن و آپدیتهای دورهای، این فایل رو هم بهروز میکنن. اون توصیه میکنه cooldown هم براشون بذاری، یعنی یه نسخهی تازه رو چند روز بعد از انتشار برداری نه همون لحظه.
گیتهاب پیشنهاد میده تو CI هم چک کنی lockfile بهروز و سالم باشه. نویسنده به جای کپی کردن فایل verify-lockfile.yml، یه job جدا به اسم lockfile به workflow لینتش اضافه کرده که روی رانر سبک ubuntu-slim اجرا میشه و gh actions-lock --verify رو صدا میزنه. این job وقتی lockfile با workflowها هماهنگ نباشه یا یه pin دیگه تو upstream تأیید نشه، fail میشه. نکته اینکه خود اکستنشن روی نسخهی v0.4.1 pin شده و باید یه روزی آپدیتش کرد. اگه workflow جدیدی اضافه کنی، باید دوباره lock کنی و CI بهت یادآوری میکنه.
آخر سر، نویسنده استفاده از zizmor (یه لینتر امنیتی برای GitHub Actions) رو جدی توصیه میکنه. نسخههای قبل از v1.32.0 هنوز میگن اکشنها رو hash-pin کن و v1.32.0 اولین نسخهایه که lockfile رو میشناسه. نویسنده این تغییر رو روی پروژههایی مثل Pillow و CPython هم اعمال کرده.
نکات کلیدی:
- lockfileهای GitHub Actions از ۲۸ اکتبر ۲۰۲۶ به طور رسمی در دسترسن
- دستور gh actions-lock فایل .github/workflows/actions.lock رو میسازه
- با gh actions-lock --verify تو CI میشه هماهنگ بودن lockfile رو چک کرد
- Renovate و Dependabot از lockfile پشتیبانی میکنن
- zizmor از نسخهی v1.32.0 به بعد lockfile رو میشناسه




