https://github.com/39services/ansible_role_docker

Ansible role to install Docker
https://github.com/39services/ansible_role_docker

Last synced: 25 days ago
JSON representation

Ansible role to install Docker

• Host: GitHub
• URL: https://github.com/39services/ansible_role_docker
• Owner: 39services
• License: mit
• Created: 2023-05-09T10:17:50.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-06-07T11:28:36.000Z (7 months ago)
• Last Synced: 2024-12-06T12:13:05.422Z (about 1 month ago)
• Size: 73.2 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Ansible Role Docker

=========

[![Molecule Test](https://github.com/diademiemi/ansible_role_docker/actions/workflows/molecule.yml/badge.svg)](https://github.com/diademiemi/ansible_role_docker/actions/workflows/molecule.yml)

This is an Ansible role to install and configure docker.

Include more information about docker in this section.

Requirements

------------

These platforms are supported:

- Ubuntu 20.04

- Ubuntu 22.04

- Debian 11

- Debian 12

- EL 8 (Tested on Rocky Linux 8)

- EL 9 (Tested on Rocky Linux 9)

- Fedora 40

- openSUSE Leap 15.5

Role Variables

--------------

Variable | Default | Description

--- | --- | ---

`docker_add_users_to_group` | `true` | Whether to add users to `docker` group

`docker_users` | `[{{ ansible_user_id }}]` | Users to add to Docker group

`docker_packages` | See [vars/](./vars) | Packages to install

`docker_uninstall_old_packages` | See [vars/](./vars) | Which packages to install when `__role_action` is `uninstall_old`

`docker_el_os_name` | See [vars/](./vars) | Repository name for RHEL-based Linux operating systems

`docker_install_pip_packages` | `true` | Whether to the Docker Python package

`docker_pip_global_packages` | See [vars/default.yml](./vars/default.yml) | Global Python packages to install

Dependencies

------------

None

`diademiemi.python` collection when `docker_install_pip_packages` is `true`

Example Playbook

----------------

```yaml

- name: Use diademiemi.docker role

  hosts: "{{ target | default('docker') }}"

  roles:

    - role: "diademiemi.docker"

      vars:

        __role_action: "setup"  # Variable to control which tasks are ran, default is "setup"

        # __role_action: "uninstall_old" # Uncomment to uninstall old packages

      tags: ['diademiemi', 'docker', 'setup']    ```

```

License

-------

MIT

Author Information

------------------

- diademiemi (@diademiemi)

Role Testing

------------

This repository comes with Molecule that run in Podman on the supported platforms.

Install Molecule by running

```bash

pip3 install -r requirements.txt

```

Run the tests with

```bash

molecule test

```

These tests are automatically ran by GitHub Actions on push. If the tests are successful, the role is automatically published to Ansible Galaxy.