No description
Find a file
semantic-release-bot 1970ecc043 chore(release): 1.15.0 [skip ci]
# [1.15.0](https://github.com/de-it-krachten/ansible-role-docker_compose/compare/v1.14.0...v1.15.0) (2026-03-15)

### Features

* Drop support for Fedora 41 ([ac71450](ac71450cb6))
* Drop support for openSUSE Leap 15 ([1db53b2](1db53b2c08))
* Drop support for SUSE Linux Enterprise 15 ([2715530](2715530747))
2026-03-15 11:37:14 +00:00
.github/workflows Update CI 2026-03-14 19:27:11 +01:00
defaults fix: Add intermediate docker_compose_dirs 2025-10-20 12:47:42 +02:00
handlers Fix CI 2025-08-06 19:42:20 +02:00
meta Update CI 2026-03-14 19:27:11 +01:00
molecule/default Update CI 2026-03-14 19:27:11 +01:00
tasks Fix lint issues 2025-11-01 21:14:27 +01:00
templates feat: Add support for compose files 2023-04-10 23:01:28 +02:00
.ansible-lint feat: Update CI to latest standards 2022-10-08 02:29:32 +02:00
.cicd Update CI 2026-03-06 22:33:11 +01:00
.cicd.overwrite Update CI 2026-03-14 19:27:11 +01:00
.collections fix: pin venv to docker<7 2024-02-08 15:46:16 +01:00
.gitignore feat: Update supported platforms & CI 2024-12-29 01:49:06 +01:00
.releaserc.yml feat: docker-compose v1 is no longer installed by default 2025-09-23 10:55:37 +02:00
.roles feat: Update CI to latest standards 2022-10-08 02:29:32 +02:00
.yamllint feat: Update supported platforms & CI 2024-12-29 01:49:06 +01:00
CHANGELOG.md chore(release): 1.15.0 [skip ci] 2026-03-15 11:37:14 +00:00
README.md Update CI 2026-03-14 19:27:11 +01:00

CI

ansible-role-docker_compose

Installs docker-compose

Dependencies

Roles

None

Collections

  • community.docker

Platforms

Supported platforms

  • Red Hat Enterprise Linux 81
  • Red Hat Enterprise Linux 91
  • Red Hat Enterprise Linux 101
  • RockyLinux 8
  • RockyLinux 9
  • RockyLinux 10
  • OracleLinux 8
  • OracleLinux 9
  • OracleLinux 10
  • AlmaLinux 8
  • AlmaLinux 9
  • AlmaLinux 10
  • Debian 11 (Bullseye)
  • Debian 12 (Bookworm)1
  • Debian 13 (Trixie)
  • Ubuntu 22.04 LTS
  • Ubuntu 24.04 LTS
  • Fedora 421
  • Fedora 431
  • Alpine 31

Note: 1 : no automated testing is performed on these platforms

Role Variables

defaults/main.yml


# -----------------------------------------------------------------------------
# Install
# -----------------------------------------------------------------------------

# Should we fall back to docker-compose v1
docker_compose_v1: false

# type of installation (binary/pip/both)
docker_compose_type: pip
docker_compose_pipinvenv: true

# Set virtual environment location
docker_compose_venv_path: /usr/local/venv/docker-compose

# Python to use for docker-compose in venv
docker_compose_venv_python: /usr/bin/python3

# API endpoint to get latest version
docker_compose_api: https://api.github.com/repos/docker/compose

# Download location for binary
docker_compose_repo: https://github.com/docker/compose

# Should the software be downloaded
docker_compose_download: true

# Version to install
docker_compose_version: latest

# Platform/architecture, as it makes part of the binary to download
docker_compose_platform: "{{ ansible_system | lower }}-{{ ansible_architecture }}"

# Target location/ownership/permissions for the binary
docker_compose_path: /usr/local/bin/docker-compose

# Default permissions for data directories
docker_compose_owner: root
docker_compose_group: root
docker_compose_mode: '0755'


# -----------------------------------------------------------------------------
# Template
# -----------------------------------------------------------------------------

# Path where docker-compose projects can be found
docker_compose_root: /export/docker

# Specifies project location
docker_compose_project_dir: "{{ docker_compose_root }}/{{ docker_compose_project_name }}"

# Should the latest image be pulled during project start/restart (always, missing)
docker_compose_pull: missing

# Should the latest image be build during project start/restart (always, missing)
docker_compose_build: never

# Force restart of the project (by default only when a change is found)
docker_compose_restart: false

# Execute template code as root
docker_compose_become: no

# Should a backup of docker-compose.yml be created
docker_compose_backup: true

# Files to distribute to remote host
docker_compose_files: []

# Directories to create on remote host
docker_compose_dirs: []

Example Playbook

molecule/default/converge.yml


- name: sample playbook for role 'docker_compose'
  hosts: all
  become: 'yes'
  vars:
    molecule_driver: '{{ lookup(''env'', ''MOLECULE_DRIVER_NAME'') }}'
    python_package_install_optional: true
    docker_compose_type: pip
  roles:
    - deitkrachten.python
  tasks:
    - name: Include role 'docker_compose'
      ansible.builtin.include_role:
        name: docker_compose