Docker Container

Deploy docker containers on Ubuntu 24.04.

Requirements

Docker engine must be insalled on the host this role will run on.

Role Variables

The following variables will be equivalent to docker.io/ubuntu/nginx:latest.

Docker registry base url (default: docker.io):
docker_container_registry: docker.io

Docker rebpository namespace (default: ""):
docker_container_repository_namespace: ubuntu

Docker repository name (default: ubuntu):
docker_container_repository_name: nginx

Docker container tag (default: latest):
docker_container_repository_tag: latest

Docker container options to pass to docker run command (default: undefined):
docker_container_run_options: "-p 8080:8080"

Default image: docker.io/ubuntu:latest.

Dependencies

No dependencies.

Example Playbook

---
- hosts: goapp

  vars:
    docker_container_registry: docker.io
    docker_container_repository_name: ubuntu
    docker_container_repository_tag: latest
    docker_container_run_options: "-p 8080:8080"

  pre_tasks:
    - name: Update apt cache.
      ansible.builtin.apt:
        update_cache: true
        cache_valid_time: 86400

  roles:
    - role: cuqmbr.docker_container

TODO

Add support for other Linux distrubitions:

• RHEL: Almalinux, RockyLinux 9 and 8
• Debian: Debian 12 and 11, Ubuntu 24.04 and 22.04
• Archlinux

Make role more generic:

• Add dockerd parameters configuration
• Add docker container run parameters configuration