GitHub Enterprise Server
のホスト名の変更について
お使いの GitHub Enterprise Server インスタンス に新しいホスト名を使用する必要がある場合は、既存のインスタンスの設定とデータをバックアップし、新しいインスタンスを構成し、新しいインスタンスにバックアップを復元してから、新しいインスタンスにトラフィックを送信するように DNS 構成を調整する必要があります。
新しいインスタンスへの移行にはダウンタイムが必要です。 必要なダウンタイムの長さは、バックアップする必要があるデータの量と、バックアップ ホストとインスタンス間のネットワーク接続の速度によって異なります。
この記事では、「ソース インスタンス」という用語は古いホスト名のインスタンスを指し、「宛先インスタンス」という用語は新しいホスト名のインスタンスを指します。
警告: 初期セットアップ後に GitHub Enterprise Server のホスト名を変更しないでください。 ホスト名を変更すると、インスタンスの停止やユーザーのセキュリティ キーの無効化など、予期しない動作が生じます。 インスタンスのホスト名を変更して問題が発生した場合は、GitHub Enterprise サポート または GitHub Premium Support に問い合わせてください。
新しいホスト名を使用してインスタンスに移行する
-
使用する新しいホスト名を使用して、GitHub Enterprise Server の宛先インスタンスを構成します。 詳しくは、次のドキュメントを参照してください。
-
スケジュールされているダウンタイムをインスタンスのユーザーに通知します。 必要に応じて、サインインするすべてのユーザー向けに表示される必須メッセージを作成できます。 詳細については、「エンタープライズのユーザー メッセージをカスタマイズする」を参照してください。
-
ソース インスタンスで、メインテナント モードを有効にします。 詳しくは、「メンテナンスモードの有効化とスケジューリング」を参照してください。
-
GitHub Enterprise Server Backup Utilities を使用して、ソース インスタンスのデータと設定をバックアップします。 詳しくは、「インスタンスでのバックアップの構成」を参照してください。
-
任意のホスト名を使用して、バックアップを宛インスタンスに復元します。
ghe-restore
ユーティリティを実行するときは、-c
オプションを使用して宛先インスタンスの構成を上書きします。 詳しくは、「インスタンスでのバックアップの構成」を参照してください。 -
宛先インスタンスの構成を完了します。 詳しくは、「GitHub Enterprise を設定する」を参照してください。
-
宛先インスタンスでメンテナンス モードを有効にします。
-
必要に応じて、宛先インスタンスがメインテナント モードになっている間に、インスタンスの構成を検証し、ユーザー データがそのままであることを確認します。 詳しくは、「メンテナンスモードの有効化とスケジューリング」を参照してください。
-
宛先インスタンスにトラフィックを転送するには、宛先インスタンスの IP アドレスに解決されるように、ソース インスタンスのホスト名で DNS
CNAME
レコードを更新します。注: インスタンスの Web アプリケーションで復元されたユーザー生成コンテンツには、ソース インスタンスの古いホスト名を参照する URL が含まれている可能性があります。 必要に応じて、これらのリンクが引き続き宛先インスタンスに解決されるように、DNS を使用してリダイレクトを構成できます。 新しいインスタンスのホスト名に解決される
CNAME
レコードに加えて、元のホスト名から新しいホスト名にトラフィックを転送する 2 つ目の DNSCNAME
レコードを構成します。 詳細については、DNS プロバイダーのドキュメントを参照してください。 -
宛先インスタンスでメンテナンス モードを無効にします。