Skip to main content
ドキュメントへの更新が頻繁に発行されており、このページの翻訳はまだ行われている場合があります。 最新の情報については、「英語のドキュメント」を参照してください。
All products
エンタープライズ管理者

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

この記事の内容

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

この機能を使用できるユーザー

Site administrators can enable GitHub Actions and configure enterprise settings.

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のためのハードウェア要件をレビューしてください。 詳しくは、「GitHub Enterprise Server の GitHub Actions を使い始める」を参照してください。

  • TLS は、お使いの GitHub Enterprise Server インスタンス のドメイン用に構成されている必要があります。 詳しくは、「TLSの設定」を参照してください。

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

  • お使いの GitHub Enterprise Server インスタンス に HTTP プロキシ サーバーが構成されている場合:

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

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

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

  1. AWS コンソールまたは CLI を使って、ストレージ バケット用のアクセス キーを作成します。 GitHub Actionsは、バケットにアクセスするアクセスキーのために以下の権限を必要とします。

    • s3:PutObject
    • s3:GetObject
    • s3:ListBucketMultipartUploads
    • s3:ListMultipartUploadParts
    • s3:AbortMultipartUpload
    • s3:DeleteObject
    • s3:ListBucket
    • kms:GenerateDataKey (キー管理サービス (KMS) の暗号化が有効な場合)

    AWS アクセス キーの管理の詳細については、「AWS ID とアクセス管理のドキュメント」を参照してください。

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

  3. [サイト管理者] ページにまだ表示されていない場合は、左上隅の [サイト管理者] をクリックします。 1. [ サイト管理者] サイドバーで [Management Console] をクリックします。 1. [設定] サイドバーで [Actions] をクリックします。 1. [GitHub Actions] で、 [GitHub Actions を有効にする] を選びます。

  4. [成果物とログ ストレージ] の下で、 [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 とシークレット キー。 1. [ストレージ設定のテスト] ボタンをクリックして、ストレージ設定を検証します。

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

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

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

次のステップ

設定の実行が正常に完了すると、GitHub Actions は お使いの GitHub Enterprise Server インスタンス 上で有効になります。 次の手順 (GitHub Actionsのアクセス許可の管理、セルフホステッド ランナーの追加など) については、「GitHub Enterprise Server の GitHub Actions を使い始める」に戻ります。