add renew_anon_volumes parameter to docker compose up

[z-bsod]

SUMMARY

Add a variable for the docker compose up parameter renew_anon_volumes to recreate anonymous volumes when recreating containers on docker compose up

ISSUE TYPE

• Feature Pull Request

COMPONENT NAME

docker_compose_v2

ADDITIONAL INFORMATION

As far as I am aware there was no way to set this option using the community.docker collection before

usage example:

    - name: Start compose environment and renew anon volumes
      community.docker.docker_compose_v2:
        project_src: compose
        renew_anon_volumes: true
        state: present

output of example playbook in test repository

% ansible-playbook test.yml
[WARNING]: No inventory was parsed, only implicit localhost is available
[WARNING]: provided hosts list is empty, only localhost is available. Note that the implicit localhost does not match
'all'

PLAY [localhost] ******************************************************************************************************

TASK [Gathering Facts] ************************************************************************************************
ok: [localhost]

TASK [Build images] ***************************************************************************************************
ok: [localhost] => (item=1)
ok: [localhost] => (item=2)
ok: [localhost] => (item=3)

TASK [Start compose with image version 1] *****************************************************************************
changed: [localhost]

TASK [create file in image] *******************************************************************************************
changed: [localhost]

TASK [get folder contents] ********************************************************************************************
changed: [localhost]

TASK [Output folder contents] *****************************************************************************************
ok: [localhost] => {
    "folder.stdout": "total 0\n-rw-r--r-- 1 root root 0 Oct 17 06:51 image_v1"
}

TASK [start image with image version 2] *******************************************************************************
changed: [localhost]

TASK [get folder contents of v2 container] ****************************************************************************
changed: [localhost]

TASK [Output folder contents] *****************************************************************************************
ok: [localhost] => {
    "folder.stdout": "total 0\n-rw-r--r-- 1 root root 0 Oct 17 06:51 image_v1"
}

TASK [start image with image version 3 and cleanup parameter] *********************************************************
changed: [localhost]

TASK [get folder contents of v3 container] ****************************************************************************
changed: [localhost]

TASK [Output folder contents] *****************************************************************************************
ok: [localhost] => {
    "folder.stdout": "total 0"
}

PLAY RECAP ************************************************************************************************************
localhost                  : ok=12   changed=7    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   

ansible-playbook test.yml  4,59s user 2,84s system 25% cpu 28,629 total
 

[felixfontein]

Thanks for your contribution! Can you please add a changelog fragment? Thanks.

[felixfontein]

Thanks for applying the changes. Please do not forget about the changelog fragment :)

[z-bsod]

Ah, I misunderstood and thought the version number in the Documentation was a changelog fragment.

After looking up what a changelog fragment is, I added one and hope it's correct this way.

[felixfontein]

@z-bsod thanks for your contribution! :)