TeamCity データのバックアップ
TeamCity のデータバックアップについて
TeamCity では、データをバックアップする方法がいくつか用意されています：
Web UI からのバックアップ: サーバーの実行中にバックアップを作成するための Web UI のアクション (REST API 経由でもトリガー可能)。 定期的なメンテナンスバックアップに推奨されます。 バックアップされたデータにはいくつかの制限が適用されます (以下の 関連セクションを参照)。 このオプションは、メンテナンス画面でのアップグレード時、つまり TeamCity サーバーの新しいバージョンを初めて起動するときにも使用できます。
MaintainDB コマンドラインツールを介したバックアップ: UI 経由の場合と同じです。 すべてのデータを含めるには、サーバーが 停止しているときにツールを使用します。
手動バックアップ: バックアップ手順を手動で管理する場合に適しています。
ビルドエージェントのデータをバックアップするみが必要な場合があります。
データのバックアップ
UI で、または maintainDB にそれぞれのパラメーターを追加することにより、バックアップするデータを選択できます。
TeamCity では、次のデータをバックアップできます：
サーバー設定、プロジェクトとビルド構成の設定（
<TeamCity データディレクトリ>/設定に保存されているすべて）、およびセキュリティで保護された値カスタムプラグイン（
<TeamCity データディレクトリ>/プラグインにインストール）とデータベースドライバー (<TeamCity データディレクトリ>/libディレクトリから)補足データ: 設定履歴、トリガーの状態、プラグインデータなど (
<TeamCity データディレクトリ>/system/pluginDataディレクトリ以下のすべて)ビルドログ
個人的な変更
次のデータはバックアップに 含まれていません:
ビルドアーティファクト (サイズが大きいため)。 これには、ビルドアーティファクト、内部 NuGet フィードパッケージ、カバレッジレポート、ビルド完了パラメーター、設定ダイジェストなどが含まれます。 アーティファクトをバックアップする必要がある場合は、 バックアップから TeamCity データを復元する前に、 アーティファクトディレクトリの内容を手動で保存してください。
UI からのバックアップの場合: 実行中のビルドとビルドキューの状態。 これらをバックアップする場合は、TeamCity サーバーを停止し、maintainDB ツールを使用してください。
<TeamCity ホーム>配下にある TeamCity アプリケーションの手動カスタマイズは、使用中のサーバーポート番号を含み、<TeamCity ホーム>/conf/server.xmlファイルに保存されます。TeamCity アプリケーションログ (
<TeamCity ホーム>/ログ配下)。前述の項目に該当しない、
<TeamCity データディレクトリ>に手動で作成されたファイル。
推奨されるアプローチ は、 手動バックアッププロセスを実行するか、"Basic" レベルで定期的に UI からバックアップを実行することです (たとえば、 REST API 経由で自動化)。これにより、ビルドアーティファクトとビルドログを除くすべての重要なデータが確実にバックアップされます。
ビルドアーティファクトとログ (必要な場合) は、 <TeamCity データディレクトリ>/system/artifacts 配下のファイルをコピーすることで手動でバックアップできます。
バックアップ対象としてログが選択されている場合、TeamCity はサーバーで現在指定されている すべてのアーティファクトディレクトリでログを検索します。
大規模な本番用 TeamCity インストールでは、データベースとの間でデータをエクスポートおよびインポートすることが最適なソリューションではない場合があり、レプリケーションによってデータベースバックアップを維持する方がより良いオプションになることがあります。たとえば、MySQL データベースについては、対応する ドキュメントを参照してください。