maintainDB コマンドラインツールを使用したバックアップの作成
TeamCity .tar.gz および .exe ディストリビューションは、 <TeamCity Home> /bin ディレクトリにある maintainDB.bat|sh ユーティリティを提供します。このコマンドラインツールを使用すると、サーバーデータのバックアップ、復元、および異なるデータベース間の移行を行うことができます。また、UI を使用してデータをバックアップすることもできます。
バックアップする前に
データをバックアップする前に、TeamCity サーバーをシャットダウンして、すべてのビルドをバックアップに含めることをお勧めします。TeamCity サーバーが稼働しているときにバックアッププロセスが開始された場合、実行中のビルドとキューに入れられたビルドはバックアップに含まれません。
バックアップファイルの場所と形式
バックアップファイルのデフォルトディレクトリは <TeamCity Data Directory>\backup です。
バックアップファイル名のデフォルト形式は TeamCity_Backup_<timestamp>.zip です。<timestamp> 接尾辞が YYYYMMDD_HHMMSS 形式で追加されます。
maintainDB Utility を使用した TeamCity データバックアップの実行
このセクションでは、maintainDB オプションのいくつかについて説明します。使用可能なすべてのオプションの完全なリストについては、パラメーターなしでコマンドラインから maintainDB を実行してください。
データバックアップファイルを作成するには、コマンドラインから maintainDB ユーティリティを backup コマンドで起動します。
TeamCity データのバックアップにはいくつかの制限があります。デフォルトでは、オプションのパラメーターなしで maintainDB ユーティリティを実行すると、データベース、サーバー設定、プロジェクトとビルド構成、プラグインと補足データ (設定履歴、トリガーの状態、プラグインのデータなど) のみがバックアップされ、ビルドログと個人の変更は省略されます。
バックアップ範囲の構成
バックアップファイルに含めるデータの範囲を構成するには、次のオプションを使用します。
-Cまたは--include-config— ビルド構成設定が含まれます-Dまたは--include-database— データベースを含む-Lまたは--include-build-logs— ビルドログが含まれます-Pまたは--include-personal-changes— 個人的な変更が含まれます-Uまたは--include-supplementary-data— 補足（プラグイン）データが含まれます
上記のオプションのさまざまな組み合わせを指定すると、バックアップファイルの内容を制御できます。例: サポートされているすべてのタイプのデータでバックアップを作成する
データバックアップ用の maintainDB の使用例
カスタム名でバックアップファイルを作成するには、-F または --backup-file オプションを指定して maintainDB を実行し、拡張子なしで目的のバックアップファイル名を指定します。
上記のコマンドを実行すると、デフォルトのバックアップディレクトリに指定された名前の新しい ZIP ファイルが作成されます。
カスタムファイル名にタイムスタンプ接尾辞を追加するには、-M または --timestamp-suffix オプションを追加します。
カスタムディレクトリにバックアップファイルを作成するには、-F オプションを指定して、maintainDB を実行します。
MaintainDB の起動オプション
TEAMCITY_SERVER_OPTS/TEAMCITY_SERVER_MEM_OPTS 環境変数を使用して TeamCity サーバー起動オプションをカスタマイズする場合、またはサーバーを実行するためにカスタム JDK インストールを使用する場合は、maintainDB スクリプトを TEAMCITY_MAINTAINDB_OPTS/TEAMCITY_MAINTAINDB_MEM_OPTS 環境変数に追加された関連オプションとともに実行し、TeamCity サーバーとすべて同じ環境でスクリプトを実行して、同じ JVM を使用する必要がある場合があります。
