インスタンスのホスト名を変更する

既存の GitHub Enterprise Server インスタンスのホスト名を変更する場合は、設定とデータを新しいインスタンスに復元する必要があります。

この記事の内容

GitHub Enterprise Server

のホスト名の変更について

お使いの GitHub Enterprise Server インスタンス に新しいホスト名を使用する必要がある場合は、既存のインスタンスの設定とデータをバックアップし、新しいインスタンスを構成し、新しいインスタンスにバックアップを復元してから、新しいインスタンスにトラフィックを送信するように DNS 構成を調整する必要があります。

新しいインスタンスへの移行にはダウンタイムが必要です。 必要なダウンタイムの長さは、バックアップする必要があるデータの量と、バックアップ ホストとインスタンス間のネットワーク接続の速度によって異なります。

この記事では、「ソース インスタンス」という用語は古いホスト名のインスタンスを指し、「宛先インスタンス」という用語は新しいホスト名のインスタンスを指します。

Warning

初期セットアップ後に GitHub Enterprise Server のホスト名を変更しないでください。 ホスト名を変更すると、インスタンスの停止やユーザーのセキュリティ キーの無効化など、予期しない動作が生じます。 インスタンスのホスト名を変更して問題が発生した場合は、GitHub Enterprise サポート または GitHub Premium Support に問い合わせてください。

新しいホスト名を使用してインスタンスに移行する

  1. 使用する新しいホスト名を使用して、GitHub Enterprise Server の宛先インスタンスを構成します。 詳しくは、次のドキュメントを参照してください。

  2. スケジュールされているダウンタイムをインスタンスのユーザーに通知します。 必要に応じて、サインインするすべてのユーザー向けに表示される必須メッセージを作成できます。 詳細については、「エンタープライズのユーザー メッセージをカスタマイズする」を参照してください。

  3. ソース インスタンスで、メインテナント モードを有効にします。 詳しくは、「メンテナンスモードの有効化とスケジューリング」を参照してください。

  4. GitHub Enterprise Server Backup Utilities を使用して、ソース インスタンスのデータと設定をバックアップします。 詳しくは、「インスタンスでのバックアップの構成」を参照してください。

  5. 任意のホスト名を使用して、バックアップを宛インスタンスに復元します。 ghe-restore ユーティリティを実行するときは、-c オプションを使用して宛先インスタンスの構成を上書きします。 詳しくは、「インスタンスでのバックアップの構成」を参照してください。

  6. 宛先インスタンスの構成を完了します。 詳しくは、「GitHub Enterprise を設定する」を参照してください。

  7. 宛先インスタンスでメンテナンス モードを有効にします。

  8. 必要に応じて、宛先インスタンスがメインテナント モードになっている間に、インスタンスの構成を検証し、ユーザー データがそのままであることを確認します。 詳しくは、「メンテナンスモードの有効化とスケジューリング」を参照してください。

  9. 宛先インスタンスにトラフィックを転送するには、宛先インスタンスの IP アドレスに解決されるように、ソース インスタンスのホスト名で DNS CNAME レコードを更新します。

    Note

    インスタンスの Web アプリケーションで復元されたユーザー生成コンテンツには、ソース インスタンスの古いホスト名を参照する URL が含まれている可能性があります。 必要に応じて、これらのリンクが引き続き宛先インスタンスに解決されるように、DNS を使用してリダイレクトを構成できます。 新しいインスタンスのホスト名に解決される CNAME レコードに加えて、元のホスト名から新しいホスト名にトラフィックを転送する 2 つ目の DNS CNAME レコードを構成します。 詳細については、DNS プロバイダーのドキュメントを参照してください。

  10. 宛先インスタンスでメンテナンス モードを無効にします。