1
0
Fork 0
No description
Find a file
2024-10-18 16:26:33 +01:00
defaults quant-ux: new role 2024-02-02 14:17:44 +00:00
tasks quant-ux: new role 2024-02-02 14:17:44 +00:00
templates when binding to local ports, don't also route via traefik-docker labels 2024-10-18 16:26:33 +01:00
README.md README 2024-02-02 14:35:05 +00:00

An Ansible role to deploy Quant-UX in (Docker) containers, with (optional) Traefik integration.

Requires

On the controller:

  • Ansible
  • This role

On the target machine:

  • Docker, including 'docker compose' command
  • Traefik configured to watch for Docker containers (optional)

Brief Instructions

Download and store the role where your Ansible configuration can find it, either using ansible-galaxy or manually.

Include the role in your playbook. Set the required variables, and any optional variables, in your inventory or with the 'vars' keyword. All required and optional variables are listed in 'defaults/main.yml'.

Example (in 'roles' section in an Ansible playbook):

  - role: quant-ux-docker-ansible
    vars:
      qux_domain: qux.example
      qux_jwt_password: at_least_24_random_characters

Routing, Traefik, Bind Ports

This role puts Traefik labels on the containers, so that if Traefik is configured to watch for Docker containers, Traefik will read the labels and configure its routing.

Alternatively, you can set the qux_*_bind_port variables to bind the container entry-points to host ports, and optionally configure your own reverse-proxy to route to them.