YouTrack サーバー 2024.2 ヘルプ

ベース URL またはリッスンポートを変更する

YouTrack インストールの構成ファイルには、インターネットまたは内部ネットワーク経由でサービスにアクセスできる場所を決定する 2 つのプロパティがあります。

プロパティ

説明

base-url

これは、アプリケーション内のさまざまなリソースやページにアクセスするための開始点を形成する基本的な Web アドレスです。YouTrack の場合、プロトコル (http:// または https://) とドメイン名) が含まれます。

listen-port

これは、受信ネットワーク要求と接続をリッスンするように YouTrack が構成されているホストサーバー上の特定のネットワークポートです。

YouTrack インストールのベース URL またはリッスンポートを変更したい理由はさまざまです。これには、ドメインまたはホスティングの移行、ブランド変更、名前変更、セキュリティとアクセス制御が含まれる場合があります。

リッスンポートの変更は、セキュリティ目的、負荷分散、ポート競合の解決、ネットワーク構成の最適化、特定の運用要件またはコンプライアンス要件を満たすために必要になる場合があります。

多くの場合、リッスンポートを変更するには、ベース URL を更新する必要があります。例: プロキシまたはポート転送が使用されておらず、エンドユーザーが指定されたリッスンポートを介してサービスに直接アクセスする場合。この状況では、listen-port と base-url を一緒に変更する必要があります。

プロキシまたはポート転送が使用されている場合、クライアントは別のポートでプロキシと通信できるため、ベース URL のポートがリッスンポートに対応しない可能性があります。この場合、リッスンポートの変更には、プロキシまたはポート転送設定の更新を伴う必要があります。

プロキシ URL が以前のベース URL と異なる場合は、ベース URL も更新する必要があります。この状況は、プロキシが以前に使用されなかった場合、またはプロキシが別のホストまたはポートでリッスンするように再構成された場合に発生する可能性があります。このような場合、古いベース URL は古くなっている可能性があります。

YouTrack インストールのベース URL の変更

YouTrack のベース URL を更新するには、次の手順を使用します。ベース URL にリッスンポートが含まれている場合は、必ず両方のプロパティを同時に更新してください。

Docker インストールのベース URL を変更するには:

  1. 次のコマンドを使用して、YouTrack サービスを停止します。

    docker exec <containerId> stop

  2. configure コマンドを実行します。

    docker run -it --rm \ -v <path to conf directory>:/opt/youtrack/conf jetbrains/youtrack:<version> \ configure --base-url <new target web address>

    ベース URL と待機ポートを同時に更新する場合は、新しい待機ポートも configure コマンドに追加します。例:

    configure --base-url <new target web address> --listen-port <new listen port>

  3. YouTrack サービスを再起動します。

    docker start <containerId>

ZIP インストールのベース URL を変更するには:

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

    youtrack.sh stop

  2. ディレクトリを <youtrack_home>/bin に変更します。

    ZIP インストールの場合、<youtrack_home> ディレクトリは ZIP ディストリビューションがインストール中に解凍された場所です。

  3. 構成コマンドを実行します。

    youtrack.sh configure --base-url <new target web address>

    ベース URL と待機ポートを同時に更新する場合は、新しい待機ポートも configure コマンドに追加します。例:

    configure --base-url <new target web address> --listen-port <new listen port>

  4. 次のコマンドを使用して、YouTrack サービスを再起動します。

    youtrack.sh restart

YouTrack インストールのリッスンポートの変更

次の手順に従って、YouTrack のリッスンポートを更新します。これを成功させるには、エンドユーザーまたはリバースプロキシサーバー (使用中の場合) がリッスンポートにアクセスできる必要があります。これには、ファイアウォールを介してこのポートへのアクセスを明示的に開くことが必要になる場合があります。

Docker インストールのリッスンポートを変更するには、次の手順を実行する

  1. 次のコマンドを使用して、YouTrack サービスを停止します。

    docker exec <containerId> stop

  2. configure コマンドを実行します。

    docker run -it --rm \ -v <path to conf directory>:/opt/youtrack/conf jetbrains/youtrack:<version> \ configure --listen-port <new listen port>

    ベース URL と待機ポートを同時に更新する場合は、新しい待機ポートも configure コマンドに追加します。例:

    configure --base-url <new target web address> --listen-port <new listen port>

  3. YouTrack サービスを再起動します。

    docker start <containerId>

ZIP インストールのリッスンポートを変更するには、次の手順を実行する

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

    youtrack.sh stop

  2. ディレクトリを <youtrack_home>/bin に変更します。

    ZIP インストールの場合、<youtrack_home> ディレクトリは ZIP ディストリビューションがインストール中に解凍された場所です。

  3. 構成コマンドを実行します。

    youtrack.sh configure --listen-port <new listen port>

    ベース URL と待機ポートを同時に更新する場合は、新しい待機ポートも configure コマンドに追加します。例:

    configure --base-url <new target web address> --listen-port <new listen port>

  4. 次のコマンドを使用して、YouTrack サービスを再起動します。

    youtrack.sh restart
データベースの場所を変更する ネットワークインターフェースバインディングの構成