This role provides the following:
- Installation of Docker following Docker-Engine install procedures as documented by Docker.
- It will manage kernel versions as well, verifying the that the correct kernel for Docker support is installed.
Supports the following Operating Systems:
- CentOS 7
- RedHat 7
- Fedora 24
- Fedora 23
- OracleLinux 7
- Ubuntu 14.04
- Ubuntu 16.04
This role requires Ansible 2.0.0 or higher. Requirements are listed in the metadata file.
If you rely on privileage escalation (e.g. become: true) with this role, you will need Ansible 2.2.1 or higher to take advantage of this issue being fixed: ansible/ansible#17490
For more information about the variables many can be found https://docs.docker.com/engine/reference/commandline/dockerd/
| Variable | Required | Default | Comments |
|---|---|---|---|
docker_edition |
No | ce |
Specifies either legacy, ce, or ee version of Docker. |
docker_ee_url |
No | Undefined |
Docker EE URL from the Docker Store |
docker_repo |
No | docker |
Defines how Ansible manages the repository. Options are "other" and "docker" |
docker_channel |
No | stable |
What release channel of Docker to install. |
docker_ee_version |
No | 17.03 |
Docker EE version for EE repository |
docker_storage_driver |
No | Undefined |
Storage driver to use |
docker_block_device |
No | Undefined |
The device name used for the storage driver. |
docker_mount_opts |
No | Undefined |
The mount options when mounting filesystems |
docker_storage_opts |
No | Undefined |
Storage driver options |
docker_api_cors_header |
No | Undefined |
Set CORS headers in the remote API |
docker_authorization_plugins |
No | Undefined |
Authorization plugins to load |
docker_bip |
No | Undefined |
Specify network bridge IP |
docker_bridge |
No | Undefined |
Attach containers to a network bridge |
docker_cgroup_parent |
No | Undefined |
Set parent cgroup for all containers |
docker_cluster_store |
No | Undefined |
Set cluster store options |
docker_cluster_store_opts |
No | Undefined |
Please see dockerd manual for info |
docker_cluster_advertise |
No | Undefined |
Address or interface name to advertise |
docker_debug |
No | Undefined |
Enable debug mode |
docker_default_gateway |
No | Undefined |
Container default gateway IPv4 address |
docker_default_gateway_v6 |
No | Undefined |
Container default gateway IPv6 address |
docker_default_runtime |
No | Undefined |
Default OCI runtime for containers |
docker_default_ulimits |
No | Undefined |
Default ulimits for containers |
docker_disable_legacy_registry |
No | Undefined |
Disable contacting legacy registries |
docker_dns |
No | Undefined |
DNS server to use |
docker_dns_opts |
No | Undefined |
DNS options to use |
docker_dns_search |
No | Undefined |
DNS search domains to use |
docker_exec_opts |
No | Undefined |
Runtime execution options |
docker_exec_root |
No | Undefined |
Root directory for execution state files |
docker_fixed_cidr |
No | Undefined |
IPv4 subnet for fixed IPs |
docker_fixed_cidr_v6 |
No | Undefined |
IPv6 subnet for fixed IPs |
docker_graph |
No | Undefined |
Root of the Docker runtime |
docker_group |
No | Undefined |
Group for the unix socket |
docker_hosts |
No | Undefined |
Daemon socket(s) to connect to |
docker_icc |
No | Undefined |
Enable inter-container communication |
docker_insecure_registries |
No | Undefined |
Enable insecure registry communication |
docker_ip |
No | Undefined |
Default IP when binding container ports |
docker_iptables |
No | Undefined |
Enable addition of iptables rules |
docker_ipv6 |
No | Undefined |
Enable IPv6 networking |
docker_ip_forward |
No | Undefined |
Enable net.ipv4.ip_forward |
docker_ip_masq |
No | Undefined |
Enable IP masquerading |
docker_labels |
No | Undefined |
Set key=value labels to the daemon |
docker_live_restore |
No | Undefined |
Enables keeping containers alive during daemon downtime |
docker_log_driver |
No | Undefined |
Default driver for container logs |
docker_log_level |
No | Undefined |
Set the logging level |
docker_log_opts |
No | Undefined |
Default log driver options for containers |
docker_max_concurrent_downloads |
No | Undefined |
Set the max concurrent downloads for each pull |
docker_max_concurrent_uploads |
No | Undefined |
Set the max concurrent uploads for each push |
docker_mtu |
No | Undefined |
Set the containers network MTU |
docker_oom_score_adjust |
No | Undefined |
Set the oom_score_adj for the daemon |
docker_pidfile |
No | Undefined |
Path to use for daemon PID file |
docker_raw_logs |
No | Undefined |
Full timestamps without ANSI coloring |
docker_registry_mirrors |
No | Undefined |
Preferred Docker registry mirror |
docker_runtimes |
No | Undefined |
Register an additional OCI compatible runtime |
docker_selinux_enabled |
No | Undefined |
Enable selinux support |
docker_swarm_default_advertise_addr |
No | Undefined |
Set default address or interface for swarm advertised address |
docker_tls |
No | Undefined |
Use TLS; implied by –tlsverify |
docker_tlscacert |
No | Undefined |
Trust certs signed only by this CA |
docker_tlscert |
No | Undefined |
Path to TLS certificate file |
docker_tlskey |
No | Undefined |
Path to TLS key file |
docker_tlsverify |
No | Undefined |
Use TLS and verify the remote |
docker_userland_proxy |
No | Undefined |
Use userland proxy for loopback traffic |
docker_userns_remap |
No | Undefined |
User/Group setting for user namespaces |
docker_http_proxy |
No | Undefined |
Set the Docker service to use HTTP_PROXY |
docker_https_proxy |
No | Undefined |
Set the Docker service to use HTTPS_PROXY |
docker_no_proxy_params |
No | Undefined |
Do not proxy for Docker service params |
Install docker to the hosts with basic defaults. This does not install devicemapper, or configure the server for production. This just simply installs docker and gets it running. Compare this to apt install docker-ce or yum install docker-ce.
- hosts: servers
roles:
- role: avinetworks.docker
Install docker with devicemapper. Please note, this will create a new LVM on /dev/sda3, please do not use a block device already in use. This is the recommended production deployment on RHEL/CentOS/Fedora systems.
- hosts: servers
roles:
- role: avinetworks.docker
docker_storage_driver: devicemapper
docker_block_device: /dev/sda3
Install docker with AUFS. This is recommended for production deployment on Ubuntu systems.
- hosts: servers
roles:
- role: avinetworks.docker
docker_storage_driver: aufs
Please see examples/ folder for more examples.
MIT
Eric Anderson