TeamCity オンプレミス 2026.1 ヘルプ

TeamCity メンテナンスモード

TeamCity の起動時に TeamCity メンテナンスページが表示される場合、この TeamCity インスタンスを起動するには技術的なメンテナンスが必要であることを意味します。ほとんどの場合、このページは、TeamCity インストールで想定されるデータ形式がデータディレクトリまたはデータベースのデータ形式に対応していない場合に表示されます。例: アップグレード中、TeamCity はデータを新しい形式に変換する前にこのページを表示します。

セキュリティ上の理由から、メンテナンスは、TeamCity サーバーがインストールされている環境への管理アクセス権を持つシステム管理者が実行する必要があります。TeamCity がインストールされているコンピューターにアクセスできない場合は、システム管理者に TeamCity に技術的なメンテナンスが必要であることを通知してください。

TeamCity システム管理者の場合は、このページの対応するフィールドに認証トークンを入力して確認してください。このトークンは、 <TeamCity Home Directory>/logs teamcity-server.log ファイルにあります。

このトークンを提供した後、必要なメンテナンスの種類の詳細を確認できます。次のいずれかの要因が原因である可能性があります。

TeamCity データアップグレード

インストールされたバージョンの TeamCity は、TeamCity インスタンスを更新するときに、TeamCity データディレクトリとデータベースが新しい TeamCity バージョンで必要とされるのと同じデータ形式を使用しているかどうかを確認します。新しいバージョンでデータ変換が必要な場合は、このページにデータ形式の詳細が表示されます。注意深く確認して、データディレクトリとデータベースの場所が実際にサーバーで使用されることを意図したものであることを確認してください。

以前にデータをバックアップしたことがない場合は、この時点で、提供されているオプションを使用してバックアップしてください。特に大規模な TeamCity のインストールでは、バックアッププロセスに時間がかかる場合があることに注意してください。バックアップする他の方法については、この記事で詳しく説明しています。

TeamCity がデータを変換すると、ダウングレードはできなくなります。以前の TeamCity バージョンに戻す必要がある場合は、対応するバックアップからデータを復元することによってのみそれを行うことができます。

データがバックアップされたら、アップグレードをクリックします。

新しい TeamCity データ形式

TeamCity は、データ形式が、実行しようとしているよりも新しい TeamCity バージョンに対応していることを検出しました。ダウングレードはサポートされていないため、実行する TeamCity バージョンの形式に一致するデータを提供するまで、TeamCity を開始することはできません。これを行うには、バックアップから必要なデータを復元します。手順については、この記事を参照してください。

TeamCity 起動エラー

TeamCity の起動時に重大なエラーが発生した場合、このページにエラーメッセージが表示されます。続行するには、エラーの原因を修正して、TeamCity サーバーを再起動する必要があります。

TeamCity データベース作成

外部データベースを使用して TeamCity を設定するとき、または外部データベースに移行した後にこの画面が表示された場合は、続行をクリックして TeamCity 用の新しいデータベースを作成します。

2025 年 4 月 07 日

関連ページ:

TeamCity データディレクトリ

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

TeamCity サーバーとエージェントのアップグレード

TeamCity は、以前のバージョンからそれ以降のバージョンへのアップグレードをサポートしています。アップグレードノートに記載がない限り、すべての設定とデータは保持されます。少なくともいくつかのバグ修正アップデートがリリースされた後、最新の TeamCity バージョンを実行するための定期的なアップグレードを計画することをお勧めします。このようにして、最新の修正とセキュリティパッチを適用した完全にサポートされたバージョンを実行します。セキュリティパッチ:TeamCity は、サーバー、ビルド...

TeamCity エージェントをインストールして開始する

TeamCity ビルドエージェントは、TeamCity サーバーからのコマンドをリッスンし、実際のビルドプロセスを開始するソフトウェアです。実稼働の TeamCity セットアップでは、専用のマシンに追加のビルドエージェントをインストールする必要があります。その前に、エージェントとサーバー間の通信、システム要件、競合するソフトウェア、およびセキュリティに関する注意事項を必ず参照してください。Tomcat サーブレットコンテナーにバンドルされた TeamCity をインストールするか、Window...