Ansible Role: Traefik-docker

Install Traefik Docker Compose project.

• https://traefik.io/traefik/
• https://doc.traefik.io/traefik/

Requirements

Requires the following to be installed:

• docker
• docker compose

Role Variables

Common Docker projects variables:

# Base directory for Docker projects
docker_projects_path: # /var/apps

Available role variables are listed below, along with default values (see defaults/main.yml):

# Docker project variables

traefik_project_name: traefik

# Docker project dynamic vars (uses `docker_project_name` prefix, adapt if overridden)

# Project network mode
traefik_network_mode: bridge

# Additional external docker-compose networks, joined by main service
traefik_additional_networks: []
#  - example_default

traefik_traefik_router_service: api@internal
traefik_traefik_entrypoints: http,https
traefik_traefik_middlewares:
  - "internal-access@file"


# Traefik project variables

traefik_version: 3.6

traefik_logs_path: "{{ docker_project_path }}/logs"

traefik_cert_base_src:   # ex: /etc/letsencrypt/live
traefik_cert_domains: [] # ex: [ my-domain.net, other-domain.net ]

# Label used by other services to indicate subdomain to use when relying on default routing
# see: *_traefik_subdomain vars usage
# see: djuuu.docker_project - tasks/_init-vars.yml
traefik_subdomain_label_key: "traefik.subdomain"

traefik_cli_arguments: []

traefik_plugins: []

# Networks allowed through the 'internal-access@file' middleware (CIDR)
traefik_internal_networks: []
#  - { net: '192.168.1.0/24', comment: 'IPV4 local subnet' }
#  - { net: '2001:db8::/60',  comment: 'IPv6 example subnet' }

# Users allowed through the 'basic-auth@file' middleware (htpasswd strings)
traefik_basicauth_users: []
# - "example:$apr1$aLpmRU6d$ZrSfA1TGPFlpHZxGPB2re1"

Additional config files

Additional files located in config/traefik/{{ inventory_hostname }} will be copied in the project main directory.

This is especially useful to add dynamic configuration files.

Ex:

• config/traefik/
  • my-host/
    • dynamic-conf/
      • services/
        • some-service.yml
        • other-service.yml
      • middlewares/
        • custom-middleware.yml

Dependencies

This role depends on :

• djuuu.docker_project

Example Playbook

- hosts: all
  gather_facts: false
  roles:
    - djuuu.traefik_docker

License

Beerware License