YouTrack サーバー 2024.2 ヘルプ

Docker コンテナーの停止と再起動

このページでは、YouTrack サーバーサーバーを停止および起動する方法について説明します。

以下の状況では YouTrack を停止する必要があります。

  • データベースの場所を変更します。

  • YouTrack サーバーサーバーのプロパティまたは JVM オプションを変更する必要があります。

  • YouTrack サーバーのインストールをアップグレードしたい。

Docker コンテナーを停止する

YouTrack サービスを正常に停止するには、次のコマンドを実行してください。

docker exec <containerId> stop

正常にシャットダウンするには、標準の docker kill コマンドを使用することもできます。

docker kill --signal=SIGTERM <containerId>

標準コマンド docker stop の使用はお勧めしません。デフォルトでは、このコマンドは SIGTERM シグナルを Docker コンテナー内の Hub プロセスに送信し、10 秒間待機します。Hub がその期間内に完全にシャットダウンしない場合、SIGKILL がカーネルに送信され、Hub プロセスが直ちに終了します。これにより、データが破損する可能性があります。この結果を回避するには、このコマンドを使用するときに適切なタイムアウト値を指定します。例: 次のコマンドは、Hub サービスがシャットダウンするのに十分な時間を残します。

docker stop -t 60 <containerId>

Docker コンテナーで 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:<version>
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>

コマンド属性:

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

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

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

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

    詳細については、docker の公式ドキュメント(英語)を参照してください。

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

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

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

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

関連ページ:

Docker コンテナーでアップグレードする

このページでは、Docker イメージを使用して YouTrack インストールをアップグレードするさまざまな方法について説明します。前提条件:アップグレードする前に、以下の前提条件タスクを実行してください。現在のデータベースのバックアップを作成します。YouTrack サーバーは、データベースの前方互換性を提供しません。データベースは、アップグレード手順中に最新バージョンと互換性のある形式に移行されます。これは、以前のバージョンに戻して、アップグレード中に処理されたデータベースを引き続き使用...

Docker インストールを復元する

始める前に、復元したいデータベースのバックアップコピーがあることを確認してください。この手順では必ず正しいファイルを選択するように、バックアップコピーの場所をメモしてください。アップグレードが失敗した後で以前のインストールバージョンにロールバックする場合は、インストール前に作成したバックアップを使用してください。この前提条件を無視した場合は、以前のインストールのバージョンに対応するバックアップファイルを見つけてください。現在のインストールを復元しようとしている場合は、現在のインストールのバージョ...