Google Cloud Storage で GitHub Actions を有効にする

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 を有効にする

1. GitHub Enterprise Server の管理アカウントから、任意のページの右上隅の をクリックします。

   

2. [サイト管理者] ページにまだ表示されていない場合は、左上隅の [サイト管理者] をクリックします。

   1. 左側のサイドバーで、 Management Console をクリックします。 1. 左側のサイドバーで、 [アクション] をクリックします。

   1. [GitHub Actions の有効化] を選択します。

3. [成果物とログ ストレージ] で、 [Google Cloud Storage] を選び、バケットの詳細を入力します。

   • [サービス URL] : バケットのサービス URL。 通常、これは https://storage.googleapis.com になります。
   • [バケット名] : バケットの名前。
   • [HMAC アクセス ID] と [HMAC シークレット] : ストレージ アカウントの Google Cloud アクセス ID とシークレット。 詳細については、Google Cloud ドキュメントの「サービス アカウントの HMAC キーの管理」を参照してください。

   1. [ストレージ設定のテスト] ボタンをクリックして、ストレージ設定を検証します。

   ストレージ設定の検証でエラーが発生した場合は、ストレージ プロバイダーで設定を確認し、もう一度やり直してください。 1. 左側のサイドバーで、 [設定の保存] をクリックします。

   

   注: Management Console に設定を保存すると、システム サービスが再起動され、ユーザーに表示されるダウンタイムが発生する可能性があります。

4. 設定の実行が完了するのを待ってください。

   

次のステップ

設定の実行が正常に完了すると、GitHub Actions は your GitHub Enterprise Server instance 上で有効になります。 GitHub Actions アクセス許可の管理やセルフホステッド ランナーの追加など、次の手順については、「GitHub Enterprise Server の GitHub Actions の概要」に戻ります。