Ansible Collection - bodsch.docker

A collection of Ansible roles for docker Stuff.

Requirements & Dependencies

• ruamel.yaml

pip install ruamel.yaml

supported operating systems

• Arch Linux
• Debian based
  • Debian 10
  • Debian 11
  • Debian 12
  • Ubuntu 20.04
  • Ubuntu 22.04
  • Ubuntu 24.04

Installing this collection

You can install the memsource collection with the Ansible Galaxy CLI:

#> ansible-galaxy collection install bodsch.docker

To install directly from GitHub:

#> ansible-galaxy collection install [email protected]:bodsch/ansible-collection-docker.git

You can also include it in a requirements.yml file and install it with ansible-galaxy collection install -r requirements.yml, using the format:

---
collections:
  - name: bodsch.docker

The python module dependencies are not installed by ansible-galaxy. They can be manually installed using pip:

pip install -r requirements.txt

Contribution

Please read Contribution

Development, Branches (Git Tags)

The master Branch is my Working Horse includes the "latest, hot shit" and can be complete broken!

If you want to use something stable, please use a Tagged Version!

---

Roles

Role	Build State	Description
bodsch.docker.docker		This role will fully configure and install dockerd.
bodsch.docker.container		Ansible role for deployment of generic container applications.
bodsch.docker.registry		Ansible role to install and configure container registry.
bodsch.docker.registry_ui		Ansible role for installing and configuring registry-ui
bodsch.docker.compose_file		Ansible role to manage docker compose file or fragments.

Modules

Name	Description
compose_file	Manage Docker Compose YAML files
compose_files	Manage multiple Docker Compose fragment files.
container_directories	Manage and create container directories.
container_environments	Manage environment and configuration files for containers.
container_mounts	Manage and migrate container mounts and volumes.
docker_client_configs	Manage Docker client configuration files.
docker_common_config	Manage the Docker daemon configuration file.
docker_plugins	Manage Docker plugins.
docker_version	Retrieve the current Docker Engine and API version.

Filters

Name	Description
container_filter
container_names
container_images
container_state
container_volumes
container_mounts
container_environnments
container_ignore_state
container_with_states
container_filter_by
container_facts
remove_custom_fields
remove_source_handling
changed
update
files_available
reporting
combine_registries
validate_mountpoints
validate_log_driver

---

Author

• Bodo Schulz

License

Apache

FREE SOFTWARE, HELL YEAH!