cross-posted from: https://lemmy.ml/post/39297898

Hello, Does anyone have by any chance an ansible playbook to setup docker on a debian trixie?

This is my first experience with Ansible, i thought this would be easy and straightforward. I used existing ones for debian 12 as template and yes, with ai, and taking things from other templates, i am trying to make this work. but for the life of me, i cannot crack this.

i began with the most simple steps:

- name: install Docker
  hosts: all
  become: true
  tasks:
    - name: Install apt-transport-https
      ansible.builtin.apt:
        name:
          - apt-transport-https
          - ca-certificates
          - lsb-release
          - gnupg
        state: latest
        update_cache: true

    - name: Create keyrings directory
      ansible.builtin.file:
        path: /etc/apt/keyrings
        state: directory
        mode: '0755'

    - name: Add Docker GPG key
      ansible.builtin.shell: |
        curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg
        chmod a+r /etc/apt/keyrings/docker.gpg
      args:
        creates: /etc/apt/keyrings/docker.gpg

    - name: Add Docker repository
      ansible.builtin.apt_repository:
        repo: "deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian trixie stable"
        state: present
        filename: docker

    - name: Install Docker
      ansible.builtin.apt:
        name:
          - docker-ce
          - docker-ce-cli
          - containerd.io
          - docker-buildx-plugin
          - docker-compose-plugin
        state: latest
        update_cache: true

and added some debug stuff that really didnt help that much:

- name: Install Docker Engine and Docker Compose on Debian (Ansible WebUI compatible)
  hosts: all
  become: true
  become_user: root

  vars:
    docker_packages:
      - docker-ce
      - docker-ce-cli
      - containerd.io
      - docker-buildx-plugin
      - docker-compose-plugin

  tasks:

    - name: Ensure required packages are installed
      apt:
        name:
          - ca-certificates
          - curl
          - gnupg
        update_cache: yes
        state: present
      delegate_to: "{{ inventory_hostname }}"

    - name: Ensure /etc/apt/keyrings exists
      file:
        path: /etc/apt/keyrings
        state: directory
        mode: '0755'
      delegate_to: "{{ inventory_hostname }}"

    - name: Get system architecture for Docker repo
      ansible.builtin.command: dpkg --print-architecture
      register: dpkg_architecture
      changed_when: false
      delegate_to: "{{ inventory_hostname }}"

    - name: Download Docker GPG key
      ansible.builtin.get_url:
        url: https://download.docker.com/linux/debian/gpg
        dest: /etc/apt/keyrings/docker.asc
        mode: '0644'
      delegate_to: "{{ inventory_hostname }}"

    - name: DEBUG - Check if GPG key exists
      ansible.builtin.stat:
        path: /etc/apt/keyrings/docker.asc
      register: gpg_key_stat
      delegate_to: "{{ inventory_hostname }}"

    - name: DEBUG - Show GPG key status
      ansible.builtin.debug:
        msg: "GPG key exists: {{ gpg_key_stat.stat.exists }}, Size: {{ gpg_key_stat.stat.size | default('N/A') }}"

    - name: DEBUG - List keyrings directory
      ansible.builtin.command: ls -lah /etc/apt/keyrings/
      register: keyrings_list
      delegate_to: "{{ inventory_hostname }}"

    - name: DEBUG - Show keyrings directory contents
      ansible.builtin.debug:
        var: keyrings_list.stdout_lines

    - name: Add Docker APT repository (correct for Debian 13)
      ansible.builtin.apt_repository:
        repo: "deb [arch={{ dpkg_architecture.stdout }} signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian {{ ansible_distribution_release }} stable"
        filename: docker
        state: present
      delegate_to: "{{ inventory_hostname }}"

    - name: DEBUG - Check if repo file exists
      ansible.builtin.stat:
        path: /etc/apt/sources.list.d/docker.list
      register: repo_file_stat
      delegate_to: "{{ inventory_hostname }}"

    - name: DEBUG - Show repo file status
      ansible.builtin.debug:
        msg: "Repo file exists: {{ repo_file_stat.stat.exists }}"

    - name: DEBUG - Show repo file contents if exists
      ansible.builtin.command: cat /etc/apt/sources.list.d/docker.list
      register: repo_contents
      when: repo_file_stat.stat.exists
      failed_when: false
      delegate_to: "{{ inventory_hostname }}"

    - name: DEBUG - Display repo contents
      ansible.builtin.debug:
        var: repo_contents.stdout_lines
      when: repo_file_stat.stat.exists

    - name: Update apt cache after adding repo
      apt:
        update_cache: yes
      delegate_to: "{{ inventory_hostname }}"

    - name: Install Docker packages
      apt:
        name: "{{ docker_packages }}"
        state: present
      delegate_to: "{{ inventory_hostname }}"

    - name: Enable & start Docker
      service:
        name: docker
        state: started
        enabled: yes
      delegate_to: "{{ inventory_hostname }}"

