If you modify the state of plugins on the TeamCity server, all active agents will need to restart to synchronize with the server. Note that after starting, the full agent behaves like a regular agent. All instances will be synchronized with the server from the start and can instantly run a build. The full agent is the most convenient if you use scripts for creating agent images (for example, in cloud). This makes its distribution archive larger but significantly reduces the time spent on the first agent run. The full agent contains all enabled plugins and automatically stays relevant with the current TeamCity server state. * A minimal TeamCity agent distribution does not contain plugins: the agent downloads them on the first start. On Windows, you may want to install the build agent Windows service instead of using the manual agent startup. On Linux, you may need to give execution permissions to the bin/agent.sh shell script. Refer to this article for details on the agent configuration. Open the \conf directory and rename the file to buildAgent.properties.Įdit the buildAgent.properties file to specify the TeamCity server URL (HTTPS is recommended, see these notes) and the name of the agent. Minimal ZIP file distribution: a regular build agent with no plugins.įull ZIP file distribution*: a full build agent prepacked with all plugins currently enabled on the server.Įxtract the downloaded file into an arbitrary directory.
Make sure that the JRE_HOME or JAVA_HOME environment variables are set on the agent machine and respectively point to the installed JRE or JDK directories.Ĭlick Install Build Agents and select one of the two options to download the archive: On the agent machine, run agentInstaller.exe and follow the installation instructions.Įnsure that the user account used for running the agent service has proper permissions. Preparing a container based on the official TeamCity Agent imageĬlick Install Build Agents and select Windows Installer to download the installer. Installing manually from a ZIP file on any platform Before installing a TeamCity build agent, make sure to read the system requirements.
0 kommentar(er)
