Installing GoCD agent on Windows

Installation
- Silent (Headless) Installation
Overriding default startup arguments and environment
Location of GoCD agent files
Registering your agent with the server

Installation

You must be logged in as a user with Admin privileges to install the GoCD agent on Windows.

Download a version of go-agent from the downloads page.
Double-click the go-agent-${version}-setup.exe installer file and follow the prompts to install Go.
During installation you will be asked to select a root path for your GoCD agent. In addition to being the agent installation directory, this directory will contain also contain a directory where your source code is checked out and built.
You will next be prompted to choose the bundled JRE or specify the location of JRE (or JDK) installed on your system.
After installing the files, the installer will prompt you for the hostname or IP address of the GoCD server. Leaving this blank it will default to localhost.
At the end of the installation, GoCD agent registers itself as a windows service and starts running automatically.

Silent (Headless) Installation

You may use this method if you would like to script the installation of the GoCD agent.

go-agent-${version}-setup.exe /S /START_AGENT=NO /SERVERURL="<SERVERURL>" /GO_AGENT_JAVA_HOME=<PATH_TO_JAVA_HOME> /D=<PATH_TO_AGENT_DIRECTORY>

Argument	Required	Description
`SERVERURL`	No	The URL of the GoCD server. Defaults to `https://127.0.0.1:8154/go`. The value must be surrounded by `"` quotes. If using `powershell.exe`, the quotes must be escaped with backticks `
`START_AGENT`	No	Whether the agent service should start after installation. Set to `NO` (case-sensitive) to disable starting up the service after installation.
`GO_AGENT_JAVA_HOME`	No	The path to a JRE (or JDK) that the agent should run with. Defaults to the jre packaged with the agent. Needs to be at-least Java 8 (same version as the GoCD server).
`PATH_TO_AGENT_DIRECTORY`	No	The path where the agent should be installed. Defaults to `C:\Program Files(x86)\Go Agent`.

For example:

C:\> go-agent-16.1.0-1234-setup.exe /S /SERVERURL="https://10.12.20.47:8154/go" /D=C:\go\agent

In case you are using powershell.exe for the silent installation, the SERVERURL argument needs to be passed with quotes being escaped with backticks:

C:\> go-agent-16.1.0-1234-setup.exe /S /SERVERURL=`"https://10.12.20.47:8154/go`" /D=C:\go\agent

If User Access Control feature is enabled on your Windows system, it needs to be turned off for silent installation to work.

If you are using the silent installation to upgrade GoCD, you should not specify the Installation-Directory option.

Overriding default startup arguments and environment

Create a file named config/wrapper-properties.conf where you installed the agent
Copy any specific properties, or add new properties from config/wrapper-agent.conf into this file. Be sure to increment the property index if you're adding any new properties.
For e.g. to override the loglevel to debug, override wrapper.console.loglevel -
```
# config/wrapper-properties.conf
wrapper.console.loglevel=DEBUG
```

To append additional JVM args to the agent

# config/wrapper-properties.conf
# since the last "wrapper.java.additional" index is 2, we use the next available index.
wrapper.java.additional.3=-Xmx512mb

Each property must be configured separately

# Having a single property for multiple configurations is invalid, e.g
wrapper.java.additional.16="-Dcruise.config.foo='bar' -Dcruise.config.other='baz'"

Valid properties,
wrapper.java.additional.16=-Dcruise.config.foo=bar
wrapper.java.additional.17=-Dcruise.config.other=baz

Please note : If the go-agent as an application is run by any user, then this user needs to have these required permissions to the go-agent folder, i.e. modify, read and execute, list folder contents and read permissions.

Location of GoCD agent files

All the files for the GoCD agent are under its root installation folder in Windows, the default location is C:\Program Files\Go Agent.

Registering your agent with the server

For security reasons, all newly installed Go agents need to be enabled on the Go server before work is assigned to them. This prevents an unauthorized person from getting access to your source code. To enable a newly installed Go agent, do the following:

Open the Go server dashboard
Follow the instructions here to find the agent you've just installed on the list and add the agent to your cloud. The Go server will now schedule work for this agent.

Windows