YouTrack サーバー 2024.2 ヘルプ

Hub サーバーの URL を更新する

外部 Hub サービスに接続するには、YouTrack がどこを探すべきかを知る必要があります。外部 Hub サービスの場所は、YouTrack の構成ファイルに保存されます。誤って編集されないように、この設定は管理 UI で公開されていません。この URL を更新するには、Hub 移行サービスを使用するか、YouTrack サーバーのプロパティファイルに保存されている値を更新します。

YouTrack の外部 Hub サーバーの URL を更新する必要がある状況がいくつかあります。

  • 外部 Hub インストールが再構成され、そのベース URL が変更されました。

  • 外部 Hub インストールが破損し、異なるベース URL を持つ別の場所に復元されました。

  • Hub の新しいコピーが別の場所にインストールされているため、YouTrack を新しいインストールに接続したいと考えています。新しいインストールのベース URL は、古いインストールのベース URL とは異なります。

YouTrack の実行が停止していて開始できない場合は、Hub URL を手動で更新する必要があります。

新しい Hub インストールでの YouTrack のサービスとしての登録

新規インストールに切り替える場合、YouTrack はこの Hub インストールのサービスとしてすでに登録されている必要があります。そうしないと、YouTrack は起動しません。この条件は次の場合に満たされます。

  • 新しい Hub インストールのデータベースは、以前 YouTrack で使用されていた Hub インストールに属するバックアップファイルから復元されました。

  • 新しい Hub インストールは、以前の Hub インストールを新しいインストールに移行することにより作成されました。

  • YouTrack サービスは、新しい Hub インストールのレジストリに手動で追加されました。この手順の詳細については、Hub のドキュメント(英語)を参照してください。

YouTrack の Hub サーバーの URL を更新する前に、YouTrack が新しい Hub インストールに正しく登録されていることを確認してください。詳細については、Hub のドキュメント(英語)を参照してください。

Hub URL の手動更新

Hub サービスに接続できなくなったために YouTrack がシャットダウンした場合は、Hub URL を手動で更新できます。この操作は、YouTrack サーバーにコマンドを適用することによって実行されます。

Hub サーバーへの接続を保護する証明書が自己署名されているか、既知の認証局によって発行されていない場合、YouTrack の内部キーストアにも証明書をインポートする必要があります。詳細な手順については、Hub サーバーの証明書を更新するを参照してください。

Hub URL を手動で更新するには:

  1. コマンドラインインターフェースを開き、次のコマンドを入力します。

    docker run -it -v /path/to/conf/on/host:/opt/youtrack/conf -v ... <YT_MAGE_ID> configure --hub-url=<url-with-/hub-at-the-end>
  2. <url-with-/hub-at-the-end> の場合、新規 Hub インストールのベース URL を指定し、/hub を追加します。

  3. YouTrack を開始

    • YouTrack は、新しい URL を使用して Hub サービスに接続します。

Hub URL を手動で更新するには:

  1. 以下のいずれかの方法を使用して、bundle.properties ファイルの値を更新します。

    • YouTrack サーバーでコマンドラインインターフェースを開き、次のコマンドを入力します。

      <youtrack_home>/bin/youtrack.sh configure --hub-url=<url-with-/hub-at-the-end>
    • <youtrack_app_data>/conf/internal/bundle.properties ファイルを開き、次のプロパティの値を手動で変更します。

      hub-url=<url-with-/hub-at-the-end>
  2. <url-with-/hub-at-the-end> の場合、新規 Hub インストールのベース URL を指定し、/hub を追加します。

  3. YouTrack を開始

    • YouTrack は、新しい URL を使用して Hub サービスに接続します。