GoCD agent docker image based on ubuntu 16.04.
Please make sure to log them at https://github.com/gocd/docker-gocd-agent.
Start the container with this:
docker run -d -e GO_SERVER_URL=... gocd/gocd-agent-ubuntu-16.04:v17.3.0
Note: Please make sure to always provide the version. We do not publish the latest
tag. And we don't intend to.
This will start the GoCD agent and connect it the GoCD server specified by GO_SERVER_URL
.
Note: The
GO_SERVER_URL
must be an HTTPS url and end with/go
, for e.g.https://ip.add.re.ss:8154/go
docker run -d \
-e AGENT_AUTO_REGISTER_KEY=... \
-e AGENT_AUTO_REGISTER_RESOURCES=... \
-e AGENT_AUTO_REGISTER_ENVIRONMENTS=... \
-e AGENT_AUTO_REGISTER_HOSTNAME=... \
gocd/gocd-agent-ubuntu-16.04:v17.3.0
If the AGENT_AUTO_REGISTER_*
variables are provided (we recommend that you do), then the agent will be automatically approved by the server. See the auto registration docs on the GoCD website.
This image will work well with the docker elastic agent plugin and the docker swarm elastic agent plugin. No special configuration would be needed.
The GoCD agent will store all configuration, logs and perform builds in /godata
. If you'd like to provide secure credentials like SSH private keys among other things, you can mount /home/go
docker run -v /path/to/godata:/godata -v /path/to/home-dir:/home/go gocd/gocd-agent-ubuntu-16.04:v17.3.0
JVM options can be tweaked using the environment variable GO_AGENT_SYSTEM_PROPERTIES
.
docker run -e GO_AGENT_SYSTEM_PROPERTIES="-Dfoo=bar" gocd/gocd-agent-ubuntu-16.04:v17.3.0
The GoCD server runs as the go
user, the location of the various directories is:
Directory | Description |
---|---|
/godata/config |
the directory where the GoCD configuration is store |
/godata/pipelines |
the directory where the agent will run builds |
/godata/logs |
the directory where GoCD logs will be written out to |
/home/go |
the home directory for the GoCD server |
- Check if the docker container is running
docker ps -a
- Check the STDOUT to see if there is any output that indicates failures
docker logs CONTAINER_ID
- Check the agent logs
docker exec -it CONTAINER_ID /bin/bash
, then runless /godata/logs/*.log
inside the container.
Copyright 2017 ThoughtWorks, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.