TeamCity Web UI からバックアップを作成する

TeamCity では、Web UI を介して TeamCity データのバックアップを作成できます。バックアップファイルを作成するには、管理 | バックアップページに移動し、以下の説明に従ってバックアップパラメーターを指定し、バックアッププロセスを開始します。

バックアップ設定

オプション	説明
バックアップファイル	バックアップファイルの名前を指定します。拡張子 (`.zip`) が自動的に追加されます。デフォルトでは、TeamCity はバックアップファイルを `<TeamCity Data Directory>` `/backup` ディレクトリに保存します。セキュリティ上の理由から、UI でこのパスを明示的に変更することはできません。この設定を変更するには、 `<TeamCity Data Directory>` `/config/backup-config.xml` ファイルで絶対パスまたは相対パス (パスは TeamCity データディレクトリを基準にする必要があります) を指定します。例: <backup-settings> ... <general> <backup-dir path="C:/TC-Backups"/> </general> ... </backup-settings>
タイムスタンプ接尾辞を追加	指定したファイル名にタイムスタンプ接尾辞を自動的に追加するには、このオプションをオンにします。古いバックアップをクリーンアップしない場合、これはバックアップファイルを区別できます。バックアップファイルが保存されているディレクトリに、上記で指定した名前のファイルがすでに含まれている場合、TeamCity はバックアップを実行しません。別の名前を指定するか、タイムスタンプ接尾辞オプションを有効にしてこれを回避する必要があります。タイムスタンプ接尾辞には特定の形式があります。バックアップファイルをアルファベット順に並べ替えると、時間順に並べられます。
バックアップ範囲	バックアップしたいデータの種類を指定します。範囲に応じたバックアップファイルの内容は、範囲を選択したときに UI に表示されます。バックアップファイルのサイズとバックアップ処理にかかる時間は、選択した範囲によって異なります。結果として生じるファイルサイズとバックアップに費やされる時間を減らすために、サーバー設定、プロジェクトとビルド構成、プラグインとデータベースを含む「基本」スコープを選択してください。ただし、バックアップされた設定のみを復元できます。ほとんどのニーズに適した完全バックアップを行うには、「ビルドログ」を除くすべての項目を選択したカスタムスコープを使用し、 `<TeamCity Data Directory>` `/system/artifacts` の場所を通常のファイルシステムとしてバックアップすることをお勧めします。ビルドアーティファクトはサイズが大きいため、バックアップに含まれていません。アーティファクトディレクトリを個別にバックアップするか、アーティファクトに冗長ストレージを使用することをお勧めします。ビルドログはビルドアーティファクトの一部として保存されるため、アーティファクトの場所の個別のバックアップを実装する場合は、ビルドログをバックアップする必要はありません。

オプション

説明

バックアップファイル

バックアップファイルの名前を指定します。拡張子 (.zip) が自動的に追加されます。デフォルトでは、TeamCity はバックアップファイルを <TeamCity Data Directory> /backup ディレクトリに保存します。セキュリティ上の理由から、UI でこのパスを明示的に変更することはできません。この設定を変更するには、 <TeamCity Data Directory> /config/backup-config.xml ファイルで絶対パスまたは相対パス (パスは TeamCity データディレクトリを基準にする必要があります) を指定します。例:

<backup-settings>
  ...
  <general>
    <backup-dir path="C:/TC-Backups"/>
  </general>
  ...
</backup-settings>

タイムスタンプ接尾辞を追加

指定したファイル名にタイムスタンプ接尾辞を自動的に追加するには、このオプションをオンにします。古いバックアップをクリーンアップしない場合、これはバックアップファイルを区別できます。

バックアップ範囲

バックアップしたいデータの種類を指定します。範囲に応じたバックアップファイルの内容は、範囲を選択したときに UI に表示されます。バックアップファイルのサイズとバックアップ処理にかかる時間は、選択した範囲によって異なります。

