手動バックアップと復元

TeamCity データディレクトリのバックアップ

TeamCity データディレクトリ ストア:

• サーバー設定、プロジェクト、それらの設定を使用したビルド構成（つまり、UI を介して構成されたすべてのもの）。

• 別の場所が構成されていない限り、デフォルトでアーティファクトをビルドします。 ビルドログもビルドアーティファクトの一部として保存されます。

• 現在の操作ファイル、内部データ構造など。

ディレクトリ構造とデータの詳細については、 TeamCity データディレクトリセクションを参照してください。

必要に応じて、容量を節約するためにディレクトリの一部をバックアップから除外できます: 失われるのは除外されたデータのみです。 system/キャッシング ディレクトリはバックアップから安全に除外できます — 必要なデータは TeamCity の始動時にゼロから再構築されます。

<TeamCity データディレクトリ>/system ディレクトリのデータのバックアップをスキップする場合は、各 アーティファクト、 messages、 変更 サブディレクトリの最新のファイルを必ず書き留めて、この情報を保存してください。 データベースよりも新しい状態に対応する TeamCity データディレクトリを使用してデータベースバックアップを復元する場合に必要になります。

<TeamCity データディレクトリ>/system/buildserver.* ファイルには、内部データベース (HSQLDB) データが保存されます。 HSQLDB を使用する場合は、これらのデータをバックアップする必要があります (デフォルト設定は実稼働での使用には適していません)。

データベースデータ

データベースには、ビルド結果に関するすべての情報（ビルド履歴、およびアーティファクトとビルドログを除くすべてのビルド関連データ）、VCS の変更、エージェント、ビルドキュー、ユーザーアカウント、ユーザー権限などが保存されます。

• 内部データベース HSQLDB (デフォルト設定、本番環境では推奨されません) を使用する場合、データベースは <TeamCity データディレクトリ>/system ディレクトリ内に直接存在するファイルに保存されます。 ディレクトリのすべてのファイルはバックアップできます。 HSQLDB バックアップノート(英語)を参照することもできます。

• 外部データベースを使用する場合は、データベース固有のツールを使用して、TeamCity で使用されるデータベーススキーマをバックアップしてください。 TeamCity で使用される外部データベース接続設定については、 <TeamCity データディレクトリ>/config/データベース.properties ファイルを参照してください。 対応するインストールセクションも参照できます。

アプリケーションファイル

元の配布パッケージがまだあり、以下を行っていない場合は、TeamCity アプリケーションディレクトリ (ウェブアプリケーションを含むウェブサーバーのみ) をバックアップする必要はありません：

• TeamCity が使用するカスタムライブラリを配置する

• 非デフォルトの TeamCity プラグインをウェブアプリケーションファイルに直接インストールする

• 起動スクリプト / 構成を変更します。

アプリケーションファイルをバックアップする必要があると感じる場合:

• non-war ディストリビューションを使用する場合: すべて を <TeamCity データディレクトリ> 配下にバックアップします。ただし、 temp ディレクトリと work ディレクトリは除きます。

• war ディストリビューションを使用する場合は、使用するサーブレットコンテナーのバックアップ手順に従ってください。

ログファイル

TeamCity サーバーログファイル (主に問題解決やデバッグ目的で使用) が必要な場合は、 <TeamCity データディレクトリ>/ログ ディレクトリをバックアップします。

TeamCity データディレクトリの復元

以前にバックアップしたファイルを元の場所に戻すだけで済みます。 ただし、バックアップを復元するときに余分なファイルがないことが重要です。 これを実現する最も簡単な方法は、バックアップをクリーンなデータディレクトリに復元することです。 これが不可能な場合は、バックアップ後に作成されたファイルが消去されていることを確認してください。 特に、 <TeamCity データディレクトリ>/system の アーティファクト、 messages、 変更 ディレクトリに新しく作成されたファイルです。

TeamCity データベースの復元

データベースは、データベース固有のツールと方法を使用して復元する必要があります。 また、データベース固有の方法を使用して、復元を高速化することもできます（SQL Server の「復旧モデル」を「単純」に設定するなど）。

復元する前に、TeamCity で使用されるスキーマに余分なテーブルがないことを確認してください。

新しいサーバーへの復元

サーバーのコピーを実行する場合は、サーバーが別々のデータディレクトリとデータベースを使用していることを確認してください。 外部データベースの場合は、 <TeamCity データディレクトリ>/config/データベース.properties ファイルの設定を変更して、別のデータベースを指すようにしてください。

ビルドログの復元

複数のアーティファクトディレクトリからの /アーティファクト の /ログ サブディレクトリにあるビルドログは、単一のディレクトリ system/<プロジェクト ID>/<ビルド構成名>/<internal_build_id>/.teamcity/ログ にバックアップされ、復元されます。