Remote Agents
Installation
Installation
4 min
install the agent in swimlane ui settings > tenant specific > agents click view agents to see your agents and pools click deploy agent to open the install window note do not click outside this window or it will close and you must start again fill in required fields (see below for field details) click copy install script paste the script into your terminal and run it answer any prompts or questions to finish installation sample install script the script prompts for your turbine username and password credentials are not saved configuration options agent install script fields only required field information agent name the name of the agent, will prompt if not provided (this value is prefixed with agent ) agent name can only contain letters, numbers, underscores, or hyphens do not use spaces customizable fields information ca cert path path to a folder of ca certs to be mounted for certificate validation (helpful for self signed or internal certs) docker bin path to the docker executable, this script tries to find docker but you can help it if it cannot agent image name the docker image to use by default it uses the publicly hosted docker image with the same version as your deployment example swimlane/turbine agent 11 0 agent heartbeat interval how often the agent sends a heartbeat message when the threshold for the heartbeat is exceeded, it is marked unhealthy agent initial pools the initial pools to join you can add more than one agent job max the maximum number of jobs the agent can handle at once agent job queue expires seconds to wait until a job on the queue expires example 5 hours = 18000 seconds http proxy add http proxy support for remote agents example http //username\ password\@host\ port https proxy add https proxy support for remote agents example https //username\ password\@host\ port no proxy comma delimited list of urls which may bypass the above proxy settings example swimlane com,google com cron user the user that will execute the cron job that performs updates to the agent images the user needs to be able to execute docker commands and curl requests for assistance creating a cron user, please contact your linux first line of support join default pool joins the remote agent to the $default pool, in addition to the $remote pool ignore insecure certificates instructs the agent and its connectors to ignore insecure certificates while connecting to https sources allow insecure certificates for gateway communication allows an insecure certificate when connecting to the host turbine instance’s gateway note additional options may be available, but only via command line usage information is available by running the script directly preflight checks during installation, the script will attempt several checks please watch for warnings or errors the warnings or errors may not prevent installation, but could effect stability or performance of your remote agent checks performed primary swimlane turbine system connection login credentials image access from quay io http //quay io/ (or other image repositories provided) cgroupv2 enablement container host version, function, and storage size ability of the container host to run an image quality of connection to a turbine cloud environment (including latency) virtual container network settings conflicting containers or networks on the container host