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.

前提条件

警告: サポートされている S3 ストレージ プロバイダーは、Amazon S3 と MinIO Gateway for NAS のみです。 他のS3 API互換ストレージプロバイダはサポートされていません。 サポートされているストレージ プロバイダーの詳細については、「GitHub Enterprise Server の 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) の暗号化が有効な場合)
  • GitHub Actionsのためのハードウェア要件をレビューしてください。 詳細については、「GitHub Enterprise Server の GitHub Actions の概要」を参照してください。

  • your GitHub Enterprise Server instanceのドメインに合わせてTLSを設定しなければなりません。 詳細については、「TLS の構成」を参照してください。

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

  • your GitHub Enterprise Server instance に HTTP プロキシ サーバー が構成されている場合:

    • localhost127.0.0.1HTTP プロキシ除外 リストに追加する必要があります。
    • BYOS バケットがルーティングできない場合は、バケットの URL も除外リストに追加する必要があります。

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

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

  1. your GitHub Enterprise Server instance に SSH でアクセスします。 インスタンスが複数のノードで構成されている場合は (高可用性や geo レプリケーションが構成されている場合など)、プライマリ ノードに SSH 接続します。 クラスターを使用する場合は、任意のノードに SSH 接続できます。 SSH 接続について詳しくは、「管理シェル (SSH) にアクセスする」をご覧ください。

    $ ssh -p 122 admin@HOSTNAME
    1. `ghe-actions-precheck` コマンドを実行すると、Blob Storage の構成をテストできます。 詳細については、「[コマンド ライン ユーティリティ](/admin/configuration/configuring-your-enterprise/command-line-utilities#ghe-actions-precheck)」を参照してください。 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 とアクセス管理のドキュメント」を参照してください。

    S3 構成の Amazon S3 Storage とフィールドを選択するためのラジオ ボタン 1. 左側のサイドバーで、 [設定の保存] をクリックします。

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

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

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

    インスタンスの設定

次のステップ

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