TELEICU/Site onboarding flow - Revision history

Admin: Fix 2 Mermaid diagrams: remove

 wrapping (via update-page on MediaWiki MCP Server)

2026-07-06T03:22:17Z

Fix 2 Mermaid diagrams: remove <pre> wrapping (via update-page on MediaWiki MCP Server)

← Older revision		Revision as of 08:52, 6 July 2026
Line 18:		Line 18:
	== Path A: Ansible ==		== Path A: Ansible ==

	<pre>
	{{#mermaid:flowchart TB		{{#mermaid:flowchart TB
	OS["Install Ubuntu LTS<br/>(manual or netboot)"]		OS["Install Ubuntu LTS<br/>(manual or netboot)"]
Line 30:		Line 29:
	OS --> TS --> REG --> PULL --> K3S --> MID --> MON		OS --> TS --> REG --> PULL --> K3S --> MID --> MON
	}}		}}
	</pre>

	# Install Ubuntu LTS (20.04, 22.04, or 24.04 — target consistent via ansible later)		# Install Ubuntu LTS (20.04, 22.04, or 24.04 — target consistent via ansible later)
Line 42:		Line 40:
	== Path B: NixOS ==		== Path B: NixOS ==

	<pre>
	{{#mermaid:flowchart TB		{{#mermaid:flowchart TB
	ISO["Boot nixos-generator ISO<br/>(pre-configured tunnel)"]		ISO["Boot nixos-generator ISO<br/>(pre-configured tunnel)"]
Line 54:		Line 51:
	ISO --> CONNECT --> ANYWHERE --> ZFS --> REBOOT --> K3S --> COMIN		ISO --> CONNECT --> ANYWHERE --> ZFS --> REBOOT --> K3S --> COMIN
	}}		}}
	</pre>

	# Boot the custom ISO (generated via nixos-generator with pre-configured tunnel credentials)		# Boot the custom ISO (generated via nixos-generator with pre-configured tunnel credentials)

Admin: Automated edit (via update-page on MediaWiki MCP Server)

2026-07-06T03:10:49Z

Automated edit (via update-page on MediaWiki MCP Server)

← Older revision		Revision as of 08:40, 6 July 2026
Line 72:		Line 72:
	- [ ] Downtime classifier agent reporting		- [ ] Downtime classifier agent reporting
	- [ ] [[Special:CargoTables/TeleicuSites\|TeleicuSites]] entry updated with migration status		- [ ] [[Special:CargoTables/TeleicuSites\|TeleicuSites]] entry updated with migration status

			{{Navbox TELEICU}}

	{{Related}}		{{Related}}

Admin: Create TELEICU site onboarding flow page (via create-page on MediaWiki MCP Server)

2026-07-06T02:56:01Z

Create TELEICU site onboarding flow page (via create-page on MediaWiki MCP Server)

New page

{{Doc header
|type=flow
|domain=teleicu
|title=Site onboarding flow
|order=22
}}

Step-by-step process for adding a new hospital site to the TELEICU K3s cluster.

== Pre-requisites ==

- [ ] Hardware deployed and powered on
- [ ] UPS connected and functional
- [ ] Internet connectivity verified (minimum bandwidth TBD)
- [ ] Tailscale pre-authorization key generated
- [ ] Site registered in [[Special:CargoTables/TeleicuSites|TeleicuSites]] table

== Path A: Ansible ==

<pre>
{{#mermaid:flowchart TB
OS["Install Ubuntu LTS (manual or netboot)"]
TS["Install & configure Tailscale"]
REG["Register to Tailscale mesh"]
PULL["Configure ansible-pull timer + cron"]
K3S["K3s agent joins control plane"]
MID["Middleware workloads deployed via K3s"]
MON["Monitoring agent starts reporting"]

OS --> TS --> REG --> PULL --> K3S --> MID --> MON
}}
</pre>

# Install Ubuntu LTS (20.04, 22.04, or 24.04 — target consistent via ansible later)
# Install Tailscale using the bootstrap script
# Register the node with the Tailscale mesh using a pre-authentication key
# Deploy <code>ansible-pull</code> with a systemd timer (every 15 min)
# ansible-pull applies the K3s agent role → node joins the cluster
# Middleware workloads are scheduled onto the node by the control plane
# Monitoring agent starts reporting to VictoriaMetrics

== Path B: NixOS ==

<pre>
{{#mermaid:flowchart TB
ISO["Boot nixos-generator ISO (pre-configured tunnel)"]
CONNECT["Tunnel connects to Cloudflare / Tailscale"]
ANYWHERE["nixos-anywhere over tunnel"]
ZFS["ZFS partitions via disko NixOS installed"]
REBOOT["Reboot into NixOS"]
K3S["K3s agent auto-joins control plane"]
COMIN["comin starts polling for updates"]

ISO --> CONNECT --> ANYWHERE --> ZFS --> REBOOT --> K3S --> COMIN
}}
</pre>

# Boot the custom ISO (generated via nixos-generator with pre-configured tunnel credentials)
# ISO connects to Cloudflare Tunnel and/or Tailscale automatically
# From the bootstrap environment, run <code>nixos-anywhere</code> over the tunnel to the target disk
# <code>nixos-anywhere</code> partitions the disk (ZFS via disko), installs NixOS
# Node reboots into the NixOS generation — Tailscale and K3s agent start automatically
# K3s agent registers with the control plane
# comin starts polling the flake repo for configuration updates

== Post-onboarding verification ==

- [ ] Node shows Ready in <code>kubectl get nodes</code>
- [ ] Tailscale status shows connected to mesh
- [ ] Middleware health endpoints respond
- [ ] Metrics flowing to VictoriaMetrics
- [ ] Downtime classifier agent reporting
- [ ] [[Special:CargoTables/TeleicuSites|TeleicuSites]] entry updated with migration status

{{Related}}