GitHub Actions ストレージの資格情報の更新

GitHub Actions ストレージに接続するための資格情報が変更された場合は、GitHub Enterprise Server の構成の資格情報を更新する必要があります。

この記事で

ストレージ プロバイダーの資格情報シークレットの更新

          GitHub ActionsでGitHub Enterprise Server ストレージ プロバイダーの資格情報シークレットを更新するには、2 つのオプションがあります。

警告

このプロセスは、既存の外部ストレージ プロバイダーに対する認証に使用される秘密鍵を更新する場合にのみ使用されます。 ネットワーク構成、ストレージ プロバイダー、ストレージ アカウントは変更されていないことを前提としています。

このプロセスを使用して、管理コンソールで資格情報ベースの認証と OIDC ベースの認証を切り替えないでください。 GitHub Actionsストレージの認証方法を変更すると、データが失われる可能性があります。

  1. サーバーでメンテナンス モードを有効にします。
  2. シークレットを更新するか、更新されたシークレットをストレージ プロバイダーから取得します。
  3. 以下の UI または CLI オプションを使用して、GitHub ActionsのGitHub Enterprise Serverストレージ プロバイダーの資格情報を更新します。

管理コンソールを使用した資格情報シークレットの更新

  1.        **管理コンソール**の [アクション] セクションに移動します。 詳細については、「[AUTOTITLE](/admin/administering-your-instance/administering-your-instance-from-the-web-ui/accessing-the-management-console)」を参照してください。
  2. シークレットを更新するか、Azure Blob Storageは接続文字列内のシークレットを更新し、 Test storage settings をクリックして、 GitHub Enterprise Server がストレージに正常に接続できることを確認します。
  3. [ Save settings ] をクリックし、サービスが完全に再起動するまで待ちます。

コマンド ラインを使用した資格情報シークレットの更新

  1.        `ghe-actions-precheck` コマンドを実行して、新しい Actions ストレージ資格情報をテストし、GitHub Enterprise Serverの構成を更新します。 詳細については、「[AUTOTITLE](/admin/administering-your-instance/administering-your-instance-from-the-command-line/command-line-utilities#ghe-actions-precheck)」を参照してください
  2. Actions ストレージ接続テストが成功すると、 Yes または No を入力して、これらの設定で Actions Storage を構成するように求められます。 「 Yes 」と入力して Enter キーを押します。
  3. 既存の Actions ストレージ構成の上書きに関するプロンプトが表示されます。 「 Yes 」と入力して Enter キーを押します。

          GitHub Actions ストレージの認証エラーの特定

シークレットまたは接続文字列が正しくないためGitHub Enterprise ServerGitHub Actions ストレージ プロバイダーに接続できない場合は、Access Deniedまたは認証関連の例外が表示されます。 この例外は、次の 2 つの状況で発生する可能性があります。

  • ghe-check-blob-connectionを実行すると、コマンドはその出力で認証エラーを直接報告します。

  • ghe-config-apply実行すると、管理コンソールで [設定の保存] をクリックするか、コマンド ラインから手動でghe-config-apply実行してトリガーされます。 例外は、 /data/user/common/ghe-config.log ファイルに表示されます。 この場合、 ghe-config-apply は完了せず、アプライアンスで予期しないサービスの停止が発生する可能性があります。

            GitHub Enterprise Serverのストレージ プロバイダーの構成が正しいシークレットまたは接続文字列で更新されたら、`ghe-config-apply`を実行して、ジョブが再実行され、正常に完了することを確認できます。

メモ

接続エラーは、ネットワークの問題やストレージ エンドポイントの構成ミスなど、他の原因によっても発生する可能性があります。 エラーが認証に関連していないように見える場合は、エラー出力全体を確認して詳細を確認してください。

          `ghe-check-blob-connection`の詳細については、「[AUTOTITLE](/admin/administering-your-instance/administering-your-instance-from-the-command-line/command-line-utilities#ghe-check-blob-connection)」を参照してください。

          `ghe-config-apply`の詳細については、「[AUTOTITLE](/admin/administering-your-instance/administering-your-instance-from-the-command-line/command-line-utilities#ghe-config-apply)」を参照してください。