Skip to main content

NAS ストレージ用の MinIO ゲートウェイで GitHub Actions を有効化する

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

Who can use this feature

Site administrators can enable GitHub Actions and configure enterprise settings.

警告: MinIO は MinIO Gateway の削除を発表しています。 2022 年 6 月 1 日以降、現在の MinIO NAS ゲートウェイ実装のサポートとバグ修正は、LTS サポート 契約を結んだ有料のお客様のみが利用できるようになります。 GitHub Actions で引き続き MinIO ゲートウェイを使用する場合は、MinIO LTS のサポートに移行することをお勧めします。 詳細については、minio/minio リポジトリ内の GCS、Azure、HDFS 用 MinIO Gateway のスケジュールされた削除に関するページを参照してください。

前提条件

GitHub Actions を有効化する前に、次のステップを完了していることを確認してください。

  • アプライアンスでのリソースの競合を回避するために、MinIO を your GitHub Enterprise Server instance とは別にホストすることをお勧めします。

  • ワークフロー データを保存するためのバケットを作成します。 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 プロキシ サーバーの構成」を参照してください。

NAS ストレージ用の MinIO ゲートウェイで 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 Service URL](AWS サービス URL) : MinIO サービスの URL。 たとえば、https://my-minio.example:9000 のようにします。
    • [AWS S3 Bucket](AWS S3 バケット) : S3 バケットの名前。
    • [AWS S3 Access Key](AWS S3 アクセス キー) および [AWS S3 Secret Key](AWS S3 秘密鍵) : MinIO インスタンスで使用される MINIO_ACCESS_KEY および MINIO_SECRET_KEY

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

  4. [Artifact & Log Storage](成果物とログ ストレージ) の下で、 [Force path style](パス スタイルの強制) を選択します。 パス スタイルを強制するチェックボックス 1. 左側のサイドバーで、 [設定の保存] をクリックします。

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

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

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

    インスタンスの設定

次のステップ

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