TeamCity 2020.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認証は、ビルド成果物をダウンロードしてビルドをトリガーするときに役立ちます。

ゲストユーザーが有効になっている場合は、それを使用してアクションを実行することもできます。Guestユーザーに代わってアクションを実行するには、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 パラメーターを渡すことで、特定のエージェントでビルドをトリガーできます。エージェントIDは、エージェントの詳細ページのURL(エージェント | <エージェント名>)から取得できます。例:詳細ページに次の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