This is the agent Docker Cloud uses to set up nodes. It's a daemon that will register the host with the DockerCloud API using a user token (Token
), and will manage the installation, configuration and ongoing upgrade of the Docker daemon.
For information on how to install it in your host, please check the Bring Your Own Node documentation.
If installing from a .deb
or .rpm
package, Docker Cloud Agent will be configured in upstart to be launched on boot.
# dockercloud-agent -h
Usage of ./dockercloud-agent:
-debug
Enable debug mode
-docker-host string
Override 'DockerHost'
-docker-opts string
Add additional flags to run docker daemon
-host string
Override 'Host' in the configuration file
-ngrok-host string
ngrok host for NAT tunneling
-skip-nat-tunnel
Skip NAT tunnel
-require-nat-tunnel
Force requirement of NAT tunnel (non-standalone)
-standalone
Standalone mode, skipping reg with Docker Cloud
-stdout
Print log to stdout
-token string
Override 'Token' in the configuration file
-uuid string
Override 'UUID' in the configuration file
-v show version
set: Set items in the config file and exit, supported items
CertCommonName="xxx"
DockerHost="xxx"
Host="xxx"
Token="xxx"
UUID="xxx"
DockerOpts="xxx"
Configuration file is located in /etc/dockercloud/agent/dockercloud-agent.conf
(JSON file) with the following structure:
{
"CertCommonName":"",
"DockerHost":"tcp://0.0.0.0:2375",
"Host":"https://cloud.docker.com/",
"Token":"",
"UUID":"",
"DockerOpts":""
}
Logs are stored under /var/log/dockercloud/
:
agent.log
contains the logs of the agent itselfdocker.log
contains the Docker daemon logs
Run make
to build binaries and .deb
and .rpm
packages which will be stored in the build/
folder.
If HTTP_PROXY
and HTTPS_PRXOY
is defined, tutum-agent will read and use them. (this is supported by golang natively)
Currently supported and tested on:
- Ubuntu 14.04, 15.04, 15.10
- CentOS 7
- Fedora 21, 22
- Debian 8
- Red Hat Enterprise Linux 7
In order to report a security issue, please send us an email to security@docker.com. Thank you!