CI ジョブはコマンドを実行でき、認証情報を受け取る場合もあります。権限は、その認証情報で何を読み取ったり変更したりできるかを決めます。ページのチェックだけを行うジョブなら、通常はソースファイルの読み取り権限で足ります。
継続的インテグレーション · レッスン 7
ワークフローの権限
日常的な CI チェックに、必要なリポジトリの権限だけを与える方法を学びます。
チェックに読み取り権限を与える
この GitHub Actions の設定では、ワークフローに標準で付与されるトークンを、リポジトリの内容の読み取りに限定します。
permissions:
contents: read
チェックアウトとローカルのテストでは、リポジトリを読み取れます。パッケージを公開するジョブには、別のリソースに対する別の操作権限が必要です。公開の権限は、それを必要とするジョブだけに与えます。
あるジョブではページを読み、grep を実行します。リポジトリの内容に対して、どの権限が必要ですか?
秘密情報を扱う
非公開のトークンなどの機密値をシークレットと呼びます。承認済みのジョブで必要になった場合は、プラットフォームのシークレット管理機能を使います。一般的なページ設定とシークレットは分けて管理します。ローカルのサンプルを定期的にチェックするだけなら、公開用の認証情報を使わずに実行できるようにします。
アクセスを制限したシークレット管理機能で扱うべきものはどれですか?
調査に役立つログを残す
ワークフローのログは、他の人と共有されることがあります。操作とその結果を、シークレットの値を出力せずに記録します。例えば、必要な認証情報を取得できなかった、あるいはアクセスが拒否されたと書けます。管理者が調査できるようにジョブ名とリビジョンを添え、認証情報そのものはメッセージに含めません。
公開ジョブで認証できません。認証情報を公開せずに、調査に役立つメッセージはどれですか?
新しいジョブをレビューする
提案されたワークフローは、プルリクエストでページをチェックし、パッケージを公開するジョブを追加します。この二つのジョブに必要な権限は異なります。チェックに与える権限は必要な読み取りに限り、承認された公開権限は実際に公開するジョブだけに与えます。
二つのジョブの要件を最もよく満たす修正はどれですか?
レッスン完了
ワークフローの権限 を完了しました
小さな CI パイプラインに必要な権限を判断できるようになりました。
ジョブの作業に合わせて、リポジトリの権限を設定します。
非公開の認証情報は、アクセスが制限された場所に保管します。
認証情報の値を含めず、調査に役立つエラーを記録します。