Skip to main content

Amazon S3 ストレージで GitHub Actions を有効化する

You can enable GitHub Actions on GitHub Enterprise Server and use Amazon S3 storage to store data generated by workflow runs.

Site administrators can enable GitHub Actions and configure enterprise settings.

必要な環境

警告: サポートされている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 (Key Management Service (KMS) の暗号化が有効になっている場合)
  • 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 GitHub Enterprise Serverインスタンス's domain. For more information, see "Configuring TLS."

    Note: 信頼された認証局によって署名された証明書でGitHub Enterprise Server上のTLSを設定することを強くおすすめします。 自己署名証明書でも動作はしますが、セルフホストランナーに追加の設定が必要になり、プロダクションの環境では推奨されません。

  • GitHub Enterprise Serverインスタンス上でHTTP Proxy Serverが設定されている場合:

    • localhost127.0.0.1HTTP Proxy Exclusionリストに追加しなければなりません。
    • BYOSバケットがルーティングできない場合、このバケットのURLも除外リストに追加しなければなりません。

    プロキシの設定変更に関する詳しい情報については「アウトバウンドのWebプロキシサーバーの設定」を参照してください。

Amazon S3 ストレージで GitHub Actions を有効化する

  1. GitHub Enterprise ServerインスタンスにSSHでアクセスしてください。 If your instance comprises multiple nodes, for example if high availability or geo-replication are configured, SSH into the primary node. If you use a cluster, you can SSH into any node. For more information about SSH access, see "Accessing the administrative shell (SSH)."

    $ ssh -p 122 admin@HOSTNAME
  2. blobストレージの設定をテストするには、ghe-actions-precheckコマンドを実行してください。 詳しい情報については、「コマンドラインユーティリティ」を参照してください。

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

    Screenshot of the rocket ship icon for accessing site admin settings

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

    Screenshot of "Site admin" link

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

  6. サイドバーでActions(アクション)をクリックしてください。

    設定サイドバーのActionsタブ

  7. Enable GitHub Actions(GitHub Actionsの有効化)を選択してください。 GitHub Actionsを有効化するチェックボックス

  8. [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 およびアクセス管理のドキュメント」を参照してください。

    Amazon S3 ストレージを選択するためのラジオボタンと S3 設定のフィールド

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

    Screenshot of the save settings button in the Management Console

    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 GitHub Enterprise Serverインスタンス. 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."