アップグレード

既存の Docker インストールをアップグレードするには

1. 既存の YouTrack インストールが実行されている間の YouTrack データベースのバックアップを作成します。

2. Docker コンテナーを停止するには、次のコマンドを使用します。

   docker exec <CONTAINER_ID> stop

   YouTrack コンテナーの ID がわからない場合は、次のコマンドを使用して、サーバーの Docker コンテナーのリストを取得します。

   docker ps -a

3. 以前のバージョンのコンテナーを削除するには、次のコマンドを使用します。

   docker rm <CONTAINER_ID>

   以前のバージョンを削除せずに更新されたコンテナーを実行しようとすると、重複したコンテナー名との競合によりコマンドは失敗します。

4. 次のパラメーターを youtrack.jvmoptions ファイルに追加します。

   -Ddisable.configuration.wizard.on.upgrade=true

   具体的な手順については、「JVM オプションを手動で更新する」を参照してください。

5. ターゲットの YouTrack バージョン用のイメージをプルして実行するには、次のコマンドを実行します。コマンドのその他の属性（ボリュームとポートのマッピング）は、以前のバージョンの YouTrack イメージで使用した属性と同じである必要があります。

   docker run -it --name <youtrack-server-instance> \ -v <path to data directory>:/opt/youtrack/data \ -v <path to conf directory>:/opt/youtrack/conf \ -v <path to logs directory>:/opt/youtrack/logs \ -v <path to backups directory>:/opt/youtrack/backups \ -p <port on host>:8080 \ jetbrains/youtrack:<new version>

   必要に応じて、次の情報を使用してこのコマンドをカスタマイズします。

   • -it は、コンテナーの入力と出力の両方をターミナルに接続するコマンドラインフラグです。これにより、コンテナーがターミナルで直接実行しているかのように、コンテナーによって生成された出力を確認できます。

     コンテナーが起動すると、初期化プロセス中に生成されたログメッセージも表示されます。

     ターミナルがコンテナーの出力に接続されているときに Ctrl + C を押すと、コンテナーの実行中のプロセスに割り込みシグナルが送信されます。これは、ターミナルで通常のプロセスを停止する方法と似ています。このコマンドによりコンテナーがシャットダウンされるため、このコンテキストで Ctrl + C を使用する場合は注意してください。

     コンテナー内で実行中のプロセスを中断せずにターミナルをコンテナー出力から切り離したい場合は、Ctrl + P を押してから Ctrl + Q を押します。

     詳細は docker documentation 公式(英語)を参照してください。

   • --name youtrack-server-instance はコンテナーの任意の名前です。

     デフォルトでは、Docker はコンテナーに対してランダムな、場合によっては不可解な名前を生成します。--name オプションを使用すると、コンテナーに、識別と管理が容易になる、より意味があり人間が判読できる名前を付けることができます。

   • -v <path to <name> directory>:C:/opt/youtrack/<name> は、ホストマシン上にプロビジョニングされたストレージの場所を指定し、コンテナー内の対応する C:/opt/youtrack/<name> ディレクトリにマップします。

   • -p <port on host>:8080 は、ポートマッピングを定義するパラメーターです。これにより、ホストマシンは <port on host> ポートでトラフィックをリッスンし、すべてのトラフィックをコンテナー内のポート 8080 に伝播するように指示されます。

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

   • jetbrains/youtrack:<new version> は、Docker Hub リポジトリ(英語)でホストされている特定の YouTrack バージョンおよびビルドへの参照です。

   docker run -it --name <youtrack-server-instance> ` -v <path to data directory>:C:/opt/youtrack/data ` -v <path to conf directory>:C:/opt/youtrack/conf ` -v <path to logs directory>:C:/opt/youtrack/logs ` -v <path to backups directory>:C:/opt/youtrack/backups ` -p <port on host>:8080 ` jetbrains/youtrack-windows:<new version>

   必要に応じて、次の情報を使用してこのコマンドをカスタマイズします。

   • -it は、コンテナーの入力と出力の両方をターミナルに接続するコマンドラインフラグです。これにより、コンテナーがターミナルで直接実行しているかのように、コンテナーによって生成された出力を確認できます。

     コンテナーが起動すると、初期化プロセス中に生成されたログメッセージも表示されます。

     ターミナルがコンテナーの出力に接続されているときに Ctrl + C を押すと、コンテナーの実行中のプロセスに割り込みシグナルが送信されます。これは、ターミナルで通常のプロセスを停止する方法と似ています。このコマンドによりコンテナーがシャットダウンされるため、このコンテキストで Ctrl + C を使用する場合は注意してください。

     コンテナー内で実行中のプロセスを中断せずにターミナルをコンテナー出力から切り離したい場合は、Ctrl + P を押してから Ctrl + Q を押します。

     詳細は docker documentation 公式(英語)を参照してください。

   • --name youtrack-server-instance はコンテナーの任意の名前です。

     デフォルトでは、Docker はコンテナーに対してランダムな、場合によっては不可解な名前を生成します。--name オプションを使用すると、コンテナーに、識別と管理が容易になる、より意味があり人間が判読できる名前を付けることができます。

   • -v <path to <name> directory>:/opt/youtrack/<name> は、ホストマシン上にプロビジョニングされたストレージの場所を指定し、コンテナー内の対応する /opt/youtrack/<name> ディレクトリにマップします。

   • -p <port on host>:8080 は、ポートマッピングを定義するパラメーターです。これにより、ホストマシンは <port on host> ポートでトラフィックをリッスンし、すべてのトラフィックをコンテナー内のポート 8080 に伝播するように指示されます。

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

   • jetbrains/youtrack-windows:<new version> は、Docker Hub リポジトリ(英語)でホストされている特定の YouTrack バージョンおよびビルドへの参照です。

