Enabling GitHub Actions with Amazon S3 storage

Prerequisites

Before enabling GitHub Actions, make sure you have completed the following steps:

• Create your Amazon S3 bucket for storing artifacts 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プロキシサーバーの設定」を参照してく� さい。

Enabling GitHub Actions with Amazon S3 storage

1. your GitHub Enterprise Server instanceにSSHでアクセスしてく� さい。 詳しい情� �については「管理シェル（SSH）にアクセスする」を参照してく� さい。

   $ ssh -p 122 admin@HOSTNAME

2. Run the ghe-actions-precheck command to test your blob storage configuration. 詳しい情� �については、「コマンドラインユーティリティ」を参照してく� さい。

3. From an administrative account on GitHub Enterprise Server, in the upper-right corner of any page, click .

   

4. If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.

   

5. 左のサイドバーでManagement Consoleをクリックしてく� さい。

6. サイドバーでActions（アクション）をクリックしてく� さい。

7. Enable GitHub Actions（GitHub Actionsの有効化）を選択してく� さい。

8. Under "Artifact & Log Storage", select Amazon S3, and enter your storage bucket's details:

   • AWS Service URL: The service URL for your bucket. For example, if your S3 bucket was created in the us-west-2 region, this value should be https://s3.us-west-2.amazonaws.com.

     For more information, see "AWS service endpoints" in the AWS documentation.

   • AWS S3 Bucket: The name of your S3 bucket.

   • AWS S3 Access Key and AWS S3 Secret Key: The AWS access key ID and secret key for your bucket. For more information on managing AWS access keys, see the "AWS Identity and Access Management Documentation."

   

9. 左のサイドバーの下でSave settings（設定の保存）をクリックしてく� さい。

   

   Note: Saving settings in the Management Console restarts system services, which could result in user-visible downtime.

10. 設定が完了するのを待ってく� さい。

    

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."