注: GitHub Actions の Google Cloud Storage のサポートは現在ベータ版であり、変更される可能性があります。
GitHub Actions の外部ストレージについて
GitHub Actions は、ワークフロー ログ、キャッシュ、ユーザーがアップロードしたビルド成果物など、ワークフローの実行によって生成されたデータを、外部の BLOB ストレージを使って保存します。 詳しくは、「GitHub Enterprise Server の GitHub Actions を使ってみる」をご覧ください。
前提条件
GitHub Actions を有効化する前に、次のステップを完了していることを確認してください。
-
ワークフローの実行によって生成されるデータを保存するための Google Cloud Storage バケットを作成します。
-
バケットにアクセスできる Google Cloud サービス アカウントを作成し、サービス アカウントのハッシュベースのメッセージ認証コード (HMAC) キーを作成します。 詳細については、Google Cloud ドキュメントの「サービス アカウントの HMAC キーの管理」を参照してください。
サービス アカウントには、バケットに対する次の ID およびアクセス管理 (IAM) アクセス許可が必要です。
storage.objects.create
storage.objects.get
storage.objects.list
storage.objects.update
storage.objects.delete
storage.multipartUploads.create
storage.multipartUploads.abort
storage.multipartUploads.listParts
storage.multipartUploads.list
* GitHub Actionsのためのハードウェア要件をレビューしてください。 詳細については、「GitHub Enterprise Server の GitHub Actions の概要」を参照してください。
-
TLS は、your GitHub Enterprise Server instance のドメイン用に構成されている必要があります。 詳細については、「TLS の構成」を参照してください。
注: 信頼された認証局によって署名された証明書でGitHub Enterprise Server上のTLSを設定することを強くおすすめします。 自己署名証明書でも動作はしますが、セルフホストランナーに追加の設定が必要になり、プロダクションの環境では推奨されません。
-
your GitHub Enterprise Server instance に HTTP プロキシ サーバーが構成されている場合:
localhost
と127.0.0.1
を HTTP プロキシ除外リストに追加する必要があります。- ご利用の外部ストレージの場所がルーティング不可能である場合は、該当する外部ストレージ URL も、除外リストに追加する必要があります。
プロキシ設定の変更の詳細については、「アウトバウンドの Web プロキシ サーバーの構成」を参照してください。
Google Cloud Storage で GitHub Actions を有効にする
-
GitHub Enterprise Server の管理アカウントから、任意のページの右上隅の をクリックします。
-
[サイト管理者] ページにまだ表示されていない場合は、左上隅の [サイト管理者] をクリックします。
1. 左側のサイドバーで、 Management Console をクリックします。
1. 左側のサイドバーで、 [アクション] をクリックします。
1. [GitHub Actions の有効化] を選択します。
-
[成果物とログ ストレージ] で、 [Google Cloud Storage] を選び、バケットの詳細を入力します。
- [サービス URL] : バケットのサービス URL。 通常、これは
https://storage.googleapis.com
になります。 - [バケット名] : バケットの名前。
- [HMAC アクセス ID] と [HMAC シークレット] : ストレージ アカウントの Google Cloud アクセス ID とシークレット。 詳細については、Google Cloud ドキュメントの「サービス アカウントの HMAC キーの管理」を参照してください。
1. [ストレージ設定のテスト] ボタンをクリックして、ストレージ設定を検証します。
ストレージ設定の検証でエラーが発生した場合は、ストレージ プロバイダーで設定を確認し、もう一度やり直してください。 1. 左側のサイドバーで、 [設定の保存] をクリックします。
注: Management Console に設定を保存すると、システム サービスが再起動され、ユーザーに表示されるダウンタイムが発生する可能性があります。
- [サービス URL] : バケットのサービス URL。 通常、これは
-
設定の実行が完了するのを待ってください。
次のステップ
設定の実行が正常に完了すると、GitHub Actions は your GitHub Enterprise Server instance 上で有効になります。 GitHub Actions アクセス許可の管理やセルフホステッド ランナーの追加など、次の手順については、「GitHub Enterprise Server の GitHub Actions の概要」に戻ります。