README

README.md

@@ -0,0 +1,34 @@
+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):
+
+```yaml
+  - 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.