TeamCity データのバックアップ

TeamCity でのデータバックアップについて

TeamCity は、そのデータをバックアップするいくつかの方法を提供します。

• Web UI からのバックアップ : サーバーの実行中にバックアップを作成するための Web UI のアクション (REST API 経由でもトリガー可能)。定期的なメンテナンスバックアップに推奨されます。バックアップされたデータにはいくつかの制限が適用されます (以下の関連セクションを参照)。このオプションは、メンテナンス画面でのアップグレード時 (TeamCity サーバーの新しいバージョンの最初の起動時) にも使用できます。

• MaintainDB コマンドラインツールを介したバックアップ : UI 経由の場合と同じです。すべてのデータを含めるには、サーバーが停止しているときにツールを使用します。

• 手動バックアップ : バックアップ手順を手動で管理する場合に適しています。

• ビルドエージェントのデータをバックアップするみが必要な場合があります。

データのバックアップ

UI で、または maintainDB にそれぞれのパラメーターを追加することにより、バックアップするデータを選択できます。

TeamCity では、次のデータをバックアップできます。

• データベースに保存されているデータ

• サーバー設定、プロジェクトとビルド構成の設定（ <TeamCity Data Directory> /config に保存されているすべて）、およびセキュリティで保護された値

• カスタムプラグイン（ <TeamCity Data Directory> /plugins にインストール）とデータベースドライバー ( <TeamCity Data Directory> /lib ディレクトリから)

• 補足データ: 設定履歴、トリガーの状態、プラグインデータなど ( <TeamCity Data Directory> /system/pluginData ディレクトリ以下のすべて)

• ビルドログ

• 個人的な変更

次のデータはバックアップに含まれません :

• アーティファクトのビルド (サイズが大きいため)。これには、ビルドアーティファクト、内部 NuGet フィードパッケージ、カバレッジレポート、ビルド完了パラメーター、設定ダイジェストなどが含まれます。アーティファクトをバックアップする必要がある場合は、バックアップから TeamCity データを復元する前に、アーティファクトディレクトリの内容を手動で保存してください。

• UI からのバックアップの場合: 実行中のビルドとビルドキューの状態。これらをバックアップする場合は、TeamCity サーバーを停止し、maintainDB ツールを使用します。

• <TeamCity Home> にある TeamCity アプリケーションマニュアルのカスタマイズ (使用されるサーバーポート番号を含む) は、 <TeamCity Home> /conf/server.xml ファイルに保存されます。

• TeamCity アプリケーションログ ( <TeamCity Home> /logs の下)。

• 前述の項目に該当しない、 <TeamCity Data Directory> に手動で作成されたファイル。

推奨されるアプローチは、手動バックアッププロセスを実行するか、「Basic」レベルで UI から定期的にバックアップを実行します (たとえば、REST API を介して自動化されます)。これにより、ビルドアーティファクトとビルドログを除くすべての重要なデータが確実にバックアップされます。

ビルドアーティファクトとログ (必要な場合) は、 <TeamCity Data Directory> /system/artifacts のファイルをコピーすることで手動でバックアップできます。
ログをバックアップ対象として選択すると、TeamCity はサーバー上で現在指定されているすべてのアーティファクトディレクトリでログを検索します。

大規模な実稼働 TeamCity インストールの場合、データベースとの間でデータをエクスポートおよびインポートすることは最適なソリューションではない可能性があり、レプリケーションを介してデータベースのバックアップを維持することはより良いオプションである可能性があることに注意してください。たとえば、MySQL データベースの対応するドキュメント(英語)を参照してください。