GitHub Actions の外部ストレージについて
GitHub Actions は、ワークフロー ログ、ユーザーがアップロードしたビルド成果物など、ワークフローの実行によって生成されたデータを、外部の BLOB ストレージを使って保存します。 詳しくは、「GitHub Enterprise Server の GitHub Actions を使ってみる」をご覧く� さい。
前提条件
注: GitHub でサポートされている S3 ストレージ プロバイダーは、Amazon S3 と MinIO Gateway for NAS のみです。
GitHub パートナーが GitHub Enterprise Server 上で GitHub Actions を操作していると自己検証している S3 API 互換ストレージ製品は他にもあります。 詳細については、GHES ストレージ パートナー リポジトリを参照してく� さい。
GitHub テクノロジ パートナーシップ プログラ� を通じて検証されたストレージ製品の� �合、ストレージ プロバイダーは、GitHub Actions でストレージ製品を使用するためのサポートとドキュメントを担当します。
GitHub Actions を有効化する前に、次のステップを完了していることを確認してく� さい。
-
ワークフローの実行によって生成されるデータを保存するための Amazon S3 バケットを作成します。 GitHub Actionsは、バケットにアクセスするアクセスキーのために以下の権限を必要とします。
s3:PutObject
s3:GetObject
s3:ListBucketMultipartUploads
s3:ListMultipartUploadParts
s3:AbortMultipartUpload
s3:DeleteObject
s3:ListBucket
kms:GenerateDataKey
(キー管理サービス (KMS) の暗号化が有効な� �合)
-
GitHub Actionsのためのハードウェア要件をレビューしてく� さい。 詳細については、「GitHub Enterprise Server の GitHub Actions の概要」を参照してく� さい。
-
のドメインに合わせてTLSを設定しなければなりません。 詳細については、「TLS の構成」を参照してく� さい。
注: 信� �された認証局によって署名された証明書でGitHub Enterprise Server上のTLSを設定することを強くおすすめします。 自己署名証明書でも動作はしますが、セルフホストランナーに追� の設定が必要になり、プロダクションの環境では推奨されません。
-
your GitHub Enterprise Server instance に HTTP プロキシ サーバー が構成されている� �合:
localhost
と127.0.0.1
を HTTP プロキシ除外 リストに追� する必要があります。- ご利用の外部ストレージの� �所がルーティング不可能である� �合は、該当する外部ストレージ URL も、除外リストに追� する必要があります。
プロキシ設定の変更の詳細については、「アウトバウンドの Web プロキシ サーバーの構成」を参照してく� さい。
Amazon S3 ストレージで GitHub Actions を有効化する
-
GitHub Enterprise Server の管理アカウントから、任意のページの右上隅の をクリックします。
-
[サイト管理者] ページにま� 表示されていない� �合は、左上隅の [サイト管理者] をクリックします。
1. 左側のサイドバーで、 [Management Console] をクリックします。 1. 左側のサイドバーで、 [アクション] をクリックします。
1. [GitHub Actions の有効化] を選択します。
-
[Artifact & Log Storage](成果物とログ ストレージ) の下で、 [Amazon S3] を選択し、ストレージ バケットの詳細を入力します。
-
AWS サービス URL: バケットのサービス URL。 たとえば、S3 バケットが
us-west-2
� �域で作成された� �合、この値はhttps://s3.us-west-2.amazonaws.com
になるはずです。詳細については、AWS ドキュメントの「AWS サービス エンドポイント」を参照してく� さい。
-
[AWS S3 Bucket](AWS S3 バケット) : S3 バケットの名前。
-
AWS S3 アクセス キー と AWS S3 シークレット キー: バケットのための AWS アクセス キー ID とシークレット キー。 AWS アクセス キーの管理の詳細については、「AWS ID とアクセス管理のドキュメント」を参照してく� さい。
1. [ストレージ設定のテスト] ボタンをクリックして、ストレージ設定を検証します。
ストレージ設定の検証でエラーが発生した� �合は、ストレージ プロバイダーで設定を確認し、もう一度やり直してく� さい。 1. 左側のサイドバーで、 [設定の保存] をクリックします。
注: [Management Console] に設定を保存すると、システ� サービスが再起動され、ユーザーに表示されるダウンタイ� が発生する可能性があります。
-
-
設定の実行が完了するのを待ってく� さい。
次のステップ
設定の実行が正常に完了すると、GitHub Actionsは上で有効になります。 GitHub Actions アクセス許可の管理やセルフホステッド ランナーの追� など、次の手� �については、「GitHub Enterprise Server の GitHub Actions の概要」に戻ります。