IMPORTANT! Even if this role does not list support for some distribution versions it might still work.
This Ansible role installs and configures Docker CE (Community Edition) on several different Linux distributions. The goal is to let the user of this role to just care about how Docker shall be installed and configured and hide the differences that exists in the different distributions.
ansible-galaxy role install haxorof.docker_ce
- One way to install and configure Docker CE across supported Linux distributions.
- Support install of Docker SDK and Docker Compose.
- Best effort support of installations of Docker plugins.
- Best effort uninstall of Docker CE and related configuration
- Do tweaks etc to avoid buggy or non-working configurations in some supported distributions.
- Ease handling of setting up Docker according to Center of Internet Security (CIS) documentation.
Note! Some version(s) of distributions listed below only have Python 2.7 installed, these are only compatible with Ansible versions below 10.0.0 (or ansible-core versions below 2.17). This is because Python 2.7 support was dropped in Ansible 10.0.0 (ansible-core 2.17).
- AlmaLinux1
- Amazon Linux1
- CentOS1
- CentOS Stream
- Debian
- Fedora
- Linux Mint1 (based on Ubuntu).
- Raspbian (based on Debian)
- RHEL
- Rocky Linux1
- Ubuntu
1 NB: Docker does not officially support completely or partly Docker CE on this distribution and some features might/will not work.
There might be other distributions that also works with this roles which are not in the list above by disabling the distribution check by setting variable docker_do_checks to no.
See changelog here
- ansible
9.0.0or later (ansible-core2.16or later)
For this role to support multiple Ansible versions it is not possible to avoid all Ansible deprecation warnings. Read Ansible documentation if you want to disable deprecation warnings.
This role tries to support the latest and previous major release of Ansible version. For supported Ansible versions see here
If only ansible-core is installed these collections must also be installed for the role to work:
- ansible.posix
- community.general
No additional requirements.
Variables related to this role are listed here
None.
Following sub sections show different kind of examples to illustrate what this role supports.
- hosts: docker
roles:
- role: haxorof.docker_ce- hosts: docker
vars:
docker_daemon_envs:
HTTP_PROXY: http://localhost:3128/
NO_PROXY: localhost,127.0.0.1,docker-registry.somecorporation.com
roles:
- haxorof.docker_ce- hosts: test-host
vars:
docker_sdk: true
docker_compose: true
roles:
- haxorof.docker_ce
post_tasks:
- name: Test hello container
become: yes
docker_container:
name: hello
image: hello-world
- name: Test hello service
become: yes
docker_service:
project_name: hello
definition:
version: '3'
services:
hello:
image: "hello-world"This minimal example below show what kind of role configuration that is required to pass the Docker bench checks.
However this configuration setup devicemapper in a certain way which will create logical volumes for the containers. Simplest is to have at least 3 GB of free space available in the partition. Since Docker v17.06 it is possible to just set the storage option dm.directlvm_device to make Docker create the necessary volumes:
- hosts: docker
vars:
docker_plugins:
- type: authz
alias: opa-docker-authz
name: openpolicyagent/opa-docker-authz-v2:0.4
args: opa-args="-policy-file /opa/policies/authz.rego"
docker_enable_audit: yes
docker_daemon_config:
icc: false
log-driver: journald
userns-remap: default
live-restore: true
userland-proxy: false
no-new-privileges: true
roles:
- haxorof.docker_ceBecause the configuration above requires Linux user namespaces to be enabled then additional GRUB arguments might be needed. Example below show one example what changes that might be needed and reboot of the host is required for the changes to take full affect.
# https://success.docker.com/article/user-namespace-runtime-error
- hosts: docker
roles:
- role: jtyr.grub_cmdline
vars:
grub_cmdline_add_args:
- namespace.unpriv_enable=1
- user_namespace.enable=1
become: yes
tasks:
- name: set user.max_user_namespaces
sysctl:
name: user.max_user_namespaces
value: 15000
sysctl_set: yes
state: present
reload: yes
become: yesFor a more complete working example on CentOS 7 have a look here.
Here is the latest test results of the automated test which is located in the tests directory:
Note! All distributions listed in test matrix below does not provided the latest released Docker CE version.
Last run: 2022-04-17 (Latest possible Docker CE release 20.10.14, Run with Ansible 4.10.0)
| Suite | ID | Comment |
|---|---|---|
| s-1 | t_config | |
| s-2 | t_postinstall | |
| s-3 | t_devicemapper_config | |
| s-4 | t_auditd |
| Symbol | Definition |
|---|---|
| ✔️ | All tests passed |
| ❌ | At least one test failed |
| ➖ | No test done / Not yet tested |
| # | s-1 | s-2 | s-3 | s-4 | updated |
|---|---|---|---|---|---|
| almalinux/8 | ✔️ | ✔️ | ✔️ | ✔️ | 2023-05-18 |
| almalinux/9 | ✔️ | ✔️ | ❌ | ✔️ | 2023-05-18 |
| centos/7 | ✔️ | ✔️ | ✔️ | ✔️ | 2023-05-18 |
| centos/stream8 | ➖ | ➖ | ➖ | ➖ | 2023-05-18 |
| centos/stream9 | ➖ | ➖ | ➖ | ➖ | 2023-05-18 |
| generic/debian10 | ✔️ | ✔️ | ✔️ | ✔️ | 2023-05-18 |
| generic/debian11 | ✔️ | ✔️ | ✔️ | ✔️ | 2023-05-18 |
| generic/fedora36 | ➖ | ➖ | ➖ | ➖ | 2023-05-18 |
| generic/fedora37 | ➖ | ➖ | ➖ | ➖ | 2023-05-18 |
| generic/rocky8 | ✔️ | ✔️ | ✔️ | ✔️ | 2023-05-18 |
| generic/rocky9 | ✔️ | ✔️ | ❌ | ✔️ | 2023-05-18 |
| generic/ubuntu1804 | ✔️ | ✔️ | ✔️ | ✔️ | 2023-05-18 |
| generic/ubuntu2004 | ✔️ | ✔️ | ✔️ | ✔️ | 2023-05-18 |
| generic/ubuntu2204 | ✔️ | ✔️ | ✔️ | ✔️ | 2023-05-18 |
| generic/rhel7 | ✔️ | ✔️ | ✔️ | ✔️ | 2021-06-19 |
| generic/rhel8 | ✔️ | ✔️ | ✔️ | ✔️ | 2021-06-19 |
| generic/rhel9 | ✔️ | ✔️ | ❌ | ✔️ | 2022-08-12 |
This is an open source project under the MIT license.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
![github-actions[bot] avatar](https://avatars.githubusercontent.com/in/15368?v=4 "github-actions[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent