ansible-taler-exchange

Ansible playbook to deploy a production Taler Exchange
Log | Files | Refs | README | LICENSE

README.md (1506B)

      1 # Role `hacktivism_goa`
      2 
      3 Event currency **GOA** for hacktivism, structured like
      4 `taler-deployment/regional-currency/setup-exchange.sh`, **with systemd**.
      5 
      6 ## Requirements
      7 
      8 - Container PID1 = **systemd** (`./run-container-koopa.sh`)
      9 - Host port **9011** only; TLS on host Caddy
     10 - Bank already at `bank.hacktivism.ch` (x-taler-bank wire gateway)
     11 
     12 Snapshot / `sleep infinity` images are **rejected** (`require_systemd: true`).
     13 
     14 ## Flow
     15 
     16 | Step | regional-currency | this role |
     17 |------|-------------------|-----------|
     18 | packages | apt exchange/postgres | `packages.yml` |
     19 | config | `conf.d/setup.conf` + wire secret | `site_config.yml` + GOA overrides |
     20 | coins | `taler-harness gen-coin-config` | static GOA ladder by default |
     21 | db | `taler-exchange-dbconfig` | `db.yml` |
     22 | start | `systemctl restart taler-exchange.target` | `start.yml` |
     23 | offline | `taler-exchange-offline` + timer | `offline.yml` if `do_offline` |
     24 | health | `/config` `/keys` | `health.yml` |
     25 | conversion | optional nexus/IBAN | **not supported** |
     26 
     27 ## GOA specifics (host_vars)
     28 
     29 - `CURRENCY=GOA`, `CURRENCY_ROUND_UNIT=GOA:0.00000001`
     30 - `SERVE=tcp` `PORT=9011`
     31 - `exchange_account_id: "1"` (live name; set `default` for pure regional)
     32 - `use_static_goa_coins: true`
     33 - `do_offline: false` until offline master key is available in-container
     34 
     35 ## Usage (koopa)
     36 
     37 ```bash
     38 cd ~/ansible-taler-exchange
     39 ./run-container-koopa.sh    # rebuilds systemd container (replaces current)
     40 ./deploy-hacktivism-goa.sh  # ansible → systemctl path
     41 ```