TeamCity オンプレミス 2026.1 ヘルプ

スーパーユーザーアクセス

スーパーユーザーログインモードでは、システム管理者がサーバー UI に完全にアクセスできるため、資格情報を紛失した場合や認証設定を調整した場合などに最適です。起動時にサーバーメンテナンスページにアクセスするにはスーパーユーザートークンも必要です。このページでは、特定のアクション (サーバー更新後のデータベースアップグレードなど) の前に手動での確認を求められます。

スーパーユーザーはすべてのシステム管理者権限を利用できますが、通知などの個人設定はありません。複数のスーパーユーザーが、互いのセッションに干渉することなく同時にログインできます。

スーパーユーザートークン

スーパーユーザーとしてログインするには、ユーザー名を指定せずに、認証トークンをパスワードとして入力します。サーバーが起動するたびに新しいトークンが生成され、サーバーコンソールと teamcity-server.log ファイルの両方に記録されます (「スーパーユーザー認証トークン」を検索してください)。

[2024-10-24 13:10:10,459] INFO - jetbrains.buildServer.STARTUP - Upgrade from version 1011 to version 1012 is required [2024-10-24 13:10:10,459] INFO - jetbrains.buildServer.STARTUP - Backup of this version is possible [2024-10-24 13:10:10,465] INFO - jetbrains.buildServer.STARTUP - Current stage: Data upgrade is required (administrator login is required to proceed) [2024-10-24 13:10:10,466] INFO - jetbrains.buildServer.STARTUP - Administrator can login from web UI using super user authentication token (better use a private browser window) [2024-10-24 13:10:10,466] INFO - jetbrains.buildServer.SERVER - Super user authentication token: 12345678910 (use empty username with the token as the password to access the server)

空のユーザー名でログインする代わりに、<TeamCity_server_URL>/login.html?super=1 にアクセスしてトークンを入力することもできます。このページにアクセスすると、便宜上、トークンがサーバーログに再度出力されます。

スーパーユーザーを無効にする

スーパーユーザーログインはデフォルトで有効になっていますが、teamcity.superUser.disable=true 内部プロパティを設定することで無効にできます。緊急の場合は、< TeamCity Data Directory> /config/internal.properties ファイルでこの設定を削除し、TeamCity を再起動してスーパーユーザーアクセスを復元します。

2025 年 4 月 07 日

関連ページ:

ロールと権限の管理

TeamCity のユーザーアクセスレベルは、ユーザーに異なるロールを割り当てて、それぞれの権限を付与することによって処理されます。権限とは、ビルドを実行したり、ビルド構成設定を変更したりするなど、特定の操作を実行するための承認です。ロールとは、1 つまたはすべてのプロジェクトでユーザーに付与できる権限のセットであり、プロジェクトや UI のさまざまな機能へのアクセスを制御します。認証モード:TeamCity 認証は、シンプルモードと per-project モードの 2 つのモードをサポートしま...

TeamCity サーバーログ

TeamCity サーバーは、サーバーの動作に関する問題を調査したり、内部エラーの詳細を取得したりするために調べることができる内部アクティビティのログを保持しています。ログは、TeamCity サーバーマシン (通常は) のディスクディレクトリにプレーンテキストファイルとして保存されます。TeamCity の実行中は、ファイルにメッセージが追加されます。サーバーの実行中、ログは管理 | 診断セクションのタブの Web UI で表示できます。一般的なロギングの説明:TeamCity はログ記録に...

TeamCity データディレクトリ

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