Skip to main content

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

GitHub Enterprise Server で GitHub Actions を有効化し、Amazon S3 ストレージを使用してワークフローの実行によって生成されたデータを保存できます。

Who can use this feature

Site administrators can enable GitHub Actions and configure enterprise settings.

前提条件

注: 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) の暗号化が有効な場合)
  • 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 プロキシ サーバー が構成されている場合:

    • localhost127.0.0.1HTTP プロキシ除外 リストに追加する必要があります。
    • ご利用の外部ストレージの場所がルーティング不可能である場合は、該当する外部ストレージ URL も、除外リストに追加する必要があります。

    プロキシ設定の変更の詳細については、「アウトバウンドの Web プロキシ サーバーの構成」を参照してください。

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

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

    サイト管理者設定にアクセスするための宇宙船アイコンのスクリーンショット

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

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

    設定サイドバーのActionsタブ 1. [GitHub Actions の有効化] を選択します。 GitHub Actions を有効にするチェックボックス

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

    Amazon S3 Storage と S3 構成のフィールドを選ぶためのラジオ ボタン 1. [ストレージ設定のテスト] ボタンをクリックして、ストレージ設定を検証します。

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

    [Management Console] の [設定の保存] ボタンのスクリーンショット

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

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

    インスタンスの設定

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