but everytime it fails at adding the package because its not found. because the repo was not added, my keyrings folder is miserably empty.

the target server has only root. so no user confusion there. yes, i know. bad practice. but its a learning exercise and its a lxc within my home network not internet exposed.

PLAY [Install Docker Engine and Docker Compose on Debian (Ansible WebUI compatible)] ***

TASK [Gathering Facts] *********************************************************
[WARNING]: Host 'anytype.lab' is using the discovered Python interpreter at '/usr/bin/python3.13', but future installation of another Python interpreter could cause a different interpreter to be discovered. See https://docs.ansible.com/ansible-core/2.19/reference_appendices/interpreter_discovery.html for more information.
ok: [anytype.lab]

TASK [Ensure required packages are installed] **********************************
changed: [anytype.lab]

TASK [Ensure /etc/apt/keyrings exists] *****************************************
ok: [anytype.lab]

TASK [Get system architecture for Docker repo] *********************************
skipping: [anytype.lab]

TASK [Download Docker GPG key] *************************************************
changed: [anytype.lab]

TASK [DEBUG - Check if GPG key exists] *****************************************
ok: [anytype.lab]

TASK [DEBUG - Show GPG key status] *********************************************
ok: [anytype.lab] => {
    "msg": "GPG key exists: False, Size: N/A"
}

TASK [DEBUG - List keyrings directory] *****************************************
skipping: [anytype.lab]

TASK [DEBUG - Show keyrings directory contents] ********************************
ok: [anytype.lab] => {
    "keyrings_list.stdout_lines": []
}

TASK [Add Docker APT repository (correct for Debian 13)] ***********************
changed: [anytype.lab]

TASK [DEBUG - Check if repo file exists] ***************************************
ok: [anytype.lab]

TASK [DEBUG - Show repo file status] *******************************************
ok: [anytype.lab] => {
    "msg": "Repo file exists: False"
}

TASK [DEBUG - Show repo file contents if exists] *******************************
skipping: [anytype.lab]

TASK [DEBUG - Display repo contents] *******************************************
skipping: [anytype.lab]

TASK [Update apt cache after adding repo] **************************************
changed: [anytype.lab]

TASK [Install Docker packages] *************************************************
[ERROR]: Task failed: Module failed: No package matching 'docker-ce' is available
Origin: /tmp/ansible-webui/repositories/1_ansibleplaybooksrepo/playbooks/debian13docker.yml:100:7

 98       delegate_to: "{{ inventory_hostname }}"
 99
100     - name: Install Docker packages
          ^ column 7

fatal: [anytype.lab]: FAILED! => {"changed": false, "msg": "No package matching 'docker-ce' is available"}

PLAY RECAP *********************************************************************
anytype.lab                : ok=11   changed=4    unreachable=0    failed=1    skipped=4    rescued=0    ignored=0   

I am using https://ansible-webui.oxl.app/ although i doubt it has any effect whatsoever. but then again, i know next to nothing of ansible as of yet. so, for sure: what i am missing is incredibly dumb.

