merchant: document selfbuild webui/merchant deploy

This commit is contained in:
Hernâni Marques 2026-07-18 14:32:29 +02:00
parent 14bee9f1ec
commit f4b556c3c0
No known key found for this signature in database

View file

@ -30,6 +30,27 @@ Automatic import needs:
SMS backends are symlinks into `/var/taler-src/...` (not copied).
## Self-build deploy (webui tag + merchant master)
From a laptop with `ssh koopa` + `pnpm`/`node` (e.g. clementine):
```bash
cd ~/src/koopa/koopa-admin-log
chmod +x scripts/taler-merchant/build-deploy-webui-1.6.11-merchant-master.sh
./scripts/taler-merchant/build-deploy-webui-1.6.11-merchant-master.sh
```
What it does:
1. **Clone** `taler-typescript-core` **tag `v1.6.11`**, build SPA, install into
`taler-hacktivism:/usr/share/taler-merchant-webui` (backup `…bak-selfbuild-*`).
2. **Inside the container:** update `/var/taler-src/merchant` to **master**,
`./bootstrap && ./configure --prefix=/usr && make && make install`.
3. **`start_merchant.sh --restart`** + smoke `/config` + `/webui/`.
Env knobs: `SKIP_WEBUI=1`, `SKIP_MERCHANT=1`, `SKIP_RESTART=1`,
`WEBUI_TAG=…`, `MERCHANT_REF=master`, `KOOPA_SSH=koopa`.
## Portal / instance IDs: **lowercase only**
Merchant SPA (`/webui/`) and `/instances/{id}/…` require **lowercase** instance