TeamCity 2020.2 ヘルプ

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

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

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

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

To force using a basic HTTP authentication instead of redirecting to the login page if no credentials are supplied, prepend a path in the usual TeamCity URL with /httpAuth . For example:

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

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

If you have Guest user enabled, it can be used to perform the action too. Use /guestAuth before the URL path to perform the action on Guest user behalf. For example:

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

You can trigger a build on a specific agent passing additional agentId parameter with the agent's ID. You can get the agent Id from the URL of the Agent's details page: エージェント | <エージェント名> . For example, you can infer that agent's Id equals "2", if its details page has the following URL:

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 — modification/change internal id which can be obtained from the web diff URL.

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

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