any help will be greatly appreciated.

  • audricd@lemmy.mlOP
    link
    fedilink
    English
    arrow-up
    1
    ·
    3 months ago

    docker_pre_apks:

    • apt-transport-https
    • ca-certificates
    • curl
    • gnupg2
    • libssl-dev
    • python3-cffi-backend
    • python3-pip
    • libffi-dev
    • python3-setuptools
    • python3-nacl
    • python3-jsondiff

    docker_apks:

    still same result :(

    ---
    - name: Install Docker Engine and Docker Compose on Debian (Ansible WebUI compatible)
      hosts: all
      become: true
      become_user: root
    
      vars:
        docker_pre_apks:
          - apt-transport-https
          - ca-certificates
          - curl
          - gnupg2
          - libssl-dev
          - python3-cffi-backend
          - python3-pip
          - libffi-dev
          - python3-setuptools
          - python3-nacl
          - python3-jsondiff
        docker_apks:
          - docker-ce
          - docker-ce-cli
          - containerd.io
        docker_arch: amd64
    
      tasks:
    
        - name: Install pre setup stuff
          ansible.builtin.apt:
            pkg: "{{ docker_pre_apks }}"
            update_cache: true
            state: present
    
        - name: Add gpg for docker repo
          ansible.builtin.apt_key:
            url: https://download.docker.com/linux/debian/gpg
            state: present
          when: (ansible_distribution == 'Debian' and ansible_distribution_major_version <= '12')
    
        - name: Copy up apt list
          ansible.builtin.apt_repository:
            repo: "deb [arch={{ docker_arch }}] https://download.docker.com/linux/debian {{ ansible_distribution_release }} stable"
            state: present
            filename: docker
          when: (ansible_distribution == 'Debian' and ansible_distribution_major_version <= '12')
    
        - name: Setup deb822 formatted repositorie
          ansible.builtin.deb822_repository:
            name: php
            types: deb
            uris: https://download.docker.com/linux/debian
            components: stable
            suites: "{{ ansible_distribution_release }}"
            signed_by: https://download.docker.com/linux/debian/gpg
            state: present
            enabled: true
          when: (ansible_distribution == 'Debian' and ansible_distribution_major_version >= '13')
    
        - name: Install docker
          ansible.builtin.apt:
            pkg: "{{ docker_apks }}"
            force_apt_get: yes
            update_cache: yes
            state: present
    
        - name: Start docker service
          ansible.builtin.service:
            name: docker
            enabled: yes
            state: started
    
    PLAY [Install Docker Engine and Docker Compose on Debian (Ansible WebUI compatible)] ***
    
    TASK [Gathering Facts] *********************************************************
    [WARNING]: Host 'anytype.lab' is using the discovered Python interpreter at '/usr/bin/python3.13', but future installation of another Python interpreter could cause a different interpreter to be discovered. See https://docs.ansible.com/ansible-core/2.19/reference_appendices/interpreter_discovery.html for more information.
    ok: [anytype.lab]
    
    TASK [Install pre setup stuff] *************************************************
    changed: [anytype.lab]
    
    TASK [Add gpg for docker repo] *************************************************
    skipping: [anytype.lab]
    
    TASK [Copy up apt list] ********************************************************
    skipping: [anytype.lab]
    
    TASK [Setup deb822 formatted repositorie] **************************************
    changed: [anytype.lab]
    
    TASK [Install docker] **********************************************************
    [ERROR]: Task failed: Module failed: No package matching 'docker-ce' is available
    Origin: /tmp/ansible-webui/repositories/1_ansibleplaybooksrepo/playbooks/debian13docker.yml:59:7
    
    57       when: (ansible_distribution == 'Debian' and ansible_distribution_major_version >= '13')
    58
    59     - name: Install docker
             ^ column 7
    
    fatal: [anytype.lab]: FAILED! => {"changed": false, "msg": "No package matching 'docker-ce' is available"}
    
    PLAY RECAP *********************************************************************
    anytype.lab                : ok=3    changed=2    unreachable=0    failed=1    skipped=2    rescued=0    ignored=0   
    
    

    i have NO idea what i am doing wrong. this is new to me. but i personally learn better with practical examples rather than reading books and documentation. i thought setting up docker was simple enough to begin… i guess i was wrong.

    • Matt The Horwood
      link
      fedilink
      English
      arrow-up
      2
      ·
      3 months ago

      How very odd, as root can you try some things?

      1. Can you cat the apt config? File is /etc/apt/sources.d/php not sure of the file extension, but should have the config to collect docker

      Also if you run apt install docker-ce does it give you any better errors?

      • audricd@lemmy.mlOP
        link
        fedilink
        English
        arrow-up
        1
        ·
        3 months ago

        thank you very much for your continued support!

        i am not sure which file you are referring to. this is tree from /etc/apt:

        root@anytype:/etc/apt# tree
        .
        |-- apt.conf.d
        |   |-- 01autoremove
        |   |-- 20listchanges
        |   `-- 70debconf
        |-- auth.conf.d
        |-- keyrings
        |-- listchanges.conf
        |-- listchanges.conf.d
        |-- preferences.d
        |-- sources.list.d
        |   `-- debian.sources
        `-- trusted.gpg.d
            |-- debian-archive-bookworm-automatic.asc
            |-- debian-archive-bookworm-security-automatic.asc
            |-- debian-archive-bookworm-stable.asc
            |-- debian-archive-bullseye-automatic.asc
            |-- debian-archive-bullseye-security-automatic.asc
            |-- debian-archive-bullseye-stable.asc
            |-- debian-archive-trixie-automatic.asc
            |-- debian-archive-trixie-security-automatic.asc
            `-- debian-archive-trixie-stable.asc
        

        its been clear for awhile now that the script is doing pretty much nothing: because, as you can see: even the keyrings directory is empty, so its not even able the repo, hence it cant find docker-ce. im not sure where it fails. if downloading the asc file, dearmoring, adding repo…

        as you can see im running as root by the way, so no need to become.

        how do you suggest i debug this? sorry for my total lack of knowledge.

        • Matt The Horwood
          link
          fedilink
          English
          arrow-up
          2
          ·
          3 months ago

          Well I can’t see either docker or my missed named php file in that, so would concur that it’s not working.

          Your playbooks look to be run as root, so it should have placed a file or 2.

          Will re-read all the comments and see if I can spot anything

        • Matt The Horwood
          link
          fedilink
          English
          arrow-up
          2
          ·
          3 months ago

          Might have found your issue, please remove all delegate_to lines. That’s not how it works

          • audricd@lemmy.mlOP
            link
            fedilink
            English
            arrow-up
            1
            ·
            3 months ago

            my latest / current version doesnt have that anymore (ive been through a lot of constant revisions…)

            ---
            - name: Install Docker Engine and Docker Compose on Debian (Ansible WebUI compatible)
              hosts: all
              become: true
              become_user: root
            
              vars:
                docker_pre_apks:
                  - apt-transport-https
                  - ca-certificates
                  - curl
                  - gnupg2
                  - libssl-dev
                  - python3-cffi-backend
                  - python3-pip
                  - libffi-dev
                  - python3-setuptools
                  - python3-nacl
                  - python3-jsondiff
                docker_apks:
                  - docker-ce
                  - docker-ce-cli
                  - containerd.io
                docker_arch: amd64
            
              tasks:
            
                - name: Install pre setup stuff
                  ansible.builtin.apt:
                    pkg: "{{ docker_pre_apks }}"
                    update_cache: true
                    state: present
            
                - name: Add gpg for docker repo
                  ansible.builtin.apt_key:
                    url: https://download.docker.com/linux/debian/gpg
                    state: present
                  when: (ansible_distribution == 'Debian' and ansible_distribution_major_version <= '12')
            
                - name: Copy up apt list
                  ansible.builtin.apt_repository:
                    repo: "deb [arch={{ docker_arch }}] https://download.docker.com/linux/debian {{ ansible_distribution_release }} stable"
                    state: present
                    filename: docker
                  when: (ansible_distribution == 'Debian' and ansible_distribution_major_version <= '12')
            
                - name: Setup deb822 formatted repositorie
                  ansible.builtin.deb822_repository:
                    name: php
                    types: deb
                    uris: https://download.docker.com/linux/debian
                    components: stable
                    suites: "{{ ansible_distribution_release }}"
                    signed_by: https://download.docker.com/linux/debian/gpg
                    state: present
                    enabled: true
                  when: (ansible_distribution == 'Debian' and ansible_distribution_major_version >= '13')
            
                - name: Install docker
                  ansible.builtin.apt:
                    pkg: "{{ docker_apks }}"
                    force_apt_get: yes
                    update_cache: yes
                    state: present
            
                - name: Start docker service
                  ansible.builtin.service:
                    name: docker
                    enabled: yes
                    state: started
            

            as a reminder: this is run (unsuccessfully) through ansible web-ui while that could be an issue, im confused the same setup was able to run a (simplier) nother playbook

            - name: install root ca certificate
              hosts: all
              gather_facts: yes
            
              tasks:
            
              - name: Copy custom CA certificate
                copy:
                  src: ../files/root_ca.crt
                  dest: /usr/local/share/ca-certificates/root_ca.crt
                  mode: '0644'
            
              - name: Update CA certificates
                command: update-ca-certificates
                register: ca_update
            

            im not making sense of this

            • Matt The Horwood
              link
              fedilink
              English
              arrow-up
              2
              ·
              3 months ago

              Ok, where in the world are you?

              I have time on a Tuesday evening UK time from 8pm where you could join me over Google meet, if that would be of help

              • audricd@lemmy.mlOP
                link
                fedilink
                English
                arrow-up
                1
                ·
                3 months ago

                wow that would be extremely kind of you!! im based in spain. im just one hour ahead of you. PMing you my google address