1. 既存の YouTrack インストールが実行されている間の YouTrack データベースのバックアップを作成します。

2. 既存の YouTrack サービスを停止します。

3. Docker Hub リポジトリ(英語)からターゲットの YouTrack バージョンのイメージを取得します。

   docker pull jetbrains/youtrack:<version>

   <version> を完全なバージョン番号に置き換えてビルドします。リリースバージョンの完全なリストについては、Docker Hub(英語) を確認してください。

   docker pull jetbrains/youtrack-windows:<version>

   <version> を完全なバージョン番号に置き換えて、Windows コンテナーを実行するように構成された Windows Server ホスト向けにビルドしてください。リリースバージョンの完全なリストについては、Docker Hub(英語) を参照してください。

4. ホストマシン上に YouTrack 固有のディレクトリを作成して設定する

5. YouTrack データベースのバックアップファイルを、前の手順で作成した backups ディレクトリにコピーします。

6. 次のコマンドを実行してコンテナー内で YouTrack を起動し、そのデータボリュームとリッスンポートをマッピングします。

   docker run -it --name <youtrack-server-instance> \ -v <path to data directory>:/opt/youtrack/data \ -v <path to conf directory>:/opt/youtrack/conf \ -v <path to logs directory>:/opt/youtrack/logs \ -v <path to backups directory>:/opt/youtrack/backups \ -p <port on host>:8080 \ jetbrains/youtrack:<version>

   docker run -it --name <youtrack-server-instance> ` -v <path to data directory>:C:/opt/youtrack/data ` -v <path to conf directory>:C:/opt/youtrack/conf ` -v <path to logs directory>:C:/opt/youtrack/logs ` -v <path to backups directory>:C:/opt/youtrack/backups ` -p <port on host>:8080 ` jetbrains/youtrack-windows:<version>

   必要に応じて、次の情報を使用してこのコマンドをカスタマイズします。

   • -it は、コンテナーの入力と出力の両方をターミナルに接続するコマンドラインフラグです。これにより、コンテナーがターミナルで直接実行しているかのように、コンテナーによって生成された出力を確認できます。

     コンテナーが起動すると、初期化プロセス中に生成されたログメッセージも表示されます。

     ターミナルがコンテナーの出力に接続されているときに Ctrl + C を押すと、コンテナーの実行中のプロセスに割り込みシグナルが送信されます。これは、ターミナルで通常のプロセスを停止する方法と似ています。このコマンドによりコンテナーがシャットダウンされるため、このコンテキストで Ctrl + C を使用する場合は注意してください。

     コンテナー内で実行中のプロセスを中断せずにターミナルをコンテナー出力から切り離したい場合は、Ctrl + P を押してから Ctrl + Q を押します。

     詳細は docker documentation 公式(英語)を参照してください。

   • --name youtrack-server-instance はコンテナーの任意の名前です。

     デフォルトでは、Docker はコンテナーに対してランダムな、場合によっては不可解な名前を生成します。--name オプションを使用すると、コンテナーに、識別と管理が容易になる、より意味があり人間が判読できる名前を付けることができます。

   • -v <path to <name> directory>:C:/opt/youtrack/<name> は、ホストマシン上にプロビジョニングされたストレージの場所を指定し、コンテナー内の対応する C:/opt/youtrack/<name> ディレクトリにマップします。

   • -p <port on host>:8080 は、ポートマッピングを定義するパラメーターです。これにより、ホストマシンは <port on host> ポートでトラフィックをリッスンし、すべてのトラフィックをコンテナー内のポート 8080 に伝播するように指示されます。

   YouTrack サービスは Docker コンテナー内の {0.0.0.0:8080} で開始され、ポート 8080 は指定された <port on host> にマップされます。これにより、ホストマシンの <ポート on host> にネットワークアクセスできる任意のマシンからサービスにアクセスできるようになります。たとえば、ホストマシンの完全修飾ドメイン名 (FQDN) が host.mydomain.com で、<ポート on host> が 7777 の場合、サービスは http://host.mydomain.com:7777 で利用可能になります。

   YouTrack サービスは、Web ベースの構成ウィザードから開始します。ウィザードには、サービスがホストされている Web アドレスからアクセスできます。

   構成ウィザードはワンタイムアクセストークンで保護されており、Docker からのログ出力からコピーする必要があります。例:

   JetBrains YouTrack 2025.1 Configuration Wizard will listen inside container on {0.0.0.0:8080}/ after start and can be accessed by URL [http://<put-your-docker-HOST-name-here>:<put-host-port-mapped-to-container-port-8080-here>//?wizard_token=FOT8QIzHuktzvxtiT1Ax]

   前のセクションの例を使用すると、構成ウィザードは http://host.mydomain.com:7777//?wizard_token=FOT8QIzHuktzvxtiT1Ax から利用できます。

7. Web ブラウザーで構成ウィザードの URL を開きます。

8. 構成ウィザードで、アップグレードをクリックします。

   

9. アップグレード元を選択ページで、選択ボタンをクリックし、アップグレードソースとしてバックアップファイルを選択します。

   

   次へをクリックします。

10. 設定を確認ページで、システム設定とシステムディレクトリの場所を確認します。

    

11. ライセンスを確認します。必要に応じて、このページでライセンスを更新することもできます。

12. 完了したら、アップグレードをクリックします。

    • YouTrack サーバーはそのコンポーネントを起動します。

      セットアップが完了するまで、ブラウザーのページを閉じないでください。YouTrack サーバーサーバーの準備が整うと、ログインページにリダイレクトされます。

13. YouTrack サーバー管理者アカウントの資格情報を入力し、ログインボタンをクリックします。

    • YouTrack がダッシュボードページを開きます。

    YouTrack サーバーのインストールがアップグレードされ、使用できるようになります。