必要な環境
警告: サポートされているS3のストレージプロバイダは、Amazon S3とMinIO Gateway for NASのみです。 他のS3 API互換ストレージプロバイダはサポートされていません。 サポートされているストレージプロバイダに関する詳しい情報については「GitHub Enterprise ServerのためのGitHub Actionsの利用を始める」を参照してください。
GitHub Actions を有効化する前に、次のステップを完了していることを確認してください。
-
Create your Amazon S3 bucket for storing data generated by workflow runs. GitHub Actionsは、バケットにアクセスするアクセスキーのために以下の権限を必要とします。
s3:PutObject
s3:GetObject
s3:ListBucketMultipartUploads
s3:ListMultipartUploadParts
s3:AbortMultipartUpload
s3:DeleteObject
s3:ListBucket
kms:GenerateDataKey
(if Key Management Service (KMS) encryption has been enabled)
-
Review the hardware requirements for GitHub Actions. For more information, see "Getting started with GitHub Actions for GitHub Enterprise Server."
-
TLS must be configured for your GitHub Enterprise Server instance's domain. For more information, see "Configuring TLS."
Note: 信頼された認証局によって署名された証明書でGitHub Enterprise Server上のTLSを設定することを強くおすすめします。 自己署名証明書でも動作はしますが、セルフホストランナーに追加の設定が必要になり、プロダクションの環境では推奨されません。
-
your GitHub Enterprise Server instanceでHTTPプロキシサーバーを設定しているなら、HTTPプロキシの除外リストに
localhost
と127.0.0.1
を追加しなければなりません。 プロキシの設定変更に関する詳しい情報については「アウトバウンドのWebプロキシサーバーの設定」を参照してください。
Amazon S3 ストレージで GitHub Actions を有効化する
-
your GitHub Enterprise Server instanceにSSHでアクセスしてください。 詳しい情報については「管理シェル(SSH)にアクセスする」を参照してください。
$ ssh -p 122 admin@HOSTNAME
-
Run the
ghe-actions-precheck
command to test your blob storage configuration. 詳しい情報については、「コマンドラインユーティリティ」を参照してください。 -
From an administrative account on GitHub Enterprise Server, in the upper-right corner of any page, click .
-
If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.
-
左のサイドバーでManagement Consoleをクリックしてください。
-
サイドバーでActions(アクション)をクリックしてください。
-
Enable GitHub Actions(GitHub Actionsの有効化)を選択してください。
-
[Artifact & Log Storage] で、[Amazon S3] を選択し、ストレージバケットの詳細を入力します。
-
AWS Service URL: バケットのサービス URL。 たとえば、S3 バケットが
us-west-2
リージョンで作成された場合、この値はhttps://s3.us-west-2.amazonaws.com
である必要があります。詳しい情報については、AWS ドキュメントの「AWS サービスエンドポイント」を参照してください。
-
AWS S3 Bucket: S3 バケットの名前。
-
AWS S3 Access Key および AWS S3 Secret Key: バケットの AWS アクセスキー IDと シークレットキー。 AWS アクセスキーの管理の詳細については、「AWS ID およびアクセス管理のドキュメント」を参照してください。
-
-
左のサイドバーの下でSave settings(設定の保存)をクリックしてください。
Note: Saving settings in the Management Console restarts system services, which could result in user-visible downtime.
-
設定が完了するのを待ってください。
Next steps
After the configuration run has successfully completed, GitHub Actions will be enabled on your GitHub Enterprise Server instance. For your next steps, such as managing GitHub Actions access permissions and adding self-hosted runners, return to "Getting started with GitHub Actions for GitHub Enterprise Server."