結果として生じるファイルサイズとバックアップに費やされる時間を減らすために、サーバー設定、プロジェクトとビルド構成、プラグインとデータベースを含む「基本」スコープを選択してください。ただし、バックアップされた設定のみを復元できます。

ほとんどのニーズに適した完全バックアップを行うには、「ビルドログ」を除くすべての項目を選択したカスタムスコープを使用し、 <TeamCity Data Directory> /system/artifacts の場所を通常のファイルシステムとしてバックアップすることをお勧めします。

ビルドアーティファクトはサイズが大きいため、バックアップに含まれていません。アーティファクトディレクトリを個別にバックアップするか、アーティファクトに冗長ストレージを使用することをお勧めします。ビルドログはビルドアーティファクトの一部として保存されるため、アーティファクトの場所の個別のバックアップを実装する場合は、ビルドログをバックアップする必要はありません。

バックアップを開始すると、TeamCity はそのステータスと、進行状況や推定を含む現在のプロセスの詳細を表示します。

重要な注意点

実行中のビルドとキューに入れられたビルドは、サーバーの実行中に作成されたバックアップには含まれません。これらのビルドを含めるには、サーバーが実行されていないときに別のバックアップ方法を使用することを検討してください。
バックアッププロセスには、システムにビルドがいくつあるかによって時間がかかります。このプロセス中に、システムの状態が変化する可能性があります。たとえば、一部のビルドが終了したり、ビルドキューで待機していた他のビルドが開始したり、新しいビルドがビルドキューに表示されたりする場合があります。これらの変更はバックアップに影響を与えないことに注意してください。TeamCity は、バックアッププロセスが開始された時点までの実際のデータのみをバックアップします。
結果のバックアップファイルは *.zip アーカイブであり、使用する OS やデータベースの種類に依存しない特定の構造を持っています。バックアップファイルを使用して、別のオペレーティングシステム上や別のデータベース上でもデータを復元できます。このファイルの内容を手動で変更した場合、TeamCity はあなたのデータを復元することはできません。

履歴をバックアップする

管理 | バックアップページのヒストリータブでは、作成されたバックアップファイルのリスト、そのサイズとファイルが作成された日付を確認できます。

ここで表示されるのは、Web UI から作成されたバックアップファイルのみであることに注意してください。ユーティリティを使用して作成されたバックアップは、ヒストリータブには表示されません。

2025 年 4 月 07 日

関連ページ：

TeamCity データディレクトリ

TeamCity データディレクトリは、TeamCity サーバーが構成、ビルド結果、現在の操作ファイルを保存するために使用するファイルシステム上のディレクトリです。このディレクトリは、すべての構成設定の 1 次ストレージであり、TeamCity のインストールに不可欠なデータを保持します。ビルド履歴、ユーザーとそのデータ、その他のデータはデータベースに保存されます。ディレクトリとデータベースに保存されるデータの説明については、バックアップに関する注意事項を参照してください。このドキュメントや他...

TeamCity の設定とメンテナンス

サーバー構成を変更するには、管理 | グローバル設定に移動します。次の設定ブロックを使用できます。TeamCity の設定：データベース実行中の TeamCity サーバーによって使用されるデータベース。データディレクトリディレクトリを参照できる \<TeamCity データディレクトリ \> パス。アーティファクトディレクトリ TeamCity サーバーがビルドアーティファクト、ビルドログ、その他のビルドデータを保存するために使用するルートディレクトリのリスト。デフォルトの場所はです...

maintainDB コマンドラインツールを使用したバックアップの作成

TeamCity.tar.gz および .exe ディストリビューションは、ディレクトリにあるユーティリティを提供します。このコマンドラインツールを使用すると、サーバーデータのバックアップ、復元、および異なるデータベース間の移行を行うことができます。また、UI を使用してデータをバックアップすることもできます。バックアップする前に：データをバックアップする前に、TeamCity サーバーをシャットダウンして、すべてのビルドをバックアップに含めることをお勧めします。TeamCity サーバーが稼働...