Installation of the go agent using the package manager will require root access on the machine. You are also required to have a java version 7 for the agent to run.
The installer will create a user called go
if one does not exist on the machine. The home directory will be set to /var/go
. If you want to create your own go
user, make sure you do it before you install the Go agent.
The Go agent RPM installer has been tested on RedHat Enterprise Linux and CentOS. It should work on most RPM based Linux distributions.
If you prefer to use the YUM repository and install via YUM -
$ echo "
[gocd]
name = GoCD YUM Repository
baseurl = http://dl.bintray.com/gocd/gocd-rpm
enabled = 1
gpgcheck = 0
" > /etc/yum.repos.d/thoughtworks-go.repo
$ yum install -y java-1.7.0-openjdk #optional, you may use other jre/jdk if you prefer
$ yum install -y go-agent
Alternatively, if you have the agent RPM downloaded -
$ yum install -y java-1.7.0-openjdk #optional, you may use other jre/jdk if you prefer
$ rpm -i go-agent-${version}.noarch.rpm
The Go agent .deb installer has been tested on Ubuntu. However it should work on most Linux distributions which use debs.
If you prefer to use the apt repository and install via apt-get
-
$ echo "deb http://dl.bintray.com/gocd/gocd-deb/ /" > /etc/apt/sources.list.d/gocd.list
$ wget --quiet -O - "https://bintray.com/user/downloadSubjectPublicKey?username=gocd" | sudo apt-key add -
$ apt-get update
$ apt-get install go-agent
Alternatively, if you have the agent DEB downloaded -
$ dpkg -i go-agent-${version}.deb
To manage the go-agent service, you may use the following commands -
$ /etc/init.d/go-agent [start|stop|status|restart]
After installing the go-agent service, you must first configure the service with the hostname (or IP address) of your Go server, in order to do this -
/etc/default/go-agent
in your favourite text editor.GO_SERVER=127.0.0.1
to the hostname (or IP address) of your Go server./etc/init.d/go-agent [start|restart]
to (re)start the agent.Note: You can override default environment for the go agent by editing the file
/etc/defaults/go-agent
The go agent installs the following files on your filesystem
/var/lib/go-agent #contains the binaries
/usr/share/go-agent #contains the start script
/var/log/go-agent #contains the agent logs
/etc/default/go-agent #contains all the environment variables with default values. These variable values can be changed as per requirement
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: