Skip to main content
Skip to content

インスタンスへのアップグレードに関する既知の問題

GitHub Enterprise Serverのアップグレード プロセスに影響を与える問題、またはアップグレード完了後にインスタンスに影響を与える問題の回避策の概要を参照してください。

GitHub Enterprise Serverアップグレードに関する既知の問題について

GitHub は、 GitHub Enterprise Serverの新しいリリースへのアップグレードに影響を与える可能性がある次の問題を認識しています。 詳細については、 GitHub Enterprise Server リリース ノートの「既知の問題」を参照してください。

アップグレードを試みるときにエラー The file provided is not a valid GitHub Enterprise Server package が表示される場合は、インスタンスで GPG 署名キーをローテーションすることが必要になる場合があります。 詳しくは、「アップグレード パッケージの署名キーのローテーション」をご覧ください。

GitHub では、インスタンスの構成とデータの定期的なバックアップを強くお勧めします。 アップグレードを続行する前に、インスタンスをバックアップしてから、ステージング環境でバックアップを検証します。 詳細については、「バックアップ ユーティリティを使用したインスタンスでのバックアップの構成」および「ステージングインスタンスのセットアップ」を参照してください。

SAML NameID 照合では大文字と小文字が区別されます

この変更は、2026 年 11 月 17 日にリリースされた GitHub Enterprise Server 3.19.16、3.20.12、3.21.10、および 3.22.5 に適用されます。 GitHub Enterprise Cloud には適用されず、SCIM プロビジョニングが有効になっている GitHub Enterprise Server インスタンスにも適用されません。

セキュリティ修正により、SAML NameID 値が既存のアカウントに照合される方法が変更されます。 大文字、アクセント、または末尾のスペースの違いは無視されるのではなく拒否されます。 これは、SAML サインインが間違った GitHub アカウントを選択するのを防ぐのに役立ちます。

SAML 認証中に ID プロバイダー (IdP) によって送信された NameID が、 GitHub Enterprise Serverに格納されているユーザーの SAML マッピングと正確に一致しない場合、認証は失敗します。 たとえば、Monaの受信NameIDが、格納されているNameIDのmonaと一致しなくなりました。 ユーザーにはエラー Another user already owns the account. Please have your administrator check the authentication log. が表示されます

アップグレードする前に、IdP によって送信される SAML NameID 値が、格納されている SAML マッピング NameID 値 (大文字と小文字が同じなど) と正確に一致することを確認します。

  1. サイト管理者ダッシュボードの [NameID] タブで、ユーザーの保存されている SAML **** を確認します。 詳しくは、「ユーザーの SAML NameID の更新」をご覧ください。 ghe-saml-mapping-csv --dumpを使用してマッピングをエクスポートすることもできます。 このユーティリティは、SCIM プロビジョニングを使用するインスタンスをサポートしていません。
  2. ユーザーの受信した SAML NameID を確認します。 SAML デバッグを一時的に有効にし、ユーザーの SAML サインイン試行を再現し、systemdジャーナル ログの SAML 応答のNameIDでgithub-unicornを調べます。 過剰なログ記録と潜在的なパフォーマンスへの影響を回避するには、その直後にデバッグを無効にします。 詳しくは、「SAML認証のトラブルシューティング」をご覧ください。

値が異なる場合は、IdP によって送信された値と一致するように、ユーザーに保存されている SAML NameID マッピングを更新します。

以前の大文字と小文字を区別しない SAML NameID の照合動作の復元に取り組んでいます。 リリース ノートで、この更新プログラムが利用可能になった際にお知らせします。

バージョン 3.15 以降へのアップグレードでの一時停止の解除

バージョン 3.15、3.16、3.17 へのアップグレードでの一時停止を解除しました。 3.15.12、3.16.8、3.17.5 以降にアップグレードできるようになりました。 3.15、3.16、または 3.17 のそれより前のリリースへのアップグレードはお勧めしません。 追加のステップとして、アップグレードの前にシステムの容量を調べることをお勧めします。 「アップグレードする前にシステムの容量を確認する」を参照してください。

バージョン 3.14、3.15、3.16、3.17 のサポート期間を延長しました。 3.13 のサポート期間は変更されません。 3.14、3.15、3.16、3.17 の各終了日が更新されました。 詳しくは、「GitHub Enterprise Server リリース」をご覧ください。

この延長されたサポート期間の全期間を通して、3.14、3.15、3.16、3.17 の修正プログラムを引き続きリリースします。

