Skip to content

Latest commit

 

History

History
137 lines (115 loc) · 12.7 KB

README.md

File metadata and controls

137 lines (115 loc) · 12.7 KB
Raw

Ansible Collection: ericsysmin.docker

Build Status

Role Summary

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
  • Fedora 26
  • Fedora 27
  • Fedora 29
  • OracleLinux 7
  • Ubuntu 14.04
  • Ubuntu 16.04

Requirements

This role requires Ansible 2.4 or higher. Requirements are listed in the metadata file.

Role Variables

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 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_users No Undefined A list of system users to be added to the docker group (so they can use Docker on the server)
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

Example Playbooks

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: ericsysmin.docker.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: ericsysmin.docker.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: ericsysmin.docker.docker
      docker_storage_driver: aufs

License

Apache 2.0

Author Information

ericsysmin