General Info
Vendor | JetBrains |
License | |
Type | free, open-source |
Plugin Description
Allows to delegate agent authorization to the agent machine administrators.
Status
Basic implementation completed. Can be unstable in non-basic use.
Usage
1. Set internal property agent.authorize.tokens to a set of comma-separated values in the format "name:secureToken:limit:agentPoolId"
For example:
agent.authorize.tokens=demoToken1:70d44d1e5007dd6b:1:0,demoToken2:70d44d1e5007dd7b:1:3,demoToken3:70d44d1e5007dd8b:1:3
Default agents pool has id "0", other agentPoolId values you can look up in the list by REST URL http://SERVER_URL/app/rest/agentPools
The only currently supported "limit" is "1".
2. On unauthorized agent, add "teamcity.magic.authorizationToken" configuration parameter into buildAgent.propertes file with the value of the token
For example:
teamcity.magic.authorizationToken=70d44d1e5007dd6b
3. Once connected, the agent is authorized noting the token name in the authorization comment and is moved to the agent pool specified by the id in the step 1.
Further agents connected with the same token will not be authorized.
Each token can be used to authorize a single agent only.
Known Issues
If an authorized agent is unauthorized or deleted form the server, another agent can connect with the authorization token.
The only currently supported "limit" is "1".
Download
Last build on public TeamCity server.
TeamCity Versions Compatibility
Compatible with TeamCity 8.0 and later.
Installation
Copy the plugin zip into the <TeamCity Data Directory>/plugins directory (more on this).
Feedback
Everybody is encouraged to try the plugin and provide feedback in the forum or post bugs into the issue tracker.
Please make sure to note the plugin version that you use.
Development links
Sources
<builds are not yet available>
Related Materials
Original issue: TW-33377