TeamCity オンプレミス 2026.1 ヘルプ

HTTP によるサーバーへのアクセス

以下の例はあなたのサーバー WebUI が http://teamcity.jetbrains.com:8111/(英語) URL を通してアクセス可能であると仮定します。

TeamCity サーバーはユーザーが特定の Web サーバーページにアクセスし、様々なスクリプトからアクションを実行することを可能にする基本的な HTTP 認証をサポートします。リクエスト発行時に基本的な HTTP 認証情報を提供する方法についてはクライアントツール / ライブラリのマニュアルを参照してください。

基本的な HTTP 認証を使用するには、有効な TeamCity サーバーのユーザー名とパスワードを使用してください。操作を実行するには、適切なユーザー権限が必要です。

資格情報が指定されていない場合にログインページにリダイレクトする代わりに基本 HTTP 認証を使用するように強制するには、通常の TeamCity URL のパスの前に /httpAuth を追加します。例:

http://teamcity.jetbrains.com:8111/httpAuth/action.html?add2Queue=MyBuildConf

HTTP 認証は、ビルドアーティファクトをダウンロードしてビルドをトリガーするときに役立ちます。

ゲストユーザーが有効になっている場合は、それを使用してアクションを実行することもできます。ゲストユーザーに代わってアクションを実行するには、URL パスの前に /guestAuth を使用します。例:

http://teamcity.jetbrains.com:8111/guestAuth/action.html?add2Queue=MyBuildConf

スクリプトからビルドを開始する

ビルドをトリガーするには、基本 HTTP 認証を実行する URL の HTTP POST リクエストを送信します。

http://<server address>/httpAuth/action.html?add2Queue=<build configuration ID>

一部のツール(Wget(英語) など)は、基本 HTTP 認証用に次の構文をサポートしています。

http://<user name>:<user password>@<server address>/httpAuth/action.html?add2Queue=<build configuration Id>

例:

http://testuser:testpassword@teamcity.jetbrains.com:8111/httpAuth/action.html?add2Queue=MyBuildConf

エージェントの ID とともに追加の agentId パラメーターを渡すことで、特定のエージェントでビルドをトリガーできます。エージェントの詳細ページの URL からエージェント ID を取得できます: エージェント | \<agent 名 \>。例: 詳細ページに次の URL がある場合、エージェントの ID は「2」であると推測できます。

http://teamcity.jetbrains.com:8111/agentDetails.html?id=2

2 つのエージェントで同時にビルドをトリガーするには、次の URL を使用してください。

http://testuser:testpassword@teamcity.jetbrains.com:8111/httpAuth/action.html?add2Queue=MyBuildConf&agentId=1&agentId=2

有効で互換性のあるすべてのエージェントでビルドをトリガーするには、エージェント ID として allEnabledCompatible を使用します。

http://testuser:testpassword@teamcity.jetbrains.com:8111/httpAuth/action.html?add2Queue=MyBuildConf&agentId=allEnabledCompatible

カスタムビルドを開始する

TeamCity を使用すると、カスタマイズしたパラメーターでビルドを開始できます。特定のビルドエージェントを選択してビルドを実行し、追加のプロパティと環境変数を定義し、特定のソースリビジョンを(ビルドに含める最後の変更を指定して)選択することができます。これらのカスタマイズは、単一のトリガービルドにのみ影響し、ビルド構成の他のビルドには影響しません。

特定の変更に対して包括的にビルドをトリガーするには、次の URL を使用してください。

http://testuser:testpassword@teamcity.jetbrains.com:8111/httpAuth/action.html?add2Queue=MyBuildConf&modificationId=11112

modificationId — Web 差分 URL から取得できる内部 ID の変更 / 変更。

カスタムパラメーター(システムプロパティと環境変数)を使ってビルドを開始するには、次のようにします。

http://testuser:testpassword@teamcity.jetbrains.com:8111/httpAuth/action.html?add2Queue=MyBuildConf&name=<full property name1>&value=<value1>&name=<full property name2>&value=<value2>

<full property name> は system./env のフルプロパティ名です。構成パラメーターを定義するための接頭辞または接頭辞なし。以前のバージョンの TeamCity では、このアクションに異なる構文が使用されていました。ただし、その構文は互換性のためにまだサポートされています。

ビルドをキューの先頭に移動するには、クエリ文字列に次を追加します。&moveToTop=true

パーソナルビルドを実行するには、クエリ文字列に &personal=true を追加します。

機能ブランチでビルドを実行するには

http://testuser:testpassword@teamcity.jetbrains.com/httpAuth/action.html?add2Queue=bt10&branchName=master
2025 年 4 月 07 日