tripleawwy.traefik_docker

Ansible role containerized Traefik

Table of Contents

About The Project

This project aims to easily provision the reverse proxy Traefik with Ansible and Docker.

Built With

Getting Started

The following instructions will guide you trough requirements needed for this Ansible role to run.

Requirements

The remote host needs to have Docker installed. No other requirements are necessary.

Role Variables

Dependencies

  • ansible-core >= v2.13.5
  • community.docker >= v3.0.0

Usage

You'll need to install the Ansible role.

  • e.g. by using the requirements file.

    # requirements.yml
      - src: tripleawwy.traefik_docker
        version: v1.0.0
    
    ansible-galaxy install -r requirements.yml
    
  • or via Ansible Galaxy directly

    ansible-galaxy install tripleawwy.traefik_docker
    

Example Playbook

The following Playbook provisions Traefik with a default Traefik certificate on localhost

---
- name: Example
  hosts: localhost
  become: true
  vars:
    traefik_dashboard_enabled: "true"
    traefik_log_level: "DEBUG"
    traefik_labels:
      traefik.enable: "true"
      traefik.http.routers.traefik_api.rule: "{{ traefik_api_rule }}"
      traefik.http.routers.traefik_api.entrypoints: "web_secure"
      traefik.http.routers.traefik_api.service: "api@internal"
      traefik.http.routers.traefik_api.tls: "true"
  tasks:
    - name: "Include traefik_docker role"
      ansible.builtin.include_role:
        name: "tripleawwy.traefik_docker"

Testing

Tests are done with Molecule with the help of Vagrant and Virtual Box. You can find more detailed requirements here.

If your test environment is set up:

molecule test

Contributing

Feel free to open issues, pull requests or ask me anything directly!

Author Information

tripleawwy

License

MIT

Detailed information: https://choosealicense.com/licenses/mit/

Acknowledgements

About

This role deploys Traefik with the help of Docker

Install
ansible-galaxy install tripleawwy.traefik_docker
GitHub repository
License
Unknown
Downloads
288
Owner