feat: support to install docker compose as docker CLI plugins

defaults/main.yml

@@ -69,15 +69,14 @@ docker_ca_certificates_src_dir: "{{ '~/docker-ca-certificates' | expanduser }}"
 # certificate files (besides other locations).
 docker_ca_certificates_dst_dir: "/usr/local/share/ca-certificates"
 
-# Currently only "standalone" is supported. So that means on the remote host
-# "docker-compose" command will be available and not the "docker compose"
-# plugin (without "-").
-# When commented no "docker-compose" will be installed and all "docker_compose_*"
-# variables are ignored.
-# docker_compose_type: "standalone"
+# 2 kind of compose installation are supported (standalone to support legacy environments):
+# - standalone: The standalone "docker-compose" binary. This is the old way to use "docker-compose". The binary is called "docker-compose" and is installed in a directory defined by `docker_compose_bin_directory` variable. This is the default value for `docker_compose_type` variable.
+# - plugin: The "docker compose" plugin for "docker" CLI. This is the new way to use "docker-compose". The binary is called "docker-compose" and is installed in "/usr/local/lib/docker/cli-plugins/docker-compose". This is the recommended way to use "docker-compose" and is the default value for `docker_compose_type` variable.
+# When commented no "docker-compose" will be installed and all "docker_compose_*" variables will be ignored.
+docker_compose_type: "standalone"
 
 # "docker-compose" version
-docker_compose_version: "2.38.2"
+docker_compose_version: "5.1.1"
 
 # The directory where to "docker-compose" binary will be installed
 docker_compose_bin_directory: "/usr/local/bin"

tasks/deps-debian.yml

@@ -0,0 +1,5 @@
+---
+- name: Install prerequisite packages
+  ansible.builtin.apt:
+    name: "{{ dependency_packages }}"
+    state: present

tasks/deps-redhat.yml

@@ -0,0 +1,4 @@
+- name: Install prerequisite packages
+  ansible.builtin.package:
+    name: "{{ dependency_packages }}"
+    state: present

tasks/docker-compose-plugin.yml

@@ -0,0 +1,18 @@
+---
+
+- name: Ensure docker compose cli plugins directory exists
+  ansible.builtin.file:
+    path: /usr/local/lib/docker/cli-plugins
+    state: directory
+    owner: root
+    group: root
+    mode: "0755"
+
+- name: Downloading docker compose plugins binary v2 and make exec
+  ansible.builtin.get_url:
+    url: "https://github.com/docker/compose/releases/download/v{{ docker_compose_version }}/docker-compose-{{ ansible_system | lower }}-{{ ansible_architecture }}"
+    dest: "/usr/local/lib/docker/cli-plugins/docker-compose"
+    mode: "{{ docker_compose_bin_file_perm }}"
+    owner: "{{ docker_compose_bin_owner }}"
+    group: "{{ docker_compose_bin_group }}"
+    checksum: "sha256:https://github.com/docker/compose/releases/download/v{{ docker_compose_version }}/docker-compose-{{ ansible_system | lower }}-{{ ansible_architecture }}.sha256"

tasks/main.yml

@@ -16,19 +16,8 @@
   tags:
     - always
 
-- name: Bootstrap python3-apt on Debian family hosts
-  when:
-    - ansible_facts['os_family'] == "Debian"
-  ansible.builtin.raw: |
-    if python3 -c 'import apt' >/dev/null 2>&1; then
-      echo "python3-apt already present"
-    else
-      export DEBIAN_FRONTEND=noninteractive
-      apt-get update
-      apt-get install -y python3-apt
-    fi
-  register: docker__python3_apt_bootstrap
-  changed_when: "'python3-apt already present' not in docker__python3_apt_bootstrap.stdout"
+- ansible.builtin.include_tasks: deps-{{ ansible_os_family | lower }}.yml
+  when: ansible_os_family in ['RedHat', 'Debian'] # supported os family
 
 - name: Gather the package facts
   ansible.builtin.package_facts:
@@ -241,9 +230,9 @@
 
 - name: Install docker-compose binary
   when:
-    - docker_compose_type is defined
+    - docker_compose_type is defined and docker_compose_type in ['standalone', 'plugin']
   ansible.builtin.include_tasks:
-    file: "tasks/docker-compose.yml"
+    file: "tasks/docker-compose-{{ docker_compose_type }}.yml"
     apply:
       tags:
         - docker-compose

vars/debian-11.yml

@@ -1,3 +1,5 @@
 ---
 docker_ip_nft_tables_packages:
   iptables: "iptables"
+dependency_packages:
+  - python3-apt

vars/debian-12.yml

@@ -1,3 +1,5 @@
 ---
 docker_ip_nft_tables_packages:
   iptables: "iptables"
+dependency_packages:
+  - python3-apt

vars/debian.yml

@@ -1,3 +1,5 @@
 ---
 docker_ip_nft_tables_packages:
   iptables: "iptables"
+dependency_packages:
+  - python3-apt

vars/ubuntu-22.yml

@@ -1,3 +1,5 @@
 ---
 docker_ip_nft_tables_packages:
   iptables: "iptables"
+dependency_packages:
+  - python3-apt

vars/ubuntu-24.yml

@@ -1,3 +1,5 @@
 ---
 docker_ip_nft_tables_packages:
   iptables: "iptables"
+dependency_packages:
+  - python3-apt

vars/ubuntu.yml

@@ -1,3 +1,5 @@
 ---
 docker_ip_nft_tables_packages:
   iptables: "iptables"
+dependency_packages:
+  - python3-apt