手動バックアップと復元

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

TeamCity Data Directory ストア:

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

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

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

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

必要に応じて、ディレクトリの一部をバックアップから除外してスペースを節約できます。除外されたデータのみが失われます。バックアップから system/caches ディレクトリを安全に除外できます。TeamCity の起動時に必要なデータが最初から再構築されます。

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

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

データベースデータ

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

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

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

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

TeamCity アプリケーションディレクトリ（Web サーバーと Web アプリケーションのみ）をバックアップする必要はありません。ただし、元のディストリビューションパッケージがまだあり、次のことはしていません。

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

• デフォルト以外の TeamCity プラグインを Web アプリケーションファイルに直接インストールする

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

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

• non-war ディストリビューションを使用する場合: temp および work ディレクトリを除く、 <TeamCity Data Directory> にあるすべてのものをバックアップします。

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

ログファイル

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

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

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

TeamCity データベースの復元

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

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

新しいサーバーへの復元

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

ビルドログの復元

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