TeamCity On-Premises 2026.2 Help

HTTP でのサーバーへのアクセス

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

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

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

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

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

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

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

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 とともに追加の エージェント ID パラメーターを渡すことで、特定のエージェントでビルドをトリガーできます。 エージェントの詳細ページの URL からエージェント ID を取得できます: エージェント | \<エージェントのお名前\>。 例: 詳細ページに次の 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 として 有効で互換性があるものすべて を使用します。

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

変更 ID — 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>

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

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

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

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

http://testuser:testpassword@teamcity.jetbrains.com/httpAuth/action.html?add2Queue=bt10&branchName=master
2026 年 9 月 11 日