Repolode
github

github/gh-actions-lock

ワークフロー内のすべてのActionを特定のコミットに固定し、CIでロックファイルを検証するGitHub CLI拡張機能。

スター
300
フォーク
22
未解決の Issue
33
最終コミット
昨日

これは何?

gh-actions-lockは、GitHub Actionsの依存関係を記録したロックファイルを生成・検証するGitHub CLI拡張機能です。ワークフローから参照される直接・間接のすべてのActionを解決し、それぞれが解決された正確なコミットを.github/workflows/actions.lockに記録するため、タグやブランチが移動してもCIの実行内容が知らないうちに変わることはありません。

複数のモードを利用できます。ロックファイルを書き込む、または更新するfixモード、mainやv4などの浮動参照を現在の上流コミットに進めるrelockモード、fixと同じチェックをCIで実行するverifyモード、そしてすべてのuses:行にロックファイルのエントリーがあることを確認する、pre-commit hook向けのオフラインverify-localモードです。github.comとデータレジデンシー対応のGitHub Enterprise Cloudをサポートしていますが、GitHub Enterprise Serverには対応していません。

既知の制限も記載されています。ほかのリポジトリから呼び出される再利用可能なワークフローや、digestのないコンテナイメージはロックされません。また、ローカルの./アクションは追跡されません。

主な機能

  • 01直接・間接のGitHub Actionsを特定のコミットに固定し、actions.lockに記録します。
  • 02CI向けのverifyモードと、pre-commitチェック向けのオフラインverify-localモードを提供します。
  • 03mainやv4などの浮動参照を、現在の上流コミットに再ロックできます。
  • 04github.comとデータレジデンシー対応のGitHub Enterprise Cloudをサポートします。
  • 05--jsonで機械可読な結果を出力します。

ユースケース

  • リポジトリ内のActionのバージョンをロックし、レビュー済みのコミットでCIを実行する。
  • Pull Requestのチェックにロックファイルの検証ステップを追加する。
  • ワークフローの変更をコミットする前に、オフラインで網羅性を確認する。

クイックスタート

  1. 1

    GitHub CLI 拡張機能をインストールします

    gh extension install github/gh-actions-lock
  2. 2

    リポジトリのチェックアウトから、すべてのアクションを固定してロックファイルを書き込みます

    gh actions-lock
  3. 3

    ロックファイルをソース管理に含めるため、ワークフローディレクトリをステージします

    git add .github/workflows/

使う前に知っておきたいこと

  • 認証済みの gh CLI が必要です。
  • GitHub Enterprise Server はサポートされていません。
  • 別のリポジトリから呼び出された再利用可能なワークフローはロックされません。
  • @sha256 ダイジェストのないコンテナイメージは警告が表示され、ロックされません。

収録されている特集

トピック

#github-actions#supply-chain-security#dependency-pinning#lockfile#cli#devops#gh-extension#go#security

よくある質問

gh-actions-lock とは?
ワークフロー内のすべてのActionを特定のコミットに固定し、CIでロックファイルを検証するGitHub CLI拡張機能。 gh-actions-lockは、GitHub Actionsの依存関係を記録したロックファイルを生成・検証するGitHub CLI拡張機能です。ワークフローから参照される直接・間接のすべてのActionを解決し、それぞれが解決された正確なコミットを.github/workflows/actions.lockに記録するため、タグやブランチが移動してもCIの実行内容が知らないうちに変わることはありません。
gh-actions-lock は無料で使えますか?ライセンスは?
gh-actions-lock は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
gh-actions-lock は今もメンテナンスされていますか?
活発にメンテナンス中。gh-actions-lock の最終コミットは 2026年11月6日 です。
gh-actions-lock は何に使えますか?
リポジトリ内のActionのバージョンをロックし、レビュー済みのコミットでCIを実行する。 Pull Requestのチェックにロックファイルの検証ステップを追加する。 ワークフローの変更をコミットする前に、オフラインで網羅性を確認する。
gh-actions-lock のインストール方法は?
GitHub CLI 拡張機能をインストールします: gh extension install github/gh-actions-lock リポジトリのチェックアウトから、すべてのアクションを固定してロックファイルを書き込みます: gh actions-lock ロックファイルをソース管理に含めるため、ワークフローディレクトリをステージします: git add .github/workflows/
gh-actions-lock はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/github/gh-actions-lock

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト

インストーラーやパッケージマネージャーが、ホストに適したバイナリアーティファクトを選び、検証できる署名付きリリースマニフェスト。

セキュリティ#supply-chain-security#release-engineering#code-signing
198+13 今週5RustMIT活発にメンテナンス更新 22 時間前