4.1 KiB
Running a public demo
A demo is obs-beacond watching a simulated fleet (scripts/fleet), with
demo sign-in turned on so anyone can look around without an account.
demo_signin: true
With it on, the sign-in page offers Look around. A demo visitor:
- sees everything an admin sees, Configure included, so the demo shows the whole product;
- changes nothing: obs-beacond answers every request from a demo session that isn't a GET or HEAD with 403 "This is the demo: it shows everything and changes nothing." Signing out is the one exception;
- isn't written to the audit log (a public demo's visitors would bury everything else in it). The session shows a Demo badge in the header.
The people who run the demo stay private: a visitor sees made-up accounts on Configure → Users and an empty audit log. Exports in Configure never include channel secrets, demo or not. Notes and acknowledgements you add while signed in as yourself carry your name, as they do anywhere.
Turning demo_signin off ends every demo session at its next check.
Never on a real fleet
Demo sign-in lets in anyone who can reach the page. Use it only on an obs-beacond whose agents are the simulator. The sign-in providers you configure still work beside it, so you can sign in as yourself to change the demo's settings. They're folded under Sign in as yourself, so visitors aren't invited to type real credentials into a demo.
Shape of a demo host
One container with no network at all (--network none) holds both
obs-beacond and the simulator, so nothing in it can reach anything else:
- obs-beacond listens on a unix socket in a folder the reverse proxy can
reach (
listen: unix:/run/demo/web.sock, formats.md). The agent API isn't on that socket. - The simulator's agents report to a loopback agent listener
(
agent_listen: 127.0.0.1:8461,agent_tls: {off: true}), and its stand-ins for Cloudflare, Akamai, mail, Vault, Patroni and the alert channels answer on the container's own loopback. fleet config -demowrites the server's pieces;fleet run -demoruns the fleet (add-ibmi 4for IBM i and the HMC). Start the fleet first so its stand-ins are up for obs-beacond's first readings.fleet run -history <database> -state-key <obs-beacond's state key>first writes the last 30 days into obs-beacond's (SQLite) database, so the graphs, reports and incident history aren't empty on a fresh demo (below). It takes under a minute, before the stand-ins start, so wait for them that long; it leaves a database that already has history alone.- The root is read-only and the state is in tmpfs, so restarting the container is a fresh demo; restart it on a timer (weekly is plenty) so history doesn't pile up.
What a visitor sees
Most of the simulated fleet is healthy. What's wrong follows a plan
(scripts/fleet/scenario.go, and "The demo fleet" in development.md):
three stories with a cause and its effects, a few lasting warnings, and
problems that come and go through the day, so incidents open, resolve and
show up under Recently resolved. Each comes round about on a schedule but
not like a clock: its start and length vary, and it skips about half its
turns, four in five at night in Phoenix, so the history has a working
day's shape, about 1,400 incidents a month rather than thousands, and in
the day there's never an hour with nothing going on. Because the plan
runs on the clock, two visitors an hour apart see different problems, and
a restarted demo shows the same ones the old one would have.
The demo starts with a month behind it, worked out from the same plan and
clock (scripts/fleet/history.go): every host's hourly CPU, memory and
disks (a working day in its site's time zone, quieter weekends, memory
that creeps until a weekly restart, disks that fill until a clean-up), the
clusters' nodes (and a week of their controllers and VMs, to keep the
database small), the arrays' I/O, the IBM i partitions' CPU, the
Vaults' leases, the mail monitor's rounds, availability for the reports,
and an incident for each time a problem came and went, with notes on the
stories saying what the cause was. Its incident numbers carry on from
there.