playbooks

Traffic Billing Stack

The traffic billing stack now has a single aggregate playbook:

deploy_traffic_billing_stack.yml

It orchestrates these existing playbooks in dependency order:

deploy_xray_exporter.yml
deploy_billing_service.yml
deploy_accounts_svc_plus.yml
deploy_console_svc_plus.yml
deploy_agent_svc_plus.yml

Full stack deploy

cd /Users/shenlan/workspaces/cloud-neutral-toolkit/playbooks
export INTERNAL_SERVICE_TOKEN=...
export DATABASE_URL=postgres://...
export FRONTEND_IMAGE=ghcr.io/x-evor/dashboard:latest
ansible-playbook -i inventory.ini deploy_traffic_billing_stack.yml

Deploy to one target host directly

Use STACK_TARGET_HOST to override all service host groups with one inventory host.

cd /Users/shenlan/workspaces/cloud-neutral-toolkit/playbooks
export STACK_TARGET_HOST=jp-xhttp-contabo.svc.plus
export INTERNAL_SERVICE_TOKEN=...
export DATABASE_URL=postgres://...
export FRONTEND_IMAGE=ghcr.io/x-evor/dashboard:latest
ansible-playbook -i inventory.ini deploy_traffic_billing_stack.yml

Deploy only selected services

Use STACK_SERVICES with a comma-separated list:

xray-exporter
billing-service
accounts
console
agent

cd /Users/shenlan/workspaces/cloud-neutral-toolkit/playbooks
export STACK_TARGET_HOST=jp-xhttp-contabo.svc.plus
export STACK_SERVICES=xray-exporter,billing-service,agent
export INTERNAL_SERVICE_TOKEN=...
export DATABASE_URL=postgres://...
ansible-playbook -i inventory.ini deploy_traffic_billing_stack.yml

Notes

accounts and console still use their existing role contracts.
console requires FRONTEND_IMAGE because the target host only does pull-only compose deployment.
console now writes a Caddy fragment named like <server-name>-<release_id>-<hostname>-<domain>.caddy instead of managing the Caddy service container itself.
billing-service requires DATABASE_URL.
xray-exporter and agent require INTERNAL_SERVICE_TOKEN.

Deploy console to a specific host and sync DNS

deploy_console_svc_plus.yml now accepts two useful overrides:

console_service_target_host: inventory host to deploy to, for example jp_xhttp_contabo_host
console_service_sync_dns=true: rebuild and reconcile DNS records for that target host after deployment

Example:

cd /Users/shenlan/workspaces/cloud-neutral-toolkit/playbooks
ansible-playbook -i inventory.ini deploy_console_svc_plus.yml \
  -e console_service_target_host=jp_xhttp_contabo_host \
  -e console_service_sync_dns=true \
  -e FRONTEND_IMAGE=ghcr.io/x-evor/dashboard:latest

2.6 KiB Raw Blame History