marchon/master-zapier-plan-draft
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
master-zapier-plan-draft/packages/verae-ops
History
George Lambert a73875f4ef
Some checks are pending
offline / test (push) Waiting to run
Details
Cut the test environment over to the 3-node Proxmox NATS cluster. 
Fleet/keep/middleware NATS_URL lists 10.10.10.21–23. Product streams
are replicas=3. px-worker worm/tree run on that cluster. Backup timer
and px-worker uptime watch are on. MOCK_VERAE and Zapier push unchanged.
2026-09-11 23:59:38 -04:00
..
caddy Fix catalog book links and rewrite PDF destinations to live HTTPS. 2026-09-11 22:50:00 -04:00
01-dependencies.md Document catalog host moves and add per-module host-deps installer. 2026-09-11 23:12:25 -04:00
02-docker.md Document every repo in Sphinx, catalog PDFs, and verae-ops 2026-09-11 14:36:17 -04:00
03-proxmox.md Add a three-node NATS JetStream cluster on distinct Proxmox LXC guests. 2026-09-11 23:47:42 -04:00
04-virtual-servers.md Document every repo in Sphinx, catalog PDFs, and verae-ops 2026-09-11 14:36:17 -04:00
05-dedicated-hardware.md Put zapier.georgelambert.org service names on Caddy. 2026-09-11 20:04:57 -04:00
06-linking-services.md Document every repo in Sphinx, catalog PDFs, and verae-ops 2026-09-11 14:36:17 -04:00
07-maintenance.md Add Proxmox worker CT, off-box watch, backup, and tagged deploy. 2026-09-11 23:35:44 -04:00
docker-compose.yml Separate Zapier, web, API, and leaf access planes with NATS authz 2026-09-11 16:05:05 -04:00
GETTING-STARTED.md Cut the test environment over to the 3-node Proxmox NATS cluster. 2026-09-11 23:59:38 -04:00
NATS.md Document every repo in Sphinx, catalog PDFs, and verae-ops 2026-09-11 14:36:17 -04:00
package.json Document every repo in Sphinx, catalog PDFs, and verae-ops 2026-09-11 14:36:17 -04:00
README.md Restyle staff and console UIs; add UI-Docs walkthrough and review PDF. 2026-09-11 18:01:33 -04:00
SUMMARY.md Document every repo in Sphinx, catalog PDFs, and verae-ops 2026-09-11 14:36:17 -04:00

README.md

verae-ops — install, run, maintain

How to stand up Verae Time × Zapier on Docker, Proxmox, generic VMs, or dedicated hardware, and how to link dependent services.

Forgejo: https://git.georgelambert.org/marchon/verae-ops
Clone: ssh://git@git.georgelambert.org:2223/marchon/verae-ops.git
Catalog: https://zapier.georgelambert.org/packages/verae-ops/README.pdf
System map: https://zapier.georgelambert.org/overview/README.pdf

This is the operations repo. Application code lives in the other independent git repositories.

Reading order

  1. GETTING-STARTED.md — install, first-up, monitor (read this first)
  2. 01-dependencies.md — what must exist, who talks to whom
  3. 02-docker.md — Compose (NATS 3-node cluster + HTTPS edges)
  4. 03-proxmox.md — LXC / QEMU VMs
  5. 04-virtual-servers.md — cloud or hypervisor VMs
  6. 05-dedicated-hardware.md — bare metal (NS1-style)
  7. 06-linking-services.md — env vars, URLs, replica floors
  8. 07-maintenance.md — upgrade, backup, fleet, NATS

Public PDFs of the same files: https://zapier.georgelambert.org/packages/verae-ops/<name>.pdf.

Non-negotiables

Rule Why
Zapier cloud → HTTPS only (zappier-edge) Never NATS, never api.veraetime.net
NATS binds loopback or a private docker/VM net Not on the public NIC
Tree-node min 3, pause does not count Bulk Merkle lookups
Private keys stay on disk; git stores paths machines.json identityFile
Operator console HTTP binds 0.0.0.0:3850 Not a public NATS bus; NATS stays private

Quick lab (one machine)

git clone ssh://git@git.georgelambert.org:2223/marchon/verae-ops.git
cd verae-ops
docker compose up --build

Then: zappier http://127.0.0.1:3000/ middleware http://127.0.0.1:3100/health NATS monitoring http://127.0.0.1:8222/

Production layout is three NATS nodes + fleet-spread workers; see 02-docker.md and 05-dedicated-hardware.md.