authoravatarclover caruso<git@paperclover.net>2026-10-16 17:17:54-07:00
committeravatarclover caruso<git@paperclover.net>2026-10-21 02:52:29-07:00
log0786e0d038ecc3beecd8b582a082e679bd86f88b
tree0f98b72f8c41eba863cb008bc31e768a5993dd50
parentfa5832d9995e457115a50395949d4f2cb63df265
signature Signed by SSH key SHA256:52mNGHRsVFBDED9IAX5pe+LRWUefqTbxEReunq21QvU

Retire legacy infrastructure tooling and make Snow Globe staging-first

Rename maintained tooling, runtime namespaces, and host configuration to Snow Globe. Preserve existing control state, numeric owners, VM metadata, telemetry history, and immutable-release rollback through a bounded transition. Remove completed migration/import tooling, retired services, exclusion plumbing, and the obsolete dashboard development runner. Consolidate current hardware, recovery, and operations guidance. Add isolated dashboard previews, infer SSO issuer routing, and inherit Pkl resource defaults. Stop the retired VM window experiment proxy before renaming the dashboard identity. Assisted-by: gpt-6.1-sol

235 files changed, 4176 insertions(+), 11526 deletions(-)

AGENTS.md+119-181
...@@ -1,182 +1,120 @@...@@ -1,182 +1,120 @@
1# Snow Globe infrastructure1# Snow Globe
22
3This repo runs Clover's home server: her creative file store, shared apps, and3Snow Globe is Clover's physical home computer: NixOS, Nomad/Podman services,
4virtual machines. NixOS provides the host; Nomad schedules Podman containers;4ZFS storage, and virtual machines. Pkl describes services; the Rust/Solid
5Pkl describes services; the Rust/Solid dashboard manages the system. Treat5web app manages the system. Availability and existing data are part of correctness.
6availability and existing data as part of correctness.6
77## Default workflow
8## Access and authorization8
99Finish a requested change through verification without another permission round:
10- Local edits and staging previews on Zenith are always implied by a task.10
11 Carry them through verification without asking for permission again. Use111. Inspect the current code, Jujutsu state, and relevant service/runbook.
12 disposable preview data for writes and keep active production services intact.122. Implement the change and run the checks that cover it.
13- Production changes require a request to take the work to prod. A request to133. Automatically deploy the working changes to staging on Snow Globe:
14 fix, stage, test, or commit something does not authorize production deployment.14 `python3 tools/deploy.py stage <service>` or `stage dashboard`.
15 Once prod is requested, complete the normal deployment workflow.154. Test the real preview: app behavior, authentication, persistence, dependencies,
16- Read-only infrastructure inspection over SSH is allowed for the task. Confirm16 logs/restarts, and effects on other services. For UI, use the normal browser
17 the target host before a remote mutation. Set both deployment host and port17 panel, check the keyboard, and capture screenshots or recordings.
18 explicitly; the CLI's legacy defaults still point at the rehearsal VM.185. Present the working preview URL and evidence. Keep it available for review.
19- Private file contents require authorization per source. Infrastructure access,19 Wait for Clover to request production promotion.
20 a mounted share, or permission to list a tree does not authorize opening its20
21 contents. Keep private material and derived model output inside its store.21A request to change, fix, test, stage, or commit does not authorize production.
22- Never print credentials or encryption keys into chat, command arguments,22Once Clover requests production, finish the normal deployment without asking
23 ordinary logs, or tracked files. Use existing private files or stdin for23again: put the reviewed changes on a described, conflict-free **main**, run
24 imports; keep secret files owner-readable only. Nomad variables own service24`python3 tools/deploy.py prod`, and verify the actual production paths and history.
25 secrets; configuration declares names and references, not values.25Production exports **main**; it never promotes a preview database or the working
26- Before destructive storage or OS work, require verified recovery: tested key26copy. Do not move main or push merely because a local commit was requested.
27 recovery and app/database restores, with at least two restricted copies stored27
28 separately off the server. Local snapshots and a key archive alone do not28Two surfaces use the real machine during iteration:
29 establish data recovery. Follow the linked cutover runbooks.29
30- Agent/model trials use disposable data and credentials, separated from the30- **Local AI:** deploy and test changes directly in production without waiting
31 personal archive and host credentials. A service preview may clone production31 for a separate promotion request. The physical GPU is required; do not start a
32 data and secrets; staging does not itself grant permission to inspect them.32 competing preview model. Use disposable prompts, credentials, and workspaces.
3333- **Virtual machines:** iterate on Snow Globe using disposable guests and disks.
34## Machines and paths34 Test actual guest/host integration and consoles. Preserve active personal
3535 guests; a VM task does not authorize unrelated guest or storage changes.
36| Surface | Connection / role | Configuration |36
37| --- | --- | --- |37Other service/dashboard changes follow staging first. Host/OS changes that cannot
38| Mac checkout | `/Users/clo/dev/infra-2`; edit and upload here | This working copy |38be exercised in a service preview need isolated host testing; see
39| Optional rehearsal NixOS VM | `root@127.0.0.1`, SSH port `2222` | `nixos/vm.nix`, `studio.test`, demo pool |39[host rehearsal](tools/rehearsal.md). Do not substitute an isolated test for
40| Zenith production | `root@10.0.0.1`, SSH port `22` | `nixos/zenith.nix`, `paperclover.net`, physical pool |40production verification after an authorized promotion.
4141
42`tools/deploy.py` reads `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT`; defaults42## Target and state
43are the rehearsal connection above. Set both explicitly for Zenith staging43
44and production. Prefer staging previews on Zenith for service and dashboard44The deployment CLI defaults to Snow Globe, `root@10.0.0.1`, SSH port `22`.
45verification; use the VM when host or guest isolation is required.45`SNOWGLOBE_DEPLOY_HOST` and `SNOWGLOBE_DEPLOY_PORT` override it; set both when targeting
46Host settings and dataset names have their canonical home in `nixos/zenith.nix`46another machine. Confirm the connected host before remote mutations.
47and `config/site.pkl`; inspect them instead of copying values into new tooling.47The configured hostname is `snowglobe`, with pretty name `snow globe`.
4848
49| Local / logical location | Remote location | Meaning |49| Path | Purpose |
50| --- | --- | --- |50| --- | --- |
51| Checkout release sources | `/opt/studio/releases/<digest>` | Uploaded, immutable release trees |51| `nixos/snowglobe.nix`, `config/site.pkl` | Host and site configuration |
52| Published main revision | `/opt/studio/main` | Release exported from described `main` |52| `/opt/snowglobe/releases/<digest>` | Immutable uploaded releases |
53| Active deployment | `/opt/studio/current` | Active release link; not an editable checkout |53| `/opt/snowglobe/main`, `/opt/snowglobe/current` | Published main and active release links |
54| Zenith host installation | `/etc/nixos` | Installed host configuration; release activation also manages NixOS |54| `/etc/nixos` | Installed host configuration, managed by release activation |
55| Mac SMB `/Volumes/clover` | Zenith `/srv/clover` | Live personal files; not a disposable test tree |55| `/srv/prod/<service>` | Persistent service ZFS datasets |
56| `/Volumes/clover/Media` | Zenith `/srv/clover/Media` | Media child dataset |56| `/srv/staging/<stage>` | Disposable preview data and external mount clones |
57| Mac `/Volumes/media` (launcher default) | VM `/mnt/media-source` → `/srv/clover/Media` | Read-only 9P export and bindfs view for rehearsal |57| `/srv/clover` (`/Volumes/clover` on Mac) | Live personal files |
58| Managed service storage | `/srv/prod/<service>` | Persistent, per-service ZFS datasets |58| `/srv/clover/Media` | Separate media dataset |
59| Preview storage | `/srv/staging/<stage>` | Disposable service clones, with separate external clones where needed |59| `/srv/vm` | Guest disks, access files, installation library |
60| VM storage | `/srv/vm` | Guest disks, access files, and installation library |60| `/var/lib/snowglobe` | Identities, previews, history, backups, dashboard state, logs |
61| Deployment/control state | `/var/lib/studio` | UID registry, stages, history, backups, dashboard state, run logs |61
62| Nomad state | `services.nomad.settings.data_dir` in `nixos/configuration.nix` | Separate from service data; includes ACLs and secrets |62Preserve persistent state, numeric owners, and existing consumers through
6363namespace changes. Read current configuration and host state before changing
64The rehearsal VM has its own Clover dataset. Its media view references the Mac's64operational assumptions.
65mounted share read-only; those bytes are not synthetic fixtures. See65
66`tools/local-vm.sh` for launch/cache overrides and `tools/mac-domains.py` for66## Data and credentials
67Mac rehearsal routing. Do not hand-edit DNS, trust, or host files to bypass them.67
6868- Infrastructure access and directory listings do not authorize reading private
69## Where changes belong69 contents. Get authorization per source; keep private material and derived model
7070 output inside its store. Preview clones do not broaden that authorization.
71- `config/Service.pkl` owns the service schema; `config/site.pkl` owns site71- Keep credentials and encryption keys out of chat, command arguments, logs, and
72 defaults and overrides. `config/excluded-services.json` filters deployment72 tracked files. Use private files/stdin. Nomad variables own service secrets;
73 sources. Services are discovered from `service/*/*.pkl`.73 configuration declares references. Restrict private files to their consumers.
74- `service/<name>/service.pkl` owns a service's containers, routes, mounts,74- Preserve assigned numeric owners in `/var/lib/snowglobe/identities.json`, seeded
75 requirements, secret declarations, health checks, and resource limits.75 from `config/identities.json`. Never renumber services or recursively chown data
76 Sibling Pkl files define additional services, e.g. Postgres's pgAdmin.76 as a shortcut.
77- `tools/studio.py` owns rendering, provisioning, staging, and service setup.77- Before destructive storage or OS work, verify key recovery and application/
78 `tools/deploy.py` uploads local sources or `main`; `tools/release.py` owns78 database restores with at least two restricted copies off the server, stored
79 release activation and code rollback; `tools/data.py` owns backup/restore.79 separately. Snapshots or a key archive alone do not establish recovery.
80- `tools/router.py` generates Caddy routes from service discovery. Change the80- Use the release workflow for activation and rollback, not ad hoc replacement
81 declaration or generator, not generated routes or Nomad jobs.81 containers or edits inside `/opt/snowglobe/current`. Code rollback does not restore
82- `nixos/` owns host units, packages, isolation, mounts, and hardware settings.82 data. Read [data restore](tools/data-restore.md) before proposing data loss.
83 `dashboard/src/` owns the HTTP server and auth; `dashboard/web/` owns the UI;83
84 `tools/dashboard-host.py` and `tools/vms.py` own privileged host operations.84## Implementation and checks
85- `guest/` owns guest capture/provisioning and its shared protocol. Inspect85
86 `guest/DESIGN.md` before changing the guest/host boundary.86- `config/Service.pkl` owns the schema; `config/site.pkl` owns site settings.
87- Runtime identities live in `/var/lib/studio/identities.json`, initially seeded87 Services are discovered from `service/*/*.pkl`. Declare routes, mounts, health,
88 from `config/identities.json`. Preserve assigned numeric owners; do not88 authentication, resources, and provider requirements in the service definition.
89 renumber services or recursively change ownership as a shortcut.89- `tools/snowglobe.py` owns rendering/provisioning; `tools/deploy.py` uploads;
9090 `tools/release.py` activates; `tools/data.py` backs up/restores;
91## Adding or changing a service91 `tools/router.py` derives Caddy routes. Change sources, not generated jobs/routes.
9292- `nixos/` owns the host. `dashboard/src/` and `dashboard/web/` own the app;
931. Read the closest existing service and the schema. Declare managed storage,93 `tools/dashboard-host.py` and `tools/vms.py` own privileged operations.
94 explicit external mounts, health checks, auth, and requirements. Use94 Read `guest/DESIGN.md` before changing the guest/host boundary.
95 `prepare` for repeatable work before startup and `setup` for repeatable95- Review outbound mail, federation, downloads, automation, fixed ports, host
96 configuration after health. Declare providers instead of hardcoding their96 networking, and GPU use before staging. Use preview-aware settings or fresh
97 current addresses or credentials.97 isolation. Fresh previews reject writable external mounts. Read-only mounts
982. Check side effects before staging: outbound mail, federation, downloads,98 can still expose their source; inspect actual bindings.
99 automation, fixed host ports, host networking, and exclusive GPU use. Use99- Repeating `stage <service>` updates its preview and retains preview data. Use
100 preview-aware configuration or `stageIsolation = "fresh"` when a cloned app100 the printed hostname. Clean up superseded previews with
101 would act as production. Fresh stages reject writable external mounts.101 `python3 tools/deploy.py destroy <stage-id>`; retain evidence first.
1023. Run the relevant local checks, then stage the working files:102- Dashboard: `cd dashboard && npm run check && npm run build` and
103103 `cargo test --manifest-path dashboard/Cargo.toml`. Deployment:
104 ```sh104 `python3 tools/deploy-test.py`; target-side `tools/snowglobe.py validate` checks
105 STUDIO_DEPLOY_HOST=root@10.0.0.1 STUDIO_DEPLOY_PORT=22 python3 tools/deploy.py stage <service>105 jobs and `check` checks routes. Rendering can allocate identities.
106 ```106- Read a test's entry point before running it. Host/service/storage/guest mutation
107107 tests need disposable fixtures or the explicit production scope above. A health
108 The command prints `stage`, `release`, `host`, and `dataset`. Use that host;108 response alone does not prove the app works. Metrics/traces must be observed.
109 do not invent a staging hostname. Repeating `stage <service>` updates its109- Prefer fewer moving parts. Derive state, remove dead code and false comments,
110 existing preview and keeps preview data. Storage/isolation or incompatible110 and keep one home for each artifact. When a trade depends on how likely a
111 requirement changes can require destroying and recreating that preview.111 default or interface is to change, explain the trade and ask Clover.
1124. Verify the actual app path, authentication, persistence, provider connections,
113 and healthy allocations. Check logs/restarts and sampled unaffected services.
114 An HTTP health response alone does not establish that the app works.
115 Writable external ZFS mounts get clones; read-only external mounts can still
116 reference the source. Review the actual bindings for host-networked services.
1175. Clean up previews when finished using `python3 tools/deploy.py destroy
118 <stage-id>` against the same target. Destruction deletes preview state; retain
119 anything the task needs first. The physical RTX 3090 fits one model instance;
120 stop its AI preview before a production AI deployment.
1216. Commit reviewed changes. Production exports a described, conflict-free
122 **main**, not the working copy and not the preview's edited database. Only
123 after production is requested and the intended changes are on `main`:
124
125 ```sh
126 STUDIO_DEPLOY_HOST=root@10.0.0.1 STUDIO_DEPLOY_PORT=22 python3 tools/deploy.py prod
127 ```
128
129 Check deployment history and real production paths. The release workflow
130 takes a pre-switch backup and performs health checks; use it instead of an
131 ad hoc container replacement or edits inside `/opt/studio/current`.
132
133Code rollback uses `deploy.py rollback [release-id]`. It does **not** restore
134data. Data restore explicitly discards later writes and is a separate operation;
135read `tools/data-restore.md` before proposing it.
136
137## Verification and change hygiene
138
139- Run checks that cover the change. Inspect a test's entry point first: some
140 `tools/*-test.py` scripts mutate host services or require Linux/real guests.
141 Run those against isolated staging fixtures. Tests that alter host services,
142 storage, or guests require a disposable VM or explicit production scope.
143- Dashboard: `cd dashboard && npm run check && npm run build`; run Rust tests
144 with `cargo test --manifest-path dashboard/Cargo.toml`. Host tests include
145 `python3 tools/dashboard-host-test.py` and `python3 tools/dashboard-vms-test.py`.
146- Deployment: `python3 tools/deploy-test.py`. On the target, the uploaded
147 `tools/studio.py validate` checks generated Nomad jobs; `check` checks routes.
148 Even render loads/allocates identities, so it is not a pure local formatter.
149- Local AI: use the unit checks and live client probes in `tools/local-ai.md`.
150 Rehearsal has no production GPU/model instance; do not download model weights
151 or enable GPU inference there.
152- UI changes need real browser verification, keyboard checks, and screenshots
153 or recordings for Clover to judge. Test VM consoles in the normal browser
154 panel. Metrics/traces must represent observed app telemetry.
155- Prefer fewer names, fields, branches, casts, and public promises. Derive state
156 instead of storing it. Delete dead code and comments describing removed
157 behavior. One artifact has one home; link additional consumers to it.
158- When a trade depends on how likely something is to change, report the trade
159 and ask Clover. Do not decide it by asserting that the thing is stable.
160- Use Jujutsu, never standalone `git`. Inspect `jj st`, the current description,112- Use Jujutsu, never standalone `git`. Inspect `jj st`, the current description,
161 and `jj diff --git` before editing or committing; preserve unrelated work.113 and `jj diff --git`; preserve unrelated work and split independent changes.
162 Split independent changes when committing. Do not push or move `main` merely114 Attribution uses `Assisted-by: <model>`, never `Co-authored-by`.
163 because a task requests a local commit. Use `Assisted-by: <model>` if adding115
164 model attribution, never `Co-authored-by`.116## References
165117
166## Operational references118[Storage layout](readme.md) · [Physical host/recovery](tools/snowglobe-hardware.md) ·
167119[Service dependencies](tools/service-dependencies.md) · [Files](tools/copyparty.md) ·
168- Storage layout: [readme.md](readme.md).120[AI steering](service/local-ai/steering/README.md) · [AI cache](tools/local-ai-cache.md)
169- Physical host and recovery context: [tools/zenith-hardware.md](tools/zenith-hardware.md).
170- Storage and permissions: [tools/media-cutover.md](tools/media-cutover.md),
171 [tools/storage-acl-cutover.md](tools/storage-acl-cutover.md).
172- Legacy recovery and app imports: [tools/legacy-handoff.md](tools/legacy-handoff.md),
173 [tools/personal-cutover.md](tools/personal-cutover.md), and the service's
174 `tools/*-migration.md` runbook.
175- Provider behavior: [tools/service-dependencies.md](tools/service-dependencies.md).
176- Copyparty administration and folder moves: [tools/copyparty.md](tools/copyparty.md).
177- Local inference: [tools/local-ai.md](tools/local-ai.md).
178
179Runbooks contain dated rehearsal evidence and migration history. Check current
180configuration and read-only host state before treating an old observation as
181today's topology. Keep deployment history and long investigations in their
182runbooks; AGENTS.md carries the rules and links.
config/OpenID.pkl+2-1
...@@ -3,13 +3,14 @@ module OpenID...@@ -3,13 +3,14 @@ module OpenID
3import "Service.pkl" as service3import "Service.pkl" as service
4import "site.pkl" as site4import "site.pkl" as site
55
6hostname: String = "snowglobe.\(site.domain)"6const hostname: String = "snowglobe.\(site.domain)"
7issuer: String = "https://\(hostname)"7issuer: String = "https://\(hostname)"
88
9class Client extends service.Requirement {9class Client extends service.Requirement {
10 alias: String = "oidc"10 alias: String = "oidc"
11 fixed provider = "snowglobe"11 fixed provider = "snowglobe"
12 fixed kind = "client"12 fixed kind = "client"
13 fixed issuerHostname = module.hostname
13 clientId: String(isNotEmpty)14 clientId: String(isNotEmpty)
14 name: String15 name: String
15 redirectUris: Listing<String>16 redirectUris: Listing<String>
config/Service.pkl+11-15
...@@ -4,15 +4,6 @@ import "site.pkl" as site...@@ -4,15 +4,6 @@ import "site.pkl" as site
44
5const nomadHostPort = "{{ if regexMatch \":\" .Address }}[{{ .Address }}]{{ else }}{{ .Address }}{{ end }}:{{ .Port }}"5const nomadHostPort = "{{ if regexMatch \":\" .Address }}[{{ .Address }}]{{ else }}{{ .Address }}{{ end }}:{{ .Port }}"
66
7/// Name shown in the management UI and service listings.
8class Metadata {
9 name: String
10 tagline: String = ""
11 launcher: Boolean = true
12 /// Discovery group; absent uses the public route's auth role.
13 access: String?
14}
15
16/// One HTTP listener and its public route.7/// One HTTP listener and its public route.
17class Http {8class Http {
18 containerPort: UInt169 containerPort: UInt16
...@@ -107,7 +98,12 @@ class Container {...@@ -107,7 +98,12 @@ class Container {
107id: String = read?("prop:serviceId")98id: String = read?("prop:serviceId")
108/// Stable numeric owner assigned by the deployment tool.99/// Stable numeric owner assigned by the deployment tool.
109uid: Int = read("prop:uid").toInt()100uid: Int = read("prop:uid").toInt()
110meta: Metadata101/// Name shown in the management UI and service listings.
102name: String
103tagline: String = ""
104launcher: Boolean = true
105/// Discovery group; absent uses the public route's auth role.
106access: String?
111/// Allows site-specific services to stay out of deployments where they would cause side effects.107/// Allows site-specific services to stay out of deployments where they would cause side effects.
112enabled: Boolean = true108enabled: Boolean = true
113/// Simple replaces one allocation; overlapped runs a canary alongside it.109/// Simple replaces one allocation; overlapped runs a canary alongside it.
...@@ -156,16 +152,16 @@ local deploymentContainers: Mapping<String, Container> =...@@ -156,16 +152,16 @@ local deploymentContainers: Mapping<String, Container> =
156 else152 else
157 throw("Declare a container or an input")153 throw("Declare a container or an input")
158154
159local vmStartupGrace: String? = if (read?("env:STUDIO_VM_ACCEL") == "qemu") "60m" else null155local vmStartupGrace: String? = if (read?("env:SNOWGLOBE_VM_ACCEL") == "qemu") "60m" else null
160156
161output {157output {
162 renderer = new JsonRenderer {}158 renderer = new JsonRenderer {}
163 value = new {159 value = new {
164 id = module.id160 id = module.id
165 name = module.meta.name161 name = module.name
166 tagline = module.meta.tagline162 tagline = module.tagline
167 launcher = module.meta.launcher163 launcher = module.launcher
168 access = module.meta.access164 access = module.access
169 rollout = module.rollout165 rollout = module.rollout
170 stageIsolation = module.stageIsolation166 stageIsolation = module.stageIsolation
171 healthyDeadline = vmStartupGrace ?? module.healthyDeadline167 healthyDeadline = vmStartupGrace ?? module.healthyDeadline
config/excluded-services.json deleted-5
...@@ -1,5 +0,0 @@
1[
2 "evil-forgejo",
3 "evil-hedgedoc",
4 "keycloak"
5]
config/site.pkl+13-13
...@@ -1,18 +1,18 @@...@@ -1,18 +1,18 @@
1module Site1module Site
22
3/// The path to the root ZFS store3/// The path to the root ZFS store
4root: String = read?("prop:root") ?? read?("env:STUDIO_ROOT") ?? "/srv"4root: String = read?("prop:root") ?? read?("env:SNOWGLOBE_ROOT") ?? "/srv"
5pool: String = read?("prop:pool") ?? read?("env:STUDIO_POOL") ?? "studio-demo"5pool: String = read?("prop:pool") ?? read?("env:SNOWGLOBE_POOL") ?? "snowglobe-demo"
6nodeName: String = read?("prop:nodeName") ?? read?("env:STUDIO_NODE_NAME") ?? "clover-demo"6nodeName: String = read?("prop:nodeName") ?? read?("env:SNOWGLOBE_NODE_NAME") ?? "snowglobe-rehearsal"
7/// The base domain that the infrastructure runs on7/// The base domain that the infrastructure runs on
8domain: String = read?("prop:domain") ?? read?("env:STUDIO_DOMAIN") ?? "studio.test"8domain: String = read?("prop:domain") ?? read?("env:SNOWGLOBE_DOMAIN") ?? "snowglobe.test"
9ownerEmail: String = read?("prop:ownerEmail") ?? read?("env:STUDIO_OWNER_EMAIL") ?? "account@paperclover.net"9ownerEmail: String = read?("prop:ownerEmail") ?? read?("env:SNOWGLOBE_OWNER_EMAIL") ?? "account@paperclover.net"
10cloverRoot: String = read?("prop:cloverRoot") ?? read?("env:STUDIO_CLOVER_ROOT") ?? "\(root)/clover"10cloverRoot: String = read?("prop:cloverRoot") ?? read?("env:SNOWGLOBE_CLOVER_ROOT") ?? "\(root)/clover"
11cloverUid: Int = (read?("prop:cloverUid") ?? read?("env:STUDIO_CLOVER_UID") ?? "3000").toInt()11cloverUid: Int = (read?("prop:cloverUid") ?? read?("env:SNOWGLOBE_CLOVER_UID") ?? "3000").toInt()
12cloverGid: Int = (read?("prop:cloverGid") ?? read?("env:STUDIO_CLOVER_GID") ?? "3000").toInt()12cloverGid: Int = (read?("prop:cloverGid") ?? read?("env:SNOWGLOBE_CLOVER_GID") ?? "3000").toInt()
13cloverReadOnly: Boolean = (read?("prop:cloverReadOnly") ?? read?("env:STUDIO_CLOVER_READ_ONLY") ?? "false") == "true"13cloverReadOnly: Boolean = (read?("prop:cloverReadOnly") ?? read?("env:SNOWGLOBE_CLOVER_READ_ONLY") ?? "false") == "true"
14mediaRoot: String = read?("prop:mediaRoot") ?? read?("env:STUDIO_MEDIA_ROOT") ?? "\(cloverRoot)/Media"14mediaRoot: String = read?("prop:mediaRoot") ?? read?("env:SNOWGLOBE_MEDIA_ROOT") ?? "\(cloverRoot)/Media"
15localAiSsdCache: String = read?("prop:localAiSsdCache") ?? read?("env:STUDIO_LOCAL_AI_SSD_CACHE") ?? "/var/cache/studio/local-ai"15localAiSsdCache: String = read?("prop:localAiSsdCache") ?? read?("env:SNOWGLOBE_LOCAL_AI_SSD_CACHE") ?? "/var/cache/snowglobe/local-ai"
16jellyfinFolders: Mapping<String, String> = new {16jellyfinFolders: Mapping<String, String> = new {
17 ["Anime"] = "Anime"17 ["Anime"] = "Anime"
18 ["Movies"] = "Movies"18 ["Movies"] = "Movies"
...@@ -21,6 +21,6 @@ jellyfinFolders: Mapping<String, String> = new {...@@ -21,6 +21,6 @@ jellyfinFolders: Mapping<String, String> = new {
21 ["Independent"] = "Videos/Independent"21 ["Independent"] = "Videos/Independent"
22 ["Paper Clover"] = "Videos/Paper Clover"22 ["Paper Clover"] = "Videos/Paper Clover"
23}23}
24mediaReadOnly: Boolean = (read?("prop:mediaReadOnly") ?? read?("env:STUDIO_MEDIA_READ_ONLY") ?? "false") == "true"24mediaReadOnly: Boolean = (read?("prop:mediaReadOnly") ?? read?("env:SNOWGLOBE_MEDIA_READ_ONLY") ?? "false") == "true"
25tlsInternal: Boolean = (read?("prop:tlsInternal") ?? read?("env:STUDIO_TLS_INTERNAL") ?? "false") == "true" || domain.endsWith(".test")25tlsInternal: Boolean = (read?("prop:tlsInternal") ?? read?("env:SNOWGLOBE_TLS_INTERNAL") ?? "false") == "true" || domain.endsWith(".test")
26preview: Boolean = (read?("prop:preview") ?? "false") == "true"26preview: Boolean = (read?("prop:preview") ?? "false") == "true"
dashboard/dev.ts deleted-37
...@@ -1,37 +0,0 @@
1import { execFile, spawn } from "node:child_process";
2import { watch } from "node:fs";
3import { promisify } from "node:util";
4
5const host = process.env.STUDIO_DEPLOY_HOST ?? "root@127.0.0.1";
6const ssh = ["-p", process.env.STUDIO_DEPLOY_PORT ?? "2222", "-o", "BatchMode=yes", "-o", "ConnectTimeout=8"];
7const dir = "/root/studio-dashboard-dev";
8const run = promisify(execFile);
9const quote = (value: string) => "'" + value.replaceAll("'", "'\\''") + "'";
10const restart = `import os, shlex, subprocess
11variables = dict(item.split("=", 1) for item in shlex.split(subprocess.check_output(["systemctl", "show", "-P", "Environment", "studio-dashboard"], text=True)))
12for key in ["STUDIO_INDEX_POOL", "STUDIO_YT_STATE", "STUDIO_FILES_WRITABLE"]: variables.pop(key, None)
13variables.update(PORT="7070", STUDIO_METRICS="follow", STUDIO_DATA_DIR="${dir}/data")
14subprocess.run(["systemctl", "stop", "studio-dashboard-dev"], check=False)
15subprocess.run(["systemd-run", "--unit=studio-dashboard-dev", "--collect", "--property=WorkingDirectory=${dir}/result/lib/home-dashboard", *["--setenv="+key+"="+value for key,value in variables.items()], "${dir}/result/bin/home-dashboard"], check=True)`;
16let pending = false;
17let rebuilding = false;
18async function rebuild() {
19 pending = true;
20 if (rebuilding) return;
21 rebuilding = true;
22 try {
23 while (pending) {
24 pending = false;
25 await run("rsync", ["-a", "--delete", ...[".jj", ".git", "node_modules", "target", "dist", ".cache", "data", "result"].map(name => "--exclude=" + name), "-e", ["ssh", ...ssh].join(" "), "../", `${host}:${dir}/`]);
26 await run("ssh", [...ssh, host, `cd ${dir} && nix --extra-experimental-features 'nix-command flakes' build path:.#dashboard --cores 2 --max-jobs 1 -o result && python3 -c ${quote(restart)}`], { maxBuffer: 16 * 1024 * 1024 });
27 console.log("Rust dashboard ready");
28 }
29 } finally { rebuilding = false; }
30}
31await rebuild();
32watch("src", { recursive: true }, () => rebuild().catch(console.error));
33const tunnel = spawn("ssh", [...ssh, "-N", "-o", "ExitOnForwardFailure=yes", "-L", "7070:127.0.0.1:7070", host], { stdio: "inherit" });
34tunnel.on("exit", code => process.exit(code ?? 1));
35for (const signal of ["SIGINT", "SIGTERM"] as const) process.on(signal, () => {
36 run("ssh", [...ssh, host, "systemctl stop studio-dashboard-dev"]).finally(() => tunnel.kill());
37});
dashboard/package.json+1-2
...@@ -3,7 +3,7 @@...@@ -3,7 +3,7 @@
3 "private": true,3 "private": true,
4 "type": "module",4 "type": "module",
5 "scripts": {5 "scripts": {
6 "dev": "concurrently -k -n server,web \"node dev.ts\" \"vite\"",6 "dev": "python3 ../tools/deploy.py stage dashboard",
7 "build": "vite build",7 "build": "vite build",
8 "check": "tsc --noEmit",8 "check": "tsc --noEmit",
9 "start": "cargo run --release"9 "start": "cargo run --release"
...@@ -16,7 +16,6 @@...@@ -16,7 +16,6 @@
16 "@novnc/novnc": "^1.7.0",16 "@novnc/novnc": "^1.7.0",
17 "@solidjs/router": "^1.0.0",17 "@solidjs/router": "^1.0.0",
18 "@types/node": "^26.6.2",18 "@types/node": "^26.6.2",
19 "concurrently": "^10.0.5",
20 "esbuild": "0.28.2",19 "esbuild": "0.28.2",
21 "lucide-solid": "^1.48.0",20 "lucide-solid": "^1.48.0",
22 "solid-js": "^1.9.15",21 "solid-js": "^1.9.15",
dashboard/pnpm-lock.yaml-145
...@@ -24,9 +24,6 @@ importers:...@@ -24,9 +24,6 @@ importers:
24 '@types/node':24 '@types/node':
25 specifier: ^26.6.225 specifier: ^26.6.2
26 version: 26.6.226 version: 26.6.2
27 concurrently:
28 specifier: ^10.0.5
29 version: 10.0.5
30 esbuild:27 esbuild:
31 specifier: 0.28.228 specifier: 0.28.2
32 version: 0.28.229 version: 0.28.2
...@@ -555,14 +552,6 @@ packages:...@@ -555,14 +552,6 @@ packages:
555 cpu: [x64]552 cpu: [x64]
556 os: [win32]553 os: [win32]
557554
558 ansi-regex@6.3.0:
559 resolution: {integrity: sha512-WpDfL7NO6j7tH88IDBNVdUJxDh9nmCteAVW9dsep846XdwF4naCBK+/tGLX3KJgcpgMRXCFlTM2hKGoK9FsdrQ==}
560 engines: {node: '>=12'}
561
562 ansi-styles@6.2.3:
563 resolution: {integrity: sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==}
564 engines: {node: '>=12'}
565
566 babel-plugin-jsx-dom-expressions@0.40.10:555 babel-plugin-jsx-dom-expressions@0.40.10:
567 resolution: {integrity: sha512-lxve6Y02YiZTldB7efKpnbf1BH00XCFZNYYW235jSGsYaJNFtHrYlKV6/O+miHbjqpIr9FTe5+0no4hofAMbfA==}556 resolution: {integrity: sha512-lxve6Y02YiZTldB7efKpnbf1BH00XCFZNYYW235jSGsYaJNFtHrYlKV6/O+miHbjqpIr9FTe5+0no4hofAMbfA==}
568 peerDependencies:557 peerDependencies:
...@@ -590,19 +579,6 @@ packages:...@@ -590,19 +579,6 @@ packages:
590 caniuse-lite@1.0.30001812:579 caniuse-lite@1.0.30001812:
591 resolution: {integrity: sha512-qN+QNNBr93TCmFrmte0bBCjSDMuRvt78VlHT99qIGPszm4QsqCX8lnyWUFkHi8B7ZBAPq8SH+UqyXNy/odMdng==}580 resolution: {integrity: sha512-qN+QNNBr93TCmFrmte0bBCjSDMuRvt78VlHT99qIGPszm4QsqCX8lnyWUFkHi8B7ZBAPq8SH+UqyXNy/odMdng==}
592581
593 chalk@5.6.2:
594 resolution: {integrity: sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==}
595 engines: {node: ^12.17.0 || ^14.13 || >=16.0.0}
596
597 cliui@9.0.1:
598 resolution: {integrity: sha512-k7ndgKhwoQveBL+/1tqGJYNz097I7WOvwbmmU2AR5+magtbjPWQTS1C5vzGkBC8Ym8UWRzfKUzUUqFLypY4Q+w==}
599 engines: {node: '>=20'}
600
601 concurrently@10.0.5:
602 resolution: {integrity: sha512-JaP/CoftUrCcAFW/g//RbgEGwlelnEae6cfBLgH6ZdO6s8jPkn6p9SB9u6pdVxYXoiSnFqseOlHfrEfF82TVOg==}
603 engines: {node: '>=22'}
604 hasBin: true
605
606 convert-source-map@2.0.0:582 convert-source-map@2.0.0:
607 resolution: {integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==}583 resolution: {integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==}
608584
...@@ -625,9 +601,6 @@ packages:...@@ -625,9 +601,6 @@ packages:
625 electron-to-chromium@1.5.439:601 electron-to-chromium@1.5.439:
626 resolution: {integrity: sha512-qu6QIPXhsb+CRcAiTMNjR4A1y/7tCYKkKjr5CZXRVih6qkDf79peZ2BpEU3qoDBNCRrcy3Mra3X9nG5oruuA7Q==}602 resolution: {integrity: sha512-qu6QIPXhsb+CRcAiTMNjR4A1y/7tCYKkKjr5CZXRVih6qkDf79peZ2BpEU3qoDBNCRrcy3Mra3X9nG5oruuA7Q==}
627603
628 emoji-regex@10.6.0:
629 resolution: {integrity: sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==}
630
631 entities@6.0.1:604 entities@6.0.1:
632 resolution: {integrity: sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==}605 resolution: {integrity: sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==}
633 engines: {node: '>=0.12'}606 engines: {node: '>=0.12'}
...@@ -659,14 +632,6 @@ packages:...@@ -659,14 +632,6 @@ packages:
659 resolution: {integrity: sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==}632 resolution: {integrity: sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==}
660 engines: {node: '>=6.9.0'}633 engines: {node: '>=6.9.0'}
661634
662 get-caller-file@2.0.5:
663 resolution: {integrity: sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==}
664 engines: {node: 6.* || 8.* || >= 10.*}
665
666 get-east-asian-width@1.7.0:
667 resolution: {integrity: sha512-XjH1AECxf0giL2V1aU8vKyRR2ppRUb5c0EvT7zuJTokQ74bNo52zOtghqdWIqrhUD79fo3x0WfKZdOqxF6LG1Q==}
668 engines: {node: '>=18'}
669
670 hono@4.13.9:635 hono@4.13.9:
671 resolution: {integrity: sha512-7dMkQmZoC4E6F7AtaQSPhlWAdnBti+j7rreMZl8QB4jFiEhP9TWbGWUMi8WYzBCgmgulxuvLQupKqo+Co6Omyg==}636 resolution: {integrity: sha512-7dMkQmZoC4E6F7AtaQSPhlWAdnBti+j7rreMZl8QB4jFiEhP9TWbGWUMi8WYzBCgmgulxuvLQupKqo+Co6Omyg==}
672 engines: {node: '>=16.9.0'}637 engines: {node: '>=16.9.0'}
...@@ -804,9 +769,6 @@ packages:...@@ -804,9 +769,6 @@ packages:
804 engines: {node: ^20.19.0 || >=22.12.0}769 engines: {node: ^20.19.0 || >=22.12.0}
805 hasBin: true770 hasBin: true
806771
807 rxjs@7.8.2:
808 resolution: {integrity: sha512-dhKf903U/PQZY6boNNtAGdWbG85WAbjT/1xYoZIC7FAY0yWapOBQVsVrDl58W86//e1VpMNBtRV4MaXfdMySFA==}
809
810 semver@6.3.1:772 semver@6.3.1:
811 resolution: {integrity: sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==}773 resolution: {integrity: sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==}
812 hasBin: true774 hasBin: true
...@@ -821,10 +783,6 @@ packages:...@@ -821,10 +783,6 @@ packages:
821 resolution: {integrity: sha512-rVQVWjjSvlINzaQPZH5JFqsqEsIWdTxY3iJZCnTL/5gQbXIRooVZKI60tVCkOVfzcRPejboxO2t0P89dg5mQaA==}783 resolution: {integrity: sha512-rVQVWjjSvlINzaQPZH5JFqsqEsIWdTxY3iJZCnTL/5gQbXIRooVZKI60tVCkOVfzcRPejboxO2t0P89dg5mQaA==}
822 engines: {node: '>=10'}784 engines: {node: '>=10'}
823785
824 shell-quote@1.9.0:
825 resolution: {integrity: sha512-Iov+JwFv/2HcTpcwNMKd8+IWNb8tboQJNQTkAY/LLVK7gGH9jy+LGkVqPxfekHl+yMmiqXszdGWXgkfml7hjqA==}
826 engines: {node: '>= 0.4'}
827
828 solid-js@1.9.15:786 solid-js@1.9.15:
829 resolution: {integrity: sha512-EeiY2xfpZJqPLjXspVEKjAII4yv8NyG//NxZ3IpOFHdUNnnTyL0uJOeS9LWGvA7cFCz5y94cjFwYlmw5Luncsg==}787 resolution: {integrity: sha512-EeiY2xfpZJqPLjXspVEKjAII4yv8NyG//NxZ3IpOFHdUNnnTyL0uJOeS9LWGvA7cFCz5y94cjFwYlmw5Luncsg==}
830788
...@@ -837,29 +795,10 @@ packages:...@@ -837,29 +795,10 @@ packages:
837 resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==}795 resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==}
838 engines: {node: '>=0.10.0'}796 engines: {node: '>=0.10.0'}
839797
840 string-width@7.2.0:
841 resolution: {integrity: sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==}
842 engines: {node: '>=18'}
843
844 strip-ansi@7.2.0:
845 resolution: {integrity: sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==}
846 engines: {node: '>=12'}
847
848 supports-color@10.2.2:
849 resolution: {integrity: sha512-SS+jx45GF1QjgEXQx4NJZV9ImqmO2NPz5FNsIHrsDjh2YsHnawpan7SNQ1o8NuhrbHZy9AZhIoCUiCeaW/C80g==}
850 engines: {node: '>=18'}
851
852 tinyglobby@0.2.17:798 tinyglobby@0.2.17:
853 resolution: {integrity: sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==}799 resolution: {integrity: sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==}
854 engines: {node: '>=12.0.0'}800 engines: {node: '>=12.0.0'}
855801
856 tree-kill@1.2.2:
857 resolution: {integrity: sha512-L0Orpi8qGpRG//Nd+H90vFB+3iHnue1zSSGmNOOCh1GLJ7rUKVwV2HvijphGQS2UmhUZewS9VgvxYIdgr+fG1A==}
858 hasBin: true
859
860 tslib@2.8.1:
861 resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==}
862
863 tsx@4.23.15:802 tsx@4.23.15:
864 resolution: {integrity: sha512-Yiex1Ovn8z2xPpOWckIiysV1SSyRMY9BkLF++q0yKiDxCqRhosKfMg3janKkiLBwZ5c/YryloKwGZcrEmtwxKw==}803 resolution: {integrity: sha512-Yiex1Ovn8z2xPpOWckIiysV1SSyRMY9BkLF++q0yKiDxCqRhosKfMg3janKkiLBwZ5c/YryloKwGZcrEmtwxKw==}
865 engines: {node: '>=18.0.0'}804 engines: {node: '>=18.0.0'}
...@@ -943,25 +882,9 @@ packages:...@@ -943,25 +882,9 @@ packages:
943 vite:882 vite:
944 optional: true883 optional: true
945884
946 wrap-ansi@9.0.2:
947 resolution: {integrity: sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==}
948 engines: {node: '>=18'}
949
950 y18n@5.0.8:
951 resolution: {integrity: sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==}
952 engines: {node: '>=10'}
953
954 yallist@3.1.1:885 yallist@3.1.1:
955 resolution: {integrity: sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==}886 resolution: {integrity: sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==}
956887
957 yargs-parser@22.0.0:
958 resolution: {integrity: sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw==}
959 engines: {node: ^20.19.0 || ^22.12.0 || >=23}
960
961 yargs@18.0.0:
962 resolution: {integrity: sha512-4UEqdc2RYGHZc7Doyqkrqiln3p9X2DZVxaGbwhn2pi7MrRagKaOcIKe8L3OxYcbhXLgLFUS3zAYuQjKBQgmuNg==}
963 engines: {node: ^20.19.0 || ^22.12.0 || >=23}
964
965snapshots:888snapshots:
966889
967 '@babel/code-frame@7.29.7':890 '@babel/code-frame@7.29.7':
...@@ -1316,10 +1239,6 @@ snapshots:...@@ -1316,10 +1239,6 @@ snapshots:
1316 '@typescript/typescript-win32-x64@7.0.2':1239 '@typescript/typescript-win32-x64@7.0.2':
1317 optional: true1240 optional: true
13181241
1319 ansi-regex@6.3.0: {}
1320
1321 ansi-styles@6.2.3: {}
1322
1323 babel-plugin-jsx-dom-expressions@0.40.10(@babel/core@7.29.7):1242 babel-plugin-jsx-dom-expressions@0.40.10(@babel/core@7.29.7):
1324 dependencies:1243 dependencies:
1325 '@babel/core': 7.29.71244 '@babel/core': 7.29.7
...@@ -1348,23 +1267,6 @@ snapshots:...@@ -1348,23 +1267,6 @@ snapshots:
13481267
1349 caniuse-lite@1.0.30001812: {}1268 caniuse-lite@1.0.30001812: {}
13501269
1351 chalk@5.6.2: {}
1352
1353 cliui@9.0.1:
1354 dependencies:
1355 string-width: 7.2.0
1356 strip-ansi: 7.2.0
1357 wrap-ansi: 9.0.2
1358
1359 concurrently@10.0.5:
1360 dependencies:
1361 chalk: 5.6.2
1362 rxjs: 7.8.2
1363 shell-quote: 1.9.0
1364 supports-color: 10.2.2
1365 tree-kill: 1.2.2
1366 yargs: 18.0.0
1367
1368 convert-source-map@2.0.0: {}1270 convert-source-map@2.0.0: {}
13691271
1370 csstype@3.2.3: {}1272 csstype@3.2.3: {}
...@@ -1377,8 +1279,6 @@ snapshots:...@@ -1377,8 +1279,6 @@ snapshots:
13771279
1378 electron-to-chromium@1.5.439: {}1280 electron-to-chromium@1.5.439: {}
13791281
1380 emoji-regex@10.6.0: {}
1381
1382 entities@6.0.1: {}1282 entities@6.0.1: {}
13831283
1384 esbuild@0.28.2:1284 esbuild@0.28.2:
...@@ -1421,10 +1321,6 @@ snapshots:...@@ -1421,10 +1321,6 @@ snapshots:
14211321
1422 gensync@1.0.0-beta.2: {}1322 gensync@1.0.0-beta.2: {}
14231323
1424 get-caller-file@2.0.5: {}
1425
1426 get-east-asian-width@1.7.0: {}
1427
1428 hono@4.13.9: {}1324 hono@4.13.9: {}
14291325
1430 html-entities@2.3.3: {}1326 html-entities@2.3.3: {}
...@@ -1539,10 +1435,6 @@ snapshots:...@@ -1539,10 +1435,6 @@ snapshots:
1539 '@rolldown/binding-win32-arm64-msvc': 1.2.111435 '@rolldown/binding-win32-arm64-msvc': 1.2.11
1540 '@rolldown/binding-win32-x64-msvc': 1.2.111436 '@rolldown/binding-win32-x64-msvc': 1.2.11
15411437
1542 rxjs@7.8.2:
1543 dependencies:
1544 tslib: 2.8.1
1545
1546 semver@6.3.1: {}1438 semver@6.3.1: {}
15471439
1548 seroval-plugins@1.5.6(seroval@1.5.6):1440 seroval-plugins@1.5.6(seroval@1.5.6):
...@@ -1551,8 +1443,6 @@ snapshots:...@@ -1551,8 +1443,6 @@ snapshots:
15511443
1552 seroval@1.5.6: {}1444 seroval@1.5.6: {}
15531445
1554 shell-quote@1.9.0: {}
1555
1556 solid-js@1.9.15:1446 solid-js@1.9.15:
1557 dependencies:1447 dependencies:
1558 csstype: 3.2.31448 csstype: 3.2.3
...@@ -1570,27 +1460,11 @@ snapshots:...@@ -1570,27 +1460,11 @@ snapshots:
15701460
1571 source-map-js@1.2.1: {}1461 source-map-js@1.2.1: {}
15721462
1573 string-width@7.2.0:
1574 dependencies:
1575 emoji-regex: 10.6.0
1576 get-east-asian-width: 1.7.0
1577 strip-ansi: 7.2.0
1578
1579 strip-ansi@7.2.0:
1580 dependencies:
1581 ansi-regex: 6.3.0
1582
1583 supports-color@10.2.2: {}
1584
1585 tinyglobby@0.2.17:1463 tinyglobby@0.2.17:
1586 dependencies:1464 dependencies:
1587 fdir: 6.5.0(picomatch@4.0.7)1465 fdir: 6.5.0(picomatch@4.0.7)
1588 picomatch: 4.0.71466 picomatch: 4.0.7
15891467
1590 tree-kill@1.2.2: {}
1591
1592 tslib@2.8.1: {}
1593
1594 tsx@4.23.15:1468 tsx@4.23.15:
1595 dependencies:1469 dependencies:
1596 esbuild: 0.28.21470 esbuild: 0.28.2
...@@ -1661,23 +1535,4 @@ snapshots:...@@ -1661,23 +1535,4 @@ snapshots:
1661 optionalDependencies:1535 optionalDependencies:
1662 vite: 8.3.1(@types/node@26.6.2)(esbuild@0.28.2)(tsx@4.23.15)1536 vite: 8.3.1(@types/node@26.6.2)(esbuild@0.28.2)(tsx@4.23.15)
16631537
1664 wrap-ansi@9.0.2:
1665 dependencies:
1666 ansi-styles: 6.2.3
1667 string-width: 7.2.0
1668 strip-ansi: 7.2.0
1669
1670 y18n@5.0.8: {}
1671
1672 yallist@3.1.1: {}1538 yallist@3.1.1: {}
1673
1674 yargs-parser@22.0.0: {}
1675
1676 yargs@18.0.0:
1677 dependencies:
1678 cliui: 9.0.1
1679 escalade: 3.2.0
1680 get-caller-file: 2.0.5
1681 string-width: 7.2.0
1682 y18n: 5.0.8
1683 yargs-parser: 22.0.0
dashboard/server/youtube-worker.py+7-7
...@@ -19,20 +19,20 @@ import yaml...@@ -19,20 +19,20 @@ import yaml
1919
20os.umask(0o007)20os.umask(0o007)
2121
22YT_CONFIG_DIR = os.environ.get("STUDIO_YT_CONFIG", "/srv/clover/Documents/Config/Youtube Downloader")22YT_CONFIG_DIR = os.environ.get("SNOWGLOBE_YT_CONFIG", "/srv/clover/Documents/Config/Youtube Downloader")
23FEED_CONFIG = os.path.join(YT_CONFIG_DIR, "feed.yaml")23FEED_CONFIG = os.path.join(YT_CONFIG_DIR, "feed.yaml")
24STATE_DIR = os.environ.get("STUDIO_YT_STATE", "/srv/prod/ytdl/data")24STATE_DIR = os.environ.get("SNOWGLOBE_YT_STATE", "/srv/prod/ytdl/data")
25INTERVAL = int(os.environ.get("CHECK_INTERVAL", "1800"))25INTERVAL = int(os.environ.get("CHECK_INTERVAL", "1800"))
26SMTP_HOST = os.environ.get("SMTP_HOST", "")26SMTP_HOST = os.environ.get("SMTP_HOST", "")
27SMTP_PORT = int(os.environ.get("SMTP_PORT", "465"))27SMTP_PORT = int(os.environ.get("SMTP_PORT", "465"))
28SMTP_USER = os.environ.get("SMTP_USER", "")28SMTP_USER = os.environ.get("SMTP_USER", "")
29SMTP_PASS = os.environ.get("SMTP_PASS", "")29SMTP_PASS = os.environ.get("SMTP_PASS", "")
30MAIL_FROM = os.environ.get("MAIL_FROM", f"yt-feed@{os.environ.get('STUDIO_DOMAIN', 'studio.test')}")30MAIL_FROM = os.environ.get("MAIL_FROM", f"yt-feed@{os.environ.get('SNOWGLOBE_DOMAIN', 'snowglobe.test')}")
31MAIL_TO = os.environ.get("MAIL_TO", os.environ.get("STUDIO_OWNER_EMAIL", "account@paperclover.net"))31MAIL_TO = os.environ.get("MAIL_TO", os.environ.get("SNOWGLOBE_OWNER_EMAIL", "account@paperclover.net"))
32BASE_URL = os.environ.get("BASE_URL", f"https://snowglobe.{os.environ.get('STUDIO_DOMAIN', 'studio.test')}/youtube").rstrip("/")32BASE_URL = os.environ.get("BASE_URL", f"https://snowglobe.{os.environ.get('SNOWGLOBE_DOMAIN', 'snowglobe.test')}/youtube").rstrip("/")
33READ_ONLY = os.environ.get("STUDIO_MEDIA_READ_ONLY") == "true"33READ_ONLY = os.environ.get("SNOWGLOBE_MEDIA_READ_ONLY") == "true"
3434
35MEDIA_ROOT = os.environ.get("STUDIO_YT_MEDIA", "/srv/clover/Media")35MEDIA_ROOT = os.environ.get("SNOWGLOBE_YT_MEDIA", "/srv/clover/Media")
36INDIE_DIR = os.path.join(MEDIA_ROOT, "Indie Shows")36INDIE_DIR = os.path.join(MEDIA_ROOT, "Indie Shows")
37INDEP_DIR = os.path.join(MEDIA_ROOT, "Videos/Independent")37INDEP_DIR = os.path.join(MEDIA_ROOT, "Videos/Independent")
38MUSIC_DIR = os.path.join(MEDIA_ROOT, "Intake - Music")38MUSIC_DIR = os.path.join(MEDIA_ROOT, "Intake - Music")
dashboard/src/ai.rs+2-2
...@@ -29,7 +29,7 @@ pub async fn route(...@@ -29,7 +29,7 @@ pub async fn route(
29 {29 {
30 return Err(Error::new(30 return Err(Error::new(
31 403,31 403,
32 "Open Local AI in Snowglobe to copy its key.",32 "Open Local AI in Snow Globe to copy its key.",
33 ));33 ));
34 }34 }
35 let jobs = core::nomad(&app, "/v1/jobs").await?;35 let jobs = core::nomad(&app, "/v1/jobs").await?;
...@@ -45,7 +45,7 @@ pub async fn route(...@@ -45,7 +45,7 @@ pub async fn route(
45 )45 )
46 })?;46 })?;
47 let job = core::nomad(&app, &format!("/v1/job/{}", encoded(id))).await?;47 let job = core::nomad(&app, &format!("/v1/job/{}", encoded(id))).await?;
48 let hostname = string(&job["Meta"]["studio_hostname"]);48 let hostname = string(&job["Meta"]["snowglobe_hostname"]);
49 if hostname.is_empty()49 if hostname.is_empty()
50 || !hostname50 || !hostname
51 .bytes()51 .bytes()
dashboard/src/apps.rs+5-5
...@@ -1,7 +1,7 @@...@@ -1,7 +1,7 @@
1use crate::*;1use crate::*;
22
3pub fn file_link(path: &str, zip: bool) -> Value {3pub fn file_link(path: &str, zip: bool) -> Value {
4 let root = env("STUDIO_STORE_ROOT", "/srv");4 let root = env("SNOWGLOBE_STORE_ROOT", "/srv");
5 let Some(relative) = std::path::Path::new(path).strip_prefix(&root).ok() else {5 let Some(relative) = std::path::Path::new(path).strip_prefix(&root).ok() else {
6 return Value::Null;6 return Value::Null;
7 };7 };
...@@ -10,7 +10,7 @@ pub fn file_link(path: &str, zip: bool) -> Value {...@@ -10,7 +10,7 @@ pub fn file_link(path: &str, zip: bool) -> Value {
10 .map(|c| encoded(&c.as_os_str().to_string_lossy()))10 .map(|c| encoded(&c.as_os_str().to_string_lossy()))
11 .collect::<Vec<_>>()11 .collect::<Vec<_>>()
12 .join("/");12 .join("/");
13 let Ok(files) = std::env::var("STUDIO_FILES_URL") else {13 let Ok(files) = std::env::var("SNOWGLOBE_FILES_URL") else {
14 return Value::Null;14 return Value::Null;
15 };15 };
16 json!(format!("{files}/{path}{}", if zip { "?zip" } else { "" }))16 json!(format!("{files}/{path}{}", if zip { "?zip" } else { "" }))
...@@ -126,7 +126,7 @@ fn validate_vm(mut spec: Value) -> Result<Value> {...@@ -126,7 +126,7 @@ fn validate_vm(mut spec: Value) -> Result<Value> {
126}126}
127async fn paper(app: Arc<App>, path: &str, body: Option<Value>) -> Result<Value> {127async fn paper(app: Arc<App>, path: &str, body: Option<Value>) -> Result<Value> {
128 let jobs = core::scan(app.clone()).await?;128 let jobs = core::scan(app.clone()).await?;
129 let host = jobs.value["clover-source-of-truth"]["job"]["Meta"]["studio_hostname"]129 let host = jobs.value["clover-source-of-truth"]["job"]["Meta"]["snowglobe_hostname"]
130 .as_str()130 .as_str()
131 .ok_or_else(|| Error::new(502, "Paper Clover is unavailable."))?;131 .ok_or_else(|| Error::new(502, "Paper Clover is unavailable."))?;
132 let key = host::call(132 let key = host::call(
...@@ -141,7 +141,7 @@ async fn paper(app: Arc<App>, path: &str, body: Option<Value>) -> Result<Value>...@@ -141,7 +141,7 @@ async fn paper(app: Arc<App>, path: &str, body: Option<Value>) -> Result<Value>
141 if path == "scan" {141 if path == "scan" {
142 path.into()142 path.into()
143 } else {143 } else {
144 format!("studio/{path}")144 format!("{}/{path}", namespace::PREVIOUS.as_str())
145 }145 }
146 );146 );
147 let request = if let Some(body) = body {147 let request = if let Some(body) = body {
...@@ -422,7 +422,7 @@ pub async fn route(...@@ -422,7 +422,7 @@ pub async fn route(
422 }422 }
423 ["paper-clover"] if method == Method::GET => {423 ["paper-clover"] if method == Method::GET => {
424 let mut value = paper(app, "stats", None).await?;424 let mut value = paper(app, "stats", None).await?;
425 value["browse"] = std::env::var("STUDIO_PUBLISHED_ROOT")425 value["browse"] = std::env::var("SNOWGLOBE_PUBLISHED_ROOT")
426 .ok()426 .ok()
427 .map(|p| file_link(&p, false))427 .map(|p| file_link(&p, false))
428 .unwrap_or(Value::Null);428 .unwrap_or(Value::Null);
dashboard/src/auth.rs+4-4
...@@ -170,7 +170,7 @@ impl Store {...@@ -170,7 +170,7 @@ impl Store {
170 {170 {
171 return Err(Error::new(171 return Err(Error::new(
172 500,172 500,
173 "Set separate HTTPS origins for Snowglobe and Files.",173 "Set separate HTTPS origins for Snow Globe and Files.",
174 ));174 ));
175 }175 }
176 let rp_origin = url::Url::parse(&format!("https://{rp}"))?;176 let rp_origin = url::Url::parse(&format!("https://{rp}"))?;
...@@ -419,7 +419,7 @@ impl Store {...@@ -419,7 +419,7 @@ impl Store {
419 }419 }
420 db.execute("DELETE FROM sessions WHERE expires<=?", [now() as i64])?;420 db.execute("DELETE FROM sessions WHERE expires<=?", [now() as i64])?;
421 let ip = headers421 let ip = headers
422 .get("X-Studio-Client-IP")422 .get("X-Snowglobe-Client-IP")
423 .and_then(|v| v.to_str().ok())423 .and_then(|v| v.to_str().ok())
424 .unwrap_or("unknown");424 .unwrap_or("unknown");
425 db.execute(425 db.execute(
...@@ -439,7 +439,7 @@ impl Store {...@@ -439,7 +439,7 @@ impl Store {
439 }439 }
440 pub(crate) fn limit(&self, headers: &HeaderMap, name: &str) -> Result<()> {440 pub(crate) fn limit(&self, headers: &HeaderMap, name: &str) -> Result<()> {
441 let ip = headers441 let ip = headers
442 .get("X-Studio-Client-IP")442 .get("X-Snowglobe-Client-IP")
443 .and_then(|v| v.to_str().ok())443 .and_then(|v| v.to_str().ok())
444 .unwrap_or("unknown");444 .unwrap_or("unknown");
445 let db = self.db.lock().unwrap();445 let db = self.db.lock().unwrap();
...@@ -479,7 +479,7 @@ impl Store {...@@ -479,7 +479,7 @@ impl Store {
479 if headers.get("origin").and_then(|v| v.to_str().ok())479 if headers.get("origin").and_then(|v| v.to_str().ok())
480 != Some(self.origin.origin().ascii_serialization().as_str())480 != Some(self.origin.origin().ascii_serialization().as_str())
481 {481 {
482 return Err(Error::new(403, "Open sign-in on Snowglobe and try again."));482 return Err(Error::new(403, "Open sign-in on Snow Globe and try again."));
483 }483 }
484 let cookie = cookie(headers, CSRF_COOKIE).unwrap_or_default();484 let cookie = cookie(headers, CSRF_COOKIE).unwrap_or_default();
485 if cookie.is_empty()485 if cookie.is_empty()
dashboard/src/core.rs+23-60
...@@ -5,16 +5,18 @@ use std::path::Path;...@@ -5,16 +5,18 @@ use std::path::Path;
55
6pub async fn nomad(app: &App, path: &str) -> Result<Value> {6pub async fn nomad(app: &App, path: &str) -> Result<Value> {
7 let value = nomad_raw(app, path).await?;7 let value = nomad_raw(app, path).await?;
8 Ok(value8 let mut value = value
9 .map(|bytes| serde_json::from_slice(&bytes))9 .map(|bytes| serde_json::from_slice(&bytes))
10 .transpose()?10 .transpose()?
11 .unwrap_or(Value::Null))11 .unwrap_or(Value::Null);
12 namespace::nomad(&mut value);
13 Ok(value)
12}14}
13pub async fn nomad_raw(app: &App, path: &str) -> Result<Option<Bytes>> {15pub async fn nomad_raw(app: &App, path: &str) -> Result<Option<Bytes>> {
14 let request = async {16 let request = async {
15 let token = tokio::fs::read_to_string(env(17 let token = tokio::fs::read_to_string(env(
16 "STUDIO_NOMAD_TOKEN_FILE",18 "SNOWGLOBE_NOMAD_TOKEN_FILE",
17 "/var/lib/studio/dashboard.token",19 "/var/lib/snowglobe/dashboard.token",
18 ))20 ))
19 .await21 .await
20 .map_err(|e| Error::new(501, format!("Nomad isn't connected: {e}")))?;22 .map_err(|e| Error::new(501, format!("Nomad isn't connected: {e}")))?;
...@@ -222,25 +224,12 @@ pub async fn service_file(app: &App, id: &str) -> Result<PathBuf> {...@@ -222,25 +224,12 @@ pub async fn service_file(app: &App, id: &str) -> Result<PathBuf> {
222 if !valid_id(id) {224 if !valid_id(id) {
223 return Err(Error::new(400, "Invalid service ID."));225 return Err(Error::new(400, "Invalid service ID."));
224 }226 }
225 let excluded = excluded_services(&app.repo).await?;
226 if excluded.iter().any(|service| service == id) {
227 return Err(Error::new(
228 404,
229 format!("No service is named {id}. Pick one from the sidebar."),
230 ));
231 }
232 let direct = app.repo.join("service").join(id).join("service.pkl");227 let direct = app.repo.join("service").join(id).join("service.pkl");
233 if tokio::fs::try_exists(&direct).await? {228 if tokio::fs::try_exists(&direct).await? {
234 return Ok(direct);229 return Ok(direct);
235 }230 }
236 let mut dirs = tokio::fs::read_dir(app.repo.join("service")).await?;231 let mut dirs = tokio::fs::read_dir(app.repo.join("service")).await?;
237 while let Some(dir) = dirs.next_entry().await? {232 while let Some(dir) = dirs.next_entry().await? {
238 if excluded
239 .iter()
240 .any(|service| dir.file_name() == service.as_str())
241 {
242 continue;
243 }
244 let file = dir.path().join(format!("{id}.pkl"));233 let file = dir.path().join(format!("{id}.pkl"));
245 if tokio::fs::try_exists(&file).await? {234 if tokio::fs::try_exists(&file).await? {
246 return Ok(file);235 return Ok(file);
...@@ -264,7 +253,7 @@ async fn icons(app: Arc<App>, id: String) -> Result<Arc<Document>> {...@@ -264,7 +253,7 @@ async fn icons(app: Arc<App>, id: String) -> Result<Arc<Document>> {
264 let mut found = serde_json::Map::new();253 let mut found = serde_json::Map::new();
265 for file in ["icon.svg","icon-light.svg","icon-dark.svg"] {254 for file in ["icon.svg","icon-light.svg","icon-dark.svg"] {
266 let candidate = dir.join(file);255 let candidate = dir.join(file);
267 let fallback = PathBuf::from(env("STUDIO_ICON_DIR","server/icons")).join(&id).join(file);256 let fallback = PathBuf::from(env("SNOWGLOBE_ICON_DIR","server/icons")).join(&id).join(file);
268 let path = if tokio::fs::try_exists(&candidate).await? { candidate } else { fallback };257 let path = if tokio::fs::try_exists(&candidate).await? { candidate } else { fallback };
269 if let Ok(bytes) = tokio::fs::read(&path).await {258 if let Ok(bytes) = tokio::fs::read(&path).await {
270 found.insert(file.to_owned(),json!({"path":path,"hash":format!("{:x}",Sha1::digest(&bytes))[..12].to_owned()}));259 found.insert(file.to_owned(),json!({"path":path,"hash":format!("{:x}",Sha1::digest(&bytes))[..12].to_owned()}));
...@@ -350,7 +339,7 @@ async fn summarize(app: Arc<App>, id: &str, found: &Value) -> Value {...@@ -350,7 +339,7 @@ async fn summarize(app: Arc<App>, id: &str, found: &Value) -> Value {
350 }339 }
351 })340 })
352 .sum();341 .sum();
353 json!({"id":id,"name":meta["studio_name"].as_str().unwrap_or(id),"health":found["health"].as_str().unwrap_or("down"),"url":meta["studio_hostname"].as_str().filter(|h| !h.is_empty() && meta["studio_launcher"] != "false").map(|h| format!("https://{h}")),"icon":icon_of(app.clone(),id).await,"access":meta["studio_auth_role"],"tagline":meta["studio_tagline"],"cpu":usage["cpu"],"cpuLimit":if mhz > 0.0 { cpu/mhz } else {0.0},"memory":usage["memory"],"memoryLimit":memory*1048576.0})342 json!({"id":id,"name":meta["snowglobe_name"].as_str().unwrap_or(id),"health":found["health"].as_str().unwrap_or("down"),"url":meta["snowglobe_hostname"].as_str().filter(|h| !h.is_empty() && meta["snowglobe_launcher"] != "false").map(|h| format!("https://{h}")),"icon":icon_of(app.clone(),id).await,"access":meta["snowglobe_auth_role"],"tagline":meta["snowglobe_tagline"],"cpu":usage["cpu"],"cpuLimit":if mhz > 0.0 { cpu/mhz } else {0.0},"memory":usage["memory"],"memoryLimit":memory*1048576.0})
354}343}
355async fn summaries(app: Arc<App>) -> Result<Arc<Document>> {344async fn summaries(app: Arc<App>) -> Result<Arc<Document>> {
356 let state = app.clone();345 let state = app.clone();
...@@ -444,19 +433,11 @@ async fn issues(app: Arc<App>) -> Result<Value> {...@@ -444,19 +433,11 @@ async fn issues(app: Arc<App>) -> Result<Value> {
444 Ok(json!(issues))433 Ok(json!(issues))
445}434}
446435
447async fn excluded_services(repo: &Path) -> Result<Vec<String>> {
448 Ok(serde_json::from_slice(
449 &tokio::fs::read(repo.join("config/excluded-services.json")).await?,
450 )?)
451}
452
453async fn launcher_module(repo: &Path) -> Result<String> {436async fn launcher_module(repo: &Path) -> Result<String> {
454 let excluded = excluded_services(repo).await?;
455 let mut files = Vec::new();437 let mut files = Vec::new();
456 let mut directories = tokio::fs::read_dir(repo.join("service")).await?;438 let mut directories = tokio::fs::read_dir(repo.join("service")).await?;
457 while let Some(directory) = directories.next_entry().await? {439 while let Some(directory) = directories.next_entry().await? {
458 let directory_name = directory.file_name().to_string_lossy().into_owned();440 if !directory.file_type().await?.is_dir() {
459 if excluded.contains(&directory_name) || !directory.file_type().await?.is_dir() {
460 continue;441 continue;
461 }442 }
462 let mut entries = tokio::fs::read_dir(directory.path()).await?;443 let mut entries = tokio::fs::read_dir(directory.path()).await?;
...@@ -465,14 +446,7 @@ async fn launcher_module(repo: &Path) -> Result<String> {...@@ -465,14 +446,7 @@ async fn launcher_module(repo: &Path) -> Result<String> {
465 if !path.extension().is_some_and(|extension| extension == "pkl") {446 if !path.extension().is_some_and(|extension| extension == "pkl") {
466 continue;447 continue;
467 }448 }
468 let name = if entry.file_name() == "service.pkl" {449 files.push(path);
469 directory_name.clone()
470 } else {
471 path.file_stem().unwrap().to_string_lossy().into_owned()
472 };
473 if !excluded.contains(&name) {
474 files.push(path);
475 }
476 }450 }
477 }451 }
478 files.sort();452 files.sort();
...@@ -485,11 +459,11 @@ async fn launcher_module(repo: &Path) -> Result<String> {...@@ -485,11 +459,11 @@ async fn launcher_module(repo: &Path) -> Result<String> {
485 }459 }
486 module.push_str(&format!("local services = Map({})\n", services.join(", ")));460 module.push_str(&format!("local services = Map({})\n", services.join(", ")));
487 module.push_str(r#"output { renderer = new JsonRenderer { omitNullProperties = false }461 module.push_str(r#"output { renderer = new JsonRenderer { omitNullProperties = false }
488value = services.filter((_, s) -> s.enabled && s.meta.launcher).mapValues((_, s) ->462value = services.filter((_, s) -> s.enabled && s.launcher).mapValues((_, s) ->
489let (tasks = s.containers?.toMap() ?? Map("app", s.container))463let (tasks = s.containers?.toMap() ?? Map("app", s.container))
490let (routes = tasks.filter((_, task) -> task?.http?.hostname != null).mapValues((_, task) -> task.http))464let (routes = tasks.filter((_, task) -> task?.http?.hostname != null).mapValues((_, task) -> task.http))
491let (route = routes.values.firstOrNull)465let (route = routes.values.firstOrNull)
492new Dynamic { name = s.meta.name; tagline = s.meta.tagline; hostname = route?.hostname; access = s.meta.access ?? route?.authRole; urls = routes.mapValues((_, http) -> "https://\(http.hostname)") }) }"#);466new Dynamic { name = s.name; tagline = s.tagline; hostname = route?.hostname; access = s.access ?? route?.authRole; urls = routes.mapValues((_, http) -> "https://\(http.hostname)") }) }"#);
493 Ok(module)467 Ok(module)
494}468}
495469
...@@ -534,7 +508,7 @@ async fn service(app: Arc<App>, id: &str) -> Result<Arc<Document>> {...@@ -534,7 +508,7 @@ async fn service(app: Arc<App>, id: &str) -> Result<Arc<Document>> {
534 .map(|s| json!({"id":other,"name":s["name"],"kind":kind,"health":s["health"]}))508 .map(|s| json!({"id":other,"name":s["name"],"kind":kind,"health":s["health"]}))
535 };509 };
536 let needs = |other: &str| {510 let needs = |other: &str| {
537 serde_json::from_str::<Value>(string(&jobs.value[other]["job"]["Meta"]["studio_requires"]))511 serde_json::from_str::<Value>(string(&jobs.value[other]["job"]["Meta"]["snowglobe_requires"]))
538 .ok()512 .ok()
539 };513 };
540 let requirements = needs(id).map(|n| {514 let requirements = needs(id).map(|n| {
...@@ -557,7 +531,7 @@ async fn service(app: Arc<App>, id: &str) -> Result<Arc<Document>> {...@@ -557,7 +531,7 @@ async fn service(app: Arc<App>, id: &str) -> Result<Arc<Document>> {
557 };531 };
558 let mut summary = summarize(app.clone(), id, found).await;532 let mut summary = summarize(app.clone(), id, found).await;
559 let meta = &found["job"]["Meta"];533 let meta = &found["job"]["Meta"];
560 let application_traces = if let Some(name) = meta["studio_trace_service"]534 let application_traces = if let Some(name) = meta["snowglobe_trace_service"]
561 .as_str()535 .as_str()
562 .filter(|s| !s.is_empty())536 .filter(|s| !s.is_empty())
563 {537 {
...@@ -568,7 +542,7 @@ async fn service(app: Arc<App>, id: &str) -> Result<Arc<Document>> {...@@ -568,7 +542,7 @@ async fn service(app: Arc<App>, id: &str) -> Result<Arc<Document>> {
568 false542 false
569 };543 };
570 let metrics =544 let metrics =
571 if array(&found["job"]["TaskGroups"]).iter().flat_map(|g| array(&g["Services"])).any(|s| array(&s["Tags"]).iter().any(|tag| string(tag).starts_with("studio-metrics-path="))) || meta["studio_metrics_pushed"] == "true" {545 if array(&found["job"]["TaskGroups"]).iter().flat_map(|g| array(&g["Services"])).any(|s| array(&s["Tags"]).iter().any(|tag| string(tag).starts_with("snowglobe-metrics-path="))) || meta["snowglobe_metrics_pushed"] == "true" {
572 telemetry::metric_names(app.clone(), id)546 telemetry::metric_names(app.clone(), id)
573 .await547 .await
574 .unwrap_or(json!([]))548 .unwrap_or(json!([]))
...@@ -576,7 +550,7 @@ async fn service(app: Arc<App>, id: &str) -> Result<Arc<Document>> {...@@ -576,7 +550,7 @@ async fn service(app: Arc<App>, id: &str) -> Result<Arc<Document>> {
576 json!([])550 json!([])
577 };551 };
578 let release = host::call(json!({"operation":"deploy.current"})).await?;552 let release = host::call(json!({"operation":"deploy.current"})).await?;
579 let secrets = serde_json::from_str::<Value>(string(&meta["studio_secrets"]))553 let secrets = serde_json::from_str::<Value>(string(&meta["snowglobe_secrets"]))
580 .ok()554 .ok()
581 .map(|v| {555 .map(|v| {
582 array(&v)556 array(&v)
...@@ -851,34 +825,23 @@ async fn definition(app: Arc<App>, id: &str) -> Result<Value> {...@@ -851,34 +825,23 @@ async fn definition(app: Arc<App>, id: &str) -> Result<Value> {
851mod tests {825mod tests {
852 use super::*;826 use super::*;
853 #[tokio::test]827 #[tokio::test]
854 async fn launcher_excludes_directories_and_grouped_definitions_before_import() {828 async fn launcher_discovers_direct_and_grouped_definitions() {
855 let root = std::env::temp_dir().join(format!("studio-launcher-{}", uuid::Uuid::new_v4()));829 let root = std::env::temp_dir().join(format!("snowglobe-launcher-{}", uuid::Uuid::new_v4()));
856 tokio::fs::create_dir_all(root.join("config"))830 tokio::fs::create_dir_all(root.join("service/personal"))
857 .await831 .await
858 .unwrap();832 .unwrap();
859 for directory in ["retired", "personal"] {833 tokio::fs::write(root.join("service/README.md"), "not a service")
860 tokio::fs::create_dir_all(root.join("service").join(directory))
861 .await
862 .unwrap();
863 }
864 tokio::fs::write(root.join("config/excluded-services.json"), r#"["retired"]"#)
865 .await834 .await
866 .unwrap();835 .unwrap();
867 for file in [836 for file in ["service.pkl", "fixture.pkl", "icon.svg"] {
868 "retired/service.pkl",837 tokio::fs::write(root.join("service/personal").join(file), "unread fixture")
869 "personal/retired.pkl",
870 "personal/service.pkl",
871 "personal/fixture.pkl",
872 ] {
873 tokio::fs::write(root.join("service").join(file), "unread fixture")
874 .await838 .await
875 .unwrap();839 .unwrap();
876 }840 }
877 let module = launcher_module(&root).await.unwrap();841 let module = launcher_module(&root).await.unwrap();
878 assert!(!module.contains("retired"));
879 assert!(!module.contains("import*"));
880 assert!(module.contains("/personal/service.pkl"));842 assert!(module.contains("/personal/service.pkl"));
881 assert!(module.contains("/personal/fixture.pkl"));843 assert!(module.contains("/personal/fixture.pkl"));
844 assert!(!module.contains("icon.svg"));
882 assert_eq!(845 assert_eq!(
883 module846 module
884 .lines()847 .lines()
dashboard/src/deploys.rs+1-1
...@@ -15,7 +15,7 @@ async fn stages(app: Arc<App>) -> Result<Value> {...@@ -15,7 +15,7 @@ async fn stages(app: Arc<App>) -> Result<Value> {
15 for stage in values.as_array_mut().unwrap() {15 for stage in values.as_array_mut().unwrap() {
16 let job = jobs.as_ref().map(|jobs| &jobs.value[string(&stage["id"])]);16 let job = jobs.as_ref().map(|jobs| &jobs.value[string(&stage["id"])]);
17 stage["hostname"] = json!(17 stage["hostname"] = json!(
18 job.and_then(|job| job["job"]["Meta"]["studio_hostname"].as_str())18 job.and_then(|job| job["job"]["Meta"]["snowglobe_hostname"].as_str())
19 .filter(|hostname| !hostname.is_empty())19 .filter(|hostname| !hostname.is_empty())
20 );20 );
21 stage["health"] = json!(job.map(|job| job["health"].as_str().unwrap_or("down")));21 stage["health"] = json!(job.map(|job| job["health"].as_str().unwrap_or("down")));
dashboard/src/files.rs+8-8
...@@ -52,7 +52,7 @@ struct Explorer {...@@ -52,7 +52,7 @@ struct Explorer {
52}52}
53impl Explorer {53impl Explorer {
54 async fn new(root: PathBuf) -> Result<Self> {54 async fn new(root: PathBuf) -> Result<Self> {
55 let store = PathBuf::from(env("STUDIO_STORE_ROOT", "/srv"));55 let store = PathBuf::from(env("SNOWGLOBE_STORE_ROOT", "/srv"));
56 let scope = root56 let scope = root
57 .strip_prefix(&store)57 .strip_prefix(&store)
58 .map_err(|_| Error::new(500, "Library root is outside the store."))?58 .map_err(|_| Error::new(500, "Library root is outside the store."))?
...@@ -577,7 +577,7 @@ async fn prune(ops: &Value) -> Result<()> {...@@ -577,7 +577,7 @@ async fn prune(ops: &Value) -> Result<()> {
577 let mounts = mounts().await?;577 let mounts = mounts().await?;
578 let datasets: HashSet<_> = array(&mounts)578 let datasets: HashSet<_> = array(&mounts)
579 .iter()579 .iter()
580 .filter(|m| Path::new(string(&m["target"])).starts_with(env("STUDIO_STORE_ROOT", "/srv")))580 .filter(|m| Path::new(string(&m["target"])).starts_with(env("SNOWGLOBE_STORE_ROOT", "/srv")))
581 .map(|m| string(&m["source"]))581 .map(|m| string(&m["source"]))
582 .collect();582 .collect();
583 if datasets.is_empty() {583 if datasets.is_empty() {
...@@ -605,11 +605,11 @@ pub async fn route(...@@ -605,11 +605,11 @@ pub async fn route(
605) -> Result<Response> {605) -> Result<Response> {
606 let root = if media {606 let root = if media {
607 env(607 env(
608 "STUDIO_MEDIA_ROOT",608 "SNOWGLOBE_MEDIA_ROOT",
609 &format!("{}/clover/Media", env("STUDIO_STORE_ROOT", "/srv")),609 &format!("{}/clover/Media", env("SNOWGLOBE_STORE_ROOT", "/srv")),
610 )610 )
611 } else {611 } else {
612 env("STUDIO_STORE_ROOT", "/srv")612 env("SNOWGLOBE_STORE_ROOT", "/srv")
613 };613 };
614 let explorer = Explorer::new(root.into()).await?;614 let explorer = Explorer::new(root.into()).await?;
615 if parts == ["refresh"] && media && method == Method::POST {615 if parts == ["refresh"] && media && method == Method::POST {
...@@ -719,7 +719,7 @@ async fn change(...@@ -719,7 +719,7 @@ async fn change(
719 parts: &[&str],719 parts: &[&str],
720 body: Value,720 body: Value,
721) -> Result<Response> {721) -> Result<Response> {
722 if env("STUDIO_FILES_WRITABLE", "") != "1" {722 if env("SNOWGLOBE_FILES_WRITABLE", "") != "1" {
723 return Err(Error::new(723 return Err(Error::new(
724 501,724 501,
725 "The file browser can't change files yet. Use copyparty instead.",725 "The file browser can't change files yet. Use copyparty instead.",
...@@ -1064,7 +1064,7 @@ async fn revert(explorer: &Explorer, op: &Value, mounts: &Value) -> Result<()> {...@@ -1064,7 +1064,7 @@ async fn revert(explorer: &Explorer, op: &Value, mounts: &Value) -> Result<()> {
1064 Ok(())1064 Ok(())
1065}1065}
1066async fn refresh(app: Arc<App>) -> Result<Response> {1066async fn refresh(app: Arc<App>) -> Result<Response> {
1067 let base = std::env::var("STUDIO_JELLYFIN_URL")1067 let base = std::env::var("SNOWGLOBE_JELLYFIN_URL")
1068 .map_err(|_| Error::new(501, "Jellyfin isn't connected to the dashboard."))?;1068 .map_err(|_| Error::new(501, "Jellyfin isn't connected to the dashboard."))?;
1069 let password = host::call(1069 let password = host::call(
1070 json!({"operation":"deploy.secret.get","service":"jellyfin","key":"admin_password"}),1070 json!({"operation":"deploy.secret.get","service":"jellyfin","key":"admin_password"}),
...@@ -1078,7 +1078,7 @@ async fn refresh(app: Arc<App>) -> Result<Response> {...@@ -1078,7 +1078,7 @@ async fn refresh(app: Arc<App>) -> Result<Response> {
1078 .post(format!("{base}/Users/AuthenticateByName"))1078 .post(format!("{base}/Users/AuthenticateByName"))
1079 .header(1079 .header(
1080 "Authorization",1080 "Authorization",
1081 "MediaBrowser Client=\"home server\", Device=\"server\", DeviceId=\"studio\", Version=\"1\"",1081 "MediaBrowser Client=\"home server\", Device=\"server\", DeviceId=\"snowglobe\", Version=\"1\"",
1082 )1082 )
1083 .json(&json!({"Username":"snow","Pw":password}))1083 .json(&json!({"Username":"snow","Pw":password}))
1084 .send()1084 .send()
dashboard/src/guest.rs+3-3
...@@ -92,7 +92,7 @@ pub fn providers(auth: &auth::Store, next: &str) -> Result<Value> {...@@ -92,7 +92,7 @@ pub fn providers(auth: &auth::Store, next: &str) -> Result<Value> {
9292
93fn registration(auth: &auth::Store, provider: &str) -> Result<(String, String)> {93fn registration(auth: &auth::Store, provider: &str) -> Result<(String, String)> {
94 auth.db.lock().unwrap().query_row("SELECT client_id,secret FROM guest_providers WHERE id=?", [provider], |r|Ok((r.get(0)?,r.get(1)?)))94 auth.db.lock().unwrap().query_row("SELECT client_id,secret FROM guest_providers WHERE id=?", [provider], |r|Ok((r.get(0)?,r.get(1)?)))
95 .optional()?.ok_or_else(|| Error::new(503, "This sign-in provider isn't available. Use your Snowglobe account or try again later."))95 .optional()?.ok_or_else(|| Error::new(503, "This sign-in provider isn't available. Use your Snow Globe account or try again later."))
96}96}
9797
98async fn response_bytes(mut response: reqwest::Response) -> Result<Vec<u8>> {98async fn response_bytes(mut response: reqwest::Response) -> Result<Vec<u8>> {
...@@ -528,7 +528,7 @@ async fn handle(app: &App, request: Request) -> Result<Response> {...@@ -528,7 +528,7 @@ async fn handle(app: &App, request: Request) -> Result<Response> {
528 if !current.is_null() && !is_guest(&current) {528 if !current.is_null() && !is_guest(&current) {
529 return Err(Error::new(529 return Err(Error::new(
530 403,530 403,
531 "You're signed into Snowglobe. Open Shale to use your account.",531 "You're signed into Snow Globe. Open Shale to use your account.",
532 ));532 ));
533 }533 }
534 let callback = format!("{}auth/guest/callback/{provider}", auth.origin);534 let callback = format!("{}auth/guest/callback/{provider}", auth.origin);
...@@ -616,7 +616,7 @@ async fn handle(app: &App, request: Request) -> Result<Response> {...@@ -616,7 +616,7 @@ async fn handle(app: &App, request: Request) -> Result<Response> {
616 let http = reqwest::Client::builder()616 let http = reqwest::Client::builder()
617 .timeout(Duration::from_secs(10))617 .timeout(Duration::from_secs(10))
618 .redirect(reqwest::redirect::Policy::none())618 .redirect(reqwest::redirect::Policy::none())
619 .user_agent("Snowglobe guest sign-in")619 .user_agent("Snow Globe guest sign-in")
620 .default_headers({620 .default_headers({
621 let mut headers = HeaderMap::new();621 let mut headers = HeaderMap::new();
622 headers.insert("accept", "application/json".parse().unwrap());622 headers.insert("accept", "application/json".parse().unwrap());
dashboard/src/host.rs+2-2
...@@ -41,8 +41,8 @@ pub async fn open(request: Value) -> Result<(Value, tokio::net::UnixStream)> {...@@ -41,8 +41,8 @@ pub async fn open(request: Value) -> Result<(Value, tokio::net::UnixStream)> {
41 };41 };
42 tokio::time::timeout(Duration::from_secs(timeout), async {42 tokio::time::timeout(Duration::from_secs(timeout), async {
43 let mut socket = tokio::net::UnixStream::connect(env(43 let mut socket = tokio::net::UnixStream::connect(env(
44 "STUDIO_HOST_SOCKET",44 "SNOWGLOBE_HOST_SOCKET",
45 "/run/studio-host/host.sock",45 "/run/snowglobe-host/host.sock",
46 ))46 ))
47 .await?;47 .await?;
48 #[cfg(target_os = "linux")]48 #[cfg(target_os = "linux")]
dashboard/src/index.rs+3-3
...@@ -820,7 +820,7 @@ pub async fn route(app: Arc<App>, kind: &str, query: &HashMap<String, String>) -...@@ -820,7 +820,7 @@ pub async fn route(app: Arc<App>, kind: &str, query: &HashMap<String, String>) -
820 })?820 })?
821 .clone();821 .clone();
822 let _slot = app.heavy.acquire().await?;822 let _slot = app.heavy.acquire().await?;
823 let root = env("STUDIO_STORE_ROOT", "/srv");823 let root = env("SNOWGLOBE_STORE_ROOT", "/srv");
824 let rel = crate::files::relative(824 let rel = crate::files::relative(
825 query.get("path").map(String::as_str).unwrap_or_default(),825 query.get("path").map(String::as_str).unwrap_or_default(),
826 false,826 false,
...@@ -849,7 +849,7 @@ mod tests {...@@ -849,7 +849,7 @@ mod tests {
849849
850 #[test]850 #[test]
851 fn reads_recover_interrupted_updates() {851 fn reads_recover_interrupted_updates() {
852 if let Ok(file) = std::env::var("STUDIO_INDEX_CRASH_TEST_DB") {852 if let Ok(file) = std::env::var("SNOWGLOBE_INDEX_CRASH_TEST_DB") {
853 let db = Connection::open(file).unwrap();853 let db = Connection::open(file).unwrap();
854 db.execute_batch("PRAGMA cache_size=1; BEGIN IMMEDIATE; UPDATE file SET size=99;")854 db.execute_batch("PRAGMA cache_size=1; BEGIN IMMEDIATE; UPDATE file SET size=99;")
855 .unwrap();855 .unwrap();
...@@ -869,7 +869,7 @@ mod tests {...@@ -869,7 +869,7 @@ mod tests {
869 assert!(869 assert!(
870 std::process::Command::new(std::env::current_exe().unwrap())870 std::process::Command::new(std::env::current_exe().unwrap())
871 .args(["--exact", thread.name().unwrap()])871 .args(["--exact", thread.name().unwrap()])
872 .env("STUDIO_INDEX_CRASH_TEST_DB", &file)872 .env("SNOWGLOBE_INDEX_CRASH_TEST_DB", &file)
873 .status()873 .status()
874 .unwrap()874 .unwrap()
875 .success()875 .success()
dashboard/src/main.rs+62-33
...@@ -10,6 +10,7 @@ mod guest;...@@ -10,6 +10,7 @@ mod guest;
10mod host;10mod host;
11mod index;11mod index;
12mod mcp;12mod mcp;
13mod namespace;
13mod observability;14mod observability;
14mod oidc;15mod oidc;
15mod relay;16mod relay;
...@@ -113,6 +114,9 @@ struct App {...@@ -113,6 +114,9 @@ struct App {
113}114}
114impl App {115impl App {
115 fn request(&self, method: Method, address: &str) -> Result<reqwest::RequestBuilder> {116 fn request(&self, method: Method, address: &str) -> Result<reqwest::RequestBuilder> {
117 if env("SNOWGLOBE_PREVIEW", "") == "1" && !matches!(method, Method::GET | Method::HEAD) {
118 return Err(Error::new(403, "This preview cannot change other services. Use production for app controls."));
119 }
116 let url = url::Url::parse(address)?;120 let url = url::Url::parse(address)?;
117 let client = match &self.internal {121 let client = match &self.internal {
118 Some((base, client)) if url.origin() == base.origin() => client,122 Some((base, client)) if url.origin() == base.origin() => client,
...@@ -264,6 +268,11 @@ async fn api(State(app): State<Arc<App>>, request: Request) -> Result<Response>...@@ -264,6 +268,11 @@ async fn api(State(app): State<Arc<App>>, request: Request) -> Result<Response>
264 return users::picture(&app, &parts).await;268 return users::picture(&app, &parts).await;
265 }269 }
266 let me = user(request.headers())?;270 let me = user(request.headers())?;
271 if env("SNOWGLOBE_PREVIEW", "") == "1"
272 && matches!(parts[0], "seedbox" | "youtube" | "paper-clover")
273 {
274 return Err(Error::new(403, "This app uses production data. Open it in production to continue."));
275 }
267 let headers = request.headers().clone();276 let headers = request.headers().clone();
268 let section = match parts.first().copied().unwrap_or_default() {277 let section = match parts.first().copied().unwrap_or_default() {
269 "host" | "metrics" | "live" => Some("metrics"),278 "host" | "metrics" | "live" => Some("metrics"),
...@@ -344,8 +353,8 @@ async fn api(State(app): State<Arc<App>>, request: Request) -> Result<Response>...@@ -344,8 +353,8 @@ async fn api(State(app): State<Arc<App>>, request: Request) -> Result<Response>
344353
345#[tokio::main(worker_threads = 4)]354#[tokio::main(worker_threads = 4)]
346async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {355async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
347 let address: std::net::IpAddr = env("STUDIO_LISTEN_ADDRESS", "127.0.0.1").parse()?;356 let address: std::net::IpAddr = env("SNOWGLOBE_LISTEN_ADDRESS", "127.0.0.1").parse()?;
348 let proof = match std::env::var_os("STUDIO_PROXY_TOKEN_FILE") {357 let proof = match std::env::var_os("SNOWGLOBE_PROXY_TOKEN_FILE").filter(|file| !file.is_empty()) {
349 Some(file) => {358 Some(file) => {
350 let token = std::fs::read_to_string(file)?.trim().to_owned();359 let token = std::fs::read_to_string(file)?.trim().to_owned();
351 if token.len() != 64 || !token.bytes().all(|b| b.is_ascii_hexdigit()) {360 if token.len() != 64 || !token.bytes().all(|b| b.is_ascii_hexdigit()) {
...@@ -359,13 +368,13 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {...@@ -359,13 +368,13 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
359 None if address.is_loopback() => None,368 None if address.is_loopback() => None,
360 None => {369 None => {
361 return Err(std::io::Error::other(370 return Err(std::io::Error::other(
362 "Set STUDIO_PROXY_TOKEN_FILE before listening on a non-loopback address.",371 "Set SNOWGLOBE_PROXY_TOKEN_FILE before listening on a non-loopback address.",
363 )372 )
364 .into());373 .into());
365 }374 }
366 };375 };
367 let certificates = if let Ok(path) =376 let certificates = if let Ok(path) =
368 std::env::var("STUDIO_CA_BUNDLE").or_else(|_| std::env::var("NODE_EXTRA_CA_CERTS"))377 std::env::var("SNOWGLOBE_CA_BUNDLE").or_else(|_| std::env::var("NODE_EXTRA_CA_CERTS"))
369 {378 {
370 reqwest::Certificate::from_pem_bundle(&std::fs::read(path)?)?379 reqwest::Certificate::from_pem_bundle(&std::fs::read(path)?)?
371 } else {380 } else {
...@@ -378,7 +387,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {...@@ -378,7 +387,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
378 }387 }
379 http388 http
380 };389 };
381 let internal = std::env::var("STUDIO_INTERNAL_URL")390 let internal = std::env::var("SNOWGLOBE_INTERNAL_URL")
382 .ok()391 .ok()
383 .map(392 .map(
384 |address| -> std::result::Result<_, Box<dyn std::error::Error>> {393 |address| -> std::result::Result<_, Box<dyn std::error::Error>> {
...@@ -392,17 +401,17 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {...@@ -392,17 +401,17 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
392 || base.fragment().is_some()401 || base.fragment().is_some()
393 {402 {
394 return Err(std::io::Error::other(403 return Err(std::io::Error::other(
395 "STUDIO_INTERNAL_URL must be an HTTPS origin.",404 "SNOWGLOBE_INTERNAL_URL must be an HTTPS origin.",
396 )405 )
397 .into());406 .into());
398 }407 }
399 let token = proof.as_ref().ok_or_else(|| {408 let token = proof.as_ref().ok_or_else(|| {
400 std::io::Error::other("STUDIO_INTERNAL_URL requires STUDIO_PROXY_TOKEN_FILE.")409 std::io::Error::other("SNOWGLOBE_INTERNAL_URL requires SNOWGLOBE_PROXY_TOKEN_FILE.")
401 })?;410 })?;
402 let mut value = axum::http::HeaderValue::from_str(token)?;411 let mut value = axum::http::HeaderValue::from_str(token)?;
403 value.set_sensitive(true);412 value.set_sensitive(true);
404 let mut headers = HeaderMap::new();413 let mut headers = HeaderMap::new();
405 headers.insert("Studio-Proxy-Token", value);414 headers.insert("Snowglobe-Proxy-Token", value);
406 Ok((415 Ok((
407 base,416 base,
408 client()417 client()
...@@ -425,35 +434,55 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {...@@ -425,35 +434,55 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
425 let mut token = axum::http::HeaderValue::from_str(proof.as_ref().unwrap())?;434 let mut token = axum::http::HeaderValue::from_str(proof.as_ref().unwrap())?;
426 token.set_sensitive(true);435 token.set_sensitive(true);
427 let mut headers = HeaderMap::new();436 let mut headers = HeaderMap::new();
428 headers.insert("Studio-Proxy-Token", token);437 headers.insert("Snowglobe-Proxy-Token", token);
429 shale_http = shale_http.default_headers(headers);438 shale_http = shale_http.default_headers(headers);
430 }439 }
431 let shale_http = shale_http.build()?;440 let shale_http = shale_http.build()?;
432 let (live, _) = watch::channel(Bytes::new());441 let (live, _) = watch::channel(Bytes::new());
433 let index = std::env::var("STUDIO_INDEX_POOL").ok().map(|pool| {442 let index = std::env::var("SNOWGLOBE_INDEX_POOL").ok().map(|pool| {
434 Arc::new(index::Index::new(443 Arc::new(index::Index::new(
435 pool,444 pool,
436 env("STUDIO_INDEX_DIR", ".cache/index").into(),445 env("SNOWGLOBE_INDEX_DIR", ".cache/index").into(),
437 ))446 ))
438 });447 });
439 let origin = env(448 let origin = env(
440 "STUDIO_PUBLIC_ORIGIN",449 "SNOWGLOBE_PUBLIC_ORIGIN",
441 &format!("https://snowglobe.{}", env("STUDIO_DOMAIN", "studio.test")),450 &format!("https://snowglobe.{}", env("SNOWGLOBE_DOMAIN", "snowglobe.test")),
442 );451 );
443 let auth = auth::Store::new(452 let auth = auth::Store::new(
444 &PathBuf::from(env("STUDIO_DATA_DIR", "data")),453 &PathBuf::from(env("SNOWGLOBE_DATA_DIR", "data")),
445 &origin,454 &origin,
446 &env(455 &env(
447 "STUDIO_FILE_ORIGIN",456 "SNOWGLOBE_FILE_ORIGIN",
448 &format!("https://file.{}", env("STUDIO_DOMAIN", "studio.test")),457 &format!("https://file.{}", env("SNOWGLOBE_DOMAIN", "snowglobe.test")),
449 ),458 ),
450 &env(459 &env(
451 "STUDIO_AUTH_RP_ID",460 "SNOWGLOBE_AUTH_RP_ID",
452 &format!("auth.{}", env("STUDIO_DOMAIN", "studio.test")),461 &format!("auth.{}", env("SNOWGLOBE_DOMAIN", "snowglobe.test")),
453 ),462 ),
454 )463 )
455 .map_err(|error| std::io::Error::other(error.message))?;464 .map_err(|error| std::io::Error::other(error.message))?;
456 if let Some(path) = std::env::args().skip(1).next() {465 if let Some(path) = std::env::args().skip(1).next() {
466 if path == "--preview-account" {
467 if auth.ready() {
468 return Err(std::io::Error::other("Preview accounts require an empty store.").into());
469 }
470 let id = uuid::Uuid::new_v4().to_string();
471 let role = uuid::Uuid::new_v4().to_string();
472 let password = mcp::secret();
473 auth.import(json!({"rpId":env("SNOWGLOBE_AUTH_RP_ID", "auth.snowglobe.test"),
474 "roles":[{"id":role,"name":"infra-admin"}],
475 "users":[{"id":id,"username":"preview","enabled":true,
476 "firstName":"Preview","lastName":"Account","email":"preview@example.invalid",
477 "emailVerified":false,"requiredActions":[],"roles":[role],"credentials":[]}]}))
478 .map_err(|error| std::io::Error::other(error.message))?;
479 let hash = auth::password_hash(&password)
480 .map_err(|error| std::io::Error::other(error.message))?;
481 auth::set_password(&auth.db.lock().unwrap(), &id, &hash)
482 .map_err(|error| std::io::Error::other(error.message))?;
483 println!("{}", json!({"username":"preview","password":password}));
484 return Ok(());
485 }
457 if path == "--import-commit-identity" {486 if path == "--import-commit-identity" {
458 let input = serde_json::from_reader(std::io::stdin())?;487 let input = serde_json::from_reader(std::io::stdin())?;
459 let output = identity::import(&auth, &input).map_err(|error| std::io::Error::other(error.message))?;488 let output = identity::import(&auth, &input).map_err(|error| std::io::Error::other(error.message))?;
...@@ -486,13 +515,13 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {...@@ -486,13 +515,13 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
486 println!("{result}");515 println!("{result}");
487 return Ok(());516 return Ok(());
488 }517 }
489 let import = PathBuf::from(env("STUDIO_DATA_DIR", "data")).join("accounts-import.json");518 let import = PathBuf::from(env("SNOWGLOBE_DATA_DIR", "data")).join("accounts-import.json");
490 if import.exists() {519 if import.exists() {
491 auth.import(serde_json::from_slice(&std::fs::read(&import)?)?)520 auth.import(serde_json::from_slice(&std::fs::read(&import)?)?)
492 .map_err(|error| std::io::Error::other(error.message))?;521 .map_err(|error| std::io::Error::other(error.message))?;
493 std::fs::remove_file(&import)?;522 std::fs::remove_file(&import)?;
494 }523 }
495 if env("STUDIO_AUTH_REQUIRED", "0") == "1" && !auth.ready() {524 if env("SNOWGLOBE_AUTH_REQUIRED", "0") == "1" && !auth.ready() {
496 return Err(std::io::Error::other(525 return Err(std::io::Error::other(
497 "Import accounts before starting native authentication.",526 "Import accounts before starting native authentication.",
498 )527 )
...@@ -500,13 +529,13 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {...@@ -500,13 +529,13 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
500 }529 }
501 let app = Arc::new(App {530 let app = Arc::new(App {
502 auth,531 auth,
503 mcp: mcp::Store::new(&PathBuf::from(env("STUDIO_DATA_DIR", "data")), &origin)532 mcp: mcp::Store::new(&PathBuf::from(env("SNOWGLOBE_DATA_DIR", "data")), &origin)
504 .map_err(|error| std::io::Error::other(error.message))?,533 .map_err(|error| std::io::Error::other(error.message))?,
505 relay: relay::Broker::default(),534 relay: relay::Broker::default(),
506 shale: shale::Backend::new(535 shale: shale::Backend::new(
507 &env(536 &env(
508 "STUDIO_SHALE_URL",537 "SNOWGLOBE_SHALE_URL",
509 &format!("https://shale.{}", env("STUDIO_DOMAIN", "studio.test")),538 &format!("https://shale.{}", env("SNOWGLOBE_DOMAIN", "snowglobe.test")),
510 ),539 ),
511 client(),540 client(),
512 )541 )
...@@ -517,8 +546,8 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {...@@ -517,8 +546,8 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
517 cache: cache::Cache::default(),546 cache: cache::Cache::default(),
518 nomad_slots: Semaphore::new(4),547 nomad_slots: Semaphore::new(4),
519 specs: Mutex::new(HashMap::new()),548 specs: Mutex::new(HashMap::new()),
520 repo: env("STUDIO_REPO", "..").into(),549 repo: env("SNOWGLOBE_REPO", "..").into(),
521 data: env("STUDIO_DATA_DIR", "data").into(),550 data: env("SNOWGLOBE_DATA_DIR", "data").into(),
522 live,551 live,
523 usage: Mutex::new(HashMap::new()),552 usage: Mutex::new(HashMap::new()),
524 vm_usage: Mutex::new(HashMap::new()),553 vm_usage: Mutex::new(HashMap::new()),
...@@ -534,7 +563,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {...@@ -534,7 +563,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
534 index.start(state).await;563 index.start(state).await;
535 });564 });
536 }565 }
537 if std::env::var("STUDIO_YT_STATE").is_ok() {566 if std::env::var("SNOWGLOBE_YT_STATE").is_ok() {
538 for parts in [&[][..], &["library"][..]] {567 for parts in [&[][..], &["library"][..]] {
539 let state = app.clone();568 let state = app.clone();
540 tokio::spawn(async move {569 tokio::spawn(async move {
...@@ -546,7 +575,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {...@@ -546,7 +575,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
546 }575 }
547 core::start(app.clone());576 core::start(app.clone());
548 telemetry::start(app.clone());577 telemetry::start(app.clone());
549 let dist = env("STUDIO_WEB_DIR", "dist");578 let dist = env("SNOWGLOBE_WEB_DIR", "dist");
550 let router = Router::new()579 let router = Router::new()
551 .route("/api/{*path}", any(api))580 .route("/api/{*path}", any(api))
552 .route("/auth/{*path}", any(auth::route))581 .route("/auth/{*path}", any(auth::route))
...@@ -568,20 +597,20 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {...@@ -568,20 +597,20 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
568 async move {597 async move {
569 request.headers_mut().remove("User-Id");598 request.headers_mut().remove("User-Id");
570 if mcp::public(request.uri().path()) {599 if mcp::public(request.uri().path()) {
571 request.headers_mut().remove("Studio-Proxy-Token");600 request.headers_mut().remove("Snowglobe-Proxy-Token");
572 request.headers_mut().remove("User-Name");601 request.headers_mut().remove("User-Name");
573 request.headers_mut().remove("User-Groups");602 request.headers_mut().remove("User-Groups");
574 } else if let Some(proof) = proof {603 } else if let Some(proof) = proof {
575 let supplied = request604 let supplied = request
576 .headers()605 .headers()
577 .get("Studio-Proxy-Token")606 .get("Snowglobe-Proxy-Token")
578 .map(|value| value.as_bytes())607 .map(|value| value.as_bytes())
579 .unwrap_or_default();608 .unwrap_or_default();
580 if supplied.ct_eq(proof.as_bytes()).unwrap_u8() == 0 {609 if supplied.ct_eq(proof.as_bytes()).unwrap_u8() == 0 {
581 return Error::new(403, "Open the dashboard through its sign-in page.")610 return Error::new(403, "Open the dashboard through its sign-in page.")
582 .into_response();611 .into_response();
583 }612 }
584 request.headers_mut().remove("Studio-Proxy-Token");613 request.headers_mut().remove("Snowglobe-Proxy-Token");
585 }614 }
586 if request.uri().path() == "/auth/shale/page" {615 if request.uri().path() == "/auth/shale/page" {
587 return next.run(request).await;616 return next.run(request).await;
...@@ -605,7 +634,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {...@@ -605,7 +634,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
605 };634 };
606 if account.is_null() {635 if account.is_null() {
607 return if path.starts_with("/api/") {636 return if path.starts_with("/api/") {
608 Error::new(401, "Sign in to Snowglobe.").into_response()637 Error::new(401, "Sign in to Snow Globe.").into_response()
609 } else {638 } else {
610 (639 (
611 StatusCode::FOUND,640 StatusCode::FOUND,
...@@ -634,7 +663,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {...@@ -634,7 +663,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
634 "location",663 "location",
635 format!(664 format!(
636 "https://shale.{}/",665 "https://shale.{}/",
637 env("STUDIO_DOMAIN", "studio.test")666 env("SNOWGLOBE_DOMAIN", "snowglobe.test")
638 ),667 ),
639 )],668 )],
640 )669 )
...@@ -650,7 +679,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {...@@ -650,7 +679,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
650 .and_then(|v| v.to_str().ok())679 .and_then(|v| v.to_str().ok())
651 != Some(app.auth.origin.origin().ascii_serialization().as_str())680 != Some(app.auth.origin.origin().ascii_serialization().as_str())
652 {681 {
653 return Error::new(403, "Open Snowglobe and try again.")682 return Error::new(403, "Open Snow Globe and try again.")
654 .into_response();683 .into_response();
655 }684 }
656 if !array(&account["requiredActions"]).is_empty()685 if !array(&account["requiredActions"]).is_empty()
dashboard/src/mcp.rs+2-2
...@@ -969,8 +969,8 @@ mod tests {...@@ -969,8 +969,8 @@ mod tests {
969 let path = std::env::temp_dir()969 let path = std::env::temp_dir()
970 .canonicalize()970 .canonicalize()
971 .unwrap()971 .unwrap()
972 .join(format!("studio-mcp-test-{}", uuid::Uuid::new_v4()));972 .join(format!("snowglobe-mcp-test-{}", uuid::Uuid::new_v4()));
973 let store = Arc::new(Store::new(&path, "https://globe.studio.test").unwrap());973 let store = Arc::new(Store::new(&path, "https://globe.snowglobe.test").unwrap());
974 Self { store, path }974 Self { store, path }
975 }975 }
976 fn code(&self, client: &str, code: &str) -> HashMap<String, String> {976 fn code(&self, client: &str, code: &str) -> HashMap<String, String> {
dashboard/src/namespace-transition.json created+4
...@@ -0,0 +1,4 @@
1{
2 "previous": "studio",
3 "previousHost": "zenith"
4}
dashboard/src/namespace.rs created+87
...@@ -0,0 +1,87 @@
1use crate::*;
2use serde_json::Map;
3
4pub static PREVIOUS: std::sync::LazyLock<String> = std::sync::LazyLock::new(|| {
5 serde_json::from_str::<Value>(include_str!("namespace-transition.json")).unwrap()["previous"]
6 .as_str().unwrap().to_owned()
7});
8
9fn keys(values: &mut Map<String, Value>, separator: &str) {
10 let prefix = format!("{}{separator}", PREVIOUS.as_str());
11 let renamed: Vec<_> = values.keys().filter_map(|key| {
12 key.strip_prefix(&prefix).map(|suffix| (key.clone(), format!("snowglobe{separator}{suffix}")))
13 }).collect();
14 for (old, new) in renamed {
15 let value = values.remove(&old).unwrap();
16 values.entry(new).or_insert(value);
17 }
18}
19
20pub fn nomad(value: &mut Value) {
21 match value {
22 Value::Object(values) => {
23 if let Some(meta) = values.get_mut("Meta").and_then(Value::as_object_mut) {
24 keys(meta, "_");
25 }
26 if let Some(tags) = values.get_mut("Tags").and_then(Value::as_array_mut) {
27 let prefix = format!("{}-metrics-path=", PREVIOUS.as_str());
28 for tag in tags {
29 if let Some(path) = tag.as_str().and_then(|tag| tag.strip_prefix(&prefix)) {
30 *tag = json!(format!("snowglobe-metrics-path={path}"));
31 }
32 }
33 }
34 for value in values.values_mut() {
35 nomad(value);
36 }
37 }
38 Value::Array(values) => values.iter_mut().for_each(nomad),
39 _ => {}
40 }
41}
42
43pub fn attributes(values: &mut Map<String, Value>) {
44 keys(values, ".");
45}
46
47pub fn metric_selector(metric: &str, labels: &str) -> String {
48 let previous = metric.replacen("snowglobe_", &format!("{}_", PREVIOUS.as_str()), 1);
49 format!("sum without (__name__) ({metric}{labels}) or sum without (__name__) ({previous}{labels})")
50}
51
52#[cfg(test)]
53mod tests {
54 use super::*;
55
56 #[test]
57 fn persisted_metadata_is_read_once_with_current_values_winning() {
58 let old = PREVIOUS.as_str();
59 let mut value = json!({"Meta": {
60 format!("{old}_name"): "old name", "snowglobe_name": "Snow Globe",
61 format!("{old}_hostname"): "knife.example.test"
62 }, "TaskGroups": [{"Services": [{"Tags": [format!("{old}-metrics-path=/metrics"), "caddy-host=knife.example.test"]}]}],
63 "Config": {"Env": {format!("{}_DOMAIN", old.to_uppercase()): "untouched"}}});
64 nomad(&mut value);
65 assert_eq!(value["Meta"]["snowglobe_name"], "Snow Globe");
66 assert_eq!(value["Meta"]["snowglobe_hostname"], "knife.example.test");
67 assert!(value["Meta"].get(format!("{old}_name")).is_none());
68 assert_eq!(value["TaskGroups"][0]["Services"][0]["Tags"][0], "snowglobe-metrics-path=/metrics");
69 assert_eq!(value["Config"]["Env"][format!("{}_DOMAIN", old.to_uppercase())], "untouched");
70 let normalized = value.clone();
71 nomad(&mut value);
72 assert_eq!(value, normalized);
73 }
74
75 #[test]
76 fn historical_trace_ownership_remains_explicit() {
77 let mut values = Map::from_iter([
78 (format!("{}.service", PREVIOUS.as_str()), json!("private")),
79 (format!("{}.kind", PREVIOUS.as_str()), json!("edge")),
80 ("snowglobe.service".into(), json!("current")),
81 ]);
82 attributes(&mut values);
83 assert_eq!(values["snowglobe.service"], "current");
84 assert_eq!(values["snowglobe.kind"], "edge");
85 assert_eq!(values.len(), 2);
86 }
87}
dashboard/src/observability.rs+6-6
...@@ -129,14 +129,14 @@ impl ServerHandler for Observability {...@@ -129,14 +129,14 @@ impl ServerHandler for Observability {
129 }129 }
130}130}
131fn visible_span(span: &Value, jobs: &Value, resources: &Value) -> bool {131fn visible_span(span: &Value, jobs: &Value, resources: &Value) -> bool {
132 if let Some(id) = span["attributes"]["studio.service"].as_str() {132 if let Some(id) = span["attributes"]["snowglobe.service"].as_str() {
133 return array(resources).iter().any(|r| r == id);133 return array(resources).iter().any(|r| r == id);
134 }134 }
135 let owners: Vec<_> = jobs135 let owners: Vec<_> = jobs
136 .as_object()136 .as_object()
137 .into_iter()137 .into_iter()
138 .flat_map(|jobs| jobs.iter())138 .flat_map(|jobs| jobs.iter())
139 .filter(|(_, job)| job["job"]["Meta"]["studio_trace_service"] == span["service"])139 .filter(|(_, job)| job["job"]["Meta"]["snowglobe_trace_service"] == span["service"])
140 .map(|(id, _)| id)140 .map(|(id, _)| id)
141 .collect();141 .collect();
142 owners.len() == 1 && array(resources).iter().any(|r| r == owners[0])142 owners.len() == 1 && array(resources).iter().any(|r| r == owners[0])
...@@ -153,7 +153,7 @@ mod tests {...@@ -153,7 +153,7 @@ mod tests {
153 use super::*;153 use super::*;
154 #[test]154 #[test]
155 fn trace_grants_reject_foreign_and_ambiguous_spans() {155 fn trace_grants_reject_foreign_and_ambiguous_spans() {
156 let jobs = json!({"allowed":{"job":{"Meta":{"studio_trace_service":"backend"}}},"private":{"job":{"Meta":{"studio_trace_service":"private-api"}}}});156 let jobs = json!({"allowed":{"job":{"Meta":{"snowglobe_trace_service":"backend"}}},"private":{"job":{"Meta":{"snowglobe_trace_service":"private-api"}}}});
157 let resources = json!(["allowed"]);157 let resources = json!(["allowed"]);
158 assert!(visible_span(158 assert!(visible_span(
159 &json!({"service":"backend","attributes":{}}),159 &json!({"service":"backend","attributes":{}}),
...@@ -166,17 +166,17 @@ mod tests {...@@ -166,17 +166,17 @@ mod tests {
166 &resources166 &resources
167 ));167 ));
168 assert!(!visible_span(168 assert!(!visible_span(
169 &json!({"service":"backend","attributes":{"studio.service":"private"}}),169 &json!({"service":"backend","attributes":{"snowglobe.service":"private"}}),
170 &jobs,170 &jobs,
171 &resources171 &resources
172 ));172 ));
173 assert!(visible_span(173 assert!(visible_span(
174 &json!({"service":"allowed","attributes":{"studio.service":"allowed"}}),174 &json!({"service":"allowed","attributes":{"snowglobe.service":"allowed"}}),
175 &jobs,175 &jobs,
176 &resources176 &resources
177 ));177 ));
178 let mut ambiguous = jobs.clone();178 let mut ambiguous = jobs.clone();
179 ambiguous["private"]["job"]["Meta"]["studio_trace_service"] = json!("backend");179 ambiguous["private"]["job"]["Meta"]["snowglobe_trace_service"] = json!("backend");
180 assert!(!visible_span(180 assert!(!visible_span(
181 &json!({"service":"backend","attributes":{}}),181 &json!({"service":"backend","attributes":{}}),
182 &ambiguous,182 &ambiguous,
dashboard/src/relay.rs+3-3
...@@ -801,7 +801,7 @@ pub fn router(app: Arc<App>) -> Router {...@@ -801,7 +801,7 @@ pub fn router(app: Arc<App>) -> Router {
801 let state = app.clone();801 let state = app.clone();
802 let expected_host =802 let expected_host =
803 app.mcp.origin[url::Position::BeforeHost..url::Position::AfterPort].to_owned();803 app.mcp.origin[url::Position::BeforeHost..url::Position::AfterPort].to_owned();
804 let agent = env("STUDIO_AGENT_DIR", "agent");804 let agent = env("SNOWGLOBE_AGENT_DIR", "agent");
805 Router::new()805 Router::new()
806 .route("/pairing", any(pairing))806 .route("/pairing", any(pairing))
807 .route("/agent/connect", any(connect))807 .route("/agent/connect", any(connect))
...@@ -848,8 +848,8 @@ mod tests {...@@ -848,8 +848,8 @@ mod tests {
848 let path = std::env::temp_dir()848 let path = std::env::temp_dir()
849 .canonicalize()849 .canonicalize()
850 .unwrap()850 .unwrap()
851 .join(format!("studio-relay-test-{}", uuid::Uuid::new_v4()));851 .join(format!("snowglobe-relay-test-{}", uuid::Uuid::new_v4()));
852 let store = Arc::new(mcp::Store::new(&path, "https://globe.studio.test").unwrap());852 let store = Arc::new(mcp::Store::new(&path, "https://globe.snowglobe.test").unwrap());
853 let machine = uuid::Uuid::new_v4().to_string();853 let machine = uuid::Uuid::new_v4().to_string();
854 let grant = uuid::Uuid::new_v4().to_string();854 let grant = uuid::Uuid::new_v4().to_string();
855 {855 {
dashboard/src/shale.rs+5-5
...@@ -586,7 +586,7 @@ pub async fn manage(...@@ -586,7 +586,7 @@ pub async fn manage(
586 600,586 600,
587 )?;587 )?;
588 tx.commit()?;588 tx.commit()?;
589 Ok(axum::Json(json!({"redirect":app.shale.origin.join(&format!("/-/studio-mcp/{nonce}"))?.as_str()})).into_response())589 Ok(axum::Json(json!({"redirect":app.shale.origin.join(&format!("/-/snowglobe-mcp/{nonce}"))?.as_str()})).into_response())
590 }590 }
591 Method::DELETE => {591 Method::DELETE => {
592 let session = {592 let session = {
...@@ -639,7 +639,7 @@ pub async fn oauth(app: Arc<App>, request: Request) -> Response {...@@ -639,7 +639,7 @@ pub async fn oauth(app: Arc<App>, request: Request) -> Response {
639 tx.commit()?;639 tx.commit()?;
640 return Ok((StatusCode::FOUND, [640 return Ok((StatusCode::FOUND, [
641 ("location", string(&link["authorization"]).to_owned()),641 ("location", string(&link["authorization"]).to_owned()),
642 ("set-cookie", format!("studio_mcp_shale_link={nonce}; Path=/-/callback; Secure; HttpOnly; SameSite=Lax; Max-Age=600")),642 ("set-cookie", format!("snowglobe_mcp_shale_link={nonce}; Path=/-/callback; Secure; HttpOnly; SameSite=Lax; Max-Age=600")),
643 ]).into_response());643 ]).into_response());
644 }644 }
645 if !callback {645 if !callback {
...@@ -647,7 +647,7 @@ pub async fn oauth(app: Arc<App>, request: Request) -> Response {...@@ -647,7 +647,7 @@ pub async fn oauth(app: Arc<App>, request: Request) -> Response {
647 }647 }
648 let cookies: Vec<_> = request.headers().get_all("cookie").iter()648 let cookies: Vec<_> = request.headers().get_all("cookie").iter()
649 .filter_map(|v| v.to_str().ok()).flat_map(|v| v.split(';'))649 .filter_map(|v| v.to_str().ok()).flat_map(|v| v.split(';'))
650 .filter_map(|part| part.trim().strip_prefix("studio_mcp_shale_link=")).collect();650 .filter_map(|part| part.trim().strip_prefix("snowglobe_mcp_shale_link=")).collect();
651 if cookies.len() != 1 || cookies[0].len() != 43 {651 if cookies.len() != 1 || cookies[0].len() != 43 {
652 return Err(Error::new(400, "This Shale link cookie is missing. Start linking again."));652 return Err(Error::new(400, "This Shale link cookie is missing. Start linking again."));
653 }653 }
...@@ -724,7 +724,7 @@ pub async fn oauth(app: Arc<App>, request: Request) -> Response {...@@ -724,7 +724,7 @@ pub async fn oauth(app: Arc<App>, request: Request) -> Response {
724 if callback {724 if callback {
725 response.headers_mut().append(725 response.headers_mut().append(
726 "set-cookie",726 "set-cookie",
727 "studio_mcp_shale_link=; Path=/-/callback; Secure; HttpOnly; SameSite=Lax; Max-Age=0"727 "snowglobe_mcp_shale_link=; Path=/-/callback; Secure; HttpOnly; SameSite=Lax; Max-Age=0"
728 .parse()728 .parse()
729 .unwrap(),729 .unwrap(),
730 );730 );
...@@ -754,7 +754,7 @@ mod tests {...@@ -754,7 +754,7 @@ mod tests {
754 }754 }
755 #[test]755 #[test]
756 fn repository_names_cannot_change_origin_or_path_segments() {756 fn repository_names_cannot_change_origin_or_path_segments() {
757 let origin = url::Url::parse("https://shale.studio.test").unwrap();757 let origin = url::Url::parse("https://shale.snowglobe.test").unwrap();
758 for name in [758 for name in [
759 "",759 "",
760 ".",760 ".",
dashboard/src/shale_page.rs+6-6
...@@ -350,7 +350,7 @@ pub async fn proxy(app: Arc<App>, request: Request) -> Result<Response> {...@@ -350,7 +350,7 @@ pub async fn proxy(app: Arc<App>, request: Request) -> Result<Response> {
350 .get("host")350 .get("host")
351 .and_then(|v| v.to_str().ok())351 .and_then(|v| v.to_str().ok())
352 .unwrap_or_default();352 .unwrap_or_default();
353 let domain = env("STUDIO_DOMAIN", "studio.test");353 let domain = env("SNOWGLOBE_DOMAIN", "snowglobe.test");
354 let service = host.strip_suffix(&format!(".{domain}")).unwrap_or_default().to_owned();354 let service = host.strip_suffix(&format!(".{domain}")).unwrap_or_default().to_owned();
355 if service != "shale"355 if service != "shale"
356 && !(service356 && !(service
...@@ -361,13 +361,13 @@ pub async fn proxy(app: Arc<App>, request: Request) -> Result<Response> {...@@ -361,13 +361,13 @@ pub async fn proxy(app: Arc<App>, request: Request) -> Result<Response> {
361 }361 }
362 let upstream: std::net::SocketAddr = parts362 let upstream: std::net::SocketAddr = parts
363 .headers363 .headers
364 .get("studio-shale-upstream")364 .get("snowglobe-shale-upstream")
365 .and_then(|v| v.to_str().ok())365 .and_then(|v| v.to_str().ok())
366 .ok_or_else(|| Error::new(403, "Open Shale to continue."))?366 .ok_or_else(|| Error::new(403, "Open Shale to continue."))?
367 .parse()?;367 .parse()?;
368 let uri: axum::http::Uri = parts368 let uri: axum::http::Uri = parts
369 .headers369 .headers
370 .get("studio-shale-uri")370 .get("snowglobe-shale-uri")
371 .and_then(|v| v.to_str().ok())371 .and_then(|v| v.to_str().ok())
372 .ok_or_else(|| Error::new(403, "Open Shale to continue."))?372 .ok_or_else(|| Error::new(403, "Open Shale to continue."))?
373 .parse()?;373 .parse()?;
...@@ -398,9 +398,9 @@ pub async fn proxy(app: Arc<App>, request: Request) -> Result<Response> {...@@ -398,9 +398,9 @@ pub async fn proxy(app: Arc<App>, request: Request) -> Result<Response> {
398 }398 }
399 strip_hop_headers(&mut parts.headers);399 strip_hop_headers(&mut parts.headers);
400 for name in [400 for name in [
401 "studio-shale-upstream",401 "snowglobe-shale-upstream",
402 "studio-shale-uri",402 "snowglobe-shale-uri",
403 "studio-proxy-token",403 "snowglobe-proxy-token",
404 "user-name",404 "user-name",
405 "user-groups",405 "user-groups",
406 "user-id",406 "user-id",
dashboard/src/shares.rs+2-2
...@@ -68,8 +68,8 @@ pub async fn route(...@@ -68,8 +68,8 @@ pub async fn route(
68 .await?;68 .await?;
69 if value.is_object() {69 if value.is_object() {
70 value["filesUrl"] = json!(env(70 value["filesUrl"] = json!(env(
71 "STUDIO_FILES_URL",71 "SNOWGLOBE_FILES_URL",
72 &format!("https://file.{}", env("STUDIO_DOMAIN", "studio.test")),72 &format!("https://file.{}", env("SNOWGLOBE_DOMAIN", "snowglobe.test")),
73 ));73 ));
74 }74 }
75 Ok(Document::new(value).response())75 Ok(Document::new(value).response())
dashboard/src/storage.rs+1-1
...@@ -147,7 +147,7 @@ pub async fn route(...@@ -147,7 +147,7 @@ pub async fn route(
147 [] if method == Method::GET => {147 [] if method == Method::GET => {
148 let found=app.cache.get("storage".into(),Duration::from_secs(30),move || async move {148 let found=app.cache.get("storage".into(),Duration::from_secs(30),move || async move {
149 let (pool,mut datasets)=tokio::try_join!(pool(),datasets())?;let root=array(&datasets).iter().find(|d| d["name"]==pool["name"]).ok_or_else(|| Error::new(502,"The storage pool has no root dataset."))?;let held:f64=array(&datasets).iter().map(|d| number(&d["usedbysnapshots"])).sum();let space=json!({"live":number(&root["used"])-held,"held":held,"free":root["available"]});149 let (pool,mut datasets)=tokio::try_join!(pool(),datasets())?;let root=array(&datasets).iter().find(|d| d["name"]==pool["name"]).ok_or_else(|| Error::new(502,"The storage pool has no root dataset."))?;let held:f64=array(&datasets).iter().map(|d| number(&d["usedbysnapshots"])).sum();let space=json!({"live":number(&root["used"])-held,"held":held,"free":root["available"]});
150 let media=env("STUDIO_MEDIA_ROOT",&format!("{}/clover/Media",env("STUDIO_STORE_ROOT","/srv")));for dataset in datasets.as_array_mut().unwrap() {let mount=dataset["mountpoint"].as_str().map(str::to_owned);dataset["link"]=mount.as_ref().map(|p| apps::file_link(p,false)).unwrap_or(Value::Null);dataset["media"]=mount.and_then(|p| std::path::Path::new(&p).strip_prefix(&media).ok().map(|p| p.to_string_lossy().into_owned())).map(|p| json!(p)).unwrap_or(Value::Null);}Ok(json!({"pool":pool,"datasets":datasets,"space":space}))150 let media=env("SNOWGLOBE_MEDIA_ROOT",&format!("{}/clover/Media",env("SNOWGLOBE_STORE_ROOT","/srv")));for dataset in datasets.as_array_mut().unwrap() {let mount=dataset["mountpoint"].as_str().map(str::to_owned);dataset["link"]=mount.as_ref().map(|p| apps::file_link(p,false)).unwrap_or(Value::Null);dataset["media"]=mount.and_then(|p| std::path::Path::new(&p).strip_prefix(&media).ok().map(|p| p.to_string_lossy().into_owned())).map(|p| json!(p)).unwrap_or(Value::Null);}Ok(json!({"pool":pool,"datasets":datasets,"space":space}))
151 }).await?;151 }).await?;
152 return Ok(found.response());152 return Ok(found.response());
153 }153 }
dashboard/src/telemetry.rs+37-34
...@@ -47,7 +47,11 @@ pub async fn read(...@@ -47,7 +47,11 @@ pub async fn read(
47 app.cache47 app.cache
48 .get(key, Duration::from_secs(2), move || async move {48 .get(key, Duration::from_secs(2), move || async move {
49 let request = if let Some(form) = &form {49 let request = if let Some(form) = &form {
50 state.request(Method::POST, &url)?.form(form)50 if env("SNOWGLOBE_PREVIEW", "") == "1" {
51 state.request(Method::GET, &url)?.query(form)
52 } else {
53 state.request(Method::POST, &url)?.form(form)
54 }
51 } else {55 } else {
52 state.request(Method::GET, &url)?56 state.request(Method::GET, &url)?
53 };57 };
...@@ -72,16 +76,16 @@ pub async fn read(...@@ -72,16 +76,16 @@ pub async fn read(
72}76}
7377
74const METRICS: &[(&str, &str)] = &[78const METRICS: &[(&str, &str)] = &[
75 ("host.cpu", "studio_host_cpu_percent"),79 ("host.cpu", "snowglobe_host_cpu_percent"),
76 ("host.memory", "studio_host_memory_bytes"),80 ("host.memory", "snowglobe_host_memory_bytes"),
77 ("host.temperature", "studio_host_temperature_celsius"),81 ("host.temperature", "snowglobe_host_temperature_celsius"),
78 ("host.power", "studio_host_power_watts"),82 ("host.power", "snowglobe_host_power_watts"),
79 ("host.gpu", "studio_host_gpu_percent"),83 ("host.gpu", "snowglobe_host_gpu_percent"),
80 ("host.network", "studio_host_network_bytes_per_second"),84 ("host.network", "snowglobe_host_network_bytes_per_second"),
81 ("service.cpu", "studio_service_cpu_cores"),85 ("service.cpu", "snowglobe_service_cpu_cores"),
82 ("service.memory", "studio_service_memory_bytes"),86 ("service.memory", "snowglobe_service_memory_bytes"),
83 ("vm.cpu", "studio_vm_cpu_percent"),87 ("vm.cpu", "snowglobe_vm_cpu_percent"),
84 ("vm.memory", "studio_vm_memory_bytes"),88 ("vm.memory", "snowglobe_vm_memory_bytes"),
85];89];
8690
87fn series(result: &Value, application: bool) -> Value {91fn series(result: &Value, application: bool) -> Value {
...@@ -173,9 +177,7 @@ pub async fn metrics(...@@ -173,9 +177,7 @@ pub async fn metrics(
173 .find(|(key, _)| *key == name)177 .find(|(key, _)| *key == name)
174 .ok_or_else(|| Error::new(400, "Invalid metric."))?178 .ok_or_else(|| Error::new(400, "Invalid metric."))?
175 .1;179 .1;
176 format!(180 let labels = service
177 "{metric}{}",
178 service
179 .map(|id| format!(181 .map(|id| format!(
180 "{{{}={}}}",182 "{{{}={}}}",
181 if name.starts_with("vm.") {183 if name.starts_with("vm.") {
...@@ -185,8 +187,8 @@ pub async fn metrics(...@@ -185,8 +187,8 @@ pub async fn metrics(
185 },187 },
186 quote(id)188 quote(id)
187 ))189 ))
188 .unwrap_or_default()190 .unwrap_or_default();
189 )191 namespace::metric_selector(metric, &labels)
190 };192 };
191 let key = if window.is_some() {193 let key = if window.is_some() {
192 format!("series:{selector}:fixed:{from}:{to}")194 format!("series:{selector}:fixed:{from}:{to}")
...@@ -225,8 +227,8 @@ pub async fn metric_names(app: Arc<App>, id: &str) -> Result<Value> {...@@ -225,8 +227,8 @@ pub async fn metric_names(app: Arc<App>, id: &str) -> Result<Value> {
225 (227 (
226 "match[]",228 "match[]",
227 format!(229 format!(
228 "{{{label}={},__name__!~\"studio_.*\"}}",230 "{{{label}={},__name__!~\"(snowglobe|{})_.*\"}}",
229 serde_json::to_string(id).unwrap()231 serde_json::to_string(id).unwrap(), namespace::PREVIOUS.as_str()
230 ),232 ),
231 )233 )
232 }));234 }));
...@@ -366,6 +368,7 @@ fn span(row: &Value) -> Value {...@@ -366,6 +368,7 @@ fn span(row: &Value) -> Value {
366 .map(|key| (key.into(), value.clone()))368 .map(|key| (key.into(), value.clone()))
367 })369 })
368 .collect();370 .collect();
371 namespace::attributes(&mut attributes);
369 for (from, to) in [372 for (from, to) in [
370 ("http.request.method", "http.request.method"),373 ("http.request.method", "http.request.method"),
371 ("http.response.status_code", "http.response.status_code"),374 ("http.response.status_code", "http.response.status_code"),
...@@ -383,7 +386,7 @@ fn span(row: &Value) -> Value {...@@ -383,7 +386,7 @@ fn span(row: &Value) -> Value {
383 .cloned()386 .cloned()
384 .unwrap_or(Value::Null);387 .unwrap_or(Value::Null);
385 let service = attributes388 let service = attributes
386 .get("studio.service")389 .get("snowglobe.service")
387 .cloned()390 .cloned()
388 .unwrap_or_else(|| {391 .unwrap_or_else(|| {
389 row["resource_attr:service.name"]392 row["resource_attr:service.name"]
...@@ -405,7 +408,7 @@ fn span(row: &Value) -> Value {...@@ -405,7 +408,7 @@ fn span(row: &Value) -> Value {
405 } else {408 } else {
406 Value::Null409 Value::Null
407 };410 };
408 let name = if attributes.get("studio.kind").is_some_and(|v| v == "edge") {411 let name = if attributes.get("snowglobe.kind").is_some_and(|v| v == "edge") {
409 format!("edge: {}", row["name"].as_str().unwrap_or("request"))412 format!("edge: {}", row["name"].as_str().unwrap_or("request"))
410 } else {413 } else {
411 string(&row["name"]).into()414 string(&row["name"]).into()
...@@ -500,7 +503,7 @@ pub async fn traces(...@@ -500,7 +503,7 @@ pub async fn traces(
500 visible: impl Fn(&Value) -> bool,503 visible: impl Fn(&Value) -> bool,
501) -> Result<Value> {504) -> Result<Value> {
502 let jobs = core::scan(app.clone()).await?;505 let jobs = core::scan(app.clone()).await?;
503 let Some(service) = jobs.value[id]["job"]["Meta"]["studio_trace_service"]506 let Some(service) = jobs.value[id]["job"]["Meta"]["snowglobe_trace_service"]
504 .as_str()507 .as_str()
505 .filter(|s| !s.is_empty())508 .filter(|s| !s.is_empty())
506 else {509 else {
...@@ -611,7 +614,7 @@ pub async fn traces(...@@ -611,7 +614,7 @@ pub async fn traces(
611 let value = |trace: &Value| {614 let value = |trace: &Value| {
612 array(&trace["spans"])615 array(&trace["spans"])
613 .iter()616 .iter()
614 .find(|s| s["service"] == service && s["attributes"]["studio.kind"] != "edge")617 .find(|s| s["service"] == service && s["attributes"]["snowglobe.kind"] != "edge")
615 .map(|s| number(&s[if key == "_time" { "start" } else { "duration" }]))618 .map(|s| number(&s[if key == "_time" { "start" } else { "duration" }]))
616 .unwrap_or(0.0)619 .unwrap_or(0.0)
617 };620 };
...@@ -695,21 +698,21 @@ impl Recorder {...@@ -695,21 +698,21 @@ impl Recorder {
695 };698 };
696 let mut lines = vec![699 let mut lines = vec![
697 format!(700 format!(
698 "studio_host_cpu_percent {} {timestamp}",701 "snowglobe_host_cpu_percent {} {timestamp}",
699 number(&live["host"]["cpu"])702 number(&live["host"]["cpu"])
700 ),703 ),
701 format!(704 format!(
702 "studio_host_memory_bytes {} {timestamp}",705 "snowglobe_host_memory_bytes {} {timestamp}",
703 number(&live["host"]["memory"])706 number(&live["host"]["memory"])
704 ),707 ),
705 ];708 ];
706 for (id, (cpu, memory)) in usage {709 for (id, (cpu, memory)) in usage {
707 let id = serde_json::to_string(&id)?;710 let id = serde_json::to_string(&id)?;
708 lines.push(format!(711 lines.push(format!(
709 "studio_service_cpu_cores{{service={id}}} {cpu} {timestamp}"712 "snowglobe_service_cpu_cores{{service={id}}} {cpu} {timestamp}"
710 ));713 ));
711 lines.push(format!(714 lines.push(format!(
712 "studio_service_memory_bytes{{service={id}}} {memory} {timestamp}"715 "snowglobe_service_memory_bytes{{service={id}}} {memory} {timestamp}"
713 ));716 ));
714 }717 }
715 let sample = host::sample(app.clone()).await?;718 let sample = host::sample(app.clone()).await?;
...@@ -719,22 +722,22 @@ impl Recorder {...@@ -719,22 +722,22 @@ impl Recorder {
719 let network_at = number(&sample["at"]);722 let network_at = number(&sample["at"]);
720 if let Some((old_rx, old_tx, t)) = self.network.filter(|(_, _, t)| network_at > *t) {723 if let Some((old_rx, old_tx, t)) = self.network.filter(|(_, _, t)| network_at > *t) {
721 lines.push(format!(724 lines.push(format!(
722 "studio_host_network_bytes_per_second{{direction=\"down\"}} {} {timestamp}",725 "snowglobe_host_network_bytes_per_second{{direction=\"down\"}} {} {timestamp}",
723 ((rx - old_rx) / (network_at - t)).max(0.0)726 ((rx - old_rx) / (network_at - t)).max(0.0)
724 ));727 ));
725 lines.push(format!(728 lines.push(format!(
726 "studio_host_network_bytes_per_second{{direction=\"up\"}} {} {timestamp}",729 "snowglobe_host_network_bytes_per_second{{direction=\"up\"}} {} {timestamp}",
727 ((tx - old_tx) / (network_at - t)).max(0.0)730 ((tx - old_tx) / (network_at - t)).max(0.0)
728 ));731 ));
729 }732 }
730 self.network = Some((rx, tx, network_at));733 self.network = Some((rx, tx, network_at));
731 if let Some(value) = live["host"]["temperature"].as_f64() {734 if let Some(value) = live["host"]["temperature"].as_f64() {
732 lines.push(format!(735 lines.push(format!(
733 "studio_host_temperature_celsius {value} {timestamp}"736 "snowglobe_host_temperature_celsius {value} {timestamp}"
734 ));737 ));
735 }738 }
736 if let Some(value) = sample["gpu"].as_f64() {739 if let Some(value) = sample["gpu"].as_f64() {
737 lines.push(format!("studio_host_gpu_percent {value} {timestamp}"));740 lines.push(format!("snowglobe_host_gpu_percent {value} {timestamp}"));
738 }741 }
739 if let Ok(Ok(stats)) = tokio::time::timeout(742 if let Ok(Ok(stats)) = tokio::time::timeout(
740 Duration::from_secs(8),743 Duration::from_secs(8),
...@@ -757,11 +760,11 @@ impl Recorder {...@@ -757,11 +760,11 @@ impl Recorder {
757 usage.insert(id.clone(), json!({"cpu":cpu,"memory":stat["memory"]}));760 usage.insert(id.clone(), json!({"cpu":cpu,"memory":stat["memory"]}));
758 next.insert(id.clone(), (number(&stat["cpu"]), at));761 next.insert(id.clone(), (number(&stat["cpu"]), at));
759 lines.push(format!(762 lines.push(format!(
760 "studio_vm_cpu_percent{{vm={}}} {cpu} {timestamp}",763 "snowglobe_vm_cpu_percent{{vm={}}} {cpu} {timestamp}",
761 serde_json::to_string(id)?764 serde_json::to_string(id)?
762 ));765 ));
763 lines.push(format!(766 lines.push(format!(
764 "studio_vm_memory_bytes{{vm={}}} {} {timestamp}",767 "snowglobe_vm_memory_bytes{{vm={}}} {} {timestamp}",
765 serde_json::to_string(id)?,768 serde_json::to_string(id)?,
766 number(&stat["memory"])769 number(&stat["memory"])
767 ));770 ));
...@@ -778,7 +781,7 @@ pub fn start(app: Arc<App>) {...@@ -778,7 +781,7 @@ pub fn start(app: Arc<App>) {
778 loop {781 loop {
779 let result = async {782 let result = async {
780 let base = endpoint(app.clone(), "victoria-metrics").await?;783 let base = endpoint(app.clone(), "victoria-metrics").await?;
781 if env("STUDIO_METRICS", "") == "follow" {784 if env("SNOWGLOBE_METRICS", "") == "follow" {
782 let names: Vec<_> = METRICS785 let names: Vec<_> = METRICS
783 .iter()786 .iter()
784 .filter(|(k, _)| k.starts_with("service.") || k.starts_with("vm."))787 .filter(|(k, _)| k.starts_with("service.") || k.starts_with("vm."))
...@@ -828,7 +831,7 @@ pub fn start(app: Arc<App>) {...@@ -828,7 +831,7 @@ pub fn start(app: Arc<App>) {
828 .flat_map(|group| array(&group["Services"]))831 .flat_map(|group| array(&group["Services"]))
829 .flat_map(move |service| {832 .flat_map(move |service| {
830 array(&service["Tags"]).iter().filter_map(move |tag| {833 array(&service["Tags"]).iter().filter_map(move |tag| {
831 string(tag).strip_prefix("studio-metrics-path=").map(834 string(tag).strip_prefix("snowglobe-metrics-path=").map(
832 |path| {835 |path| {
833 (836 (
834 id.clone(),837 id.clone(),
dashboard/src/vms.rs+2-2
...@@ -45,8 +45,8 @@ pub async fn console(request: Request, name: &str, serial: bool) -> Result<Respo...@@ -45,8 +45,8 @@ pub async fn console(request: Request, name: &str, serial: bool) -> Result<Respo
45 .map(|(_, stream)| stream);45 .map(|(_, stream)| stream);
46 }46 }
47 let mut stream = tokio::net::UnixStream::connect(env(47 let mut stream = tokio::net::UnixStream::connect(env(
48 "STUDIO_VM_SCREEN_SOCKET",48 "SNOWGLOBE_VM_SCREEN_SOCKET",
49 "/run/studio-vm-screen/screen.sock",49 "/run/snowglobe-vm-screen/screen.sock",
50 ))50 ))
51 .await?;51 .await?;
52 stream52 stream
dashboard/src/youtube.rs+6-6
...@@ -27,14 +27,14 @@ impl Worker {...@@ -27,14 +27,14 @@ impl Worker {
27 }27 }
28 let response = tokio::time::timeout(Duration::from_secs(25), async {28 let response = tokio::time::timeout(Duration::from_secs(25), async {
29 if child.is_none() {29 if child.is_none() {
30 if std::env::var("STUDIO_YT_STATE").is_err() {30 if std::env::var("SNOWGLOBE_YT_STATE").is_err() {
31 return Err(Error::new(31 return Err(Error::new(
32 501,32 501,
33 "YouTube isn't connected to this home server. Configure its archive state, then retry.",33 "YouTube isn't connected to this home server. Configure its archive state, then retry.",
34 ));34 ));
35 }35 }
36 let python = env("STUDIO_YT_PYTHON", "python3");36 let python = env("SNOWGLOBE_YT_PYTHON", "python3");
37 let script = env("STUDIO_YT_WORKER", "server/youtube-worker.py");37 let script = env("SNOWGLOBE_YT_WORKER", "server/youtube-worker.py");
38 let mut command = tokio::process::Command::new(python);38 let mut command = tokio::process::Command::new(python);
39 for (key, name) in [39 for (key, name) in [
40 ("SMTP_HOST", "smtp_host"),40 ("SMTP_HOST", "smtp_host"),
...@@ -156,8 +156,8 @@ pub async fn route(...@@ -156,8 +156,8 @@ pub async fn route(
156 move || async move {156 move || async move {
157 if call == "library" {157 if call == "library" {
158 let _slot = state.heavy.acquire().await?;158 let _slot = state.heavy.acquire().await?;
159 let python = env("STUDIO_YT_PYTHON", "python3");159 let python = env("SNOWGLOBE_YT_PYTHON", "python3");
160 let script = env("STUDIO_YT_WORKER", "server/youtube-worker.py");160 let script = env("SNOWGLOBE_YT_WORKER", "server/youtube-worker.py");
161 return Ok(serde_json::from_slice(161 return Ok(serde_json::from_slice(
162 &command(&python, &[&script, "--library"], None).await?,162 &command(&python, &[&script, "--library"], None).await?,
163 )?);163 )?);
...@@ -167,7 +167,7 @@ pub async fn route(...@@ -167,7 +167,7 @@ pub async fn route(
167 if call == "snapshot" {167 if call == "snapshot" {
168 let archive = core::read_json(168 let archive = core::read_json(
169 std::path::Path::new(&env(169 std::path::Path::new(&env(
170 "STUDIO_YT_ARCHIVE_STATUS",170 "SNOWGLOBE_YT_ARCHIVE_STATUS",
171 "/srv/prod/ytdl-sub/config/archive-status.json",171 "/srv/prod/ytdl-sub/config/archive-status.json",
172 )),172 )),
173 Value::Null,173 Value::Null,
dashboard/tsconfig.json-1
...@@ -24,7 +24,6 @@...@@ -24,7 +24,6 @@
24 },24 },
25 "include": [25 "include": [
26 "web",26 "web",
27 "dev.ts",
28 "vite.config.ts"27 "vite.config.ts"
29 ]28 ]
30}29}
dashboard/vite.config.ts-13
...@@ -8,17 +8,4 @@ export default defineConfig({...@@ -8,17 +8,4 @@ export default defineConfig({
8 plugins: [solid()],8 plugins: [solid()],
9 resolve: { alias: { "@novnc/keyboard": resolve(dirname(createRequire(import.meta.url).resolve("@novnc/novnc")), "input/keyboard.js") } },9 resolve: { alias: { "@novnc/keyboard": resolve(dirname(createRequire(import.meta.url).resolve("@novnc/novnc")), "input/keyboard.js") } },
10 build: { outDir: "../dist", emptyOutDir: true },10 build: { outDir: "../dist", emptyOutDir: true },
11 server: {
12 host: true,
13 allowedHosts: [".ts.net", "sandwich"],
14 // Stands in for forward auth.
15 proxy: {
16 "/api/": {
17 target: process.env.STUDIO_DEV_API_URL ?? "http://127.0.0.1:7070",
18 xfwd: true,
19 ws: true,
20 headers: { "User-Name": process.env.STUDIO_DEV_USER ?? "snow", "User-Groups": process.env.STUDIO_DEV_GROUPS ?? "infra-admin" },
21 },
22 },
23 },
24});11});
dashboard/web/pages/Account.tsx+2-2
...@@ -70,7 +70,7 @@ export function Account() {...@@ -70,7 +70,7 @@ export function Account() {
70 <a class="button" href="/">maybe later</a>70 <a class="button" href="/">maybe later</a>
71 </section>71 </section>
72 </Show>72 </Show>
73 <Show when={user().requiredActions.length}><section class="card"><p class="muted">Finish your profile and change any temporary password to open Snowglobe and Files.</p></section></Show>73 <Show when={user().requiredActions.length}><section class="card"><p class="muted">Finish your profile and change any temporary password to open Snow Globe and Files.</p></section></Show>
74 <Profile user={user()} />74 <Profile user={user()} />
75 <SignIn user={user()} />75 <SignIn user={user()} />
76 <CommitIdentity user={user()} identity={user().commitIdentity} refetch={refetchAccount} />76 <CommitIdentity user={user()} identity={user().commitIdentity} refetch={refetchAccount} />
...@@ -212,7 +212,7 @@ function SignIn(props: { user: Self }) {...@@ -212,7 +212,7 @@ function SignIn(props: { user: Self }) {
212 });212 });
213 return <section class="card">213 return <section class="card">
214 <h2 class="card-title">sign-in</h2>214 <h2 class="card-title">sign-in</h2>
215 <p class="muted">These sign-in methods work with Snowglobe and Files.</p>215 <p class="muted">These sign-in methods work with Snow Globe and Files.</p>
216 <div class="credentials">216 <div class="credentials">
217 <span class="label">password</span><span>{password() ? "set" : "none"}</span>217 <span class="label">password</span><span>{password() ? "set" : "none"}</span>
218 <button class="button small" onClick={change}>{password() ? "change" : "set password"}</button>218 <button class="button small" onClick={change}>{password() ? "change" : "set password"}</button>
dashboard/web/pages/MCPConsent.tsx+1-1
...@@ -48,7 +48,7 @@ export function MCPConsent() {...@@ -48,7 +48,7 @@ export function MCPConsent() {
48 };48 };
49 return <main class="mcp-authorization">49 return <main class="mcp-authorization">
50 <section class="mcp-approval" aria-labelledby="connection-title">50 <section class="mcp-approval" aria-labelledby="connection-title">
51 <div class="mcp-approval-brand">Snowglobe <span class="muted">· MCP connection</span></div>51 <div class="mcp-approval-brand">Snow Globe <span class="muted">· MCP connection</span></div>
52 <Show when={details()} fallback={<>52 <Show when={details()} fallback={<>
53 <h1 id="connection-title">{consent.state === "errored" ? "Connection unavailable" : "Loading connection…"}</h1>53 <h1 id="connection-title">{consent.state === "errored" ? "Connection unavailable" : "Loading connection…"}</h1>
54 <Show when={consent.state === "errored"} fallback={<div class="skeleton" style={{ height: "120px" }} aria-label="Loading connection" />}>54 <Show when={consent.state === "errored"} fallback={<div class="skeleton" style={{ height: "120px" }} aria-label="Loading connection" />}>
dashboard/web/pages/Users.tsx+2-2
...@@ -78,7 +78,7 @@ function groupTip(group: string, d: Data) {...@@ -78,7 +78,7 @@ function groupTip(group: string, d: Data) {
7878
7979
80const appName = (clientId: string, services: ServiceSummary[]) =>80const appName = (clientId: string, services: ServiceSummary[]) =>
81 clientId === "dashboard" ? "Snowglobe" : clientId === "file" ? "Files" : services.find((service) => service.id === clientId)?.name ?? clientId;81 clientId === "dashboard" ? "Snow Globe" : clientId === "file" ? "Files" : services.find((service) => service.id === clientId)?.name ?? clientId;
8282
83/** "active 3h ago in Jellyfin, Shale", from their open sessions. */83/** "active 3h ago in Jellyfin, Shale", from their open sessions. */
84function seen(user: User, services: ServiceSummary[]) {84function seen(user: User, services: ServiceSummary[]) {
...@@ -531,7 +531,7 @@ function Profile(props: { user: User; data: Data; refetch: () => unknown }) {...@@ -531,7 +531,7 @@ function Profile(props: { user: User; data: Data; refetch: () => unknown }) {
531 const name = props.user.username;531 const name = props.user.username;
532 showTextDialog({532 showTextDialog({
533 title: `Delete ${name}?`,533 title: `Delete ${name}?`,
534 description: `${name} is signed out and loses access to Snowglobe and Files. This can't be undone.`,534 description: `${name} is signed out and loses access to Snow Globe and Files. This can't be undone.`,
535 label: `type ${name} to confirm`,535 label: `type ${name} to confirm`,
536 validateInput: (value) => value === name,536 validateInput: (value) => value === name,
537 confirmLabel: "delete user",537 confirmLabel: "delete user",
flake.nix+4-4
...@@ -1,5 +1,5 @@...@@ -1,5 +1,5 @@
1{1{
2 description = "Clover infrastructure prototype";2 description = "Snow Globe infrastructure";
33
4 inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-26.05";4 inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-26.05";
55
...@@ -14,7 +14,7 @@...@@ -14,7 +14,7 @@
14 system = "x86_64-linux";14 system = "x86_64-linux";
15 modules = [15 modules = [
16 "${nixpkgs}/nixos/modules/installer/cd-dvd/installation-cd-minimal.nix"16 "${nixpkgs}/nixos/modules/installer/cd-dvd/installation-cd-minimal.nix"
17 ./nixos/zenith-network.nix17 ./nixos/snowglobe-network.nix
18 ({ lib, pkgs, ... }: {18 ({ lib, pkgs, ... }: {
19 networking.hostName = "infra-2-installer";19 networking.hostName = "infra-2-installer";
20 networking.networkmanager.enable = lib.mkForce false;20 networking.networkmanager.enable = lib.mkForce false;
...@@ -40,9 +40,9 @@...@@ -40,9 +40,9 @@
40 modules = [ ./nixos/configuration.nix ./nixos/vm.nix ];40 modules = [ ./nixos/configuration.nix ./nixos/vm.nix ];
41 };41 };
4242
43 nixosConfigurations.zenith = nixpkgs.lib.nixosSystem {43 nixosConfigurations.snowglobe = nixpkgs.lib.nixosSystem {
44 system = "x86_64-linux";44 system = "x86_64-linux";
45 modules = [ ./nixos/configuration.nix ./nixos/zenith.nix ./nixos/hardware-configuration.nix ];45 modules = [ ./nixos/configuration.nix ./nixos/snowglobe.nix ./nixos/hardware-configuration.nix ];
46 };46 };
47 };47 };
48}48}
nixos/configuration.nix+88-87
...@@ -3,10 +3,10 @@ let...@@ -3,10 +3,10 @@ let
3 dashboard = pkgs.callPackage ./dashboard.nix { };3 dashboard = pkgs.callPackage ./dashboard.nix { };
4 dashboardPort = "7072";4 dashboardPort = "7072";
5 internalPort = 8448;5 internalPort = 8448;
6 proxyToken = "/var/lib/studio/dashboard-proxy.token";6 proxyToken = "/var/lib/snowglobe/dashboard-proxy.token";
7 hostTools = lib.fileset.toSource {7 hostTools = lib.fileset.toSource {
8 root = ../.;8 root = ../.;
9 fileset = lib.fileset.unions [ ../tools/dashboard-host.py ../service/copyparty/manage.py ../service/copyparty/copyparty.conf ../tools/shale-labels.py ../config/shale.json ../dashboard/src/host-protocol.json ../tools/vms.py ../tools/vm-ssh.py ../tools/dashboard-run.py ../tools/release.py ../guest/protocol.json ];9 fileset = lib.fileset.unions [ ../tools/dashboard-host.py ../service/copyparty/manage.py ../service/copyparty/copyparty.conf ../tools/shale-labels.py ../config/shale.json ../dashboard/src/host-protocol.json ../tools/vms.py ../tools/vm-ssh.py ../tools/dashboard-run.py ../tools/release.py ../tools/namespace-transition.py ../dashboard/src/namespace-transition.json ../guest/protocol.json ];
10 };10 };
11 nativePkl = pkgs.callPackage ./pkl.nix { };11 nativePkl = pkgs.callPackage ./pkl.nix { };
12 screenPython = pkgs.python3.withPackages (packages: [ packages.pygobject3 packages.gst-python ]);12 screenPython = pkgs.python3.withPackages (packages: [ packages.pygobject3 packages.gst-python ]);
...@@ -70,7 +70,7 @@ in...@@ -70,7 +70,7 @@ in
70 };70 };
71 };71 };
72 systemd.services.caddy.environment = {72 systemd.services.caddy.environment = {
73 OTEL_SERVICE_NAME = "studio-caddy";73 OTEL_SERVICE_NAME = "snowglobe-caddy";
74 OTEL_EXPORTER_OTLP_TRACES_ENDPOINT = "http://127.0.0.1:10428/insert/opentelemetry/v1/traces";74 OTEL_EXPORTER_OTLP_TRACES_ENDPOINT = "http://127.0.0.1:10428/insert/opentelemetry/v1/traces";
75 OTEL_TRACES_SAMPLER = "parentbased_traceidratio";75 OTEL_TRACES_SAMPLER = "parentbased_traceidratio";
76 OTEL_TRACES_SAMPLER_ARG = "0.25";76 OTEL_TRACES_SAMPLER_ARG = "0.25";
...@@ -109,14 +109,14 @@ in...@@ -109,14 +109,14 @@ in
109 };109 };
110 };110 };
111111
112 systemd.services.studio-log-shipper = {112 systemd.services.snowglobe-log-shipper = {
113 wantedBy = [ "multi-user.target" ];113 wantedBy = [ "multi-user.target" ];
114 after = [ "nomad.service" ];114 after = [ "nomad.service" ];
115 wants = [ "nomad.service" ];115 wants = [ "nomad.service" ];
116 unitConfig.ConditionPathExists = "/opt/studio/current/tools/log-shipper.py";116 unitConfig.ConditionPathExists = "/opt/snowglobe/current/tools/log-shipper.py";
117 path = [ pkgs.systemd ];117 path = [ pkgs.systemd ];
118 serviceConfig = {118 serviceConfig = {
119 ExecStart = "${pkgs.python3}/bin/python3 /opt/studio/current/tools/log-shipper.py";119 ExecStart = "${pkgs.python3}/bin/python3 /opt/snowglobe/current/tools/log-shipper.py";
120 Restart = "always";120 Restart = "always";
121 RestartSec = 5;121 RestartSec = 5;
122 };122 };
...@@ -127,16 +127,16 @@ in...@@ -127,16 +127,16 @@ in
127 requires = [ "podman.socket" ];127 requires = [ "podman.socket" ];
128 };128 };
129129
130 systemd.services.studio-router = {130 systemd.services.snowglobe-router = {
131 wantedBy = [ "multi-user.target" ];131 wantedBy = [ "multi-user.target" ];
132 wants = [ "nomad.service" "caddy.service" ];132 wants = [ "nomad.service" "caddy.service" ];
133 after = [ "nomad.service" "caddy.service" ];133 after = [ "nomad.service" "caddy.service" ];
134 unitConfig.ConditionPathExists = "/var/lib/studio/router.token";134 unitConfig.ConditionPathExists = "/var/lib/snowglobe/router.token";
135 environment = {135 environment = {
136 STUDIO_DOMAIN = config.environment.variables.STUDIO_DOMAIN;136 SNOWGLOBE_DOMAIN = config.environment.variables.SNOWGLOBE_DOMAIN;
137 STUDIO_DASHBOARD_PORT = dashboardPort;137 SNOWGLOBE_DASHBOARD_PORT = dashboardPort;
138 STUDIO_INTERNAL_PORT = toString internalPort;138 SNOWGLOBE_INTERNAL_PORT = toString internalPort;
139 STUDIO_PROXY_TOKEN_FILE = proxyToken;139 SNOWGLOBE_PROXY_TOKEN_FILE = proxyToken;
140 };140 };
141 serviceConfig = {141 serviceConfig = {
142 ExecStart = "${pkgs.python3}/bin/python3 ${../tools/router.py}";142 ExecStart = "${pkgs.python3}/bin/python3 ${../tools/router.py}";
...@@ -145,26 +145,27 @@ in...@@ -145,26 +145,27 @@ in
145 };145 };
146 };146 };
147147
148 users.groups.studio-dashboard = { };148 users.groups.snowglobe-dashboard.gid = 994;
149 users.users.studio-dashboard = {149 users.users.snowglobe-dashboard = {
150 uid = 997;
150 isSystemUser = true;151 isSystemUser = true;
151 group = "studio-dashboard";152 group = "snowglobe-dashboard";
152 };153 };
153 systemd.services.studio-vm-screen = {154 systemd.services.snowglobe-vm-screen = {
154 wantedBy = [ "multi-user.target" ];155 wantedBy = [ "multi-user.target" ];
155 wants = [ "studio-host.service" ];156 wants = [ "snowglobe-host.service" ];
156 after = [ "studio-host.service" ];157 after = [ "snowglobe-host.service" ];
157 environment = {158 environment = {
158 GST_PLUGIN_SYSTEM_PATH_1_0 = lib.makeSearchPath "lib/gstreamer-1.0" screenPlugins;159 GST_PLUGIN_SYSTEM_PATH_1_0 = lib.makeSearchPath "lib/gstreamer-1.0" screenPlugins;
159 GI_TYPELIB_PATH = lib.makeSearchPath "lib/girepository-1.0" (map lib.getLib ([ pkgs.gst_all_1.gstreamer ] ++ screenPlugins));160 GI_TYPELIB_PATH = lib.makeSearchPath "lib/girepository-1.0" (map lib.getLib ([ pkgs.gst_all_1.gstreamer ] ++ screenPlugins));
160 LD_LIBRARY_PATH = "/run/opengl-driver/lib";161 LD_LIBRARY_PATH = "/run/opengl-driver/lib";
161 STUDIO_VM_GUEST_PROTOCOL = toString ../guest/protocol.json;162 SNOWGLOBE_VM_GUEST_PROTOCOL = toString ../guest/protocol.json;
162 };163 };
163 serviceConfig = {164 serviceConfig = {
164 ExecStart = "${screenPython}/bin/python3 ${../tools/vm-screen.py}";165 ExecStart = "${screenPython}/bin/python3 ${../tools/vm-screen.py}";
165 User = "studio-dashboard";166 User = "snowglobe-dashboard";
166 Group = "studio-dashboard";167 Group = "snowglobe-dashboard";
167 RuntimeDirectory = "studio-vm-screen";168 RuntimeDirectory = "snowglobe-vm-screen";
168 RuntimeDirectoryMode = "0700";169 RuntimeDirectoryMode = "0700";
169 RuntimeDirectoryPreserve = "yes";170 RuntimeDirectoryPreserve = "yes";
170 UMask = "0077";171 UMask = "0077";
...@@ -182,29 +183,29 @@ in...@@ -182,29 +183,29 @@ in
182 RestartSec = 2;183 RestartSec = 2;
183 };184 };
184 };185 };
185 systemd.services.studio-host = {186 systemd.services.snowglobe-host = {
186 wantedBy = [ "multi-user.target" ];187 wantedBy = [ "multi-user.target" ];
187 wants = [ "podman.socket" ];188 wants = [ "podman.socket" ];
188 after = [ "podman.socket" ];189 after = [ "podman.socket" ];
189 path = [ pkgs.zfs pkgs.util-linux pkgs.python3 pkgs.libvirt pkgs.qemu pkgs.gptfdisk pkgs.cdrkit pkgs.openssl pkgs.openssh pkgs.podman pkgs.nomad pkgs.systemd pkgs.rsync pkgs.nixos-rebuild nativePkl ]190 path = [ pkgs.zfs pkgs.util-linux pkgs.python3 pkgs.libvirt pkgs.qemu pkgs.gptfdisk pkgs.cdrkit pkgs.openssl pkgs.openssh pkgs.podman pkgs.nomad pkgs.systemd pkgs.rsync pkgs.nixos-rebuild nativePkl ]
190 ++ lib.optional (builtins.elem "nvidia" config.services.xserver.videoDrivers) (lib.getBin config.hardware.nvidia.package);191 ++ lib.optional (builtins.elem "nvidia" config.services.xserver.videoDrivers) (lib.getBin config.hardware.nvidia.package);
191 environment = (lib.filterAttrs (name: _: lib.hasPrefix "STUDIO_" name) config.environment.variables) // {192 environment = (lib.filterAttrs (name: _: lib.hasPrefix "SNOWGLOBE_" name) config.environment.variables) // {
192 STUDIO_POOL = lib.attrByPath [ "STUDIO_POOL" ] "studio-demo" config.environment.variables;193 SNOWGLOBE_POOL = lib.attrByPath [ "SNOWGLOBE_POOL" ] "snowglobe-demo" config.environment.variables;
193 STUDIO_DASHBOARD_USER = "studio-dashboard";194 SNOWGLOBE_DASHBOARD_USER = "snowglobe-dashboard";
194 STUDIO_VM_ACCEL = lib.attrByPath [ "STUDIO_VM_ACCEL" ] "kvm" config.environment.variables;195 SNOWGLOBE_VM_ACCEL = lib.attrByPath [ "SNOWGLOBE_VM_ACCEL" ] "kvm" config.environment.variables;
195 };196 };
196 serviceConfig = {197 serviceConfig = {
197 ExecStart = "${pkgs.python3}/bin/python3 ${hostTools}/tools/dashboard-host.py";198 ExecStart = "${pkgs.python3}/bin/python3 ${hostTools}/tools/dashboard-host.py";
198 Type = "notify";199 Type = "notify";
199 Group = "studio-dashboard";200 Group = "snowglobe-dashboard";
200 StateDirectory = "studio/host";201 StateDirectory = "snowglobe/host";
201 StateDirectoryMode = "0700";202 StateDirectoryMode = "0700";
202 RuntimeDirectory = "studio-host";203 RuntimeDirectory = "snowglobe-host";
203 RuntimeDirectoryMode = "0750";204 RuntimeDirectoryMode = "0750";
204 RuntimeDirectoryPreserve = "yes";205 RuntimeDirectoryPreserve = "yes";
205 UMask = "0077";206 UMask = "0077";
206 ProtectSystem = "strict";207 ProtectSystem = "strict";
207 ReadWritePaths = [ "/srv/vm" "-/srv/prod/shale/data" "-/srv/prod/copyparty/cfg" "/srv/staging" "/srv/clover" "/var/lib/studio/dashboard" ] ++ lib.optionals (config.networking.hostName != "clover-demo") [ "/srv/clover/Media/vm" ];208 ReadWritePaths = [ "/srv/vm" "-/srv/prod/shale/data" "-/srv/prod/copyparty/cfg" "/srv/staging" "/srv/clover" "/var/lib/snowglobe/dashboard" ] ++ lib.optionals (config.networking.hostName != "snowglobe-rehearsal") [ "/srv/clover/Media/vm" ];
208 ProtectHome = true;209 ProtectHome = true;
209 PrivateTmp = true;210 PrivateTmp = true;
210 NoNewPrivileges = true;211 NoNewPrivileges = true;
...@@ -220,49 +221,49 @@ in...@@ -220,49 +221,49 @@ in
220 RestartSec = 2;221 RestartSec = 2;
221 };222 };
222 };223 };
223 systemd.services.studio-dashboard = let224 systemd.services.snowglobe-dashboard = let
224 environment = (lib.filterAttrs (name: _: lib.hasPrefix "STUDIO_" name) config.environment.variables) // {225 environment = (lib.filterAttrs (name: _: lib.hasPrefix "SNOWGLOBE_" name) config.environment.variables) // {
225 STUDIO_DATA_DIR = "/data";226 SNOWGLOBE_DATA_DIR = "/data";
226 STUDIO_PROXY_TOKEN_FILE = "/run/secrets/dashboard-proxy.token";227 SNOWGLOBE_PROXY_TOKEN_FILE = "/run/secrets/dashboard-proxy.token";
227 STUDIO_NOMAD_TOKEN_FILE = "/run/secrets/dashboard-nomad.token";228 SNOWGLOBE_NOMAD_TOKEN_FILE = "/run/secrets/dashboard-nomad.token";
228 STUDIO_CA_BUNDLE = "/run/secrets/ca-bundle.crt";229 SNOWGLOBE_CA_BUNDLE = "/run/secrets/ca-bundle.crt";
229 STUDIO_INDEX_DIR = "/data/index";230 SNOWGLOBE_INDEX_DIR = "/data/index";
230 STUDIO_INTERNAL_URL = "https://dashboard.internal.${config.environment.variables.STUDIO_DOMAIN}:${toString internalPort}";231 SNOWGLOBE_INTERNAL_URL = "https://dashboard.internal.${config.environment.variables.SNOWGLOBE_DOMAIN}:${toString internalPort}";
231 STUDIO_FILES_URL = "https://file.${config.environment.variables.STUDIO_DOMAIN}";232 SNOWGLOBE_FILES_URL = "https://file.${config.environment.variables.SNOWGLOBE_DOMAIN}";
232 STUDIO_AUTH_REQUIRED = "1";233 SNOWGLOBE_AUTH_REQUIRED = "1";
233 STUDIO_AUTH_RP_ID = "auth.${config.environment.variables.STUDIO_DOMAIN}";234 SNOWGLOBE_AUTH_RP_ID = "auth.${config.environment.variables.SNOWGLOBE_DOMAIN}";
234 STUDIO_FILE_ORIGIN = "https://file.${config.environment.variables.STUDIO_DOMAIN}";235 SNOWGLOBE_FILE_ORIGIN = "https://file.${config.environment.variables.SNOWGLOBE_DOMAIN}";
235 STUDIO_PUBLIC_ORIGIN = "https://snowglobe.${config.environment.variables.STUDIO_DOMAIN}";236 SNOWGLOBE_PUBLIC_ORIGIN = "https://snowglobe.${config.environment.variables.SNOWGLOBE_DOMAIN}";
236 STUDIO_JELLYFIN_URL = "https://jelly.${config.environment.variables.STUDIO_DOMAIN}";237 SNOWGLOBE_JELLYFIN_URL = "https://jelly.${config.environment.variables.SNOWGLOBE_DOMAIN}";
237 STUDIO_SHALE_URL = "https://shale.${config.environment.variables.STUDIO_DOMAIN}";238 SNOWGLOBE_SHALE_URL = "https://shale.${config.environment.variables.SNOWGLOBE_DOMAIN}";
238 STUDIO_PUBLISHED_ROOT = "/srv/clover/Published";239 SNOWGLOBE_PUBLISHED_ROOT = "/srv/clover/Published";
239 STUDIO_DOMAIN = config.environment.variables.STUDIO_DOMAIN;240 SNOWGLOBE_DOMAIN = config.environment.variables.SNOWGLOBE_DOMAIN;
240 STUDIO_POOL = lib.attrByPath [ "STUDIO_POOL" ] "studio-demo" config.environment.variables;241 SNOWGLOBE_POOL = lib.attrByPath [ "SNOWGLOBE_POOL" ] "snowglobe-demo" config.environment.variables;
241 STUDIO_NODE_NAME = config.networking.hostName;242 SNOWGLOBE_NODE_NAME = config.networking.hostName;
242 STUDIO_MEDIA_READ_ONLY = lib.attrByPath [ "STUDIO_MEDIA_READ_ONLY" ] "false" config.environment.variables;243 SNOWGLOBE_MEDIA_READ_ONLY = lib.attrByPath [ "SNOWGLOBE_MEDIA_READ_ONLY" ] "false" config.environment.variables;
243 STUDIO_CLOVER_READ_ONLY = lib.attrByPath [ "STUDIO_CLOVER_READ_ONLY" ] "false" config.environment.variables;244 SNOWGLOBE_CLOVER_READ_ONLY = lib.attrByPath [ "SNOWGLOBE_CLOVER_READ_ONLY" ] "false" config.environment.variables;
244 };245 };
245 in {246 in {
246 inherit environment;247 inherit environment;
247 wantedBy = [ "multi-user.target" ];248 wantedBy = [ "multi-user.target" ];
248 wants = [ "nomad.service" "studio-router.service" "studio-host.service" "studio-vm-screen.service" ];249 wants = [ "nomad.service" "snowglobe-router.service" "snowglobe-host.service" "snowglobe-vm-screen.service" ];
249 after = [ "nomad.service" "studio-host.service" "studio-vm-screen.service" ];250 after = [ "nomad.service" "snowglobe-host.service" "snowglobe-vm-screen.service" ];
250 unitConfig.ConditionPathExists = [ "/var/lib/studio/dashboard.token" "/var/lib/studio/ca-bundle.crt" "/opt/studio/current" ];251 unitConfig.ConditionPathExists = [ "/var/lib/snowglobe/dashboard.token" "/var/lib/snowglobe/ca-bundle.crt" "/opt/snowglobe/current" ];
251 path = [ pkgs.podman pkgs.coreutils pkgs.curl pkgs.openssl pkgs.systemd ];252 path = [ pkgs.podman pkgs.coreutils pkgs.curl pkgs.openssl pkgs.systemd ];
252 serviceConfig = {253 serviceConfig = {
253 Type = "notify";254 Type = "notify";
254 NotifyAccess = "all";255 NotifyAccess = "all";
255 ExecStart = pkgs.writeShellScript "studio-dashboard-start" ''256 ExecStart = pkgs.writeShellScript "snowglobe-dashboard-start" ''
256 uid=$(id -u studio-dashboard)257 uid=$(id -u snowglobe-dashboard)
257 gid=$(id -g studio-dashboard)258 gid=$(id -g snowglobe-dashboard)
258 optional=()259 optional=()
259 if test -d /srv/prod/ytdl/data && test -d '/srv/clover/Documents/Config/Youtube Downloader'; then260 if test -d /srv/prod/ytdl/data && test -d '/srv/clover/Documents/Config/Youtube Downloader'; then
260 optional+=(--volume=/srv/prod/ytdl/data:/srv/prod/ytdl/data:rw261 optional+=(--volume=/srv/prod/ytdl/data:/srv/prod/ytdl/data:rw
261 --env=STUDIO_YT_STATE=/srv/prod/ytdl/data262 --env=SNOWGLOBE_YT_STATE=/srv/prod/ytdl/data
262 '--env=STUDIO_YT_CONFIG=/srv/clover/Documents/Config/Youtube Downloader'263 '--env=SNOWGLOBE_YT_CONFIG=/srv/clover/Documents/Config/Youtube Downloader'
263 --env=STUDIO_YT_MEDIA=/srv/clover/Media)264 --env=SNOWGLOBE_YT_MEDIA=/srv/clover/Media)
264 fi265 fi
265 exec podman run --rm --replace --name=studio-dashboard --pull=never \266 exec podman run --rm --replace --name=snowglobe-dashboard --pull=never \
266 --sdnotify=conmon --cgroups=no-conmon --log-driver=journald \267 --sdnotify=conmon --cgroups=no-conmon --log-driver=journald \
267 --user="$uid:$gid" \268 --user="$uid:$gid" \
268 --group-add=${toString config.users.groups.chloe.gid} --network=podman \269 --group-add=${toString config.users.groups.chloe.gid} --network=podman \
...@@ -272,20 +273,20 @@ in...@@ -272,20 +273,20 @@ in
272 --tmpfs=/tmp:rw,noexec,nosuid,nodev,size=256m,mode=1777 \273 --tmpfs=/tmp:rw,noexec,nosuid,nodev,size=256m,mode=1777 \
273 --tmpfs=/run:rw,noexec,nosuid,nodev,size=16m,mode=755 \274 --tmpfs=/run:rw,noexec,nosuid,nodev,size=16m,mode=755 \
274 --env=HOME=/data --env=XDG_CACHE_HOME=/data/cache \275 --env=HOME=/data --env=XDG_CACHE_HOME=/data/cache \
275 --volume=/var/lib/studio/dashboard:/data:rw \276 --volume=/var/lib/snowglobe/dashboard:/data:rw \
276 --volume=/run/studio-host:/run/studio-host:ro \277 --volume=/run/snowglobe-host:/run/snowglobe-host:ro \
277 --volume=/run/studio-vm-screen:/run/studio-vm-screen:ro \278 --volume=/run/snowglobe-vm-screen:/run/snowglobe-vm-screen:ro \
278 --volume=${proxyToken}:/run/secrets/dashboard-proxy.token:ro \279 --volume=${proxyToken}:/run/secrets/dashboard-proxy.token:ro \
279 --volume=/var/lib/studio/dashboard.token:/run/secrets/dashboard-nomad.token:ro \280 --volume=/var/lib/snowglobe/dashboard.token:/run/secrets/dashboard-nomad.token:ro \
280 --volume=/var/lib/studio/ca-bundle.crt:/run/secrets/ca-bundle.crt:ro \281 --volume=/var/lib/snowglobe/ca-bundle.crt:/run/secrets/ca-bundle.crt:ro \
281 --mount=type=bind,src=/srv/clover,dst=/srv/clover,bind-nonrecursive,bind-propagation=rslave,ro="$STUDIO_CLOVER_READ_ONLY" \282 --mount=type=bind,src=/srv/clover,dst=/srv/clover,bind-nonrecursive,bind-propagation=rslave,ro="$SNOWGLOBE_CLOVER_READ_ONLY" \
282 --mount=type=bind,src=/srv/clover/Media,dst=/srv/clover/Media,bind-nonrecursive,bind-propagation=rslave,ro="$STUDIO_MEDIA_READ_ONLY" \283 --mount=type=bind,src=/srv/clover/Media,dst=/srv/clover/Media,bind-nonrecursive,bind-propagation=rslave,ro="$SNOWGLOBE_MEDIA_READ_ONLY" \
283 ${lib.concatMapStringsSep " " (name: lib.escapeShellArg "--env=${name}") (builtins.attrNames environment)} \284 ${lib.concatMapStringsSep " " (name: lib.escapeShellArg "--env=${name}") (builtins.attrNames environment)} \
284 ${lib.concatMapStringsSep " " (name: lib.escapeShellArg "--add-host=${name}.${config.environment.variables.STUDIO_DOMAIN}:host-gateway") [ "dashboard.internal" "auth" "jelly" "db" "shale" ]} \285 ${lib.concatMapStringsSep " " (name: lib.escapeShellArg "--add-host=${name}.${config.environment.variables.SNOWGLOBE_DOMAIN}:host-gateway") [ "dashboard.internal" "auth" "jelly" "db" "shale" ]} \
285 "''${optional[@]}" ${lib.escapeShellArg "${dashboard.image.imageName}:${dashboard.image.imageTag}"}286 "''${optional[@]}" ${lib.escapeShellArg "${dashboard.image.imageName}:${dashboard.image.imageTag}"}
286 '';287 '';
287 ExecStop = "${pkgs.podman}/bin/podman stop --ignore --time=8 studio-dashboard";288 ExecStop = "${pkgs.podman}/bin/podman stop --ignore --time=8 snowglobe-dashboard";
288 ExecStopPost = "${pkgs.podman}/bin/podman rm --ignore --force studio-dashboard";289 ExecStopPost = "${pkgs.podman}/bin/podman rm --ignore --force snowglobe-dashboard";
289 CPUWeight = 1000;290 CPUWeight = 1000;
290 KillMode = "mixed";291 KillMode = "mixed";
291 TimeoutStartSec = 180;292 TimeoutStartSec = 180;
...@@ -299,9 +300,9 @@ in...@@ -299,9 +300,9 @@ in
299 openssl rand -hex 32 > ${proxyToken}.pending300 openssl rand -hex 32 > ${proxyToken}.pending
300 mv ${proxyToken}.pending ${proxyToken}301 mv ${proxyToken}.pending ${proxyToken}
301 fi302 fi
302 chown root:studio-dashboard ${proxyToken} /var/lib/studio/dashboard.token303 chown root:snowglobe-dashboard ${proxyToken} /var/lib/snowglobe/dashboard.token
303 chmod 0640 ${proxyToken} /var/lib/studio/dashboard.token304 chmod 0640 ${proxyToken} /var/lib/snowglobe/dashboard.token
304 chown -R studio-dashboard:studio-dashboard /var/lib/studio/dashboard305 chown -R snowglobe-dashboard:snowglobe-dashboard /var/lib/snowglobe/dashboard
305 systemd-tmpfiles --create --prefix=/srv/prod/ytdl/data306 systemd-tmpfiles --create --prefix=/srv/prod/ytdl/data
306 if ! podman image exists ${lib.escapeShellArg "${dashboard.image.imageName}:${dashboard.image.imageTag}"}; then307 if ! podman image exists ${lib.escapeShellArg "${dashboard.image.imageName}:${dashboard.image.imageTag}"}; then
307 podman load --quiet --input ${dashboard.image}308 podman load --quiet --input ${dashboard.image}
...@@ -309,7 +310,7 @@ in...@@ -309,7 +310,7 @@ in
309 '';310 '';
310 postStart = ''311 postStart = ''
311 for attempt in $(seq 1 30); do312 for attempt in $(seq 1 30); do
312 if printf 'header = "Studio-Proxy-Token: %s"\n' "$(cat ${proxyToken})" | curl --config - --fail --silent http://127.0.0.1:${dashboardPort}/ >/dev/null; then313 if printf 'header = "Snowglobe-Proxy-Token: %s"\n' "$(cat ${proxyToken})" | curl --config - --fail --silent http://127.0.0.1:${dashboardPort}/ >/dev/null; then
313 exit 0314 exit 0
314 fi315 fi
315 sleep 1316 sleep 1
...@@ -325,20 +326,20 @@ in...@@ -325,20 +326,20 @@ in
325 "d /srv/vm 0755 root root -"326 "d /srv/vm 0755 root root -"
326 "d /srv/logs 0770 clo chloe -"327 "d /srv/logs 0770 clo chloe -"
327 "A+ /srv/prod/ytdl/data - - - - g:chloe:rwX,m::rwX,d:g:chloe:rwx,d:m::rwx"328 "A+ /srv/prod/ytdl/data - - - - g:chloe:rwX,m::rwX,d:g:chloe:rwx,d:m::rwx"
328 "d /var/lib/studio 0700 root root -"329 "d /var/lib/snowglobe 0700 root root -"
329 "d /var/lib/studio/dashboard 0700 studio-dashboard studio-dashboard -"330 "d /var/lib/snowglobe/dashboard 0700 snowglobe-dashboard snowglobe-dashboard -"
330 "d /var/lib/studio/routes 0700 root root -"331 "d /var/lib/snowglobe/routes 0700 root root -"
331 "d /var/lib/caddy/studio 0755 caddy caddy -"332 "d /var/lib/caddy/snowglobe 0755 caddy caddy -"
332 "f /var/lib/caddy/routes.caddy 0640 caddy caddy -"333 "f /var/lib/caddy/routes.caddy 0640 caddy caddy -"
333 "d /var/lib/swtpm-localca 0750 tss tss -"334 "d /var/lib/swtpm-localca 0750 tss tss -"
334 ];335 ];
335336
336 environment.variables.STUDIO_NODE_NAME = config.networking.hostName;337 environment.variables.SNOWGLOBE_NODE_NAME = config.networking.hostName;
337 environment.variables.STUDIO_DOMAIN = lib.mkDefault "studio.test";338 environment.variables.SNOWGLOBE_DOMAIN = lib.mkDefault "snowglobe.test";
338 environment.variables.STUDIO_VM_SECURE_OVMF_CODE = secureOvmf.firmware;339 environment.variables.SNOWGLOBE_VM_SECURE_OVMF_CODE = secureOvmf.firmware;
339 environment.variables.STUDIO_VM_SECURE_OVMF_VARS = secureOvmf.variablesMs;340 environment.variables.SNOWGLOBE_VM_SECURE_OVMF_VARS = secureOvmf.variablesMs;
340 environment.variables.STUDIO_VM_SECURE_AAVMF_CODE = "${secureAavmf}/code.fd";341 environment.variables.SNOWGLOBE_VM_SECURE_AAVMF_CODE = "${secureAavmf}/code.fd";
341 environment.variables.STUDIO_VM_SECURE_AAVMF_VARS = "${secureAavmf}/vars.fd";342 environment.variables.SNOWGLOBE_VM_SECURE_AAVMF_VARS = "${secureAavmf}/vars.fd";
342 environment.variables.STUDIO_VM_WINDOWS_ARM_EMULATOR = "${windowsArmQemu}/bin/qemu-system-aarch64";343 environment.variables.SNOWGLOBE_VM_WINDOWS_ARM_EMULATOR = "${windowsArmQemu}/bin/qemu-system-aarch64";
343 environment.systemPackages = with pkgs; [ acl curl jq openssl python3 rsync zfs qemu ] ++ [ nativePkl ];344 environment.systemPackages = with pkgs; [ acl curl jq openssl python3 rsync zfs qemu ] ++ [ nativePkl ];
344}345}
nixos/dashboard.nix+6-8
...@@ -6,9 +6,7 @@ let...@@ -6,9 +6,7 @@ let
6 root = ../.;6 root = ../.;
7 fileset = lib.fileset.unions [7 fileset = lib.fileset.unions [
8 ../config8 ../config
9 (lib.fileset.difference ../service (lib.fileset.unions9 ../service
10 (builtins.filter builtins.pathExists (map (name: ../service + "/${name}")
11 (builtins.fromJSON (builtins.readFile ../config/excluded-services.json))))))
12 ];10 ];
13 };11 };
14 web = stdenv.mkDerivation (finalAttrs: {12 web = stdenv.mkDerivation (finalAttrs: {
...@@ -49,17 +47,17 @@ let...@@ -49,17 +47,17 @@ let
49 };47 };
50 dashboard = runCommand "home-dashboard-0.1.0" {48 dashboard = runCommand "home-dashboard-0.1.0" {
51 passthru.image = dockerTools.buildLayeredImage {49 passthru.image = dockerTools.buildLayeredImage {
52 name = "studio-dashboard";50 name = "snowglobe-dashboard";
53 contents = [ dashboard coreutils nativePkl youtubePython yt-dlp ffmpeg dockerTools.caCertificates ];51 contents = [ dashboard coreutils nativePkl youtubePython yt-dlp ffmpeg dockerTools.caCertificates ];
54 config = {52 config = {
55 User = "65534:65534";53 User = "65534:65534";
56 Cmd = [ "${dashboard}/bin/home-dashboard" ];54 Cmd = [ "${dashboard}/bin/home-dashboard" ];
57 WorkingDir = "${dashboard}/lib/home-dashboard";55 WorkingDir = "${dashboard}/lib/home-dashboard";
58 Env = [56 Env = [
59 "STUDIO_LISTEN_ADDRESS=0.0.0.0" "PORT=7072"57 "SNOWGLOBE_LISTEN_ADDRESS=0.0.0.0" "PORT=7072"
60 "STUDIO_PROXY_TOKEN_FILE=/run/secrets/dashboard-proxy.token"58 "SNOWGLOBE_PROXY_TOKEN_FILE=/run/secrets/dashboard-proxy.token"
61 "STUDIO_REPO=${source}"59 "SNOWGLOBE_REPO=${source}"
62 "STUDIO_YT_PYTHON=${youtubePython}/bin/python3"60 "SNOWGLOBE_YT_PYTHON=${youtubePython}/bin/python3"
63 "PATH=${lib.makeBinPath [ coreutils nativePkl youtubePython yt-dlp ffmpeg ]}"61 "PATH=${lib.makeBinPath [ coreutils nativePkl youtubePython yt-dlp ffmpeg ]}"
64 ];62 ];
65 };63 };
nixos/snowglobe-network.nix created+10
...@@ -0,0 +1,10 @@
1{
2 networking.useDHCP = false;
3 networking.interfaces.enp4s0.useDHCP = false;
4 networking.interfaces.enp4s0.ipv4.addresses = [
5 { address = "10.0.0.1"; prefixLength = 24; }
6 { address = "192.168.0.1"; prefixLength = 24; }
7 ];
8 networking.defaultGateway = { address = "10.0.0.2"; interface = "enp4s0"; };
9 networking.nameservers = [ "1.1.1.1" "1.0.0.1" ];
10}
nixos/snowglobe.nix created+102
...@@ -0,0 +1,102 @@
1{ config, lib, pkgs, ... }:
2let
3 adminKey = lib.fileContents ../config/admin.pub;
4 pool = "globe";
5 xmppNetwork = builtins.fromJSON (builtins.readFile ../service/xmpp/network.json);
6 xmppTCPPorts = map (name: xmppNetwork.${name}) [ "c2s" "c2s_tls" "s2s" "turn" "turn_tls" ];
7 xmppUDPPorts = [ xmppNetwork.turn xmppNetwork.turn_tls ];
8 encryptionRoots = {
9 apps = "apps";
10 clover = "clover";
11 media = "clover/Media";
12 logs = "logs";
13 prod = "prod";
14 staging = "staging";
15 };
16in
17{
18 imports = [ ./snowglobe-network.nix ];
19
20 networking.hostName = "snowglobe";
21 environment.etc."machine-info".text = ''
22 PRETTY_HOSTNAME="snow globe"
23 '';
24 networking.hostId = "4fa19ccb";
25 services.nomad.settings.name = config.networking.hostName;
26 networking.firewall.allowedTCPPorts = [ 80 443 ] ++ xmppTCPPorts;
27 networking.firewall.allowedUDPPorts = xmppUDPPorts;
28 networking.firewall.allowedUDPPortRanges = [{ from = xmppNetwork.relay_first; to = xmppNetwork.relay_last; }];
29 networking.firewall.interfaces.enp4s0.allowedTCPPorts = [ 445 ];
30
31 systemd.services.xmpp-nat = {
32 wantedBy = [ "multi-user.target" ];
33 wants = [ "network-online.target" ];
34 after = [ "network-online.target" ];
35 startAt = "*:0/5";
36 serviceConfig = { Type = "oneshot"; DynamicUser = true; };
37 script = ''
38 ${pkgs.miniupnpc}/bin/upnpc -u http://${config.networking.defaultGateway.address}:1900/whaoc/rootDesc.xml -e "Snow Globe XMPP" -r \
39 ${lib.concatMapStringsSep " " (port: "${toString port} TCP") xmppTCPPorts} \
40 ${lib.concatMapStringsSep " " (port: "${toString port} UDP") (xmppUDPPorts ++ lib.range xmppNetwork.relay_first xmppNetwork.relay_last)}
41 '';
42 };
43
44 boot.loader.systemd-boot.enable = true;
45 boot.loader.efi.canTouchEfiVariables = true;
46 boot.zfs.forceImportRoot = false;
47 boot.zfs.extraPools = [ pool ];
48 boot.zfs.requestEncryptionCredentials = false;
49 security.tpm2.enable = true;
50
51 systemd.services.snowglobe-zfs-unlock = {
52 requires = [ "zfs-import-${pool}.service" "dev-tpmrm0.device" ];
53 after = [ "zfs-import-${pool}.service" "dev-tpmrm0.device" ];
54 before = [ "zfs-mount.service" ];
55 requiredBy = [ "zfs-mount.service" ];
56 unitConfig.DefaultDependencies = false;
57 serviceConfig = {
58 Type = "oneshot";
59 RemainAfterExit = true;
60 LoadCredentialEncrypted = lib.mapAttrsToList
61 (name: _: "zfs-${name}:/etc/credstore.encrypted/zfs-${name}") encryptionRoots;
62 };
63 script = lib.concatStrings (lib.mapAttrsToList (name: dataset: ''
64 if test "$(${pkgs.zfs}/bin/zfs get -H -o value keystatus ${pool}/${dataset})" = unavailable; then
65 ${pkgs.zfs}/bin/zfs load-key -L "file://$CREDENTIALS_DIRECTORY/zfs-${name}" ${pool}/${dataset}
66 fi
67 '') encryptionRoots);
68 };
69
70 services.xserver.videoDrivers = [ "nvidia" ];
71 hardware.graphics.enable = true;
72 hardware.nvidia.open = false;
73 hardware.nvidia.nvidiaPersistenced = true;
74 hardware.nvidia.nvidiaSettings = false;
75
76 systemd.services.nomad = {
77 requires = [ "zfs-import-${pool}.service" ];
78 after = [ "zfs-import-${pool}.service" "zfs-mount.service" ];
79 preStart = ''
80 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv)" = ${pool}
81 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/clover)" = ${pool}/clover
82 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/clover/Media)" = ${pool}/clover/Media
83 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/prod)" = ${pool}/prod
84 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/staging)" = ${pool}/staging
85 '';
86 };
87
88 users.groups.chloe.gid = 3000;
89 users.users.root.openssh.authorizedKeys.keys = [ adminKey ];
90 users.users.clo = {
91 isNormalUser = true;
92 uid = 3000;
93 group = "chloe";
94 extraGroups = [ "wheel" ];
95 openssh.authorizedKeys.keys = [ adminKey ];
96 };
97 environment.variables.SNOWGLOBE_POOL = pool;
98 environment.variables.SNOWGLOBE_DOMAIN = "paperclover.net";
99 environment.variables.SNOWGLOBE_LOCAL_AI = "true";
100
101 system.stateVersion = "26.05";
102}
nixos/vm.nix+33-33
...@@ -1,16 +1,16 @@...@@ -1,16 +1,16 @@
1{ lib, pkgs, ... }:1{ lib, pkgs, ... }:
2{2{
3 networking.hostName = "clover-demo";3 networking.hostName = "snowglobe-rehearsal";
4 networking.hostId = "d3c10e01";4 networking.hostId = "d3c10e01";
5 networking.useDHCP = true;5 networking.useDHCP = true;
6 networking.dhcpcd.denyInterfaces = [ "veth*" "podman*" ];6 networking.dhcpcd.denyInterfaces = [ "veth*" "podman*" ];
7 environment.variables.STUDIO_JAVA_OPTIONS = "-XX:TieredStopAtLevel=1";7 environment.variables.SNOWGLOBE_JAVA_OPTIONS = "-XX:TieredStopAtLevel=1";
8 environment.variables.STUDIO_INDEX_POOL = "studio-demo";8 environment.variables.SNOWGLOBE_INDEX_POOL = "snowglobe-demo";
9 environment.variables.STUDIO_API_TIMEOUT = "600";9 environment.variables.SNOWGLOBE_API_TIMEOUT = "600";
10 environment.variables.STUDIO_MEDIA_READ_ONLY = "true";10 environment.variables.SNOWGLOBE_MEDIA_READ_ONLY = "true";
11 environment.variables.STUDIO_VM_ACCEL = "qemu";11 environment.variables.SNOWGLOBE_VM_ACCEL = "qemu";
12 environment.variables.STUDIO_VM_PRESETS_ROOT = "/srv/vm/.library/presets";12 environment.variables.SNOWGLOBE_VM_PRESETS_ROOT = "/srv/vm/.library/presets";
13 environment.variables.STUDIO_VM_UPLOADS_ROOT = "/srv/vm/.library/iso";13 environment.variables.SNOWGLOBE_VM_UPLOADS_ROOT = "/srv/vm/.library/iso";
14 services.nomad.settings.client.cpu_total_compute = 16000;14 services.nomad.settings.client.cpu_total_compute = 16000;
15 services.nomad.settings.client.preferred_address_family = "ipv4";15 services.nomad.settings.client.preferred_address_family = "ipv4";
16 services.nomad.settings.plugin.nomad-driver-podman.config.client_http_timeout = "10m";16 services.nomad.settings.plugin.nomad-driver-podman.config.client_http_timeout = "10m";
...@@ -30,10 +30,10 @@...@@ -30,10 +30,10 @@
30 settings = {30 settings = {
31 interface = "tailscale0";31 interface = "tailscale0";
32 bind-dynamic = true;32 bind-dynamic = true;
33 address = "/studio.test/100.95.50.31";33 address = "/snowglobe.test/100.95.50.31";
34 };34 };
35 };35 };
36 services.caddy.virtualHosts."*.studio.test".extraConfig = ''36 services.caddy.virtualHosts."*.snowglobe.test".extraConfig = ''
37 tls internal37 tls internal
38 respond 40438 respond 404
39 '';39 '';
...@@ -54,35 +54,35 @@...@@ -54,35 +54,35 @@
54 };54 };
55 services.getty.autologinUser = "root";55 services.getty.autologinUser = "root";
56 users.groups.chloe.gid = 3000;56 users.groups.chloe.gid = 3000;
57 systemd.services.studio-demo-pool = {57 systemd.services.snowglobe-demo-pool = {
58 wantedBy = [ "multi-user.target" ];58 wantedBy = [ "multi-user.target" ];
59 before = [ "studio-media-view.service" "nomad.service" ];59 before = [ "snowglobe-media-view.service" "nomad.service" ];
60 serviceConfig.Type = "oneshot";60 serviceConfig.Type = "oneshot";
61 script = ''61 script = ''
62 ${pkgs.coreutils}/bin/mkdir -p /var/lib/studio /srv/clover62 ${pkgs.coreutils}/bin/mkdir -p /var/lib/snowglobe /srv/clover
63 if ! ${pkgs.zfs}/bin/zpool list studio-demo >/dev/null 2>&1; then63 if ! ${pkgs.zfs}/bin/zpool list snowglobe-demo >/dev/null 2>&1; then
64 if test -e /var/lib/studio/zpool.img; then64 if test -e /var/lib/snowglobe/zpool.img; then
65 ${pkgs.zfs}/bin/zpool import -d /var/lib/studio studio-demo65 ${pkgs.zfs}/bin/zpool import -d /var/lib/snowglobe snowglobe-demo
66 else66 else
67 ${pkgs.coreutils}/bin/truncate -s 16G /var/lib/studio/zpool.img67 ${pkgs.coreutils}/bin/truncate -s 16G /var/lib/snowglobe/zpool.img
68 ${pkgs.zfs}/bin/zpool create -f -o ashift=12 -O mountpoint=none studio-demo /var/lib/studio/zpool.img68 ${pkgs.zfs}/bin/zpool create -f -o ashift=12 -O mountpoint=none snowglobe-demo /var/lib/snowglobe/zpool.img
69 fi69 fi
70 fi70 fi
71 if test "$(${pkgs.coreutils}/bin/stat -c %s /var/lib/studio/zpool.img)" -lt 17179869184; then71 if test "$(${pkgs.coreutils}/bin/stat -c %s /var/lib/snowglobe/zpool.img)" -lt 17179869184; then
72 ${pkgs.coreutils}/bin/truncate -s 16G /var/lib/studio/zpool.img72 ${pkgs.coreutils}/bin/truncate -s 16G /var/lib/snowglobe/zpool.img
73 ${pkgs.zfs}/bin/zpool online -e studio-demo /var/lib/studio/zpool.img73 ${pkgs.zfs}/bin/zpool online -e snowglobe-demo /var/lib/snowglobe/zpool.img
74 fi74 fi
75 if ! ${pkgs.zfs}/bin/zfs list studio-demo/clover >/dev/null 2>&1; then75 if ! ${pkgs.zfs}/bin/zfs list snowglobe-demo/clover >/dev/null 2>&1; then
76 ${pkgs.zfs}/bin/zfs create -o mountpoint=/srv/clover -o acltype=posixacl studio-demo/clover76 ${pkgs.zfs}/bin/zfs create -o mountpoint=/srv/clover -o acltype=posixacl snowglobe-demo/clover
77 fi77 fi
78 test "$(${pkgs.zfs}/bin/zfs get -H -o value mountpoint studio-demo/clover)" = /srv/clover78 test "$(${pkgs.zfs}/bin/zfs get -H -o value mountpoint snowglobe-demo/clover)" = /srv/clover
79 ${pkgs.zfs}/bin/zfs mount studio-demo/clover 2>/dev/null ||79 ${pkgs.zfs}/bin/zfs mount snowglobe-demo/clover 2>/dev/null ||
80 ${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/clover | ${pkgs.gnugrep}/bin/grep -qx studio-demo/clover80 ${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/clover | ${pkgs.gnugrep}/bin/grep -qx snowglobe-demo/clover
81 ${pkgs.coreutils}/bin/chown 3000:3000 /srv/clover81 ${pkgs.coreutils}/bin/chown 3000:3000 /srv/clover
82 ${pkgs.coreutils}/bin/chmod 2770 /srv/clover82 ${pkgs.coreutils}/bin/chmod 2770 /srv/clover
83 '';83 '';
84 };84 };
85 systemd.services.studio-media-source = {85 systemd.services.snowglobe-media-source = {
86 serviceConfig = {86 serviceConfig = {
87 Type = "oneshot";87 Type = "oneshot";
88 RemainAfterExit = true;88 RemainAfterExit = true;
...@@ -103,9 +103,9 @@...@@ -103,9 +103,9 @@
103 exit 1103 exit 1
104 '';104 '';
105 };105 };
106 systemd.services.studio-media-view = {106 systemd.services.snowglobe-media-view = {
107 after = [ "studio-demo-pool.service" "studio-media-source.service" ];107 after = [ "snowglobe-demo-pool.service" "snowglobe-media-source.service" ];
108 requires = [ "studio-demo-pool.service" "studio-media-source.service" ];108 requires = [ "snowglobe-demo-pool.service" "snowglobe-media-source.service" ];
109 serviceConfig = {109 serviceConfig = {
110 Type = "oneshot";110 Type = "oneshot";
111 RemainAfterExit = true;111 RemainAfterExit = true;
...@@ -116,9 +116,9 @@...@@ -116,9 +116,9 @@
116 };116 };
117 };117 };
118 systemd.services.nomad = {118 systemd.services.nomad = {
119 wants = [ "studio-demo-pool.service" ];119 wants = [ "snowglobe-demo-pool.service" ];
120 requires = [ "studio-media-view.service" ];120 requires = [ "snowglobe-media-view.service" ];
121 after = [ "studio-demo-pool.service" "studio-media-view.service" ];121 after = [ "snowglobe-demo-pool.service" "snowglobe-media-view.service" ];
122 };122 };
123123
124 system.stateVersion = "26.05";124 system.stateVersion = "26.05";
nixos/zenith-network.nix deleted-10
...@@ -1,10 +0,0 @@
1{
2 networking.useDHCP = false;
3 networking.interfaces.enp4s0.useDHCP = false;
4 networking.interfaces.enp4s0.ipv4.addresses = [
5 { address = "10.0.0.1"; prefixLength = 24; }
6 { address = "192.168.0.1"; prefixLength = 24; }
7 ];
8 networking.defaultGateway = { address = "10.0.0.2"; interface = "enp4s0"; };
9 networking.nameservers = [ "1.1.1.1" "1.0.0.1" ];
10}
nixos/zenith.nix deleted-98
...@@ -1,98 +0,0 @@
1{ config, lib, pkgs, ... }:
2let
3 adminKey = lib.fileContents ../config/admin.pub;
4 pool = "globe";
5 xmppNetwork = builtins.fromJSON (builtins.readFile ../service/xmpp/network.json);
6 xmppTCPPorts = map (name: xmppNetwork.${name}) [ "c2s" "c2s_tls" "s2s" "turn" "turn_tls" ];
7 xmppUDPPorts = [ xmppNetwork.turn xmppNetwork.turn_tls ];
8 encryptionRoots = {
9 apps = "apps";
10 clover = "clover";
11 media = "clover/Media";
12 logs = "logs";
13 prod = "prod";
14 staging = "staging";
15 };
16in
17{
18 imports = [ ./zenith-network.nix ];
19
20 networking.hostName = "zenith";
21 networking.hostId = "4fa19ccb";
22 networking.firewall.allowedTCPPorts = [ 80 443 ] ++ xmppTCPPorts;
23 networking.firewall.allowedUDPPorts = xmppUDPPorts;
24 networking.firewall.allowedUDPPortRanges = [{ from = xmppNetwork.relay_first; to = xmppNetwork.relay_last; }];
25 networking.firewall.interfaces.enp4s0.allowedTCPPorts = [ 445 ];
26
27 systemd.services.xmpp-nat = {
28 wantedBy = [ "multi-user.target" ];
29 wants = [ "network-online.target" ];
30 after = [ "network-online.target" ];
31 startAt = "*:0/5";
32 serviceConfig = { Type = "oneshot"; DynamicUser = true; };
33 script = ''
34 ${pkgs.miniupnpc}/bin/upnpc -u http://${config.networking.defaultGateway.address}:1900/whaoc/rootDesc.xml -e "Snow Globe XMPP" -r \
35 ${lib.concatMapStringsSep " " (port: "${toString port} TCP") xmppTCPPorts} \
36 ${lib.concatMapStringsSep " " (port: "${toString port} UDP") (xmppUDPPorts ++ lib.range xmppNetwork.relay_first xmppNetwork.relay_last)}
37 '';
38 };
39
40 boot.loader.systemd-boot.enable = true;
41 boot.loader.efi.canTouchEfiVariables = true;
42 boot.zfs.forceImportRoot = false;
43 boot.zfs.extraPools = [ pool ];
44 boot.zfs.requestEncryptionCredentials = false;
45 security.tpm2.enable = true;
46
47 systemd.services.studio-zfs-unlock = {
48 requires = [ "zfs-import-${pool}.service" "dev-tpmrm0.device" ];
49 after = [ "zfs-import-${pool}.service" "dev-tpmrm0.device" ];
50 before = [ "zfs-mount.service" ];
51 requiredBy = [ "zfs-mount.service" ];
52 unitConfig.DefaultDependencies = false;
53 serviceConfig = {
54 Type = "oneshot";
55 RemainAfterExit = true;
56 LoadCredentialEncrypted = lib.mapAttrsToList
57 (name: _: "zfs-${name}:/etc/credstore.encrypted/zfs-${name}") encryptionRoots;
58 };
59 script = lib.concatStrings (lib.mapAttrsToList (name: dataset: ''
60 if test "$(${pkgs.zfs}/bin/zfs get -H -o value keystatus ${pool}/${dataset})" = unavailable; then
61 ${pkgs.zfs}/bin/zfs load-key -L "file://$CREDENTIALS_DIRECTORY/zfs-${name}" ${pool}/${dataset}
62 fi
63 '') encryptionRoots);
64 };
65
66 services.xserver.videoDrivers = [ "nvidia" ];
67 hardware.graphics.enable = true;
68 hardware.nvidia.open = false;
69 hardware.nvidia.nvidiaPersistenced = true;
70 hardware.nvidia.nvidiaSettings = false;
71
72 systemd.services.nomad = {
73 requires = [ "zfs-import-${pool}.service" ];
74 after = [ "zfs-import-${pool}.service" "zfs-mount.service" ];
75 preStart = ''
76 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv)" = ${pool}
77 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/clover)" = ${pool}/clover
78 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/clover/Media)" = ${pool}/clover/Media
79 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/prod)" = ${pool}/prod
80 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/staging)" = ${pool}/staging
81 '';
82 };
83
84 users.groups.chloe.gid = 3000;
85 users.users.root.openssh.authorizedKeys.keys = [ adminKey ];
86 users.users.clo = {
87 isNormalUser = true;
88 uid = 3000;
89 group = "chloe";
90 extraGroups = [ "wheel" ];
91 openssh.authorizedKeys.keys = [ adminKey ];
92 };
93 environment.variables.STUDIO_POOL = pool;
94 environment.variables.STUDIO_DOMAIN = "paperclover.net";
95 environment.variables.STUDIO_LOCAL_AI = "true";
96
97 system.stateVersion = "26.05";
98}
readme.md+33-12
...@@ -8,16 +8,36 @@ from Jellyfin and Navidrome for media consumption to git hosting and render...@@ -8,16 +8,36 @@ from Jellyfin and Navidrome for media consumption to git hosting and render
8farms.8farms.
99
10The system is built out of a NixOS base (just to install the system itself),10The system is built out of a NixOS base (just to install the system itself),
11using managed docker containers (managed via Nomad) and virtual machines to run11using Podman containers scheduled by Nomad and virtual machines to run the
12all the real services. There is a lot of custom tooling to spawn interactive12services. Changes automatically get a staging deployment on Snow Globe for
13testing environments. For example, without even pushing any code, I can edit the13testing and review. Production promotion is a separate, explicit step.
14configuration of a service or upgrade it, then spin up an isolated domain like
15`shale-4c84f9da.staging.paperclover.net` to verify changes. Then, pushing to
16production ensures that the new deployment is healthy before routing traffic to
17it -- It's kind of like "easy kubernetes."
1814
19[paper clover]: https://paperclover.net15[paper clover]: https://paperclover.net
2016
17## change → preview → review
18
19The deployment tool defaults to Snow Globe at `root@10.0.0.1:22`.
20
21```sh
22python3 tools/deploy.py stage shale
23python3 tools/deploy.py stage dashboard
24```
25
26These upload working files and print the preview URL. Service previews use
27separate ZFS storage; the dashboard preview uses disposable accounts and files,
28with read-only observations of the real host. Test the app and keep its preview
29available for review. Repeating the command updates that preview.
30
31After approval, commit the reviewed changes on `main` and run
32`python3 tools/deploy.py prod`. The release workflow backs up state, activates
33the release, and checks production health. Single-writer services can have a
34brief interruption. Code rollback and data restore are separate operations.
35
36GPU AI changes are tested directly in production. VM integration uses disposable
37guests on the real machine. Most other work follows the preview workflow above;
38isolated host testing is documented in [tools/rehearsal.md](tools/rehearsal.md).
39The complete agent workflow is in [AGENTS.md](AGENTS.md).
40
21## filesystem layout41## filesystem layout
2242
23The computer mounts the ZFS root dataset under `/srv`, meaning "server," loosely43The computer mounts the ZFS root dataset under `/srv`, meaning "server," loosely
...@@ -29,7 +49,7 @@ srv/...@@ -29,7 +49,7 @@ srv/
29 +--- Archive/<year> personal archive. one folder per year, scrambled within.49 +--- Archive/<year> personal archive. one folder per year, scrambled within.
30 +--- Asset/ resources, sample packs, audio plugins, stock videos50 +--- Asset/ resources, sample packs, audio plugins, stock videos
31 +--- Blender/ 51 +--- Blender/
32 +--- Font/ (moved from zenith Documents/Font, will be stable index)52 +--- Font/
33 +--- Samples/ 53 +--- Samples/
34 +--- Texture/ 54 +--- Texture/
35 +--- Video/ 55 +--- Video/
...@@ -52,7 +72,8 @@ srv/...@@ -52,7 +72,8 @@ srv/
52 +--- clover-sandbox/ [dataset]72 +--- clover-sandbox/ [dataset]
53```73```
5474
55Media is it's own dataset so it can be snapshotted independently of my personal75Media is its own dataset so it can be snapshotted independently of personal
56data (less frequent, lower retention), and all my personal files are on the same76data. Personal files share a dataset to allow fast moves between top-level
57dataset to allow fast move/copying between top level folders. Services use their77folders; services use separate datasets for copy-on-write previews. No automatic
58own datasets to implement copy-on-write forks.78snapshot retention policy is configured. Hardware, encryption, permissions, and
79recovery boundaries are documented in [tools/snowglobe-hardware.md](tools/snowglobe-hardware.md).
service/clover-source-of-truth/service.pkl+3-2
...@@ -2,7 +2,8 @@ amends "../../config/Service.pkl"...@@ -2,7 +2,8 @@ amends "../../config/Service.pkl"
22
3import "../../config/site.pkl" as site3import "../../config/site.pkl" as site
44
5meta { name = "Clover DB"; launcher = false }5name = "Clover DB"
6launcher = false
67
7local isTest = site.domain.endsWith(".test")8local isTest = site.domain.endsWith(".test")
89
...@@ -31,6 +32,6 @@ container {...@@ -31,6 +32,6 @@ container {
31 ["CLOVER_FILE_DERIVED"] = "/data/derived"32 ["CLOVER_FILE_DERIVED"] = "/data/derived"
32 ["CLOVER_SOT_KEY"] = "${secret.own.key}"33 ["CLOVER_SOT_KEY"] = "${secret.own.key}"
33 ["CLOVER_INDEX_CORES"] = "4"34 ["CLOVER_INDEX_CORES"] = "4"
34 ["CLOVER_INDEXER"] = if (site.pool == "studio-demo") "0" else "1"35 ["CLOVER_INDEXER"] = if (site.pool == "snowglobe-demo") "0" else "1"
35 }36 }
36}37}
service/copyparty/copyparty.conf+2-2
...@@ -3,7 +3,7 @@...@@ -3,7 +3,7 @@
3 p: 39233 p: 3923
4 shr: /shr4 shr: /shr
5 hist: /cfg/hists5 hist: /cfg/hists
6 df: STUDIO_MIN_FREE_GB6 df: SNOWGLOBE_MIN_FREE_GB
7 ver7 ver
8 theme: 28 theme: 2
9 name: clover's nas9 name: clover's nas
...@@ -19,7 +19,7 @@...@@ -19,7 +19,7 @@
19 auth-ord: pw,idp,ipu19 auth-ord: pw,idp,ipu
20 idp-h-usr: user-name20 idp-h-usr: user-name
21 idp-h-grp: user-groups21 idp-h-grp: user-groups
22 idp-h-key: STUDIO_IDP_HEADER22 idp-h-key: SNOWGLOBE_IDP_HEADER
23 idp-login: /auth/file/sign-in?rd={dst}23 idp-login: /auth/file/sign-in?rd={dst}
24 idp-logout: /auth/file/sign-out24 idp-logout: /auth/file/sign-out
25 idp-login-t: with snow globe25 idp-login-t: with snow globe
service/copyparty/manage.py+9-9
...@@ -165,7 +165,7 @@ def configuration(cfg, state, items, source=None):...@@ -165,7 +165,7 @@ def configuration(cfg, state, items, source=None):
165 raise Error(503, 'Copyparty sign-in configuration is unavailable. Redeploy the service.')165 raise Error(503, 'Copyparty sign-in configuration is unavailable. Redeploy the service.')
166 capacity = os.statvfs(cfg)166 capacity = os.statvfs(cfg)
167 reserve = max(1, min(16, capacity.f_blocks * capacity.f_frsize // (4 * 10**9)))167 reserve = max(1, min(16, capacity.f_blocks * capacity.f_frsize // (4 * 10**9)))
168 base = base.replace('STUDIO_IDP_HEADER', 'X-Studio-Idp-' + proof).replace('STUDIO_MIN_FREE_GB', str(reserve))168 base = base.replace('SNOWGLOBE_IDP_HEADER', 'X-Snowglobe-Idp-' + proof).replace('SNOWGLOBE_MIN_FREE_GB', str(reserve))
169 return render(base, state, items).encode()169 return render(base, state, items).encode()
170170
171171
...@@ -196,11 +196,11 @@ def rename(source, destination):...@@ -196,11 +196,11 @@ def rename(source, destination):
196196
197class Manager:197class Manager:
198 def __init__(self, users):198 def __init__(self, users):
199 root = Path(os.environ.get('STUDIO_ROOT', '/srv'))199 root = Path(os.environ.get('SNOWGLOBE_ROOT', '/srv'))
200 self.root = Path(os.environ.get('STUDIO_CLOVER_ROOT', str(root / 'clover'))).resolve()200 self.root = Path(os.environ.get('SNOWGLOBE_CLOVER_ROOT', str(root / 'clover'))).resolve()
201 self.cfg = Path(os.environ.get('STUDIO_COPYPARTY_CFG', str(root / 'prod/copyparty/cfg')))201 self.cfg = Path(os.environ.get('SNOWGLOBE_COPYPARTY_CFG', str(root / 'prod/copyparty/cfg')))
202 self.native = self.cfg / 'copyparty'202 self.native = self.cfg / 'copyparty'
203 self.service = os.environ.get('STUDIO_COPYPARTY_SERVICE', 'copyparty')203 self.service = os.environ.get('SNOWGLOBE_COPYPARTY_SERVICE', 'copyparty')
204 self.users = users204 self.users = users
205 self.path = self.cfg / 'manager.json'205 self.path = self.cfg / 'manager.json'
206 self.changed = set()206 self.changed = set()
...@@ -280,7 +280,7 @@ class Manager:...@@ -280,7 +280,7 @@ class Manager:
280 raise Error(503, 'Copyparty address is unavailable. Redeploy its service.')280 raise Error(503, 'Copyparty address is unavailable. Redeploy its service.')
281 address = '[' + address + ']' if ':' in address else address281 address = '[' + address + ']' if ':' in address else address
282 request = urllib.request.Request('http://' + address + ':' + str(port) + '/?reload=cfg', headers={282 request = urllib.request.Request('http://' + address + ':' + str(port) + '/?reload=cfg', headers={
283 'User-Name': 'snow', 'User-Groups': '', 'X-Studio-Idp-' + items['idp_header']: '1',283 'User-Name': 'snow', 'User-Groups': '', 'X-Snowglobe-Idp-' + items['idp_header']: '1',
284 })284 })
285 try:285 try:
286 with urllib.request.urlopen(request, timeout=remaining(deadline, 30)) as response:286 with urllib.request.urlopen(request, timeout=remaining(deadline, 30)) as response:
...@@ -340,7 +340,7 @@ class Manager:...@@ -340,7 +340,7 @@ class Manager:
340 if virtual == 'clover' or virtual.startswith('clover/'):340 if virtual == 'clover' or virtual.startswith('clover/'):
341 return self.root / virtual[len('clover'):].lstrip('/')341 return self.root / virtual[len('clover'):].lstrip('/')
342 if virtual == 'media' or virtual.startswith('media/'):342 if virtual == 'media' or virtual.startswith('media/'):
343 media = Path(os.environ.get('STUDIO_MEDIA_ROOT', str(self.root / 'Media')))343 media = Path(os.environ.get('SNOWGLOBE_MEDIA_ROOT', str(self.root / 'Media')))
344 return media / virtual[len('media'):].lstrip('/')344 return media / virtual[len('media'):].lstrip('/')
345 return None345 return None
346346
...@@ -573,9 +573,9 @@ class Manager:...@@ -573,9 +573,9 @@ class Manager:
573573
574 def apply(self, action, payload):574 def apply(self, action, payload):
575 self.data = json.loads(runs.read(self.path, missing='{"accounts":[],"grants":[],"names":{}}'))575 self.data = json.loads(runs.read(self.path, missing='{"accounts":[],"grants":[],"names":{}}'))
576 origin = Path(self.data.get('root', os.environ.get('STUDIO_SOURCE_CLOVER_ROOT', '/srv/clover')))576 origin = Path(self.data.get('root', os.environ.get('SNOWGLOBE_SOURCE_CLOVER_ROOT', '/srv/clover')))
577 if 'root' not in self.data and self.data.get('grants'):577 if 'root' not in self.data and self.data.get('grants'):
578 origin = Path(os.environ.get('STUDIO_SOURCE_CLOVER_ROOT', str(self.root)))578 origin = Path(os.environ.get('SNOWGLOBE_SOURCE_CLOVER_ROOT', str(self.root)))
579 if origin != self.root:579 if origin != self.root:
580 for grant in self.data['grants']:580 for grant in self.data['grants']:
581 grant['path'] = str(self.root / Path(grant['path']).relative_to(origin))581 grant['path'] = str(self.root / Path(grant['path']).relative_to(origin))
service/copyparty/prepare.py+1-1
...@@ -20,7 +20,7 @@ variable = json.loads(subprocess.check_output(...@@ -20,7 +20,7 @@ variable = json.loads(subprocess.check_output(
20items = variable['Items']20items = variable['Items']
21state_path = cfg / 'manager.json'21state_path = cfg / 'manager.json'
22state = json.loads(state_path.read_text()) if state_path.exists() else {'accounts': [], 'grants': [], 'names': {}}22state = json.loads(state_path.read_text()) if state_path.exists() else {'accounts': [], 'grants': [], 'names': {}}
23canonical_root = Path(os.environ.get('STUDIO_CLOVER_ROOT', str(Path(os.environ.get('STUDIO_ROOT', '/srv')) / 'clover')))23canonical_root = Path(os.environ.get('SNOWGLOBE_CLOVER_ROOT', str(Path(os.environ.get('SNOWGLOBE_ROOT', '/srv')) / 'clover')))
24origin = Path(state.get('root', str(canonical_root)))24origin = Path(state.get('root', str(canonical_root)))
25if origin != canonical_root:25if origin != canonical_root:
26 for grant in state['grants']:26 for grant in state['grants']:
service/copyparty/service.pkl+1-4
...@@ -2,8 +2,7 @@ amends "../../config/Service.pkl"...@@ -2,8 +2,7 @@ amends "../../config/Service.pkl"
22
3import "../../config/site.pkl" as site3import "../../config/site.pkl" as site
44
5meta { name = "Copyparty" }5name = "Copyparty"
6rollout = "simple"
7prepare = "prepare.py"6prepare = "prepare.py"
87
9secrets {8secrets {
...@@ -12,8 +11,6 @@ secrets {...@@ -12,8 +11,6 @@ secrets {
1211
13container {12container {
14 image = "docker.io/copyparty/ac@sha256:9658d60c7fec0bffb968cacc677712be3c8a6e73bb388b6b47b7f2b178a754a6"13 image = "docker.io/copyparty/ac@sha256:9658d60c7fec0bffb968cacc677712be3c8a6e73bb388b6b47b7f2b178a754a6"
15 cpu = 200
16 memory = 512
1714
18 http {15 http {
19 containerPort = 392316 containerPort = 3923
service/dawarich/redis-insight.pkl+1-2
...@@ -1,6 +1,6 @@...@@ -1,6 +1,6 @@
1amends "../../config/Service.pkl"1amends "../../config/Service.pkl"
22
3meta { name = "Redis Insight" }3name = "Redis Insight"
4dependsOn { "dawarich" }4dependsOn { "dawarich" }
55
6secrets {6secrets {
...@@ -10,7 +10,6 @@ secrets {...@@ -10,7 +10,6 @@ secrets {
10container {10container {
11 image = "docker.io/redis/redisinsight@sha256:0131987fd5fefe3828ed33666f9742bd071b729f5a95cf923c593c14a8995c2c"11 image = "docker.io/redis/redisinsight@sha256:0131987fd5fefe3828ed33666f9742bd071b729f5a95cf923c593c14a8995c2c"
12 cpu = 15012 cpu = 150
13 memory = 512
1413
15 http {14 http {
16 containerPort = 554015 containerPort = 5540
service/dawarich/service.pkl+4-6
...@@ -32,7 +32,7 @@ local sharedVolumes: Mapping<String, service.Volume> = new {...@@ -32,7 +32,7 @@ local sharedVolumes: Mapping<String, service.Volume> = new {
32 ["/var/app/storage"] {}32 ["/var/app/storage"] {}
33 ["/var/app/tmp/imports/watched"] {}33 ["/var/app/tmp/imports/watched"] {}
34 ["/etc/ssl/certs/ca-certificates.crt"] {34 ["/etc/ssl/certs/ca-certificates.crt"] {
35 src = "/var/lib/studio/ca-bundle.crt"35 src = "/var/lib/snowglobe/ca-bundle.crt"
36 readOnly = true36 readOnly = true
37 }37 }
38}38}
...@@ -43,14 +43,15 @@ local databaseEnv = """...@@ -43,14 +43,15 @@ local databaseEnv = """
43 {{ range nomadService 1 (env "NOMAD_ALLOC_ID") "\(module.id)-redis" }}REDIS_URL=redis://\(module.nomadHostPort){{ end }}43 {{ range nomadService 1 (env "NOMAD_ALLOC_ID") "\(module.id)-redis" }}REDIS_URL=redis://\(module.nomadHostPort){{ end }}
44 """44 """
4545
46meta { name = "Dawarich"; access = "infra-admin" }46name = "Dawarich"
47access = "infra-admin"
47healthyDeadline = "20m"48healthyDeadline = "20m"
4849
49requirements {50requirements {
50 database51 database
51 new sso.Client {52 new sso.Client {
52 clientId = module.id53 clientId = module.id
53 name = module.meta.name54 name = module.name
54 redirectUris { "https://\(module.containers["web"].http.hostname)/users/auth/openid_connect/callback" }55 redirectUris { "https://\(module.containers["web"].http.hostname)/users/auth/openid_connect/callback" }
55 }56 }
56}57}
...@@ -66,7 +67,6 @@ containers {...@@ -66,7 +67,6 @@ containers {
66 args { "ruby"; "-e"; "exit 0" }67 args { "ruby"; "-e"; "exit 0" }
67 imageUser = true68 imageUser = true
68 lifecycle = "prestart"69 lifecycle = "prestart"
69 cpu = 200
70 memory = 102470 memory = 1024
71 volumes = sharedVolumes71 volumes = sharedVolumes
72 env = commonEnv72 env = commonEnv
...@@ -75,7 +75,6 @@ containers {...@@ -75,7 +75,6 @@ containers {
7575
76 ["web"] {76 ["web"] {
77 image = dawarichImage77 image = dawarichImage
78 extraHosts { "\(sso.hostname):host-gateway" }
79 entrypoint = "web-entrypoint.sh"78 entrypoint = "web-entrypoint.sh"
80 args { "bin/rails"; "server"; "-p"; "3000"; "-b"; "::" }79 args { "bin/rails"; "server"; "-p"; "3000"; "-b"; "::" }
81 imageUser = true80 imageUser = true
...@@ -107,7 +106,6 @@ containers {...@@ -107,7 +106,6 @@ containers {
107 entrypoint = "sidekiq-entrypoint.sh"106 entrypoint = "sidekiq-entrypoint.sh"
108 args { "sidekiq" }107 args { "sidekiq" }
109 imageUser = true108 imageUser = true
110 cpu = 200
111 memory = 1024109 memory = 1024
112 volumes = sharedVolumes110 volumes = sharedVolumes
113 env = (commonEnv) {111 env = (commonEnv) {
service/ddns-updater/service.pkl+1-1
...@@ -16,7 +16,7 @@ class DnsCredentials extends service.Requirement {...@@ -16,7 +16,7 @@ class DnsCredentials extends service.Requirement {
16 srv: Listing<SrvRecord> = new {}16 srv: Listing<SrvRecord> = new {}
17}17}
1818
19meta { name = "DDNS" }19name = "DDNS"
20provide = "provide.py"20provide = "provide.py"
21enabled = !site.preview && !site.domain.endsWith(".test")21enabled = !site.preview && !site.domain.endsWith(".test")
2222
service/evil-forgejo/api.py deleted-33
...@@ -1,33 +0,0 @@
1import json
2import os
3import subprocess
4import urllib.request
5
6
7def nomad(path):
8 request = urllib.request.Request(
9 "http://127.0.0.1:4646/v1/" + path,
10 headers={"X-Nomad-Token": os.environ["NOMAD_TOKEN"]},
11 )
12 with urllib.request.urlopen(request, timeout=5) as response:
13 return json.load(response)
14
15
16def instance(job="evil-forgejo"):
17 running = [item["ID"] for item in nomad(f"job/{job}/allocations")
18 if item["ClientStatus"] == "running" and item["DesiredStatus"] == "run"]
19 if len(running) != 1:
20 raise ValueError(f"{job} needs one running allocation")
21 allocation = running[0]
22 services = [item for item in nomad(f"service/{job}-forgejo") if item["AllocID"] == allocation]
23 if len(services) != 1:
24 raise ValueError(f"{job} has no Forgejo listener")
25 result = subprocess.run(
26 ["podman", "--url", "unix:///run/podman/podman.sock", "ps", "--format", "{{.ID}} {{.Names}}"],
27 check=True, capture_output=True, text=True,
28 )
29 containers = [parts[0] for line in result.stdout.splitlines()
30 if len(parts := line.split()) == 2 and parts[1] == "forgejo-" + allocation]
31 if len(containers) != 1:
32 raise ValueError(f"{job} Forgejo task is unavailable")
33 return containers[0], f"http://{services[0]['Address']}:{services[0]['Port']}"
service/evil-forgejo/app.ini deleted-115
...@@ -1,115 +0,0 @@
1APP_NAME="evil inc"
2APP_SLOGAL="be evil. take control back."
3RUN_MODE=prod
4RUN_USER=git
5WORK_PATH=/data/work
6
7[repository]
8MAX_CREATION_LIMIT=20000
9ROOT=/data/git/repositories
10DEFAULT_CLOSE_ISSUES_VIA_COMMITS_IN_ANY_BRANCH=true
11DEFAULT_REPO_UNITS=repo.code,repo.issues,repo.pulls
12DISABLE_STARS=true
13DEFAULT_BRANCH=master
14
15[repository.local]
16LOCAL_COPY_PATH=/data/work/tmp/local-repo
17
18[repository.upload]
19TEMP_PATH=/data/work/uploads
20
21[ui]
22EXPLORE_PAGING_NUM=100
23ISSUE_PAGING_NUM=500
24MEMBERS_PAGING_NUM=100
25THEMES=evil,evil-dark,evil-light
26DEFAULT_THEME=evil
27
28[server]
29APP_DATA_PATH=/data/work
30DOMAIN=$GIT_HOST
31SSH_DOMAIN=$GIT_HOST
32HTTP_ADDR=0.0.0.0
33HTTP_PORT=$FORGEJO_HTTP_PORT
34ROOT_URL=https://$GIT_HOST/
35LFS_JWT_SECRET=$FORGEJO_SERVER_LFS_JWT_SECRET
36LFS_START_SERVER=true
37OFFLINE_MODE=true
38LANDING_PAGE=/evil
39START_SSH_SERVER=false
40SSH_CREATE_AUTHORIZED_KEYS_FILE=false
41
42[database]
43DB_TYPE=postgres
44HOST=$DB_HOST
45NAME=$DB_NAME
46USER=$DB_USER
47PASSWD=$DB_PASSWORD
48LOG_SQL=false
49SCHEMA=
50SSL_MODE=disable
51
52[indexer]
53ISSUE_INDEXER_PATH=/data/work/indexers/issues.bleve
54
55[session]
56PROVIDER_CONFIG=/data/work/sessions
57PROVIDER=file
58
59[picture]
60AVATAR_UPLOAD_PATH=/data/work/avatars
61REPOSITORY_AVATAR_UPLOAD_PATH=/data/work/repo-avatars
62
63[admin]
64DISABLE_REGULAR_ORG_CREATION=true
65
66[attachment]
67PATH=/data/work/attachments
68
69[log]
70MODE=console
71LEVEL=info
72ROOT_PATH=/data/work/log
73
74[security]
75INSTALL_LOCK=true
76REVERSE_PROXY_LIMIT=1
77REVERSE_PROXY_TRUSTED_PROXIES=*
78PASSWORD_HASH_ALGO=pbkdf2_hi
79SECRET_KEY=$FORGEJO_SECURITY_SECRET_KEY
80INTERNAL_TOKEN=$FORGEJO_SECURITY_INTERNAL_TOKEN
81
82[service]
83ENABLE_INTERNAL_SIGNIN=true
84DISABLE_REGISTRATION=false
85ALLOW_ONLY_EXTERNAL_REGISTRATION=true
86SHOW_REGISTRATION_BUTTON=false
87REQUIRE_SIGNIN_VIEW=false
88REGISTER_EMAIL_CONFIRM=true
89ENABLE_NOTIFY_MAIL=true
90DEFAULT_KEEP_EMAIL_PRIVATE=false
91DEFAULT_ALLOW_CREATE_ORGANIZATION=true
92DEFAULT_ENABLE_TIMETRACKING=false
93
94[lfs]
95PATH = /data/git/lfs
96
97[mailer]
98ENABLED=$MAILER_ENABLED
99; TODO: get evil mailing credentials. we likely will not need this
100; for a while and can just use clover's email. its not that deep
101FROM=noreply.evil-git@paperclover.net
102PROTOCOL=smtps
103SMTP_PORT=465
104SMTP_ADDR=$MAILER_ADDRESS
105USER=$MAILER_USERNAME
106PASSWD=$MAILER_PASSWORD
107
108[repository.pull-request]
109DEFAULT_MERGE_STYLE=squash
110
111[repository.signing]
112DEFAULT_TRUST_MODEL=committer
113
114[oauth2]
115JWT_SECRET=$FORGEJO_OAUTH2_JWT_SECRET
service/evil-forgejo/icon.svg deleted-1
...@@ -1 +0,0 @@
1<svg fill="#fb923c" role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Forgejo</title><path d="M16.7773 0c1.6018 0 2.9004 1.2986 2.9004 2.9005s-1.2986 2.9004-2.9004 2.9004c-1.0854 0-2.0315-.596-2.5288-1.4787H12.91c-2.3322 0-4.2272 1.8718-4.2649 4.195l-.0007 2.1175a7.0759 7.0759 0 0 1 4.148-1.4205l.1176-.001 1.3385.0002c.4973-.8827 1.4434-1.4788 2.5288-1.4788 1.6018 0 2.9004 1.2986 2.9004 2.9005s-1.2986 2.9004-2.9004 2.9004c-1.0854 0-2.0315-.596-2.5288-1.4787H12.91c-2.3322 0-4.2272 1.8718-4.2649 4.195l-.0007 2.319c.8827.4973 1.4788 1.4434 1.4788 2.5287 0 1.602-1.2986 2.9005-2.9005 2.9005-1.6018 0-2.9004-1.2986-2.9004-2.9005 0-1.0853.596-2.0314 1.4788-2.5287l-.0002-9.9831c0-3.887 3.1195-7.0453 6.9915-7.108l.1176-.001h1.3385C14.7458.5962 15.692 0 16.7773 0ZM7.2227 19.9052c-.6596 0-1.1943.5347-1.1943 1.1943s.5347 1.1943 1.1943 1.1943 1.1944-.5347 1.1944-1.1943-.5348-1.1943-1.1944-1.1943Zm9.5546-10.4644c-.6596 0-1.1944.5347-1.1944 1.1943s.5348 1.1943 1.1944 1.1943c.6596 0 1.1943-.5347 1.1943-1.1943s-.5347-1.1943-1.1943-1.1943Zm0-7.7346c-.6596 0-1.1944.5347-1.1944 1.1943s.5348 1.1943 1.1944 1.1943c.6596 0 1.1943-.5347 1.1943-1.1943s-.5347-1.1943-1.1943-1.1943Z"/></svg>
service/evil-forgejo/provide.py deleted-67
...@@ -1,67 +0,0 @@
1#!/usr/bin/env python3
2import json
3import sys
4import urllib.error
5import urllib.request
6
7from api import instance
8
9
10data = json.load(sys.stdin)
11request = data["request"]
12if request["kind"] != "oauth-client":
13 raise ValueError("unsupported Forgejo input")
14stage = data.get("stageId")
15existing = data.get("existing") or {}
16if data.get("operation") == "delete" and not stage:
17 raise ValueError("refusing to delete a production OAuth client")
18_, address = instance()
19authorization = "token " + data["providerSecrets"]["automation_token"]
20
21
22def api(path, method="GET", body=None, missing_ok=False):
23 query = urllib.request.Request(
24 address + "/api/v1" + path,
25 data=json.dumps(body).encode() if body is not None else None,
26 method=method,
27 headers={"Authorization": authorization, "Content-Type": "application/json"},
28 )
29 try:
30 with urllib.request.urlopen(query, timeout=10) as response:
31 return json.load(response) if response.status != 204 else None
32 except urllib.error.HTTPError as error:
33 if error.code == 404 and (method == "DELETE" or missing_ok):
34 return None
35 raise RuntimeError(f"Forgejo OAuth API returned HTTP {error.code}") from error
36
37
38application_id = existing.get("applicationId")
39if data.get("operation") == "delete":
40 if application_id:
41 api("/user/applications/oauth2/" + application_id, "DELETE")
42 sys.exit(0)
43
44suffix = request["name"] + (":" + stage if stage else "")
45name = "Snow Globe: " + suffix
46desired = {"name": name, "redirect_uris": request["redirectUris"], "confidential_client": True}
47if application_id:
48 current = api("/user/applications/oauth2/" + application_id, missing_ok=True)
49 if current and current["client_id"] == existing.get("clientId") and existing.get("clientSecret"):
50 if any(current[key] != value for key, value in desired.items()):
51 api("/user/applications/oauth2/" + application_id, "PATCH", desired)
52 client_id = existing["clientId"]
53 client_secret = existing["clientSecret"]
54 else:
55 application_id = None
56if not application_id:
57 applications = api("/user/applications/oauth2?limit=100")
58 if any(item["name"] in (name, "studio:" + suffix) for item in applications):
59 raise ValueError("Forgejo OAuth client exists without its stored secret")
60 created = api("/user/applications/oauth2", "POST", desired)
61 application_id = str(created["id"])
62 client_id = created["client_id"]
63 client_secret = created["client_secret"]
64if not client_id or not client_secret:
65 raise ValueError("Forgejo OAuth client has no credentials")
66print(json.dumps({"applicationId": application_id, "clientId": client_id,
67 "clientSecret": client_secret, "providerUrl": "https://" + data["host"]}))
service/evil-forgejo/public/assets/css/theme-evil-dark.css deleted-118
...@@ -1,118 +0,0 @@
1@import "theme-forgejo-dark.css";
2
3:root {
4 --f: 0.75;
5 --l: 4;
6 --steel-900: lch(from #10161d l calc(c * var(--f)) 320);
7 --steel-850: lch(from #131a21 l calc(c * var(--f)) 320);
8 --steel-800: lch(from #171e26 l calc(c * var(--f)) 320);
9 --steel-750: lch(from #1d262f l calc(c * var(--f)) 320);
10 --steel-700: lch(from #242d38 l calc(c * var(--f)) 320);
11 --steel-650: lch(from #2b3642 l calc(c * var(--f)) 320);
12 --steel-600: lch(from #374351 l calc(c * var(--f)) 320);
13 --steel-550: lch(from #445161 l calc(c * var(--f)) 320);
14 --steel-500: lch(from #515f70 l calc(c * var(--f)) 320);
15 --steel-450: lch(from #5f6e80 l calc(c * var(--f)) 320);
16 --steel-400: lch(from #6d7d8f l calc(c * var(--f)) 320);
17 --steel-350: lch(from #7c8c9f l calc(c * var(--f)) 320);
18 --steel-300: lch(from #8c9caf l calc(c * var(--f)) 320);
19 --steel-250: lch(from #9dadc0 l calc(c * var(--f)) 320);
20 --steel-200: lch(from #aebed0 l calc(c * var(--f)) 320);
21 --steel-150: lch(from #c0cfe0 l calc(c * var(--f)) 320);
22 --steel-100: lch(from #d2e0f0 l calc(c * var(--f)) 320);
23 --zinc-50: lch(from #fafafa l calc(c * var(--f)) 320);
24 --zinc-100: lch(from #f4f4f5 l calc(c * var(--f)) 320);
25 --zinc-150: lch(from #ececee l calc(c * var(--f)) 320);
26 --zinc-200: lch(from #e4e4e7 l calc(c * var(--f)) 320);
27 --zinc-250: lch(from #dcdce0 l calc(c * var(--f)) 320);
28 --zinc-300: lch(from #d4d4d8 l calc(c * var(--f)) 320);
29 --zinc-350: lch(from #babac1 l calc(c * var(--f)) 320);
30 --zinc-400: lch(from #a1a1aa l calc(c * var(--f)) 320);
31 --zinc-450: lch(from #898992 l calc(c * var(--f)) 320);
32 --zinc-500: lch(from #71717a l calc(c * var(--f)) 320);
33 --zinc-550: lch(from #61616a l calc(c * var(--f)) 320);
34 --zinc-600: lch(from #52525b l calc(c * var(--f)) 320);
35 --zinc-650: lch(from #484850 l calc(c * var(--f)) 320);
36 --zinc-700: lch(from #3f3f46 l calc(c * var(--f)) 320);
37 --zinc-750: lch(from #333338 l calc(c * var(--f)) 320);
38 --zinc-800: lch(from #27272a l calc(c * var(--f)) 320);
39 --zinc-850: lch(from #1f1f23 l calc(c * var(--f)) 320);
40 --zinc-900: lch(from #18181b l calc(c * var(--f)) 320);
41 --color-primary: #e286f3;
42 --color-primary-contrast: lch(from var(--color-primary) 95% 0 h);
43 --color-primary-dark-1: lch(from var(--color-primary) l c h);
44 --color-primary-dark-2: lch(from var(--color-primary) calc(l * 0.85) c h);
45 --color-primary-dark-3: lch(from var(--color-primary) calc(l * 0.85) c h);
46 --color-primary-dark-4: lch(from var(--color-primary) calc(l * 0.72) c h);
47 --color-primary-dark-5: lch(from var(--color-primary) calc(l * 0.72) c h);
48 --color-primary-dark-6: lch(from var(--color-primary) calc(l * 0.72) c h);
49 --color-primary-dark-7: lch(from var(--color-primary) calc(l * 0.72) c h);
50 --color-primary-light-1: lch(from var(--color-primary) calc(l * 1.15) c h);
51 --color-primary-light-2: lch(from var(--color-primary) calc(l * 1.28) c h);
52 --color-primary-light-3: lch(from var(--color-primary) calc(l * 1.48) c h);
53 --color-primary-light-4: lch(from var(--color-primary) calc(l * 1.68) c h);
54 --color-primary-light-5: lch(
55 from
56 var(--color-primary)
57 calc(l * 1.82)
58 calc(c * 0.6)
59 h
60 );
61 --color-primary-light-6: lch(
62 from
63 var(--color-primary)
64 calc(l * 1.92)
65 calc(c * 0.3)
66 h
67 );
68 --color-primary-light-7: lch(
69 from
70 var(--color-primary)
71 calc(l * 1.98)
72 calc(c * 0.15)
73 h
74 );
75 --color-primary-alpha-10: lch(from var(--color-primary) l c h / 0.1);
76 --color-primary-alpha-20: lch(from var(--color-primary) l c h / 0.2);
77 --color-primary-alpha-30: lch(from var(--color-primary) l c h / 0.3);
78 --color-primary-alpha-40: lch(from var(--color-primary) l c h / 0.4);
79 --color-primary-alpha-50: lch(from var(--color-primary) l c h / 0.5);
80 --color-primary-alpha-60: lch(from var(--color-primary) l c h / 0.6);
81 --color-primary-alpha-70: lch(from var(--color-primary) l c h / 0.7);
82 --color-primary-alpha-80: lch(from var(--color-primary) l c h / 0.8);
83 --color-primary-alpha-90: lch(from var(--color-primary) l c h / 0.9);
84 --color-active: var(--steel-600);
85 --color-secondary-alpha-10: lch(from var(--color-secondary) l c h / 0.1);
86 --color-secondary-alpha-20: lch(from var(--color-secondary) l c h / 0.2);
87 --color-secondary-alpha-30: lch(from var(--color-secondary) l c h / 0.3);
88 --color-secondary-alpha-40: lch(from var(--color-secondary) l c h / 0.4);
89 --color-secondary-alpha-50: lch(from var(--color-secondary) l c h / 0.5);
90 --color-secondary-alpha-60: lch(from var(--color-secondary) l c h / 0.6);
91 --color-secondary-alpha-70: lch(from var(--color-secondary) l c h / 0.7);
92 --color-secondary-alpha-80: lch(from var(--color-secondary) l c h / 0.8);
93 --color-secondary-alpha-90: lch(from var(--color-secondary) l c h / 0.9);
94}
95
96.organization.profile:has(.overflow-menu-items > a[href="/evil"]) {
97 .org-avatar, .org-title {
98 clip: rect(1px, 1px, 1px, 1px);
99 clip-path: inset(50%);
100 height: 1px;
101 width: 1px;
102 margin: -1px;
103 overflow: hidden;
104 padding: 0;
105 position: absolute;
106 }
107 #org-info .render-content p {
108 display: none;
109 }
110 .org-header::before {
111 content: " ";
112 height: 60px;
113 width: 215px;
114 margin-left: 10px;
115 margin-bottom: 10px;
116 background: url(data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCAxNDUzIDQwNiI+PHBhdGggZD0iTTQ2IDQ2YzIgMTctNyAxMzUtMiAxNDBzMTI1LTQgMTQyLTJjMjYgNSAyNiA0MS0xIDQ1LTE3IDItMTM2LTgtMTQxLTMtNCA0IDUgMTA1IDMgMTE5IDE0LTQgMjktNiA0My03IDIzLTEgODgtNCAxMDggMCAyMiA0IDI0IDM5LTEgNDQtMzAgNi03NCAwLTEwNyAzLTI3IDItODYgMjYtODgtMTgtMi00MiAxNC05OSA2LTE0MiAwLTQtNi03LTctMTItNC0xOSA1LTE3IDctMjYgOC0zOC0xMS0xNDQgMi0xNzFDMTQgOSAyMCA1IDI4IDRjMTktMyAxMjQtNSAxNDEtMSAyMyA1IDE4IDQzLTMgNDNINDZabTEwMzYgMTc2Yy0xNS0xMC0zMyAzNC0zNyA0NC01IDE0LTEwIDMxLTEzIDQ2cy02IDU3LTExIDY3Yy0xMCAyMC00MSAxNC00My0xMi0xLTE3IDAtMTQxIDQtMTUxIDQtMTMgMjItMTUgMzMtOGw3IDljMSAwIDEyLTE5IDE2LTIyIDQ2LTUxIDc4IDMgMTAzIDQwIDE5IDI4IDc4IDExNCA4OCAxNDAgNyAyMS0xMCAzOC0yOSAyOS05LTUtMzctNjAtNDUtNzNsLTczLTEwOVptMzI2LTEwMWMyNS0xIDMyIDMwIDEwIDM5LTM0IDE0LTU4IDgtOTEgMzgtNjggNjAtMTIgMTIzIDU0IDE0NiAxOCA2IDY3IDkgNzEgMjcgMTAgNDUtODUgMTItMTAzIDUtMTUyLTY0LTExNS0yMDkgMjktMjQ4IDctMiAyMy03IDMwLTdaTTYzNiA1YzcgNyA1IDQyIDQgNTMgMCA3OC04IDE1Ni02IDIzNCAwIDI0IDkgNjYgNSA4Ni0zIDE5LTMxIDIxLTM0LTEtNC0yNiA1LTcwIDUtMTAwIDEtNzgtMTQtMTg0LTUtMjU4IDItMTYgMTktMjYgMzEtMTRaTTMxMyAzMTBjMjEtMzIgMzQtNzAgNTktOTkgMTAtMTEgMzItMzYgNDgtMjQgMjQgMTktMTMgMzgtMjMgNDgtMjAgMjMtMzkgNTctNTAgODYtNSAxMS0xNyA1Ni0yMyA2MS0xMyAxMC0yNiAzLTMyLTExLTktMTctNDQtMTIwLTQ3LTEzNy0zLTI1IDIzLTM2IDM2LTE5czIwIDc0IDMyIDk1Wm0xNzAtMTEzYzEyLTEyIDMyLTQgMzQgMTIgNSAyOC0xIDg0LTEgMTE3IDAgMTQgNyA1Mi00IDYyLTggNy0yMiA3LTI5LTItMTEtMTEtMy02OC0zLTg1IDAtMjctNi03MC0xLTk1IDAtMyAyLTYgNC05Wm0xNS01MmEyMSAyMSAwIDEgMCAwLTQyIDIxIDIxIDAgMCAwIDAgNDJaIiBmaWxsPSIjZTZkYmU3Ii8+PHBhdGggZmlsbD0iI0UxODZGNCIgZD0iTTk1MSA0MGMyMyAyMS0xIDUzLTE2IDcwLTEzIDE1LTQ1IDUyLTY0IDUxLTYgMC00Ni0yMi01My0yNy0zOS0yNy0zNS0xMDIgMjctODkgOCAyIDI4IDE1IDMwIDE1IDMtMSAxMi0xNSAxNy0xOCAxNC0xMSA0NS0xNSA1OS0yWiIvPjxwYXRoIGQ9Ik04NjAgMzg3Yy0zLTQtNS05LTYtMTQtMy0yMi0zLTE1NSAwLTE3NiA0LTI0IDM3LTI1IDQwIDIgMyAyMCAzIDE1NiAwIDE3NS0yIDE3LTIyIDI0LTM0IDEzWiIgZmlsbD0iI2U2ZGJlNyIvPjwvc3ZnPg);
117 }
118}
service/evil-forgejo/public/assets/css/theme-evil-light.css deleted-175
...@@ -1,175 +0,0 @@
1@import "theme-forgejo-light.css";
2
3:root {
4 --f: 5;
5 --l: 4;
6 --steel-900: lch(from #10161d l calc(c * var(--f)) 320);
7 --steel-850: lch(from #131a21 l calc(c * var(--f)) 320);
8 --steel-800: lch(from #171e26 l calc(c * var(--f)) 320);
9 --steel-750: lch(from #1d262f l calc(c * var(--f)) 320);
10 --steel-700: lch(from #242d38 l calc(c * var(--f)) 320);
11 --steel-650: lch(from #2b3642 l calc(c * var(--f)) 320);
12 --steel-600: lch(from #374351 l calc(c * var(--f)) 320);
13 --steel-550: lch(from #445161 l calc(c * var(--f)) 320);
14 --steel-500: lch(from #515f70 l calc(c * var(--f)) 320);
15 --steel-450: lch(from #5f6e80 l calc(c * var(--f)) 320);
16 --steel-400: lch(from #6d7d8f l calc(c * var(--f)) 320);
17 --steel-350: lch(from #7c8c9f l calc(c * var(--f)) 320);
18 --steel-300: lch(from #8c9caf l calc(c * var(--f)) 320);
19 --steel-250: lch(from #9dadc0 l calc(c * var(--f)) 320);
20 --steel-200: lch(from #aebed0 l calc(c * var(--f)) 320);
21 --steel-150: lch(from #c0cfe0 l calc(c * var(--f)) 320);
22 --steel-100: lch(from #d2e0f0 l calc(c * var(--f)) 320);
23 --zinc-50: lch(from #fafafa l calc(c * var(--f)) 320);
24 --zinc-100: lch(from #f4f4f5 l calc(c * var(--f)) 320);
25 --zinc-150: lch(from #ececee l calc(c * var(--f)) 320);
26 --zinc-200: lch(from #e4e4e7 l calc(c * var(--f)) 320);
27 --zinc-250: lch(from #dcdce0 l calc(c * var(--f)) 320);
28 --zinc-300: lch(from #d4d4d8 l calc(c * var(--f)) 320);
29 --zinc-350: lch(from #babac1 l calc(c * var(--f)) 320);
30 --zinc-400: lch(from #a1a1aa l calc(c * var(--f)) 320);
31 --zinc-450: lch(from #898992 l calc(c * var(--f)) 320);
32 --zinc-500: lch(from #71717a l calc(c * var(--f)) 320);
33 --zinc-550: lch(from #61616a l calc(c * var(--f)) 320);
34 --zinc-600: lch(from #52525b l calc(c * var(--f)) 320);
35 --zinc-650: lch(from #484850 l calc(c * var(--f)) 320);
36 --zinc-700: lch(from #3f3f46 l calc(c * var(--f)) 320);
37 --zinc-750: lch(from #333338 l calc(c * var(--f)) 320);
38 --zinc-800: lch(from #27272a l calc(c * var(--f)) 320);
39 --zinc-850: lch(from #1f1f23 l calc(c * var(--f)) 320);
40 --zinc-900: lch(from #18181b l calc(c * var(--f)) 320);
41 --color-primary: #b734cf;
42 --color-primary-contrast: lch(from var(--color-primary) 95% 0 h);
43 --color-primary-dark-1: lch(from var(--color-primary) l c h);
44 --color-primary-dark-2: lch(from var(--color-primary) calc(l * 0.85) c h);
45 --color-primary-dark-3: lch(from var(--color-primary) calc(l * 0.85) c h);
46 --color-primary-dark-4: lch(from var(--color-primary) calc(l * 0.72) c h);
47 --color-primary-dark-5: lch(from var(--color-primary) calc(l * 0.72) c h);
48 --color-primary-dark-6: lch(from var(--color-primary) calc(l * 0.72) c h);
49 --color-primary-dark-7: lch(from var(--color-primary) calc(l * 0.72) c h);
50 --color-primary-light-1: lch(from var(--color-primary) calc(l * 1.15) c h);
51 --color-primary-light-2: lch(from var(--color-primary) calc(l * 1.28) c h);
52 --color-primary-light-3: lch(from var(--color-primary) calc(l * 1.48) c h);
53 --color-primary-light-4: lch(from var(--color-primary) calc(l * 1.68) c h);
54 --color-primary-light-5: lch(
55 from
56 var(--color-primary)
57 calc(l * 1.82)
58 calc(c * 0.6)
59 h
60 );
61 --color-primary-light-6: lch(
62 from
63 var(--color-primary)
64 calc(l * 1.92)
65 calc(c * 0.3)
66 h
67 );
68 --color-primary-light-7: lch(
69 from
70 var(--color-primary)
71 calc(l * 1.98)
72 calc(c * 0.15)
73 h
74 );
75 --color-primary-alpha-10: lch(from var(--color-primary) l c h / 0.1);
76 --color-primary-alpha-20: lch(from var(--color-primary) l c h / 0.2);
77 --color-primary-alpha-30: lch(from var(--color-primary) l c h / 0.3);
78 --color-primary-alpha-40: lch(from var(--color-primary) l c h / 0.4);
79 --color-primary-alpha-50: lch(from var(--color-primary) l c h / 0.5);
80 --color-primary-alpha-60: lch(from var(--color-primary) l c h / 0.6);
81 --color-primary-alpha-70: lch(from var(--color-primary) l c h / 0.7);
82 --color-primary-alpha-80: lch(from var(--color-primary) l c h / 0.8);
83 --color-primary-alpha-90: lch(from var(--color-primary) l c h / 0.9);
84 --color-active: var(--steel-600);
85 --color-secondary-alpha-10: lch(from var(--color-secondary) l c h / 0.1);
86 --color-secondary-alpha-20: lch(from var(--color-secondary) l c h / 0.2);
87 --color-secondary-alpha-30: lch(from var(--color-secondary) l c h / 0.3);
88 --color-secondary-alpha-40: lch(from var(--color-secondary) l c h / 0.4);
89 --color-secondary-alpha-50: lch(from var(--color-secondary) l c h / 0.5);
90 --color-secondary-alpha-60: lch(from var(--color-secondary) l c h / 0.6);
91 --color-secondary-alpha-70: lch(from var(--color-secondary) l c h / 0.7);
92 --color-secondary-alpha-80: lch(from var(--color-secondary) l c h / 0.8);
93 --color-secondary-alpha-90: lch(from var(--color-secondary) l c h / 0.9);
94 --color-body: lch(from #fff l calc(c * var(--f) + var(--l)) h);
95 --color-text-dark: lch(from #000 l calc(c * var(--f) + var(--l)) h);
96 --color-input-background: lch(from #fff l calc(c * var(--f) + var(--l)) h);
97 --color-input-toggle-background: lch(
98 from
99 #fff
100 l
101 calc(c * var(--f) + var(--l))
102 h
103 );
104 --color-header-wrapper-transparent: lch(
105 from
106 #d2e0f000
107 l
108 calc(c * var(--f) + var(--l))
109 h
110 );
111 --color-light-border: lch(from #0000001d l calc(c * var(--f) + var(--l)) h);
112 --color-hover: lch(from #e4e4e4aa l calc(c * var(--f) + var(--l)) h);
113 --color-active: lch(from #e2e2e5 l calc(c * var(--f) + var(--l)) 320);
114 --color-markup-table-row: lch(
115 from
116 #ffffff06
117 l
118 calc(c * var(--f) + var(--l))
119 h
120 );
121 --color-shadow: lch(from #00000060 l calc(c * var(--f) + var(--l)) h);
122 --color-text-focus: lch(from #fff l calc(c * var(--f) + var(--l)) h);
123 --color-reaction-bg: lch(from #0000000a l calc(c * var(--f) + var(--l)) h);
124 --color-tooltip-text: lch(from #ffffff l calc(c * var(--f) + var(--l)) h);
125 --color-tooltip-bg: lch(from #000000f0 l calc(c * var(--f) + var(--l)) h);
126 --color-label-bg: lch(from #cacaca7b l calc(c * var(--f) + var(--l)) h);
127 --color-label-hover-bg: lch(
128 from
129 #cacacaa0
130 l
131 calc(c * var(--f) + var(--l))
132 h
133 );
134 --color-label-active-bg: lch(
135 from
136 #cacacaff
137 l
138 calc(c * var(--f) + var(--l))
139 h
140 );
141 --color-label-bg-alt: lch(from #cacacaff l calc(c * var(--f) + var(--l)) h);
142 --color-overlay-backdrop: lch(
143 from
144 #080808c0
145 l
146 calc(c * var(--f) + var(--l))
147 h
148 );
149 --checkerboard-color-1: lch(from #ffffff l calc(c * var(--f) + var(--l)) h);
150 --checkerboard-color-2: lch(from #e5e5e5 l calc(c * var(--f) + var(--l)) h);
151}
152
153.organization.profile:has(.overflow-menu-items > a[href="/evil"]) {
154 .org-avatar, .org-title {
155 clip: rect(1px, 1px, 1px, 1px);
156 clip-path: inset(50%);
157 height: 1px;
158 width: 1px;
159 margin: -1px;
160 overflow: hidden;
161 padding: 0;
162 position: absolute;
163 }
164 #org-info .render-content p {
165 display: none;
166 }
167 .org-header::before {
168 content: " ";
169 height: 60px;
170 width: 215px;
171 margin-left: 10px;
172 margin-bottom: 10px;
173 background: url(data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCAxNDUzIDQwNiI+PHBhdGggZmlsbD0iIzIwMTQyMiIgZD0iTTQ2IDQ2YzIgMTctNyAxMzUtMiAxNDBzMTI1LTQgMTQyLTJjMjYgNSAyNiA0MS0xIDQ1LTE3IDItMTM2LTgtMTQxLTMtNCA0IDUgMTA1IDMgMTE5IDE0LTQgMjktNiA0My03IDIzLTEgODgtNCAxMDggMCAyMiA0IDI0IDM5LTEgNDQtMzAgNi03NCAwLTEwNyAzLTI3IDItODYgMjYtODgtMTgtMi00MiAxNC05OSA2LTE0MiAwLTQtNi03LTctMTItNC0xOSA1LTE3IDctMjYgOC0zOC0xMS0xNDQgMi0xNzFDMTQgOSAyMCA1IDI4IDRjMTktMyAxMjQtNSAxNDEtMSAyMyA1IDE4IDQzLTMgNDNINDZabTEwMzYgMTc2Yy0xNS0xMC0zMyAzNC0zNyA0NC01IDE0LTEwIDMxLTEzIDQ2cy02IDU3LTExIDY3Yy0xMCAyMC00MSAxNC00My0xMi0xLTE3IDAtMTQxIDQtMTUxIDQtMTMgMjItMTUgMzMtOGw3IDljMSAwIDEyLTE5IDE2LTIyIDQ2LTUxIDc4IDMgMTAzIDQwIDE5IDI4IDc4IDExNCA4OCAxNDAgNyAyMS0xMCAzOC0yOSAyOS05LTUtMzctNjAtNDUtNzNsLTczLTEwOVptMzI2LTEwMWMyNS0xIDMyIDMwIDEwIDM5LTM0IDE0LTU4IDgtOTEgMzgtNjggNjAtMTIgMTIzIDU0IDE0NiAxOCA2IDY3IDkgNzEgMjcgMTAgNDUtODUgMTItMTAzIDUtMTUyLTY0LTExNS0yMDkgMjktMjQ4IDctMiAyMy03IDMwLTdaTTYzNiA1YzcgNyA1IDQyIDQgNTMgMCA3OC04IDE1Ni02IDIzNCAwIDI0IDkgNjYgNSA4Ni0zIDE5LTMxIDIxLTM0LTEtNC0yNiA1LTcwIDUtMTAwIDEtNzgtMTQtMTg0LTUtMjU4IDItMTYgMTktMjYgMzEtMTRaTTMxMyAzMTBjMjEtMzIgMzQtNzAgNTktOTkgMTAtMTEgMzItMzYgNDgtMjQgMjQgMTktMTMgMzgtMjMgNDgtMjAgMjMtMzkgNTctNTAgODYtNSAxMS0xNyA1Ni0yMyA2MS0xMyAxMC0yNiAzLTMyLTExLTktMTctNDQtMTIwLTQ3LTEzNy0zLTI1IDIzLTM2IDM2LTE5czIwIDc0IDMyIDk1Wm0xNzAtMTEzYzEyLTEyIDMyLTQgMzQgMTIgNSAyOC0xIDg0LTEgMTE3IDAgMTQgNyA1Mi00IDYyLTggNy0yMiA3LTI5LTItMTEtMTEtMy02OC0zLTg1IDAtMjctNi03MC0xLTk1IDAtMyAyLTYgNC05Wm0xNS01MmEyMSAyMSAwIDEgMCAwLTQyIDIxIDIxIDAgMCAwIDAgNDJaIi8+PHBhdGggZmlsbD0iI0UxODZGNCIgZD0iTTk1MSA0MGMyMyAyMS0xIDUzLTE2IDcwLTEzIDE1LTQ1IDUyLTY0IDUxLTYgMC00Ni0yMi01My0yNy0zOS0yNy0zNS0xMDIgMjctODkgOCAyIDI4IDE1IDMwIDE1IDMtMSAxMi0xNSAxNy0xOCAxNC0xMSA0NS0xNSA1OS0yWiIvPjxwYXRoIGZpbGw9IiMyMDE0MjIiIGQ9Ik04NjAgMzg3Yy0zLTQtNS05LTYtMTQtMy0yMi0zLTE1NSAwLTE3NiA0LTI0IDM3LTI1IDQwIDIgMyAyMCAzIDE1NiAwIDE3NS0yIDE3LTIyIDI0LTM0IDEzWiIvPjwvc3ZnPg);
174 }
175}
service/evil-forgejo/public/assets/css/theme-evil.css deleted-189
...@@ -1,189 +0,0 @@
1@import "theme-forgejo-light.css";
2@import "theme-forgejo-dark.css" (prefers-color-scheme: dark);
3
4:root {
5 --f: 5;
6 --l: 4;
7 --steel-900: lch(from #10161d l calc(c * var(--f)) 320);
8 --steel-850: lch(from #131a21 l calc(c * var(--f)) 320);
9 --steel-800: lch(from #171e26 l calc(c * var(--f)) 320);
10 --steel-750: lch(from #1d262f l calc(c * var(--f)) 320);
11 --steel-700: lch(from #242d38 l calc(c * var(--f)) 320);
12 --steel-650: lch(from #2b3642 l calc(c * var(--f)) 320);
13 --steel-600: lch(from #374351 l calc(c * var(--f)) 320);
14 --steel-550: lch(from #445161 l calc(c * var(--f)) 320);
15 --steel-500: lch(from #515f70 l calc(c * var(--f)) 320);
16 --steel-450: lch(from #5f6e80 l calc(c * var(--f)) 320);
17 --steel-400: lch(from #6d7d8f l calc(c * var(--f)) 320);
18 --steel-350: lch(from #7c8c9f l calc(c * var(--f)) 320);
19 --steel-300: lch(from #8c9caf l calc(c * var(--f)) 320);
20 --steel-250: lch(from #9dadc0 l calc(c * var(--f)) 320);
21 --steel-200: lch(from #aebed0 l calc(c * var(--f)) 320);
22 --steel-150: lch(from #c0cfe0 l calc(c * var(--f)) 320);
23 --steel-100: lch(from #d2e0f0 l calc(c * var(--f)) 320);
24 --zinc-50: lch(from #fafafa l calc(c * var(--f)) 320);
25 --zinc-100: lch(from #f4f4f5 l calc(c * var(--f)) 320);
26 --zinc-150: lch(from #ececee l calc(c * var(--f)) 320);
27 --zinc-200: lch(from #e4e4e7 l calc(c * var(--f)) 320);
28 --zinc-250: lch(from #dcdce0 l calc(c * var(--f)) 320);
29 --zinc-300: lch(from #d4d4d8 l calc(c * var(--f)) 320);
30 --zinc-350: lch(from #babac1 l calc(c * var(--f)) 320);
31 --zinc-400: lch(from #a1a1aa l calc(c * var(--f)) 320);
32 --zinc-450: lch(from #898992 l calc(c * var(--f)) 320);
33 --zinc-500: lch(from #71717a l calc(c * var(--f)) 320);
34 --zinc-550: lch(from #61616a l calc(c * var(--f)) 320);
35 --zinc-600: lch(from #52525b l calc(c * var(--f)) 320);
36 --zinc-650: lch(from #484850 l calc(c * var(--f)) 320);
37 --zinc-700: lch(from #3f3f46 l calc(c * var(--f)) 320);
38 --zinc-750: lch(from #333338 l calc(c * var(--f)) 320);
39 --zinc-800: lch(from #27272a l calc(c * var(--f)) 320);
40 --zinc-850: lch(from #1f1f23 l calc(c * var(--f)) 320);
41 --zinc-900: lch(from #18181b l calc(c * var(--f)) 320);
42 --color-primary: #b734cf;
43 --color-primary-contrast: lch(from var(--color-primary) 95% 0 h);
44 --color-primary-dark-1: lch(from var(--color-primary) l c h);
45 --color-primary-dark-2: lch(from var(--color-primary) calc(l * 0.85) c h);
46 --color-primary-dark-3: lch(from var(--color-primary) calc(l * 0.85) c h);
47 --color-primary-dark-4: lch(from var(--color-primary) calc(l * 0.72) c h);
48 --color-primary-dark-5: lch(from var(--color-primary) calc(l * 0.72) c h);
49 --color-primary-dark-6: lch(from var(--color-primary) calc(l * 0.72) c h);
50 --color-primary-dark-7: lch(from var(--color-primary) calc(l * 0.72) c h);
51 --color-primary-light-1: lch(from var(--color-primary) calc(l * 1.15) c h);
52 --color-primary-light-2: lch(from var(--color-primary) calc(l * 1.28) c h);
53 --color-primary-light-3: lch(from var(--color-primary) calc(l * 1.48) c h);
54 --color-primary-light-4: lch(from var(--color-primary) calc(l * 1.68) c h);
55 --color-primary-light-5: lch(
56 from
57 var(--color-primary)
58 calc(l * 1.82)
59 calc(c * 0.6)
60 h
61 );
62 --color-primary-light-6: lch(
63 from
64 var(--color-primary)
65 calc(l * 1.92)
66 calc(c * 0.3)
67 h
68 );
69 --color-primary-light-7: lch(
70 from
71 var(--color-primary)
72 calc(l * 1.98)
73 calc(c * 0.15)
74 h
75 );
76 --color-primary-alpha-10: lch(from var(--color-primary) l c h / 0.1);
77 --color-primary-alpha-20: lch(from var(--color-primary) l c h / 0.2);
78 --color-primary-alpha-30: lch(from var(--color-primary) l c h / 0.3);
79 --color-primary-alpha-40: lch(from var(--color-primary) l c h / 0.4);
80 --color-primary-alpha-50: lch(from var(--color-primary) l c h / 0.5);
81 --color-primary-alpha-60: lch(from var(--color-primary) l c h / 0.6);
82 --color-primary-alpha-70: lch(from var(--color-primary) l c h / 0.7);
83 --color-primary-alpha-80: lch(from var(--color-primary) l c h / 0.8);
84 --color-primary-alpha-90: lch(from var(--color-primary) l c h / 0.9);
85 --color-active: var(--steel-600);
86 --color-secondary-alpha-10: lch(from var(--color-secondary) l c h / 0.1);
87 --color-secondary-alpha-20: lch(from var(--color-secondary) l c h / 0.2);
88 --color-secondary-alpha-30: lch(from var(--color-secondary) l c h / 0.3);
89 --color-secondary-alpha-40: lch(from var(--color-secondary) l c h / 0.4);
90 --color-secondary-alpha-50: lch(from var(--color-secondary) l c h / 0.5);
91 --color-secondary-alpha-60: lch(from var(--color-secondary) l c h / 0.6);
92 --color-secondary-alpha-70: lch(from var(--color-secondary) l c h / 0.7);
93 --color-secondary-alpha-80: lch(from var(--color-secondary) l c h / 0.8);
94 --color-secondary-alpha-90: lch(from var(--color-secondary) l c h / 0.9);
95}
96@media (not (prefers-color-scheme: dark)) {
97 :root {
98 --color-body: lch(from #fff l calc(c * var(--f) + var(--l)) h);
99 --color-text-dark: lch(from #000 l calc(c * var(--f) + var(--l)) h);
100 --color-input-background: lch(from #fff l calc(c * var(--f) + var(--l)) h);
101 --color-input-toggle-background: lch(
102 from
103 #fff
104 l
105 calc(c * var(--f) + var(--l))
106 h
107 );
108 --color-header-wrapper-transparent: lch(
109 from
110 #d2e0f000
111 l
112 calc(c * var(--f) + var(--l))
113 h
114 );
115 --color-light-border: lch(from #0000001d l calc(c * var(--f) + var(--l)) h);
116 --color-hover: lch(from #e4e4e4aa l calc(c * var(--f) + var(--l)) h);
117 --color-active: lch(from #e2e2e5 l calc(c * var(--f) + var(--l)) 320);
118 --color-markup-table-row: lch(
119 from
120 #ffffff06
121 l
122 calc(c * var(--f) + var(--l))
123 h
124 );
125 --color-shadow: lch(from #00000060 l calc(c * var(--f) + var(--l)) h);
126 --color-text-focus: lch(from #fff l calc(c * var(--f) + var(--l)) h);
127 --color-reaction-bg: lch(from #0000000a l calc(c * var(--f) + var(--l)) h);
128 --color-tooltip-text: lch(from #ffffff l calc(c * var(--f) + var(--l)) h);
129 --color-tooltip-bg: lch(from #000000f0 l calc(c * var(--f) + var(--l)) h);
130 --color-label-bg: lch(from #cacaca7b l calc(c * var(--f) + var(--l)) h);
131 --color-label-hover-bg: lch(
132 from
133 #cacacaa0
134 l
135 calc(c * var(--f) + var(--l))
136 h
137 );
138 --color-label-active-bg: lch(
139 from
140 #cacacaff
141 l
142 calc(c * var(--f) + var(--l))
143 h
144 );
145 --color-label-bg-alt: lch(from #cacacaff l calc(c * var(--f) + var(--l)) h);
146 --color-overlay-backdrop: lch(
147 from
148 #080808c0
149 l
150 calc(c * var(--f) + var(--l))
151 h
152 );
153 --checkerboard-color-1: lch(from #ffffff l calc(c * var(--f) + var(--l)) h);
154 --checkerboard-color-2: lch(from #e5e5e5 l calc(c * var(--f) + var(--l)) h);
155 }
156}
157@media (prefers-color-scheme: dark) {
158 :root {
159 --f: 0.75;
160 --color-primary: #e286f3;
161 }
162}
163
164.organization.profile:has(.overflow-menu-items > a[href="/evil"]) {
165 .org-avatar, .org-title {
166 clip: rect(1px, 1px, 1px, 1px);
167 clip-path: inset(50%);
168 height: 1px;
169 width: 1px;
170 margin: -1px;
171 overflow: hidden;
172 padding: 0;
173 position: absolute;
174 }
175 #org-info .render-content p {
176 display: none;
177 }
178 .org-header::before {
179 content: " ";
180 height: 60px;
181 width: 215px;
182 margin-left: 10px;
183 margin-bottom: 10px;
184 background: url(data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCAxNDUzIDQwNiI+PHBhdGggZmlsbD0iIzIwMTQyMiIgZD0iTTQ2IDQ2YzIgMTctNyAxMzUtMiAxNDBzMTI1LTQgMTQyLTJjMjYgNSAyNiA0MS0xIDQ1LTE3IDItMTM2LTgtMTQxLTMtNCA0IDUgMTA1IDMgMTE5IDE0LTQgMjktNiA0My03IDIzLTEgODgtNCAxMDggMCAyMiA0IDI0IDM5LTEgNDQtMzAgNi03NCAwLTEwNyAzLTI3IDItODYgMjYtODgtMTgtMi00MiAxNC05OSA2LTE0MiAwLTQtNi03LTctMTItNC0xOSA1LTE3IDctMjYgOC0zOC0xMS0xNDQgMi0xNzFDMTQgOSAyMCA1IDI4IDRjMTktMyAxMjQtNSAxNDEtMSAyMyA1IDE4IDQzLTMgNDNINDZabTEwMzYgMTc2Yy0xNS0xMC0zMyAzNC0zNyA0NC01IDE0LTEwIDMxLTEzIDQ2cy02IDU3LTExIDY3Yy0xMCAyMC00MSAxNC00My0xMi0xLTE3IDAtMTQxIDQtMTUxIDQtMTMgMjItMTUgMzMtOGw3IDljMSAwIDEyLTE5IDE2LTIyIDQ2LTUxIDc4IDMgMTAzIDQwIDE5IDI4IDc4IDExNCA4OCAxNDAgNyAyMS0xMCAzOC0yOSAyOS05LTUtMzctNjAtNDUtNzNsLTczLTEwOVptMzI2LTEwMWMyNS0xIDMyIDMwIDEwIDM5LTM0IDE0LTU4IDgtOTEgMzgtNjggNjAtMTIgMTIzIDU0IDE0NiAxOCA2IDY3IDkgNzEgMjcgMTAgNDUtODUgMTItMTAzIDUtMTUyLTY0LTExNS0yMDkgMjktMjQ4IDctMiAyMy03IDMwLTdaTTYzNiA1YzcgNyA1IDQyIDQgNTMgMCA3OC04IDE1Ni02IDIzNCAwIDI0IDkgNjYgNSA4Ni0zIDE5LTMxIDIxLTM0LTEtNC0yNiA1LTcwIDUtMTAwIDEtNzgtMTQtMTg0LTUtMjU4IDItMTYgMTktMjYgMzEtMTRaTTMxMyAzMTBjMjEtMzIgMzQtNzAgNTktOTkgMTAtMTEgMzItMzYgNDgtMjQgMjQgMTktMTMgMzgtMjMgNDgtMjAgMjMtMzkgNTctNTAgODYtNSAxMS0xNyA1Ni0yMyA2MS0xMyAxMC0yNiAzLTMyLTExLTktMTctNDQtMTIwLTQ3LTEzNy0zLTI1IDIzLTM2IDM2LTE5czIwIDc0IDMyIDk1Wm0xNzAtMTEzYzEyLTEyIDMyLTQgMzQgMTIgNSAyOC0xIDg0LTEgMTE3IDAgMTQgNyA1Mi00IDYyLTggNy0yMiA3LTI5LTItMTEtMTEtMy02OC0zLTg1IDAtMjctNi03MC0xLTk1IDAtMyAyLTYgNC05Wm0xNS01MmEyMSAyMSAwIDEgMCAwLTQyIDIxIDIxIDAgMCAwIDAgNDJaIi8+PHBhdGggZmlsbD0iI0UxODZGNCIgZD0iTTk1MSA0MGMyMyAyMS0xIDUzLTE2IDcwLTEzIDE1LTQ1IDUyLTY0IDUxLTYgMC00Ni0yMi01My0yNy0zOS0yNy0zNS0xMDIgMjctODkgOCAyIDI4IDE1IDMwIDE1IDMtMSAxMi0xNSAxNy0xOCAxNC0xMSA0NS0xNSA1OS0yWiIvPjxwYXRoIGZpbGw9IiMyMDE0MjIiIGQ9Ik04NjAgMzg3Yy0zLTQtNS05LTYtMTQtMy0yMi0zLTE1NSAwLTE3NiA0LTI0IDM3LTI1IDQwIDIgMyAyMCAzIDE1NiAwIDE3NS0yIDE3LTIyIDI0LTM0IDEzWiIvPjwvc3ZnPg);
185 @media (prefers-color-scheme: dark) {
186 background: url(data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCAxNDUzIDQwNiI+PHBhdGggZD0iTTQ2IDQ2YzIgMTctNyAxMzUtMiAxNDBzMTI1LTQgMTQyLTJjMjYgNSAyNiA0MS0xIDQ1LTE3IDItMTM2LTgtMTQxLTMtNCA0IDUgMTA1IDMgMTE5IDE0LTQgMjktNiA0My03IDIzLTEgODgtNCAxMDggMCAyMiA0IDI0IDM5LTEgNDQtMzAgNi03NCAwLTEwNyAzLTI3IDItODYgMjYtODgtMTgtMi00MiAxNC05OSA2LTE0MiAwLTQtNi03LTctMTItNC0xOSA1LTE3IDctMjYgOC0zOC0xMS0xNDQgMi0xNzFDMTQgOSAyMCA1IDI4IDRjMTktMyAxMjQtNSAxNDEtMSAyMyA1IDE4IDQzLTMgNDNINDZabTEwMzYgMTc2Yy0xNS0xMC0zMyAzNC0zNyA0NC01IDE0LTEwIDMxLTEzIDQ2cy02IDU3LTExIDY3Yy0xMCAyMC00MSAxNC00My0xMi0xLTE3IDAtMTQxIDQtMTUxIDQtMTMgMjItMTUgMzMtOGw3IDljMSAwIDEyLTE5IDE2LTIyIDQ2LTUxIDc4IDMgMTAzIDQwIDE5IDI4IDc4IDExNCA4OCAxNDAgNyAyMS0xMCAzOC0yOSAyOS05LTUtMzctNjAtNDUtNzNsLTczLTEwOVptMzI2LTEwMWMyNS0xIDMyIDMwIDEwIDM5LTM0IDE0LTU4IDgtOTEgMzgtNjggNjAtMTIgMTIzIDU0IDE0NiAxOCA2IDY3IDkgNzEgMjcgMTAgNDUtODUgMTItMTAzIDUtMTUyLTY0LTExNS0yMDkgMjktMjQ4IDctMiAyMy03IDMwLTdaTTYzNiA1YzcgNyA1IDQyIDQgNTMgMCA3OC04IDE1Ni02IDIzNCAwIDI0IDkgNjYgNSA4Ni0zIDE5LTMxIDIxLTM0LTEtNC0yNiA1LTcwIDUtMTAwIDEtNzgtMTQtMTg0LTUtMjU4IDItMTYgMTktMjYgMzEtMTRaTTMxMyAzMTBjMjEtMzIgMzQtNzAgNTktOTkgMTAtMTEgMzItMzYgNDgtMjQgMjQgMTktMTMgMzgtMjMgNDgtMjAgMjMtMzkgNTctNTAgODYtNSAxMS0xNyA1Ni0yMyA2MS0xMyAxMC0yNiAzLTMyLTExLTktMTctNDQtMTIwLTQ3LTEzNy0zLTI1IDIzLTM2IDM2LTE5czIwIDc0IDMyIDk1Wm0xNzAtMTEzYzEyLTEyIDMyLTQgMzQgMTIgNSAyOC0xIDg0LTEgMTE3IDAgMTQgNyA1Mi00IDYyLTggNy0yMiA3LTI5LTItMTEtMTEtMy02OC0zLTg1IDAtMjctNi03MC0xLTk1IDAtMyAyLTYgNC05Wm0xNS01MmEyMSAyMSAwIDEgMCAwLTQyIDIxIDIxIDAgMCAwIDAgNDJaIiBmaWxsPSIjZTZkYmU3Ii8+PHBhdGggZmlsbD0iI0UxODZGNCIgZD0iTTk1MSA0MGMyMyAyMS0xIDUzLTE2IDcwLTEzIDE1LTQ1IDUyLTY0IDUxLTYgMC00Ni0yMi01My0yNy0zOS0yNy0zNS0xMDIgMjctODkgOCAyIDI4IDE1IDMwIDE1IDMtMSAxMi0xNSAxNy0xOCAxNC0xMSA0NS0xNSA1OS0yWiIvPjxwYXRoIGQ9Ik04NjAgMzg3Yy0zLTQtNS05LTYtMTQtMy0yMi0zLTE1NSAwLTE3NiA0LTI0IDM3LTI1IDQwIDIgMyAyMCAzIDE1NiAwIDE3NS0yIDE3LTIyIDI0LTM0IDEzWiIgZmlsbD0iI2U2ZGJlNyIvPjwvc3ZnPg);
187 }
188 }
189}
service/evil-forgejo/public/assets/img/apple-touch-icon.png deleted
Binary files a/service/evil-forgejo/public/assets/img/apple-touch-icon.png and /dev/null differ
service/evil-forgejo/public/assets/img/avatar_default.png deleted
Binary files a/service/evil-forgejo/public/assets/img/avatar_default.png and /dev/null differ
service/evil-forgejo/public/assets/img/favicon.png deleted
Binary files a/service/evil-forgejo/public/assets/img/favicon.png and /dev/null differ
service/evil-forgejo/public/assets/img/favicon.svg deleted-14
...@@ -1,14 +0,0 @@
1<svg width="78" height="78" viewBox="0 0 78 78" fill="none" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
2<g clip-path="url(#clip0_555_6)">
3<rect x="-0.5" y="8" width="78.7516" height="61" fill="url(#pattern0_555_6)"/>
4</g>
5<defs>
6<pattern id="pattern0_555_6" patternContentUnits="objectBoundingBox" width="1" height="1">
7<use xlink:href="#image0_555_6" transform="scale(0.000717875 0.000926784)"/>
8</pattern>
9<clipPath id="clip0_555_6">
10<rect width="78" height="78" fill="white"/>
11</clipPath>
12<image id="image0_555_6" width="1393" height="1079" preserveAspectRatio="none" xlink:href="data:image/png;base64,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"/>
13</defs>
14</svg>
service/evil-forgejo/public/assets/img/logo.png deleted
Binary files a/service/evil-forgejo/public/assets/img/logo.png and /dev/null differ
service/evil-forgejo/public/assets/img/logo.svg deleted-14
...@@ -1,14 +0,0 @@
1<svg width="78" height="78" viewBox="0 0 78 78" fill="none" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
2<g clip-path="url(#clip0_555_6)">
3<rect x="-0.5" y="8" width="78.7516" height="61" fill="url(#pattern0_555_6)"/>
4</g>
5<defs>
6<pattern id="pattern0_555_6" patternContentUnits="objectBoundingBox" width="1" height="1">
7<use xlink:href="#image0_555_6" transform="scale(0.000717875 0.000926784)"/>
8</pattern>
9<clipPath id="clip0_555_6">
10<rect width="78" height="78" fill="white"/>
11</clipPath>
12<image id="image0_555_6" width="1393" height="1079" preserveAspectRatio="none" xlink:href="data:image/png;base64,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"/>
13</defs>
14</svg>
service/evil-forgejo/service.pkl deleted-114
...@@ -1,114 +0,0 @@
1extends "../../config/Service.pkl"
2
3import "../../config/Service.pkl" as service
4import "../../config/site.pkl" as site
5import "../postgres/service.pkl" as postgres
6
7class OAuthClient extends service.Requirement {
8 alias: String = "oauth"
9 fixed provider = "evil-forgejo"
10 fixed kind = "oauth-client"
11 name: String(isNotEmpty)
12 redirectUris: Listing<String>
13}
14
15local gitHost = if (site.domain.endsWith(".test")) "git.evil.\(site.domain)" else "git.evil.inc"
16
17meta { name = "evil.inc Git" }
18healthyDeadline = "20m"
19healthRestartGrace = "2m"
20setup = "setup.py"
21provide = "provide.py"
22
23requirements { new postgres.Database { name = "evil_forgejo" } }
24
25secrets {
26 ["lfs_jwt"] {}
27 ["oauth_jwt"] {}
28 ["security_key"] {}
29 ["internal_token"] {}
30 ["anubis_key"] {}
31 ["automation_password"] {}
32}
33
34requiredSecrets = if (site.domain.endsWith(".test")) new Listing {} else new Listing {
35 "mailer_address"
36 "mailer_username"
37 "mailer_password"
38}
39
40containers {
41 ["forgejo"] {
42 image = "code.forgejo.org/forgejo/forgejo@sha256:3d0ba60633e5ce50a4ac8afce06797eda5728411db047373e7d7d68cecb5bfe8"
43 entrypoint = "/bin/sh"
44 args { "/studio/start.sh" }
45 hostNetwork = true
46 imageUser = true
47 cpu = 300
48 memory = 1024
49
50 http {
51 containerPort = 3000
52 checkPath = "/api/healthz"
53 }
54
55 volumes {
56 ["/data"] {}
57 ["/studio/start.sh"] { config = "start.sh" }
58 ["/studio/app.ini"] { config = "app.ini" }
59 ["/custom/public"] { config = "public" }
60 }
61
62 env {
63 ["FORGEJO_CUSTOM"] = "/custom"
64 ["USER_UID"] = "\(module.uid)"
65 ["USER_GID"] = "\(module.uid)"
66 ["GIT_HOST"] = gitHost
67 ["DB_NAME"] = "${secret.database.name}"
68 ["DB_USER"] = "${secret.database.username}"
69 ["DB_PASSWORD"] = "${secret.database.password}"
70 ["FORGEJO_SERVER_LFS_JWT_SECRET"] = "${secret.own.lfs_jwt}"
71 ["FORGEJO_OAUTH2_JWT_SECRET"] = "${secret.own.oauth_jwt}"
72 ["FORGEJO_SECURITY_SECRET_KEY"] = "${secret.own.security_key}"
73 ["FORGEJO_SECURITY_INTERNAL_TOKEN"] = "${secret.own.internal_token}"
74 ["MAILER_ENABLED"] = if (site.domain.endsWith(".test")) "false" else "true"
75 ["MAILER_ADDRESS"] = if (site.domain.endsWith(".test")) "127.0.0.1" else "${secret.own.mailer_address}"
76 ["MAILER_USERNAME"] = if (site.domain.endsWith(".test")) "" else "${secret.own.mailer_username}"
77 ["MAILER_PASSWORD"] = if (site.domain.endsWith(".test")) "" else "${secret.own.mailer_password}"
78 }
79
80 envTemplate = """
81 FORGEJO_HTTP_PORT={{ env "NOMAD_PORT_forgejo_http" }}
82 {{ range nomadService 1 (env "NOMAD_ALLOC_ID") "postgres" }}DB_HOST=\(module.nomadHostPort){{ end }}
83 """
84 }
85
86 ["anubis"] {
87 image = "ghcr.io/techarohq/anubis@sha256:2babd956e4eb6daa06a41a9b3cbde394a0b2dae1872395f02a380436637c1bfa"
88 hostNetwork = true
89 imageUser = true
90 cpu = 100
91 memory = 256
92
93 http {
94 containerPort = 80
95 hostname = gitHost
96 checkPath = "/api/healthz"
97 checkHeaders { ["X-Real-Ip"] = "127.0.0.1" }
98 forwardRealIp = true
99 }
100
101 env {
102 ["COOKIE_DOMAIN"] = gitHost
103 ["REDIRECT_DOMAINS"] = gitHost
104 ["ED25519_PRIVATE_KEY_HEX"] = "${secret.own.anubis_key}"
105 ["COOKIE_PREFIX"] = "anubis_v1"
106 ["DIFFICULTY"] = "5"
107 }
108
109 envTemplate = """
110 BIND=:{{ env "NOMAD_PORT_anubis_http" }}
111 TARGET=http://127.0.0.1:{{ env "NOMAD_PORT_forgejo_http" }}
112 """
113 }
114}
service/evil-forgejo/setup.py deleted-70
...@@ -1,70 +0,0 @@
1#!/usr/bin/env python3
2import json
3import os
4import secrets
5import subprocess
6import sys
7import tempfile
8import urllib.error
9import urllib.request
10
11from api import instance
12
13
14data = json.load(sys.stdin)
15container, address = instance(data["serviceId"])
16script = """
17IFS= read -r password
18cd /app/gitea
19su-exec git /usr/local/bin/gitea admin user create \
20 --username studio-automation --email studio-automation@users.invalid \
21 --password "$password" --must-change-password=false >/dev/null 2>&1 || true
22su-exec git /usr/local/bin/gitea admin user change-password \
23 --username studio-automation --password "$password" >/dev/null
24su-exec git /usr/local/bin/gitea admin user must-change-password \
25 --unset studio-automation >/dev/null
26"""
27result = subprocess.run(
28 ["podman", "--url", "unix:///run/podman/podman.sock", "exec", "-i", container,
29 "/bin/sh", "-ec", script],
30 input=data["automation_password"] + "\n", text=True, capture_output=True,
31)
32if result.returncode:
33 raise RuntimeError("could not prepare Forgejo automation account")
34
35path = "nomad/jobs/" + data["serviceId"]
36request = urllib.request.Request(
37 "http://127.0.0.1:4646/v1/var/" + path,
38 headers={"X-Nomad-Token": os.environ["NOMAD_TOKEN"]},
39)
40with urllib.request.urlopen(request, timeout=5) as response:
41 variable = json.load(response)
42current = variable["Items"].get("automation_token")
43if current:
44 check = urllib.request.Request(address + "/api/v1/user", headers={"Authorization": "token " + current})
45 try:
46 with urllib.request.urlopen(check, timeout=5) as response:
47 response.read()
48 except urllib.error.HTTPError as error:
49 if error.code not in (401, 403):
50 raise
51 current = None
52if not current:
53 generated = subprocess.run(
54 ["podman", "--url", "unix:///run/podman/podman.sock", "exec", container,
55 "/bin/sh", "-ec", "cd /app/gitea; su-exec git /usr/local/bin/gitea admin user generate-access-token --username studio-automation --token-name studio-" + secrets.token_hex(8) + " --raw"],
56 check=True, capture_output=True, text=True,
57 ).stdout.strip()
58 if len(generated) < 20:
59 raise ValueError("Forgejo did not generate an automation token")
60 with tempfile.NamedTemporaryFile("w", suffix=".nv.hcl", delete=False) as file:
61 file.write("items {\n" + "".join(
62 f" {key} = {json.dumps(value)}\n"
63 for key, value in {**variable["Items"], "automation_token": generated}.items()
64 ) + "}\n")
65 filename = file.name
66 try:
67 subprocess.run(["nomad", "var", "put", "-in=hcl", "-out=none",
68 f"-check-index={variable['ModifyIndex']}", path, "@" + filename], check=True)
69 finally:
70 os.unlink(filename)
service/evil-forgejo/start.sh deleted-10
...@@ -1,10 +0,0 @@
1#!/bin/sh
2set -eu
3
4mkdir -p /custom/conf
5envsubst < /studio/app.ini > /custom/conf/app.ini
6chown "$USER_UID:$USER_GID" /custom/conf /custom/conf/app.ini
7chmod 750 /custom/conf
8chmod 600 /custom/conf/app.ini
9# The image's s6 bundle starts an SSH daemon on the host's port 22.
10exec /usr/bin/entrypoint /bin/bash -c 'source /etc/s6/gitea/setup; cd /app/gitea; exec su-exec git /usr/local/bin/gitea web'
service/evil-hedgedoc/icon.svg deleted-1
...@@ -1 +0,0 @@
1<svg fill="#1e81b0" role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>HedgeDoc</title><path d="m12.097.227-1.913 1.341L7.93.914 6.6 2.816l-2.346.142-.586 2.234-2.157.92.23 2.295L.032 9.995l1.015 2.083L0 14.14l1.679 1.616-.267 2.291 2.141.955.549 2.243 2.344.178 1.3 1.925 2.965-.836-6.421-6.298a4.548 4.548 0 0 1-1.491-3.364c0-2.542 2.1-4.601 4.692-4.601 1.406 0 2.668.607 3.527 1.57l.978.959 1.195-1.173a4.725 4.725 0 0 1 3.3-1.332c2.591 0 4.692 2.061 4.692 4.603 0 1.4-.702 2.628-1.644 3.497l-6.291 6.178a1.78 1.78 0 0 0-1.25-.509c-.489 0-.933.195-1.252.51.006.675.563 1.22 1.252 1.22.66 0 1.2-.502 1.248-1.139l2.822.78 1.33-1.901 2.348-.142.585-2.234 2.156-.921-.227-2.297 1.705-1.587-1.015-2.081L24 10.186l-1.68-1.614.266-2.293-2.14-.955-.55-2.243-2.344-.18L16.253.98l-2.265.619ZM9.292 13.58c-.614 0-1.111.489-1.111 1.091a1.1 1.1 0 0 0 1.111 1.09 1.1 1.1 0 0 0 1.112-1.09 1.1 1.1 0 0 0-1.112-1.09zm5.423 0a1.1 1.1 0 0 0-1.11 1.091 1.1 1.1 0 0 0 1.11 1.09c.616 0 1.112-.488 1.112-1.09 0-.602-.496-1.09-1.112-1.09z"/></svg>
service/evil-hedgedoc/service.pkl deleted-66
...@@ -1,66 +0,0 @@
1amends "../../config/Service.pkl"
2
3import "../../config/site.pkl" as site
4import "../evil-forgejo/service.pkl" as forgejo
5import "../postgres/service.pkl" as postgres
6
7local host = if (site.preview) "\(module.id).evil.\(site.domain)" else if (site.domain.endsWith(".test")) "md.evil.\(site.domain)" else "md.evil.inc"
8
9meta { name = "evil.inc Notes" }
10healthyDeadline = "15m"
11healthRestartGrace = "5m"
12
13requirements {
14 new postgres.Database { name = "evil_hedgedoc" }
15 new forgejo.OAuthClient {
16 name = "HedgeDoc"
17 redirectUris { "https://\(host)/auth/oauth2/callback" }
18 }
19}
20
21secrets { ["session_secret"] {} }
22
23container {
24 image = "quay.io/hedgedoc/hedgedoc@sha256:7b3f79667ad58c6419758547f10940638bcdc85ebee2a4e650318a704095975b"
25 cpu = 200
26 memory = 768
27
28 http {
29 containerPort = 3000
30 hostname = host
31 checkPath = "/_health"
32 metricsPath = "/metrics"
33 }
34
35 volumes { ["/hedgedoc/public/uploads"] {} }
36
37 env {
38 ["CMD_DB_DIALECT"] = "postgres"
39 ["CMD_DB_DATABASE"] = "${secret.database.name}"
40 ["CMD_DB_USERNAME"] = "${secret.database.username}"
41 ["CMD_DB_PASSWORD"] = "${secret.database.password}"
42 ["CMD_DOMAIN"] = host
43 ["CMD_PROTOCOL_USESSL"] = "true"
44 ["CMD_URL_ADDPORT"] = "false"
45 ["CMD_EMAIL"] = "false"
46 ["CMD_ALLOW_ANONYMOUS"] = "false"
47 ["CMD_ALLOW_ANONYMOUS_EDITS"] = "false"
48 ["CMD_SESSION_SECRET"] = "${secret.own.session_secret}"
49 ["CMD_OAUTH2_PROVIDERNAME"] = "git.evil.inc"
50 ["CMD_OAUTH2_CLIENT_ID"] = "${secret.oauth.clientId}"
51 ["CMD_OAUTH2_CLIENT_SECRET"] = "${secret.oauth.clientSecret}"
52 ["CMD_OAUTH2_BASEURL"] = "${secret.oauth.providerUrl}"
53 ["CMD_OAUTH2_AUTHORIZATION_URL"] = "${secret.oauth.providerUrl}/login/oauth/authorize"
54 ["CMD_OAUTH2_USER_PROFILE_ID_ATTR"] = "id"
55 ["CMD_OAUTH2_USER_PROFILE_USERNAME_ATTR"] = "username"
56 ["CMD_OAUTH2_USER_PROFILE_DISPLAY_NAME_ATTR"] = "full_name"
57 ["CMD_OAUTH2_USER_PROFILE_EMAIL_ATTR"] = "email"
58 }
59
60 envTemplate = """
61 {{ range nomadService 1 (env "NOMAD_ALLOC_ID") "postgres" }}CMD_DB_HOST={{ .Address }}
62 CMD_DB_PORT={{ .Port }}{{ end }}
63 {{ range nomadService 1 (env "NOMAD_ALLOC_ID") "evil-forgejo-forgejo" }}CMD_OAUTH2_TOKEN_URL=http://\(module.nomadHostPort)/login/oauth/access_token
64 CMD_OAUTH2_USER_PROFILE_URL=http://\(module.nomadHostPort)/api/v1/user{{ end }}
65 """
66}
service/flaresolverr/service.pkl+1-1
...@@ -1,6 +1,6 @@...@@ -1,6 +1,6 @@
1amends "../../config/Service.pkl"1amends "../../config/Service.pkl"
22
3meta { name = "FlareSolverr" }3name = "FlareSolverr"
4rollout = "overlapped"4rollout = "overlapped"
55
6container {6container {
service/forward-auth/service.pkl+3-4
...@@ -5,13 +5,13 @@ import "../../config/OpenID.pkl" as sso...@@ -5,13 +5,13 @@ import "../../config/OpenID.pkl" as sso
55
6local isPreview = read?("prop:preview") == "true"6local isPreview = read?("prop:preview") == "true"
77
8meta { name = "Forward Auth" }8name = "Forward Auth"
9rollout = "overlapped"9rollout = "overlapped"
1010
11requirements {11requirements {
12 new sso.Client {12 new sso.Client {
13 clientId = module.id13 clientId = module.id
14 name = module.meta.name14 name = module.name
15 redirectUris {15 redirectUris {
16 when (isPreview) { "https://\(module.id).\(site.domain)/snow.oauth2/callback" }16 when (isPreview) { "https://\(module.id).\(site.domain)/snow.oauth2/callback" }
17 when (!isPreview) { for (host in new Listing<String> { "music"; "seedbox"; "ddns"; "redis"; "pg"; "snr"; "rdr"; "logs"; "metrics"; "traces"; "jkt"; "openclaw" }) {17 when (!isPreview) { for (host in new Listing<String> { "music"; "seedbox"; "ddns"; "redis"; "pg"; "snr"; "rdr"; "logs"; "metrics"; "traces"; "jkt"; "openclaw" }) {
...@@ -29,7 +29,6 @@ container {...@@ -29,7 +29,6 @@ container {
29 image = "quay.io/oauth2-proxy/oauth2-proxy@sha256:56e3daedf765c7a1eea6e366fbe684be7d3084830ade14b6174570d3c7960954"29 image = "quay.io/oauth2-proxy/oauth2-proxy@sha256:56e3daedf765c7a1eea6e366fbe684be7d3084830ade14b6174570d3c7960954"
30 cpu = 10030 cpu = 100
31 memory = 25631 memory = 256
32 extraHosts { "\(sso.hostname):host-gateway" }
3332
34 http {33 http {
35 containerPort = 418034 containerPort = 4180
...@@ -39,7 +38,7 @@ container {...@@ -39,7 +38,7 @@ container {
3938
40 volumes {39 volumes {
41 ["/etc/ssl/certs/ca-certificates.crt"] {40 ["/etc/ssl/certs/ca-certificates.crt"] {
42 src = "/var/lib/studio/ca-bundle.crt"41 src = "/var/lib/snowglobe/ca-bundle.crt"
43 readOnly = true42 readOnly = true
44 }43 }
45 }44 }
service/intake/service.pkl+2-1
...@@ -2,7 +2,8 @@ amends "../../config/Service.pkl"...@@ -2,7 +2,8 @@ amends "../../config/Service.pkl"
22
3import "../../config/site.pkl" as site3import "../../config/site.pkl" as site
44
5meta { name = "JSON Intake"; launcher = false }5name = "JSON Intake"
6launcher = false
67
7secrets = if (site.domain.endsWith(".test")) new { ["key"] {} } else new {}8secrets = if (site.domain.endsWith(".test")) new { ["key"] {} } else new {}
8requiredSecrets = if (site.domain.endsWith(".test")) new {} else new { "key" }9requiredSecrets = if (site.domain.endsWith(".test")) new {} else new { "key" }
service/jackett/service.pkl+1-3
...@@ -1,11 +1,9 @@...@@ -1,11 +1,9 @@
1amends "../../config/Service.pkl"1amends "../../config/Service.pkl"
22
3meta { name = "Jackett" }3name = "Jackett"
44
5container {5container {
6 image = "lscr.io/linuxserver/jackett@sha256:139a0819074ef16556399a66ee3c492f0d202ec20467cf9300d7126b8a31f2b5"6 image = "lscr.io/linuxserver/jackett@sha256:139a0819074ef16556399a66ee3c492f0d202ec20467cf9300d7126b8a31f2b5"
7 cpu = 200
8 memory = 512
97
10 http {8 http {
11 containerPort = 91179 containerPort = 9117
service/jellyfin/configure.py+2-2
...@@ -10,13 +10,13 @@ import urllib.request...@@ -10,13 +10,13 @@ import urllib.request
1010
11config = json.load(sys.stdin)11config = json.load(sys.stdin)
12base = f"https://{config['host']}"12base = f"https://{config['host']}"
13context = ssl.create_default_context(cafile="/var/lib/studio/ca-bundle.crt")13context = ssl.create_default_context(cafile="/var/lib/snowglobe/ca-bundle.crt")
1414
1515
16def request(path, data=None, token=None):16def request(path, data=None, token=None):
17 headers = {17 headers = {
18 "Content-Type": "application/json",18 "Content-Type": "application/json",
19 "Authorization": 'MediaBrowser Client="home server", Device="server", DeviceId="studio", Version="1"',19 "Authorization": 'MediaBrowser Client="home server", Device="server", DeviceId="snowglobe", Version="1"',
20 }20 }
21 if token:21 if token:
22 headers["X-Emby-Token"] = token22 headers["X-Emby-Token"] = token
service/jellyfin/service.pkl+3-6
...@@ -3,9 +3,7 @@ amends "../../config/Service.pkl"...@@ -3,9 +3,7 @@ amends "../../config/Service.pkl"
3import "../../config/site.pkl" as site3import "../../config/site.pkl" as site
4import "../../config/OpenID.pkl" as sso4import "../../config/OpenID.pkl" as sso
55
6meta { name = "Jellyfin" }6name = "Jellyfin"
7// SQLite under /config requires one writer during rollout.
8rollout = "simple"
9healthyDeadline = "20m"7healthyDeadline = "20m"
10healthRestartGrace = "20m"8healthRestartGrace = "20m"
11prepare = "prepare.py"9prepare = "prepare.py"
...@@ -16,7 +14,7 @@ secrets { ["admin_password"] {} }...@@ -16,7 +14,7 @@ secrets { ["admin_password"] {} }
16requirements {14requirements {
17 new sso.Client {15 new sso.Client {
18 clientId = module.id16 clientId = module.id
19 name = module.meta.name17 name = module.name
20 redirectUris {18 redirectUris {
21 "https://\(module.container.http.hostname)/sso/OID/r/snow"19 "https://\(module.container.http.hostname)/sso/OID/r/snow"
22 "https://\(module.container.http.hostname)/sso/OID/redirect/snow"20 "https://\(module.container.http.hostname)/sso/OID/redirect/snow"
...@@ -28,7 +26,6 @@ container {...@@ -28,7 +26,6 @@ container {
28 image = "docker.io/jellyfin/jellyfin@sha256:aefb67e6a7ff1debdd154a78a7bbb780fd0c873d8639210a7f6a2016ad2b35db"26 image = "docker.io/jellyfin/jellyfin@sha256:aefb67e6a7ff1debdd154a78a7bbb780fd0c873d8639210a7f6a2016ad2b35db"
29 cpu = 50027 cpu = 500
30 memory = 307228 memory = 3072
31 extraHosts { "\(sso.hostname):host-gateway" }
3229
33 http {30 http {
34 containerPort = 809631 containerPort = 8096
...@@ -53,7 +50,7 @@ container {...@@ -53,7 +50,7 @@ container {
53 }50 }
54 ["/config/config/branding.xml"] { config = "branding.xml" }51 ["/config/config/branding.xml"] { config = "branding.xml" }
55 ["/etc/ssl/certs/ca-certificates.crt"] {52 ["/etc/ssl/certs/ca-certificates.crt"] {
56 src = "/var/lib/studio/ca-bundle.crt"53 src = "/var/lib/snowglobe/ca-bundle.crt"
57 readOnly = true54 readOnly = true
58 }55 }
59 }56 }
service/keycloak/api.py deleted-83
...@@ -1,83 +0,0 @@
1import http.client
2import io
3import json
4import os
5import socket
6import ssl
7import time
8import urllib.error
9import urllib.parse
10
11
12class LoopbackHTTPS(http.client.HTTPSConnection):
13 def connect(self):
14 sock = socket.create_connection(("127.0.0.1", self.port), self.timeout)
15 self.sock = self._context.wrap_socket(sock, server_hostname=self.host)
16
17
18class Keycloak:
19 def configure_profile(self):
20 profile = self.request("/admin/realms/master/users/profile")
21 if not any(attribute["name"] == "picture" for attribute in profile["attributes"]):
22 profile["attributes"].append({"name": "picture", "displayName": "Profile picture",
23 "permissions": {"view": ["admin", "user"], "edit": ["admin", "user"]},
24 "validations": {"length": {"max": 8192}}})
25 self.request("/admin/realms/master/users/profile", "PUT", profile)
26
27 def __init__(self, host, password, attempts=300, cafile=None):
28 self.host = host
29 self.context = ssl.create_default_context(
30 cafile=cafile or ("/var/lib/caddy/.local/share/caddy/pki/authorities/local/root.crt"
31 if host.endswith(".test") else None)
32 )
33 self.token = None
34 for attempt in range(attempts):
35 try:
36 body = urllib.parse.urlencode({
37 "client_id": "admin-cli",
38 "grant_type": "password",
39 "username": "admin",
40 "password": password,
41 }).encode()
42 self.token = self.request("/realms/master/protocol/openid-connect/token", "POST", body)["access_token"]
43 break
44 except urllib.error.HTTPError as error:
45 if error.code not in (502, 503, 504) or attempt == attempts - 1:
46 raise
47 time.sleep(2)
48 except (ConnectionError, TimeoutError, http.client.HTTPException, ssl.SSLError):
49 if attempt == attempts - 1:
50 raise
51 time.sleep(2)
52
53 def request(self, path, method="GET", body=None, full=False):
54 headers = {}
55 if self.token:
56 headers["Authorization"] = "Bearer " + self.token
57 if isinstance(body, (dict, list)):
58 body = json.dumps(body).encode()
59 headers["Content-Type"] = "application/json"
60 elif body is not None:
61 headers["Content-Type"] = "application/x-www-form-urlencoded"
62 connection = LoopbackHTTPS(
63 self.host,
64 timeout=int(os.getenv("STUDIO_API_TIMEOUT", "10")),
65 context=self.context,
66 )
67 try:
68 connection.request(method, path, body=body, headers=headers)
69 response = connection.getresponse()
70 content = response.read(16 * 1024 * 1024 + 1)
71 if len(content) > 16 * 1024 * 1024:
72 raise ValueError("Keycloak response exceeds 16 MiB")
73 if response.status >= 400:
74 raise urllib.error.HTTPError(
75 "https://" + self.host + path, response.status, response.reason,
76 response.headers, io.BytesIO(content),
77 )
78 value = json.loads(content) if content else None
79 if full:
80 return {"body": value, "id": response.getheader("Location", "").rsplit("/", 1)[-1] or None}
81 return value
82 finally:
83 connection.close()
service/keycloak/configure.py deleted-67
...@@ -1,67 +0,0 @@
1#!/usr/bin/env python3
2import json
3import sys
4
5from api import Keycloak
6
7
8config = json.load(sys.stdin)
9keycloak = Keycloak(config["host"], config["password"])
10keycloak.configure_profile()
11keycloak.request(
12 "/admin/realms/master",
13 "PUT",
14 {
15 "displayName": "snow sign on",
16 "displayNameHtml": '<div class="kc-logo-text"><span>snow sign on</span></div>',
17 "editUsernameAllowed": True,
18 "resetPasswordAllowed": True,
19 "rememberMe": True,
20 "loginWithEmailAllowed": True,
21 "registrationAllowed": False,
22 "webAuthnPolicyRpEntityName": "snow sign on",
23 "webAuthnPolicyPasswordlessPasskeysEnabled": True,
24 "loginTheme": "snow",
25 },
26)
27roles_path = "/admin/realms/master/roles"
28roles = {role["name"]: role for role in keycloak.request(roles_path)}
29for name in ("admin", "infra-admin", "media", "media-manage"):
30 if name not in roles:
31 keycloak.request(roles_path, "POST", {"name": name})
32 roles[name] = keycloak.request(f"{roles_path}/{name}")
33
34users = keycloak.request("/admin/realms/master/users?username=admin&exact=true")
35if len(users) != 1:
36 raise ValueError("expected one bootstrap admin user")
37if users[0].get("email") or users[0].get("emailVerified"):
38 keycloak.request(
39 f"/admin/realms/master/users/{users[0]['id']}", "PUT",
40 {**users[0], "email": None, "emailVerified": False},
41 )
42mapping_path = f"/admin/realms/master/users/{users[0]['id']}/role-mappings/realm"
43assigned = {role["name"] for role in keycloak.request(mapping_path)}
44missing = [roles[name] for name in ("admin", "media", "media-manage") if name not in assigned]
45if missing:
46 keycloak.request(mapping_path, "POST", missing)
47
48snow = keycloak.request("/admin/realms/master/users?username=snow&exact=true")
49if not snow:
50 keycloak.request("/admin/realms/master/users", "POST", {
51 "username": "snow",
52 "enabled": True,
53 "credentials": [{"type": "password", "value": config["snow_password"], "temporary": False}],
54 })
55 snow = keycloak.request("/admin/realms/master/users?username=snow&exact=true")
56if len(snow) != 1:
57 raise ValueError("expected one snow user")
58if snow[0].get("email") != config["ownerEmail"] or not snow[0].get("emailVerified"):
59 keycloak.request(
60 f"/admin/realms/master/users/{snow[0]['id']}", "PUT",
61 {**snow[0], "email": config["ownerEmail"], "emailVerified": True},
62 )
63mapping_path = f"/admin/realms/master/users/{snow[0]['id']}/role-mappings/realm"
64assigned = {role["name"] for role in keycloak.request(mapping_path)}
65missing = [roles[name] for name in ("infra-admin", "media", "media-manage") if name not in assigned]
66if missing:
67 keycloak.request(mapping_path, "POST", missing)
service/keycloak/icon.svg deleted-1
...@@ -1 +0,0 @@
1<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" id="Layer_1" x="0" y="0" version="1.1" viewBox="0 0 512 512"><style>.st9{fill:#d0d0d0}.st11{fill:#d9d9d9}.st13{fill:#d8d8d8}.st14{fill:#e2e2e2}.st16{fill:#dedede}.st21{fill:#00b8e3}.st22{fill:#33c6e9}.st23{fill:#008aaa}</style><g id="g2460" transform="translate(.714 .07)"><path id="path1588" d="M432.9 149.2c-1.4 0-2.7-.7-3.4-2L370.1 44.1c-.7-1.2-2-2-3.5-2H124.2c-1.4 0-2.7.7-3.4 2L58.9 150.9l23.9 34.9c-.7 1.2-6.2 24-5.5 25.2L58.9 360.9l61.9 106.9c.7 1.2 2 2 3.4 2h242.4c1.4 0 2.7-.7 3.5-2l59.4-103.2c.7-1.2 2-2 3.4-2h73.8c2.4 0 4.4-2 4.4-4.4V153.6c0-2.4-2-4.4-4.4-4.4z" style="fill:#4d4d4d"/><path id="path1594" d="M72.7 245.3 6.4 269.4l-6.6-11.3c-.7-1.2-.7-2.7 0-3.9l30-52z" style="fill:#e1e1e1"/><path id="polygon1794" d="M511.3 258.3V309l-43.7-44.5z" style="fill:#c8c8c8"/><path id="path1798" d="m467.5 264.5 43.7 44.5v49.6c0 2.4-2 4.4-4.4 4.4H456z" style="fill:#c2c2c2"/><path id="polygon1802" d="M467.5 264.5 456 362.9h-61.2l-18.5-44.7z" style="fill:#c7c7c7"/><path id="polygon1804" d="M511.3 211.2v47l-43.7 6.2z" style="fill:#cecece"/><path id="path1808" d="M511.3 153.6v57.6l-43.7 53.2-33.1-115.3h72.2c2.4-.1 4.5 1.8 4.6 4.3z" style="fill:#d3d3d3"/><path id="polygon1812" d="M394.8 362.9h-32.3l-8.4-12 22.1-32.7z" style="fill:#c6c6c6"/><path id="polygon1814" d="m467.5 264.5-121.1-51.2 63.7-64.1h24.4z" style="fill:#d5d5d5"/><path id="path1816" d="m346.5 213.3 29.8 105 91.2-53.8z" class="st9"/><path id="polygon1818" d="m353.8 362.9.4-12 8.4 12z" style="fill:#bfbfbf"/><path id="polygon1820" d="m410.1 149.2-63.7 64.1-11.4-57.4 24.6-6.8h50.5z" class="st11"/><path id="path1822" d="m346.5 213.3-147 33.9 154.7 103.7z" style="fill:#d4d4d4"/><path id="path1824" d="m346.5 213.3 7.7 137.6 22.1-32.7z" class="st9"/><path id="path1826" d="m335 155.9-135.5 91.2 147-33.9z" class="st11"/><path id="polygon1828" d="m199.5 247.2-63.7 115.7H99.6L72.7 245.3z" class="st13"/><path id="path1830" d="m134.3 149.2-61.5 96.1L57.3 155l2.2-3.8c.7-1.2 2-1.9 3.4-1.9z" class="st14"/><path id="path1832" d="M99.6 362.9H62.7c-1.4 0-2.8-.8-3.5-2L6.4 269.4l66.4-24.1z" class="st13"/><path id="polygon1834" d="M29.9 202.1 57.1 155l15.7 90.3z" style="fill:#e4e4e4"/><path id="polygon1836" d="m335 155.9-40.8-6.8H159.4l40.1 98z" class="st16"/><path id="polygon1838" d="m199.5 247.2-40.1-98h-25.1l-61.5 96.1z" class="st16"/><path id="polygon1840" d="M324.7 362.9h29.1l.4-12z" style="fill:#c5c5c5"/><path id="polygon1842" d="M266.7 362.9h58l29.5-12-154.7-103.7 27.9 115.7z" class="st9"/><path id="polygon1844" d="m227.4 362.9-27.9-115.7-63.7 115.7z" style="fill:#d1d1d1"/><path id="polygon1856" d="m335.4 149.2-.4 6.8 24.6-6.8z" style="fill:#ddd"/><path id="polygon1858" d="m335 155.9-3.8-6.8h-37z" style="fill:#e3e3e3"/><path id="polygon1860" d="m335 155.9.4-6.8h-4.2z" class="st14"/><path id="path1862" d="m223.9 151-59.7 103.4c-.3.5-.4 1.1-.4 1.7h-41.7l82-142q.75.45 1.2 1.2l18.6 32.3c.5 1.1.5 2.4 0 3.4" class="st21"/><path id="path1864" d="M223.8 364.9 205.3 397q-.45.75-1.2 1.2l-82-142.2h41.7c0 .6.1 1.1.4 1.6l59.6 103.2c.8 1.2.9 2.9 0 4.1" class="st22"/><path id="path1866" d="m204 114.2-82 141.9-20.6 35.6-19.6-34c-.3-.5-.4-1-.4-1.6s.1-1.2.4-1.7l19.9-34.4 60.4-104.5c.6-1.1 1.8-1.8 3-1.8h37.2c.6 0 1.2.2 1.7.5" class="st23"/><path id="path1868" d="M204 398.2c-.5.3-1.1.5-1.8.5h-37.1c-1.3 0-2.4-.7-3-1.8l-55.2-95.6-5.5-9.5 20.6-35.6z" class="st21"/><path id="path1870" d="m368.9 256.1-82 142q-.75-.45-1.2-1.2L267 364.7c-.5-1-.5-2.3 0-3.3L326.7 258c.3-.5.5-1.2.5-1.8z" class="st23"/><path id="path1872" d="M409.4 256.1c0 .6-.2 1.3-.5 1.8l-80.3 139.3c-.6 1-1.8 1.7-3 1.6h-37c-.6 0-1.2-.2-1.8-.5L368.9 256l20.6-35.6 19.5 33.8c.3.7.4 1.3.4 1.9" class="st21"/><path id="path1874" d="M368.9 256.1h-41.7c0-.6-.2-1.2-.5-1.8L267 151.2c-.6-1.1-.6-2.5 0-3.6l18.6-32.2q.45-.75 1.2-1.2z" class="st21"/><path id="path1876" d="m389.4 220.5-20.6 35.6-82-142c.6-.3 1.2-.5 1.8-.5h37.1c1.2 0 2.3.6 3 1.6z" class="st22"/></g></svg>
\ No newline at end of file
service/keycloak/provide.py deleted-100
...@@ -1,100 +0,0 @@
1#!/usr/bin/env python3
2import json
3import sys
4import urllib.parse
5
6from api import Keycloak
7
8
9data = json.load(sys.stdin)
10request = data["request"]
11if request["kind"] != "client":
12 raise ValueError("unsupported Keycloak input")
13stage_id = data.get("stageId")
14client_id = request["clientId"]
15if stage_id and client_id != stage_id:
16 client_id += "-" + stage_id[-8:]
17if data.get("operation") == "delete" and not stage_id:
18 raise ValueError("refusing to delete a production client")
19existing = data.get("existing") or {}
20if existing.get("clientId") and existing["clientId"] != client_id:
21 raise ValueError("client ID changed; migrate the existing client before deployment")
22keycloak = Keycloak(data["host"], data["providerSecrets"]["password"])
23desired = {
24 "protocol": "openid-connect",
25 "clientId": client_id,
26 "name": request["name"],
27 "publicClient": False,
28 "authorizationServicesEnabled": False,
29 "serviceAccountsEnabled": False,
30 "implicitFlowEnabled": False,
31 "directAccessGrantsEnabled": False,
32 "standardFlowEnabled": True,
33 "frontchannelLogout": True,
34 "redirectUris": request["redirectUris"],
35 "attributes": {"post.logout.redirect.uris": "*"},
36}
37path = "/admin/realms/master/clients"
38query = "?" + urllib.parse.urlencode({"clientId": client_id})
39found = keycloak.request(path + query)
40matches = [client for client in found if client["clientId"] == client_id]
41if len(matches) > 1:
42 raise ValueError(f"duplicate Keycloak client: {client_id}")
43if data.get("operation") == "delete":
44 if matches:
45 keycloak.request(f"{path}/{matches[0]['id']}", "DELETE")
46 sys.exit(0)
47if not matches:
48 keycloak.request(path, "POST", desired)
49 found = keycloak.request(path + query)
50 matches = [client for client in found if client["clientId"] == client_id]
51 if len(matches) != 1:
52 raise ValueError(f"Keycloak client was not created: {client_id}")
53uuid = matches[0]["id"]
54current = keycloak.request(f"{path}/{uuid}")
55attributes = {**(current.get("attributes") or {}), **desired["attributes"]}
56if any(current.get(key) != value for key, value in desired.items() if key != "attributes") or current.get("attributes", {}) != attributes:
57 keycloak.request(f"{path}/{uuid}", "PUT", {**current, **desired, "attributes": attributes})
58aliases = request.get("usernameAliases", {})
59if aliases:
60 if len(set(aliases.values())) != len(aliases):
61 raise ValueError("Shale username aliases must be unique")
62 roles_path = f"{path}/{uuid}/roles"
63 roles = {role["name"]: role for role in keycloak.request(roles_path)}
64 if set(roles) - set(aliases.values()):
65 raise ValueError("username alias clients cannot also carry permission roles")
66 for username, alias in aliases.items():
67 users = keycloak.request("/admin/realms/master/users?" + urllib.parse.urlencode({"username": username, "exact": "true"}))
68 if len(users) != 1:
69 raise ValueError(f"expected one alias account: {username}")
70 if alias not in roles:
71 keycloak.request(roles_path, "POST", {"name": alias, "description": "Shale username alias"})
72 roles[alias] = keycloak.request(roles_path + "/" + urllib.parse.quote(alias, safe=""))
73 owners = keycloak.request(roles_path + "/" + urllib.parse.quote(alias, safe="") + "/users")
74 if any(owner["id"] != users[0]["id"] for owner in owners):
75 raise ValueError(f"username alias already assigned: {alias}")
76 assigned = keycloak.request(f"/admin/realms/master/users/{users[0]['id']}/role-mappings/clients/{uuid}")
77 if any(role["name"] != alias for role in assigned):
78 raise ValueError(f"multiple username aliases for {username}")
79 if not assigned:
80 keycloak.request(f"/admin/realms/master/users/{users[0]['id']}/role-mappings/clients/{uuid}", "POST", [roles[alias]])
81 mapper = {
82 "name": "Shale username alias", "protocol": "openid-connect",
83 "protocolMapper": "oidc-usermodel-client-role-mapper",
84 "config": {"usermodel.clientRoleMapping.clientId": client_id,
85 "claim.name": "preferred_username", "jsonType.label": "String",
86 "multivalued": "false", "access.token.claim": "true",
87 "id.token.claim": "true", "userinfo.token.claim": "true"},
88 }
89 mappers_path = f"{path}/{uuid}/protocol-mappers/models"
90 matches = [item for item in keycloak.request(mappers_path) if item["name"] == mapper["name"]]
91 if len(matches) > 1:
92 raise ValueError("duplicate Shale username mapper")
93 if not matches:
94 keycloak.request(mappers_path, "POST", mapper)
95 elif any(matches[0].get(key) != value for key, value in mapper.items()):
96 keycloak.request(f"{mappers_path}/{matches[0]['id']}", "PUT", {**mapper, "id": matches[0]["id"]})
97secret = keycloak.request(f"{path}/{uuid}/client-secret")["value"]
98if not secret:
99 raise ValueError(f"Keycloak client has no secret: {client_id}")
100print(json.dumps({"clientId": client_id, "clientSecret": secret, "issuerUrl": f"https://{data['host']}/realms/master"}))
service/keycloak/service.pkl deleted-73
...@@ -1,73 +0,0 @@
1extends "../../config/Service.pkl"
2
3import "../../config/Service.pkl" as service
4import "../../config/site.pkl" as site
5import "../postgres/service.pkl" as postgres
6
7class OpenIDClient extends service.Requirement {
8 alias: String = "oidc"
9 fixed provider = "keycloak"
10 fixed kind = "client"
11 clientId: String(isNotEmpty)
12 name: String
13 redirectUris: Listing<String> = new { "*" }
14 usernameAliases: Mapping<String, String> = new {}
15}
16
17local database = new postgres.Database { name = "keycloak_next" }
18
19meta { name = "Keycloak"; launcher = false }
20traceServiceName = module.id
21dependsOn { "victoria" }
22healthyDeadline = "20m"
23setup = "configure.py"
24provide = "provide.py"
25
26requirements { database }
27
28container {
29 image = "quay.io/keycloak/keycloak@sha256:82a77884f3af238beab1e7afd63b5f530e1b5c0590bd7aa60b40a40463e29b2c"
30 rootGroup = true
31 cpu = 500
32 memory = 1200
33 args { "start" }
34
35 http {
36 containerPort = 8080
37 subdomain = "auth"
38 plainHostnames { "keycloak.\(site.domain)" }
39 checkPath = "/realms/master"
40 }
41
42 volumes {
43 ["/opt/keycloak/data"] {}
44 ["/opt/keycloak/themes/snow"] { config = "theme" }
45 }
46
47 env {
48 ["JAVA_TOOL_OPTIONS"] = read?("env:STUDIO_JAVA_OPTIONS") ?? ""
49 ["KC_DB"] = "postgres"
50 ["KC_DB_USERNAME"] = "${secret.database.username}"
51 ["KC_DB_PASSWORD"] = "${secret.database.password}"
52 ["KC_BOOTSTRAP_ADMIN_USERNAME"] = "admin"
53 ["KC_BOOTSTRAP_ADMIN_PASSWORD"] = "${secret.own.password}"
54 ["KC_HTTP_ENABLED"] = "true"
55 ["KC_PROXY_HEADERS"] = "xforwarded"
56 ["KC_HOSTNAME"] = "https://\(module.container.http.hostname)"
57 ["KC_TRACING_ENABLED"] = "true"
58 ["KC_TRACING_PROTOCOL"] = "http/protobuf"
59 ["KC_TELEMETRY_SERVICE_NAME"] = module.id
60 ["KC_TRACING_SAMPLER_TYPE"] = "parentbased_traceidratio"
61 ["KC_TRACING_SAMPLER_RATIO"] = "0.25"
62 }
63
64 envTemplate = """
65 {{ range nomadService 1 (env "NOMAD_ALLOC_ID") "\(database.provider)" }}KC_DB_URL=jdbc:postgresql://\(module.nomadHostPort)/{{ with nomadVar "nomad/jobs/\(module.id)/inputs/database" }}{{ .name }}{{ end }}{{ end }}
66 {{ range nomadService 1 (env "NOMAD_ALLOC_ID") "victoria-traces" }}KC_TRACING_ENDPOINT=http://\(module.nomadHostPort)/insert/opentelemetry{{ end }}
67 """
68}
69
70secrets {
71 ["password"] {}
72 ["snow_password"] {}
73}
service/keycloak/theme/login/resources/css/styles.css deleted-1
...@@ -1 +0,0 @@
1../../../../../../dashboard/web/sso/css/styles.css
\ No newline at end of file
service/keycloak/theme/login/resources/font/.gitignore deleted
service/keycloak/theme/login/resources/img/license.txt deleted-1
...@@ -1 +0,0 @@
1../../../../../../dashboard/web/sso/img/license.txt
\ No newline at end of file
service/keycloak/theme/login/resources/img/miku-dark.png deleted-1
...@@ -1 +0,0 @@
1../../../../../../dashboard/web/sso/img/miku-dark.png
\ No newline at end of file
service/keycloak/theme/login/resources/img/miku-light.png deleted-1
...@@ -1 +0,0 @@
1../../../../../../dashboard/web/sso/img/miku-light.png
\ No newline at end of file
service/keycloak/theme/login/resources/js/stars.js deleted-105
...@@ -1,105 +0,0 @@
1const shader = `
2 // Heavily modified off of https://www.shadertoy.com/view/3sKGWw
3 // big thanks to these resources as well:
4 // https://youtu.be/3CycKKJiwis
5 // https://www.shadertoy.com/view/4djSRW
6 // https://www.shadertoy.com/view/3s3GDn
7
8 precision mediump float;
9 uniform vec2 u_resolution;
10 uniform float u_time;
11 uniform bool u_mask;
12
13 float random(vec2 p){
14 vec3 p3 = fract(vec3(p.xyx) * .1031);
15 p3 += dot(p3, p3.yzx + 33.33);
16 return fract((p3.x + p3.y) * p3.z);
17 }
18
19 vec2 random2(vec2 p){
20 vec3 p3 = fract(vec3(p.xyx) * vec3(.1031, .1030, .0973));
21 p3 += dot(p3, p3.yzx+33.33);
22 return fract((p3.xx+p3.yz)*p3.zy);
23 }
24
25 void main() {
26 float glow;
27 vec2 uv;
28 vec2 fl;
29 vec2 local_uv;
30 vec2 seed;
31 vec2 centre;
32 vec2 cell;
33 float t = u_time * 0.00015;
34 float blinkTime = u_time * 0.0068;
35 float rotationAngle = -t * 21.0;
36 mat2 rotation = mat2(cos(rotationAngle), -sin(rotationAngle),
37 sin(rotationAngle), cos(rotationAngle));
38 vec3 col = vec3(0);
39
40 centre = vec2(cos(t), sin(t)) * 5.0 + 0.5;
41
42 // Get uv from the fragment coordinates, rotation and depth
43 uv = (centre - (gl_FragCoord.xy - u_resolution / 2.0) / (1600.0 / 25.0)) * rotation;
44 fl = floor(uv);
45 // The local cell coordinates. uv-fl == frac(uv)
46 local_uv = uv - fl - 0.5;
47
48 // For a 3x3 group of cells around the fragment, find the distance from the points
49 // of each to the current fragment and draw an accumulative glow accordingly
50 // The local cell is (0, 0)
51 for(float j = -1.0; j <= 1.0; j++){
52 for(float k = -1.0; k <= 1.0; k++){
53 cell = vec2(j, k);
54 seed = 128.0 + (fl + cell);
55 glow =
56 ((0.6 + 0.5 * sin((128.0 * random(seed)) * blinkTime))) * 25.0
57 * pow(0.005 / length(local_uv - (cell + 0.9 * (random2(seed) - 0.5))), 2.0);
58 col += vec3(0.2 * glow) + 0.1 * glow;
59 }
60 }
61
62 col = 1.0 - exp(-col);
63 col = pow(col, vec3(0.45));
64
65 if (u_mask) {
66 float mask = smoothstep(100.0, 300.0, length(vec2(gl_FragCoord.x - u_resolution.x/2.0, gl_FragCoord.y - 200.0)));
67 col *= mask;
68 }
69
70 gl_FragColor = vec4(col * (u_mask ? 0.6 : 0.25), 0);
71 }
72`;
73
74function createShader(gl, type, source) {
75 const shader = gl.createShader(type);
76 gl.shaderSource(shader, source);
77 gl.compileShader(shader);
78 const success = gl.getShaderParameter(shader, gl.COMPILE_STATUS);
79 if (success) {
80 return shader;
81 }
82
83 // eslint-disable-next-line no-console
84 console.error(gl.getShaderInfoLog(shader));
85 gl.deleteShader(shader);
86 throw new Error("Failed to compile shader");
87}
88
89function createProgram(gl, vertexShader, fragmentShader) {
90 const program = gl.createProgram();
91
92 gl.attachShader(program, vertexShader);
93 gl.attachShader(program, fragmentShader);
94 gl.linkProgram(program);
95
96 const success = gl.getProgramParameter(program, gl.LINK_STATUS);
97 if (success) {
98 return program;
99 }
100
101 // eslint-disable-next-line no-console
102 console.error(gl.getProgramInfoLog(program));
103 gl.deleteProgram(program);
104 throw new Error("Failed to link program");
105}
service/keycloak/theme/login/resources/js/webauthnRegister.js deleted-159
...@@ -1,159 +0,0 @@
1import { base64url } from "rfc4648";
2
3export async function registerByWebAuthn(input) {
4 // Check if WebAuthn is supported by this browser
5 if (!window.PublicKeyCredential) {
6 returnFailure(input.errmsg);
7 return;
8 }
9
10 const publicKey = {
11 challenge: base64url.parse(input.challenge, { loose: true }),
12 rp: { id: input.rpId, name: input.rpEntityName },
13 user: {
14 id: base64url.parse(input.userid, { loose: true }),
15 name: input.username,
16 displayName: input.username,
17 },
18 pubKeyCredParams: getPubKeyCredParams(input.signatureAlgorithms),
19 };
20
21 if (input.attestationConveyancePreference !== "not specified") {
22 publicKey.attestation = input.attestationConveyancePreference;
23 }
24
25 const authenticatorSelection = {};
26 let isAuthenticatorSelectionSpecified = false;
27
28 if (input.authenticatorAttachment !== "not specified") {
29 authenticatorSelection.authenticatorAttachment =
30 input.authenticatorAttachment;
31 isAuthenticatorSelectionSpecified = true;
32 }
33
34 if (input.requireResidentKey !== "not specified") {
35 if (input.requireResidentKey === "Yes") {
36 authenticatorSelection.requireResidentKey = true;
37 } else {
38 authenticatorSelection.requireResidentKey = false;
39 }
40 isAuthenticatorSelectionSpecified = true;
41 }
42
43 if (input.userVerificationRequirement !== "not specified") {
44 authenticatorSelection.userVerification = input.userVerificationRequirement;
45 isAuthenticatorSelectionSpecified = true;
46 }
47
48 if (isAuthenticatorSelectionSpecified) {
49 publicKey.authenticatorSelection = authenticatorSelection;
50 }
51
52 if (input.createTimeout !== 0) {
53 publicKey.timeout = input.createTimeout * 1000;
54 }
55
56 const excludeCredentials = getExcludeCredentials(input.excludeCredentialIds);
57 if (excludeCredentials.length > 0) {
58 publicKey.excludeCredentials = excludeCredentials;
59 }
60
61 try {
62 const result = await doRegister(publicKey);
63 returnSuccess(result, input.initLabel, input.initLabelPrompt);
64 } catch (error) {
65 returnFailure(error);
66 }
67}
68
69function doRegister(publicKey) {
70 return navigator.credentials.create({ publicKey });
71}
72
73function getPubKeyCredParams(signatureAlgorithmsList) {
74 const pubKeyCredParams = [];
75 if (signatureAlgorithmsList.length === 0) {
76 pubKeyCredParams.push({ type: "public-key", alg: -7 });
77 return pubKeyCredParams;
78 }
79
80 for (const entry of signatureAlgorithmsList) {
81 pubKeyCredParams.push({
82 type: "public-key",
83 alg: entry,
84 });
85 }
86
87 return pubKeyCredParams;
88}
89
90function getExcludeCredentials(excludeCredentialIds) {
91 const excludeCredentials = [];
92 if (excludeCredentialIds === "") {
93 return excludeCredentials;
94 }
95
96 for (const entry of excludeCredentialIds.split(",")) {
97 excludeCredentials.push({
98 type: "public-key",
99 id: base64url.parse(entry, { loose: true }),
100 });
101 }
102
103 return excludeCredentials;
104}
105
106function getTransportsAsString(transportsList) {
107 if (!Array.isArray(transportsList)) {
108 return "";
109 }
110
111 return transportsList.join();
112}
113
114function returnSuccess(result, initLabel, initLabelPrompt) {
115 document.getElementById("clientDataJSON").value = base64url.stringify(
116 new Uint8Array(result.response.clientDataJSON),
117 { pad: false },
118 );
119 document.getElementById("attestationObject").value = base64url.stringify(
120 new Uint8Array(result.response.attestationObject),
121 { pad: false },
122 );
123 document.getElementById("publicKeyCredentialId").value = base64url.stringify(
124 new Uint8Array(result.rawId),
125 { pad: false },
126 );
127
128 if (typeof result.response.getTransports === "function") {
129 const transports = result.response.getTransports();
130 if (transports) {
131 document.getElementById("transports").value = getTransportsAsString(
132 transports,
133 );
134 }
135 } else {
136 console.log(
137 "Your browser is not able to recognize supported transport media for the authenticator.",
138 );
139 }
140
141 // let labelResult = window.prompt(initLabelPrompt, initLabel);
142 // if (labelResult === null) {
143 // labelResult = initLabel;
144 // }
145 document.getElementById("authenticatorLabel").value = "Passkey " +
146 new Date().toString();
147
148 document.getElementById("register").requestSubmit();
149}
150
151function returnFailure(err) {
152 if (err.name === "NotAllowedError") {
153 document.getElementById("error").value =
154 "the operation was cancelled / browser does not support passkey";
155 } else {
156 document.getElementById("error").value = err;
157 }
158 document.getElementById("register").requestSubmit();
159}
service/keycloak/theme/login/template.ftl deleted-209
...@@ -1,209 +0,0 @@
1<#import "footer.ftl" as loginFooter>
2<#macro registrationLayout bodyClass="" displayInfo=false displayMessage=true displayRequiredFields=false>
3<!DOCTYPE html>
4<html class="${properties.kcHtmlClass!}" lang="${lang}"<#if realm.internationalizationEnabled> dir="${(locale.rtl)?then('rtl','ltr')}"</#if>>
5
6<head>
7 <meta charset="utf-8">
8 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
9 <meta name="viewport" content="width=device-width, initial-scale=1.0">
10
11 <#if properties.meta?has_content>
12 <#list properties.meta?split(' ') as meta>
13 <meta name="${meta?split('==')[0]}" content="${meta?split('==')[1]}"/>
14 </#list>
15 </#if>
16 <title>sso (snow sign on)</title>
17 <link rel="icon" href="${url.resourcesPath}/img/favicon.ico" />
18 <#if properties.stylesCommon?has_content>
19 <#list properties.stylesCommon?split(' ') as style>
20 <link href="${url.resourcesCommonPath}/${style}" rel="stylesheet" />
21 </#list>
22 </#if>
23 <#if properties.styles?has_content>
24 <#list properties.styles?split(' ') as style>
25 <link href="${url.resourcesPath}/${style}" rel="stylesheet" />
26 </#list>
27 </#if>
28 <#if properties.scripts?has_content>
29 <#list properties.scripts?split(' ') as script>
30 <script src="${url.resourcesPath}/${script}" type="text/javascript"></script>
31 </#list>
32 </#if>
33 <script type="importmap">
34 {
35 "imports": {
36 "rfc4648": "${url.resourcesCommonPath}/vendor/rfc4648/rfc4648.js"
37 }
38 }
39 </script>
40 <script src="${url.resourcesPath}/js/menu-button-links.js" type="module"></script>
41 <#if scripts??>
42 <#list scripts as script>
43 <script src="${script}" type="text/javascript"></script>
44 </#list>
45 </#if>
46 <script type="module">
47 import { startSessionPolling } from "${url.resourcesPath}/js/authChecker.js";
48
49 startSessionPolling(
50 "${url.ssoLoginInOtherTabsUrl?no_esc}"
51 );
52 </script>
53 <script type="module">
54 document.addEventListener("click", (event) => {
55 const link = event.target.closest("a[data-once-link]");
56
57 if (!link) {
58 return;
59 }
60
61 if (link.getAttribute("aria-disabled") === "true") {
62 event.preventDefault();
63 return;
64 }
65
66 const { disabledClass } = link.dataset;
67
68 if (disabledClass) {
69 link.classList.add(...disabledClass.trim().split(/\s+/));
70 }
71
72 link.setAttribute("role", "link");
73 link.setAttribute("aria-disabled", "true");
74 });
75 </script>
76 <#if authenticationSession??>
77 <script type="module">
78 import { checkAuthSession } from "${url.resourcesPath}/js/authChecker.js";
79
80 checkAuthSession(
81 "${authenticationSession.authSessionIdHash}"
82 );
83 </script>
84 </#if>
85</head>
86
87<body class="${properties.kcBodyClass!}" data-page-id="login-${pageId}">
88<div class="${properties.kcLoginClass!}">
89 <div id="kc-header" class="${properties.kcHeaderClass!}">
90 <div id="kc-header-wrapper"
91 class="${properties.kcHeaderWrapperClass!}">${kcSanitize(msg("loginTitleHtml",(realm.displayNameHtml!'')))?no_esc}</div>
92 </div>
93 <div class="${properties.kcFormCardClass!}">
94 <header class="${properties.kcFormHeaderClass!}">
95 <#if realm.internationalizationEnabled && locale.supported?size gt 1>
96 <div class="${properties.kcLocaleMainClass!}" id="kc-locale">
97 <div id="kc-locale-wrapper" class="${properties.kcLocaleWrapperClass!}">
98 <div id="kc-locale-dropdown" class="menu-button-links ${properties.kcLocaleDropDownClass!}">
99 <button tabindex="1" id="kc-current-locale-link" aria-label="${msg("languages")}" aria-haspopup="true" aria-expanded="false" aria-controls="language-switch1">${locale.current}</button>
100 <ul role="menu" tabindex="-1" aria-labelledby="kc-current-locale-link" aria-activedescendant="" id="language-switch1" class="${properties.kcLocaleListClass!}">
101 <#assign i = 1>
102 <#list locale.supported as l>
103 <li class="${properties.kcLocaleListItemClass!}" role="none">
104 <a role="menuitem" id="language-${i}" class="${properties.kcLocaleItemClass!}" href="${l.url}">${l.label}</a>
105 </li>
106 <#assign i++>
107 </#list>
108 </ul>
109 </div>
110 </div>
111 </div>
112 </#if>
113 <#if !(auth?has_content && auth.showUsername() && !auth.showResetCredentials())>
114 <#if displayRequiredFields>
115 <div class="${properties.kcContentWrapperClass!}">
116 <div class="${properties.kcLabelWrapperClass!} subtitle">
117 <span class="subtitle"><span class="required">*</span> ${msg("requiredFields")}</span>
118 </div>
119 <div class="col-md-10">
120 <h1 id="kc-page-title"><#nested "header"></h1>
121 </div>
122 </div>
123 <#else>
124 <h1 id="kc-page-title"><#nested "header"></h1>
125 </#if>
126 <#else>
127 <#if displayRequiredFields>
128 <div class="${properties.kcContentWrapperClass!}">
129 <div class="${properties.kcLabelWrapperClass!} subtitle">
130 <span class="subtitle"><span class="required">*</span> ${msg("requiredFields")}</span>
131 </div>
132 <div class="col-md-10">
133 <#nested "show-username">
134 <div id="kc-username" class="${properties.kcFormGroupClass!}">
135 <label id="kc-attempted-username">${auth.attemptedUsername}</label>
136 <a id="reset-login" href="${url.loginRestartFlowUrl}" aria-label="${msg("restartLoginTooltip")}">
137 <div class="kc-login-tooltip">
138 <i class="${properties.kcResetFlowIcon!}"></i>
139 <span class="kc-tooltip-text">${msg("restartLoginTooltip")}</span>
140 </div>
141 </a>
142 </div>
143 </div>
144 </div>
145 <#else>
146 <#nested "show-username">
147 <div id="kc-username" class="${properties.kcFormGroupClass!}">
148 <label id="kc-attempted-username">${auth.attemptedUsername}</label>
149 <a id="reset-login" href="${url.loginRestartFlowUrl}" aria-label="${msg("restartLoginTooltip")}">
150 <div class="kc-login-tooltip">
151 <i class="${properties.kcResetFlowIcon!}"></i>
152 <span class="kc-tooltip-text">${msg("restartLoginTooltip")}</span>
153 </div>
154 </a>
155 </div>
156 </#if>
157 </#if>
158 </header>
159 <div id="kc-content">
160 <div id="kc-content-wrapper">
161
162 <#-- App-initiated actions should not see warning messages about the need to complete the action -->
163 <#-- during login. -->
164 <#if displayMessage && message?has_content && (message.type != 'warning' || !isAppInitiatedAction??)>
165 <div class="alert-${message.type} ${properties.kcAlertClass!} pf-m-<#if message.type = 'error'>danger<#else>${message.type}</#if>">
166 <div class="pf-c-alert__icon">
167 <#if message.type = 'success'><span class="${properties.kcFeedbackSuccessIcon!}"></span></#if>
168 <#if message.type = 'warning'><span class="${properties.kcFeedbackWarningIcon!}"></span></#if>
169 <#if message.type = 'error'><span class="${properties.kcFeedbackErrorIcon!}"></span></#if>
170 <#if message.type = 'info'><span class="${properties.kcFeedbackInfoIcon!}"></span></#if>
171 </div>
172 <span class="${properties.kcAlertTitleClass!}">${kcSanitize(message.summary)?no_esc}</span>
173 </div>
174 </#if>
175
176 <#nested "form">
177
178 <#if auth?has_content && auth.showTryAnotherWayLink()>
179 <form id="kc-select-try-another-way-form" action="${url.loginAction}" method="post">
180 <div class="${properties.kcFormGroupClass!}">
181 <input type="hidden" name="tryAnotherWay" value="on"/>
182 <a href="#" id="try-another-way"
183 onclick="document.forms['kc-select-try-another-way-form'].requestSubmit();return false;">${msg("doTryAnotherWay")}</a>
184 </div>
185 </form>
186 </#if>
187
188 <#nested "socialProviders">
189
190 <#if displayInfo>
191 <div id="kc-info" class="${properties.kcSignUpClass!}">
192 <div id="kc-info-wrapper" class="${properties.kcInfoAreaWrapperClass!}">
193 <#nested "info">
194 </div>
195 </div>
196 </#if>
197 </div>
198 </div>
199
200
201 <@loginFooter.content/>
202 </div>
203 </div>
204 <div id='credit'>
205 <a rel="noopener noreferrer" target="_blank" href="https://www.pixiv.net/en/artworks/109102745">art by 紺屋</a>
206 </div>
207</body>
208</html>
209</#macro>
service/keycloak/theme/login/theme.properties deleted-128
...@@ -1,128 +0,0 @@
1parent=base
2import=common/keycloak
3
4styles=css/styles.css
5stylesCommon=
6
7darkMode=false
8
9kcFormGroupClass=pf-v5-c-form__group
10kcFormGroupLabelClass=pf-v5-c-form__group-label pf-v5-u-pb-xs
11kcFormLabelClass=pf-v5-c-form__label
12kcFormLabelTextClass=pf-v5-c-form__label-text
13
14kcLabelClass=pf-v5-c-form__label
15kcInputClass=pf-v5-c-form-control
16kcInputGroup=pf-v5-c-input-group
17kcFormHelperTextClass=pf-v5-c-form__helper-text
18kcInputHelperTextClass=pf-v5-c-helper-text pf-v5-u-display-flex pf-v5-u-justify-content-space-between
19kcInputHelperTextItemClass=pf-v5-c-helper-text__item
20kcInputHelperTextItemTextClass=pf-v5-c-helper-text__item-text
21kcInputGroupItemClass=pf-v5-c-input-group__item
22kcFill=pf-m-fill
23kcError=pf-m-error
24kcLoginFooterBand=pf-v5-c-login__main-footer-band
25kcLoginFooterBandItem=pf-v5-c-login__main-footer-band-item
26
27kcCheckboxClass=pf-v5-c-check
28kcCheckboxInputClass=pf-v5-c-check__input
29kcCheckboxLabelClass=pf-v5-c-check__label
30kcCheckboxLabelRequiredClass=pf-v5-c-check__label-required
31
32kcInputRequiredClass=pf-v5-c-form__label-required
33kcInputErrorMessageClass=pf-v5-c-helper-text__item-text pf-m-error kc-feedback-text
34kcFormControlUtilClass=pf-v5-c-form-control__utilities
35kcInputErrorIconStatusClass=pf-v5-c-form-control__icon pf-m-status
36kcInputErrorIconClass=fas fa-exclamation-circle
37kcAlertClass=pf-v5-c-alert pf-m-inline pf-v5-u-mb-md
38kcAlertIconClass=pf-v5-c-alert__icon
39kcAlertTitleClass=pf-v5-c-alert__title
40kcAlertDescriptionClass=pf-v5-c-alert__description
41kcFormPasswordVisibilityButtonClass=pf-v5-c-button pf-m-control
42kcFormControlToggleIcon=pf-v5-c-form-control__toggle-icon
43kcFormActionGroupClass=pf-v5-c-form__actions pf-v5-u-pt-xs
44kcFormReadOnlyClass=pf-m-readonly
45
46kcPanelClass=pf-v5-c-panel pf-m-raised
47kcPanelMainClass=pf-v5-c-panel__main
48kcPanelMainBodyClass=pf-v5-c-panel__main-body
49kcListClass=pf-v5-c-list
50
51kcButtonClass=pf-v5-c-button
52kcButtonPrimaryClass=pf-v5-c-button pf-m-primary
53kcButtonSecondaryClass=pf-v5-c-button pf-m-secondary
54kcButtonBlockClass=pf-m-block
55kcButtonLinkClass=pf-v5-c-button pf-m-link
56kcCommonLogoIdP=pf-v5-c-login__main-footer-links-item
57kcFormSocialAccountListClass=pf-v5-c-login__main-body pf-v5-u-pl-0 pf-v5-u-pr-0
58kcFormSocialAccountListItemClass=pf-v5-u-pb-sm
59kcFormSocialAccountNameClass=pf-v5-u-m-auto
60kcFormSocialAccountListButtonClass=pf-v5-c-button pf-m-secondary pf-m-block pf-v5-u-display-flex pf-v5-u-align-items-center pf-v5-u-justify-content-space-between
61kcFormSocialAccountListButtonDisabledClass=pf-m-aria-disabled
62kcFormSocialAccountListGridClass=pf-v5-l-grid pf-m-gutter pf-m-all-6-col-on-xl pf-m-all-6-col-on-sm
63kcFormSocialAccountGridItem=pf-v5-l-grid__item
64
65kcLoginClass=pf-v5-c-login__main
66kcFormClass=pf-v5-c-form pf-v5-u-w-100
67kcFormCardClass=card-pf
68
69kcResetFlowIcon=pf-icon fas fa-share-square
70
71kcSelectAuthListClass=pf-v5-c-data-list select-auth-container
72kcSelectAuthListItemWrapperClass=pf-v5-c-data-list__item pf-m-clickable
73kcSelectAuthListItemClass=pf-v5-c-data-list__item-row select-auth-box-parent
74kcSelectAuthListItemHeadingClass=pf-v5-u-font-family-heading select-auth-box-headline
75kcSelectAuthListItemBodyClass=pf-v5-c-data-list__cell pf-m-no-fill pf-v5-u-pt-md pf-v5-u-pb-md
76kcSelectAuthListItemIconClass=pf-v5-c-data-list__cell pf-m-icon pf-v5-u-display-flex pf-v5-u-pt-0 pf-v5-u-align-items-center
77kcSelectAuthListItemFillClass=pf-v5-c-data-list__item-action
78kcSelectAuthListItemDescriptionClass=pf-v5-c-data-list__cell pf-m-no-fill select-auth-box-desc
79
80kcRecoveryCodesWarning=pf-v5-c-alert pf-m-warning pf-m-inline pf-v5-u-mb-md kc-recovery-codes-warning
81kcLogin=pf-v5-c-login
82kcLoginContainer=pf-v5-c-login__container
83kcLoginMain=pf-v5-c-login__main
84kcLoginMainHeader=pf-v5-c-login__main-header
85kcLoginMainFooter=pf-v5-c-login__main-footer
86kcLoginMainFooterBand=pf-v5-c-login__main-footer-band
87kcLoginMainFooterBandItem=pf-v5-c-login__main-footer-band-item
88kcLoginMainFooterHelperText=pf-v5-u-font-size-sm pf-v5-u-color-200
89kcLoginMainTitle=pf-v5-c-title pf-m-3xl
90kcLoginMainHeaderUtilities=pf-v5-c-login__main-header-utilities
91kcLoginMainBody=pf-v5-c-login__main-body
92
93kcContentWrapperClass=pf-v5-u-mb-md-on-md
94kcWebAuthnDefaultIcon=pf-v5-c-icon pf-m-lg
95kcMarginTopClass=pf-v5-u-mt-md-on-md
96
97kcLoginOTPListClass=pf-v5-c-tile
98kcLoginOTPListItemHeaderClass=pf-v5-c-tile__header pf-m-stacked
99kcLoginOTPListItemIconBodyClass=pf-v5-c-tile__icon
100kcLoginOTPListItemIconClass=fa fa-mobile
101kcLoginOTPListItemTitleClass=pf-v5-c-tile__title
102kcLoginOTPListSelectedClass=pf-m-selected
103
104kcCopyIconClass=fas fa-copy
105kcCheckIconClass=fas fa-check
106kcAngleRightIconClass=fas fa-angle-right
107kcAngleDownIconClass=fas fa-angle-down
108kcExpandedClass=pf-m-expanded
109
110kcCodeClipboardCopyClass=pf-v5-c-clipboard-copy
111kcCodeClipboardCopyGroupClass=pf-v5-c-clipboard-copy__group
112kcCodeClipboardCopyContentClass=pf-v5-c-clipboard-copy__expandable-content
113
114kcDarkModeClass=pf-v5-theme-dark
115
116kcHtmlClass=login-pf
117kcLogoIdP-facebook=
118kcLogoIdP-google=
119kcLogoIdP-github=
120kcLogoIdP-linkedin=
121kcLogoIdP-instagram=
122kcLogoIdP-microsoft=
123kcLogoIdP-bitbucket=
124kcLogoIdP-gitlab=
125kcLogoIdP-paypal=
126kcLogoIdP-stackoverflow=
127kcLogoIdP-twitter=
128kcLogoIdP-openshift-v4=
service/keycloak/theme/login/webauthn-error.ftl deleted-36
...@@ -1,36 +0,0 @@
1<#import "template.ftl" as layout>
2<@layout.registrationLayout displayMessage=true; section>
3 <#if section = "header">
4 ${kcSanitize(msg("webauthn-error-title"))?no_esc}
5 <#elseif section = "form">
6
7 <script type="text/javascript">
8 refreshPage = () => {
9 document.getElementById('isSetRetry').value = 'retry';
10 document.getElementById('executionValue').value = '${execution}';
11 document.getElementById('kc-error-credential-form').requestSubmit();
12 }
13 </script>
14
15 <form id="kc-error-credential-form" class="${properties.kcFormClass!}" action="${url.loginAction}"
16 method="post">
17 <input type="hidden" id="executionValue" name="authenticationExecution"/>
18 <input type="hidden" id="isSetRetry" name="isSetRetry"/>
19 </form>
20
21 <input tabindex="4" onclick="refreshPage()" type="button"
22 class="${properties.kcButtonClass!} ${properties.kcButtonPrimaryClass!} ${properties.kcButtonBlockClass!} ${properties.kcButtonLargeClass!}"
23 name="try-again" id="kc-try-again" value="${kcSanitize(msg("doTryAgain"))?no_esc}"
24 />
25
26 <#if isAppInitiatedAction??>
27 <form action="${url.loginAction}" class="${properties.kcFormClass!}" id="kc-webauthn-settings-form" method="post">
28 <button type="submit"
29 class="${properties.kcButtonClass!} ${properties.kcButtonDefaultClass!} ${properties.kcButtonBlockClass!} ${properties.kcButtonLargeClass!}"
30 id="cancelWebAuthnAIA" name="cancel-aia" value="true">${msg("doCancel")}
31 </button>
32 </form>
33 </#if>
34
35 </#if>
36</@layout.registrationLayout>
\ No newline at end of file
service/keycloak/theme/login/webauthn-register.ftl deleted-72
...@@ -1,72 +0,0 @@
1<#import "template.ftl" as layout>
2<#import "password-commons.ftl" as passwordCommons>
3
4<@layout.registrationLayout; section>
5 <#if section = "title">
6 title
7 <#elseif section = "header">
8 <div class="alert-info pf-v5-c-alert pf-m-inline pf-v5-u-mb-md pf-m-danger">
9 <div class="pf-c-alert__icon">
10 <span class=""></span>
11 </div>
12 <span class="pf-v5-c-alert__title">
13 you will be prompted to create a passkey. please contact clover if
14 this doesn't work in your browser.
15 </span>
16 </div>
17 <#elseif section = "form">
18
19 <form id="register" class="${properties.kcFormClass!}" action="${url.loginAction}" method="post">
20 <div class="${properties.kcFormGroupClass!}">
21 <input type="hidden" id="clientDataJSON" name="clientDataJSON"/>
22 <input type="hidden" id="attestationObject" name="attestationObject"/>
23 <input type="hidden" id="publicKeyCredentialId" name="publicKeyCredentialId"/>
24 <input type="hidden" id="authenticatorLabel" name="authenticatorLabel"/>
25 <input type="hidden" id="transports" name="transports"/>
26 <input type="hidden" id="error" name="error"/>
27 </div>
28 </form>
29
30 <script type="module">
31 import { registerByWebAuthn } from "${url.resourcesPath}/js/webauthnRegister.js";
32 function init() {
33 const input = {
34 challenge : '${challenge}',
35 userid : '${userid}',
36 username : '${username}',
37 signatureAlgorithms : [<#list signatureAlgorithms as sigAlg>${sigAlg?c},</#list>],
38 rpEntityName : '${rpEntityName}',
39 rpId : '${rpId}',
40 attestationConveyancePreference : '${attestationConveyancePreference}',
41 authenticatorAttachment : '${authenticatorAttachment}',
42 requireResidentKey : '${requireResidentKey}',
43 userVerificationRequirement : '${userVerificationRequirement}',
44 createTimeout : ${createTimeout?c},
45 excludeCredentialIds : '${excludeCredentialIds}',
46 initLabel : "${msg("webauthn-registration-init-label")?no_esc}",
47 initLabelPrompt : "${msg("webauthn-registration-init-label-prompt")?no_esc}",
48 errmsg : "${msg("webauthn-unsupported-browser-text")?no_esc}"
49 };
50 registerByWebAuthn(input);
51 }
52 init();
53 </script>
54
55<!--
56 <input type="submit"
57 class="${properties.kcButtonClass!} ${properties.kcButtonPrimaryClass!} ${properties.kcButtonBlockClass!} ${properties.kcButtonLargeClass!}"
58 id="registerWebAuthn" value="${msg("doRegisterSecurityKey")}"/>
59-->
60
61 <#if !isSetRetry?has_content && isAppInitiatedAction?has_content>
62 <form action="${url.loginAction}" class="${properties.kcFormClass!}" id="kc-webauthn-settings-form"
63 method="post">
64 <button type="submit"
65 class="${properties.kcButtonClass!} ${properties.kcButtonDefaultClass!} ${properties.kcButtonBlockClass!} ${properties.kcButtonLargeClass!}"
66 id="cancelWebAuthnAIA" name="cancel-aia" value="true">${msg("doCancel")}
67 </button>
68 </form>
69 </#if>
70
71 </#if>
72</@layout.registrationLayout>
service/knife/prepare.py+1-1
...@@ -14,7 +14,7 @@ import uuid...@@ -14,7 +14,7 @@ import uuid
1414
15bundle = json.loads(Path(__file__).with_name("bundle.json").read_text())15bundle = json.loads(Path(__file__).with_name("bundle.json").read_text())
16if subprocess.run(["podman", "image", "exists", bundle["image"]]).returncode:16if subprocess.run(["podman", "image", "exists", bundle["image"]]).returncode:
17 with tempfile.TemporaryDirectory(prefix="studio-knife-") as temporary:17 with tempfile.TemporaryDirectory(prefix="snowglobe-knife-") as temporary:
18 archive = Path(temporary) / "bundle.tar.gz"18 archive = Path(temporary) / "bundle.tar.gz"
19 digest = hashlib.sha256()19 digest = hashlib.sha256()
20 with urllib.request.urlopen(bundle["url"], timeout=120) as source, archive.open("wb") as target:20 with urllib.request.urlopen(bundle["url"], timeout=120) as source, archive.open("wb") as target:
service/knife/service.pkl+3-2
...@@ -5,11 +5,12 @@ import "../../config/OpenID.pkl" as sso...@@ -5,11 +5,12 @@ import "../../config/OpenID.pkl" as sso
55
6local bundle = (new json.Parser {}).parse(read("bundle.json"))6local bundle = (new json.Parser {}).parse(read("bundle.json"))
77
8meta { name = "The Knife"; access = "infra-admin" }8name = "The Knife"
9access = "infra-admin"
9requirements {10requirements {
10 new sso.Client {11 new sso.Client {
11 clientId = module.id12 clientId = module.id
12 name = module.meta.name13 name = module.name
13 redirectUris { "https://\(module.container.http.hostname)/api/auth/oidc/callback" }14 redirectUris { "https://\(module.container.http.hostname)/api/auth/oidc/callback" }
14 }15 }
15}16}
service/local-ai/Dockerfile+3-3
...@@ -24,10 +24,10 @@ RUN python3.12 /tmp/model-source/download.py --runtime-only --root /tmp/runtime...@@ -24,10 +24,10 @@ RUN python3.12 /tmp/model-source/download.py --runtime-only --root /tmp/runtime
24RUN set -e; SP=$(venv/bin/python -c 'import vllm,os; print(os.path.dirname(vllm.__file__))' | tail -n1); \24RUN set -e; SP=$(venv/bin/python -c 'import vllm,os; print(os.path.dirname(vllm.__file__))' | tail -n1); \
25 for p in patches/*.patch; do patch --batch -p1 -d "$SP" < "$p"; done; \25 for p in patches/*.patch; do patch --batch -p1 -d "$SP" < "$p"; done; \
26 bash verify.sh --install26 bash verify.sh --install
27COPY cache /tmp/studio-ai-cache27COPY cache /tmp/snowglobe-ai-cache
28RUN venv/bin/pip install /tmp/studio-ai-cache && venv/bin/pip check && rm -rf /tmp/studio-ai-cache28RUN venv/bin/pip install /tmp/snowglobe-ai-cache && venv/bin/pip check && rm -rf /tmp/snowglobe-ai-cache
29ENV HOME=/cache VLLM_NO_USAGE_STATS=1 DO_NOT_TRACK=1 HF_HUB_OFFLINE=129ENV HOME=/cache VLLM_NO_USAGE_STATS=1 DO_NOT_TRACK=1 HF_HUB_OFFLINE=1
30RUN mkdir -p /cache && chmod 1777 /cache30RUN mkdir -p /cache && chmod 1777 /cache
31COPY steering /app/steering31COPY steering /app/steering
32RUN patch --batch -p1 -d /app/venv/lib/python3.12/site-packages/vllm < /app/steering/runtime.patch32RUN patch --batch -p1 -d /app/venv/lib/python3.12/site-packages/vllm < /app/steering/runtime.patch
33ENV PYTHONPATH=/app/steering STUDIO_STEERING_DIR=/app/steering33ENV PYTHONPATH=/app/steering SNOWGLOBE_STEERING_DIR=/app/steering
service/local-ai/cache/pyproject.toml+3-3
...@@ -3,12 +3,12 @@ requires = ["setuptools"]...@@ -3,12 +3,12 @@ requires = ["setuptools"]
3build-backend = "setuptools.build_meta"3build-backend = "setuptools.build_meta"
44
5[project]5[project]
6name = "studio-ai-cache"6name = "snowglobe-ai-cache"
7version = "1.0.0"7version = "1.0.0"
8dependencies = ["cryptography==50.0.2"]8dependencies = ["cryptography==50.0.2"]
99
10[project.entry-points."vllm.general_plugins"]10[project.entry-points."vllm.general_plugins"]
11studio_ai_cache = "studio_ai_cache_vllm:register"11snowglobe_ai_cache = "snowglobe_ai_cache_vllm:register"
1212
13[tool.setuptools]13[tool.setuptools]
14py-modules = ["studio_ai_cache", "studio_ai_cache_vllm"]14py-modules = ["snowglobe_ai_cache", "snowglobe_ai_cache_vllm"]
service/local-ai/cache/snowglobe_ai_cache.py created+186
...@@ -0,0 +1,186 @@
1"""Bounded, authenticated disk caches with SSD promotion and request pinning."""
2from collections import OrderedDict
3import fcntl
4import logging
5import mmap
6import os
7from pathlib import Path
8import struct
9import threading
10
11from cryptography.exceptions import InvalidTag
12from cryptography.hazmat.primitives.ciphers.aead import AESGCM
13
14
15class DiskCache:
16 def __init__(self, ssd, hdd, ssd_bytes, hdd_bytes, key):
17 if min(ssd_bytes, hdd_bytes) <= 0:
18 raise ValueError("Disk cache capacities must be positive")
19 self.cipher = AESGCM(key)
20 self.roots = (Path(ssd), Path(hdd))
21 if (self.roots[0].resolve().is_relative_to(self.roots[1].resolve())
22 or self.roots[1].resolve().is_relative_to(self.roots[0].resolve())):
23 raise ValueError("Disk cache directories must be distinct")
24 self.limits = (ssd_bytes, hdd_bytes)
25 self.lock = threading.Lock()
26 self.writers = (threading.Lock(), threading.Lock())
27 self.entries = (OrderedDict(), OrderedDict())
28 self.pins = {}
29 self.files = []
30 try:
31 for tier, root in enumerate(self.roots):
32 root.mkdir(mode=0o700, parents=True, exist_ok=True)
33 root.chmod(0o700)
34 descriptor = os.open(root / ".lock", os.O_CREAT | os.O_RDWR, 0o600)
35 self.files.append(descriptor)
36 fcntl.flock(descriptor, fcntl.LOCK_EX | fcntl.LOCK_NB)
37 for path in root.rglob("*.pending"):
38 path.unlink()
39 inventory = sorted((path.stat().st_mtime_ns, path) for path in root.rglob("*.bin"))
40 for _, path in inventory:
41 self.entries[tier][str(path.relative_to(root))] = path.stat().st_size
42 self._evict(tier, 0)
43 except Exception:
44 self.close()
45 raise
46
47 def close(self):
48 for descriptor in self.files:
49 os.close(descriptor)
50 self.files.clear()
51
52 def acquire(self, name, request):
53 with self.lock:
54 for entries in self.entries:
55 if name in entries:
56 entries.move_to_end(name)
57 self.pins.setdefault(name, set()).add(request)
58 return True
59 return False
60
61 def release(self, request):
62 with self.lock:
63 for name, requests in list(self.pins.items()):
64 requests.discard(request)
65 if not requests:
66 del self.pins[name]
67
68 def touch(self, name):
69 with self.lock:
70 for entries in self.entries:
71 if name in entries:
72 entries.move_to_end(name)
73 break
74
75 def _evict(self, tier, needed):
76 removed = []
77 with self.lock:
78 entries = self.entries[tier]
79 size = sum(entries.values())
80 for name in list(entries):
81 if size + needed <= self.limits[tier]:
82 break
83 if name not in self.pins:
84 size -= entries.pop(name)
85 removed.append(self.roots[tier] / name)
86 for path in removed:
87 self._unlink(tier, path)
88 return size + needed <= self.limits[tier]
89
90 def _unlink(self, tier, path):
91 path.unlink(missing_ok=True)
92 parent = path.parent
93 while parent != self.roots[tier]:
94 try:
95 parent.rmdir()
96 except OSError:
97 break
98 parent = parent.parent
99
100 def _put(self, tier, name, buffer):
101 path = self.roots[tier] / name
102 with self.writers[tier]:
103 with self.lock:
104 if name in self.entries[tier]:
105 self.entries[tier].move_to_end(name)
106 present = True
107 else:
108 present = False
109 if present:
110 os.utime(path, None)
111 return
112 if len(buffer) > self.limits[tier] or not self._evict(tier, len(buffer)):
113 return
114 path.parent.mkdir(mode=0o700, parents=True, exist_ok=True)
115 pending = path.with_suffix(".pending")
116 try:
117 descriptor = os.open(pending, os.O_CREAT | os.O_EXCL | os.O_WRONLY | getattr(os, "O_DIRECT", 0), 0o600)
118 try:
119 if os.write(descriptor, buffer) != len(buffer):
120 raise OSError("Short cache write")
121 os.fsync(descriptor)
122 finally:
123 os.close(descriptor)
124 pending.replace(path)
125 with self.lock:
126 self.entries[tier][name] = len(buffer)
127 finally:
128 pending.unlink(missing_ok=True)
129
130 def store(self, name, data):
131 # Page-aligned ciphertext keeps direct I/O on both ext4 and ZFS.
132 size = (len(data) + 36 + mmap.PAGESIZE - 1) // mmap.PAGESIZE * mmap.PAGESIZE
133 with mmap.mmap(-1, size) as buffer:
134 nonce = os.urandom(12)
135 buffer[:20] = struct.pack("!Q", len(data)) + nonce
136 view = memoryview(buffer)[20:20 + len(data) + 16]
137 try:
138 self.cipher.encrypt_into(nonce, data, name.encode(), view)
139 finally:
140 view.release()
141 self._put(1, name, buffer)
142 self._put(0, name, buffer)
143
144 def load(self, name, target):
145 pin = object()
146 if not self.acquire(name, pin):
147 raise FileNotFoundError("Cache block was evicted")
148 try:
149 for tier, root in enumerate(self.roots):
150 path = root / name
151 with self.lock:
152 size = self.entries[tier].get(name)
153 if size is None:
154 continue
155 try:
156 with mmap.mmap(-1, size) as buffer:
157 descriptor = os.open(path, os.O_RDONLY | getattr(os, "O_DIRECT", 0))
158 try:
159 if os.readv(descriptor, [buffer]) != size:
160 raise OSError("Short cache read")
161 finally:
162 os.close(descriptor)
163 if struct.unpack("!Q", buffer[:8])[0] != len(target):
164 raise ValueError("Cache block size mismatch")
165 view = memoryview(buffer)[20:20 + len(target) + 16]
166 try:
167 self.cipher.decrypt_into(buffer[8:20], view, name.encode(), target)
168 finally:
169 view.release()
170 with self.lock:
171 self.entries[tier].move_to_end(name)
172 os.utime(path, None)
173 if tier == 1:
174 try:
175 self._put(0, name, buffer)
176 except OSError:
177 logging.getLogger(__name__).warning("SSD cache promotion failed", exc_info=True)
178 return "ssd" if tier == 0 else "hdd"
179 except (OSError, ValueError, struct.error, InvalidTag):
180 with self.writers[tier]:
181 with self.lock:
182 self.entries[tier].pop(name, None)
183 self._unlink(tier, path)
184 raise FileNotFoundError("No authenticated cache block remains")
185 finally:
186 self.release(pin)
service/local-ai/cache/snowglobe_ai_cache_vllm.py created+73
...@@ -0,0 +1,73 @@
1"""vLLM secondary tier for the bounded SSD/HDD cache."""
2import functools
3import hashlib
4import os
5from pathlib import Path
6
7import vllm
8from vllm.v1.kv_offload.base import LookupResult, Medium
9from vllm.v1.kv_offload.file_mapper import FileMapper
10from vllm.v1.kv_offload.tiering.base import JobResult, RequestOffloadingContext, SecondaryTierManager
11from vllm.v1.kv_offload.tiering.factory import SecondaryTierFactory
12from vllm.v1.kv_offload.tiering.fs.thread_pool import DualQueueThreadPool
13
14from snowglobe_ai_cache import DiskCache
15
16
17class DiskTier(SecondaryTierManager):
18 medium = Medium.STORAGE
19
20 def __init__(self, offloading_spec, primary_kv_view, tier_type, ssd_dir, hdd_dir, ssd_bytes, hdd_bytes):
21 super().__init__(offloading_spec, primary_kv_view, tier_type)
22 key = hashlib.sha256(os.environ["SNOWGLOBE_AI_CACHE_KEY"].encode()).digest()
23 namespace = hashlib.sha256(
24 Path("/models/manifest.json").read_bytes() + vllm.__version__.encode()
25 + Path(__file__).read_bytes() + Path(__file__).with_name("snowglobe_ai_cache.py").read_bytes() + key
26 ).hexdigest()
27 self.mapper = FileMapper.from_offloading_spec(namespace, offloading_spec, offloading_spec.blocks_per_chunk)
28 self.cache = DiskCache(ssd_dir, hdd_dir, ssd_bytes, hdd_bytes, key)
29 self.block_size = primary_kv_view.strides[0]
30 self.pool = DualQueueThreadPool(16, 2, thread_name_prefix="snowglobe_kv_disk")
31
32 def on_new_request(self, req_context):
33 return RequestOffloadingContext()
34
35 def lookup(self, key, req_context):
36 return LookupResult.HIT if self.cache.acquire(self.mapper.get_file_name(key), req_context.req_id) else LookupResult.MISS
37
38 def submit_store(self, job_metadata):
39 tasks = [functools.partial(self._transfer, self.cache.store, key, block_id)
40 for key, block_id in zip(job_metadata.keys, job_metadata.block_ids, strict=True)]
41 self.pool.enqueue_store(job_metadata.job_id, len(tasks), tasks)
42
43 def submit_load(self, job_metadata):
44 tasks = [functools.partial(self._transfer, self.cache.load, key, block_id)
45 for key, block_id in zip(job_metadata.keys, job_metadata.block_ids, strict=True)]
46 self.pool.enqueue_load(job_metadata.job_id, len(tasks), tasks)
47
48 def _transfer(self, operation, key, block_id):
49 offset = int(block_id) * self.block_size
50 with self._primary_kv_view.cast("B")[offset:offset + self.block_size] as view:
51 operation(self.mapper.get_file_name(key), view)
52
53 def get_finished_jobs(self):
54 return [JobResult(job_id, success) for job_id, success in self.pool.get_finished()]
55
56 def touch(self, keys, req_context):
57 for key in keys:
58 self.cache.touch(self.mapper.get_file_name(key))
59
60 def on_request_finished(self, req_context):
61 self.cache.release(req_context.req_id)
62
63 def drain_jobs(self):
64 self.pool.wait_idle()
65
66 def shutdown(self):
67 self.pool.wait_idle()
68 self.pool.shutdown(wait=True)
69 self.cache.close()
70
71
72def register():
73 SecondaryTierFactory.register_tier("snowglobe_disk", __name__, "DiskTier")
service/local-ai/cache/studio_ai_cache.py deleted-186
...@@ -1,186 +0,0 @@
1"""Bounded, authenticated disk caches with SSD promotion and request pinning."""
2from collections import OrderedDict
3import fcntl
4import logging
5import mmap
6import os
7from pathlib import Path
8import struct
9import threading
10
11from cryptography.exceptions import InvalidTag
12from cryptography.hazmat.primitives.ciphers.aead import AESGCM
13
14
15class DiskCache:
16 def __init__(self, ssd, hdd, ssd_bytes, hdd_bytes, key):
17 if min(ssd_bytes, hdd_bytes) <= 0:
18 raise ValueError("Disk cache capacities must be positive")
19 self.cipher = AESGCM(key)
20 self.roots = (Path(ssd), Path(hdd))
21 if (self.roots[0].resolve().is_relative_to(self.roots[1].resolve())
22 or self.roots[1].resolve().is_relative_to(self.roots[0].resolve())):
23 raise ValueError("Disk cache directories must be distinct")
24 self.limits = (ssd_bytes, hdd_bytes)
25 self.lock = threading.Lock()
26 self.writers = (threading.Lock(), threading.Lock())
27 self.entries = (OrderedDict(), OrderedDict())
28 self.pins = {}
29 self.files = []
30 try:
31 for tier, root in enumerate(self.roots):
32 root.mkdir(mode=0o700, parents=True, exist_ok=True)
33 root.chmod(0o700)
34 descriptor = os.open(root / ".lock", os.O_CREAT | os.O_RDWR, 0o600)
35 self.files.append(descriptor)
36 fcntl.flock(descriptor, fcntl.LOCK_EX | fcntl.LOCK_NB)
37 for path in root.rglob("*.pending"):
38 path.unlink()
39 inventory = sorted((path.stat().st_mtime_ns, path) for path in root.rglob("*.bin"))
40 for _, path in inventory:
41 self.entries[tier][str(path.relative_to(root))] = path.stat().st_size
42 self._evict(tier, 0)
43 except Exception:
44 self.close()
45 raise
46
47 def close(self):
48 for descriptor in self.files:
49 os.close(descriptor)
50 self.files.clear()
51
52 def acquire(self, name, request):
53 with self.lock:
54 for entries in self.entries:
55 if name in entries:
56 entries.move_to_end(name)
57 self.pins.setdefault(name, set()).add(request)
58 return True
59 return False
60
61 def release(self, request):
62 with self.lock:
63 for name, requests in list(self.pins.items()):
64 requests.discard(request)
65 if not requests:
66 del self.pins[name]
67
68 def touch(self, name):
69 with self.lock:
70 for entries in self.entries:
71 if name in entries:
72 entries.move_to_end(name)
73 break
74
75 def _evict(self, tier, needed):
76 removed = []
77 with self.lock:
78 entries = self.entries[tier]
79 size = sum(entries.values())
80 for name in list(entries):
81 if size + needed <= self.limits[tier]:
82 break
83 if name not in self.pins:
84 size -= entries.pop(name)
85 removed.append(self.roots[tier] / name)
86 for path in removed:
87 self._unlink(tier, path)
88 return size + needed <= self.limits[tier]
89
90 def _unlink(self, tier, path):
91 path.unlink(missing_ok=True)
92 parent = path.parent
93 while parent != self.roots[tier]:
94 try:
95 parent.rmdir()
96 except OSError:
97 break
98 parent = parent.parent
99
100 def _put(self, tier, name, buffer):
101 path = self.roots[tier] / name
102 with self.writers[tier]:
103 with self.lock:
104 if name in self.entries[tier]:
105 self.entries[tier].move_to_end(name)
106 present = True
107 else:
108 present = False
109 if present:
110 os.utime(path, None)
111 return
112 if len(buffer) > self.limits[tier] or not self._evict(tier, len(buffer)):
113 return
114 path.parent.mkdir(mode=0o700, parents=True, exist_ok=True)
115 pending = path.with_suffix(".pending")
116 try:
117 descriptor = os.open(pending, os.O_CREAT | os.O_EXCL | os.O_WRONLY | getattr(os, "O_DIRECT", 0), 0o600)
118 try:
119 if os.write(descriptor, buffer) != len(buffer):
120 raise OSError("Short cache write")
121 os.fsync(descriptor)
122 finally:
123 os.close(descriptor)
124 pending.replace(path)
125 with self.lock:
126 self.entries[tier][name] = len(buffer)
127 finally:
128 pending.unlink(missing_ok=True)
129
130 def store(self, name, data):
131 # Page-aligned ciphertext keeps direct I/O on both ext4 and ZFS.
132 size = (len(data) + 36 + mmap.PAGESIZE - 1) // mmap.PAGESIZE * mmap.PAGESIZE
133 with mmap.mmap(-1, size) as buffer:
134 nonce = os.urandom(12)
135 buffer[:20] = struct.pack("!Q", len(data)) + nonce
136 view = memoryview(buffer)[20:20 + len(data) + 16]
137 try:
138 self.cipher.encrypt_into(nonce, data, name.encode(), view)
139 finally:
140 view.release()
141 self._put(1, name, buffer)
142 self._put(0, name, buffer)
143
144 def load(self, name, target):
145 pin = object()
146 if not self.acquire(name, pin):
147 raise FileNotFoundError("Cache block was evicted")
148 try:
149 for tier, root in enumerate(self.roots):
150 path = root / name
151 with self.lock:
152 size = self.entries[tier].get(name)
153 if size is None:
154 continue
155 try:
156 with mmap.mmap(-1, size) as buffer:
157 descriptor = os.open(path, os.O_RDONLY | getattr(os, "O_DIRECT", 0))
158 try:
159 if os.readv(descriptor, [buffer]) != size:
160 raise OSError("Short cache read")
161 finally:
162 os.close(descriptor)
163 if struct.unpack("!Q", buffer[:8])[0] != len(target):
164 raise ValueError("Cache block size mismatch")
165 view = memoryview(buffer)[20:20 + len(target) + 16]
166 try:
167 self.cipher.decrypt_into(buffer[8:20], view, name.encode(), target)
168 finally:
169 view.release()
170 with self.lock:
171 self.entries[tier].move_to_end(name)
172 os.utime(path, None)
173 if tier == 1:
174 try:
175 self._put(0, name, buffer)
176 except OSError:
177 logging.getLogger(__name__).warning("SSD cache promotion failed", exc_info=True)
178 return "ssd" if tier == 0 else "hdd"
179 except (OSError, ValueError, struct.error, InvalidTag):
180 with self.writers[tier]:
181 with self.lock:
182 self.entries[tier].pop(name, None)
183 self._unlink(tier, path)
184 raise FileNotFoundError("No authenticated cache block remains")
185 finally:
186 self.release(pin)
service/local-ai/cache/studio_ai_cache_vllm.py deleted-73
...@@ -1,73 +0,0 @@
1"""vLLM secondary tier for the bounded SSD/HDD cache."""
2import functools
3import hashlib
4import os
5from pathlib import Path
6
7import vllm
8from vllm.v1.kv_offload.base import LookupResult, Medium
9from vllm.v1.kv_offload.file_mapper import FileMapper
10from vllm.v1.kv_offload.tiering.base import JobResult, RequestOffloadingContext, SecondaryTierManager
11from vllm.v1.kv_offload.tiering.factory import SecondaryTierFactory
12from vllm.v1.kv_offload.tiering.fs.thread_pool import DualQueueThreadPool
13
14from studio_ai_cache import DiskCache
15
16
17class DiskTier(SecondaryTierManager):
18 medium = Medium.STORAGE
19
20 def __init__(self, offloading_spec, primary_kv_view, tier_type, ssd_dir, hdd_dir, ssd_bytes, hdd_bytes):
21 super().__init__(offloading_spec, primary_kv_view, tier_type)
22 key = hashlib.sha256(os.environ["STUDIO_AI_CACHE_KEY"].encode()).digest()
23 namespace = hashlib.sha256(
24 Path("/models/manifest.json").read_bytes() + vllm.__version__.encode()
25 + Path(__file__).read_bytes() + Path(__file__).with_name("studio_ai_cache.py").read_bytes() + key
26 ).hexdigest()
27 self.mapper = FileMapper.from_offloading_spec(namespace, offloading_spec, offloading_spec.blocks_per_chunk)
28 self.cache = DiskCache(ssd_dir, hdd_dir, ssd_bytes, hdd_bytes, key)
29 self.block_size = primary_kv_view.strides[0]
30 self.pool = DualQueueThreadPool(16, 2, thread_name_prefix="studio_kv_disk")
31
32 def on_new_request(self, req_context):
33 return RequestOffloadingContext()
34
35 def lookup(self, key, req_context):
36 return LookupResult.HIT if self.cache.acquire(self.mapper.get_file_name(key), req_context.req_id) else LookupResult.MISS
37
38 def submit_store(self, job_metadata):
39 tasks = [functools.partial(self._transfer, self.cache.store, key, block_id)
40 for key, block_id in zip(job_metadata.keys, job_metadata.block_ids, strict=True)]
41 self.pool.enqueue_store(job_metadata.job_id, len(tasks), tasks)
42
43 def submit_load(self, job_metadata):
44 tasks = [functools.partial(self._transfer, self.cache.load, key, block_id)
45 for key, block_id in zip(job_metadata.keys, job_metadata.block_ids, strict=True)]
46 self.pool.enqueue_load(job_metadata.job_id, len(tasks), tasks)
47
48 def _transfer(self, operation, key, block_id):
49 offset = int(block_id) * self.block_size
50 with self._primary_kv_view.cast("B")[offset:offset + self.block_size] as view:
51 operation(self.mapper.get_file_name(key), view)
52
53 def get_finished_jobs(self):
54 return [JobResult(job_id, success) for job_id, success in self.pool.get_finished()]
55
56 def touch(self, keys, req_context):
57 for key in keys:
58 self.cache.touch(self.mapper.get_file_name(key))
59
60 def on_request_finished(self, req_context):
61 self.cache.release(req_context.req_id)
62
63 def drain_jobs(self):
64 self.pool.wait_idle()
65
66 def shutdown(self):
67 self.pool.wait_idle()
68 self.pool.shutdown(wait=True)
69 self.cache.close()
70
71
72def register():
73 SecondaryTierFactory.register_tier("studio_disk", __name__, "DiskTier")
service/local-ai/cache/test_cache.py+1-1
...@@ -5,7 +5,7 @@ from pathlib import Path...@@ -5,7 +5,7 @@ from pathlib import Path
5import tempfile5import tempfile
6import unittest6import unittest
77
8from studio_ai_cache import DiskCache8from snowglobe_ai_cache import DiskCache
99
1010
11class CacheTests(unittest.TestCase):11class CacheTests(unittest.TestCase):
service/local-ai/cache/test_vllm_cache.py+3-3
...@@ -13,7 +13,7 @@ from vllm.v1.kv_offload.cpu.spec import CPUOffloadingSpec...@@ -13,7 +13,7 @@ from vllm.v1.kv_offload.cpu.spec import CPUOffloadingSpec
13from vllm.v1.kv_offload.tiering.factory import SecondaryTierFactory13from vllm.v1.kv_offload.tiering.factory import SecondaryTierFactory
14from vllm.v1.kv_offload.tiering.manager import CPUPrimaryTierOffloadingManager, TieringOffloadingManager14from vllm.v1.kv_offload.tiering.manager import CPUPrimaryTierOffloadingManager, TieringOffloadingManager
1515
16from studio_ai_cache_vllm import register16from snowglobe_ai_cache_vllm import register
1717
1818
19class VllmCacheTests(unittest.TestCase):19class VllmCacheTests(unittest.TestCase):
...@@ -25,7 +25,7 @@ class VllmCacheTests(unittest.TestCase):...@@ -25,7 +25,7 @@ class VllmCacheTests(unittest.TestCase):
25 self.temporary = tempfile.TemporaryDirectory()25 self.temporary = tempfile.TemporaryDirectory()
26 self.addCleanup(self.temporary.cleanup)26 self.addCleanup(self.temporary.cleanup)
27 self.root = Path(self.temporary.name)27 self.root = Path(self.temporary.name)
28 os.environ["STUDIO_AI_CACHE_KEY"] = "disposable-synthetic-cache-key"28 os.environ["SNOWGLOBE_AI_CACHE_KEY"] = "disposable-synthetic-cache-key"
29 config = OffloadingConfig(29 config = OffloadingConfig(
30 groups=(OffloadingGroupConfig(16, ("attention",)), OffloadingGroupConfig(16, ("recurrent",))),30 groups=(OffloadingGroupConfig(16, ("attention",)), OffloadingGroupConfig(16, ("recurrent",))),
31 worker_kv_bytes_per_block=mmap.PAGESIZE,31 worker_kv_bytes_per_block=mmap.PAGESIZE,
...@@ -39,7 +39,7 @@ class VllmCacheTests(unittest.TestCase):...@@ -39,7 +39,7 @@ class VllmCacheTests(unittest.TestCase):
39 primary = CPUPrimaryTierOffloadingManager(4, region)39 primary = CPUPrimaryTierOffloadingManager(4, region)
40 self.view = primary.get_kv_memoryview()40 self.view = primary.get_kv_memoryview()
41 self.tier = SecondaryTierFactory.create_secondary_tier({41 self.tier = SecondaryTierFactory.create_secondary_tier({
42 "type": "studio_disk", "ssd_dir": str(self.root / "ssd"), "hdd_dir": str(self.root / "hdd"),42 "type": "snowglobe_disk", "ssd_dir": str(self.root / "ssd"), "hdd_dir": str(self.root / "hdd"),
43 "ssd_bytes": 4 * mmap.PAGESIZE, "hdd_bytes": 6 * mmap.PAGESIZE,43 "ssd_bytes": 4 * mmap.PAGESIZE, "hdd_bytes": 6 * mmap.PAGESIZE,
44 }, self.view, spec)44 }, self.view, spec)
45 self.manager = TieringOffloadingManager(primary, [self.tier])45 self.manager = TieringOffloadingManager(primary, [self.tier])
service/local-ai/gateway.py+3-3
...@@ -13,10 +13,10 @@ import threading...@@ -13,10 +13,10 @@ import threading
1313
14WAIT_SECONDS = 8 * 60 * 6014WAIT_SECONDS = 8 * 60 * 60
15HOP_HEADERS = {"connection", "transfer-encoding", "content-length", "host", "accept-encoding"}15HOP_HEADERS = {"connection", "transfer-encoding", "content-length", "host", "accept-encoding"}
16STEERING_DIR = Path(os.environ.get("STUDIO_STEERING_DIR", Path(__file__).with_name("steering")))16STEERING_DIR = Path(os.environ.get("SNOWGLOBE_STEERING_DIR", Path(__file__).with_name("steering")))
17STEERING_REVISION = hashlib.sha256(b"".join(17STEERING_REVISION = hashlib.sha256(b"".join(
18 (STEERING_DIR / name).read_bytes()18 (STEERING_DIR / name).read_bytes()
19 for name in ("golden-gate.safetensors", "studio_ai_steering.py", "runtime.patch")19 for name in ("golden-gate.safetensors", "snowglobe_ai_steering.py", "runtime.patch")
20)).hexdigest()20)).hexdigest()
2121
2222
...@@ -24,7 +24,7 @@ def route_model(data):...@@ -24,7 +24,7 @@ def route_model(data):
24 golden = data.get("model") == "golden-gate-qwen3.8-27B"24 golden = data.get("model") == "golden-gate-qwen3.8-27B"
25 if golden and data.get("use_beam_search"):25 if golden and data.get("use_beam_search"):
26 raise ValueError("Golden Gate does not support beam search. Set use_beam_search to false.")26 raise ValueError("Golden Gate does not support beam search. Set use_beam_search to false.")
27 data["vllm_xargs"] = {**(data.get("vllm_xargs") or {}), "studio_golden_gate": int(golden)}27 data["vllm_xargs"] = {**(data.get("vllm_xargs") or {}), "snowglobe_golden_gate": int(golden)}
28 salt = data.get("cache_salt")28 salt = data.get("cache_salt")
29 if salt is not None and (not isinstance(salt, str) or not salt):29 if salt is not None and (not isinstance(salt, str) or not salt):
30 raise ValueError("cache_salt must be a nonempty string")30 raise ValueError("cache_salt must be a nonempty string")
service/local-ai/service.pkl+6-5
...@@ -7,9 +7,10 @@ local models = (new json.Parser {}).parse(read("catalog.json")).models...@@ -7,9 +7,10 @@ local models = (new json.Parser {}).parse(read("catalog.json")).models
7local model = models[0]7local model = models[0]
8local weights = (new json.Parser {}).parse(read("models.json"))8local weights = (new json.Parser {}).parse(read("models.json"))
99
10meta { name = "Local AI"; launcher = false; access = "admin" }10name = "Local AI"
11enabled = (read?("env:STUDIO_LOCAL_AI") ?? "false") == "true"11launcher = false
12rollout = "simple"12access = "admin"
13enabled = (read?("env:SNOWGLOBE_LOCAL_AI") ?? "false") == "true"
13stageIsolation = "fresh"14stageIsolation = "fresh"
14prepare = "prepare.py"15prepare = "prepare.py"
15healthyDeadline = "30m"16healthyDeadline = "30m"
...@@ -40,7 +41,7 @@ container {...@@ -40,7 +41,7 @@ container {
40 env {41 env {
41 ["LD_LIBRARY_PATH"] = "/nvidia/lib:/usr/local/cuda/lib64"42 ["LD_LIBRARY_PATH"] = "/nvidia/lib:/usr/local/cuda/lib64"
42 ["VLLM_API_KEY"] = "${secret.own.api_key}"43 ["VLLM_API_KEY"] = "${secret.own.api_key}"
43 ["STUDIO_AI_CACHE_KEY"] = "${secret.own.cache_key}"44 ["SNOWGLOBE_AI_CACHE_KEY"] = "${secret.own.cache_key}"
44 ["PYTHONHASHSEED"] = "0"45 ["PYTHONHASHSEED"] = "0"
45 ["PYTORCH_CUDA_ALLOC_CONF"] = "expandable_segments:False"46 ["PYTORCH_CUDA_ALLOC_CONF"] = "expandable_segments:False"
46 ["MODEL"] = "/models"47 ["MODEL"] = "/models"
...@@ -59,7 +60,7 @@ container {...@@ -59,7 +60,7 @@ container {
59 ["PORT"] = "8081"60 ["PORT"] = "8081"
60 ["VLLM_MAMBA_ALIGN_KEEP_CHECKPOINTS"] = "1"61 ["VLLM_MAMBA_ALIGN_KEEP_CHECKPOINTS"] = "1"
61 ["FLASHINFER_DISABLE_VERSION_CHECK"] = "1"62 ["FLASHINFER_DISABLE_VERSION_CHECK"] = "1"
62 ["EXTRA_ARGS"] = "--served-model-name \(models.toList().map((item) -> item.slug).join(" ")) --kv-transfer-config {\"kv_connector\":\"OffloadingConnector\",\"kv_role\":\"kv_both\",\"kv_connector_extra_config\":{\"spec_name\":\"TieringOffloadingSpec\",\"cpu_bytes_to_use\":8589934592,\"offload_prompt_only\":false,\"secondary_tiers\":[{\"type\":\"studio_disk\",\"ssd_dir\":\"/cache/ssd\",\"hdd_dir\":\"/cache/hdd\",\"ssd_bytes\":17179869184,\"hdd_bytes\":274877906944}]}} --limit-mm-per-prompt {\"image\":{\"count\":10}} --default-chat-template-kwargs {\"enable_thinking\":true,\"reasoning_effort\":\"\(model.default_reasoning_level)\"} --generation-config vllm --override-generation-config {\"temperature\":1.0,\"top_p\":0.95,\"top_k\":20,\"min_p\":0,\"presence_penalty\":0,\"repetition_penalty\":1.0} --disable-uvicorn-access-log"63 ["EXTRA_ARGS"] = "--served-model-name \(models.toList().map((item) -> item.slug).join(" ")) --kv-transfer-config {\"kv_connector\":\"OffloadingConnector\",\"kv_role\":\"kv_both\",\"kv_connector_extra_config\":{\"spec_name\":\"TieringOffloadingSpec\",\"cpu_bytes_to_use\":8589934592,\"offload_prompt_only\":false,\"secondary_tiers\":[{\"type\":\"snowglobe_disk\",\"ssd_dir\":\"/cache/ssd\",\"hdd_dir\":\"/cache/hdd\",\"ssd_bytes\":17179869184,\"hdd_bytes\":274877906944}]}} --limit-mm-per-prompt {\"image\":{\"count\":10}} --default-chat-template-kwargs {\"enable_thinking\":true,\"reasoning_effort\":\"\(model.default_reasoning_level)\"} --generation-config vllm --override-generation-config {\"temperature\":1.0,\"top_p\":0.95,\"top_k\":20,\"min_p\":0,\"presence_penalty\":0,\"repetition_penalty\":1.0} --disable-uvicorn-access-log"
63 }64 }
64 args { "/config/gateway.py" }65 args { "/config/gateway.py" }
65}66}
service/local-ai/steering/README.md+1-1
...@@ -13,7 +13,7 @@ forward pass, including CUDA graph replay and speculative verification....@@ -13,7 +13,7 @@ forward pass, including CUDA graph replay and speculative verification.
13Normal rows preserve both residual branches unchanged. The MTP drafter uses13Normal rows preserve both residual branches unchanged. The MTP drafter uses
14the resulting target hidden states; its separate layer is not steered.14the resulting target hidden states; its separate layer is not steered.
1515
16GPU verification at full strength on 2026-10-16 used Swift's existing INT4 weights on Zenith's16GPU verification at full strength on 2026-10-16 used Swift's existing INT4 weights on Snow Globe's
17RTX 3090. CUDA graph replay preserved normal rows exactly. Sixteen concurrent17RTX 3090. CUDA graph replay preserved normal rows exactly. Sixteen concurrent
18mixed-model requests selected the correct behavior. Identical 7,526-token18mixed-model requests selected the correct behavior. Identical 7,526-token
19prompts had zero cross-model cache hits and 6,656 same-model reuse hits.19prompts had zero cross-model cache hits and 6,656 same-model reuse hits.
service/local-ai/steering/runtime.patch+2-2
...@@ -4,7 +4,7 @@...@@ -4,7 +4,7 @@
4 4
5 import torch5 import torch
6 from torch import nn6 from torch import nn
7+from studio_ai_steering import GoldenGateSteering7+from snowglobe_ai_steering import GoldenGateSteering
8 8
9 from vllm._aiter_ops import rocm_aiter_ops9 from vllm._aiter_ops import rocm_aiter_ops
10 from vllm.compilation.decorators import support_torch_compile10 from vllm.compilation.decorators import support_torch_compile
...@@ -37,7 +37,7 @@...@@ -37,7 +37,7 @@
37 from vllm.platforms import current_platform37 from vllm.platforms import current_platform
38 from vllm.pooling_params import PoolingParams38 from vllm.pooling_params import PoolingParams
39 from vllm.sampling_params import SamplingType39 from vllm.sampling_params import SamplingType
40+from studio_ai_steering import GoldenGateSteering40+from snowglobe_ai_steering import GoldenGateSteering
41 from vllm.sequence import IntermediateTensors41 from vllm.sequence import IntermediateTensors
42 from vllm.tasks import GenerationTask, PoolingTask, SupportedTask42 from vllm.tasks import GenerationTask, PoolingTask, SupportedTask
43 from vllm.tracing import instrument43 from vllm.tracing import instrument
service/local-ai/steering/snowglobe_ai_steering.py created+38
...@@ -0,0 +1,38 @@
1from pathlib import Path
2
3import torch
4from safetensors.torch import load_file
5
6
7class GoldenGateSteering(torch.nn.Module):
8 def __init__(self, config):
9 super().__init__()
10 parallel = config.parallel_config
11 if (parallel.tensor_parallel_size, parallel.pipeline_parallel_size,
12 parallel.data_parallel_size) != (1, 1, 1) or parallel.enable_dbo:
13 raise ValueError("Golden Gate steering requires one GPU without microbatching")
14 vector = load_file(str(Path(__file__).with_name("golden-gate.safetensors")))["steer.layer32"]
15 if vector.shape != (config.model_config.hf_text_config.hidden_size,):
16 raise ValueError("Golden Gate vector does not match the model's hidden dimension")
17 self.register_buffer("vector", (vector * 0.625).to(device="cuda", dtype=config.model_config.dtype), persistent=False)
18 self.register_buffer("mask", torch.zeros(config.scheduler_config.max_num_batched_tokens, 1,
19 device="cuda", dtype=torch.bool), persistent=False)
20 self.cpu_mask = torch.zeros(self.mask.shape, device="cpu", dtype=torch.bool, pin_memory=True)
21
22 def prepare(self, requests, req_ids, counts):
23 self.cpu_mask.zero_()
24 offset = 0
25 for req_id, count in zip(req_ids, counts, strict=True):
26 params = requests[req_id].sampling_params
27 if params and (params.extra_args or {}).get("snowglobe_golden_gate"):
28 self.cpu_mask[offset:offset + count] = True
29 offset += count
30 if offset > len(self.mask):
31 raise ValueError("Golden Gate token mask is smaller than the scheduled batch")
32 self.mask.copy_(self.cpu_mask, non_blocking=True)
33
34 def forward(self, hidden, residual):
35 mask = self.mask[:hidden.shape[0]]
36 # vLLM defers the residual addition until the next layer's fused norm.
37 steered = (hidden + residual) + self.vector
38 return torch.where(mask, 0, hidden), torch.where(mask, steered, residual)
service/local-ai/steering/studio_ai_steering.py deleted-38
...@@ -1,38 +0,0 @@
1from pathlib import Path
2
3import torch
4from safetensors.torch import load_file
5
6
7class GoldenGateSteering(torch.nn.Module):
8 def __init__(self, config):
9 super().__init__()
10 parallel = config.parallel_config
11 if (parallel.tensor_parallel_size, parallel.pipeline_parallel_size,
12 parallel.data_parallel_size) != (1, 1, 1) or parallel.enable_dbo:
13 raise ValueError("Golden Gate steering requires one GPU without microbatching")
14 vector = load_file(str(Path(__file__).with_name("golden-gate.safetensors")))["steer.layer32"]
15 if vector.shape != (config.model_config.hf_text_config.hidden_size,):
16 raise ValueError("Golden Gate vector does not match the model's hidden dimension")
17 self.register_buffer("vector", (vector * 0.625).to(device="cuda", dtype=config.model_config.dtype), persistent=False)
18 self.register_buffer("mask", torch.zeros(config.scheduler_config.max_num_batched_tokens, 1,
19 device="cuda", dtype=torch.bool), persistent=False)
20 self.cpu_mask = torch.zeros(self.mask.shape, device="cpu", dtype=torch.bool, pin_memory=True)
21
22 def prepare(self, requests, req_ids, counts):
23 self.cpu_mask.zero_()
24 offset = 0
25 for req_id, count in zip(req_ids, counts, strict=True):
26 params = requests[req_id].sampling_params
27 if params and (params.extra_args or {}).get("studio_golden_gate"):
28 self.cpu_mask[offset:offset + count] = True
29 offset += count
30 if offset > len(self.mask):
31 raise ValueError("Golden Gate token mask is smaller than the scheduled batch")
32 self.mask.copy_(self.cpu_mask, non_blocking=True)
33
34 def forward(self, hidden, residual):
35 mask = self.mask[:hidden.shape[0]]
36 # vLLM defers the residual addition until the next layer's fused norm.
37 steered = (hidden + residual) + self.vector
38 return torch.where(mask, 0, hidden), torch.where(mask, steered, residual)
service/local-ai/steering/test_steering.py+2-2
...@@ -3,7 +3,7 @@ import unittest...@@ -3,7 +3,7 @@ import unittest
33
4import torch4import torch
55
6from studio_ai_steering import GoldenGateSteering6from snowglobe_ai_steering import GoldenGateSteering
77
88
9@unittest.skipUnless(torch.cuda.is_available(), "requires a CUDA GPU")9@unittest.skipUnless(torch.cuda.is_available(), "requires a CUDA GPU")
...@@ -17,7 +17,7 @@ class Steering(unittest.TestCase):...@@ -17,7 +17,7 @@ class Steering(unittest.TestCase):
17 )17 )
18 with torch.device("cuda"):18 with torch.device("cuda"):
19 steering = GoldenGateSteering(config)19 steering = GoldenGateSteering(config)
20 requests = {name: SimpleNamespace(sampling_params=SimpleNamespace(extra_args={"studio_golden_gate": value}))20 requests = {name: SimpleNamespace(sampling_params=SimpleNamespace(extra_args={"snowglobe_golden_gate": value}))
21 for name, value in [("normal", 0), ("golden", 1)]}21 for name, value in [("normal", 0), ("golden", 1)]}
22 hidden = torch.randn(8, 5120, device="cuda", dtype=torch.bfloat16)22 hidden = torch.randn(8, 5120, device="cuda", dtype=torch.bfloat16)
23 residual = torch.randn_like(hidden)23 residual = torch.randn_like(hidden)
service/local-ai/test_gateway.py+4-4
...@@ -25,10 +25,10 @@ class ResponsesCompatibility(unittest.TestCase):...@@ -25,10 +25,10 @@ class ResponsesCompatibility(unittest.TestCase):
25 worker.join()25 worker.join()
2626
27 def test_steering_and_cache_namespace_follow_model_selection(self):27 def test_steering_and_cache_namespace_follow_model_selection(self):
28 normal = route_model({"model": "qwen3.8-27b", "vllm_xargs": {"studio_golden_gate": 1}})28 normal = route_model({"model": "qwen3.8-27b", "vllm_xargs": {"snowglobe_golden_gate": 1}})
29 golden = route_model({"model": "golden-gate-qwen3.8-27B", "vllm_xargs": {"studio_golden_gate": 0}, "chat_template_kwargs": {"enable_thinking": True}})29 golden = route_model({"model": "golden-gate-qwen3.8-27B", "vllm_xargs": {"snowglobe_golden_gate": 0}, "chat_template_kwargs": {"enable_thinking": True}})
30 self.assertEqual(normal["vllm_xargs"]["studio_golden_gate"], 0)30 self.assertEqual(normal["vllm_xargs"]["snowglobe_golden_gate"], 0)
31 self.assertEqual(golden["vllm_xargs"]["studio_golden_gate"], 1)31 self.assertEqual(golden["vllm_xargs"]["snowglobe_golden_gate"], 1)
32 self.assertNotIn("chat_template_kwargs", normal)32 self.assertNotIn("chat_template_kwargs", normal)
33 self.assertFalse(golden["chat_template_kwargs"]["enable_thinking"])33 self.assertFalse(golden["chat_template_kwargs"]["enable_thinking"])
34 self.assertNotEqual(normal["cache_salt"], golden["cache_salt"])34 self.assertNotEqual(normal["cache_salt"], golden["cache_salt"])
service/navidrome/service.pkl+1-3
...@@ -2,12 +2,10 @@ amends "../../config/Service.pkl"...@@ -2,12 +2,10 @@ amends "../../config/Service.pkl"
22
3import "../../config/site.pkl" as site3import "../../config/site.pkl" as site
44
5meta { name = "Navidrome" }5name = "Navidrome"
66
7container {7container {
8 image = "docker.io/deluan/navidrome@sha256:59ce76e6e06193fbfbb1736a93b8468227e1ea663fc7b25b1da13fbb97f5197b"8 image = "docker.io/deluan/navidrome@sha256:59ce76e6e06193fbfbb1736a93b8468227e1ea663fc7b25b1da13fbb97f5197b"
9 cpu = 200
10 memory = 512
119
12 http {10 http {
13 containerPort = 453311 containerPort = 4533
service/openclaw/service.pkl+4-5
...@@ -1,7 +1,8 @@...@@ -1,7 +1,8 @@
1amends "../../config/Service.pkl"1amends "../../config/Service.pkl"
22
3meta { name = "OpenClaw"; access = "infra-admin" }3name = "OpenClaw"
4enabled = (read?("env:STUDIO_LOCAL_AI") ?? "false") == "true"4access = "infra-admin"
5enabled = (read?("env:SNOWGLOBE_LOCAL_AI") ?? "false") == "true"
5stageIsolation = "fresh"6stageIsolation = "fresh"
6healthyDeadline = "30m"7healthyDeadline = "30m"
7healthRestartGrace = "30m"8healthRestartGrace = "30m"
...@@ -14,7 +15,6 @@ containers {...@@ -14,7 +15,6 @@ containers {
14 hostNetwork = true15 hostNetwork = true
15 entrypoint = "/usr/sbin/nginx"16 entrypoint = "/usr/sbin/nginx"
16 args { "-c"; "/cfg/nginx.conf"; "-g"; "daemon off;" }17 args { "-c"; "/cfg/nginx.conf"; "-g"; "daemon off;" }
17 cpu = 200
18 memory = 25618 memory = 256
19 http {19 http {
20 containerPort = 1888920 containerPort = 18889
...@@ -27,7 +27,7 @@ containers {...@@ -27,7 +27,7 @@ containers {
27 }27 }
28 volumes {28 volumes {
29 ["/cfg"] {}29 ["/cfg"] {}
30 ["/etc/ssl/certs/ca-certificates.crt"] { src = "/var/lib/studio/ca-bundle.crt"; readOnly = true }30 ["/etc/ssl/certs/ca-certificates.crt"] { src = "/var/lib/snowglobe/ca-bundle.crt"; readOnly = true }
31 }31 }
32 }32 }
33 ["internet"] {33 ["internet"] {
...@@ -35,7 +35,6 @@ containers {...@@ -35,7 +35,6 @@ containers {
35 hostNetwork = true35 hostNetwork = true
36 entrypoint = "/usr/sbin/squid"36 entrypoint = "/usr/sbin/squid"
37 args { "-N"; "-f"; "/config/squid.conf" }37 args { "-N"; "-f"; "/config/squid.conf" }
38 cpu = 200
39 memory = 25638 memory = 256
40 volumes { ["/config/squid.conf"] { config = "squid.conf" } }39 volumes { ["/config/squid.conf"] { config = "squid.conf" } }
41 }40 }
service/openspeedtest/service.pkl+1-1
...@@ -1,6 +1,6 @@...@@ -1,6 +1,6 @@
1amends "../../config/Service.pkl"1amends "../../config/Service.pkl"
22
3meta { name = "Open Speed Test" }3name = "Open Speed Test"
4rollout = "overlapped"4rollout = "overlapped"
5healthRestartGrace = "30s"5healthRestartGrace = "30s"
66
service/pds/service.pkl+4-5
...@@ -4,10 +4,10 @@ import "../../config/site.pkl" as site...@@ -4,10 +4,10 @@ import "../../config/site.pkl" as site
44
5local isolated = site.preview || site.domain.endsWith(".test")5local isolated = site.preview || site.domain.endsWith(".test")
66
7meta { name = "ATProto PDS"; launcher = false }7name = "ATProto PDS"
8launcher = false
8traceServiceName = module.id9traceServiceName = module.id
9metricsPushed = true10metricsPushed = true
10rollout = "simple"
11stageIsolation = "fresh"11stageIsolation = "fresh"
12dependsOn { "victoria" }12dependsOn { "victoria" }
1313
...@@ -29,9 +29,8 @@ requiredSecrets = if (isolated) new {} else new {...@@ -29,9 +29,8 @@ requiredSecrets = if (isolated) new {} else new {
29container {29container {
30 image = "ghcr.io/bluesky-social/pds@sha256:d155af1c906d7848e7dea9d59a8a7def065a04b77aa98ae56ea05a8d4eadb63a"30 image = "ghcr.io/bluesky-social/pds@sha256:d155af1c906d7848e7dea9d59a8a7def065a04b77aa98ae56ea05a8d4eadb63a"
31 entrypoint = "/bin/sh"31 entrypoint = "/bin/sh"
32 args { "/studio/start.sh" }32 args { "/snowglobe/start.sh" }
33 cpu = 25033 cpu = 250
34 memory = 512
3534
36 http {35 http {
37 containerPort = 300036 containerPort = 3000
...@@ -41,7 +40,7 @@ container {...@@ -41,7 +40,7 @@ container {
4140
42 volumes {41 volumes {
43 ["/pds"] {}42 ["/pds"] {}
44 ["/studio/start.sh"] { config = "start.sh" }43 ["/snowglobe/start.sh"] { config = "start.sh" }
45 }44 }
4645
47 env {46 env {
service/postgres/pgadmin.pkl+3-4
...@@ -3,7 +3,7 @@ amends "../../config/Service.pkl"...@@ -3,7 +3,7 @@ amends "../../config/Service.pkl"
3import "service.pkl" as postgres3import "service.pkl" as postgres
4import "../../config/site.pkl" as site4import "../../config/site.pkl" as site
55
6meta { name = "pgAdmin" }6name = "pgAdmin"
7healthyDeadline = "15m"7healthyDeadline = "15m"
8requirements { new postgres.AdminConnection {} }8requirements { new postgres.AdminConnection {} }
99
...@@ -14,9 +14,8 @@ secrets {...@@ -14,9 +14,8 @@ secrets {
14container {14container {
15 image = "docker.io/dpage/pgadmin4@sha256:33eb7d070ee7500d1513453773f61df1256fdea08257d4a3f4aebd8cf1cc87cf"15 image = "docker.io/dpage/pgadmin4@sha256:33eb7d070ee7500d1513453773f61df1256fdea08257d4a3f4aebd8cf1cc87cf"
16 entrypoint = "/bin/sh"16 entrypoint = "/bin/sh"
17 args { "/studio/start.sh" }17 args { "/snowglobe/start.sh" }
18 cpu = 15018 cpu = 150
19 memory = 512
2019
21 http {20 http {
22 containerPort = 505021 containerPort = 5050
...@@ -27,7 +26,7 @@ container {...@@ -27,7 +26,7 @@ container {
2726
28 volumes {27 volumes {
29 ["/var/lib/pgadmin"] {}28 ["/var/lib/pgadmin"] {}
30 ["/studio/start.sh"] { config = "start.sh" }29 ["/snowglobe/start.sh"] { config = "start.sh" }
31 }30 }
3231
33 env {32 env {
service/postgres/service.pkl+1-1
...@@ -16,7 +16,7 @@ class AdminConnection extends service.Requirement {...@@ -16,7 +16,7 @@ class AdminConnection extends service.Requirement {
16 fixed kind = "admin"16 fixed kind = "admin"
17}17}
1818
19meta { name = "Postgres" }19name = "Postgres"
20provide = "provide.py"20provide = "provide.py"
2121
22container {22container {
service/qbittorrent/service.pkl+1-3
...@@ -2,8 +2,7 @@ amends "../../config/Service.pkl"...@@ -2,8 +2,7 @@ amends "../../config/Service.pkl"
22
3import "../../config/site.pkl" as site3import "../../config/site.pkl" as site
44
5meta { name = "qBittorrent" }5name = "qBittorrent"
6rollout = "simple"
7healthyDeadline = "15m"6healthyDeadline = "15m"
8prepare = "prepare.py"7prepare = "prepare.py"
98
...@@ -15,7 +14,6 @@ requiredSecrets {...@@ -15,7 +14,6 @@ requiredSecrets {
15container {14container {
16 image = "docker.io/binhex/arch-qbittorrentvpn@sha256:7320d195ca582b236207b88f483319cd49b08c0665b22b945c3d4cebcb601a17"15 image = "docker.io/binhex/arch-qbittorrentvpn@sha256:7320d195ca582b236207b88f483319cd49b08c0665b22b945c3d4cebcb601a17"
17 imageUser = true16 imageUser = true
18 cpu = 200
19 memory = 102417 memory = 1024
20 capAdd { "NET_ADMIN" }18 capAdd { "NET_ADMIN" }
21 devices { "/dev/net/tun" }19 devices { "/dev/net/tun" }
service/radarr/service.pkl+1-1
...@@ -2,7 +2,7 @@ amends "../../config/Service.pkl"...@@ -2,7 +2,7 @@ amends "../../config/Service.pkl"
22
3import "../../config/site.pkl" as site3import "../../config/site.pkl" as site
44
5meta { name = "Radarr" }5name = "Radarr"
6setup = "tools/configure-arr.py"6setup = "tools/configure-arr.py"
7dependsOn {7dependsOn {
8 "qbittorrent"8 "qbittorrent"
service/samba/service.pkl+1-1
...@@ -2,7 +2,7 @@ amends "../../config/Service.pkl"...@@ -2,7 +2,7 @@ amends "../../config/Service.pkl"
22
3import "../../config/site.pkl" as site3import "../../config/site.pkl" as site
44
5meta { name = "Samba" }5name = "Samba"
66
7container {7container {
8 image = "ghcr.io/servercontainers/samba@sha256:31b90ea7fe3258d30fccd971c85743b92694605f4b43dc8a4df23a202fced06a"8 image = "ghcr.io/servercontainers/samba@sha256:31b90ea7fe3258d30fccd971c85743b92694605f4b43dc8a4df23a202fced06a"
service/shale/prepare.py+1-1
...@@ -17,7 +17,7 @@ for config in (root / "repositories_owned").glob("*/config"):...@@ -17,7 +17,7 @@ for config in (root / "repositories_owned").glob("*/config"):
17 file.write("\n[http]\n\treceivepack = true\n")17 file.write("\n[http]\n\treceivepack = true\n")
18path = root / "data/astheno.shale.db"18path = root / "data/astheno.shale.db"
19if path.exists():19if path.exists():
20 domain = os.environ["STUDIO_DOMAIN"]20 domain = os.environ["SNOWGLOBE_DOMAIN"]
21 old, new = "auth." + domain + "/realms/master", "snowglobe." + domain21 old, new = "auth." + domain + "/realms/master", "snowglobe." + domain
22 db = sqlite3.connect(path, timeout=30)22 db = sqlite3.connect(path, timeout=30)
23 db.execute("BEGIN IMMEDIATE")23 db.execute("BEGIN IMMEDIATE")
service/shale/service.pkl+5-8
...@@ -3,13 +3,11 @@ amends "../../config/Service.pkl"...@@ -3,13 +3,11 @@ amends "../../config/Service.pkl"
3import "../../config/OpenID.pkl" as sso3import "../../config/OpenID.pkl" as sso
4import "../../config/site.pkl" as site4import "../../config/site.pkl" as site
55
6meta {6name = "Shale"
7 name = "Shale"
8}
9requirements {7requirements {
10 new sso.Client {8 new sso.Client {
11 clientId = module.id9 clientId = module.id
12 name = module.meta.name10 name = module.name
13 redirectUris { "https://\(module.container.http.hostname)/-/callback" }11 redirectUris { "https://\(module.container.http.hostname)/-/callback" }
14 usernameAliases { ["snow"] = "clover" }12 usernameAliases { ["snow"] = "clover" }
15 allowGuests = true13 allowGuests = true
...@@ -21,7 +19,6 @@ prepare = "prepare.py"...@@ -21,7 +19,6 @@ prepare = "prepare.py"
21container {19container {
22 memory = 409620 memory = 4096
23 image = "docker.io/astheno/shale@sha256:b55cc42c4eb2c1e21733405bec795e49ddd7c71fb1755d2aa2ee4361f750cebd"21 image = "docker.io/astheno/shale@sha256:b55cc42c4eb2c1e21733405bec795e49ddd7c71fb1755d2aa2ee4361f750cebd"
24 extraHosts { "\(sso.hostname):host-gateway" }
2522
26 http {23 http {
27 containerPort = 800024 containerPort = 8000
...@@ -29,11 +26,11 @@ container {...@@ -29,11 +26,11 @@ container {
29 overrideFiles {26 overrideFiles {
30 ["/-/theme.css"] = "theme.css"27 ["/-/theme.css"] = "theme.css"
31 ["/-/repo-icons/"] = "icons"28 ["/-/repo-icons/"] = "icons"
32 ["/-/studio-readme/"] = "readme"29 ["/-/snowglobe-readme/"] = "readme"
33 }30 }
34 headHtml {31 headHtml {
35 ["/*"] = """32 ["/*"] = """
36 <script defer src="/-/studio-readme/markdown-it.min.js"></script><script defer src="/-/studio-readme/purify.min.js"></script><script defer src="/-/studio-readme/readme.js?h=\(read("readme/readme.js").bytes.sha256)"></script>33 <script defer src="/-/snowglobe-readme/markdown-it.min.js"></script><script defer src="/-/snowglobe-readme/purify.min.js"></script><script defer src="/-/snowglobe-readme/readme.js?h=\(read("readme/readme.js").bytes.sha256)"></script>
37 """34 """
38 }35 }
39 }36 }
...@@ -45,7 +42,7 @@ container {...@@ -45,7 +42,7 @@ container {
45 ["/etc/crontabs"] {}42 ["/etc/crontabs"] {}
46 ["/etc/shale/theme.css"] { config = "theme.css" }43 ["/etc/shale/theme.css"] { config = "theme.css" }
47 ["/etc/ssl/certs/ca-certificates.crt"] {44 ["/etc/ssl/certs/ca-certificates.crt"] {
48 src = "/var/lib/studio/ca-bundle.crt"45 src = "/var/lib/snowglobe/ca-bundle.crt"
49 readOnly = true46 readOnly = true
50 }47 }
51 }48 }
service/sonarr/service.pkl+1-1
...@@ -2,7 +2,7 @@ amends "../../config/Service.pkl"...@@ -2,7 +2,7 @@ amends "../../config/Service.pkl"
22
3import "../../config/site.pkl" as site3import "../../config/site.pkl" as site
44
5meta { name = "Sonarr" }5name = "Sonarr"
6setup = "tools/configure-arr.py"6setup = "tools/configure-arr.py"
7dependsOn {7dependsOn {
8 "qbittorrent"8 "qbittorrent"
service/tailscale/service.pkl+1-1
...@@ -2,7 +2,7 @@ amends "../../config/Service.pkl"...@@ -2,7 +2,7 @@ amends "../../config/Service.pkl"
22
3import "../../config/site.pkl" as site3import "../../config/site.pkl" as site
44
5meta { name = "Tailscale" }5name = "Tailscale"
66
7container {7container {
8 image = "docker.io/tailscale/tailscale@sha256:2667499ed87ae29218f292556ba062918402dd5e92e93637af14867e4df12dd3"8 image = "docker.io/tailscale/tailscale@sha256:2667499ed87ae29218f292556ba062918402dd5e92e93637af14867e4df12dd3"
service/victoria/service.pkl+2-4
...@@ -1,12 +1,12 @@...@@ -1,12 +1,12 @@
1amends "../../config/Service.pkl"1amends "../../config/Service.pkl"
22
3meta { name = "Victoria"; tagline = "Metrics, logs, and traces" }3name = "Victoria"
4tagline = "Metrics, logs, and traces"
45
5containers {6containers {
6 ["logs"] {7 ["logs"] {
7 image = "docker.io/victoriametrics/victoria-logs:v1.52.0"8 image = "docker.io/victoriametrics/victoria-logs:v1.52.0"
8 cpu = 3009 cpu = 300
9 memory = 512
10 args { "-storageDataPath=/logs"; "-retentionPeriod=30d" }10 args { "-storageDataPath=/logs"; "-retentionPeriod=30d" }
1111
12 http {12 http {
...@@ -22,7 +22,6 @@ containers {...@@ -22,7 +22,6 @@ containers {
22 ["metrics"] {22 ["metrics"] {
23 image = "docker.io/victoriametrics/victoria-metrics:v1.152.0"23 image = "docker.io/victoriametrics/victoria-metrics:v1.152.0"
24 cpu = 30024 cpu = 300
25 memory = 512
26 args { "-storageDataPath=/metrics"; "-retentionPeriod=30d"; "-usePromCompatibleNaming" }25 args { "-storageDataPath=/metrics"; "-retentionPeriod=30d"; "-usePromCompatibleNaming" }
2726
28 http {27 http {
...@@ -39,7 +38,6 @@ containers {...@@ -39,7 +38,6 @@ containers {
39 ["traces"] {38 ["traces"] {
40 image = "docker.io/victoriametrics/victoria-traces:v0.11.1"39 image = "docker.io/victoriametrics/victoria-traces:v0.11.1"
41 cpu = 30040 cpu = 300
42 memory = 512
43 args { "-storageDataPath=/traces"; "-retentionPeriod=30d" }41 args { "-storageDataPath=/traces"; "-retentionPeriod=30d" }
4442
45 http {43 http {
service/xmpp/prosody.cfg.lua+1-1
...@@ -4,7 +4,7 @@ local network = Lua.require("prosody.util.json").decode(Lua.io.open("/etc/xmpp-n...@@ -4,7 +4,7 @@ local network = Lua.require("prosody.util.json").decode(Lua.io.open("/etc/xmpp-n
44
5data_path = "/var/lib/prosody"5data_path = "/var/lib/prosody"
6pidfile = "/var/lib/prosody/prosody.pid"6pidfile = "/var/lib/prosody/prosody.pid"
7plugin_paths = { "/opt/prosody-modules", "/studio" }7plugin_paths = { "/opt/prosody-modules", "/snowglobe" }
8admins = { "clover@" .. domain }8admins = { "clover@" .. domain }
9bootstrap_password = ENV_XMPP_PASSWORD9bootstrap_password = ENV_XMPP_PASSWORD
10authentication = "internal_hashed"10authentication = "internal_hashed"
service/xmpp/service.pkl+8-8
...@@ -8,7 +8,8 @@ local network = new json.Parser {}.parse(read("network.json").text)...@@ -8,7 +8,8 @@ local network = new json.Parser {}.parse(read("network.json").text)
8local host = read?("prop:hostname") ?? "xmpp.\(site.domain)"8local host = read?("prop:hostname") ?? "xmpp.\(site.domain)"
9local accountDomain = if (site.preview) host else site.domain9local accountDomain = if (site.preview) host else site.domain
1010
11meta { name = "XMPP"; launcher = false }11name = "XMPP"
12launcher = false
12stageIsolation = "fresh"13stageIsolation = "fresh"
13healthyDeadline = "10m"14healthyDeadline = "10m"
14setup = "setup.py"15setup = "setup.py"
...@@ -28,12 +29,12 @@ containers {...@@ -28,12 +29,12 @@ containers {
28 ["certificates"] {29 ["certificates"] {
29 build = "."30 build = "."
30 entrypoint = "/usr/bin/python3"31 entrypoint = "/usr/bin/python3"
31 args { "/studio/run.py"; "certificates" }32 args { "/snowglobe/run.py"; "certificates" }
32 hostNetwork = true33 hostNetwork = true
33 lifecycle = "prestartSidecar"34 lifecycle = "prestartSidecar"
34 cpu = 10035 cpu = 100
35 memory = 25636 memory = 256
36 volumes { ["/tls"] {}; ["/studio"] { config = "runtime" } }37 volumes { ["/tls"] {}; ["/snowglobe"] { config = "runtime" } }
37 env {38 env {
38 ["XMPP_DOMAIN"] = accountDomain39 ["XMPP_DOMAIN"] = accountDomain
39 ["XMPP_HOST"] = host40 ["XMPP_HOST"] = host
...@@ -44,9 +45,8 @@ containers {...@@ -44,9 +45,8 @@ containers {
44 ["prosody"] {45 ["prosody"] {
45 build = "."46 build = "."
46 entrypoint = "/usr/bin/python3"47 entrypoint = "/usr/bin/python3"
47 args { "/studio/run.py"; "prosody" }48 args { "/snowglobe/run.py"; "prosody" }
48 hostNetwork = true49 hostNetwork = true
49 memory = 512
50 http { containerPort = 5280; hostname = host; loopback = true; checkPath = "/health"; forwardRealIp = true }50 http { containerPort = 5280; hostname = host; loopback = true; checkPath = "/health"; forwardRealIp = true }
51 tcp {51 tcp {
52 new { name = "c2s"; containerPort = network.c2s; hostPort = containerPort; loopback = false }52 new { name = "c2s"; containerPort = network.c2s; hostPort = containerPort; loopback = false }
...@@ -56,7 +56,7 @@ containers {...@@ -56,7 +56,7 @@ containers {
56 volumes {56 volumes {
57 ["/var/lib/prosody"] {}57 ["/var/lib/prosody"] {}
58 ["/tls"] { readOnly = true }58 ["/tls"] { readOnly = true }
59 ["/studio"] { config = "runtime" }59 ["/snowglobe"] { config = "runtime" }
60 ["/etc/prosody/prosody.cfg.lua"] { config = "prosody.cfg.lua" }60 ["/etc/prosody/prosody.cfg.lua"] { config = "prosody.cfg.lua" }
61 }61 }
62 env {62 env {
...@@ -72,7 +72,7 @@ containers {...@@ -72,7 +72,7 @@ containers {
72 ["turn"] {72 ["turn"] {
73 build = "."73 build = "."
74 entrypoint = "/usr/bin/python3"74 entrypoint = "/usr/bin/python3"
75 args { "/studio/run.py"; "turn" }75 args { "/snowglobe/run.py"; "turn" }
76 hostNetwork = true76 hostNetwork = true
77 memory = 25677 memory = 256
78 tcp {78 tcp {
...@@ -82,7 +82,7 @@ containers {...@@ -82,7 +82,7 @@ containers {
82 new { name = "relay-\(port)"; containerPort = port; hostPort = port; loopback = false }82 new { name = "relay-\(port)"; containerPort = port; hostPort = port; loopback = false }
83 }83 }
84 }84 }
85 volumes { ["/tls"] { readOnly = true }; ["/studio"] { config = "runtime" } }85 volumes { ["/tls"] { readOnly = true }; ["/snowglobe"] { config = "runtime" } }
86 env { ["XMPP_HOST"] = host; ["TURN_SECRET"] = "${secret.own.turn}" }86 env { ["XMPP_HOST"] = host; ["TURN_SECRET"] = "${secret.own.turn}" }
87 }87 }
88}88}
service/xmpp/setup.py+1-1
...@@ -22,7 +22,7 @@ if len(sys.argv) == 1:...@@ -22,7 +22,7 @@ if len(sys.argv) == 1:
22 sys.exit()22 sys.exit()
2323
24stage = sys.argv[1]24stage = sys.argv[1]
25metadata = Path("/var/lib/studio/stages") / (stage + ".json")25metadata = Path("/var/lib/snowglobe/stages") / (stage + ".json")
26network = json.loads(Path(__file__).with_name("network.json").read_text())26network = json.loads(Path(__file__).with_name("network.json").read_text())
27rules = [27rules = [
28 ["-p", "tcp", "-m", "multiport", "--dports", ",".join(str(network[key]) for key in (28 ["-p", "tcp", "-m", "multiport", "--dports", ",".join(str(network[key]) for key in (
service/ytdl/service.pkl+1-2
...@@ -4,7 +4,7 @@ import "../../config/site.pkl" as site...@@ -4,7 +4,7 @@ import "../../config/site.pkl" as site
44
5local passive = site.preview || site.mediaReadOnly5local passive = site.preview || site.mediaReadOnly
66
7meta { name = "YTDL" }7name = "YTDL"
88
9requiredSecrets {9requiredSecrets {
10 "smtp_host"10 "smtp_host"
...@@ -43,7 +43,6 @@ containers {...@@ -43,7 +43,6 @@ containers {
43 else43 else
44 "sh /config-yt/archive-loop.sh"44 "sh /config-yt/archive-loop.sh"
45 }45 }
46 cpu = 200
47 memory = if (passive) 256 else 51246 memory = if (passive) 256 else 512
4847
49 http = if (passive) new {48 http = if (passive) new {
tools/check-legacy-handoff.sh deleted-24
...@@ -1,24 +0,0 @@
1#!/bin/sh
2set -eu
3
4handoff=${1:?Expected a legacy handoff directory}
5target=${2:?Expected a production target}
6port=${3:?Expected a target SSH port}
7printf '%s\n' "$handoff" | grep -Eq '^/mnt/storage1/apps/studio-handoff/[0-9]{8}T[0-9]{6}Z-[0-9a-f]{6}$' || {
8 echo 'Invalid legacy handoff directory' >&2
9 exit 1
10}
11ssh -p "$port" "$target" "
12 set -eu
13 test -f '$handoff/manifest.json'
14 pool=\$(findmnt -n -o SOURCE --mountpoint /srv)
15 test \"\$(findmnt -n -o FSTYPE --mountpoint /srv)\" = zfs
16 zpool list \"\$pool\" >/dev/null
17 apps=\$(findmnt -n -o SOURCE --mountpoint /mnt/storage1/apps)
18 test \"\$apps\" = \"\$pool/apps\"
19 test \"\$(findmnt -n -o FSTYPE --mountpoint /mnt/storage1/apps)\" = zfs
20 test \"\$(zfs get -H -o value encryption \"\$apps\")\" = aes-256-gcm
21" || {
22 echo 'Legacy handoff or encrypted apps dataset is unavailable' >&2
23 exit 1
24}
tools/configure-arr.py+1-1
...@@ -6,7 +6,7 @@ from urllib.parse import urlsplit, urlunsplit...@@ -6,7 +6,7 @@ from urllib.parse import urlsplit, urlunsplit
6import urllib.request6import urllib.request
7import xml.etree.ElementTree as ET7import xml.etree.ElementTree as ET
88
9from studio import load9from snowglobe import load
1010
1111
12data = json.load(sys.stdin)12data = json.load(sys.stdin)
tools/copyparty-cutover-test.py deleted-299
...@@ -1,299 +0,0 @@
1#!/usr/bin/env python3
2import importlib.util
3import json
4import os
5from pathlib import Path
6import sqlite3
7import sys
8import tempfile
9import unittest
10from unittest.mock import patch
11
12spec = importlib.util.spec_from_file_location('cutover', Path(__file__).with_name('copyparty-cutover.py'))
13cutover = importlib.util.module_from_spec(spec)
14spec.loader.exec_module(cutover)
15copyparty = cutover.copyparty
16public_statuses = cutover.public_statuses
17
18
19class Cutover(unittest.TestCase):
20 def setUp(self):
21 self.temporary = tempfile.TemporaryDirectory(prefix='copyparty-cutover-')
22 self.addCleanup(self.temporary.cleanup)
23 self.base = Path(self.temporary.name)
24 self.root = self.base / 'clover'
25 self.cfg = self.base / 'cfg'
26 (self.root / 'Share').mkdir(parents=True)
27 (self.cfg / 'copyparty').mkdir(parents=True)
28 self.environment = patch.dict(os.environ, {'STUDIO_CLOVER_ROOT': str(self.root), 'STUDIO_COPYPARTY_CFG': str(self.cfg)})
29 self.environment.start()
30 self.addCleanup(self.environment.stop)
31 self.manager = copyparty.Manager([])
32 self.manager.job = {'ID': 'copyparty', 'Stop': False, 'Meta': {'studio_hostname': 'copyparty.example.invalid'}}
33 self.events = []
34 edge = patch.object(cutover, 'public_statuses', side_effect=lambda host, keys, deadline: {key: 200 for key in keys})
35 edge.start()
36 self.addCleanup(edge.stop)
37
38 def stop():
39 self.events.append('stop')
40 if self.manager.offline_at is None:
41 self.manager.offline_at = cutover.time.monotonic()
42 self.manager.stopped = True
43
44 def start():
45 self.events.append('start')
46 self.manager.stopped = False
47
48 self.manager.stop = stop
49 self.manager.start = start
50 for source, _ in cutover.MOVES:
51 path = self.root / source
52 (path / 'nested').mkdir(parents=True)
53 (path / 'selected.txt').write_text('Disposable fixture')
54 (path / 'nested' / 'child.txt').write_text('Disposable child')
55 (self.cfg / 'copyparty.conf').write_text('Fixture configuration')
56 self.database = self.cfg / 'copyparty/shares.db'
57 with sqlite3.connect(self.database) as db:
58 db.executescript("CREATE TABLE kv(k text,v int); INSERT INTO kv VALUES('sver',2); CREATE TABLE sh(k text,pw text,vp text,pr text,st int,un text,t0 int,t1 int); CREATE TABLE sf(k text,vp text);")
59 db.executemany('INSERT INTO sh VALUES(?,?,?,?,?,?,?,?)', [
60 ('folder-key', 'opaque-hash', 'clover/Documents/Public/Snowbound', 'rw', 0, 'snow', 10, 20),
61 ('nested-key', '', 'clover/Documents/Public/Snowbound/nested', 'r', 0, 'snow', 30, 0),
62 ('selected-key', 'another-hash', 'clover/Documents/EvilTakeout', 'r', 1, 'snow', 40, 50),
63 ('unaffected-key', '', 'clover/Other', 'r', 0, 'snow', 60, 0),
64 ])
65 db.execute('INSERT INTO sf VALUES(?,?)', ('selected-key', 'selected.txt'))
66 with sqlite3.connect(self.database) as db:
67 self.original = cutover.rows(db)
68 self.before_content = {str(path.relative_to(self.root)): path.read_bytes() for path in self.root.rglob('*.txt')}
69
70 def test_move_preserves_keys_selections_passwords_inodes_and_content(self):
71 expected = cutover.plan(self.manager)
72 result = cutover.apply(self.manager, expected, self.base / 'backups')
73 self.assertEqual(result['result'], 'moved')
74 self.assertEqual(self.events, ['stop', 'start'])
75 with sqlite3.connect(self.database) as db:
76 actual = cutover.rows(db)
77 self.assertEqual(actual, cutover.remapped(self.manager, self.original, cutover.mappings(self.manager)))
78 self.assertEqual(actual['sf'], self.original['sf'])
79 for detail in expected['moves']:
80 source, destination = Path(detail['source']), Path(detail['destination'])
81 self.assertFalse(source.exists())
82 self.assertEqual(destination.stat().st_ino, detail['inode'])
83 for old_path, contents in self.before_content.items():
84 old = self.root / old_path
85 if old.is_relative_to(source):
86 self.assertEqual((destination / old.relative_to(source)).read_bytes(), contents)
87 backup = Path(result['backup'])
88 for child in backup.iterdir():
89 self.assertEqual(child.stat().st_mode & 0o777, 0o600)
90 self.assertEqual(backup.stat().st_mode & 0o777, 0o700)
91
92 def test_public_probe_sends_bounded_verified_head_and_preserves_redirect_status(self):
93 response = cutover.subprocess.CompletedProcess([], 0, stdout='302', stderr='')
94 with patch.object(cutover.subprocess, 'run', return_value=response) as run:
95 actual = public_statuses('copyparty.example.invalid', ['selected file'], cutover.time.monotonic() + 1)
96 self.assertEqual(actual, {'selected file': 302})
97 arguments = run.call_args.args[0]
98 self.assertEqual(arguments[:2], ['curl', '--disable'])
99 self.assertIn('--head', arguments)
100 self.assertEqual(arguments[arguments.index('--output') + 1], '/dev/null')
101 self.assertEqual(arguments[arguments.index('--write-out') + 1], '%{http_code}')
102 self.assertEqual(arguments[arguments.index('--noproxy') + 1], '*')
103 self.assertEqual(arguments[-2:], ['--', 'https://copyparty.example.invalid/shr/selected%20file/'])
104 self.assertLessEqual(run.call_args.kwargs['timeout'], 1)
105 self.assertEqual(float(arguments[arguments.index('--max-time') + 1]), run.call_args.kwargs['timeout'])
106 for flag in ['--insecure', '-k', '--location', '-L', '--include', '-i']:
107 self.assertNotIn(flag, arguments)
108
109 def test_public_probe_treats_network_tls_and_process_timeout_as_unavailable(self):
110 for response in [
111 cutover.subprocess.CompletedProcess([], 35, stdout='000', stderr='TLS problem'),
112 cutover.subprocess.CompletedProcess([], 28, stdout='200', stderr='Timeout'),
113 cutover.subprocess.CompletedProcess([], 0, stdout='000', stderr=''),
114 cutover.subprocess.CompletedProcess([], 0, stdout='200 headers', stderr=''),
115 ]:
116 with patch.object(cutover.subprocess, 'run', return_value=response):
117 self.assertEqual(public_statuses('host', ['key'], cutover.time.monotonic() + 1), {'key': None})
118 with patch.object(cutover.subprocess, 'run', side_effect=cutover.subprocess.TimeoutExpired('curl', 0.1)):
119 self.assertEqual(public_statuses('host', ['key'], cutover.time.monotonic() + 0.1), {'key': None})
120 with patch.object(cutover.subprocess, 'run') as run:
121 self.assertEqual(public_statuses('host', ['key'], cutover.time.monotonic() - 1), {'key': None})
122 run.assert_not_called()
123
124 def test_stalled_probe_children_cannot_hold_the_executor_past_its_budget(self):
125 run = cutover.subprocess.run
126 def stalled(arguments, **options):
127 return run([sys.executable, '-c', 'import time; time.sleep(10)'], **options)
128 started = cutover.time.monotonic()
129 with patch.object(cutover.subprocess, 'run', side_effect=stalled):
130 actual = public_statuses('host', ['one', 'two'], started + 0.15)
131 self.assertEqual(actual, {'one': None, 'two': None})
132 self.assertLess(cutover.time.monotonic() - started, 1.5)
133
134 def test_public_poll_recovers_and_timeout_obeys_its_budget(self):
135 clock = [0.0]
136 def sleep(delay):
137 clock[0] += delay
138 with patch.object(cutover.time, 'monotonic', side_effect=lambda: clock[0]), patch.object(cutover.time, 'sleep', side_effect=sleep):
139 with patch.object(cutover, 'public_statuses', side_effect=[{'key': 503}, {'key': 200}]):
140 cutover.wait_public('host', {'key': 200}, 1)
141 self.assertEqual(clock[0], 0.5)
142 with patch.object(cutover, 'public_statuses', return_value={'key': None}), self.assertRaises(TimeoutError):
143 cutover.wait_public('host', {'key': 200}, 1)
144 self.assertEqual(clock[0], 1)
145
146 def test_edge_timeout_rolls_back_and_records_recovery_evidence(self):
147 expected = cutover.plan(self.manager)
148 with patch.object(cutover, 'wait_public', side_effect=[TimeoutError('injected edge timeout'), None]):
149 with self.assertRaisesRegex(TimeoutError, 'edge timeout'):
150 cutover.apply(self.manager, expected, self.base / 'backups')
151 self.assertEqual(cutover.plan(self.manager), expected)
152 self.assertEqual(self.events, ['stop', 'start', 'stop', 'start'])
153 evidence = json.loads(next((self.base / 'backups').glob('*/result.json')).read_text())
154 self.assertEqual(evidence['result'], 'rolled-back')
155 self.assertEqual(evidence['publicStatuses'], {key: 200 for key in expected['affectedKeys']})
156
157 def test_existing_grants_follow_moves_and_configuration_is_rerendered(self):
158 source, destination = cutover.mappings(self.manager)[0]
159 state = {'accounts': [], 'grants': [{'id': 'fixture', 'subject': 'user:fixture', 'path': str(source), 'permissions': 'r'}], 'names': {}}
160 (self.cfg / 'manager.json').write_text(json.dumps(state))
161 expected = cutover.plan(self.manager)
162 with patch.object(copyparty.runs, 'nomad', return_value={'Items': {}}), patch.object(copyparty, 'configuration', return_value=b'Updated configuration') as render:
163 cutover.apply(self.manager, expected, self.base / 'backups')
164 saved = json.loads((self.cfg / 'manager.json').read_text())
165 self.assertEqual(saved['grants'][0]['path'], str(destination))
166 self.assertEqual(render.call_args.args[1]['grants'], saved['grants'])
167 self.assertEqual((self.cfg / 'copyparty.conf').read_bytes(), b'Updated configuration')
168
169 def test_failed_restart_restores_files_and_database_before_restart(self):
170 def start():
171 self.events.append('start')
172 if self.events.count('start') == 1:
173 raise RuntimeError('injected startup failure')
174 self.manager.stopped = False
175 self.manager.start = start
176 expected = cutover.plan(self.manager)
177 with self.assertRaisesRegex(RuntimeError, 'injected startup failure'):
178 cutover.apply(self.manager, expected, self.base / 'backups')
179 self.assertEqual(self.events, ['stop', 'start', 'stop', 'start'])
180 self.assertEqual(cutover.plan(self.manager), expected)
181 with sqlite3.connect(self.database) as db:
182 self.assertEqual(cutover.rows(db), self.original)
183 for path, content in self.before_content.items():
184 self.assertEqual((self.root / path).read_bytes(), content)
185
186 def test_rollback_uses_actual_helper_stop_and_start_with_frozen_nomad_job(self):
187 self.manager.stop = copyparty.Manager.stop.__get__(self.manager)
188 self.manager.start = copyparty.Manager.start.__get__(self.manager)
189 self.manager.job = None
190 requests = []
191 def nomad(path, method='GET', body=None, **_):
192 requests.append((path, method, body))
193 if path == 'job/copyparty' and method == 'GET':
194 return {'ID': 'copyparty', 'Stop': False, 'Meta': {'immutable': 'fixture', 'studio_hostname': 'copyparty.example.invalid'}}
195 if path.endswith('/allocations'):
196 return [{'ClientStatus': 'complete'}]
197 if path.startswith('var/'):
198 return {'Items': {'idp_header': 'fixture'}}
199 return {}
200 expected = cutover.plan(self.manager)
201 with patch.object(copyparty.runs, 'nomad', side_effect=nomad), patch.object(self.manager, 'reload', side_effect=[copyparty.Error(400, 'injected reload rejection'), None]):
202 with self.assertRaisesRegex(copyparty.Error, 'injected reload rejection'):
203 cutover.apply(self.manager, expected, self.base / 'backups')
204 self.assertEqual(cutover.plan(self.manager), expected)
205 registrations = [body for path, method, body in requests if path == 'jobs' and method == 'POST']
206 self.assertEqual(registrations, [{'Job': self.manager.job}, {'Job': self.manager.job}])
207 self.assertEqual(len([path for path, method, _ in requests if method == 'DELETE']), 2)
208 self.assertFalse(self.manager.stopped)
209
210 def test_partial_rename_failure_rolls_back_before_start(self):
211 native_rename = copyparty.rename
212 calls = 0
213 def rename(source, destination):
214 nonlocal calls
215 calls += 1
216 if calls == 3:
217 raise RuntimeError('injected third rename failure')
218 self.assertTrue(self.manager.stopped)
219 native_rename(source, destination)
220 expected = cutover.plan(self.manager)
221 with patch.object(copyparty, 'rename', side_effect=rename), self.assertRaisesRegex(RuntimeError, 'third rename'):
222 cutover.apply(self.manager, expected, self.base / 'backups')
223 self.assertEqual(cutover.plan(self.manager), expected)
224 self.assertEqual(self.events, ['stop', 'start'])
225
226 def test_stop_timeout_still_restarts_the_frozen_job(self):
227 def stop():
228 self.manager.offline_at = cutover.time.monotonic()
229 self.manager.stopped = True
230 raise RuntimeError('injected stop timeout')
231 self.manager.stop = stop
232 expected = cutover.plan(self.manager)
233 with self.assertRaisesRegex(RuntimeError, 'stop timeout'):
234 cutover.apply(self.manager, expected, self.base / 'backups')
235 self.assertEqual(self.events, ['start'])
236 self.assertEqual(cutover.plan(self.manager), expected)
237
238 def test_ambiguous_stop_response_reregisters_even_without_stopped_flag(self):
239 def stop():
240 self.manager.offline_at = cutover.time.monotonic()
241 self.manager.stopped = False
242 raise TimeoutError('lost Nomad stop response')
243 self.manager.stop = stop
244 expected = cutover.plan(self.manager)
245 with self.assertRaisesRegex(TimeoutError, 'lost Nomad stop response'):
246 cutover.apply(self.manager, expected, self.base / 'backups')
247 self.assertEqual(self.events, ['start'])
248 self.assertEqual(cutover.plan(self.manager), expected)
249
250 def test_verification_budget_reserves_time_for_restart(self):
251 expected = cutover.plan(self.manager)
252 original_tree = cutover.tree
253 def timed_tree(path, deadline=None):
254 if deadline is not None:
255 raise TimeoutError('injected verification deadline')
256 return original_tree(path)
257 with patch.object(cutover, 'tree', side_effect=timed_tree), self.assertRaisesRegex(TimeoutError, 'verification deadline'):
258 cutover.apply(self.manager, expected, self.base / 'backups')
259 self.assertEqual(self.events, ['stop', 'start'])
260 self.assertEqual(cutover.plan(self.manager), expected)
261
262 def test_source_and_database_drift_stop_before_mutation(self):
263 expected = cutover.plan(self.manager)
264 (self.root / cutover.MOVES[0][0] / 'changed.txt').write_text('Concurrent disposable write')
265 with self.assertRaisesRegex(ValueError, 'plan changed'):
266 cutover.apply(self.manager, expected, self.base / 'backups')
267 self.assertEqual(self.events, [])
268
269 def test_parent_shares_and_parent_selections_require_explicit_url_preservation(self):
270 for selected in [0, 1]:
271 with sqlite3.connect(self.database) as db:
272 db.execute('INSERT OR REPLACE INTO sh VALUES(?,?,?,?,?,?,?,?)', ('parent', '', 'clover/Documents/Public', 'r', selected, 'snow', 1, 0))
273 if selected:
274 db.execute('INSERT INTO sf VALUES(?,?)', ('parent', 'Snowbound'))
275 with self.assertRaisesRegex(ValueError, 'parent of a moved folder'):
276 cutover.plan(self.manager)
277 with sqlite3.connect(self.database) as db:
278 db.execute("DELETE FROM sh WHERE k='parent'")
279 db.execute("DELETE FROM sf WHERE k='parent'")
280
281 def test_symlinks_mounts_and_existing_destinations_reject_before_downtime(self):
282 source, destination = cutover.mappings(self.manager)[0]
283 destination.mkdir()
284 with self.assertRaises(ValueError):
285 cutover.plan(self.manager)
286 destination.rmdir()
287 link = source / 'link'
288 link.symlink_to('selected.txt')
289 with self.assertRaisesRegex(ValueError, 'symbolic link'):
290 cutover.plan(self.manager)
291 link.unlink()
292 with patch.object(cutover.os.path, 'ismount', side_effect=lambda path: Path(path) == source):
293 with self.assertRaises(ValueError):
294 cutover.plan(self.manager)
295 self.assertEqual(self.events, [])
296
297
298if __name__ == '__main__':
299 unittest.main()
tools/copyparty-cutover.py deleted-279
...@@ -1,279 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import concurrent.futures
4import copy
5import hashlib
6import importlib.util
7import json
8import os
9import re
10from pathlib import Path
11import sqlite3
12import socket
13import subprocess
14import stat
15import time
16import uuid
17from urllib.parse import quote
18
19
20spec = importlib.util.spec_from_file_location("copyparty", Path(__file__).resolve().parent.parent / "service/copyparty/manage.py")
21copyparty = importlib.util.module_from_spec(spec)
22spec.loader.exec_module(copyparty)
23
24
25MOVES = (
26 ('Documents/Public/Snowbound', 'Clover - Snowbound'),
27 ('Documents/Public/Meadow', 'Clover - Meadow Chat'),
28 ('Documents/Public/Bill Wurtz Music', 'Xavier - Bill Wurtz Music'),
29 ('Documents/HOTEWIG Reanimated', 'Collab - HOTEWIG Reanimated'),
30 ('Documents/EvilTakeout', 'Lino - Evil Inc Data Takeout'),
31 ('Documents/Windows7', 'Clover - Windows 7'),
32)
33
34
35def digest(value):
36 return hashlib.sha256(json.dumps(value, ensure_ascii=False, separators=(',', ':')).encode()).hexdigest()
37
38
39def rows(database):
40 if database.execute("SELECT v FROM kv WHERE k='sver'").fetchone() != (2,):
41 raise ValueError('Unsupported Copyparty share database version.')
42 return {
43 'sh': database.execute('SELECT * FROM sh ORDER BY k').fetchall(),
44 'sf': database.execute('SELECT * FROM sf ORDER BY k,vp').fetchall(),
45 }
46
47
48def mappings(manager):
49 return [(manager.root / source, manager.root / 'Share' / name) for source, name in MOVES]
50
51
52def remapped(manager, before, moves):
53 after = copy.deepcopy(before)
54 for index, row in enumerate(before['sh']):
55 source_path = manager.real(row[2].strip('/'))
56 for source, destination in moves:
57 if source_path is not None and source_path.is_relative_to(source):
58 changed = list(row)
59 changed[2] = manager.virtual(destination / source_path.relative_to(source))
60 after['sh'][index] = tuple(changed)
61 break
62 if (source_path is not None and source.is_relative_to(source_path)) or row[2].strip('/') == '':
63 raise ValueError('A share includes a parent of a moved folder. Preserve its URL paths before cutover: ' + row[0])
64 return after
65
66
67def tree(path, deadline=None):
68 def unreadable(error):
69 raise error
70
71 result = []
72 for directory, dirs, files in os.walk(path, followlinks=False, onerror=unreadable):
73 if deadline is not None and time.monotonic() >= deadline:
74 raise TimeoutError("Folder verification exceeded the cutover budget.")
75 base = Path(directory)
76 if base != path and os.path.ismount(base):
77 raise ValueError('A source contains a mounted filesystem: ' + str(base))
78 for entry in [base] + [base / name for name in files] + [base / name for name in dirs if (base / name).is_symlink()]:
79 if deadline is not None and time.monotonic() >= deadline:
80 raise TimeoutError("Folder verification exceeded the cutover budget.")
81 info = entry.lstat()
82 if stat.S_ISLNK(info.st_mode):
83 raise ValueError('Review this source symbolic link before cutover: ' + str(entry))
84 result.append((str(entry.relative_to(path)), info.st_dev, info.st_ino, info.st_mode, info.st_size if not stat.S_ISDIR(info.st_mode) else 0, info.st_mtime_ns))
85 dirs[:] = [name for name in dirs if not (base / name).is_symlink()]
86 return sorted(result)
87
88
89def plan(manager, deadline=None):
90 moves = mappings(manager)
91 details = []
92 for source, destination in moves:
93 manager.path_for(str(source))
94 manager.path_for(str(destination), missing=True)
95 if source.is_symlink() or os.path.ismount(source) or os.path.lexists(destination):
96 raise ValueError('A source is mounted or a destination already exists: ' + str(source))
97 source_info, parent_info = source.stat(), destination.parent.stat()
98 if source_info.st_dev != parent_info.st_dev:
99 raise ValueError('Source and destination must be on the same filesystem: ' + str(source))
100 manifest = tree(source, deadline)
101 details.append({'source': str(source), 'destination': str(destination), 'device': source_info.st_dev,
102 'inode': source_info.st_ino, 'entries': len(manifest), 'tree': digest(manifest)})
103 with sqlite3.connect((manager.native / 'shares.db').as_uri() + '?mode=ro', uri=True) as database:
104 before = rows(database)
105 after = remapped(manager, before, moves)
106 return {'host': socket.gethostname(), 'service': manager.service, 'configRoot': str(manager.cfg), 'moves': details, 'shares': len(before['sh']), 'selections': len(before['sf']),
107 'affectedKeys': [old[0] for old, new in zip(before['sh'], after['sh']) if old != new],
108 'sharesBefore': digest(before), 'sharesAfter': digest(after),
109 'config': digest((manager.cfg / 'copyparty.conf').read_text()),
110 'manager': digest((manager.cfg / 'manager.json').read_text() if (manager.cfg / 'manager.json').exists() else None)}
111
112
113def write_database(database, data):
114 current = rows(database)
115 if current['sf'] != data['sf'] or len(current['sh']) != len(data['sh']) or any(
116 old[:2] + old[3:] != new[:2] + new[3:]
117 for old, new in zip(current['sh'], data['sh'])
118 ):
119 raise ValueError('Share keys, selections, passwords, or permissions changed during cutover.')
120 with database:
121 database.executemany('UPDATE sh SET vp=? WHERE k=?', [(row[2], row[0]) for row in data['sh']])
122 if rows(database) != data:
123 raise ValueError('Copyparty share paths changed while the database was being written.')
124
125
126def public_statuses(host, keys, deadline):
127 def head(key):
128 timeout = min(3, deadline - time.monotonic())
129 if timeout <= 0:
130 return key, None
131 try:
132 response = subprocess.run(
133 ['curl', '--disable', '--noproxy', '*', '--silent', '--show-error',
134 '--head', '--output', '/dev/null', '--write-out', '%{http_code}',
135 '--max-time', str(timeout), '--', 'https://' + host + '/shr/' + quote(key, safe='') + '/'],
136 capture_output=True, text=True, timeout=timeout,
137 )
138 status = response.stdout.strip()
139 return key, int(status) if response.returncode == 0 and re.fullmatch(r'[1-5][0-9]{2}', status) else None
140 except (OSError, subprocess.TimeoutExpired):
141 return key, None
142
143 with concurrent.futures.ThreadPoolExecutor(max_workers=4) as workers:
144 return dict(workers.map(head, keys))
145
146
147def wait_public(host, expected, deadline):
148 while time.monotonic() < deadline:
149 if public_statuses(host, expected, deadline) == expected:
150 return
151 time.sleep(min(0.5, max(0, deadline - time.monotonic())))
152 raise TimeoutError('Public share links did not recover before the cutover deadline.')
153
154
155def apply(manager, expected, backup_root):
156 if plan(manager) != expected:
157 raise ValueError('The cutover plan changed. Review a new plan before applying.')
158 if manager.job is None:
159 manager.job = copyparty.runs.nomad('job/' + manager.service)
160 host = (manager.job or {}).get('Meta', {}).get('studio_hostname', '')
161 if not isinstance(host, str) or not re.fullmatch(r'[a-zA-Z0-9.-]+', host):
162 raise ValueError('Copyparty has no public hostname. Check its deployed service route.')
163 manager.job['Stop'] = False
164 baseline = public_statuses(host, expected['affectedKeys'], time.monotonic() + 15)
165 if any(status is None for status in baseline.values()):
166 raise ValueError('Public shares are unavailable. Restore their current routes before cutover.')
167 backup_root.mkdir(parents=True, exist_ok=True, mode=0o700)
168 metadata = backup_root.lstat()
169 if not stat.S_ISDIR(metadata.st_mode) or metadata.st_uid != os.geteuid() or metadata.st_mode & 0o077:
170 raise ValueError('Cutover backups require an owner-only directory.')
171 backup = backup_root / (time.strftime('%Y%m%dT%H%M%SZ', time.gmtime()) + '-' + uuid.uuid4().hex[:8])
172 backup.mkdir(mode=0o700)
173 database_path = manager.native / 'shares.db'
174 saved_files = {}
175 for path in (manager.cfg / 'copyparty.conf', manager.cfg / 'manager.json'):
176 saved_files[path] = path.read_bytes() if path.exists() else None
177 if saved_files[path] is not None:
178 copyparty.atomic(backup / path.name, saved_files[path])
179 copyparty.atomic(backup / 'plan.json', json.dumps(expected, ensure_ascii=False).encode())
180 moved = []
181 before = None
182 database = None
183 manager.deadline = time.monotonic() + 285
184 mutation_deadline = manager.deadline - 205
185 restart_attempted = False
186 try:
187 manager.stop()
188 copyparty.atomic(backup / 'nomad-job.json', json.dumps(manager.job).encode())
189 if plan(manager, mutation_deadline) != expected:
190 raise ValueError('The source files or share rows changed before Copyparty stopped.')
191 database = sqlite3.connect(database_path)
192 before = rows(database)
193 with sqlite3.connect(backup / 'shares.db') as target:
194 database.backup(target)
195 (backup / 'shares.db').chmod(0o600)
196 after = remapped(manager, before, mappings(manager))
197 data_path = manager.cfg / 'manager.json'
198 data = json.loads(saved_files[data_path]) if saved_files[data_path] is not None else None
199 for source, destination in mappings(manager):
200 copyparty.rename(source, destination)
201 moved.append((source, destination))
202 write_database(database, after)
203 if data is not None:
204 for grant in data.get('grants', []):
205 original = Path(grant['path'])
206 for source, destination in mappings(manager):
207 if original.is_relative_to(source):
208 grant['path'] = str(destination / original.relative_to(source))
209 break
210 copyparty.atomic(data_path, json.dumps(data, ensure_ascii=False).encode())
211 variable = copyparty.runs.nomad('var/nomad/jobs/' + manager.service)
212 rendered = copyparty.configuration(manager.cfg, {**data, 'root': str(manager.root)}, variable['Items'])
213 info = (manager.cfg / 'copyparty.conf').stat()
214 copyparty.atomic(manager.cfg / 'copyparty.conf', rendered, (info.st_uid, info.st_gid))
215 for detail in expected['moves']:
216 destination = Path(detail['destination'])
217 if digest(tree(destination, mutation_deadline)) != detail['tree']:
218 raise ValueError('Moved folder metadata changed: ' + str(destination))
219 if digest(rows(database)) != expected['sharesAfter']:
220 raise ValueError('Share keys, selections, passwords, or permissions changed during cutover.')
221 if time.monotonic() >= mutation_deadline:
222 raise TimeoutError("Folder updates exceeded the cutover budget.")
223 restart_attempted = True
224 manager.start()
225 wait_public(host, baseline, manager.offline_at + 150)
226 result = {'result': 'moved', 'moves': len(moved), 'affectedKeys': expected['affectedKeys'], 'backup': str(backup),
227 'downtimeSeconds': time.monotonic() - manager.offline_at, 'publicStatuses': baseline}
228 copyparty.atomic(backup / 'result.json', json.dumps(result).encode())
229 return result
230 except BaseException as failure:
231 if moved or before is not None:
232 if restart_attempted:
233 manager.stop()
234 if database is None:
235 database = sqlite3.connect(database_path)
236 if before is not None:
237 write_database(database, before)
238 for source, destination in reversed(moved):
239 copyparty.rename(destination, source)
240 for path, content in saved_files.items():
241 if content is None:
242 path.unlink(missing_ok=True)
243 else:
244 owner = path.stat()
245 copyparty.atomic(path, content, (owner.st_uid, owner.st_gid))
246 if manager.job is not None:
247 manager.start()
248 wait_public(host, baseline, manager.deadline)
249 evidence = {'result': 'rolled-back', 'reason': str(failure), 'downtimeSeconds': time.monotonic() - manager.offline_at,
250 'publicStatuses': baseline}
251 copyparty.atomic(backup / 'result.json', json.dumps(evidence).encode())
252 raise
253 finally:
254 if database is not None:
255 database.close()
256
257
258def main():
259 parser = argparse.ArgumentParser(description='Review or apply the six Clover share-folder moves.')
260 parser.add_argument('--apply', action='store_true')
261 parser.add_argument('--plan', type=Path, help='Save the reviewed plan, or read it when applying.')
262 args = parser.parse_args()
263 manager = copyparty.Manager([])
264 if args.apply:
265 if args.plan is None:
266 parser.error('--apply requires --plan from the reviewed preflight')
267 lock = os.open(manager.cfg / '.manager.lock', os.O_WRONLY | os.O_CREAT | os.O_NOFOLLOW, 0o600)
268 with os.fdopen(lock, 'w') as locked:
269 copyparty.fcntl.flock(locked, copyparty.fcntl.LOCK_EX)
270 print(json.dumps(apply(manager, json.loads(args.plan.read_text()), Path('/var/lib/studio/copyparty-cutover'))))
271 else:
272 value = plan(manager)
273 if args.plan is not None:
274 copyparty.atomic(args.plan, json.dumps(value, ensure_ascii=False, indent=2).encode())
275 print(json.dumps(value, ensure_ascii=False))
276
277
278if __name__ == '__main__':
279 main()
tools/copyparty-test.py+2-2
...@@ -32,7 +32,7 @@ class Shares(unittest.TestCase):...@@ -32,7 +32,7 @@ class Shares(unittest.TestCase):
32 self.subject = str(uuid.uuid4())32 self.subject = str(uuid.uuid4())
33 self.users = [{'id': self.subject, 'username': 'test-user', 'enabled': True, 'kind': None, 'requiredActions': []}]33 self.users = [{'id': self.subject, 'username': 'test-user', 'enabled': True, 'kind': None, 'requiredActions': []}]
34 self.variable = {'ModifyIndex': 1, 'Items': {'idp_header': 'a' * 32, 'unrelated': 'retained'}}34 self.variable = {'ModifyIndex': 1, 'Items': {'idp_header': 'a' * 32, 'unrelated': 'retained'}}
35 self.environment = patch.dict(os.environ, {'STUDIO_CLOVER_ROOT': str(self.root), 'STUDIO_COPYPARTY_CFG': str(self.cfg)})35 self.environment = patch.dict(os.environ, {'SNOWGLOBE_CLOVER_ROOT': str(self.root), 'SNOWGLOBE_COPYPARTY_CFG': str(self.cfg)})
36 self.environment.start()36 self.environment.start()
37 self.addCleanup(self.environment.stop)37 self.addCleanup(self.environment.stop)
38 self.nomad = patch.object(shares.runs, 'nomad', side_effect=self.request)38 self.nomad = patch.object(shares.runs, 'nomad', side_effect=self.request)
...@@ -312,7 +312,7 @@ class Shares(unittest.TestCase):...@@ -312,7 +312,7 @@ class Shares(unittest.TestCase):
312 clone = self.root.parent / 'clover-clone'312 clone = self.root.parent / 'clover-clone'
313 clone.mkdir()313 clone.mkdir()
314 (clone / 'work').mkdir()314 (clone / 'work').mkdir()
315 with patch.dict(os.environ, {'STUDIO_CLOVER_ROOT': str(clone)}):315 with patch.dict(os.environ, {'SNOWGLOBE_CLOVER_ROOT': str(clone)}):
316 state = self.call('state')316 state = self.call('state')
317 self.assertEqual(state['grants'][0]['path'], str(clone / 'work'))317 self.assertEqual(state['grants'][0]['path'], str(clone / 'work'))
318 self.assertEqual(state['links'][0]['path'], str(clone / 'source'))318 self.assertEqual(state['links'][0]['path'], str(clone / 'source'))
tools/copyparty.md+13-89
...@@ -1,10 +1,9 @@...@@ -1,10 +1,9 @@
1# Copyparty administration and folder cutover1# Copyparty administration
22
3Snowglobe's admin Shares page manages native public links and separate API3Snow Globe's Shares page manages native public links and separate API
4accounts. A person's page assigns folder permissions. Existing Copyparty4accounts. A person's page assigns folder permissions. Existing Copyparty
5permissions remain additive; changing a folder is an explicit retarget or move5permissions remain additive; changing a folder is an explicit retarget or move
6action. New shared folders default to `Share/Name - Description` under Clover.6action. New shared folders default to `Share/Name - Description` under Clover.
7The legacy `clover/Public` mount is retired; use managed links and grants.
87
9Copyparty owns its native `cfg/copyparty/shares.db` and selected-file records.8Copyparty owns its native `cfg/copyparty/shares.db` and selected-file records.
10`cfg/manager.json` stores API account labels, UUID-based folder grants, and link9`cfg/manager.json` stores API account labels, UUID-based folder grants, and link
...@@ -13,89 +12,14 @@ labels. API password hashes live in the service's Nomad variable under...@@ -13,89 +12,14 @@ labels. API password hashes live in the service's Nomad variable under
13config file cannot recover managed accounts. `prepare.py` regenerates config12config file cannot recover managed accounts. `prepare.py` regenerates config
14from the canonical service policy and managed state on every deployment.13from the canonical service policy and managed state on every deployment.
1514
16## Six-folder production move15A folder move must update the native share paths and selected-file records
1716while Copyparty is stopped, preserving keys, passwords, permissions, expirations,
18`copyparty-cutover.py` contains the requested six source/destination pairs.17and selected files. Code rollback does not undo filesystem moves. Rehearse on
19It requires a reviewed plan, absent destinations, and same-filesystem renames.18clones, retain restricted database/config backups, and verify the original
20The plan binds the host, service, roots, source metadata, and complete native19public links after restart. The completed six-folder move's recovery evidence
21share projection. No file contents are read. Public HEAD responses are captured20remains at `/var/lib/snowglobe/copyparty-cutover/20261016T082910Z-424b5410`.
22before stopping the service and verified after restart; existing keys,21
23passwords, permissions, expirations, and selected-file records must agree.22The privileged host unit reaches Copyparty through Podman's declared bridge
2423subnet. A loopback-only network allowlist prevents configuration reloads even
25Run the script from the reviewed immutable release on the confirmed target:24when its destination is a loopback-forwarded container port. Keep the derived
2625bridge access when changing host restrictions.
27```sh
28umask 077
29python3 tools/copyparty-cutover.py --plan /root/copyparty-cutover-plan.json
30python3 tools/copyparty-cutover.py --apply --plan /root/copyparty-cutover-plan.json
31```
32
33Copyparty remains stopped through all folder and database changes. A mismatch
34restores the old paths and records before restarting the frozen original job.
35Mutation verification has an 80-second cutoff; public readiness has a
36150-second forward deadline, leaving recovery time within the 285-second
37overall budget. Restricted backups and result evidence live under
38`/var/lib/studio/copyparty-cutover`. Code rollback does not undo this file move.
39
40## 2026-10-16 staging evidence
41
42Zenith preview `copyparty-preview-9909de81` verified API account scope,
43permission changes, password/session revocation, signed UUID identity grants,
44symlink confinement, selected-file retention, and nested public links. A
45disposable offline move completed in 6.94 seconds. The six requested clone
46folders were then renamed with unchanged inode/metadata manifests: all 20
47share records and four selected-file rows matched the expected path-only
48projection, and all nine affected public URLs returned their original 200
49responses within a 78.2-second upper bound. Production source metadata and
50share records remained unchanged during rehearsal.
51
52## 2026-10-16 production evidence
53
54Release `765dec72842b4d08` deployed described main revision
55`e0cc66a00eb2757846148a241961225d1f9b1253`. All production routes passed
56the release workflow's checks. The canonical host unit now serves share
57operations; obsolete Win10/ARM host overrides were archived with the release
58backup after their effective VM code matched main byte for byte.
59
60The six requested folders moved to `Share` with their requested names.
61All 2,184 metadata entries retained their device, inode, mode, size, and mtime.
62All 20 native shares and four selected-file rows matched the path-only
63projection, and all nine affected public URLs returned their original 200
64responses. Meadow had no native public link; its folder moved without creating
65one. Copyparty remained stopped throughout the folder and database changes.
66
67The move's stop-to-public-readiness interval was 13.44 seconds. Independent
68one-second HTTPS HEAD sampling bounded total public unavailability across
69release activation and the move to 55.12 seconds over three intervals.
70Restricted plan, database/config backups, frozen job, and result evidence are
71in `/var/lib/studio/copyparty-cutover/20261016T082910Z-424b5410`.
72
73## 2026-10-16 account creation timeout
74
75The production host unit allowed only loopback traffic, but Podman's loopback
76port forwarding translates requests onto its bridge. A read-only health probe
77under the same IP restrictions timed out after 3.003 seconds; allowing the
78existing Podman subnet returned HTTP 200 in 0.0013 seconds. Account creation
79waited for config reload and its recovery reload before returning an error.
80The host allowlist now derives the bridge range from the declared Podman default
81subnet, preserving the existing network.
82
83The hardened preview created an account in 0.54 seconds and rotated its
84password in 0.60 seconds. Double-clicked submits sent one request each.
85Shares-list checks also caught absolute copy-status text expanding the document
86outside its scroller. Anchoring that hidden text and bounding the list during
87refresh errors kept the document at 720 × 320 in a 720 × 320 viewport, with
88only the table scrolling. Its headers and last-row keyboard actions stayed
89reachable; the hidden live status remained in the accessibility tree.
90
91Production account creation completed in 0.60 seconds, rotation in 0.47
92seconds, and deletion in 0.15 seconds under the effective host restrictions.
93The disposable account was removed; shares and grants remained unchanged.
94
95The first rollout, `a8982234e99ab23c`, also exported newer sibling Clover DB
96sources. That image failed before database startup because its nonroot user
97could not create its launcher cache. Clover DB was restored through the
98previous immutable release's service deployment. Its newer source also carries
99database migrations outside this change's scope. The build manifest now pins
100sitegen revision `13f64d71038f5e72ab34dc1f55805e2fee05f368`; all 183 exported
101files, file types, and executable bits match the previous healthy context.
tools/dashboard-auth-test.py+5-5
...@@ -62,9 +62,9 @@ def main():...@@ -62,9 +62,9 @@ def main():
62 proof = uuid.uuid4().hex + uuid.uuid4().hex62 proof = uuid.uuid4().hex + uuid.uuid4().hex
63 (data / 'proof').write_text(proof)63 (data / 'proof').write_text(proof)
64 (data / 'source.json').write_text(json.dumps(export))64 (data / 'source.json').write_text(json.dumps(export))
65 environment = {**os.environ, 'STUDIO_DOMAIN': 'paperclover.net', 'STUDIO_DATA_DIR': str(data),65 environment = {**os.environ, 'SNOWGLOBE_DOMAIN': 'paperclover.net', 'SNOWGLOBE_DATA_DIR': str(data),
66 'STUDIO_PUBLIC_ORIGIN': origin, 'STUDIO_AUTH_RP_ID': rp, 'STUDIO_FILE_ORIGIN': file,66 'SNOWGLOBE_PUBLIC_ORIGIN': origin, 'SNOWGLOBE_AUTH_RP_ID': rp, 'SNOWGLOBE_FILE_ORIGIN': file,
67 'STUDIO_WEB_DIR': str(Path('dashboard/dist').resolve()), 'STUDIO_PROXY_TOKEN_FILE': str(data / 'proof'), 'STUDIO_AUTH_REQUIRED': '1'}67 'SNOWGLOBE_WEB_DIR': str(Path('dashboard/dist').resolve()), 'SNOWGLOBE_PROXY_TOKEN_FILE': str(data / 'proof'), 'SNOWGLOBE_AUTH_REQUIRED': '1'}
68 binary = str(args.binary.resolve())68 binary = str(args.binary.resolve())
69 imported = subprocess.run([binary, '--import-accounts', str(data / 'source.json')], env=environment, capture_output=True, text=True)69 imported = subprocess.run([binary, '--import-accounts', str(data / 'source.json')], env=environment, capture_output=True, text=True)
70 assert imported.returncode == 0, imported.stderr70 assert imported.returncode == 0, imported.stderr
...@@ -97,7 +97,7 @@ def main():...@@ -97,7 +97,7 @@ def main():
97 server.terminate(); server.wait(timeout=10)97 server.terminate(); server.wait(timeout=10)
9898
99 def request(path, method='GET', body=None, cookies=None, status=200, extra=None, host=origin, include_headers=False):99 def request(path, method='GET', body=None, cookies=None, status=200, extra=None, host=origin, include_headers=False):
100 headers = {'Studio-Proxy-Token': proof, 'Host': host.split('://')[1], 'X-Studio-Client-IP': '127.0.0.1'}100 headers = {'Snowglobe-Proxy-Token': proof, 'Host': host.split('://')[1], 'X-Snowglobe-Client-IP': '127.0.0.1'}
101 if body is not None: headers.update({'Origin': origin, 'Content-Type': 'application/json'})101 if body is not None: headers.update({'Origin': origin, 'Content-Type': 'application/json'})
102 if cookies: headers['Cookie'] = '; '.join(f'{k}={v}' for k, v in cookies.items())102 if cookies: headers['Cookie'] = '; '.join(f'{k}={v}' for k, v in cookies.items())
103 headers.update(extra or {})103 headers.update(extra or {})
...@@ -120,7 +120,7 @@ def main():...@@ -120,7 +120,7 @@ def main():
120 request('/api/account/pictures/missing', status=404)120 request('/api/account/pictures/missing', status=404)
121 request('/api/me', status=401, extra={'User-Name': name, 'User-Groups': 'infra-admin'})121 request('/api/me', status=401, extra={'User-Name': name, 'User-Groups': 'infra-admin'})
122 request('/api/shares', status=401, extra={'User-Name': name, 'User-Groups': 'infra-admin'})122 request('/api/shares', status=401, extra={'User-Name': name, 'User-Groups': 'infra-admin'})
123 request('/auth/status', status=403, extra={'Studio-Proxy-Token': 'wrong'})123 request('/auth/status', status=403, extra={'Snowglobe-Proxy-Token': 'wrong'})
124 csrf = request('/auth/status', cookies=cookies)['csrf']124 csrf = request('/auth/status', cookies=cookies)['csrf']
125 csrf_headers = request('/auth/status', cookies=cookies, include_headers=True)125 csrf_headers = request('/auth/status', cookies=cookies, include_headers=True)
126 assert csrf_headers['set-cookie'].startswith('__Host-snow-csrf=')126 assert csrf_headers['set-cookie'].startswith('__Host-snow-csrf=')
tools/dashboard-backup-test.py+6-3
...@@ -33,11 +33,14 @@ def main():...@@ -33,11 +33,14 @@ def main():
33 assert db.execute('SELECT value FROM durable').fetchall() == [(name,)]33 assert db.execute('SELECT value FROM durable').fetchall() == [(name,)]
34 revision = 'a' * 1634 revision = 'a' * 16
35 (directory / 'manifest.json').write_text(json.dumps({'id': backup_id, 'fromRelease': revision, 'services': {'dashboard': {'files': files}}}))35 (directory / 'manifest.json').write_text(json.dumps({'id': backup_id, 'fromRelease': revision, 'services': {'dashboard': {'files': files}}}))
36 data.current_release = lambda: Path('/releases') / revision36 active = data.STATE / "releases" / revision
37 (active / "tools").mkdir(parents=True)
38 (active / "tools/snowglobe.py").touch()
39 data.current_release = lambda: active
37 lifecycle = []40 lifecycle = []
38 def run(*args, **kwargs):41 def run(*args, **kwargs):
39 lifecycle.append(args)42 lifecycle.append(args)
40 if args == ('systemctl', 'stop', 'studio-dashboard'):43 if args == ('systemctl', 'stop', 'snowglobe-dashboard'):
41 for db in connections:44 for db in connections:
42 db.close()45 db.close()
43 data.run = run46 data.run = run
...@@ -47,7 +50,7 @@ def main():...@@ -47,7 +50,7 @@ def main():
47 db.commit()50 db.commit()
48 (live / 'pictures' / 'avatar').write_bytes(b'later picture')51 (live / 'pictures' / 'avatar').write_bytes(b'later picture')
49 data.restore(backup_id, 'dashboard')52 data.restore(backup_id, 'dashboard')
50 assert lifecycle == [('systemctl', 'stop', 'studio-dashboard'), ('systemctl', 'start', 'studio-dashboard'), ('systemctl', 'is-active', '--quiet', 'studio-dashboard')]53 assert lifecycle == [('systemctl', 'stop', 'snowglobe-dashboard'), ('systemctl', 'start', 'snowglobe-dashboard'), ('systemctl', 'is-active', '--quiet', 'snowglobe-dashboard')]
51 assert (live / 'pictures' / 'avatar').read_bytes() == b'original picture'54 assert (live / 'pictures' / 'avatar').read_bytes() == b'original picture'
52 for name in ['accounts.sqlite', 'connections.sqlite']:55 for name in ['accounts.sqlite', 'connections.sqlite']:
53 with sqlite3.connect(live / name) as db:56 with sqlite3.connect(live / name) as db:
tools/dashboard-bench.py+1-1
...@@ -12,7 +12,7 @@ parser = argparse.ArgumentParser(description=__doc__)...@@ -12,7 +12,7 @@ parser = argparse.ArgumentParser(description=__doc__)
12parser.add_argument("--clients", type=int, default=24)12parser.add_argument("--clients", type=int, default=24)
13parser.add_argument("--rounds", type=int, default=20)13parser.add_argument("--rounds", type=int, default=20)
14parser.add_argument("--port", type=int, default=7072)14parser.add_argument("--port", type=int, default=7072)
15parser.add_argument("--unit", default="studio-dashboard.service")15parser.add_argument("--unit", default="snowglobe-dashboard.service")
16parser.add_argument("--include-files", action="store_true")16parser.add_argument("--include-files", action="store_true")
17args = parser.parse_args()17args = parser.parse_args()
18if args.clients < 1 or args.rounds < 1:18if args.clients < 1 or args.rounds < 1:
tools/dashboard-browser-test.py+6-6
...@@ -23,7 +23,7 @@ def main():...@@ -23,7 +23,7 @@ def main():
23 original = routes.read_bytes()23 original = routes.read_bytes()
24 metadata = routes.stat()24 metadata = routes.stat()
25 candidate = router.render(Path(router.TOKEN).read_text().strip())25 candidate = router.render(Path(router.TOKEN).read_text().strip())
26 start = "globe." + os.environ["STUDIO_DOMAIN"] + " {"26 start = "globe." + os.environ["SNOWGLOBE_DOMAIN"] + " {"
27 begin = original.index(start.encode())27 begin = original.index(start.encode())
28 depth = 028 depth = 0
29 end = None29 end = None
...@@ -33,9 +33,9 @@ def main():...@@ -33,9 +33,9 @@ def main():
33 end = position + 133 end = position + 1
34 break34 break
35 assert end is not None35 assert end is not None
36 replacement = candidate[candidate.index(start):candidate.index("dashboard.internal." + os.environ["STUDIO_DOMAIN"] + ":")].strip().encode()36 replacement = candidate[candidate.index(start):candidate.index("dashboard.internal." + os.environ["SNOWGLOBE_DOMAIN"] + ":")].strip().encode()
37 content = original[:begin] + replacement + original[end:]37 content = original[:begin] + replacement + original[end:]
38 active = subprocess.run(["systemctl", "is-active", "studio-router"], capture_output=True).returncode == 038 active = subprocess.run(["systemctl", "is-active", "snowglobe-router"], capture_output=True).returncode == 0
39 pending = routes.with_name("routes.browser-test.pending")39 pending = routes.with_name("routes.browser-test.pending")
4040
41 def install(value):41 def install(value):
...@@ -47,9 +47,9 @@ def main():...@@ -47,9 +47,9 @@ def main():
4747
48 try:48 try:
49 if active:49 if active:
50 subprocess.run(["systemctl", "stop", "studio-router"], check=True, capture_output=True, timeout=30)50 subprocess.run(["systemctl", "stop", "snowglobe-router"], check=True, capture_output=True, timeout=30)
51 install(content)51 install(content)
52 args.ready_file.write_text(json.dumps({"origin": "https://globe." + os.environ["STUDIO_DOMAIN"], "ready": True}) + "\n")52 args.ready_file.write_text(json.dumps({"origin": "https://globe." + os.environ["SNOWGLOBE_DOMAIN"], "ready": True}) + "\n")
53 args.ready_file.chmod(0o600)53 args.ready_file.chmod(0o600)
54 deadline = time.monotonic() + args.timeout54 deadline = time.monotonic() + args.timeout
55 while not stop.exists() and time.monotonic() < deadline:55 while not stop.exists() and time.monotonic() < deadline:
...@@ -60,7 +60,7 @@ def main():...@@ -60,7 +60,7 @@ def main():
60 assert hashlib.sha256(routes.read_bytes()).digest() == hashlib.sha256(original).digest()60 assert hashlib.sha256(routes.read_bytes()).digest() == hashlib.sha256(original).digest()
61 finally:61 finally:
62 if active:62 if active:
63 subprocess.run(["systemctl", "start", "studio-router"], check=True, capture_output=True, timeout=30)63 subprocess.run(["systemctl", "start", "snowglobe-router"], check=True, capture_output=True, timeout=30)
64 pending.unlink(missing_ok=True)64 pending.unlink(missing_ok=True)
65 args.ready_file.unlink(missing_ok=True)65 args.ready_file.unlink(missing_ok=True)
66 stop.unlink(missing_ok=True)66 stop.unlink(missing_ok=True)
tools/dashboard-deploy-test.py+15-15
...@@ -18,7 +18,7 @@ host = importlib.import_module("dashboard-host")...@@ -18,7 +18,7 @@ host = importlib.import_module("dashboard-host")
1818
19class DeploymentBoundary(unittest.TestCase):19class DeploymentBoundary(unittest.TestCase):
20 def setUp(self):20 def setUp(self):
21 self.temporary = tempfile.TemporaryDirectory(prefix="studio-deploy-boundary-")21 self.temporary = tempfile.TemporaryDirectory(prefix="snowglobe-deploy-boundary-")
22 self.addCleanup(self.temporary.cleanup)22 self.addCleanup(self.temporary.cleanup)
23 self.root = Path(self.temporary.name).resolve()23 self.root = Path(self.temporary.name).resolve()
24 self.state = self.root / "state"24 self.state = self.root / "state"
...@@ -31,7 +31,7 @@ class DeploymentBoundary(unittest.TestCase):...@@ -31,7 +31,7 @@ class DeploymentBoundary(unittest.TestCase):
31 context = patch.object(release, name, value)31 context = patch.object(release, name, value)
32 context.start()32 context.start()
33 self.addCleanup(context.stop)33 self.addCleanup(context.stop)
34 self.host = host.Host("studio-demo")34 self.host = host.Host("snowglobe-demo")
35 state_context = patch.object(runs, "HOST_STATE", self.state / "host")35 state_context = patch.object(runs, "HOST_STATE", self.state / "host")
36 state_context.start()36 state_context.start()
37 self.addCleanup(state_context.stop)37 self.addCleanup(state_context.stop)
...@@ -44,8 +44,8 @@ class DeploymentBoundary(unittest.TestCase):...@@ -44,8 +44,8 @@ class DeploymentBoundary(unittest.TestCase):
44 path.write_text("fixture")44 path.write_text("fixture")
45 else:45 else:
46 path.mkdir()46 path.mkdir()
47 (self.snapshot / "tools/studio.py").write_text("print('fixture')")47 (self.snapshot / "tools/snowglobe.py").write_text("print('fixture')")
48 (self.snapshot / ".studio-release.json").write_text(json.dumps({"id": self.version, "digest": release.tree_digest(self.snapshot), "version": 2, "main": {"commit": "b" * 40, "description": "Fixture main"}}))48 (self.snapshot / ".snowglobe-release.json").write_text(json.dumps({"id": self.version, "digest": release.tree_digest(self.snapshot), "version": 2, "main": {"commit": "b" * 40, "description": "Fixture main"}}))
49 (self.state / "stages").mkdir()49 (self.state / "stages").mkdir()
50 self.stage = "fixture-preview"50 self.stage = "fixture-preview"
51 self.stage_file = self.state / "stages" / (self.stage + ".json")51 self.stage_file = self.state / "stages" / (self.stage + ".json")
...@@ -76,13 +76,13 @@ class DeploymentBoundary(unittest.TestCase):...@@ -76,13 +76,13 @@ class DeploymentBoundary(unittest.TestCase):
76 executed.assert_not_called()76 executed.assert_not_called()
7777
78 def test_commands_come_from_verified_releases_and_history(self):78 def test_commands_come_from_verified_releases_and_history(self):
79 self.assertEqual(runs.command("destroy", self.stage)[1:], [str(self.snapshot / "tools/studio.py"), "destroy", self.stage])79 self.assertEqual(runs.command("destroy", self.stage)[1:], [str(self.snapshot / "tools/snowglobe.py"), "destroy", self.stage])
80 self.assertEqual(runs.command("deploy", self.version)[1:], [str(Path(runs.__file__).with_name("release.py")), "deploy", self.version])80 self.assertEqual(runs.command("deploy", self.version)[1:], [str(Path(runs.__file__).with_name("release.py")), "deploy", self.version])
81 self.assertEqual(runs.command("rollback", "1")[1:], [str(Path(runs.__file__).with_name("release.py")), "rollback", self.version])81 self.assertEqual(runs.command("rollback", "1")[1:], [str(Path(runs.__file__).with_name("release.py")), "rollback", self.version])
82 self.assertEqual(runs.command("start", "fixture")[1:], [str(self.snapshot / "tools/studio.py"), "deploy", "fixture"])82 self.assertEqual(runs.command("start", "fixture")[1:], [str(self.snapshot / "tools/snowglobe.py"), "deploy", "fixture"])
83 self.assertEqual(runs.command("stop", "fixture"), ["nomad", "job", "stop", "-yes", "fixture"])83 self.assertEqual(runs.command("stop", "fixture"), ["nomad", "job", "stop", "-yes", "fixture"])
84 self.assertEqual(runs.command("restart", "fixture"), ["nomad", "job", "restart", "-yes", "fixture"])84 self.assertEqual(runs.command("restart", "fixture"), ["nomad", "job", "restart", "-yes", "fixture"])
85 (self.snapshot / "tools/studio.py").write_text("changed")85 (self.snapshot / "tools/snowglobe.py").write_text("changed")
86 for action, target in [("destroy", self.stage), ("deploy", self.version), ("rollback", "1"), ("start", "fixture")]:86 for action, target in [("destroy", self.stage), ("deploy", self.version), ("rollback", "1"), ("start", "fixture")]:
87 with self.subTest(action=action), self.assertRaisesRegex(ValueError, "contents changed"):87 with self.subTest(action=action), self.assertRaisesRegex(ValueError, "contents changed"):
88 runs.command(action, target)88 runs.command(action, target)
...@@ -91,11 +91,11 @@ class DeploymentBoundary(unittest.TestCase):...@@ -91,11 +91,11 @@ class DeploymentBoundary(unittest.TestCase):
91 with patch.object(release, "SOURCES", tuple(name for name in release.SOURCES if name != "guest")):91 with patch.object(release, "SOURCES", tuple(name for name in release.SOURCES if name != "guest")):
92 digest = release.tree_digest(self.snapshot)92 digest = release.tree_digest(self.snapshot)
93 shutil.rmtree(self.snapshot / "guest")93 shutil.rmtree(self.snapshot / "guest")
94 manifest = self.snapshot / ".studio-release.json"94 manifest = self.snapshot / ".snowglobe-release.json"
95 details = json.loads(manifest.read_text())95 details = json.loads(manifest.read_text())
96 details["digest"] = digest96 details["digest"] = digest
97 manifest.write_text(json.dumps(details))97 manifest.write_text(json.dumps(details))
98 self.assertEqual(runs.command("destroy", self.stage)[1:], [str(self.snapshot / "tools/studio.py"), "destroy", self.stage])98 self.assertEqual(runs.command("destroy", self.stage)[1:], [str(self.snapshot / "tools/snowglobe.py"), "destroy", self.stage])
99 shutil.rmtree(self.snapshot / "tools")99 shutil.rmtree(self.snapshot / "tools")
100 with self.assertRaisesRegex(ValueError, "contents changed"):100 with self.assertRaisesRegex(ValueError, "contents changed"):
101 runs.command("destroy", self.stage)101 runs.command("destroy", self.stage)
...@@ -137,7 +137,7 @@ class DeploymentBoundary(unittest.TestCase):...@@ -137,7 +137,7 @@ class DeploymentBoundary(unittest.TestCase):
137 with self.assertRaisesRegex(ValueError, "main changed"):137 with self.assertRaisesRegex(ValueError, "main changed"):
138 release.main()138 release.main()
139 activate.assert_not_called()139 activate.assert_not_called()
140 manifest = self.snapshot / ".studio-release.json"140 manifest = self.snapshot / ".snowglobe-release.json"
141 original = json.loads(manifest.read_text())141 original = json.loads(manifest.read_text())
142 for revision in [None, {"commit": "b" * 40, "description": " "}, {"commit": "escape", "description": "main"}]:142 for revision in [None, {"commit": "b" * 40, "description": " "}, {"commit": "escape", "description": "main"}]:
143 manifest.write_text(json.dumps({**original, "main": revision}))143 manifest.write_text(json.dumps({**original, "main": revision}))
...@@ -169,7 +169,7 @@ class DeploymentBoundary(unittest.TestCase):...@@ -169,7 +169,7 @@ class DeploymentBoundary(unittest.TestCase):
169 output = 'job "fixture" {\n' if argv[-1] == "render" else '"leader"'169 output = 'job "fixture" {\n' if argv[-1] == "render" else '"leader"'
170 return subprocess.CompletedProcess(argv, 0, stdout=output, stderr="")170 return subprocess.CompletedProcess(argv, 0, stdout=output, stderr="")
171171
172 with patch.object(release.subprocess, "run", side_effect=execute):172 with patch.object(release.subprocess, "run", side_effect=execute), patch.object(release, "host_configuration", return_value="snowglobe"), patch.object(release.transition, "activate"):
173 self.assertIsNone(release.activate(self.version, initial=True))173 self.assertIsNone(release.activate(self.version, initial=True))
174 self.assertEqual(release.current_release(), self.version)174 self.assertEqual(release.current_release(), self.version)
175175
...@@ -205,7 +205,7 @@ class DeploymentBoundary(unittest.TestCase):...@@ -205,7 +205,7 @@ class DeploymentBoundary(unittest.TestCase):
205 root = runs.HOST_STATE205 root = runs.HOST_STATE
206 (root / "runs").mkdir(exist_ok=True)206 (root / "runs").mkdir(exist_ok=True)
207 (root / "runs" / (started["id"] + ".log")).write_text("fixture\n")207 (root / "runs" / (started["id"] + ".log")).write_text("fixture\n")
208 restored = host.Host("studio-demo")208 restored = host.Host("snowglobe-demo")
209 active = subprocess.CompletedProcess([], 0, stdout="ActiveState=active\nExecMainStatus=0\nLoadState=loaded\n")209 active = subprocess.CompletedProcess([], 0, stdout="ActiveState=active\nExecMainStatus=0\nLoadState=loaded\n")
210 with patch.object(runs.subprocess, "run", return_value=active):210 with patch.object(runs.subprocess, "run", return_value=active):
211 self.assertEqual(restored.handle({"operation": "deploy.last"}), {**started, "code": None})211 self.assertEqual(restored.handle({"operation": "deploy.last"}), {**started, "code": None})
...@@ -249,7 +249,7 @@ class DeploymentBoundary(unittest.TestCase):...@@ -249,7 +249,7 @@ class DeploymentBoundary(unittest.TestCase):
249249
250 def test_secret_scope_and_compare_and_set_preserve_siblings(self):250 def test_secret_scope_and_compare_and_set_preserve_siblings(self):
251 (self.state / "nomad.token").write_text("private-fixture-token")251 (self.state / "nomad.token").write_text("private-fixture-token")
252 job = {"Meta": {"studio_secrets": json.dumps([{"name": "token", "generated": True, "bytes": 16}])}}252 job = {"Meta": {"snowglobe_secrets": json.dumps([{"name": "token", "generated": True, "bytes": 16}])}}
253 existing = {"ModifyIndex": 7, "Items": {"token": "old", "sibling": "keep", "undeclared": "private"}}253 existing = {"ModifyIndex": 7, "Items": {"token": "old", "sibling": "keep", "undeclared": "private"}}
254 with patch.object(runs, "nomad", side_effect=[job, existing]) as requested:254 with patch.object(runs, "nomad", side_effect=[job, existing]) as requested:
255 self.assertEqual(runs.secret("get", "fixture", "token"), "old")255 self.assertEqual(runs.secret("get", "fixture", "token"), "old")
...@@ -266,11 +266,11 @@ class DeploymentBoundary(unittest.TestCase):...@@ -266,11 +266,11 @@ class DeploymentBoundary(unittest.TestCase):
266 def test_rotations_use_the_recorded_size_and_refuse_external_secrets(self):266 def test_rotations_use_the_recorded_size_and_refuse_external_secrets(self):
267 (self.state / "nomad.token").write_text("private-fixture-token")267 (self.state / "nomad.token").write_text("private-fixture-token")
268 for generated, count in [(False, 16), (True, True), (True, 4097), (True, 0)]:268 for generated, count in [(False, 16), (True, True), (True, 4097), (True, 0)]:
269 job = {"Meta": {"studio_secrets": json.dumps([{"name": "token", "generated": generated, "bytes": count}])}}269 job = {"Meta": {"snowglobe_secrets": json.dumps([{"name": "token", "generated": generated, "bytes": count}])}}
270 with patch.object(runs, "nomad", side_effect=[job, None]) as requested, self.assertRaises(runs.Error):270 with patch.object(runs, "nomad", side_effect=[job, None]) as requested, self.assertRaises(runs.Error):
271 runs.secret("rotate", "fixture", "token")271 runs.secret("rotate", "fixture", "token")
272 self.assertEqual(requested.call_count, 2)272 self.assertEqual(requested.call_count, 2)
273 job = {"Meta": {"studio_secrets": '[{"name":"token","generated":true,"bytes":16}]'}}273 job = {"Meta": {"snowglobe_secrets": '[{"name":"token","generated":true,"bytes":16}]'}}
274 with patch.object(runs, "nomad", side_effect=[job, None, {}]) as requested, patch.object(runs.subprocess, "run", return_value=subprocess.CompletedProcess([], 0)):274 with patch.object(runs, "nomad", side_effect=[job, None, {}]) as requested, patch.object(runs.subprocess, "run", return_value=subprocess.CompletedProcess([], 0)):
275 runs.secret("rotate", "fixture", "token")275 runs.secret("rotate", "fixture", "token")
276 value = requested.call_args.args[2]["Items"]["token"]276 value = requested.call_args.args[2]["Items"]["token"]
tools/dashboard-deploy-vm-test.py+12-12
...@@ -29,7 +29,7 @@ def main():...@@ -29,7 +29,7 @@ def main():
29 service_id = "boundary-service-" + suffix29 service_id = "boundary-service-" + suffix
30 managed_file = release.STATE / "managed-jobs.json"30 managed_file = release.STATE / "managed-jobs.json"
31 managed_bytes = managed_file.read_bytes()31 managed_bytes = managed_file.read_bytes()
32 container = "studio-dashboard-deploy-test-" + suffix32 container = "snowglobe-dashboard-deploy-test-" + suffix
33 current = release.current_release()33 current = release.current_release()
34 history_bytes = release.HISTORY.read_bytes()34 history_bytes = release.HISTORY.read_bytes()
35 stages_before = {path.name for path in (release.STATE / "stages").glob("*.json")}35 stages_before = {path.name for path in (release.STATE / "stages").glob("*.json")}
...@@ -55,7 +55,7 @@ def main():...@@ -55,7 +55,7 @@ def main():
55 def http(path, body=None, status=200, section="deploys", groups="infra-admin", method=None):55 def http(path, body=None, status=200, section="deploys", groups="infra-admin", method=None):
56 request = urllib.request.Request("http://127.0.0.1:7076/api/" + section + path,56 request = urllib.request.Request("http://127.0.0.1:7076/api/" + section + path,
57 data=json.dumps(body).encode() if body is not None else None, method=method,57 data=json.dumps(body).encode() if body is not None else None, method=method,
58 headers={"User-Name": "fixture", "User-Groups": groups, "Studio-Proxy-Token": proof, "Content-Type": "application/json"})58 headers={"User-Name": "fixture", "User-Groups": groups, "Snowglobe-Proxy-Token": proof, "Content-Type": "application/json"})
59 try:59 try:
60 response = urllib.request.urlopen(request, timeout=40)60 response = urllib.request.urlopen(request, timeout=40)
61 except urllib.error.HTTPError as error:61 except urllib.error.HTTPError as error:
...@@ -95,7 +95,7 @@ def main():...@@ -95,7 +95,7 @@ def main():
95 time.sleep(.1)95 time.sleep(.1)
96 raise AssertionError("container deployment view did not start")96 raise AssertionError("container deployment view did not start")
9797
98 with tempfile.TemporaryDirectory(prefix="studio-deploy-boundary-", dir="/run") as temporary:98 with tempfile.TemporaryDirectory(prefix="snowglobe-deploy-boundary-", dir="/run") as temporary:
99 data = Path(temporary) / "data"99 data = Path(temporary) / "data"
100 data.mkdir()100 data.mkdir()
101 os.chown(data, 65534, 65534)101 os.chown(data, 65534, 65534)
...@@ -139,24 +139,24 @@ def main():...@@ -139,24 +139,24 @@ def main():
139 path.write_text("fixture")139 path.write_text("fixture")
140 else:140 else:
141 path.mkdir()141 path.mkdir()
142 script = fixture_release / "tools/studio.py"142 script = fixture_release / "tools/snowglobe.py"
143 script.write_text("import time\ntime.sleep(3)\nprint('approved fixture worker')\n")143 script.write_text("import time\ntime.sleep(3)\nprint('approved fixture worker')\n")
144 digest = release.tree_digest(fixture_release)144 digest = release.tree_digest(fixture_release)
145 destination = release.RELEASES / digest[:16]145 destination = release.RELEASES / digest[:16]
146 assert not destination.exists()146 assert not destination.exists()
147 fixture_release.rename(destination)147 fixture_release.rename(destination)
148 fixture_release = destination148 fixture_release = destination
149 (fixture_release / ".studio-release.json").write_text(json.dumps({"id": digest[:16], "digest": digest, "version": 2}))149 (fixture_release / ".snowglobe-release.json").write_text(json.dumps({"id": digest[:16], "digest": digest, "version": 2}))
150 value = json.loads(stage_file.read_text())150 value = json.loads(stage_file.read_text())
151 stage_file.write_text(json.dumps({**value, "release": digest[:16]}))151 stage_file.write_text(json.dumps({**value, "release": digest[:16]}))
152 active = call("deploy.start", action="destroy", target=stage_id)152 active = call("deploy.start", action="destroy", target=stage_id)
153 owned_runs.append(active["id"])153 owned_runs.append(active["id"])
154 call("deploy.start", action="deploy", target=current, status=409)154 call("deploy.start", action="deploy", target=current, status=409)
155 shell("systemctl", "restart", "studio-host-boundary-test.service")155 shell("systemctl", "restart", "snowglobe-host-boundary-test.service")
156 assert call("deploy.last")["id"] == active["id"]156 assert call("deploy.last")["id"] == active["id"]
157 result = done(active["id"])157 result = done(active["id"])
158 assert result["code"] == 0 and "approved fixture worker" in result["lines"], result158 assert result["code"] == 0 and "approved fixture worker" in result["lines"], result
159 (fixture_release / "tools/studio.py").write_text("print('unapproved changed worker')")159 (fixture_release / "tools/snowglobe.py").write_text("print('unapproved changed worker')")
160 call("deploy.start", action="destroy", target=stage_id, status=502)160 call("deploy.start", action="destroy", target=stage_id, status=502)
161 assert call("deploy.last")["id"] == active["id"]161 assert call("deploy.last")["id"] == active["id"]
162 stage_file.write_text(json.dumps(value))162 stage_file.write_text(json.dumps(value))
...@@ -166,9 +166,9 @@ def main():...@@ -166,9 +166,9 @@ def main():
166 shell("podman", "run", "-d", "--name=" + container, "--pull=never", "--user=65534:65534",166 shell("podman", "run", "-d", "--name=" + container, "--pull=never", "--user=65534:65534",
167 "--read-only", "--cap-drop=all", "--security-opt=no-new-privileges", "--pids-limit=128",167 "--read-only", "--cap-drop=all", "--security-opt=no-new-privileges", "--pids-limit=128",
168 "--memory=512m", "--cpus=2", "--tmpfs=/tmp:rw,noexec,nosuid,nodev,size=64m",168 "--memory=512m", "--cpus=2", "--tmpfs=/tmp:rw,noexec,nosuid,nodev,size=64m",
169 "--publish=127.0.0.1:7076:7072", "--volume=" + str(args.socket.parent) + ":/run/studio-host:ro",169 "--publish=127.0.0.1:7076:7072", "--volume=" + str(args.socket.parent) + ":/run/snowglobe-host:ro",
170 "--volume=" + str(proxy_token) + ":/run/secrets/dashboard-proxy.token:ro",170 "--volume=" + str(proxy_token) + ":/run/secrets/dashboard-proxy.token:ro",
171 "--volume=" + str(data) + ":/data:rw,nosuid,nodev", "--env=STUDIO_DATA_DIR=/data", args.image)171 "--volume=" + str(data) + ":/data:rw,nosuid,nodev", "--env=SNOWGLOBE_DATA_DIR=/data", args.image)
172 overview = ready()172 overview = ready()
173 assert overview["current"] == current and overview["recorded"]173 assert overview["current"] == current and overview["recorded"]
174 assert len(overview["history"]) == len(json.loads(history_bytes))174 assert len(overview["history"]) == len(json.loads(history_bytes))
...@@ -187,7 +187,7 @@ def main():...@@ -187,7 +187,7 @@ def main():
187 managed_file.write_text(json.dumps([*json.loads(managed_bytes), service_id]))187 managed_file.write_text(json.dumps([*json.loads(managed_bytes), service_id]))
188 service_created = True188 service_created = True
189 nomad("jobs", {"Job": {"ID": service_id, "Name": service_id, "Namespace": "default", "Datacenters": ["*"], "Type": "service",189 nomad("jobs", {"Job": {"ID": service_id, "Name": service_id, "Namespace": "default", "Datacenters": ["*"], "Type": "service",
190 "Meta": {"studio_secrets": json.dumps([{"name": "fixture", "generated": True, "bytes": 16}, {"name": "outside", "generated": False}])},190 "Meta": {"snowglobe_secrets": json.dumps([{"name": "fixture", "generated": True, "bytes": 16}, {"name": "outside", "generated": False}])},
191 "TaskGroups": [{"Name": "fixture", "Count": 1, "Tasks": [{"Name": "idle", "Driver": "podman",191 "TaskGroups": [{"Name": "fixture", "Count": 1, "Tasks": [{"Name": "idle", "Driver": "podman",
192 "Config": {"image": "docker.io/library/alpine:3.22", "command": "/bin/sleep", "args": ["600"]},192 "Config": {"image": "docker.io/library/alpine:3.22", "command": "/bin/sleep", "args": ["600"]},
193 "Resources": {"CPU": 25, "MemoryMB": 32}}]}]}})193 "Resources": {"CPU": 25, "MemoryMB": 32}}]}]}})
...@@ -219,7 +219,7 @@ def main():...@@ -219,7 +219,7 @@ def main():
219 assert secret_value not in "\n".join(call("deploy.run", id=saved["id"])["lines"])219 assert secret_value not in "\n".join(call("deploy.run", id=saved["id"])["lines"])
220 assert http(prefix + "fixture", section="services")["value"] == secret_value220 assert http(prefix + "fixture", section="services")["value"] == secret_value
221 assert nomad("var/nomad/jobs/" + service_id)["Items"]["outside"] == "keep"221 assert nomad("var/nomad/jobs/" + service_id)["Items"]["outside"] == "keep"
222 assert not list(Path("/var/lib/studio/host-boundary-test/runs").glob("*.input"))222 assert not list(Path("/var/lib/snowglobe/host-boundary-test/runs").glob("*.input"))
223 http(prefix + "fixture/rotate", {}, status=204, section="services")223 http(prefix + "fixture/rotate", {}, status=204, section="services")
224 saved = call("deploy.last")224 saved = call("deploy.last")
225 owned_runs.append(saved["id"])225 owned_runs.append(saved["id"])
...@@ -284,7 +284,7 @@ def main():...@@ -284,7 +284,7 @@ def main():
284 finally:284 finally:
285 subprocess.run(["podman", "rm", "--force", container], capture_output=True)285 subprocess.run(["podman", "rm", "--force", container], capture_output=True)
286 for identity in owned_runs:286 for identity in owned_runs:
287 subprocess.run(["systemctl", "stop", "studio-run-" + identity], capture_output=True, timeout=15)287 subprocess.run(["systemctl", "stop", "snowglobe-run-" + identity], capture_output=True, timeout=15)
288 if service_created:288 if service_created:
289 nomad("job/" + service_id + "?purge=true", method="DELETE")289 nomad("job/" + service_id + "?purge=true", method="DELETE")
290 nomad("var/nomad/jobs/" + service_id, method="DELETE")290 nomad("var/nomad/jobs/" + service_id, method="DELETE")
tools/dashboard-file-boundary-test.py+10-10
...@@ -18,7 +18,7 @@ import uuid...@@ -18,7 +18,7 @@ import uuid
18def main():18def main():
19 parser = argparse.ArgumentParser()19 parser = argparse.ArgumentParser()
20 parser.add_argument("socket", type=Path)20 parser.add_argument("socket", type=Path)
21 parser.add_argument("--pool", default="studio-demo")21 parser.add_argument("--pool", default="snowglobe-demo")
22 parser.add_argument("--image", required=True)22 parser.add_argument("--image", required=True)
23 parser.add_argument("--output", type=Path)23 parser.add_argument("--output", type=Path)
24 args = parser.parse_args()24 args = parser.parse_args()
...@@ -27,7 +27,7 @@ def main():...@@ -27,7 +27,7 @@ def main():
27 dataset = args.pool + "/files-boundary-test-" + suffix27 dataset = args.pool + "/files-boundary-test-" + suffix
28 mount = Path("/srv/.files-boundary-test-" + suffix)28 mount = Path("/srv/.files-boundary-test-" + suffix)
29 private = Path("/srv/.files-private-test-" + suffix)29 private = Path("/srv/.files-private-test-" + suffix)
30 container = "studio-dashboard-files-test-" + suffix30 container = "snowglobe-dashboard-files-test-" + suffix
3131
32 def run(*argv):32 def run(*argv):
33 return subprocess.run(argv, check=True, capture_output=True, text=True).stdout33 return subprocess.run(argv, check=True, capture_output=True, text=True).stdout
...@@ -35,7 +35,7 @@ def main():...@@ -35,7 +35,7 @@ def main():
35 def call(path, body=None, status=200):35 def call(path, body=None, status=200):
36 req = urllib.request.Request("http://127.0.0.1:7075" + path,36 req = urllib.request.Request("http://127.0.0.1:7075" + path,
37 data=json.dumps(body).encode() if body is not None else None,37 data=json.dumps(body).encode() if body is not None else None,
38 headers={"User-Name": "fixture", "User-Groups": "infra-admin", "Studio-Proxy-Token": proof, "Content-Type": "application/json"})38 headers={"User-Name": "fixture", "User-Groups": "infra-admin", "Snowglobe-Proxy-Token": proof, "Content-Type": "application/json"})
39 try:39 try:
40 response = urllib.request.urlopen(req, timeout=30)40 response = urllib.request.urlopen(req, timeout=30)
41 except urllib.error.HTTPError as error:41 except urllib.error.HTTPError as error:
...@@ -75,7 +75,7 @@ def main():...@@ -75,7 +75,7 @@ def main():
75 time.sleep(.1)75 time.sleep(.1)
76 raise AssertionError((tree, meta))76 raise AssertionError((tree, meta))
7777
78 with tempfile.TemporaryDirectory(prefix="studio-file-boundary-", dir="/run") as temporary:78 with tempfile.TemporaryDirectory(prefix="snowglobe-file-boundary-", dir="/run") as temporary:
79 os.chown(temporary, 65534, 65534)79 os.chown(temporary, 65534, 65534)
80 data = Path(temporary) / "data"80 data = Path(temporary) / "data"
81 data.mkdir()81 data.mkdir()
...@@ -98,17 +98,17 @@ def main():...@@ -98,17 +98,17 @@ def main():
98 launch = ["podman", "run", "-d", "--name=" + container, "--pull=never", "--user=65534:65534",98 launch = ["podman", "run", "-d", "--name=" + container, "--pull=never", "--user=65534:65534",
99 "--read-only", "--cap-drop=all", "--security-opt=no-new-privileges", "--pids-limit=128",99 "--read-only", "--cap-drop=all", "--security-opt=no-new-privileges", "--pids-limit=128",
100 "--memory=512m", "--cpus=2", "--tmpfs=/tmp:rw,noexec,nosuid,nodev,size=64m",100 "--memory=512m", "--cpus=2", "--tmpfs=/tmp:rw,noexec,nosuid,nodev,size=64m",
101 "--publish=127.0.0.1:7075:7072", "--volume=" + str(args.socket.parent) + ":/run/studio-host:ro",101 "--publish=127.0.0.1:7075:7072", "--volume=" + str(args.socket.parent) + ":/run/snowglobe-host:ro",
102 "--volume=" + str(proxy_token) + ":/run/secrets/dashboard-proxy.token:ro",102 "--volume=" + str(proxy_token) + ":/run/secrets/dashboard-proxy.token:ro",
103 "--volume=" + str(data) + ":/data:rw,nosuid,nodev",103 "--volume=" + str(data) + ":/data:rw,nosuid,nodev",
104 "--env=STUDIO_DATA_DIR=/data", "--env=STUDIO_FILES_WRITABLE=1"]104 "--env=SNOWGLOBE_DATA_DIR=/data", "--env=SNOWGLOBE_FILES_WRITABLE=1"]
105 run(*launch,105 run(*launch,
106 "--mount=type=bind,src=" + str(mount) + ",dst=" + str(mount) + ",bind-nonrecursive,bind-propagation=rslave",106 "--mount=type=bind,src=" + str(mount) + ",dst=" + str(mount) + ",bind-nonrecursive,bind-propagation=rslave",
107 "--mount=type=bind,src=" + str(mount / "media") + ",dst=" + str(mount / "media") + ",bind-nonrecursive,bind-propagation=rslave",107 "--mount=type=bind,src=" + str(mount / "media") + ",dst=" + str(mount / "media") + ",bind-nonrecursive,bind-propagation=rslave",
108 "--mount=type=bind,src=" + str(mount / "docs") + ",dst=" + str(mount / "docs") + ",bind-nonrecursive,bind-propagation=rslave",108 "--mount=type=bind,src=" + str(mount / "docs") + ",dst=" + str(mount / "docs") + ",bind-nonrecursive,bind-propagation=rslave",
109 "--env=STUDIO_STORE_ROOT=" + str(mount),109 "--env=SNOWGLOBE_STORE_ROOT=" + str(mount),
110 "--env=STUDIO_MEDIA_ROOT=" + str(mount / "media"),110 "--env=SNOWGLOBE_MEDIA_ROOT=" + str(mount / "media"),
111 "--env=STUDIO_INDEX_POOL=" + dataset, "--env=STUDIO_INDEX_DIR=/data/index", args.image)111 "--env=SNOWGLOBE_INDEX_POOL=" + dataset, "--env=SNOWGLOBE_INDEX_DIR=/data/index", args.image)
112 ready()112 ready()
113 baseline_size = len("media fixture") + len("document fixture")113 baseline_size = len("media fixture") + len("document fixture")
114 baseline = indexed(baseline_size, 2)114 baseline = indexed(baseline_size, 2)
...@@ -242,7 +242,7 @@ def main():...@@ -242,7 +242,7 @@ def main():
242 (partial / "fixture").write_text("partial mount fixture")242 (partial / "fixture").write_text("partial mount fixture")
243 os.chown(partial / "fixture", 65534, 65534)243 os.chown(partial / "fixture", 65534, 65534)
244 run(*launch, "--volume=" + str(partial) + ":" + str(partial) + ":rw,nosuid,nodev",244 run(*launch, "--volume=" + str(partial) + ":" + str(partial) + ":rw,nosuid,nodev",
245 "--env=STUDIO_STORE_ROOT=" + str(private), args.image)245 "--env=SNOWGLOBE_STORE_ROOT=" + str(private), args.image)
246 ready()246 ready()
247 call("/api/storage/files/delete", {"paths": ["data/fixture"]}, 409)247 call("/api/storage/files/delete", {"paths": ["data/fixture"]}, 409)
248 assert (partial / "fixture").read_text() == "partial mount fixture"248 assert (partial / "fixture").read_text() == "partial mount fixture"
tools/dashboard-files-test.py+8-8
...@@ -4,17 +4,17 @@ import argparse,json,os,shlex,subprocess,tempfile,time,urllib.request,urllib.err...@@ -4,17 +4,17 @@ import argparse,json,os,shlex,subprocess,tempfile,time,urllib.request,urllib.err
4from pathlib import Path4from pathlib import Path
5parser=argparse.ArgumentParser(description=__doc__)5parser=argparse.ArgumentParser(description=__doc__)
6parser.add_argument('binary')6parser.add_argument('binary')
7parser.add_argument('--pool',default='studio-demo')7parser.add_argument('--pool',default='snowglobe-demo')
8args=parser.parse_args()8args=parser.parse_args()
9run=lambda *argv:subprocess.run(argv,check=True,capture_output=True,text=True)9run=lambda *argv:subprocess.run(argv,check=True,capture_output=True,text=True)
10dataset=args.pool+'/dashboard-test-'+uuid.uuid4().hex[:8]10dataset=args.pool+'/dashboard-test-'+uuid.uuid4().hex[:8]
11unit='studio-dashboard-files-test'11unit='snowglobe-dashboard-files-test'
12with tempfile.TemporaryDirectory(prefix='studio-files-test-') as temporary:12with tempfile.TemporaryDirectory(prefix='snowglobe-files-test-') as temporary:
13 root=Path(temporary)/'store';media=root/'media';docs=root/'work/docs'13 root=Path(temporary)/'store';media=root/'media';docs=root/'work/docs'
14 variables=dict(v.split('=',1) for v in shlex.split(run('systemctl','show','-P','Environment','studio-dashboard').stdout))14 variables=dict(v.split('=',1) for v in shlex.split(run('systemctl','show','-P','Environment','snowglobe-dashboard').stdout))
15 for key in ['STUDIO_INDEX_POOL','STUDIO_YT_STATE']:variables.pop(key,None)15 for key in ['SNOWGLOBE_INDEX_POOL','SNOWGLOBE_YT_STATE']:variables.pop(key,None)
16 variables.update(PORT='7074',STUDIO_METRICS='follow',STUDIO_STORE_ROOT=str(root),STUDIO_MEDIA_ROOT=str(media),STUDIO_DATA_DIR=temporary+'/state',STUDIO_FILES_WRITABLE='1',STUDIO_INDEX_POOL=dataset,STUDIO_INDEX_DIR=temporary+'/index')16 variables.update(PORT='7074',SNOWGLOBE_METRICS='follow',SNOWGLOBE_STORE_ROOT=str(root),SNOWGLOBE_MEDIA_ROOT=str(media),SNOWGLOBE_DATA_DIR=temporary+'/state',SNOWGLOBE_FILES_WRITABLE='1',SNOWGLOBE_INDEX_POOL=dataset,SNOWGLOBE_INDEX_DIR=temporary+'/index')
17 proof={'Studio-Proxy-Token':Path(variables['STUDIO_PROXY_TOKEN_FILE']).read_text().strip()} if 'STUDIO_PROXY_TOKEN_FILE' in variables else {}17 proof={'Snowglobe-Proxy-Token':Path(variables['SNOWGLOBE_PROXY_TOKEN_FILE']).read_text().strip()} if 'SNOWGLOBE_PROXY_TOKEN_FILE' in variables else {}
18 def start():18 def start():
19 run('systemd-run','--unit='+unit,'--collect','--property=CPUWeight=1000','--property=CPUQuota=100%','--property=PrivateMounts=yes',*['--setenv='+k+'='+v for k,v in variables.items()],str(Path(args.binary).resolve()))19 run('systemd-run','--unit='+unit,'--collect','--property=CPUWeight=1000','--property=CPUQuota=100%','--property=PrivateMounts=yes',*['--setenv='+k+'='+v for k,v in variables.items()],str(Path(args.binary).resolve()))
20 deadline=time.monotonic()+12020 deadline=time.monotonic()+120
...@@ -75,7 +75,7 @@ with tempfile.TemporaryDirectory(prefix='studio-files-test-') as temporary:...@@ -75,7 +75,7 @@ with tempfile.TemporaryDirectory(prefix='studio-files-test-') as temporary:
75 call('/api/media/ops/'+op['id']+'/undo',{},409);assert (media/'new/extra').exists()75 call('/api/media/ops/'+op['id']+'/undo',{},409);assert (media/'new/extra').exists()
76 (media/'new/extra').unlink();undo(op)76 (media/'new/extra').unlink();undo(op)
77 assert not any(entry['name']=='new' for entry in call('/api/media/list')['entries'])77 assert not any(entry['name']=='new' for entry in call('/api/media/list')['entries'])
78 run('systemctl','stop',unit);variables.pop('STUDIO_FILES_WRITABLE');start()78 run('systemctl','stop',unit);variables.pop('SNOWGLOBE_FILES_WRITABLE');start()
79 call('/api/media/folder',{'path':'','name':'denied'},501);assert not (media/'denied').exists()79 call('/api/media/folder',{'path':'','name':'denied'},501);assert not (media/'denied').exists()
80 print('PASS: tree totals, text preview, path confinement, bulk rename, atomic clash refusal, collapsed move, dataset protection, cross-dataset refusal, multi-dataset delete/undo, persistent journal, index wake after mutation, occupied-folder refusal, read-only mode')80 print('PASS: tree totals, text preview, path confinement, bulk rename, atomic clash refusal, collapsed move, dataset protection, cross-dataset refusal, multi-dataset delete/undo, persistent journal, index wake after mutation, occupied-folder refusal, read-only mode')
81 finally:81 finally:
tools/dashboard-host-test.py+22-22
...@@ -19,7 +19,7 @@ spec.loader.exec_module(host_module)...@@ -19,7 +19,7 @@ spec.loader.exec_module(host_module)
1919
20class Boundary(unittest.TestCase):20class Boundary(unittest.TestCase):
21 def setUp(self):21 def setUp(self):
22 self.host = host_module.Host("studio-demo")22 self.host = host_module.Host("snowglobe-demo")
2323
24 @unittest.skipUnless(sys.platform == "linux", "Linux Unix peer credentials")24 @unittest.skipUnless(sys.platform == "linux", "Linux Unix peer credentials")
25 def test_large_json_header_preserves_stream_bytes_and_enforces_limit(self):25 def test_large_json_header_preserves_stream_bytes_and_enforces_limit(self):
...@@ -62,15 +62,15 @@ class Boundary(unittest.TestCase):...@@ -62,15 +62,15 @@ class Boundary(unittest.TestCase):
62 {"operation": "storage.datasets", "env": {"PATH": "/tmp"}},62 {"operation": "storage.datasets", "env": {"PATH": "/tmp"}},
63 {"operation": "host.sample", "path": "/root/private"},63 {"operation": "host.sample", "path": "/root/private"},
64 {"operation": "host.usage", "refresh": True, "pid": 1},64 {"operation": "host.usage", "refresh": True, "pid": 1},
65 {"operation": "deploy.managed", "path": "/var/lib/studio/nomad.token"},65 {"operation": "deploy.managed", "path": "/var/lib/snowglobe/nomad.token"},
66 {"operation": "storage.snapshots"}]66 {"operation": "storage.snapshots"}]
67 for refresh in [None, [], {}, 0, 1, "true"]:67 for refresh in [None, [], {}, 0, 1, "true"]:
68 requests.append({"operation": "host.usage", "refresh": refresh})68 requests.append({"operation": "host.usage", "refresh": refresh})
69 for dataset in [None, [], "other", "studio-demo-other", "studio-demo/../other",69 for dataset in [None, [], "other", "snowglobe-demo-other", "snowglobe-demo/../other",
70 "studio-demo//child", "studio-demo/child\nother", "-r", "studio-demo/a@snap"]:70 "snowglobe-demo//child", "snowglobe-demo/child\nother", "-r", "snowglobe-demo/a@snap"]:
71 requests.append({"operation": "storage.snapshots", "dataset": dataset})71 requests.append({"operation": "storage.snapshots", "dataset": dataset})
72 for snapshot in [None, [], "a%b", "a,b", "a@b", "a\nb", "../other", "a;id"]:72 for snapshot in [None, [], "a%b", "a,b", "a@b", "a\nb", "../other", "a;id"]:
73 requests.append({"operation": "storage.reclaim", "dataset": "studio-demo/a",73 requests.append({"operation": "storage.reclaim", "dataset": "snowglobe-demo/a",
74 "from": snapshot, "to": "safe"})74 "from": snapshot, "to": "safe"})
75 with patch.object(host_module, "command") as command:75 with patch.object(host_module, "command") as command:
76 for request in requests:76 for request in requests:
...@@ -94,32 +94,32 @@ class Boundary(unittest.TestCase):...@@ -94,32 +94,32 @@ class Boundary(unittest.TestCase):
9494
95 def test_reclaim_is_always_a_dry_run(self):95 def test_reclaim_is_always_a_dry_run(self):
96 with patch.object(host_module, "command", return_value="reclaim\t1024") as command:96 with patch.object(host_module, "command", return_value="reclaim\t1024") as command:
97 self.host.handle({"operation": "storage.reclaim", "dataset": "studio-demo/a",97 self.host.handle({"operation": "storage.reclaim", "dataset": "snowglobe-demo/a",
98 "from": "snapshot one", "to": "snapshot two"})98 "from": "snapshot one", "to": "snapshot two"})
99 command.assert_called_once_with("zfs", "destroy", "-nvp",99 command.assert_called_once_with("zfs", "destroy", "-nvp",
100 "studio-demo/a@snapshot one%snapshot two")100 "snowglobe-demo/a@snapshot one%snapshot two")
101101
102 def test_mounts_exclude_other_pools(self):102 def test_mounts_exclude_other_pools(self):
103 mounts = {"filesystems": [{"source": source, "target": "/srv"}103 mounts = {"filesystems": [{"source": source, "target": "/srv"}
104 for source in ["studio-demo", "studio-demo/a", "studio-demo-other/a", "other/a", "studio-demo/a@dash-123"]]}104 for source in ["snowglobe-demo", "snowglobe-demo/a", "snowglobe-demo-other/a", "other/a", "snowglobe-demo/a@dash-123"]]}
105 with patch.object(host_module, "command", return_value=json.dumps(mounts)):105 with patch.object(host_module, "command", return_value=json.dumps(mounts)):
106 self.assertEqual([m["source"] for m in self.host.handle({"operation": "storage.mounts"})["filesystems"]],106 self.assertEqual([m["source"] for m in self.host.handle({"operation": "storage.mounts"})["filesystems"]],
107 ["studio-demo", "studio-demo/a"])107 ["snowglobe-demo", "snowglobe-demo/a"])
108108
109 def test_snapshot_arguments_cannot_be_options(self):109 def test_snapshot_arguments_cannot_be_options(self):
110 with patch.object(host_module, "command", return_value="") as command:110 with patch.object(host_module, "command", return_value="") as command:
111 self.host.handle({"operation": "storage.removed", "dataset": "studio-demo/a", "snapshot": "snapshot -r"})111 self.host.handle({"operation": "storage.removed", "dataset": "snowglobe-demo/a", "snapshot": "snapshot -r"})
112 command.assert_called_once_with("zfs", "diff", "-H", "studio-demo/a@snapshot -r", "studio-demo/a")112 command.assert_called_once_with("zfs", "diff", "-H", "snowglobe-demo/a@snapshot -r", "snowglobe-demo/a")
113113
114 def test_snapshot_mutations_are_scoped(self):114 def test_snapshot_mutations_are_scoped(self):
115 requests = []115 requests = []
116 for datasets in [None, {}, [], [None], ["other/private"], ["studio-demo/../escape"], ["-r"]]:116 for datasets in [None, {}, [], [None], ["other/private"], ["snowglobe-demo/../escape"], ["-r"]]:
117 requests.append({"operation": "files.snapshot", "datasets": datasets})117 requests.append({"operation": "files.snapshot", "datasets": datasets})
118 for snapshot in ["before", "dash-1%after", "dash-1,after", "dash-../other", "dash--r"]:118 for snapshot in ["before", "dash-1%after", "dash-1,after", "dash-../other", "dash--r"]:
119 requests.append({"operation": "files.discard", "dataset": "studio-demo/a", "snapshot": snapshot})119 requests.append({"operation": "files.discard", "dataset": "snowglobe-demo/a", "snapshot": snapshot})
120 for value in ["before%after", "-r", "before,after", "before@after"]:120 for value in ["before%after", "-r", "before,after", "before@after"]:
121 requests.append({"operation": "storage.destroy", "dataset": "studio-demo/a", "from": value, "to": "after"})121 requests.append({"operation": "storage.destroy", "dataset": "snowglobe-demo/a", "from": value, "to": "after"})
122 requests.append({"operation": "files.snapshot", "datasets": ["studio-demo/a"], "recursive": True})122 requests.append({"operation": "files.snapshot", "datasets": ["snowglobe-demo/a"], "recursive": True})
123 with patch.object(host_module, "command") as command:123 with patch.object(host_module, "command") as command:
124 for request in requests:124 for request in requests:
125 with self.subTest(request=request), self.assertRaises(host_module.Rejected):125 with self.subTest(request=request), self.assertRaises(host_module.Rejected):
...@@ -128,14 +128,14 @@ class Boundary(unittest.TestCase):...@@ -128,14 +128,14 @@ class Boundary(unittest.TestCase):
128128
129 def test_file_snapshots_use_only_the_undo_namespace(self):129 def test_file_snapshots_use_only_the_undo_namespace(self):
130 with patch.object(host_module.time, "time_ns", return_value=123), patch.object(host_module, "command", return_value="") as command:130 with patch.object(host_module.time, "time_ns", return_value=123), patch.object(host_module, "command", return_value="") as command:
131 name = self.host.handle({"operation": "files.snapshot", "datasets": ["studio-demo/b", "studio-demo/a", "studio-demo/a"]})131 name = self.host.handle({"operation": "files.snapshot", "datasets": ["snowglobe-demo/b", "snowglobe-demo/a", "snowglobe-demo/a"]})
132 self.assertEqual(name, "dash-123")132 self.assertEqual(name, "dash-123")
133 command.assert_called_once_with("zfs", "snapshot", "studio-demo/a@dash-123", "studio-demo/b@dash-123")133 command.assert_called_once_with("zfs", "snapshot", "snowglobe-demo/a@dash-123", "snowglobe-demo/b@dash-123")
134 with patch.object(host_module, "command", return_value="studio-demo/a@before\nstudio-demo/a@dash-123\nstudio-demo/a@dash-manual\n"):134 with patch.object(host_module, "command", return_value="snowglobe-demo/a@before\nsnowglobe-demo/a@dash-123\nsnowglobe-demo/a@dash-manual\n"):
135 self.assertEqual(self.host.handle({"operation": "files.snapshots", "datasets": ["studio-demo/a"]}), ["studio-demo/a@dash-123"])135 self.assertEqual(self.host.handle({"operation": "files.snapshots", "datasets": ["snowglobe-demo/a"]}), ["snowglobe-demo/a@dash-123"])
136 with patch.object(host_module, "command", return_value="") as command:136 with patch.object(host_module, "command", return_value="") as command:
137 self.host.handle({"operation": "files.discard", "dataset": "studio-demo/a", "snapshot": "dash-123"})137 self.host.handle({"operation": "files.discard", "dataset": "snowglobe-demo/a", "snapshot": "dash-123"})
138 command.assert_called_once_with("zfs", "destroy", "studio-demo/a@dash-123")138 command.assert_called_once_with("zfs", "destroy", "snowglobe-demo/a@dash-123")
139139
140 def test_child_output_is_bounded(self):140 def test_child_output_is_bounded(self):
141 with patch.object(host_module, "MAX_RESPONSE", 4096):141 with patch.object(host_module, "MAX_RESPONSE", 4096):
...@@ -143,7 +143,7 @@ class Boundary(unittest.TestCase):...@@ -143,7 +143,7 @@ class Boundary(unittest.TestCase):
143 host_module.command(sys.executable, "-c", "import os; os.write(2, b'x' * 1000000)")143 host_module.command(sys.executable, "-c", "import os; os.write(2, b'x' * 1000000)")
144144
145 def test_index_operations_preserve_other_snapshots(self):145 def test_index_operations_preserve_other_snapshots(self):
146 dataset = "studio-demo/a"146 dataset = "snowglobe-demo/a"
147 with patch.object(host_module, "command") as command:147 with patch.object(host_module, "command") as command:
148 for name in ["manual", "dash-123", "index-fixture", "index-123%manual", "index-../escape"]:148 for name in ["manual", "dash-123", "index-fixture", "index-123%manual", "index-../escape"]:
149 for request in [{"operation": "index.discard", "dataset": dataset, "snapshot": name},149 for request in [{"operation": "index.discard", "dataset": dataset, "snapshot": name},
tools/dashboard-host-vm-test.py+1-1
...@@ -35,7 +35,7 @@ def request(socket_path, payload):...@@ -35,7 +35,7 @@ def request(socket_path, payload):
35def main():35def main():
36 parser = argparse.ArgumentParser()36 parser = argparse.ArgumentParser()
37 parser.add_argument("socket")37 parser.add_argument("socket")
38 parser.add_argument("--pool", default="studio-demo")38 parser.add_argument("--pool", default="snowglobe-demo")
39 parser.add_argument("--user", default="nobody")39 parser.add_argument("--user", default="nobody")
40 parser.add_argument("--client", action="store_true")40 parser.add_argument("--client", action="store_true")
41 args = parser.parse_args()41 args = parser.parse_args()
tools/dashboard-host.py+9-4
...@@ -430,7 +430,7 @@ def stream_upload(connection, request):...@@ -430,7 +430,7 @@ def stream_upload(connection, request):
430 Path(temporary).unlink(missing_ok=True)430 Path(temporary).unlink(missing_ok=True)
431431
432432
433def serve_connection(connection, host, allowed_uid):433def serve_connection(connection, host, allowed_uid, allowed_operations=None):
434 with connection:434 with connection:
435 connection.settimeout(65)435 connection.settimeout(65)
436 _, uid, _ = struct.unpack("3i", connection.getsockopt(socket.SOL_SOCKET, socket.SO_PEERCRED, 12))436 _, uid, _ = struct.unpack("3i", connection.getsockopt(socket.SOL_SOCKET, socket.SO_PEERCRED, 12))
...@@ -451,6 +451,11 @@ def serve_connection(connection, host, allowed_uid):...@@ -451,6 +451,11 @@ def serve_connection(connection, host, allowed_uid):
451 if len(line) > MAX_REQUEST or not line.endswith(b"\n"):451 if len(line) > MAX_REQUEST or not line.endswith(b"\n"):
452 raise Rejected("The host request is too large or incomplete.")452 raise Rejected("The host request is too large or incomplete.")
453 request = json.loads(line)453 request = json.loads(line)
454 if allowed_operations is not None and (
455 not isinstance(request, dict) or not isinstance(request.get("operation"), str)
456 or request["operation"] not in allowed_operations
457 ):
458 raise dashboard_runs.Error(403, "This preview cannot change Snow Globe. Use production for host controls.")
454 if isinstance(request, dict) and request.get("operation") in {"vm.console", "vm.serial", "vm.guest", "vm.upload"}:459 if isinstance(request, dict) and request.get("operation") in {"vm.console", "vm.serial", "vm.guest", "vm.upload"}:
455 streams = GUEST_SLOTS if request["operation"] == "vm.guest" else STREAM_SLOTS460 streams = GUEST_SLOTS if request["operation"] == "vm.guest" else STREAM_SLOTS
456 if not streams.acquire(blocking=False):461 if not streams.acquire(blocking=False):
...@@ -484,9 +489,9 @@ def serve_connection(connection, host, allowed_uid):...@@ -484,9 +489,9 @@ def serve_connection(connection, host, allowed_uid):
484489
485490
486def main():491def main():
487 host = Host(os.environ["STUDIO_POOL"])492 host = Host(os.environ["SNOWGLOBE_POOL"])
488 allowed_uid = pwd.getpwnam(os.environ["STUDIO_DASHBOARD_USER"]).pw_uid493 allowed_uid = pwd.getpwnam(os.environ["SNOWGLOBE_DASHBOARD_USER"]).pw_uid
489 socket_path = Path(os.environ.get("STUDIO_HOST_SOCKET", "/run/studio-host/host.sock"))494 socket_path = Path(os.environ.get("SNOWGLOBE_HOST_SOCKET", "/run/snowglobe-host/host.sock"))
490 socket_path.unlink(missing_ok=True)495 socket_path.unlink(missing_ok=True)
491 with socket.socket(socket.AF_UNIX, socket.SOCK_STREAM) as listener:496 with socket.socket(socket.AF_UNIX, socket.SOCK_STREAM) as listener:
492 listener.bind(str(socket_path))497 listener.bind(str(socket_path))
tools/dashboard-iam-test.py deleted-156
...@@ -1,156 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import importlib
4import json
5from pathlib import Path
6import subprocess
7import sys
8import time
9import urllib.error
10import urllib.parse
11import urllib.request
12import uuid
13
14
15def main():
16 parser = argparse.ArgumentParser()
17 parser.add_argument("--url", required=True)
18 parser.add_argument("--socket", required=True)
19 parser.add_argument("--proof-file", type=Path, required=True)
20 parser.add_argument("--user", default="studio-dashboard")
21 parser.add_argument("--output", type=Path)
22 args = parser.parse_args()
23 if args.output:
24 args.output.unlink(missing_ok=True)
25 sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "service/keycloak"))
26 from api import Keycloak
27 keycloak = Keycloak("keycloak.studio.test", importlib.import_module("dashboard-run").secret("get", "keycloak", "password"), attempts=1)
28 keycloak.configure_profile()
29 name = "iam-fixture-" + uuid.uuid4().hex
30 password = uuid.uuid4().hex + "A1!"
31 identity = None
32 proof = args.proof_file.read_text().strip()
33 admin = keycloak.request("/admin/realms/master/users?username=admin&exact=true")[0]
34 admin = keycloak.request("/admin/realms/master/users/" + admin["id"])
35 admin_roles = keycloak.request("/admin/realms/master/users/" + admin["id"] + "/role-mappings/realm")
36 server_role = next(role for role in admin_roles if role["name"] == "admin")
37
38 def http(path, method="GET", body=None, status=200, actor="fixture-operator", groups="infra-admin"):
39 request = urllib.request.Request(args.url + "/api/" + path, method=method,
40 data=json.dumps(body).encode() if body is not None else None,
41 headers={"User-Name": actor, "User-Groups": groups, "Studio-Proxy-Token": proof, "Content-Type": "application/json"})
42 try:
43 response = urllib.request.urlopen(request, timeout=70)
44 except urllib.error.HTTPError as error:
45 response = error
46 with response:
47 content = response.read()
48 assert response.status == status, (path, response.status, content[:200])
49 return json.loads(content) if content and response.headers.get("Content-Type", "").startswith("application/json") else None
50
51 def broker(path=None, method="GET", body=None, status=200, **fields):
52 payload = {"operation": "iam.request", "path": path, "method": method, "body": body} if path is not None else fields
53 process = subprocess.run([sys.executable, str(Path(__file__).with_name("dashboard-host-vm-test.py")), args.socket,
54 "--client", "--user", args.user], input=json.dumps(payload).encode() + b"\n", capture_output=True, timeout=75)
55 assert process.returncode == 0, "broker client failed"
56 result = json.loads(process.stdout)
57 if status != 200:
58 assert result.get("status") == status, (path, result)
59 return None
60 assert "value" in result, (path, result)
61 return result["value"]
62
63 def sign_in(secret):
64 body = urllib.parse.urlencode({"client_id": "admin-cli", "grant_type": "password", "username": name, "password": secret}).encode()
65 return keycloak.request("/realms/master/protocol/openid-connect/token", "POST", body)
66
67 try:
68 started = time.monotonic()
69 directory = http("users")
70 directory_seconds = time.monotonic() - started
71 assert all(user["username"] != "admin" for user in directory["users"])
72 roles = {role["name"]: role for role in directory["groups"]}
73 assert set(roles) == {"infra-admin", "media", "media-manage"}
74 http("users", status=403, groups="media")
75 created = http("users", "POST", {"profile": {"username": name, "email": name + "@fixture.invalid", "firstName": "Native", "lastName": "Fixture"},
76 "groups": [roles["media"]["id"]], "setup": {"kind": "password", "password": password}}, status=201)
77 identity = created["id"]
78 path = "users/" + identity
79 assert keycloak.request("/admin/realms/master/" + path)["username"] == name
80 http(path, "PATCH", {"requiredActions": [], "emailVerified": True, "firstName": "Verified"}, status=204)
81 http(path + "/password", "PUT", {"password": password, "temporary": False}, status=204)
82 tokens = sign_in(password)
83 assert tokens["access_token"]
84 http(path + "/credentials")
85 http(path + "/groups/" + roles["infra-admin"]["id"], "PUT", status=204)
86 http(path + "/groups/" + roles["infra-admin"]["id"], "DELETE", status=400, actor=name)
87 http(path + "/groups/" + roles["infra-admin"]["id"], "DELETE", status=204)
88 mapped = {role["name"] for role in keycloak.request("/admin/realms/master/" + path + "/role-mappings/realm")}
89 assert mapped & {"infra-admin", "media", "media-manage", "admin"} == {"media"}
90 http("account", "PATCH", {"firstName": "Account"}, status=204, actor=name, groups="media")
91 assert http("account", actor=name, groups="media")["firstName"] == "Account"
92 broker("/" + path, "PUT", {"attributes": {"picture": ["https://fixture.invalid/picture"]}})
93 profile = keycloak.request("/admin/realms/master/" + path)
94 assert profile["attributes"]["picture"] == ["https://fixture.invalid/picture"]
95 assert profile["firstName"] == "Account" and profile["email"] == name + "@fixture.invalid"
96 broker("/" + path, "PUT", {"attributes": {"picture": None}})
97 profile = keycloak.request("/admin/realms/master/" + path)
98 assert "picture" not in profile.get("attributes", {})
99 assert profile["firstName"] == "Account" and profile["email"] == name + "@fixture.invalid"
100 http(path + "/logout", "POST", status=204)
101 try:
102 keycloak.request("/realms/master/protocol/openid-connect/token", "POST", urllib.parse.urlencode({
103 "client_id": "admin-cli", "grant_type": "refresh_token", "refresh_token": tokens["refresh_token"]}).encode())
104 except urllib.error.HTTPError as error:
105 assert error.code == 400
106 else:
107 raise AssertionError("logged-out refresh token remained usable")
108 changed = uuid.uuid4().hex + "A1!"
109 http(path + "/password", "PUT", {"password": changed, "temporary": False}, status=204)
110 assert sign_in(changed)["access_token"]
111 http(path, "PATCH", {"enabled": False}, status=204)
112 try:
113 sign_in(changed)
114 except urllib.error.HTTPError as error:
115 assert error.code == 400
116 else:
117 raise AssertionError("disabled fixture signed in")
118 http(path, "PATCH", {"enabled": True}, status=204)
119 for operation in ["get", "set", "rotate"]:
120 fields = {"operation": "deploy.secret." + operation, "service": "keycloak", "key": "password"}
121 if operation == "set":
122 fields["value"] = "fixture-not-applied"
123 broker(status=403, **fields)
124 for forbidden in ["/clients", "/realm-settings", "/users/" + identity + "/../../clients", "/users?max=1000&first=0"]:
125 broker(forbidden, status=400)
126 broker("/users/" + admin["id"] + "/reset-password", "PUT", {"type": "password", "value": "fixture-not-applied", "temporary": False}, status=403)
127 broker("/users/" + admin["id"], "DELETE", status=403)
128 broker("/" + path + "/role-mappings/realm", "POST", [server_role], status=403)
129 broker("/" + path + "/role-mappings/realm", "POST", [{"id": server_role["id"], "name": "infra-admin"}], status=403)
130 assert keycloak.request("/admin/realms/master/users/" + admin["id"]) == admin
131 assert keycloak.request("/admin/realms/master/users/" + admin["id"] + "/role-mappings/realm") == admin_roles
132 Keycloak("keycloak.studio.test", importlib.import_module("dashboard-run").secret("get", "keycloak", "password"), attempts=1)
133 http(path, "DELETE", status=204)
134 identity = None
135 result = {"native_user_crud": True, "password_sign_in_and_reset": True, "disable_rejects_sign_in": True,
136 "dashboard_role_grants": True, "self_lockout_refused": True, "account_profile": True,
137 "logout_revokes_refresh": True, "non_admin_refused": True, "bootstrap_user_hidden_and_protected": True,
138 "credential_export_and_change_refused": True, "admin_paths_and_forged_roles_refused": True,
139 "existing_realm_preserved": True, "directory_seconds": round(directory_seconds, 3)}
140 result["picture_persists_and_preserves_profile"] = True
141 finally:
142 if identity is not None:
143 keycloak.request("/admin/realms/master/users/" + identity, "DELETE")
144 remaining = keycloak.request("/admin/realms/master/users?username=" + name + "&exact=true")
145 for user in remaining:
146 keycloak.request("/admin/realms/master/users/" + user["id"], "DELETE")
147 assert not keycloak.request("/admin/realms/master/users?username=" + name + "&exact=true")
148 result["owned_fixture_removed"] = True
149 if args.output:
150 args.output.parent.mkdir(parents=True, exist_ok=True)
151 args.output.write_text(json.dumps(result, indent=2) + "\n")
152 print(json.dumps(result))
153
154
155if __name__ == "__main__":
156 main()
tools/dashboard-mcp-test.py deleted-237
...@@ -1,237 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import base64
4import hashlib
5import importlib
6import json
7from pathlib import Path
8import subprocess
9import sys
10import time
11import urllib.error
12import urllib.parse
13import urllib.request
14import uuid
15
16
17class NoRedirect(urllib.request.HTTPRedirectHandler):
18 def redirect_request(self, request, fp, code, message, headers, newurl):
19 return None
20
21
22def main():
23 parser = argparse.ArgumentParser()
24 parser.add_argument("--url", required=True)
25 parser.add_argument("--proof-file", type=Path, required=True)
26 parser.add_argument("--restart-unit")
27 parser.add_argument("--output", type=Path)
28 args = parser.parse_args()
29 if args.output:
30 args.output.unlink(missing_ok=True)
31 origin = "https://globe.studio.test"
32 resource = origin + "/mcp/observability"
33 opener = urllib.request.build_opener(NoRedirect)
34 proof = args.proof_file.read_text().strip()
35 sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "service/keycloak"))
36 from api import Keycloak
37 keycloak = Keycloak("keycloak.studio.test", importlib.import_module("dashboard-run").secret("get", "keycloak", "password"), attempts=1)
38 marker = "mcp-fixture-" + uuid.uuid4().hex
39 names = [marker + "-one", marker + "-two"]
40 identities = {}
41
42 def http(path, method="GET", body=None, status=200, actor=None, groups="infra-admin", token=None, form=False, headers=None):
43 fields = {"Host": "globe.studio.test", "Content-Type": "application/x-www-form-urlencoded" if form else "application/json"}
44 if actor is not None:
45 fields.update({"Studio-Proxy-Token": proof, "User-Name": actor, "User-Groups": groups, "Origin": origin})
46 if token is not None:
47 fields.update({"Authorization": "Bearer " + token, "Accept": "application/json, text/event-stream", "MCP-Protocol-Version": "2025-11-25"})
48 fields.update(headers or {})
49 encoded = urllib.parse.urlencode(body).encode() if form else json.dumps(body).encode() if body is not None else None
50 request = urllib.request.Request(args.url + path, method=method, data=encoded, headers=fields)
51 try:
52 response = opener.open(request, timeout=70)
53 except urllib.error.HTTPError as error:
54 response = error
55 with response:
56 content = response.read()
57 assert response.status == status, (path, response.status, content[:300])
58 if content and response.headers.get("Content-Type", "").startswith("application/json"):
59 value = json.loads(content)
60 else:
61 value = content.decode()
62 return value, response.headers
63
64 def consent(client, actor, chosen, scope="observability:read offline_access"):
65 verifier = uuid.uuid4().hex + uuid.uuid4().hex
66 challenge = base64.urlsafe_b64encode(hashlib.sha256(verifier.encode()).digest()).decode().rstrip("=")
67 request = {"response_type": "code", "client_id": client["client_id"], "redirect_uri": client["redirect_uris"][0],
68 "code_challenge_method": "S256", "code_challenge": challenge, "resource": resource, "scope": scope, "state": marker}
69 _, headers = http("/oauth/authorize?" + urllib.parse.urlencode(request), status=302)
70 pending = urllib.parse.urlsplit(headers["Location"]).path.removeprefix("/connect/")
71 path = "/api/mcp/consent/" + pending
72 details, _ = http(path, actor=actor)
73 assert details["client"] == client["client_name"]
74 http(path, actor=names[1] if actor == names[0] else names[0], status=403)
75 http(path, "POST", {"resources": ["outside-grant"]}, actor=actor, status=403)
76 http(path, "POST", {"resources": chosen}, actor=actor, headers={"Origin": "https://other.invalid"}, status=403)
77 result, _ = http(path, "POST", {"resources": chosen}, actor=actor)
78 query = urllib.parse.parse_qs(urllib.parse.urlsplit(result["redirect"]).query)
79 assert query["state"] == [marker] and query["iss"] == [origin + "/"]
80 http(path, actor=actor, status=404)
81 return {"grant_type": "authorization_code", "client_id": client["client_id"], "redirect_uri": client["redirect_uris"][0],
82 "code_verifier": verifier, "code": query["code"][0], "resource": resource}
83
84 def rpc(token, method, params=None):
85 result, _ = http("/mcp/observability", "POST", {"jsonrpc": "2.0", "id": 1, "method": method,
86 **({"params": params} if params is not None else {})}, token=token)
87 assert "error" not in result, (method, result)
88 return result["result"]
89
90 def ingest(service, path, body, content_type="application/json"):
91 readonly = Path("/var/lib/studio/dashboard.token").read_text().strip()
92 request = urllib.request.Request("http://127.0.0.1:4646/v1/service/" + service, headers={"X-Nomad-Token": readonly})
93 with urllib.request.urlopen(request, timeout=10) as response:
94 upstream = json.load(response)[0]
95 request = urllib.request.Request(f"http://{upstream['Address']}:{upstream['Port']}" + path,
96 data=body, headers={"Content-Type": content_type})
97 with urllib.request.urlopen(request, timeout=10) as response:
98 assert response.status == 200
99
100 try:
101 role = keycloak.request("/admin/realms/master/roles/infra-admin")
102 for name in names:
103 result = keycloak.request("/admin/realms/master/users", "POST", {"username": name, "enabled": True}, full=True)
104 identities[name] = result["id"]
105 keycloak.request("/admin/realms/master/users/" + result["id"] + "/role-mappings/realm", "POST", [role])
106 metadata, _ = http("/.well-known/oauth-protected-resource/mcp/observability")
107 assert metadata["resource"] == resource and metadata["authorization_servers"] == [origin + "/"]
108 metadata, _ = http("/.well-known/oauth-authorization-server")
109 assert metadata["issuer"] == origin + "/" and metadata["code_challenge_methods_supported"] == ["S256"]
110 _, headers = http("/mcp/observability", status=401, headers={"User-Name": names[0], "User-Groups": "infra-admin"})
111 assert headers["WWW-Authenticate"].startswith("Bearer resource_metadata=")
112 http("/api/mcp", status=403, headers={"User-Name": names[0], "User-Groups": "infra-admin"})
113 overview, _ = http("/api/mcp", actor=names[0])
114 assert not overview["connections"] and overview["catalogs"][0]["endpoint"] == resource
115 readonly = Path("/var/lib/studio/dashboard.token").read_text().strip()
116 request = urllib.request.Request("http://127.0.0.1:4646/v1/jobs", headers={"X-Nomad-Token": readonly})
117 with urllib.request.urlopen(request, timeout=10) as response:
118 jobs = json.load(response)
119 aliases = {}
120 for job in jobs:
121 request = urllib.request.Request("http://127.0.0.1:4646/v1/job/" + urllib.parse.quote(job["ID"], safe=""), headers={"X-Nomad-Token": readonly})
122 with urllib.request.urlopen(request, timeout=10) as response:
123 aliases[job["ID"]] = json.load(response).get("Meta", {}).get("studio_trace_service")
124 services = [job for job, alias in aliases.items() if alias and list(aliases.values()).count(alias) == 1]
125 assert len(services) >= 2, "need two trace-enabled services for scoped native fixture"
126 allowed, denied = services[:2]
127 client, _ = http("/oauth/register", "POST", {"client_name": marker, "redirect_uris": ["http://127.0.0.1:29999/callback"],
128 "token_endpoint_auth_method": "none"}, status=201)
129 form = consent(client, names[0], [allowed])
130 wrong = {**form, "code_verifier": "wrong"}
131 http("/oauth/token", "POST", wrong, form=True, status=400)
132 tokens, _ = http("/oauth/token", "POST", form, form=True)
133 http("/oauth/token", "POST", form, form=True, status=400)
134 token = tokens["access_token"]
135 assert rpc(token, "initialize", {"protocolVersion": "2025-11-25", "capabilities": {}, "clientInfo": {"name": marker, "version": "1"}})["capabilities"]["tools"] == {}
136 listed = rpc(token, "tools/list")
137 assert listed["ttlMs"] == 0 and listed["cacheScope"] == "private", listed
138 tools = listed["tools"]
139 assert {tool["name"] for tool in tools} == {"get_logs", "get_traces", "get_trace"}
140 assert all(tool["annotations"]["readOnlyHint"] for tool in tools)
141 refused = rpc(token, "tools/call", {"name": "get_logs", "arguments": {"service": denied}})
142 assert refused["isError"]
143 http("/mcp/observability", "POST", {"jsonrpc": "2.0", "id": 1, "method": "tools/list"}, token=token, headers={"Origin": "https://other.invalid"}, status=403)
144 at = time.time() - 60
145 row = {"_time": str(at), "_msg": marker, "source": "nomad", "job": allowed, "task": "fixture", "stream": "stdout"}
146 ingest("victoria-logs", "/insert/jsonline", (json.dumps(row) + "\n").encode(), "application/stream+json")
147 trace_id = uuid.uuid4().hex
148 spans = []
149 for service, span_id, parent in [(denied, "1234567890abcdef", ""), (allowed, "abcdef1234567890", "1234567890abcdef")]:
150 spans.append({"resource": {"attributes": [{"key": "service.name", "value": {"stringValue": aliases[service]}}]},
151 "scopeSpans": [{"spans": [{"traceId": trace_id, "spanId": span_id, "parentSpanId": parent,
152 "name": marker + ("-foreign-secret" if service == denied else "-allowed"), "kind": 1,
153 "startTimeUnixNano": str(int(at * 1e9)), "endTimeUnixNano": str(int((at + .01) * 1e9)),
154 "status": {"code": 2 if service == denied else 1},
155 "attributes": [{"key": "studio.service", "value": {"stringValue": service}}]}]}]})
156 ingest("victoria-traces", "/insert/opentelemetry/v1/traces", json.dumps({"resourceSpans": spans}).encode())
157 deadline = time.monotonic() + 30
158 while True:
159 try:
160 logs = rpc(token, "tools/call", {"name": "get_logs", "arguments": {"service": allowed, "q": marker}})
161 assert not logs.get("isError") and any(row["text"] == marker for row in logs["structuredContent"]["logs"]), logs
162 trace = rpc(token, "tools/call", {"name": "get_trace", "arguments": {"service": allowed, "trace_id": trace_id}})
163 assert not trace.get("isError") and len(trace["structuredContent"]["trace"]["spans"]) == 1, trace
164 traces = rpc(token, "tools/call", {"name": "get_traces", "arguments": {"service": allowed, "q": marker}})
165 assert not traces.get("isError") and any(row["id"] == trace_id and row["spans"] == 1 for row in traces["structuredContent"]["traces"]), traces
166 assert "foreign-secret" not in json.dumps(trace) + json.dumps(traces)
167 break
168 except (AssertionError, urllib.error.HTTPError):
169 if time.monotonic() > deadline:
170 raise
171 time.sleep(1)
172 overview, _ = http("/api/mcp", actor=names[0])
173 grant_id = overview["connections"][0]["id"]
174 other, _ = http("/api/mcp", actor=names[1])
175 assert not other["connections"]
176 http("/api/mcp/connections/" + grant_id, "DELETE", actor=names[1], status=404)
177 if args.restart_unit:
178 subprocess.run(["systemctl", "restart", args.restart_unit], check=True, capture_output=True, timeout=60)
179 rpc(token, "tools/list")
180 refresh = {"grant_type": "refresh_token", "client_id": client["client_id"], "refresh_token": tokens["refresh_token"], "resource": resource}
181 rotated, _ = http("/oauth/token", "POST", refresh, form=True)
182 assert rotated["refresh_token"] != tokens["refresh_token"]
183 http("/oauth/token", "POST", refresh, form=True, status=400)
184 http("/mcp/observability", token=token, status=401)
185 http("/mcp/observability", token=rotated["access_token"], status=401)
186 second = consent(client, names[0], [allowed], "observability:read")
187 tokens, _ = http("/oauth/token", "POST", second, form=True)
188 assert "refresh_token" not in tokens
189 overview, _ = http("/api/mcp", actor=names[0])
190 http("/api/mcp/connections/" + overview["connections"][0]["id"], "DELETE", actor=names[0], status=204)
191 http("/mcp/observability", token=tokens["access_token"], status=401)
192 for change in ["disable", "remove-role", "delete-user"]:
193 exchange = consent(client, names[0], [allowed])
194 tokens, _ = http("/oauth/token", "POST", exchange, form=True)
195 path = "/admin/realms/master/users/" + identities[names[0]]
196 if change == "disable":
197 keycloak.request(path, "PUT", {"enabled": False})
198 elif change == "remove-role":
199 keycloak.request(path + "/role-mappings/realm", "DELETE", [role])
200 else:
201 keycloak.request(path, "DELETE")
202 refresh = {"grant_type": "refresh_token", "client_id": client["client_id"], "refresh_token": tokens["refresh_token"]}
203 rejected, _ = http("/oauth/token", "POST", refresh, form=True, status=400)
204 assert rejected["error"] == "invalid_grant"
205 http("/mcp/observability", token=tokens["access_token"], status=401)
206 if change == "disable":
207 keycloak.request(path, "PUT", {"enabled": True})
208 elif change == "remove-role":
209 keycloak.request(path + "/role-mappings/realm", "POST", [role])
210 result = {"resource_metadata": True, "pkce_code_single_use": True, "shared_realm_identity": True,
211 "consent_owner_and_origin": True, "sdk_initialization_and_tools": True, "explicit_service_grants": True,
212 "native_log_retrieval": True, "native_trace_retrieval": True, "foreign_spans_and_summary_filtered": True,
213 "cross_user_connections_refused": True, "refresh_rotation_and_replay_revocation": True,
214 "dashboard_revocation_immediate": True, "refresh_requires_consent": True,
215 "refresh_honors_account_disable_role_removal_and_deletion": True,
216 "restart_preserves_tokens": bool(args.restart_unit)}
217 finally:
218 for name in names:
219 try:
220 overview, _ = http("/api/mcp", actor=name)
221 for connection in overview["connections"]:
222 http("/api/mcp/connections/" + connection["id"], "DELETE", actor=name, status=204)
223 except (AssertionError, urllib.error.URLError):
224 pass
225 for name in names:
226 for identity in keycloak.request("/admin/realms/master/users?username=" + name + "&exact=true"):
227 keycloak.request("/admin/realms/master/users/" + identity["id"], "DELETE")
228 assert not keycloak.request("/admin/realms/master/users?username=" + name + "&exact=true")
229 result["owned_users_removed"] = True
230 if args.output:
231 args.output.parent.mkdir(parents=True, exist_ok=True)
232 args.output.write_text(json.dumps(result, indent=2) + "\n")
233 print(json.dumps(result))
234
235
236if __name__ == "__main__":
237 main()
tools/dashboard-metrics-test.py+6-6
...@@ -50,15 +50,15 @@ nomad = ThreadingHTTPServer(("127.0.0.1", 0), Nomad)...@@ -50,15 +50,15 @@ nomad = ThreadingHTTPServer(("127.0.0.1", 0), Nomad)
50for server in [metrics, nomad]:50for server in [metrics, nomad]:
51 threading.Thread(target=server.serve_forever, daemon=True).start()51 threading.Thread(target=server.serve_forever, daemon=True).start()
5252
53unit = "studio-dashboard-metrics-test"53unit = "snowglobe-dashboard-metrics-test"
54with tempfile.TemporaryDirectory(prefix="studio-metrics-test-") as temporary:54with tempfile.TemporaryDirectory(prefix="snowglobe-metrics-test-") as temporary:
55 environment = subprocess.check_output(["systemctl", "show", "-P", "Environment", "studio-dashboard"], text=True)55 environment = subprocess.check_output(["systemctl", "show", "-P", "Environment", "snowglobe-dashboard"], text=True)
56 variables = dict(item.split("=", 1) for item in shlex.split(environment))56 variables = dict(item.split("=", 1) for item in shlex.split(environment))
57 for key in ["STUDIO_INDEX_POOL", "STUDIO_YT_STATE", "STUDIO_FILES_WRITABLE"]:57 for key in ["SNOWGLOBE_INDEX_POOL", "SNOWGLOBE_YT_STATE", "SNOWGLOBE_FILES_WRITABLE"]:
58 variables.pop(key, None)58 variables.pop(key, None)
59 variables.update(PORT="7074", STUDIO_METRICS="follow", STUDIO_DATA_DIR=temporary,59 variables.update(PORT="7074", SNOWGLOBE_METRICS="follow", SNOWGLOBE_DATA_DIR=temporary,
60 NOMAD_ADDR=f"http://127.0.0.1:{nomad.server_port}")60 NOMAD_ADDR=f"http://127.0.0.1:{nomad.server_port}")
61 proof = {"Studio-Proxy-Token": Path(variables["STUDIO_PROXY_TOKEN_FILE"]).read_text().strip()} if "STUDIO_PROXY_TOKEN_FILE" in variables else {}61 proof = {"Snowglobe-Proxy-Token": Path(variables["SNOWGLOBE_PROXY_TOKEN_FILE"]).read_text().strip()} if "SNOWGLOBE_PROXY_TOKEN_FILE" in variables else {}
62 def request(range=3600):62 def request(range=3600):
63 started = time.monotonic()63 started = time.monotonic()
64 req = urllib.request.Request(f"http://127.0.0.1:7074/api/metrics/host.cpu?range={range}",64 req = urllib.request.Request(f"http://127.0.0.1:7074/api/metrics/host.cpu?range={range}",
tools/dashboard-oidc-test.py+5-5
...@@ -43,9 +43,9 @@ def main():...@@ -43,9 +43,9 @@ def main():
43 data = Path(temporary).resolve()43 data = Path(temporary).resolve()
44 (data / 'proof').write_text(proof)44 (data / 'proof').write_text(proof)
45 (data / 'source.json').write_text(json.dumps(export))45 (data / 'source.json').write_text(json.dumps(export))
46 environment = {**os.environ, 'STUDIO_DOMAIN': 'paperclover.net', 'STUDIO_DATA_DIR': str(data),46 environment = {**os.environ, 'SNOWGLOBE_DOMAIN': 'paperclover.net', 'SNOWGLOBE_DATA_DIR': str(data),
47 'STUDIO_PUBLIC_ORIGIN': origin, 'STUDIO_AUTH_RP_ID': 'auth.paperclover.net', 'STUDIO_FILE_ORIGIN': 'https://file.paperclover.net',47 'SNOWGLOBE_PUBLIC_ORIGIN': origin, 'SNOWGLOBE_AUTH_RP_ID': 'auth.paperclover.net', 'SNOWGLOBE_FILE_ORIGIN': 'https://file.paperclover.net',
48 'STUDIO_WEB_DIR': str(Path('dashboard/dist').resolve()), 'STUDIO_PROXY_TOKEN_FILE': str(data / 'proof'), 'STUDIO_AUTH_REQUIRED': '1'}48 'SNOWGLOBE_WEB_DIR': str(Path('dashboard/dist').resolve()), 'SNOWGLOBE_PROXY_TOKEN_FILE': str(data / 'proof'), 'SNOWGLOBE_AUTH_REQUIRED': '1'}
49 binary = str(args.binary.resolve())49 binary = str(args.binary.resolve())
50 result = subprocess.run([binary, '--import-accounts', str(data / 'source.json')], env=environment, capture_output=True, text=True)50 result = subprocess.run([binary, '--import-accounts', str(data / 'source.json')], env=environment, capture_output=True, text=True)
51 assert result.returncode == 0, result.stderr51 assert result.returncode == 0, result.stderr
...@@ -80,7 +80,7 @@ def main():...@@ -80,7 +80,7 @@ def main():
80 server.terminate(); server.wait(timeout=10)80 server.terminate(); server.wait(timeout=10)
81 cookies = {}81 cookies = {}
82 def request(path, method='GET', body=None, status=200, extra=None, session=True, form=False):82 def request(path, method='GET', body=None, status=200, extra=None, session=True, form=False):
83 headers = {'Studio-Proxy-Token': proof, 'Host': 'snowglobe.paperclover.net', 'X-Studio-Client-IP': '127.0.0.1'}83 headers = {'Snowglobe-Proxy-Token': proof, 'Host': 'snowglobe.paperclover.net', 'X-Snowglobe-Client-IP': '127.0.0.1'}
84 if body is not None: headers.update({'Origin': origin, 'Content-Type': 'application/x-www-form-urlencoded' if form else 'application/json'})84 if body is not None: headers.update({'Origin': origin, 'Content-Type': 'application/x-www-form-urlencoded' if form else 'application/json'})
85 if session: headers['Cookie'] = '; '.join(f'{k}={v}' for k,v in cookies.items())85 if session: headers['Cookie'] = '; '.join(f'{k}={v}' for k,v in cookies.items())
86 headers.update(extra or {})86 headers.update(extra or {})
...@@ -97,7 +97,7 @@ def main():...@@ -97,7 +97,7 @@ def main():
97 csrf = request('/auth/status')['csrf']97 csrf = request('/auth/status')['csrf']
98 login = {'csrf': csrf, 'username': 'oidc-test', 'password': password, 'next': '/'}98 login = {'csrf': csrf, 'username': 'oidc-test', 'password': password, 'next': '/'}
99 request('/auth/password', 'POST', login)99 request('/auth/password', 'POST', login)
100 metadata = request('/.well-known/openid-configuration', extra={'Studio-Proxy-Token': 'wrong'})100 metadata = request('/.well-known/openid-configuration', extra={'Snowglobe-Proxy-Token': 'wrong'})
101 assert metadata['issuer'] == origin and metadata['id_token_signing_alg_values_supported'] == ['RS256']101 assert metadata['issuer'] == origin and metadata['id_token_signing_alg_values_supported'] == ['RS256']
102 jwk = request('/auth/oidc/jwks')['keys'][0]102 jwk = request('/auth/oidc/jwks')['keys'][0]
103 decode = lambda s: base64.urlsafe_b64decode(s + '=' * (-len(s) % 4))103 decode = lambda s: base64.urlsafe_b64decode(s + '=' * (-len(s) % 4))
tools/dashboard-package-test.py+16-16
...@@ -22,13 +22,13 @@ def main():...@@ -22,13 +22,13 @@ def main():
22 parser.add_argument("--image", required=True)22 parser.add_argument("--image", required=True)
23 parser.add_argument("--output", type=Path)23 parser.add_argument("--output", type=Path)
24 args = parser.parse_args()24 args = parser.parse_args()
25 container = "studio-dashboard-package-test-" + uuid.uuid4().hex[:12]25 container = "snowglobe-dashboard-package-test-" + uuid.uuid4().hex[:12]
26 proof = uuid.uuid4().hex + uuid.uuid4().hex26 proof = uuid.uuid4().hex + uuid.uuid4().hex
2727
28 def shell(*argv):28 def shell(*argv):
29 return subprocess.run(argv, capture_output=True, text=True, check=True, timeout=60).stdout29 return subprocess.run(argv, capture_output=True, text=True, check=True, timeout=60).stdout
3030
31 with tempfile.TemporaryDirectory(prefix="studio-dashboard-package-", dir="/run") as temporary:31 with tempfile.TemporaryDirectory(prefix="snowglobe-dashboard-package-", dir="/run") as temporary:
32 data = Path(temporary) / "data"32 data = Path(temporary) / "data"
33 data.mkdir()33 data.mkdir()
34 os.chown(data, 65534, 65534)34 os.chown(data, 65534, 65534)
...@@ -45,10 +45,10 @@ def main():...@@ -45,10 +45,10 @@ def main():
45 "--security-opt=no-new-privileges", "--memory=512m", "--cpus=2", "--pids-limit=128",45 "--security-opt=no-new-privileges", "--memory=512m", "--cpus=2", "--pids-limit=128",
46 "--publish=127.0.0.1::7072", "--volume=" + str(data) + ":/data:rw",46 "--publish=127.0.0.1::7072", "--volume=" + str(data) + ":/data:rw",
47 "--volume=" + str(token) + ":/run/secrets/dashboard-proxy.token:ro",47 "--volume=" + str(token) + ":/run/secrets/dashboard-proxy.token:ro",
48 "--tmpfs=/tmp:rw,noexec,nosuid,size=64m", "--env=STUDIO_DATA_DIR=/data",48 "--tmpfs=/tmp:rw,noexec,nosuid,size=64m", "--env=SNOWGLOBE_DATA_DIR=/data",
49 "--env=STUDIO_DOMAIN=studio.test", "--env=STUDIO_MEDIA_READ_ONLY=true",49 "--env=SNOWGLOBE_DOMAIN=snowglobe.test", "--env=SNOWGLOBE_MEDIA_READ_ONLY=true",
50 "--env=STUDIO_YT_STATE=/data/yt", "--env=STUDIO_YT_CONFIG=/data/config",50 "--env=SNOWGLOBE_YT_STATE=/data/yt", "--env=SNOWGLOBE_YT_CONFIG=/data/config",
51 "--env=STUDIO_YT_MEDIA=/data/media", args.image)51 "--env=SNOWGLOBE_YT_MEDIA=/data/media", args.image)
52 info = json.loads(shell("podman", "inspect", container))[0]52 info = json.loads(shell("podman", "inspect", container))[0]
53 port = info["NetworkSettings"]["Ports"]["7072/tcp"][0]["HostPort"]53 port = info["NetworkSettings"]["Ports"]["7072/tcp"][0]["HostPort"]
54 base = "http://127.0.0.1:" + port54 base = "http://127.0.0.1:" + port
...@@ -58,7 +58,7 @@ def main():...@@ -58,7 +58,7 @@ def main():
58 "User-Name": "fixture", "User-Groups": "infra-admin,media,media-manage",58 "User-Name": "fixture", "User-Groups": "infra-admin,media,media-manage",
59 }59 }
60 if supplied is not None:60 if supplied is not None:
61 headers["Studio-Proxy-Token"] = supplied61 headers["Snowglobe-Proxy-Token"] = supplied
62 request = urllib.request.Request(base + path, headers=headers)62 request = urllib.request.Request(base + path, headers=headers)
63 with urllib.request.urlopen(request, timeout=30) as response:63 with urllib.request.urlopen(request, timeout=30) as response:
64 return response.read()64 return response.read()
...@@ -80,11 +80,11 @@ def main():...@@ -80,11 +80,11 @@ def main():
80 except urllib.error.HTTPError as error:80 except urllib.error.HTTPError as error:
81 assert error.code == 403, (path, error.code)81 assert error.code == 403, (path, error.code)
82 assert json.loads(get("/api/me"))["name"] == "fixture"82 assert json.loads(get("/api/me"))["name"] == "fixture"
83 python = next(value.split("=", 1)[1] for value in info["Config"]["Env"] if value.startswith("STUDIO_YT_PYTHON="))83 python = next(value.split("=", 1)[1] for value in info["Config"]["Env"] if value.startswith("SNOWGLOBE_YT_PYTHON="))
84 address = next(network["IPAddress"] for network in info["NetworkSettings"]["Networks"].values() if network["IPAddress"])84 address = next(network["IPAddress"] for network in info["NetworkSettings"]["Networks"].values() if network["IPAddress"])
85 neighbor = f"""import urllib.request, urllib.error85 neighbor = f"""import urllib.request, urllib.error
86request = urllib.request.Request('http://{address}:7072/api/me', headers={{86request = urllib.request.Request('http://{address}:7072/api/me', headers={{
87 'User-Name': 'snow', 'User-Groups': 'infra-admin', 'Studio-Proxy-Token': '0' * 64,87 'User-Name': 'snow', 'User-Groups': 'infra-admin', 'Snowglobe-Proxy-Token': '0' * 64,
88}})88}})
89try:89try:
90 urllib.request.urlopen(request, timeout=5)90 urllib.request.urlopen(request, timeout=5)
...@@ -96,9 +96,9 @@ print('refused')...@@ -96,9 +96,9 @@ print('refused')
96 assert shell("podman", "run", "--rm", "--read-only", "--cap-drop=ALL", "--security-opt=no-new-privileges",96 assert shell("podman", "run", "--rm", "--read-only", "--cap-drop=ALL", "--security-opt=no-new-privileges",
97 "--entrypoint=" + python, args.image, "-c", neighbor).strip() == "refused"97 "--entrypoint=" + python, args.image, "-c", neighbor).strip() == "refused"
98 unsecured = subprocess.run(["podman", "run", "--rm", "--read-only", "--network=none", "--cap-drop=ALL",98 unsecured = subprocess.run(["podman", "run", "--rm", "--read-only", "--network=none", "--cap-drop=ALL",
99 "--security-opt=no-new-privileges", "--unsetenv=STUDIO_PROXY_TOKEN_FILE", args.image],99 "--security-opt=no-new-privileges", "--unsetenv=SNOWGLOBE_PROXY_TOKEN_FILE", args.image],
100 capture_output=True, text=True, timeout=10)100 capture_output=True, text=True, timeout=10)
101 assert unsecured.returncode != 0 and "Set STUDIO_PROXY_TOKEN_FILE" in unsecured.stderr, unsecured.stderr101 assert unsecured.returncode != 0 and "Set SNOWGLOBE_PROXY_TOKEN_FILE" in unsecured.stderr, unsecured.stderr
102102
103 class Auth(BaseHTTPRequestHandler):103 class Auth(BaseHTTPRequestHandler):
104 def do_GET(self):104 def do_GET(self):
...@@ -117,13 +117,13 @@ print('refused')...@@ -117,13 +117,13 @@ print('refused')
117 "/v1/service/forward-auth": [{"ServiceName": "forward-auth", "AllocID": "fixture", "Address": "127.0.0.1", "Port": auth.server_port, "Tags": []}],117 "/v1/service/forward-auth": [{"ServiceName": "forward-auth", "AllocID": "fixture", "Address": "127.0.0.1", "Port": auth.server_port, "Tags": []}],
118 "/v1/allocation/fixture/checks": {"ready": {"Status": "success"}},118 "/v1/allocation/fixture/checks": {"ready": {"Status": "success"}},
119 }[path]119 }[path]
120 os.environ.update(STUDIO_DOMAIN="studio.test", STUDIO_DASHBOARD_PORT=port, STUDIO_PROXY_TOKEN_FILE=str(token))120 os.environ.update(SNOWGLOBE_DOMAIN="snowglobe.test", SNOWGLOBE_DASHBOARD_PORT=port, SNOWGLOBE_PROXY_TOKEN_FILE=str(token))
121 with socket.socket() as reservation:121 with socket.socket() as reservation:
122 reservation.bind(("127.0.0.1", 0))122 reservation.bind(("127.0.0.1", 0))
123 proxy_port = reservation.getsockname()[1]123 proxy_port = reservation.getsockname()[1]
124 config = Path(temporary) / "Caddyfile"124 config = Path(temporary) / "Caddyfile"
125 config.write_text("{\n admin off\n auto_https off\n}\n" + router.render("fixture").replace(125 config.write_text("{\n admin off\n auto_https off\n}\n" + router.render("fixture").replace(
126 "globe.studio.test {", "http://127.0.0.1:" + str(proxy_port) + " {"126 "globe.snowglobe.test {", "http://127.0.0.1:" + str(proxy_port) + " {"
127 ).replace(" tls internal\n", ""))127 ).replace(" tls internal\n", ""))
128 config.chmod(0o600)128 config.chmod(0o600)
129 log = Path(temporary) / "caddy.log"129 log = Path(temporary) / "caddy.log"
...@@ -141,7 +141,7 @@ print('refused')...@@ -141,7 +141,7 @@ print('refused')
141 if time.monotonic() >= deadline or caddy.poll() is not None:141 if time.monotonic() >= deadline or caddy.poll() is not None:
142 raise AssertionError(log.read_text().replace(proof, "<redacted>"))142 raise AssertionError(log.read_text().replace(proof, "<redacted>"))
143 time.sleep(.1)143 time.sleep(.1)
144 forged = {"User-Name": "snow", "User-Groups": "infra-admin", "Studio-Proxy-Token": "0" * 64}144 forged = {"User-Name": "snow", "User-Groups": "infra-admin", "Snowglobe-Proxy-Token": "0" * 64}
145 request = urllib.request.Request("http://127.0.0.1:" + str(proxy_port) + "/api/me",145 request = urllib.request.Request("http://127.0.0.1:" + str(proxy_port) + "/api/me",
146 headers={**forged, "Cookie": "fixture=1"})146 headers={**forged, "Cookie": "fixture=1"})
147 with urllib.request.urlopen(request, timeout=10) as response:147 with urllib.request.urlopen(request, timeout=10) as response:
...@@ -171,7 +171,7 @@ print('refused')...@@ -171,7 +171,7 @@ print('refused')
171 auth.shutdown()171 auth.shutdown()
172 apps = json.loads(get("/api/launcher"))172 apps = json.loads(get("/api/launcher"))
173 assert any(app["id"] == "shale" for app in apps), apps173 assert any(app["id"] == "shale" for app in apps), apps
174 assert all(app["url"].endswith(".studio.test") for app in apps), apps174 assert all(app["url"].endswith(".snowglobe.test") for app in apps), apps
175 icon = next(url for app in apps for url in (app["icon"] or {}).values() if url)175 icon = next(url for app in apps for url in (app["icon"] or {}).values() if url)
176 assert b"<svg" in get(icon)176 assert b"<svg" in get(icon)
177 library = json.loads(get("/api/youtube/library"))177 library = json.loads(get("/api/youtube/library"))
...@@ -183,7 +183,7 @@ print('refused')...@@ -183,7 +183,7 @@ print('refused')
183 assert {mount["Destination"] for mount in info["Mounts"]} == {"/data", "/run/secrets/dashboard-proxy.token"}, info["Mounts"]183 assert {mount["Destination"] for mount in info["Mounts"]} == {"/data", "/run/secrets/dashboard-proxy.token"}, info["Mounts"]
184 assert not next(mount["RW"] for mount in info["Mounts"] if mount["Destination"] == "/run/secrets/dashboard-proxy.token")184 assert not next(mount["RW"] for mount in info["Mounts"] if mount["Destination"] == "/run/secrets/dashboard-proxy.token")
185 assert shell("podman", "exec", container, "id", "-u").strip() == "65534"185 assert shell("podman", "exec", container, "id", "-u").strip() == "65534"
186 for denied in ["/opt/studio/current", "/var/lib/studio/nomad.token", "/run/podman/podman.sock", "/dev/zfs"]:186 for denied in ["/opt/snowglobe/current", "/var/lib/snowglobe/nomad.token", "/run/podman/podman.sock", "/dev/zfs"]:
187 assert subprocess.run(["podman", "exec", container, "test", "-e", denied], capture_output=True).returncode == 1, denied187 assert subprocess.run(["podman", "exec", container, "test", "-e", denied], capture_output=True).returncode == 1, denied
188 result = {"proxy_proof_required": "passed", "neighbor_identity_forgery_refused": "passed",188 result = {"proxy_proof_required": "passed", "neighbor_identity_forgery_refused": "passed",
189 "wildcard_startup_without_proof_refused": "passed",189 "wildcard_startup_without_proof_refused": "passed",
tools/dashboard-public-load-test.py deleted-141
...@@ -1,141 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3from concurrent.futures import ThreadPoolExecutor
4import http.cookiejar
5import importlib
6import json
7from pathlib import Path
8import ssl
9import subprocess
10import sys
11import time
12import urllib.parse
13import urllib.request
14import uuid
15
16
17def main():
18 parser = argparse.ArgumentParser()
19 parser.add_argument('--clients', type=int, default=24)
20 parser.add_argument('--requests', type=int, default=1200)
21 parser.add_argument('--idle-seconds', type=int, default=0)
22 parser.add_argument('--output', type=Path, required=True)
23 args = parser.parse_args()
24 assert 1 <= args.clients <= 64 and 12 <= args.requests <= 50000
25 assert 0 <= args.idle_seconds <= 600
26 for unit in ['studio-dashboard-unit-test', 'studio-host-unit-test']:
27 subprocess.run(['systemctl', 'is-active', '--quiet', unit], check=True)
28 repo = Path(__file__).resolve().parent.parent
29 sys.path.insert(0, str(repo / 'service/keycloak'))
30 from api import Keycloak, LoopbackHTTPS
31 Page = importlib.import_module('dashboard-shale-test').Page
32 secret = importlib.import_module('dashboard-run').secret
33 origin = 'https://globe.studio.test'
34 context = ssl.create_default_context(cafile='/var/lib/studio/ca-bundle.crt')
35
36 class TLS(urllib.request.HTTPSHandler):
37 def https_open(self, request):
38 target = urllib.parse.urlsplit(request.full_url)
39 assert target.scheme == 'https' and target.netloc in ('globe.studio.test', 'keycloak.studio.test')
40 return self.do_open(LoopbackHTTPS, request, context=context)
41
42 class Redirect(urllib.request.HTTPRedirectHandler):
43 def redirect_request(self, request, response, code, message, headers, target):
44 parts = urllib.parse.urlsplit(target)
45 assert parts.scheme == 'https' and parts.netloc in ('globe.studio.test', 'keycloak.studio.test')
46 return super().redirect_request(request, response, code, message, headers, target)
47
48 class NoRedirect(urllib.request.HTTPRedirectHandler):
49 def redirect_request(self, *args):
50 return None
51
52 keycloak = Keycloak('keycloak.studio.test', secret('get', 'keycloak', 'password'), attempts=1)
53 name = 'dashboard-load-' + uuid.uuid4().hex
54 password = uuid.uuid4().hex + 'A1!'
55 user = None
56 try:
57 role = keycloak.request('/admin/realms/master/roles/infra-admin')
58 user = keycloak.request('/admin/realms/master/users', 'POST', {
59 'username': name, 'enabled': True, 'requiredActions': [],
60 'credentials': [{'type': 'password', 'value': password, 'temporary': False}],
61 }, full=True)['id']
62 keycloak.request('/admin/realms/master/users/' + user + '/role-mappings/realm', 'POST', [role])
63 cookies = http.cookiejar.CookieJar()
64 login = urllib.request.build_opener(TLS(), Redirect(), urllib.request.HTTPCookieProcessor(cookies))
65 with login.open(origin + '/snow.oauth2/start?' + urllib.parse.urlencode({'rd': origin + '/'}), timeout=30) as response:
66 target = response.url
67 body = response.read(4 * 1024 * 1024 + 1).decode()
68 assert urllib.parse.urlsplit(target).netloc == 'keycloak.studio.test'
69 forms = [form for form in Page(body).forms if any(field.get('name') == 'password' for field in form['fields'])]
70 assert len(forms) == 1
71 action = urllib.parse.urljoin(target, forms[0]['action'])
72 action_url = urllib.parse.urlsplit(action)
73 assert action_url.scheme == 'https' and action_url.netloc == 'keycloak.studio.test'
74 fields = {field['name']: field.get('value', '') for field in forms[0]['fields'] if field.get('name')}
75 fields.update(username=name, password=password)
76 with login.open(urllib.request.Request(action, data=urllib.parse.urlencode(fields).encode(),
77 headers={'Content-Type': 'application/x-www-form-urlencoded', 'Origin': 'https://keycloak.studio.test'}), timeout=30) as response:
78 assert response.status == 200 and response.url == origin + '/'
79 response.read(4 * 1024 * 1024 + 1)
80 cookie_request = urllib.request.Request(origin + '/api/me')
81 cookies.add_cookie_header(cookie_request)
82 cookie = cookie_request.get_header('Cookie')
83 assert cookie
84 paths = ['/api/me', '/api/host', '/api/services', '/api/launcher', '/api/status', '/api/storage',
85 '/api/mcp', '/api/media/list', *['/api/metrics/' + metric + '?range=3600'
86 for metric in ['host.cpu', 'host.memory', 'service.cpu', 'service.memory']]]
87
88 def request(path):
89 start = time.monotonic()
90 client = urllib.request.build_opener(TLS(), NoRedirect())
91 with client.open(urllib.request.Request(origin + path, headers={'Cookie': cookie}), timeout=30) as response:
92 assert response.status == 200 and response.headers.get_content_type() == 'application/json'
93 body = response.read(8 * 1024 * 1024 + 1)
94 assert len(body) <= 8 * 1024 * 1024
95 value = json.loads(body)
96 if path == '/api/me':
97 assert value['name'] == name
98 if path == '/api/mcp':
99 assert {catalog['endpoint'] for catalog in value['catalogs']} == {origin + '/mcp/' + catalog
100 for catalog in ['observability', 'agents', 'shale']}
101 return path, (time.monotonic() - start) * 1000
102
103 for path in paths:
104 request(path)
105 start = time.monotonic()
106 with ThreadPoolExecutor(max_workers=args.clients) as clients:
107 results = list(clients.map(request, [paths[i % len(paths)] for i in range(args.requests)]))
108 report = {'public_https_and_real_sso': True, 'clients': args.clients, 'requests': len(results),
109 'seconds': round(time.monotonic() - start, 2), 'routes': {}}
110 for path in paths:
111 samples = sorted(ms for route, ms in results if route == path)
112 report['routes'][path] = {'requests': len(samples), 'p95_ms': round(samples[int(len(samples) * .95)], 2),
113 'max_ms': round(samples[-1], 2)}
114 print(json.dumps({'load_complete': report}), flush=True)
115 if args.idle_seconds:
116 units = ['studio-dashboard-unit-test.service', 'studio-host-unit-test.service']
117 before = {}
118 for unit in units:
119 stat = Path('/sys/fs/cgroup/system.slice') / unit / 'cpu.stat'
120 before[unit] = int(dict(line.split() for line in stat.read_text().splitlines())['usage_usec'])
121 start = time.monotonic()
122 time.sleep(args.idle_seconds)
123 elapsed = time.monotonic() - start
124 idle = {'seconds': round(elapsed, 2), 'percent_of_one_core': {}}
125 for unit in units:
126 stat = Path('/sys/fs/cgroup/system.slice') / unit / 'cpu.stat'
127 used = int(dict(line.split() for line in stat.read_text().splitlines())['usage_usec']) - before[unit]
128 idle['percent_of_one_core'][unit] = round(used / elapsed / 10000, 3)
129 request('/api/me')
130 report['idle'] = idle
131 finally:
132 if user:
133 keycloak = Keycloak('keycloak.studio.test', secret('get', 'keycloak', 'password'), attempts=1)
134 keycloak.request('/admin/realms/master/users/' + user, 'DELETE')
135 report['owned_sso_fixture_removed'] = True
136 args.output.write_text(json.dumps(report, indent=2) + '\n')
137 print(json.dumps(report), flush=True)
138
139
140if __name__ == '__main__':
141 main()
tools/dashboard-relay-test.py deleted-454
...@@ -1,454 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import base64
4from concurrent.futures import ThreadPoolExecutor
5import hashlib
6import importlib
7import json
8import os
9from pathlib import Path
10import queue
11import re
12import tempfile
13import socket
14import sqlite3
15import struct
16import subprocess
17import sys
18import threading
19import time
20import urllib.error
21import urllib.parse
22import urllib.request
23import uuid
24
25
26class NoRedirect(urllib.request.HTTPRedirectHandler):
27 def redirect_request(self, request, fp, code, message, headers, newurl):
28 return None
29
30
31class Agent:
32 def __init__(self, address, token, status=101, origin=None, host="globe.studio.test"):
33 target = urllib.parse.urlsplit(address)
34 self.socket = socket.create_connection((target.hostname, target.port), timeout=5)
35 self.socket.settimeout(45)
36 key = base64.b64encode(os.urandom(16)).decode()
37 fields = {"Host": host, "Upgrade": "websocket", "Connection": "Upgrade", "Sec-WebSocket-Version": "13",
38 "Sec-WebSocket-Key": key, "Authorization": "Bearer " + token}
39 if origin is not None:
40 fields["Origin"] = origin
41 self.socket.sendall(("GET /agent/connect HTTP/1.1\r\n" + "".join(k + ": " + v + "\r\n" for k, v in fields.items()) + "\r\n").encode())
42 self.stream = self.socket.makefile("rb", buffering=0)
43 response = self.stream.readline().decode().split()
44 assert int(response[1]) == status, response
45 headers = {}
46 while line := self.stream.readline().strip():
47 k, v = line.decode().split(":", 1)
48 headers[k.lower()] = v.strip()
49 if status != 101:
50 self.close()
51 return
52 expected = base64.b64encode(hashlib.sha1((key + "258EAFA5-E914-47DA-95CA-C5AB0DC85B11").encode()).digest()).decode()
53 assert headers["sec-websocket-accept"] == expected
54 self.lock = threading.Lock()
55 self.frames = queue.Queue()
56 self.mode = "reply"
57 self.pings = 0
58 self.closed = threading.Event()
59 self.machine = self.receive()["machine_id"]
60 self.thread = threading.Thread(target=self.run, daemon=True)
61 self.thread.start()
62
63 def read(self, size):
64 result = b""
65 while len(result) < size:
66 part = self.stream.read(size - len(result))
67 if not part:
68 raise EOFError()
69 result += part
70 return result
71
72 def receive(self):
73 while True:
74 first, size = self.read(2)
75 assert first & 128 and not size & 128
76 size &= 127
77 if size == 126:
78 size = struct.unpack("!H", self.read(2))[0]
79 elif size == 127:
80 size = struct.unpack("!Q", self.read(8))[0]
81 assert size <= 4 * 1024 * 1024
82 data = self.read(size)
83 opcode = first & 15
84 if opcode == 9:
85 self.pings += 1
86 self.send(data, opcode=10)
87 elif opcode == 8:
88 raise EOFError()
89 else:
90 assert opcode == 1
91 return json.loads(data)
92
93 def send(self, value, opcode=1):
94 data = value if isinstance(value, bytes) else json.dumps(value).encode()
95 prefix = bytes([128 | opcode])
96 length = len(data)
97 if length < 126:
98 prefix += bytes([128 | length])
99 elif length < 65536:
100 prefix += bytes([128 | 126]) + struct.pack("!H", length)
101 else:
102 prefix += bytes([128 | 127]) + struct.pack("!Q", length)
103 mask = os.urandom(4)
104 packet = prefix + mask + bytes(byte ^ mask[i % 4] for i, byte in enumerate(data))
105 with self.lock:
106 self.socket.sendall(packet)
107
108 def run(self):
109 try:
110 while True:
111 frame = self.receive()
112 assert set(frame) == {"id", "method", "params"}
113 uuid.UUID(frame["id"])
114 self.frames.put(frame)
115 if self.mode == "reply":
116 self.send({"id": frame["id"], "result": {"fixture": self.machine, "method": frame["method"], "params": frame["params"]}})
117 elif self.mode == "drop":
118 self.socket.shutdown(socket.SHUT_RDWR)
119 break
120 except (EOFError, OSError):
121 pass
122 finally:
123 self.closed.set()
124
125 def close(self):
126 try:
127 self.socket.shutdown(socket.SHUT_RDWR)
128 except OSError:
129 pass
130 self.stream.close()
131 self.socket.close()
132 if hasattr(self, "thread"):
133 self.thread.join(timeout=5)
134
135
136def main():
137 parser = argparse.ArgumentParser()
138 parser.add_argument("--url", required=True)
139 parser.add_argument("--proof-file", type=Path, required=True)
140 parser.add_argument("--data-dir", type=Path, required=True)
141 parser.add_argument("--restart-unit", required=True)
142 parser.add_argument("--output", type=Path)
143 parser.add_argument("--agent-dir", type=Path)
144 parser.add_argument("--agent-origin")
145 parser.add_argument("--agent-ca", type=Path)
146 args = parser.parse_args()
147 if args.output:
148 args.output.unlink(missing_ok=True)
149 origin = "https://globe.studio.test"
150 resource = origin + "/mcp/agents"
151 proof = args.proof_file.read_text().strip()
152 opener = urllib.request.build_opener(NoRedirect)
153 marker = "relay-fixture-" + uuid.uuid4().hex
154 names = [marker + "-one", marker + "-two"]
155 sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "service/keycloak"))
156 from api import Keycloak
157 keycloak = Keycloak("keycloak.studio.test", importlib.import_module("dashboard-run").secret("get", "keycloak", "password"), attempts=1)
158 agents = []
159 credentials = []
160
161 def http(path, method="GET", body=None, actor=None, token=None, status=200, form=False, headers=None):
162 fields = {"Host": "globe.studio.test", "Content-Type": "application/x-www-form-urlencoded" if form else "application/json"}
163 if actor:
164 fields.update({"Studio-Proxy-Token": proof, "User-Name": actor, "User-Groups": "", "Origin": origin})
165 if token:
166 fields.update({"Authorization": "Bearer " + token, "Accept": "application/json, text/event-stream", "MCP-Protocol-Version": "2025-11-25"})
167 fields.update(headers or {})
168 data = urllib.parse.urlencode(body).encode() if form else json.dumps(body).encode() if body is not None else None
169 try:
170 response = opener.open(urllib.request.Request(args.url + path, method=method, headers=fields, data=data), timeout=65)
171 except urllib.error.HTTPError as error:
172 response = error
173 with response:
174 content = response.read()
175 assert response.status == status, (path, response.status, content[:300])
176 value = json.loads(content) if content and response.headers.get("Content-Type", "").startswith("application/json") else content.decode()
177 return value, response.headers
178
179 def pair(actor, label):
180 pending, _ = http("/pairing", "POST", {"name": label, "platform": "fixture"}, status=201)
181 credentials.append(pending["token"])
182 http("/pairing", token=pending["token"], status=202)
183 machine, _ = http("/api/mcp/relay/pair", "POST", {"code": pending["code"]}, actor=actor)
184 http("/api/mcp/relay/pair", "POST", {"code": pending["code"]}, actor=actor, status=410)
185 assert "tokenHash" not in machine and "token" not in machine
186 result, _ = http("/pairing", token=pending["token"])
187 assert result["machine_id"] == machine["id"]
188 return machine, pending["token"]
189
190 def key(actor, machines, write=False):
191 result, _ = http("/api/mcp/relay/keys", "POST", {"name": marker, "resources": machines, "write": write}, actor=actor)
192 credentials.append(result["key"])
193 return result
194
195 def rpc(token, method, params=None, error=False):
196 response, _ = http("/mcp/agents", "POST", {"jsonrpc": "2.0", "id": 1, "method": method, **({"params": params} if params is not None else {})}, token=token)
197 assert "error" not in response, response
198 result = response["result"]
199 if method == "tools/call":
200 assert bool(result.get("isError")) == error, result
201 return result
202
203 def call(token, name, fields=None, error=False):
204 return rpc(token, "tools/call", {"name": name, "arguments": fields or {}}, error=error)
205
206 def command(token, machine, method="list_threads", params=None, status=200):
207 return http("/api/v1/machines/" + machine + "/commands", "POST", {"method": method, "params": params or {}}, token=token, status=status)[0]
208
209 def connect(token):
210 agent = Agent(args.url, token)
211 agents.append(agent)
212 return agent
213
214 try:
215 for name in names:
216 keycloak.request("/admin/realms/master/users", "POST", {"username": name, "enabled": True})
217 first, token1 = pair(names[0], "First fixture")
218 second, token2 = pair(names[0], "Second fixture")
219 foreign, foreign_token = pair(names[1], "Foreign fixture")
220 http("/api/mcp/relay/machines/" + first["id"], "DELETE", actor=names[1], status=404)
221 http("/api/mcp/relay/machines/" + first["id"], "PATCH", {"name": "Renamed fixture"}, actor=names[0])
222 http("/api/mcp/relay/pair", "POST", {"code": "random"}, actor=names[0], status=403, headers={"Origin": "https://other.invalid"})
223 http("/api/mcp/relay/keys", "POST", {"name": marker, "resources": [foreign["id"]]}, actor=names[0], status=403)
224 http("/pairing", "POST", {}, status=421, headers={"Host": "other.invalid"})
225 read = key(names[0], [first["id"], second["id"]])
226 control = key(names[0], [first["id"], second["id"]], write=True)
227 command(control["key"], foreign["id"], status=403)
228 command(read["key"], first["id"], "start_thread", {"provider": "codex", "cwd": "/owned", "message": "fixture"}, status=403)
229 http("/api/v1/machines", status=401, headers={"User-Name": names[0], "User-Groups": "infra-admin", "Studio-Proxy-Token": proof})
230 http("/api/v1/machines", token=read["key"], status=403, headers={"Origin": "https://other.invalid"})
231 Agent(args.url, token1, status=401, origin=origin)
232 Agent(args.url, token1, status=421, host="other.invalid")
233 live = opener.open(urllib.request.Request(args.url + "/api/mcp/relay/live", headers={"Host": "globe.studio.test", "Studio-Proxy-Token": proof, "User-Name": names[0], "User-Groups": ""}), timeout=10)
234 def snapshot():
235 while line := live.readline():
236 if line.startswith(b"data:"):
237 value = json.loads(line.split(b":", 1)[1])
238 assert {m["id"] for m in value} == {first["id"], second["id"]}
239 return value
240 raise AssertionError("Machine stream closed")
241 try:
242 assert not any(m["online"] for m in snapshot())
243 a1 = connect(token1)
244 assert sum(m["online"] for m in snapshot()) == 1
245 a2 = connect(token2)
246 assert all(m["online"] for m in snapshot())
247 http("/api/mcp/relay/machines/" + first["id"], "PATCH", {"name": "Stream renamed fixture"}, actor=names[0])
248 assert next(m for m in snapshot() if m["id"] == first["id"])["name"] == "Stream renamed fixture"
249 finally:
250 live.close()
251 Agent(args.url, token1, status=409)
252 assert a1.machine == first["id"] and a2.machine == second["id"]
253 init = rpc(control["key"], "initialize", {"protocolVersion": "2025-11-25", "capabilities": {}, "clientInfo": {"name": marker, "version": "1"}})
254 assert init["capabilities"]["tools"] == {}
255 listed = rpc(control["key"], "tools/list")
256 assert listed["ttlMs"] == 0 and listed["cacheScope"] == "private", listed
257 tools = listed["tools"]
258 assert len(tools) == 7
259 assert next(t for t in tools if t["name"] == "send_message")["annotations"]["readOnlyHint"] is False
260 call(control["key"], "send_message", {"provider": "codex", "thread_id": str(uuid.uuid4()), "message": "ambiguous fixture"}, error=True)
261 assert a1.frames.empty() and a2.frames.empty()
262 results = call(read["key"], "list_threads")["structuredContent"]["results"]
263 assert len(results) == 2 and all(r["result"]["params"] == {"limit": 30} for r in results)
264 a1.frames.get(timeout=2); a2.frames.get(timeout=2)
265 call(control["key"], "set_target_machines", {"machine_ids": [foreign["id"]]}, error=True)
266 call(control["key"], "set_target_machines", {"machine_ids": [first["id"]]})
267 unchanged, _ = http("/api/v1/machines", token=read["key"])
268 assert len(unchanged) == 2 and all(m["selected"] for m in unchanged)
269 write_params = {"provider": "claude", "thread_id": str(uuid.uuid4()), "message": "owned fixture", "expected_turn_id": str(uuid.uuid4())}
270 call(control["key"], "send_message", write_params)
271 assert a1.frames.get(timeout=2)["params"] == write_params and a2.frames.empty()
272 command(control["key"], first["id"], params={"limit": 101}, status=400)
273 assert a1.frames.empty()
274 call(control["key"], "send_message", {"provider": "codex", "thread_id": str(uuid.uuid4()), "message": "雪" * 100000}, error=True)
275 assert a1.frames.empty()
276 a1.mode = "hold"
277 with ThreadPoolExecutor(max_workers=9) as pool:
278 pending = [pool.submit(command, control["key"], first["id"]) for _ in range(8)]
279 frames = [a1.frames.get(timeout=10) for _ in range(8)]
280 command(control["key"], first["id"], status=429)
281 for frame in frames:
282 a1.send({"id": frame["id"], "result": {"bounded": True}})
283 assert all(future.result(timeout=10)["result"] == {"bounded": True} for future in pending)
284 started = time.monotonic()
285 outcome = command(control["key"], first["id"], status=409)
286 elapsed = time.monotonic() - started
287 frame = a1.frames.get(timeout=2)
288 assert "unknown" in outcome["error"] and 29 <= elapsed < 40 and a1.pings >= 1
289 a1.send({"id": frame["id"], "result": {"late": True}})
290 a1.mode = "reply"
291 assert command(control["key"], first["id"])["result"]["params"] == {"limit": 30}
292 a1.frames.get(timeout=2)
293 a1.mode = "drop"
294 started = time.monotonic()
295 outcome = command(control["key"], first["id"], "send_message", write_params, status=409)
296 assert "unknown" in outcome["error"] and time.monotonic() - started < 5
297 a1.frames.get(timeout=2)
298 a1.close()
299 a1 = connect(token1)
300 time.sleep(.2)
301 assert a1.frames.empty()
302 assert command(control["key"], first["id"])["result"]["method"] == "list_threads"
303 a1.frames.get(timeout=2)
304 metadata, _ = http("/.well-known/oauth-protected-resource/mcp/agents")
305 assert metadata["resource"] == resource and "sessions:write" in metadata["scopes_supported"]
306 client, _ = http("/oauth/register", "POST", {"client_name": marker, "redirect_uris": ["http://127.0.0.1:20001/callback"]}, status=201)
307 verifier = uuid.uuid4().hex + uuid.uuid4().hex
308 fields = {"response_type": "code", "client_id": client["client_id"], "redirect_uri": client["redirect_uris"][0], "resource": resource, "scope": "sessions:read sessions:write offline_access",
309 "code_challenge_method": "S256", "code_challenge": base64.urlsafe_b64encode(hashlib.sha256(verifier.encode()).digest()).decode().rstrip("=")}
310 _, headers = http("/oauth/authorize?" + urllib.parse.urlencode(fields), status=302)
311 request_id = urllib.parse.urlsplit(headers["Location"]).path.removeprefix("/connect/")
312 consent_path = "/api/mcp/consent/" + request_id
313 details, _ = http(consent_path, actor=names[0])
314 assert {r["id"] for r in details["resources"]} == {first["id"], second["id"]}
315 http(consent_path, actor=names[1], status=403)
316 result, _ = http(consent_path, "POST", {"resources": [first["id"]]}, actor=names[0])
317 code = urllib.parse.parse_qs(urllib.parse.urlsplit(result["redirect"]).query)["code"][0]
318 tokens, _ = http("/oauth/token", "POST", {"grant_type": "authorization_code", "client_id": client["client_id"], "redirect_uri": fields["redirect_uri"], "resource": resource, "code_verifier": verifier, "code": code}, form=True)
319 credentials.extend([tokens["access_token"], tokens["refresh_token"]])
320 assert len(call(tokens["access_token"], "list_machines")["structuredContent"]["machines"]) == 1
321 http("/mcp/observability", "POST", {}, token=tokens["access_token"], status=401)
322 http("/oauth/token", "POST", {"grant_type": "refresh_token", "client_id": client["client_id"], "refresh_token": tokens["refresh_token"], "resource": origin + "/mcp/observability"}, status=400, form=True)
323 rotated, _ = http("/oauth/token", "POST", {"grant_type": "refresh_token", "client_id": client["client_id"], "refresh_token": tokens["refresh_token"], "resource": resource}, form=True)
324 credentials.extend([rotated["access_token"], rotated["refresh_token"]])
325 with sqlite3.connect(args.data_dir / "connections.sqlite") as db:
326 rows = db.execute("SELECT key,value FROM records").fetchall()
327 assert all(not any(secret in key + value for secret in credentials) for key, value in rows)
328 expired, _ = http("/pairing", "POST", {"name": marker, "platform": "test"}, status=201)
329 code_hash = hashlib.sha256(expired["code"].replace("-", "").encode()).hexdigest()
330 db.execute("UPDATE records SET expires=1 WHERE key=?", ("pair:" + code_hash,))
331 http("/pairing", token=expired["token"], status=410)
332 subprocess.run(["systemctl", "restart", args.restart_unit], check=True, timeout=180, capture_output=True)
333 for agent in agents:
334 assert agent.closed.wait(5)
335 a1, a2 = connect(token1), connect(token2)
336 assert command(read["key"], first["id"])["result"]["method"] == "list_threads"
337 a1.frames.get(timeout=2)
338 assert len(call(rotated["access_token"], "list_machines")["structuredContent"]["machines"]) == 1
339 http("/api/mcp/connections/" + control["id"], "DELETE", actor=names[0], status=204)
340 http("/api/v1/machines", token=control["key"], status=401)
341 assert a1.frames.empty()
342 http("/api/mcp/relay/machines/" + first["id"], "DELETE", actor=names[0], status=204)
343 assert a1.closed.wait(5)
344 Agent(args.url, token1, status=401)
345 http("/pairing", token=token1, status=410)
346 remaining = call(read["key"], "list_machines")["structuredContent"]["machines"]
347 assert len(remaining) == 1 and remaining[0]["id"] == second["id"] and remaining[0]["selected"]
348 http("/api/v1/targets", "PUT", {"machine_ids": [first["id"]]}, token=read["key"], status=403)
349 a2.send({"id": str(uuid.uuid4()), "result": {}, "error": "malformed"})
350 assert a2.closed.wait(5)
351 original_agent_checks = None
352 if args.agent_dir:
353 node = next(Path("/nix/store").glob("*nodejs-24*/bin/node"))
354 with tempfile.TemporaryDirectory(prefix="studio-relay-cli-") as temporary:
355 local = Path(temporary)
356 home = local / "home"
357 home.mkdir()
358 (home / "codex").mkdir()
359 (home / "claude/projects").mkdir(parents=True)
360 with sqlite3.connect(home / "codex/state_5.sqlite") as catalog:
361 catalog.execute("CREATE TABLE threads(id TEXT,title TEXT,cwd TEXT,updated_at INTEGER,rollout_path TEXT,archived INTEGER)")
362 allowed = local / "workspace"
363 allowed.mkdir()
364 resolver = local / "lookup.cjs"
365 resolver.write_text("const dns=require('node:dns'); const original=dns.lookup; dns.lookup=function(host,opts,callback){if(host==='globe.studio.test'){if(typeof opts==='function'){callback=opts;opts={};} process.nextTick(()=>opts?.all?callback(null,[{address:'127.0.0.1',family:4}]):callback(null,'127.0.0.1',4));}else{return original.apply(this,arguments);}};\n")
366 executable = local / "model-fixture"
367 executable.write_text("#!/bin/sh\nexec " + str(node) + " " + str(args.agent_dir / "fake-cli.mjs") + ' "$@"\n')
368 executable.chmod(0o700)
369 log = local / "agent.log"
370 environment = {**os.environ, "HOME": str(home), "CODEX_HOME": str(home / "codex"), "CLAUDE_CONFIG_DIR": str(home / "claude"),
371 "PATH": str(node.parent) + ":" + os.environ.get("PATH", ""), "NODE_OPTIONS": "--require " + str(resolver), "NODE_EXTRA_CA_CERTS": str(args.agent_ca)}
372 output = queue.Queue()
373 with log.open("w") as stderr:
374 process = subprocess.Popen([str(node), str(args.agent_dir / "dist/agent.js"), "run", "--server", args.agent_origin,
375 "--name", marker, "--data-dir", str(local / "identity"), "--allow-root", str(allowed),
376 "--codex-bin", str(executable), "--claude-bin", str(executable)], env=environment, stdout=subprocess.PIPE, stderr=stderr, text=True)
377 reader = threading.Thread(target=lambda: [output.put(line) for line in process.stdout], daemon=True)
378 reader.start()
379 try:
380 deadline = time.monotonic() + 15
381 code = None
382 while not code and time.monotonic() < deadline:
383 line = output.get(timeout=15)
384 match = re.search(r"code ([A-F0-9]{5}-[A-F0-9]{5})", line)
385 if match:
386 code = match[1]
387 assert code, "Original agent did not begin pairing"
388 machine, _ = http("/api/mcp/relay/pair", "POST", {"code": code}, actor=names[0])
389 deadline = time.monotonic() + 15
390 while time.monotonic() < deadline:
391 overview, _ = http("/api/mcp", actor=names[0])
392 if any(m["id"] == machine["id"] and m["online"] for m in overview["machines"]):
393 break
394 time.sleep(.2)
395 else:
396 raise AssertionError("Original agent did not connect")
397 credential_file = local / "identity/agent.json"
398 assert credential_file.stat().st_mode & 0o777 == 0o600
399 native_key = key(names[0], [machine["id"]], write=True)
400 assert command(native_key["key"], machine["id"])["result"] == {"threads": [], "errors": []}
401 for provider in ["codex", "claude"]:
402 started = command(native_key["key"], machine["id"], "start_thread", {"provider": provider, "cwd": str(allowed), "message": "owned fixture"})["result"]
403 thread = started["thread_id"]
404 time.sleep(.05)
405 read_fields = {"provider": provider, "thread_id": thread}
406 transcript = command(native_key["key"], machine["id"], "read_thread", read_fields)["result"]
407 assert "fixture reply" in json.dumps(transcript)
408 command(native_key["key"], machine["id"], "send_message", {**read_fields, "message": "slow"})
409 if provider == "claude":
410 live = command(native_key["key"], machine["id"], "read_thread", read_fields)["result"]
411 command(native_key["key"], machine["id"], "interrupt_thread", {**read_fields, "expected_turn_id": live["active_turn_id"]})
412 command(native_key["key"], machine["id"], "start_thread", {"provider": "codex", "cwd": str(home), "message": "outside allowed directory"}, status=400)
413 http("/api/mcp/relay/machines/" + machine["id"], "DELETE", actor=names[0], status=204)
414 assert process.wait(timeout=10) != 0
415 original_agent_checks = {"tls_pairing_and_outbound_wss": True, "credential_mode_0600": True, "codex_and_claude_owned_session_roundtrip": True,
416 "session_control_and_expected_turn": True, "local_directory_allowlist": True, "unlink_rejects_reconnect": True}
417 finally:
418 if process.poll() is None:
419 process.terminate()
420 process.wait(timeout=10)
421 process.stdout.close()
422 reader.join(timeout=5)
423 result = {"native_pairing_single_use_and_expiry": True, "existing_agents_wire_protocol": True, "ordinary_realm_user_consent": True,
424 "machine_and_cross_catalog_isolation": True, "explicit_control_scope": True, "single_machine_writes": True,
425 "per_connection_target_selection": True, "native_mcp_tools": True, "owned_machine_stream": True, "eight_pending_limit": True, "unicode_command_frame_budget": True,
426 "heartbeat_and_timeout_unknown_outcome": True, "disconnect_unknown_outcome_no_replay": True,
427 "hash_only_credentials": True, "restart_preserves_pairing_keys_and_oauth": True,
428 "revoke_and_unlink_immediate": True, "origin_host_and_malformed_frames_refused": True,
429 "timeout_seconds": round(elapsed, 2)}
430 if original_agent_checks is not None:
431 result["original_node_agent"] = original_agent_checks
432 finally:
433 for agent in agents:
434 agent.close()
435 keycloak = Keycloak("keycloak.studio.test", importlib.import_module("dashboard-run").secret("get", "keycloak", "password"), attempts=1)
436 for name in names:
437 try:
438 overview, _ = http("/api/mcp", actor=name)
439 for connection in overview["connections"]:
440 http("/api/mcp/connections/" + connection["id"], "DELETE", actor=name, status=204)
441 for machine in overview["machines"]:
442 http("/api/mcp/relay/machines/" + machine["id"], "DELETE", actor=name, status=204)
443 finally:
444 for identity in keycloak.request("/admin/realms/master/users?username=" + name + "&exact=true"):
445 keycloak.request("/admin/realms/master/users/" + identity["id"], "DELETE")
446 assert not keycloak.request("/admin/realms/master/users?username=" + name + "&exact=true")
447 result["owned_users_and_machines_removed"] = True
448 if args.output:
449 args.output.write_text(json.dumps(result, indent=2) + "\n")
450 print(json.dumps(result))
451
452
453if __name__ == "__main__":
454 main()
tools/dashboard-routing-test.py+18-18
...@@ -22,8 +22,8 @@ def main():...@@ -22,8 +22,8 @@ def main():
22 parser.add_argument("--output", type=Path)22 parser.add_argument("--output", type=Path)
23 args = parser.parse_args()23 args = parser.parse_args()
24 proof = uuid.uuid4().hex + uuid.uuid4().hex24 proof = uuid.uuid4().hex + uuid.uuid4().hex
25 container = "studio-dashboard-routing-test-" + uuid.uuid4().hex[:12]25 container = "snowglobe-dashboard-routing-test-" + uuid.uuid4().hex[:12]
26 fixture_id = "studio-routing-fixture-" + uuid.uuid4().hex[:12]26 fixture_id = "snowglobe-routing-fixture-" + uuid.uuid4().hex[:12]
27 trace_id = uuid.uuid4().hex27 trace_id = uuid.uuid4().hex
28 redirected = []28 redirected = []
2929
...@@ -46,19 +46,19 @@ def main():...@@ -46,19 +46,19 @@ def main():
46 self.send_header("Content-Type", "application/json")46 self.send_header("Content-Type", "application/json")
47 self.end_headers()47 self.end_headers()
48 self.wfile.write(json.dumps({"path": self.path, "host": self.headers.get("Host"),48 self.wfile.write(json.dumps({"path": self.path, "host": self.headers.get("Host"),
49 "proof": self.headers.get("Studio-Proxy-Token"),49 "proof": self.headers.get("Snowglobe-Proxy-Token"),
50 "user": self.headers.get("User-Name")}).encode())50 "user": self.headers.get("User-Name")}).encode())
5151
52 def log_message(self, *args):52 def log_message(self, *args):
53 pass53 pass
5454
55 with tempfile.TemporaryDirectory(prefix="studio-dashboard-routing-", dir="/run") as temporary, HTTPServer(("127.0.0.1", 0), Fixture) as fixture:55 with tempfile.TemporaryDirectory(prefix="snowglobe-dashboard-routing-", dir="/run") as temporary, HTTPServer(("127.0.0.1", 0), Fixture) as fixture:
56 root = Path(temporary)56 root = Path(temporary)
57 threading.Thread(target=fixture.serve_forever, daemon=True).start()57 threading.Thread(target=fixture.serve_forever, daemon=True).start()
58 token = root / "proxy.token"58 token = root / "proxy.token"
59 token.write_text(proof)59 token.write_text(proof)
60 readonly = root / "nomad.token"60 readonly = root / "nomad.token"
61 readonly.write_bytes(Path("/var/lib/studio/dashboard.token").read_bytes())61 readonly.write_bytes(Path("/var/lib/snowglobe/dashboard.token").read_bytes())
62 for file in [token, readonly]:62 for file in [token, readonly]:
63 os.chown(file, 0, 65534)63 os.chown(file, 0, 65534)
64 file.chmod(0o440)64 file.chmod(0o440)
...@@ -71,14 +71,14 @@ def main():...@@ -71,14 +71,14 @@ def main():
71 continue71 continue
72 else:72 else:
73 raise AssertionError("no fixture listener available")73 raise AssertionError("no fixture listener available")
74 os.environ.update(STUDIO_DOMAIN="studio.test", STUDIO_INTERNAL_PORT=str(port),74 os.environ.update(SNOWGLOBE_DOMAIN="snowglobe.test", SNOWGLOBE_INTERNAL_PORT=str(port),
75 STUDIO_DASHBOARD_PORT="7072", STUDIO_PROXY_TOKEN_FILE=str(token))75 SNOWGLOBE_DASHBOARD_PORT="7072", SNOWGLOBE_PROXY_TOKEN_FILE=str(token))
76 real_nomad = router.nomad76 real_nomad = router.nomad
7777
78 def discovery(path, supplied):78 def discovery(path, supplied):
79 if path in ["/v1/service/routing-fixture", "/v1/service/qbittorrent"]:79 if path in ["/v1/service/routing-fixture", "/v1/service/qbittorrent"]:
80 return [{"ServiceName": path.rsplit("/", 1)[1], "AllocID": "routing-fixture", "Address": "127.0.0.1",80 return [{"ServiceName": path.rsplit("/", 1)[1], "AllocID": "routing-fixture", "Address": "127.0.0.1",
81 "Port": fixture.server_port, "Tags": ["caddy-host=routing-fixture.studio.test"]}]81 "Port": fixture.server_port, "Tags": ["caddy-host=routing-fixture.snowglobe.test"]}]
82 if path == "/v1/allocation/routing-fixture/checks":82 if path == "/v1/allocation/routing-fixture/checks":
83 return {"ready": {"Status": "failure"}}83 return {"ready": {"Status": "failure"}}
84 value = real_nomad(path, supplied)84 value = real_nomad(path, supplied)
...@@ -87,7 +87,7 @@ def main():...@@ -87,7 +87,7 @@ def main():
87 return value87 return value
8888
89 router.nomad = discovery89 router.nomad = discovery
90 host = "dashboard.internal.studio.test"90 host = "dashboard.internal.snowglobe.test"
91 content = router.render(Path(router.TOKEN).read_text().strip())91 content = router.render(Path(router.TOKEN).read_text().strip())
92 gateway = content[content.index(host + ":" + str(port) + " {"):]92 gateway = content[content.index(host + ":" + str(port) + " {"):]
93 config = root / "Caddyfile"93 config = root / "Caddyfile"
...@@ -107,7 +107,7 @@ def main():...@@ -107,7 +107,7 @@ def main():
107 time.sleep(.1)107 time.sleep(.1)
108 ca.chmod(0o444)108 ca.chmod(0o444)
109 image = json.loads(shell("podman", "image", "inspect", args.image))[0]109 image = json.loads(shell("podman", "image", "inspect", args.image))[0]
110 python = next(value.split("=", 1)[1] for value in image["Config"]["Env"] if value.startswith("STUDIO_YT_PYTHON="))110 python = next(value.split("=", 1)[1] for value in image["Config"]["Env"] if value.startswith("SNOWGLOBE_YT_PYTHON="))
111 client = f"""import json, ssl, time, urllib.request, urllib.error111 client = f"""import json, ssl, time, urllib.request, urllib.error
112base = 'https://{host}:{port}'112base = 'https://{host}:{port}'
113proof = open('/proxy.token').read().strip()113proof = open('/proxy.token').read().strip()
...@@ -116,7 +116,7 @@ context = ssl.create_default_context(cafile='/ca.crt')...@@ -116,7 +116,7 @@ context = ssl.create_default_context(cafile='/ca.crt')
116def request(path, supplied=proof, method='GET', body=None, content_type='application/json'):116def request(path, supplied=proof, method='GET', body=None, content_type='application/json'):
117 headers = {{'User-Name': 'forged', 'X-Nomad-Token': nomad, 'Content-Type': content_type}}117 headers = {{'User-Name': 'forged', 'X-Nomad-Token': nomad, 'Content-Type': content_type}}
118 if supplied is not None:118 if supplied is not None:
119 headers['Studio-Proxy-Token'] = supplied119 headers['Snowglobe-Proxy-Token'] = supplied
120 query = urllib.request.Request(base + path, data=body, headers=headers, method=method)120 query = urllib.request.Request(base + path, data=body, headers=headers, method=method)
121 try:121 try:
122 with urllib.request.urlopen(query, context=context, timeout=15) as response:122 with urllib.request.urlopen(query, context=context, timeout=15) as response:
...@@ -127,8 +127,8 @@ for supplied in [None, '0' * 64, proof[:-1], proof + '0']:...@@ -127,8 +127,8 @@ for supplied in [None, '0' * 64, proof[:-1], proof + '0']:
127 assert request('/nomad/v1/services', supplied)[0] == 403127 assert request('/nomad/v1/services', supplied)[0] == 403
128status, body = request('/nomad/v1/services')128status, body = request('/nomad/v1/services')
129assert status == 200 and isinstance(json.loads(body), list), (status, body)129assert status == 200 and isinstance(json.loads(body), list), (status, body)
130assert request('/nomad/v1/var/studio-routing-fixture')[0] == 403130assert request('/nomad/v1/var/snowglobe-routing-fixture')[0] == 403
131status, body = request('/nomad/v1/jobs', method='POST', body=json.dumps({{'Job': {{'ID': 'studio-routing-fixture', 'Name': 'studio-routing-fixture', 'Type': 'service', 'Datacenters': ['clover'], 'TaskGroups': [{{'Name': 'fixture', 'Count': 0, 'Tasks': [{{'Name': 'probe', 'Driver': 'podman', 'Config': {{'image': 'alpine:3.22'}}, 'Resources': {{'CPU': 100, 'MemoryMB': 32}}}}]}}]}}}}).encode())131status, body = request('/nomad/v1/jobs', method='POST', body=json.dumps({{'Job': {{'ID': 'snowglobe-routing-fixture', 'Name': 'snowglobe-routing-fixture', 'Type': 'service', 'Datacenters': ['clover'], 'TaskGroups': [{{'Name': 'fixture', 'Count': 0, 'Tasks': [{{'Name': 'probe', 'Driver': 'podman', 'Config': {{'image': 'alpine:3.22'}}, 'Resources': {{'CPU': 100, 'MemoryMB': 32}}}}]}}]}}}}).encode())
132assert status == 403, (status, body)132assert status == 403, (status, body)
133assert request('/services/unknown-fixture/health')[0] == 404133assert request('/services/unknown-fixture/health')[0] == 404
134for service in ['victoria-metrics', 'victoria-logs', 'victoria-traces']:134for service in ['victoria-metrics', 'victoria-logs', 'victoria-traces']:
...@@ -139,7 +139,7 @@ result = json.loads(body)...@@ -139,7 +139,7 @@ result = json.loads(body)
139assert status == 200 and result == {{'path': '/probe?fixture=1', 'host': '127.0.0.1:{fixture.server_port}', 'proof': None, 'user': None}}, result139assert status == 200 and result == {{'path': '/probe?fixture=1', 'host': '127.0.0.1:{fixture.server_port}', 'proof': None, 'user': None}}, result
140# Keep fixture samples outside VictoriaMetrics' query latency window.140# Keep fixture samples outside VictoriaMetrics' query latency window.
141at = time.time() - 60141at = time.time() - 60
142metric = 'studio_service_cpu_cores{{service="{fixture_id}"}} 0.125 ' + str(int(at * 1000)) + '\\n'142metric = 'snowglobe_service_cpu_cores{{service="{fixture_id}"}} 0.125 ' + str(int(at * 1000)) + '\\n'
143status, body = request('/services/victoria-metrics/api/v1/import/prometheus', method='POST', body=metric.encode(), content_type='text/plain')143status, body = request('/services/victoria-metrics/api/v1/import/prometheus', method='POST', body=metric.encode(), content_type='text/plain')
144assert status == 204, (status, body)144assert status == 204, (status, body)
145row = {{'_time': str(at), '_msg': 'Routing fixture', 'source': 'nomad', 'job': '{fixture_id}', 'task': 'probe', 'stream': 'stdout'}}145row = {{'_time': str(at), '_msg': 'Routing fixture', 'source': 'nomad', 'job': '{fixture_id}', 'task': 'probe', 'stream': 'stdout'}}
...@@ -172,15 +172,15 @@ print(json.dumps({{'private_bridge': True, 'nonroot': __import__('os').getuid()...@@ -172,15 +172,15 @@ print(json.dumps({{'private_bridge': True, 'nonroot': __import__('os').getuid()
172 "--add-host=" + host + ":host-gateway", "--publish=127.0.0.1::7072",172 "--add-host=" + host + ":host-gateway", "--publish=127.0.0.1::7072",
173 "--volume=" + str(ca) + ":/ca.crt:ro", "--volume=" + str(token) + ":/proxy.token:ro",173 "--volume=" + str(ca) + ":/ca.crt:ro", "--volume=" + str(token) + ":/proxy.token:ro",
174 "--volume=" + str(readonly) + ":/nomad.token:ro", "--volume=" + str(data) + ":/data:rw",174 "--volume=" + str(readonly) + ":/nomad.token:ro", "--volume=" + str(data) + ":/data:rw",
175 "--env=STUDIO_PROXY_TOKEN_FILE=/proxy.token", "--env=STUDIO_NOMAD_TOKEN_FILE=/nomad.token",175 "--env=SNOWGLOBE_PROXY_TOKEN_FILE=/proxy.token", "--env=SNOWGLOBE_NOMAD_TOKEN_FILE=/nomad.token",
176 "--env=STUDIO_CA_BUNDLE=/ca.crt", f"--env=STUDIO_INTERNAL_URL=https://{host}:{port}",176 "--env=SNOWGLOBE_CA_BUNDLE=/ca.crt", f"--env=SNOWGLOBE_INTERNAL_URL=https://{host}:{port}",
177 "--env=STUDIO_DATA_DIR=/data", "--env=STUDIO_DOMAIN=studio.test", args.image)177 "--env=SNOWGLOBE_DATA_DIR=/data", "--env=SNOWGLOBE_DOMAIN=snowglobe.test", args.image)
178 info = json.loads(shell("podman", "inspect", container))[0]178 info = json.loads(shell("podman", "inspect", container))[0]
179 app_port = info["NetworkSettings"]["Ports"]["7072/tcp"][0]["HostPort"]179 app_port = info["NetworkSettings"]["Ports"]["7072/tcp"][0]["HostPort"]
180180
181 def dashboard(path):181 def dashboard(path):
182 request = urllib.request.Request("http://127.0.0.1:" + app_port + path, headers={182 request = urllib.request.Request("http://127.0.0.1:" + app_port + path, headers={
183 "Studio-Proxy-Token": proof, "User-Name": "fixture", "User-Groups": "infra-admin",183 "Snowglobe-Proxy-Token": proof, "User-Name": "fixture", "User-Groups": "infra-admin",
184 })184 })
185 with urllib.request.urlopen(request, timeout=20) as response:185 with urllib.request.urlopen(request, timeout=20) as response:
186 return json.load(response)186 return json.load(response)
tools/dashboard-run.py+9-9
...@@ -28,7 +28,7 @@ FIELDS = {...@@ -28,7 +28,7 @@ FIELDS = {
28ACTIONS = {"deploy", "destroy", "rollback", "start", "stop", "restart", "secret-set", "secret-rotate"}28ACTIONS = {"deploy", "destroy", "rollback", "start", "stop", "restart", "secret-set", "secret-rotate"}
29MAX_LOG = 1024 * 102429MAX_LOG = 1024 * 1024
30MAX_METADATA = 6553630MAX_METADATA = 65536
31HOST_STATE = Path(os.environ.get("STUDIO_HOST_STATE_ROOT", "/var/lib/studio/host"))31HOST_STATE = Path(os.environ.get("SNOWGLOBE_HOST_STATE_ROOT", "/var/lib/snowglobe/host"))
3232
3333
34class Error(Exception):34class Error(Exception):
...@@ -98,7 +98,7 @@ def nomad(path, method="GET", body=None, timeout=10):...@@ -98,7 +98,7 @@ def nomad(path, method="GET", body=None, timeout=10):
98def secret(action, target, key, value=None):98def secret(action, target, key, value=None):
99 service(target, key)99 service(target, key)
100 job = nomad("job/" + target)100 job = nomad("job/" + target)
101 specs = json.loads((job or {}).get("Meta", {}).get("studio_secrets", "[]"))101 specs = json.loads((job or {}).get("Meta", {}).get("snowglobe_secrets", "[]"))
102 if not isinstance(specs, list):102 if not isinstance(specs, list):
103 raise Error(502, "The service's secret names couldn't be read. Deploy its current release again.")103 raise Error(502, "The service's secret names couldn't be read. Deploy its current release again.")
104 matches = [spec for spec in specs if isinstance(spec, dict) and spec.get("name") == key]104 matches = [spec for spec in specs if isinstance(spec, dict) and spec.get("name") == key]
...@@ -160,7 +160,7 @@ def command(action, target, key=None):...@@ -160,7 +160,7 @@ def command(action, target, key=None):
160 version = release.current_release()160 version = release.current_release()
161 if version is None:161 if version is None:
162 raise Error(409, "No release is running. Deploy a release before starting this service.")162 raise Error(409, "No release is running. Deploy a release before starting this service.")
163 return [sys.executable, str(release.check_release(version) / "tools/studio.py"), "deploy", target]163 return [sys.executable, str(release.transition.layout(release.check_release(version))["script"]), "deploy", target]
164 if action == "rollback":164 if action == "rollback":
165 saved = entry(target)165 saved = entry(target)
166 version = saved["release"]166 version = saved["release"]
...@@ -177,7 +177,7 @@ def command(action, target, key=None):...@@ -177,7 +177,7 @@ def command(action, target, key=None):
177 if not isinstance(version, str):177 if not isinstance(version, str):
178 raise Error(409, "This stage has no release. Stage it again.")178 raise Error(409, "This stage has no release. Stage it again.")
179 root = release.check_release(version)179 root = release.check_release(version)
180 return [sys.executable, str(root / "tools/studio.py"), "destroy", target]180 return [sys.executable, str(release.transition.layout(root)["script"]), "destroy", target]
181181
182182
183def last():183def last():
...@@ -201,7 +201,7 @@ def run(identity):...@@ -201,7 +201,7 @@ def run(identity):
201 raise Error(404, "That run is no longer available.")201 raise Error(404, "That run is no longer available.")
202 code = read(root / (identity + ".exit"), 64)202 code = read(root / (identity + ".exit"), 64)
203 if code is None:203 if code is None:
204 shown = subprocess.run(["systemctl", "show", "--property=ActiveState,ExecMainStatus,LoadState", "studio-run-" + identity],204 shown = subprocess.run(["systemctl", "show", "--property=ActiveState,ExecMainStatus,LoadState", "snowglobe-run-" + identity],
205 capture_output=True, text=True, timeout=5)205 capture_output=True, text=True, timeout=5)
206 state = dict(line.split("=", 1) for line in shown.stdout.splitlines() if "=" in line)206 state = dict(line.split("=", 1) for line in shown.stdout.splitlines() if "=" in line)
207 if shown.returncode and state.get("LoadState") != "not-found":207 if shown.returncode and state.get("LoadState") != "not-found":
...@@ -237,10 +237,10 @@ def start(action, target, key=None, value=None):...@@ -237,10 +237,10 @@ def start(action, target, key=None, value=None):
237 pending = HOST_STATE / "last-run.pending"237 pending = HOST_STATE / "last-run.pending"
238 pending.write_text(json.dumps(metadata) + "\n")238 pending.write_text(json.dumps(metadata) + "\n")
239 pending.replace(HOST_STATE / "last-run.json")239 pending.replace(HOST_STATE / "last-run.json")
240 args = ["systemd-run", "--unit=studio-run-" + identity, "--collect", "--quiet",240 args = ["systemd-run", "--unit=snowglobe-run-" + identity, "--collect", "--quiet",
241 "--property=RuntimeMaxSec=3600", "--property=TimeoutStopSec=10",241 "--property=RuntimeMaxSec=3600", "--property=TimeoutStopSec=10",
242 "--property=MemoryMax=4G", "--property=TasksMax=1024", "--property=CPUWeight=10"]242 "--property=MemoryMax=4G", "--property=TasksMax=1024", "--property=CPUWeight=10"]
243 args.extend("--setenv=" + key + "=" + value for key, value in os.environ.items() if key == "PATH" or key.startswith("STUDIO_"))243 args.extend("--setenv=" + key + "=" + value for key, value in os.environ.items() if key == "PATH" or key.startswith("SNOWGLOBE_"))
244 subprocess.run([*args, "--", sys.executable, str(Path(__file__)), identity, action, target, *([key] if key is not None else [])],244 subprocess.run([*args, "--", sys.executable, str(Path(__file__)), identity, action, target, *([key] if key is not None else [])],
245 check=True, capture_output=True, timeout=10)245 check=True, capture_output=True, timeout=10)
246 except BaseException:246 except BaseException:
...@@ -256,7 +256,7 @@ def handle(request):...@@ -256,7 +256,7 @@ def handle(request):
256 raise Error(400, "Choose a secret from this service's list.")256 raise Error(400, "Choose a secret from this service's list.")
257 service(request["service"], request["key"])257 service(request["service"], request["key"])
258 process = subprocess.run(["systemd-run", "--pipe", "--wait", "--collect", "--quiet",258 process = subprocess.run(["systemd-run", "--pipe", "--wait", "--collect", "--quiet",
259 "--unit=studio-secret-read-" + str(uuid.uuid4()), "--property=RuntimeMaxSec=25",259 "--unit=snowglobe-secret-read-" + str(uuid.uuid4()), "--property=RuntimeMaxSec=25",
260 "--property=MemoryMax=128M", "--property=TasksMax=8", "--property=ProtectSystem=strict",260 "--property=MemoryMax=128M", "--property=TasksMax=8", "--property=ProtectSystem=strict",
261 "--property=ProtectHome=yes", "--property=NoNewPrivileges=yes", "--property=CapabilityBoundingSet=",261 "--property=ProtectHome=yes", "--property=NoNewPrivileges=yes", "--property=CapabilityBoundingSet=",
262 "--property=RestrictAddressFamilies=AF_INET AF_UNIX", "--property=IPAddressDeny=any",262 "--property=RestrictAddressFamilies=AF_INET AF_UNIX", "--property=IPAddressDeny=any",
...@@ -372,7 +372,7 @@ def worker(identity, action, target, key=None):...@@ -372,7 +372,7 @@ def worker(identity, action, target, key=None):
372 try:372 try:
373 argv = command(action, target, key)373 argv = command(action, target, key)
374 output.write(("$ " + " ".join(argv) + "\n").encode())374 output.write(("$ " + " ".join(argv) + "\n").encode())
375 environment = None375 environment = release.transition.environment(Path(argv[1]).parent.parent) if len(argv) > 1 and argv[1].endswith(".py") else None
376 if action in {"stop", "restart"}:376 if action in {"stop", "restart"}:
377 environment = {**os.environ, "NOMAD_TOKEN": read(release.STATE / "nomad.token", missing="").strip()}377 environment = {**os.environ, "NOMAD_TOKEN": read(release.STATE / "nomad.token", missing="").strip()}
378 if not environment["NOMAD_TOKEN"]:378 if not environment["NOMAD_TOKEN"]:
tools/dashboard-shale-attribution-test.py+9-9
...@@ -127,14 +127,14 @@ def main():...@@ -127,14 +127,14 @@ def main():
127127
128 host_thread = threading.Thread(target=host_requests, daemon=True)128 host_thread = threading.Thread(target=host_requests, daemon=True)
129 host_thread.start()129 host_thread.start()
130 origin = 'https://globe.studio.test'130 origin = 'https://globe.snowglobe.test'
131 environment = {**os.environ, 'PORT': str(port), 'STUDIO_LISTEN_ADDRESS': '127.0.0.1',131 environment = {**os.environ, 'PORT': str(port), 'SNOWGLOBE_LISTEN_ADDRESS': '127.0.0.1',
132 'STUDIO_DATA_DIR': str(root / 'data'), 'STUDIO_PUBLIC_ORIGIN': origin,132 'SNOWGLOBE_DATA_DIR': str(root / 'data'), 'SNOWGLOBE_PUBLIC_ORIGIN': origin,
133 'STUDIO_AUTH_RP_ID': 'studio.test', 'STUDIO_FILE_ORIGIN': 'https://file.studio.test',133 'SNOWGLOBE_AUTH_RP_ID': 'snowglobe.test', 'SNOWGLOBE_FILE_ORIGIN': 'https://file.snowglobe.test',
134 'STUDIO_SHALE_URL': 'https://localhost:' + str(backend.server_port),134 'SNOWGLOBE_SHALE_URL': 'https://localhost:' + str(backend.server_port),
135 'STUDIO_CA_BUNDLE': str(cert), 'STUDIO_REPO': str(Path(__file__).resolve().parent.parent),135 'SNOWGLOBE_CA_BUNDLE': str(cert), 'SNOWGLOBE_REPO': str(Path(__file__).resolve().parent.parent),
136 'STUDIO_AUTH_REQUIRED': '0', 'STUDIO_HOST_SOCKET': str(root / 'host.sock')}136 'SNOWGLOBE_AUTH_REQUIRED': '0', 'SNOWGLOBE_HOST_SOCKET': str(root / 'host.sock')}
137 for name in ('STUDIO_PROXY_TOKEN_FILE', 'STUDIO_INTERNAL_URL', 'STUDIO_YT_STATE', 'STUDIO_INDEX_POOL'):137 for name in ('SNOWGLOBE_PROXY_TOKEN_FILE', 'SNOWGLOBE_INTERNAL_URL', 'SNOWGLOBE_YT_STATE', 'SNOWGLOBE_INDEX_POOL'):
138 environment.pop(name, None)138 environment.pop(name, None)
139 with (root / 'server.log').open('wb') as log:139 with (root / 'server.log').open('wb') as log:
140 server = subprocess.Popen([str(args.binary.resolve())], env=environment, stdout=log, stderr=log)140 server = subprocess.Popen([str(args.binary.resolve())], env=environment, stdout=log, stderr=log)
...@@ -162,7 +162,7 @@ def main():...@@ -162,7 +162,7 @@ def main():
162 def call(name, fields, error=False):162 def call(name, fields, error=False):
163 connection = http.client.HTTPConnection('127.0.0.1', port, timeout=15)163 connection = http.client.HTTPConnection('127.0.0.1', port, timeout=15)
164 connection.request('POST', '/mcp/shale', json.dumps({'jsonrpc': '2.0', 'id': 1, 'method': 'tools/call', 'params': {'name': name, 'arguments': fields}}),164 connection.request('POST', '/mcp/shale', json.dumps({'jsonrpc': '2.0', 'id': 1, 'method': 'tools/call', 'params': {'name': name, 'arguments': fields}}),
165 {'Host': 'globe.studio.test', 'Authorization': 'Bearer fixture', 'Accept': 'application/json, text/event-stream', 'Content-Type': 'application/json'})165 {'Host': 'globe.snowglobe.test', 'Authorization': 'Bearer fixture', 'Accept': 'application/json, text/event-stream', 'Content-Type': 'application/json'})
166 response = connection.getresponse()166 response = connection.getresponse()
167 body = response.read()167 body = response.read()
168 connection.close()168 connection.close()
tools/dashboard-shale-link-test.py deleted-463
...@@ -1,463 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import base64
4from concurrent.futures import ThreadPoolExecutor
5import copy
6import http.cookiejar
7import hashlib
8import importlib
9import json
10import math
11from pathlib import Path
12import sqlite3
13import ssl
14import subprocess
15import sys
16import time
17import urllib.error
18import urllib.parse
19import urllib.request
20import uuid
21
22
23class NoRedirect(urllib.request.HTTPRedirectHandler):
24 def redirect_request(self, request, fp, code, message, headers, newurl):
25 return None
26
27
28def main():
29 parser = argparse.ArgumentParser()
30 parser.add_argument('--url', required=True)
31 parser.add_argument('--proof-file', type=Path, required=True)
32 parser.add_argument('--data-dir', type=Path, required=True)
33 parser.add_argument('--restart-unit', required=True)
34 parser.add_argument('--shale-origin', required=True)
35 parser.add_argument('--shale-database', type=Path, required=True)
36 parser.add_argument('--shale-container', required=True)
37 parser.add_argument('--output', type=Path)
38 args = parser.parse_args()
39 if args.output:
40 args.output.unlink(missing_ok=True)
41 repo = Path(__file__).resolve().parent.parent
42 sys.path.insert(0, str(repo / 'service/keycloak'))
43 from api import Keycloak, LoopbackHTTPS
44 Page = importlib.import_module('dashboard-shale-test').Page
45 keycloak = Keycloak('keycloak.studio.test', importlib.import_module('dashboard-run').secret('get', 'keycloak', 'password'), attempts=1)
46 context = ssl.create_default_context(cafile='/var/lib/studio/ca-bundle.crt')
47 origin = 'https://globe.studio.test'
48 proof = args.proof_file.read_text().strip()
49 marker = 'shale-link-' + uuid.uuid4().hex
50 accounts = [(marker + '-one', uuid.uuid4().hex + 'A1!'), (marker + '-two', uuid.uuid4().hex + 'A1!'),
51 ('ai', uuid.uuid4().hex + 'A1!')]
52 ids = []
53 sessions = {name: uuid.uuid4().hex + uuid.uuid4().hex for name, _ in accounts}
54
55 class TLS(urllib.request.HTTPSHandler):
56 def https_open(self, request):
57 parsed = urllib.parse.urlsplit(request.full_url)
58 assert parsed.netloc in ('keycloak.studio.test', urllib.parse.urlsplit(args.shale_origin).netloc)
59 return self.do_open(LoopbackHTTPS, request, context=context)
60
61 def browser():
62 cookies = http.cookiejar.CookieJar()
63 return urllib.request.build_opener(TLS(), NoRedirect(), urllib.request.HTTPCookieProcessor(cookies)), cookies
64
65 def request(client, url, method='GET', body=None, headers=None, status=None):
66 try:
67 response = client.open(urllib.request.Request(url, method=method, data=body, headers=headers or {}), timeout=45)
68 except urllib.error.HTTPError as error:
69 response = error
70 with response:
71 value = response.read(4 * 1024 * 1024 + 1)
72 assert len(value) <= 4 * 1024 * 1024
73 if status is not None:
74 assert response.status == status, (urllib.parse.urlsplit(url).path, response.status, value[:300])
75 return response.status, response.headers, value.decode()
76
77 def api(actor, method='GET', path='/api/mcp', status=200, body=None):
78 _, _, body = request(urllib.request.build_opener(NoRedirect()), args.url + path, method,
79 body=json.dumps(body).encode() if body is not None else None,
80 headers={'Host': 'globe.studio.test', 'Studio-Proxy-Token': proof, 'User-Name': actor,
81 'Cookie': '__Host-snow-session=' + sessions[actor],
82 'User-Groups': '', 'Origin': origin, 'Content-Type': 'application/json'}, status=status)
83 return json.loads(body) if body and status < 400 else body or None
84
85 def records(prefix):
86 path = args.data_dir / 'connections.sqlite'
87 with sqlite3.connect(path.as_uri() + '?mode=ro', uri=True) as db:
88 return {key: json.loads(value) for key, value in db.execute('SELECT key,value FROM records WHERE substr(key,1,?)=?', (len(prefix), prefix))}
89
90 def session(index):
91 return records('shale-session:').get('shale-session:' + ids[index])
92
93 def session_count(index):
94 with sqlite3.connect(args.shale_database.as_uri() + '?mode=ro', uri=True) as db:
95 return db.execute('SELECT count(*) FROM sessions s JOIN users u ON s.user=u.id WHERE u.snowflake=?', (ids[index],)).fetchone()[0]
96
97 def start(index, pending=None):
98 target = api(accounts[index][0], 'POST', '/api/mcp/shale', body={'request': pending} if pending else {})['redirect']
99 assert target.startswith(args.shale_origin + '/-/studio-mcp/')
100 client, cookies = browser()
101 _, headers, _ = request(client, target, status=302)
102 link_cookies = [cookie for cookie in cookies if cookie.name == 'studio_mcp_shale_link']
103 assert len(link_cookies) == 1
104 cookie = link_cookies[0]
105 assert not cookie.domain_specified and cookie.secure and cookie.path == '/-/callback'
106 assert cookie.has_nonstandard_attr('HttpOnly') and cookie.get_nonstandard_attr('SameSite') == 'Lax'
107 assert headers.get('Referrer-Policy') == 'no-referrer'
108 assert headers.get('Cache-Control') == 'no-store'
109 request(browser()[0], target, status=410)
110 return client, cookies, headers['Location'], target
111
112 def authorize(client, authorization, index):
113 status, headers, body = request(client, authorization, status=200)
114 form = next(form for form in Page(body).forms if any(field.get('name') == 'password' for field in form['fields']))
115 target = urllib.parse.urljoin(authorization, form['action'])
116 assert urllib.parse.urlsplit(target).hostname == 'keycloak.studio.test'
117 fields = {field['name']: field.get('value', '') for field in form['fields'] if field.get('name')}
118 fields.update(username=accounts[index][0], password=accounts[index][1])
119 status, headers, body = request(client, target, 'POST', urllib.parse.urlencode(fields).encode(),
120 {'Content-Type': 'application/x-www-form-urlencoded', 'Origin': 'https://keycloak.studio.test'})
121 for _ in range(6):
122 assert status in (302, 303), status
123 target = urllib.parse.urljoin(target, headers['Location'])
124 parts = urllib.parse.urlsplit(target)
125 if parts.netloc == urllib.parse.urlsplit(args.shale_origin).netloc:
126 assert parts.path == '/-/callback' and 'code' in dict(urllib.parse.parse_qsl(parts.query))
127 return target
128 assert parts.netloc == 'keycloak.studio.test'
129 status, headers, body = request(client, target)
130 raise AssertionError('too many sign-in redirects')
131
132 def finish(client, target, status=303, pending=None):
133 _, headers, _ = request(client, target, status=status)
134 assert headers.get('Cache-Control') == 'no-store'
135 assert all(not cookie.startswith('SessionID=') for cookie in headers.get_all('Set-Cookie', []))
136 assert any('studio_mcp_shale_link=;' in cookie and 'Max-Age=0' in cookie for cookie in headers.get_all('Set-Cookie', []))
137 if status == 303:
138 assert headers['Location'] == origin + ('/connect/' + pending if pending else '/mcp/settings/shale')
139
140 def backend_session(value, status):
141 return request(browser()[0], args.shale_origin + '/-/settings', headers={'Cookie': 'SessionID=' + value['session']}, status=status)
142
143 def link(index, pending=None):
144 client, cookies, authorization, _ = start(index, pending)
145 target = authorize(client, authorization, index)
146 captured = http.cookiejar.CookieJar()
147 for cookie in cookies:
148 captured.set_cookie(copy.copy(cookie))
149 finish(client, target, pending=pending)
150 replay = urllib.request.build_opener(TLS(), NoRedirect(), urllib.request.HTTPCookieProcessor(captured))
151 finish(replay, target, 410)
152 result = session(index)
153 assert result and result['origin'] == args.shale_origin + '/'
154 assert result['linkedAt'] > 0 and len(result['session']) > 20
155 overview = api(accounts[index][0])['shale']
156 assert overview is not None and set(overview) == {'linkedAt'}, overview
157 assert math.isclose(overview['linkedAt'], result['linkedAt'], rel_tol=0, abs_tol=1e-6), overview
158 assert session_count(index) == 1
159 backend_session(result, 200)
160 return result
161
162 def public(path, method='GET', body=None, status=200, token=None, form=False):
163 headers = {'Host': 'globe.studio.test', 'Content-Type': 'application/x-www-form-urlencoded' if form else 'application/json'}
164 if token:
165 headers.update({'Authorization': 'Bearer ' + token, 'Accept': 'application/json, text/event-stream',
166 'MCP-Protocol-Version': '2025-11-25'})
167 encoded = urllib.parse.urlencode(body).encode() if form else json.dumps(body).encode() if body is not None else None
168 _, headers, body = request(urllib.request.build_opener(NoRedirect()), args.url + path, method, encoded, headers, status)
169 return (json.loads(body) if body and headers.get('Content-Type', '').startswith('application/json') else body or None), headers
170
171 def pending_request(client, index, scope):
172 verifier = uuid.uuid4().hex + uuid.uuid4().hex
173 challenge = base64.urlsafe_b64encode(hashlib.sha256(verifier.encode()).digest()).decode().rstrip('=')
174 _, headers = public('/oauth/authorize?' + urllib.parse.urlencode({'response_type': 'code',
175 'client_id': client['client_id'], 'redirect_uri': client['redirect_uris'][0], 'code_challenge_method': 'S256',
176 'code_challenge': challenge, 'resource': origin + '/mcp/shale', 'scope': scope, 'state': marker}), status=302)
177 pending = urllib.parse.urlsplit(headers['Location']).path.removeprefix('/connect/')
178 details = api(accounts[index][0], path='/api/mcp/consent/' + pending)
179 assert details['client'] == marker
180 api(accounts[1 if index == 0 else 0][0], path='/api/mcp/consent/' + pending, status=403)
181 return pending, verifier, details
182
183 def consent(client, index, repository, scope):
184 pending, verifier, details = pending_request(client, index, scope)
185 available = {r['id'] for r in details['resources']}
186 assert details['linked'] and (repository == 'all' or repository in available), details
187 if index == 0:
188 assert {'alpha', 'beta'} <= available, details
189 path = '/api/mcp/consent/' + pending
190 api(accounts[index][0], 'POST', path, 403, {'resources': ['outside-grant']})
191 api(accounts[index][0], 'POST', path, 403 if len(available) >= 2 else 400, {'resources': [repository, repository]})
192 result = api(accounts[index][0], 'POST', path, body={'resources': 'all' if repository == 'all' else [repository]})
193 query = urllib.parse.parse_qs(urllib.parse.urlsplit(result['redirect']).query)
194 assert query['state'] == [marker]
195 tokens, _ = public('/oauth/token', 'POST', {'grant_type': 'authorization_code', 'client_id': client['client_id'],
196 'redirect_uri': client['redirect_uris'][0], 'code_verifier': verifier, 'code': query['code'][0],
197 'resource': origin + '/mcp/shale'}, form=True)
198 return tokens
199
200 def rpc(token, method, params=None, error=False):
201 value, _ = public('/mcp/shale', 'POST', {'jsonrpc': '2.0', 'id': 1, 'method': method,
202 **({'params': params} if params is not None else {})}, token=token)
203 assert 'error' not in value, value
204 value = value['result']
205 assert bool(value.get('isError')) == error, value
206 return value if error or 'structuredContent' not in value else value['structuredContent']
207
208 def call(token, tool, fields=None, error=False):
209 return rpc(token, 'tools/call', {'name': tool, 'arguments': fields or {}}, error=error)
210
211 def backend(index, suffix, fields=None):
212 headers = {'Cookie': 'SessionID=' + session(index)['session']}
213 if fields is not None:
214 headers.update({'Origin': args.shale_origin, 'Referer': args.shale_origin + suffix,
215 'Content-Type': 'application/x-www-form-urlencoded'})
216 return request(browser()[0], args.shale_origin + suffix, 'POST' if fields is not None else 'GET',
217 urllib.parse.urlencode(fields).encode() if fields is not None else None, headers)
218
219 def submit_backend(index, path, changes):
220 status, _, body = backend(index, path)
221 assert status == 200, (path, status, body[:700])
222 forms = [form for form in Page(body).forms if changes.keys() <= {field.get('name') for field in form['fields']}
223 and ('t' not in changes or any(field.get('name') == 't' and field.get('value') == changes['t'] for field in form['fields']))]
224 assert len(forms) == 1, path
225 form = forms[0]
226 assert urllib.parse.urljoin(args.shale_origin + path, form.get('action', '')) == args.shale_origin + path
227 fields = {field['name']: field.get('value', '') for field in form['fields']
228 if field.get('name') and field.get('type') == 'hidden'}
229 fields.update(timezone='UTC', tzoffset='+00:00', **changes)
230 return backend(index, path, fields)
231
232 def repository(index, name):
233 status, headers, _ = submit_backend(1, '/-/new', {'name': name, 'description': 'Owned Shale MCP fixture', 'access': 'private'})
234 assert status == 303, status
235 target = urllib.parse.urlsplit(urllib.parse.urljoin(args.shale_origin, headers['Location']))
236 assert target.netloc == urllib.parse.urlsplit(args.shale_origin).netloc
237 assert target.path.rstrip('/') == '/' + name, target.path
238 if index == 0:
239 with sqlite3.connect(args.shale_database) as db:
240 identity = db.execute('SELECT id FROM users WHERE snowflake=?', (ids[index],)).fetchone()[0]
241 assert db.execute('UPDATE repositories SET owner=? WHERE name=?', (identity, name)).rowcount == 1
242
243 for name, _ in accounts:
244 assert not keycloak.request('/admin/realms/master/users?username=' + name + '&exact=true'), 'Fixture account already exists: ' + name
245 try:
246 for name, credential in accounts:
247 keycloak.request('/admin/realms/master/users', 'POST', {'username': name, 'firstName': name,
248 'lastName': 'Fixture', 'email': name + '@fixture.invalid', 'emailVerified': True, 'enabled': True,
249 'credentials': [{'type': 'password', 'value': credential, 'temporary': False}]})
250 found = keycloak.request('/admin/realms/master/users?username=' + name + '&exact=true')
251 assert len(found) == 1
252 ids.append(found[0]['id'])
253 with sqlite3.connect(args.data_dir / 'accounts.sqlite') as db:
254 profile = {key: found[0].get(key) for key in ['username', 'firstName', 'lastName', 'email', 'emailVerified', 'enabled']}
255 profile['requiredActions'] = []
256 db.execute('INSERT INTO users(id,profile) VALUES (?,?)', (ids[-1], json.dumps(profile)))
257 stamp = int(time.time())
258 db.execute('INSERT INTO sessions VALUES (?,?,?,?,?,?,?,?)',
259 (hashlib.sha256(sessions[name].encode()).hexdigest(), ids[-1], 'dashboard', stamp + 3600, '127.0.0.1', stamp, stamp, stamp))
260 assert all(api(name)['shale'] is None for name, _ in accounts)
261 api(accounts[0][0], 'POST', '/api/mcp/shale', status=200)
262 old_target = api(accounts[0][0], 'POST', '/api/mcp/shale')['redirect']
263 latest_target = api(accounts[0][0], 'POST', '/api/mcp/shale')['redirect']
264 request(browser()[0], old_target, status=410)
265 with sqlite3.connect(args.data_dir / 'connections.sqlite') as db:
266 db.execute("UPDATE records SET expires=1 WHERE substr(key,1,11)='shale-link:'")
267 request(browser()[0], latest_target, status=410)
268 client, cookies, authorization, _ = start(0)
269 request(client, args.shale_origin + '/-/callback?state=other&code=fixture', status=403)
270 request(browser()[0], args.url + '/oauth/shale/link/' + 'a' * 43, headers={'Host': 'globe.studio.test'}, status=403)
271 client, cookies, authorization, _ = start(0)
272 finish(client, authorize(client, authorization, 1), 403)
273 assert session(0) is None and session(1) is None and session_count(1) == 0
274 oauth_client, _ = public('/oauth/register', 'POST', {'client_name': marker,
275 'redirect_uris': ['http://127.0.0.1:29999/shale-callback'], 'token_endpoint_auth_method': 'none'}, status=201)
276 pending, _, details = pending_request(oauth_client, 0, 'shale:read')
277 assert not details['linked'] and not details['resources']
278 api(accounts[1][0], 'POST', '/api/mcp/shale', 403, {'request': pending})
279 first = link(0, pending)
280 api(accounts[0][0], 'POST', '/api/mcp/consent/' + pending, body={'deny': True})
281 assert api(accounts[1][0])['shale'] is None
282 second = link(1)
283 assert first['session'] != second['session']
284 new_first = link(0)
285 assert new_first['session'] != first['session']
286 backend_session(first, 303)
287 backend_session(second, 200)
288 assert session_count(0) == 1
289 for index, name in [(0, 'alpha'), (0, 'beta'), (1, 'foreign')]:
290 repository(index, name)
291 readonly = consent(oauth_client, 0, 'alpha', 'shale:read offline_access')
292 writing = consent(oauth_client, 0, 'alpha', 'shale:read shale:write offline_access')
293 other = consent(oauth_client, 1, 'foreign', 'shale:read shale:write')
294 read = readonly['access_token']
295 write = writing['access_token']
296 initialized = rpc(read, 'initialize', {'protocolVersion': '2025-11-25', 'capabilities': {},
297 'clientInfo': {'name': marker, 'version': '1'}})
298 assert initialized['capabilities']['tools'] == {}
299 assert 'Assisted-by:' in initialized['instructions'] and 'model' in initialized['instructions']
300 listed = rpc(read, 'tools/list')
301 assert listed["ttlMs"] == 0 and listed["cacheScope"] == "private", listed
302 tools = listed["tools"]
303 assert {tool['name'] for tool in tools} == {'list_repositories', 'list_issues', 'get_issue', 'create_issue',
304 'comment_issue', 'set_issue_status', 'set_issue_title', 'list_labels', 'create_label', 'update_label', 'delete_label', 'set_issue_labels'}
305 assert all('model' in tool['inputSchema']['required'] for tool in tools
306 if not tool['annotations']['readOnlyHint'])
307 create_schema = next(tool['inputSchema'] for tool in tools if tool['name'] == 'create_issue')
308 assert create_schema['properties']['status']['enum'] == ['todo', 'triage']
309 assert all(tool['annotations']['readOnlyHint'] == tool['name'].startswith(('list_', 'get_')) for tool in tools)
310 assert {repo['id'] for repo in call(read, 'list_repositories')['repositories']} == {'alpha'}
311 grant = next(value for value in records('grant:').values() if value['scopes'] == ['shale:read', 'offline_access'] and value['user'] == ids[0])
312 endpoint = '/api/mcp/connections/' + grant['id']
313 details = api(accounts[0][0], path=endpoint)
314 assert details['linked'] and details['selected'] == ['alpha']
315 assert {'alpha', 'beta'} <= {resource['id'] for resource in details['resources']}
316 api(accounts[1][0], path=endpoint, status=404)
317 api(accounts[1][0], 'POST', endpoint, 404, {'resources': ['foreign']})
318 api(accounts[0][0], 'POST', endpoint, 403, {'resources': ['foreign']})
319 api(accounts[0][0], 'POST', endpoint, 403, {'resources': ['alpha', 'alpha']})
320 api(accounts[0][0], 'POST', endpoint, 400, {'resources': []})
321 api(accounts[0][0], 'POST', endpoint, 204, {'resources': ['beta']})
322 assert {repo['id'] for repo in call(read, 'list_repositories')['repositories']} == {'beta'}
323 call(read, 'list_issues', {'repository': 'alpha'}, error=True)
324 call(read, 'create_issue', {'repository': 'beta', 'title': 'REFUSED'}, error=True)
325 api(accounts[0][0], 'POST', endpoint, 204, {'resources': 'all'})
326 assert api(accounts[0][0], path=endpoint)['selected'] == 'all'
327 assert {repo['id'] for repo in call(read, 'list_repositories')['repositories']} == {'alpha', 'beta'}
328 call(read, 'list_issues', {'repository': 'foreign'}, error=True)
329 call(read, 'create_issue', {'repository': 'beta', 'title': 'REFUSED'}, error=True)
330 nested = 'userscripts/nested-fixture'
331 repository(0, nested)
332 assert {repo['id'] for repo in call(read, 'list_repositories')['repositories']} == {'alpha', 'beta', nested}
333 assert not call(read, 'list_issues', {'repository': nested})['issues']
334 api(accounts[0][0], 'POST', endpoint, 204, {'resources': [nested]})
335 assert {repo['id'] for repo in call(read, 'list_repositories')['repositories']} == {nested}
336 call(read, 'list_issues', {'repository': 'beta'}, error=True)
337 api(accounts[0][0], 'POST', endpoint, 204, {'resources': ['alpha']})
338
339 assert {repo['id'] for repo in call(other['access_token'], 'list_repositories')['repositories']} == {'foreign'}
340 all_repositories = consent(oauth_client, 0, 'all', 'shale:read')
341 assert {repo['id'] for repo in call(all_repositories['access_token'], 'list_repositories')['repositories']} == {'alpha', 'beta', nested}
342 assert not call(read, 'list_issues', {'repository': 'alpha'})['issues']
343 for token, name in [(read, 'beta'), (read, 'foreign'), (other['access_token'], 'alpha'),
344 (write, 'alpha/../foreign'), (write, 'https://other.invalid')]:
345 call(token, 'list_issues', {'repository': name}, error=True)
346 call(read, 'create_issue', {'repository': 'alpha', 'title': 'REFUSED'}, error=True)
347 call(write, 'create_issue', {'repository': 'alpha', 'title': 'REFUSED', 'url': 'https://other.invalid'}, error=True)
348 public('/mcp/observability', 'POST', {'jsonrpc': '2.0', 'id': 1, 'method': 'tools/list'}, token=read, status=401)
349 call(write, 'create_issue', {'repository': 'alpha', 'title': 'REFUSED'}, error=True)
350 title = 'MCP <angle> & Unicode ☃'
351 status, _, _ = submit_backend(0, '/alpha/issues/new', {'title': title,
352 'description': 'Owned body <script>fixture</script> & Unicode ☃'})
353 assert status == 303
354 created = call(read, 'get_issue', {'repository': 'alpha', 'id': 1})['issue']
355 assert created['title'] == title and created['id'] == 1
356 assert len(created['comments']) == 1 and 'Unicode ☃' in created['comments'][0]['text']
357 assert '<script>fixture</script>' in created['comments'][0]['text']
358 listed = call(read, 'list_issues', {'repository': 'alpha', 'q': 'is:open'})['issues'][0]
359 assert listed['title'] == title and listed['status'] == created['status']
360 rejected = call(read, 'list_issues', {'repository': 'alpha', 'q': 'Unicode'}, error=True)
361 assert 'filter syntax' in rejected['content'][0]['text'], rejected
362 issue_fields = {'repository': 'alpha', 'id': created['id']}
363 status, _, _ = submit_backend(0, '/alpha/issues/labels', {'name': 'Owned ☃', 'description': 'Fixture label', 'color': '#ff40ff'})
364 assert status == 303
365 status, _, _ = submit_backend(0, '/alpha/issues/1', {'t': 'labels', 'labels': '1'})
366 assert status == 303
367 changed = call(read, 'get_issue', issue_fields)['issue']
368 assert changed['labels'] == ['Owned ☃'], changed
369 with sqlite3.connect(args.shale_database) as db:
370 rows = db.execute('SELECT id FROM users WHERE snowflake=?', (ids[1],)).fetchall()
371 assert len(rows) == 1
372 original_owner = db.execute("SELECT owner FROM repositories WHERE name='alpha'").fetchone()[0]
373 db.execute("UPDATE repositories SET owner=?,access_git_webui='private',access_issues='private' WHERE name='alpha'", (rows[0][0],))
374 try:
375 call(read, 'get_issue', issue_fields, error=True)
376 call(write, 'create_issue', {'repository': 'alpha', 'title': 'REFUSED'}, error=True)
377 finally:
378 with sqlite3.connect(args.shale_database) as db:
379 db.execute("UPDATE repositories SET owner=?,access_git_webui='public',access_issues='public' WHERE name='alpha'", (original_owner,))
380 with sqlite3.connect(args.shale_database) as db:
381 assert db.execute("SELECT count(*) FROM issues WHERE title='REFUSED'").fetchone()[0] == 0
382 subprocess.run(['systemctl', 'restart', args.restart_unit], check=True, capture_output=True, timeout=30)
383 assert session(0) == new_first and session(1) == second
384 assert math.isclose(api(accounts[0][0])['shale']['linkedAt'], new_first['linkedAt'], rel_tol=0, abs_tol=1e-6)
385 backend_session(new_first, 200)
386 assert call(read, 'get_issue', issue_fields)['issue'] == changed
387 backend(0, '/-/logout')
388 call(read, 'get_issue', issue_fields, error=True)
389 new_first = link(0)
390 assert call(read, 'get_issue', issue_fields)['issue'] == changed
391 client, cookies, authorization, _ = start(0)
392 target = authorize(client, authorization, 0)
393 subprocess.run(['podman', 'pause', args.shale_container], check=True, capture_output=True)
394 try:
395 with ThreadPoolExecutor(max_workers=2) as pool:
396 callback = pool.submit(finish, client, target, 410)
397 deadline = time.monotonic() + 10
398 while not any(record.get('phase') == 'processing' for record in records('shale-link:').values()):
399 assert time.monotonic() < deadline, 'callback did not reach backend'
400 time.sleep(.05)
401 unlink = pool.submit(api, accounts[0][0], 'DELETE', '/api/mcp/shale', 204)
402 deadline = time.monotonic() + 10
403 while session(0) is not None or records('shale-link:'):
404 assert time.monotonic() < deadline, 'unlink did not cancel the callback'
405 time.sleep(.05)
406 subprocess.run(['podman', 'unpause', args.shale_container], check=True, capture_output=True)
407 callback.result(timeout=30)
408 unlink.result(timeout=30)
409 finally:
410 subprocess.run(['podman', 'unpause', args.shale_container], capture_output=True)
411 assert session(0) is None and session_count(0) == 0
412 assert api(accounts[0][0])['shale'] is None and session(1) == second
413 backend_session(second, 200)
414 public('/mcp/shale', token=read, status=401)
415 public('/mcp/shale', token=write, status=401)
416 public('/oauth/token', 'POST', {'grant_type': 'refresh_token', 'client_id': oauth_client['client_id'],
417 'refresh_token': readonly['refresh_token'], 'resource': origin + '/mcp/shale'}, form=True, status=400)
418 api(accounts[1][0], 'DELETE', '/api/mcp/shale', 204)
419 assert session(1) is None and session_count(1) == 0
420 backend_session(second, 303)
421 api(accounts[2][0], 'DELETE', '/api/mcp/shale', 204)
422 assert session(2) is None
423 assert not records('shale-link:') and not records('shale-session:')
424 result = {'two_user_oidc_linking': True, 'same_realm_ordinary_users': True, 'host_only_callback_cookie': True,
425 'single_use_state_and_expiry': True, 'account_mismatch_refused_and_session_removed': True,
426 'cross_user_session_isolation': True, 'backend_session_not_exposed_to_browser': True,
427 'relink_revokes_previous_backend_session': True, 'restart_preserves_credentials': True,
428 'unlink_cancels_inflight_callback': True, 'unlink_revokes_backend_session': True,
429 'oauth_link_returns_to_consent': True, 'sdk_catalog_and_repository_grants': True,
430 'cross_repository_and_cross_user_tools_refused': True, 'read_only_and_audience_enforced': True,
431 'native_issue_read': True, 'unicode_and_rendered_text': True,
432 'native_issue_labels_read': True,
433 'backend_permission_changes_enforced': True, 'expired_backend_session_refused': True,
434 'all_repository_approval_and_dynamic_access': True, 'nested_repository_paths': True, 'existing_token_resource_edits': True,
435 'restart_preserves_mcp_access': True, 'unlink_revokes_mcp_access_and_refresh': True}
436 finally:
437 keycloak = Keycloak('keycloak.studio.test', importlib.import_module('dashboard-run').secret('get', 'keycloak', 'password'), attempts=1)
438 cleanup_errors = []
439 for (name, _), identity in zip(accounts, ids):
440 try:
441 api(name, 'DELETE', '/api/mcp/shale', 204)
442 except Exception as error:
443 cleanup_errors.append(error)
444 try:
445 keycloak.request('/admin/realms/master/users/' + identity, 'DELETE')
446 except Exception as error:
447 cleanup_errors.append(error)
448 with sqlite3.connect(args.data_dir / 'accounts.sqlite') as db:
449 db.execute('PRAGMA foreign_keys=ON')
450 for identity in ids:
451 for table in ['sessions', 'credentials', 'memberships']:
452 db.execute(f'DELETE FROM {table} WHERE user_id=?', (identity,))
453 db.execute('DELETE FROM users WHERE id=?', (identity,))
454 if cleanup_errors:
455 raise cleanup_errors[0]
456 result['owned_users_and_credentials_removed'] = True
457 if args.output:
458 args.output.write_text(json.dumps(result, indent=2) + '\n')
459 print(json.dumps(result), flush=True)
460
461
462if __name__ == '__main__':
463 main()
tools/dashboard-shale-page-test.py+14-14
...@@ -61,7 +61,7 @@ def main():...@@ -61,7 +61,7 @@ def main():
61 return self.respond(b' ' * (9 * 1024 * 1024), 'text/html')61 return self.respond(b' ' * (9 * 1024 * 1024), 'text/html')
62 if self.path == '/-/login':62 if self.path == '/-/login':
63 callback = 'https://' + self.headers['Host'] + '/-/callback'63 callback = 'https://' + self.headers['Host'] + '/-/callback'
64 return self.respond(b'', 'text/plain', 302, [('Location', 'https://snowglobe.studio.test/auth/oidc/authorize?redirect_uri=' + urllib.parse.quote(callback, safe=''))])64 return self.respond(b'', 'text/plain', 302, [('Location', 'https://snowglobe.snowglobe.test/auth/oidc/authorize?redirect_uri=' + urllib.parse.quote(callback, safe=''))])
65 if self.path == '/redirect':65 if self.path == '/redirect':
66 return self.respond(b'', 'text/plain', 302, [('Location', '/snowbound/issues/26'), ('Set-Cookie', 'SessionID=new; Path=/; HttpOnly'), ('Set-Cookie', 'other=kept; Path=/')])66 return self.respond(b'', 'text/plain', 302, [('Location', '/snowbound/issues/26'), ('Set-Cookie', 'SessionID=new; Path=/; HttpOnly'), ('Set-Cookie', 'other=kept; Path=/')])
67 if self.path.startswith('/-/') and args.page:67 if self.path.startswith('/-/') and args.page:
...@@ -108,8 +108,8 @@ def main():...@@ -108,8 +108,8 @@ def main():
108 subprocess.run(['openssl', 'req', '-x509', '-newkey', 'rsa:2048', '-nodes', '-days', '1', '-subj', '/CN=localhost', '-addext', 'subjectAltName=DNS:localhost', '-addext', 'basicConstraints=CA:FALSE', '-keyout', str(gateway_key), '-out', str(certificate)], check=True, capture_output=True)108 subprocess.run(['openssl', 'req', '-x509', '-newkey', 'rsa:2048', '-nodes', '-days', '1', '-subj', '/CN=localhost', '-addext', 'subjectAltName=DNS:localhost', '-addext', 'basicConstraints=CA:FALSE', '-keyout', str(gateway_key), '-out', str(certificate)], check=True, capture_output=True)
109 data = root / 'data'109 data = root / 'data'
110 data.mkdir()110 data.mkdir()
111 environment = {**os.environ, 'PORT': str(dashboard_port), 'STUDIO_DOMAIN': 'studio.test', 'STUDIO_DATA_DIR': str(data), 'STUDIO_PROXY_TOKEN_FILE': str(token), 'STUDIO_INTERNAL_URL': f'https://localhost:{internal_port}', 'STUDIO_CA_BUNDLE': str(certificate), 'STUDIO_REPO': str(repo), 'STUDIO_WEB_DIR': str(repo / 'dashboard/dist')}111 environment = {**os.environ, 'PORT': str(dashboard_port), 'SNOWGLOBE_DOMAIN': 'snowglobe.test', 'SNOWGLOBE_DATA_DIR': str(data), 'SNOWGLOBE_PROXY_TOKEN_FILE': str(token), 'SNOWGLOBE_INTERNAL_URL': f'https://localhost:{internal_port}', 'SNOWGLOBE_CA_BUNDLE': str(certificate), 'SNOWGLOBE_REPO': str(repo), 'SNOWGLOBE_WEB_DIR': str(repo / 'dashboard/dist')}
112 for key in ['STUDIO_INDEX_POOL', 'STUDIO_AUTH_REQUIRED', 'STUDIO_YT_STATE']:112 for key in ['SNOWGLOBE_INDEX_POOL', 'SNOWGLOBE_AUTH_REQUIRED', 'SNOWGLOBE_YT_STATE']:
113 environment.pop(key, None)113 environment.pop(key, None)
114 log = stack.enter_context((root / 'dashboard.log').open('w'))114 log = stack.enter_context((root / 'dashboard.log').open('w'))
115 dashboard = subprocess.Popen([str(args.binary)], env=environment, stdout=log, stderr=log)115 dashboard = subprocess.Popen([str(args.binary)], env=environment, stdout=log, stderr=log)
...@@ -130,17 +130,17 @@ def main():...@@ -130,17 +130,17 @@ def main():
130 profile = {'kind': 'guest', 'enabled': True, 'username': username, 'guestProvider': provider, 'firstName': name}130 profile = {'kind': 'guest', 'enabled': True, 'username': username, 'guestProvider': provider, 'firstName': name}
131 db.execute('INSERT INTO users(id,profile) VALUES (?,?)', [username, json.dumps(profile)])131 db.execute('INSERT INTO users(id,profile) VALUES (?,?)', [username, json.dumps(profile)])
132 db.execute('INSERT INTO external_identities VALUES (?,?,?)', [provider, subject, username])132 db.execute('INSERT INTO external_identities VALUES (?,?,?)', [provider, subject, username])
133 os.environ.update(STUDIO_DOMAIN='studio.test', STUDIO_DASHBOARD_PORT=str(dashboard_port), STUDIO_PROXY_TOKEN_FILE=str(token), STUDIO_INTERNAL_PORT=str(internal_port))133 os.environ.update(SNOWGLOBE_DOMAIN='snowglobe.test', SNOWGLOBE_DASHBOARD_PORT=str(dashboard_port), SNOWGLOBE_PROXY_TOKEN_FILE=str(token), SNOWGLOBE_INTERNAL_PORT=str(internal_port))
134 router.ROUTE_DIR = str(root / 'routes')134 router.ROUTE_DIR = str(root / 'routes')
135 Path(router.ROUTE_DIR).mkdir()135 Path(router.ROUTE_DIR).mkdir()
136 (Path(router.ROUTE_DIR) / 'shale.json').write_text(json.dumps({'headHtml': {'shale.studio.test': {'/snowbound/*': '<meta name="rewrite-test" content="kept">'}}}))136 (Path(router.ROUTE_DIR) / 'shale.json').write_text(json.dumps({'headHtml': {'shale.snowglobe.test': {'/snowbound/*': '<meta name="rewrite-test" content="kept">'}}}))
137137
138 def nomad(path, token):138 def nomad(path, token):
139 if path == '/v1/services':139 if path == '/v1/services':
140 return [{'Namespace': 'default', 'Services': [{'ServiceName': 'shale'}, {'ServiceName': 'shale-preview-12345678'}]}]140 return [{'Namespace': 'default', 'Services': [{'ServiceName': 'shale'}, {'ServiceName': 'shale-preview-12345678'}]}]
141 if path.startswith('/v1/service/'):141 if path.startswith('/v1/service/'):
142 service = path.rsplit('/', 1)[1]142 service = path.rsplit('/', 1)[1]
143 host = 'shale.studio.test' if service == 'shale' else service + '.studio.test'143 host = 'shale.snowglobe.test' if service == 'shale' else service + '.snowglobe.test'
144 return [{'Address': '127.0.0.1', 'Port': fixture.server_port, 'ServiceName': service, 'AllocID': service, 'JobID': service, 'Tags': ['caddy-host=' + host]}]144 return [{'Address': '127.0.0.1', 'Port': fixture.server_port, 'ServiceName': service, 'AllocID': service, 'JobID': service, 'Tags': ['caddy-host=' + host]}]
145 return {'ready': {'Status': 'success'}}145 return {'ready': {'Status': 'success'}}
146146
...@@ -156,8 +156,8 @@ def main():...@@ -156,8 +156,8 @@ def main():
156 return rendered[start:end].replace(host + ' {', f'http://127.0.0.1:{listener} {{', 1).replace(' tls internal\n', '').replace(' route {\n', f' route {{\n request_header Host {host}\n', 1)156 return rendered[start:end].replace(host + ' {', f'http://127.0.0.1:{listener} {{', 1).replace(' tls internal\n', '').replace(' route {\n', f' route {{\n request_header Host {host}\n', 1)
157157
158 preview_port = port()158 preview_port = port()
159 config = '{\n admin off\n auto_https off\n}\n' + local_site('shale.studio.test', gateway_port) + '\n' + local_site('shale-preview-12345678.studio.test', preview_port)159 config = '{\n admin off\n auto_https off\n}\n' + local_site('shale.snowglobe.test', gateway_port) + '\n' + local_site('shale-preview-12345678.snowglobe.test', preview_port)
160 internal_host = f'dashboard.internal.studio.test:{internal_port}'160 internal_host = f'dashboard.internal.snowglobe.test:{internal_port}'
161 start = rendered.index(internal_host + ' {')161 start = rendered.index(internal_host + ' {')
162 config += '\n' + rendered[start:].replace(internal_host + ' {', f'https://localhost:{internal_port} {{', 1).replace(' tls internal\n', f' tls {certificate} {gateway_key}\n', 1)162 config += '\n' + rendered[start:].replace(internal_host + ' {', f'https://localhost:{internal_port} {{', 1).replace(' tls internal\n', f' tls {certificate} {gateway_key}\n', 1)
163 config_path = root / 'Caddyfile'163 config_path = root / 'Caddyfile'
...@@ -170,7 +170,7 @@ def main():...@@ -170,7 +170,7 @@ def main():
170 origin = f'http://127.0.0.1:{gateway_port}'170 origin = f'http://127.0.0.1:{gateway_port}'
171171
172 def request(path, *, headers=None, body=None, direct=False):172 def request(path, *, headers=None, body=None, direct=False):
173 supplied = {'Cookie': 'SessionID=preserved', 'Origin': 'https://shale.studio.test', **(headers or {})}173 supplied = {'Cookie': 'SessionID=preserved', 'Origin': 'https://shale.snowglobe.test', **(headers or {})}
174 url = (f'http://127.0.0.1:{dashboard_port}' if direct else origin) + path174 url = (f'http://127.0.0.1:{dashboard_port}' if direct else origin) + path
175 try:175 try:
176 response = opener.open(urllib.request.Request(url, headers=supplied, data=body), timeout=15)176 response = opener.open(urllib.request.Request(url, headers=supplied, data=body), timeout=15)
...@@ -199,25 +199,25 @@ def main():...@@ -199,25 +199,25 @@ def main():
199 assert b'rewrite-test' in body199 assert b'rewrite-test' in body
200 assert headers['Cache-Control'] == 'no-store' and headers.get('ETag') is None and headers.get('Last-Modified') is None200 assert headers['Cache-Control'] == 'no-store' and headers.get('ETag') is None and headers.get('Last-Modified') is None
201 assert observations[-1][1] == '/snowbound/issues/26?query=kept', observations[-1]201 assert observations[-1][1] == '/snowbound/issues/26?query=kept', observations[-1]
202 assert observations[-1][2]['host'] == 'shale.studio.test', observations[-1]202 assert observations[-1][2]['host'] == 'shale.snowglobe.test', observations[-1]
203 assert observations[-1][2]['cookie'] == 'SessionID=preserved', observations[-1]203 assert observations[-1][2]['cookie'] == 'SessionID=preserved', observations[-1]
204 status, headers, body = request('/json', headers={'Accept': 'application/json'})204 status, headers, body = request('/json', headers={'Accept': 'application/json'})
205 assert status == 200 and headers['Content-Type'].startswith('application/json')205 assert status == 200 and headers['Content-Type'].startswith('application/json')
206 assert body == b'{"issue":{"title":"<angle> & Unicode"}}'206 assert body == b'{"issue":{"title":"<angle> & Unicode"}}'
207 assert observations[-1][2]['accept'] == 'application/json'207 assert observations[-1][2]['accept'] == 'application/json'
208 assert not any(key.lower().startswith('studio-') for key in observations[-1][2]), observations[-1]208 assert not any(key.lower().startswith('snowglobe-') for key in observations[-1][2]), observations[-1]
209 status, headers, body = request('/~guest-github-24465214')209 status, headers, body = request('/~guest-github-24465214')
210 assert status == 302 and headers['Location'] == 'https://github.com/paperclover' and headers['Referrer-Policy'] == 'no-referrer' 210 assert status == 302 and headers['Location'] == 'https://github.com/paperclover' and headers['Referrer-Policy'] == 'no-referrer'
211 assert request('/~guest-astheno-abc/')[0] == 200211 assert request('/~guest-astheno-abc/')[0] == 200
212 assert observations[-1][1] == '/~guest-astheno-abc/'212 assert observations[-1][1] == '/~guest-astheno-abc/'
213 assert request('/~guest-astheno-unknown')[0] == 200213 assert request('/~guest-astheno-unknown')[0] == 200
214 status, headers, body = request('/-/login')214 status, headers, body = request('/-/login')
215 assert status == 302 and urllib.parse.parse_qs(urllib.parse.urlparse(headers['Location']).query)['redirect_uri'] == ['https://shale.studio.test/-/callback']215 assert status == 302 and urllib.parse.parse_qs(urllib.parse.urlparse(headers['Location']).query)['redirect_uri'] == ['https://shale.snowglobe.test/-/callback']
216 status, headers, body = request('/redirect')216 status, headers, body = request('/redirect')
217 assert status == 302 and headers['Location'] == '/snowbound/issues/26' and len(headers.get_all('Set-Cookie')) == 2217 assert status == 302 and headers['Location'] == '/snowbound/issues/26' and len(headers.get_all('Set-Cookie')) == 2
218 with opener.open(f'http://127.0.0.1:{preview_port}/snowbound/issues/26') as response:218 with opener.open(f'http://127.0.0.1:{preview_port}/snowbound/issues/26') as response:
219 assert response.status == 200219 assert response.status == 200
220 assert observations[-1][2]['host'] == 'shale-preview-12345678.studio.test'220 assert observations[-1][2]['host'] == 'shale-preview-12345678.snowglobe.test'
221 assert any(link.get('href') == 'https://github.com/paperclover' for link in Links(response.read().decode()).links)221 assert any(link.get('href') == 'https://github.com/paperclover' for link in Links(response.read().decode()).links)
222 assert b'/~guest-github-24465214' in request('/repo/info/refs')[2]222 assert b'/~guest-github-24465214' in request('/repo/info/refs')[2]
223 assert request('/binary')[2] == blob223 assert request('/binary')[2] == blob
...@@ -226,7 +226,7 @@ def main():...@@ -226,7 +226,7 @@ def main():
226 assert status == 201 and body == b'field=unchanged' and observations[-1][1] == '/submit?keep=yes'226 assert status == 201 and body == b'field=unchanged' and observations[-1][1] == '/submit?keep=yes'
227 assert request('/submit', body=b'blocked', headers={'Origin': 'https://other.example'})[0] == 403227 assert request('/submit', body=b'blocked', headers={'Origin': 'https://other.example'})[0] == 403
228 assert request('/auth/shale/page', direct=True)[0] == 403228 assert request('/auth/shale/page', direct=True)[0] == 403
229 assert request('/auth/shale/page', direct=True, headers={'Studio-Proxy-Token': proof, 'Studio-Shale-Upstream': f'127.0.0.1:{fixture.server_port}', 'Studio-Shale-Uri': '/', 'Host': 'snowglobe.studio.test'})[0] == 403229 assert request('/auth/shale/page', direct=True, headers={'Snowglobe-Proxy-Token': proof, 'Snowglobe-Shale-Upstream': f'127.0.0.1:{fixture.server_port}', 'Snowglobe-Shale-Uri': '/', 'Host': 'snowglobe.snowglobe.test'})[0] == 403
230 print(json.dumps({'html_links': 'passed', 'provider_redirects': 'passed', 'cookies_forms_and_binary': 'passed', 'proxy_boundary': 'passed', 'head_injection': 'passed', 'origin': origin}), flush=True)230 print(json.dumps({'html_links': 'passed', 'provider_redirects': 'passed', 'cookies_forms_and_binary': 'passed', 'proxy_boundary': 'passed', 'head_injection': 'passed', 'origin': origin}), flush=True)
231 if args.browser_ready_file:231 if args.browser_ready_file:
232 args.browser_ready_file.write_text(json.dumps({'origin': origin}))232 args.browser_ready_file.write_text(json.dumps({'origin': origin}))
tools/dashboard-shale-test.py deleted-468
...@@ -1,468 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import base64
4from contextlib import closing, contextmanager
5import copy
6from html.parser import HTMLParser
7import http.client
8import http.cookiejar
9import http.server
10import importlib
11import json
12import os
13from pathlib import Path
14import re
15import sqlite3
16import ssl
17import socket
18import subprocess
19import sys
20import tempfile
21import threading
22import time
23import urllib.error
24import urllib.parse
25import urllib.request
26import uuid
27
28
29class Page(HTMLParser):
30 def __init__(self, text):
31 super().__init__()
32 self.forms = []
33 self.links = []
34 self.codes = []
35 self.form = None
36 self.code = None
37 self.select = None
38 self.feed(text)
39
40 def handle_starttag(self, tag, attrs):
41 attrs = dict(attrs)
42 if tag == "form":
43 self.form = {**attrs, "fields": []}
44 self.forms.append(self.form)
45 if tag in {"input", "select", "textarea", "button"} and self.form is not None:
46 self.form["fields"].append(attrs)
47 if tag == "select":
48 self.select = attrs
49 attrs["options"] = []
50 if tag == "option" and self.select is not None:
51 self.select["options"].append(attrs)
52 if tag == "a":
53 self.links.append(attrs.get("href", ""))
54 if tag in {"code", "pre", "textarea"}:
55 self.code = ""
56
57 def handle_data(self, data):
58 if self.code is not None:
59 self.code += data
60
61 def handle_endtag(self, tag):
62 if tag == "select":
63 self.select = None
64 if tag == "form":
65 self.form = None
66 if tag in {"code", "pre", "textarea"} and self.code is not None:
67 self.codes.append(self.code)
68 self.code = None
69
70
71@contextmanager
72def instance(keycloak, marker, image, traces_endpoint, traces_env, *, host="localhost", dashboard_port=None):
73 container = "studio-shale-backend-test-" + marker
74 client_name = "shale-fixture-" + marker
75 client_secret = uuid.uuid4().hex + uuid.uuid4().hex
76 client_id = None
77 caddy = None
78 proxy = None
79
80 def run(*argv):
81 try:
82 return subprocess.check_output(argv, text=True, stderr=subprocess.PIPE).strip()
83 except subprocess.CalledProcessError as error:
84 raise AssertionError(f"{argv[0]} failed ({error.returncode})") from None
85
86 with tempfile.TemporaryDirectory(prefix="studio-shale-backend-", dir="/run") as temporary:
87 root = Path(temporary)
88 with socket.socket() as reservation:
89 reservation.bind(("127.0.0.1", 0))
90 backend_port = reservation.getsockname()[1]
91 with socket.socket() as reservation:
92 for port in range(20000, 32001):
93 try:
94 reservation.bind(("127.0.0.1", port))
95 break
96 except OSError:
97 continue
98 else:
99 raise AssertionError("no fixture HTTPS port available")
100 origin = "https://" + host + ":" + str(port)
101 try:
102 keycloak.request("/admin/realms/master/clients", "POST", {
103 "clientId": client_name, "protocol": "openid-connect", "publicClient": False,
104 "standardFlowEnabled": True, "secret": client_secret,
105 "redirectUris": [origin + "/-/callback"], "webOrigins": [origin],
106 })
107 clients = keycloak.request("/admin/realms/master/clients?clientId=" + client_name)
108 assert len(clients) == 1
109 client_id = clients[0]["id"]
110 authority = Path("/var/lib/caddy/.local/share/caddy/pki/authorities/local")
111 run("openssl", "req", "-new", "-newkey", "rsa:2048", "-nodes", "-keyout", str(root / "key.pem"),
112 "-out", str(root / "request.pem"), "-subj", "/CN=" + host,
113 "-addext", "subjectAltName=DNS:" + host + ",IP:127.0.0.1")
114 run("openssl", "x509", "-req", "-in", str(root / "request.pem"), "-CA", str(authority / "root.crt"),
115 "-CAkey", str(authority / "root.key"), "-set_serial", "0x" + marker,
116 "-out", str(root / "cert.pem"), "-days", "1", "-copy_extensions", "copyall")
117 config = root / "Caddyfile"
118 bridge = importlib.import_module("router").shale_mcp_routes(dashboard_port) if dashboard_port else []
119 upstream_port = backend_port
120 if dashboard_port:
121 drop = root / "drop-next-write"
122
123 class Proxy(http.server.BaseHTTPRequestHandler):
124 def log_message(self, *args):
125 pass
126
127 def do_GET(self):
128 with closing(http.client.HTTPConnection("127.0.0.1", backend_port, timeout=20)) as upstream:
129 upstream.request(self.command, self.path,
130 self.rfile.read(int(self.headers.get("Content-Length", 0))), dict(self.headers))
131 response = upstream.getresponse()
132 body = response.read()
133 if self.command == "POST" and drop.exists() and drop.read_text() == self.path:
134 drop.unlink()
135 self.close_connection = True
136 self.connection.shutdown(socket.SHUT_RDWR)
137 return
138 self.send_response(response.status)
139 for name, value in response.getheaders():
140 if name.lower() not in {"connection", "transfer-encoding", "content-length"}:
141 self.send_header(name, value)
142 self.send_header("Content-Length", str(len(body)))
143 self.end_headers()
144 self.wfile.write(body)
145
146 do_POST = do_GET
147
148 proxy = http.server.ThreadingHTTPServer(("127.0.0.1", 0), Proxy)
149 proxy_thread = threading.Thread(target=proxy.serve_forever, daemon=True)
150 proxy_thread.start()
151 upstream_port = proxy.server_port
152 config.write_text("{\n admin off\n auto_https disable_redirects\n skip_install_trust\n}\n" + origin +
153 " {\n tls " + str(root / "cert.pem") + " " + str(root / "key.pem") +
154 "\n" + "\n".join(bridge) + "\n handle {\n reverse_proxy 127.0.0.1:" + str(upstream_port) + "\n }\n}\n")
155 binary = (Path("/proc") / run("systemctl", "show", "-P", "MainPID", "caddy") / "exe").resolve(strict=True)
156 with (root / "caddy.log").open("w") as output:
157 caddy = subprocess.Popen([str(binary), "run", "--config", str(config), "--adapter", "caddyfile"],
158 stdout=output, stderr=output,
159 env={**os.environ, "XDG_DATA_HOME": temporary, "XDG_CONFIG_HOME": temporary})
160 volumes = []
161 for directory, target in [("data", "/data"), ("owned", "/repositories_owned"), ("mirrors", "/repositories_mirrors"), ("cron", "/etc/crontabs")]:
162 path = root / directory
163 path.mkdir()
164 os.chown(path, 65534, 65534)
165 volumes.append("--volume=" + str(path) + ":" + target + ":rw")
166 run("podman", "run", "-d", "--name=" + container, "--pull=never", "--user=65534:65534",
167 "--read-only", "--cap-drop=all", "--security-opt=no-new-privileges", "--memory=512m", "--cpus=2", "--pids-limit=128",
168 "--tmpfs=/tmp:rw,noexec,nosuid,nodev,size=64m", "--publish=127.0.0.1:" + str(backend_port) + ":8000",
169 "--add-host=keycloak.studio.test:host-gateway", "--volume=/var/lib/studio/ca-bundle.crt:/etc/ssl/certs/ca-certificates.crt:ro",
170 "--env=DOMAIN=" + host + ":" + str(port), "--env=SERVER_TITLE=MCP fixture",
171 "--env=SESSION_SECRET=" + uuid.uuid4().hex + uuid.uuid4().hex,
172 "--env=OAUTH2_CLIENT=oidc,keycloak.studio.test/realms/master|" + client_name + "|" + client_secret,
173 "--env=NPROC=2", "--env=MIRRORS_DISABLE_CLONE=true", "--env=MIRRORS_DISABLE_PULL_POLL=true",
174 *(["--env=OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=" + traces_endpoint] if traces_env else []),
175 *volumes, image, *(["--otel-exporter-otlp-traces-endpoint", traces_endpoint] if traces_endpoint and not traces_env else []))
176 deployed = json.loads(run("podman", "inspect", container))[0]
177 assert deployed["ImageName"] == image
178 assert deployed["Config"]["User"] == "65534:65534"
179 context = ssl.create_default_context(cafile="/var/lib/studio/ca-bundle.crt")
180 from api import LoopbackHTTPS
181
182 class HTTPS(urllib.request.HTTPSHandler):
183 def https_open(self, request):
184 assert urllib.parse.urlsplit(request.full_url).netloc == urllib.parse.urlsplit(origin).netloc
185 return self.do_open(LoopbackHTTPS, request, context=context)
186
187 readiness = urllib.request.build_opener(HTTPS())
188 deadline = time.monotonic() + 15
189 while True:
190 try:
191 with readiness.open(origin, timeout=2) as response:
192 assert response.status == 200
193 break
194 except OSError:
195 if time.monotonic() >= deadline:
196 raise AssertionError((root / "caddy.log").read_text())
197 time.sleep(.1)
198 yield origin, root / "data/astheno.shale.db", container
199 except Exception:
200 if subprocess.run(["podman", "container", "exists", container], capture_output=True).returncode == 0:
201 state = json.loads(run("podman", "inspect", container))[0]["State"]
202 print(json.dumps({"fixture_backend_running": state["Running"], "fixture_backend_exit_code": state["ExitCode"],
203 "fixture_backend_oom_killed": state["OOMKilled"]}), flush=True)
204 raise
205 finally:
206 try:
207 subprocess.run(["podman", "rm", "--ignore", "--force", container], check=True, capture_output=True)
208 finally:
209 try:
210 if caddy:
211 caddy.terminate()
212 try:
213 caddy.wait(timeout=10)
214 except subprocess.TimeoutExpired:
215 caddy.kill()
216 caddy.wait(timeout=10)
217 finally:
218 if proxy:
219 proxy.shutdown()
220 proxy.server_close()
221 proxy_thread.join(timeout=5)
222 from api import Keycloak
223 keycloak = Keycloak(keycloak.host, importlib.import_module("dashboard-run").secret("get", "keycloak", "password"), attempts=1)
224 if client_id is None:
225 clients = keycloak.request("/admin/realms/master/clients?clientId=" + client_name)
226 assert len(clients) <= 1
227 client_id = clients[0]["id"] if clients else None
228 if client_id:
229 keycloak.request("/admin/realms/master/clients/" + client_id, "DELETE")
230
231
232
233def main():
234 parser = argparse.ArgumentParser()
235 parser.add_argument("--output", type=Path)
236 parser.add_argument("--image")
237 parser.add_argument("--traces-endpoint")
238 parser.add_argument("--traces-env", action="store_true")
239 args = parser.parse_args()
240 if args.output:
241 args.output.unlink(missing_ok=True)
242 assert not args.traces_env or args.traces_endpoint
243 if args.traces_endpoint:
244 endpoint = urllib.parse.urlsplit(args.traces_endpoint)
245 assert endpoint.scheme in {"http", "https"} and endpoint.hostname
246 assert not endpoint.username and not endpoint.password
247 repo = Path(__file__).resolve().parent.parent
248 image = args.image or re.search(r'^\s*image = "([^"]+)"', (repo / "service/shale/service.pkl").read_text(), re.MULTILINE).group(1)
249 sys.path.insert(0, str(repo / "tools"))
250 sys.path.insert(0, str(repo / "service/keycloak"))
251 from api import Keycloak, LoopbackHTTPS
252 keycloak_host = "keycloak.studio.test"
253 shale_host = "localhost"
254 context = ssl.create_default_context(cafile="/var/lib/studio/ca-bundle.crt")
255
256 class HTTPS(urllib.request.HTTPSHandler, urllib.request.HTTPHandler):
257 def http_open(self, request):
258 raise AssertionError("unencrypted fixture redirect")
259
260 def https_open(self, request):
261 parts = urllib.parse.urlsplit(request.full_url)
262 assert parts.netloc in {keycloak_host, urllib.parse.urlsplit(shale).netloc}
263 return self.do_open(LoopbackHTTPS, request, context=context)
264
265 class NoRedirect(urllib.request.HTTPRedirectHandler):
266 def redirect_request(self, req, fp, code, msg, headers, newurl):
267 return None
268
269 key = uuid.uuid4().hex
270 name = "mcp-fixture-" + key
271 password = uuid.uuid4().hex + "A1!"
272 keycloak = Keycloak(keycloak_host, importlib.import_module("dashboard-run").secret("get", "keycloak", "password"))
273 cookies = http.cookiejar.CookieJar()
274 opener = urllib.request.build_opener(HTTPS(), urllib.request.HTTPCookieProcessor(cookies))
275
276 def request(url, fields=None, headers=None, client=opener):
277 headers = dict(headers or {})
278 data = None
279 if fields is not None:
280 parts = urllib.parse.urlsplit(url)
281 headers.update(Origin=parts.scheme + "://" + parts.netloc, Referer=parts._replace(fragment="").geturl())
282 data = urllib.parse.urlencode(fields).encode()
283 req = urllib.request.Request(url, headers=headers, data=data)
284 try:
285 response = client.open(req, timeout=15)
286 except urllib.error.HTTPError as error:
287 response = error
288 with response:
289 return response.status, response.url, response.headers, response.read().decode()
290
291 def submit(url, form, changes, client=opener):
292 target = urllib.parse.urljoin(url, form.get("action", ""))
293 assert urllib.parse.urlsplit(target).netloc == urllib.parse.urlsplit(shale).netloc
294 fields = {a["name"]: a.get("value", "") for a in form["fields"] if a.get("name") and a.get("type") == "hidden"}
295 fields.update(timezone="UTC", tzoffset="+00:00", **changes)
296 return request(target, fields, client=client)
297
298 accounts = [(name, password), ("mcp-stranger-" + key, uuid.uuid4().hex + "A1!")]
299 try:
300 for username, credential in accounts:
301 keycloak.request("/admin/realms/master/users", "POST", {
302 "username": username, "firstName": username, "lastName": "Fixture", "email": username + "@fixture.invalid",
303 "emailVerified": True, "enabled": True,
304 "credentials": [{"type": "password", "value": credential, "temporary": False}],
305 })
306 users = keycloak.request("/admin/realms/master/users?username=" + username + "&exact=true")
307 assert len(users) == 1
308 with instance(keycloak, key, image, args.traces_endpoint, args.traces_env) as (shale, database, container):
309 def login(client, username, credential):
310 status, url, _, body = request(shale + "/-/login", client=client)
311 assert status == 200, status
312 form = next(f for f in Page(body).forms if any(a.get("name") == "password" for a in f["fields"]))
313 fields = {a["name"]: a.get("value", "") for a in form["fields"] if a.get("name")}
314 fields.update(username=username, password=credential)
315 status, url, _, _ = request(urllib.parse.urljoin(url, form["action"]), fields, client=client)
316 assert status == 200 and urllib.parse.urlsplit(url).hostname == shale_host
317
318 login(opener, *accounts[0])
319 stranger = urllib.request.build_opener(HTTPS(), urllib.request.HTTPCookieProcessor(http.cookiejar.CookieJar()))
320 login(stranger, *accounts[1])
321 status, url, _, body = request(shale + "/-/settings")
322 assert status == 200, status
323 form = next(f for f in Page(body).forms if any(a.get("name") == "label" for a in f["fields"]))
324 assert form.get("enctype", "application/x-www-form-urlencoded") == "application/x-www-form-urlencoded"
325 status, _, _, body = submit(url, form, {"label": name})
326 if status != 200:
327 state = json.loads(subprocess.check_output(["podman", "inspect", container], text=True))[0]["State"]
328 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
329 count = db.execute("SELECT count(*) FROM personal_tokens").fetchone()[0]
330 result = {"oidc_fixture_user": True, "mint_status": status,
331 "backend_exit_code": state["ExitCode"], "token_rows_after_response": count}
332 print(json.dumps(result), flush=True)
333 if args.output:
334 args.output.write_text(json.dumps(result, indent=2) + "\n")
335 raise AssertionError("token mint failed; write outcome recorded without replay")
336 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
337 users = db.execute("SELECT id FROM users WHERE name=?", (name,)).fetchall()
338 assert len(users) == 1
339 identity = users[0][0]
340 tokens = db.execute("SELECT uuid FROM personal_tokens WHERE agent=? AND label=?", (identity, name)).fetchall()
341 assert len(tokens) == 1
342 token_id = tokens[0][0]
343 page = Page(body)
344 tokens = {text.strip() for text in [*page.codes, *[a.get("value", "") for f in page.forms for a in f["fields"]]]
345 if re.fullmatch(r"[A-Za-z0-9_:.=+-]{24,}", text.strip())}
346 assert len(tokens) == 1
347 token = next(iter(tokens))
348 anonymous = urllib.request.build_opener(HTTPS(), NoRedirect())
349 for authorization in ["Bearer " + token, "token " + token,
350 "Basic " + base64.b64encode((name + ":" + token).encode()).decode()]:
351 status, _, _, body = request(shale + "/-/settings", headers={"Authorization": authorization}, client=anonymous)
352 assert status == 303 and name not in body
353 status, url, _, body = request(shale + "/-/new")
354 assert status == 200
355 form = next(f for f in Page(body).forms if any(a.get("name") == "name" for a in f["fields"]))
356 status, url, _, body = submit(url, form, {"name": "fixture", "description": "Disposable MCP adapter test", "access": "private"})
357 assert status == 200, status
358 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
359 assert db.execute("SELECT count(*) FROM repositories WHERE name='fixture' AND owner=?", (identity,)).fetchone()[0] == 1
360 repository_url = url
361 for client in (anonymous, stranger):
362 status, _, _, _ = request(repository_url, client=client)
363 assert status in (403, 404), status
364 issues = next(link for link in Page(body).links if "issues" in link)
365 status, url, _, body = request(urllib.parse.urljoin(repository_url, issues))
366 assert status == 200
367 new_issue = next(link for link in Page(body).links if link == "./new")
368 status, url, _, body = request(urllib.parse.urljoin(url, new_issue))
369 assert status == 200
370 title = "Fixture <angle> & Unicode ☃"
371 description = "Disposable body <script>fixture</script> & Unicode ☃"
372 form = next(f for f in Page(body).forms if any(a.get("name") == "title" for a in f["fields"]))
373 status, url, _, body = submit(url, form, {"title": title, "description": description})
374 assert status == 200, status
375 issue_url = url
376 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
377 issues = db.execute("SELECT id,title FROM issues").fetchall()
378 assert len(issues) == 1 and issues[0][1] == title
379 assert db.execute("SELECT payload FROM issue_actions WHERE issue=?", (issues[0][0],)).fetchone()[0] == description
380 status, _, _, _ = request(issue_url, client=anonymous)
381 assert status in (403, 404), status
382 status, _, _, body = request(issue_url)
383 assert status == 200
384 page = Page(body)
385 comment = "Fixture comment <angle> & Unicode ☃"
386 form = next(f for f in page.forms if any(a.get("name") == "t" and a.get("value") == "comment" for a in f["fields"]))
387 status, _, _, body = submit(issue_url, form, {"comment": comment})
388 assert status == 200, status
389 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
390 assert db.execute("SELECT count(*) FROM issue_actions WHERE payload=?", (comment,)).fetchone()[0] == 1
391 form = next(f for f in Page(body).forms if any(a.get("name") == "t" and a.get("value") == "status" for a in f["fields"]))
392 status_field = next(a for a in form["fields"] if a.get("name") == "status")
393 assert any(option["value"] == "done" for option in status_field["options"])
394 status, _, _, body = submit(issue_url, form, {"status": "done"})
395 assert status == 200
396 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
397 assert db.execute("SELECT status FROM issues").fetchone()[0] == "done"
398 status, _, _, stranger_settings = request(shale + "/-/settings", client=stranger)
399 assert status == 200
400 stranger_csrf = {a["name"]: a["value"] for f in Page(stranger_settings).forms for a in f["fields"] if a.get("name") == "csrf_token"}
401 for client, csrf in [(anonymous, {}), (stranger, stranger_csrf)]:
402 status, _, _, _ = request(issue_url, {"t": "comment", "comment": "UNAUTHORIZED",
403 "timezone": "UTC", "tzoffset": "+00:00", **csrf}, client=client)
404 assert status in ((400, 403, 404) if client is anonymous else (403, 404)), status
405 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
406 assert db.execute("SELECT count(*) FROM issue_actions WHERE payload='UNAUTHORIZED'").fetchone()[0] == 0
407 subprocess.run(["podman", "restart", container], check=True, capture_output=True)
408 deadline = time.monotonic() + 15
409 while True:
410 status, _, _, body = request(issue_url)
411 if status == 200:
412 break
413 assert time.monotonic() < deadline, status
414 time.sleep(.1)
415 assert "Unicode ☃" in body
416 for client in (anonymous, stranger):
417 status, _, _, _ = request(issue_url, client=client)
418 assert status in (403, 404), status
419 status, url, _, body = request(shale + "/-/settings")
420 form = next(f for f in Page(body).forms if any(a.get("name") == "label" for a in f["fields"]))
421 status, _, _, body = submit(url, form, {"label": "second"})
422 assert status == 200, status
423 form = next(f for f in Page(body).forms if any(a.get("name") == "t" and a.get("value") == "token_revoke" for a in f["fields"]))
424 status, _, _, _ = submit(url, form, {})
425 assert status == 200
426 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
427 assert db.execute("SELECT count(*) FROM personal_tokens WHERE agent=?", (identity,)).fetchone()[0] == 1
428 assert db.execute("SELECT count(*) FROM personal_tokens WHERE uuid=?", (token_id,)).fetchone()[0] == 0
429 captured = http.cookiejar.CookieJar()
430 for cookie in cookies:
431 if cookie.domain.startswith("localhost"):
432 captured.set_cookie(copy.copy(cookie))
433 assert len(captured) > 0
434 replay = urllib.request.build_opener(HTTPS(), NoRedirect(), urllib.request.HTTPCookieProcessor(captured))
435 status, _, _, _ = request(issue_url, client=replay)
436 assert status == 200
437 status, _, _, _ = request(shale + "/-/logout")
438 assert status == 200
439 status, _, _, _ = request(issue_url)
440 assert status in (403, 404), status
441 replay_status, _, _, _ = request(issue_url, client=replay)
442 assert replay_status in (200, 303, 403, 404), replay_status
443 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
444 session_rows = db.execute("SELECT count(*) FROM sessions WHERE user=?", (identity,)).fetchone()[0]
445 result = {"backend_image": image,
446 "backend_image_id": json.loads(subprocess.check_output(["podman", "inspect", container], text=True))[0]["Image"],
447 "traces_endpoint": args.traces_endpoint, "traces_environment_variable": args.traces_env,
448 "logout_cookie_replay_status": replay_status,
449 "backend_session_rows_after_logout": session_rows,
450 "checks": ["two_user_oidc", "personal_token_mint", "pat_not_html_auth", "private_repository_create",
451 "anonymous_read_denied", "other_user_read_denied", "issue_create_unicode", "comment_create_unicode",
452 "issue_close", "anonymous_write_denied", "other_user_write_denied", "session_survives_restart",
453 "second_token_mint", "token_revoke", "logout_denies_private_read",
454 "cross_user_denied_after_restart", "captured_session_valid_before_logout", "logout_cookie_replay_probe"]}
455 finally:
456 for username, _ in accounts:
457 users = keycloak.request("/admin/realms/master/users?username=" + username + "&exact=true")
458 for user in users:
459 assert user["username"] == username
460 keycloak.request("/admin/realms/master/users/" + user["id"], "DELETE")
461 result["checks"].append("fixture_cleanup")
462 print(json.dumps(result), flush=True)
463 if args.output:
464 args.output.write_text(json.dumps(result, indent=2) + "\n")
465
466
467if __name__ == "__main__":
468 main()
tools/dashboard-stage-test.py created+113
...@@ -0,0 +1,113 @@
1#!/usr/bin/env python3
2from importlib import import_module
3import json
4import os
5from pathlib import Path
6import struct
7import subprocess
8import tempfile
9import unittest
10from unittest.mock import Mock, patch
11
12
13stage = import_module("dashboard-stage")
14boundary = import_module("dashboard-host")
15
16
17class PreviewBoundary(unittest.TestCase):
18 def call(self, request):
19 payload = json.dumps(request).encode() + b"\n"
20 connection = Mock()
21 connection.__enter__ = Mock(return_value=connection)
22 connection.__exit__ = Mock(return_value=False)
23 connection.getsockopt.return_value = struct.pack("3i", 1, os.getuid(), 1)
24 connection.recv.side_effect = [payload, payload]
25 host = Mock()
26 host.handle.return_value = {"observed": True}
27 with patch.object(boundary.socket, "SO_PEERCRED", 17, create=True), patch.object(boundary, "stream_console") as stream, patch.object(boundary, "stream_upload") as upload:
28 boundary.serve_connection(connection, host, os.getuid(), stage.OPERATIONS)
29 stream.assert_not_called()
30 upload.assert_not_called()
31 sent = b"".join(call.args[0] for call in connection.sendall.call_args_list)
32 return json.loads(sent[4:]), host
33
34 def test_denies_host_mutations_and_vm_streams_before_dispatch(self):
35 for operation in ["vm.create", "vm.start", "vm.console", "vm.serial", "vm.guest", "vm.upload", "storage.destroy", "deploy.start", "deploy.secret.get", "shale.write", "copyparty.manage", []]:
36 with self.subTest(operation=operation):
37 response, host = self.call({"operation": operation})
38 self.assertEqual(response["status"], 403)
39 host.handle.assert_not_called()
40
41 def test_read_uses_the_real_host_handler(self):
42 for operation in ["host.sample", "vm.node", "vm.domains", "vm.library"]:
43 with self.subTest(operation=operation):
44 request = {"operation": operation}
45 response, host = self.call(request)
46 self.assertEqual(response, {"value": {"observed": True}})
47 host.handle.assert_called_once_with(request)
48
49 def test_stage_identity_rejects_paths_and_production(self):
50 for identity in ["dashboard", "knife-preview-12345678", "dashboard-preview-../private", "dashboard-preview-12345678\n"]:
51 with self.assertRaisesRegex(ValueError, "invalid dashboard stage"):
52 stage.metadata(identity)
53
54 def test_file_operations_cannot_name_production_or_account_dataset(self):
55 dataset = "globe/staging/dashboard-preview-12345678"
56 host = stage.PreviewHost({"clone": dataset})
57 for operation in ["files.snapshot", "files.snapshots", "files.discard"]:
58 for target in ["globe/prod/knife", dataset, dataset + "/files/child", dataset + "/files/../data"]:
59 request = {"operation": operation, "dataset": target} if operation == "files.discard" else {"operation": operation, "datasets": [target]}
60 with self.subTest(request=request), patch.object(boundary.Host, "handle") as handler:
61 with self.assertRaises(boundary.dashboard_runs.Error) as error:
62 host.handle(request)
63 self.assertEqual(error.exception.status, 403)
64 handler.assert_not_called()
65 with patch.object(boundary.Host, "handle", return_value="real snapshot") as handler:
66 request = {"operation": "files.snapshot", "datasets": [dataset + "/files"]}
67 self.assertEqual(host.handle(request), "real snapshot")
68 handler.assert_called_once_with(request)
69
70 def test_failed_child_creation_and_repeated_token_revoke_still_clean_parent(self):
71 identity = "dashboard-preview-12345678"
72 dataset = "globe/staging/" + identity
73 saved = {"clone": dataset, "mount": "/srv/staging/" + identity, "tokenAccessor": "already-revoked",
74 "external": {"files": {"clone": dataset + "/files"}}}
75 missing_token = subprocess.CompletedProcess([], 1, stderr="Error deleting token: Unexpected response code: 400 (Cannot delete nonexistent tokens: already-revoked)")
76 okay = subprocess.CompletedProcess([], 0, stderr="")
77 def process(argv, **kwargs):
78 return missing_token if argv[:4] == ["nomad", "acl", "token", "delete"] else okay
79 with patch.object(stage, "metadata", return_value=saved), patch.object(stage.snowglobe, "token"), patch.object(stage.subprocess, "run", side_effect=process), patch.object(stage.snowglobe, "command", return_value=subprocess.CompletedProcess([], 0, stdout=dataset + "\n")) as commands, patch.object(stage.snowglobe, "destroy_stage") as destroy, patch.object(stage.shutil, "rmtree"):
80 stage.destroy(identity)
81 self.assertEqual(saved["external"], {})
82 self.assertEqual(saved["clone"], dataset)
83 destroy.assert_called_once_with(identity, saved, {})
84 self.assertFalse(any(call.args[:2] == ("zfs", "destroy") for call in commands.call_args_list))
85
86
87class NativePreview(unittest.TestCase):
88 def test_empty_proof_requires_loopback_and_fresh_account_stays_private(self):
89 binary = Path(os.environ.get("DASHBOARD_BINARY", "dashboard/target/debug/home-dashboard")).resolve()
90 if not binary.exists():
91 self.skipTest("build home-dashboard to exercise its native auth CLI")
92 with tempfile.TemporaryDirectory() as temporary:
93 env = {**os.environ, "SNOWGLOBE_LISTEN_ADDRESS": "0.0.0.0", "SNOWGLOBE_PROXY_TOKEN_FILE": "", "SNOWGLOBE_DATA_DIR": temporary,
94 "SNOWGLOBE_DOMAIN": "preview.test", "SNOWGLOBE_PUBLIC_ORIGIN": "https://dashboard.preview.test", "SNOWGLOBE_FILE_ORIGIN": "https://files.preview.test",
95 "SNOWGLOBE_AUTH_RP_ID": "dashboard.preview.test"}
96 rejected = subprocess.run([str(binary), "--preview-account"], env=env, capture_output=True, text=True)
97 self.assertNotEqual(rejected.returncode, 0)
98 self.assertIn("before listening on a non-loopback address", rejected.stderr)
99 self.assertFalse(Path(temporary, "accounts.sqlite").exists())
100 env["SNOWGLOBE_LISTEN_ADDRESS"] = "127.0.0.1"
101 created = subprocess.run([str(binary), "--preview-account"], env=env, capture_output=True, text=True, check=True)
102 credentials = json.loads(created.stdout)
103 self.assertEqual(credentials["username"], "preview")
104 self.assertGreaterEqual(len(credentials["password"]), 32)
105 self.assertEqual(Path(temporary, "accounts.sqlite").stat().st_mode & 0o777, 0o600)
106 again = subprocess.run([str(binary), "--preview-account"], env=env, capture_output=True, text=True)
107 self.assertNotEqual(again.returncode, 0)
108 self.assertIn("empty store", again.stderr)
109 self.assertNotIn(credentials["password"], again.stdout + again.stderr)
110
111
112if __name__ == "__main__":
113 unittest.main()
tools/dashboard-stage.py created+214
...@@ -0,0 +1,214 @@
1#!/usr/bin/env python3
2import concurrent.futures
3from importlib import import_module
4import json
5import os
6from pathlib import Path
7import re
8import secrets
9import shlex
10import shutil
11import socket
12import subprocess
13import sys
14import threading
15import time
16
17import snowglobe
18
19
20OPERATIONS = frozenset({
21 "host.sample", "host.usage", "storage.mounts", "storage.datasets", "storage.pool",
22 "storage.snapshots", "vm.node", "vm.domains", "vm.library", "deploy.current", "deploy.main", "deploy.history",
23 "deploy.stages", "deploy.managed", "deploy.release", "deploy.last",
24 "files.snapshot", "files.snapshots", "files.discard",
25})
26STAGE_ID = re.compile(r"dashboard-preview-[0-9a-f]{8}\Z")
27boundary = import_module("dashboard-host")
28
29
30class PreviewHost(boundary.Host):
31 def __init__(self, saved):
32 super().__init__(saved["clone"].split("/", 1)[0])
33 self.stage = saved
34
35 def handle(self, request):
36 operation = request.get("operation") if isinstance(request, dict) else None
37 if operation in {"files.snapshot", "files.snapshots", "files.discard"}:
38 datasets = request.get("datasets") if operation != "files.discard" else [request.get("dataset")]
39 if not isinstance(datasets, list) or datasets != [self.stage["clone"] + "/files"]:
40 raise boundary.dashboard_runs.Error(403, "File changes are limited to this preview's files.")
41 if operation == "storage.mounts" and set(request) == {"operation"}:
42 mounted = json.loads(snowglobe.command(
43 "findmnt", "--json", "-o", "SOURCE,TARGET,FSTYPE,OPTIONS", "--mountpoint", self.stage["mount"] + "/files", capture=True,
44 ).stdout)
45 mounted["filesystems"][0]["target"] = "/srv"
46 return mounted
47 return super().handle(request)
48
49
50def metadata(stage):
51 if not STAGE_ID.fullmatch(stage):
52 raise ValueError("invalid dashboard stage ID")
53 saved = json.loads((snowglobe.STATE / "stages" / f"{stage}.json").read_text())
54 if saved.get("sourceId") != "dashboard":
55 raise ValueError("not a dashboard stage")
56 return saved
57
58
59def serve(stage):
60 saved = metadata(stage)
61 host = PreviewHost(saved)
62 runtime = Path("/run/snowglobe-preview") / stage
63 runtime.mkdir(parents=True, exist_ok=True)
64 os.chown(runtime, 0, saved["uid"])
65 runtime.chmod(0o750)
66 path = runtime / "host.sock"
67 path.unlink(missing_ok=True)
68 with socket.socket(socket.AF_UNIX, socket.SOCK_STREAM) as listener:
69 listener.bind(str(path))
70 os.chown(path, 0, saved["uid"])
71 path.chmod(0o660)
72 listener.listen(8)
73 slots = threading.BoundedSemaphore(8)
74 with concurrent.futures.ThreadPoolExecutor(max_workers=4) as workers:
75 while True:
76 connection, _ = listener.accept()
77 if not slots.acquire(blocking=False):
78 connection.close()
79 continue
80 work = workers.submit(boundary.serve_connection, connection, host, saved["uid"], OPERATIONS)
81 work.add_done_callback(lambda _: slots.release())
82
83
84def stage():
85 snowglobe.token()
86 site = json.loads(snowglobe.command("pkl", "eval", "-f", "json", str(snowglobe.REPO / "config/site.pkl"), capture=True).stdout)
87 site["hostRoot"] = str(Path(site["root"]) / "prod/dashboard")
88 site["stagingRoot"] = str(Path(site["root"]) / "staging")
89 snowglobe.check_staging_pool(site)
90 directory = snowglobe.STATE / "stages"
91 previous = [path for path in directory.glob("*.json") if json.loads(path.read_text()).get("sourceId") == "dashboard"]
92 if len(previous) > 1:
93 raise ValueError("multiple dashboard stages exist; destroy one first")
94 created = not previous
95 identity = "dashboard-preview-" + secrets.token_hex(4) if created else previous[0].stem
96 hostname = identity + "." + site["domain"]
97 root = Path(site["stagingRoot"]) / identity
98 saved = {"sourceId": "dashboard", "tasks": ["app"], "inputs": {}, "mount": str(root),
99 "clone": site["pool"] + "/staging/" + identity, "uid": snowglobe.identity("dashboard"),
100 "stageIsolation": "fresh"} if created else metadata(identity)
101 nix = ["nix", "--extra-experimental-features", "nix-command flakes"]
102 package = "path:" + str(snowglobe.REPO) + "#dashboard-image"
103 image = subprocess.run([*nix, "eval", "--raw", package, "--apply", 'image: "${image.imageName}:${image.imageTag}"'],
104 stdout=subprocess.PIPE, text=True, check=True).stdout.strip()
105 if subprocess.run(["podman", "image", "exists", image], capture_output=True).returncode:
106 built = subprocess.run([*nix, "build", package, "--no-link", "--print-out-paths"],
107 stdout=subprocess.PIPE, text=True, check=True).stdout.strip()
108 snowglobe.command("podman", "load", "--quiet", "--input", built)
109 env = {
110 "SNOWGLOBE_DOMAIN": site["domain"], "SNOWGLOBE_PUBLIC_ORIGIN": "https://" + hostname,
111 "SNOWGLOBE_FILE_ORIGIN": "https://files-" + hostname, "SNOWGLOBE_AUTH_RP_ID": hostname,
112 "SNOWGLOBE_AUTH_REQUIRED": "1", "SNOWGLOBE_PROXY_TOKEN_FILE": "", "SNOWGLOBE_DATA_DIR": "/data",
113 "SNOWGLOBE_PREVIEW": "1", "SNOWGLOBE_METRICS": "follow",
114 "SNOWGLOBE_LISTEN_ADDRESS": "127.0.0.1", "PORT": "${NOMAD_PORT_http}",
115 "SNOWGLOBE_NOMAD_TOKEN_FILE": "/run/secrets/nomad.token", "NOMAD_ADDR": "http://127.0.0.1:4646",
116 "SNOWGLOBE_HOST_SOCKET": "/run/snowglobe-host/host.sock", "SNOWGLOBE_NODE_NAME": site["nodeName"],
117 "SNOWGLOBE_STORE_ROOT": "/srv", "SNOWGLOBE_MEDIA_ROOT": "/srv/Media",
118 "SNOWGLOBE_FILES_WRITABLE": "1", "SNOWGLOBE_CLOVER_READ_ONLY": "false", "SNOWGLOBE_MEDIA_READ_ONLY": "false",
119 "HOME": "/data", "XDG_CACHE_HOME": "/data/cache",
120 }
121 try:
122 if created:
123 snowglobe.command("zfs", "create", "-o", "mountpoint=" + str(root), saved["clone"])
124 saved["external"] = {"files": {"clone": saved["clone"] + "/files"}}
125 directory.mkdir(parents=True, exist_ok=True)
126 snowglobe.write_private(directory / f"{identity}.json", json.dumps(saved))
127 snowglobe.command("zfs", "create", "-o", "mountpoint=" + str(root / "files"), saved["clone"] + "/files")
128 for path in (root / "data", root / "files", root / "files/Media"):
129 path.mkdir(parents=True, exist_ok=True)
130 os.chown(path, saved["uid"], saved["uid"])
131 path.chmod(0o750)
132 fixture = root / "files/preview.txt"
133 fixture.write_text("Disposable Snow Globe dashboard preview.\n")
134 fixture.chmod(0o644)
135 directory.mkdir(parents=True, exist_ok=True)
136 saved.update(release=snowglobe.REPO.name, ready=False)
137 snowglobe.write_private(directory / f"{identity}.json", json.dumps(saved))
138 if created:
139 policy = 'namespace "default" { capabilities = ["list-jobs", "read-job"] }\nnode { policy = "read" }\n'
140 snowglobe.command("nomad", "acl", "policy", "apply", identity, "-", input=policy)
141 token = json.loads(snowglobe.command("nomad", "acl", "token", "create", "-policy=" + identity,
142 "-name=" + identity, "-json", capture=True).stdout)
143 saved["tokenAccessor"] = token["AccessorID"]
144 snowglobe.write_private(directory / f"{identity}.json", json.dumps(saved))
145 snowglobe.write_private(root / "nomad.token", token["SecretID"] + "\n")
146 os.chown(root / "nomad.token", saved["uid"], saved["uid"])
147 imported = snowglobe.command("podman", "run", "--rm", "--network=none", "--read-only",
148 "--user=" + str(saved["uid"]), "--cap-drop=ALL", "--security-opt=no-new-privileges",
149 "--entrypoint=/bin/home-dashboard",
150 "--volume=" + str(root / "data") + ":/data:rw",
151 *["--env=" + key + "=" + value for key, value in env.items()], image, "--preview-account", capture=True)
152 snowglobe.write_private(root / "access.json", imported.stdout)
153 runtime = "/run/snowglobe-preview/" + identity
154 host_environment = snowglobe.transition.host_environment()
155 host_path = next(value for value in shlex.split(host_environment) if value.startswith("PATH="))
156 snowglobe.transition.stop_preview(identity)
157 snowglobe.command("systemd-run", "--collect", "--quiet", "--unit=snowglobe-preview-" + identity,
158 "--property=Restart=on-failure", "--property=MemoryMax=256M", "--property=TasksMax=32",
159 "--setenv=" + host_path,
160 sys.executable, str(Path(__file__).resolve()), "--serve", identity)
161 for _ in range(100):
162 if Path(runtime, "host.sock").exists():
163 break
164 time.sleep(.1)
165 else:
166 raise RuntimeError("dashboard preview host socket did not start")
167 job = {"ID": identity, "Name": identity, "Type": "service", "Datacenters": ["clover"],
168 "Meta": {"snowglobe_service": "dashboard", "snowglobe_name": "Snow Globe preview", "snowglobe_hostname": hostname},
169 "TaskGroups": [{"Name": "app", "Count": 1, "Networks": [{"Mode": "host", "DynamicPorts": [{"Label": "http", "HostNetwork": "loopback"}]}],
170 "Services": [{"Name": identity, "Provider": "nomad", "PortLabel": "http", "TaskName": "app", "Tags": ["caddy-host=" + hostname],
171 "Checks": [{"Name": "Dashboard sign-in", "Type": "http", "Path": "/sign-in", "Interval": 10000000000, "Timeout": 5000000000}]}],
172 "Tasks": [{"Name": "app", "Driver": "podman", "User": str(saved["uid"]) + ":" + str(saved["uid"]), "Env": env,
173 "Config": {"image": image, "network_mode": "host", "cap_drop": ["ALL"], "security_opt": ["no-new-privileges"],
174 "volumes": [str(root / "data") + ":/data:rw", str(root / "files") + ":/srv:rw,rslave", runtime + ":/run/snowglobe-host:ro",
175 str(root / "nomad.token") + ":/run/secrets/nomad.token:ro"]},
176 "Resources": {"CPU": 1000, "MemoryMB": 2048}}]}]}
177 snowglobe.command("nomad", "job", "run", "-json", "-", input=json.dumps(job))
178 snowglobe.check_http(hostname, "/sign-in", site["tlsInternal"])
179 saved["ready"] = True
180 snowglobe.write_private(directory / f"{identity}.json", json.dumps(saved))
181 except BaseException:
182 if created and (directory / f"{identity}.json").exists():
183 destroy(identity)
184 raise
185 print(f"stage={identity}\nrelease={saved['release']}\nhost={hostname}\ndataset={saved['clone']}\naccess={root / 'access.json'}")
186
187
188def destroy(identity):
189 snowglobe.token()
190 saved = metadata(identity)
191 snowglobe.transition.stop_preview(identity)
192 if saved.get("tokenAccessor"):
193 revoked = subprocess.run(["nomad", "acl", "token", "delete", saved["tokenAccessor"]], capture_output=True, text=True)
194 if revoked.returncode and "400 (Cannot delete nonexistent tokens:" not in revoked.stderr:
195 raise RuntimeError(revoked.stderr.strip())
196 snowglobe.command("nomad", "acl", "policy", "delete", identity, capture=True)
197 datasets = set(snowglobe.command("zfs", "list", "-H", "-o", "name", capture=True).stdout.splitlines())
198 saved["external"] = {name: item for name, item in saved.get("external", {}).items() if item["clone"] in datasets}
199 if saved.get("external", {}).get("files", {}).get("clone") == saved["clone"] + "/files":
200 snapshots = snowglobe.command("zfs", "list", "-H", "-t", "snapshot", "-r", "-o", "name", saved["clone"] + "/files", capture=True).stdout.splitlines()
201 for snapshot in snapshots:
202 if snapshot.startswith(saved["clone"] + "/files@"):
203 snowglobe.command("zfs", "destroy", snapshot)
204 if saved["clone"] not in datasets:
205 del saved["clone"]
206 snowglobe.destroy_stage(identity, saved, {})
207 shutil.rmtree(Path("/run/snowglobe-preview") / identity, ignore_errors=True)
208
209
210if __name__ == "__main__":
211 if len(sys.argv) == 3 and sys.argv[1] == "--serve":
212 serve(sys.argv[2])
213 else:
214 raise SystemExit("Expected --serve STAGE")
tools/dashboard-unit-test.py deleted-303
...@@ -1,303 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3from contextlib import ExitStack
4import importlib
5import json
6import os
7from pathlib import Path
8import pwd
9import re
10import shutil
11import socket
12import subprocess
13import sys
14import tempfile
15import time
16import urllib.request
17import uuid
18
19import router
20
21
22def main():
23 parser = argparse.ArgumentParser()
24 parser.add_argument("--output", type=Path)
25 parser.add_argument("--browser-ready-file", type=Path)
26 parser.add_argument("--browser-timeout", type=int, default=180)
27 parser.add_argument("--relay-agent-dir", type=Path)
28 args = parser.parse_args()
29 assert 1 <= args.browser_timeout <= 600
30 repo = Path(__file__).resolve().parent.parent
31 nix = ["nix", "--extra-experimental-features", "nix-command flakes"]
32 base = "path:" + str(repo) + "#nixosConfigurations.vm.config"
33
34 def shell(*argv, timeout=60):
35 result = subprocess.run(argv, capture_output=True, text=True, timeout=timeout)
36 if result.returncode:
37 raise AssertionError(result.stderr)
38 return result.stdout
39
40 units = {name: shell(*nix, "eval", base + '.systemd.units."' + name + '.service".text',
41 "--offline", "--raw", "--option", "eval-cache", "false")
42 for name in ["studio-dashboard", "studio-host"]}
43 permissions = [rule for rule in json.loads(shell(*nix, "eval", base + ".systemd.tmpfiles.rules",
44 "--offline", "--json", "--option", "eval-cache", "false"))
45 if rule.startswith("A+ /srv/prod/ytdl/data ")]
46 assert len(permissions) == 1, permissions
47 scripts = re.findall(r"^Exec(?:Start|StartPre|StartPost)=(/nix/store/\S+)$", units["studio-dashboard"], re.M)
48 assert len(scripts) == 3, scripts
49 shell(*nix, "build", *[base + '.systemd.units."' + name + '.service".unit'
50 for name in units], "--offline", "--no-link", timeout=1200)
51 try:
52 account = pwd.getpwnam("studio-dashboard")
53 except KeyError:
54 shell("useradd", "--system", "--user-group", "--no-create-home", "studio-dashboard")
55 account = pwd.getpwnam("studio-dashboard")
56 assert account.pw_uid != 0 and account.pw_gid != 0
57 app_unit = "studio-dashboard-unit-test"
58 host_unit = "studio-host-unit-test"
59 container = "studio-dashboard-unit-test"
60 unit_files = [Path("/run/systemd/system/" + name + ".service") for name in [app_unit, host_unit]]
61 assert not any(file.exists() for file in unit_files), unit_files
62 assert not json.loads(shell("podman", "ps", "--all", "--filter=name=^" + container + "$", "--format=json"))
63 proof = uuid.uuid4().hex + uuid.uuid4().hex
64
65 with tempfile.TemporaryDirectory(prefix="studio-dashboard-unit-", dir="/run") as temporary, ExitStack() as fixtures:
66 root = Path(temporary)
67 library = root / "clover"
68 season = library / "Media/jellyfin/Indie Shows/Fixture/Season 1"
69 config = library / "Documents/Config/Youtube Downloader"
70 config.mkdir(parents=True)
71 season.mkdir(parents=True)
72 (config / "feed.yaml").write_text("shows: []\n")
73 (season / "S01E01 - Fixture.mp4").write_bytes(b"fixture")
74 (season / "S01E01 - Fixture.nfo").write_text("<episodedetails><title>Unit fixture</title></episodedetails>")
75 for directory in [library, *[p for p in library.rglob("*") if p.is_dir()]]:
76 os.chown(directory, 3000, 3000)
77 directory.chmod(0o2770)
78 data = root / "data"
79 data.mkdir(mode=0o700)
80 (data / "existing.json").write_text('{"fixture":true}\n')
81 state = root / "yt-state"
82 (state / "nested").mkdir(parents=True)
83 (state / "existing.json").write_text('{"fixture":true}\n')
84 for path in [state, *state.rglob("*")]:
85 os.chown(path, 3118, 3118)
86 path.chmod(0o750 if path.is_dir() else 0o640)
87 token = root / "proxy.token"
88 token.write_text(proof)
89 readonly = root / "nomad.token"
90 readonly.write_bytes(Path("/var/lib/studio/dashboard.token").read_bytes())
91 ca = root / "ca.crt"
92 ca.write_bytes(Path("/var/lib/studio/ca-bundle.crt").read_bytes())
93 ca.chmod(0o444)
94 acl = root / "permissions.conf"
95 acl.write_text(permissions[0].replace("/srv/prod/ytdl/data", str(state)) + "\n")
96 with socket.socket() as reservation:
97 reservation.bind(("127.0.0.1", 0))
98 port = reservation.getsockname()[1]
99 sys.path.insert(0, str(repo / "service/keycloak"))
100 from api import Keycloak
101 keycloak = Keycloak("keycloak.studio.test", importlib.import_module("dashboard-run").secret("get", "keycloak", "password"), attempts=1)
102 shale_image = re.search(r'^\s*image = "([^"]+)"', (repo / "service/shale/service.pkl").read_text(), re.M).group(1)
103 shale_origin, shale_database, shale_container = fixtures.enter_context(importlib.import_module("dashboard-shale-test").instance(
104 keycloak, uuid.uuid4().hex, shale_image, None, False, host="shale.studio.test", dashboard_port=port))
105 with socket.socket() as reservation:
106 for gateway_port in range(20000, 32001):
107 try:
108 reservation.bind(("0.0.0.0", gateway_port))
109 break
110 except OSError:
111 continue
112 else:
113 raise AssertionError("no fixture gateway port available")
114 os.environ.update(STUDIO_DOMAIN="studio.test", STUDIO_INTERNAL_PORT=str(gateway_port),
115 STUDIO_DASHBOARD_PORT=str(port), STUDIO_PROXY_TOKEN_FILE=str(token))
116 rendered = router.render(Path(router.TOKEN).read_text().strip())
117 gateway = rendered[rendered.index(f"dashboard.internal.studio.test:{gateway_port} {{"):]
118 gateway_config = root / "Caddyfile"
119 gateway_config.write_text("{\n admin off\n auto_https disable_redirects\n skip_install_trust\n}\n" + gateway +
120 f"\nglobe.studio.test:{gateway_port} {{\n tls internal\n reverse_proxy 127.0.0.1:{port} {{\n header_up Host globe.studio.test\n }}\n}}\n")
121 gateway_config.chmod(0o600)
122 caddy_binary = (Path("/proc") / shell("systemctl", "show", "-P", "MainPID", "caddy").strip() / "exe").resolve(strict=True)
123 caddy = None
124 replacements = {
125 "https://dashboard.internal.studio.test:8448": f"https://dashboard.internal.studio.test:{gateway_port}",
126 "--name=studio-dashboard ": "--name=" + container + " ",
127 "--volume=/run/studio-host:/run/studio-host:ro": "--volume=/run/" + host_unit + ":/run/studio-host:ro",
128 "/var/lib/studio/dashboard-proxy.token": str(token),
129 "/var/lib/studio/dashboard.token": str(readonly),
130 "/var/lib/studio/ca-bundle.crt": str(ca),
131 "/var/lib/studio/dashboard": str(data),
132 "/srv/prod/ytdl/data": str(state),
133 "/srv/clover": str(library),
134 "--prefix=" + str(state): "--prefix=" + str(state) + " " + str(acl),
135 "--publish=127.0.0.1:7072:7072": f"--publish=127.0.0.1:{port}:7072",
136 "http://127.0.0.1:7072/": f"http://127.0.0.1:{port}/",
137 }
138 text = units["studio-dashboard"]
139 for source in scripts:
140 content = Path(source).read_text()
141 # Only host mount sources move; container paths retain the generated unit's contract.
142 for original, replacement in replacements.items():
143 if original in ["/srv/prod/ytdl/data", "/srv/clover"]:
144 content = content.replace("test -d " + original, "test -d " + replacement)
145 content = content.replace("test -d '" + original, "test -d '" + replacement)
146 content = content.replace("src=" + original, "src=" + replacement)
147 content = content.replace("--volume=" + original + ":", "--volume=" + replacement + ":")
148 content = content.replace("--prefix=" + original, "--prefix=" + replacement)
149 else:
150 content = content.replace(original, replacement)
151 destination = root / Path(source).name
152 destination.write_text(content)
153 destination.chmod(0o700)
154 text = text.replace(source, str(destination))
155 text = text.replace("https://dashboard.internal.studio.test:8448", f"https://dashboard.internal.studio.test:{gateway_port}")
156 text = text.replace('Environment="STUDIO_SHALE_URL=https://shale.studio.test"', 'Environment="STUDIO_SHALE_URL=' + shale_origin + '"')
157 text = re.sub(r'^Environment="STUDIO_INDEX_POOL=.*"\n', "", text, flags=re.M)
158 text = text.replace("studio-host.service", host_unit + ".service").replace("studio-router.service", "")
159 text = text.replace("--time=8 studio-dashboard", "--time=8 " + container).replace("--force studio-dashboard", "--force " + container)
160 for original in ["/var/lib/studio/dashboard.token", "/var/lib/studio/ca-bundle.crt"]:
161 text = text.replace("ConditionPathExists=" + original, "ConditionPathExists=" + replacements[original])
162 unit_files[0].write_text(text)
163 host_text = units["studio-host"].replace("RuntimeDirectory=studio-host", "RuntimeDirectory=" + host_unit).replace("StateDirectory=studio/host", "StateDirectory=studio/host-unit-test")
164 host_text = host_text.replace("[Service]\n", "[Service]\n" + f'Environment="STUDIO_HOST_SOCKET=/run/{host_unit}/host.sock"\nEnvironment="STUDIO_HOST_STATE_ROOT=/var/lib/studio/host-unit-test"\n')
165 unit_files[1].write_text(host_text)
166 try:
167 with (root / "caddy.log").open("w") as log:
168 caddy = subprocess.Popen([str(caddy_binary), "run", "--config", str(gateway_config), "--adapter", "caddyfile"],
169 stdout=log, stderr=log, env={**os.environ, "XDG_DATA_HOME": str(root), "XDG_CONFIG_HOME": str(root)})
170 gateway_ca = root / "caddy/pki/authorities/local/root.crt"
171 deadline = time.monotonic() + 15
172 while not gateway_ca.exists():
173 if caddy.poll() is not None or time.monotonic() > deadline:
174 raise AssertionError("fixture gateway did not start")
175 time.sleep(.1)
176 with ca.open("ab") as bundle:
177 bundle.write(gateway_ca.read_bytes())
178 shell("systemctl", "daemon-reload")
179 shell("systemctl", "start", app_unit, timeout=180)
180 info = json.loads(shell("podman", "inspect", container))[0]
181 assert info["Config"]["User"] == f"{account.pw_uid}:{account.pw_gid}", info["Config"]["User"]
182 host = info["HostConfig"]
183 assert host["ReadonlyRootfs"] and not host["Privileged"] and not host["Devices"]
184 assert host["NetworkMode"] != "host" and host["PidsLimit"] == 256
185 assert host["Memory"] == 2 * 1024 ** 3 and host["NanoCpus"] == 4 * 10 ** 9
186 assert "no-new-privileges" in host["SecurityOpt"]
187 mounts = {mount["Destination"]: mount for mount in info["Mounts"]}
188 sources = {"/data": data, "/run/studio-host": Path("/run/" + host_unit),
189 "/run/secrets/dashboard-proxy.token": token, "/run/secrets/dashboard-nomad.token": readonly,
190 "/run/secrets/ca-bundle.crt": ca, "/srv/clover": library,
191 "/srv/clover/Media": library / "Media", "/srv/prod/ytdl/data": state}
192 assert mounts.keys() == sources.keys(), mounts.keys()
193 for target, source in sources.items():
194 assert mounts[target]["Source"] == str(source), mounts[target]
195 assert mounts[target]["RW"] == (target in ["/data", "/srv/clover", "/srv/prod/ytdl/data"]), mounts[target]
196 for namespace in ["net", "pid", "mnt"]:
197 assert Path(f"/proc/{info['State']['Pid']}/ns/{namespace}").stat().st_ino != Path(f"/proc/self/ns/{namespace}").stat().st_ino
198 status = shell("podman", "exec", container, "/bin/cat", "/proc/1/status")
199 assert f"Uid:\t{account.pw_uid}\t{account.pw_uid}\t{account.pw_uid}\t{account.pw_uid}" in status
200 assert all(field + ":\t0000000000000000" in status for field in ["CapEff", "CapPrm", "CapBnd", "CapAmb"])
201 for denied in ["/var/lib/studio/nomad.token", "/run/podman/podman.sock", "/run/libvirt/libvirt-sock", "/dev/zfs", "/opt/studio/current", "/srv/vm", "/srv/prod/keycloak"]:
202 result = subprocess.run(["podman", "exec", container, "/bin/test", "-e", denied], capture_output=True)
203 assert result.returncode != 0, denied
204 assert data.stat().st_uid == account.pw_uid and (data / "existing.json").stat().st_uid == account.pw_uid
205 python = next(value.split("=", 1)[1] for value in info["Config"]["Env"] if value.startswith("STUDIO_YT_PYTHON="))
206 shell("podman", "exec", container, python, "-c", "import ssl; assert ssl.create_default_context().cert_store_stats()['x509_ca'] > 0")
207 refused = "import socket; s=socket.socket(socket.AF_UNIX); s.connect('/run/studio-host/host.sock'); " + "\ntry:\n s.sendall(b'{\"operation\":\"host.sample\"}\\n'); assert s.recv(4) == b''\nexcept (BrokenPipeError, ConnectionResetError):\n pass\n"
208 shell("podman", "exec", f"--user=65534:{account.pw_gid}", container, python, "-c", refused)
209 shell("podman", "exec", container, python, "-c", "from pathlib import Path; p=Path('/srv/prod/ytdl/data'); (p/'existing.json').write_text('fixture'); (p/'nested/new.json').write_text('fixture')")
210 assert (state / "existing.json").stat().st_uid == 3118 and state.stat().st_uid == 3118
211 assert (state / "nested/new.json").exists()
212 shell("podman", "exec", "--user=3118:3000", container, python, "-c", "from pathlib import Path; p=Path('/srv/prod/ytdl/data'); (p/'nested/new.json').open('a').write('service'); (p/'nested/service.json').write_text('service')")
213 shell("podman", "exec", container, python, "-c", "from pathlib import Path; p=Path('/srv/prod/ytdl/data/nested/service.json'); assert p.read_text() == 'service'; p.open('a').write('dashboard')")
214 assert subprocess.run(["podman", "exec", container, "/bin/touch", "/srv/clover/Media/escaped"], capture_output=True).returncode != 0
215
216 def get(path):
217 request = urllib.request.Request(f"http://127.0.0.1:{port}" + path, headers={
218 "Studio-Proxy-Token": proof, "User-Name": "fixture", "User-Groups": "infra-admin",
219 })
220 with urllib.request.urlopen(request, timeout=30) as response:
221 return json.load(response)
222
223 machine = get("/api/host")
224 assert machine["cores"] > 0 and machine["memory"] > 2 * 1024 ** 3
225 assert get("/api/media/list?path=jellyfin/Indie%20Shows/Fixture/Season%201")["entries"]
226 assert get("/api/youtube/library")
227 assert get("/api/youtube")
228 iam_output = root / "iam-checks.json"
229 shell(sys.executable, str(repo / "tools/dashboard-iam-test.py"), "--url", f"http://127.0.0.1:{port}",
230 "--socket", f"/run/{host_unit}/host.sock", "--proof-file", str(token),
231 "--output", str(iam_output), timeout=180)
232 iam_checks = json.loads(iam_output.read_text())
233 mcp_output = root / "mcp-checks.json"
234 shell(sys.executable, str(repo / "tools/dashboard-mcp-test.py"), "--url", f"http://127.0.0.1:{port}",
235 "--proof-file", str(token), "--restart-unit", app_unit,
236 "--output", str(mcp_output), timeout=240)
237 mcp_checks = json.loads(mcp_output.read_text())
238 relay_output = root / "relay-checks.json"
239 shell(sys.executable, str(repo / "tools/dashboard-relay-test.py"), "--url", f"http://127.0.0.1:{port}",
240 "--proof-file", str(token), "--data-dir", str(data), "--restart-unit", app_unit,
241 "--output", str(relay_output), *(["--agent-dir", str(args.relay_agent_dir), "--agent-origin", f"https://globe.studio.test:{gateway_port}", "--agent-ca", str(gateway_ca)] if args.relay_agent_dir else []), timeout=240)
242 relay_checks = json.loads(relay_output.read_text())
243 shale_output = root / "shale-link-checks.json"
244 shell(sys.executable, str(repo / "tools/dashboard-shale-link-test.py"), "--url", f"http://127.0.0.1:{port}",
245 "--proof-file", str(token), "--data-dir", str(data), "--restart-unit", app_unit,
246 "--shale-origin", shale_origin, "--shale-database", str(shale_database), "--shale-container", shale_container,
247 "--output", str(shale_output), timeout=240)
248 shale_checks = json.loads(shale_output.read_text())
249 worker = "from pathlib import Path; found=[]\nfor p in Path('/proc').iterdir():\n if p.name.isdigit():\n try:\n argv=(p/'cmdline').read_bytes().rstrip(b'\\0').split(b'\\0')\n if argv[1:] == [b'server/youtube-worker.py']:\n found.append((p/'status').read_text())\n except (FileNotFoundError, PermissionError):\n pass\nassert len(found) == 1, len(found)\n" + f"assert 'Uid:\\t{account.pw_uid}\\t{account.pw_uid}\\t{account.pw_uid}\\t{account.pw_uid}' in found[0]\nassert 'CapEff:\\t0000000000000000' in found[0] and 'NoNewPrivs:\\t1' in found[0]\n"
250 shell("podman", "exec", container, python, "-c", worker)
251 socket_inode = Path("/run/" + host_unit).stat().st_ino
252 shell("systemctl", "restart", host_unit)
253 assert Path("/run/" + host_unit).stat().st_ino == socket_inode
254 time.sleep(1.1)
255 assert get("/api/host")["memory"] == machine["memory"]
256 started = time.monotonic()
257 shell("systemctl", "restart", app_unit, timeout=180)
258 restart_seconds = time.monotonic() - started
259 assert restart_seconds < 15, restart_seconds
260 assert get("/api/me")["name"] == "fixture" and (data / "existing.json").exists()
261 browser_checks = None
262 if args.browser_ready_file:
263 browser_checks = json.loads(shell(sys.executable, str(repo / "tools/dashboard-browser-test.py"),
264 "--ready-file", str(args.browser_ready_file), "--timeout", str(args.browser_timeout), timeout=args.browser_timeout + 60))
265 started = time.monotonic()
266 shell("systemctl", "stop", app_unit, timeout=30)
267 elapsed = time.monotonic() - started
268 assert elapsed < 15 and shell("systemctl", "show", "-P", "Result", app_unit).strip() == "success"
269 result = {"image": info["ImageName"], "generated_nixos_unit": True, "dedicated_uid": account.pw_uid, "readonly_rootfs": True,
270 "zero_capabilities": True, "quotas": True, "private_network": True, "bounded_mounts": True,
271 "host_broker_uid_auth": True, "other_uid_same_group_refused": True,
272 "state_ownership_migration": True, "shared_youtube_acl": True,
273 "youtube_owner_preserved": True, "readonly_media": True, "unprivileged_youtube_worker": True,
274 "python_public_tls_roots": True,
275 "iam": iam_checks, "mcp": mcp_checks, "relay": relay_checks, "shale_link": shale_checks,
276 "broker_restart_socket_preserved": True, "container_restart_state_preserved": True,
277 "cached_image_restart_seconds": round(restart_seconds, 2),
278 "systemd_stop_seconds": round(elapsed, 2)}
279 if browser_checks is not None:
280 result["browser_route_fixture"] = browser_checks
281 if args.output:
282 args.output.parent.mkdir(parents=True, exist_ok=True)
283 args.output.write_text(json.dumps(result, indent=2) + "\n")
284 print(json.dumps(result))
285 finally:
286 subprocess.run(["systemctl", "stop", app_unit, host_unit], capture_output=True, timeout=60)
287 subprocess.run(["podman", "rm", "--ignore", "--force", container], capture_output=True, timeout=15)
288 if caddy is not None:
289 caddy.terminate()
290 try:
291 caddy.wait(timeout=10)
292 except subprocess.TimeoutExpired:
293 caddy.kill()
294 caddy.wait(timeout=5)
295 for file in unit_files:
296 file.unlink(missing_ok=True)
297 for directory in ["/var/lib/studio/host-unit-test", "/run/" + host_unit]:
298 shutil.rmtree(directory, ignore_errors=True)
299 shell("systemctl", "daemon-reload")
300
301
302if __name__ == "__main__":
303 main()
tools/dashboard-vm-boundary-test.py+1-1
...@@ -116,7 +116,7 @@ raise AssertionError('interrupted creation reported success')...@@ -116,7 +116,7 @@ raise AssertionError('interrupted creation reported success')
116 attempt = subprocess.run([sys.executable, "-c", interrupted, str(Path(__file__).parent), phase],116 attempt = subprocess.run([sys.executable, "-c", interrupted, str(Path(__file__).parent), phase],
117 input=json.dumps({**spec, "image": installer.name if phase == "copy" else "blank"}),117 input=json.dumps({**spec, "image": installer.name if phase == "copy" else "blank"}),
118 capture_output=True, text=True, timeout=60,118 capture_output=True, text=True, timeout=60,
119 env={**os.environ, "STUDIO_VM_IMAGES_ROOT": str(images)})119 env={**os.environ, "SNOWGLOBE_VM_IMAGES_ROOT": str(images)})
120 elapsed = time.monotonic() - started120 elapsed = time.monotonic() - started
121 assert attempt.returncode == 1, attempt.stderr121 assert attempt.returncode == 1, attempt.stderr
122 if phase == "copy":122 if phase == "copy":
tools/data-restore.md+33-17
...@@ -1,12 +1,21 @@...@@ -1,12 +1,21 @@
1# Production data rollback1# Production data restore
22
3Every promotion and code rollback backs up the active release before switching it. One ZFS snapshot operation captures the mounted service datasets and PostgreSQL data at the same instant. A temporary clone of that PostgreSQL snapshot runs without a network and produces the service-owned database dumps, including services with multiple database inputs. The clone is destroyed before the backup is published. `python3 tools/deploy.py backups` lists the backup IDs and services. A failed promotion can leave a completed backup even when release history has no new entry.3Every production promotion and code rollback backs up the active release
4before switching it. One ZFS snapshot operation captures mounted managed
5service datasets and PostgreSQL data together. A temporary isolated PostgreSQL
6clone produces service-owned database dumps and is destroyed before the
7backup is published. A failed deployment can leave a completed backup without
8a successful release-history entry.
49
5The backup now also saves a private `nomad.snap` and its SHA-256 in the manifest. A disposable backup run against the VM's live Nomad server verified the file and digest, then removed it. This snapshot includes jobs, ACLs, and secret variables; keep the backup directory private. Service data restore does not apply the whole Nomad snapshot, which is reserved for an explicit cluster recovery. The backup directory is still on the OS disk until Snow Globe control state has durable storage.10`python3 tools/deploy.py backups` lists backup IDs and services. Each backup's
11private manifest records the service snapshots, database dumps and checksums,
12and a private `nomad.snap`. The Nomad snapshot includes jobs, ACLs, and secret
13variables. It is for explicit cluster recovery; service restore does not apply
14it. Earlier backups may lack this snapshot. Manifests and dumps remain on the
15OS disk; see [hardware and recovery](snowglobe-hardware.md) for off-server
16recovery requirements.
617
7At inspection, the VM retained 25 release backups: their PostgreSQL dumps and manifests used `275 MB`, and their service snapshots numbered 550. No automatic retention policy deletes these backups yet; choose one before long-running production use. Earlier backup manifests do not contain `nomad.snap`.18To restore one service after production data restore is explicitly authorized:
8
9To restore one service, roll its code back first, then run:
1019
11```sh20```sh
12python3 tools/deploy.py backups21python3 tools/deploy.py backups
...@@ -14,14 +23,21 @@ python3 tools/deploy.py rollback <old-release-id>...@@ -14,14 +23,21 @@ python3 tools/deploy.py rollback <old-release-id>
14python3 tools/deploy.py data-restore <service-id> --backup <backup-id> --discard-writes23python3 tools/deploy.py data-restore <service-id> --backup <backup-id> --discard-writes
15```24```
1625
17The backup's `fromRelease` must match the active release. Data restore stops that service, saves its current dataset and database as a safety copy, restores the chosen ZFS snapshot and PostgreSQL dump, then deploys and checks the service. **Changes written after the chosen backup are discarded from the live service.** The safety snapshot and dump remain on the host. Postgres itself is shared; restore its owner services individually. Shared Clover and Media mounts are outside this service restore; restoring an entire shared dataset would discard unrelated users' writes.26The backup's `fromRelease` must match the active release. The command verifies
1827backup snapshots and dumps before stopping the service, saves the current
19The CLI checks that the backup snapshot and database dumps exist before stopping the service. A disposable missing-snapshot manifest on the VM was rejected while Redis Insight stayed running; the fixture was removed.28dataset and database as a safety copy, restores the selected data, then
2029deploys and checks the service. **Writes after the chosen backup are discarded
21On the VM, backup `20260927T030206Z-67f38b` captured 22 service snapshots and four database dumps from a cloned PostgreSQL snapshot. All dump hashes and snapshots verified; the temporary container and dataset were removed while the production PostgreSQL allocation stayed running. An injected dump failure after clone startup left the ZFS dataset/snapshot list and backup directory list unchanged, with no probe container. Earlier rollback and restore tests are recorded in the release history.30from the live service.** The safety snapshot and dump remain on the host.
2231
23# VM restore rehearsal32Restore PostgreSQL owner services individually; the PostgreSQL service itself
2433is shared. Clover, Media, and external archive mounts are outside managed
25On 2026-09-27, backup `20260927T033539Z-123cab` captured the running x86 VM's service datasets and PostgreSQL databases. A throwaway file and table were then added to `evil-hedgedoc`. Running `data.py restore 20260927T033539Z-123cab evil-hedgedoc --discard-writes` stopped the job, saved the pre-restore safety snapshot, restored the dataset and database, and redeployed it. Both probes disappeared, `https://md.evil.studio.test/_health` returned 200 from the Mac, and all 19 VM routes passed their health checks. This proves the explicit data restore path on the VM; the production NAS cutover remains separate.34service restore. Restoring an entire shared dataset discards unrelated writes.
2635For Shale, keep the complete service dataset together: repository visibility,
27The `20260927T055034Z-27d895` backup retained all 22 service snapshots and four matching PostgreSQL dumps. Its Dawarich dump restored into a new database owned by `svc_dawarich` in an isolated PostgreSQL ZFS clone, with `pgcrypto` and `postgis` created first and `pg_restore --role=svc_dawarich`. The restored `points` table contained 22,666 rows. The probe container and clone were removed, the live PostgreSQL allocation stayed running, and Dawarich still returned HTTP 200.36repository objects, issue database, attachment files, and their manifest must
37agree. For Copyparty, also preserve its Nomad API-account hashes as described
38in [administration](copyparty.md). For Knife, preserve the external archive
39store and identity as described in [operations](knife.md).
40
41Verify the real application, authentication, persistence, provider connections,
42allocation health and logs after recovery. Code rollback only changes code;
43it does not restore data or undo a folder move.
tools/data.py+15-11
...@@ -4,6 +4,7 @@ from contextlib import closing, contextmanager...@@ -4,6 +4,7 @@ from contextlib import closing, contextmanager
4from datetime import datetime, timezone4from datetime import datetime, timezone
5import hashlib5import hashlib
6import json6import json
7from importlib import import_module
7import os8import os
8from pathlib import Path9from pathlib import Path
9import re10import re
...@@ -14,8 +15,10 @@ import subprocess...@@ -14,8 +15,10 @@ import subprocess
14import time15import time
1516
1617
17ROOT = Path("/opt/studio")18transition = import_module("namespace-transition")
18STATE = Path("/var/lib/studio")19
20ROOT = Path("/opt/snowglobe")
21STATE = Path("/var/lib/snowglobe")
19BACKUPS = STATE / "backups"22BACKUPS = STATE / "backups"
20BACKUP_ID = re.compile(r"\d{8}T\d{6}Z-[0-9a-f]{6}\Z")23BACKUP_ID = re.compile(r"\d{8}T\d{6}Z-[0-9a-f]{6}\Z")
21SERVICE_ID = re.compile(r"[a-z][a-z0-9-]*\Z")24SERVICE_ID = re.compile(r"[a-z][a-z0-9-]*\Z")
...@@ -32,7 +35,7 @@ def current_release():...@@ -32,7 +35,7 @@ def current_release():
32 if not current.is_symlink():35 if not current.is_symlink():
33 raise ValueError("No active home server release")36 raise ValueError("No active home server release")
34 release = current.resolve()37 release = current.resolve()
35 if release.parent != ROOT / "releases" or not RELEASE_ID.fullmatch(release.name):38 if release.parent != (ROOT / "releases").resolve() or not RELEASE_ID.fullmatch(release.name):
36 raise ValueError("Active home server release is invalid")39 raise ValueError("Active home server release is invalid")
37 return release40 return release
3841
...@@ -118,7 +121,7 @@ def cloned_postgres(snapshot, clone, mountpoint):...@@ -118,7 +121,7 @@ def cloned_postgres(snapshot, clone, mountpoint):
118 image = inspect["Image"]121 image = inspect["Image"]
119 if not re.fullmatch(r"[0-9a-f]{64}", image):122 if not re.fullmatch(r"[0-9a-f]{64}", image):
120 raise ValueError("Postgres image ID is invalid")123 raise ValueError("Postgres image ID is invalid")
121 probe = "studio-backup-" + clone.rsplit("/", 1)[1]124 probe = "snowglobe-backup-" + clone.rsplit("/", 1)[1]
122 created = False125 created = False
123 try:126 try:
124 run("zfs", "clone", "-o", f"mountpoint={mountpoint}", snapshot, clone)127 run("zfs", "clone", "-o", f"mountpoint={mountpoint}", snapshot, clone)
...@@ -175,7 +178,7 @@ def backup(from_release, to_release):...@@ -175,7 +178,7 @@ def backup(from_release, to_release):
175 directory = BACKUPS / backup_id178 directory = BACKUPS / backup_id
176 manifest = {"id": backup_id, "fromRelease": from_release, "toRelease": to_release,179 manifest = {"id": backup_id, "fromRelease": from_release, "toRelease": to_release,
177 "time": int(time.time()), "services": {}}180 "time": int(time.time()), "services": {}}
178 snapshot = "studio-" + backup_id181 snapshot = "snowglobe-" + backup_id
179 datasets = set()182 datasets = set()
180 allocations = {}183 allocations = {}
181 for service in sorted(names):184 for service in sorted(names):
...@@ -262,7 +265,8 @@ def restore(backup_id, service):...@@ -262,7 +265,8 @@ def restore(backup_id, service):
262 path = source / name265 path = source / name
263 if not path.resolve().is_relative_to(source.resolve()) or not path.is_file() or checksum(path) != digest:266 if not path.resolve().is_relative_to(source.resolve()) or not path.is_file() or checksum(path) != digest:
264 raise ValueError("Dashboard backup is missing or changed")267 raise ValueError("Dashboard backup is missing or changed")
265 run("systemctl", "stop", "studio-dashboard")268 unit = transition.layout(current_release())["prefix"] + "-dashboard"
269 run("systemctl", "stop", unit)
266 safety = BACKUPS / ("before-restore-" + datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ") + "-" + secrets.token_hex(3))270 safety = BACKUPS / ("before-restore-" + datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ") + "-" + secrets.token_hex(3))
267 safety.mkdir(mode=0o700)271 safety.mkdir(mode=0o700)
268 files = backup_dashboard(safety / "dashboard")272 files = backup_dashboard(safety / "dashboard")
...@@ -273,8 +277,8 @@ def restore(backup_id, service):...@@ -273,8 +277,8 @@ def restore(backup_id, service):
273 if (root / "pictures").exists():277 if (root / "pictures").exists():
274 shutil.rmtree(root / "pictures")278 shutil.rmtree(root / "pictures")
275 shutil.copytree(source, root, dirs_exist_ok=True)279 shutil.copytree(source, root, dirs_exist_ok=True)
276 run("systemctl", "start", "studio-dashboard")280 run("systemctl", "start", unit)
277 run("systemctl", "is-active", "--quiet", "studio-dashboard")281 run("systemctl", "is-active", "--quiet", unit)
278 print(f"restored=dashboard backup={backup_id} safety={safety.name}")282 print(f"restored=dashboard backup={backup_id} safety={safety.name}")
279 return283 return
280 dataset = entry.get("dataset")284 dataset = entry.get("dataset")
...@@ -319,9 +323,9 @@ def restore(backup_id, service):...@@ -319,9 +323,9 @@ def restore(backup_id, service):
319 with (directory / database["dump"]).open("rb") as input_file:323 with (directory / database["dump"]).open("rb") as input_file:
320 run(*PODMAN, "exec", "-i", container, "pg_restore", "-U", "postgres", "-d", name,324 run(*PODMAN, "exec", "-i", container, "pg_restore", "-U", "postgres", "-d", name,
321 "--no-owner", "--no-acl", "--role=" + owner, stdin=input_file)325 "--no-owner", "--no-acl", "--role=" + owner, stdin=input_file)
322 script = current_release() / "tools/studio.py"326 script = transition.layout(current_release())["script"]
323 run("python3", str(script), "deploy", service)327 run("python3", str(script), "deploy", service, env=transition.environment(current_release()))
324 run("python3", str(script), "check", service)328 run("python3", str(script), "check", service, env=transition.environment(current_release()))
325 print(f"restored={service} backup={backup_id} safety={safety}")329 print(f"restored={service} backup={backup_id} safety={safety}")
326330
327331
tools/dawarich-migration.md deleted-31
...@@ -1,31 +0,0 @@
1# Dawarich migration
2
3The 2026-10-04 offline handoff includes Dawarich's PostgreSQL 18 database, with a verified restore and hashes for every table, sequence, and large object. Restore it before starting Dawarich. Keep the original Rails `SECRET_KEY_BASE` and copy `/var/app/storage` into the managed service dataset before the first application boot.
4
5The production database import on 2026-10-04 passed all 63 exported relation and large-object fingerprints before any Dawarich process started. Evidence is `/var/lib/studio/dawarich-import-7hw6v9w1/verified.json`. PostGIS retains its 8,500 built-in spatial references; PostgreSQL extension dumps contain only custom reference rows. Removing the built-ins changes geometry JSON serialization as well as breaking reference lookup. The importer preserves built-ins and replaces only explicitly dumped custom SRIDs.
6
7[import-personal-postgres.py](import-personal-postgres.py) reads the allocated production database from `nomad/jobs/dawarich/inputs/database`. The target database and `svc_dawarich` role must already exist. For initial production migration, keep both Nomad jobs stopped and use an isolated PostGIS initializer with `--network none`, mounting the final PostgreSQL data directory:
8
9```sh
10python3 tools/import-personal-postgres.py dawarich \
11 /mnt/storage1/apps/studio-handoff/20261004T230507Z-e75419 \
12 --container PERSONAL_POSTGRES_INITIALIZER
13```
14
15The importer saves a private target backup under `/var/lib/studio/dawarich-import-*`, restores application objects as the allocated owner, preserves PostGIS reference data, and compares the result with the export's content hashes. It leaves Dawarich stopped. Stop and remove the initializer before deploying the production Postgres job. For a later import into an already running production Postgres allocation, omit `--container`; Dawarich must still be stopped.
16
17The historical preview results below concern the rehearsal VM. Zenith's separate Redis dump was 86,557 bytes and belonged to Dawarich. DB 0 contained caches and track-generation keys; DB 1 held 106 queued `Family::Invitations::CleanupJob` entries. The old image's nightly schedule sent them to `family`, while its worker listened to `families`; that queue reached 107 entries on 2026-09-27. The pinned image schedules this job on `families`, and all 14 of its scheduled queues appear in the worker's queue list.
18
19The rehearsal's source and target used PostgreSQL 18 with PostGIS. The tested transfer used a consistent custom-format dump made with `pg_dump -Fc --no-owner --no-acl --exclude-extension=postgis`, then restored it into a **separate stage database** after creating the PostGIS extension there. It did not write to Zenith or the VM's production database.
20
21The Rails `SECRET_KEY_BASE` must stay the same as the source value so encrypted records remain readable. The old `/var/app/storage` contained one file; its checksum matched the staged copy. The generated `/var/app/public` assets and `/var/app/tmp` cache were not imported. The stage used its own Keycloak client and database; its two imported user records remained intact.
22
23Before the new image ran, the source and staged database both had 22,666 points, 1,011 tracks, 2 users, and 74 visits. The current image rebuilds derived tracks and visits on startup; after a worker restart, the staged database had 22,666 points, 698 tracks, 2 users, 139 visits, and 74 newly generated track segments. Track count is therefore not a row-for-row import check. Point and user counts, storage checksums, HTTPS health, and the SSO login flow should be checked separately.
24
25The first staged boot exposed a startup race: Sidekiq loaded the old `TrackSegment` schema before the web entrypoint finished migrations, then logged `unknown attribute 'start_at'`. Restarting the worker after migrations restored segment creation. The service now runs Redis as a prestart sidecar and completes a migration task before starting web and worker. Its web entrypoint still repeats the upstream migration command, which is idempotent but extends cold startup on the emulated x86 VM.
26
27The corrected deployment is `dawarich-preview-1e4dac4a` at `https://dawarich-preview-1e4dac4a.studio.test` (release `554d23a23d940690`). Nomad marked it healthy; the HTTPS health endpoint returned 200 with certificate verification, and the new worker allocation logged no `start_at` errors.
28
29[import-dawarich.sh](import-dawarich.sh) repeats the preview restore from the latest read-only Zenith app snapshot and copies the small storage directory. It compares the source and target `SECRET_KEY_BASE` by hash, backs up the target ZFS dataset and database, restores the source PostgreSQL dump with PostGIS, and checks point/user counts before starting the preview. The 2026-09-26 run completed successfully: 22,666 points and two users survived migrations, HTTPS health returned 200 from this Mac with certificate verification, Nomad marked the job healthy, and the worker had no `start_at` error.
30
31The shell importer requires the old running source and serves VM previews. The Python importer uses the retained offline handoff for the same-machine production cutover.
tools/ddns-migration.md deleted-9
...@@ -1,9 +0,0 @@
1# DDNS cutover
2
3The `.test` VM does not run DDNS. Evaluating `service/ddns-updater/service.pkl` on the VM with `domain=paperclover.net` produced valid JSON for the Cloudflare `*.paperclover.net` record and required `cloudflare_zone_id` and `cloudflare_api_token`. Zenith's legacy `.env` contains the corresponding `CLOUDFLARE_ZONE_ID` and `CLOUDFLARE_API_TOKEN` keys. No public DNS record was changed during this check.
4
5The current worktree's `config/`, `service/`, and `tools/` generated 27 production-domain jobs, all accepted by `nomad job validate` on the VM. This was validation only; it did not submit jobs or contact Cloudflare.
6
7Snow Globe replaces a service hostname's first label with its stage ID: Shale becomes `shale-preview-12345678.paperclover.net`, while evil.inc Forgejo becomes `evil-forgejo-preview-12345678.evil.paperclover.net`. Cloudflare's wildcard DNS records [cover multiple levels when no specific record takes precedence](https://developers.cloudflare.com/dns/manage-dns-records/reference/wildcard-dns-records/). Read-only DNS queries resolved both a sample Shale stage name and an otherwise nonexistent name under `evil.paperclover.net` to the current public address. The README's `.staging.paperclover.net` example describes a different hostname scheme from the current CLI. No public record changed; ACME issuance still needs a live cutover check.
8
9At production cutover, set `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT` for the new host, then run `bash tools/import-legacy-secrets.sh ddns-updater CLOUDFLARE_ZONE_ID CLOUDFLARE_API_TOKEN`. The order matches the required secret fields in the service definition. Start the Snow Globe DDNS job only after the old updater is stopped; otherwise both updaters can write the wildcard record. Verify the provider status and the public record after the new job starts.
tools/deploy-test.py+12-13
...@@ -15,7 +15,7 @@ import release...@@ -15,7 +15,7 @@ import release
1515
16class MainExport(unittest.TestCase):16class MainExport(unittest.TestCase):
17 def test_production_exports_main_while_staging_exports_working_files(self):17 def test_production_exports_main_while_staging_exports_working_files(self):
18 with tempfile.TemporaryDirectory(prefix="studio-main-export-") as temporary:18 with tempfile.TemporaryDirectory(prefix="snowglobe-main-export-") as temporary:
19 root = Path(temporary)19 root = Path(temporary)
20 repo = root / "repo"20 repo = root / "repo"
21 repo.mkdir()21 repo.mkdir()
...@@ -28,11 +28,12 @@ class MainExport(unittest.TestCase):...@@ -28,11 +28,12 @@ class MainExport(unittest.TestCase):
28 else:28 else:
29 path.mkdir()29 path.mkdir()
30 (path / "fixture").write_text("committed")30 (path / "fixture").write_text("committed")
31 (repo / "config/excluded-services.json").write_text('["retired"]\n')31 (repo / "service/app").mkdir()
32 (repo / "service/retired").mkdir()32 (repo / "service/app/service.pkl").write_text("service definition")
33 (repo / "service/retired/private").write_text("must not be exported")33 (repo / "service/app/worker.pkl").write_text("grouped definition")
34 executable = repo / "tools/fixture"34 executable = repo / "tools/fixture"
35 executable.chmod(0o755)35 executable.chmod(0o755)
36 subprocess.run(["jj", "file", "track", "--include-ignored", "AGENTS.md"], cwd=repo, check=True, capture_output=True)
36 for args in [["describe", "-m", "Test main"], ["bookmark", "set", "main"]]:37 for args in [["describe", "-m", "Test main"], ["bookmark", "set", "main"]]:
37 subprocess.run(["jj", *args], cwd=repo, check=True, capture_output=True)38 subprocess.run(["jj", *args], cwd=repo, check=True, capture_output=True)
38 commit = subprocess.run(["jj", "--ignore-working-copy", "log", "-r", "main", "--no-graph", "-T", "commit_id"], cwd=repo, check=True, capture_output=True, text=True).stdout39 commit = subprocess.run(["jj", "--ignore-working-copy", "log", "-r", "main", "--no-graph", "-T", "commit_id"], cwd=repo, check=True, capture_output=True, text=True).stdout
...@@ -42,8 +43,6 @@ class MainExport(unittest.TestCase):...@@ -42,8 +43,6 @@ class MainExport(unittest.TestCase):
42 original = subprocess.run43 original = subprocess.run
4344
44 def transport(argv, **kwargs):45 def transport(argv, **kwargs):
45 if argv[0] == "jj" and "show" in argv and argv[-1].startswith("service/retired/"):
46 raise AssertionError("read excluded source")
47 if argv[0] == "ssh":46 if argv[0] == "ssh":
48 return subprocess.CompletedProcess(argv, 1)47 return subprocess.CompletedProcess(argv, 1)
49 if argv[0] == "rsync" and "-e" in argv:48 if argv[0] == "rsync" and "-e" in argv:
...@@ -64,13 +63,13 @@ class MainExport(unittest.TestCase):...@@ -64,13 +63,13 @@ class MainExport(unittest.TestCase):
64 self.assertEqual((main / "service/fixture").read_text(), "committed")63 self.assertEqual((main / "service/fixture").read_text(), "committed")
65 self.assertFalse((main / "service/new").exists())64 self.assertFalse((main / "service/new").exists())
66 self.assertTrue(os.access(main / "tools/fixture", os.X_OK))65 self.assertTrue(os.access(main / "tools/fixture", os.X_OK))
67 self.assertEqual(json.loads((main / ".studio-release.json").read_text())["main"], {"commit": commit, "description": "Test main\n"})66 self.assertEqual(json.loads((main / ".snowglobe-release.json").read_text())["main"], {"commit": commit, "description": "Test main\n"})
68 self.assertEqual((stage / "service/fixture").read_text(), "unfinished")67 self.assertEqual((stage / "service/fixture").read_text(), "unfinished")
69 self.assertEqual((stage / "service/new").read_text(), "new working file")68 self.assertEqual((stage / "service/new").read_text(), "new working file")
70 self.assertNotIn("main", json.loads((stage / ".studio-release.json").read_text()))69 self.assertNotIn("main", json.loads((stage / ".snowglobe-release.json").read_text()))
71 self.assertFalse((main / "service/retired").exists())70 for exported in (main, stage):
72 self.assertFalse((stage / "service/retired").exists())71 self.assertEqual((exported / "service/app/service.pkl").read_text(), "service definition")
73 self.assertFalse(any("retired" in relative.parts for _, relative in release.files(repo)))72 self.assertEqual((exported / "service/app/worker.pkl").read_text(), "grouped definition")
74 subprocess.run(["jj", "bookmark", "set", "main"], cwd=repo, check=True, capture_output=True)73 subprocess.run(["jj", "bookmark", "set", "main"], cwd=repo, check=True, capture_output=True)
75 with self.assertRaisesRegex(ValueError, "commit description"):74 with self.assertRaisesRegex(ValueError, "commit description"):
76 deploy.upload(main=True)75 deploy.upload(main=True)
...@@ -80,7 +79,7 @@ class BuildSourceExport(unittest.TestCase):...@@ -80,7 +79,7 @@ class BuildSourceExport(unittest.TestCase):
80 def setUp(self):79 def setUp(self):
81 stack = ExitStack()80 stack = ExitStack()
82 self.addCleanup(stack.close)81 self.addCleanup(stack.close)
83 root = Path(stack.enter_context(tempfile.TemporaryDirectory(prefix="studio-build-source-"))).resolve()82 root = Path(stack.enter_context(tempfile.TemporaryDirectory(prefix="snowglobe-build-source-"))).resolve()
84 self.repo = root / "repo"83 self.repo = root / "repo"
85 self.source = root / "source"84 self.source = root / "source"
86 self.remote = root / "remote"85 self.remote = root / "remote"
...@@ -93,7 +92,6 @@ class BuildSourceExport(unittest.TestCase):...@@ -93,7 +92,6 @@ class BuildSourceExport(unittest.TestCase):
93 else:92 else:
94 path.mkdir()93 path.mkdir()
95 (path / "fixture").write_text("fixture")94 (path / "fixture").write_text("fixture")
96 (self.repo / "config/excluded-services.json").write_text("[]\n")
97 (self.source / "lib").mkdir()95 (self.source / "lib").mkdir()
98 (self.source / "lib/committed").write_text("committed library")96 (self.source / "lib/committed").write_text("committed library")
99 (self.source / "src").mkdir()97 (self.source / "src").mkdir()
...@@ -113,6 +111,7 @@ class BuildSourceExport(unittest.TestCase):...@@ -113,6 +111,7 @@ class BuildSourceExport(unittest.TestCase):
113 self.spec = {"source": "../source", "revision": self.commit,111 self.spec = {"source": "../source", "revision": self.commit,
114 "dockerfile": "src/app.dockerfile", "include": ["run.sh", "lib"]}112 "dockerfile": "src/app.dockerfile", "include": ["run.sh", "lib"]}
115 self.manifest.write_text(json.dumps(self.spec))113 self.manifest.write_text(json.dumps(self.spec))
114 subprocess.run(["jj", "file", "track", "--include-ignored", "AGENTS.md"], cwd=self.repo, check=True, capture_output=True)
116 for args in [["describe", "-m", "Pinned build source"], ["bookmark", "set", "main"]]:115 for args in [["describe", "-m", "Pinned build source"], ["bookmark", "set", "main"]]:
117 subprocess.run(["jj", *args], cwd=self.repo, check=True, capture_output=True)116 subprocess.run(["jj", *args], cwd=self.repo, check=True, capture_output=True)
118 original = subprocess.run117 original = subprocess.run
tools/deploy.py+29-38
...@@ -12,13 +12,13 @@ import sys...@@ -12,13 +12,13 @@ import sys
12import tempfile12import tempfile
13import time13import time
1414
15from release import SOURCES, excluded_services, tree_digest15from release import SOURCES, tree_digest
1616
1717
18REPO = Path(__file__).resolve().parent.parent18REPO = Path(__file__).resolve().parent.parent
19HOST = os.environ.get("STUDIO_DEPLOY_HOST", "root@127.0.0.1")19HOST = os.environ.get("SNOWGLOBE_DEPLOY_HOST", "root@10.0.0.1")
20PORT = os.environ.get("STUDIO_DEPLOY_PORT", "2222")20PORT = os.environ.get("SNOWGLOBE_DEPLOY_PORT", "22")
21REMOTE = Path("/opt/studio")21REMOTE = Path("/opt/snowglobe")
22NAME = re.compile(r"[a-z][a-z0-9-]*\Z")22NAME = re.compile(r"[a-z][a-z0-9-]*\Z")
23RELEASE_ID = re.compile(r"[0-9a-f]{16}\Z")23RELEASE_ID = re.compile(r"[0-9a-f]{16}\Z")
2424
...@@ -32,18 +32,27 @@ def ssh(command, capture=False):...@@ -32,18 +32,27 @@ def ssh(command, capture=False):
3232
33def run_logged(mode, target, command):33def run_logged(mode, target, command):
34 run = f"{int(time.time() * 1000)}-{mode}-{target or 'current'}"34 run = f"{int(time.time() * 1000)}-{mode}-{target or 'current'}"
35 path = f"/var/lib/studio/runs/{run}.log"35 path = f"/var/lib/snowglobe/runs/{run}.log"
36 script = f"umask 077; mkdir -p /var/lib/studio/runs; set -o pipefail; {command} 2>&1 | tee {shlex.quote(path)}"36 script = f"umask 077; mkdir -p /var/lib/snowglobe/runs; set -o pipefail; {command} 2>&1 | tee {shlex.quote(path)}"
37 ssh("bash -c " + shlex.quote(script))37 ssh("bash -c " + shlex.quote(script))
38 print(f"run={run}")38 print(f"run={run}")
3939
4040
41def prepare_remote():
42 subprocess.run(
43 ["ssh", "-p", PORT, "-o", "BatchMode=yes", HOST, "python3 - prepare"],
44 input="NAMESPACE = " + repr(json.loads((REPO / "dashboard/src/namespace-transition.json").read_text())) + "\n"
45 + (REPO / "tools/namespace-transition.py").read_text(), text=True, check=True,
46 )
47
48
41def sync_manager(release):49def sync_manager(release):
42 source = REMOTE / "releases" / release / "tools"50 source = REMOTE / "releases" / release / "tools"
43 ssh(f"cp {source}/release.py {source}/data.py {REMOTE}/")51 ssh(f"cp {source}/release.py {source}/data.py {source}/namespace-transition.py {REMOTE}/")
52 ssh(f"cp {source}/../dashboard/src/namespace-transition.json {REMOTE}/namespace-transition.json")
4453
4554
46def export_revision(source, commit, paths, destination, excluded=frozenset()):55def export_revision(source, commit, paths, destination):
47 entries = subprocess.run(56 entries = subprocess.run(
48 ["jj", "--ignore-working-copy", "file", "list", "-r", commit, "-T",57 ["jj", "--ignore-working-copy", "file", "list", "-r", commit, "-T",
49 '\"[\" ++ json(path) ++ \",\" ++ json(file_type) ++ \",\" ++ json(executable) ++ \"]\\n\"',58 '\"[\" ++ json(path) ++ \",\" ++ json(file_type) ++ \",\" ++ json(executable) ++ \"]\\n\"',
...@@ -53,11 +62,6 @@ def export_revision(source, commit, paths, destination, excluded=frozenset()):...@@ -53,11 +62,6 @@ def export_revision(source, commit, paths, destination, excluded=frozenset()):
53 for entry in entries:62 for entry in entries:
54 name, kind, executable = json.loads(entry)63 name, kind, executable = json.loads(entry)
55 relative = Path(name)64 relative = Path(name)
56 if relative.parts[:1] == ("service",) and (
57 set(relative.parts[1:]) & excluded or
58 relative.suffix == ".pkl" and relative.stem in excluded
59 ):
60 continue
61 if kind != "file" or relative.is_absolute() or ".." in relative.parts:65 if kind != "file" or relative.is_absolute() or ".." in relative.parts:
62 raise ValueError(f"unsupported revision file: {name}")66 raise ValueError(f"unsupported revision file: {name}")
63 target = destination / relative67 target = destination / relative
...@@ -70,7 +74,6 @@ def export_revision(source, commit, paths, destination, excluded=frozenset()):...@@ -70,7 +74,6 @@ def export_revision(source, commit, paths, destination, excluded=frozenset()):
7074
7175
72def upload(main=False):76def upload(main=False):
73 excluded = set() if main else excluded_services(REPO)
74 with tempfile.TemporaryDirectory() as temporary:77 with tempfile.TemporaryDirectory() as temporary:
75 snapshot = Path(temporary)78 snapshot = Path(temporary)
76 revision = None79 revision = None
...@@ -84,23 +87,13 @@ def upload(main=False):...@@ -84,23 +87,13 @@ def upload(main=False):
84 if conflicted or not description.strip():87 if conflicted or not description.strip():
85 raise ValueError("main needs a commit description and no conflicts before deployment")88 raise ValueError("main needs a commit description and no conflicts before deployment")
86 revision = {"commit": commit, "description": description}89 revision = {"commit": commit, "description": description}
87 # Production must use main's exclusions too. A working staging90 export_revision(REPO, commit, SOURCES, snapshot)
88 # change must not remove dependencies from the committed release.
89 excluded = set(json.loads(subprocess.run(
90 ["jj", "--ignore-working-copy", "file", "show", "-r", commit,
91 "config/excluded-services.json"],
92 cwd=REPO, check=True, capture_output=True, text=True,
93 ).stdout))
94 export_revision(REPO, commit, SOURCES, snapshot, excluded)
95 else:91 else:
96 subprocess.run(92 subprocess.run(
97 ["rsync", "-a", "--exclude=.DS_Store", "--exclude=__pycache__", "--exclude=*.pyc",93 ["rsync", "-a", "--exclude=.DS_Store", "--exclude=__pycache__", "--exclude=*.pyc",
98 "--exclude=.identities.lock", "--exclude=identities.pending", "--exclude=._*",94 "--exclude=.identities.lock", "--exclude=identities.pending", "--exclude=._*",
99 "--exclude=dashboard/node_modules", "--exclude=dashboard/dist",95 "--exclude=dashboard/node_modules", "--exclude=dashboard/dist",
100 "--exclude=dashboard/.cache", "--exclude=dashboard/data", "--exclude=dashboard/target",96 "--exclude=dashboard/.cache", "--exclude=dashboard/data", "--exclude=dashboard/target",
101 *(f"--exclude=/service/{name}/" for name in sorted(excluded)),
102 *(f"--exclude=/service/*/{name}.pkl" for name in sorted(excluded)),
103 *(f"--exclude=/service/*/{name}/" for name in sorted(excluded)),
104 *(str(REPO / path) for path in SOURCES),97 *(str(REPO / path) for path in SOURCES),
105 str(snapshot) + "/"], check=True,98 str(snapshot) + "/"], check=True,
106 )99 )
...@@ -156,21 +149,21 @@ def upload(main=False):...@@ -156,21 +149,21 @@ def upload(main=False):
156 details = {"id": release, "digest": digest, "version": 2}149 details = {"id": release, "digest": digest, "version": 2}
157 if revision:150 if revision:
158 details["main"] = revision151 details["main"] = revision
159 (snapshot / ".studio-release.json").write_text(json.dumps(details) + "\n")152 (snapshot / ".snowglobe-release.json").write_text(json.dumps(details) + "\n")
160 if subprocess.run(153 if subprocess.run(
161 ["ssh", "-p", PORT, "-o", "BatchMode=yes", HOST, f"test -d {remote_release}"],154 ["ssh", "-p", PORT, "-o", "BatchMode=yes", HOST, f"test -d {remote_release}"],
162 check=False,155 check=False,
163 ).returncode == 0:156 ).returncode == 0:
164 ssh(f"python3 {remote_release}/tools/release.py verify {release}")157 ssh(f"python3 {remote_release}/tools/release.py verify {release}")
165 if revision:158 if revision:
166 script = "import pathlib,sys; p=pathlib.Path(" + repr(str(remote_release / ".studio-release.json")) + "); t=p.with_suffix('.pending'); t.write_text(sys.stdin.read()); t.chmod(0o444); t.replace(p)"159 script = "import pathlib,sys; p=pathlib.Path(" + repr(str(remote_release / ".snowglobe-release.json")) + "); t=p.with_suffix('.pending'); t.write_text(sys.stdin.read()); t.chmod(0o444); t.replace(p)"
167 subprocess.run(["ssh", "-p", PORT, "-o", "BatchMode=yes", HOST,160 subprocess.run(["ssh", "-p", PORT, "-o", "BatchMode=yes", HOST,
168 "python3 -c " + shlex.quote(script)], input=json.dumps(details) + "\n", text=True, check=True)161 "python3 -c " + shlex.quote(script)], input=json.dumps(details) + "\n", text=True, check=True)
169 return release162 return release
170 ssh(f"mkdir -p {remote_release}")163 ssh(f"mkdir -p {remote_release}")
171 subprocess.run(164 subprocess.run(
172 ["rsync", "-a", "-e", f"ssh -p {PORT} -o BatchMode=yes",165 ["rsync", "-a", "-e", f"ssh -p {PORT} -o BatchMode=yes",
173 *(str(snapshot / path) for path in SOURCES), str(snapshot / ".studio-release.json"),166 *(str(snapshot / path) for path in SOURCES), str(snapshot / ".snowglobe-release.json"),
174 f"{HOST}:{remote_release}/"], check=True,167 f"{HOST}:{remote_release}/"], check=True,
175 )168 )
176 ssh(f"chmod -R a-w {remote_release}")169 ssh(f"chmod -R a-w {remote_release}")
...@@ -215,29 +208,30 @@ def main():...@@ -215,29 +208,30 @@ def main():
215 values = args.file.read_text()208 values = args.file.read_text()
216 if not values.strip():209 if not values.strip():
217 raise ValueError("secret input is empty")210 raise ValueError("secret input is empty")
211 prepare_remote()
218 manager = f"python3 {REMOTE}/release.py"212 manager = f"python3 {REMOTE}/release.py"
219 if args.mode == "stage":213 if args.mode == "stage":
220 release = upload()214 release = upload()
221 overrides = "".join(f" --env {shlex.quote(value)}" for value in args.env)215 overrides = "".join(f" --env {shlex.quote(value)}" for value in args.env)
222 run_logged("stage", args.target, f"python3 {REMOTE}/releases/{release}/tools/studio.py stage {args.target}{overrides}")216 run_logged("stage", args.target, f"python3 {REMOTE}/releases/{release}/tools/snowglobe.py stage {args.target}{overrides}")
223 elif args.mode == "secrets":217 elif args.mode == "secrets":
224 release = upload()218 release = upload()
225 keys = "".join(f" --key {shlex.quote(key)}" for key in args.key)219 keys = "".join(f" --key {shlex.quote(key)}" for key in args.key)
226 subprocess.run(220 subprocess.run(
227 ["ssh", "-p", PORT, "-o", "BatchMode=yes", HOST,221 ["ssh", "-p", PORT, "-o", "BatchMode=yes", HOST,
228 f"python3 {REMOTE}/releases/{release}/tools/studio.py secrets {args.target}{keys}"],222 f"python3 {REMOTE}/releases/{release}/tools/snowglobe.py secrets {args.target}{keys}"],
229 input=values, text=True, check=True,223 input=values, text=True, check=True,
230 )224 )
231 elif args.mode == "bootstrap":225 elif args.mode == "bootstrap":
232 release = upload(main=True)226 release = upload(main=True)
233 sync_manager(release)227 sync_manager(release)
234 ssh(f"{manager} publish {release}")228 ssh(f"{manager} publish {release}")
235 ssh(f"python3 {REMOTE}/releases/{release}/tools/studio.py pool")229 ssh(f"python3 {REMOTE}/releases/{release}/tools/snowglobe.py pool")
236 ssh(f"python3 {REMOTE}/releases/{release}/tools/studio.py bootstrap")230 ssh(f"python3 {REMOTE}/releases/{release}/tools/snowglobe.py bootstrap")
237 ssh(f"python3 {REMOTE}/releases/{release}/tools/release.py bootstrap {release}")231 ssh(f"python3 {REMOTE}/releases/{release}/tools/release.py bootstrap {release}")
238 elif args.mode == "allocate":232 elif args.mode == "allocate":
239 release = upload()233 release = upload()
240 ssh(f"python3 {REMOTE}/releases/{release}/tools/studio.py allocate {args.target}")234 ssh(f"python3 {REMOTE}/releases/{release}/tools/snowglobe.py allocate {args.target}")
241 elif args.mode in {"publish", "prod"}:235 elif args.mode in {"publish", "prod"}:
242 release = upload(main=True)236 release = upload(main=True)
243 sync_manager(release)237 sync_manager(release)
...@@ -255,11 +249,8 @@ def main():...@@ -255,11 +249,8 @@ def main():
255 release = upload()249 release = upload()
256 run_logged("data-restore", args.target, f"python3 {REMOTE}/releases/{release}/tools/data.py restore {args.backup} {args.target} --discard-writes")250 run_logged("data-restore", args.target, f"python3 {REMOTE}/releases/{release}/tools/data.py restore {args.backup} {args.target} --discard-writes")
257 else:251 else:
258 metadata = json.loads(ssh(f"cat /var/lib/studio/stages/{args.target}.json", capture=True).stdout)252 release = upload()
259 release = metadata.get("release")253 run_logged("destroy", args.target, f"python3 {REMOTE}/releases/{release}/tools/release.py stage-destroy {args.target}")
260 if not isinstance(release, str) or not RELEASE_ID.fullmatch(release):
261 raise ValueError("stage has no successful release; inspect it before removal")
262 run_logged("destroy", args.target, f"python3 {REMOTE}/releases/{release}/tools/studio.py destroy {args.target}")
263254
264255
265if __name__ == "__main__":256if __name__ == "__main__":
tools/evil-forgejo-migration.md deleted-27
...@@ -1,27 +0,0 @@
1# evil.inc Forgejo cutover
2
3Zenith's Forgejo database is 21 MB; its app directory is about 14 GB. The VM Forgejo has the same usernames for all seven numeric user IDs referenced by the imported HedgeDoc OAuth profiles. This checks identity continuity without inspecting private repository contents. The app directory must move with the database because it holds Git objects, LFS data, attachments, avatars, and indexes.
4
5Snow Globe generates a new automation account password, but the imported Forgejo database needs the old signing and security keys. The named secret import preserves Snow Globe's automation password while replacing only the legacy values. With `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT` pointing at the production host, run:
6
7```sh
8bash tools/import-legacy-secrets.sh evil-forgejo \
9 mailer_address=MAILER_ADDRESS \
10 mailer_username=MAILER_USERNAME \
11 mailer_password=MAILER_PASSWORD \
12 lfs_jwt=EVIL_FORGEJO_SERVER_LFS_JWT_SECRET \
13 oauth_jwt=EVIL_FORGEJO_OAUTH2_JWT_SECRET \
14 security_key=EVIL_FORGEJO_SECURITY_SECRET_KEY \
15 internal_token=EVIL_FORGEJO_SECURITY_INTERNAL_TOKEN \
16 anubis_key=ANUBIS_PRIVATE_KEY
17```
18
19The source `.env` contains one unquoted value for each named key. The importer streams them through stdin and checks the destination field names against the service definition. Stop the old Forgejo and HedgeDoc before the final database and app-directory copy, and keep both stopped until the new Forgejo and HedgeDoc identities are checked. Do not switch the public route before the repository data and database have been restored together.
20
21For a same-machine OS replacement, use the [legacy PostgreSQL handoff](legacy-handoff.md) before reboot. After the encrypted apps dataset is mounted on NixOS, import the original Forgejo secrets with `STUDIO_LEGACY_HANDOFF` set, stop the Snow Globe Forgejo job, then run `bash tools/import-evil-forgejo.sh`. It checks the retained database dump and secret fingerprints, copies `/mnt/storage1/apps/evil-infra/forgejo` directly into the managed service dataset, compares a content digest without exposing file contents, restores the database, and checks user/repository counts. It keeps the new job stopped and prints the pre-import ZFS snapshot and database dump for recovery. The 14 GB production copy has not run on the VM.
22
23A read-only Zenith `pg_dump` restored into a disposable VM PostgreSQL database on 2026-09-26. The source and restored database both had 10 users and 15 repositories; the disposable database was removed afterward. No repository contents were opened or copied. This verifies the logical database restore separately from the 14 GB file transfer.
24
25A disposable VM fixture also passed the importer's `rsync -aH --numeric-ids --one-file-system --delete` copy and `tree-hash.py` comparison, including a hardlink, symlink, owner, group, and mode. The production 14 GB transfer remains untested.
26
27After a database import, Snow Globe's saved HedgeDoc OAuth application ID may point to a different legacy client. The provider now checks the client ID before updating an application and creates a fresh OAuth client when the saved one is missing or belongs to another client. A VM probe used a real ID collision: the unrelated client remained unchanged, the replacement client was created, and the temporary replacement was deleted after the check.
tools/export-legacy-postgres.sh deleted-80
...@@ -1,80 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
5root=/mnt/storage1/apps/studio-handoff
6id=$(date -u +%Y%m%dT%H%M%SZ)-$(python3 -c 'import secrets; print(secrets.token_hex(3))')
7pending=$root/.pending-$id
8final=$root/$id
9
10ssh "$source_host" 'test "$(findmnt -n -o SOURCE --mountpoint /mnt/storage1/apps)" = storage1/apps; test "$(findmnt -n -o FSTYPE --mountpoint /mnt/storage1/apps)" = zfs'
11ssh "$source_host" 'sudo -n docker info >/dev/null'
12
13check_stopped() {
14 [[ $(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' evil-forgejo") == false ]] || {
15 echo 'Stop Zenith evil-forgejo before exporting the final database' >&2
16 exit 1
17 }
18 [[ $(ssh "$source_host" "sudo -n docker ps -a --filter label=com.docker.compose.service=evil-hedgedoc --format '{{.State}}'") == exited ]] || {
19 echo 'Stop Zenith evil-hedgedoc before exporting the final databases' >&2
20 exit 1
21 }
22}
23
24check_stopped
25ssh "$source_host" 'sudo -n docker exec postgres pg_isready -U postgres >/dev/null'
26ssh "$source_host" 'test -r /mnt/storage1/apps/home-infra/.env'
27ssh "$source_host" "set -e; test ! -e '$final'; mkdir -m 700 -p '$root'; mkdir -m 700 '$pending'"
28for database in evil-forgejo evil-hedgedoc; do
29 ssh "$source_host" "set -e; umask 077; sudo -n docker exec postgres pg_dump -U postgres -Fc --no-owner --no-acl '$database' > '$pending/$database.dump'; test -s '$pending/$database.dump'; sudo -n docker exec -i postgres pg_restore -l < '$pending/$database.dump' >/dev/null"
30done
31check_stopped
32ssh "$source_host" python3 - "$pending" "$id" <<'PY'
33import hashlib
34import json
35from pathlib import Path
36import subprocess
37import sys
38
39folder = Path(sys.argv[1])
40manifest = {"id": sys.argv[2], "databases": {}}
41queries = {
42 "evil-forgejo": 'SELECT (SELECT count(*) FROM "user"), (SELECT count(*) FROM repository)',
43 "evil-hedgedoc": 'SELECT (SELECT count(*) FROM "Notes"), (SELECT count(*) FROM "Users"), (SELECT count(*) FROM "Revisions"), (SELECT count(*) FROM "Authors")',
44}
45for name in ("evil-forgejo", "evil-hedgedoc"):
46 source = folder / f"{name}.dump"
47 digest = hashlib.sha256()
48 with source.open("rb") as file:
49 for chunk in iter(lambda: file.read(1024 * 1024), b""):
50 digest.update(chunk)
51 result = subprocess.run(["sudo", "-n", "docker", "exec", "postgres", "psql", "-U", "postgres", "-d", name,
52 "-At", "-c", queries[name]], check=True, capture_output=True, text=True)
53 counts = [int(value) for value in result.stdout.strip().split("|")]
54 if len(counts) != (4 if name == "evil-hedgedoc" else 2):
55 raise ValueError(f"Unexpected count result for {name}")
56 manifest["databases"][name] = {"file": source.name, "bytes": source.stat().st_size,
57 "sha256": digest.hexdigest(), "counts": counts}
58legacy_env = (Path("/mnt/storage1/apps/home-infra/.env")).read_text().splitlines()
59forgejo_secrets = {
60 "lfs_jwt": "EVIL_FORGEJO_SERVER_LFS_JWT_SECRET",
61 "oauth_jwt": "EVIL_FORGEJO_OAUTH2_JWT_SECRET",
62 "security_key": "EVIL_FORGEJO_SECURITY_SECRET_KEY",
63 "internal_token": "EVIL_FORGEJO_SECURITY_INTERNAL_TOKEN",
64 "anubis_key": "ANUBIS_PRIVATE_KEY",
65 "mailer_address": "MAILER_ADDRESS",
66 "mailer_username": "MAILER_USERNAME",
67 "mailer_password": "MAILER_PASSWORD",
68}
69fingerprints = {}
70for target, source in forgejo_secrets.items():
71 values = [line.split("=", 1)[1] for line in legacy_env if line.startswith(source + "=")]
72 if len(values) != 1 or not values[0]:
73 raise ValueError(f"Legacy Forgejo secret is unavailable: {source}")
74 fingerprints[target] = hashlib.sha256(values[0].encode()).hexdigest()
75manifest["databases"]["evil-forgejo"]["secretSha256"] = fingerprints
76(folder / "manifest.json").write_text(json.dumps(manifest, indent=2) + "\n")
77PY
78ssh "$source_host" "set -e; chmod 600 '$pending/manifest.json'; mv '$pending' '$final'; sync"
79check_stopped
80echo "Legacy PostgreSQL handoff: $final"
tools/export-offline-postgres.py deleted-220
...@@ -1,220 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3from contextlib import contextmanager
4from datetime import datetime, timezone
5import hashlib
6import json
7import os
8from pathlib import Path
9import secrets
10import shutil
11import subprocess
12import tempfile
13
14
15def run(command, *, user=None, output=None):
16 result = subprocess.run(command, stdout=output or subprocess.PIPE,
17 stderr=subprocess.PIPE, user=user, group=user,
18 extra_groups=[] if user is not None else None)
19 if result.returncode:
20 with (destination / 'diagnostics.log').open('ab') as log:
21 log.write(result.stderr)
22 raise RuntimeError(f'{Path(command[0]).name} failed; see private diagnostics.log')
23 return result.stdout
24
25
26def sha256(path):
27 digest = hashlib.sha256()
28 with path.open('rb') as source:
29 for block in iter(lambda: source.read(1024 * 1024), b''):
30 digest.update(block)
31 return digest.hexdigest()
32
33
34def tree_hash(path):
35 digest = hashlib.sha256()
36 for entry in sorted(path.rglob('*')):
37 digest.update(str(entry.relative_to(path)).encode() + b'\0')
38 if entry.is_symlink():
39 raise ValueError(f'External cluster link requires separate backup: {entry}')
40 if entry.is_file():
41 digest.update(bytes.fromhex(sha256(entry)))
42 return digest.hexdigest()
43
44
45def identifier(value):
46 return '"' + value.replace('"', '""') + '"'
47
48
49@contextmanager
50def server(runtime, folder, *, source=None):
51 folder.mkdir(mode=0o700)
52 data = folder / 'data'
53 socket = folder / 'socket'
54 socket.mkdir(mode=0o700)
55 os.chown(folder, 65534, 65534)
56 os.chown(socket, 65534, 65534)
57 if source:
58 run(['rsync', '-aH', '--numeric-ids', str(source) + '/', str(data) + '/'])
59 (data / 'postmaster.pid').unlink(missing_ok=True)
60 for entry in [data, *data.rglob('*')]:
61 os.chown(entry, 65534, 65534)
62 else:
63 run([str(runtime / 'bin/initdb'), '-D', str(data), '-U', 'infra2_backup_verifier',
64 '--auth=trust', '--locale=C.UTF-8'], user=65534)
65 config = folder / 'postgresql.conf'
66 config.write_text("listen_addresses = ''\nssl = off\nlogging_collector = off\n"
67 "shared_preload_libraries = ''\n"
68 f"unix_socket_directories = '{socket}'\n"
69 f"hba_file = '{folder / 'pg_hba.conf'}'\n")
70 (folder / 'pg_hba.conf').write_text('local all all trust\n')
71 os.chown(config, 65534, 65534)
72 os.chown(folder / 'pg_hba.conf', 65534, 65534)
73 control = [str(runtime / 'bin/pg_ctl'), '-D', str(data)]
74 try:
75 run(control + ['-l', str(folder / 'server.log'), '-o', f'-c config_file={config}',
76 '-w', 'start'], user=65534)
77 yield socket
78 finally:
79 if (data / 'postmaster.pid').exists():
80 run(control + ['-m', 'fast', '-w', 'stop'], user=65534)
81
82
83def sql(runtime, socket, database, query, *, role='postgres'):
84 return run([str(runtime / 'bin/psql'), '-X', '-h', str(socket), '-U', role,
85 '-d', database, '-v', 'ON_ERROR_STOP=1', '-At', '-c', query])
86
87
88def fingerprint(runtime, socket, database):
89 relations = json.loads(sql(runtime, socket, database, """
90 SELECT coalesce(json_agg(x ORDER BY n, c), '[]') FROM (
91 SELECT n.nspname n, c.relname c, c.relkind k
92 FROM pg_class c JOIN pg_namespace n ON n.oid=c.relnamespace
93 WHERE n.nspname NOT LIKE 'pg_%' AND n.nspname <> 'information_schema'
94 AND c.relkind IN ('r','m','S')
95 ) x
96 """))
97 result = {}
98 for relation in relations:
99 table = identifier(relation['n']) + '.' + identifier(relation['c'])
100 query = (f'SELECT last_value,is_called FROM {table}' if relation['k'] == 'S' else
101 f"COPY (SELECT row_to_json(t)::text FROM {table} t "
102 'ORDER BY row_to_json(t)::text COLLATE "C") TO STDOUT')
103 content = sql(runtime, socket, database, query)
104 result[table] = {'rows': len(content.splitlines()),
105 'sha256': hashlib.sha256(content).hexdigest()}
106 for name, query in {
107 'large_objects': 'COPY (SELECT loid,pageno,encode(data,\'hex\') FROM pg_largeobject ORDER BY loid,pageno) TO STDOUT',
108 'large_object_owners': 'COPY (SELECT oid,pg_get_userbyid(lomowner),lomacl::text FROM pg_largeobject_metadata ORDER BY oid) TO STDOUT',
109 }.items():
110 content = sql(runtime, socket, database, query)
111 result[name] = {'rows': len(content.splitlines()),
112 'sha256': hashlib.sha256(content).hexdigest()}
113 return result
114
115
116parser = argparse.ArgumentParser(description='Export and restore-check stopped PostgreSQL clusters from private copies.')
117parser.add_argument('--cluster', nargs=2, action='append', required=True, metavar=('SOURCE', 'RUNTIME'))
118parser.add_argument('--locale-archive', type=Path, required=True)
119args = parser.parse_args()
120if os.geteuid() != 0:
121 parser.error('Run as root on the installer')
122os.umask(0o077)
123os.environ['LOCALE_ARCHIVE'] = str(args.locale_archive)
124os.environ.pop('PGOPTIONS', None)
125root = Path('/mnt/storage1/apps/studio-handoff')
126mounted = subprocess.check_output(['findmnt', '-n', '-o', 'SOURCE,FSTYPE', '--mountpoint', str(root.parent)], text=True).split()
127if len(mounted) != 2 or mounted[1] != 'zfs' or not mounted[0].endswith('/apps'):
128 parser.error('Expected retained apps dataset mounted at /mnt/storage1/apps')
129if subprocess.run(['pgrep', '-x', 'postgres'], stdout=subprocess.DEVNULL).returncode == 0:
130 parser.error('Stop PostgreSQL before taking an offline copy')
131handoff_id = datetime.now(timezone.utc).strftime('%Y%m%dT%H%M%SZ-') + secrets.token_hex(3)
132root.mkdir(mode=0o700, exist_ok=True)
133destination = root / ('.pending-' + handoff_id)
134destination.mkdir(mode=0o700)
135manifest = {'id': handoff_id, 'clusters': {}, 'databases': {}}
136work = Path(tempfile.mkdtemp(prefix='infra2-pg-export-', dir='/run'))
137os.chown(work, 65534, 65534)
138try:
139 for source_arg, runtime_arg in args.cluster:
140 source, runtime = Path(source_arg).resolve(), Path(runtime_arg).resolve()
141 if not source.is_relative_to(root.parent) or not (source / 'PG_VERSION').is_file():
142 raise ValueError('Source must be a retained cluster inside the apps dataset')
143 major = (source / 'PG_VERSION').read_text().strip()
144 version = run([str(runtime / 'bin/postgres'), '--version']).decode().strip()
145 if version.split()[-1].split('.')[0] != major or major in manifest['clusters']:
146 raise ValueError('Runtime major must match its unique source cluster')
147 before = tree_hash(source)
148 output = destination / ('pg' + major)
149 output.mkdir(mode=0o700)
150 run(['tar', '-C', str(source), '-czf', str(output / 'cluster.tar.gz'), '.'])
151 cluster = {'source': str(source), 'runtime': version, 'sourceSha256': before, 'databases': {}}
152 with server(runtime, work / ('source' + major), source=source) as socket:
153 databases = json.loads(sql(runtime, socket, 'postgres', """
154 SELECT json_agg(x ORDER BY name) FROM (
155 SELECT datname name, datallowconn connect, datistemplate template,
156 pg_get_userbyid(datdba) owner FROM pg_database WHERE datname <> 'template0'
157 ) x
158 """))
159 tablespaces = json.loads(sql(runtime, socket, 'postgres', "SELECT coalesce(json_agg(spcname), '[]') FROM pg_tablespace WHERE spcname NOT IN ('pg_default','pg_global')"))
160 if tablespaces:
161 raise ValueError('Custom tablespaces require an explicit restore layout')
162 with (output / 'globals.sql').open('wb') as file:
163 run([str(runtime / 'bin/pg_dumpall'), '-h', str(socket), '-U', 'postgres', '--globals-only'], output=file)
164 for index, database in enumerate(databases):
165 name = database['name']
166 if not database['connect']:
167 sql(runtime, socket, 'postgres', f'ALTER DATABASE {identifier(name)} ALLOW_CONNECTIONS true')
168 dump = output / f'{index:03d}.dump'
169 with dump.open('wb') as file:
170 run([str(runtime / 'bin/pg_dump'), '-h', str(socket), '-U', 'postgres', '-d', name,
171 '-Fc', '--create'], output=file)
172 entry = {**database, 'file': str(dump.relative_to(destination)), 'bytes': dump.stat().st_size,
173 'sha256': sha256(dump), 'contents': fingerprint(runtime, socket, name)}
174 cluster['databases'][name] = entry
175 if name in {'evil-forgejo', 'evil-hedgedoc'} and major == '18':
176 query = ('SELECT (SELECT count(*) FROM "user"), (SELECT count(*) FROM repository)' if name == 'evil-forgejo' else
177 'SELECT (SELECT count(*) FROM "Notes"), (SELECT count(*) FROM "Users"), (SELECT count(*) FROM "Revisions"), (SELECT count(*) FROM "Authors")')
178 entry['counts'] = [int(n) for n in sql(runtime, socket, name, query).decode().strip().split('|')]
179 if tree_hash(source) != before:
180 raise RuntimeError('Original cluster changed during export; export is not publishable')
181 with server(runtime, work / ('restore' + major)) as socket:
182 bootstrap = 'infra2_backup_verifier'
183 sql(runtime, socket, 'postgres', f'CREATE DATABASE {bootstrap}', role=bootstrap)
184 run([str(runtime / 'bin/psql'), '-X', '-h', str(socket), '-U', bootstrap, '-d', bootstrap,
185 '-v', 'ON_ERROR_STOP=1', '-f', str(output / 'globals.sql')])
186 sql(runtime, socket, bootstrap, 'ALTER DATABASE template1 IS_TEMPLATE false', role=bootstrap)
187 for name, entry in cluster['databases'].items():
188 run([str(runtime / 'bin/pg_restore'), '-h', str(socket), '-U', bootstrap, '-d', bootstrap,
189 '--clean', '--if-exists', '--create', '--exit-on-error', str(destination / entry['file'])])
190 if fingerprint(runtime, socket, name) != entry['contents']:
191 raise RuntimeError(f'Restored data differs: PostgreSQL {major} database {name}')
192 print(f'PostgreSQL {major}: restored and verified {name}', flush=True)
193 cluster['restoreVerified'] = True
194 manifest['clusters'][major] = cluster
195 for name in ('evil-forgejo', 'evil-hedgedoc'):
196 entry = manifest['clusters']['18']['databases'][name]
197 (destination / (name + '.dump')).symlink_to(entry['file'])
198 manifest['databases'][name] = {key: entry[key] for key in ('bytes', 'sha256', 'counts')}
199 manifest['databases'][name]['file'] = name + '.dump'
200 keys = {'lfs_jwt': 'EVIL_FORGEJO_SERVER_LFS_JWT_SECRET', 'oauth_jwt': 'EVIL_FORGEJO_OAUTH2_JWT_SECRET',
201 'security_key': 'EVIL_FORGEJO_SECURITY_SECRET_KEY', 'internal_token': 'EVIL_FORGEJO_SECURITY_INTERNAL_TOKEN',
202 'anubis_key': 'ANUBIS_PRIVATE_KEY', 'mailer_address': 'MAILER_ADDRESS',
203 'mailer_username': 'MAILER_USERNAME', 'mailer_password': 'MAILER_PASSWORD'}
204 legacy_env = (root.parent / 'home-infra/.env').read_text().splitlines()
205 fingerprints = {}
206 for target, key in keys.items():
207 values = [line.split('=', 1)[1] for line in legacy_env if line.startswith(key + '=')]
208 if len(values) != 1 or not values[0]:
209 raise ValueError(f'Legacy secret unavailable: {key}')
210 fingerprints[target] = hashlib.sha256(values[0].encode()).hexdigest()
211 manifest['databases']['evil-forgejo']['secretSha256'] = fingerprints
212 manifest['files'] = {str(path.relative_to(destination)): {'bytes': path.stat().st_size, 'sha256': sha256(path)}
213 for path in destination.rglob('*') if path.is_file() and not path.is_symlink()}
214 (destination / 'manifest.json').write_text(json.dumps(manifest, indent=2) + '\n')
215 final = root / handoff_id
216 destination.rename(final)
217 os.sync()
218 print(f'Verified PostgreSQL handoff: {final}', flush=True)
219finally:
220 shutil.rmtree(work)
tools/guest-channel-test.py+2-2
...@@ -15,13 +15,13 @@ class ChannelTests(unittest.TestCase):...@@ -15,13 +15,13 @@ class ChannelTests(unittest.TestCase):
15 def test_only_the_running_domains_owned_channel_is_opened(self):15 def test_only_the_running_domains_owned_channel_is_opened(self):
16 path = f"/run/libvirt/qemu/channel/9-fixture/{vms.GUEST_CHANNEL}"16 path = f"/run/libvirt/qemu/channel/9-fixture/{vms.GUEST_CHANNEL}"
17 self.assertEqual(self.request(path), {"path": path})17 self.assertEqual(self.request(path), {"path": path})
18 for source, state, channel in [("/run/studio-host/host.sock", "running", None),18 for source, state, channel in [("/run/snowglobe-host/host.sock", "running", None),
19 (path.replace("9-fixture", "8-other"), "running", None),19 (path.replace("9-fixture", "8-other"), "running", None),
20 (path, "paused", None), (path, "running", "org.qemu.guest_agent.0")]:20 (path, "paused", None), (path, "running", "org.qemu.guest_agent.0")]:
21 with self.subTest(source=source, state=state, channel=channel), self.assertRaises(ValueError):21 with self.subTest(source=source, state=state, channel=channel), self.assertRaises(ValueError):
22 self.request(source, state, channel)22 self.request(source, state, channel)
23 with self.assertRaises(ValueError):23 with self.assertRaises(ValueError):
24 vms.validate("guest", {"name": "fixture", "path": "/run/studio-host/host.sock"})24 vms.validate("guest", {"name": "fixture", "path": "/run/snowglobe-host/host.sock"})
25 with self.assertRaises(ValueError):25 with self.assertRaises(ValueError):
26 vms.validate("guest", {"name": "../other"})26 vms.validate("guest", {"name": "../other"})
2727
tools/guest-provider.py+3-3
...@@ -22,8 +22,8 @@ parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.R...@@ -22,8 +22,8 @@ parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.R
22parser.add_argument('provider', choices=['github', 'astheno'])22parser.add_argument('provider', choices=['github', 'astheno'])
23parser.add_argument('--client-id')23parser.add_argument('--client-id')
24parser.add_argument('--disable', action='store_true')24parser.add_argument('--disable', action='store_true')
25parser.add_argument('--host', default=os.environ.get('STUDIO_DEPLOY_HOST', 'root@zenith'))25parser.add_argument('--host', default=os.environ.get('SNOWGLOBE_DEPLOY_HOST', 'root@10.0.0.1'))
26parser.add_argument('--port', default=os.environ.get('STUDIO_DEPLOY_PORT', '22'))26parser.add_argument('--port', default=os.environ.get('SNOWGLOBE_DEPLOY_PORT', '22'))
27args = parser.parse_args()27args = parser.parse_args()
28if not args.disable and not args.client_id:28if not args.disable and not args.client_id:
29 parser.error('--client-id is required unless --disable is used')29 parser.error('--client-id is required unless --disable is used')
...@@ -31,7 +31,7 @@ payload = {'provider': args.provider, 'enabled': not args.disable}...@@ -31,7 +31,7 @@ payload = {'provider': args.provider, 'enabled': not args.disable}
31if not args.disable:31if not args.disable:
32 payload.update(clientId=args.client_id, clientSecret=getpass.getpass('Client secret: '))32 payload.update(clientId=args.client_id, clientSecret=getpass.getpass('Client secret: '))
33result = subprocess.run(['ssh', '-p', args.port, args.host,33result = subprocess.run(['ssh', '-p', args.port, args.host,
34 'podman exec -i studio-dashboard /bin/home-dashboard --guest-provider'],34 'podman exec -i snowglobe-dashboard /bin/home-dashboard --guest-provider'],
35 input=json.dumps(payload), text=True, capture_output=True)35 input=json.dumps(payload), text=True, capture_output=True)
36if result.returncode:36if result.returncode:
37 raise SystemExit('Provider configuration did not complete. Check the dashboard and SSH connection.')37 raise SystemExit('Provider configuration did not complete. Check the dashboard and SSH connection.')
tools/hedgedoc-migration.md deleted-9
...@@ -1,9 +0,0 @@
1# HedgeDoc migration
2
3`bash tools/import-hedgedoc.sh evil-hedgedoc-preview-f6eb07a4` restored Zenith's HedgeDoc database into a disposable stage and copied its uploads. The importer checked the upload copy by checksum, backed up the stage database, compared the restored table counts with Zenith, and restarted the stage. On 2026-09-26 both sides had 39 notes, 8 users, 183 revisions, and 68 authors. The stage returned HTTPS 200; `/auth/oauth2` redirected to the staged Forgejo OAuth client at `git.evil.studio.test` with the stage callback URL. No note bodies or repository contents were inspected.
4
5The seven HedgeDoc OAuth profile IDs all resolve to the same Forgejo usernames on Zenith and the VM when matched by numeric user ID. That checks account continuity for the imported database; an interactive sign-in remains the final identity check.
6
7For production, keep the Forgejo user IDs stable. Stop Zenith's HedgeDoc and the Snow Globe HedgeDoc job, set `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT` for the new host, then run `bash tools/import-hedgedoc.sh evil-hedgedoc`. The importer refuses a running source or destination, verifies the uploads and four table counts, leaves a pre-import destination database dump, and leaves Snow Globe stopped. Promote a tested preview to start the new service, then verify HTTPS and a Forgejo sign-in before switching the public route. The old HedgeDoc data stays in place until cutover is accepted.
8
9For a same-machine OS replacement, use the [legacy PostgreSQL handoff](legacy-handoff.md) and set `STUDIO_LEGACY_HANDOFF` when running the production importer. It verifies the retained dump and reads uploads from the mounted old apps dataset without contacting old Docker.
tools/import-arr.sh deleted-127
...@@ -1,127 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4service=${1:?usage: tools/import-arr.sh sonarr|radarr [preview-id]}
5[[ $service == sonarr || $service == radarr ]] || { echo 'Expected sonarr or radarr' >&2; exit 1; }
6instance=${2:-$service}
7[[ $instance == "$service" || $instance =~ ^${service}-preview-[0-9a-f]{8}$ ]] || { echo 'Expected the service ID or its preview ID' >&2; exit 1; }
8
9source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
10target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
11target_port=${STUDIO_DEPLOY_PORT:-2222}
12remote=(ssh -p "$target_port" "$target_host")
13source_copy_host=$source_host
14source_rsh=ssh
15offline=false
16if [[ -n ${STUDIO_LEGACY_HANDOFF:-} ]]; then
17 [[ $instance == "$service" && -n ${STUDIO_DEPLOY_HOST:-} ]] || {
18 echo 'Offline handoff requires a production ARR service and target' >&2; exit 1;
19 }
20 sh "$(dirname "$0")/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$target_host" "$target_port"
21 source_copy_host=$target_host
22 source_rsh="ssh -p $target_port"
23 offline=true
24fi
25source_ssh() {
26 if [[ $offline == true ]]; then
27 "${remote[@]}" "$@"
28 else
29 ssh "$source_host" "$@"
30 fi
31}
32if [[ $instance == "$service" ]]; then
33 root="/srv/prod/$service"
34 if [[ $offline == false ]]; then
35 source_running=$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' $service")
36 [[ $source_running == false ]] || { echo "Stop Zenith $service before importing production data" >&2; exit 1; }
37 fi
38 response=$("${remote[@]}" "curl -s -w '\n%{http_code}' -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/$service")
39 status=${response##*$'\n'}
40 if [[ $status == 200 ]]; then
41 stopped=$(python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())' <<<"${response%$'\n'*}")
42 [[ $stopped == true ]] || { echo "Stop production $service before importing" >&2; exit 1; }
43 elif [[ $status != 404 ]]; then
44 echo "Could not verify production $service job state: $status" >&2
45 exit 1
46 fi
47else
48 root="/srv/staging/$instance"
49 source_id=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
50 [[ $source_id == "$service" ]] || { echo 'Preview belongs to another service' >&2; exit 1; }
51fi
52dataset=$("${remote[@]}" "findmnt -n -o SOURCE --mountpoint $root")
53[[ $dataset == */prod/"$service" || $dataset == */staging/"$instance" ]] || { echo "Expected a mounted service dataset at $root" >&2; exit 1; }
54
55scratch=$(mktemp -d)
56source_backup=
57cleanup() {
58 rm -rf "$scratch"
59 if [[ -n $source_backup ]]; then
60 source_ssh "rm -f '$source_backup'"
61 fi
62}
63trap cleanup EXIT
64
65source_backup=$(source_ssh "python3 - '/mnt/storage1/apps/$service/$service.db'" <<'PY'
66import os
67import sqlite3
68import sys
69import tempfile
70
71source = sqlite3.connect(f"file:{sys.argv[1]}?mode=ro", uri=True)
72fd, name = tempfile.mkstemp(prefix="studio-arr-", suffix=".db")
73os.close(fd)
74try:
75 target = sqlite3.connect(name)
76 source.backup(target)
77 if target.execute("PRAGMA integrity_check").fetchone()[0] != "ok":
78 raise ValueError("ARR SQLite backup is invalid")
79 target.close()
80 source.close()
81except BaseException:
82 os.unlink(name)
83 raise
84print(name)
85PY
86)
87rsync -a --exclude="/$service.db*" --exclude='/logs.db*' --exclude='/*.pid' --exclude='/logs/' \
88 -e "$source_rsh" "$source_copy_host:/mnt/storage1/apps/$service/" "$scratch/config/"
89if [[ $offline == true ]]; then
90 scp -q -P "$target_port" "$source_copy_host:$source_backup" "$scratch/config/$service.db"
91else
92 scp -q "$source_copy_host:$source_backup" "$scratch/config/$service.db"
93fi
94
95if [[ $instance != "$service" ]]; then
96 "${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
97fi
98for _ in {1..30}; do
99 running=$("${remote[@]}" "curl -s -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/$instance/allocations" |
100 python3 -c 'import json,sys; print(sum(x["ClientStatus"] == "running" for x in json.load(sys.stdin)))')
101 [[ $running == 0 ]] && break
102 sleep 2
103done
104[[ $running == 0 ]] || { echo "$instance still has a running allocation" >&2; exit 1; }
105
106snapshot="$dataset@before-arr-import-$(date +%s)-$$"
107"${remote[@]}" "zfs snapshot $snapshot"
108rsync -a --delete -e "ssh -p $target_port" "$scratch/config/" "$target_host:$root/config/"
109uid=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"$service\"])'")
110"${remote[@]}" "chown -R $uid:$uid $root/config; chmod 750 $root/config; python3 -c 'import sqlite3; c=sqlite3.connect(\"$root/config/$service.db\"); assert c.execute(\"PRAGMA integrity_check\").fetchone()[0] == \"ok\"'"
111local_hash=$(shasum -a 256 "$scratch/config/$service.db" | cut -d ' ' -f 1)
112remote_hash=$("${remote[@]}" "sha256sum $root/config/$service.db" | cut -d ' ' -f 1)
113[[ $local_hash == "$remote_hash" ]] || { echo 'Copied database hash differs from source backup' >&2; exit 1; }
114
115if [[ $instance == "$service" ]]; then
116 if [[ $offline == false ]]; then
117 [[ $(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' $service") == false ]] || {
118 echo "Zenith $service restarted during import; leave the home server stopped" >&2
119 exit 1
120 }
121 fi
122 echo "Imported production $service from Zenith. Previous dataset state: $snapshot"
123else
124 python3 "$(dirname "$0")/deploy.py" stage "$service"
125 "${remote[@]}" "zfs destroy $snapshot"
126 echo "Imported and tested $instance"
127fi
tools/import-dashboard-auth.py deleted-59
...@@ -1,59 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import hashlib
4import json
5import os
6from pathlib import Path
7import subprocess
8
9
10parser = argparse.ArgumentParser(description="Copy Keycloak accounts into a private dashboard import")
11parser.add_argument("--host", required=True)
12parser.add_argument("--output", required=True, type=Path)
13args = parser.parse_args()
14if args.output.exists():
15 parser.error("output already exists")
16
17remote = r'''
18import json, subprocess, urllib.request
19request = urllib.request.Request("http://127.0.0.1:4646/v1/job/postgres/allocations", headers={"X-Nomad-Token":open("/var/lib/studio/nomad.token").read().strip()})
20allocations = [a["ID"] for a in json.load(urllib.request.urlopen(request)) if a["ClientStatus"] == "running" and a["DesiredStatus"] == "run"]
21assert len(allocations) == 1
22containers = [line.split()[0] for line in subprocess.check_output(["podman", "ps", "--format", "{{.ID}} {{.Names}}"], text=True).splitlines() if line.split()[1].endswith(allocations[0])]
23assert len(containers) == 1
24sql = """
25BEGIN TRANSACTION ISOLATION LEVEL REPEATABLE READ READ ONLY;
26SELECT json_build_object(
27 'issuer','https://auth.paperclover.net/realms/master',
28 'rpId','auth.paperclover.net',
29 'roles',(SELECT coalesce(json_agg(json_build_object('id',id,'name',name)), '[]') FROM keycloak_role WHERE realm_id=(SELECT id FROM realm WHERE name='master') AND client_role=false),
30 'users',(SELECT coalesce(json_agg(json_build_object(
31 'id',u.id,'username',u.username,'email',u.email,'firstName',u.first_name,'lastName',u.last_name,
32 'enabled',u.enabled,'emailVerified',u.email_verified,'createdTimestamp',u.created_timestamp,
33 'requiredActions',(SELECT coalesce(json_agg(required_action),'[]') FROM user_required_action WHERE user_id=u.id),
34 'attributes',(SELECT coalesce(json_object_agg(name,vals),'{}') FROM (SELECT name,json_agg(value) AS vals FROM user_attribute WHERE user_id=u.id GROUP BY name)a),
35 'roles',(SELECT coalesce(json_agg(role_id),'[]') FROM user_role_mapping WHERE user_id=u.id),
36 'credentials',(SELECT coalesce(json_agg(json_build_object('id',id,'type',type,'userLabel',user_label,'createdDate',created_date,'credentialData',credential_data::json,'secretData',secret_data::json)),'[]') FROM credential WHERE user_id=u.id)
37 )),'[]') FROM user_entity u WHERE realm_id=(SELECT id FROM realm WHERE name='master'))
38);
39COMMIT;
40"""
41result = subprocess.run(["podman", "exec", "-i", containers[0], "psql", "-U", "postgres", "-d", "keycloak_next", "-tA", "-v", "ON_ERROR_STOP=1"], input=sql, text=True, capture_output=True, check=True)
42print(next(line for line in result.stdout.splitlines() if line.startswith('{')))
43'''
44result = subprocess.run(["ssh", "-o", "BatchMode=yes", args.host, "python3", "-"], input=remote, text=True, capture_output=True, check=True)
45data = json.loads(result.stdout)
46if not data["users"]:
47 raise ValueError("source realm has no accounts")
48content = (json.dumps(data, separators=(",", ":")) + "\n").encode()
49args.output.parent.mkdir(mode=0o700, parents=True, exist_ok=True)
50with os.fdopen(os.open(args.output, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600), "wb") as output:
51 output.write(content)
52 output.flush()
53 os.fsync(output.fileno())
54counts = {}
55for user in data["users"]:
56 for credential in user["credentials"]:
57 kind = credential["type"]
58 counts[kind] = counts.get(kind, 0) + 1
59print(json.dumps({"accounts": len(data["users"]), "credentials": counts, "sha256": hashlib.sha256(content).hexdigest()}))
tools/import-dawarich.sh deleted-73
...@@ -1,73 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4instance=${1:?usage: tools/import-dawarich.sh dawarich-preview-XXXXXXXX}
5[[ $instance =~ ^dawarich-preview-[0-9a-f]{8}$ ]] || {
6 echo 'Expected a Dawarich preview ID' >&2
7 exit 1
8}
9
10source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
11target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
12target_port=${STUDIO_DEPLOY_PORT:-2222}
13remote=(ssh -p "$target_port" "$target_host")
14
15root=/srv/staging/$instance
16source_id=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
17[[ $source_id == dawarich ]] || { echo 'Preview belongs to another service' >&2; exit 1; }
18snapshot=$(ssh "$source_host" '/usr/sbin/zfs list -H -t snapshot -o name -s creation -r storage1/apps | tail -n 1')
19[[ $snapshot == storage1/apps@* ]] || { echo 'No Zenith app snapshot is available' >&2; exit 1; }
20source_root=/mnt/storage1/apps/.zfs/snapshot/${snapshot#*@}/dawarich_storage
21
22dataset=$("${remote[@]}" "findmnt -n -o SOURCE --mountpoint $root")
23[[ $dataset == */staging/$instance ]] || { echo 'Preview dataset is not mounted' >&2; exit 1; }
24
25source_secret=$(ssh "$source_host" "sudo -n docker inspect -f '{{range .Config.Env}}{{println .}}{{end}}' dawarich-app" |
26 python3 -c 'import hashlib,sys; values=[line.split("=",1)[1] for line in sys.stdin.read().splitlines() if line.startswith("SECRET_KEY_BASE=")]; assert len(values)==1; print(hashlib.sha256(values[0].encode()).hexdigest())')
27own=$("${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad var get -out json nomad/jobs/$instance" |
28 python3 -c 'import hashlib,json,sys; print(hashlib.sha256(json.load(sys.stdin)["Items"]["secret_key_base"].encode()).hexdigest())')
29[[ $source_secret == "$own" ]] || { echo 'Dawarich secret differs from Zenith; import the original before restoring data' >&2; exit 1; }
30
31db_json=$("${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad var get -out json nomad/jobs/$instance/inputs/database")
32read -r database owner < <(python3 -c 'import json,sys; d=json.load(sys.stdin)["Items"]; print(d["name"], d["username"])' <<<"$db_json")
33[[ $database =~ ^dawarich_s_[0-9a-f]{8}$ && $owner == svc_$database ]] || { echo 'Unexpected preview database' >&2; exit 1; }
34
35allocation=$("${remote[@]}" 'NOMAD_TOKEN=$(cat /var/lib/studio/nomad.token) nomad job allocs -json postgres' |
36 python3 -c 'import json,sys; ids=[a["ID"] for a in json.load(sys.stdin) if a["ClientStatus"]=="running" and a["DesiredStatus"]=="run"]; assert len(ids)==1; print(ids[0])')
37container=app-$allocation
38podman='podman --url unix:///run/podman/podman.sock'
39scratch=$(mktemp -d)
40trap 'rm -rf "$scratch"' EXIT
41rsync -a "$source_host:$source_root/" "$scratch/"
42drift=$(rsync -rlnc --delete --out-format='%n' "$source_host:$source_root/" "$scratch/")
43[[ -z $drift ]] || { echo 'Zenith storage changed during copy; retry the import' >&2; exit 1; }
44source_counts=$(ssh "$source_host" 'sudo -n docker exec postgres psql -U postgres -d dawarich -At -c "SELECT (SELECT count(*) FROM points), (SELECT count(*) FROM users)"')
45
46"${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
47for _ in {1..30}; do
48 running=$("${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job allocs -json $instance" |
49 python3 -c 'import json,sys; print(sum(a["ClientStatus"]=="running" for a in json.load(sys.stdin)))')
50 [[ $running == 0 ]] && break
51 sleep 2
52done
53[[ $running == 0 ]] || { echo 'Dawarich allocation is still running' >&2; exit 1; }
54
55backup_snapshot=$dataset@before-dawarich-import-$(date +%s)-$$
56"${remote[@]}" "zfs snapshot $backup_snapshot"
57rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/var/app/storage/"
58uid=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"dawarich\"])'")
59"${remote[@]}" "chown -R $uid:$uid $root/var/app/storage"
60drift=$(rsync -rlnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/" "$target_host:$root/var/app/storage/")
61[[ -z $drift ]] || { echo "Storage copy differs from Zenith; restore $backup_snapshot" >&2; exit 1; }
62
63backup=/var/lib/studio/$instance-before-import.dump
64"${remote[@]}" "umask 077; $podman exec $container pg_dump -U postgres -Fc $database > $backup; test -s $backup"
65"${remote[@]}" "$podman exec $container psql -U postgres -d $database -v ON_ERROR_STOP=1 -c 'DROP SCHEMA public CASCADE; CREATE SCHEMA public AUTHORIZATION $owner; CREATE EXTENSION postgis;' >/dev/null"
66ssh "$source_host" 'sudo -n docker exec postgres pg_dump -U postgres -Fc --no-owner --no-acl --exclude-extension=postgis dawarich' |
67 "${remote[@]}" "$podman exec -i $container pg_restore -U postgres -d $database --no-owner --no-acl --role=$owner"
68target_counts=$("${remote[@]}" "$podman exec $container psql -U postgres -d $database -At -c 'SELECT (SELECT count(*) FROM points), (SELECT count(*) FROM users)'")
69[[ $source_counts == "$target_counts" ]] || { echo "Database counts differ from Zenith; restore $backup" >&2; exit 1; }
70
71python3 "$(dirname "$0")/deploy.py" stage dawarich
72"${remote[@]}" "zfs destroy $backup_snapshot"
73echo "Imported $instance from $snapshot. Previous database: $backup"
tools/import-evil-forgejo.sh deleted-77
...@@ -1,77 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4: "${STUDIO_DEPLOY_HOST:?Set STUDIO_DEPLOY_HOST to the production target}"
5: "${STUDIO_LEGACY_HANDOFF:?Set STUDIO_LEGACY_HANDOFF to the offline PostgreSQL handoff}"
6
7target_port=${STUDIO_DEPLOY_PORT:-22}
8remote=(ssh -p "$target_port" "$STUDIO_DEPLOY_HOST")
9sh "$(dirname "$0")/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$STUDIO_DEPLOY_HOST" "$target_port"
10root=/srv/prod/evil-forgejo
11source_dir=/mnt/storage1/apps/evil-infra/forgejo
12database=evil_forgejo
13owner=svc_evil_forgejo
14podman='podman --url unix:///run/podman/podman.sock'
15
16entry=$("${remote[@]}" "python3 - '$STUDIO_LEGACY_HANDOFF' evil-forgejo" < "$(dirname "$0")/verify-legacy-dump.py")
17source_counts=$(python3 -c 'import json,sys; print("|".join(map(str,json.load(sys.stdin)["counts"])))' <<<"$entry")
18"${remote[@]}" "test \$(findmnt -n -o FSTYPE --mountpoint $root) = zfs; test -d $source_dir"
19
20response=$("${remote[@]}" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/evil-forgejo')
21[[ ${response##*$'\n'} == 200 ]] || { echo 'evil.inc Forgejo is unavailable on the home server' >&2; exit 1; }
22stopped=$(python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())' <<<"${response%$'\n'*}")
23[[ $stopped == true ]] || { echo 'Stop evil.inc Forgejo on the home server before importing' >&2; exit 1; }
24for _ in {1..30}; do
25 running=$("${remote[@]}" 'NOMAD_TOKEN=$(cat /var/lib/studio/nomad.token) nomad job allocs -json evil-forgejo' |
26 python3 -c 'import json,sys; print(sum(a["ClientStatus"] == "running" for a in json.load(sys.stdin)))')
27 [[ $running == 0 ]] && break
28 sleep 2
29done
30[[ $running == 0 ]] || { echo 'evil.inc Forgejo did not stop on the home server' >&2; exit 1; }
31
32db_json=$("${remote[@]}" 'NOMAD_TOKEN=$(cat /var/lib/studio/nomad.token) nomad var get -out json nomad/jobs/evil-forgejo/inputs/database')
33read -r actual_database actual_owner < <(python3 -c 'import json,sys; d=json.load(sys.stdin)["Items"]; print(d["name"], d["username"])' <<<"$db_json")
34[[ $actual_database == "$database" && $actual_owner == "$owner" ]] || { echo 'Unexpected evil.inc Forgejo database on the home server' >&2; exit 1; }
35
36"${remote[@]}" "python3 - '$STUDIO_LEGACY_HANDOFF'" <<'PY'
37import hashlib
38import json
39import os
40from pathlib import Path
41import subprocess
42import sys
43
44legacy = json.loads((Path(sys.argv[1]) / "manifest.json").read_text())["databases"]["evil-forgejo"]["secretSha256"]
45environment = {**os.environ, "NOMAD_TOKEN": Path("/var/lib/studio/nomad.token").read_text().strip()}
46result = subprocess.run(["nomad", "var", "get", "-out", "json", "nomad/jobs/evil-forgejo"],
47 check=True, capture_output=True, text=True, env=environment)
48actual = json.loads(result.stdout)["Items"]
49for name, fingerprint in legacy.items():
50 if name not in actual or hashlib.sha256(actual[name].encode()).hexdigest() != fingerprint:
51 raise ValueError(f"Import the original evil.inc Forgejo secret before restoring data: {name}")
52PY
53
54allocation=$("${remote[@]}" 'NOMAD_TOKEN=$(cat /var/lib/studio/nomad.token) nomad job allocs -json postgres' |
55 python3 -c 'import json,sys; ids=[a["ID"] for a in json.load(sys.stdin) if a["ClientStatus"] == "running" and a["DesiredStatus"] == "run"]; assert len(ids) == 1; print(ids[0])')
56container=app-$allocation
57source_manifest=$("${remote[@]}" "python3 - '$source_dir'" < "$(dirname "$0")/tree-hash.py")
58source_bytes=$(python3 -c 'import json,sys; print(json.load(sys.stdin)["bytes"])' <<<"$source_manifest")
59available=$("${remote[@]}" "df -B1 --output=avail $root | tail -n 1")
60(( available > source_bytes )) || { echo 'Too little free space for the evil.inc Forgejo app directory' >&2; exit 1; }
61
62dataset=$("${remote[@]}" "findmnt -n -o SOURCE --mountpoint $root")
63[[ $dataset == */prod/evil-forgejo ]] || { echo 'Unexpected production dataset' >&2; exit 1; }
64snapshot=$dataset@before-evil-forgejo-import-$(date +%s)-$$
65"${remote[@]}" "set -e; zfs snapshot '$snapshot'; mkdir -p '$root/data'; rsync -aH --numeric-ids --one-file-system --delete '$source_dir/' '$root/data/'"
66target_manifest=$("${remote[@]}" "python3 - '$root/data'" < "$(dirname "$0")/tree-hash.py")
67[[ $source_manifest == "$target_manifest" ]] || { echo "Forgejo app-directory copy differs; restore $snapshot" >&2; exit 1; }
68uid=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"evil-forgejo\"])'")
69"${remote[@]}" "chown -R $uid:$uid '$root/data'"
70
71backup=$root/before-import-$(date +%s)-$$.dump
72"${remote[@]}" "umask 077; $podman exec $container pg_dump -U postgres -Fc $database > '$backup'; test -s '$backup'"
73"${remote[@]}" "$podman exec $container psql -U postgres -d $database -v ON_ERROR_STOP=1 -c 'DROP SCHEMA public CASCADE; CREATE SCHEMA public AUTHORIZATION $owner;' >/dev/null"
74"${remote[@]}" "set -o pipefail; cat '$STUDIO_LEGACY_HANDOFF/evil-forgejo.dump' | $podman exec -i $container pg_restore -U postgres -d $database --no-owner --no-acl --role=$owner"
75counts=$("${remote[@]}" "$podman exec $container psql -U postgres -d $database -At -c 'SELECT (SELECT count(*) FROM \"user\"), (SELECT count(*) FROM repository)'")
76[[ $counts == "$source_counts" ]] || { echo "Forgejo database counts differ; restore $backup" >&2; exit 1; }
77echo "Imported evil.inc Forgejo app files and database; verified user/repository counts: $counts. Previous dataset: $snapshot. Previous database: $backup"
tools/import-forgejo-issues.py deleted-512
...@@ -1,512 +0,0 @@
1#!/usr/bin/env python3
2"""Import a verified personal Forgejo export into stopped Shale, without replacing native issues."""
3import argparse
4from collections import Counter, defaultdict
5from datetime import datetime, timezone
6import hashlib
7import grp
8import json
9import os
10from pathlib import Path
11import re
12import shutil
13import sqlite3
14import sys
15import tempfile
16import urllib.request
17from urllib.parse import quote
18
19ALPHABET = '0123456789ABCDEFGHJKMNPQRSTVWXYZ'
20EPOCH = 1577836800 # Shale's ULIDs use 2020-01-01, rather than the Unix epoch.
21CLOSED = ('done', 'not_planned', 'duplicate', 'invalid')
22EVENTS = ['comment', 'reopened', 'closed', 'issue reference', 'commit reference',
23 'comment reference', 'pull request reference', 'label changed', 'milestone changed',
24 'assignee changed', 'title changed', 'branch deleted', 'time tracking started',
25 'time tracking stopped', 'time added', 'time tracking canceled', 'deadline added',
26 'deadline changed', 'deadline removed', 'dependency added', 'dependency removed',
27 'code comment', 'review', 'locked', 'unlocked', 'target branch changed',
28 'time deleted', 'review requested', 'merged', 'pull request updated',
29 'project changed', 'project column changed', 'review dismissed', 'reference changed',
30 'automatic merge scheduled', 'automatic merge canceled', 'pinned', 'unpinned']
31
32
33def timestamp(epoch):
34 return datetime.fromtimestamp(int(epoch), timezone.utc).isoformat(timespec='seconds')
35
36
37def identifier(kind, key, epoch):
38 milliseconds = (int(epoch) - EPOCH) * 1000
39 if not 0 <= milliseconds < 2 ** 48:
40 raise ValueError('Source creation time is outside Shale ULID range')
41 entropy = int.from_bytes(hashlib.sha256(f'personal-forgejo:{kind}:{key}'.encode()).digest()[:10], 'big')
42 value = (milliseconds << 80) | entropy
43 return ''.join(ALPHABET[(value >> (5 * i)) & 31] for i in range(25, -1, -1))
44
45
46def digest(path):
47 return hashlib.sha256(path.read_bytes()).hexdigest()
48
49
50def stopped(job):
51 token = os.environ.get('NOMAD_TOKEN') or Path('/var/lib/studio/nomad.token').read_text().strip()
52 def read(path):
53 request = urllib.request.Request('http://127.0.0.1:4646/v1/' + path,
54 headers={'X-Nomad-Token': token})
55 with urllib.request.urlopen(request, timeout=10) as response:
56 return json.load(response)
57 if not read('job/' + job).get('Stop') or any(
58 item['ClientStatus'] in ('pending', 'running') for item in read('job/' + job + '/allocations')):
59 raise ValueError('Stop the target Shale job and wait for its allocations before importing')
60
61
62def migrate(database, source, attachments, target, evidence, before_commit=lambda: None):
63 db = sqlite3.connect(database)
64 db.row_factory = sqlite3.Row
65 db.execute('PRAGMA foreign_keys=ON')
66 if db.execute('PRAGMA integrity_check').fetchone()[0] != 'ok':
67 raise ValueError('Shale SQLite integrity check failed')
68 source_hash = digest(source)
69 data = json.loads(source.read_text())
70 for field in ['repositories', 'issues', 'comments', 'labels', 'issue_labels', 'authors',
71 'attachments', 'assignees', 'milestones', 'pull_requests', 'history']:
72 if not isinstance(data.get(field), list):
73 raise ValueError(f'Missing source table: {field}')
74 owners = db.execute("SELECT * FROM users WHERE name='clover'").fetchall()
75 if len(owners) != 1 or owners[0]['snowflake'] != '8c909fab-98b0-4472-9171-9606ccebe9d5':
76 raise ValueError('Clover original identity is missing')
77 owner = owners[0]['id']
78 repos = {r['name']: dict(r) for r in db.execute('SELECT * FROM repositories')}
79 sources = {r['id']: r for r in data['repositories']}
80 issue_sources = {r['id']: r for r in data['issues']}
81 if len(issue_sources) != len(data['issues']):
82 raise ValueError('Duplicate source issue IDs')
83 for r in data['repositories']:
84 if r['name'] not in repos or repos[r['name']]['owner'] != owner:
85 raise ValueError(f'Expected imported Clover repository: {r["name"]}')
86 if any(c['issue_id'] not in issue_sources for c in data['comments']):
87 raise ValueError('Orphan source comment')
88 with sqlite3.connect(evidence / 'before.db') as backup:
89 db.backup(backup)
90 originals = {table: [dict(r) for r in db.execute(f'SELECT * FROM {table}')]
91 for table in ['issues', 'issue_actions', 'issue_labels', 'issues__labels', 'users']}
92 db.execute('BEGIN IMMEDIATE')
93 db.execute('CREATE TABLE IF NOT EXISTS studio_forgejo_records('
94 'kind TEXT NOT NULL, source_id TEXT NOT NULL, target_id INTEGER, '
95 'source_json TEXT NOT NULL, PRIMARY KEY(kind,source_id))')
96 previous = db.execute("SELECT source_json FROM studio_forgejo_records WHERE kind='export' AND source_id='personal'").fetchone()
97 if previous and json.loads(previous[0])['sha256'] != source_hash:
98 raise ValueError('A different export was already imported; review the source before merging')
99
100 def saved(kind, key):
101 row = db.execute('SELECT target_id FROM studio_forgejo_records WHERE kind=? AND source_id=?', (kind, str(key))).fetchone()
102 return row[0] if row else None
103
104 def record(kind, key, target_id, row):
105 db.execute('INSERT OR IGNORE INTO studio_forgejo_records VALUES(?,?,?,?)',
106 (kind, str(key), target_id, json.dumps(row, ensure_ascii=False, sort_keys=True)))
107
108 users = {1: owner}
109 names = {r['name'] for r in db.execute('SELECT name FROM users')}
110 actors = {int(r.get('poster_id') or 0) for r in [*data['issues'], *data['comments'], *data['history']]}
111 actors.update(int(r['assignee_id']) for r in data['assignees'])
112 author_source = {r['id']: r for r in data['authors']}
113 for key in sorted(actors - {1}):
114 row = author_source.get(key, {'id': key, 'name': 'forgejo-system' if key == 0 else f'forgejo-user-{key}',
115 'created_unix': min(i['created_unix'] for i in data['issues']),
116 'updated_unix': max(i['updated_unix'] for i in data['issues'])})
117 existing = saved('user', key)
118 if existing is None:
119 name = row['name']
120 if name in names:
121 name = 'forgejo-' + name
122 if name in names:
123 raise ValueError('Historical author name collision')
124 cursor = db.execute('INSERT INTO users(uuid,provider,snowflake,name,joined_on,last_updated) VALUES(?,?,?,?,?,?)',
125 (identifier('user', key, row['created_unix']), 'personal-forgejo.invalid',
126 str(key), name, timestamp(row['created_unix']), timestamp(row['updated_unix'])))
127 existing = cursor.lastrowid
128 names.add(name)
129 record('user', key, existing, row)
130 users[key] = existing
131 record('user', 1, owner, author_source[1])
132
133 external = {'paperclover': owner}
134 external_rows = defaultdict(list)
135 for row in [*data['issues'], *data['comments']]:
136 if row.get('original_author'):
137 external_rows[row['original_author']].append(row)
138 for name, rows in external_rows.items():
139 if name == 'paperclover':
140 continue
141 if not re.fullmatch(r'[A-Za-z0-9_.-]+', name):
142 raise ValueError('Unsupported external author name')
143 key = 'external:' + name
144 existing = saved('user', key)
145 if existing is None:
146 display = name if name not in names else 'github-' + name
147 if display in names:
148 raise ValueError('External author name collision')
149 created = min(row['created_unix'] for row in rows)
150 updated = max(row['updated_unix'] or row['created_unix'] for row in rows)
151 existing = db.execute('INSERT INTO users(uuid,provider,snowflake,name,joined_on,last_updated) VALUES(?,?,?,?,?,?)',
152 (identifier('user', key, created), 'personal-forgejo-external.invalid', name,
153 display, timestamp(created), timestamp(updated))).lastrowid
154 names.add(display)
155 record('user', key, existing, {'original_author': name})
156 external[name] = existing
157
158 def actor(row):
159 return external[row['original_author']] if row.get('original_author') else users[row['poster_id']]
160
161 labels = {}
162 for row in sorted(data['labels'], key=lambda r: r['id']):
163 if row['repo_id'] not in sources:
164 raise ValueError('Label has no source repository')
165 repo = repos[sources[row['repo_id']]['name']]
166 existing = saved('label', row['id'])
167 if existing is None:
168 color = row['color'].lstrip('#')
169 if not re.fullmatch('[0-9a-fA-F]{6}', color):
170 raise ValueError('Invalid source label color')
171 epoch = row['created_unix'] or sources[row['repo_id']]['created_unix']
172 existing = db.execute('INSERT INTO issue_labels(uuid,repo,name,description,color,last_updated) VALUES(?,?,?,?,?,?)',
173 (identifier('label', row['id'], epoch), repo['id'], row['name'], row['description'],
174 '#' + color, timestamp(row['updated_unix'] or epoch))).lastrowid
175 record('label', row['id'], existing, row)
176 labels[row['id']] = existing
177
178 # Preserve incoming numbers when free; collisions go above BOTH namespaces.
179 occupied = defaultdict(set)
180 ceilings = defaultdict(int)
181 for row in db.execute('SELECT repo,number FROM issues'):
182 occupied[row['repo']].add(row['number'])
183 ceilings[row['repo']] = max(ceilings[row['repo']], row['number'])
184 for row in data['issues']:
185 repo = repos[sources[row['repo_id']]['name']]['id']
186 ceilings[repo] = max(ceilings[repo], row['index'])
187 issue_map = {}
188 collisions = []
189 assignees = defaultdict(list)
190 for row in data['assignees']:
191 assignees[row['issue_id']].append(users[row['assignee_id']])
192 planned = []
193 for row in sorted(data['issues'], key=lambda r: (r['repo_id'], r['index'])):
194 repo = repos[sources[row['repo_id']]['name']]
195 existing = saved('issue', row['id'])
196 number = row['index']
197 if existing is None:
198 if number in occupied[repo['id']]:
199 ceilings[repo['id']] += 1
200 number = ceilings[repo['id']]
201 occupied[repo['id']].add(number)
202 else:
203 number = db.execute('SELECT number FROM issues WHERE id=?', (existing,)).fetchone()[0]
204 planned.append((repo, number, existing, row))
205 # Shale allocates the next number from the issue with the highest row ID.
206 for repo, number, existing, row in sorted(planned, key=lambda item: (item[0]['id'], item[1])):
207 if existing is None:
208 existing = db.execute('INSERT INTO issues(uuid,repo,number,author,last_updated,title,status,assignee) VALUES(?,?,?,?,?,?,?,?)',
209 (identifier('issue', row['id'], row['created_unix']), repo['id'], number,
210 actor(row), timestamp(row['updated_unix']), row['name'],
211 'done' if row['is_closed'] else 'todo',
212 assignees[row['id']][0] if len(assignees[row['id']]) == 1 else None)).lastrowid
213 record('issue', row['id'], existing, row)
214 if number != row['index']:
215 collisions.append({'repo': repo['name'], 'forgejo': row['index'], 'shale': number})
216 issue_map[row['id']] = {'id': existing, 'number': number, 'repo': repo['name'],
217 'url': '/' + quote(repo['name'], safe='/') + '/issues/' + str(number)}
218
219 # Preserve attachment authorization by checking the associated Shale issue
220 # before Caddy serves the copied file. No unauthenticated static directory.
221 attachment_map = {}
222 manifest = []
223 for row in data['attachments']:
224 if row['issue_id'] not in issue_map:
225 raise ValueError('An attachment belongs to an unsupported release or missing issue')
226 if row['external_url']:
227 attachment_map[row['uuid']] = row['external_url']
228 record('attachment', row['id'], None, row)
229 continue
230 key = row['uuid']
231 if not re.fullmatch('[0-9a-f-]{36}', key):
232 raise ValueError('Unsafe attachment UUID')
233 source_file = attachments / key[0] / key[1] / key
234 if source_file.is_symlink() or not source_file.is_file() or source_file.stat().st_size != row['size']:
235 raise ValueError('Source attachment missing or size differs')
236 name = Path(row['name']).name
237 if name != row['name'] or not name or any(c in name for c in '\\"\r\n'):
238 raise ValueError('Unsafe attachment filename')
239 destination = target / 'forgejo-attachments' / key / name
240 destination.parent.mkdir(parents=True, exist_ok=True)
241 if destination.exists() and digest(destination) != digest(source_file):
242 raise ValueError('Attachment copy differs')
243 if not destination.exists():
244 shutil.copyfile(source_file, destination)
245 checksum = digest(source_file)
246 if digest(destination) != checksum:
247 raise ValueError('Attachment checksum failed')
248 # Caddy serves these only after Shale authorizes the associated issue.
249 # Keep them unavailable to other local users.
250 caddy_group = grp.getgrnam('caddy').gr_gid
251 for directory in [target / 'forgejo-attachments', destination.parent]:
252 os.chown(directory, 0, caddy_group)
253 directory.chmod(0o750)
254 os.chown(destination, 0, caddy_group)
255 destination.chmod(0o640)
256 path = '/-/forgejo-attachments/' + key + '/' + quote(name, safe='')
257 attachment_map[key] = path
258 manifest.append({'path': path, 'file': key + '/' + name,
259 'issue': issue_map[row['issue_id']]['url'], 'sha256': checksum})
260 record('attachment', row['id'], None, row)
261
262 source_urls = {}
263 for row in data['issues']:
264 repo = sources[row['repo_id']]
265 owner_name = repo['owner_name']
266 for kind in ['issues', 'pulls']:
267 source_urls[f'/{owner_name}/{repo["name"]}/{kind}/{row["index"]}'] = issue_map[row['id']]['url']
268
269 def rewrite(text, repo_id):
270 def attachment(match):
271 key = match.group(1)
272 if key not in attachment_map:
273 raise ValueError('Issue references an attachment absent from the source export')
274 return attachment_map[key]
275 text = re.sub(r'(?:https?://(?:git|forgejo)\.paperclover\.net)?/attachments/([0-9a-f-]{36})', attachment, text)
276 def link(match):
277 return source_urls.get(match.group(1), match.group(0))
278 text = re.sub(r'https?://(?:git|forgejo)\.paperclover\.net(/[^\s)<>]+/(?:issues|pulls)/[0-9]+)', link, text)
279 text = re.sub(r'(?<=\]\()(/[^\s)<>]+/(?:issues|pulls)/[0-9]+)(?=\))', link, text)
280 # Leave code, quoted text, and bare #references untouched; map explicit links only.
281 return text
282
283 def action(kind, key, issue_id, actor, payload, added, updated=None, source_row=None):
284 existing = saved(kind, key)
285 if existing is not None:
286 return existing
287 created = db.execute('INSERT INTO issue_actions(uuid,issue,actor,kind,payload,added_on,last_updated) VALUES(?,?,?,?,?,?,?)',
288 (identifier(kind, key, added), issue_id, actor, kind if kind in ['comment', 'update_status', 'add_label', 'remove_label'] else 'comment',
289 payload, timestamp(added), timestamp(updated or added))).lastrowid
290 record(kind, key, created, source_row or {})
291 return created
292
293 milestone_source = {r['id']: r for r in data['milestones']}
294 pulls = {r['issue_id']: r for r in data['pull_requests']}
295 body_edits = defaultdict(int)
296 for revision in data['history']:
297 if not revision['comment_id'] and not revision['is_first_created']:
298 body_edits[revision['issue_id']] = max(body_edits[revision['issue_id']], revision['edited_unix'])
299 for row in data['issues']:
300 item = issue_map[row['id']]
301 body = rewrite(row['content'], row['repo_id'])
302 metadata = []
303 if item['number'] != row['index']:
304 metadata.append(f'Original Forgejo issue #{row["index"]}.')
305 if row['is_pull']:
306 pr = pulls[row['id']]
307 metadata.append(f'Imported pull request: `{pr["head_branch"]}` → `{pr["base_branch"]}`.' +
308 (f' Merged as `{pr["merged_commit_id"]}`.' if pr['has_merged'] else ''))
309 if row['milestone_id']:
310 metadata.append('Milestone: ' + milestone_source[row['milestone_id']]['name'] + '.')
311 if row['is_locked']:
312 metadata.append('The original discussion was locked.')
313 if len(assignees[row['id']]) > 1:
314 original_assignees = [author_source[a['assignee_id']]['name'] for a in data['assignees'] if a['issue_id'] == row['id']]
315 metadata.append('Original assignees: ' + ', '.join(original_assignees) + '.')
316 if metadata:
317 body += '\n\n---\n\n' + '\n\n'.join(metadata)
318 action('issue-body', row['id'], item['id'], actor(row), body,
319 row['created_unix'], max(row['created_unix'], body_edits[row['id']]), row)
320 # Shale's status-change renderer requires an initial status action.
321 # Forgejo stores initial state on the issue, rather than as a comment.
322 action('update_status', 'initial-' + str(row['id']), item['id'], actor(row),
323 'todo', row['created_unix'])
324
325 for row in sorted(data['comments'], key=lambda r: (r['created_unix'], r['id'])):
326 item = issue_map[row['issue_id']]
327 kind = 'comment'
328 payload = rewrite(row['content'], issue_sources[row['issue_id']]['repo_id'])
329 if row['type'] in [1, 2]:
330 kind, payload = 'update_status', 'todo' if row['type'] == 1 else 'done'
331 elif row['type'] == 7 and row['label_id'] in labels:
332 kind = 'add_label' if row['content'] == '1' else 'remove_label'
333 payload = str(labels[row['label_id']])
334 elif row['type'] != 0:
335 event = EVENTS[row['type']] if row['type'] < len(EVENTS) else f'event {row["type"]}'
336 detail = []
337 for field in ['old_title', 'new_title', 'old_ref', 'new_ref', 'commit_sha', 'commit_id', 'tree_path', 'line']:
338 if row.get(field):
339 detail.append(f'{field}: {row[field]}')
340 for field in ['old_milestone_id', 'milestone_id']:
341 if row.get(field):
342 detail.append(field + ': ' + milestone_source.get(row[field], {}).get('name', str(row[field])))
343 if row.get('dependent_issue_id'):
344 linked = issue_map.get(row['dependent_issue_id'])
345 detail.append('Dependency: ' + (f'[{linked["repo"]}#{linked["number"]}]({linked["url"]})' if linked else str(row['dependent_issue_id'])))
346 if row.get('ref_issue_id') and row['ref_issue_id'] in issue_map:
347 linked = issue_map[row['ref_issue_id']]
348 detail.append(f'[{linked["repo"]}#{linked["number"]}]({linked["url"]})')
349 payload = 'Forgejo: ' + event + '.' + ('\n\n' + '\n\n'.join(detail) if detail else '') + ('\n\n' + payload if payload else '')
350 existing = saved('forgejo-comment', row['id'])
351 if existing is None:
352 # Every original comment/event maps to exactly one Shale action.
353 action_id = action(kind, 'forgejo-' + str(row['id']), item['id'], actor(row), payload,
354 row['created_unix'], row['updated_unix'], row)
355 record('forgejo-comment', row['id'], action_id, row)
356
357 for row in data['issue_labels']:
358 item = issue_map[row['issue_id']]
359 existing = saved('issue-label', row['id'])
360 if existing is None:
361 label = labels[row['label_id']]
362 epoch = issue_sources[row['issue_id']]['updated_unix']
363 existing = db.execute('INSERT INTO issues__labels(uuid,issue,label) VALUES(?,?,?)',
364 (identifier('issue-label', row['id'], epoch), item['id'], label)).lastrowid
365 record('issue-label', row['id'], existing, row)
366
367 for table in ['history', 'milestones', 'pull_requests', 'assignees']:
368 for row in data[table]:
369 record(table, row['id'], None, row)
370 for source_repo in data['repositories']:
371 repo = repos[source_repo['name']]
372 if any(i['repo_id'] == source_repo['id'] for i in data['issues']):
373 db.execute("UPDATE repositories SET access_issues=? WHERE id=? AND access_issues='off'",
374 ('private' if source_repo['is_private'] else 'public', repo['id']))
375 for field in ['access_issues_submit', 'access_issues_comment']:
376 db.execute(f"UPDATE repositories SET {field}='private' WHERE id=? AND {field}='off'", (repo['id'],))
377 slots = ','.join('?' for _ in CLOSED)
378 db.execute(f'UPDATE repositories SET open_issues=(SELECT count(*) FROM issues WHERE repo=repositories.id AND status NOT IN ({slots}))', CLOSED)
379 db.execute(f'UPDATE issue_labels SET open_issues=(SELECT count(*) FROM issues__labels il JOIN issues i ON i.id=il.issue WHERE il.label=issue_labels.id AND i.status NOT IN ({slots}))', CLOSED)
380 for table, rows in originals.items():
381 for row in rows:
382 current = dict(db.execute(f'SELECT * FROM {table} WHERE id=?', (row['id'],)).fetchone())
383 if table == 'issue_labels':
384 current.pop('open_issues');row = {k:v for k,v in row.items() if k != 'open_issues'}
385 if current != row:
386 raise ValueError(f'Existing Shale {table} row changed')
387 if db.execute('PRAGMA foreign_key_check').fetchall():
388 raise ValueError('Imported data has invalid foreign keys')
389 if db.execute('SELECT 1 FROM issues i WHERE i.id=(SELECT max(id) FROM issues WHERE repo=i.repo) '
390 'AND i.number<>(SELECT max(number) FROM issues WHERE repo=i.repo)').fetchone():
391 raise ValueError('Issue row order would reuse a number; repair it before importing')
392 for kind, rows in [('issue', data['issues']), ('forgejo-comment', data['comments']), ('label', data['labels']),
393 ('issue-label', data['issue_labels']), ('attachment', data['attachments']), ('history', data['history'])]:
394 count = db.execute('SELECT count(*) FROM studio_forgejo_records WHERE kind=?', (kind,)).fetchone()[0]
395 if count != len(rows):
396 raise ValueError(f'Incomplete import: {kind}')
397 record('export', 'personal', None, {'sha256': source_hash})
398 before_commit()
399 db.commit()
400 db.close()
401 report = {'source_sha256': source_hash, 'issues': len(data['issues']), 'comments_and_events': len(data['comments']),
402 'labels': len(labels), 'attachments': len(manifest), 'history_revisions': len(data['history']),
403 'number_collisions': collisions, 'issue_mapping': issue_map}
404 (evidence / 'report.json').write_text(json.dumps(report, indent=2) + '\n')
405 (target / 'forgejo-attachments.json').write_text(json.dumps(manifest, indent=2) + '\n')
406 print(json.dumps({k:v for k,v in report.items() if k != 'issue_mapping'}, indent=2))
407
408
409def repair_issue_order(database, evidence, before_commit):
410 with sqlite3.connect(database) as db:
411 db.row_factory = sqlite3.Row
412 db.execute('PRAGMA foreign_keys=ON')
413 with sqlite3.connect(evidence / 'before.db') as backup:
414 db.backup(backup)
415 db.execute('BEGIN IMMEDIATE')
416 db.execute('PRAGMA defer_foreign_keys=ON')
417 if db.execute('PRAGMA integrity_check').fetchone()[0] != 'ok' or db.execute('PRAGMA foreign_key_check').fetchall():
418 raise ValueError('Shale database integrity failed')
419 if db.execute('SELECT 1 FROM issues GROUP BY repo,number HAVING count(*)>1').fetchone():
420 raise ValueError('Duplicate issue numbers require separate review')
421 tables = [r[0] for r in db.execute("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'")]
422 if any(not re.fullmatch('[a-z_]+', table) for table in tables):
423 raise ValueError('Unexpected table name')
424 references = {table: [r['from'] for r in db.execute(f'PRAGMA foreign_key_list({table})') if r['table'] == 'issues'] for table in tables}
425 for table in tables:
426 for column in db.execute(f'PRAGMA table_info({table})'):
427 if re.fullmatch('(.*_)?issue(_id)?', column['name']) and column['name'] not in references[table]:
428 raise ValueError('Undeclared issue reference requires review')
429 imported = {r[0] for r in db.execute("SELECT target_id FROM studio_forgejo_records WHERE kind='issue'")}
430 swaps = {}
431 for repo in db.execute('SELECT DISTINCT repo FROM issues'):
432 newest = db.execute('SELECT id,number FROM issues WHERE repo=? ORDER BY id DESC LIMIT 1', repo).fetchone()
433 highest = db.execute('SELECT id,number FROM issues WHERE repo=? ORDER BY number DESC LIMIT 1', repo).fetchone()
434 if newest['number'] != highest['number']:
435 if newest['id'] not in imported or highest['id'] not in imported:
436 raise ValueError('Repair would change a native issue ID')
437 swaps[newest['id']], swaps[highest['id']] = highest['id'], newest['id']
438
439 def contents():
440 identities = dict(db.execute('SELECT id,uuid FROM issues'))
441 result = {}
442 for table in tables:
443 rows = []
444 for record in db.execute(f'SELECT * FROM {table}'):
445 row = dict(record)
446 if table == 'issues':
447 row['id'] = identities[row['id']] if row['id'] in imported else row['id']
448 for column in references[table]:
449 row[column] = identities[row[column]]
450 if table == 'studio_forgejo_records' and row['kind'] == 'issue':
451 row['target_id'] = identities[row['target_id']]
452 rows.append(tuple(row.items()))
453 result[table] = Counter(rows)
454 return result
455
456 before = contents()
457 for old, new in [*((old, -old) for old in swaps), *((-old, new) for old, new in swaps.items())]:
458 db.execute('UPDATE issues SET id=? WHERE id=?', (new, old))
459 for table, columns in references.items():
460 for column in columns:
461 db.execute(f'UPDATE {table} SET {column}=? WHERE {column}=?', (new, old))
462 db.execute("UPDATE studio_forgejo_records SET target_id=? WHERE kind='issue' AND target_id=?", (new, old))
463 if before != contents() or db.execute('PRAGMA foreign_key_check').fetchall():
464 raise ValueError('Repair changed issue content or references')
465 before_commit()
466 db.commit()
467 report = {'surrogate_id_swaps': swaps, 'all_table_contents_preserved': True}
468 (evidence / 'report.json').write_text(json.dumps(report, indent=2) + '\n')
469 print(json.dumps(report))
470
471
472def main():
473 parser = argparse.ArgumentParser()
474 parser.add_argument('--target', type=Path, required=True)
475 parser.add_argument('--source', type=Path, required=True)
476 parser.add_argument('--proof', type=Path, help='Verified export proof; defaults to source-proof.json beside the source')
477 parser.add_argument('--attachments', type=Path, default=Path('/mnt/storage1/apps/forgejo/work/attachments'))
478 parser.add_argument('--rehearsal', action='store_true')
479 parser.add_argument('--repair-issue-order', action='store_true')
480 args = parser.parse_args()
481 if os.geteuid() != 0:
482 parser.error('Run as root on Zenith')
483 os.umask(0o077)
484 target = args.target.resolve()
485 if 'evil' in str(target).lower() or target.is_relative_to('/mnt/storage1/apps'):
486 parser.error('Use a managed Shale target or isolated copy')
487 if args.rehearsal:
488 if target.is_relative_to('/srv/prod'):
489 parser.error('Rehearsal must use an isolated target')
490 elif target != Path('/srv/prod/shale'):
491 parser.error('Production imports must target /srv/prod/shale')
492 guard = lambda: None
493 if target == Path('/srv/prod/shale'):
494 guard = lambda: stopped('shale')
495 elif target.parent == Path('/srv/staging'):
496 if not re.fullmatch(r'shale-preview-[0-9a-f]{8}', target.name):
497 parser.error('Expected a managed Shale stage')
498 guard = lambda: stopped(target.name)
499 proof = args.proof or args.source.parent / 'source-proof.json'
500 if not proof.is_file() or json.loads(proof.read_text()).get('sourceSha256') != digest(args.source):
501 parser.error('Verified export proof is missing or the source checksum differs')
502 guard()
503 evidence = Path(tempfile.mkdtemp(prefix='issue-import-', dir=str(args.source.parent)))
504 if args.repair_issue_order:
505 repair_issue_order(target / 'data/astheno.shale.db', evidence, guard)
506 else:
507 migrate(target / 'data/astheno.shale.db', args.source, args.attachments, target, evidence, guard)
508 print('Evidence:', evidence)
509
510
511if __name__ == '__main__':
512 main()
tools/import-forgejo-to-shale.py deleted-240
...@@ -1,240 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3from datetime import datetime, timezone
4import hashlib
5import json
6import os
7from pathlib import Path
8import re
9import secrets
10import shutil
11import sqlite3
12import tempfile
13import urllib.error
14import urllib.request
15
16
17SOURCE = Path('/mnt/storage1/apps/forgejo/git/repositories')
18ACCESS = ('access_git_webui', 'access_git_proto', 'access_git_proto_push', 'access_issues',
19 'access_issues_submit', 'access_issues_comment', 'access_readme')
20
21
22def sha256(path):
23 digest = hashlib.sha256()
24 with path.open('rb') as source:
25 for block in iter(lambda: source.read(1024 * 1024), b''):
26 digest.update(block)
27 return digest.hexdigest()
28
29
30def refs(repository):
31 result = {}
32 packed = repository / 'packed-refs'
33 if packed.exists():
34 for line in packed.read_text().splitlines():
35 if line and line[0] not in '#^':
36 value, name = line.split(' ')
37 result[name] = value
38 for path in (repository / 'refs').rglob('*'):
39 if path.is_symlink():
40 raise ValueError('Repository refs contain a link. Resolve it before importing')
41 if path.is_file():
42 result[str(path.relative_to(repository))] = path.read_text().strip()
43 for name, value in result.items():
44 if not name.startswith('refs/') or any(part in ('', '.', '..') for part in name.split('/')):
45 raise ValueError('Repository has an unsafe ref name. Review its retained refs')
46 if not re.fullmatch('[0-9a-f]{40}', value):
47 raise ValueError('Repository has a symbolic or unsupported ref. Resolve it before importing')
48 return result
49
50
51def stopped():
52 token = os.environ.get('NOMAD_TOKEN') or Path('/var/lib/studio/nomad.token').read_text().strip()
53 def read(path):
54 request = urllib.request.Request('http://127.0.0.1:4646/v1/' + path,
55 headers={'X-Nomad-Token': token})
56 with urllib.request.urlopen(request, timeout=10) as response:
57 return json.load(response)
58 try:
59 job = read('job/shale')
60 except urllib.error.HTTPError as error:
61 if error.code == 404:
62 return
63 raise
64 if not job.get('Stop') or any(item['ClientStatus'] in ('pending', 'running')
65 for item in read('job/shale/allocations')):
66 raise ValueError('Stop Shale and wait for its allocations before importing')
67
68
69def main():
70 parser = argparse.ArgumentParser(description='Import retained personal Forgejo histories into stopped Shale.')
71 parser.add_argument('--target', type=Path, required=True, help='Copied Shale service root')
72 parser.add_argument('--metadata', type=Path, required=True, help='Personal Forgejo repository metadata JSON')
73 args = parser.parse_args()
74 if os.geteuid() != 0:
75 parser.error('Run as root on Zenith')
76 os.umask(0o077)
77 target = args.target.resolve()
78 retained = Path('/mnt/storage1/apps')
79 if target.is_relative_to(retained) or retained.is_relative_to(target):
80 raise ValueError('Target overlaps retained app data. Use the managed Shale copy')
81 database = target / 'data/astheno.shale.db'
82 if not database.is_file():
83 raise ValueError('Shale database is missing. Import its retained state first')
84 metadata = json.loads(args.metadata.read_text())
85 required = {'owner_name', 'lower_name', 'name', 'is_private', 'default_branch', 'is_empty', 'is_mirror'}
86 if not isinstance(metadata, list) or any(not isinstance(row, dict) or not required.issubset(row) for row in metadata):
87 raise ValueError('Forgejo metadata is incomplete. Export the documented personal repository fields')
88 if any(not re.fullmatch(r'[A-Za-z0-9_.-]+', row[field]) or row[field] in ('.', '..')
89 for row in metadata for field in ('owner_name', 'lower_name', 'name')):
90 raise ValueError('Repository metadata has unsafe names. Review the personal Forgejo export')
91 indexed = {(row['owner_name'], row['lower_name']): row for row in metadata}
92 if len(indexed) != len(metadata) or any(type(row[field]) is not bool for row in metadata
93 for field in ('is_private', 'is_empty', 'is_mirror')):
94 raise ValueError('Forgejo metadata has duplicate repositories or missing visibility')
95 sources = sorted(SOURCE.glob('*/*.git'))
96 if not sources:
97 raise ValueError('No retained personal Forgejo repositories were found')
98 if any(path.is_file() for path in (SOURCE.parent / 'lfs').rglob('*')):
99 raise ValueError('Forgejo has LFS data. Preserve its serving path before migrating repositories')
100 for source in sources:
101 if source.is_symlink() or (source.parent.name, source.name[:-4]) not in indexed:
102 raise ValueError('A retained repository has no verified metadata. Export its personal Forgejo database entry')
103 if any((source / folder).is_symlink() for folder in ('objects', 'refs')):
104 raise ValueError('Repository storage contains a link. Preserve its contents before importing')
105 if (source / 'shallow').exists() or (source / 'objects/info/alternates').exists():
106 raise ValueError('Repository history depends on external objects. Preserve them before importing')
107 if any((source / 'objects/pack').glob('*.promisor')):
108 raise ValueError('Repository has promised objects. Retrieve the complete history before importing')
109 expected_paths = {(row['owner_name'], row['lower_name']) for row in metadata if not row['is_empty']}
110 if not expected_paths.issubset({(source.parent.name, source.name[:-4]) for source in sources}):
111 raise ValueError('A nonempty Forgejo repository is missing from retained storage')
112 stopped()
113 evidence = Path(tempfile.mkdtemp(prefix='shale-forgejo-import-', dir='/var/lib/studio'))
114 db = sqlite3.connect(database)
115 db.row_factory = sqlite3.Row
116 if db.execute('PRAGMA integrity_check').fetchone()[0] != 'ok':
117 raise ValueError('Shale database failed integrity checking. Recover the retained copy')
118 owners = db.execute("SELECT id FROM users WHERE name='snow'").fetchall()
119 if len(owners) != 1:
120 raise ValueError('Shale needs one existing snow account. Preserve its original identity before importing')
121 owner = owners[0]['id']
122 stat = database.stat()
123 with sqlite3.connect(evidence / 'before.db') as backup:
124 db.backup(backup)
125 existing = {row['name'].casefold(): dict(row) for row in db.execute(
126 'SELECT id,uuid,owner,name,' + ','.join(ACCESS) + ' FROM repositories')}
127 records = []
128 now = datetime.now(timezone.utc).isoformat(timespec='seconds')
129 try:
130 for key, row in indexed.items():
131 name = row['name'] if key[0] == 'clo' else key[0] + '/' + row['name']
132 entry = existing.get(name.casefold())
133 if entry and entry['owner'] != owner:
134 raise ValueError('Repository belongs to another Shale account. Review its ownership before merging')
135 if entry and row['is_private']:
136 for field in ACCESS:
137 db.execute(f"UPDATE repositories SET {field}='private' WHERE id=? AND {field} IN ('public','unlisted')", (entry['id'],))
138 db.commit()
139 db.execute('BEGIN IMMEDIATE')
140 for key, row in sorted(indexed.items()):
141 source = SOURCE / key[0] / (key[1] + '.git')
142 name = row['name'] if key[0] == 'clo' else key[0] + '/' + row['name']
143 entry = existing.get(name.casefold())
144 if entry:
145 directory = target / 'repositories_owned' / entry['uuid']
146 if not directory.is_dir():
147 raise ValueError('An existing Shale repository directory is missing. Recover it before merging')
148 else:
149 alphabet = '0123456789ABCDEFGHJKMNPQRSTVWXYZ'
150 number = secrets.randbits(128)
151 repo_id = ''.join(alphabet[(number >> (5 * position)) & 31] for position in range(25, -1, -1))
152 directory = target / 'repositories_owned' / repo_id
153 directory.mkdir(mode=0o700)
154 os.chown(directory, stat.st_uid, stat.st_gid)
155 for folder in ('objects', 'refs'):
156 (directory / folder).mkdir(mode=0o700)
157 os.chown(directory / folder, stat.st_uid, stat.st_gid)
158 (directory / 'config').write_text('[core]\nrepositoryformatversion = 0\nbare = true\n[http]\nreceivepack = true\n')
159 access = 'private' if row['is_private'] else 'public'
160 cursor = db.execute(
161 'INSERT INTO repositories(uuid,owner,created_on,name,description,' + ','.join(ACCESS) + ',last_updated) '
162 'VALUES(?,?,?,?,?,?,?,?,?,?,?,?,?)',
163 (repo_id, owner, now, name, '', access, access, 'private', 'off', 'off', 'off', access, now))
164 entry = {'id': cursor.lastrowid, 'uuid': repo_id, 'name': name}
165 existing[name.casefold()] = entry
166 previous = refs(directory)
167 original = refs(source) if source.exists() else {}
168 objects = {}
169 for path in sorted((source / 'objects').rglob('*')) if source.exists() else ():
170 if path.is_symlink():
171 raise ValueError('Repository objects contain a link. Preserve its contents before importing')
172 relative = path.relative_to(source / 'objects')
173 if not path.is_file() or relative.parts[0] == 'info':
174 continue
175 checksum = sha256(path)
176 destination = directory / 'objects' / relative
177 destination.parent.mkdir(mode=0o700, parents=True, exist_ok=True)
178 if destination.exists():
179 if sha256(destination) != checksum:
180 raise ValueError('Object files differ under the same name. Keep Shale stopped and review the copies')
181 else:
182 shutil.copyfile(path, destination)
183 os.chmod(destination, 0o600)
184 os.chown(destination, stat.st_uid, stat.st_gid)
185 if sha256(destination) != checksum:
186 raise RuntimeError('Copied objects failed verification. Keep Shale stopped')
187 objects[str(relative)] = checksum
188 mapped = {}
189 combined = dict(previous)
190 for reference, value in original.items():
191 destination = reference
192 if destination in combined and combined[destination] != value:
193 category = 'heads' if reference.startswith('refs/heads/') else 'tags' if reference.startswith('refs/tags/') else None
194 destination = ('refs/' + category + '/forgejo/' + key[0] + '/' + reference.split('/', 2)[2]
195 if category else 'refs/forgejo/' + key[0] + '/' + reference[5:])
196 if destination in combined and combined[destination] != value:
197 destination += '-'+value
198 path = directory / destination
199 path.parent.mkdir(mode=0o700, parents=True, exist_ok=True)
200 path.write_text(value + '\n')
201 os.chown(path, stat.st_uid, stat.st_gid)
202 combined[destination] = value
203 mapped[reference] = destination
204 if not (directory / 'HEAD').exists():
205 desired = 'refs/heads/' + row['default_branch']
206 if original and desired not in original:
207 desired = next((reference for reference in sorted(original) if reference.startswith('refs/heads/')), desired)
208 (directory / 'HEAD').write_text('ref: ' + desired + '\n')
209 os.chown(directory / 'HEAD', stat.st_uid, stat.st_gid)
210 os.chown(directory / 'config', stat.st_uid, stat.st_gid)
211 final = refs(directory)
212 if any(final.get(reference) != value for reference, value in previous.items()) or any(
213 final.get(mapped[reference]) != value for reference, value in original.items()
214 ):
215 raise RuntimeError('Ref verification failed. Keep Shale stopped and review the retained refs')
216 if source.exists() and refs(source) != original:
217 raise RuntimeError('Source refs changed during import. Keep Shale stopped')
218 for parent in (directory / 'objects', directory / 'refs'):
219 for path in parent.rglob('*'):
220 if path.is_dir():
221 os.chown(path, stat.st_uid, stat.st_gid)
222 records.append({'source': '/'.join(key), 'target': entry['name'], 'uuid': entry['uuid'],
223 'private': row['is_private'], 'sourceMirror': row['is_mirror'], 'objects': objects,
224 'originalRefs': original, 'refMapping': mapped, 'previousRefs': previous,
225 'head': (directory / 'HEAD').read_text().strip()})
226 stopped()
227 if db.execute('PRAGMA foreign_key_check').fetchall():
228 raise RuntimeError('Shale database references are invalid. Keep it stopped')
229 db.commit()
230 finally:
231 db.close()
232 (evidence / 'repositories.json').write_text(json.dumps(records, indent=2) + '\n')
233 print(f'Imported and verified {len(records)} personal repositories. Evidence and previous database: {evidence}')
234
235
236if __name__ == '__main__':
237 try:
238 main()
239 except (ValueError, RuntimeError, OSError, sqlite3.Error, urllib.error.HTTPError) as error:
240 raise SystemExit(str(error)) from None
tools/import-hedgedoc.sh deleted-123
...@@ -1,123 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4instance=${1:?usage: tools/import-hedgedoc.sh evil-hedgedoc[-preview-XXXXXXXX]}
5[[ $instance == evil-hedgedoc || $instance =~ ^evil-hedgedoc-preview-[0-9a-f]{8}$ ]] || { echo 'Expected a HedgeDoc service or preview ID' >&2; exit 1; }
6if [[ $instance == evil-hedgedoc ]]; then
7 root=/srv/prod/evil-hedgedoc
8else
9 root="/srv/staging/$instance"
10fi
11
12source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
13target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
14target_port=${STUDIO_DEPLOY_PORT:-2222}
15remote=(ssh -p "$target_port" "$target_host")
16path="nomad/jobs/$instance/inputs/database"
17handoff=${STUDIO_LEGACY_HANDOFF:-}
18if [[ -n $handoff ]]; then
19 [[ $instance == evil-hedgedoc && -n ${STUDIO_DEPLOY_HOST:-} ]] || {
20 echo 'Offline handoff requires production HedgeDoc and a target' >&2
21 exit 1
22 }
23 sh "$(dirname "$0")/check-legacy-handoff.sh" "$handoff" "$target_host" "$target_port"
24 entry=$("${remote[@]}" "python3 - '$handoff' evil-hedgedoc" < "$(dirname "$0")/verify-legacy-dump.py")
25 source_counts=$(python3 -c 'import json,sys; print("|".join(map(str,json.load(sys.stdin)["counts"])))' <<<"$entry")
26 upload_host=$target_host
27 upload_rsh="ssh -p $target_port"
28else
29 upload_host=$source_host
30 upload_rsh=ssh
31fi
32
33if [[ $instance != evil-hedgedoc ]]; then
34 "${remote[@]}" "test -f /var/lib/studio/stages/$instance.json"
35else
36 [[ -n ${STUDIO_DEPLOY_HOST:-} ]] || { echo 'Set STUDIO_DEPLOY_HOST to the production target' >&2; exit 1; }
37 if [[ -z $handoff ]]; then
38 source_state=$(ssh "$source_host" "sudo -n docker ps -a --filter label=com.docker.compose.service=evil-hedgedoc --format '{{.State}}'")
39 [[ $source_state == exited ]] || { echo 'Stop Zenith evil-hedgedoc before importing production data' >&2; exit 1; }
40 fi
41 job_response=$("${remote[@]}" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/evil-hedgedoc')
42 job_status=${job_response##*$'\n'}
43 if [[ $job_status == 200 ]]; then
44 stopped=$(python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())' <<<"${job_response%$'\n'*}")
45 [[ $stopped == true ]] || { echo 'Stop production HedgeDoc before importing' >&2; exit 1; }
46 for _ in {1..30}; do
47 running=$("${remote[@]}" 'curl -s -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/evil-hedgedoc/allocations' | python3 -c 'import json,sys; print(sum(x["ClientStatus"] == "running" for x in json.load(sys.stdin)))')
48 [[ $running == 0 ]] && break
49 sleep 2
50 done
51 [[ $running == 0 ]] || { echo 'Production HedgeDoc allocation did not stop' >&2; exit 1; }
52 elif [[ $job_status != 404 ]]; then
53 echo "Could not verify production job state: $job_status" >&2
54 exit 1
55 fi
56fi
57"${remote[@]}" "test \$(findmnt -n -o FSTYPE --mountpoint $root) = zfs"
58db_json=$("${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad var get -out json $path")
59read -r database owner < <(python3 -c 'import json,sys; d=json.load(sys.stdin)["Items"]; print(d["name"], d["username"])' <<<"$db_json")
60if [[ $instance == evil-hedgedoc ]]; then
61 [[ $database == evil_hedgedoc && $owner == svc_evil_hedgedoc ]] || { echo 'Unexpected production database' >&2; exit 1; }
62else
63 [[ $database =~ ^evil_hedgedoc_s_[0-9a-f]{8}$ && $owner =~ ^svc_evil_hedgedoc_s_[0-9a-f]{8}$ ]] || { echo 'Unexpected preview database' >&2; exit 1; }
64fi
65
66alloc_json=$("${remote[@]}" 'NOMAD_TOKEN=$(cat /var/lib/studio/nomad.token) nomad job allocs -json postgres')
67allocation=$(python3 -c 'import json,sys; ids=[x["ID"] for x in json.load(sys.stdin) if x["ClientStatus"] == "running" and x["DesiredStatus"] == "run"]; assert len(ids) == 1; print(ids[0])' <<<"$alloc_json")
68container="app-$allocation"
69podman='podman --url unix:///run/podman/podman.sock'
70scratch=$(mktemp -d)
71trap 'rm -rf "$scratch"' EXIT
72rsync -a -e "$upload_rsh" "$upload_host:/mnt/storage1/apps/evil-infra/hedgedoc/" "$scratch/uploads/"
73drift=$(rsync -rnc --delete --out-format='%n' -e "$upload_rsh" "$upload_host:/mnt/storage1/apps/evil-infra/hedgedoc/" "$scratch/uploads/")
74[[ -z $drift ]] || { echo 'Source uploads changed during copy' >&2; exit 1; }
75
76if [[ $instance != evil-hedgedoc ]]; then
77 "${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
78 for _ in {1..30}; do
79 running=$("${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job allocs -json $instance" | python3 -c 'import json,sys; print(sum(x["ClientStatus"] == "running" for x in json.load(sys.stdin)))')
80 [[ $running == 0 ]] && break
81 sleep 2
82 done
83 [[ $running == 0 ]] || { echo 'Preview did not stop' >&2; exit 1; }
84fi
85
86uploads="$root/hedgedoc/public/uploads"
87rsync -a --delete -e "ssh -p $target_port" "$scratch/uploads/" "$target_host:$uploads/"
88drift=$(rsync -rnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/uploads/" "$target_host:$uploads/")
89[[ -z $drift ]] || { echo 'Target uploads differ from source copy' >&2; exit 1; }
90uid=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"evil-hedgedoc\"])'")
91"${remote[@]}" "chown -R $uid:$uid $uploads; chmod 750 $uploads"
92
93backup="/var/lib/studio/$instance-before-import.dump"
94"${remote[@]}" "umask 077; $podman exec $container pg_dump -U postgres -Fc $database > $backup; test -s $backup"
95"${remote[@]}" "$podman exec $container psql -U postgres -d $database -v ON_ERROR_STOP=1 -c 'DROP SCHEMA public CASCADE; CREATE SCHEMA public AUTHORIZATION $owner;' >/dev/null"
96
97if [[ -n $handoff ]]; then
98 "${remote[@]}" "set -o pipefail; cat '$handoff/evil-hedgedoc.dump' | $podman exec -i $container pg_restore -U postgres -d $database --no-owner --no-acl --role=$owner"
99else
100 ssh "$source_host" 'sudo -n docker exec postgres pg_dump -U postgres -Fc evil-hedgedoc' |
101 "${remote[@]}" "$podman exec -i $container pg_restore -U postgres -d $database --no-owner --no-acl --role=$owner"
102fi
103
104counts_sql='SELECT (SELECT count(*) FROM "Notes"), (SELECT count(*) FROM "Users"), (SELECT count(*) FROM "Revisions"), (SELECT count(*) FROM "Authors");'
105if [[ -z $handoff ]]; then
106 source_counts=$(printf '%s\n' "$counts_sql" | ssh "$source_host" sudo -n docker exec -i postgres psql -U postgres -d evil-hedgedoc -At)
107fi
108target_counts=$(printf '%s\n' "$counts_sql" | "${remote[@]}" "$podman exec -i $container psql -U postgres -d $database -At")
109[[ $source_counts == "$target_counts" ]] || { echo 'Restored HedgeDoc record counts differ from Zenith' >&2; exit 1; }
110echo "Verified HedgeDoc Notes, Users, Revisions, and Authors counts: $target_counts"
111
112if [[ $instance == evil-hedgedoc ]]; then
113 if [[ -z $handoff ]]; then
114 [[ $(ssh "$source_host" "sudo -n docker ps -a --filter label=com.docker.compose.service=evil-hedgedoc --format '{{.State}}'") == exited ]] || {
115 echo 'Zenith evil-hedgedoc restarted during import; leave the home server stopped' >&2
116 exit 1
117 }
118 fi
119 echo "Production data imported; promote a tested HedgeDoc preview. Previous database: $backup"
120else
121 python3 "$(dirname "$0")/deploy.py" stage evil-hedgedoc
122 echo "Preview database imported; previous preview dump: $backup"
123fi
tools/import-jackett.sh deleted-100
...@@ -1,100 +0,0 @@
1#!/bin/sh
2set -eu
3
4instance=${1:?usage: tools/import-jackett.sh jackett|jackett-preview-XXXXXXXX}
5case $instance in
6 jackett)
7 test -n "${STUDIO_DEPLOY_HOST:-}" || { echo 'Set STUDIO_DEPLOY_HOST to the production target' >&2; exit 1; }
8 production=true
9 ;;
10 jackett-preview-*)
11 printf '%s\n' "$instance" | grep -Eq '^jackett-preview-[0-9a-f]{8}$' || {
12 echo 'Expected a Jackett preview ID' >&2; exit 1;
13 }
14 production=false
15 ;;
16 *) echo 'Expected jackett or its preview ID' >&2; exit 1 ;;
17esac
18
19source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
20target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
21target_port=${STUDIO_DEPLOY_PORT:-2222}
22offline=false
23copy_host=$source_host
24copy_rsh=ssh
25if [ -n "${STUDIO_LEGACY_HANDOFF:-}" ]; then
26 test "$production" = true || { echo 'Offline handoff requires production Jackett' >&2; exit 1; }
27 sh "$(dirname "$0")/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$target_host" "$target_port"
28 offline=true
29 copy_host=$target_host
30 copy_rsh="ssh -p $target_port"
31fi
32if [ "$production" = true ]; then
33 root=/srv/prod/jackett/config/Jackett
34 mount=/srv/prod/jackett
35 source_root=/mnt/storage1/apps/jackett
36 if [ "$offline" = false ]; then
37 test "$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' jackett")" = false || {
38 echo 'Stop Zenith jackett before importing production data' >&2; exit 1;
39 }
40 fi
41 response=$(ssh -p "$target_port" "$target_host" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/jackett')
42 status=$(printf '%s\n' "$response" | tail -n 1)
43 test "$status" = 200 || { echo "Could not verify jackett on the home server: $status" >&2; exit 1; }
44 stopped=$(printf '%s\n' "$response" | sed '$d' | python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())')
45 test "$stopped" = true || { echo 'Stop jackett on the home server before importing production data' >&2; exit 1; }
46else
47 root="/srv/staging/$instance/config/Jackett"
48 mount="/srv/staging/$instance"
49 source_id=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
50 test "$source_id" = jackett || { echo 'Preview belongs to another service' >&2; exit 1; }
51 source_snapshot=$(ssh "$source_host" '/usr/sbin/zfs list -H -t snapshot -o name -s creation -r storage1/apps | tail -n 1')
52 case $source_snapshot in storage1/apps@*) ;; *) echo 'No apps ZFS snapshot is available' >&2; exit 1 ;; esac
53 source_root="/mnt/storage1/apps/.zfs/snapshot/${source_snapshot#*@}/jackett"
54fi
55
56dataset=$(ssh -p "$target_port" "$target_host" "findmnt -n -o SOURCE --mountpoint $mount")
57if [ "$production" = true ]; then
58 case $dataset in */prod/jackett) ;; *) echo 'Production dataset is not mounted' >&2; exit 1 ;; esac
59else
60 case $dataset in */staging/"$instance") ;; *) echo 'Preview dataset is not mounted' >&2; exit 1 ;; esac
61fi
62
63scratch=$(mktemp -d)
64trap 'rm -rf "$scratch"' EXIT
65rsync -a --exclude='/log.txt*' -e "$copy_rsh" "$copy_host:$source_root/" "$scratch/"
66python3 - "$scratch" <<'PY'
67import json
68from pathlib import Path
69import sys
70
71root = Path(sys.argv[1])
72config = json.loads((root / "ServerConfig.json").read_text())
73if not config.get("APIKey") or not list((root / "Indexers").glob("*.json")):
74 raise ValueError("Jackett configuration is incomplete")
75PY
76
77if [ "$production" = false ]; then
78 ssh -p "$target_port" "$target_host" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
79fi
80snapshot="$dataset@before-jackett-import-$(date +%s)-$$"
81ssh -p "$target_port" "$target_host" "set -eu; for i in \$(seq 1 30); do running=\$(curl -fsS -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/$instance/allocations | python3 -c 'import json,sys; print(sum(a[\"ClientStatus\"] == \"running\" for a in json.load(sys.stdin)))'); test \"\$running\" = 0 && break; sleep 2; done; test \"\$running\" = 0; zfs snapshot $snapshot"
82
83rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/"
84owner=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"jackett\"])'")
85ssh -p "$target_port" "$target_host" "chown -R $owner:$owner $root"
86drift=$(rsync -rlnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/" "$target_host:$root/")
87test -z "$drift" || { echo "Jackett copy differs from source; restore $snapshot" >&2; exit 1; }
88
89if [ "$production" = true ]; then
90 if [ "$offline" = false ]; then
91 test "$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' jackett")" = false || {
92 echo 'Zenith jackett restarted during import; leave the home server stopped' >&2; exit 1;
93 }
94 fi
95 echo "Imported production Jackett. Previous dataset state: $snapshot"
96else
97 python3 "$(dirname "$0")/deploy.py" stage jackett
98 ssh -p "$target_port" "$target_host" "zfs destroy $snapshot"
99 echo "Imported and tested $instance from $source_snapshot"
100fi
tools/import-jellyfin.sh deleted-103
...@@ -1,103 +0,0 @@
1#!/bin/sh
2set -eu
3
4instance=${1:?usage: tools/import-jellyfin.sh jellyfin|jellyfin-preview-XXXXXXXX}
5case $instance in
6 jellyfin)
7 test -n "${STUDIO_DEPLOY_HOST:-}" || { echo 'Set STUDIO_DEPLOY_HOST to the production target' >&2; exit 1; }
8 production=true
9 ;;
10 jellyfin-preview-*)
11 printf '%s\n' "$instance" | grep -Eq '^jellyfin-preview-[0-9a-f]{8}$' || {
12 echo 'Expected a Jellyfin preview ID' >&2; exit 1;
13 }
14 production=false
15 ;;
16 *) echo 'Expected jellyfin or its preview ID' >&2; exit 1 ;;
17esac
18
19source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
20target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
21target_port=${STUDIO_DEPLOY_PORT:-2222}
22offline=false
23if [ -n "${STUDIO_LEGACY_HANDOFF:-}" ]; then
24 test "$production" = true || { echo 'Offline handoff requires production Jellyfin' >&2; exit 1; }
25 sh "$(dirname "$0")/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$target_host" "$target_port"
26 offline=true
27fi
28if [ "$production" = true ]; then
29 root=/srv/prod/jellyfin/config
30 mount=/srv/prod/jellyfin
31 source_root=/mnt/storage1/apps/jellyfin
32 if [ "$offline" = false ]; then
33 test "$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' jellyfin")" = false || {
34 echo 'Stop Zenith jellyfin before importing production data' >&2; exit 1;
35 }
36 fi
37 response=$(ssh -p "$target_port" "$target_host" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/jellyfin')
38 status=$(printf '%s\n' "$response" | tail -n 1)
39 test "$status" = 200 || { echo "Could not verify jellyfin on the home server: $status" >&2; exit 1; }
40 stopped=$(printf '%s\n' "$response" | sed '$d' | python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())')
41 test "$stopped" = true || { echo 'Stop jellyfin on the home server before importing production data' >&2; exit 1; }
42 media_fs=$(ssh -p "$target_port" "$target_host" 'findmnt -n -o FSTYPE --mountpoint /srv/clover/Media')
43 test "$media_fs" = zfs || { echo 'Mount the real Media ZFS dataset before importing production data' >&2; exit 1; }
44 source_label=stopped-live-source
45 if [ "$offline" = true ]; then source_label=mounted-old-apps; fi
46else
47 root="/srv/staging/$instance/config"
48 mount="/srv/staging/$instance"
49 source_id=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
50 test "$source_id" = jellyfin || { echo 'Preview belongs to another service' >&2; exit 1; }
51 source_snapshot=$(ssh "$source_host" '/usr/sbin/zfs list -H -t snapshot -o name -s creation -r storage1/apps | tail -n 1')
52 case $source_snapshot in storage1/apps@*) ;; *) echo 'No apps ZFS snapshot is available' >&2; exit 1 ;; esac
53 source_label=${source_snapshot#*@}
54 source_root="/mnt/storage1/apps/.zfs/snapshot/$source_label/jellyfin"
55fi
56
57dataset=$(ssh -p "$target_port" "$target_host" "findmnt -n -o SOURCE --mountpoint $mount")
58if [ "$production" = true ]; then
59 case $dataset in */prod/jellyfin) ;; *) echo 'Production dataset is not mounted' >&2; exit 1 ;; esac
60else
61 case $dataset in */staging/"$instance") ;; *) echo 'Preview dataset is not mounted' >&2; exit 1 ;; esac
62fi
63
64if [ "$offline" = false ]; then
65 scratch=$(mktemp -d)
66 trap 'rm -rf "$scratch"' EXIT
67 rsync -a --exclude='/cache/' --exclude='/log/' --exclude='/transcodes/' --exclude='*-shm' \
68 "$source_host:$source_root/" "$scratch/"
69fi
70
71if [ "$production" = false ]; then
72 ssh -p "$target_port" "$target_host" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
73fi
74snapshot="$dataset@before-jellyfin-import-$(date +%s)-$$"
75ssh -p "$target_port" "$target_host" "set -eu; for i in \$(seq 1 30); do running=\$(curl -fsS -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/$instance/allocations | python3 -c 'import json,sys; print(sum(a[\"ClientStatus\"] == \"running\" for a in json.load(sys.stdin)))'); test \"\$running\" = 0 && break; sleep 2; done; test \"\$running\" = 0; zfs snapshot $snapshot"
76
77if [ "$offline" = true ]; then
78 ssh -p "$target_port" "$target_host" "rsync -a --delete --delete-excluded --exclude='/cache/' --exclude='/log/' --exclude='/transcodes/' --exclude='*-shm' '$source_root/' '$root/'"
79else
80 rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/"
81fi
82owner=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"jellyfin\"])'")
83ssh -p "$target_port" "$target_host" "chown -R $owner:$owner $root"
84if [ "$offline" = true ]; then
85 drift=$(ssh -p "$target_port" "$target_host" "rsync -rlnc --delete --delete-excluded --exclude='/cache/' --exclude='/log/' --exclude='/transcodes/' --exclude='*-shm' --out-format='%n' '$source_root/' '$root/'")
86else
87 drift=$(rsync -rlnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/" "$target_host:$root/")
88fi
89test -z "$drift" || { echo "Jellyfin copy differs from source; restore $snapshot" >&2; exit 1; }
90ssh -p "$target_port" "$target_host" "python3 -c 'import sqlite3; from pathlib import Path; root=Path(\"$root/data\"); assert all((root / name).is_file() and sqlite3.connect(\"file:\" + str(root / name) + \"?mode=ro\", uri=True).execute(\"PRAGMA integrity_check\").fetchone()[0] == \"ok\" for name in (\"jellyfin.db\", \"introskipper/introskipper.db\"))'"
91
92if [ "$production" = true ]; then
93 if [ "$offline" = false ]; then
94 test "$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' jellyfin")" = false || {
95 echo 'Zenith jellyfin restarted during import; leave the home server stopped' >&2; exit 1;
96 }
97 fi
98 echo "Imported production Jellyfin from $source_label. Previous dataset state: $snapshot"
99else
100 python3 "$(dirname "$0")/deploy.py" stage jellyfin
101 ssh -p "$target_port" "$target_host" "zfs destroy $snapshot"
102 echo "Imported and tested $instance from $source_snapshot"
103fi
tools/import-legacy-secrets.sh deleted-54
...@@ -1,54 +0,0 @@
1#!/bin/bash
2set -euo pipefail
3
4service=${1:?usage: tools/import-legacy-secrets.sh SERVICE ENV_NAME...|KEY=ENV_NAME...}
5shift
6(( $# > 0 )) || { echo 'Expected at least one environment variable name' >&2; exit 1; }
7[[ $service =~ ^[a-z][a-z0-9-]*$ ]] || { echo 'Invalid service name' >&2; exit 1; }
8sources=()
9keys=()
10for item in "$@"; do
11 if [[ $item == *=* ]]; then
12 key=${item%%=*}
13 source=${item#*=}
14 [[ $key =~ ^[A-Za-z_][A-Za-z0-9_]*$ ]] || { echo 'Invalid secret key' >&2; exit 1; }
15 keys+=("$key")
16 else
17 source=$item
18 fi
19 [[ $source =~ ^[A-Z][A-Z0-9_]*$ ]] || { echo 'Invalid environment variable name' >&2; exit 1; }
20 sources+=("$source")
21done
22(( ${#keys[@]} == 0 || ${#keys[@]} == ${#sources[@]} )) || { echo 'Use a target key for every source name' >&2; exit 1; }
23options=()
24for key in "${keys[@]}"; do
25 options+=(--key "$key")
26done
27: "${STUDIO_DEPLOY_HOST:?Set STUDIO_DEPLOY_HOST to the production target}"
28
29source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
30repo=$(cd "$(dirname "$0")/.." && pwd)
31names=$(printf ' %s' "${sources[@]}")
32if [[ -n ${STUDIO_LEGACY_HANDOFF:-} ]]; then
33 sh "$repo/tools/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$STUDIO_DEPLOY_HOST" "${STUDIO_DEPLOY_PORT:-22}"
34 source_remote=(ssh -p "${STUDIO_DEPLOY_PORT:-22}" "$STUDIO_DEPLOY_HOST")
35else
36 source_remote=(ssh "$source_host")
37fi
38
39"${source_remote[@]}" "python3 -$names <<'PY'
40from pathlib import Path
41import sys
42
43lines = Path('/mnt/storage1/apps/home-infra/.env').read_text().splitlines()
44if len(set(sys.argv[1:])) != len(sys.argv[1:]):
45 raise SystemExit('Duplicate source secret name')
46secrets = []
47for name in sys.argv[1:]:
48 values = [line.split('=', 1)[1] for line in lines if line.startswith(name + '=')]
49 if len(values) != 1 or not values[0]:
50 raise SystemExit('Expected one nonempty source secret: ' + name)
51 secrets.append(values[0])
52for value in secrets:
53 print(value)
54PY" | python3 "$repo/tools/deploy.py" secrets "$service" --file - "${options[@]}"
tools/import-navidrome.sh deleted-102
...@@ -1,102 +0,0 @@
1#!/bin/sh
2set -eu
3
4instance=${1:?usage: tools/import-navidrome.sh navidrome|navidrome-preview-XXXXXXXX}
5case $instance in
6 navidrome)
7 test -n "${STUDIO_DEPLOY_HOST:-}" || { echo 'Set STUDIO_DEPLOY_HOST to the production target' >&2; exit 1; }
8 production=true
9 ;;
10 navidrome-preview-*)
11 printf '%s\n' "$instance" | grep -Eq '^navidrome-preview-[0-9a-f]{8}$' || {
12 echo 'Expected a Navidrome preview ID' >&2; exit 1;
13 }
14 production=false
15 ;;
16 *) echo 'Expected navidrome or its preview ID' >&2; exit 1 ;;
17esac
18
19source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
20target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
21target_port=${STUDIO_DEPLOY_PORT:-2222}
22offline=false
23if [ -n "${STUDIO_LEGACY_HANDOFF:-}" ]; then
24 test "$production" = true || { echo 'Offline handoff requires production Navidrome' >&2; exit 1; }
25 sh "$(dirname "$0")/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$target_host" "$target_port"
26 offline=true
27fi
28if [ "$production" = true ]; then
29 root=/srv/prod/navidrome/data
30 mount=/srv/prod/navidrome
31 source_root=/mnt/storage1/apps/navidrone
32 if [ "$offline" = false ]; then
33 test "$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' navidrome")" = false || {
34 echo 'Stop Zenith navidrome before importing production data' >&2; exit 1;
35 }
36 fi
37 response=$(ssh -p "$target_port" "$target_host" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/navidrome')
38 status=$(printf '%s\n' "$response" | tail -n 1)
39 test "$status" = 200 || { echo "Could not verify navidrome on the home server: $status" >&2; exit 1; }
40 stopped=$(printf '%s\n' "$response" | sed '$d' | python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())')
41 test "$stopped" = true || { echo 'Stop navidrome on the home server before importing production data' >&2; exit 1; }
42 media_fs=$(ssh -p "$target_port" "$target_host" 'findmnt -n -o FSTYPE --mountpoint /srv/clover/Media')
43 test "$media_fs" = zfs || { echo 'Mount the real Media ZFS dataset before importing production data' >&2; exit 1; }
44else
45 root="/srv/staging/$instance/data"
46 mount="/srv/staging/$instance"
47 source_id=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
48 test "$source_id" = navidrome || { echo 'Preview belongs to another service' >&2; exit 1; }
49 source_snapshot=$(ssh "$source_host" '/usr/sbin/zfs list -H -t snapshot -o name -s creation -r storage1/apps | tail -n 1')
50 case $source_snapshot in storage1/apps@*) ;; *) echo 'No apps ZFS snapshot is available' >&2; exit 1 ;; esac
51 source_root="/mnt/storage1/apps/.zfs/snapshot/${source_snapshot#*@}/navidrone"
52fi
53
54dataset=$(ssh -p "$target_port" "$target_host" "findmnt -n -o SOURCE --mountpoint $mount")
55if [ "$production" = true ]; then
56 case $dataset in */prod/navidrome) ;; *) echo 'Production dataset is not mounted' >&2; exit 1 ;; esac
57else
58 case $dataset in */staging/"$instance") ;; *) echo 'Preview dataset is not mounted' >&2; exit 1 ;; esac
59fi
60
61if [ "$offline" = true ]; then
62 ssh -p "$target_port" "$target_host" "test -s '$source_root/navidrome.db'" || { echo 'Navidrome database is missing' >&2; exit 1; }
63else
64 scratch=$(mktemp -d)
65 trap 'rm -rf "$scratch"' EXIT
66 rsync -a --exclude='*-shm' "$source_host:$source_root/" "$scratch/"
67 test -s "$scratch/navidrome.db" || { echo 'Navidrome database is missing' >&2; exit 1; }
68fi
69
70if [ "$production" = false ]; then
71 ssh -p "$target_port" "$target_host" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
72fi
73snapshot="$dataset@before-navidrome-import-$(date +%s)-$$"
74ssh -p "$target_port" "$target_host" "set -eu; for i in \$(seq 1 30); do running=\$(curl -fsS -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/$instance/allocations | python3 -c 'import json,sys; print(sum(a[\"ClientStatus\"] == \"running\" for a in json.load(sys.stdin)))'); test \"\$running\" = 0 && break; sleep 2; done; test \"\$running\" = 0; zfs snapshot $snapshot"
75
76if [ "$offline" = true ]; then
77 ssh -p "$target_port" "$target_host" "rsync -a --delete --delete-excluded --exclude='*-shm' '$source_root/' '$root/'"
78else
79 rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/"
80fi
81owner=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"navidrome\"])'")
82ssh -p "$target_port" "$target_host" "chown -R $owner:$owner $root"
83if [ "$offline" = true ]; then
84 drift=$(ssh -p "$target_port" "$target_host" "rsync -rlnc --delete --delete-excluded --exclude='*-shm' --out-format='%n' '$source_root/' '$root/'")
85else
86 drift=$(rsync -rlnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/" "$target_host:$root/")
87fi
88test -z "$drift" || { echo "Navidrome copy differs from source; restore $snapshot" >&2; exit 1; }
89ssh -p "$target_port" "$target_host" "python3 -c 'import sqlite3; db=sqlite3.connect(\"file:$root/navidrome.db?mode=ro\", uri=True); assert db.execute(\"PRAGMA integrity_check\").fetchone()[0] == \"ok\"; assert db.execute(\"select count(*) from user where user_name=\\\"snow\\\" and is_admin=1\").fetchone()[0] == 1'"
90
91if [ "$production" = true ]; then
92 if [ "$offline" = false ]; then
93 test "$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' navidrome")" = false || {
94 echo 'Zenith navidrome restarted during import; leave the home server stopped' >&2; exit 1;
95 }
96 fi
97 echo "Imported production Navidrome. Previous dataset state: $snapshot"
98else
99 python3 "$(dirname "$0")/deploy.py" stage navidrome
100 ssh -p "$target_port" "$target_host" "zfs destroy $snapshot"
101 echo "Imported and tested $instance from $source_snapshot"
102fi
tools/import-pds-secrets.py deleted-44
...@@ -1,44 +0,0 @@
1#!/usr/bin/env python3
2import os
3from pathlib import Path
4import re
5import subprocess
6
7
8if not os.environ.get("STUDIO_DEPLOY_HOST"):
9 raise SystemExit("Set STUDIO_DEPLOY_HOST to the production target")
10
11if os.environ.get("STUDIO_LEGACY_HANDOFF"):
12 ssh = ["ssh", "-o", "BatchMode=yes", "-p", os.environ.get("STUDIO_DEPLOY_PORT", "22"), os.environ["STUDIO_DEPLOY_HOST"]]
13else:
14 ssh = ["ssh", "-o", "BatchMode=yes", os.environ.get("STUDIO_MIGRATION_SOURCE", "zenith")]
15
16source = subprocess.run(
17 [*ssh, "cat", "/mnt/storage1/apps/home-infra/.env"],
18 check=True, capture_output=True, text=True,
19).stdout
20names = {
21 "PDS_JWT_SECRET": "jwt_secret",
22 "PDS_ADMIN_PASSWORD": "admin_password",
23 "PDS_PLC_ROTATION_KEY_K256_PRIVATE_KEY_HEX": "plc_rotation_key",
24 "MAILER_ADDRESS": "mailer_address",
25 "MAILER_USERNAME": "mailer_username",
26 "MAILER_PASSWORD": "mailer_password",
27}
28values = {}
29for line in source.splitlines():
30 key, separator, value = line.partition("=")
31 key = key.strip()
32 if separator and key in names:
33 if names[key] in values:
34 raise ValueError(f"duplicate source secret: {key}")
35 values[names[key]] = value.strip()
36if len(values) != len(names) or not all(values.values()):
37 raise ValueError("PDS source secrets are incomplete")
38if not re.fullmatch(r"[0-9a-fA-F]{64}", values["plc_rotation_key"]):
39 raise ValueError("invalid PDS rotation key")
40
41subprocess.run(
42 ["python3", str(Path(__file__).with_name("deploy.py")), "secrets", "pds", "--file", "-"],
43 input="".join(values[name] + "\n" for name in names.values()), text=True, check=True,
44)
tools/import-pds.sh deleted-127
...@@ -1,127 +0,0 @@
1#!/bin/sh
2set -eu
3
4instance=${1:?usage: tools/import-pds.sh pds|pds-preview-XXXXXXXX}
5case $instance in
6 pds)
7 test -n "${STUDIO_DEPLOY_HOST:-}" || { echo 'Set STUDIO_DEPLOY_HOST to the production target' >&2; exit 1; }
8 production=true
9 ;;
10 pds-preview-*)
11 printf '%s\n' "$instance" | grep -Eq '^pds-preview-[0-9a-f]{8}$' || {
12 echo 'Expected a PDS preview ID' >&2; exit 1;
13 }
14 production=false
15 ;;
16 *) echo 'Expected pds or its preview ID' >&2; exit 1 ;;
17esac
18
19source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
20target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
21target_port=${STUDIO_DEPLOY_PORT:-2222}
22offline=false
23copy_host=$source_host
24copy_rsh=ssh
25if [ -n "${STUDIO_LEGACY_HANDOFF:-}" ]; then
26 test "$production" = true || { echo 'Offline handoff requires production PDS' >&2; exit 1; }
27 sh "$(dirname "$0")/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$target_host" "$target_port"
28 offline=true
29 copy_host=$target_host
30 copy_rsh="ssh -p $target_port"
31fi
32source_ssh() {
33 if [ "$offline" = true ]; then
34 ssh -p "$target_port" "$target_host" "$@"
35 else
36 ssh "$source_host" "$@"
37 fi
38}
39if [ "$production" = true ]; then
40 root=/srv/prod/pds/pds
41 mount=/srv/prod/pds
42 if [ "$offline" = false ]; then
43 source_running=$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' pds")
44 test "$source_running" = false || { echo 'Stop Zenith pds before importing production data' >&2; exit 1; }
45 fi
46 response=$(ssh -p "$target_port" "$target_host" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/pds')
47 status=$(printf '%s\n' "$response" | tail -n 1)
48 test "$status" = 200 || { echo "Could not verify pds on the home server: $status" >&2; exit 1; }
49 stopped=$(printf '%s\n' "$response" | sed '$d' | python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())')
50 test "$stopped" = true || { echo 'Stop pds on the home server before importing production data' >&2; exit 1; }
51else
52 root="/srv/staging/$instance/pds"
53 mount="/srv/staging/$instance"
54 source_id=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
55 test "$source_id" = pds || { echo 'Preview belongs to another service' >&2; exit 1; }
56fi
57scratch=$(mktemp -d)
58source_backup=
59cleanup() {
60 rm -rf "$scratch"
61 if [ -n "$source_backup" ]; then
62 source_ssh "rm -rf '$source_backup'"
63 fi
64}
65trap cleanup EXIT
66
67dataset=$(ssh -p "$target_port" "$target_host" "findmnt -n -o SOURCE --mountpoint $mount")
68if [ "$production" = true ]; then
69 case $dataset in */prod/pds) ;; *) echo 'Production dataset is not mounted' >&2; exit 1 ;; esac
70 python3 "$(dirname "$0")/import-pds-secrets.py"
71else
72 case $dataset in */staging/"$instance") ;; *) echo 'Preview dataset is not mounted' >&2; exit 1 ;; esac
73 origin=$(ssh -p "$target_port" "$target_host" "zfs get -H -o value origin $dataset")
74 test "$origin" = - || { echo 'Expected a fresh preview dataset' >&2; exit 1; }
75fi
76snapshot="$dataset@before-pds-import-$(date +%s)-$$"
77
78source_backup=$(source_ssh python3 - <<'PY'
79from pathlib import Path
80import shutil
81import sqlite3
82import tempfile
83
84out = Path(tempfile.mkdtemp(prefix="studio-pds-"))
85try:
86 for name in ("account", "sequencer", "did_cache"):
87 source = sqlite3.connect(f"file:/mnt/storage1/apps/pds/{name}.sqlite?mode=ro", uri=True)
88 target = sqlite3.connect(out / f"{name}.sqlite")
89 source.backup(target)
90 if target.execute("PRAGMA integrity_check").fetchone()[0] != "ok":
91 raise ValueError(f"Invalid PDS SQLite copy: {name}")
92 target.close()
93 source.close()
94except BaseException:
95 shutil.rmtree(out)
96 raise
97print(out)
98PY
99)
100rsync -a -e "$copy_rsh" "$copy_host:$source_backup/" "$scratch/"
101rsync -a --exclude='*.sqlite*' -e "$copy_rsh" "$copy_host:/mnt/storage1/apps/pds/" "$scratch/"
102drift=$(rsync -rnc --delete --exclude='*.sqlite*' --out-format='%n' -e "$copy_rsh" "$copy_host:/mnt/storage1/apps/pds/" "$scratch/")
103test -z "$drift" || { echo 'PDS source changed during copy; retry the import' >&2; exit 1; }
104
105if [ "$production" = false ]; then
106 ssh -p "$target_port" "$target_host" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
107fi
108ssh -p "$target_port" "$target_host" "set -eu; for i in \$(seq 1 30); do running=\$(curl -fsS -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/$instance/allocations | python3 -c 'import json,sys; print(sum(a[\"ClientStatus\"] == \"running\" for a in json.load(sys.stdin)))'); test \"\$running\" = 0 && break; sleep 2; done; test \"\$running\" = 0; zfs snapshot $snapshot"
109
110rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/"
111owner=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"pds\"])'")
112ssh -p "$target_port" "$target_host" "chown -R $owner:$owner $root; python3 -c 'import sqlite3; from pathlib import Path; root=Path(\"$root\"); names=(\"account\",\"sequencer\",\"did_cache\"); assert all((root / (name + \".sqlite\")).is_file() and sqlite3.connect(\"file:\" + str(root / (name + \".sqlite\")) + \"?mode=ro&immutable=1\", uri=True).execute(\"PRAGMA integrity_check\").fetchone()[0] == \"ok\" for name in names)'"
113drift=$(rsync -rnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/" "$target_host:$root/")
114test -z "$drift" || { echo "PDS copy differs from source backup; restore $snapshot" >&2; exit 1; }
115
116if [ "$production" = true ]; then
117 if [ "$offline" = false ]; then
118 test "$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' pds")" = false || {
119 echo 'Zenith pds restarted during import; leave the home server stopped' >&2; exit 1;
120 }
121 fi
122 echo "Imported production PDS from Zenith. Previous dataset state: $snapshot"
123else
124 python3 "$(dirname "$0")/deploy.py" stage pds
125 ssh -p "$target_port" "$target_host" "zfs destroy $snapshot"
126 echo "Imported and tested $instance"
127fi
tools/import-personal-files.py deleted-114
...@@ -1,114 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import json
4import os
5from pathlib import Path
6import sqlite3
7import subprocess
8import time
9import urllib.error
10import urllib.request
11
12
13parser = argparse.ArgumentParser(description="Copy retained app files on the new host before starting the service.")
14parser.add_argument("service", choices=["tailscale", "ddns-updater", "copyparty", "ytdl", "pds"])
15
16
17def main():
18 service = parser.parse_args().service
19 if os.geteuid() != 0:
20 raise SystemExit("Run this importer as root on the production host.")
21 token = Path("/var/lib/studio/nomad.token").read_text().strip()
22 request = urllib.request.Request(
23 "http://127.0.0.1:4646/v1/job/" + service,
24 headers={"X-Nomad-Token": token},
25 )
26 try:
27 with urllib.request.urlopen(request, timeout=10) as response:
28 job = json.load(response)
29 if not job.get("Stop"):
30 raise SystemExit("Stop " + service + " before copying its files.")
31 except urllib.error.HTTPError as error:
32 if error.code != 404:
33 raise
34 request.full_url += "/allocations"
35 try:
36 with urllib.request.urlopen(request, timeout=10) as response:
37 allocations = json.load(response)
38 except urllib.error.HTTPError as error:
39 if error.code != 404:
40 raise
41 allocations = []
42 if any(item["ClientStatus"] not in ("complete", "failed", "lost") for item in allocations):
43 raise SystemExit("Wait for " + service + " allocations to stop before copying its files.")
44
45 root = Path("/srv/prod") / service
46 dataset = subprocess.check_output(["findmnt", "-n", "-o", "SOURCE", "--mountpoint", str(root)], text=True).strip()
47 if dataset != "globe/prod/" + service:
48 raise SystemExit("Mount globe/prod/" + service + " at " + str(root) + " before copying files.")
49 uid = 0 if service == "tailscale" else json.loads(Path("/var/lib/studio/identities.json").read_text())[service]
50 directories = {
51 "tailscale": ("tailscale", "var/lib/tailscale"),
52 "ddns-updater": ("ddns-updater", "updater/data"),
53 "copyparty": ("copyparty/copyparty", "cfg/copyparty"),
54 "ytdl": ("ytdl-sub", "config"),
55 "pds": ("pds", "pds"),
56 }
57 source_name, target_name = directories[service]
58 source = Path("/mnt/storage1/apps") / source_name
59 target = root / target_name
60 if not source.is_dir():
61 raise SystemExit("Retained app files are missing at " + str(source))
62 if service == "tailscale":
63 json.loads((source / "tailscaled.state").read_text())
64 elif service == "ddns-updater":
65 json.loads((source / "updates.json").read_text())
66 elif service == "copyparty":
67 for database in source.glob("*.db"):
68 with sqlite3.connect("file:" + str(database) + "?mode=ro", uri=True) as connection:
69 if connection.execute("PRAGMA integrity_check").fetchone()[0] != "ok":
70 raise SystemExit("Check the retained Copyparty database before copying " + database.name)
71 if not (source / "shares.db").is_file():
72 raise SystemExit("Restore the retained Copyparty shares.db before importing.")
73 elif service == "pds":
74 for name in ("account", "sequencer", "did_cache"):
75 if not (source / (name + ".sqlite")).is_file():
76 raise SystemExit("Restore the retained PDS " + name + " database before importing.")
77 if list(source.rglob("*-wal")) or list(source.rglob("*-shm")):
78 raise SystemExit("Back up all PDS SQLite databases, including actor stores, before importing WAL files.")
79 for database in source.rglob("*.sqlite"):
80 with sqlite3.connect("file:" + str(database) + "?mode=ro&immutable=1", uri=True) as connection:
81 if connection.execute("PRAGMA integrity_check").fetchone()[0] != "ok":
82 raise SystemExit("Check the retained PDS database before importing " + database.name)
83
84 snapshot = dataset + "@before-files-import-" + str(time.time_ns())
85 subprocess.run(["zfs", "snapshot", snapshot], check=True)
86 target.mkdir(parents=True, exist_ok=True)
87 exclusions = ["--exclude=*.lock", "--exclude=/.ytdl-sub-lock", "--exclude=/.cache/", "--exclude=/work/"]
88 subprocess.run(["rsync", "-aH", "--delete", *exclusions, str(source) + "/", str(target) + "/"], check=True)
89 drift = subprocess.check_output([
90 "rsync", "-rlnc", "--delete", "--out-format=%n", *exclusions, str(source) + "/", str(target) + "/",
91 ], text=True)
92 if drift:
93 raise SystemExit("Copied files differ from the retained source. Restore " + snapshot + " before retrying.")
94 os.chown(target, uid, uid)
95 for directory, children, files in os.walk(target):
96 for name in children + files:
97 os.chown(Path(directory) / name, uid, uid, follow_symlinks=False)
98 if service == "tailscale":
99 os.chmod(target / "tailscaled.state", 0o600)
100 elif service == "copyparty":
101 for database in target.glob("*.db"):
102 with sqlite3.connect("file:" + str(database) + "?mode=ro", uri=True) as connection:
103 if connection.execute("PRAGMA integrity_check").fetchone()[0] != "ok":
104 raise SystemExit("Copied Copyparty database needs recovery from " + snapshot)
105 elif service == "pds":
106 for database in target.rglob("*.sqlite"):
107 with sqlite3.connect("file:" + str(database) + "?mode=ro&immutable=1", uri=True) as connection:
108 if connection.execute("PRAGMA integrity_check").fetchone()[0] != "ok":
109 raise SystemExit("Copied PDS database needs recovery from " + snapshot)
110 print(json.dumps({"service": service, "snapshot": snapshot, "copied": True}))
111
112
113if __name__ == "__main__":
114 main()
tools/import-personal-postgres.py deleted-215
...@@ -1,215 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import hashlib
4import json
5import os
6from pathlib import Path
7import re
8import subprocess
9import tempfile
10import urllib.error
11import urllib.request
12
13
14def identifier(value):
15 return '"' + value.replace('"', '""') + '"'
16
17
18def digest(path):
19 result = hashlib.sha256()
20 with path.open('rb') as stream:
21 for block in iter(lambda: stream.read(1024 * 1024), b''):
22 result.update(block)
23 return result.hexdigest()
24
25
26def fingerprint(sql, database):
27 relations = json.loads(sql(database, """
28 SELECT coalesce(json_agg(x ORDER BY n, c), '[]') FROM (
29 SELECT n.nspname n, c.relname c, c.relkind k
30 FROM pg_class c JOIN pg_namespace n ON n.oid=c.relnamespace
31 WHERE n.nspname NOT LIKE 'pg_%' AND n.nspname <> 'information_schema'
32 AND c.relkind IN ('r','m','S')
33 ) x
34 """))
35 result = {}
36 for relation in relations:
37 table = identifier(relation['n']) + '.' + identifier(relation['c'])
38 query = (f'SELECT last_value,is_called FROM {table}' if relation['k'] == 'S' else
39 f'COPY (SELECT row_to_json(t)::text FROM {table} t '
40 'ORDER BY row_to_json(t)::text COLLATE "C") TO STDOUT')
41 content = sql(database, query)
42 result[table] = {'rows': len(content.splitlines()),
43 'sha256': hashlib.sha256(content).hexdigest()}
44 content = sql(database, "COPY (SELECT loid,pageno,encode(data,'hex') "
45 'FROM pg_largeobject ORDER BY loid,pageno) TO STDOUT')
46 result['large_objects'] = {'rows': len(content.splitlines()),
47 'sha256': hashlib.sha256(content).hexdigest()}
48 return result
49
50
51def main():
52 parser = argparse.ArgumentParser(description='Restore a personal database before starting its service.')
53 parser.add_argument('service', choices=('keycloak', 'dawarich'))
54 parser.add_argument('handoff', type=Path)
55 parser.add_argument('--container', help='Restore inside the isolated initializer before deploying Postgres')
56 args = parser.parse_args()
57 if os.geteuid() != 0:
58 parser.error('Run as root on Zenith')
59 os.umask(0o077)
60 handoff = args.handoff.resolve()
61 cluster = json.loads((handoff / 'manifest.json').read_text())['clusters']['18']
62 if not cluster.get('restoreVerified'):
63 raise ValueError('PostgreSQL 18 backup is unverified. Use the verified handoff')
64 entry = cluster['databases'][args.service]
65 dump = (handoff / entry['file']).resolve()
66 if not dump.is_relative_to(handoff / 'pg18') or dump.suffix != '.dump':
67 raise ValueError('Dump is outside the PostgreSQL 18 handoff')
68 if dump.stat().st_size != entry['bytes'] or digest(dump) != entry['sha256']:
69 raise ValueError('Backup checksum differs. Recover the verified handoff before importing')
70
71 token = os.environ.get('NOMAD_TOKEN') or Path('/var/lib/studio/nomad.token').read_text().strip()
72
73 def nomad(path):
74 request = urllib.request.Request('http://127.0.0.1:4646/v1/' + path,
75 headers={'X-Nomad-Token': token})
76 with urllib.request.urlopen(request, timeout=10) as response:
77 return json.load(response)
78
79 def stopped(service):
80 try:
81 job = nomad('job/' + service)
82 except urllib.error.HTTPError as error:
83 if error.code == 404:
84 return
85 raise
86 if not job.get('Stop') or any(
87 item['ClientStatus'] in ('pending', 'running')
88 for item in nomad('job/' + service + '/allocations')
89 ):
90 raise ValueError(f'Stop {service} and wait for its allocations before importing')
91
92 stopped(args.service)
93 connection = nomad('var/nomad/jobs/' + args.service + '/inputs/database')['Items']
94 database, owner = connection['name'], connection['username']
95 expected_database = 'keycloak_next' if args.service == 'keycloak' else 'dawarich'
96 if database != expected_database or owner != 'svc_' + database:
97 raise ValueError('Database variable differs from the production service. Allocate its database first')
98 if args.container:
99 stopped('postgres')
100 else:
101 allocations = [item['ID'] for item in nomad('job/postgres/allocations')
102 if item['ClientStatus'] == 'running' and item['DesiredStatus'] == 'run']
103 if len(allocations) != 1:
104 raise ValueError('Postgres needs exactly one running allocation')
105 folder = Path(tempfile.mkdtemp(prefix=args.service + '-import-', dir='/var/lib/studio'))
106 diagnostics = folder / 'diagnostics.log'
107 podman = ['podman']
108
109 def run(command, *, source=None, output=None):
110 with diagnostics.open('ab') as errors:
111 result = subprocess.run(command, input=source if isinstance(source, bytes) else None,
112 stdin=source if source is not None and not isinstance(source, bytes) else None,
113 stdout=output or subprocess.PIPE, stderr=errors)
114 if result.returncode:
115 raise RuntimeError(f'{Path(command[0]).name} failed. See {diagnostics}')
116 return result.stdout
117
118 if args.container:
119 container = json.loads(run(podman + ['inspect', args.container]))[0]
120 if not container['State']['Running'] or container['HostConfig']['NetworkMode'] != 'none':
121 raise ValueError('Initializer must be running with --network none')
122 container_id = container['Id']
123 else:
124 containers = [parts[0] for line in run(podman + ['ps', '--format', '{{.ID}} {{.Names}}']).decode().splitlines()
125 if len(parts := line.split()) == 2 and parts[1].endswith(allocations[0])]
126 if len(containers) != 1:
127 raise ValueError('Postgres allocation container is unavailable')
128 container_id = containers[0]
129 execute = podman + ['exec', '-i', container_id]
130
131 def sql(db, query):
132 return run(execute + ['psql', '-X', '-U', 'postgres', '-d', db,
133 '-At', '-v', 'ON_ERROR_STOP=1'], source=(query + '\n').encode())
134
135 current_owner = sql('postgres', f"SELECT pg_get_userbyid(datdba) FROM pg_database WHERE datname='{database}'").decode().strip()
136 if current_owner != owner:
137 raise ValueError('Production database is missing or has another owner. Allocate it with the Postgres provider')
138 with dump.open('rb') as source:
139 listing = run(execute + ['pg_restore', '--list'], source=source).decode()
140 extensions = re.findall(r'^\d+; \d+ \d+ EXTENSION - (\S+) ', listing, re.MULTILINE)
141 if set(extensions) - {'plpgsql', 'postgis'} or ('postgis' in extensions) != (args.service == 'dawarich'):
142 raise ValueError('Backup extensions differ from the service. Review the personal database before importing')
143 extension_data, application = [], []
144 for line in listing.splitlines():
145 if re.match(r'^\d+; \d+ \d+ (EXTENSION |COMMENT - EXTENSION |SCHEMA - public )', line):
146 continue
147 if re.match(r'^\d+; \d+ \d+ TABLE DATA public spatial_ref_sys ', line):
148 extension_data.append(line)
149 else:
150 application.append(line)
151 contents = {name: value for name, value in entry['contents'].items() if name != 'large_object_owners'}
152 restore_list = '/tmp/' + folder.name + '.list'
153 run(execute + ['tee', restore_list], source=('\n'.join(application) + '\n').encode())
154 try:
155 stopped(args.service)
156 if args.container:
157 stopped('postgres')
158 if sql('postgres', f"SELECT count(*) FROM pg_stat_activity WHERE datname='{database}'").strip() != b'0':
159 raise ValueError('Database has connected clients. Stop them before importing')
160 backup = folder / 'before.dump'
161 with backup.open('wb') as output:
162 run(execute + ['pg_dump', '-U', 'postgres', '-Fc', database], output=output)
163 if not backup.stat().st_size:
164 raise RuntimeError('Target backup is empty. Import stopped')
165 sql('postgres', f'DROP DATABASE {database};')
166 sql('postgres', f'CREATE DATABASE {database} OWNER {owner};')
167 sql(database, f'ALTER SCHEMA public OWNER TO {owner};')
168 if args.service == 'dawarich':
169 sql(database, 'CREATE EXTENSION postgis;')
170 with dump.open('rb') as source:
171 run(execute + ['pg_restore', '-U', 'postgres', '-d', database, '--no-owner', '--no-acl',
172 '--role=' + owner, '--single-transaction', '--exit-on-error',
173 '--use-list=' + restore_list], source=source)
174 if extension_data:
175 run(execute + ['tee', restore_list], source=('\n'.join(extension_data) + '\n').encode())
176 with dump.open('rb') as source:
177 extension_sql = run(execute + ['pg_restore', '-U', 'postgres', '--data-only', '--no-owner',
178 '--no-acl', '--use-list=' + restore_list, '--file=-'], source=source)
179 srids = []
180 copying = False
181 for line in extension_sql.splitlines():
182 if line.startswith(b'COPY public.spatial_ref_sys ('):
183 copying = True
184 elif copying and line == b'\\.':
185 copying = False
186 elif copying:
187 srids.append(int(line.split(b'\t', 1)[0]))
188 # PostGIS dumps include custom SRIDs; the extension supplies built-in definitions.
189 if srids:
190 sql(database, 'DELETE FROM public.spatial_ref_sys WHERE srid IN (' + ','.join(map(str, srids)) + ');')
191 with dump.open('rb') as source:
192 run(execute + ['pg_restore', '-U', 'postgres', '-d', database, '--no-owner', '--no-acl',
193 '--data-only', '--single-transaction', '--exit-on-error',
194 '--use-list=' + restore_list], source=source)
195 actual = fingerprint(sql, database)
196 if actual != contents:
197 changed = sorted(name for name in actual.keys() | contents.keys() if actual.get(name) != contents.get(name))
198 (folder / 'differences.json').write_text(json.dumps(changed, indent=2) + '\n')
199 raise RuntimeError(f'Restored data differs. Keep {args.service} stopped and review {folder}')
200 if dump.stat().st_size != entry['bytes'] or digest(dump) != entry['sha256']:
201 raise RuntimeError('Backup changed during import. Keep the service stopped')
202 (folder / 'verified.json').write_text(json.dumps({
203 'service': args.service, 'database': database, 'source': str(dump),
204 'sha256': entry['sha256'], 'contents': actual,
205 }, indent=2) + '\n')
206 print(f'Imported and verified {args.service}. Previous database: {backup}')
207 finally:
208 run(execute + ['rm', '-f', restore_list])
209
210
211if __name__ == '__main__':
212 try:
213 main()
214 except (ValueError, RuntimeError, OSError, KeyError, urllib.error.HTTPError) as error:
215 raise SystemExit(str(error)) from None
tools/import-qbittorrent.sh deleted-66
...@@ -1,66 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4: "${STUDIO_DEPLOY_HOST:?Set STUDIO_DEPLOY_HOST to the production target}"
5source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
6target_host=$STUDIO_DEPLOY_HOST
7target_port=${STUDIO_DEPLOY_PORT:-2222}
8remote=(ssh -p "$target_port" "$target_host")
9root=/srv/prod/qbittorrent
10source_copy_host=$source_host
11source_rsh=ssh
12offline=false
13if [[ -n ${STUDIO_LEGACY_HANDOFF:-} ]]; then
14 sh "$(dirname "$0")/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$target_host" "$target_port"
15 source_copy_host=$target_host
16 source_rsh="ssh -p $target_port"
17 offline=true
18fi
19
20if [[ $offline == false ]]; then
21 source_running=$(ssh "$source_host" 'sudo -n docker inspect -f "{{.State.Running}}" qbittorrent')
22 [[ $source_running == false ]] || { echo 'Stop Zenith qBittorrent before importing its profile' >&2; exit 1; }
23fi
24"${remote[@]}" 'test "$(findmnt -n -o FSTYPE --mountpoint /srv/clover/Media)" = zfs; test -d /srv/clover/Media/Seedbox; test -L /srv/clover/Media/torrent; test /srv/clover/Media/Seedbox -ef /srv/clover/Media/torrent' || {
25 echo 'Mount Media and point torrent at Seedbox before importing qBittorrent' >&2; exit 1;
26}
27
28response=$("${remote[@]}" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/qbittorrent')
29status=${response##*$'\n'}
30if [[ $status == 200 ]]; then
31 stopped=$(python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())' <<<"${response%$'\n'*}")
32 [[ $stopped == true ]] || { echo 'Stop qBittorrent on the home server before importing its profile' >&2; exit 1; }
33elif [[ $status != 404 ]]; then
34 echo "Could not verify qBittorrent job state on the home server: $status" >&2
35 exit 1
36fi
37dataset=$("${remote[@]}" "findmnt -n -o SOURCE --mountpoint $root")
38[[ $dataset == */prod/qbittorrent ]] || { echo "Expected a mounted service dataset at $root" >&2; exit 1; }
39
40scratch=$(mktemp -d)
41trap 'rm -rf "$scratch"' EXIT
42mkdir "$scratch/qBittorrent"
43rsync -a --exclude=/config/ipc-socket --exclude=/config/lockfile --exclude=/data/logs/ --exclude=/cache/ \
44 -e "$source_rsh" "$source_copy_host:/mnt/storage1/apps/qbittorrent/qBittorrent/" "$scratch/qBittorrent/"
45resume_count=$(find "$scratch/qBittorrent/data/BT_backup" -maxdepth 1 -type f -name '*.fastresume' | wc -l | tr -d ' ')
46[[ $resume_count -gt 0 ]] || { echo 'No saved torrents copied from Zenith' >&2; exit 1; }
47
48snapshot="$dataset@before-qbittorrent-import-$(date +%s)-$$"
49"${remote[@]}" "zfs snapshot $snapshot"
50rsync -a --delete -e "ssh -p $target_port" "$scratch/qBittorrent/" "$target_host:$root/config/qBittorrent/"
51changes=$(rsync -a --checksum --dry-run --itemize-changes -e "ssh -p $target_port" \
52 "$scratch/qBittorrent/" "$target_host:$root/config/qBittorrent/")
53[[ -z $changes ]] || { echo 'Copied qBittorrent profile differs from source' >&2; exit 1; }
54
55uid=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"qbittorrent\"])'")
56"${remote[@]}" "chown -R $uid:$uid $root/config/qBittorrent && chmod -R u+rwX,go-rwx $root/config/qBittorrent && printf '{\"hostRoot\":\"$root\",\"uid\":$uid}' | python3 /opt/studio/current/service/qbittorrent/prepare.py"
57copied=$("${remote[@]}" "find $root/config/qBittorrent/data/BT_backup -maxdepth 1 -type f -name '*.fastresume' | wc -l")
58[[ $copied -eq $resume_count ]] || { echo 'Saved torrent count changed during import' >&2; exit 1; }
59if [[ $offline == false ]]; then
60 [[ $(ssh "$source_host" 'sudo -n docker inspect -f "{{.State.Running}}" qbittorrent') == false ]] || {
61 echo 'Zenith qBittorrent restarted during import; leave the home server stopped' >&2
62 exit 1
63 }
64fi
65"${remote[@]}" 'python3 /opt/studio/current/tools/studio.py deploy qbittorrent'
66echo "Imported $resume_count saved torrents into $dataset; pre-import snapshot: $snapshot"
tools/import-shale.sh deleted-106
...@@ -1,106 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4instance=${1:?usage: tools/import-shale.sh shale|shale-preview-XXXXXXXX}
5[[ $instance == shale || $instance =~ ^shale-preview-[0-9a-f]{8}$ ]] || { echo 'Expected Shale or its preview ID' >&2; exit 1; }
6source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
7target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
8target_port=${STUDIO_DEPLOY_PORT:-2222}
9remote=(ssh -p "$target_port" "$target_host")
10job_status=200
11handoff=${STUDIO_LEGACY_HANDOFF:-}
12if [[ -n $handoff ]]; then
13 [[ $instance == shale && -n ${STUDIO_DEPLOY_HOST:-} ]] || {
14 echo 'Offline handoff requires production Shale and a target' >&2
15 exit 1
16 }
17 sh "$(dirname "$0")/check-legacy-handoff.sh" "$handoff" "$target_host" "$target_port"
18 source_copy_host=$target_host
19 source_rsh="ssh -p $target_port"
20else
21 source_copy_host=$source_host
22 source_rsh=ssh
23fi
24
25if [[ $instance == shale ]]; then
26 [[ -n ${STUDIO_DEPLOY_HOST:-} ]] || { echo 'Set STUDIO_DEPLOY_HOST to the production target' >&2; exit 1; }
27 if [[ -z $handoff ]]; then
28 [[ $(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' shale") == false ]] || { echo 'Stop Zenith Shale before importing production data' >&2; exit 1; }
29 fi
30 root=/srv/prod/shale
31 source_root=/mnt/storage1/apps/shale
32 job_response=$("${remote[@]}" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/shale')
33 job_status=${job_response##*$'\n'}
34 if [[ $job_status == 200 ]]; then
35 stopped=$(python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())' <<<"${job_response%$'\n'*}")
36 [[ $stopped == true ]] || { echo 'Stop Shale on the home server before importing production data' >&2; exit 1; }
37 elif [[ $job_status != 404 ]]; then
38 echo "Could not verify production Shale job: $job_status" >&2
39 exit 1
40 fi
41else
42 root=/srv/staging/$instance
43 source_id=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
44 [[ $source_id == shale ]] || { echo 'Preview belongs to another service' >&2; exit 1; }
45 source_snapshot=$(ssh "$source_host" '/usr/sbin/zfs list -H -t snapshot -o name -s creation -r storage1/apps | tail -n 1')
46 [[ $source_snapshot == storage1/apps@* ]] || { echo 'No Zenith app snapshot is available' >&2; exit 1; }
47 source_root=/mnt/storage1/apps/.zfs/snapshot/${source_snapshot#*@}/shale
48fi
49
50dataset=$("${remote[@]}" "findmnt -n -o SOURCE --mountpoint $root")
51if [[ $instance == shale ]]; then
52 [[ $dataset == */prod/shale ]] || { echo 'Production Shale dataset is not mounted' >&2; exit 1; }
53else
54 [[ $dataset == */staging/$instance ]] || { echo 'Preview Shale dataset is not mounted' >&2; exit 1; }
55fi
56
57scratch=$(mktemp -d)
58trap 'rm -rf "$scratch"' EXIT
59for name in data repositories_owned repositories_mirrors; do
60 rsync -aH -e "$source_rsh" "$source_copy_host:$source_root/$name/" "$scratch/$name/"
61 drift=$(rsync -rlnc --delete --out-format='%n' -e "$source_rsh" "$source_copy_host:$source_root/$name/" "$scratch/$name/")
62 [[ -z $drift ]] || { echo "Zenith Shale $name changed during copy" >&2; exit 1; }
63done
64python3 - "$scratch/data/astheno.shale.db" <<'PY'
65import sqlite3
66import sys
67
68db = sqlite3.connect(f"file:{sys.argv[1]}?mode=ro", uri=True)
69assert db.execute("PRAGMA integrity_check").fetchone()[0] == "ok"
70PY
71
72if [[ $instance != shale ]]; then
73 "${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
74fi
75if [[ $job_status == 200 || $instance != shale ]]; then
76 for _ in {1..30}; do
77 running=$("${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job allocs -json $instance" |
78 python3 -c 'import json,sys; print(sum(a["ClientStatus"] == "running" for a in json.load(sys.stdin)))')
79 [[ $running == 0 ]] && break
80 sleep 2
81 done
82 [[ $running == 0 ]] || { echo 'Shale allocation did not stop' >&2; exit 1; }
83fi
84
85snapshot=$dataset@before-shale-import-$(date +%s)-$$
86"${remote[@]}" "zfs snapshot $snapshot"
87for name in data repositories_owned repositories_mirrors; do
88 "${remote[@]}" "mkdir -p $root/$name"
89 rsync -aH --delete -e "ssh -p $target_port" "$scratch/$name/" "$target_host:$root/$name/"
90 drift=$(rsync -rlnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/$name/" "$target_host:$root/$name/")
91 [[ -z $drift ]] || { echo "Shale $name on the home server differs from the source copy; restore $snapshot" >&2; exit 1; }
92done
93uid=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"shale\"])'")
94"${remote[@]}" "chown -R $uid:$uid $root/data $root/repositories_owned $root/repositories_mirrors"
95"${remote[@]}" "python3 -c 'import sqlite3; db=sqlite3.connect(\"file:$root/data/astheno.shale.db?mode=ro\", uri=True); assert db.execute(\"PRAGMA integrity_check\").fetchone()[0] == \"ok\"'"
96
97if [[ $instance == shale ]]; then
98 if [[ -z $handoff ]]; then
99 [[ $(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' shale") == false ]] || { echo 'Zenith Shale restarted during import; leave the home server stopped' >&2; exit 1; }
100 fi
101 echo "Imported production Shale. Previous dataset state: $snapshot"
102else
103 python3 "$(dirname "$0")/deploy.py" stage shale
104 "${remote[@]}" "zfs destroy $snapshot"
105 echo "Imported and tested $instance from $source_snapshot"
106fi
tools/import-source-data.sh deleted-68
...@@ -1,68 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4: "${STUDIO_DEPLOY_HOST:?Set STUDIO_DEPLOY_HOST to the production target}"
5source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
6target_host=$STUDIO_DEPLOY_HOST
7target_port=${STUDIO_DEPLOY_PORT:-22}
8remote=(ssh -p "$target_port" "$target_host")
9target_dir=/srv/prod/clover-source-of-truth/data
10tree_hash="$(dirname "$0")/tree-hash.py"
11
12if [[ -n ${STUDIO_MIGRATION_SNAPSHOT:-} ]]; then
13 [[ $STUDIO_MIGRATION_SNAPSHOT =~ ^[A-Za-z0-9_-]+$ ]] || { echo 'Invalid source snapshot name' >&2; exit 1; }
14 source=("${remote[@]}")
15 source_dir="/srv/clover/.zfs/snapshot/$STUDIO_MIGRATION_SNAPSHOT/Documents/Config/paper clover"
16 "${source[@]}" "test -d '$source_dir'"
17else
18 source=(ssh "$source_host")
19 source_dir='/mnt/storage1/clover/Documents/Config/paper clover'
20 [[ $("${source[@]}" "sudo -n docker inspect -f '{{.State.Running}}' clover-source-of-truth") == false ]] || {
21 echo 'Stop Zenith Source of Truth before importing production data' >&2
22 exit 1
23 }
24fi
25"${remote[@]}" "set -e; test \$(findmnt -n -o FSTYPE --mountpoint /srv/clover) = zfs; test -d /srv/clover/Published; ! findmnt -n -R '$target_dir' >/dev/null"
26dataset=$("${remote[@]}" 'findmnt -n -o SOURCE --mountpoint /srv/prod/clover-source-of-truth')
27[[ $dataset == */prod/clover-source-of-truth ]] || { echo 'Production service dataset is not mounted' >&2; exit 1; }
28job_response=$("${remote[@]}" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/clover-source-of-truth')
29job_status=${job_response##*$'\n'}
30if [[ $job_status == 200 ]]; then
31 stopped=$(python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())' <<<"${job_response%$'\n'*}")
32 [[ $stopped == true ]] || { echo 'Stop Source of Truth on the home server before importing production data' >&2; exit 1; }
33 for _ in {1..30}; do
34 running=$("${remote[@]}" 'NOMAD_TOKEN=$(cat /var/lib/studio/nomad.token) nomad job allocs -json clover-source-of-truth' |
35 python3 -c 'import json,sys; print(sum(a["ClientStatus"] == "running" for a in json.load(sys.stdin)))')
36 [[ $running == 0 ]] && break
37 sleep 2
38 done
39 [[ $running == 0 ]] || { echo 'The home server allocation did not stop' >&2; exit 1; }
40elif [[ $job_status != 404 ]]; then
41 echo "Could not verify the home server job: $job_status" >&2
42 exit 1
43fi
44
45source_manifest=$("${source[@]}" "python3 - '$source_dir'" < "$tree_hash")
46source_bytes=$(python3 -c 'import json,sys; print(json.load(sys.stdin)["bytes"])' <<<"$source_manifest")
47available=$("${remote[@]}" "df -B1 --output=avail /srv/prod/clover-source-of-truth | tail -n 1")
48(( available > source_bytes )) || { echo 'Production dataset has too little free space for the source tree' >&2; exit 1; }
49
50snapshot=$dataset@before-source-data-import-$(date +%s)-$$
51"${remote[@]}" "set -e; zfs snapshot $snapshot; rm -rf -- '$target_dir'; mkdir -p -- '$target_dir'"
52if [[ -n ${STUDIO_MIGRATION_SNAPSHOT:-} ]]; then
53 "${remote[@]}" "bash -c \"set -euo pipefail; tar -C '$source_dir' -cf - . | tar -C '$target_dir' -xf -\""
54else
55 "${source[@]}" "tar -C '$source_dir' -cf - ." |
56 "${remote[@]}" "tar -C '$target_dir' -xf -"
57fi
58target_manifest=$("${remote[@]}" "python3 - '$target_dir'" < "$tree_hash")
59[[ $source_manifest == "$target_manifest" ]] || { echo "Source and target trees differ; restore $snapshot" >&2; exit 1; }
60uid=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"clover-source-of-truth\"])'")
61"${remote[@]}" "set -e; chown -R $uid:$uid '$target_dir'; python3 -c 'import sqlite3; db=sqlite3.connect(\"file:$target_dir/cache.sqlite?mode=ro\", uri=True); assert db.execute(\"PRAGMA integrity_check\").fetchone()[0] == \"ok\"'"
62if [[ -z ${STUDIO_MIGRATION_SNAPSHOT:-} ]]; then
63 [[ $("${source[@]}" "sudo -n docker inspect -f '{{.State.Running}}' clover-source-of-truth") == false ]] || {
64 echo 'Zenith Source of Truth restarted during import; leave the home server stopped' >&2
65 exit 1
66 }
67fi
68echo "Imported ${source_bytes} bytes without local staging. Previous dataset state: $snapshot"
tools/import-source-index.sh deleted-68
...@@ -1,68 +0,0 @@
1#!/bin/sh
2set -eu
3
4instance=${1:?usage: tools/import-source-index.sh clover-source-of-truth-preview-XXXXXXXX}
5printf '%s\n' "$instance" | grep -Eq '^clover-source-of-truth-preview-[0-9a-f]{8}$' || {
6 echo 'Expected a Clover Source of Truth preview ID' >&2
7 exit 1
8}
9
10source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
11target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
12target_port=${STUDIO_DEPLOY_PORT:-2222}
13root="/srv/staging/$instance/data"
14mount="/srv/staging/$instance"
15source_id=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
16test "$source_id" = clover-source-of-truth || { echo 'Preview belongs to another service' >&2; exit 1; }
17dataset=$(ssh -p "$target_port" "$target_host" "findmnt -n -o SOURCE --mountpoint $mount")
18case $dataset in */staging/"$instance") ;; *) echo 'Preview dataset is not mounted' >&2; exit 1 ;; esac
19
20scratch=$(mktemp -d)
21source_backup=
22cleanup() {
23 rm -rf "$scratch"
24 if [ -n "$source_backup" ]; then
25 ssh "$source_host" "rm -rf '$source_backup'"
26 fi
27}
28trap cleanup EXIT
29
30source_backup=$(ssh "$source_host" sh -s <<'REMOTE'
31set -eu
32out=$(mktemp -d /tmp/studio-source-index-XXXXXX)
33trap 'rm -rf "$out"' EXIT
34source='/mnt/storage1/clover/Documents/Config/paper clover/cache.sqlite'
35sqlite3 -readonly "$source" ".backup '$out/cache.sqlite'"
36test "$(sqlite3 -readonly "$out/cache.sqlite" 'PRAGMA integrity_check;')" = ok
37trap - EXIT
38printf '%s\n' "$out"
39REMOTE
40)
41rsync -a "$source_host:$source_backup/cache.sqlite" "$scratch/cache.sqlite"
42python3 - "$scratch/cache.sqlite" <<'PY'
43import sqlite3
44import sys
45
46db = sqlite3.connect('file:' + sys.argv[1] + '?mode=ro&immutable=1', uri=True)
47assert db.execute('PRAGMA integrity_check').fetchone()[0] == 'ok'
48PY
49
50ssh -p "$target_port" "$target_host" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
51snapshot="$dataset@before-source-index-import-$(date +%s)-$$"
52ssh -p "$target_port" "$target_host" "set -eu; for i in \$(seq 1 30); do running=\$(curl -fsS -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/$instance/allocations | python3 -c 'import json,sys; print(sum(a[\"ClientStatus\"] == \"running\" for a in json.load(sys.stdin)))'); test \"\$running\" = 0 && break; sleep 2; done; test \"\$running\" = 0; zfs snapshot $snapshot"
53
54rsync -a -e "ssh -p $target_port" "$scratch/cache.sqlite" "$target_host:$root/cache.sqlite"
55owner=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"clover-source-of-truth\"])'")
56ssh -p "$target_port" "$target_host" "chown $owner:$owner $root/cache.sqlite; rm -f $root/cache.sqlite-wal $root/cache.sqlite-shm $root/db-snapshot.sqlite"
57drift=$(rsync -rnc --out-format='%n' -e "ssh -p $target_port" "$scratch/cache.sqlite" "$target_host:$root/cache.sqlite")
58test -z "$drift" || { echo "Index copy differs from source backup; restore $snapshot" >&2; exit 1; }
59
60python3 "$(dirname "$0")/deploy.py" stage clover-source-of-truth
61ssh -p "$target_port" "$target_host" "python3 - <<'PY'
62import sqlite3
63source = sqlite3.connect('file:$root/cache.sqlite?mode=ro', uri=True)
64assert source.execute('PRAGMA integrity_check').fetchone()[0] == 'ok'
65for table in ('media_files', 'derived_files', 'derived_refs'):
66 print(table, source.execute('SELECT count(*) FROM ' + table).fetchone()[0])
67PY"
68echo "Imported the live SQLite index into $instance; previous dataset: $snapshot"
tools/import-yt-feed.sh deleted-109
...@@ -1,109 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4instance=${1:-ytdl}
5[[ $instance == ytdl || $instance =~ ^ytdl-preview-[0-9a-f]{8}$ ]] || {
6 echo 'Expected ytdl or its preview ID' >&2
7 exit 1
8}
9
10source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
11target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
12target_port=${STUDIO_DEPLOY_PORT:-2222}
13remote=(ssh -p "$target_port" "$target_host")
14source_copy_host=$source_host
15source_rsh=ssh
16offline=false
17if [[ -n ${STUDIO_LEGACY_HANDOFF:-} ]]; then
18 [[ $instance == ytdl && -n ${STUDIO_DEPLOY_HOST:-} ]] || {
19 echo 'Offline handoff requires production YouTube Triage and a target' >&2; exit 1;
20 }
21 sh "$(dirname "$0")/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$target_host" "$target_port"
22 source_copy_host=$target_host
23 source_rsh="ssh -p $target_port"
24 offline=true
25fi
26if [[ $instance == ytdl ]]; then
27 root=/srv/prod/ytdl
28 "${remote[@]}" 'test "$(findmnt -n -o FSTYPE --mountpoint /srv/clover/Media)" = zfs; test -d "/srv/clover/Media/Intake - Music"; test -d "/srv/clover/Media/Indie Shows"; test -d /srv/clover/Media/Videos/Independent' || {
29 echo 'Mount Media with Intake - Music, Indie Shows, and Videos/Independent before importing YouTube Triage' >&2
30 exit 1
31 }
32 if [[ $offline == false ]]; then
33 source_running=$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' yt-feed")
34 [[ $source_running == false ]] || { echo 'Stop Zenith yt-feed before importing production data' >&2; exit 1; }
35 fi
36 response=$("${remote[@]}" "curl -s -w '\n%{http_code}' -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/ytdl")
37 status=${response##*$'\n'}
38 if [[ $status == 200 ]]; then
39 stopped=$(python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())' <<<"${response%$'\n'*}")
40 [[ $stopped == true ]] || { echo 'Stop production YTDL before importing' >&2; exit 1; }
41 elif [[ $status != 404 ]]; then
42 echo "Could not verify production YTDL job state: $status" >&2
43 exit 1
44 fi
45else
46 root=/srv/staging/$instance
47 source_id=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
48 [[ $source_id == ytdl ]] || { echo 'Preview belongs to another service' >&2; exit 1; }
49fi
50dataset=$("${remote[@]}" "findmnt -n -o SOURCE --mountpoint $root")
51[[ $dataset == */prod/ytdl || $dataset == */staging/"$instance" ]] || {
52 echo "Expected a mounted YTDL dataset at $root" >&2
53 exit 1
54}
55
56scratch=$(mktemp -d)
57trap 'rm -rf "$scratch"' EXIT
58rsync -a -e "$source_rsh" "$source_copy_host:/mnt/storage1/apps/yt-feed/" "$scratch/"
59python3 - "$scratch" <<'PY'
60import json
61from pathlib import Path
62import sys
63
64root = Path(sys.argv[1])
65files = list(root.glob("*.json"))
66if not files:
67 raise ValueError("no YouTube Triage JSON state was copied")
68for file in files:
69 json.loads(file.read_text())
70print(f"Copied {len(files)} valid JSON state files")
71PY
72drift=$(rsync -rnc --delete --out-format='%n' -e "$source_rsh" "$source_copy_host:/mnt/storage1/apps/yt-feed/" "$scratch/")
73[[ -z $drift ]] || { echo 'Source changed during copy; retry the import' >&2; exit 1; }
74
75if [[ $instance != ytdl ]]; then
76 "${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
77else
78 "${remote[@]}" 'systemctl stop studio-dashboard'
79fi
80for _ in {1..30}; do
81 running=$("${remote[@]}" "curl -s -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/$instance/allocations" |
82 python3 -c 'import json,sys; print(sum(x["ClientStatus"] == "running" for x in json.load(sys.stdin)))')
83 [[ $running == 0 ]] && break
84 sleep 2
85done
86[[ $running == 0 ]] || { echo "$instance still has a running allocation" >&2; exit 1; }
87
88snapshot="$dataset@before-yt-feed-import-$(date +%s)-$$"
89"${remote[@]}" "zfs snapshot $snapshot"
90rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/data/"
91uid=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"ytdl\"])'")
92"${remote[@]}" "chown -R $uid:$uid $root/data"
93drift=$(rsync -rnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/" "$target_host:$root/data/")
94[[ -z $drift ]] || { echo "Copied state differs from source; restore $snapshot" >&2; exit 1; }
95
96if [[ $instance == ytdl ]]; then
97 if [[ $offline == false ]]; then
98 [[ $(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' yt-feed") == false ]] || {
99 echo 'Zenith yt-feed restarted during import; leave the home server stopped' >&2
100 exit 1
101 }
102 fi
103 "${remote[@]}" 'systemctl start studio-dashboard'
104 echo "Imported production YTDL from Zenith. Previous dataset state: $snapshot"
105else
106 python3 "$(dirname "$0")/deploy.py" stage ytdl
107 "${remote[@]}" "zfs destroy $snapshot"
108 echo "Imported and tested $instance"
109fi
tools/intake-migration.md deleted-7
...@@ -1,7 +0,0 @@
1# JSON Intake migration
2
3Zenith's `Documents/Intake` exists but contains no files at the 2026-09-26 inspection. Snow Globe already mounts the equivalent Clover folder, so no application dataset copy is required.
4
5Existing Siri shortcuts and webhooks send Zenith's `INTAKE_KEY`. During production cutover, set `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT` for the production host, then run `bash tools/import-legacy-secrets.sh intake INTAKE_KEY` to stream that value from Zenith's `.env` into Snow Globe's Nomad secret. Redeploy Intake to load it. The command does not print or save the key locally; it refuses to run without an explicit target.
6
7On 2026-09-26, `intake-preview-7f29ae9a` inherited the VM production key and cloned the Clover dataset for its writable mount. Its HTTPS route rejected an incorrect key with 401 and accepted a test row with the inherited key; the row appeared only in the clone, then was removed. Release `7b6aac707cf7c55f` promoted successfully after a backup of 22 service datasets and four databases, and all 19 HTTP routes passed. Destroying the stage removed its Nomad job, secret, ZFS clone, and source snapshot. Production Intake remained healthy and its Clover folder stayed empty.
tools/jellyfin-migration.md deleted-13
...@@ -1,13 +0,0 @@
1# Jellyfin media migration proof
2
3An initial small preview used a consistent SQLite backup from Zenith, verified by `PRAGMA integrity_check` before and after transfer. Its 4,879 `/media/...` paths matched Zenith's database by sorted path digest. On Zenith, 4,823 resolved in the existing media dataset; the other 56 were already missing at the source (50 videos, 3 trailers, 2 folders, and 1 photo).
4
5The VM mounts Zenith's media tree read-only at `/srv/clover/Media`, which Jellyfin receives as `/media`. Twenty evenly spaced source paths that exist on Zenith also resolved through the VM mount. The staged app is healthy without copying the 3.97 TiB media dataset. [The media cutover plan](media-cutover.md) moves that dataset to the final `/srv/clover/Media` mountpoint while preserving hardlinks and snapshots.
6
7A full preview restore used the existing read-only `storage1/apps@hourly-2026-09-26_01-00` snapshot as its source. [import-jellyfin.sh](import-jellyfin.sh) copied Jellyfin's metadata, artwork, attachments, subtitles, intro-skipper state, and plugins while excluding caches, logs, and transcodes. The copy was 4.7 GB on the Mac and 3.2 GB in the VM's compressed ZFS dataset; checksums matched before the app started. The pinned 10.11.11 image migrated the 10.11.5 database successfully. Both sides had 17,466 base items, 22 users, 7,717 user-data rows, and the same digest for 4,879 media paths after boot. The source and stage also matched counts for 7,149 metadata files, 873 attachments, and 1,574 subtitles. SQLite integrity and HTTPS health passed; the SSO start endpoint redirected to the staged Keycloak client.
8
9Production import (`STUDIO_DEPLOY_HOST=<new-host> STUDIO_DEPLOY_PORT=22 sh tools/import-jellyfin.sh jellyfin`) uses the stopped live source, requires the new Jellyfin job stopped and the real Media ZFS filesystem mounted, snapshots the destination, verifies the copy, assigns Jellyfin's allocated UID, and leaves the new job stopped for cutover. During the preview boot, a three-second Nomad health probe timed out under load and Caddy briefly removed the stage route. The probe now allows 15 seconds; the updated preview deployment passed. The imported Jellyfin settings also automatically installed newer AniList and Intro Skipper plugins after startup.
10
11After a same-machine OS replacement, set `STUDIO_LEGACY_HANDOFF` to the [offline handoff](legacy-handoff.md) directory. The production importer then copies the old app metadata directly between mounted datasets on the new host, without a Mac scratch copy or old Docker daemon. The 3.97 TiB Media dataset remains a ZFS mount and is not copied.
12
13The service binds the reorganized host folders at their original `/media/jellyfin/...` container paths using the shared [config/site.pkl](../config/site.pkl) mapping. Both existing library settings and new-instance setup keep those paths; no database path rewrite is needed. See the [current service layout](media-cutover.md#service-paths-for-the-reorganized-tree). This follows [Jellyfin's migration guidance](https://jellyfin.org/docs/general/administration/migrate/) to preserve the paths seen by the application.
tools/knife.md+1-12
...@@ -38,7 +38,7 @@ an allocation ID:...@@ -38,7 +38,7 @@ an allocation ID:
3838
39```sh39```sh
40ssh -p 22 root@10.0.0.140ssh -p 22 root@10.0.0.1
41export NOMAD_TOKEN="$(cat /var/lib/studio/nomad.token)"41export NOMAD_TOKEN="$(cat /var/lib/snowglobe/nomad.token)"
42knife_allocation=$(nomad job allocs -json knife | python3 -c 'import json,sys; a=[r["ID"] for r in json.load(sys.stdin) if r["ClientStatus"]=="running" and r["DesiredStatus"]=="run"]; assert len(a)==1; print(a[0])')42knife_allocation=$(nomad job allocs -json knife | python3 -c 'import json,sys; a=[r["ID"] for r in json.load(sys.stdin) if r["ClientStatus"]=="running" and r["DesiredStatus"]=="run"]; assert len(a)==1; print(a[0])')
43knife_container="app-$knife_allocation"43knife_container="app-$knife_allocation"
44podman exec "$knife_container" knife auth devices revoke-all44podman exec "$knife_container" knife auth devices revoke-all
...@@ -75,14 +75,3 @@ requirements or corrupt downloads fail startup. For a new image, review the bund...@@ -75,14 +75,3 @@ requirements or corrupt downloads fail startup. For a new image, review the bund
75and update `service/knife/bundle.json`, then use the normal stage → main → prod75and update `service/knife/bundle.json`, then use the normal stage → main → prod
76workflow. Runtime downloads under `data/runtime/knife-container` survive an infra76workflow. Runtime downloads under `data/runtime/knife-container` survive an infra
77image rollback; rolling back code does not restore state or archive objects.77image rollback; rolling back code does not restore state or archive objects.
78
79## 2026-10-16 SSO verification
80
81A fresh Zenith preview completed Clover's real Snow Globe sign-in, verified the
82issuer/subject account binding, renewed its browser session, and opened an
83authenticated WebSocket through HTTPS. Anonymous access, missing CSRF, invalid
84OIDC/native transactions, and corrupt archive objects were rejected. A synthetic
85object uploaded and downloaded identically with working byte ranges; temporarily
86removing the preview's archive marker returned 503 and its original marker was
87restored unchanged. The private allocation JSON matched its separate Nomad client,
88used mode 0400 and UID 3132, and its intended bind mount rejected writes.
tools/legacy-handoff.md deleted-28
...@@ -1,28 +0,0 @@
1# Same-machine PostgreSQL handoff
2
3The retained apps dataset is an encrypted ZFS root. Keep its mountpoint explicitly at `/mnt/storage1/apps` after renaming the pool to `globe` and replacing Zenith with NixOS; [media-cutover.md](media-cutover.md) gives the command order. The old app directories and `/mnt/storage1/apps/home-infra/.env` remain there; the new `/srv/prod` root is separate.
4
5If TrueNAS is still running, stop the old apps being migrated, leaving old PostgreSQL running long enough to export. Run `bash tools/export-legacy-postgres.sh` before replacing the OS. Zenith grants the `clo` account passwordless `sudo docker` access for the export; this online exporter requires the original `storage1/apps` mount and exports Forgejo and HedgeDoc only. It does not stop apps itself.
6
7If already booted into the installer, [export-offline-postgres.py](export-offline-postgres.py) exports every connectable database and all roles from both retained clusters. It requires all PostgreSQL servers to be stopped, matching-major runtimes with the source extensions installed, and `glibcLocales`. It starts private RAM copies over private Unix sockets, saves complete physical archives including `template0`, checks the original file hashes remain unchanged, and restores every logical dump into fresh temporary clusters. Verification compares every user table's contents, sequence state, and large objects. The originals are never started. Run as root on the installer, with the runtime paths supplied by the pinned Nix builds:
8
9```sh
10python3 tools/export-offline-postgres.py \
11 --cluster /mnt/storage1/apps/pg_data "$postgres17_runtime" \
12 --cluster /mnt/storage1/apps/pg_data18/18/docker "$postgres18_runtime" \
13 --locale-archive "$glibc_locales/lib/locale/locale-archive"
14```
15
16It publishes a private `studio-handoff/<timestamp>-<suffix>` directory only after successful restores. Its `pg17` and `pg18` directories contain all database dumps, `globals.sql`, and `cluster.tar.gz`; the manifest records their hashes and restore evidence. Root-level Forgejo and HedgeDoc dump links select the PG18 exports for the existing importers. Dawarich's old database is retained in the full export even though its new service starts fresh. Copy the complete handoff directory, preserving these links, to a private off-server archive and verify the file hashes before replacing the OS. `globals.sql` contains role password hashes; protect the archive like the recovery keys. Failed exports remain under `.pending-*` and cannot be selected by the importers.
17
18The October 4 installer export restored and verified nine databases and eleven roles from each cluster. Its complete archive is saved on the Mac at `/Users/clo/Library/Application Support/Zenith Recovery/postgres-backups/20261004T230507Z-e75419.tar`; every archived file hash and both physical cluster contents were checked against the server manifest. The production handoff is:
19
20```sh
21export STUDIO_LEGACY_HANDOFF=/mnt/storage1/apps/studio-handoff/20261004T230507Z-e75419
22```
23
24After NixOS has imported and unlocked the apps dataset, set `STUDIO_DEPLOY_HOST`, `STUDIO_DEPLOY_PORT`, and `STUDIO_LEGACY_HANDOFF` to that printed directory. The importers require the mounted pool's encrypted apps dataset at `/mnt/storage1/apps` and a stopped destination job. HedgeDoc and evil.inc Forgejo verify dump hashes and source table counts before restoring their PostgreSQL databases. Shale, Jellyfin, Navidrome, PDS, qBittorrent, Sonarr, Radarr, Jackett, and YouTube Triage can copy their retained app data without the old Docker daemon. Each importer prints its pre-import backup or ZFS snapshot.
25
26`import-legacy-secrets.sh` reads the retained old `.env` from the new host when `STUDIO_LEGACY_HANDOFF` is set. It sends only the requested keys into Snow Globe's Nomad variables; it does not print their values. The handoff directory must exist on the target. Without that variable, the script continues reading from the old Zenith host for a two-host migration.
27
28The handoff contains no Forgejo repository files. [import-evil-forgejo.sh](import-evil-forgejo.sh) checks its `evil-forgejo.dump`, secret fingerprints, and the stopped Snow Globe job, then copies the old 14 GB app directory directly from the mounted dataset. The Forgejo job stays stopped until its files, database, and account identities have been checked together.
tools/local-ai-cache.md+5-5
...@@ -20,7 +20,7 @@ plugin versions, key, KV layout, and parallel configuration. Corrupt blocks...@@ -20,7 +20,7 @@ plugin versions, key, KV layout, and parallel configuration. Corrupt blocks
20fall back to another copy or become misses. Key rotation invalidates reuse;20fall back to another copy or become misses. Key rotation invalidates reuse;
21old entries remain encrypted and subject to eviction.21old entries remain encrypted and subject to eviction.
2222
23`config/site.pkl` owns the NVMe path (`/var/cache/studio/local-ai` by default).23`config/site.pkl` owns the NVMe path (`/var/cache/snowglobe/local-ai` by default).
24The prepare hook creates it with the assigned service owner. HDD blocks use24The prepare hook creates it with the assigned service owner. HDD blocks use
25the managed service dataset. Fresh previews use separate managed directories25the managed service dataset. Fresh previews use separate managed directories
26for both disk tiers.26for both disk tiers.
...@@ -48,7 +48,7 @@ blocks totaling 1,912,086,528 bytes. Forced RAM/disk restore probes stopped...@@ -48,7 +48,7 @@ blocks totaling 1,912,086,528 bytes. Forced RAM/disk restore probes stopped
48when the endpoint reported busy; end-to-end disk restore timing remains48when the endpoint reported busy; end-to-end disk restore timing remains
49unverified.49unverified.
5050
51## Zenith measurements — 2026-10-0951## Snow Globe measurements — 2026-10-09
5252
53HyperQwen, vLLM 0.27.1, MTP with three draft tokens, 150,000-token53HyperQwen, vLLM 0.27.1, MTP with three draft tokens, 150,000-token
54context, GPU prefix caching enabled. Production stayed running; no cache54context, GPU prefix caching enabled. Production stayed running; no cache
...@@ -98,13 +98,13 @@ timings and counters; it never prints prompt text, generated text, or keys....@@ -98,13 +98,13 @@ timings and counters; it never prints prompt text, generated text, or keys.
9898
99```sh99```sh
100ssh -o BatchMode=yes root@10.0.0.1 \100ssh -o BatchMode=yes root@10.0.0.1 \
101 'pid=$(pgrep -x vllm); nsenter -t "$pid" -n python3 - prefill "$pid" --hostname zenith' \101 'pid=$(pgrep -x vllm); nsenter -t "$pid" -n python3 - prefill "$pid" --hostname snowglobe' \
102 < tools/benchmark-local-ai-cache.py102 < tools/benchmark-local-ai-cache.py
103ssh -o BatchMode=yes root@10.0.0.1 \103ssh -o BatchMode=yes root@10.0.0.1 \
104 'python3 - filesystem /srv/staging --hostname zenith' \104 'python3 - filesystem /srv/staging --hostname snowglobe' \
105 < tools/benchmark-local-ai-cache.py105 < tools/benchmark-local-ai-cache.py
106ssh -o BatchMode=yes root@10.0.0.1 \106ssh -o BatchMode=yes root@10.0.0.1 \
107 'python3 - filesystem /var/tmp --hostname zenith' \107 'python3 - filesystem /var/tmp --hostname snowglobe' \
108 < tools/benchmark-local-ai-cache.py108 < tools/benchmark-local-ai-cache.py
109```109```
110110
tools/local-vm.sh+3-3
...@@ -1,7 +1,7 @@...@@ -1,7 +1,7 @@
1#!/bin/sh1#!/bin/sh
2set -eu2set -eu
33
4cache=${STUDIO_VM_CACHE_DIR:-$HOME/Library/Caches/clover-studio-vm-x86}4cache=${SNOWGLOBE_VM_CACHE_DIR:-$HOME/Library/Caches/clover-snowglobe-vm-x86}
5mode=${1:-}5mode=${1:-}
6qemu=$(command -v qemu-system-x86_64 || true)6qemu=$(command -v qemu-system-x86_64 || true)
7if [ -z "$qemu" ]; then7if [ -z "$qemu" ]; then
...@@ -25,14 +25,14 @@ if [ "$mode" != installed ] && [ -f "$cache/nixos-minimal.iso" ]; then...@@ -25,14 +25,14 @@ if [ "$mode" != installed ] && [ -f "$cache/nixos-minimal.iso" ]; then
25 set -- -drive "file=$cache/nixos-minimal.iso,media=cdrom,readonly=on"25 set -- -drive "file=$cache/nixos-minimal.iso,media=cdrom,readonly=on"
26fi26fi
27if [ "$mode" = installed ]; then27if [ "$mode" = installed ]; then
28 media=${STUDIO_VM_MEDIA_SOURCE:-/Volumes/media}28 media=${SNOWGLOBE_VM_MEDIA_SOURCE:-/Volumes/media}
29 if ! mount | grep -F " on $media (" >/dev/null; then29 if ! mount | grep -F " on $media (" >/dev/null; then
30 echo "Mount the media share at $media before starting the VM" >&230 echo "Mount the media share at $media before starting the VM" >&2
31 exit 131 exit 1
32 fi32 fi
33 set -- "$@" -virtfs "local,path=$media,mount_tag=media,security_model=none,readonly=on"33 set -- "$@" -virtfs "local,path=$media,mount_tag=media,security_model=none,readonly=on"
34fi34fi
35if [ "${STUDIO_VM_HEADLESS:-0}" = 1 ]; then35if [ "${SNOWGLOBE_VM_HEADLESS:-0}" = 1 ]; then
36 set -- "$@" -display none -serial "file:$cache/serial.log" -daemonize -pidfile "$cache/qemu.pid"36 set -- "$@" -display none -serial "file:$cache/serial.log" -daemonize -pidfile "$cache/qemu.pid"
37else37else
38 set -- "$@" -display cocoa -serial mon:stdio38 set -- "$@" -display cocoa -serial mon:stdio
tools/log-shipper.py+2-2
...@@ -9,13 +9,13 @@ import time...@@ -9,13 +9,13 @@ import time
9from urllib.request import Request, urlopen9from urllib.request import Request, urlopen
1010
1111
12STATE = Path("/var/lib/studio/log-shipper.json")12STATE = Path("/var/lib/snowglobe/log-shipper.json")
13LOGS = Path("/var/lib/nomad/alloc")13LOGS = Path("/var/lib/nomad/alloc")
14CRI = re.compile(r"^(\S+) (stdout|stderr) [FP] ?(.*)$")14CRI = re.compile(r"^(\S+) (stdout|stderr) [FP] ?(.*)$")
1515
1616
17def nomad(path):17def nomad(path):
18 token = Path("/var/lib/studio/nomad.token").read_text().strip()18 token = Path("/var/lib/snowglobe/nomad.token").read_text().strip()
19 with urlopen(Request("http://127.0.0.1:4646" + path, headers={"X-Nomad-Token": token}), timeout=10) as response:19 with urlopen(Request("http://127.0.0.1:4646" + path, headers={"X-Nomad-Token": token}), timeout=10) as response:
20 return json.load(response)20 return json.load(response)
2121
tools/media-cutover.md deleted-222
...@@ -1,222 +0,0 @@
1# Media dataset cutover
2
3Before cutover, TrueNAS mounted `storage1/media` at `/mnt/storage1/media`. It is one 3.97 TiB ZFS filesystem containing `jellyfin`, `music`, `music_intake`, and `torrent`; `jellyfin` and `torrent` report the same filesystem device. The dataset had one snapshot with no clones at inspection. The VM reads it through a read-only mount at `/srv/clover/Media` without copying its contents.
4
5The Mac mounted the VM's `media` SMB share over Tailscale, listed the source folders, and received a write error for a test file. The `clover` share is writable in the VM; both shares use the same `clo` account.
6
7Zenith's NFSv4 ACLs need a separate [permission cutover](storage-acl-cutover.md) before this dataset is served by NixOS.
8
9The new layout needs that same dataset at `/srv/clover/Media`. A disposable VM test moved a ZFS filesystem beneath a different parent with `zfs rename`, changed its mountpoint, and confirmed that its snapshot, inode, and hardlinks survived. A second test renamed an independent encrypted root beneath another encrypted root; it remained its own encryption root. These test the ZFS operations, not the live Zenith cutover.
10
11Run the layout commands as root in the live installer, one step at a time. Stop on any error. The old writers and share services must be stopped; booting the installer leaves the old TrueNAS services stopped.
12
13### Reopen the inspected pool for writes
14
15The recovery inspection imported `storage1` read-only with an alternate root under `/run/infra2-inspection`. Export releases that import; it does not delete the pool. Reimport the verified data pool by its numeric ID, without an alternate root. `-N` leaves every dataset unmounted, `cachefile=none` avoids recording this temporary import, and `-f` permits the installer to take over the pool last used by TrueNAS. This ID identifies the four-disk data pool, not the NVMe's `boot-pool`.
16
17```sh
18zpool export storage1
19zpool import -N -f -d /dev/disk/by-id -o cachefile=none 8944904502819631621
20zpool get readonly,altroot storage1
21```
22
23The last command must show `readonly=off` and `altroot=-` before continuing. Leave `boot-pool` alone.
24
25### Record identity and take a snapshot
26
27Keep this shell open: `media_guid` records the dataset's identity for the check after renaming. The recursive snapshot captures all existing datasets' file state before cutover. It does not undo dataset names or mountpoint properties.
28
29```sh
30media_guid=$(zfs get -H -o value guid storage1/media)
31zfs snapshot -r storage1@before-infra2-layout
32```
33
34### Rename the pool to globe
35
36The top-level dataset has the pool's name. Rename it by exporting and importing the pool with a new name, not with `zfs rename`. These commands also work midway through the mountpoint changes below, provided the datasets remain unmounted.
37
38```sh
39zpool export storage1
40zpool import -N -d /dev/disk/by-id -o cachefile=none 8944904502819631621 globe
41zpool get guid,readonly,altroot globe
42zfs list -r -o name,mountpoint,mounted globe
43```
44
45Expect the same pool GUID `8944904502819631621`, `readonly=off`, and `altroot=-`. Every dataset and snapshot prefix becomes `globe/`; their GUIDs, encryption keys, and snapshots are retained. The explicit `/srv` mountpoint and pinned `/mnt/storage1/apps` path remain unchanged. The production configuration uses `globe` for imports and service startup checks. See [OpenZFS pool import](https://openzfs.github.io/openzfs-docs/man/master/8/zpool-import.8.html).
46
47From here onward, use `globe` in ZFS arguments. Keep `/mnt/storage1/apps` as a filesystem path: the legacy importers still read it there. Existing recovery exports label their keys with the original `storage1/...` names; those same keys now unlock the corresponding `globe/...` datasets.
48
49### Set the layout
50
51`mountpoint` controls where a dataset appears in the filesystem. `rename` changes its name and parent in the ZFS hierarchy. The `-u` flags update metadata without mounting datasets. Encrypted datasets can be renamed while locked; these commands do not change their keys or copy their file contents. See [OpenZFS rename](https://openzfs.github.io/openzfs-docs/man/master/8/zfs-rename.8.html) and [mountpoint properties](https://openzfs.github.io/openzfs-docs/man/master/7/zfsprops.7.html).
52
53| Command | Effect |
54| --- | --- |
55| `zfs set -u mountpoint=/mnt/storage1/apps globe/apps` | Pin the retained app tree at the path used by the legacy importers, before moving the pool root. |
56| `zfs set -u mountpoint=/srv globe` | Move the pool's root mountpoint; default-mountpoint children such as backups, logs, and mirrors follow it. |
57| `zfs set -u mountpoint=/srv/clover globe/clover` | Set Clover's mount location. Its dataset name stays `globe/clover`. |
58| `zfs rename -u globe/media globe/clover/Media` | Move the existing Media dataset beneath Clover and capitalize its name. Its snapshots stay attached to the same dataset. |
59| `zfs set -u mountpoint=/srv/clover/Media globe/clover/Media` | Set Media's mount location. It remains an independent encryption root with its original key. |
60
61The destination dataset must not already exist, and the `Media` directory inside Clover must be absent or empty before mounting there. The live inspection checked both on 2026-10-04: the dataset and directory were absent.
62
63### Verify before mounting
64
65```sh
66test "$(zfs get -H -o value guid globe/clover/Media)" = "$media_guid"
67zfs list -o name,mountpoint,mounted globe globe/apps globe/clover globe/clover/Media
68zfs get encryptionroot globe/apps globe/clover globe/clover/Media
69zfs list -t snapshot -r -o name globe/clover/Media
70```
71
72The identity check must succeed. Expect these mountpoint properties, with `mounted=no` throughout:
73
74```text
75globe /srv
76globe/apps /mnt/storage1/apps
77globe/clover /srv/clover
78globe/clover/Media /srv/clover/Media
79```
80
81Media's `encryptionroot` must be `globe/clover/Media`, not `globe/clover`; apps and Clover must remain their own encryption roots. Media's original snapshots should now use its new dataset prefix, alongside `@before-infra2-layout`. Loading keys and mounting the filesystems follow this metadata check; permission conversion is covered in [storage-acl-cutover.md](storage-acl-cutover.md). Preserve the old NVMe until the PostgreSQL handoff in [legacy-handoff.md](legacy-handoff.md) is verified.
82
83A disposable pool with an altroot reproduced the default child's move when the parent mountpoint changed, then kept the old child path after an explicit mountpoint was set. After loading keys and mounting, Clover and Media must resolve to distinct ZFS filesystems before starting Snow Globe; `tools/studio.py pool` enforces this. Check a known hardlinked download/library pair by device and inode, then verify Jellyfin and Navidrome library paths inside their containers.
84
85The root change also relocates other default-mountpoint children: `backup` (including the 2.07 TB `backup/sandwich`), `mirrors` (266 GB), `agent`, `homes`, `logs`, and `.ix-virt`. They remain datasets under `/srv` until deliberately renamed; the move does not copy their data. `ix-apps` has a local `/mnt/.ix-apps` mountpoint and `.system` uses `legacy`, so neither follows the root. Preserve these datasets during cutover.
86
87### Remove retired app clones and the rehearsal store
88
89The five `apps-hourly-…-clone` entries are cloned filesystems, distinct from the original `globe/apps@hourly-…` snapshots. The rehearsal store is `globe/apps/snowglobe-rehearsal-20261002` (59.8 GiB at inspection). The live installer inspection on 2026-10-04 confirmed that all six are unmounted, and `zfs destroy -nvr` previews succeeded: each would delete only the named filesystem and its own `@before-infra2-layout` snapshot.
90
91These commands permanently remove those six retired filesystems and their snapshots. They preserve `globe/apps`, its original hourly snapshots, and the other datasets' cutover snapshots. Run one command at a time and stop on an error. To preview a command again, replace `-vr` with `-nvr`; lowercase `-r` includes the target's children and snapshots. Do not use uppercase `-R`, which also destroys dependent clones outside the target hierarchy. See [OpenZFS destroy](https://openzfs.github.io/openzfs-docs/man/master/8/zfs-destroy.8.html).
92
93```sh
94zfs destroy -vr globe/apps-hourly-2026-09-06_21-00-clone
95zfs destroy -vr globe/apps-hourly-2026-09-08_23-00-clone
96zfs destroy -vr globe/apps-hourly-2026-09-11_07-00-clone
97zfs destroy -vr globe/apps-hourly-2026-09-11_12-00-clone
98zfs destroy -vr globe/apps-hourly-2026-09-12_14-00-clone
99zfs destroy -vr globe/apps/snowglobe-rehearsal-20261002
100```
101
102Check the remaining app datasets and source snapshots afterward:
103
104```sh
105zfs list -r -o name,used,mountpoint globe/apps
106zfs list -t snapshot -d 1 -o name globe/apps
107```
108
109### Unlock and mount Clover and Media
110
111Clover and Media are independent encryption roots, so each needs its original key. The recovery export labels these `storage1/clover` and `storage1/media`, respectively. For the installer commands below, the recovered keys must be available as `/run/infra2-keys/clover.hex` and `/run/infra2-keys/media.hex`, with directory mode `0700` and file mode `0600`, owned by root. These temporary files disappear at reboot; recover them from the private archive again if needed. Keep keys out of this repository and terminal output.
112
113Run one command at a time and stop on errors. Mount the pool root if needed, then verify that `/srv` is its actual mountpoint:
114
115```sh
116if [ "$(zfs get -H -o value mounted globe)" = no ]; then zfs mount globe; fi
117test "$(findmnt -n -o SOURCE --mountpoint /srv)" = globe
118```
119
120Load the two keys, mount Clover before its Media child, then remove the temporary key files after both mounts succeed. `-L` overrides the key source for this command without changing the datasets' persistent `keylocation=prompt`. Loading keys alone does not mount them; see [OpenZFS load-key](https://openzfs.github.io/openzfs-docs/man/master/8/zfs-load-key.8.html). Use ordinary [ZFS mounts](https://openzfs.github.io/openzfs-docs/man/master/8/zfs-mount.8.html), without overlay options; stop if the Media mountpoint is nonempty.
121
122```sh
123zfs load-key -L file:///run/infra2-keys/clover.hex globe/clover
124zfs load-key -L file:///run/infra2-keys/media.hex globe/clover/Media
125zfs mount globe/clover
126zfs mount globe/clover/Media
127rm /run/infra2-keys/clover.hex /run/infra2-keys/media.hex
128test "$(findmnt -n -o SOURCE --mountpoint /srv/clover)" = globe/clover
129test "$(findmnt -n -o SOURCE --mountpoint /srv/clover/Media)" = globe/clover/Media
130findmnt -rn -o SOURCE,TARGET,FSTYPE --mountpoint /srv/clover/Media
131```
132
133The last command must show `globe/clover/Media /srv/clover/Media zfs`. This mounts only Clover and Media beneath the pool root. Continue to the folder renames below after these checks succeed. Root can perform these renames; service access still requires the separate ACL cutover.
134
135### Unlock retained apps for the legacy handoff
136
137The original apps key is labeled `storage1/apps` in the recovery export. Prepare it as `/run/infra2-keys/apps.hex` with the same root-only permissions as the Clover and Media keys. Unlock and mount the retained dataset at its pinned legacy path:
138
139```sh
140zfs load-key -L file:///run/infra2-keys/apps.hex globe/apps
141zfs mount globe/apps
142rm /run/infra2-keys/apps.hex
143test "$(findmnt -n -o SOURCE --mountpoint /mnt/storage1/apps)" = globe/apps
144findmnt -rn -o SOURCE,TARGET,FSTYPE --mountpoint /mnt/storage1/apps
145```
146
147Expect `globe/apps /mnt/storage1/apps zfs`. Keep this path intact for the [legacy handoff](legacy-handoff.md); mounting the dataset does not start the old apps.
148
149### Keys after installation
150
151The recovery keys remain in the private recovery archive on the Mac. The `/run/infra2-keys` files above are temporary transfer copies; after `load-key`, ZFS holds the loaded key material in memory, so deleting those files does not relock mounted datasets. Reboot loses the loaded keys. The datasets retain `keylocation=prompt` for manual recovery; the installed target loads TPM-encrypted credentials before mounting them. Nomad's mount checks prevent it from starting against locked data.
152
153Zenith's enabled TPM 2.0 (`/dev/tpm0` and `/dev/tpmrm0`) sealed and decrypted all six encryption-root keys during installation preparation on 2026-10-04. A systemd service test successfully loaded the encrypted credentials and unlocked the previously locked logs dataset. [zenith-hardware.md](zenith-hardware.md) records their recovery locations and the installed boot service; the root names and credential paths have one home in [zenith.nix](../nixos/zenith.nix).
154
155[TPM-encrypted systemd credentials](https://github.com/systemd/systemd/blob/main/man/systemd-creds.xml) keep encrypted key blobs on the NVMe and supply decrypted credentials in RAM. These credentials bind to the original TPM and PCR 7. Secure Boot is disabled, so this supplies convenient automatic unlock and protection for detached drives, without establishing a trusted boot chain. Firmware changes affecting PCR 7 or a TPM reset can require resealing the credentials from the recovery keys.
156
157Manual unlock over root SSH remains the recovery path: recover the relevant key to a private `/run` file, use `zfs load-key -L file:///run/<key-file> <dataset>`, remove that file, then mount the dataset. Keep the off-server keys when replacing hardware; encrypted blobs from the old TPM cannot unlock on a replacement machine.
158
159### Rename the media folders
160
161Clover and Media both report `casesensitivity=insensitive` on the live pool. Names differing only by capitalization resolve to the same entry. For a case-only folder rename, use an unused temporary name; ordinary `mv music Music` interprets the existing destination directory as a request to move `music` inside itself. From the Media directory:
162
163```sh
164test ! -e .music-case-rename && test ! -L .music-case-rename &&
165mv -T -- music .music-case-rename &&
166mv -T -- .music-case-rename Music
167```
168
169Lowercase configured paths still resolve after a case-only rename; do not create a separate `music -> Music` or `seedbox -> Seedbox` alias, because those names collide on this filesystem. The distinct `torrent` alias below preserves the old host path. qBittorrent also receives a container mount at `/data/media/torrent` pointing to `Seedbox`, so its saved torrent paths remain valid.
170
171Zenith's qBittorrent `BT_backup` is 21 MB. A checksum-verified copy contained 544 complete bencoded resume files. Their `save_path` values include 498 at `/data/media/torrent`, three in its subfolders, and 43 in Jellyfin folders; 543 also set `qBt-downloadPath` to `/data/media/torrent`. Keep these saved paths working by renaming the real media folder and leaving a relative compatibility symlink, after the media dataset is mounted at its new path and the old writers are stopped:
172
173```sh
174test -d /srv/clover/Media/torrent
175test ! -e /srv/clover/Media/Seedbox
176mv /srv/clover/Media/torrent /srv/clover/Media/Seedbox
177ln -s Seedbox /srv/clover/Media/torrent
178test "$(stat -c %d:%i /srv/clover/Media/Seedbox)" = "$(stat -Lc %d:%i /srv/clover/Media/torrent)"
179```
180
181The same-dataset rename preserves existing hardlinks. New downloads use `/data/media/Seedbox`; saved torrents continue to resolve through `/data/media/torrent`. If `Seedbox` and the `torrent` alias already exist, skip the rename and verify their device/inode identity. Rename the existing music intake folder after stopping YouTube Triage, then keep its current container path working through a relative symlink:
182
183```sh
184test -d /srv/clover/Media/music_intake
185test ! -e '/srv/clover/Media/Intake - Music'
186mv /srv/clover/Media/music_intake '/srv/clover/Media/Intake - Music'
187ln -s 'Intake - Music' /srv/clover/Media/music_intake
188```
189
190### Service paths for the reorganized tree
191
192The service definitions read the current capitalized host folders. Jellyfin and qBittorrent retain their saved paths inside the containers through individual bind mounts; the host needs no `jellyfin` compatibility directory. The shared folder mapping is defined once in [config/site.pkl](../config/site.pkl), under `jellyfinFolders`. Jellyfin mounts its entries beneath `/media/jellyfin`; qBittorrent mounts them beneath `/data/media/jellyfin` and mounts `Seedbox` at both `/data/media/Seedbox` and `/data/media/torrent`.
193
194Navidrome mounts `Music` at `/music`. Jellyfin and Navidrome mounts remain read-only; qBittorrent follows `site.mediaReadOnly`, so read-only rehearsals stay read-only. Keeping the recorded Jellyfin paths follows its [migration guidance](https://jellyfin.org/docs/general/administration/migrate/) and avoids rewriting its database paths or library settings.
195
196Before reorganization, YouTube Archiver kept its download archive JSON beside the videos in `Media/jellyfin/Independent`, not in its `/config` cache ([upstream archive behavior](https://github.com/jmbannon/ytdl-sub/wiki/5.-Optimizing-Your-First-Config)). The source inspection found 12 archive files there (52,345 bytes), and all 12 were visible through the VM's read-only media mount. That folder now lives at `Media/Videos/Independent`; preserve its archive files with the videos. The old app directory contained only a lock, cache, and empty work directory.
197
198The complete 33 MB qBittorrent config was also copied into a disposable ZFS clone in the VM. The pinned container started with `--network none` and no media mount; its API loaded all 544 torrents. All reported `missingFiles`, as expected without `/data/media`. One resume file without `qBt-savePath` adopted the new default `/data/media/seedbox`; the other 543 retained their saved paths. The container, clone, and copied config were removed after the test.
199
200A second disposable restore copied Zenith's qBittorrent profile into the VM and mounted the real read-only media through a temporary `/data/media/seedbox` alias, with `torrent -> seedbox` alongside it. The container ran as UID 3000 with no network and a read-only root filesystem. Its API loaded all 544 torrents; after resume checks, all 544 reported 100% progress, with 539 `queuedUP`, three `stalledUP`, two `forcedUP`, and none `missingFiles`. The container resolved the legacy symlink, and its temporary profile was removed. This tests the saved paths and source files through the VM mount; the actual Zenith folder has not yet been renamed.
201
202The old resume files are owned by UID 3000, while Snow Globe assigns qBittorrent UID 3114. [import-qbittorrent.sh](import-qbittorrent.sh) copies the stopped old profile into the stopped Snow Globe service's dataset, snapshots the destination, checks the copy, changes ownership, applies the new save path, and starts the service. It refuses to run while Zenith's qBittorrent is active. In a disposable VM restore, UID 3114 loaded all 544 imported torrents without a media mount; all correctly reported `missingFiles`. With the same read-only media alias and legacy symlink as above, all 544 reached 100% progress and none remained `missingFiles`.
203
204The production importer requires the real Media ZFS mount and a `torrent` symlink resolving to the same directory as `Seedbox` before it starts qBittorrent. It compares device/inode identity, so `torrent -> Seedbox/` is accepted. For a same-machine OS replacement, set `STUDIO_LEGACY_HANDOFF` to the [offline handoff](legacy-handoff.md) directory; the profile copy then reads the retained old apps dataset without old Docker.
205
206The PIA credentials are the two lines in `~/pia.txt` on the Mac (username, then password). With `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT` set for production, import them through `python3 tools/deploy.py secrets qbittorrent --file ~/pia.txt --key vpn_user --key vpn_pass` before deploying qBittorrent. The CLI requires a private file, sends its contents to the target over SSH, and does not print the values.
207
208At the 2026-09-26 check, Zenith's Sonarr and Radarr databases each had an enabled qBittorrent client and enabled RSS indexers; the VM's production and preview copies had both disabled. The preview setup disables every indexer's RSS and automatic search, including Sonarr's built-in EZTV indexer, while leaving the source untouched. A production [ARR import](import-arr.sh) now requires the corresponding Zenith container to be stopped before copying its database, and checks it remains stopped when the copy finishes. Reenable downloads only after the media dataset is writable at the final mountpoint and qBittorrent's imported profile is serving the same paths.
209
210After a same-machine OS replacement, `STUDIO_LEGACY_HANDOFF` makes the Sonarr and Radarr importer read their stopped databases and app files from the mounted old apps dataset on the new host. A read-only SQLite backup and integrity check passed for each old database.
211
212The VM runs Sonarr `4.0.20.3014` and Radarr `6.4.4.10685`. [Sonarr v4's External mode](https://wiki.servarr.com/sonarr/settings) delegates authentication to a reverse proxy, and [Radarr's current FAQ](https://wiki.servarr.com/radarr/faq) says native OIDC is unsupported. Sonarr's [v5 development settings](https://github.com/Sonarr/Sonarr/blob/v5-develop/src/Sonarr.Api.V5/Settings/GeneralSettingsResource.cs) contain OIDC fields; the latest stable [Sonarr release](https://github.com/Sonarr/Sonarr/releases) remains v4 at this check. Both pinned services use Caddy Forward Auth with External mode. Unauthenticated UI and API requests redirected to sign-in, and forged identity headers sent from the Mac still received HTTP 302 over trusted TLS. Nomad advertised their application ports only on `127.0.0.1`.
213
214[import-jackett.sh](import-jackett.sh) makes the Jackett dependency repeatable: previews copy the latest read-only Zenith app snapshot; production import requires both old and new Jackett stopped. The restored preview kept the same API key as Zenith and the VM's production Jackett, preserved all three indexer definitions, and served `t=caps` for Nyaa and Pirate Bay with HTTP 200. The imported Sonarr and Radarr Jackett indexers use that same key and point to the current Nomad Jackett endpoint.
215
216With `STUDIO_LEGACY_HANDOFF` set, production Jackett import reads its retained config from the new host's mounted old apps dataset after reboot; it no longer needs the old Docker host.
217
218Sonarr and Radarr persist their Jackett and qBittorrent endpoints in their databases, so those two internal ports are static (`30017` and `30038`) across allocation changes. On the VM, both apps' saved Jackett URLs matched the current reserved port. Their public HTTPS routes still use separate Caddy endpoints and forward auth.
219
220[import-navidrome.sh](import-navidrome.sh) restores the old `navidrone` app directory into Navidrome's managed dataset. The preview imported Zenith's `storage1/apps@hourly-2026-09-26_02-00` snapshot, migrated the database under the pinned image, and passed SQLite integrity and HTTP health checks. Its three users, 10,945 media files, 1,046 albums, and 2,655 artists matched the source snapshot; `snow` remained an administrator. A `Remote-User: snow` request to the production Navidrome API returned the existing `snow` user, proving that its external-auth setting accepts the proxy's header. The preview's database is retained, but its job is stopped while the Jackett preview uses the VM's limited memory. Production import requires both Navidrome jobs stopped and the real Media dataset mounted as ZFS.
221
222For a same-machine OS replacement, set `STUDIO_LEGACY_HANDOFF` to the [offline handoff](legacy-handoff.md) directory when importing production Jellyfin or Navidrome. Both importers read their retained app data directly from the mounted old apps dataset on the new host; the Media library stays on its ZFS dataset.
tools/namespace-transition-test.py created+338
...@@ -0,0 +1,338 @@
1#!/usr/bin/env python3
2from importlib import import_module
3import io
4import json
5import os
6from pathlib import Path
7import shutil
8import subprocess
9import sys
10import tempfile
11from types import SimpleNamespace
12import unittest
13from unittest.mock import patch
14import xml.etree.ElementTree as ET
15
16import release
17import snowglobe
18
19
20transition = import_module("namespace-transition")
21
22
23class NamespaceTransition(unittest.TestCase):
24 def setUp(self):
25 temporary = tempfile.TemporaryDirectory()
26 self.addCleanup(temporary.cleanup)
27 self.root = Path(temporary.name).resolve()
28 self.directories = tuple((self.root / parent / "snowglobe", self.root / parent / transition.PREVIOUS)
29 for parent in ("opt", "state", "assets", "cache"))
30 self.addCleanup(patch.stopall)
31 patch.object(transition, "DIRECTORIES", self.directories).start()
32 registry = self.root / "nixos"
33 registry.mkdir()
34 patch.object(transition, "NIXOS_STATE", registry).start()
35 patch.object(transition.pwd, "getpwnam", side_effect=KeyError).start()
36 patch.object(transition.grp, "getgrnam", side_effect=KeyError).start()
37
38 def test_staging_aliases_share_existing_state_and_never_seed_another_registry(self):
39 for _, old in self.directories:
40 old.mkdir(parents=True)
41 new, old = self.directories[1]
42 (old / "identities.json").write_text('{"knife":3132}')
43 transition.prepare()
44 transition.prepare()
45 self.assertTrue(new.is_symlink())
46 self.assertEqual(new.resolve(), old)
47 (new / "identities.json").write_text('{"knife":3132,"dashboard":3133}')
48 self.assertEqual(json.loads((old / "identities.json").read_text()), {"knife": 3132, "dashboard": 3133})
49 self.assertTrue(all(new.resolve() == old for new, old in self.directories))
50
51 def test_staging_bootstrap_starts_the_installed_router_generation_without_restart(self):
52 state = self.root / "bootstrap"
53 state.mkdir()
54 for name in ("nomad", "router", "dashboard"):
55 (state / (name + ".token")).write_text("disposable-" + name)
56 original = transition.layout
57 source = self.root / "installed"
58 (source / "tools").mkdir(parents=True)
59 (source / "tools" / (transition.PREVIOUS + ".py")).touch()
60 with patch.object(snowglobe, "STATE", state), patch.object(snowglobe, "token"), patch.object(
61 snowglobe.os, "geteuid", return_value=0,
62 ), patch.object(Path, "is_symlink", return_value=True), patch.object(
63 transition, "layout", return_value=original(source),
64 ), patch.object(snowglobe, "command", return_value=subprocess.CompletedProcess([], 0)) as command:
65 snowglobe.bootstrap([])
66 units = [call.args for call in command.call_args_list if call.args[0] == "systemctl"]
67 self.assertEqual(units, [("systemctl", "start", transition.PREVIOUS + "-router.service")])
68
69 def test_split_state_is_rejected_before_any_alias_is_created(self):
70 self.directories[0][1].mkdir(parents=True)
71 new, old = self.directories[1]
72 new.mkdir(parents=True)
73 old.mkdir()
74 with self.assertRaisesRegex(ValueError, "independent control stores"):
75 transition.prepare()
76 self.assertFalse(self.directories[0][0].exists())
77
78 def test_promotion_preserves_whole_stores_and_release_links_then_is_idempotent(self):
79 revision = "1" * 16
80 for _, old in self.directories:
81 old.mkdir(parents=True)
82 (old / "durable").write_text("existing bytes")
83 (old / "durable").chmod(0o600)
84 new_root, old_root = self.directories[0]
85 (old_root / "releases" / revision).mkdir(parents=True)
86 for name in ("current", "main"):
87 (old_root / name).symlink_to(old_root / "releases" / revision)
88 before = [(old / "durable").stat().st_ino for _, old in self.directories]
89 with patch.object(transition.subprocess, "run", return_value=subprocess.CompletedProcess([], 0)) as run, patch.object(
90 transition, "migrate_policies",
91 ) as policies:
92 transition.promote(self.root)
93 policies.assert_called_once_with(self.root, self.directories[1][0])
94 self.assertEqual(run.call_count, 6)
95 transition.promote(self.root)
96 self.assertEqual(run.call_count, 6)
97 for index, (new, old) in enumerate(self.directories):
98 self.assertFalse(new.is_symlink())
99 self.assertTrue(old.is_symlink())
100 self.assertEqual((new / "durable").stat().st_ino, before[index])
101 self.assertEqual((new / "durable").stat().st_mode & 0o777, 0o600)
102 for name in ("current", "main"):
103 self.assertEqual(os.readlink(new_root / name), str(new_root / "releases" / revision))
104
105 def test_old_release_manifest_and_canonical_alias_validate_without_rewriting_the_tree(self):
106 new_root, old_root = self.directories[0]
107 revision = "a" * 16
108 source = old_root / "releases" / revision
109 (source / "tools").mkdir(parents=True)
110 (source / "tools" / (transition.PREVIOUS + ".py")).write_text("immutable")
111 manifest = source / ("." + transition.PREVIOUS + "-release.json")
112 manifest.write_text(json.dumps({"id": revision, "digest": release.tree_digest(source), "version": 2}))
113 original = manifest.read_bytes()
114 (old_root / "current").symlink_to(source)
115 transition.prepare()
116 with patch.object(release, "ROOT", new_root), patch.object(release, "RELEASES", new_root / "releases"):
117 self.assertEqual(release.current_release(), revision)
118 self.assertEqual(release.check_release(revision).resolve(), source)
119 self.assertEqual(manifest.read_bytes(), original)
120
121 def test_old_release_activation_uses_its_units_script_and_environment(self):
122 revision = "b" * 16
123 source = self.root / "release"
124 (source / "tools").mkdir(parents=True)
125 (source / "tools" / (transition.PREVIOUS + ".py")).touch()
126 (source / "nixos").mkdir()
127 (source / "nixos/dashboard.nix").touch()
128 transition.layout(source)["manifest"].write_text('{"version":2}')
129 observed = []
130
131 def run(argv, **kwargs):
132 observed.append((argv, kwargs))
133 return subprocess.CompletedProcess(argv, 0, '"leader"')
134
135 with patch.dict(os.environ, {"SNOWGLOBE_POOL": "globe"}), patch.object(release, "ROOT", self.root), patch.object(
136 release, "STATE", self.root,
137 ), patch.object(release, "check_release", return_value=source), patch.object(
138 release, "current_release", return_value=None,
139 ), patch.object(release, "host_digest", return_value="different"), patch.object(
140 release, "host_configuration", return_value=transition.NAMESPACE["previousHost"],
141 ), patch.object(release, "jobs", return_value=set()), patch.object(
142 release.os, "uname", return_value=SimpleNamespace(nodename="snowglobe"),
143 ), patch.object(release.subprocess, "run", side_effect=run), patch.object(transition, "activate") as activate:
144 release.activate(revision, initial=True)
145 activate.assert_called_once_with(source)
146 scripts = [(argv, kwargs) for argv, kwargs in observed if argv[0] == "python3"]
147 self.assertEqual([argv[-1] for argv, _ in scripts], ["preflight", "pool", "deploy", "check"])
148 self.assertTrue(all(argv[1].endswith("/" + transition.PREVIOUS + ".py") for argv, _ in scripts))
149 self.assertTrue(all(kwargs["env"][transition.PREVIOUS.upper() + "_POOL"] == "globe" for _, kwargs in scripts))
150 self.assertIn(["systemctl", "restart", transition.PREVIOUS + "-router.service"], [argv for argv, _ in observed])
151
152 def test_policy_attachment_changes_after_new_policy_exists_without_changing_token_files(self):
153 state = self.root / "state"
154 state.mkdir()
155 for name in ("nomad", "router", "dashboard"):
156 (state / (name + ".token")).write_text("disposable-" + name)
157 responses = [io.BytesIO(json.dumps({"Name": transition.PREVIOUS + "-" + consumer,
158 "AccessorID": consumer, "Policies": [transition.PREVIOUS + "-" + consumer, "other"]}).encode())
159 for consumer in ("router", "dashboard")]
160 with patch.object(transition.urllib.request, "urlopen", side_effect=responses), patch.object(
161 transition.subprocess, "run", return_value=subprocess.CompletedProcess([], 0),
162 ) as run:
163 transition.migrate_policies(self.root, state)
164 commands = [call.args[0] for call in run.call_args_list]
165 for index, consumer in enumerate(("router", "dashboard")):
166 self.assertEqual(commands[index * 2][:5], ["nomad", "acl", "policy", "apply", "snowglobe-" + consumer])
167 self.assertIn("-policy=snowglobe-" + consumer, commands[index * 2 + 1])
168 self.assertIn("-policy=other", commands[index * 2 + 1])
169 self.assertFalse(any("disposable" in argument for argument in commands[index * 2 + 1]))
170 self.assertEqual((state / (consumer + ".token")).read_text(), "disposable-" + consumer)
171
172 def test_existing_vm_owner_profile_and_seed_still_resolve(self):
173 old = "https://paperclover.net/" + transition.PREVIOUS
174 root = ET.fromstring(f'<domain><metadata><vm xmlns="{old}"><owner>owner-id</owner><hardwareProfile>windows-q35-secure</hardwareProfile></vm></metadata><devices><disk><serial>{transition.PREVIOUS}-cloud-init</serial></disk></devices></domain>')
175 transition.normalize_vm(root)
176 namespace = "{https://paperclover.net/snowglobe}"
177 self.assertEqual(root.findtext(f"metadata/{namespace}vm/{namespace}owner"), "owner-id")
178 self.assertEqual(root.findtext(f"metadata/{namespace}vm/{namespace}hardwareProfile"), "windows-q35-secure")
179 self.assertEqual(root.findtext("devices/disk/serial"), "snowglobe-cloud-init")
180
181 def test_account_and_nixos_registries_round_trip_with_fixed_numeric_ownership(self):
182 old, new = transition.PREVIOUS + "-dashboard", "snowglobe-dashboard"
183 users = {old: SimpleNamespace(pw_uid=997, pw_gid=994)}
184 groups = {old: SimpleNamespace(gr_gid=994)}
185 registry = transition.NIXOS_STATE
186 (registry / "uid-map").write_text(json.dumps({old: 997, "other": 888}))
187 (registry / "gid-map").write_text(json.dumps({old: 994}))
188 for name in ("declarative-users", "declarative-groups"):
189 (registry / name).write_text("root " + old + "\n")
190
191 def lookup(values, name):
192 if name not in values:
193 raise KeyError(name)
194 return values[name]
195
196 calls = []
197
198 def command(argv, **kwargs):
199 calls.append(argv)
200 if argv[0] == "groupmod":
201 groups[argv[2]] = groups.pop(argv[3])
202 if argv[0] == "usermod":
203 users[argv[2]] = users.pop(argv[3])
204 return subprocess.CompletedProcess(argv, 0)
205
206 for _, directory in self.directories:
207 directory.mkdir(parents=True)
208 release_path = self.directories[0][1] / "releases" / ("c" * 16)
209 (release_path / "tools").mkdir(parents=True)
210 (release_path / "tools/snowglobe.py").touch()
211 transition.prepare()
212 canonical_release = self.directories[0][0] / "releases" / release_path.name
213 with patch.object(transition, "NIXOS_STATE", registry), patch.object(
214 transition.pwd, "getpwnam", side_effect=lambda name: lookup(users, name),
215 ), patch.object(transition.grp, "getgrnam", side_effect=lambda name: lookup(groups, name)), patch.object(
216 transition.subprocess, "run", side_effect=command,
217 ), patch.object(transition, "migrate_policies"):
218 transition.activate(canonical_release)
219 self.assertEqual(set(users), {new})
220 self.assertEqual((users[new].pw_uid, users[new].pw_gid, groups[new].gr_gid), (997, 994, 994))
221 self.assertEqual(json.loads((registry / "uid-map").read_text()), {new: 997, "other": 888})
222 self.assertEqual((registry / "declarative-users").read_text().split(), ["root", new])
223 previous_release = self.directories[0][0] / "releases" / ("d" * 16)
224 (previous_release / "tools").mkdir(parents=True)
225 (previous_release / "tools" / (transition.PREVIOUS + ".py")).touch()
226 transition.activate(previous_release)
227 self.assertEqual(set(users), {old})
228 self.assertEqual((users[old].pw_uid, users[old].pw_gid, groups[old].gr_gid), (997, 994, 994))
229 self.assertEqual(json.loads((registry / "uid-map").read_text()), {old: 997, "other": 888})
230 self.assertEqual((registry / "declarative-users").read_text().split(), ["root", old])
231 self.assertEqual(calls[0], ["systemctl", "stop", old])
232 self.assertEqual(calls[8], ["systemctl", "stop", new])
233
234 def test_policy_failure_after_directory_move_is_retried_without_moving_state_again(self):
235 for _, old in self.directories:
236 old.mkdir(parents=True)
237 with patch.object(transition.subprocess, "run", return_value=subprocess.CompletedProcess([], 0)) as run, patch.object(
238 transition, "migrate_policies", side_effect=[RuntimeError("interrupted ACL update"), None],
239 ) as policies:
240 with self.assertRaisesRegex(RuntimeError, "ACL update"):
241 transition.promote(self.root)
242 before = [new.stat().st_ino for new, _ in self.directories]
243 transition.promote(self.root)
244 self.assertEqual(policies.call_count, 2)
245 self.assertEqual(run.call_count, 6)
246 self.assertEqual(before, [new.stat().st_ino for new, _ in self.directories])
247
248 def test_only_legacy_transition_stops_the_retired_window_proxy(self):
249 with patch.object(transition.subprocess, "run", return_value=subprocess.CompletedProcess([], 0)) as run:
250 transition.stop_units(transition.PREVIOUS)
251 previous = [call.args[0] for call in run.call_args_list]
252 run.reset_mock()
253 transition.stop_units("snowglobe")
254 canonical = [call.args[0] for call in run.call_args_list]
255 self.assertIn(["systemctl", "stop", transition.PREVIOUS + "-vm-window-host-proxy"], previous)
256 self.assertFalse(any("vm-window-host-proxy" in command[-1] for command in canonical))
257 self.assertTrue(all(command[:2] == ["systemctl", "stop"] for command in previous + canonical))
258
259 def test_missing_reverse_alias_after_directory_move_is_recovered_from_old_releases(self):
260 new, old = self.directories[0]
261 source = new / "releases" / ("e" * 16) / "tools"
262 source.mkdir(parents=True)
263 (source / (transition.PREVIOUS + ".py")).touch()
264 transition.prepare()
265 self.assertTrue(old.is_symlink())
266 self.assertEqual(old.resolve(), new)
267
268 @unittest.skipUnless(sys.platform == "linux" and os.geteuid() == 0 and shutil.which("usermod") and shutil.which("groupmod"),
269 "requires Linux root and shadow tools; all account files stay inside a temporary prefix")
270 def test_real_shadow_tools_and_interrupted_registry_update_resume_with_only_fixture_accounts(self):
271 old, new = transition.PREVIOUS + "-dashboard", "snowglobe-dashboard"
272 prefix = self.root / "accounts"
273 etc = prefix / "etc"
274 etc.mkdir(parents=True)
275 (etc / "passwd").write_text(f"{old}:x:997:994:fixture:/var/empty:/bin/false\n")
276 (etc / "group").write_text(f"{old}:x:994:\n")
277 (etc / "shadow").write_text(f"{old}:!:1:0:99999:7:::\n")
278 (etc / "gshadow").write_text(f"{old}:!::\n")
279 for name in ("shadow", "gshadow"):
280 (etc / name).chmod(0o600)
281 (etc / "login.defs").write_text("")
282 registry = transition.NIXOS_STATE
283 for name, value in (("uid-map", 997), ("gid-map", 994)):
284 (registry / name).write_text(json.dumps({old: value}))
285 for name in ("declarative-users", "declarative-groups"):
286 (registry / name).write_text(old + "\n")
287 command = subprocess.run
288 replace = Path.replace
289 fail_login = True
290 fail_registry = True
291
292 def run(argv, **kwargs):
293 nonlocal fail_login
294 self.assertIn(argv[0], {"usermod", "groupmod"})
295 if argv[0] == "usermod" and fail_login:
296 fail_login = False
297 raise subprocess.CalledProcessError(1, argv)
298 return command([argv[0], "--prefix", str(prefix), *argv[1:]], **kwargs)
299
300 def atomic_replace(path, target):
301 nonlocal fail_registry
302 if Path(target) == registry / "gid-map" and fail_registry:
303 fail_registry = False
304 raise OSError("interrupted registry write")
305 return replace(path, target)
306
307 def user(name):
308 fields = (etc / "passwd").read_text().splitlines()[0].split(":")
309 if fields[0] != name:
310 raise KeyError(name)
311 return SimpleNamespace(pw_uid=int(fields[2]), pw_gid=int(fields[3]))
312
313 def group(name):
314 fields = (etc / "group").read_text().splitlines()[0].split(":")
315 if fields[0] != name:
316 raise KeyError(name)
317 return SimpleNamespace(gr_gid=int(fields[2]))
318
319 with patch.object(transition.pwd, "getpwnam", side_effect=user), patch.object(
320 transition.grp, "getgrnam", side_effect=group,
321 ), patch.object(transition.subprocess, "run", side_effect=run), patch.object(Path, "replace", atomic_replace):
322 with self.assertRaises(subprocess.CalledProcessError):
323 transition.rename_identity(transition.identity_change("snowglobe"))
324 self.assertEqual(group(new).gr_gid, 994)
325 self.assertEqual(user(old).pw_uid, 997)
326 with self.assertRaisesRegex(OSError, "registry write"):
327 transition.rename_identity(transition.identity_change("snowglobe"))
328 self.assertEqual(user(new).pw_uid, 997)
329 transition.rename_identity(transition.identity_change("snowglobe"))
330 self.assertIsNone(transition.identity_change("snowglobe"))
331 self.assertEqual(json.loads((registry / "gid-map").read_text()), {new: 994})
332 transition.rename_identity(transition.identity_change(transition.PREVIOUS))
333 self.assertEqual((user(old).pw_uid, user(old).pw_gid, group(old).gr_gid), (997, 994, 994))
334 self.assertIsNone(transition.identity_change(transition.PREVIOUS))
335
336
337if __name__ == "__main__":
338 unittest.main()
tools/namespace-transition.py created+245
...@@ -0,0 +1,245 @@
1#!/usr/bin/env python3
2"""Bridge the installed namespace and immutable releases during the rename."""
3import argparse
4import grp
5import json
6import os
7from pathlib import Path
8import pwd
9import subprocess
10import urllib.request
11
12
13NAMESPACE = globals().get("NAMESPACE") or json.loads(
14 (Path(__file__).with_suffix(".json") if Path(__file__).with_suffix(".json").exists()
15 else Path(__file__).resolve().parent.parent / "dashboard/src/namespace-transition.json").read_text()
16)
17PREVIOUS = NAMESPACE["previous"]
18NIXOS_STATE = Path("/var/lib/nixos")
19DIRECTORIES = tuple((Path(parent) / "snowglobe", Path(parent) / PREVIOUS)
20 for parent in ("/opt", "/var/lib", "/var/lib/caddy", "/var/cache"))
21
22
23def prepare():
24 for new, old in DIRECTORIES:
25 if new.exists() and old.exists() and new.resolve() != old.resolve():
26 raise ValueError(f"Two independent control stores exist: {new}, {old}")
27 new_root, _ = DIRECTORIES[0]
28 previous_releases = any((new_root / "releases").glob("*/tools/" + PREVIOUS + ".py"))
29 for new, old in DIRECTORIES:
30 if old.exists() and not new.exists() and not new.is_symlink():
31 new.symlink_to(old, target_is_directory=True)
32 elif previous_releases and new.exists() and not old.exists() and not old.is_symlink():
33 old.symlink_to(new, target_is_directory=True)
34
35
36def inherit_environment():
37 for name, value in list(os.environ.items()):
38 if name.startswith(PREVIOUS.upper() + "_"):
39 os.environ.setdefault("SNOWGLOBE_" + name.removeprefix(PREVIOUS.upper() + "_"), value)
40
41
42def environment(path, values=None):
43 values = dict(os.environ if values is None else values)
44 if layout(path)["prefix"] == PREVIOUS:
45 for name, value in list(values.items()):
46 if name.startswith("SNOWGLOBE_"):
47 values[PREVIOUS.upper() + "_" + name.removeprefix("SNOWGLOBE_")] = value
48 return values
49
50
51def layout(path):
52 prefix = "snowglobe" if (path / ".snowglobe-release.json").exists() or (path / "tools/snowglobe.py").exists() else PREVIOUS
53 return {"prefix": prefix, "script": path / f"tools/{prefix}.py", "manifest": path / f".{prefix}-release.json"}
54
55
56def host_configuration(hostname, available):
57 hostname = hostname.split(".", 1)[0]
58 candidates = ("snowglobe", NAMESPACE["previousHost"]) if hostname in {"snowglobe", NAMESPACE["previousHost"]} else (
59 "vm" if hostname in {"snowglobe-rehearsal", "clover-demo"} else hostname,
60 )
61 for name in candidates:
62 if name in available:
63 return name
64 raise ValueError(f"release has no NixOS configuration for {hostname}")
65
66
67def host_environment():
68 for prefix in ("snowglobe", PREVIOUS):
69 result = subprocess.run(["systemctl", "show", prefix + "-host", "--property=Environment", "--value"],
70 capture_output=True, text=True)
71 if result.stdout.strip():
72 return result.stdout
73 raise ValueError("the host service environment is unavailable")
74
75
76def stop_preview(identity):
77 for prefix in ("snowglobe", PREVIOUS):
78 subprocess.run(["systemctl", "stop", prefix + "-preview-" + identity], capture_output=True)
79
80
81def dashboard_container():
82 for name in ("snowglobe-dashboard", PREVIOUS + "-dashboard"):
83 if subprocess.run(["podman", "container", "exists", name], capture_output=True).returncode == 0:
84 return name
85 raise ValueError("the dashboard container is unavailable")
86
87
88def normalize_vm(root):
89 for element in root.iter():
90 if element.tag.startswith("{https://paperclover.net/" + PREVIOUS + "}"):
91 element.tag = element.tag.replace("{https://paperclover.net/" + PREVIOUS + "}", "{https://paperclover.net/snowglobe}", 1)
92 if element.tag == "serial" and element.text == PREVIOUS + "-cloud-init":
93 element.text = "snowglobe-cloud-init"
94 return root
95
96
97def migrate_policies(source, state, prefix="snowglobe"):
98 management = {**os.environ, "NOMAD_TOKEN": (state / "nomad.token").read_text().strip()}
99 for consumer in ("router", "dashboard"):
100 request = urllib.request.Request("http://127.0.0.1:4646/v1/acl/token/self", headers={
101 "X-Nomad-Token": (state / (consumer + ".token")).read_text().strip(),
102 })
103 with urllib.request.urlopen(request, timeout=10) as response:
104 token = json.load(response)
105 old, new = (PREVIOUS if prefix == "snowglobe" else "snowglobe") + "-" + consumer, prefix + "-" + consumer
106 subprocess.run(["nomad", "acl", "policy", "apply", new, str(source / "config/policies" / (consumer + ".hcl"))],
107 env=management, check=True, capture_output=True)
108 policies = [new if value == old else value for value in token.get("Policies", [])]
109 if old in token.get("Policies", []) or token.get("Name") == old:
110 subprocess.run(["nomad", "acl", "token", "update", "-name=" + new,
111 *("-policy=" + value for value in policies), token["AccessorID"]],
112 env=management, check=True, capture_output=True)
113
114
115def stop_units(prefix):
116 units = ("dashboard", "router", "log-shipper", "vm-screen", "host")
117 if prefix == PREVIOUS:
118 units += ("vm-window-host-proxy",)
119 for unit in units:
120 result = subprocess.run(["systemctl", "stop", prefix + "-" + unit], capture_output=True, text=True)
121 if result.returncode and "not loaded" not in result.stderr:
122 result.check_returncode()
123
124
125def identity_change(prefix):
126 old = (PREVIOUS if prefix == "snowglobe" else "snowglobe") + "-dashboard"
127 new = prefix + "-dashboard"
128 users, groups = {}, {}
129 for name in (old, new):
130 try:
131 users[name] = pwd.getpwnam(name)
132 except KeyError:
133 pass
134 try:
135 groups[name] = grp.getgrnam(name)
136 except KeyError:
137 pass
138 if len(users) > 1 or len(groups) > 1:
139 raise ValueError("Two dashboard identities exist; refusing to merge identities")
140 if any((user.pw_uid, user.pw_gid) != (997, 994) for user in users.values()) or any(
141 group.gr_gid != 994 for group in groups.values()
142 ):
143 raise ValueError("The dashboard account must retain UID 997 and GID 994")
144 registries = False
145 for filename, expected in (("uid-map", 997), ("gid-map", 994)):
146 path = NIXOS_STATE / filename
147 if path.exists():
148 values = json.loads(path.read_text())
149 if any(name in values and values[name] != expected for name in (old, new)):
150 raise ValueError("The NixOS identity registry disagrees with the dashboard account")
151 registries |= old in values
152 for filename in ("declarative-users", "declarative-groups"):
153 path = NIXOS_STATE / filename
154 registries |= path.exists() and old in path.read_text().split()
155 return (old, new) if old in users or old in groups or registries else None
156
157
158def rename_identity(change):
159 if change is None:
160 return
161 old, new = change
162 try:
163 grp.getgrnam(old)
164 except KeyError:
165 pass
166 else:
167 subprocess.run(["groupmod", "--new-name", new, old], check=True, capture_output=True)
168 try:
169 pwd.getpwnam(old)
170 except KeyError:
171 pass
172 else:
173 subprocess.run(["usermod", "--login", new, old], check=True, capture_output=True)
174 for filename in ("uid-map", "gid-map", "declarative-users", "declarative-groups"):
175 path = NIXOS_STATE / filename
176 if not path.exists():
177 continue
178 if filename.endswith("-map"):
179 values = json.loads(path.read_text())
180 if old not in values:
181 continue
182 values[new] = values.pop(old)
183 content = json.dumps(values) + "\n"
184 else:
185 names = path.read_text().split()
186 if old not in names:
187 continue
188 content = " ".join(new if name == old else name for name in names) + "\n"
189 pending = path.with_suffix(".namespace-pending")
190 pending.write_text(content)
191 pending.chmod(path.stat().st_mode & 0o777)
192 pending.replace(path)
193
194
195def promote(source):
196 prepare()
197 change = identity_change("snowglobe")
198 moving = any(old.exists() and not old.is_symlink() for _, old in DIRECTORIES)
199 if moving or change is not None:
200 stop_units(PREVIOUS)
201 rename_identity(change)
202 for new, old in DIRECTORIES:
203 if old.exists() and not old.is_symlink():
204 if new.is_symlink():
205 new.unlink()
206 old.rename(new)
207 old.symlink_to(new, target_is_directory=True)
208 new_root, old_root = DIRECTORIES[0]
209 for name in ("current", "main"):
210 link = new_root / name
211 if link.is_symlink():
212 target = Path(os.readlink(link))
213 if target.is_relative_to(old_root):
214 pending = link.with_suffix(".namespace-pending")
215 pending.unlink(missing_ok=True)
216 pending.symlink_to(new_root / target.relative_to(old_root))
217 pending.replace(link)
218 if old_root.exists():
219 migrate_policies(source, DIRECTORIES[1][0])
220
221
222def activate(path):
223 if layout(path)["prefix"] == "snowglobe":
224 promote(path)
225 else:
226 change = identity_change(PREVIOUS)
227 stop_units("snowglobe")
228 rename_identity(change)
229 migrate_policies(path, DIRECTORIES[1][0], PREVIOUS)
230
231
232def main():
233 parser = argparse.ArgumentParser()
234 parser.add_argument("mode", choices=("prepare", "promote"))
235 args = parser.parse_args()
236 if os.geteuid() != 0:
237 raise PermissionError("the namespace transition requires root")
238 if args.mode == "prepare":
239 prepare()
240 else:
241 promote(Path(__file__).resolve().parent.parent)
242
243
244if __name__ == "__main__":
245 main()
tools/oidc-provider.py+2-1
...@@ -1,6 +1,7 @@...@@ -1,6 +1,7 @@
1#!/usr/bin/env python31#!/usr/bin/env python3
2"""Provision a first-party OIDC client through the dashboard's host-only CLI."""2"""Provision a first-party OIDC client through the dashboard's host-only CLI."""
3import json3import json
4from importlib import import_module
4import subprocess5import subprocess
5import sys6import sys
67
...@@ -8,7 +9,7 @@ data = json.load(sys.stdin)...@@ -8,7 +9,7 @@ data = json.load(sys.stdin)
8if data["request"]["kind"] != "client":9if data["request"]["kind"] != "client":
9 raise ValueError("unsupported Snowglobe input")10 raise ValueError("unsupported Snowglobe input")
10result = subprocess.run(11result = subprocess.run(
11 ["podman", "exec", "-i", "studio-dashboard", "/bin/home-dashboard", "--oidc-client"],12 ["podman", "exec", "-i", import_module("namespace-transition").dashboard_container(), "/bin/home-dashboard", "--oidc-client"],
12 input=json.dumps(data), text=True, check=True, capture_output=True,13 input=json.dumps(data), text=True, check=True, capture_output=True,
13)14)
14sys.stdout.write(result.stdout)15sys.stdout.write(result.stdout)
tools/openclaw-verify.py+1-1
...@@ -5,7 +5,7 @@ import subprocess...@@ -5,7 +5,7 @@ import subprocess
55
66
7parser = argparse.ArgumentParser()7parser = argparse.ArgumentParser()
8parser.add_argument("--host", default="root@zenith")8parser.add_argument("--host", default="root@10.0.0.1")
9task = parser.add_mutually_exclusive_group()9task = parser.add_mutually_exclusive_group()
10task.add_argument("--prepare-task", action="store_true")10task.add_argument("--prepare-task", action="store_true")
11task.add_argument("--check-task", action="store_true")11task.add_argument("--check-task", action="store_true")
tools/pds-migration.md deleted-7
...@@ -1,7 +0,0 @@
1# PDS data migration
2
3The 2026-09-26 preview restore copied Zenith's three SQLite databases with SQLite's backup API and copied its blocks and actor keys without writing to Zenith. The restored stage passed SQLite integrity checks and HTTPS health. Source and stage had the same table and row counts: `account` 18/47, `sequencer` 3/76, and `did_cache` 3/5. The preview uses a separate hostname and disables PLC and crawlers, so it cannot validate public federation.
4
5For production, configure the new host's site domain as `paperclover.net` and verify PDS renders `at.paperclover.net`. Stop the old and new PDS instances, then run `STUDIO_DEPLOY_HOST=<new-host> STUDIO_DEPLOY_PORT=22 sh tools/import-pds.sh pds`. The importer requires both instances stopped, imports the existing JWT/admin/PLC and mail secrets, snapshots the destination, copies and verifies the data, and leaves the new instance stopped. Its snapshot name is printed for recovery. Start the new instance only after checking the account DID and handle against Zenith; switch public routing after its health and identity endpoints agree. The importer rechecks that Zenith did not restart during the copy.
6
7For a same-machine OS replacement, set `STUDIO_LEGACY_HANDOFF` to the [offline handoff](legacy-handoff.md) directory. The importer then reads the retained PDS SQLite files and `.env` from the new host's mounted old apps dataset, without old Docker. Its SQLite backup operation was checked read-only against all three old databases.
tools/personal-cutover.md deleted-45
...@@ -1,45 +0,0 @@
1# Personal service cutover
2
3The installed host retains the original encrypted app tree at `/mnt/storage1/apps`. Clover and its Media child are already mounted at `/srv/clover` and `/srv/clover/Media`. Copy each app's state into its managed production dataset, verify it, and only then start that app. Old app trees stay untouched. Personal Forgejo repository migration and PostgreSQL restoration are separate from these file imports.
4
5```sh
6export STUDIO_DEPLOY_HOST=root@10.0.0.1
7export STUDIO_DEPLOY_PORT=22
8export STUDIO_LEGACY_HANDOFF=/mnt/storage1/apps/studio-handoff/20261004T230507Z-e75419
9```
10
11Provision managed service datasets and identities before import. Register a stopped production Nomad job when required: render HCL, parse with `nomad job run -output`, set the returned `Job.Stop=true`, then POST `/v1/jobs` and confirm zero allocations. Do not deploy an empty app to create its dataset. A missing job is accepted by the Shale, qBittorrent, ARR, YouTube, and personal-files importers. Jellyfin, Navidrome, and Jackett importers require `Stop=true` on an existing job.
12
13| App | Retained source → managed destination | Import and pre-start proof |
14| --- | --- | --- |
15| Shale | `apps/shale/{data,repositories_owned,repositories_mirrors}` → `/srv/prod/shale/` | `bash tools/import-shale.sh shale`; three directory checksums and SQLite integrity. Forgejo-only repositories still need import into Shale. |
16| Jellyfin | `apps/jellyfin/` → `/srv/prod/jellyfin/config/` | `sh tools/import-jellyfin.sh jellyfin`; excludes caches/logs/transcodes; verifies both SQLite databases and copy checksums. |
17| Navidrome | `apps/navidrone/` → `/srv/prod/navidrome/data/` | `sh tools/import-navidrome.sh navidrome`; SQLite integrity, checksum, and retained `snow` administrator. The old directory is spelled `navidrone`. |
18| qBittorrent | `apps/qbittorrent/qBittorrent/` → `/srv/prod/qbittorrent/config/qBittorrent/` | `bash tools/import-qbittorrent.sh`; verifies resume-file count and checksum, prepares config, **then starts the service**. Load PIA secrets first. |
19| PDS | `apps/pds/` → `/srv/prod/pds/pds/` | `ssh root@10.0.0.1 'python3 - pds' < tools/import-personal-files.py`; preserve original JWT/admin/PLC/mail secrets first. Checks every SQLite database, including actor stores, and copies actor keys/blocks. Refuses WAL files requiring a consistent SQLite backup. |
20| Sonarr / Radarr | `apps/<app>/` → `/srv/prod/<app>/config/` | `bash tools/import-arr.sh <app>`; consistent SQLite backup, integrity and hash; excludes logs/PIDs. Configure current internal endpoints after startup. |
21| Jackett | `apps/jackett/` → `/srv/prod/jackett/config/Jackett/` | `sh tools/import-jackett.sh jackett`; retains API key and indexer JSON, verifies checksums. |
22| YouTube state | `apps/yt-feed/` → `/srv/prod/ytdl/data/` | `bash tools/import-yt-feed.sh ytdl`; validates JSON and checksums; stops and restarts dashboard's worker around import. Import mail secrets before activating worker. |
23| Clover DB | `/srv/clover/.zfs/snapshot/<snapshot>/Documents/Config/paper clover/` → `/srv/prod/clover-source-of-truth/data/` | `STUDIO_MIGRATION_SNAPSHOT=<snapshot> bash tools/import-source-data.sh`; direct host-local tar stream, tree digest and SQLite integrity. Import original API key. |
24| Tailscale / DDNS / Copyparty / YouTube Archiver / PDS | Sources and mount destinations are defined in [import-personal-files.py](import-personal-files.py). | Run the host-side importer below once per app. No app starts; it checks stopped allocations, snapshots destination, copies, checksum-verifies, and assigns its UID. |
25
26```sh
27ssh root@10.0.0.1 'python3 - tailscale' < tools/import-personal-files.py
28ssh root@10.0.0.1 'python3 - ddns-updater' < tools/import-personal-files.py
29ssh root@10.0.0.1 'python3 - copyparty' < tools/import-personal-files.py
30ssh root@10.0.0.1 'python3 - ytdl' < tools/import-personal-files.py
31```
32
33Tailscale must retain `tailscaled.state` to preserve its node identity; the copy remains root-owned and mode `0600`. The PDS importer copies every actor store, not only its three root SQLite files; `import-pds.sh` excludes nested SQLite files and is unsuitable for this offline cutover. DDNS retains update history; its provider configuration comes from imported Cloudflare secrets and the service's generated `CONFIG`. Copyparty's active state is the **nested** old `copyparty/copyparty/` directory, including `shares.db`, sessions, IdP database, and salts; it stays nested under the new `/cfg/copyparty`. The [container sets `XDG_CONFIG_HOME=/cfg`](https://github.com/9001/copyparty/blob/hovudstraum/scripts/docker/Dockerfile.ac), and Copyparty appends its app directory. The outer legacy policy config is not copied: `prepare.py` generates the current policy. Its share database contained 17 shares and three selected-file records at the October 5 UTC inspection. Per-volume histories already on Clover/Media stay on those datasets.
34
35YouTube Archiver's 12 retained download-archive files stay beside videos in `Media/Videos/Independent`; cache and stale locks in its old app directory are disposable. Its retained subscriptions specify `/media/jellyfin/Independent`, so the service binds that container path to the reorganized folder. The upscaler reads `/media/Videos/Independent` directly. Dashboard's worker reads the actual `Indie Shows`, `Videos/Independent`, and `Intake - Music` folders; it needs no media symlinks.
36
37Samba serves existing Clover/Media directly and needs only its account secret. Intake likewise uses `/srv/clover/Documents/Intake` directly and needs the retained API key. VictoriaMetrics, VictoriaLogs, and VictoriaTraces had no legacy directories at their personal app paths; start new stores. OpenSpeedTest, FlareSolverr, and Forward Auth have no retained application file state. Keycloak and Dawarich require their personal PostgreSQL restores before activation; Dawarich's file-volume migration belongs with its database importer.
38
39Activate telemetry and restored PostgreSQL first, then restored Keycloak and Forward Auth. Start restored Shale and complete Git repository migration. After personal files/secrets are verified, enable Copyparty, Samba, PDS, Navidrome, Jellyfin, Intake, and Clover DB. Bring up Jackett and qBittorrent before Sonarr/Radarr. Start restored YouTube state, dashboard worker, and Archiver after checking final writable media paths. DDNS starts after wildcard routing is ready; preserved Tailscale state can start once its own copy passes.
40
41Do not reuse preview imports for production: those branches can start jobs, use old `storage1` snapshot names, or intentionally disable writers. qBittorrent's production importer starts its job at the end; YouTube's importer restarts dashboard and may resume retained queued work immediately. All other production file importers listed above leave the imported app stopped.
42
43October 5 UTC execution evidence is stored root-only under `/var/lib/studio/migrations/personal-cutover-20261004`; the original app snapshot is `globe/apps@personal-cutover-20261004`. The manual no-start qBittorrent copy retained 550 saved torrents, YouTube retained six valid JSON state files, Copyparty retained 17 shares, PDS retained all four SQLite databases, and pgAdmin passed SQLite integrity. Dawarich retained its storage file, empty watched-import directory, and 95,396-byte Redis dump. YouTube state needs explicit access ACL masks (`m::rwX`) and default masks (`d:m::rwx`) so dashboard and upscaler can both write.
44
45Before ARR activation, the copied databases received a separate `before-arr-path-cutover-*` snapshot. Sonarr translated two root folders and 89 series paths; Radarr translated one root folder and 56 movie paths from `/data/media/jellyfin/<folder>` to `/data/media/<folder>`. All other application table values matched their pre-change hashes. Seven download-path mappings per app are derived from qBittorrent and ARR volume definitions, including `torrent` → `Seedbox` and the saved Jellyfin aliases; [configure-arr.py](configure-arr.py) updates their host alongside the download client. [Servarr maps paths only for the matching download-client host](https://github.com/Servarr/Wiki/blob/master/sonarr/settings.md). All mapped root destinations passed service UID/GID 3000 read/search checks. Three Sonarr series directories were already absent in the pre-layout Media snapshot; the other 86 and all 56 Radarr movie directories resolve. Private proofs are `<app>-path-cutover.json`, `<app>-mapped-directory-proof.json`, and `sonarr-missing-directory-origin.json` in the evidence directory above.
tools/rehearsal.md created+26
...@@ -0,0 +1,26 @@
1# Isolated host rehearsal
2
3Normal service and dashboard previews run on Snow Globe. Use the optional NixOS
4VM only when a change needs an isolated host, OS, storage, or guest boundary.
5It has no production GPU; do not download model weights or enable inference.
6
7The VM configuration is `nixos/vm.nix` (flake `vm`), with hostname `snowglobe-rehearsal`,
8domain `snowglobe.test`, and a demo pool. Its SSH endpoint is
9`root@127.0.0.1`, port `2222`. Both deployment overrides are required:
10
11```sh
12SNOWGLOBE_DEPLOY_HOST=root@127.0.0.1 SNOWGLOBE_DEPLOY_PORT=2222 python3 tools/deploy.py stage <service>
13```
14
15`tools/local-vm.sh` launches the VM. `SNOWGLOBE_VM_CACHE_DIR` overrides its cache;
16`SNOWGLOBE_VM_HEADLESS=1` selects background operation. Installed mode mounts
17`SNOWGLOBE_VM_MEDIA_SOURCE` (default `/Volumes/media`) read-only through 9P at
18`/mnt/media-source`, with a bindfs view at `/srv/clover/Media`.
19Those media bytes are personal source data, not synthetic fixtures. The VM's
20own Clover dataset is separate. Use disposable test data and do not inspect
21private source contents without authorization.
22
23Use the configured DNS and TLS routing for the VM. Do not hand-edit host files,
24DNS, or trust to bypass a failed setup. Keep VM console/browser checks inside the
25normal browser panel. Rehearsal evidence belongs in its relevant runbook; the
26primary agent workflow remains staging on Snow Globe.
tools/release-host-test.py created+90
...@@ -0,0 +1,90 @@
1#!/usr/bin/env python3
2import json
3import os
4from pathlib import Path
5import subprocess
6import tempfile
7from types import SimpleNamespace
8import unittest
9from unittest.mock import patch
10
11import release
12
13PREVIOUS_HOST = release.transition.NAMESPACE["previousHost"]
14
15
16class HostConfiguration(unittest.TestCase):
17 def select(self, hostname, configurations):
18 with patch.object(release.os, "uname", return_value=SimpleNamespace(nodename=hostname)), patch.object(
19 release.subprocess, "run", return_value=subprocess.CompletedProcess([], 0, json.dumps(configurations)),
20 ) as command:
21 result = release.host_configuration(Path("/release"))
22 command.assert_called_once_with(
23 ["nix", "--extra-experimental-features", "nix-command flakes", "eval", "--json", "path:/release#nixosConfigurations", "--apply", "builtins.attrNames"],
24 check=True, capture_output=True, text=True,
25 )
26 return result
27
28 def test_rename_and_rollback(self):
29 for hostname in (PREVIOUS_HOST, "snowglobe", "snowglobe.paperclover.net"):
30 with self.subTest(hostname=hostname):
31 self.assertEqual(self.select(hostname, ["installer", "snowglobe", "vm"]), "snowglobe")
32 self.assertEqual(self.select(hostname, ["installer", PREVIOUS_HOST, "vm"]), PREVIOUS_HOST)
33
34 def test_rehearsal_stays_on_vm(self):
35 self.assertEqual(self.select("snowglobe-rehearsal", ["installer", "snowglobe", "vm"]), "vm")
36
37 def test_unrelated_host_is_not_retargeted(self):
38 self.assertEqual(self.select("fixture", ["fixture", "vm"]), "fixture")
39 for hostname in ("fixture", "snowglobe", "snowglobe-rehearsal"):
40 with self.subTest(hostname=hostname), self.assertRaisesRegex(ValueError, "no NixOS configuration"):
41 self.select(hostname, ["installer"])
42
43
44class ActivationEnvironment(unittest.TestCase):
45 def test_host_switch_refreshes_inherited_name_and_preserves_overrides(self):
46 for before, after, inherited, expected in (
47 (PREVIOUS_HOST, "snowglobe", PREVIOUS_HOST, "snowglobe"),
48 ("snowglobe", PREVIOUS_HOST, "snowglobe", PREVIOUS_HOST),
49 (PREVIOUS_HOST, "snowglobe", None, "snowglobe"),
50 (PREVIOUS_HOST, "snowglobe", "test-override", "test-override"),
51 ("snowglobe-rehearsal", "snowglobe-rehearsal", "snowglobe-rehearsal", "snowglobe-rehearsal"),
52 ):
53 with self.subTest(before=before, inherited=inherited), tempfile.TemporaryDirectory() as temporary:
54 root = Path(temporary)
55 source = root / "release"
56 source.mkdir()
57 (source / "tools").mkdir()
58 (source / "tools/snowglobe.py").touch()
59 (source / ".snowglobe-release.json").write_text('{"version":1}')
60 hostname = before
61 observed = []
62
63 def run(argv, **kwargs):
64 nonlocal hostname
65 if argv[:2] == ["nixos-rebuild", "switch"]:
66 hostname = after
67 if argv[-1] == "deploy":
68 observed.append(os.environ.get("SNOWGLOBE_NODE_NAME"))
69 return subprocess.CompletedProcess(argv, 0, '"leader"')
70
71 with patch.dict(os.environ), patch.object(release, "ROOT", root), patch.object(
72 release, "STATE", root,
73 ), patch.object(release, "check_release", return_value=source), patch.object(
74 release, "current_release", return_value=None,
75 ), patch.object(release, "host_digest", return_value="new"), patch.object(
76 release, "host_configuration", return_value="fixture",
77 ), patch.object(release, "jobs", return_value=set()), patch.object(
78 release.os, "uname", side_effect=lambda: SimpleNamespace(nodename=hostname),
79 ), patch.object(release.subprocess, "run", side_effect=run):
80 if inherited is None:
81 os.environ.pop("SNOWGLOBE_NODE_NAME", None)
82 else:
83 os.environ["SNOWGLOBE_NODE_NAME"] = inherited
84 with patch.object(release.transition, "activate"):
85 release.activate("0123456789abcdef", initial=True)
86 self.assertEqual(observed, [expected])
87
88
89if __name__ == "__main__":
90 unittest.main()
tools/release.py+53-37
...@@ -4,6 +4,7 @@ from datetime import datetime, timezone...@@ -4,6 +4,7 @@ from datetime import datetime, timezone
4import fcntl4import fcntl
5import hashlib5import hashlib
6import json6import json
7from importlib import import_module
7import os8import os
8from pathlib import Path9from pathlib import Path
9import re10import re
...@@ -11,34 +12,23 @@ import subprocess...@@ -11,34 +12,23 @@ import subprocess
11import time12import time
1213
1314
14ROOT = Path("/opt/studio")15transition = import_module("namespace-transition")
16
17ROOT = Path("/opt/snowglobe")
15RELEASES = ROOT / "releases"18RELEASES = ROOT / "releases"
16STATE = Path("/var/lib/studio")19STATE = Path("/var/lib/snowglobe")
17HISTORY = STATE / "deployments.json"20HISTORY = STATE / "deployments.json"
18SOURCES = ("config", "service", "tools", "nixos", "dashboard", "guest", "flake.nix", "flake.lock", "readme.md")21SOURCES = ("config", "service", "tools", "nixos", "dashboard", "guest", "flake.nix", "flake.lock", "readme.md", "AGENTS.md")
19RELEASE_ID = re.compile(r"[0-9a-f]{16}\Z")22RELEASE_ID = re.compile(r"[0-9a-f]{16}\Z")
20STAGE_ID = re.compile(r"[a-z][a-z0-9-]*\Z")23STAGE_ID = re.compile(r"[a-z][a-z0-9-]*\Z")
2124
2225
23def excluded_services(root):
24 path = root / "config/excluded-services.json"
25 return set(json.loads(path.read_text())) if path.exists() else set()
26
27
28def files(root):26def files(root):
29 excluded = excluded_services(root)
30 for name in SOURCES:27 for name in SOURCES:
31 source = root / name28 source = root / name
32 if not source.exists() and not source.is_symlink():29 if not source.exists() and not source.is_symlink():
33 continue30 continue
34 if name == "service" and source.is_dir():31 paths = source.rglob("*") if source.is_dir() else [source]
35 paths = []
36 for directory, directories, filenames in os.walk(source):
37 directories[:] = [entry for entry in directories if entry not in excluded]
38 paths.extend(Path(directory) / entry for entry in [*directories, *filenames]
39 if not (entry.endswith(".pkl") and entry[:-4] in excluded))
40 else:
41 paths = source.rglob("*") if source.is_dir() else [source]
42 for path in sorted(paths):32 for path in sorted(paths):
43 relative = path.relative_to(root)33 relative = path.relative_to(root)
44 if relative.parts[:2] in (34 if relative.parts[:2] in (
...@@ -76,7 +66,7 @@ def host_digest(root):...@@ -76,7 +66,7 @@ def host_digest(root):
76 digest = hashlib.sha256()66 digest = hashlib.sha256()
77 paths = sorted(path for path, relative in files(root)67 paths = sorted(path for path, relative in files(root)
78 if relative.parts[0] in {"nixos", "dashboard", "config", "service"}68 if relative.parts[0] in {"nixos", "dashboard", "config", "service"}
79 or str(relative) in {"flake.nix", "flake.lock", "tools/router.py", "tools/dashboard-host.py", "tools/dashboard-run.py", "tools/release.py", "tools/vms.py", "tools/vm-screen.py", "guest/protocol.json"})69 or str(relative) in {"flake.nix", "flake.lock", "tools/router.py", "tools/dashboard-host.py", "tools/dashboard-run.py", "tools/release.py", "tools/namespace-transition.py", "tools/vms.py", "tools/vm-screen.py", "guest/protocol.json"})
80 for path in paths:70 for path in paths:
81 digest.update(str(path.relative_to(root)).encode())71 digest.update(str(path.relative_to(root)).encode())
82 _hash_contents(digest, path)72 _hash_contents(digest, path)
...@@ -89,7 +79,7 @@ def check_release(release, legacy=False):...@@ -89,7 +79,7 @@ def check_release(release, legacy=False):
89 path = RELEASES / release79 path = RELEASES / release
90 if not path.is_dir():80 if not path.is_dir():
91 raise ValueError(f"release is missing: {release}")81 raise ValueError(f"release is missing: {release}")
92 manifest = path / ".studio-release.json"82 manifest = transition.layout(path)["manifest"]
93 if not manifest.exists():83 if not manifest.exists():
94 if not legacy:84 if not legacy:
95 raise ValueError(f"release has no manifest: {release}")85 raise ValueError(f"release has no manifest: {release}")
...@@ -105,7 +95,7 @@ def current_release(link="current"):...@@ -105,7 +95,7 @@ def current_release(link="current"):
105 if not current.is_symlink():95 if not current.is_symlink():
106 return None96 return None
107 target = current.resolve()97 target = current.resolve()
108 if target.parent != RELEASES or not RELEASE_ID.fullmatch(target.name):98 if target.parent != RELEASES.resolve() or not RELEASE_ID.fullmatch(target.name):
109 raise ValueError(f"{link} points outside releases: {target}")99 raise ValueError(f"{link} points outside releases: {target}")
110 return target.name100 return target.name
111101
...@@ -116,7 +106,7 @@ def main_release(version=None):...@@ -116,7 +106,7 @@ def main_release(version=None):
116 return None106 return None
117 if not RELEASE_ID.fullmatch(version):107 if not RELEASE_ID.fullmatch(version):
118 raise ValueError("invalid release ID")108 raise ValueError("invalid release ID")
119 details = json.loads((RELEASES / version / ".studio-release.json").read_text())109 details = json.loads(transition.layout(RELEASES / version)["manifest"].read_text())
120 revision = details.get("main")110 revision = details.get("main")
121 if (not isinstance(revision, dict) or not isinstance(revision.get("commit"), str)111 if (not isinstance(revision, dict) or not isinstance(revision.get("commit"), str)
122 or not re.fullmatch(r"[0-9a-f]{40}", revision["commit"])112 or not re.fullmatch(r"[0-9a-f]{40}", revision["commit"])
...@@ -137,8 +127,8 @@ def save_history(entries):...@@ -137,8 +127,8 @@ def save_history(entries):
137127
138def jobs(path):128def jobs(path):
139 rendered = subprocess.run(129 rendered = subprocess.run(
140 ["python3", str(path / "tools/studio.py"), "render"],130 ["python3", str(transition.layout(path)["script"]), "render"],
141 check=True, capture_output=True, text=True,131 check=True, capture_output=True, text=True, env=transition.environment(path),
142 ).stdout132 ).stdout
143 result = set(re.findall(r'^job "([a-z][a-z0-9-]*)" \{$', rendered, re.MULTILINE))133 result = set(re.findall(r'^job "([a-z][a-z0-9-]*)" \{$', rendered, re.MULTILINE))
144 if not result:134 if not result:
...@@ -146,22 +136,33 @@ def jobs(path):...@@ -146,22 +136,33 @@ def jobs(path):
146 return result136 return result
147137
148138
139def host_configuration(path):
140 hostname = os.uname().nodename.split(".", 1)[0]
141 available = json.loads(subprocess.run(
142 ["nix", "--extra-experimental-features", "nix-command flakes", "eval", "--json", f"path:{path}#nixosConfigurations", "--apply", "builtins.attrNames"],
143 check=True, capture_output=True, text=True,
144 ).stdout)
145 return transition.host_configuration(hostname, available)
146
147
149def activate(release, legacy=False, initial=False):148def activate(release, legacy=False, initial=False):
150 path = check_release(release, legacy)149 path = check_release(release, legacy)
151 script = path / "tools/studio.py"150 layout = transition.layout(path)
151 script = layout["script"]
152 environment = transition.environment(path)
153 prefix = layout["prefix"]
152 managed = STATE / "managed-jobs.json"154 managed = STATE / "managed-jobs.json"
153 current = current_release()155 current = current_release()
154 previous = set(json.loads(managed.read_text())) if managed.exists() else (156 previous = set(json.loads(managed.read_text())) if managed.exists() else (
155 jobs(RELEASES / current) if current and not initial else set()157 jobs(RELEASES / current) if current and not initial else set()
156 )158 )
157 digest = host_digest(path)159 digest = host_digest(path)
158 hostname = os.uname().nodename.split(".", 1)[0]
159 configuration = "vm" if hostname == "clover-demo" else hostname
160 recorded = ROOT / "host.digest"160 recorded = ROOT / "host.digest"
161 old_digest = recorded.read_text().strip() if recorded.exists() else None161 old_digest = recorded.read_text().strip() if recorded.exists() else None
162 if old_digest != digest:162 if old_digest != digest:
163 configuration = host_configuration(path)
163 subprocess.run(["nixos-rebuild", "dry-build", "--flake", f"path:{path}#{configuration}"], check=True)164 subprocess.run(["nixos-rebuild", "dry-build", "--flake", f"path:{path}#{configuration}"], check=True)
164 subprocess.run(["python3", str(script), "preflight"], check=True)165 subprocess.run(["python3", str(script), "preflight"], check=True, env=environment)
165 backup = None166 backup = None
166 if current and not initial:167 if current and not initial:
167 backup_script = ROOT / "data.py"168 backup_script = ROOT / "data.py"
...@@ -176,7 +177,12 @@ def activate(release, legacy=False, initial=False):...@@ -176,7 +177,12 @@ def activate(release, legacy=False, initial=False):
176 if old_digest != digest:177 if old_digest != digest:
177 if current is None:178 if current is None:
178 (ROOT / "current").symlink_to(path)179 (ROOT / "current").symlink_to(path)
180 hostname = os.uname().nodename.split(".", 1)[0]
181 transition.activate(path)
179 subprocess.run(["nixos-rebuild", "switch", "--flake", f"path:{path}#{configuration}"], check=True)182 subprocess.run(["nixos-rebuild", "switch", "--flake", f"path:{path}#{configuration}"], check=True)
183 if os.environ.get("SNOWGLOBE_NODE_NAME", hostname) == hostname:
184 os.environ["SNOWGLOBE_NODE_NAME"] = os.uname().nodename.split(".", 1)[0]
185 environment = transition.environment(path)
180 next_link = ROOT / ("next-" + release)186 next_link = ROOT / ("next-" + release)
181 next_link.unlink(missing_ok=True)187 next_link.unlink(missing_ok=True)
182 next_link.symlink_to(path)188 next_link.symlink_to(path)
...@@ -193,12 +199,12 @@ def activate(release, legacy=False, initial=False):...@@ -193,12 +199,12 @@ def activate(release, legacy=False, initial=False):
193 time.sleep(2)199 time.sleep(2)
194 else:200 else:
195 raise RuntimeError("Nomad API did not become ready")201 raise RuntimeError("Nomad API did not become ready")
196 subprocess.run(["systemctl", "restart", "studio-router.service"], check=True)202 subprocess.run(["systemctl", "restart", prefix + "-router.service"], check=True)
197 if (path / "nixos/dashboard.nix").exists():203 if (path / "nixos/dashboard.nix").exists():
198 subprocess.run(["systemctl", "start", "studio-dashboard.service"], check=True)204 subprocess.run(["systemctl", "start", prefix + "-dashboard.service"], check=True)
199 subprocess.run(["systemctl", "is-active", "--quiet", "studio-dashboard.service"], check=True)205 subprocess.run(["systemctl", "is-active", "--quiet", prefix + "-dashboard.service"], check=True)
200 subprocess.run(["python3", str(script), "pool"], check=True)206 subprocess.run(["python3", str(script), "pool"], check=True, env=environment)
201 subprocess.run(["python3", str(script), "deploy"], check=True)207 subprocess.run(["python3", str(script), "deploy"], check=True, env=environment)
202 desired = jobs(path)208 desired = jobs(path)
203 for name in sorted(previous - desired):209 for name in sorted(previous - desired):
204 subprocess.run(210 subprocess.run(
...@@ -209,19 +215,29 @@ def activate(release, legacy=False, initial=False):...@@ -209,19 +215,29 @@ def activate(release, legacy=False, initial=False):
209 pending.write_text(json.dumps(sorted(desired)) + "\n")215 pending.write_text(json.dumps(sorted(desired)) + "\n")
210 pending.replace(managed)216 pending.replace(managed)
211 if (path / "tools/log-shipper.py").exists():217 if (path / "tools/log-shipper.py").exists():
212 subprocess.run(["systemctl", "restart", "studio-log-shipper.service"], check=True)218 subprocess.run(["systemctl", "restart", prefix + "-log-shipper.service"], check=True)
213 manifest = path / ".studio-release.json"219 manifest = transition.layout(path)["manifest"]
214 if not legacy and json.loads(manifest.read_text()).get("version", 1) >= 2:220 if not legacy and json.loads(manifest.read_text()).get("version", 1) >= 2:
215 subprocess.run(["python3", str(script), "check"], check=True)221 subprocess.run(["python3", str(script), "check"], check=True, env=environment)
216 return backup222 return backup
217223
218224
219def main():225def main():
220 parser = argparse.ArgumentParser(description="Deploy main or roll back a home server release")226 parser = argparse.ArgumentParser(description="Deploy main or roll back a home server release")
221 parser.add_argument("mode", choices=["publish", "deploy", "rollback", "history", "bootstrap", "verify"])227 parser.add_argument("mode", choices=["publish", "deploy", "rollback", "history", "bootstrap", "verify", "stage-destroy"])
222 parser.add_argument("target", nargs="?")228 parser.add_argument("target", nargs="?")
223 args = parser.parse_args()229 args = parser.parse_args()
230 transition.prepare()
231 transition.inherit_environment()
224 STATE.mkdir(parents=True, exist_ok=True)232 STATE.mkdir(parents=True, exist_ok=True)
233 if args.mode == "stage-destroy":
234 if not args.target or not STAGE_ID.fullmatch(args.target):
235 parser.error("stage-destroy requires a stage ID")
236 saved = json.loads((STATE / "stages" / (args.target + ".json")).read_text())
237 path = check_release(saved["release"])
238 subprocess.run(["python3", str(transition.layout(path)["script"]), "destroy", args.target],
239 check=True, env=transition.environment(path))
240 return
225 if args.mode == "verify":241 if args.mode == "verify":
226 if not args.target:242 if not args.target:
227 parser.error("verify requires a release ID")243 parser.error("verify requires a release ID")
...@@ -255,7 +271,7 @@ def main():...@@ -255,7 +271,7 @@ def main():
255 entries = history()271 entries = history()
256 current = current_release()272 current = current_release()
257 if current and not entries and args.mode != "bootstrap":273 if current and not entries and args.mode != "bootstrap":
258 entries.append({"release": current, "source": "previous", "time": int(time.time()), "legacy": not (RELEASES / current / ".studio-release.json").exists()})274 entries.append({"release": current, "source": "previous", "time": int(time.time()), "legacy": not transition.layout(RELEASES / current)["manifest"].exists()})
259 save_history(entries)275 save_history(entries)
260 if args.mode == "deploy":276 if args.mode == "deploy":
261 candidate = main_release()277 candidate = main_release()
tools/router-cookie-test.py+7-7
...@@ -30,14 +30,14 @@ def main():...@@ -30,14 +30,14 @@ def main():
30 parser = argparse.ArgumentParser()30 parser = argparse.ArgumentParser()
31 parser.add_argument('--caddy', required=True, type=Path)31 parser.add_argument('--caddy', required=True, type=Path)
32 args = parser.parse_args()32 args = parser.parse_args()
33 with tempfile.TemporaryDirectory(prefix='studio-router-cookies-') as temporary, ThreadingHTTPServer(('127.0.0.1', 0), Cookies) as backend:33 with tempfile.TemporaryDirectory(prefix='snowglobe-router-cookies-') as temporary, ThreadingHTTPServer(('127.0.0.1', 0), Cookies) as backend:
34 root = Path(temporary)34 root = Path(temporary)
35 proof = root / 'proof'35 proof = root / 'proof'
36 proof.write_text('a' * 64)36 proof.write_text('a' * 64)
37 environment = {**os.environ, 'STUDIO_DOMAIN': 'studio.test', 'STUDIO_DASHBOARD_PORT': '3000',37 environment = {**os.environ, 'SNOWGLOBE_DOMAIN': 'snowglobe.test', 'SNOWGLOBE_DASHBOARD_PORT': '3000',
38 'STUDIO_PROXY_TOKEN_FILE': str(proof), 'XDG_DATA_HOME': str(root / 'data'),38 'SNOWGLOBE_PROXY_TOKEN_FILE': str(proof), 'XDG_DATA_HOME': str(root / 'data'),
39 'XDG_CONFIG_HOME': str(root / 'config')}39 'XDG_CONFIG_HOME': str(root / 'config')}
40 environment.pop('STUDIO_INTERNAL_PORT', None)40 environment.pop('SNOWGLOBE_INTERNAL_PORT', None)
4141
42 def nomad(path, _):42 def nomad(path, _):
43 if path == '/v1/services':43 if path == '/v1/services':
...@@ -45,7 +45,7 @@ def main():...@@ -45,7 +45,7 @@ def main():
45 if path.startswith('/v1/service/'):45 if path.startswith('/v1/service/'):
46 service = path.rsplit('/', 1)[1]46 service = path.rsplit('/', 1)[1]
47 return [{'ServiceName': service, 'JobID': service, 'AllocID': service, 'Address': '127.0.0.1',47 return [{'ServiceName': service, 'JobID': service, 'AllocID': service, 'Address': '127.0.0.1',
48 'Port': backend.server_port, 'Tags': ['caddy-host=' + service + '.studio.test'] +48 'Port': backend.server_port, 'Tags': ['caddy-host=' + service + '.snowglobe.test'] +
49 (['caddy-secure-cookies=true'] if service == 'knife' else [])}]49 (['caddy-secure-cookies=true'] if service == 'knife' else [])}]
50 return {'http': {'Status': 'success'}}50 return {'http': {'Status': 'success'}}
5151
...@@ -61,8 +61,8 @@ def main():...@@ -61,8 +61,8 @@ def main():
61 listener.bind(('127.0.0.1', 0))61 listener.bind(('127.0.0.1', 0))
62 port = listener.getsockname()[1]62 port = listener.getsockname()[1]
63 runtime = root / 'Caddyfile'63 runtime = root / 'Caddyfile'
64 sites = rendered.split('auth.studio.test {', 1)[0]64 sites = rendered.split('auth.snowglobe.test {', 1)[0]
65 sites = sites.replace('knife.studio.test {', f'http://127.0.0.1:{port} {{').replace('plain.studio.test {', f'http://localhost:{port} {{').replace(' tls internal\n', '')65 sites = sites.replace('knife.snowglobe.test {', f'http://127.0.0.1:{port} {{').replace('plain.snowglobe.test {', f'http://localhost:{port} {{').replace(' tls internal\n', '')
66 runtime.write_text('{\n admin off\n auto_https off\n}\n' + sites)66 runtime.write_text('{\n admin off\n auto_https off\n}\n' + sites)
67 threading.Thread(target=backend.serve_forever, daemon=True).start()67 threading.Thread(target=backend.serve_forever, daemon=True).start()
68 with (root / 'caddy.log').open('w') as log:68 with (root / 'caddy.log').open('w') as log:
tools/router.py+35-38
...@@ -10,8 +10,8 @@ import urllib.parse...@@ -10,8 +10,8 @@ import urllib.parse
10import urllib.request10import urllib.request
1111
12ROUTES = "/var/lib/caddy/routes.caddy"12ROUTES = "/var/lib/caddy/routes.caddy"
13TOKEN = "/var/lib/studio/router.token"13TOKEN = "/var/lib/snowglobe/router.token"
14ROUTE_DIR = "/var/lib/studio/routes"14ROUTE_DIR = "/var/lib/snowglobe/routes"
15HOST = re.compile(r"[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?\Z")15HOST = re.compile(r"[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?\Z")
1616
1717
...@@ -39,13 +39,13 @@ def proxy(upstreams, indent, uncompressed=False, host=None):...@@ -39,13 +39,13 @@ def proxy(upstreams, indent, uncompressed=False, host=None):
3939
4040
41def shale_mcp_routes(port):41def shale_mcp_routes(port):
42 return [" @shale_mcp_link path_regexp shale_mcp_link ^/-/studio-mcp/([A-Za-z0-9_-]{43})$",42 return [" @shale_mcp_link path_regexp shale_mcp_link ^/-/snowglobe-mcp/([A-Za-z0-9_-]{43})$",
43 " handle @shale_mcp_link {", " rewrite * /oauth/shale/link/{re.shale_mcp_link.1}",43 " handle @shale_mcp_link {", " rewrite * /oauth/shale/link/{re.shale_mcp_link.1}",
44 " request_header -User-Name", " request_header -User-Groups", " request_header -Studio-Proxy-Token",44 " request_header -User-Name", " request_header -User-Groups", " request_header -Snowglobe-Proxy-Token",
45 *proxy(f"127.0.0.1:{port}", " "), " }",45 *proxy(f"127.0.0.1:{port}", " "), " }",
46 " @shale_mcp_callback {", " path /-/callback", " header Cookie *studio_mcp_shale_link=*", " }",46 " @shale_mcp_callback {", " path /-/callback", " header Cookie *snowglobe_mcp_shale_link=*", " }",
47 " handle @shale_mcp_callback {", " rewrite * /oauth/shale/callback",47 " handle @shale_mcp_callback {", " rewrite * /oauth/shale/callback",
48 " request_header -User-Name", " request_header -User-Groups", " request_header -Studio-Proxy-Token",48 " request_header -User-Name", " request_header -User-Groups", " request_header -Snowglobe-Proxy-Token",
49 *proxy(f"127.0.0.1:{port}", " "), " }"]49 *proxy(f"127.0.0.1:{port}", " "), " }"]
5050
5151
...@@ -100,13 +100,12 @@ def shale_git_routes(upstreams):...@@ -100,13 +100,12 @@ def shale_git_routes(upstreams):
100100
101101
102def render(token):102def render(token):
103 with open(os.environ["STUDIO_PROXY_TOKEN_FILE"]) as file:103 with open(os.environ["SNOWGLOBE_PROXY_TOKEN_FILE"]) as file:
104 dashboard_proof = file.read().strip()104 dashboard_proof = file.read().strip()
105 if not re.fullmatch(r"[0-9a-fA-F]{64}", dashboard_proof):105 if not re.fullmatch(r"[0-9a-fA-F]{64}", dashboard_proof):
106 raise ValueError("invalid dashboard proxy token")106 raise ValueError("invalid dashboard proxy token")
107 auth_host = "auth." + os.environ["STUDIO_DOMAIN"]107 auth_host = "auth." + os.environ["SNOWGLOBE_DOMAIN"]
108 legacy_host = "keycloak." + os.environ["STUDIO_DOMAIN"]108 origins = json.dumps({"origins": ["https://snowglobe." + os.environ["SNOWGLOBE_DOMAIN"]]}, separators=(",", ":"))
109 origins = json.dumps({"origins": ["https://snowglobe." + os.environ["STUDIO_DOMAIN"]]}, separators=(",", ":"))
110 webauthn = [" handle /.well-known/webauthn {", ' header Content-Type application/json',109 webauthn = [" handle /.well-known/webauthn {", ' header Content-Type application/json',
111 f" respond {json.dumps(origins)} 200", " }"]110 f" respond {json.dumps(origins)} 200", " }"]
112 routes = {}111 routes = {}
...@@ -178,7 +177,7 @@ def render(token):...@@ -178,7 +177,7 @@ def render(token):
178 lines = []177 lines = []
179 for (listener, host), route in sorted(routes.items()):178 for (listener, host), route in sorted(routes.items()):
180 if host:179 if host:
181 if host in {auth_host, legacy_host}:180 if host == auth_host:
182 continue181 continue
183 role = route["authRole"]182 role = route["authRole"]
184 if role and not auth_upstreams:183 if role and not auth_upstreams:
...@@ -205,18 +204,18 @@ def render(token):...@@ -205,18 +204,18 @@ def render(token):
205 "/srv/staging/" + service)204 "/srv/staging/" + service)
206 if service == "shale":205 if service == "shale":
207 lines += [" handle /-/logout {", f" reverse_proxy {' '.join(sorted(route['upstreams']))} {{",206 lines += [" handle /-/logout {", f" reverse_proxy {' '.join(sorted(route['upstreams']))} {{",
208 f" header_down Location https://snowglobe.{os.environ['STUDIO_DOMAIN']}/auth/shale/sign-out",207 f" header_down Location https://snowglobe.{os.environ['SNOWGLOBE_DOMAIN']}/auth/shale/sign-out",
209 " @logged_out status 200 302 303 404", " handle_response @logged_out {",208 " @logged_out status 200 302 303 404", " handle_response @logged_out {",
210 " copy_response 303", " }", " }", " }"]209 " copy_response 303", " }", " }", " }"]
211 lines += shale_attachment_routes(" ".join(sorted(route["upstreams"])))210 lines += shale_attachment_routes(" ".join(sorted(route["upstreams"])))
212 lines += [" @userscript path_regexp userscript ^/userscripts/discord-pluralkit-predict(/.*)?$",211 lines += [" @userscript path_regexp userscript ^/userscripts/discord-pluralkit-predict(/.*)?$",
213 " redir @userscript /discord-pluralkit-predict{re.userscript.1}?{query} 308"]212 " redir @userscript /discord-pluralkit-predict{re.userscript.1}?{query} 308"]
214 port = int(os.environ["STUDIO_DASHBOARD_PORT"])213 port = int(os.environ["SNOWGLOBE_DASHBOARD_PORT"])
215 if not 1 <= port <= 65535:214 if not 1 <= port <= 65535:
216 raise ValueError("invalid dashboard port for Shale linking")215 raise ValueError("invalid dashboard port for Shale linking")
217 lines += shale_mcp_routes(port)216 lines += shale_mcp_routes(port)
218 lines += [" tracing {", f" span {service}", " span_attributes {",217 lines += [" tracing {", f" span {service}", " span_attributes {",
219 f" studio.service {service}", " studio.kind edge", " }", " }"]218 f" snowglobe.service {service}", " snowglobe.kind edge", " }", " }"]
220 manifest = os.path.join(ROUTE_DIR, service + ".json")219 manifest = os.path.join(ROUTE_DIR, service + ".json")
221 assets = {}220 assets = {}
222 headers = {}221 headers = {}
...@@ -285,17 +284,17 @@ def render(token):...@@ -285,17 +284,17 @@ def render(token):
285 ]284 ]
286 elif headers and (auth_upstreams or service == "copyparty"):285 elif headers and (auth_upstreams or service == "copyparty"):
287 native = service == "copyparty"286 native = service == "copyparty"
288 auth = f"127.0.0.1:{int(os.environ['STUDIO_DASHBOARD_PORT'])}" if native else " ".join(sorted(auth_upstreams))287 auth = f"127.0.0.1:{int(os.environ['SNOWGLOBE_DASHBOARD_PORT'])}" if native else " ".join(sorted(auth_upstreams))
289 if native:288 if native:
290 lines += [" handle /auth/file/* {", " request_header -User-Name", " request_header -User-Groups",289 lines += [" handle /auth/file/* {", " request_header -User-Name", " request_header -User-Groups",
291 f" request_header Studio-Proxy-Token {dashboard_proof}",290 f" request_header Snowglobe-Proxy-Token {dashboard_proof}",
292 " request_header X-Studio-Client-IP {remote_host}", *proxy(auth," "), " }"]291 " request_header X-Snowglobe-Client-IP {remote_host}", *proxy(auth," "), " }"]
293 else:292 else:
294 lines += [" handle /snow.oauth2/* {", *proxy(auth," "), " }"]293 lines += [" handle /snow.oauth2/* {", *proxy(auth," "), " }"]
295 lines += [" handle {"]294 lines += [" handle {"]
296 lines += [f" request_header -{name}" for name in scrub]295 lines += [f" request_header -{name}" for name in scrub]
297 lines += [f" reverse_proxy {auth} {{", " lb_try_duration 5s", *passive_health(auth, " "), " method GET", " rewrite " + ("/auth/file/check" if native else "/snow.oauth2/auth"),296 lines += [f" reverse_proxy {auth} {{", " lb_try_duration 5s", *passive_health(auth, " "), " method GET", " rewrite " + ("/auth/file/check" if native else "/snow.oauth2/auth"),
298 *([f" header_up Studio-Proxy-Token {dashboard_proof}"] if native else []),297 *([f" header_up Snowglobe-Proxy-Token {dashboard_proof}"] if native else []),
299 " header_up X-Forwarded-Method {method}", " header_up X-Forwarded-Uri {uri}",298 " header_up X-Forwarded-Method {method}", " header_up X-Forwarded-Uri {uri}",
300 " @authenticated status 2xx", " handle_response @authenticated {"]299 " @authenticated status 2xx", " handle_response @authenticated {"]
301 lines += [f" request_header {name} {{rp.header.{source}}}" for name, source in headers.items()]300 lines += [f" request_header {name} {{rp.header.{source}}}" for name, source in headers.items()]
...@@ -309,13 +308,13 @@ def render(token):...@@ -309,13 +308,13 @@ def render(token):
309 shale_page = service == "shale" or re.fullmatch(r"shale-preview-[0-9a-f]{8}", service)308 shale_page = service == "shale" or re.fullmatch(r"shale-preview-[0-9a-f]{8}", service)
310 page_headers = []309 page_headers = []
311 if shale_page:310 if shale_page:
312 page_upstream = f"127.0.0.1:{int(os.environ['STUDIO_DASHBOARD_PORT'])}"311 page_upstream = f"127.0.0.1:{int(os.environ['SNOWGLOBE_DASHBOARD_PORT'])}"
313 page_headers = [f" request_header Studio-Proxy-Token {dashboard_proof}",312 page_headers = [f" request_header Snowglobe-Proxy-Token {dashboard_proof}",
314 f" request_header Studio-Shale-Upstream {json.dumps(sorted(route['upstreams'])[0])}",313 f" request_header Snowglobe-Shale-Upstream {json.dumps(sorted(route['upstreams'])[0])}",
315 " request_header Studio-Shale-Uri {uri}",314 " request_header Snowglobe-Shale-Uri {uri}",
316 " rewrite * /auth/shale/page"]315 " rewrite * /auth/shale/page"]
317 for index, (request, markup) in enumerate(head_html.items()):316 for index, (request, markup) in enumerate(head_html.items()):
318 name = f"@studio_head_{index}"317 name = f"@snowglobe_head_{index}"
319 lines += [f" {name} path {request}", f" handle {name} {{", " route {",318 lines += [f" {name} path {request}", f" handle {name} {{", " route {",
320 f" replace </head> {json.dumps(markup + '</head>')} {{",319 f" replace </head> {json.dumps(markup + '</head>')} {{",
321 " match {", " header Content-Type text/html*", " }", " }",320 " match {", " header Content-Type text/html*", " }", " }",
...@@ -330,18 +329,16 @@ def render(token):...@@ -330,18 +329,16 @@ def render(token):
330 lines.insert(len(lines) - 1, " }")329 lines.insert(len(lines) - 1, " }")
331 else:330 else:
332 lines += [f":{listener} {{", *proxy(" ".join(sorted(route["upstreams"])), " "), "}"]331 lines += [f":{listener} {{", *proxy(" ".join(sorted(route["upstreams"])), " "), "}"]
333 dashboard_host = "snowglobe." + os.environ["STUDIO_DOMAIN"]332 dashboard_host = "snowglobe." + os.environ["SNOWGLOBE_DOMAIN"]
334 if any(not HOST.fullmatch(host) for host in [auth_host, legacy_host, dashboard_host]):333 if any(not HOST.fullmatch(host) for host in [auth_host, dashboard_host]):
335 raise ValueError("invalid login domain")334 raise ValueError("invalid login domain")
336 for host in [auth_host, legacy_host]:335 lines += [f"{auth_host} {{", *([" tls internal"] if auth_host.endswith(".test") else []),
337 lines += [f"{host} {{", *([" tls internal"] if host.endswith(".test") else []),336 *webauthn, " handle {", f" redir https://{dashboard_host}/ 308", " }", "}"]
338 *(webauthn if host == auth_host else []), " handle {",
339 f" redir https://{dashboard_host}/ 308", " }", "}"]
340 traces = next((route for route in routes.values() if "victoria-traces" in route["services"]), None)337 traces = next((route for route in routes.values() if "victoria-traces" in route["services"]), None)
341 if traces:338 if traces:
342 lines += ["http://127.0.0.1:10428 {", " bind 127.0.0.1",339 lines += ["http://127.0.0.1:10428 {", " bind 127.0.0.1",
343 *proxy(" ".join(sorted(traces["upstreams"])), " "), "}"]340 *proxy(" ".join(sorted(traces["upstreams"])), " "), "}"]
344 dashboard_port = int(os.environ["STUDIO_DASHBOARD_PORT"])341 dashboard_port = int(os.environ["SNOWGLOBE_DASHBOARD_PORT"])
345 if not 1 <= dashboard_port <= 65535:342 if not 1 <= dashboard_port <= 65535:
346 raise ValueError("invalid dashboard route")343 raise ValueError("invalid dashboard route")
347 if (80, dashboard_host) in routes:344 if (80, dashboard_host) in routes:
...@@ -349,25 +346,25 @@ def render(token):...@@ -349,25 +346,25 @@ def render(token):
349 lines.append(f"{dashboard_host} {{")346 lines.append(f"{dashboard_host} {{")
350 if dashboard_host.endswith(".test"):347 if dashboard_host.endswith(".test"):
351 lines.append(" tls internal")348 lines.append(" tls internal")
352 lines += [" encode zstd gzip", " tracing {", " span globe", " span_attributes {", " studio.kind edge", " }", " }"]349 lines += [" encode zstd gzip", " tracing {", " span globe", " span_attributes {", " snowglobe.kind edge", " }", " }"]
353 lines += [" handle {", " request_header -User-Name", " request_header -User-Groups",350 lines += [" handle {", " request_header -User-Name", " request_header -User-Groups",
354 f" request_header Studio-Proxy-Token {dashboard_proof}",351 f" request_header Snowglobe-Proxy-Token {dashboard_proof}",
355 " request_header X-Studio-Client-IP {remote_host}",352 " request_header X-Snowglobe-Client-IP {remote_host}",
356 *proxy(f"127.0.0.1:{dashboard_port}", " "), " }", "}"]353 *proxy(f"127.0.0.1:{dashboard_port}", " "), " }", "}"]
357 internal_port = os.environ.get("STUDIO_INTERNAL_PORT")354 internal_port = os.environ.get("SNOWGLOBE_INTERNAL_PORT")
358 if internal_port is not None:355 if internal_port is not None:
359 internal_host = "dashboard.internal." + os.environ["STUDIO_DOMAIN"]356 internal_host = "dashboard.internal." + os.environ["SNOWGLOBE_DOMAIN"]
360 if not HOST.fullmatch(internal_host) or not internal_port.isdecimal() or not 1 <= int(internal_port) <= 65535:357 if not HOST.fullmatch(internal_host) or not internal_port.isdecimal() or not 1 <= int(internal_port) <= 65535:
361 raise ValueError("invalid internal dashboard route")358 raise ValueError("invalid internal dashboard route")
362 if (80, internal_host) in routes or (int(internal_port), "") in routes:359 if (80, internal_host) in routes or (int(internal_port), "") in routes:
363 raise ValueError("internal dashboard route conflicts with a Nomad service")360 raise ValueError("internal dashboard route conflicts with a Nomad service")
364 lines += [f"{internal_host}:{internal_port} {{", " tls internal",361 lines += [f"{internal_host}:{internal_port} {{", " tls internal",
365 f" @dashboard header Studio-Proxy-Token {dashboard_proof}",362 f" @dashboard header Snowglobe-Proxy-Token {dashboard_proof}",
366 " handle @dashboard {", " request_header -Studio-Proxy-Token",363 " handle @dashboard {", " request_header -Snowglobe-Proxy-Token",
367 " request_header -User-Name", " request_header -User-Groups",364 " request_header -User-Name", " request_header -User-Groups",
368 " handle_path /nomad/* {", *proxy("127.0.0.1:4646", " ", host="{upstream_hostport}"), " }"]365 " handle_path /nomad/* {", *proxy("127.0.0.1:4646", " ", host="{upstream_hostport}"), " }"]
369 for service, upstreams in sorted(internal_services.items()):366 for service, upstreams in sorted(internal_services.items()):
370 host = f"{service}.{os.environ['STUDIO_DOMAIN']}" if service == "shale" or re.fullmatch(r"shale-preview-[0-9a-f]{8}", service) else "{upstream_hostport}"367 host = f"{service}.{os.environ['SNOWGLOBE_DOMAIN']}" if service == "shale" or re.fullmatch(r"shale-preview-[0-9a-f]{8}", service) else "{upstream_hostport}"
371 lines += [f" handle_path /services/{service}/* {{",368 lines += [f" handle_path /services/{service}/* {{",
372 *proxy(" ".join(sorted(upstreams)), " ", host=host), " }"]369 *proxy(" ".join(sorted(upstreams)), " ", host=host), " }"]
373 lines += [" handle {", " respond 404", " }", " }", " handle {", " respond 403", " }", "}"]370 lines += [" handle {", " respond 404", " }", " }", " handle {", " respond 403", " }", "}"]
tools/samba-macos-test.swift+2-2
...@@ -13,7 +13,7 @@ guard CommandLine.arguments.count == 2 else {...@@ -13,7 +13,7 @@ guard CommandLine.arguments.count == 2 else {
1313
14let fm = FileManager.default14let fm = FileManager.default
15let directory = URL(fileURLWithPath: CommandLine.arguments[1], isDirectory: true)15let directory = URL(fileURLWithPath: CommandLine.arguments[1], isDirectory: true)
16 .appendingPathComponent(".studio-smb-test-\(UUID().uuidString)", isDirectory: true)16 .appendingPathComponent(".snowglobe-smb-test-\(UUID().uuidString)", isDirectory: true)
17var failures = 017var failures = 0
1818
19func check(_ condition: Bool) throws {19func check(_ condition: Bool) throws {
...@@ -68,7 +68,7 @@ do {...@@ -68,7 +68,7 @@ do {
68 try check(Data(contentsOf: package.appendingPathComponent("TXT.rtf")) == first)68 try check(Data(contentsOf: package.appendingPathComponent("TXT.rtf")) == first)
69 }69 }
70 test("metadata and large resource fork copy") {70 test("metadata and large resource fork copy") {
71 let attributes = ["com.apple.studio-smb-test": first, "com.apple.ResourceFork": Data(repeating: 0x5a, count: 128 * 1024)]71 let attributes = ["com.apple.snowglobe-smb-test": first, "com.apple.ResourceFork": Data(repeating: 0x5a, count: 128 * 1024)]
72 for (name, value) in attributes {72 for (name, value) in attributes {
73 let result = value.withUnsafeBytes { setxattr(file.path, name, $0.baseAddress, $0.count, 0, 0) }73 let result = value.withUnsafeBytes { setxattr(file.path, name, $0.baseAddress, $0.count, 0, 0) }
74 guard result == 0 else { throw NSError(domain: NSPOSIXErrorDomain, code: Int(errno)) }74 guard result == 0 else { throw NSError(domain: NSPOSIXErrorDomain, code: Int(errno)) }
tools/service-dependencies.md+37-37
...@@ -1,37 +1,37 @@...@@ -1,37 +1,37 @@
1# Service connection checks1# Service dependencies and rollout
22
3On 2026-09-26, the VM's pgAdmin database contained one configured server, `Clover Postgres`, at the current Nomad address and port. A query from the pgAdmin container using its rendered environment authenticated to the `postgres` database. The `pg.studio.test` health route passed. Zenith's pgAdmin also had one saved server; Snow Globe creates its connection from the Postgres requirement on boot.3Declare providers and requirements in Pkl. Provisioning allocates private
44inputs, and Nomad templates discover provider endpoints. Watched endpoint
5Redis Insight's `/api/databases/0/info` initially connected to the VM Redis service. After stopping Redis allocation `7ca6e34a`, Nomad placed a new one and changed its port from `26848` to `26913`. Redis Insight's watched `nomadService` template restarted its task once; its saved connection then used `26913` and `/api/databases/0/info` connected again. A temporary Redis key survived the reallocation and was deleted afterward. Both `redis.studio.test` and `pg.studio.test` passed their HTTP checks. [Nomad's template `change_mode` defaults to `restart`](https://developer.hashicorp.com/nomad/docs/job-specification/template), and [Redis Insight applies changed preconfigured connections after a restart](https://redis.io/docs/latest/operate/redisinsight/configuration/).5changes restart consumers; applications that persist internal endpoints must
66receive repeatable setup updates. [configure-arr.py](configure-arr.py), for
7After the x86 VM crashed and rebooted on 2026-09-26, Keycloak needed several minutes to start under emulation. Shale's earlier `wait-keycloak-app` prestart task remained marked complete, so Shale restarted 19 times while its OIDC discovery endpoint returned 404. Forward Auth also retried. Both recovered when Keycloak became healthy. [Nomad does not rerun a successful non-sidecar prestart task after a task restart](https://developer.hashicorp.com/nomad/docs/job-specification/lifecycle).7example, derives Jackett/qBittorrent endpoints and remote path mappings from
88the service declarations.
9Evil.inc Forgejo and HedgeDoc remained running but unhealthy after the same reboot. Forgejo had tried PostgreSQL before it was ready and then stopped making progress. Targeted `nomad job restart -all-tasks` calls recovered both; the full 19-route Snow Globe check then passed. Snow Globe now renders a one-minute retry delay for dependent services and [Nomad `check_restart`](https://developer.hashicorp.com/nomad/docs/job-specification/check_restart) for unhealthy services. Disposable one- and two-task Nomad jobs proved that a failing group-level check restarts every running task in its group. Eight generated jobs, including Keycloak, Forgejo, and HedgeDoc, passed `nomad job validate`.9
1010A successful non-sidecar prestart task is not rerun on every application
11Release `7ec7b25654702110` staged Shale from its ZFS clone and promoted to the VM after backup `20260926T134201Z-22d930` captured 22 service datasets. The promotion passed all 19 HTTPS routes. Live Nomad inspection confirmed Shale's one-minute retry delay and five-minute health-check grace, plus Forgejo's 20-minute grace from its declared healthy deadline.11restart. Dependent jobs therefore also need runtime retry and health recovery.
1212The schema and renderer own retry delays, health-restart grace, and deployment
13After a clean VM reboot, PostgreSQL passed first, Keycloak became healthy at 14:04 UTC, and Shale recovered on its next one-minute retry. Forgejo remained running but unhealthy after its early database connection failed. At 14:15 UTC, Nomad's group-level `check_restart` restarted both Forgejo and Anubis without intervention; both checks and Forgejo's HTTPS route passed by 14:17 UTC. The full 19-route check passed after reboot. From the Mac, Shale, Keycloak discovery, and the Shale preview returned 200 through `.studio.test` DNS and trusted TLS. The 20-minute grace made Forgejo's recovery too slow, so its service now declares a two-minute health-restart grace, separate from its deployment deadline.13deadlines. Verify the actual client connection after provider reallocation;
1414a healthy application HTTP route alone does not prove database connectivity.
15Keycloak preview `keycloak-preview-dbe9aba6` ran with the production `start` command against a cloned database. Its OIDC discovery advertised the preview hostname. Release `47342c5c49f3eb88` promoted that preview after backup `20260926T141745Z-93733a` captured 22 service datasets. The production Keycloak allocation passed its health check with zero restarts; the promotion completed its dependency allocation and all 19 HTTPS checks. From the Mac, discovery returned HTTP 200 with a trusted certificate and issuer `https://keycloak.studio.test/realms/master`. Live job inspection confirmed `start`, the full production hostname, and Forgejo's two-minute check-restart grace.15
1616The default single-allocation rollout stops the old writer before starting the
17Shale and Jellyfin currently use writable SQLite datasets, so their single-allocation `simple` rollouts cannot overlap old and new writers. The owner accepted a brief Shale restart after staged validation. A controlled restart of the Shale preview on the x86 VM returned 46 failed HTTPS probes from this Mac between 4.87 and 23.14 seconds into a 0.25-second sampling run. Nomad reported the task restart complete after two seconds, before the Caddy route served requests again. The preview subsequently returned HTTP 200 with trusted TLS and one running allocation. This measures a restart under x86 emulation, not a production release rollout or physical-host downtime.17new one. Writable SQLite stores cannot safely overlap writers. Stateless jobs
1818can declare canary rollout when their ports and mounts allow it. Generated
19Open Speed Test has no writable mounts or fixed ports, so its job now uses Nomad's overlapping canary. The first VM promotion automatically promoted a healthy canary, but one of 200 Mac HTTPS probes received HTTP 502 when Caddy dialed the retiring allocation's closed port before a route reload. The router now gives generated reverse proxies a five-second retry window and remembers failed upstream connections for 30 seconds, using [Caddy's documented load balancing options](https://caddyserver.com/docs/caddyfile/directives/reverse_proxy). The next staged release validated the generated Caddyfile and automatically promoted another healthy canary; 510 consecutive Mac HTTPS probes from 03:19:41 to 03:22:11 UTC returned 200, spanning its 03:21:05–03:21:20 rollout. This is a sampled VM result, not a guarantee that every request in future rollouts will succeed.19Caddy proxies retry connection failures while service discovery catches up;
2020this does not guarantee uninterrupted long-running requests or WebSockets.
21For a new clone stage with a PostgreSQL database requirement, Snow Globe now snapshots the service dataset and PostgreSQL dataset in one ZFS operation, which [OpenZFS creates atomically](https://openzfs.github.io/openzfs-docs/man/v2.1/8/zfs-snapshot.8.html). It starts an isolated PostgreSQL container from the latter snapshot and copies the database from that container into a stage database on the live PostgreSQL server. The 2026-09-27 HedgeDoc preview `evil-hedgedoc-preview-31768845` completed its Nomad deployment and returned HTTP 200 from the Mac. Its service snapshot remains for the preview; the temporary PostgreSQL snapshot, clone, and container were removed. This aligns the file and database fork point for these services, while applications remain responsible for their own crash recovery from the snapshots.21
2222A new cloned preview snapshots its service dataset, writable external ZFS
23Writable external ZFS mounts now join that same snapshot operation. The recreated YouTube Feed preview `yt-feed-preview-63d74b72` mounted cloned service data and a cloned writable Clover configuration folder, then completed its Nomad deployment. Both source snapshots report `createtxg=35540`, and the preview's VM health check passed. The Mac route redirected to authentication as configured.23mounts, and PostgreSQL dataset in one operation. An isolated PostgreSQL clone
2424supplies the preview database. The temporary database clone is removed after
25The preview's web container wrote a disposable file through `/yt-config` as its assigned `3118:3000` identity. It appeared in the cloned Clover configuration folder with that owner and was absent from `/srv/clover/Documents/Config/Youtube Downloader`; the file was removed afterward. This verifies writable external mount isolation and group access through the container, beyond snapshot metadata alone.25copying. Repeating staging retains existing preview data; fresh isolation
2626starts empty and rejects writable external mounts. Review outbound side
27An encrypted ZFS rehearsal on the VM created separate source and staging encryption roots, then cloned a source snapshot beneath the staging root. The clone mounted, retained the source encryption root and origin, initially used `0B`, and accepted a write without changing the source file. The temporary datasets and keys were destroyed afterward. Production staging therefore needs the source dataset key loaded while its clone exists; placing the clone below a separately encrypted staging parent does not rekey it.27effects independently of filesystem isolation.
2828
29Promotion of `c1f546fe904f4c33` stopped during Keycloak configuration. The old task digest included every file in each service folder, so a change to PostgreSQL's `provide.py` restarted PostgreSQL despite no database job configuration change. Keycloak's watched database endpoint then restarted its existing task; its group-level health check restarted that task again before x86 startup completed. A fresh Keycloak allocation completed startup, and all 19 production routes passed. Snow Globe now hashes source files into a task environment variable only for services with a `prepare` script, since those scripts change startup files under managed volumes. Editing PostgreSQL's provider script left its rendered job identical in a temporary release copy; editing qBittorrent's prepare script changed its rendered job. Single-container Nomad services now associate their checks with the task, and setup waits for its route before calling the app API. All 26 generated jobs validated. The new Keycloak preview reached HTTPS health and completed setup with zero restarts; after a manual in-place restart, it had no health-triggered restart through its nine-minute startup.29ZFS clones retain their source encryption root, even below the independently
3030encrypted staging parent. Keep source keys available while clones exist.
31Release `c19bee75fad72499` promoted successfully after backup `20260927T042521Z-9fcd75`; all 19 routes passed. Keycloak's production allocation reached health after its slow x86 build and startup with zero restarts. The Mac reached Keycloak and Shale with HTTP 200 and Jellyfin with its expected login redirect. During pgAdmin startup, QEMU paused with a host disk I/O error. Removing the two detached NixOS installer ISOs and moving the unused arm64 demo disk to `/Volumes/Project/Studio VM Archives/clover-studio-vm-arm64.qcow2` freed host space; QEMU resumed and the same promotion process finished. The resulting release history and `/opt/studio/current` both point at `c19bee75fad72499`.31Fresh previews inherit staging encryption. Verify actual mount bindings before
3232allowing disposable writes, especially read-only personal mounts.
33Read-only `nomad job plan` checks against the active release returned no allocation creates or destroys for PostgreSQL, Keycloak, or Shale. Their rendered HCL files were byte-identical to `nomad job inspect -hcl`. Nomad still described each plan as one in-place update without a field-level diff, so that phrase alone is not evidence of a changed job or a task restart. [The Nomad CLI defines exit code 0 as no allocation creation or destruction](https://developer.hashicorp.com/nomad/commands/job/plan). Resubmitting the identical PostgreSQL job retained its allocation `ff3fc333` and version 14; Keycloak retained allocation `d1c5e27a`.33
3434Inspect generated-job changes before expecting a restart. A provider script
35Release `9ee7ba520b01b1e5` staged YouTube Triage with its writable external clone, passed the VM NixOS dry build, and promoted after backup `20260927T053411Z-183aca`. The NixOS switch raised the demo pool size to 16 GB; all 19 routes passed. PostgreSQL, Keycloak, Jellyfin, Shale, and Dawarich kept allocation IDs `ff3fc333`, `d1c5e27a`, `c2b6c232`, `25050918`, and `abad9408` through this promotion. The Mac received HTTP 302 at the protected preview URL and HTTP 200 from Shale.35change can alter setup without changing a running job. Prepared startup files
3636are included in task change detection; unrelated files are not. A Nomad plan
37The manual CLI rolled back from `9ee7ba520b01b1e5` to `c19bee75fad72499` after backup `20260927T054434Z-67d6c0`, switched the NixOS host configuration, and passed all 19 routes. Promoting the same preview again backed up the rollback state as `20260927T055034Z-27d895`, restored NixOS release `9ee7ba520b01b1e5`, and passed the same route sweep. Those five sampled allocations kept their IDs through both switches; the Mac still received Shale HTTP 200 and the protected preview's HTTP 302. Data restore was not invoked by code rollback.37reporting an in-place update alone does not establish that tasks will restart.
tools/shale-labels-test.py+5-5
...@@ -15,20 +15,20 @@ class ShaleTests(unittest.TestCase):...@@ -15,20 +15,20 @@ class ShaleTests(unittest.TestCase):
15 def setUp(self):15 def setUp(self):
16 self.temp = tempfile.TemporaryDirectory()16 self.temp = tempfile.TemporaryDirectory()
17 self.root = Path(self.temp.name)17 self.root = Path(self.temp.name)
18 self.env = patch.dict(os.environ, {'STUDIO_SHALE_DATABASE': str(self.root / 'shale.sqlite'),18 self.env = patch.dict(os.environ, {'SNOWGLOBE_SHALE_DATABASE': str(self.root / 'shale.sqlite'),
19 'STUDIO_DASHBOARD_DATA': str(self.root), 'STUDIO_DOMAIN': 'studio.test', 'STUDIO_SHALE_POLICY': str(self.root / 'policy.json')})19 'SNOWGLOBE_DASHBOARD_DATA': str(self.root), 'SNOWGLOBE_DOMAIN': 'snowglobe.test', 'SNOWGLOBE_SHALE_POLICY': str(self.root / 'policy.json')})
20 self.env.start()20 self.env.start()
21 (self.root / 'policy.json').write_text(json.dumps({'actorOwners': {'ai': 'owner'}, 'statusDelegates': {'ai': ['chat']}}))21 (self.root / 'policy.json').write_text(json.dumps({'actorOwners': {'ai': 'owner'}, 'statusDelegates': {'ai': ['chat']}}))
22 with sqlite3.connect(self.root / 'accounts.sqlite') as db:22 with sqlite3.connect(self.root / 'accounts.sqlite') as db:
23 db.execute("CREATE TABLE users(id TEXT PRIMARY KEY,profile TEXT,username TEXT GENERATED ALWAYS AS (json_extract(profile,'$.username')) STORED UNIQUE)")23 db.execute("CREATE TABLE users(id TEXT PRIMARY KEY,profile TEXT,username TEXT GENERATED ALWAYS AS (json_extract(profile,'$.username')) STORED UNIQUE)")
24 for name in ('owner', 'other', 'ai'):24 for name in ('owner', 'other', 'ai'):
25 db.execute('INSERT INTO users(id,profile) VALUES(?,?)', (name, json.dumps({'username': name, 'enabled': True})))25 db.execute('INSERT INTO users(id,profile) VALUES(?,?)', (name, json.dumps({'username': name, 'enabled': True})))
26 self.grant = {'id': 'fixture', 'user': 'owner', 'resource': 'https://snowglobe.studio.test/mcp/shale', 'scopes': ['shale:write'], 'resources': ['chat']}26 self.grant = {'id': 'fixture', 'user': 'owner', 'resource': 'https://snowglobe.snowglobe.test/mcp/shale', 'scopes': ['shale:write'], 'resources': ['chat']}
27 with sqlite3.connect(self.root / 'connections.sqlite') as db:27 with sqlite3.connect(self.root / 'connections.sqlite') as db:
28 db.execute('CREATE TABLE records(key TEXT PRIMARY KEY,value TEXT,last_updated INTEGER)')28 db.execute('CREATE TABLE records(key TEXT PRIMARY KEY,value TEXT,last_updated INTEGER)')
29 db.execute('INSERT INTO records VALUES(?,?,0)', ('grant:fixture', json.dumps(self.grant)))29 db.execute('INSERT INTO records VALUES(?,?,0)', ('grant:fixture', json.dumps(self.grant)))
30 for name in ('owner', 'other', 'ai'):30 for name in ('owner', 'other', 'ai'):
31 db.execute('INSERT INTO records VALUES(?,?,0)', ('shale-session:' + name, json.dumps({'origin': 'https://shale.studio.test/'})))31 db.execute('INSERT INTO records VALUES(?,?,0)', ('shale-session:' + name, json.dumps({'origin': 'https://shale.snowglobe.test/'})))
32 self.db = sqlite3.connect(self.root / 'shale.sqlite')32 self.db = sqlite3.connect(self.root / 'shale.sqlite')
33 self.db.executescript('''33 self.db.executescript('''
34 CREATE TABLE users(id INTEGER PRIMARY KEY,uuid TEXT,name TEXT,provider TEXT,snowflake TEXT,joined_on TEXT,last_updated TEXT);34 CREATE TABLE users(id INTEGER PRIMARY KEY,uuid TEXT,name TEXT,provider TEXT,snowflake TEXT,joined_on TEXT,last_updated TEXT);
...@@ -37,7 +37,7 @@ class ShaleTests(unittest.TestCase):...@@ -37,7 +37,7 @@ class ShaleTests(unittest.TestCase):
37 CREATE TABLE issue_labels(id INTEGER PRIMARY KEY,uuid TEXT,repo INTEGER REFERENCES repositories(id),name TEXT,description TEXT,color TEXT,open_issues INTEGER DEFAULT 0,last_updated TEXT);37 CREATE TABLE issue_labels(id INTEGER PRIMARY KEY,uuid TEXT,repo INTEGER REFERENCES repositories(id),name TEXT,description TEXT,color TEXT,open_issues INTEGER DEFAULT 0,last_updated TEXT);
38 CREATE TABLE issues__labels(id INTEGER PRIMARY KEY,uuid TEXT,issue INTEGER REFERENCES issues(id),label INTEGER REFERENCES issue_labels(id));38 CREATE TABLE issues__labels(id INTEGER PRIMARY KEY,uuid TEXT,issue INTEGER REFERENCES issues(id),label INTEGER REFERENCES issue_labels(id));
39 CREATE TABLE issue_actions(id INTEGER PRIMARY KEY,uuid TEXT,issue INTEGER REFERENCES issues(id),actor INTEGER REFERENCES users(id),kind TEXT,payload TEXT,last_updated TEXT,added_on TEXT,deleted_on TEXT);39 CREATE TABLE issue_actions(id INTEGER PRIMARY KEY,uuid TEXT,issue INTEGER REFERENCES issues(id),actor INTEGER REFERENCES users(id),kind TEXT,payload TEXT,last_updated TEXT,added_on TEXT,deleted_on TEXT);
40 INSERT INTO users(id,name,provider,snowflake) VALUES(1,'owner','snowglobe.studio.test','owner'),(2,'other','snowglobe.studio.test','other'),(3,'ai','snowglobe.studio.test','ai');40 INSERT INTO users(id,name,provider,snowflake) VALUES(1,'owner','snowglobe.snowglobe.test','owner'),(2,'other','snowglobe.snowglobe.test','other'),(3,'ai','snowglobe.snowglobe.test','ai');
41 INSERT INTO repositories(id,name,owner,last_updated) VALUES(1,'chat',1,''),(2,'other',2,'');41 INSERT INTO repositories(id,name,owner,last_updated) VALUES(1,'chat',1,''),(2,'other',2,'');
42 INSERT INTO issues(id,repo,number,status,last_updated) VALUES(1,1,1,'todo',''),(2,1,2,'done',''),(3,2,1,'todo','');42 INSERT INTO issues(id,repo,number,status,last_updated) VALUES(1,1,1,'todo',''),(2,1,2,'done',''),(3,2,1,'todo','');
43 ''')43 ''')
tools/shale-labels.py+7-7
...@@ -15,7 +15,7 @@ Error = import_module('dashboard-run').Error...@@ -15,7 +15,7 @@ Error = import_module('dashboard-run').Error
1515
1616
17def database(mode, timeout):17def database(mode, timeout):
18 path = Path(os.environ.get('STUDIO_SHALE_DATABASE', '/srv/prod/shale/data/astheno.shale.db'))18 path = Path(os.environ.get('SNOWGLOBE_SHALE_DATABASE', '/srv/prod/shale/data/astheno.shale.db'))
19 return sqlite3.connect(path.as_uri() + '?mode=' + mode, uri=True, timeout=timeout)19 return sqlite3.connect(path.as_uri() + '?mode=' + mode, uri=True, timeout=timeout)
2020
2121
...@@ -36,7 +36,7 @@ def metadata(request):...@@ -36,7 +36,7 @@ def metadata(request):
36 or any(not isinstance(n, str) or len(n) > 254 for n in names)36 or any(not isinstance(n, str) or len(n) > 254 for n in names)
37 or request['repository'] is not None and not isinstance(request['repository'], str)):37 or request['repository'] is not None and not isinstance(request['repository'], str)):
38 raise Error(400, 'Choose up to 1024 account names.')38 raise Error(400, 'Choose up to 1024 account names.')
39 accounts = Path(os.environ.get('STUDIO_DASHBOARD_DATA', '/var/lib/studio/dashboard'))39 accounts = Path(os.environ.get('SNOWGLOBE_DASHBOARD_DATA', '/var/lib/snowglobe/dashboard'))
40 with closing(database('ro', 2)) as db:40 with closing(database('ro', 2)) as db:
41 db.execute('ATTACH DATABASE ? AS auth', ((accounts / 'accounts.sqlite').as_uri() + '?mode=ro',))41 db.execute('ATTACH DATABASE ? AS auth', ((accounts / 'accounts.sqlite').as_uri() + '?mode=ro',))
42 result = {}42 result = {}
...@@ -46,14 +46,14 @@ def metadata(request):...@@ -46,14 +46,14 @@ def metadata(request):
46 "JOIN auth.users h ON h.id=json_extract(a.profile,'$.owner') "46 "JOIN auth.users h ON h.id=json_extract(a.profile,'$.owner') "
47 "JOIN users o ON o.snowflake=h.id AND o.provider=u.provider "47 "JOIN users o ON o.snowflake=h.id AND o.provider=u.provider "
48 "WHERE u.provider=? AND json_extract(a.profile,'$.kind')='ai' AND u.name IN (" + ','.join('?' for _ in names) + ")",48 "WHERE u.provider=? AND json_extract(a.profile,'$.kind')='ai' AND u.name IN (" + ','.join('?' for _ in names) + ")",
49 ['snowglobe.' + os.environ.get('STUDIO_DOMAIN', 'studio.test'), *names]):49 ['snowglobe.' + os.environ.get('SNOWGLOBE_DOMAIN', 'snowglobe.test'), *names]):
50 result[name] = {'model': model, 'owner': owner, 'picture': picture}50 result[name] = {'model': model, 'owner': owner, 'picture': picture}
51 for name, seed, picture in db.execute(51 for name, seed, picture in db.execute(
52 "SELECT u.name,u.uuid,json_extract(a.profile,'$.attributes.picture[0]') "52 "SELECT u.name,u.uuid,json_extract(a.profile,'$.attributes.picture[0]') "
53 "FROM users u JOIN auth.users a ON a.id=u.snowflake "53 "FROM users u JOIN auth.users a ON a.id=u.snowflake "
54 "WHERE u.provider=? AND coalesce(json_extract(a.profile,'$.kind'),'user') NOT IN ('ai','guest') "54 "WHERE u.provider=? AND coalesce(json_extract(a.profile,'$.kind'),'user') NOT IN ('ai','guest') "
55 "AND u.name IN (" + ','.join('?' for _ in names) + ")",55 "AND u.name IN (" + ','.join('?' for _ in names) + ")",
56 ['snowglobe.' + os.environ.get('STUDIO_DOMAIN', 'studio.test'), *names]):56 ['snowglobe.' + os.environ.get('SNOWGLOBE_DOMAIN', 'snowglobe.test'), *names]):
57 if picture:57 if picture:
58 result[name] = {'avatar': seed, 'picture': picture}58 result[name] = {'avatar': seed, 'picture': picture}
59 row = db.execute("SELECT (SELECT count(*) FROM issues WHERE repo=r.id AND status NOT IN ('done','not_planned','duplicate','invalid')) FROM repositories r WHERE name=?", (request['repository'],)).fetchone()59 row = db.execute("SELECT (SELECT count(*) FROM issues WHERE repo=r.id AND status NOT IN ('done','not_planned','duplicate','invalid')) FROM repositories r WHERE name=?", (request['repository'],)).fetchone()
...@@ -117,8 +117,8 @@ def handle(request):...@@ -117,8 +117,8 @@ def handle(request):
117 raise Error(400, 'Supply issue text within the tool limits.')117 raise Error(400, 'Supply issue text within the tool limits.')
118 if action == 'create_issue' and args['status'] not in ('needs_triage', 'todo'):118 if action == 'create_issue' and args['status'] not in ('needs_triage', 'todo'):
119 raise Error(400, 'Choose triage or todo for a new issue.')119 raise Error(400, 'Choose triage or todo for a new issue.')
120 accounts = Path(os.environ.get('STUDIO_DASHBOARD_DATA', '/var/lib/studio/dashboard'))120 accounts = Path(os.environ.get('SNOWGLOBE_DASHBOARD_DATA', '/var/lib/snowglobe/dashboard'))
121 domain = os.environ.get('STUDIO_DOMAIN', 'studio.test')121 domain = os.environ.get('SNOWGLOBE_DOMAIN', 'snowglobe.test')
122 with closing(database('rw', 10)) as db, db:122 with closing(database('rw', 10)) as db, db:
123 db.row_factory = sqlite3.Row123 db.row_factory = sqlite3.Row
124 db.execute('PRAGMA foreign_keys=ON')124 db.execute('PRAGMA foreign_keys=ON')
...@@ -139,7 +139,7 @@ def handle(request):...@@ -139,7 +139,7 @@ def handle(request):
139 native_caller = db.execute('SELECT id FROM users WHERE provider=? AND snowflake=?', ('snowglobe.' + domain, grant['user'])).fetchone()139 native_caller = db.execute('SELECT id FROM users WHERE provider=? AND snowflake=?', ('snowglobe.' + domain, grant['user'])).fetchone()
140 if not repo or not native_caller or repo[2] == 'off':140 if not repo or not native_caller or repo[2] == 'off':
141 raise Error(403, 'This Shale connection cannot edit this repository.')141 raise Error(403, 'This Shale connection cannot edit this repository.')
142 policy = json.loads(Path(os.environ.get('STUDIO_SHALE_POLICY', str(Path(__file__).resolve().parent.parent / 'config/shale.json'))).read_text())142 policy = json.loads(Path(os.environ.get('SNOWGLOBE_SHALE_POLICY', str(Path(__file__).resolve().parent.parent / 'config/shale.json'))).read_text())
143 owner = policy.get('actorOwners', {}).get(caller[0], grant['user'])143 owner = policy.get('actorOwners', {}).get(caller[0], grant['user'])
144 issue = None if action == 'create_issue' or 'id' not in args else db.execute('SELECT id,status,author,title FROM issues WHERE repo=? AND number=?', (repo[0], args['id'])).fetchone()144 issue = None if action == 'create_issue' or 'id' not in args else db.execute('SELECT id,status,author,title FROM issues WHERE repo=? AND number=?', (repo[0], args['id'])).fetchone()
145 if 'id' in args and not issue:145 if 'id' in args and not issue:
tools/shale-migration.md deleted-83
...@@ -1,83 +0,0 @@
1# Shale migration
2
3Shale is the sole Git server on Zenith. Personal Forgejo is retired. Retained Forgejo repositories and database exports remain migration sources; copying the existing Shale directory does not import repositories that only existed in Forgejo. The legacy multi-server SSH router is not part of the target setup.
4
5The 2026-10-04 personal inventory found 12 Shale owned repositories, no Shale mirrors, and 19 retained Forgejo bare repositories: 18 under `clo` and one under `nix`. Forgejo's retained LFS directory contains no files. Complete both imports before Shale's first production activation.
6
7The production data migration on 2026-10-04 completed before activating either production Shale or Postgres. The retained Shale copy passed checksum and SQLite checks, then all 19 Forgejo histories imported with verified object-file hashes and ref mappings. The result contains 21 repository records. All 11 private Forgejo sources retain private access; existing Shale identities, tokens, and sessions survive. The original session secret is preserved in the Nomad variable and its private recovery copy. Production import evidence is `/var/lib/studio/shale-forgejo-import-ldfl9zuy/repositories.json`; the earlier service dataset state is `globe/prod/shale@before-shale-import-1791160403-42496`.
8
9After copying the retained Shale state into `/srv/prod/shale`, [import-forgejo-to-shale.py](import-forgejo-to-shale.py) imports the additional histories while Shale stays stopped. Its metadata JSON comes only from the separately restored **personal** Forgejo PostgreSQL database:
10
11```sql
12SELECT coalesce(json_agg(x), '[]') FROM (
13 SELECT r.id, r.owner_id, u.lower_name AS owner_name,
14 r.lower_name, r.name, r.is_private, r.default_branch,
15 r.is_empty, r.is_mirror
16 FROM repository r JOIN "user" u ON u.id = r.owner_id
17 ORDER BY u.lower_name, r.lower_name
18) x;
19```
20
21```sh
22python3 tools/import-forgejo-to-shale.py \
23 --target /srv/prod/shale \
24 --metadata /run/personal-forgejo-repositories.json
25```
26
27The importer preserves existing Shale identities and repository records. Clover's repositories retain their names; the other namespace becomes `nix/config`. It copies and hashes Git objects without copying Forgejo hooks or configuration. Missing branches, tags, pull refs, and notes retain their names. A divergent branch or tag is retained under `refs/heads/forgejo/<owner>/...` or `refs/tags/forgejo/<owner>/...`; other conflicting refs use `refs/forgejo/<owner>/...`. Existing Shale refs retain their values, including newer histories already migrated from old mirrors. Former Forgejo mirrors become owned histories, with their original mirror status recorded in the private evidence. That directory contains every original ref, its destination, all copied object hashes, and the previous SQLite database.
28
29New repository access follows verified Forgejo visibility, with pushes restricted to the owner and issue submission disabled. When private Forgejo history joins an existing repository, public or unlisted permissions are tightened to private **before objects are copied**; existing `off` permissions remain off. An import failure must leave Shale stopped. Restoring only the previous database can re-expose imported private objects through its old public permissions, so recovery must preserve the tightened access or restore the complete service dataset.
30
31Existing Shale account IDs and OIDC subjects must survive the cutover. A deliberate issuer move uses `service/shale/prepare.py` to rebind the provider before startup; duplicate bindings stop the migration. Shale caches repository metadata and access at startup, so finish SQLite changes before starting the application. An isolated pinned-image test proved direct registration of a new repository: private anonymous web access returned 404 and Git discovery returned 401; after public permissions and a restart, its page and Git advertisement returned 200 with the original branch object ID. The test used copied data, `--network none`, and no published ports.
32
33A full-data test imported all 19 retained Forgejo histories into a disposable copy of the existing Shale state, yielding 21 repository records. Its conservative fixture metadata marked every incoming repository private. Every copied object file and every source ref passed verification. The pinned application then denied anonymous access to a new private repository and a formerly public collision, while preserving an unaffected public repository. On that isolated copy, public test permissions proved HTTP pages and Git advertisements for `bgds`, `home-infra`, and `nix/config`; `home-infra` advertised the original Forgejo `main` and `vllm`. An actual smart HTTP fetch returned a 53-object pack with a verified pack checksum. Production visibility must come from the restored Forgejo metadata, not this test fixture.
34
35After migration and authenticated browser checks, push the new infra `main` to `https://shale.paperclover.net/home-infra.git` with a Shale personal access token. The existing `home-infra` record and UUID are retained; the imported Forgejo branches remain available alongside the tested final `main`.
36
37The October 5 issue migration uses `tools/import-forgejo-issues.py` and the verified personal PostgreSQL export at `/var/lib/studio/forgejo-issue-migration/source.json`. Its sibling `source-proof.json` records the source checksum. The export contains 452 issues, 1,429 comments and events, 60 labels, 24 attachments, and 312 history revisions. Pull request discussions become issues with their original branch and merge metadata. Historical authors retain their names through non-login identities; `paperclover` maps to the existing Clover account. Original creation, update, and comment timestamps are preserved. Every source row is retained in the private `studio_forgejo_records` ledger, including revision history that Shale cannot present as editable comments.
38
39Run this while the target job is stopped and its allocations have exited:
40
41```sh
42python3 tools/import-forgejo-issues.py \
43 --target /srv/prod/shale \
44 --source /var/lib/studio/forgejo-issue-migration/source.json
45```
46
47For an isolated stage, add `--rehearsal` and use `/srv/staging/shale-preview-<id>`. The importer verifies the export checksum, checks that the target job is stopped before writing and immediately before commit, backs up SQLite into a private evidence directory, verifies native issue records remain unchanged, and supports an idempotent rerun of the same export. Take a full service ZFS snapshot before the production import as well. Do not replace production with the stage clone: import again into the stopped production dataset so newer native issues survive.
48
49Six occupied numbers are remapped: `chat` #1→#6 and #2→#7; `home-infra` #1→#38, #2→#39, and #3→#40; `react-mutation` #1→#19. All other original numbers remain. Explicit Forgejo issue links are rewritten and remapped bodies identify their original number. Bare `#references` and code text remain untouched. Attachments are copied with verified SHA-256 hashes and served through an authorization check against their associated Shale issue. Their local files are readable only by root and Caddy; private issue attachments remain private.
50
51The writable ZFS rehearsal `shale-preview-0242cee6` starts from all 104 existing native issues and imports to 556 total. It preserves the original Clover OIDC identity. September's `r1616-ga87d2f5.zig.0.16.0` avoids the `r1758` anonymous deleted-comment crash, but its Markdown scanner uses a shared capture buffer and crashes under concurrent fenced-code rendering. The documented `NPROC=1` worker setting avoids that race. With this setting, 904 authenticated/anonymous imported-issue requests passed with eight clients, all 24 attachment hashes and access checks passed, and browser closing of a disposable copy of `chat` #1 succeeded. Production `chat` #1 remains untouched.
52
53Production issue import completed on October 5 under release `dda941e618934ad9`, from committed main `51be72a9`. Recovery snapshot: `globe/prod/shale@before-forgejo-issues-20261005T080143Z-14c71a`. The private import report and SQLite backup live at `/var/lib/studio/forgejo-issue-migration/issue-import-c726euv2`. All 104 native issues survived alongside the 452 imported issues. After the route reload settled, 904 concurrent HTTPS issue reads passed (644 successful reads, 260 expected private-page denials), all 24 attachment hashes and access checks passed, SQLite integrity passed, and a forged-Origin request returned 403. Browser navigation confirmed historical timestamps, comments, labels, and status on a live imported issue. Native `chat` #1 remains Todo. The disposable Keycloak rehearsal was destroyed after verification; the production recovery snapshot and private evidence remain.
54
55The r1616 build predated hidden form CSRF tokens. The router's exact HTTPS Origin guard preceded all Shale handlers inside an explicit Caddy `route`; default directive ordering could otherwise bypass it. Missing, wrong, and suffix-forged origins returned 403 without a database change on the clone. The valid site origin allowed a status change, while Basic-auth Git requests still reached Shale. At that time, the MCP adapter accepted tokenless issue forms only with the verified `r1616` structural footer and no CSRF-token input anywhere on the page.
56
57The October 5 `r1763-g9f5b1c7.zig.0.16.0` upgrade rehearsal passed anonymous reads of the formerly crashing issues, Unicode issue creation and comments, issue closing with a comment Delete form present, access denial, restart persistence, token revocation, and logout. The Rust adapter parsed its actual owner issue markup and accepted its status/comment CSRF fields. All migrated SQLite rows remained identical. Eight-worker concurrent Markdown rendering still crashed; keep `NPROC=1`, which passed 280 concurrent fenced-code requests. The injected issue-form script is no longer needed. Private evidence lives at `/var/lib/studio/shale-upgrade-0680d28c`; its disposable containers were removed after testing.
58
59Shale allocates an issue number from the issue with the highest SQLite row ID. The importer now inserts by destination number, including remapped collisions. The already-imported database needs `--repair-issue-order` once while its job is stopped: the guarded repair saves a SQLite backup, swaps six imported surrogate IDs, rewrites foreign keys and ledger references, and verifies every table's contents using issue UUIDs. Native IDs, public numbers, timestamps, comments, labels, attachments and history remain intact. It refuses duplicate numbers or changes to native issue IDs. On the repaired native-auth clone, the actual Rust Backend created `home-infra` #41, `react-mutation` #20 and `chat` #8, then commented on and closed the disposable `home-infra` issue. Fresh import, repeated import, repeated repair, and refusal checks passed.
60
61Production upgraded to `r1763` on October 5 in release `9ef0e1fd9c7a72bc`, from main `38ee0683`. The pre-cutover Shale recovery snapshot is `globe/prod/shale@native-auth-20261005T091312Z`. Fresh normal and guest sign-in callbacks returned 200; the existing Clover session and identity remained intact. All 452 imported issue routes passed concurrent anonymous checks (192 successful reads and 260 expected private-page denials), all 24 attachment hash/access checks passed, and all 556 issues remained unique with valid foreign keys. Native `chat` #1 remains Todo. The live proof is recorded in `/var/lib/studio/shale-upgrade-0680d28c/upgrade-validation.json`.
62
63The October 4 transport check inspected the then-pinned image in disposable containers without mounting real app data. Its embedded Git endpoint and account settings use HTTP and personal access tokens; no SSH listener, authorized-key interface, or forced-command handler was found. The [official installation](https://astheno.software/shale/installation/) and [configuration reference](https://astheno.software/shale/reference/environment/) also expose HTTP serving and OAuth login without SSH configuration. A `git` account must either use a Shale-aware SSH bridge or await native SSH support. Direct filesystem Git commands would bypass Shale's authorization.
64
65Zenith's Shale app directory contains a small SQLite database and 419 MB of owned repositories. `bash tools/import-shale.sh shale-preview-4eea0e3b` copied `data`, `repositories_owned`, and `repositories_mirrors` opaquely from the read-only `storage1/apps@hourly-2026-09-26_05-00` snapshot. It verified checksums and SQLite integrity, then restarted the preview. Both sides had 11 top-level owned repository directories; the preview had one healthy Nomad allocation and returned HTTPS 200. Repository contents were not inspected.
66
67For the production copy, stop Zenith's Shale container and the Snow Globe Shale job, set `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT` for the new host, then run `bash tools/import-shale.sh shale`. The importer checks both jobs remain stopped, snapshots the destination dataset, verifies all three copied directories, and leaves Snow Globe stopped. Start the new job after the copy, check the SQLite state and a known login through the new Keycloak client, then switch the public route. The destination snapshot printed by the importer remains available for recovery.
68
69After a same-machine OS replacement, set `STUDIO_LEGACY_HANDOFF` to the [offline handoff](legacy-handoff.md) directory as well. The importer then reads the retained Shale directory from the new host's mounted old apps dataset, with no old Docker dependency.
70
71## Imported repository HTTP pushes
72
73The Forgejo importer originally omitted `http.receivepack=true`, which Shale sets when it creates an owned repository. Shale checks its push ACL before invoking `git-http-backend`, but does not set `REMOTE_USER`; Git's default therefore rejected authorized pushes to imported repositories. The importer now writes the setting, and Shale's prepare step repairs missing settings without replacing an explicit disable. Production `config` remains owner-only for pushes.
74
75Shale also forwards CGI `Status` as an ordinary header on HTTP 200. The Git-specific Caddy handler translates Git's error statuses into HTTP statuses and removes the CGI header. A disposable production database/repository copy verified anonymous and invalid credentials return 401, authenticated non-owners return 403, owner discovery advertises `main=37665e69e1aa954f0dec06b1cafa1612f44dc907`, and an actual `jj git push --bookmark main` advances the clone to `b8e734ce6aabd94a7e1aacfc989467662ca27dbe`. Disabled receive-pack returns actual HTTP 403; invalid method/content type return 400/415 without a `Status` header. No production token was added.
76
77## r1807 JSON upgrade, 2026-10-13 UTC
78
79The pinned image in [service.pkl](../service/shale/service.pkl) serves repository lists, issue lists, and issue details as JSON with `Accept: application/json` on their existing URLs. The MCP reads those responses, retaining issue numbers as `id` and raw Markdown in comment text. Native JSON omits comment IDs and issue-list creation times, so the MCP omits those fields. Account settings return 406 for JSON, and label JSON omits numeric IDs; those two reads retain their HTML checks. Writes still use the host broker for durable model authorship, repository permissions, delegated statuses, and grant revocation.
80
81The inherited `shale-preview-8ff39b2c` contained earlier disposable test writes. Rehearsing its previous pinned image followed by r1807 preserved every row of all 10 existing tables, including 559 issues; SQLite integrity passed and its allocation had zero restarts. Preview mirror cloning and polling are disabled. Public browsing, README/file navigation, open/closed issue filters, issue detail, labels, keyboard navigation, and 390-pixel layouts passed browser checks.
82
83An independent instance used only synthetic databases, credentials, certificates, and native Snowglobe OIDC. The candidate Nix dashboard passed linking, every issue/label operation, raw Markdown and durable model attribution, anonymous/other-user/selected-repository denials, exact-Origin enforcement, uncertain-write handling without replay, 80 concurrent JSON reads, 280 concurrent fenced-Markdown reads, backend/dashboard restart persistence, revocation, unlinking, and SQLite integrity. `NPROC=1` remains in place. The router test also verifies JSON headers and bytes pass through unchanged. Restricted verification evidence is `/var/lib/studio/shale-json-upgrade-20261013`.
tools/snowglobe-hardware.md created+105
...@@ -0,0 +1,105 @@
1# Snow Globe hardware and recovery
2
3## Physical host
4
5Snow Globe is the existing Ryzen 9 5950X computer, with 128 GB RAM, an RTX 3090,
6a 500 GB WD Blue SN5000 NVMe OS disk, and four 8 TB WD80EFPX disks in the
7`globe` RAIDZ1 pool. The onboard RTL8168 Ethernet connection is 1 Gb/s.
8[The host configuration](../nixos/snowglobe.nix),
9[network configuration](../nixos/snowglobe-network.nix), and
10[filesystem configuration](../nixos/hardware-configuration.nix) own installed
11settings. Use the release deployment workflow for host changes.
12
13Read-only inspection on 2026-10-16 confirmed the physical machine at
14`root@10.0.0.1:22`, a healthy `globe` pool with zero known data errors, and
15mounted production, staging, Clover, and Media datasets. The host configuration
16names it `snowglobe`. Renaming the computer preserves the existing hardware,
17pool, and application state.
18
19## Storage boundaries
20
21| Dataset | Mount | Role |
22| --- | --- | --- |
23| `globe` | `/srv` | Pool root; unencrypted |
24| `globe/clover` | `/srv/clover` | Personal files; independent encryption root |
25| `globe/clover/Media` | `/srv/clover/Media` | Media; independent encryption root |
26| `globe/prod` | `/srv/prod` | Encrypted managed service data |
27| `globe/staging` | `/srv/staging` | Encrypted preview data |
28| `globe/apps` | `/mnt/storage1/apps` | Retained application recovery source |
29| `globe/logs` | `/srv/logs` | Independent encrypted dataset |
30
31The retained apps tree and other old datasets are not active deployment
32sources. Removing obsolete repository import tools does not authorize destroying
33those datasets, snapshots, or private migration evidence.
34
35Clover and Media are case-insensitive POSIX-ACL filesystems. Their current
36properties are `acltype=posix`, `aclmode=discard`, `aclinherit=discard`.
37Production and staging also use POSIX ACLs. Preserve allocated UIDs and the
38shared group 3000. Test permission changes on a clone; do not recursively
39change personal ownership to repair one service.
40
41The [site mapping](../config/site.pkl) owns media folder names. Saved application
42paths are preserved by the service bind mounts: qBittorrent sees Seedbox at
43both `/data/media/Seedbox` and `/data/media/torrent`; Jellyfin keeps its
44`/media/jellyfin/...` paths. Preserve those mappings and YouTube archive files
45alongside their videos when reorganizing media.
46
47Samba serves these datasets directly using POSIX permissions. Its declaration
48preserves shared editing with `0660` files and `2770` directories and uses
49kernel oplocks for service-write visibility. Run
50`swift tools/samba-macos-test.swift <mounted-share>` against disposable files
51after changing permissions or SMB configuration. The probe exercises Cocoa
52safe saves, packages, metadata/resource forks, and cleanup.
53
54## Unlock and recovery
55
56The host configuration lists six encrypted roots and their systemd credential
57names. TPM-encrypted blobs live in `/etc/credstore.encrypted`; the unlock unit
58runs after pool import and before mounting. Plaintext keys must stay outside
59the Nix store and tracked configuration. Nomad refuses to start without the
60actual pool, Clover, Media, production, and staging mounts.
61
62Credentials are bound to the machine's TPM and PCR 7. Clearing/replacing the
63TPM or changing firmware can require manual unlock and resealing. Secure Boot
64is disabled, so automatic TPM unlock does not establish a trusted boot chain.
65Keep independent recovery keys when replacing hardware.
66
67The private off-server recovery archive on Clover's Mac includes the additional
68production/staging keys in `postgres-backups/new-os-dataset-keys.json` and the
69verified pre-install PostgreSQL logical/physical exports in
70`postgres-backups/20261004T230507Z-e75419.tar`. Original dataset keys
71and the former OS configuration are in the same private recovery collection.
72These paths document locations only; they do not establish current backup
73completeness or authorize opening private contents.
74
75For manual unlock on a confirmed recovery host, recover the required key into
76a root-only file in `/run`, then run these commands one at a time with the
77verified dataset substituted:
78
79```sh
80zfs load-key -L file:///run/<private-key-file> <dataset>
81rm /run/<private-key-file>
82zfs mount <dataset>
83findmnt --mountpoint <expected-mountpoint>
84```
85
86Loading a key does not mount the filesystem. Mount parents before children;
87never overlay a nonempty mountpoint to bypass a mount failure.
88
89## Control state and backups
90
91The NVMe contains both Nomad state and `/var/lib/snowglobe`: service identities,
92ACL token files, dashboard accounts, release history, and backup manifests and
93database dumps. Read-only `findmnt` inspection on 2026-10-16 confirmed both
94control-state locations remain on the ext4 OS filesystem, outside the ZFS
95service datasets. Replacing the OS disk without recovering this state loses
96more than service files. A Nomad snapshot contains jobs, ACLs, and secret
97variables; it does not contain the separate dashboard account database or UID
98registry. See [data restore](data-restore.md) for service recovery boundaries.
99
100No automatic ZFS snapshot or release-backup retention schedule is configured.
101Release backups do not substitute for independent off-server recovery copies.
102Before destructive storage or OS work, verify key recovery and application/
103database restores from at least two restricted copies stored separately off
104this computer. Preserve the existing encrypted roots, pool host ID, numeric
105owners, SSH trust, and retained recovery sources through a rebuild.
tools/snowglobe-secret-files-test.py created+72
...@@ -0,0 +1,72 @@
1#!/usr/bin/env python3
2import json
3import os
4from pathlib import Path
5import subprocess
6import tempfile
7import unittest
8
9import snowglobe
10
11
12class SecretFiles(unittest.TestCase):
13 @classmethod
14 def setUpClass(cls):
15 with tempfile.TemporaryDirectory(prefix="snowglobe-secret-template-") as temporary:
16 fixture = Path(temporary) / "fixture.pkl"
17 fixture.write_text('amends ' + json.dumps((snowglobe.REPO / "config/Service.pkl").as_uri()) + '\nname = "Fixture"\ncontainer { image = "localhost/fixture:pinned" }\n')
18 result = subprocess.run([os.environ.get("PKL", "pkl"), "eval", "-p", "uid=3132", "-p", "serviceId=fixture", str(fixture)], check=True, capture_output=True, text=True)
19 cls.fixture = json.loads(result.stdout)
20 cls.fixture.update(uid=3132, sourceId="fixture", inputs={})
21 cls.fixture.pop("requirements")
22
23 def setUp(self):
24 self.data = json.loads(json.dumps(self.fixture))
25 self.task = self.data["containers"]["app"]
26 self.task["secretFiles"] = {"/run/secrets/oidc.json": '{{ with nomadVar "nomad/jobs/fixture/inputs/oidc" }}{"clientSecret":{{ .clientSecret.Value | toJSON }}}{{ end }}'}
27
28 def test_private_allocation_template_and_read_only_file_mount(self):
29 rendered = snowglobe.render(self.data, {"fixture": self.data})
30 self.assertIn('"secrets/oidc.json:/run/secrets/oidc.json:ro"', rendered)
31 self.assertIn('destination = "secrets/oidc.json"', rendered)
32 self.assertIn('perms = "0400"', rendered)
33 self.assertIn('uid = 3132', rendered)
34 self.assertIn('gid = 3132', rendered)
35 self.assertIn('error_on_missing_key = true', rendered)
36 self.assertIn(self.task["secretFiles"]["/run/secrets/oidc.json"], rendered)
37 self.assertNotIn('env = true', rendered)
38 self.assertNotIn('change_mode =', rendered)
39
40 def test_services_without_files_gain_no_template_or_mount(self):
41 self.task["secretFiles"] = {}
42 rendered = snowglobe.render(self.data, {"fixture": self.data})
43 self.assertNotIn('template {', rendered)
44 self.assertNotIn('secrets/', rendered)
45
46 def test_unsafe_and_colliding_targets_are_rejected(self):
47 for target in ("relative.json", "/run/../secret.json", "/run/./secret.json", "/run//secret.json", "/run/secrets/", "/secrets/file", "/secrets", "/run/app.env", "/run/app-secret.env", "/run/nomad_token", "/run/line\nbreak"):
48 with self.subTest(target=target):
49 self.task["secretFiles"] = {target: "{}"}
50 with self.assertRaisesRegex(ValueError, "invalid secret file target"):
51 snowglobe.render(self.data, {"fixture": self.data})
52 self.task["secretFiles"] = {"/one/config.json": "{}", "/two/config.json": "{}"}
53 with self.assertRaisesRegex(ValueError, "invalid secret file target"):
54 snowglobe.render(self.data, {"fixture": self.data})
55 self.task["secretFiles"] = {"/run/secrets/oidc.json": "{}"}
56 self.task["volumes"] = {"/run/secrets/oidc.json": {}}
57 with self.assertRaisesRegex(ValueError, "invalid secret file target"):
58 snowglobe.render(self.data, {"fixture": self.data})
59
60 def test_image_user_and_heredoc_injection_are_rejected(self):
61 self.task["imageUser"] = True
62 with self.assertRaisesRegex(ValueError, "service-owned"):
63 snowglobe.render(self.data, {"fixture": self.data})
64 self.task["imageUser"] = False
65 for body in ("EOF", "{}\nEOF\nmalicious", "{}\nEOF\r\nmalicious"):
66 self.task["secretFiles"] = {"/run/secrets/oidc.json": body}
67 with self.assertRaisesRegex(ValueError, "invalid secret template delimiter"):
68 snowglobe.render(self.data, {"fixture": self.data})
69
70
71if __name__ == "__main__":
72 unittest.main()
tools/snowglobe-sso-test.py created+77
...@@ -0,0 +1,77 @@
1#!/usr/bin/env python3
2import json
3import os
4from pathlib import Path
5import subprocess
6import tempfile
7import unittest
8from unittest.mock import patch
9
10import snowglobe
11
12
13class SsoConnectivity(unittest.TestCase):
14 client = '''new sso.Client {
15 clientId = module.id
16 name = module.name
17 redirectUris { "https://fixture.example/api/callback" }
18}'''
19
20 def load(self, requirements=client, extra_hosts=()):
21 with tempfile.TemporaryDirectory(prefix="snowglobe-sso-") as temporary:
22 fixture = Path(temporary) / "fixture.pkl"
23 fixture.write_text(f'''amends {json.dumps((snowglobe.REPO / "config/Service.pkl").as_uri())}
24import {json.dumps((snowglobe.REPO / "config/OpenID.pkl").as_uri())} as sso
25name = "Fixture"
26requirements {{ {requirements} }}
27containers {{
28 ["app"] {{
29 image = "localhost/fixture:pinned"
30 extraHosts {{ {"; ".join(json.dumps(host) for host in extra_hosts)} }}
31 }}
32 ["worker"] {{ image = "localhost/fixture:pinned" }}
33}}
34''')
35 def pkl(*args, capture=False):
36 return subprocess.run([os.environ.get("PKL", "pkl"), *args[1:]], check=True, capture_output=capture, text=True)
37 with patch.object(snowglobe, "service_files", return_value={"fixture": fixture}), patch.object(snowglobe, "identity", return_value=3132), patch.object(snowglobe, "command", side_effect=pkl):
38 return snowglobe.load("fixture", {"domain": "fixture.example"})
39
40 def render(self, data):
41 return snowglobe.render(data, {"fixture": data})
42
43 def test_client_declaration_routes_every_task_without_changing_provider_inputs(self):
44 data = self.load()
45 self.assertEqual(data["inputs"]["oidc"], {
46 "alias": "oidc", "provider": "snowglobe", "kind": "client", "clientId": "fixture",
47 "name": "Fixture", "redirectUris": ["https://fixture.example/api/callback"],
48 "usernameAliases": {}, "allowGuests": False, "usernameRequired": False,
49 })
50 rendered = self.render(data)
51 self.assertEqual(rendered.count('extra_hosts = ["snowglobe.fixture.example:host-gateway"]'), 2)
52 self.assertNotIn("snowglobe.paperclover.net", rendered)
53
54 def test_explicit_hosts_take_precedence_and_duplicates_are_removed(self):
55 data = self.load(extra_hosts=[
56 "Snowglobe.Fixture.Example:192.0.2.10",
57 "other.example:2001:db8::10",
58 "other.example:2001:db8::10",
59 ])
60 rendered = self.render(data)
61 self.assertIn('extra_hosts = ["Snowglobe.Fixture.Example:192.0.2.10", "other.example:2001:db8::10"]', rendered)
62 self.assertEqual(rendered.count("snowglobe.fixture.example:host-gateway"), 1)
63
64 def test_multiple_clients_share_one_host_binding_per_task(self):
65 other = self.client.replace('clientId = module.id', 'alias = "other"; clientId = "other"')
66 data = self.load(requirements=self.client + "\n" + other)
67 self.assertEqual(self.render(data).count("snowglobe.fixture.example:host-gateway"), 2)
68
69 def test_services_without_sso_preserve_their_explicit_hosts(self):
70 data = self.load(requirements="", extra_hosts=["other.example:host-gateway"])
71 rendered = self.render(data)
72 self.assertIn('extra_hosts = ["other.example:host-gateway"]', rendered)
73 self.assertNotIn("snowglobe.fixture.example", rendered)
74
75
76if __name__ == "__main__":
77 unittest.main()
tools/snowglobe.py created+1303
...@@ -0,0 +1,1303 @@
1#!/usr/bin/env python3
2import argparse
3from contextlib import nullcontext
4import fcntl
5import hashlib
6import json
7from importlib import import_module
8import os
9from pathlib import Path
10import re
11import secrets
12import shutil
13import subprocess
14import sys
15import tempfile
16import time
17
18from data import cloned_postgres, dataset_for
19
20
21transition = import_module("namespace-transition")
22transition.inherit_environment()
23
24REPO = Path(__file__).resolve().parent.parent
25SERVICES = REPO / "service"
26STATE = Path("/var/lib/snowglobe")
27IDENTITIES = STATE / "identities.json"
28ASSETS = Path("/var/lib/caddy/snowglobe")
29NAME = re.compile(r"[a-z][a-z0-9-]*\Z")
30
31
32def command(*args, capture=False, **kwargs):
33 return subprocess.run(args, check=True, text=True, capture_output=capture, **kwargs)
34
35
36def service_files():
37 files = {}
38 for directory in SERVICES.iterdir():
39 if not directory.is_dir():
40 continue
41 for path in directory.glob("*.pkl"):
42 name = directory.name if path.name == "service.pkl" else path.stem
43 if name in files:
44 raise ValueError(f"duplicate service definition: {name}")
45 files[name] = path
46 return files
47
48
49def services():
50 return sorted(service_files())
51
52
53def service_dir(name):
54 path = service_files()[name]
55 return path.parent if path.name == "service.pkl" else path.parent / name
56
57
58def dependencies(data):
59 return set(data["dependsOn"]) | {item["provider"] for item in data["inputs"].values() if item["provider"] != "snowglobe"}
60
61
62def ordered(data):
63 pending = {item["id"]: item for item in data}
64 result = []
65 while pending:
66 ready = [
67 item
68 for item in pending.values()
69 if not dependencies(item) & pending.keys()
70 ]
71 if not ready:
72 raise ValueError("cycle in service dependencies")
73 for item in ready:
74 result.append(item)
75 del pending[item["id"]]
76 return result
77
78
79def identity(name):
80 STATE.mkdir(parents=True, exist_ok=True)
81 if not IDENTITIES.exists():
82 write_private(IDENTITIES, (REPO / "config/identities.json").read_text())
83 with (IDENTITIES.parent / ".identities.lock").open("w") as lock:
84 fcntl.flock(lock, fcntl.LOCK_EX)
85 with IDENTITIES.open() as file:
86 ids = json.load(file)
87 if len(set(ids.values())) != len(ids):
88 raise ValueError("duplicate service UIDs")
89 if name not in ids:
90 used = set(ids.values())
91 ids[name] = next(uid for uid in range(3100, 60000) if uid not in used)
92 pending = IDENTITIES.with_suffix(".pending")
93 pending.write_text(json.dumps(ids, indent=2) + "\n")
94 pending.replace(IDENTITIES)
95 return ids[name]
96
97
98def load(name, properties, instance_id=None):
99 files = service_files()
100 if not NAME.fullmatch(name) or name not in files:
101 raise ValueError(f"unknown service: {name}")
102 instance_id = instance_id or name
103 if not NAME.fullmatch(instance_id):
104 raise ValueError(f"invalid instance ID: {instance_id}")
105 uid = identity(name)
106 result = command(
107 "pkl",
108 "eval",
109 *(
110 part
111 for key, value in {**properties, "serviceId": instance_id, "uid": uid, "preview": str(instance_id != name).lower()}.items()
112 for part in ("-p", f"{key}={value}")
113 ),
114 str(files[name]),
115 capture=True,
116 )
117 data = json.loads(result.stdout)
118 if data["id"] != instance_id:
119 raise ValueError(f"service ID must match deployment: {instance_id}")
120 inputs = {}
121 for requirement in data.pop("requirements"):
122 alias = requirement["alias"]
123 if not NAME.fullmatch(alias) or alias == "own" or alias in inputs:
124 raise ValueError(f"invalid or duplicate requirement alias: {alias}")
125 inputs[alias] = requirement
126 issuer_hosts = [request.pop("issuerHostname") for request in inputs.values()
127 if request["provider"] == "snowglobe" and request["kind"] == "client"]
128 data["inputs"] = inputs
129 data["uid"] = uid
130 data["sourceId"] = name
131 for task_name, task in data["containers"].items():
132 task["extraHosts"] = list(dict.fromkeys(task["extraHosts"]))
133 for hostname in issuer_hosts:
134 if all(host.split(":", 1)[0].lower() != hostname.lower() for host in task["extraHosts"]):
135 task["extraHosts"].append(f"{hostname}:host-gateway")
136 if bool(task.get("image")) == bool(task.get("build")):
137 raise ValueError(f"{name}.{task_name} needs one image or build directory")
138 if task.get("build"):
139 if REPO.parent == Path("/opt/snowglobe/releases").resolve():
140 context = config_path(name, task["build"])
141 if not context.is_dir() or not (context / "Dockerfile").is_file():
142 raise ValueError(f"invalid build context: {name}.{task_name}")
143 digest = hashlib.sha256()
144 for path in sorted(context.rglob("*")):
145 if path.is_file():
146 digest.update(str(path.relative_to(context)).encode() + b"\0")
147 digest.update(path.read_bytes())
148 tag = digest.hexdigest()[:16]
149 elif not (service_dir(name) / task["build"] / "Dockerfile").is_file() and not (service_dir(name) / "build-source.json").is_file():
150 raise ValueError(f"missing build source: {name}.{task_name}")
151 else:
152 tag = REPO.name
153 task["image"] = f"localhost/snowglobe/{name}-{task_name}:{tag}"
154 return data
155
156
157def q(value):
158 return json.dumps(value, ensure_ascii=False)
159
160
161def write_private(path, content):
162 pending = None
163 try:
164 with tempfile.NamedTemporaryFile("w", dir=path.parent, delete=False) as file:
165 pending = Path(file.name)
166 file.write(content)
167 pending.replace(path)
168 finally:
169 if pending:
170 pending.unlink(missing_ok=True)
171
172
173def host_path(root, relative):
174 if relative == ".":
175 return root
176 part = Path(relative)
177 if part.is_absolute() or ".." in part.parts or not part.parts:
178 raise ValueError(f"invalid relative path: {relative}")
179 return str(Path(root) / part)
180
181
182def config_path(service, relative):
183 root = service_dir(service).resolve()
184 source = (root / relative).resolve()
185 if not source.is_relative_to(root) or not source.exists():
186 raise ValueError(f"invalid config path: {relative}")
187 return source
188
189
190def config_assets(data):
191 paths = set()
192 for task in data["containers"].values():
193 paths.update(volume["config"] for volume in task["volumes"].values() if volume.get("config"))
194 if task.get("http"):
195 paths.update(task["http"]["overrideFiles"].values())
196 sources = {rel: config_path(data.get("sourceId", data["id"]), rel) for rel in paths}
197 digest = hashlib.sha256()
198 for rel, source in sorted(sources.items()):
199 digest.update(rel.encode())
200 files = sorted(source.rglob("*")) if source.is_dir() else [source]
201 for file in files:
202 if file.is_symlink():
203 raise ValueError(f"config asset cannot be a symlink: {file}")
204 if file.is_file():
205 digest.update(str(Path(rel) / file.relative_to(source)).encode() if source.is_dir() else rel.encode())
206 digest.update(file.read_bytes())
207 return ASSETS / data["id"] / digest.hexdigest()[:16], sources
208
209
210def render(data, definitions):
211 if not data["containers"]:
212 return ""
213 name = data["id"]
214 asset_dir, _ = config_assets(data)
215 prepare_digest = None
216 if data.get("prepare"):
217 source = service_dir(data.get("sourceId", name))
218 digest = hashlib.sha256()
219 for path in sorted(source.rglob("*")):
220 if not path.is_file() or "__pycache__" in path.parts or path.suffix == ".pyc":
221 continue
222 if path.name == "service.pkl" or path.name.startswith("icon"):
223 continue
224 digest.update(str(path.relative_to(source)).encode() + b"\0")
225 digest.update(path.read_bytes())
226 prepare_digest = digest.hexdigest()[:16]
227 routed = [task["http"] for task in data["containers"].values()
228 if task.get("http") and task["http"].get("hostname")]
229 primary = routed[0] if routed else {}
230 requirements = {provider: "startup" for provider in data["dependsOn"]}
231 requirements.update({item["provider"]: item["kind"] for item in data["inputs"].values()})
232 secrets_meta = [
233 {"name": name, "generated": True, "bytes": spec["bytes"]}
234 for name, spec in data["secrets"].items()
235 ] + [{"name": name, "generated": False} for name in data["requiredSecrets"]]
236 lines = [
237 f"job {q(name)} {{",
238 ' datacenters = ["clover"]',
239 ' type = "service"',
240 ' meta {',
241 f" snowglobe_service = {q(data['sourceId'])}",
242 f" snowglobe_name = {q(data['name'])}",
243 f" snowglobe_tagline = {q(data['tagline'])}",
244 f" snowglobe_hostname = {q(primary.get('hostname') or '')}",
245 f" snowglobe_launcher = {q(str(data['launcher']).lower())}",
246 f" snowglobe_auth_role = {q(data.get('access') or primary.get('authRole') or '')}",
247 f" snowglobe_trace_service = {q(data.get('traceServiceName') or '')}",
248 f" snowglobe_metrics_pushed = {q(str(data['metricsPushed']).lower())}",
249 f" snowglobe_requires = {q(json.dumps(requirements))}",
250 f" snowglobe_secrets = {q(json.dumps(secrets_meta))}",
251 ' }',
252 ' group "app" {',
253 ]
254 if dependencies(data):
255 lines += [
256 " restart {",
257 " attempts = 3",
258 ' delay = "1m"',
259 ' interval = "4m"',
260 ' mode = "delay"',
261 " }",
262 ]
263 if data["rollout"] == "overlapped":
264 for task in data["containers"].values():
265 if task["hostNetwork"] or any(
266 endpoint and endpoint.get("hostPort") is not None
267 for endpoint in (task.get("http"), *task["tcp"])
268 ) or any(not volume["readOnly"] for volume in task["volumes"].values()):
269 raise ValueError(f"overlapped rollout requires dynamic ports and read-only mounts: {name}")
270 elif data["rollout"] != "simple":
271 raise ValueError(f"unknown rollout: {data['rollout']}")
272 if data["rollout"] == "overlapped" or data.get("healthyDeadline"):
273 lines.append(" update {")
274 if data["rollout"] == "overlapped":
275 lines += [" canary = 1", " auto_promote = true", " auto_revert = true"]
276 if data.get("healthyDeadline"):
277 lines += [f" healthy_deadline = {q(data['healthyDeadline'])}", ' progress_deadline = "0"']
278 lines.append(" }")
279 if data.get("healthyDeadline"):
280 lines += [" migrate {", f" healthy_deadline = {q(data['healthyDeadline'])}", " }"]
281 ports = {}
282 network = []
283 host_network = any(task["hostNetwork"] for task in data["containers"].values())
284 if host_network and not all(task["hostNetwork"] for task in data["containers"].values()):
285 raise ValueError("mixed host and bridge networking in one group")
286 for task_name, task in data["containers"].items():
287 for kind, endpoint in [("http", task.get("http")), *((port["name"], port) for port in task["tcp"])]:
288 if endpoint:
289 label = kind if len(data["containers"]) == 1 else f"{task_name}-{kind}"
290 if label in ports.values():
291 raise ValueError(f"duplicate port label: {label}")
292 ports[(task_name, kind)] = label
293 network.append(f" port {q(label)} {{")
294 if endpoint.get("hostPort") is not None:
295 network.append(f" static = {endpoint['hostPort']}")
296 if not task["hostNetwork"]:
297 network.append(f" to = {endpoint['containerPort']}")
298 if endpoint.get("loopback") or (not task["hostNetwork"] and kind == "http" and endpoint.get("hostPort") is None):
299 network.append(' host_network = "loopback"')
300 network.append(" }")
301 if network:
302 lines.append(" network {")
303 if host_network:
304 lines.append(' mode = "host"')
305 lines += network + [" }"]
306 for provider_id in sorted(dependencies(data)):
307 provider = definitions[provider_id]
308 for provider_task, container in provider["containers"].items():
309 endpoint = container.get("http")
310 if not endpoint or not endpoint.get("hostname") or endpoint.get("authRole"):
311 continue
312 host = endpoint["hostname"]
313 task_name = f"wait-{provider_id}-{provider_task}"
314 lines += [
315 f" task {q(task_name)} {{",
316 ' driver = "podman"',
317 " lifecycle {",
318 ' hook = "prestart"',
319 " sidecar = false",
320 " }",
321 " config {",
322 ' image = "docker.io/curlimages/curl@sha256:43ebaa53d3806db6b1ce4353b6b26ae638ec1c167ee351524b05690f988bb20d"',
323 f" extra_hosts = {q([host + ':host-gateway'])}",
324 f" args = {q(['--insecure', '--fail', '--silent', '--show-error', '--retry', '999999', '--retry-all-errors', '--retry-delay', '5', '--connect-timeout', '3', '--max-time', '5', 'https://' + host + endpoint['checkPath']])}",
325 " }",
326 " resources {",
327 " cpu = 50",
328 " memory = 64",
329 " }",
330 " }",
331 ]
332 for task_name, task in data["containers"].items():
333 if task.get("http") or task.get("tcp"):
334 kind = "http" if task.get("http") else "tcp"
335 endpoint = task["http"] if kind == "http" else task["tcp"][0]
336 label = ports[(task_name, "http" if kind == "http" else endpoint["name"])]
337 lines += [" service {", f" name = {q(name if task_name == 'app' else name + '-' + task_name)}", ' provider = "nomad"', f" port = {q(label)}"]
338 if len(data["containers"]) == 1:
339 lines.append(f" task = {q(task_name)}")
340 tags = []
341 if kind == "http" and endpoint.get("metricsPath"):
342 tags.append("snowglobe-metrics-path=" + endpoint["metricsPath"])
343 if kind == "http" and endpoint.get("hostname"):
344 tags += ["caddy-host=" + host for host in [endpoint["hostname"], *endpoint["plainHostnames"]]]
345 if endpoint.get("authRole"):
346 tags.append("caddy-auth-role=" + endpoint["authRole"])
347 if endpoint.get("userHeader"):
348 tags.append("caddy-user-header=" + endpoint["userHeader"])
349 if endpoint["forwardRealIp"]:
350 tags.append("caddy-real-ip=true")
351 if endpoint.get("secureCookies"):
352 tags.append("caddy-secure-cookies=true")
353 if endpoint["tlsInternal"]:
354 tags.append("caddy-internal=true")
355 if tags:
356 lines.append(f" tags = {q(tags)}")
357 lines += [" check {", f" type = {q(kind)}"]
358 if kind == "http":
359 lines.append(f" path = {q(endpoint['checkPath'])}")
360 if endpoint["checkHeaders"]:
361 lines.append(" header {")
362 for key, value in endpoint["checkHeaders"].items():
363 if not re.fullmatch(r"[A-Za-z][A-Za-z0-9-]*", key):
364 raise ValueError(f"invalid health check header: {key}")
365 lines.append(f" {key} = [{q(value)}]")
366 lines.append(" }")
367 lines += [
368 ' interval = "10s"',
369 ' timeout = "15s"',
370 ' check_restart {',
371 ' limit = 12',
372 f" grace = {q(data.get('healthRestartGrace') or data.get('healthyDeadline') or '5m')}",
373 ' }',
374 ' }',
375 ' }',
376 ]
377 for task_name, task in data["containers"].items():
378 lines += [f" task {q(task_name)} {{", ' driver = "podman"']
379 if task["lifecycle"] != "main":
380 lines += [' lifecycle {', ' hook = "prestart"',
381 f" sidecar = {str(task['lifecycle'] == 'prestartSidecar').lower()}", ' }']
382 if not task["imageUser"]:
383 uses_clover = any(
384 volume.get("clover") or (
385 volume.get("src")
386 and Path(volume["src"]).resolve().is_relative_to(Path(data["cloverRoot"]).resolve())
387 )
388 for volume in task["volumes"].values()
389 )
390 gid = data["cloverGid"] if uses_clover else 0 if task["rootGroup"] else data["uid"]
391 lines.append(f" user = {q(str(data['uid']) + ':' + str(gid))}")
392 lines += [" config {", f" image = {q(task['image'])}"]
393 if task.get("entrypoint"):
394 lines.append(f" entrypoint = {q(task['entrypoint'])}")
395 if task["args"]:
396 lines.append(f" args = {q(task['args'])}")
397 if task["hostNetwork"]:
398 lines.append(' network_mode = "host"')
399 task_ports = [label for (owner, _), label in ports.items() if owner == task_name]
400 if task_ports and not task["hostNetwork"]:
401 lines.append(f" ports = {q(task_ports)}")
402 for field, values in (("cap_add", task["capAdd"]), ("devices", task["devices"]), ("extra_hosts", task["extraHosts"])):
403 if values:
404 lines.append(f" {field} = {q(values)}")
405 volumes = []
406 secret_files = task.get("secretFiles", {})
407 filenames = set()
408 for target, template in secret_files.items():
409 filename = Path(target).name
410 if (not re.fullmatch(r"/[A-Za-z0-9_./-]+", target) or target.endswith("/")
411 or any(part in {".", "..", ""} for part in target[1:].split("/"))
412 or filename in filenames
413 or filename in {task_name + ".env", task_name + "-secret.env", "nomad_token"}
414 or target in task["volumes"] or target == "/secrets" or target.startswith("/secrets/")):
415 raise ValueError(f"invalid secret file target: {target}")
416 if task["imageUser"]:
417 raise ValueError("secret files require a service-owned container user")
418 if re.search(r"(?m)^EOF\r?$", template):
419 raise ValueError("invalid secret template delimiter")
420 filenames.add(filename)
421 volumes.append(f"secrets/{filename}:{target}:ro")
422 for target, volume in task["volumes"].items():
423 if not target.startswith("/") or ":" in target:
424 raise ValueError(f"invalid volume target: {target}")
425 if volume.get("config") is not None:
426 if volume.get("src") is not None or not volume["readOnly"]:
427 raise ValueError("config mounts must be read only and have no host source")
428 config_path(data.get("sourceId", name), volume["config"])
429 source = host_path(str(asset_dir), volume["config"])
430 elif volume.get("src") is not None:
431 source = volume["src"]
432 if not Path(source).is_absolute():
433 raise ValueError(f"volume source must be absolute: {source}")
434 else:
435 source = host_path(data["hostRoot"], target.lstrip("/"))
436 if ":" in source:
437 raise ValueError(f"invalid volume source: {source}")
438 volumes.append(f"{source}:{target}" + (":ro" if volume["readOnly"] else ""))
439 if volumes:
440 lines.append(f" volumes = {q(volumes)}")
441 if task["tmpfs"]:
442 lines.append(f" tmpfs = {q(task['tmpfs'])}")
443 lines.append(" }")
444 secret_env = []
445 plain_env = {}
446 for key, value in task["env"].items():
447 if not re.fullmatch(r"[A-Za-z_][A-Za-z0-9_]*", key):
448 raise ValueError(f"invalid env key: {key}")
449 parts = re.split(r"(\$\{secret\.[A-Za-z_][A-Za-z0-9_]*\.[A-Za-z_][A-Za-z0-9_]*\})", value)
450 if len(parts) == 1:
451 if "${secret." in value:
452 raise ValueError(f"invalid secret reference: {value}")
453 plain_env[key] = value
454 continue
455 args = []
456 paths = {}
457 for part in parts:
458 match = re.fullmatch(r"\$\{secret\.([A-Za-z_][A-Za-z0-9_]*)\.([A-Za-z_][A-Za-z0-9_]*)\}", part)
459 if match:
460 alias, field = match.groups()
461 if alias != "own" and alias not in data["inputs"]:
462 raise ValueError(f"unknown secret alias: {alias}")
463 path = f"nomad/jobs/{name}" + (f"/inputs/{alias}" if alias != "own" else "")
464 variable = paths.setdefault(path, f"$s{len(paths)}")
465 args.append(f"(index {variable} {q(field)}).Value")
466 elif part:
467 args.append(q(part))
468 start = "".join(f'{{{{ with {variable} := nomadVar {q(path)} }}}}' for path, variable in paths.items())
469 end = "{{ end }}" * len(paths)
470 secret_env.append(f'{start}{key}={{{{ print {" ".join(args)} | toJSON }}}}{end}')
471 if "SNOWGLOBE_PREPARE_DIGEST" in task["env"]:
472 raise ValueError("SNOWGLOBE_PREPARE_DIGEST is reserved")
473 lines.append(" env {")
474 for key, value in plain_env.items():
475 lines.append(f" {key} = {q(value)}")
476 if prepare_digest:
477 lines.append(f" SNOWGLOBE_PREPARE_DIGEST = {q(prepare_digest)}")
478 lines.append(" }")
479 if secret_env:
480 lines += [" template {", " data = <<EOF", *secret_env, "EOF", f' destination = {q("secrets/" + task_name + "-secret.env")}', " env = true", " error_on_missing_key = true", " }"]
481 if task.get("envTemplate"):
482 if "\nEOF\n" in task["envTemplate"]:
483 raise ValueError("invalid env template delimiter")
484 lines += [" template {", " data = <<EOF", task["envTemplate"].rstrip(), "EOF", f' destination = {q("secrets/" + task_name + ".env")}', " env = true", " }"]
485 for target, template in secret_files.items():
486 lines += [" template {", " data = <<EOF", template.rstrip(), "EOF",
487 f' destination = {q("secrets/" + Path(target).name)}', ' perms = "0400"',
488 f' uid = {data["uid"]}', f' gid = {data["uid"]}',
489 " error_on_missing_key = true", " }"]
490 lines += [" resources {", f" cpu = {task['cpu']}", f" memory = {task['memory']}", " }", " }"]
491 lines += [" }", "}"]
492 return "\n".join(lines) + "\n"
493
494
495def token():
496 if "NOMAD_TOKEN" not in os.environ:
497 os.environ["NOMAD_TOKEN"] = (STATE / "nomad.token").read_text().strip()
498
499
500def get_variable(path):
501 result = subprocess.run(["nomad", "var", "get", "-out=json", path], capture_output=True, text=True)
502 if result.returncode == 0:
503 return json.loads(result.stdout)
504 if "Variable not found" in result.stderr + result.stdout:
505 return None
506 raise RuntimeError(f"Nomad variable read failed for {path}: {result.stderr.strip()}")
507
508
509def provision(data):
510 if not data["containers"]:
511 return
512 if os.geteuid() != 0:
513 raise PermissionError("provisioning requires root")
514 root = Path(data["hostRoot"])
515 if data["hasManagedVolumes"]:
516 root.mkdir(parents=True, exist_ok=True)
517 if command(
518 "findmnt", "-n", "-o", "FSTYPE", "--mountpoint", str(root), capture=True
519 ).stdout.strip() != "zfs":
520 raise ValueError(f"expected ZFS dataset at {root}")
521 for task in data["containers"].values():
522 gid = 0 if task["rootGroup"] else data["uid"]
523 for target, volume in task["volumes"].items():
524 if volume.get("config") is not None or volume.get("src") is not None:
525 continue
526 path = Path(host_path(str(root), target.lstrip("/")))
527 path.mkdir(parents=True, exist_ok=True)
528 os.chown(path, data["uid"], gid)
529 path.chmod(0o750)
530 if data["sourceId"] == "ytdl" and target == "/data":
531 command("systemd-tmpfiles", "--create", "--prefix=" + str(path))
532 bundle = STATE / "ca-bundle.crt"
533 if any(
534 volume.get("src") == str(bundle)
535 for task in data["containers"].values()
536 for volume in task["volumes"].values()
537 ):
538 contents = Path("/etc/ssl/certs/ca-certificates.crt").read_bytes()
539 local_ca = Path("/var/lib/caddy/.local/share/caddy/pki/authorities/local/root.crt")
540 if local_ca.exists():
541 contents += b"\n" + local_ca.read_bytes()
542 if not bundle.exists() or bundle.read_bytes() != contents:
543 pending = bundle.with_suffix(".pending")
544 pending.write_bytes(contents)
545 pending.chmod(0o644)
546 pending.replace(bundle)
547 route_dir = STATE / "routes"
548 route_dir.mkdir(parents=True, exist_ok=True)
549 asset_dir, assets = config_assets(data)
550 static = {}
551 directories = {}
552 identity = {}
553 head_html = {}
554 metrics_paths = {}
555 for task in data["containers"].values():
556 if task.get("http"):
557 http = task["http"]
558 if http["identityHeaders"]:
559 identity[http["hostname"]] = http["identityHeaders"]
560 if http["headHtml"]:
561 head_html[http["hostname"]] = http["headHtml"]
562 if http.get("metricsPath") and http["hostname"]:
563 metrics_paths[http["hostname"]] = http["metricsPath"]
564 for request, rel in http["overrideFiles"].items():
565 origin = assets[rel]
566 target = directories if origin.is_dir() else static
567 target[request] = host_path(str(asset_dir), rel)
568 if assets:
569 asset_dir.parent.mkdir(parents=True, exist_ok=True)
570 asset_dir.parent.chmod(0o755)
571 if assets and not asset_dir.exists():
572 temporary = tempfile.mkdtemp(dir=asset_dir.parent)
573 try:
574 for rel, origin in assets.items():
575 destination = Path(temporary) / rel
576 destination.parent.mkdir(parents=True, exist_ok=True)
577 if origin.is_dir():
578 shutil.copytree(origin, destination)
579 for child in destination.rglob("*"):
580 child.chmod(0o755 if child.is_dir() else 0o644)
581 else:
582 shutil.copy2(origin, destination)
583 destination.chmod(0o644)
584 Path(temporary).chmod(0o755)
585 os.replace(temporary, asset_dir)
586 finally:
587 shutil.rmtree(temporary, ignore_errors=True)
588 secret_dir = STATE / "secrets"
589 secret_dir.mkdir(parents=True, exist_ok=True)
590 secret_file = secret_dir / f"{data['id']}.nv.hcl"
591 generated = data["secrets"]
592 required = data["requiredSecrets"]
593 secret_path = "nomad/jobs/" + data["id"]
594 existing = get_variable(secret_path) if generated or required else None
595 if generated and not existing and secret_file.exists():
596 command("nomad", "var", "put", "-in=hcl", "-out=none", secret_path, "@" + str(secret_file))
597 existing = get_variable(secret_path)
598 values = dict(existing["Items"]) if existing else {}
599 if generated:
600 for item, spec in generated.items():
601 if item not in values:
602 values[item] = secrets.token_hex(spec["bytes"])
603 if not existing or values != existing["Items"]:
604 put_variable(secret_path, values, existing["ModifyIndex"] if existing else 0)
605 backup = "items {\n" + "".join(f" {item} = {q(value)}\n" for item, value in values.items()) + "}\n"
606 if not secret_file.exists() or secret_file.read_text() != backup:
607 write_private(secret_file, backup)
608 if required:
609 missing = [name for name in required if not values.get(name)]
610 if missing:
611 raise ValueError(f"missing required secrets for {data['id']}: {', '.join(missing)}")
612 proof = {}
613 for task in data["containers"].values():
614 http = task.get("http")
615 if http and http.get("identityProofSecret"):
616 name = http["identityProofSecret"]
617 if not http["identityHeaders"] or name not in values:
618 raise ValueError(f"missing identity proof secret for {data['id']}")
619 proof[http["hostname"]] = "X-Snowglobe-Idp-" + values[name]
620 write_private(route_dir / f"{data['id']}.json", json.dumps({
621 "files": static, "dirs": directories, "identity": identity,
622 "identityProof": proof, "headHtml": head_html, "metricsPaths": metrics_paths,
623 }))
624
625
626def submit(data, mode, definitions):
627 if not data["containers"]:
628 return
629 with tempfile.NamedTemporaryFile("w", suffix=".nomad.hcl", delete=False) as file:
630 file.write(render(data, definitions))
631 path = file.name
632 try:
633 command("nomad", "job", mode, path)
634 finally:
635 Path(path).unlink()
636
637
638def build_images(data):
639 for task in data["containers"].values():
640 if task.get("build"):
641 image = task["image"]
642 if subprocess.run(["podman", "image", "exists", image]).returncode:
643 command("podman", "build", "-t", image, str(config_path(data["sourceId"], task["build"])))
644
645
646def clone_dataset(source, snapshot, dataset, mount):
647 acltype = command("zfs", "get", "-H", "-o", "value", "acltype", source, capture=True).stdout.strip()
648 command("zfs", "clone", "-o", "mountpoint=" + mount, "-o", "acltype=" + acltype, snapshot, dataset)
649
650
651def check_http(host, path, tls_internal=False, attempts=120):
652 for attempt in range(attempts):
653 try:
654 if subprocess.run(
655 ["curl", "--noproxy", "*", "-sf", *(["--cacert", "/var/lib/caddy/.local/share/caddy/pki/authorities/local/root.crt"] if tls_internal else []), "--resolve", f"{host}:443:127.0.0.1", f"https://{host}{path}"],
656 capture_output=True, timeout=3,
657 ).returncode == 0:
658 print(f"Healthy {host}")
659 return
660 except subprocess.TimeoutExpired:
661 pass
662 time.sleep(2)
663 raise RuntimeError(f"HTTPS route is unhealthy: {host}")
664
665
666def put_variable(path, items, index=None):
667 with tempfile.NamedTemporaryFile("w", suffix=".nv.hcl", delete=False) as file:
668 file.write("items {\n" + "".join(f" {key} = {q(value)}\n" for key, value in items.items()) + "}\n")
669 filename = file.name
670 try:
671 command("nomad", "var", "put", "-in=hcl", "-out=none", *([f"-check-index={index}"] if index is not None else []), path, "@" + filename)
672 finally:
673 Path(filename).unlink()
674
675
676def configure(data):
677 if not data.get("setup"):
678 return
679 if data["setup"].startswith("tools/"):
680 script = (REPO / data["setup"]).resolve()
681 if not script.is_relative_to(REPO / "tools") or not script.is_file():
682 raise ValueError(f"invalid shared setup script: {data['setup']}")
683 else:
684 script = config_path(data.get("sourceId", data["id"]), data["setup"])
685 routes = [task["http"] for task in data["containers"].values()
686 if task.get("http") and task["http"].get("hostname")]
687 if len(routes) != 1:
688 raise ValueError("service setup requires one HTTP hostname")
689 route = routes[0]
690 check_http(route["hostname"], route["checkPath"], route["tlsInternal"], attempts=600)
691 variable = get_variable("nomad/jobs/" + data["id"])
692 own = variable["Items"] if variable else {}
693 command("python3", str(script), input=json.dumps({
694 "serviceId": data["id"], "host": route["hostname"], "hostRoot": data["hostRoot"],
695 "preview": data["id"] != data.get("sourceId", data["id"]),
696 "ownerEmail": data["ownerEmail"], **own,
697 }))
698 print(f"Configured {data['id']}")
699
700
701def prepare(data):
702 if data.get("prepare"):
703 script = config_path(data.get("sourceId", data["id"]), data["prepare"])
704 command("python3", str(script), input=json.dumps({
705 "hostRoot": data["hostRoot"], "uid": data["uid"],
706 }))
707
708
709def provision_inputs(data, definitions, stage_id=None, postgres_source=None):
710 for alias, request in data["inputs"].items():
711 if not NAME.fullmatch(alias):
712 raise ValueError(f"invalid input alias: {alias}")
713 native = request["provider"] == "snowglobe"
714 provider = {"id": "snowglobe", "provide": True, "containers": {}} if native else definitions[request["provider"]]
715 if not provider.get("provide"):
716 raise ValueError(f"{provider['id']} does not provide inputs")
717 path = f"nomad/jobs/{data['id']}/inputs/{alias}"
718 variable = get_variable(path)
719 own = (get_variable("nomad/jobs/" + provider["id"]) or {}).get("Items", {})
720 http = next((task["http"] for task in provider["containers"].values()
721 if task.get("http") and task["http"].get("hostname")), None)
722 if http:
723 check_http(http["hostname"], http["checkPath"], http["tlsInternal"])
724 payload = {
725 "request": request,
726 "existing": variable["Items"] if variable else None,
727 "providerSecrets": own,
728 "host": http["hostname"] if http else None,
729 }
730 if stage_id:
731 payload["stageId"] = stage_id
732 if postgres_source and provider["id"] == "postgres":
733 payload["sourceContainer"] = postgres_source
734 script = REPO / "tools/oidc-provider.py" if native else config_path(provider["id"], provider["provide"])
735 result = command("python3", str(script), input=json.dumps(payload), capture=True)
736 values = json.loads(result.stdout)
737 if not isinstance(values, dict) or not values or any(
738 not re.fullmatch(r"[A-Za-z_][A-Za-z0-9_]*", key) or not isinstance(value, str) or not value
739 for key, value in values.items()
740 ):
741 raise ValueError(f"invalid outputs from {provider['id']}")
742 if not variable or variable["Items"] != values:
743 put_variable(path, values, variable["ModifyIndex"] if variable else None)
744 print(f"Allocated {data['id']}.{alias} from {provider['id']}")
745
746
747def bootstrap(all_data):
748 if os.geteuid() != 0:
749 raise PermissionError("bootstrap requires root")
750 STATE.mkdir(parents=True, exist_ok=True)
751 if not (STATE / "nomad.token").exists():
752 result = command("nomad", "acl", "bootstrap", "-json", capture=True)
753 write_private(STATE / "nomad.token", json.loads(result.stdout)["SecretID"] + "\n")
754 token()
755 command(
756 "nomad",
757 "acl",
758 "policy",
759 "apply",
760 "snowglobe-router",
761 str(REPO / "config/policies/router.hcl"),
762 )
763 command("nomad", "acl", "policy", "apply", "snowglobe-dashboard",
764 str(REPO / "config/policies/dashboard.hcl"))
765 router_token = STATE / "router.token"
766 if not router_token.exists():
767 result = command(
768 "nomad",
769 "acl",
770 "token",
771 "create",
772 "-policy=snowglobe-router",
773 "-name=snowglobe-router",
774 "-json",
775 capture=True,
776 )
777 write_private(router_token, json.loads(result.stdout)["SecretID"] + "\n")
778 dashboard_token = STATE / "dashboard.token"
779 if not dashboard_token.exists():
780 result = command("nomad", "acl", "token", "create", "-policy=snowglobe-dashboard",
781 "-name=snowglobe-dashboard", "-json", capture=True)
782 write_private(dashboard_token, json.loads(result.stdout)["SecretID"] + "\n")
783 for data in all_data:
784 paths = {
785 f"nomad/jobs/{data['id']}/inputs/{alias}" for alias in data["inputs"]
786 }
787 if paths and data["containers"]:
788 policy = (
789 'namespace "default" {\n variables {\n'
790 + "".join(
791 f' path {q(path)} {{ capabilities = ["read"] }}\n'
792 for path in sorted(paths)
793 )
794 + " }\n}\n"
795 )
796 with tempfile.NamedTemporaryFile("w", delete=False) as file:
797 file.write(policy)
798 path = file.name
799 try:
800 for task_name in data["containers"]:
801 command(
802 "nomad", "acl", "policy", "apply", "-namespace", "default",
803 "-job", data["id"], "-group", "app", "-task", task_name,
804 data["id"] + "-" + task_name + "-imports", path,
805 )
806 finally:
807 Path(path).unlink()
808 current = Path("/opt/snowglobe/current")
809 if current.is_symlink():
810 command("systemctl", "start", transition.layout(current)["prefix"] + "-router.service")
811
812
813def destroy_stage(stage, metadata, definitions):
814 subprocess.run(["nomad", "job", "stop", "-purge", "-yes", stage], check=False)
815 for alias, request in metadata["inputs"].items():
816 native = request["provider"] == "snowglobe"
817 provider = {"id": "snowglobe", "provide": True, "containers": {}} if native else definitions[request["provider"]]
818 own = (get_variable("nomad/jobs/" + provider["id"]) or {}).get("Items", {})
819 variable = get_variable(f"nomad/jobs/{stage}/inputs/{alias}")
820 existing = variable["Items"] if variable else None
821 hosts = [task["http"]["hostname"] for task in provider["containers"].values()
822 if task.get("http") and task["http"].get("hostname")]
823 script = REPO / "tools/oidc-provider.py" if native else config_path(provider["id"], provider["provide"])
824 command("python3", str(script), input=json.dumps({
825 "operation": "delete", "request": request, "stageId": stage,
826 "providerSecrets": own, "host": hosts[0] if hosts else None,
827 "existing": existing,
828 }))
829 datasets = list(metadata.get("external", {}).values())
830 if metadata.get("clone"):
831 datasets.append({"clone": metadata["clone"], "snapshot": metadata.get("snapshot")})
832 for dataset in datasets:
833 for attempt in range(30):
834 if subprocess.run(["zfs", "destroy", dataset["clone"]], capture_output=True).returncode == 0:
835 break
836 time.sleep(1)
837 else:
838 raise RuntimeError("preview dataset is still in use")
839 if dataset.get("snapshot"):
840 command("zfs", "destroy", dataset["snapshot"])
841 if not metadata.get("clone"):
842 shutil.rmtree(metadata["mount"], ignore_errors=True)
843 for alias in metadata["inputs"]:
844 subprocess.run(["nomad", "var", "purge", f"nomad/jobs/{stage}/inputs/{alias}"], check=False)
845 subprocess.run(["nomad", "var", "purge", "nomad/jobs/" + stage], check=False)
846 for task in metadata["tasks"]:
847 subprocess.run(["nomad", "acl", "policy", "delete", stage + "-" + task + "-imports"], check=False)
848 for path in (
849 STATE / "stages" / f"{stage}.json",
850 STATE / "routes" / f"{stage}.json",
851 STATE / "secrets" / f"{stage}.nv.hcl",
852 ):
853 path.unlink(missing_ok=True)
854 shutil.rmtree(ASSETS / stage, ignore_errors=True)
855
856
857def check_pool(data):
858 if os.geteuid() != 0:
859 raise PermissionError("pool setup requires root")
860 clover = subprocess.run(
861 ["findmnt", "-n", "-o", "SOURCE,FSTYPE", "--mountpoint", data[0]["cloverRoot"]],
862 capture_output=True, text=True,
863 )
864 clover_info = clover.stdout.split()
865 if clover.returncode or len(clover_info) != 2 or clover_info[1] != "zfs":
866 raise ValueError(f"clover must be a mounted ZFS dataset: {data[0]['cloverRoot']}")
867 media = data[0]["mediaRoot"]
868 mounted = subprocess.run(
869 ["findmnt", "-n", "-o", "SOURCE,FSTYPE", "--mountpoint", media],
870 capture_output=True, text=True,
871 )
872 media_info = mounted.stdout.split()
873 expected = {"fuse"} if os.environ.get("SNOWGLOBE_MEDIA_READ_ONLY") == "true" else {"zfs"}
874 if mounted.returncode or len(media_info) != 2 or media_info[1] not in expected or media_info[0] == clover_info[0]:
875 raise ValueError(f"media must be a separate mounted dataset: {media}")
876 for path, info in ((data[0]["cloverRoot"], clover_info), (media, media_info)):
877 if info[1] == "zfs":
878 acltype = command("zfs", "get", "-H", "-o", "value", "acltype", info[0], capture=True).stdout.strip()
879 if acltype == "nfsv4":
880 raise ValueError(f"{path} uses NFSv4 ACLs, which NixOS cannot enforce. Rehearse a POSIX permission conversion on a ZFS clone before migration.")
881 pool = data[0]["pool"]
882 if subprocess.run(["zpool", "list", pool], capture_output=True).returncode:
883 raise ValueError(f"ZFS pool is unavailable: {pool}")
884 prod = pool + "/prod"
885 acl_source = prod if subprocess.run(["zfs", "list", prod], capture_output=True).returncode == 0 else pool
886 if command("zfs", "get", "-H", "-o", "value", "acltype", acl_source, capture=True).stdout.strip() == "nfsv4":
887 raise ValueError(f"{acl_source} uses NFSv4 ACLs; service datasets need POSIX ACLs on NixOS.")
888 encrypted = any(
889 command("zfs", "get", "-H", "-o", "value", "encryption", info[0], capture=True).stdout.strip() != "off"
890 for info in (clover_info, media_info) if info[1] == "zfs"
891 )
892 if encrypted:
893 root = str(Path(data[0]["hostRoot"]).parent)
894 mounted = subprocess.run(["findmnt", "-n", "-o", "SOURCE", "--mountpoint", root], capture_output=True, text=True)
895 encryption = subprocess.run(["zfs", "get", "-H", "-o", "value", "encryption", prod], capture_output=True, text=True)
896 if encryption.returncode or encryption.stdout.strip() == "off" or mounted.stdout.strip() != prod:
897 raise ValueError(f"Create and mount encrypted {prod} at {root} before deployment; the existing storage is encrypted.")
898
899
900def check_staging_pool(data):
901 check_pool([data])
902 prod = data["pool"] + "/prod"
903 staging = data["pool"] + "/staging"
904 acl_source = staging if subprocess.run(["zfs", "list", staging], capture_output=True).returncode == 0 else data["pool"]
905 if command("zfs", "get", "-H", "-o", "value", "acltype", acl_source, capture=True).stdout.strip() == "nfsv4":
906 raise ValueError(f"{acl_source} uses NFSv4 ACLs; staged datasets need POSIX ACLs on NixOS.")
907 encryption = subprocess.run(["zfs", "get", "-H", "-o", "value", "encryption", prod], capture_output=True, text=True)
908 if encryption.returncode or encryption.stdout.strip() == "off":
909 return
910 mounted = subprocess.run(["findmnt", "-n", "-o", "SOURCE", "--mountpoint", data["stagingRoot"]], capture_output=True, text=True)
911 staging_encryption = subprocess.run(["zfs", "get", "-H", "-o", "value", "encryption", staging], capture_output=True, text=True)
912 if staging_encryption.returncode or staging_encryption.stdout.strip() == "off" or mounted.stdout.strip() != staging:
913 raise ValueError(f"Create and mount encrypted {staging} at {data['stagingRoot']} before staging.")
914
915
916def ensure_pool(data):
917 check_pool(data)
918 STATE.mkdir(parents=True, exist_ok=True)
919 pool = data[0]["pool"]
920 for item in data:
921 if item["hasManagedVolumes"]:
922 dataset = pool + "/prod/" + item["id"]
923 if subprocess.run(["zfs", "list", dataset], capture_output=True).returncode:
924 root = Path(item["hostRoot"])
925 if root.exists() and any(root.iterdir()):
926 raise ValueError(f"refusing to mount over {root}")
927 if subprocess.run(["zfs", "list", pool + "/prod"], capture_output=True).returncode:
928 parent = str(root.parent)
929 if Path(parent).exists() and any(Path(parent).iterdir()):
930 raise ValueError(f"refusing to mount over {parent}")
931 command("zfs", "create", "-o", "mountpoint=" + parent, pool + "/prod")
932 command("zfs", "create", "-o", "mountpoint=" + str(root), dataset)
933
934
935def main():
936 parser = argparse.ArgumentParser()
937 parser.add_argument(
938 "mode",
939 choices=[
940 "render",
941 "secrets",
942 "validate",
943 "check",
944 "bootstrap",
945 "deploy",
946 "preflight",
947 "pool",
948 "allocate",
949 "stage",
950 "destroy",
951 ],
952 )
953 parser.add_argument("name", nargs="?")
954 parser.add_argument("--base-domain")
955 parser.add_argument("--root")
956 parser.add_argument("--pool")
957 parser.add_argument("--media-root")
958 parser.add_argument("--env", action="append", default=[])
959 parser.add_argument("--key", action="append", default=[])
960 args = parser.parse_args()
961 if args.mode == "stage" and args.name == "dashboard":
962 if args.env or args.base_domain or args.root or args.pool or args.media_root:
963 parser.error("dashboard staging uses the host configuration")
964 __import__("dashboard-stage").stage()
965 return
966 if args.mode == "destroy" and args.name and NAME.fullmatch(args.name):
967 saved = STATE / "stages" / f"{args.name}.json"
968 if saved.exists() and json.loads(saved.read_text()).get("sourceId") == "dashboard":
969 __import__("dashboard-stage").destroy(args.name)
970 return
971 if args.mode == "allocate" and not args.name:
972 parser.error("allocate requires a service name")
973 if args.key and args.mode != "secrets":
974 parser.error("--key is available only for secrets")
975 if args.name and args.mode != "destroy" and args.name not in service_files():
976 raise ValueError(f"unknown service: {args.name}")
977 properties = {
978 key: value
979 for key, value in (("domain", args.base_domain), ("root", args.root), ("pool", args.pool), ("mediaRoot", args.media_root))
980 if value
981 }
982 names = [args.name] if args.name else services()
983 if args.mode == "secrets":
984 if not args.name or not NAME.fullmatch(args.name):
985 parser.error("secrets requires a service name")
986 data = load(args.name, properties)
987 declared = [*data["requiredSecrets"], *data["secrets"]]
988 fields = args.key or declared
989 if not declared or len(set(declared)) != len(declared) or any(not re.fullmatch(r"[A-Za-z_][A-Za-z0-9_]*", field) for field in declared):
990 raise ValueError(f"invalid required secrets for {args.name}")
991 if len(set(fields)) != len(fields) or any(field not in declared for field in fields):
992 raise ValueError(f"unknown or duplicate secret key for {args.name}")
993 values = sys.stdin.read().splitlines()
994 if len(values) != len(fields) or any(not value for value in values):
995 raise ValueError(f"expected {len(fields)} nonempty secret lines for {args.name}")
996 token()
997 path = "nomad/jobs/" + args.name
998 existing = get_variable(path)
999 items = dict(existing["Items"]) if existing else {}
1000 items.update(zip(fields, values))
1001 put_variable(path, items, existing["ModifyIndex"] if existing else 0)
1002 print(f"Imported {len(fields)} secrets for {args.name}")
1003 return
1004 if args.mode == "destroy":
1005 if not args.name or not NAME.fullmatch(args.name):
1006 parser.error("destroy requires a stage ID")
1007 token()
1008 metadata = json.loads((STATE / "stages" / f"{args.name}.json").read_text())
1009 names = {metadata["sourceId"]} | {request["provider"] for request in metadata["inputs"].values() if request["provider"] != "snowglobe"}
1010 definitions = {name: load(name, properties) for name in names}
1011 destroy_stage(args.name, metadata, definitions)
1012 return
1013 if args.mode == "stage":
1014 if not args.name:
1015 parser.error("stage requires a service name")
1016 token()
1017 data = load(args.name, properties)
1018 check_staging_pool(data)
1019 definitions = {args.name: data}
1020 definitions.update({provider: load(provider, properties) for provider in dependencies(data)})
1021 if not data["containers"]:
1022 raise ValueError(f"service has no container to stage: {args.name}")
1023 stage_dir = STATE / "stages"
1024 previous = []
1025 for path in stage_dir.glob("*.json"):
1026 saved = json.loads(path.read_text())
1027 if saved.get("sourceId") == args.name:
1028 previous.append((path, saved))
1029 if len(previous) > 1:
1030 raise ValueError(f"multiple stages exist for {args.name}; destroy one first")
1031 created = not previous
1032 stage = f"{args.name}-preview-{secrets.token_hex(4)}" if created else previous[0][0].stem
1033 http = [task["http"] for task in data["containers"].values() if task.get("http") and task["http"].get("hostname")]
1034 if len(http) > 1:
1035 raise ValueError("preview requires at most one HTTP route")
1036 original_host = http[0].get("hostname") if http else None
1037 hostname = stage + "." + original_host.split(".", 1)[1] if original_host else None
1038 data = load(args.name, properties, stage)
1039 data["rollout"] = "simple"
1040 data["hostRoot"] = str(Path(data["stagingRoot"]) / stage)
1041 if data["stageIsolation"] == "fresh" and any(
1042 volume.get("src") and not volume["readOnly"]
1043 for task in data["containers"].values()
1044 for volume in task["volumes"].values()
1045 ):
1046 raise ValueError("fresh stages cannot use writable external mounts")
1047 for task in data["containers"].values():
1048 if task.get("tcp") and not task["hostNetwork"]:
1049 for port in task["tcp"]:
1050 port["hostPort"] = None
1051 if hostname:
1052 for task in data["containers"].values():
1053 if task.get("http") and task["http"].get("hostname") == original_host:
1054 task["http"]["hostname"] = hostname
1055 task["http"]["plainHostnames"] = [stage + "-" + host for host in task["http"]["plainHostnames"]]
1056 task["env"] = {key: value.replace(original_host, hostname) for key, value in task["env"].items()}
1057 if task.get("secretFiles"):
1058 task["secretFiles"] = {key: value.replace(original_host, hostname) for key, value in task["secretFiles"].items()}
1059 for request in data["inputs"].values():
1060 if request["provider"] == "snowglobe":
1061 request["redirectUris"] = [uri.replace(original_host, hostname) for uri in request["redirectUris"]]
1062 for assignment in args.env:
1063 key, separator, value = assignment.partition("=")
1064 if not separator or len(data["containers"]) != 1:
1065 parser.error(f"unknown environment override: {key}")
1066 env = next(iter(data["containers"].values()))["env"]
1067 if key not in env:
1068 parser.error(f"unknown environment override: {key}")
1069 env[key] = value
1070 metadata = (
1071 {"mount": data["hostRoot"], "inputs": data["inputs"],
1072 "tasks": list(data["containers"]), "sourceId": args.name,
1073 "stageIsolation": data["stageIsolation"]}
1074 if created else previous[0][1]
1075 )
1076 if not created:
1077 if metadata.get("stageIsolation", "clone") != data["stageIsolation"]:
1078 raise ValueError("stage isolation changed; destroy the stage before recreating it")
1079 if bool(metadata.get("clone")) != data["hasManagedVolumes"]:
1080 raise ValueError("storage layout changed; destroy the stage before recreating it")
1081 for alias, request in data["inputs"].items():
1082 if alias in metadata["inputs"] and metadata["inputs"][alias] != request:
1083 raise ValueError(f"requirement {alias} changed; destroy the stage before recreating it")
1084 if alias not in metadata["inputs"] and request["provider"] == "postgres":
1085 raise ValueError("new database requirement needs a new stage")
1086 metadata["inputs"].update(data["inputs"])
1087 metadata["tasks"] = sorted(set(metadata["tasks"]) | set(data["containers"]))
1088 stage_dir.mkdir(parents=True, exist_ok=True)
1089 postgres_snapshot = None
1090 pending_snapshots = set()
1091 try:
1092 postgres_inputs = created and data["stageIsolation"] == "clone" and any(
1093 request["provider"] == "postgres" and request["kind"] == "database"
1094 for request in data["inputs"].values()
1095 )
1096 snapshots = []
1097 source = None
1098 if created and data["hasManagedVolumes"]:
1099 pool = data["pool"]
1100 source = subprocess.run(
1101 ["findmnt", "-n", "-o", "SOURCE", "--mountpoint", definitions[args.name]["hostRoot"]],
1102 capture_output=True, text=True,
1103 ).stdout.strip()
1104 dataset = pool + "/staging/" + stage
1105 if subprocess.run(["zfs", "list", pool + "/staging"], capture_output=True).returncode:
1106 command("zfs", "create", "-o", "mountpoint=none", pool + "/staging")
1107 if source and data["stageIsolation"] == "clone":
1108 if source.split("/", 1)[0] != pool:
1109 raise ValueError(f"production dataset belongs to another pool: {source}")
1110 snapshot = source + "@" + stage
1111 snapshots.append(snapshot)
1112 if postgres_inputs:
1113 postgres_dataset = dataset_for("postgres")
1114 if not postgres_dataset:
1115 raise ValueError("Postgres needs a ZFS dataset for consistent stages")
1116 postgres_snapshot = postgres_dataset + "@" + stage
1117 snapshots.append(postgres_snapshot)
1118 external = {}
1119 for task in data["containers"].values():
1120 for volume in task["volumes"].values():
1121 if volume.get("src") and not volume["readOnly"]:
1122 external.setdefault(volume["src"], []).append(volume)
1123 external_mounts = {}
1124 for external_source in external:
1125 path = Path(external_source).resolve(strict=True)
1126 mount = json.loads(command(
1127 "findmnt", "--json", "-o", "SOURCE,TARGET,FSTYPE,OPTIONS", "--target", str(path), capture=True,
1128 ).stdout)["filesystems"][0]
1129 if "ro" not in mount["options"].split(",") and mount["fstype"] != "zfs":
1130 raise ValueError(f"writable external mount is not ZFS: {external_source}")
1131 external_mounts[external_source] = (path, mount)
1132 if created and mount["fstype"] == "zfs" and "ro" not in mount["options"].split(","):
1133 target = mount["source"] + "@" + stage
1134 if target not in snapshots:
1135 snapshots.append(target)
1136 if snapshots:
1137 if len({target.split("/", 1)[0] for target in snapshots}) != 1:
1138 raise ValueError("staged datasets must belong to one ZFS pool")
1139 command("zfs", "snapshot", *snapshots)
1140 pending_snapshots.update(snapshots)
1141 if created and data["hasManagedVolumes"]:
1142 if source and data["stageIsolation"] == "clone":
1143 try:
1144 clone_dataset(source, snapshot, dataset, data["hostRoot"])
1145 except Exception:
1146 command("zfs", "destroy", snapshot)
1147 pending_snapshots.remove(snapshot)
1148 raise
1149 metadata["snapshot"] = snapshot
1150 pending_snapshots.remove(snapshot)
1151 else:
1152 command("zfs", "create", "-o", "mountpoint=" + data["hostRoot"], dataset)
1153 metadata["clone"] = dataset
1154 bindings = {}
1155 for source, volumes in sorted(external.items()):
1156 path, mount = external_mounts[source]
1157 if "ro" in mount["options"].split(","):
1158 binding = {"src": source, "readOnly": True}
1159 elif mount["fstype"] == "zfs":
1160 dataset = mount["source"]
1161 if metadata.get("snapshot") == dataset + "@" + stage:
1162 clone_mount = data["hostRoot"]
1163 else:
1164 staged = metadata.setdefault("external", {})
1165 if dataset not in staged:
1166 if not created:
1167 raise ValueError("external storage changed; destroy the stage before recreating it")
1168 suffix = hashlib.sha256(dataset.encode()).hexdigest()[:8]
1169 pool = dataset.split("/", 1)[0]
1170 clone = pool + "/staging/" + stage + "-external-" + suffix
1171 clone_mount = str(Path(data["stagingRoot"]) / (stage + "-external-" + suffix))
1172 snapshot = dataset + "@" + stage
1173 if subprocess.run(["zfs", "list", pool + "/staging"], capture_output=True).returncode:
1174 command("zfs", "create", "-o", "mountpoint=none", pool + "/staging")
1175 try:
1176 clone_dataset(dataset, snapshot, clone, clone_mount)
1177 except Exception:
1178 command("zfs", "destroy", snapshot)
1179 pending_snapshots.remove(snapshot)
1180 raise
1181 staged[dataset] = {"clone": clone, "snapshot": snapshot, "mount": clone_mount}
1182 pending_snapshots.remove(snapshot)
1183 clone_mount = staged[dataset]["mount"]
1184 relative = path.relative_to(Path(mount["target"]).resolve())
1185 binding = {"src": str(Path(clone_mount) / relative), "readOnly": False}
1186 else:
1187 raise ValueError(f"writable external mount is not ZFS: {source}")
1188 bindings[source] = binding
1189 for volume in volumes:
1190 if path.is_relative_to(Path(data["cloverRoot"]).resolve()):
1191 volume["clover"] = True
1192 volume.update(binding)
1193 if not created and bindings != metadata.get("externalSources", {}):
1194 raise ValueError("external storage changed; destroy the stage before recreating it")
1195 metadata["externalSources"] = bindings
1196 if REPO.parent == Path("/opt/snowglobe/releases").resolve():
1197 metadata["release"] = REPO.name
1198 metadata["ready"] = False
1199 write_private(stage_dir / f"{stage}.json", json.dumps(metadata))
1200 bootstrap([data])
1201 if created and data["stageIsolation"] == "clone" and (data["secrets"] or data["requiredSecrets"]):
1202 source = get_variable("nomad/jobs/" + args.name)
1203 if source:
1204 put_variable("nomad/jobs/" + stage, source["Items"], 0)
1205 if postgres_snapshot:
1206 postgres_clone = postgres_dataset.rsplit("/prod/", 1)[0] + "/staging/" + stage + "-postgres"
1207 postgres_mount = Path(data["stagingRoot"]) / (stage + "-postgres")
1208 source_context = cloned_postgres(postgres_snapshot, postgres_clone, postgres_mount)
1209 else:
1210 source_context = nullcontext(None)
1211 with source_context as postgres_source:
1212 provision_inputs(data, definitions, stage, postgres_source)
1213 provision(data)
1214 prepare(data)
1215 build_images(data)
1216 submit(data, "run", definitions)
1217 except Exception:
1218 if created:
1219 destroy_stage(stage, metadata, definitions)
1220 raise
1221 finally:
1222 for snapshot in sorted(pending_snapshots):
1223 command("zfs", "destroy", snapshot)
1224 if hostname:
1225 check_http(hostname, http[0]["checkPath"], http[0]["tlsInternal"])
1226 configure(data)
1227 if REPO.parent == Path("/opt/snowglobe/releases").resolve():
1228 metadata["ready"] = True
1229 metadata["overrides"] = [assignment.partition("=")[0] for assignment in args.env]
1230 write_private(stage_dir / f"{stage}.json", json.dumps(metadata))
1231 print(f"stage={stage}\nrelease={metadata.get('release', '')}\nhost={hostname}\ndataset={metadata.get('clone', '')}")
1232 return
1233 definitions = {name: load(name, properties) for name in services()}
1234 if args.name and args.name not in definitions:
1235 raise ValueError(f"unknown service: {args.name}")
1236 if not args.name and args.mode == "deploy":
1237 names = [name for name in names if definitions[name]["containers"]]
1238 selected = set(names)
1239 while True:
1240 required = selected | set().union(*(dependencies(definitions[name]) for name in selected))
1241 missing = required - definitions.keys()
1242 if missing:
1243 raise ValueError(f"unknown dependency: {sorted(missing)}")
1244 if required == selected:
1245 break
1246 selected = required
1247 data = ordered([definitions[name] for name in sorted(selected)])
1248 if args.mode == "render":
1249 for item in data:
1250 if item["containers"]:
1251 print(render(item, definitions))
1252 elif args.mode == "validate":
1253 token()
1254 for item in data:
1255 submit(item, "validate", definitions)
1256 elif args.mode == "check":
1257 for item in data:
1258 for task in item["containers"].values():
1259 if task.get("http") and task["http"].get("hostname"):
1260 check_http(task["http"]["hostname"], task["http"]["checkPath"], task["http"]["tlsInternal"])
1261 elif args.mode == "preflight":
1262 check_pool(data)
1263 token()
1264 missing_secrets = {}
1265 for item in data:
1266 if item["containers"] and item["requiredSecrets"]:
1267 variable = get_variable("nomad/jobs/" + item["id"])
1268 values = variable["Items"] if variable else {}
1269 missing = [name for name in item["requiredSecrets"] if not values.get(name)]
1270 if missing:
1271 missing_secrets[item["id"]] = missing
1272 if missing_secrets:
1273 raise ValueError("missing required secrets: " + "; ".join(
1274 f"{name}: {', '.join(keys)}" for name, keys in missing_secrets.items()))
1275 elif args.mode == "pool":
1276 ensure_pool(data)
1277 elif args.mode == "allocate":
1278 ensure_pool(data)
1279 bootstrap(data)
1280 for item in data:
1281 provision_inputs(item, definitions)
1282 provision(item)
1283 prepare(item)
1284 build_images(item)
1285 elif args.mode == "bootstrap":
1286 bootstrap(data)
1287 elif args.mode == "deploy":
1288 bootstrap(data)
1289 for item in data:
1290 provision_inputs(item, definitions)
1291 provision(item)
1292 prepare(item)
1293 build_images(item)
1294 submit(item, "run", definitions)
1295 configure(item)
1296
1297
1298if __name__ == "__main__":
1299 try:
1300 main()
1301 except (OSError, RuntimeError, ValueError, subprocess.CalledProcessError) as error:
1302 print(error, file=sys.stderr)
1303 sys.exit(1)
tools/source-of-truth-migration.md deleted-19
...@@ -1,19 +0,0 @@
1# Clover Source of Truth migration
2
3The existing preview can take a consistent copy of Zenith's live SQLite index without stopping the old service:
4
5```sh
6sh tools/import-source-index.sh clover-source-of-truth-preview-6311ec97
7```
8
9The script stops only that preview, snapshots its ZFS dataset, imports a SQLite `.backup`, checks integrity and checksums, then stages and checks the HTTP route. It retains the pre-import snapshot for recovery. It leaves the preview's own API key in place; the old key must be preserved for the production endpoint because existing clients send it as their authorization header.
10
11On 2026-09-26, Zenith's live index contained 2,592 media files, 136,842 derived file records, and 15,635 derived references. The imported preview passed SQLite integrity, reported the same counts, returned HTTP 200 at `clover-source-of-truth-preview-6311ec97.studio.test`, and had one healthy Nomad allocation. A nonexistent file returned 404. One indexed public raw file and its derived asset were copied from Zenith into the isolated preview, served over HTTPS with HTTP 200, and matched their source SHA-256 hashes; the test files were then removed. The full Published and `derived` trees remain absent from the VM. Zenith's derived tree holds 143,547 files totaling 39,684,661,494 bytes, beyond the demo pool's capacity.
12
13The `clo` account used by the stream importer had zero unreadable files and zero untraversable directories in the source tree at inspection.
14
15For the real cutover, keep `storage1/clover` mounted at `/srv/clover` and point the service's `/published` mount at `/srv/clover/Published`. That avoids copying Published at all. Stop the old source-of-truth container and the new Nomad job, then run `bash tools/import-source-data.sh` with `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT` set for the new host while Zenith remains reachable over SSH. The importer checks both jobs, streams `Documents/Config/paper clover/` into the service's managed ZFS dataset without storing 40 GB on the Mac, compares content digests and SQLite integrity, and leaves Snow Globe stopped with its pre-import snapshot available. A small cross-host fixture verified the stream, including a symlink and hardlink; the full 40 GB transfer remains a production cutover operation. Later staging clones the managed service dataset with ZFS.
16
17If NixOS replaces Zenith on the same machine, stop the old service and take a named `storage1/clover` snapshot before reinstalling. After the pool is mounted at `/srv/clover`, set `STUDIO_MIGRATION_SNAPSHOT=<name>` when running the same importer. It reads the immutable `/srv/clover/.zfs/snapshot/<name>/Documents/Config/paper clover/` tree on the new host and streams directly into the service dataset; no old Docker daemon or second machine is required. The importer rejects a missing or malformed snapshot name before changing the destination.
18
19Run `bash tools/import-legacy-secrets.sh clover-source-of-truth CLOVER_SOT_KEY` during cutover to transfer the old key directly from Zenith's `.env` into Snow Globe's Nomad secret, then deploy the service so its environment receives the imported value. This command changes the production service key; do not run it against the VM while its generated key is in use. Check a representative public raw and derived file over the new hostname before changing the public route. The old container and dataset snapshots remain available until this check passes.
tools/storage-acl-cutover.md deleted-49
...@@ -1,49 +0,0 @@
1# Storage ACL cutover
2
3Zenith mounts `storage1/clover` and `storage1/media` with `nfs4acl`. Their NFSv4 ACLs are nontrivial: Clover grants `group:apps` and `user:1000`; Media grants `user:clo` and TrueNAS built-in groups. Media has 2,431 directories and 28,729 files. Of those, 543 directories and 12,885 files are `root:root` with mode `770`, so UID 3000 relies on the NFSv4 ACL to reach them.
4
5[Stock OpenZFS on Linux does not enforce NFSv4 ACLs](https://openzfs.github.io/openzfs-docs/Basic%20Concepts/Datasets/ACLs.html). The NixOS VM accepted `acltype=nfsv4` on a disposable dataset but rejected `setfacl` and denied UID 3000 access to a root-owned `770` directory. Setting `acltype=posixacl` and granting UID 3000 access made the same check pass. A property value of `nfsv4` alone is therefore insufficient proof of access on NixOS.
6
7`tools/studio.py pool` rejects a mounted Clover or Media ZFS dataset with `acltype=nfsv4` before provisioning service volumes. It also rejects NFSv4 ACLs on the production or staging dataset parent, including values inherited from the pool; a disposable pool proved all three cases and accepted POSIX ACLs. Promotion runs the Clover/Media and production preflight before switching `/opt/studio/current`; a disposable NFSv4 dataset caused promotion to fail while its release link and history stayed unchanged.
8
9The media rename and mountpoint change in [media-cutover.md](media-cutover.md) must be paired with a permission migration. Rehearse it on copy-on-write clones of both datasets, leaving the originals and their snapshots intact. A shared numeric group `3000` with group read/write and setgid directories matches the VM's working Clover, Samba, and Copyparty permissions; a clone test must also verify media writers and readers before choosing that policy for the real tree. Changing `acltype` does not translate existing NFSv4 entries into POSIX ACLs, and [TrueNAS warns against recursive ACL changes without a snapshot](https://www.truenas.com/docs/scale/datasets/permissions/permissions/).
10
11A disposable POSIX-ACL ZFS fixture started with root-owned `0770` directories and a `0660` file that UID 3000 could not read. Granting named group 3000 access and a default ACL on directories, without changing owners, let UID 3000 and Jellyfin UID 3106 read the file. qBittorrent UID 3114 created a file that Copyparty UID 3116 could append to and UID 3000 could edit. The new file kept group 0 from its setgid parent, but inherited the named group 3000 ACL; the fixture was destroyed. This proves local service access on representative modes; SMB has a separate limitation below.
12
13A macOS SMB mount reached the VM over Tailscale and wrote a file as `3000:3000` with mode `0644`, despite Samba's `force create mode = 0660`; Copyparty's group identity could not edit it. A temporary Samba configuration with `acl_xattr` and `acl_xattr:ignore system acls = yes` yielded `0666`. Adding a parent default POSIX ACL (`user::rwx,group::rwx,other::---`) yielded files at `0660`, but Mac-created directories at `2777`. Adding `inherit permissions = yes` yielded directories at `2770` and files at `0660`; Copyparty's UID 3116/GID 3000 then appended to a Mac-created file and created a sibling in its directory. `inherit permissions` and the default ACL without `acl_xattr` instead yielded `0755` directories and `0644` files. That rehearsal introduced the ACL-xattr configuration superseded by the 2026-10-13 macOS fix below, while retaining the image's `catia fruit streams_xattr` Mac VFS modules. A disposable write through the staged Samba share again produced a `0660` file and `2770` directory, both writable by UID 3116/GID 3000; the fixture was removed. VM promotion `b1a2cdde0f6f12a4` passed all 19 HTTP routes and kept four PostgreSQL dumps in its pre-switch backup. The real dataset cutover still needs inherited POSIX ACLs applied through writable directories and verified on clones. [Samba documents the `acl_xattr` behavior](https://www.samba.org/samba/docs/current/man-html/vfs_acl_xattr.8.html).
14
15`acl_xattr:ignore system acls = yes` ignores named POSIX ACL grants for SMB permission checks. A staged Samba version without `acl_xattr` let a Linux SMB client write root-owned files through group ACLs, but a macOS mount then created `0644` files and `0755` directories that Copyparty could not edit. That version was rolled back. With the current Samba settings, a Mac mount created `0660` files and `2770` directories in a group-owned `3000` fixture, and Copyparty could append. The current configuration therefore needs group ownership as well as ACLs on a production clone rehearsal; the local UID test alone does not establish Finder access.
16
17A later disposable Samba test changed only `acl_xattr:ignore system acls` to `no`. In a root-owned, group-0 directory with a named/default POSIX ACL for group 3000, a macOS SMB mount created a file and directory, overwrote an existing root-owned file, and Copyparty UID 3116/GID 3000 appended to the new file. This worked both with and without `inherit permissions`. The new file and directory were `3000:3000` mode `0770`; the existing file retained root ownership. This offers a way to avoid changing ownership across the existing tree, but the executable bits on new regular files need review. The disposable dataset and container were removed, and the managed Samba job was restored without changing its configuration.
18
19An isolated Samba container on port 1445 was reachable from macOS through an SSH tunnel using `mount_smbfs //clo@127.0.0.1:1445/clover`; the managed share stayed online. In that fixture, disabling DOS archive/hidden/system mode mapping and then tightening `create mask` to `0660`, `directory mask` to `0770`, and `acl map full control` to `no` still produced `0770` Finder files and directories. Copyparty could append. The execute bits therefore appear to come from the ACL mapping in this combination, not the tested mode masks. The isolated container, dataset, and tunnel were removed.
20
21The same isolated setup without `acl_xattr` and with `inherit permissions = no` let Finder overwrite an existing root-owned file through its named ACL. New Finder files were `0644` and directories `0755` despite Samba's forced `0660`/`2770` modes, and the new file's inherited group ACL was masked to read-only; Copyparty could not append. That configuration cannot satisfy shared editing without a further permission mechanism. The fixture was removed.
22
23With Samba's default oplocks, a Mac SMB mount returned stale bytes and NULs immediately after Copyparty appended to a mounted file; remounting showed the correct server data. A disposable Samba container with `oplocks = no` returned the correct bytes immediately in the same test. The managed Samba job was restored afterward. Disabling oplocks may reduce SMB client caching performance and has not been promoted.
24
25Zenith's `storage1` pool root is unencrypted; `storage1/apps`, `storage1/clover`, and `storage1/media` are separate AES-256-GCM encryption roots with `keyformat=hex` and `keylocation=prompt`. Creating `storage1/prod` beneath the pool root without encryption would silently expose new app data. Snow Globe now requires an encrypted `prod` dataset mounted at `/srv/prod` whenever Clover or Media is encrypted. A disposable encrypted Clover dataset failed this preflight against the VM's unencrypted demo `prod`. A fresh disposable pool with separate encrypted Clover and `prod` roots passed: the `shale` service dataset inherited `prod` as its encryption root. The current VM predates the mounted-parent change and still has `studio-demo/prod` with `mountpoint=none`; its service children are mounted individually.
26
27The real host must load the selected keys before mounting datasets and starting Nomad; [loading a key does not itself mount the dataset](https://openzfs.github.io/openzfs-docs/man/v2.2/8/zfs-load-key.8.html). Keep keys out of the repository. A separate VM test confirmed that renaming one independent encrypted root beneath another preserves its independent encryption root.
28
29Copyparty's previous `df: 16` reserve rejected every upload on the 8 GB VM pool. Its prepared config now reserves one quarter of the dataset capacity, capped at the original 16 GB. The staged and production VM instances accepted a file and directory upload; the resulting `0664` file and setgid `2775` directory were writable by Clover's separate UID/GID 3000. Test files were removed, the Source of Truth preview was restarted, and the Copyparty preview was stopped to return the VM's reserved memory. Promotion `ec5322fadd8ae7a8` passed all 19 HTTP routes with 22 ZFS snapshots and four PostgreSQL dumps in its backup.
30
31Snow Globe's `zfs clone` of a disposable encrypted Media source stayed AES-256-GCM encrypted under an unencrypted staging parent and shared the Media encryption root; writes to the clone left the source unchanged. [OpenZFS specifies that clones always share their origin's encryption key](https://openzfs.github.io/openzfs-docs/man/master/7/zfsprops.7.html). Fresh stages have no encrypted origin to inherit, so `tools/studio.py stage` now requires an encrypted `pool/staging` mounted at `/srv/staging` when `pool/prod` is encrypted. A disposable pool proved missing and unencrypted staging parents are rejected, while an encrypted parent passes. The VM's existing unencrypted pool still stages normally.
32
33`storage1/apps` is one encrypted dataset with no child datasets: 47.8 GiB live and 65.3 GiB held by 207 snapshots at inspection. It also contains stacks excluded from Snow Globe. Renaming it to `storage1/prod` would preserve that history but leave the service folders as ordinary directories; moving selected data into per-service child datasets would still be necessary. Creating a separate encrypted `prod` root keeps the old tree and its snapshots available during migration.
34
35## macOS saves — 2026-10-13
36
37Zenith ran Samba 4.23.8 with `acl_xattr` but without `CAP_SYS_ADMIN`. On macOS 15.7.5, ordinary writes succeeded while `NSFileManager.replaceItemAt`, `NSDocument.writeSafely`, package replacement, and `chmod` failed with `EACCES`. The ACL module could not store protected `security.NTACL` attributes; [Samba documents that capability requirement](https://gitlab.com/samba-team/samba/-/merge_requests/3501). Only generated disposable files were opened during these probes.
38
39The [service declaration](../service/samba/service.pkl) now uses POSIX permissions directly. Disabling NFS ACE mode updates keeps Mac clients from bypassing the creation masks. Removing inherited mode handling leaves new regular files at `0660` and directories at `2770`; UID 3116/GID 3000 can edit them. A capability-only alternative fixed Cocoa saving but produced `0644` files that the shared group could not edit. Allowing AppleDouble names also fixes client temporary files and resource-fork copies; [Samba warns that vetoing these names breaks archive tools](https://www.samba.org/samba/docs/current/man-html/vfs_fruit.8.html).
40
41[The macOS regression probe](samba-macos-test.swift) creates and removes its own directory: `swift tools/samba-macos-test.swift <mounted-share>`. Its nine checks cover atomic writes, permission-preserving replacement, Cocoa Save As/save/autosave, RTFD packages, metadata and 128 KiB resource-fork copies, AppleDouble filenames, permission updates, replacement with an open reader, and cleanup. All passed in an isolated local Linux rehearsal and Zenith's ZFS preview `samba-preview-84726d65`. The preview used disposable authentication. Files owned by root and by UID 3116 were also editable through Cocoa in the local rehearsal. Blender 5.2 saved an asset and backup, linked it into a project, reopened the project, and read an external PNG from the share.
42
43Kernel oplocks make native service overwrites and appends invalidate SMB caches. The default SMB leases returned stale data even after reopening a file; the revised configuration returned the updated bytes immediately, including service-owned files. UID 3000 granted a kernel read lease on a disposable Zenith ZFS file without extra capabilities. An external atomic replacement retains the old inode while a Mac reader remains open; closing all old handles makes subsequent readers see the replacement. Disabling oplocks entirely showed the same Mac behavior, so the service retains kernel-backed caching.
44
45The live connection negotiated 1 Gb Ethernet. A disposable 128 MiB synthetic file measured 65.3 MiB/s writes with fsync and 76.6 MiB/s reads with the Mac data cache disabled and the server cache warm. Among 512 random 64 KiB reads, median/p95/maximum latency was 1.23/1.53/178.92 ms. These numbers do not establish real-time sample-library playback. Zenith has four 8 TB WD80EFPX HDDs in one RAIDZ1 vdev with 128 KiB records, a gigabit RTL8168 NIC, and 128 GB RAM; the Mac's unused built-in port supports 10 Gb. [RAIDZ streaming bandwidth scales across data disks, but default-record random-read IOPS are roughly one disk's](https://openzfs.github.io/openzfs-docs/Basic%20Concepts/Pool%20Structure/RAIDZ.html). A cable cannot remove the NAS NIC's speed limit.
46
47REAPER supports VST3, while macOS VST3 files are executable bundles ([REAPER](https://www.reaper.fm/about.php), [Steinberg](https://steinbergmedia.github.io/vst3_dev_portal/pages/Technical%2BDocumentation/Locations%2BFormat/Plugin%2BFormat.html)). Actual vendor plug-ins and sample libraries need their own playback trial. [Kontakt streams samples during playback](https://support.native-instruments.com/support/solutions/articles/69000879768-what-is-dfd-), and [NI advises against active libraries on NAS](https://support.native-instruments.com/support/solutions/articles/69000879313-notes-on-network-drives-and-disk-formats). No existing plug-in or sample-library contents were opened or moved during this work.
48
49Production release `94c1aa0a1f6a4a00` activated on 2026-10-14 at 05:45 UTC from main `f9c3a85e`, with pre-switch backup `20261014T054319Z-54be52`. All 22 HTTP routes and the Samba allocation were healthy. The live Mac mount passed all nine regression checks, shared-group writes became visible immediately, and Blender passed the asset round trip. The old mount disconnected during activation; a background NetFS reconnect restored `/Volumes/clover` using saved credentials. Generated files and the ZFS preview were removed afterward.
tools/studio-secret-files-test.py deleted-72
...@@ -1,72 +0,0 @@
1#!/usr/bin/env python3
2import json
3import os
4from pathlib import Path
5import subprocess
6import tempfile
7import unittest
8
9import studio
10
11
12class SecretFiles(unittest.TestCase):
13 @classmethod
14 def setUpClass(cls):
15 with tempfile.TemporaryDirectory(prefix="studio-secret-template-") as temporary:
16 fixture = Path(temporary) / "fixture.pkl"
17 fixture.write_text('amends ' + json.dumps((studio.REPO / "config/Service.pkl").as_uri()) + '\nmeta { name = "Fixture" }\ncontainer { image = "localhost/fixture:pinned" }\n')
18 result = subprocess.run([os.environ.get("PKL", "pkl"), "eval", "-p", "uid=3132", "-p", "serviceId=fixture", str(fixture)], check=True, capture_output=True, text=True)
19 cls.fixture = json.loads(result.stdout)
20 cls.fixture.update(uid=3132, sourceId="fixture", inputs={})
21 cls.fixture.pop("requirements")
22
23 def setUp(self):
24 self.data = json.loads(json.dumps(self.fixture))
25 self.task = self.data["containers"]["app"]
26 self.task["secretFiles"] = {"/run/secrets/oidc.json": '{{ with nomadVar "nomad/jobs/fixture/inputs/oidc" }}{"clientSecret":{{ .clientSecret.Value | toJSON }}}{{ end }}'}
27
28 def test_private_allocation_template_and_read_only_file_mount(self):
29 rendered = studio.render(self.data, {"fixture": self.data})
30 self.assertIn('"secrets/oidc.json:/run/secrets/oidc.json:ro"', rendered)
31 self.assertIn('destination = "secrets/oidc.json"', rendered)
32 self.assertIn('perms = "0400"', rendered)
33 self.assertIn('uid = 3132', rendered)
34 self.assertIn('gid = 3132', rendered)
35 self.assertIn('error_on_missing_key = true', rendered)
36 self.assertIn(self.task["secretFiles"]["/run/secrets/oidc.json"], rendered)
37 self.assertNotIn('env = true', rendered)
38 self.assertNotIn('change_mode =', rendered)
39
40 def test_services_without_files_gain_no_template_or_mount(self):
41 self.task["secretFiles"] = {}
42 rendered = studio.render(self.data, {"fixture": self.data})
43 self.assertNotIn('template {', rendered)
44 self.assertNotIn('secrets/', rendered)
45
46 def test_unsafe_and_colliding_targets_are_rejected(self):
47 for target in ("relative.json", "/run/../secret.json", "/run/./secret.json", "/run//secret.json", "/run/secrets/", "/secrets/file", "/secrets", "/run/app.env", "/run/app-secret.env", "/run/nomad_token", "/run/line\nbreak"):
48 with self.subTest(target=target):
49 self.task["secretFiles"] = {target: "{}"}
50 with self.assertRaisesRegex(ValueError, "invalid secret file target"):
51 studio.render(self.data, {"fixture": self.data})
52 self.task["secretFiles"] = {"/one/config.json": "{}", "/two/config.json": "{}"}
53 with self.assertRaisesRegex(ValueError, "invalid secret file target"):
54 studio.render(self.data, {"fixture": self.data})
55 self.task["secretFiles"] = {"/run/secrets/oidc.json": "{}"}
56 self.task["volumes"] = {"/run/secrets/oidc.json": {}}
57 with self.assertRaisesRegex(ValueError, "invalid secret file target"):
58 studio.render(self.data, {"fixture": self.data})
59
60 def test_image_user_and_heredoc_injection_are_rejected(self):
61 self.task["imageUser"] = True
62 with self.assertRaisesRegex(ValueError, "service-owned"):
63 studio.render(self.data, {"fixture": self.data})
64 self.task["imageUser"] = False
65 for body in ("EOF", "{}\nEOF\nmalicious", "{}\nEOF\r\nmalicious"):
66 self.task["secretFiles"] = {"/run/secrets/oidc.json": body}
67 with self.assertRaisesRegex(ValueError, "invalid secret template delimiter"):
68 studio.render(self.data, {"fixture": self.data})
69
70
71if __name__ == "__main__":
72 unittest.main()
tools/studio.py deleted-1286
...@@ -1,1286 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3from contextlib import nullcontext
4import fcntl
5import hashlib
6import json
7import os
8from pathlib import Path
9import re
10import secrets
11import shutil
12import subprocess
13import sys
14import tempfile
15import time
16
17from data import cloned_postgres, dataset_for
18from release import excluded_services
19
20
21REPO = Path(__file__).resolve().parent.parent
22SERVICES = REPO / "service"
23STATE = Path("/var/lib/studio")
24IDENTITIES = STATE / "identities.json"
25ASSETS = Path("/var/lib/caddy/studio")
26NAME = re.compile(r"[a-z][a-z0-9-]*\Z")
27
28
29def command(*args, capture=False, **kwargs):
30 return subprocess.run(args, check=True, text=True, capture_output=capture, **kwargs)
31
32
33def service_files():
34 excluded = excluded_services(REPO)
35 files = {}
36 for directory in SERVICES.iterdir():
37 if directory.name in excluded or not directory.is_dir():
38 continue
39 for path in directory.glob("*.pkl"):
40 name = directory.name if path.name == "service.pkl" else path.stem
41 if name in excluded:
42 continue
43 if name in files:
44 raise ValueError(f"duplicate service definition: {name}")
45 files[name] = path
46 return files
47
48
49def services():
50 return sorted(service_files())
51
52
53def service_dir(name):
54 path = service_files()[name]
55 return path.parent if path.name == "service.pkl" else path.parent / name
56
57
58def dependencies(data):
59 return set(data["dependsOn"]) | {item["provider"] for item in data["inputs"].values() if item["provider"] != "snowglobe"}
60
61
62def ordered(data):
63 pending = {item["id"]: item for item in data}
64 result = []
65 while pending:
66 ready = [
67 item
68 for item in pending.values()
69 if not dependencies(item) & pending.keys()
70 ]
71 if not ready:
72 raise ValueError("cycle in service dependencies")
73 for item in ready:
74 result.append(item)
75 del pending[item["id"]]
76 return result
77
78
79def identity(name):
80 STATE.mkdir(parents=True, exist_ok=True)
81 if not IDENTITIES.exists():
82 write_private(IDENTITIES, (REPO / "config/identities.json").read_text())
83 with (IDENTITIES.parent / ".identities.lock").open("w") as lock:
84 fcntl.flock(lock, fcntl.LOCK_EX)
85 with IDENTITIES.open() as file:
86 ids = json.load(file)
87 if len(set(ids.values())) != len(ids):
88 raise ValueError("duplicate service UIDs")
89 if name not in ids:
90 used = set(ids.values())
91 ids[name] = next(uid for uid in range(3100, 60000) if uid not in used)
92 pending = IDENTITIES.with_suffix(".pending")
93 pending.write_text(json.dumps(ids, indent=2) + "\n")
94 pending.replace(IDENTITIES)
95 return ids[name]
96
97
98def load(name, properties, instance_id=None):
99 files = service_files()
100 if not NAME.fullmatch(name) or name not in files:
101 raise ValueError(f"unknown service: {name}")
102 instance_id = instance_id or name
103 if not NAME.fullmatch(instance_id):
104 raise ValueError(f"invalid instance ID: {instance_id}")
105 uid = identity(name)
106 result = command(
107 "pkl",
108 "eval",
109 *(
110 part
111 for key, value in {**properties, "serviceId": instance_id, "uid": uid, "preview": str(instance_id != name).lower()}.items()
112 for part in ("-p", f"{key}={value}")
113 ),
114 str(files[name]),
115 capture=True,
116 )
117 data = json.loads(result.stdout)
118 if data["id"] != instance_id:
119 raise ValueError(f"service ID must match deployment: {instance_id}")
120 inputs = {}
121 for requirement in data.pop("requirements"):
122 alias = requirement["alias"]
123 if not NAME.fullmatch(alias) or alias == "own" or alias in inputs:
124 raise ValueError(f"invalid or duplicate requirement alias: {alias}")
125 inputs[alias] = requirement
126 data["inputs"] = inputs
127 data["uid"] = uid
128 data["sourceId"] = name
129 for task_name, task in data["containers"].items():
130 if bool(task.get("image")) == bool(task.get("build")):
131 raise ValueError(f"{name}.{task_name} needs one image or build directory")
132 if task.get("build"):
133 if REPO.parent == Path("/opt/studio/releases"):
134 context = config_path(name, task["build"])
135 if not context.is_dir() or not (context / "Dockerfile").is_file():
136 raise ValueError(f"invalid build context: {name}.{task_name}")
137 digest = hashlib.sha256()
138 for path in sorted(context.rglob("*")):
139 if path.is_file():
140 digest.update(str(path.relative_to(context)).encode() + b"\0")
141 digest.update(path.read_bytes())
142 tag = digest.hexdigest()[:16]
143 elif not (service_dir(name) / task["build"] / "Dockerfile").is_file() and not (service_dir(name) / "build-source.json").is_file():
144 raise ValueError(f"missing build source: {name}.{task_name}")
145 else:
146 tag = REPO.name
147 task["image"] = f"localhost/studio/{name}-{task_name}:{tag}"
148 return data
149
150
151def q(value):
152 return json.dumps(value, ensure_ascii=False)
153
154
155def write_private(path, content):
156 pending = None
157 try:
158 with tempfile.NamedTemporaryFile("w", dir=path.parent, delete=False) as file:
159 pending = Path(file.name)
160 file.write(content)
161 pending.replace(path)
162 finally:
163 if pending:
164 pending.unlink(missing_ok=True)
165
166
167def host_path(root, relative):
168 if relative == ".":
169 return root
170 part = Path(relative)
171 if part.is_absolute() or ".." in part.parts or not part.parts:
172 raise ValueError(f"invalid relative path: {relative}")
173 return str(Path(root) / part)
174
175
176def config_path(service, relative):
177 root = service_dir(service).resolve()
178 source = (root / relative).resolve()
179 if not source.is_relative_to(root) or not source.exists():
180 raise ValueError(f"invalid config path: {relative}")
181 return source
182
183
184def config_assets(data):
185 paths = set()
186 for task in data["containers"].values():
187 paths.update(volume["config"] for volume in task["volumes"].values() if volume.get("config"))
188 if task.get("http"):
189 paths.update(task["http"]["overrideFiles"].values())
190 sources = {rel: config_path(data.get("sourceId", data["id"]), rel) for rel in paths}
191 digest = hashlib.sha256()
192 for rel, source in sorted(sources.items()):
193 digest.update(rel.encode())
194 files = sorted(source.rglob("*")) if source.is_dir() else [source]
195 for file in files:
196 if file.is_symlink():
197 raise ValueError(f"config asset cannot be a symlink: {file}")
198 if file.is_file():
199 digest.update(str(Path(rel) / file.relative_to(source)).encode() if source.is_dir() else rel.encode())
200 digest.update(file.read_bytes())
201 return ASSETS / data["id"] / digest.hexdigest()[:16], sources
202
203
204def render(data, definitions):
205 if not data["containers"]:
206 return ""
207 name = data["id"]
208 asset_dir, _ = config_assets(data)
209 prepare_digest = None
210 if data.get("prepare"):
211 source = service_dir(data.get("sourceId", name))
212 digest = hashlib.sha256()
213 for path in sorted(source.rglob("*")):
214 if not path.is_file() or "__pycache__" in path.parts or path.suffix == ".pyc":
215 continue
216 if path.name == "service.pkl" or path.name.startswith("icon"):
217 continue
218 digest.update(str(path.relative_to(source)).encode() + b"\0")
219 digest.update(path.read_bytes())
220 prepare_digest = digest.hexdigest()[:16]
221 routed = [task["http"] for task in data["containers"].values()
222 if task.get("http") and task["http"].get("hostname")]
223 primary = routed[0] if routed else {}
224 requirements = {provider: "startup" for provider in data["dependsOn"]}
225 requirements.update({item["provider"]: item["kind"] for item in data["inputs"].values()})
226 secrets_meta = [
227 {"name": name, "generated": True, "bytes": spec["bytes"]}
228 for name, spec in data["secrets"].items()
229 ] + [{"name": name, "generated": False} for name in data["requiredSecrets"]]
230 lines = [
231 f"job {q(name)} {{",
232 ' datacenters = ["clover"]',
233 ' type = "service"',
234 ' meta {',
235 f" studio_service = {q(data['sourceId'])}",
236 f" studio_name = {q(data['name'])}",
237 f" studio_tagline = {q(data['tagline'])}",
238 f" studio_hostname = {q(primary.get('hostname') or '')}",
239 f" studio_launcher = {q(str(data['launcher']).lower())}",
240 f" studio_auth_role = {q(data.get('access') or primary.get('authRole') or '')}",
241 f" studio_trace_service = {q(data.get('traceServiceName') or '')}",
242 f" studio_metrics_pushed = {q(str(data['metricsPushed']).lower())}",
243 f" studio_requires = {q(json.dumps(requirements))}",
244 f" studio_secrets = {q(json.dumps(secrets_meta))}",
245 ' }',
246 ' group "app" {',
247 ]
248 if dependencies(data):
249 lines += [
250 " restart {",
251 " attempts = 3",
252 ' delay = "1m"',
253 ' interval = "4m"',
254 ' mode = "delay"',
255 " }",
256 ]
257 if data["rollout"] == "overlapped":
258 for task in data["containers"].values():
259 if task["hostNetwork"] or any(
260 endpoint and endpoint.get("hostPort") is not None
261 for endpoint in (task.get("http"), *task["tcp"])
262 ) or any(not volume["readOnly"] for volume in task["volumes"].values()):
263 raise ValueError(f"overlapped rollout requires dynamic ports and read-only mounts: {name}")
264 elif data["rollout"] != "simple":
265 raise ValueError(f"unknown rollout: {data['rollout']}")
266 if data["rollout"] == "overlapped" or data.get("healthyDeadline"):
267 lines.append(" update {")
268 if data["rollout"] == "overlapped":
269 lines += [" canary = 1", " auto_promote = true", " auto_revert = true"]
270 if data.get("healthyDeadline"):
271 lines += [f" healthy_deadline = {q(data['healthyDeadline'])}", ' progress_deadline = "0"']
272 lines.append(" }")
273 if data.get("healthyDeadline"):
274 lines += [" migrate {", f" healthy_deadline = {q(data['healthyDeadline'])}", " }"]
275 ports = {}
276 network = []
277 host_network = any(task["hostNetwork"] for task in data["containers"].values())
278 if host_network and not all(task["hostNetwork"] for task in data["containers"].values()):
279 raise ValueError("mixed host and bridge networking in one group")
280 for task_name, task in data["containers"].items():
281 for kind, endpoint in [("http", task.get("http")), *((port["name"], port) for port in task["tcp"])]:
282 if endpoint:
283 label = kind if len(data["containers"]) == 1 else f"{task_name}-{kind}"
284 if label in ports.values():
285 raise ValueError(f"duplicate port label: {label}")
286 ports[(task_name, kind)] = label
287 network.append(f" port {q(label)} {{")
288 if endpoint.get("hostPort") is not None:
289 network.append(f" static = {endpoint['hostPort']}")
290 if not task["hostNetwork"]:
291 network.append(f" to = {endpoint['containerPort']}")
292 if endpoint.get("loopback") or (not task["hostNetwork"] and kind == "http" and endpoint.get("hostPort") is None):
293 network.append(' host_network = "loopback"')
294 network.append(" }")
295 if network:
296 lines.append(" network {")
297 if host_network:
298 lines.append(' mode = "host"')
299 lines += network + [" }"]
300 for provider_id in sorted(dependencies(data)):
301 provider = definitions[provider_id]
302 for provider_task, container in provider["containers"].items():
303 endpoint = container.get("http")
304 if not endpoint or not endpoint.get("hostname") or endpoint.get("authRole"):
305 continue
306 host = endpoint["hostname"]
307 task_name = f"wait-{provider_id}-{provider_task}"
308 lines += [
309 f" task {q(task_name)} {{",
310 ' driver = "podman"',
311 " lifecycle {",
312 ' hook = "prestart"',
313 " sidecar = false",
314 " }",
315 " config {",
316 ' image = "docker.io/curlimages/curl@sha256:43ebaa53d3806db6b1ce4353b6b26ae638ec1c167ee351524b05690f988bb20d"',
317 f" extra_hosts = {q([host + ':host-gateway'])}",
318 f" args = {q(['--insecure', '--fail', '--silent', '--show-error', '--retry', '999999', '--retry-all-errors', '--retry-delay', '5', '--connect-timeout', '3', '--max-time', '5', 'https://' + host + endpoint['checkPath']])}",
319 " }",
320 " resources {",
321 " cpu = 50",
322 " memory = 64",
323 " }",
324 " }",
325 ]
326 for task_name, task in data["containers"].items():
327 if task.get("http") or task.get("tcp"):
328 kind = "http" if task.get("http") else "tcp"
329 endpoint = task["http"] if kind == "http" else task["tcp"][0]
330 label = ports[(task_name, "http" if kind == "http" else endpoint["name"])]
331 lines += [" service {", f" name = {q(name if task_name == 'app' else name + '-' + task_name)}", ' provider = "nomad"', f" port = {q(label)}"]
332 if len(data["containers"]) == 1:
333 lines.append(f" task = {q(task_name)}")
334 tags = []
335 if kind == "http" and endpoint.get("metricsPath"):
336 tags.append("studio-metrics-path=" + endpoint["metricsPath"])
337 if kind == "http" and endpoint.get("hostname"):
338 tags += ["caddy-host=" + host for host in [endpoint["hostname"], *endpoint["plainHostnames"]]]
339 if endpoint.get("authRole"):
340 tags.append("caddy-auth-role=" + endpoint["authRole"])
341 if endpoint.get("userHeader"):
342 tags.append("caddy-user-header=" + endpoint["userHeader"])
343 if endpoint["forwardRealIp"]:
344 tags.append("caddy-real-ip=true")
345 if endpoint.get("secureCookies"):
346 tags.append("caddy-secure-cookies=true")
347 if endpoint["tlsInternal"]:
348 tags.append("caddy-internal=true")
349 if tags:
350 lines.append(f" tags = {q(tags)}")
351 lines += [" check {", f" type = {q(kind)}"]
352 if kind == "http":
353 lines.append(f" path = {q(endpoint['checkPath'])}")
354 if endpoint["checkHeaders"]:
355 lines.append(" header {")
356 for key, value in endpoint["checkHeaders"].items():
357 if not re.fullmatch(r"[A-Za-z][A-Za-z0-9-]*", key):
358 raise ValueError(f"invalid health check header: {key}")
359 lines.append(f" {key} = [{q(value)}]")
360 lines.append(" }")
361 lines += [
362 ' interval = "10s"',
363 ' timeout = "15s"',
364 ' check_restart {',
365 ' limit = 12',
366 f" grace = {q(data.get('healthRestartGrace') or data.get('healthyDeadline') or '5m')}",
367 ' }',
368 ' }',
369 ' }',
370 ]
371 for task_name, task in data["containers"].items():
372 lines += [f" task {q(task_name)} {{", ' driver = "podman"']
373 if task["lifecycle"] != "main":
374 lines += [' lifecycle {', ' hook = "prestart"',
375 f" sidecar = {str(task['lifecycle'] == 'prestartSidecar').lower()}", ' }']
376 if not task["imageUser"]:
377 uses_clover = any(
378 volume.get("clover") or (
379 volume.get("src")
380 and Path(volume["src"]).resolve().is_relative_to(Path(data["cloverRoot"]).resolve())
381 )
382 for volume in task["volumes"].values()
383 )
384 gid = data["cloverGid"] if uses_clover else 0 if task["rootGroup"] else data["uid"]
385 lines.append(f" user = {q(str(data['uid']) + ':' + str(gid))}")
386 lines += [" config {", f" image = {q(task['image'])}"]
387 if task.get("entrypoint"):
388 lines.append(f" entrypoint = {q(task['entrypoint'])}")
389 if task["args"]:
390 lines.append(f" args = {q(task['args'])}")
391 if task["hostNetwork"]:
392 lines.append(' network_mode = "host"')
393 task_ports = [label for (owner, _), label in ports.items() if owner == task_name]
394 if task_ports and not task["hostNetwork"]:
395 lines.append(f" ports = {q(task_ports)}")
396 for field, values in (("cap_add", task["capAdd"]), ("devices", task["devices"]), ("extra_hosts", task["extraHosts"])):
397 if values:
398 lines.append(f" {field} = {q(values)}")
399 volumes = []
400 secret_files = task.get("secretFiles", {})
401 filenames = set()
402 for target, template in secret_files.items():
403 filename = Path(target).name
404 if (not re.fullmatch(r"/[A-Za-z0-9_./-]+", target) or target.endswith("/")
405 or any(part in {".", "..", ""} for part in target[1:].split("/"))
406 or filename in filenames
407 or filename in {task_name + ".env", task_name + "-secret.env", "nomad_token"}
408 or target in task["volumes"] or target == "/secrets" or target.startswith("/secrets/")):
409 raise ValueError(f"invalid secret file target: {target}")
410 if task["imageUser"]:
411 raise ValueError("secret files require a service-owned container user")
412 if re.search(r"(?m)^EOF\r?$", template):
413 raise ValueError("invalid secret template delimiter")
414 filenames.add(filename)
415 volumes.append(f"secrets/{filename}:{target}:ro")
416 for target, volume in task["volumes"].items():
417 if not target.startswith("/") or ":" in target:
418 raise ValueError(f"invalid volume target: {target}")
419 if volume.get("config") is not None:
420 if volume.get("src") is not None or not volume["readOnly"]:
421 raise ValueError("config mounts must be read only and have no host source")
422 config_path(data.get("sourceId", name), volume["config"])
423 source = host_path(str(asset_dir), volume["config"])
424 elif volume.get("src") is not None:
425 source = volume["src"]
426 if not Path(source).is_absolute():
427 raise ValueError(f"volume source must be absolute: {source}")
428 else:
429 source = host_path(data["hostRoot"], target.lstrip("/"))
430 if ":" in source:
431 raise ValueError(f"invalid volume source: {source}")
432 volumes.append(f"{source}:{target}" + (":ro" if volume["readOnly"] else ""))
433 if volumes:
434 lines.append(f" volumes = {q(volumes)}")
435 if task["tmpfs"]:
436 lines.append(f" tmpfs = {q(task['tmpfs'])}")
437 lines.append(" }")
438 secret_env = []
439 plain_env = {}
440 for key, value in task["env"].items():
441 if not re.fullmatch(r"[A-Za-z_][A-Za-z0-9_]*", key):
442 raise ValueError(f"invalid env key: {key}")
443 parts = re.split(r"(\$\{secret\.[A-Za-z_][A-Za-z0-9_]*\.[A-Za-z_][A-Za-z0-9_]*\})", value)
444 if len(parts) == 1:
445 if "${secret." in value:
446 raise ValueError(f"invalid secret reference: {value}")
447 plain_env[key] = value
448 continue
449 args = []
450 paths = {}
451 for part in parts:
452 match = re.fullmatch(r"\$\{secret\.([A-Za-z_][A-Za-z0-9_]*)\.([A-Za-z_][A-Za-z0-9_]*)\}", part)
453 if match:
454 alias, field = match.groups()
455 if alias != "own" and alias not in data["inputs"]:
456 raise ValueError(f"unknown secret alias: {alias}")
457 path = f"nomad/jobs/{name}" + (f"/inputs/{alias}" if alias != "own" else "")
458 variable = paths.setdefault(path, f"$s{len(paths)}")
459 args.append(f"(index {variable} {q(field)}).Value")
460 elif part:
461 args.append(q(part))
462 start = "".join(f'{{{{ with {variable} := nomadVar {q(path)} }}}}' for path, variable in paths.items())
463 end = "{{ end }}" * len(paths)
464 secret_env.append(f'{start}{key}={{{{ print {" ".join(args)} | toJSON }}}}{end}')
465 if "STUDIO_PREPARE_DIGEST" in task["env"]:
466 raise ValueError("STUDIO_PREPARE_DIGEST is reserved")
467 lines.append(" env {")
468 for key, value in plain_env.items():
469 lines.append(f" {key} = {q(value)}")
470 if prepare_digest:
471 lines.append(f" STUDIO_PREPARE_DIGEST = {q(prepare_digest)}")
472 lines.append(" }")
473 if secret_env:
474 lines += [" template {", " data = <<EOF", *secret_env, "EOF", f' destination = {q("secrets/" + task_name + "-secret.env")}', " env = true", " error_on_missing_key = true", " }"]
475 if task.get("envTemplate"):
476 if "\nEOF\n" in task["envTemplate"]:
477 raise ValueError("invalid env template delimiter")
478 lines += [" template {", " data = <<EOF", task["envTemplate"].rstrip(), "EOF", f' destination = {q("secrets/" + task_name + ".env")}', " env = true", " }"]
479 for target, template in secret_files.items():
480 lines += [" template {", " data = <<EOF", template.rstrip(), "EOF",
481 f' destination = {q("secrets/" + Path(target).name)}', ' perms = "0400"',
482 f' uid = {data["uid"]}', f' gid = {data["uid"]}',
483 " error_on_missing_key = true", " }"]
484 lines += [" resources {", f" cpu = {task['cpu']}", f" memory = {task['memory']}", " }", " }"]
485 lines += [" }", "}"]
486 return "\n".join(lines) + "\n"
487
488
489def token():
490 if "NOMAD_TOKEN" not in os.environ:
491 os.environ["NOMAD_TOKEN"] = (STATE / "nomad.token").read_text().strip()
492
493
494def get_variable(path):
495 result = subprocess.run(["nomad", "var", "get", "-out=json", path], capture_output=True, text=True)
496 if result.returncode == 0:
497 return json.loads(result.stdout)
498 if "Variable not found" in result.stderr + result.stdout:
499 return None
500 raise RuntimeError(f"Nomad variable read failed for {path}: {result.stderr.strip()}")
501
502
503def provision(data):
504 if not data["containers"]:
505 return
506 if os.geteuid() != 0:
507 raise PermissionError("provisioning requires root")
508 root = Path(data["hostRoot"])
509 if data["hasManagedVolumes"]:
510 root.mkdir(parents=True, exist_ok=True)
511 if command(
512 "findmnt", "-n", "-o", "FSTYPE", "--mountpoint", str(root), capture=True
513 ).stdout.strip() != "zfs":
514 raise ValueError(f"expected ZFS dataset at {root}")
515 for task in data["containers"].values():
516 gid = 0 if task["rootGroup"] else data["uid"]
517 for target, volume in task["volumes"].items():
518 if volume.get("config") is not None or volume.get("src") is not None:
519 continue
520 path = Path(host_path(str(root), target.lstrip("/")))
521 path.mkdir(parents=True, exist_ok=True)
522 os.chown(path, data["uid"], gid)
523 path.chmod(0o750)
524 if data["sourceId"] == "ytdl" and target == "/data":
525 command("systemd-tmpfiles", "--create", "--prefix=" + str(path))
526 bundle = STATE / "ca-bundle.crt"
527 if any(
528 volume.get("src") == str(bundle)
529 for task in data["containers"].values()
530 for volume in task["volumes"].values()
531 ):
532 contents = Path("/etc/ssl/certs/ca-certificates.crt").read_bytes()
533 local_ca = Path("/var/lib/caddy/.local/share/caddy/pki/authorities/local/root.crt")
534 if local_ca.exists():
535 contents += b"\n" + local_ca.read_bytes()
536 if not bundle.exists() or bundle.read_bytes() != contents:
537 pending = bundle.with_suffix(".pending")
538 pending.write_bytes(contents)
539 pending.chmod(0o644)
540 pending.replace(bundle)
541 route_dir = STATE / "routes"
542 route_dir.mkdir(parents=True, exist_ok=True)
543 asset_dir, assets = config_assets(data)
544 static = {}
545 directories = {}
546 identity = {}
547 head_html = {}
548 metrics_paths = {}
549 for task in data["containers"].values():
550 if task.get("http"):
551 http = task["http"]
552 if http["identityHeaders"]:
553 identity[http["hostname"]] = http["identityHeaders"]
554 if http["headHtml"]:
555 head_html[http["hostname"]] = http["headHtml"]
556 if http.get("metricsPath") and http["hostname"]:
557 metrics_paths[http["hostname"]] = http["metricsPath"]
558 for request, rel in http["overrideFiles"].items():
559 origin = assets[rel]
560 target = directories if origin.is_dir() else static
561 target[request] = host_path(str(asset_dir), rel)
562 if assets:
563 asset_dir.parent.mkdir(parents=True, exist_ok=True)
564 asset_dir.parent.chmod(0o755)
565 if assets and not asset_dir.exists():
566 temporary = tempfile.mkdtemp(dir=asset_dir.parent)
567 try:
568 for rel, origin in assets.items():
569 destination = Path(temporary) / rel
570 destination.parent.mkdir(parents=True, exist_ok=True)
571 if origin.is_dir():
572 shutil.copytree(origin, destination)
573 for child in destination.rglob("*"):
574 child.chmod(0o755 if child.is_dir() else 0o644)
575 else:
576 shutil.copy2(origin, destination)
577 destination.chmod(0o644)
578 Path(temporary).chmod(0o755)
579 os.replace(temporary, asset_dir)
580 finally:
581 shutil.rmtree(temporary, ignore_errors=True)
582 secret_dir = STATE / "secrets"
583 secret_dir.mkdir(parents=True, exist_ok=True)
584 secret_file = secret_dir / f"{data['id']}.nv.hcl"
585 generated = data["secrets"]
586 required = data["requiredSecrets"]
587 secret_path = "nomad/jobs/" + data["id"]
588 existing = get_variable(secret_path) if generated or required else None
589 if generated and not existing and secret_file.exists():
590 command("nomad", "var", "put", "-in=hcl", "-out=none", secret_path, "@" + str(secret_file))
591 existing = get_variable(secret_path)
592 values = dict(existing["Items"]) if existing else {}
593 if generated:
594 for item, spec in generated.items():
595 if item not in values:
596 values[item] = secrets.token_hex(spec["bytes"])
597 if not existing or values != existing["Items"]:
598 put_variable(secret_path, values, existing["ModifyIndex"] if existing else 0)
599 backup = "items {\n" + "".join(f" {item} = {q(value)}\n" for item, value in values.items()) + "}\n"
600 if not secret_file.exists() or secret_file.read_text() != backup:
601 write_private(secret_file, backup)
602 if required:
603 missing = [name for name in required if not values.get(name)]
604 if missing:
605 raise ValueError(f"missing required secrets for {data['id']}: {', '.join(missing)}")
606 proof = {}
607 for task in data["containers"].values():
608 http = task.get("http")
609 if http and http.get("identityProofSecret"):
610 name = http["identityProofSecret"]
611 if not http["identityHeaders"] or name not in values:
612 raise ValueError(f"missing identity proof secret for {data['id']}")
613 proof[http["hostname"]] = "X-Studio-Idp-" + values[name]
614 write_private(route_dir / f"{data['id']}.json", json.dumps({
615 "files": static, "dirs": directories, "identity": identity,
616 "identityProof": proof, "headHtml": head_html, "metricsPaths": metrics_paths,
617 }))
618
619
620def submit(data, mode, definitions):
621 if not data["containers"]:
622 return
623 with tempfile.NamedTemporaryFile("w", suffix=".nomad.hcl", delete=False) as file:
624 file.write(render(data, definitions))
625 path = file.name
626 try:
627 command("nomad", "job", mode, path)
628 finally:
629 Path(path).unlink()
630
631
632def build_images(data):
633 for task in data["containers"].values():
634 if task.get("build"):
635 image = task["image"]
636 if subprocess.run(["podman", "image", "exists", image]).returncode:
637 command("podman", "build", "-t", image, str(config_path(data["sourceId"], task["build"])))
638
639
640def clone_dataset(source, snapshot, dataset, mount):
641 acltype = command("zfs", "get", "-H", "-o", "value", "acltype", source, capture=True).stdout.strip()
642 command("zfs", "clone", "-o", "mountpoint=" + mount, "-o", "acltype=" + acltype, snapshot, dataset)
643
644
645def check_http(host, path, tls_internal=False, attempts=120):
646 for attempt in range(attempts):
647 try:
648 if subprocess.run(
649 ["curl", "--noproxy", "*", "-sf", *(["--cacert", "/var/lib/caddy/.local/share/caddy/pki/authorities/local/root.crt"] if tls_internal else []), "--resolve", f"{host}:443:127.0.0.1", f"https://{host}{path}"],
650 capture_output=True, timeout=3,
651 ).returncode == 0:
652 print(f"Healthy {host}")
653 return
654 except subprocess.TimeoutExpired:
655 pass
656 time.sleep(2)
657 raise RuntimeError(f"HTTPS route is unhealthy: {host}")
658
659
660def put_variable(path, items, index=None):
661 with tempfile.NamedTemporaryFile("w", suffix=".nv.hcl", delete=False) as file:
662 file.write("items {\n" + "".join(f" {key} = {q(value)}\n" for key, value in items.items()) + "}\n")
663 filename = file.name
664 try:
665 command("nomad", "var", "put", "-in=hcl", "-out=none", *([f"-check-index={index}"] if index is not None else []), path, "@" + filename)
666 finally:
667 Path(filename).unlink()
668
669
670def configure(data):
671 if not data.get("setup"):
672 return
673 if data["setup"].startswith("tools/"):
674 script = (REPO / data["setup"]).resolve()
675 if not script.is_relative_to(REPO / "tools") or not script.is_file():
676 raise ValueError(f"invalid shared setup script: {data['setup']}")
677 else:
678 script = config_path(data.get("sourceId", data["id"]), data["setup"])
679 routes = [task["http"] for task in data["containers"].values()
680 if task.get("http") and task["http"].get("hostname")]
681 if len(routes) != 1:
682 raise ValueError("service setup requires one HTTP hostname")
683 route = routes[0]
684 check_http(route["hostname"], route["checkPath"], route["tlsInternal"], attempts=600)
685 variable = get_variable("nomad/jobs/" + data["id"])
686 own = variable["Items"] if variable else {}
687 command("python3", str(script), input=json.dumps({
688 "serviceId": data["id"], "host": route["hostname"], "hostRoot": data["hostRoot"],
689 "preview": data["id"] != data.get("sourceId", data["id"]),
690 "ownerEmail": data["ownerEmail"], **own,
691 }))
692 print(f"Configured {data['id']}")
693
694
695def prepare(data):
696 if data.get("prepare"):
697 script = config_path(data.get("sourceId", data["id"]), data["prepare"])
698 command("python3", str(script), input=json.dumps({
699 "hostRoot": data["hostRoot"], "uid": data["uid"],
700 }))
701
702
703def provision_inputs(data, definitions, stage_id=None, postgres_source=None):
704 for alias, request in data["inputs"].items():
705 if not NAME.fullmatch(alias):
706 raise ValueError(f"invalid input alias: {alias}")
707 native = request["provider"] == "snowglobe"
708 provider = {"id": "snowglobe", "provide": True, "containers": {}} if native else definitions[request["provider"]]
709 if not provider.get("provide"):
710 raise ValueError(f"{provider['id']} does not provide inputs")
711 path = f"nomad/jobs/{data['id']}/inputs/{alias}"
712 variable = get_variable(path)
713 own = (get_variable("nomad/jobs/" + provider["id"]) or {}).get("Items", {})
714 http = next((task["http"] for task in provider["containers"].values()
715 if task.get("http") and task["http"].get("hostname")), None)
716 if http:
717 check_http(http["hostname"], http["checkPath"], http["tlsInternal"])
718 payload = {
719 "request": request,
720 "existing": variable["Items"] if variable else None,
721 "providerSecrets": own,
722 "host": http["hostname"] if http else None,
723 }
724 if stage_id:
725 payload["stageId"] = stage_id
726 if postgres_source and provider["id"] == "postgres":
727 payload["sourceContainer"] = postgres_source
728 script = REPO / "tools/oidc-provider.py" if native else config_path(provider["id"], provider["provide"])
729 result = command("python3", str(script), input=json.dumps(payload), capture=True)
730 values = json.loads(result.stdout)
731 if not isinstance(values, dict) or not values or any(
732 not re.fullmatch(r"[A-Za-z_][A-Za-z0-9_]*", key) or not isinstance(value, str) or not value
733 for key, value in values.items()
734 ):
735 raise ValueError(f"invalid outputs from {provider['id']}")
736 if not variable or variable["Items"] != values:
737 put_variable(path, values, variable["ModifyIndex"] if variable else None)
738 print(f"Allocated {data['id']}.{alias} from {provider['id']}")
739
740
741def bootstrap(all_data):
742 if os.geteuid() != 0:
743 raise PermissionError("bootstrap requires root")
744 STATE.mkdir(parents=True, exist_ok=True)
745 if not (STATE / "nomad.token").exists():
746 result = command("nomad", "acl", "bootstrap", "-json", capture=True)
747 write_private(STATE / "nomad.token", json.loads(result.stdout)["SecretID"] + "\n")
748 token()
749 command(
750 "nomad",
751 "acl",
752 "policy",
753 "apply",
754 "studio-router",
755 str(REPO / "config/policies/router.hcl"),
756 )
757 command("nomad", "acl", "policy", "apply", "studio-dashboard",
758 str(REPO / "config/policies/dashboard.hcl"))
759 router_token = STATE / "router.token"
760 if not router_token.exists():
761 result = command(
762 "nomad",
763 "acl",
764 "token",
765 "create",
766 "-policy=studio-router",
767 "-name=studio-router",
768 "-json",
769 capture=True,
770 )
771 write_private(router_token, json.loads(result.stdout)["SecretID"] + "\n")
772 dashboard_token = STATE / "dashboard.token"
773 if not dashboard_token.exists():
774 result = command("nomad", "acl", "token", "create", "-policy=studio-dashboard",
775 "-name=studio-dashboard", "-json", capture=True)
776 write_private(dashboard_token, json.loads(result.stdout)["SecretID"] + "\n")
777 for data in all_data:
778 paths = {
779 f"nomad/jobs/{data['id']}/inputs/{alias}" for alias in data["inputs"]
780 }
781 if paths and data["containers"]:
782 policy = (
783 'namespace "default" {\n variables {\n'
784 + "".join(
785 f' path {q(path)} {{ capabilities = ["read"] }}\n'
786 for path in sorted(paths)
787 )
788 + " }\n}\n"
789 )
790 with tempfile.NamedTemporaryFile("w", delete=False) as file:
791 file.write(policy)
792 path = file.name
793 try:
794 for task_name in data["containers"]:
795 command(
796 "nomad", "acl", "policy", "apply", "-namespace", "default",
797 "-job", data["id"], "-group", "app", "-task", task_name,
798 data["id"] + "-" + task_name + "-imports", path,
799 )
800 finally:
801 Path(path).unlink()
802 if (Path("/opt/studio/current")).is_symlink():
803 command("systemctl", "start", "studio-router.service")
804
805
806def destroy_stage(stage, metadata, definitions):
807 subprocess.run(["nomad", "job", "stop", "-purge", "-yes", stage], check=False)
808 for alias, request in metadata["inputs"].items():
809 native = request["provider"] == "snowglobe"
810 provider = {"id": "snowglobe", "provide": True, "containers": {}} if native else definitions[request["provider"]]
811 own = (get_variable("nomad/jobs/" + provider["id"]) or {}).get("Items", {})
812 variable = get_variable(f"nomad/jobs/{stage}/inputs/{alias}")
813 existing = variable["Items"] if variable else None
814 hosts = [task["http"]["hostname"] for task in provider["containers"].values()
815 if task.get("http") and task["http"].get("hostname")]
816 script = REPO / "tools/oidc-provider.py" if native else config_path(provider["id"], provider["provide"])
817 command("python3", str(script), input=json.dumps({
818 "operation": "delete", "request": request, "stageId": stage,
819 "providerSecrets": own, "host": hosts[0] if hosts else None,
820 "existing": existing,
821 }))
822 datasets = list(metadata.get("external", {}).values())
823 if metadata.get("clone"):
824 datasets.append({"clone": metadata["clone"], "snapshot": metadata.get("snapshot")})
825 for dataset in datasets:
826 for attempt in range(30):
827 if subprocess.run(["zfs", "destroy", dataset["clone"]], capture_output=True).returncode == 0:
828 break
829 time.sleep(1)
830 else:
831 raise RuntimeError("preview dataset is still in use")
832 if dataset.get("snapshot"):
833 command("zfs", "destroy", dataset["snapshot"])
834 if not metadata.get("clone"):
835 shutil.rmtree(metadata["mount"], ignore_errors=True)
836 for alias in metadata["inputs"]:
837 subprocess.run(["nomad", "var", "purge", f"nomad/jobs/{stage}/inputs/{alias}"], check=False)
838 subprocess.run(["nomad", "var", "purge", "nomad/jobs/" + stage], check=False)
839 for task in metadata["tasks"]:
840 subprocess.run(["nomad", "acl", "policy", "delete", stage + "-" + task + "-imports"], check=False)
841 for path in (
842 STATE / "stages" / f"{stage}.json",
843 STATE / "routes" / f"{stage}.json",
844 STATE / "secrets" / f"{stage}.nv.hcl",
845 ):
846 path.unlink(missing_ok=True)
847 shutil.rmtree(ASSETS / stage, ignore_errors=True)
848
849
850def check_pool(data):
851 if os.geteuid() != 0:
852 raise PermissionError("pool setup requires root")
853 clover = subprocess.run(
854 ["findmnt", "-n", "-o", "SOURCE,FSTYPE", "--mountpoint", data[0]["cloverRoot"]],
855 capture_output=True, text=True,
856 )
857 clover_info = clover.stdout.split()
858 if clover.returncode or len(clover_info) != 2 or clover_info[1] != "zfs":
859 raise ValueError(f"clover must be a mounted ZFS dataset: {data[0]['cloverRoot']}")
860 media = data[0]["mediaRoot"]
861 mounted = subprocess.run(
862 ["findmnt", "-n", "-o", "SOURCE,FSTYPE", "--mountpoint", media],
863 capture_output=True, text=True,
864 )
865 media_info = mounted.stdout.split()
866 expected = {"fuse"} if os.environ.get("STUDIO_MEDIA_READ_ONLY") == "true" else {"zfs"}
867 if mounted.returncode or len(media_info) != 2 or media_info[1] not in expected or media_info[0] == clover_info[0]:
868 raise ValueError(f"media must be a separate mounted dataset: {media}")
869 for path, info in ((data[0]["cloverRoot"], clover_info), (media, media_info)):
870 if info[1] == "zfs":
871 acltype = command("zfs", "get", "-H", "-o", "value", "acltype", info[0], capture=True).stdout.strip()
872 if acltype == "nfsv4":
873 raise ValueError(f"{path} uses NFSv4 ACLs, which NixOS cannot enforce. Rehearse a POSIX permission conversion on a ZFS clone before migration.")
874 pool = data[0]["pool"]
875 if subprocess.run(["zpool", "list", pool], capture_output=True).returncode:
876 raise ValueError(f"ZFS pool is unavailable: {pool}")
877 prod = pool + "/prod"
878 acl_source = prod if subprocess.run(["zfs", "list", prod], capture_output=True).returncode == 0 else pool
879 if command("zfs", "get", "-H", "-o", "value", "acltype", acl_source, capture=True).stdout.strip() == "nfsv4":
880 raise ValueError(f"{acl_source} uses NFSv4 ACLs; service datasets need POSIX ACLs on NixOS.")
881 encrypted = any(
882 command("zfs", "get", "-H", "-o", "value", "encryption", info[0], capture=True).stdout.strip() != "off"
883 for info in (clover_info, media_info) if info[1] == "zfs"
884 )
885 if encrypted:
886 root = str(Path(data[0]["hostRoot"]).parent)
887 mounted = subprocess.run(["findmnt", "-n", "-o", "SOURCE", "--mountpoint", root], capture_output=True, text=True)
888 encryption = subprocess.run(["zfs", "get", "-H", "-o", "value", "encryption", prod], capture_output=True, text=True)
889 if encryption.returncode or encryption.stdout.strip() == "off" or mounted.stdout.strip() != prod:
890 raise ValueError(f"Create and mount encrypted {prod} at {root} before deployment; the existing storage is encrypted.")
891
892
893def check_staging_pool(data):
894 check_pool([data])
895 prod = data["pool"] + "/prod"
896 staging = data["pool"] + "/staging"
897 acl_source = staging if subprocess.run(["zfs", "list", staging], capture_output=True).returncode == 0 else data["pool"]
898 if command("zfs", "get", "-H", "-o", "value", "acltype", acl_source, capture=True).stdout.strip() == "nfsv4":
899 raise ValueError(f"{acl_source} uses NFSv4 ACLs; staged datasets need POSIX ACLs on NixOS.")
900 encryption = subprocess.run(["zfs", "get", "-H", "-o", "value", "encryption", prod], capture_output=True, text=True)
901 if encryption.returncode or encryption.stdout.strip() == "off":
902 return
903 mounted = subprocess.run(["findmnt", "-n", "-o", "SOURCE", "--mountpoint", data["stagingRoot"]], capture_output=True, text=True)
904 staging_encryption = subprocess.run(["zfs", "get", "-H", "-o", "value", "encryption", staging], capture_output=True, text=True)
905 if staging_encryption.returncode or staging_encryption.stdout.strip() == "off" or mounted.stdout.strip() != staging:
906 raise ValueError(f"Create and mount encrypted {staging} at {data['stagingRoot']} before staging.")
907
908
909def ensure_pool(data):
910 check_pool(data)
911 STATE.mkdir(parents=True, exist_ok=True)
912 pool = data[0]["pool"]
913 for item in data:
914 if item["hasManagedVolumes"]:
915 dataset = pool + "/prod/" + item["id"]
916 if subprocess.run(["zfs", "list", dataset], capture_output=True).returncode:
917 root = Path(item["hostRoot"])
918 if root.exists() and any(root.iterdir()):
919 raise ValueError(f"refusing to mount over {root}")
920 if subprocess.run(["zfs", "list", pool + "/prod"], capture_output=True).returncode:
921 parent = str(root.parent)
922 if Path(parent).exists() and any(Path(parent).iterdir()):
923 raise ValueError(f"refusing to mount over {parent}")
924 command("zfs", "create", "-o", "mountpoint=" + parent, pool + "/prod")
925 command("zfs", "create", "-o", "mountpoint=" + str(root), dataset)
926
927
928def main():
929 parser = argparse.ArgumentParser()
930 parser.add_argument(
931 "mode",
932 choices=[
933 "render",
934 "secrets",
935 "validate",
936 "check",
937 "bootstrap",
938 "deploy",
939 "preflight",
940 "pool",
941 "allocate",
942 "stage",
943 "destroy",
944 ],
945 )
946 parser.add_argument("name", nargs="?")
947 parser.add_argument("--base-domain")
948 parser.add_argument("--root")
949 parser.add_argument("--pool")
950 parser.add_argument("--media-root")
951 parser.add_argument("--env", action="append", default=[])
952 parser.add_argument("--key", action="append", default=[])
953 args = parser.parse_args()
954 if args.mode == "allocate" and not args.name:
955 parser.error("allocate requires a service name")
956 if args.key and args.mode != "secrets":
957 parser.error("--key is available only for secrets")
958 if args.name and args.mode != "destroy" and args.name not in service_files():
959 raise ValueError(f"unknown service: {args.name}")
960 properties = {
961 key: value
962 for key, value in (("domain", args.base_domain), ("root", args.root), ("pool", args.pool), ("mediaRoot", args.media_root))
963 if value
964 }
965 names = [args.name] if args.name else services()
966 if args.mode == "secrets":
967 if not args.name or not NAME.fullmatch(args.name):
968 parser.error("secrets requires a service name")
969 data = load(args.name, properties)
970 declared = [*data["requiredSecrets"], *data["secrets"]]
971 fields = args.key or declared
972 if not declared or len(set(declared)) != len(declared) or any(not re.fullmatch(r"[A-Za-z_][A-Za-z0-9_]*", field) for field in declared):
973 raise ValueError(f"invalid required secrets for {args.name}")
974 if len(set(fields)) != len(fields) or any(field not in declared for field in fields):
975 raise ValueError(f"unknown or duplicate secret key for {args.name}")
976 values = sys.stdin.read().splitlines()
977 if len(values) != len(fields) or any(not value for value in values):
978 raise ValueError(f"expected {len(fields)} nonempty secret lines for {args.name}")
979 token()
980 path = "nomad/jobs/" + args.name
981 existing = get_variable(path)
982 items = dict(existing["Items"]) if existing else {}
983 items.update(zip(fields, values))
984 put_variable(path, items, existing["ModifyIndex"] if existing else 0)
985 print(f"Imported {len(fields)} secrets for {args.name}")
986 return
987 if args.mode == "destroy":
988 if not args.name or not NAME.fullmatch(args.name):
989 parser.error("destroy requires a stage ID")
990 token()
991 metadata = json.loads((STATE / "stages" / f"{args.name}.json").read_text())
992 names = {metadata["sourceId"]} | {request["provider"] for request in metadata["inputs"].values() if request["provider"] != "snowglobe"}
993 definitions = {name: load(name, properties) for name in names}
994 destroy_stage(args.name, metadata, definitions)
995 return
996 if args.mode == "stage":
997 if not args.name:
998 parser.error("stage requires a service name")
999 token()
1000 data = load(args.name, properties)
1001 check_staging_pool(data)
1002 definitions = {args.name: data}
1003 definitions.update({provider: load(provider, properties) for provider in dependencies(data)})
1004 if not data["containers"]:
1005 raise ValueError(f"service has no container to stage: {args.name}")
1006 stage_dir = STATE / "stages"
1007 previous = []
1008 for path in stage_dir.glob("*.json"):
1009 saved = json.loads(path.read_text())
1010 if saved.get("sourceId") == args.name:
1011 previous.append((path, saved))
1012 if len(previous) > 1:
1013 raise ValueError(f"multiple stages exist for {args.name}; destroy one first")
1014 created = not previous
1015 stage = f"{args.name}-preview-{secrets.token_hex(4)}" if created else previous[0][0].stem
1016 http = [task["http"] for task in data["containers"].values() if task.get("http") and task["http"].get("hostname")]
1017 if len(http) > 1:
1018 raise ValueError("preview requires at most one HTTP route")
1019 original_host = http[0].get("hostname") if http else None
1020 hostname = stage + "." + original_host.split(".", 1)[1] if original_host else None
1021 data = load(args.name, properties, stage)
1022 data["rollout"] = "simple"
1023 data["hostRoot"] = str(Path(data["stagingRoot"]) / stage)
1024 if data["stageIsolation"] == "fresh" and any(
1025 volume.get("src") and not volume["readOnly"]
1026 for task in data["containers"].values()
1027 for volume in task["volumes"].values()
1028 ):
1029 raise ValueError("fresh stages cannot use writable external mounts")
1030 for task in data["containers"].values():
1031 if task.get("tcp") and not task["hostNetwork"]:
1032 for port in task["tcp"]:
1033 port["hostPort"] = None
1034 if hostname:
1035 for task in data["containers"].values():
1036 if task.get("http") and task["http"].get("hostname") == original_host:
1037 task["http"]["hostname"] = hostname
1038 task["http"]["plainHostnames"] = [stage + "-" + host for host in task["http"]["plainHostnames"]]
1039 task["env"] = {key: value.replace(original_host, hostname) for key, value in task["env"].items()}
1040 if task.get("secretFiles"):
1041 task["secretFiles"] = {key: value.replace(original_host, hostname) for key, value in task["secretFiles"].items()}
1042 for request in data["inputs"].values():
1043 if request["provider"] == "snowglobe":
1044 request["redirectUris"] = [uri.replace(original_host, hostname) for uri in request["redirectUris"]]
1045 for assignment in args.env:
1046 key, separator, value = assignment.partition("=")
1047 if not separator or len(data["containers"]) != 1:
1048 parser.error(f"unknown environment override: {key}")
1049 env = next(iter(data["containers"].values()))["env"]
1050 if key not in env:
1051 parser.error(f"unknown environment override: {key}")
1052 env[key] = value
1053 metadata = (
1054 {"mount": data["hostRoot"], "inputs": data["inputs"],
1055 "tasks": list(data["containers"]), "sourceId": args.name,
1056 "stageIsolation": data["stageIsolation"]}
1057 if created else previous[0][1]
1058 )
1059 if not created:
1060 if metadata.get("stageIsolation", "clone") != data["stageIsolation"]:
1061 raise ValueError("stage isolation changed; destroy the stage before recreating it")
1062 if bool(metadata.get("clone")) != data["hasManagedVolumes"]:
1063 raise ValueError("storage layout changed; destroy the stage before recreating it")
1064 for alias, request in data["inputs"].items():
1065 if alias in metadata["inputs"] and metadata["inputs"][alias] != request:
1066 raise ValueError(f"requirement {alias} changed; destroy the stage before recreating it")
1067 if alias not in metadata["inputs"] and request["provider"] == "postgres":
1068 raise ValueError("new database requirement needs a new stage")
1069 metadata["inputs"].update(data["inputs"])
1070 metadata["tasks"] = sorted(set(metadata["tasks"]) | set(data["containers"]))
1071 stage_dir.mkdir(parents=True, exist_ok=True)
1072 postgres_snapshot = None
1073 pending_snapshots = set()
1074 try:
1075 postgres_inputs = created and data["stageIsolation"] == "clone" and any(
1076 request["provider"] == "postgres" and request["kind"] == "database"
1077 for request in data["inputs"].values()
1078 )
1079 snapshots = []
1080 source = None
1081 if created and data["hasManagedVolumes"]:
1082 pool = data["pool"]
1083 source = subprocess.run(
1084 ["findmnt", "-n", "-o", "SOURCE", "--mountpoint", definitions[args.name]["hostRoot"]],
1085 capture_output=True, text=True,
1086 ).stdout.strip()
1087 dataset = pool + "/staging/" + stage
1088 if subprocess.run(["zfs", "list", pool + "/staging"], capture_output=True).returncode:
1089 command("zfs", "create", "-o", "mountpoint=none", pool + "/staging")
1090 if source and data["stageIsolation"] == "clone":
1091 if source.split("/", 1)[0] != pool:
1092 raise ValueError(f"production dataset belongs to another pool: {source}")
1093 snapshot = source + "@" + stage
1094 snapshots.append(snapshot)
1095 if postgres_inputs:
1096 postgres_dataset = dataset_for("postgres")
1097 if not postgres_dataset:
1098 raise ValueError("Postgres needs a ZFS dataset for consistent stages")
1099 postgres_snapshot = postgres_dataset + "@" + stage
1100 snapshots.append(postgres_snapshot)
1101 external = {}
1102 for task in data["containers"].values():
1103 for volume in task["volumes"].values():
1104 if volume.get("src") and not volume["readOnly"]:
1105 external.setdefault(volume["src"], []).append(volume)
1106 external_mounts = {}
1107 for external_source in external:
1108 path = Path(external_source).resolve(strict=True)
1109 mount = json.loads(command(
1110 "findmnt", "--json", "-o", "SOURCE,TARGET,FSTYPE,OPTIONS", "--target", str(path), capture=True,
1111 ).stdout)["filesystems"][0]
1112 if "ro" not in mount["options"].split(",") and mount["fstype"] != "zfs":
1113 raise ValueError(f"writable external mount is not ZFS: {external_source}")
1114 external_mounts[external_source] = (path, mount)
1115 if created and mount["fstype"] == "zfs" and "ro" not in mount["options"].split(","):
1116 target = mount["source"] + "@" + stage
1117 if target not in snapshots:
1118 snapshots.append(target)
1119 if snapshots:
1120 if len({target.split("/", 1)[0] for target in snapshots}) != 1:
1121 raise ValueError("staged datasets must belong to one ZFS pool")
1122 command("zfs", "snapshot", *snapshots)
1123 pending_snapshots.update(snapshots)
1124 if created and data["hasManagedVolumes"]:
1125 if source and data["stageIsolation"] == "clone":
1126 try:
1127 clone_dataset(source, snapshot, dataset, data["hostRoot"])
1128 except Exception:
1129 command("zfs", "destroy", snapshot)
1130 pending_snapshots.remove(snapshot)
1131 raise
1132 metadata["snapshot"] = snapshot
1133 pending_snapshots.remove(snapshot)
1134 else:
1135 command("zfs", "create", "-o", "mountpoint=" + data["hostRoot"], dataset)
1136 metadata["clone"] = dataset
1137 bindings = {}
1138 for source, volumes in sorted(external.items()):
1139 path, mount = external_mounts[source]
1140 if "ro" in mount["options"].split(","):
1141 binding = {"src": source, "readOnly": True}
1142 elif mount["fstype"] == "zfs":
1143 dataset = mount["source"]
1144 if metadata.get("snapshot") == dataset + "@" + stage:
1145 clone_mount = data["hostRoot"]
1146 else:
1147 staged = metadata.setdefault("external", {})
1148 if dataset not in staged:
1149 if not created:
1150 raise ValueError("external storage changed; destroy the stage before recreating it")
1151 suffix = hashlib.sha256(dataset.encode()).hexdigest()[:8]
1152 pool = dataset.split("/", 1)[0]
1153 clone = pool + "/staging/" + stage + "-external-" + suffix
1154 clone_mount = str(Path(data["stagingRoot"]) / (stage + "-external-" + suffix))
1155 snapshot = dataset + "@" + stage
1156 if subprocess.run(["zfs", "list", pool + "/staging"], capture_output=True).returncode:
1157 command("zfs", "create", "-o", "mountpoint=none", pool + "/staging")
1158 try:
1159 clone_dataset(dataset, snapshot, clone, clone_mount)
1160 except Exception:
1161 command("zfs", "destroy", snapshot)
1162 pending_snapshots.remove(snapshot)
1163 raise
1164 staged[dataset] = {"clone": clone, "snapshot": snapshot, "mount": clone_mount}
1165 pending_snapshots.remove(snapshot)
1166 clone_mount = staged[dataset]["mount"]
1167 relative = path.relative_to(Path(mount["target"]).resolve())
1168 binding = {"src": str(Path(clone_mount) / relative), "readOnly": False}
1169 else:
1170 raise ValueError(f"writable external mount is not ZFS: {source}")
1171 bindings[source] = binding
1172 for volume in volumes:
1173 if path.is_relative_to(Path(data["cloverRoot"]).resolve()):
1174 volume["clover"] = True
1175 volume.update(binding)
1176 if not created and bindings != metadata.get("externalSources", {}):
1177 raise ValueError("external storage changed; destroy the stage before recreating it")
1178 metadata["externalSources"] = bindings
1179 if REPO.parent == Path("/opt/studio/releases"):
1180 metadata["release"] = REPO.name
1181 metadata["ready"] = False
1182 write_private(stage_dir / f"{stage}.json", json.dumps(metadata))
1183 bootstrap([data])
1184 if created and data["stageIsolation"] == "clone" and (data["secrets"] or data["requiredSecrets"]):
1185 source = get_variable("nomad/jobs/" + args.name)
1186 if source:
1187 put_variable("nomad/jobs/" + stage, source["Items"], 0)
1188 if postgres_snapshot:
1189 postgres_clone = postgres_dataset.rsplit("/prod/", 1)[0] + "/staging/" + stage + "-postgres"
1190 postgres_mount = Path(data["stagingRoot"]) / (stage + "-postgres")
1191 source_context = cloned_postgres(postgres_snapshot, postgres_clone, postgres_mount)
1192 else:
1193 source_context = nullcontext(None)
1194 with source_context as postgres_source:
1195 provision_inputs(data, definitions, stage, postgres_source)
1196 provision(data)
1197 prepare(data)
1198 build_images(data)
1199 submit(data, "run", definitions)
1200 except Exception:
1201 if created:
1202 destroy_stage(stage, metadata, definitions)
1203 raise
1204 finally:
1205 for snapshot in sorted(pending_snapshots):
1206 command("zfs", "destroy", snapshot)
1207 if hostname:
1208 check_http(hostname, http[0]["checkPath"], http[0]["tlsInternal"])
1209 configure(data)
1210 if REPO.parent == Path("/opt/studio/releases"):
1211 metadata["ready"] = True
1212 metadata["overrides"] = [assignment.partition("=")[0] for assignment in args.env]
1213 write_private(stage_dir / f"{stage}.json", json.dumps(metadata))
1214 print(f"stage={stage}\nrelease={metadata.get('release', '')}\nhost={hostname}\ndataset={metadata.get('clone', '')}")
1215 return
1216 definitions = {name: load(name, properties) for name in services()}
1217 if args.name and args.name not in definitions:
1218 raise ValueError(f"unknown service: {args.name}")
1219 if not args.name and args.mode == "deploy":
1220 names = [name for name in names if definitions[name]["containers"]]
1221 selected = set(names)
1222 while True:
1223 required = selected | set().union(*(dependencies(definitions[name]) for name in selected))
1224 missing = required - definitions.keys()
1225 if missing:
1226 raise ValueError(f"unknown dependency: {sorted(missing)}")
1227 if required == selected:
1228 break
1229 selected = required
1230 data = ordered([definitions[name] for name in sorted(selected)])
1231 if args.mode == "render":
1232 for item in data:
1233 if item["containers"]:
1234 print(render(item, definitions))
1235 elif args.mode == "validate":
1236 token()
1237 for item in data:
1238 submit(item, "validate", definitions)
1239 elif args.mode == "check":
1240 for item in data:
1241 for task in item["containers"].values():
1242 if task.get("http") and task["http"].get("hostname"):
1243 check_http(task["http"]["hostname"], task["http"]["checkPath"], task["http"]["tlsInternal"])
1244 elif args.mode == "preflight":
1245 check_pool(data)
1246 token()
1247 missing_secrets = {}
1248 for item in data:
1249 if item["containers"] and item["requiredSecrets"]:
1250 variable = get_variable("nomad/jobs/" + item["id"])
1251 values = variable["Items"] if variable else {}
1252 missing = [name for name in item["requiredSecrets"] if not values.get(name)]
1253 if missing:
1254 missing_secrets[item["id"]] = missing
1255 if missing_secrets:
1256 raise ValueError("missing required secrets: " + "; ".join(
1257 f"{name}: {', '.join(keys)}" for name, keys in missing_secrets.items()))
1258 elif args.mode == "pool":
1259 ensure_pool(data)
1260 elif args.mode == "allocate":
1261 ensure_pool(data)
1262 bootstrap(data)
1263 for item in data:
1264 provision_inputs(item, definitions)
1265 provision(item)
1266 prepare(item)
1267 build_images(item)
1268 elif args.mode == "bootstrap":
1269 bootstrap(data)
1270 elif args.mode == "deploy":
1271 bootstrap(data)
1272 for item in data:
1273 provision_inputs(item, definitions)
1274 provision(item)
1275 prepare(item)
1276 build_images(item)
1277 submit(item, "run", definitions)
1278 configure(item)
1279
1280
1281if __name__ == "__main__":
1282 try:
1283 main()
1284 except (OSError, RuntimeError, ValueError, subprocess.CalledProcessError) as error:
1285 print(error, file=sys.stderr)
1286 sys.exit(1)
tools/tree-hash.py deleted-48
...@@ -1,48 +0,0 @@
1#!/usr/bin/env python3
2import hashlib
3import json
4import os
5from pathlib import Path
6import stat
7import sys
8
9
10root = Path(sys.argv[1]).resolve(strict=True)
11if not root.is_dir():
12 raise ValueError("Expected a directory")
13digest = hashlib.sha256()
14files = 0
15size = 0
16
17
18def fail(error):
19 raise error
20
21
22for directory, children, names in os.walk(root, followlinks=False, onerror=fail):
23 children.sort()
24 for name in sorted([*children, *names]):
25 entry = Path(directory) / name
26 relative = os.fsencode(entry.relative_to(root))
27 mode = entry.lstat().st_mode
28 if stat.S_ISDIR(mode):
29 kind = b"d"
30 elif stat.S_ISLNK(mode):
31 kind = b"l"
32 elif stat.S_ISREG(mode):
33 kind = b"f"
34 else:
35 raise ValueError(f"Unsupported file type: {entry}")
36 digest.update(kind + len(relative).to_bytes(8, "big") + relative)
37 if kind == b"l":
38 target = os.fsencode(os.readlink(entry))
39 digest.update(len(target).to_bytes(8, "big") + target)
40 elif kind == b"f":
41 files += 1
42 length = entry.stat().st_size
43 size += length
44 digest.update(length.to_bytes(8, "big"))
45 with entry.open("rb") as source:
46 for chunk in iter(lambda: source.read(1024 * 1024), b""):
47 digest.update(chunk)
48print(json.dumps({"sha256": digest.hexdigest(), "files": files, "bytes": size}))
tools/verify-legacy-dump.py deleted-37
...@@ -1,37 +0,0 @@
1#!/usr/bin/env python3
2import hashlib
3import json
4from pathlib import Path
5import re
6import sys
7
8
9folder = Path(sys.argv[1])
10if not folder.is_dir():
11 raise SystemExit("Legacy handoff directory is unavailable")
12folder = folder.resolve(strict=True)
13database = sys.argv[2]
14if folder.parent != Path("/mnt/storage1/apps/studio-handoff") or not re.fullmatch(r"\d{8}T\d{6}Z-[0-9a-f]{6}", folder.name):
15 raise ValueError("Unexpected legacy handoff directory")
16if database not in {"evil-forgejo", "evil-hedgedoc"}:
17 raise ValueError("Unexpected legacy database")
18manifest = json.loads((folder / "manifest.json").read_text())
19if manifest["id"] != folder.name:
20 raise ValueError("Legacy handoff ID changed")
21entry = manifest["databases"][database]
22if entry["file"] != database + ".dump":
23 raise ValueError("Legacy dump filename changed")
24dump = folder / entry["file"]
25digest = hashlib.sha256()
26with dump.open("rb") as file:
27 for chunk in iter(lambda: file.read(1024 * 1024), b""):
28 digest.update(chunk)
29if dump.stat().st_size != entry["bytes"] or digest.hexdigest() != entry["sha256"]:
30 raise ValueError("Legacy dump checksum mismatch")
31if len(entry["counts"]) != (4 if database == "evil-hedgedoc" else 2) or any(not isinstance(value, int) or value < 0 for value in entry["counts"]):
32 raise ValueError("Legacy database counts are invalid")
33if database == "evil-forgejo":
34 keys = {"lfs_jwt", "oauth_jwt", "security_key", "internal_token", "anubis_key", "mailer_address", "mailer_username", "mailer_password"}
35 if set(entry["secretSha256"]) != keys or any(not re.fullmatch(r"[0-9a-f]{64}", value) for value in entry["secretSha256"].values()):
36 raise ValueError("Legacy Forgejo secret fingerprints are invalid")
37print(json.dumps(entry))
tools/vm-screen-test.py+1-1
...@@ -48,7 +48,7 @@ class LifecycleTests(unittest.IsolatedAsyncioTestCase):...@@ -48,7 +48,7 @@ class LifecycleTests(unittest.IsolatedAsyncioTestCase):
48 with tempfile.TemporaryDirectory() as directory:48 with tempfile.TemporaryDirectory() as directory:
49 socket = str(Path(directory) / "screen.sock")49 socket = str(Path(directory) / "screen.sock")
50 process = await asyncio.create_subprocess_exec(sys.executable, str(Path(__file__).with_name("vm-screen.py")),50 process = await asyncio.create_subprocess_exec(sys.executable, str(Path(__file__).with_name("vm-screen.py")),
51 env={**os.environ, "STUDIO_VM_SCREEN_SOCKET": socket})51 env={**os.environ, "SNOWGLOBE_VM_SCREEN_SOCKET": socket})
52 writers = []52 writers = []
53 try:53 try:
54 async with asyncio.timeout(5):54 async with asyncio.timeout(5):
tools/vm-screen.py+5-5
...@@ -24,9 +24,9 @@ from gi.repository import GLib, Gst, GstRtp, GstSdp, GstWebRTC...@@ -24,9 +24,9 @@ from gi.repository import GLib, Gst, GstRtp, GstSdp, GstWebRTC
2424
2525
26MAX_PIXELS = 3840 * 216026MAX_PIXELS = 3840 * 2160
27STUN = os.environ.get("STUDIO_VM_STUN_SERVER", "stun://stun.cloudflare.com:3478")27STUN = os.environ.get("SNOWGLOBE_VM_STUN_SERVER", "stun://stun.cloudflare.com:3478")
28SLOTS = asyncio.Semaphore(4)28SLOTS = asyncio.Semaphore(4)
29GUEST_PROTOCOL = json.loads(Path(os.environ.get("STUDIO_VM_GUEST_PROTOCOL", Path(__file__).resolve().parent.parent / "guest/protocol.json")).read_text())29GUEST_PROTOCOL = json.loads(Path(os.environ.get("SNOWGLOBE_VM_GUEST_PROTOCOL", Path(__file__).resolve().parent.parent / "guest/protocol.json")).read_text())
30GUESTS = {}30GUESTS = {}
31TWCC = "http://www.ietf.org/id/draft-holmer-rmcat-transport-wide-cc-extensions-01"31TWCC = "http://www.ietf.org/id/draft-holmer-rmcat-transport-wide-cc-extensions-01"
3232
...@@ -312,7 +312,7 @@ class GuestDesktop:...@@ -312,7 +312,7 @@ class GuestDesktop:
312 writer = None312 writer = None
313 try:313 try:
314 reader, writer = await asyncio.wait_for(asyncio.open_unix_connection(314 reader, writer = await asyncio.wait_for(asyncio.open_unix_connection(
315 os.environ.get("STUDIO_HOST_SOCKET", "/run/studio-host/host.sock")), 10)315 os.environ.get("SNOWGLOBE_HOST_SOCKET", "/run/snowglobe-host/host.sock")), 10)
316 peer = writer.get_extra_info("socket")316 peer = writer.get_extra_info("socket")
317 if struct.unpack("3i", peer.getsockopt(socket.SOL_SOCKET, socket.SO_PEERCRED, 12))[1] != 0:317 if struct.unpack("3i", peer.getsockopt(socket.SOL_SOCKET, socket.SO_PEERCRED, 12))[1] != 0:
318 raise ValueError("Untrusted guest display broker")318 raise ValueError("Untrusted guest display broker")
...@@ -801,7 +801,7 @@ async def serve(reader, writer):...@@ -801,7 +801,7 @@ async def serve(reader, writer):
801 if not isinstance(name, str) or not name or len(name) > 63:801 if not isinstance(name, str) or not name or len(name) > 63:
802 raise ValueError("Choose a VM from the list.")802 raise ValueError("Choose a VM from the list.")
803 host_reader, host_writer = await asyncio.wait_for(asyncio.open_unix_connection(803 host_reader, host_writer = await asyncio.wait_for(asyncio.open_unix_connection(
804 os.environ.get("STUDIO_HOST_SOCKET", "/run/studio-host/host.sock")), 10)804 os.environ.get("SNOWGLOBE_HOST_SOCKET", "/run/snowglobe-host/host.sock")), 10)
805 desktop = Desktop(host_reader, host_writer, lambda message: screen.send(message) if message["type"] != "cursor" or screen.source is desktop else None)805 desktop = Desktop(host_reader, host_writer, lambda message: screen.send(message) if message["type"] != "cursor" or screen.source is desktop else None)
806 host_peer = host_writer.get_extra_info("socket")806 host_peer = host_writer.get_extra_info("socket")
807 if struct.unpack("3i", host_peer.getsockopt(socket.SOL_SOCKET, socket.SO_PEERCRED, 12))[1] != 0:807 if struct.unpack("3i", host_peer.getsockopt(socket.SOL_SOCKET, socket.SO_PEERCRED, 12))[1] != 0:
...@@ -896,7 +896,7 @@ async def main():...@@ -896,7 +896,7 @@ async def main():
896 task = asyncio.create_task(serve(reader, writer))896 task = asyncio.create_task(serve(reader, writer))
897 clients.add(task)897 clients.add(task)
898 task.add_done_callback(clients.discard)898 task.add_done_callback(clients.discard)
899 path = Path(os.environ.get("STUDIO_VM_SCREEN_SOCKET", "/run/studio-vm-screen/screen.sock"))899 path = Path(os.environ.get("SNOWGLOBE_VM_SCREEN_SOCKET", "/run/snowglobe-vm-screen/screen.sock"))
900 path.unlink(missing_ok=True)900 path.unlink(missing_ok=True)
901 server = await asyncio.start_unix_server(connected, path=str(path), limit=131072)901 server = await asyncio.start_unix_server(connected, path=str(path), limit=131072)
902 path.chmod(0o600)902 path.chmod(0o600)
tools/vms.py+22-20
...@@ -1,5 +1,6 @@...@@ -1,5 +1,6 @@
1#!/usr/bin/env python31#!/usr/bin/env python3
2import json2import json
3from importlib import import_module
3import os4import os
4from pathlib import Path5from pathlib import Path
5import re6import re
...@@ -15,10 +16,11 @@ import xml.etree.ElementTree as ET...@@ -15,10 +16,11 @@ import xml.etree.ElementTree as ET
1516
1617
17DISKS = Path("/srv/vm")18DISKS = Path("/srv/vm")
18IMAGES = Path(os.environ.get("STUDIO_VM_IMAGES_ROOT", "/srv/clover/Media/vm"))19IMAGES = Path(os.environ.get("SNOWGLOBE_VM_IMAGES_ROOT", "/srv/clover/Media/vm"))
19PRESETS = Path(os.environ.get("STUDIO_VM_PRESETS_ROOT", str(IMAGES / "Presets")))20PRESETS = Path(os.environ.get("SNOWGLOBE_VM_PRESETS_ROOT", str(IMAGES / "Presets")))
20UPLOADS = Path(os.environ.get("STUDIO_VM_UPLOADS_ROOT", str(IMAGES / "Install Disks")))21UPLOADS = Path(os.environ.get("SNOWGLOBE_VM_UPLOADS_ROOT", str(IMAGES / "Install Disks")))
21NS = "{https://paperclover.net/studio}"22transition = import_module("namespace-transition")
23NS = "{https://paperclover.net/snowglobe}"
22NAME = re.compile(r"[a-z0-9][a-z0-9-]{0,62}\Z")24NAME = re.compile(r"[a-z0-9][a-z0-9-]{0,62}\Z")
23GUEST_CHANNEL = json.loads((Path(__file__).resolve().parent.parent / "guest/protocol.json").read_text())["channel"]25GUEST_CHANNEL = json.loads((Path(__file__).resolve().parent.parent / "guest/protocol.json").read_text())["channel"]
24PROFILES = {26PROFILES = {
...@@ -237,7 +239,7 @@ def domains():...@@ -237,7 +239,7 @@ def domains():
237 for name in virsh("list", "--all", "--name").splitlines():239 for name in virsh("list", "--all", "--name").splitlines():
238 if not name:240 if not name:
239 continue241 continue
240 root = ET.fromstring(virsh("dumpxml", name))242 root = transition.normalize_vm(ET.fromstring(virsh("dumpxml", name)))
241 state_line = virsh("domstate", name, "--reason").splitlines()[0].lower()243 state_line = virsh("domstate", name, "--reason").splitlines()[0].lower()
242 state = next((value for value in ("running", "blocked", "paused", "shutdown", "crashed", "pmsuspended") if state_line.startswith(value)), "shutoff")244 state = next((value for value in ("running", "blocked", "paused", "shutdown", "crashed", "pmsuspended") if state_line.startswith(value)), "shutoff")
243 reason = state_line.split("(", 1)[1].rstrip(")") if state in {"paused", "crashed"} and "(" in state_line else None245 reason = state_line.split("(", 1)[1].rstrip(")") if state in {"paused", "crashed"} and "(" in state_line else None
...@@ -246,7 +248,7 @@ def domains():...@@ -246,7 +248,7 @@ def domains():
246 disks = []248 disks = []
247 media = []249 media = []
248 for element in root.findall("./devices/disk"):250 for element in root.findall("./devices/disk"):
249 if element.findtext("serial") == "studio-cloud-init":251 if element.findtext("serial") == "snowglobe-cloud-init":
250 continue252 continue
251 source = element.find("source")253 source = element.find("source")
252 target = element.find("target")254 target = element.find("target")
...@@ -456,7 +458,7 @@ def managed_directory(path):...@@ -456,7 +458,7 @@ def managed_directory(path):
456458
457def change_media(spec):459def change_media(spec):
458 name = spec["name"]460 name = spec["name"]
459 root = ET.fromstring(virsh("dumpxml", name, "--inactive"))461 root = transition.normalize_vm(ET.fromstring(virsh("dumpxml", name, "--inactive")))
460 drives = root.findall("./devices/disk[@device='cdrom']")462 drives = root.findall("./devices/disk[@device='cdrom']")
461 source = resolve_image(spec["image"]) if spec["image"] else None463 source = resolve_image(spec["image"]) if spec["image"] else None
462 details = profile(inferred_profile(root))464 details = profile(inferred_profile(root))
...@@ -511,7 +513,7 @@ def save_preset(spec):...@@ -511,7 +513,7 @@ def save_preset(spec):
511 name = spec["name"]513 name = spec["name"]
512 if virsh("domstate", name).strip() != "shut off":514 if virsh("domstate", name).strip() != "shut off":
513 raise ValueError("Shut down this VM before saving a preset.")515 raise ValueError("Shut down this VM before saving a preset.")
514 root = ET.fromstring(virsh("dumpxml", name, "--inactive"))516 root = transition.normalize_vm(ET.fromstring(virsh("dumpxml", name, "--inactive")))
515 if root.findtext(f"metadata/{NS}vm/{NS}platform") == "macos":517 if root.findtext(f"metadata/{NS}vm/{NS}platform") == "macos":
516 raise ValueError("Use a prepared OS X preset from the OS library.")518 raise ValueError("Use a prepared OS X preset from the OS library.")
517 if root.findtext(f"metadata/{NS}vm/{NS}setup") in {"windows-v2", "windows-v3"} and spec.get("setup") != "windows-v3":519 if root.findtext(f"metadata/{NS}vm/{NS}setup") in {"windows-v2", "windows-v3"} and spec.get("setup") != "windows-v3":
...@@ -575,7 +577,7 @@ def save_preset(spec):...@@ -575,7 +577,7 @@ def save_preset(spec):
575577
576578
577def console_target(name):579def console_target(name):
578 root = ET.fromstring(virsh("dumpxml", name))580 root = transition.normalize_vm(ET.fromstring(virsh("dumpxml", name)))
579 graphics = root.find("./devices/graphics[@type='vnc']")581 graphics = root.find("./devices/graphics[@type='vnc']")
580 if virsh("domstate", name).strip() not in {"running", "paused", "blocked"} or graphics is None:582 if virsh("domstate", name).strip() not in {"running", "paused", "blocked"} or graphics is None:
581 raise ValueError("Start this VM before opening its screen.")583 raise ValueError("Start this VM before opening its screen.")
...@@ -590,8 +592,8 @@ def console_target(name):...@@ -590,8 +592,8 @@ def console_target(name):
590592
591def secure_firmware(arch):593def secure_firmware(arch):
592 firmware = "AAVMF" if arch == "aarch64" else "OVMF"594 firmware = "AAVMF" if arch == "aarch64" else "OVMF"
593 code = Path(os.environ.get(f"STUDIO_VM_SECURE_{firmware}_CODE", ""))595 code = Path(os.environ.get(f"SNOWGLOBE_VM_SECURE_{firmware}_CODE", ""))
594 variables = Path(os.environ.get(f"STUDIO_VM_SECURE_{firmware}_VARS", ""))596 variables = Path(os.environ.get(f"SNOWGLOBE_VM_SECURE_{firmware}_VARS", ""))
595 if not code.is_absolute() or not variables.is_absolute():597 if not code.is_absolute() or not variables.is_absolute():
596 raise ValueError("Secure UEFI firmware is unavailable on this host.")598 raise ValueError("Secure UEFI firmware is unavailable on this host.")
597 try:599 try:
...@@ -764,7 +766,7 @@ def create(spec):...@@ -764,7 +766,7 @@ def create(spec):
764 elif not overlay:766 elif not overlay:
765 command("qemu-img", "create", "-f", "qcow2", str(drive), str(spec["disk"]))767 command("qemu-img", "create", "-f", "qcow2", str(drive), str(spec["disk"]))
766 virsh("pool-refresh", "vms")768 virsh("pool-refresh", "vms")
767 domain_type = "qemu" if details_profile.get("emulated") or os.environ.get("STUDIO_VM_ACCEL") == "qemu" else "kvm"769 domain_type = "qemu" if details_profile.get("emulated") or os.environ.get("SNOWGLOBE_VM_ACCEL") == "qemu" else "kvm"
768 root = ET.Element("domain", type=domain_type)770 root = ET.Element("domain", type=domain_type)
769 ET.SubElement(root, "name").text = name771 ET.SubElement(root, "name").text = name
770 ET.SubElement(root, "description").text = spec["description"]772 ET.SubElement(root, "description").text = spec["description"]
...@@ -836,7 +838,7 @@ def create(spec):...@@ -836,7 +838,7 @@ def create(spec):
836 devices = ET.SubElement(root, "devices")838 devices = ET.SubElement(root, "devices")
837 emulator = f"/run/current-system/sw/bin/qemu-system-{details_profile['arch']}"839 emulator = f"/run/current-system/sw/bin/qemu-system-{details_profile['arch']}"
838 if profile_name == "windows-aarch64-nvme":840 if profile_name == "windows-aarch64-nvme":
839 emulator = os.environ.get("STUDIO_VM_WINDOWS_ARM_EMULATOR", "")841 emulator = os.environ.get("SNOWGLOBE_VM_WINDOWS_ARM_EMULATOR", "")
840 if not Path(emulator).is_absolute():842 if not Path(emulator).is_absolute():
841 raise ValueError("Windows ARM is unavailable on this host. Choose another OS.")843 raise ValueError("Windows ARM is unavailable on this host. Choose another OS.")
842 ET.SubElement(devices, "emulator").text = emulator844 ET.SubElement(devices, "emulator").text = emulator
...@@ -860,7 +862,7 @@ def create(spec):...@@ -860,7 +862,7 @@ def create(spec):
860 ET.SubElement(seed, "driver", name="qemu", type="raw")862 ET.SubElement(seed, "driver", name="qemu", type="raw")
861 ET.SubElement(seed, "source", file=str(directory / "seed.iso"))863 ET.SubElement(seed, "source", file=str(directory / "seed.iso"))
862 ET.SubElement(seed, "target", dev=details_profile["seed"][0], bus=details_profile["seed"][1])864 ET.SubElement(seed, "target", dev=details_profile["seed"][0], bus=details_profile["seed"][1])
863 ET.SubElement(seed, "serial").text = "studio-cloud-init"865 ET.SubElement(seed, "serial").text = "snowglobe-cloud-init"
864 ET.SubElement(seed, "readonly")866 ET.SubElement(seed, "readonly")
865 if preset and spec["platform"] == "windows":867 if preset and spec["platform"] == "windows":
866 windows_seed(directory, spec["username"])868 windows_seed(directory, spec["username"])
...@@ -946,14 +948,14 @@ def main():...@@ -946,14 +948,14 @@ def main():
946 fields = Path(f"/proc/{pid}/stat").read_text().rsplit(") ", 1)[1].split()948 fields = Path(f"/proc/{pid}/stat").read_text().rsplit(") ", 1)[1].split()
947 resident = int(Path(f"/proc/{pid}/statm").read_text().split()[1]) * os.sysconf("SC_PAGE_SIZE")949 resident = int(Path(f"/proc/{pid}/statm").read_text().split()[1]) * os.sysconf("SC_PAGE_SIZE")
948 result[name] = {"cpu": (int(fields[11]) + int(fields[12])) / os.sysconf("SC_CLK_TCK"), "memory": resident,950 result[name] = {"cpu": (int(fields[11]) + int(fields[12])) / os.sysconf("SC_CLK_TCK"), "memory": resident,
949 "vcpus": int(ET.fromstring(virsh("dumpxml", name)).findtext("vcpu", "1"))}951 "vcpus": int(transition.normalize_vm(ET.fromstring(virsh("dumpxml", name))).findtext("vcpu", "1"))}
950 return result952 return result
951 if action == "library":953 if action == "library":
952 return library()954 return library()
953 if action == "console":955 if action == "console":
954 return console_target(payload["name"])956 return console_target(payload["name"])
955 if action == "guest":957 if action == "guest":
956 root = ET.fromstring(virsh("dumpxml", payload["name"]))958 root = transition.normalize_vm(ET.fromstring(virsh("dumpxml", payload["name"])))
957 source = root.find(f"./devices/channel[@type='unix']/target[@name='{GUEST_CHANNEL}']/../source")959 source = root.find(f"./devices/channel[@type='unix']/target[@name='{GUEST_CHANNEL}']/../source")
958 expected = f"/run/libvirt/qemu/channel/{root.get('id')}-{payload['name'][:20]}/{GUEST_CHANNEL}"960 expected = f"/run/libvirt/qemu/channel/{root.get('id')}-{payload['name'][:20]}/{GUEST_CHANNEL}"
959 if virsh("domstate", payload["name"]).strip() != "running" or source is None or source.get("mode") != "bind" or source.get("path") != expected:961 if virsh("domstate", payload["name"]).strip() != "running" or source is None or source.get("mode") != "bind" or source.get("path") != expected:
...@@ -962,7 +964,7 @@ def main():...@@ -962,7 +964,7 @@ def main():
962 if action == "serial":964 if action == "serial":
963 if virsh("domstate", payload["name"]).strip() not in {"running", "blocked"}:965 if virsh("domstate", payload["name"]).strip() not in {"running", "blocked"}:
964 raise ValueError("Start this VM before opening its console.")966 raise ValueError("Start this VM before opening its console.")
965 root = ET.fromstring(virsh("dumpxml", payload["name"]))967 root = transition.normalize_vm(ET.fromstring(virsh("dumpxml", payload["name"])))
966 console = root.find("./devices/console[@type='pty']")968 console = root.find("./devices/console[@type='pty']")
967 source = console.find("source") if console is not None else None969 source = console.find("source") if console is not None else None
968 target = console.find("target") if console is not None else None970 target = console.find("target") if console is not None else None
...@@ -971,7 +973,7 @@ def main():...@@ -971,7 +973,7 @@ def main():
971 raise ValueError("This VM has no serial console. Add one in its hardware settings.")973 raise ValueError("This VM has no serial console. Add one in its hardware settings.")
972 return {"path": path}974 return {"path": path}
973 if action == "owner":975 if action == "owner":
974 return ET.fromstring(virsh("dumpxml", payload["name"])).findtext(f"metadata/{NS}vm/{NS}owner")976 return transition.normalize_vm(ET.fromstring(virsh("dumpxml", payload["name"]))).findtext(f"metadata/{NS}vm/{NS}owner")
975 if action == "access":977 if action == "access":
976 try:978 try:
977 with os.fdopen(open_regular(DISKS / payload["name"] / "access.json")) as incoming:979 with os.fdopen(open_regular(DISKS / payload["name"] / "access.json")) as incoming:
...@@ -988,7 +990,7 @@ def main():...@@ -988,7 +990,7 @@ def main():
988 name = payload["name"]990 name = payload["name"]
989 ensure_name(name)991 ensure_name(name)
990 if payload["action"] == "start":992 if payload["action"] == "start":
991 root = ET.fromstring(virsh("dumpxml", name, "--inactive"))993 root = transition.normalize_vm(ET.fromstring(virsh("dumpxml", name, "--inactive")))
992 if root.find("./devices/interface/source[@network='default']") is not None:994 if root.find("./devices/interface/source[@network='default']") is not None:
993 ensure_network()995 ensure_network()
994 virsh({"start": "start", "shutdown": "shutdown", "reboot": "reboot", "destroy": "destroy", "resume": "resume"}[payload["action"]], name)996 virsh({"start": "start", "shutdown": "shutdown", "reboot": "reboot", "destroy": "destroy", "resume": "resume"}[payload["action"]], name)
...@@ -1009,7 +1011,7 @@ def main():...@@ -1009,7 +1011,7 @@ def main():
1009 raise ValueError("VM does not exist")1011 raise ValueError("VM does not exist")
1010 if virsh("domstate", name).strip() != "shut off":1012 if virsh("domstate", name).strip() != "shut off":
1011 virsh("destroy", name)1013 virsh("destroy", name)
1012 root = ET.fromstring(virsh("dumpxml", name))1014 root = transition.normalize_vm(ET.fromstring(virsh("dumpxml", name)))
1013 virsh("undefine", name, *(["--nvram"] if root.find("./os/nvram") is not None else []), *(["--tpm"] if root.find("./devices/tpm") is not None else []))1015 virsh("undefine", name, *(["--nvram"] if root.find("./os/nvram") is not None else []), *(["--tpm"] if root.find("./devices/tpm") is not None else []))
1014 directory = DISKS / name1016 directory = DISKS / name
1015 if payload["disks"] and directory.is_dir():1017 if payload["disks"] and directory.is_dir():
tools/xmpp.md+13-44
...@@ -20,62 +20,31 @@ these host ports; stop its Nomad job before launching another on the same host....@@ -20,62 +20,31 @@ these host ports; stop its Nomad job before launching another on the same host.
20`setup.py` installs a transient firewall service tagged with the preview ID. It20`setup.py` installs a transient firewall service tagged with the preview ID. It
21removes its rules within ten seconds of preview destruction, and on service stop.21removes its rules within ten seconds of preview destruction, and on service stop.
22After a host reboot, repeat the staging command to restore these runtime rules.22After a host reboot, repeat the staging command to restore these runtime rules.
23Production firewall rules are declared in `nixos/zenith.nix`. The DNS provider23Production firewall rules are declared in `nixos/snowglobe.nix`. The DNS provider
24provisions client, direct-TLS client, and federation SRV records pointing at24provisions client, direct-TLS client, and federation SRV records pointing at
25`xmpp.paperclover.net`; the website keeps its existing apex address. Router25`xmpp.paperclover.net`; the website keeps its existing apex address. Router
26forwarding must send the TCP listeners, UDP TURN listeners, and UDP relay range26forwarding must send the TCP listeners, UDP TURN listeners, and UDP relay range
27to Zenith. `xmpp-nat.service` refreshes UPnP mappings on startup and every five27to Snow Globe. `xmpp-nat.service` refreshes UPnP mappings on startup and every five
28minutes, using the Archer AX3000's description URL at the configured gateway.28minutes, using the Archer AX3000's description URL at the configured gateway.
29The description is fetched directly; multicast SSDP discovery failed on this29The description is fetched directly; multicast SSDP discovery failed on this
30host. Production activation uses the normal described-main deployment:30host. Production activation uses the normal described-main deployment:
3131
32```sh32```sh
33STUDIO_DEPLOY_HOST=root@10.0.0.1 STUDIO_DEPLOY_PORT=22 python3 tools/deploy.py prod33SNOWGLOBE_DEPLOY_HOST=root@10.0.0.1 SNOWGLOBE_DEPLOY_PORT=22 python3 tools/deploy.py prod
34```34```
3535
36## Zenith production, 2026-10-1036## Client connections and verification
3737
38The owner-readable connection file on Clover's Mac is38The owner-readable connection file on Clover's Mac is
39`~/.local/share/snowglobe/xmpp.json`. Monal can use the production JID and its39`~/.local/share/snowglobe/xmpp.json`. Monal can use the production JID and its
40generated password; the explicit server is `xmpp.paperclover.net`, port `5223`,40generated password; the explicit server is `xmpp.paperclover.net`, port `5223`,
41with direct TLS. Client and federation SRV records resolve to that server.41with direct TLS. Client and federation SRV records resolve to that server.
4242A preview has its own connection file and account domain; never copy its
43Verified through the public address from the home LAN: TLS authentication, two43account database into production.
44resources, carbons, MAM retrieval, stream resumption, PEP publication/deletion,44
45private group creation/history/destruction, PNG upload/download, WebSocket,45Test client authentication, two-resource carbons, MAM retrieval, resumable
46authenticated UDP TURN allocation/deallocation, relay address/range, rejection46streams, OMEMO/PEP keys, private group history, uploads, and WebSocket after
47of a private peer, STARTTLS, and TURN TLS certificate validation. All three tasks47changing the service. Calling also requires authenticated TURN, the configured
48had zero restarts. The normal deployment took backup48public relay range, and an off-LAN client check. Push discovery alone does not
49`20261011T015942Z-a7e251` and passed all service route checks. A transient systemd49prove delivery through an iOS client's push provider. Recheck external
50probe confirmed UPnP refresh works with `DynamicUser`. Off-LAN calls, iOS push50connectivity after router or forwarding changes.
51delivery, federation with another server, and recovery after a router restart
52need client-side verification.
53
54## Zenith preview, 2026-10-10
55
56Stage: `xmpp-preview-c035f9fb`
57Hostname: `xmpp-preview-c035f9fb.paperclover.net`
58JID: `clover@xmpp-preview-c035f9fb.paperclover.net`
59Dataset: `globe/staging/xmpp-preview-c035f9fb`
60
61The preview Nomad job and its transient firewall service were stopped for the
62production cutover. Its dataset, Nomad variables, and owner-readable Mac
63connection file at `~/.local/share/snowglobe/xmpp-preview.json` are retained.
64Preview account data was not copied into production.
65
66Delete the preview, including its accounts and history:
67
68```sh
69STUDIO_DEPLOY_HOST=root@10.0.0.1 STUDIO_DEPLOY_PORT=22 python3 tools/deploy.py destroy xmpp-preview-c035f9fb
70```
71
72Verified with synthetic data: certificate validation and TLS 1.3 login, two
73simultaneous resources, carbons, stream resumption after transport loss, MAM
74retrieval, PEP publication/deletion, private group creation/history/destruction,
75PNG upload/download over public HTTPS, WebSocket stream opening, external-service
76credentials, authenticated UDP TURN allocation/deallocation, advertised public
77relay address/range, and rejection of a private-network peer. Push support was
78discovered; delivery through an iOS client's push provider and calls across the
79public router were not exercised. All 25 pre-existing service jobs rendered
80byte-identically after the TCP schema migration. The active production release
81was unchanged, and Caddy, Nomad, dashboard, and Shale checks passed.
tools/yt-feed-migration.md deleted-9
...@@ -1,9 +0,0 @@
1# YouTube Triage migration
2
3The service keeps six JSON state files in `/mnt/storage1/apps/yt-feed` and editable `feed.yaml` and `subscriptions.yaml` in Clover's `Documents/Config/Youtube Downloader`. Its downloaded videos and upscaler output live in the existing Media dataset, so that dataset moves by ZFS rename as described in [media-cutover.md](media-cutover.md).
4
5On 2026-09-26, all six JSON files in `yt-feed-preview-e87b1ca1` matched Zenith by SHA-256 and parsed as JSON. Both Clover configuration files had matching SHA-256 hashes in the VM. The preview Media mount was read-only. Globe now owns the review API and worker; Nomad's `ytdl` job runs the thumbnail upscaler and archiver.
6
7For production, set `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT` for the new host, then run `bash tools/import-legacy-secrets.sh ytdl MAILER_ADDRESS MAILER_USERNAME MAILER_PASSWORD`. The order matches `smtp_host`, `smtp_user`, and `smtp_pass` in `service/ytdl/service.pkl`. Stop Zenith's `yt-feed` and the Snow Globe `ytdl` job before running `bash tools/import-yt-feed.sh ytdl`; the importer stops Globe's worker, snapshots the Snow Globe dataset, verifies the JSON copy, then restarts Globe. Clover's configuration and the Media dataset must be mounted at their final paths before import. Verify Globe's YouTube queue and one manual review action before cutover.
8
9For a same-machine OS replacement, set `STUDIO_LEGACY_HANDOFF` to the [offline handoff](legacy-handoff.md) directory while importing both secrets and JSON state. The production importer then reads the retained files from the mounted old apps dataset on the new host, without old Docker.
tools/zenith-hardware.md deleted-35
...@@ -1,35 +0,0 @@
1# Zenith source host inventory
2
3NixOS was installed onto the NVMe on October 4, 2026 and passed two boots over SSH at the existing addresses. The final boot reported `running` with zero failed units: the data pool imported healthy, all six encrypted roots unlocked and mounted automatically through the TPM credentials, and Nomad, Caddy, SSH, the host service, and NVIDIA persistence started successfully. Original dataset GUIDs and all PostgreSQL handoff file hashes matched their pre-install records. The RTX 3090 uses driver 595.71.05; `hardware.graphics.enable` supplies the driver library link needed by its persistence daemon. The historical TrueNAS inventory below describes the earlier layout.
4
5Read-only inspection on 2026-09-27 found a BIOS-booted Ryzen 9 5950X host with a Realtek RTL8111/8168/8411 NIC (`r8169`), RTX 3090, one 500 GB WD Blue SN5000 NVMe boot disk, and four 8 TB WD80EFPX disks. The NVMe is `/dev/disk/by-id/nvme-WD_Blue_SN5000_500GB_24261Z806200`; its GPT has a 1 MB BIOS boot partition, a 512 MB EFI partition, and a TrueNAS `boot-pool` partition with the running root at `boot-pool/ROOT/25.04.2.4`. The four other disks form the healthy `storage1` RAIDZ1 pool. The VM's UEFI boot configuration does not describe this host.
6
7`enp4s0` has static `10.0.0.1/24` and `192.168.0.1/24` addresses, default gateway `10.0.0.2`, and resolvers `1.1.1.1` and `1.0.0.1`. The NixOS target retains these; DHCP would not preserve the NAS address.
8
9`storage1` is unencrypted and mounted at `/mnt/storage1`. Its `apps`, `clover`, and `media` children are separate AES-256-GCM encryption roots. `apps` uses POSIX ACLs; `clover` and `media` use NFSv4 ACLs. Their mountpoints are `/mnt/storage1/apps`, `/mnt/storage1/clover`, and `/mnt/storage1/media`. The pool reported about 16.1 TB free. The [ACL cutover](storage-acl-cutover.md) and [Media cutover](media-cutover.md) describe the data-side migration; no disk or pool changes were made during this inventory.
10
11On 2026-09-27, Zenith ran OpenZFS 2.3.0 and reported `storage1` healthy. The pinned NixOS VM ran OpenZFS 2.4.4; its `zpool upgrade -v` listed every feature currently enabled or active on `storage1`, including encryption and block cloning. This checks feature support, not an actual import of the four-disk pool.
12
13TrueNAS's previous schedule snapshotted Clover hourly for one week, daily for four weeks, and monthly for two years; apps hourly for one week and daily for one month. Media had no scheduled snapshot task. NixOS does not yet replace this retention policy. The pinned NixOS `services.zfs.autoSnapshot` module has global retention counts, so it cannot express these different dataset schedules. Its `services.sanoid` module supports retention per dataset; the owner is choosing the replacement policy before it is enabled.
14
15The October 4 installer boots in UEFI mode on the same hardware. The `zenith` target now uses systemd-boot, host ID `4fa19ccb`, the renamed `globe` pool, and `paperclover.net`. The owner completed the dataset renames in [media-cutover.md](media-cutover.md); retained apps stay at `/mnt/storage1/apps`. Encrypted `globe/prod` and `globe/staging` roots were created with POSIX ACLs for the new service volumes. Nomad's startup guard requires the real pool, Clover, Media, production, and staging mounts; deployment separately checks their ACL types.
16
17The October 4 personal ACL cutover retained `globe/clover@personal-acl-20261004` and `globe/clover/Media@personal-acl-20261004`. Snapshot clones first passed read/write tests for UIDs 3000, 3106, 3114, and 3116 with group 3000. Both original datasets now use `acltype=posix`, `aclmode=discard`, and `aclinherit=discard`; retaining the legacy `aclmode=restricted` caused `EPERM` during rehearsal. One metadata pass processed 1,448,236 Clover entries and 31,187 Media entries without changing owner UIDs: group 3000 receives `g+rwX`, directories have setgid and inheritable group ACLs, and other access is `---`. Traversal stayed on each filesystem and did not follow symlinks. `/var/lib/studio/personal-acl-verified.json` records the completed original passes. The test clones were destroyed after verification; the original snapshots remain.
18
19The ASUS firmware TPM2 successfully sealed and decrypted every ZFS encryption-root key. [zenith.nix](../nixos/zenith.nix) loads encrypted systemd credentials from `/etc/credstore.encrypted` and runs `studio-zfs-unlock` after pool import and before `zfs-mount`. Plaintext keys remain outside the Nix store and NVMe; the running service's credentials exist in RAM. The credentials are bound to this TPM and PCR 7, so firmware changes affecting Secure Boot or clearing/replacing the TPM can require manual recovery. Secure Boot is currently disabled. The original dataset keys and TrueNAS configuration remain in the private Mac recovery archive; new production/staging keys are backed up separately at `/Users/clo/Library/Application Support/Zenith Recovery/postgres-backups/new-os-dataset-keys.json`.
20
21The NVMe installation replaces the old TrueNAS boot pool with a 1 GiB FAT32 EFI partition and an ext4 root partition occupying the remaining space. The only erase target is `/dev/disk/by-id/nvme-WD_Blue_SN5000_500GB_24261Z806200`; no HDD partition is formatted. [legacy-handoff.md](legacy-handoff.md) records the verified exports and off-server backups made before replacing the OS. The generated [hardware configuration](../nixos/hardware-configuration.nix) identifies the new root and EFI filesystems. The installed source lives at `/etc/nixos`; subsequent OS changes use `nixos-rebuild switch --flake /etc/nixos#zenith`.
22
23The target authorizes this Mac's existing ED25519 key for `clo` and root SSH. Its fingerprint `SHA256:52mNGHRsVFBDED9IAX5pe+LRWUefqTbxEReunq21QvU` matches the key Zenith currently accepts from this Mac. The other three keys in Zenith's `clo` authorized-keys file are not copied into the new root account. A synthetic NixOS evaluation confirmed both accounts receive exactly this key.
24
25The original TrueNAS ED25519, ECDSA, and RSA SSH host keys were recovered from the configuration backup, checked against their public keys, and restored into `/etc/ssh` on NixOS. ED25519 fingerprint `SHA256:P8pRWNrL6tceq9KN41Hdb0v0kmIboMf/zFBgOtHJfm0` matches this Mac's existing `git.paperclover.net` trust entry; a fresh connection with strict host checking passed after reloading SSH. The installer keys used during installation are retained privately in `/root/infra2-installer-host-keys`. [Shale migration](shale-migration.md) records the intended Git service scope, transport check, and replacement of the legacy SSH router.
26
27[Nomad stores its server state under `data_dir`](https://developer.hashicorp.com/nomad/docs/configuration), including [variables and their encrypted secret values](https://developer.hashicorp.com/nomad/docs/concepts/variables). Snow Globe stores generated service UIDs, deployment history, backup manifests/dumps, and dashboard state under `/var/lib/studio`. Both paths are on the VM's OS disk, outside its ZFS service datasets. Nomad used `66 MB` at inspection; Snow Globe's `8.7 GB` includes an `8.5 GB` VM-only `zpool.img`, while its release backups used `275 MB` across 25 runs. Reusing or replacing Zenith's NVMe would lose the control records unless they are migrated to encrypted ZFS or backed up separately. The pinned NixOS Nomad module accepts `services.nomad.settings.data_dir = "/srv/prod/nomad"` when `dropPrivileges = false`; a synthetic target evaluation passed. The corresponding Snow Globe state mount and dataset boundary await the storage policy decision before the physical cutover.
28
29A `nomad operator snapshot save` on the VM produced a private, compressed 143,608-byte snapshot in `/run`. Inspection reported 46 variables, 31 jobs, and 25 ACL policies. The snapshot restored into a fresh server-only Nomad agent in an isolated network namespace: its API listed all 31 jobs and 46 variables, and a hash comparison of Shale's secret variable items matched the live server without printing the values. The temporary agent, data, and snapshot were removed; the live leader and jobs stayed healthy. This proves [Nomad's server-state snapshot and restore](https://developer.hashicorp.com/nomad/commands/operator/snapshot/restore) on the pinned version, but Snow Globe's separate UID registry and backup files still need durable storage.
30
31The production target selects NixOS's stable NVIDIA driver for the RTX 3090 and its headless persistence daemon; the synthetic install evaluated with driver 595.71.05. Jellyfin has no GPU device allocation yet, so hardware transcoding still needs a physical-host test.
32
33With root SSH access and Nomad running, `STUDIO_DEPLOY_HOST=root@10.0.0.1 STUDIO_DEPLOY_PORT=22 python3 tools/deploy.py bootstrap` creates the Nomad ACL tokens and service datasets before checking external secrets. The first run reports all missing secret names; load those with `tools/import-legacy-secrets.sh` or `deploy.py secrets`, then rerun bootstrap to launch the jobs. Generated service secrets are created automatically. No Snow Globe job starts before the external-secret check passes. A bootstrap interrupted after switching the release link can be retried until deployment history records success.
34
35The ACL bootstrap ran twice against a disposable Nomad dev agent on the VM, created management, router, and dashboard token files, and left 14 policies. The dev agent and temporary state were removed; the VM's production Nomad agent was untouched.