必要なルート ディスク サイズは 400 GB に増えました

メモ

バージョン 3.15.2 以降では、以前の 400 GB というルート ディスク サイズ要件が削除されました。 この要件は、サポート バンドルとサポート チケットの分析に基づいていました。 ログなどのいくつかの要因により、ルート ディスクに過剰な負荷がかかり、アプライアンスの issue が発生していました。 多くのお客様にとって新しいハードウェアの調達は困難であるというフィードバックを受け、段階的なアプローチを優先して、この要件を撤回しました。 特にスタンドアロンまたはスタンドアロンの高可用性トポロジを使っているお客様の場合は、ルート ディスクを 400 GB にアップグレードすることをお勧めします。 ルート ディスクを 400 GB にアップグレードできる場合は、以下の手順を参照してください。

スタンドアロンまたは HA トポロジを使っているお客様の場合は、3.15 以降を新規にインストールするか、3.15 にアップグレードして、400 GB 以上のルート ディスク サイズを使うことをお勧めします。 GitHub ストレージ容量の増加 のガイダンスに従うことを強くお勧めします。

解読できないレコード

GitHub Enterprise Server 3.11 または 3.12 から 3.13 にアップグレードする場合、または 3.12 から 3.14 にアップグレードする場合は、復号化に必要なキーがないため、解読できないレコードに問題が発生する可能性があります。 唯一の解決策は、解読できないレコードを削除することです。 この issue の影響を受けるレコードの種類は 2FA レコードです。つまり、ユーザーに 2 要素認証 (2FA) を再度有効にするよう求める必要がある場合があります。

アップグレードする前に

GitHub Enterprise Server 3.11 または 3.12 から 3.13 にアップグレードする場合、または 3.12 から 3.14 にアップグレードする場合は、暗号化診断スクリプトを実行して、事前に解読できないレコードを特定できます。 このスクリプトはレコードを変更するものではなく、影響を理解し、それに対する計画を立てる機会を提供するものです。

  1. 暗号化診断スクリプトをダウンロードします。 curl -L -O https://gh.io/ghes-encryption-diagnostics などのコマンドを使ってスクリプトをダウンロードできます。
  2. アプライアンス上の /data/user/common ディレクトリにスクリプトを保存します。
  3. スクリプトの先頭にある指示に従って、アプライアンスで実行します。 解読できないレコードがある場合は、/tmp/column_encryption_records_to_be_deleted.log にログされます。 ここで記録されたレコードは、システムがレコードの暗号化に使用されたキーを見つけられなかったため、暗号化を解除できませんでした。

これらのレコードは、アップグレード プロセスの一部として削除されることに注意してください。 このスクリプトでは、アップグレード後に 2FA に再登録する必要があるユーザーに関する警告が表示されます。 影響を受けるユーザーのハンドルが、/tmp/column_encryption_users_to_have_2fa_disabled.log にログされます。 これらのユーザーは、2FA に再登録する必要があります。

スクリプトで予期しない問題が発生した場合は、GitHub のサポートに連絡するように求められます。 これらの問題に関連するエラーは、/tmp/column_encryption_unexpected_errors.log にログされます。 深刻な状況にあり、ユーザーに 2FA への再登録を許可できない場合は、GitHub のサポートにお問い合わせください。

スクリプトは "Success: Encrypted Records OK" を出力します。 暗号化されたレコードに関連付けられているキーを見つけることができた場合。 これらのレコードは暗号化解除され、アップグレード プロセス中に保持されるため、手動による介入は必要ありません。

アップグレード中

事前に暗号化診断スクリプトを実行する機会がなかった場合は、製品に役立つメカニズムがあります。 アップグレード プロセスの間の事前チェックでは、解読できないレコードが検出されて /tmp/column_encryption_records_to_be_deleted.log にログされます。 このシーケンスでは、アップグレード後に 2FA の再有効化が必要なユーザーが警告されます。 影響を受けるユーザーのレコードが、/tmp/column_encryption_users_to_have_2fa_disabled.log にログされます。

解読できないレコードが検出されると、アップグレードを続けるかどうかを確認するメッセージが表示されます。 続けた場合、解読できないレコードはアップグレード プロセスによって削除されます。 それ以外の場合は、アップグレード プロセスが終了します。

アップグレード中に質問がある場合は、 GitHub のサポートに連絡できます。 影響を理解する時間と機会があれば、アップグレードを再トリガーできます。