An Ansible Role that installs Docker on Linux.
Please only install the version when CI is PASSING!
Role is tested on, Ubuntu, Debian and Rocky (RedHat like) Linux distributions.
Downloads:
Original from geerlingguy.docker Additional:
- Remove PodMan from RedHat linux
- Add user and group docker:docker
- Add current Ansible become user to group docker
- set
docker_uidanddocker_guito the ID's of the docker user and group. This can be used in other Ansible roles from me that all use docker undernead. This will create a seamless installation.
None.
Available variables are listed below, along with default values (see defaults/main.yml):
# Edition can be one of: 'ce' (Community Edition) or 'ee' (Enterprise Edition).
docker_edition: 'ce'
docker_packages:
- "docker-{{ docker_edition }}"
- "docker-{{ docker_edition }}-cli"
- "docker-{{ docker_edition }}-rootless-extras"
docker_packages_state: present
The docker_edition should be either ce (Community Edition) or ee (Enterprise Edition).
You can also specify a specific version of Docker to install using the distribution-specific format:
Red Hat/CentOS: docker-{{ docker_edition }}-<VERSION> (Note: you have to add this to all packages);
Debian/Ubuntu: docker-{{ docker_edition }}=<VERSION> (Note: you have to add this to all packages).
You can control whether the package is installed, uninstalled, or at the latest version by setting docker_packages_state to present, absent, or latest, respectively. Note that the Docker daemon will be automatically restarted if the Docker package is updated. This is a side effect of flushing all handlers (running any of the handlers that have been notified by this and any other role up to this point in the play).
docker_service_manage: true
docker_service_state: started
docker_service_enabled: true
docker_restart_handler_state: restarted
Variables to control the state of the docker service, and whether it should start on boot. If you're installing Docker inside a Docker container without systemd or sysvinit, you should set docker_service_manage to false.
docker_install_compose_plugin: false
docker_compose_package: docker-compose-plugin
docker_compose_package_state: present
Docker Compose Plugin installation options. These differ from the below in that docker-compose is installed as a docker plugin (and used with docker compose) instead of a standalone binary.
docker_install_compose: true
docker_compose_version: "1.26.0"
docker_compose_arch: "{{ ansible_architecture }}"
docker_compose_path: /usr/local/bin/docker-compose
Docker Compose installation options.
docker_add_repo: true
Controls whether this role will add the official Docker repository. Set to false if you want to use the default docker packages for your system or manage the package repository on your own.
docker_repo_url: https://download.docker.com/linux
The main Docker repo URL, common between Debian and RHEL systems.
docker_apt_release_channel: stable
docker_apt_arch: "{{ 'arm64' if ansible_architecture == 'aarch64' else 'amd64' }}"
docker_apt_repository: "deb [arch={{ docker_apt_arch }}] {{ docker_repo_url }}/{{ ansible_distribution | lower }} {{ ansible_distribution_release }} {{ docker_apt_release_channel }}"
docker_apt_ignore_key_error: True
docker_apt_gpg_key: "{{ docker_repo_url }}/{{ ansible_distribution | lower }}/gpg"
docker_apt_filename: "docker"
(Used only for Debian/Ubuntu.) You can switch the channel to nightly if you want to use the Nightly release.
You can change docker_apt_gpg_key to a different url if you are behind a firewall or provide a trustworthy mirror.
Usually in combination with changing docker_apt_repository as well. docker_apt_filename controls the name of the source list file created in sources.list.d. If you are upgrading from an older (<7.0.0) version of this role, you should change this to the name of the existing file (e.g. download_docker_com_linux_debian on Debian) to avoid conflicting lists.
docker_yum_repo_url: "{{ docker_repo_url }}/{{ (ansible_distribution == 'Fedora') | ternary('fedora','centos') }}/docker-{{ docker_edition }}.repo"docker_edition }}.repo
docker_yum_repo_enable_nightly: '0'
docker_yum_repo_enable_test: '0'
docker_yum_gpg_key: "{{ docker_repo_url }}/centos/gpg"
(Used only for RedHat/CentOS.) You can enable the Nightly or Test repo by setting the respective vars to 1.
You can change docker_yum_gpg_key to a different url if you are behind a firewall or provide a trustworthy mirror.
Usually in combination with changing docker_yum_repository as well.
docker_users:
- user1
- user2
A list of system users to be added to the docker group (so they can use Docker on the server). Also the current Ansible user will be added
docker_daemon_options:
storage-driver: "devicemapper"
log-opts:
max-size: "100m"
Custom dockerd options can be configured through this dictionary representing the json file /etc/docker/daemon.json.
This role was created in 2017 by Jeff Geerling, author of Ansible for DevOps.
Changed with some additional settings by me (Bart Smeding) to integrated in my other Ansible container application roles.
If you get the error "Error connecting: Error while fetching server API version: Not supported URL scheme http+docker"} please upgrade the Ansible collections:
(or set requests python library to < 2.32.0 )
- name: community.general
- name: community.docker