| author | |
| committer | |
| log | 0786e0d038ecc3beecd8b582a082e679bd86f88b |
| tree | 0f98b72f8c41eba863cb008bc31e768a5993dd50 |
| parent | fa5832d9995e457115a50395949d4f2cb63df265 |
| signature | Signed by SSH key SHA256:52mNGHRsVFBDED9IAX5pe+LRWUefqTbxEReunq21QvU |
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-sol235 files changed, 4176 insertions(+), 11526 deletions(-)
AGENTS.md+119-181| ... | @@ -1,182 +1,120 @@ | ... | @@ -1,182 +1,120 @@ |
| 1 | # Snow Globe infrastructure | 1 | # Snow Globe |
| 2 | 2 | ||
| 3 | This repo runs Clover's home server: her creative file store, shared apps, and | 3 | Snow Globe is Clover's physical home computer: NixOS, Nomad/Podman services, |
| 4 | virtual machines. NixOS provides the host; Nomad schedules Podman containers; | 4 | ZFS storage, and virtual machines. Pkl describes services; the Rust/Solid |
| 5 | Pkl describes services; the Rust/Solid dashboard manages the system. Treat | 5 | web app manages the system. Availability and existing data are part of correctness. |
| 6 | availability and existing data as part of correctness. | 6 | |
| 7 | 7 | ## Default workflow | |
| 8 | ## Access and authorization | 8 | |
| 9 | 9 | Finish 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. Use | 11 | 1. Inspect the current code, Jujutsu state, and relevant service/runbook. |
| 12 | disposable preview data for writes and keep active production services intact. | 12 | 2. Implement the change and run the checks that cover it. |
| 13 | - Production changes require a request to take the work to prod. A request to | 13 | 3. 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. | 15 | 4. Test the real preview: app behavior, authentication, persistence, dependencies, |
| 16 | - Read-only infrastructure inspection over SSH is allowed for the task. Confirm | 16 | 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 port | 17 | panel, check the keyboard, and capture screenshots or recordings. |
| 18 | explicitly; the CLI's legacy defaults still point at the rehearsal VM. | 18 | 5. 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 its | 20 | |
| 21 | contents. Keep private material and derived model output inside its store. | 21 | A request to change, fix, test, stage, or commit does not authorize production. |
| 22 | - Never print credentials or encryption keys into chat, command arguments, | 22 | Once Clover requests production, finish the normal deployment without asking |
| 23 | ordinary logs, or tracked files. Use existing private files or stdin for | 23 | again: put the reviewed changes on a described, conflict-free **main**, run |
| 24 | imports; keep secret files owner-readable only. Nomad variables own service | 24 | `python3 tools/deploy.py prod`, and verify the actual production paths and history. |
| 25 | secrets; configuration declares names and references, not values. | 25 | Production exports **main**; it never promotes a preview database or the working |
| 26 | - Before destructive storage or OS work, require verified recovery: tested key | 26 | copy. 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 stored | 27 | |
| 28 | separately off the server. Local snapshots and a key archive alone do not | 28 | Two 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 the | 30 | - **Local AI:** deploy and test changes directly in production without waiting |
| 31 | personal archive and host credentials. A service preview may clone production | 31 | 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. |
| 33 | 33 | - **Virtual machines:** iterate on Snow Globe using disposable guests and disks. | |
| 34 | ## Machines and paths | 34 | Test actual guest/host integration and consoles. Preserve active personal |
| 35 | 35 | guests; a VM task does not authorize unrelated guest or storage changes. | |
| 36 | | Surface | Connection / role | Configuration | | 36 | |
| 37 | | --- | --- | --- | | 37 | Other 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 | | 38 | be 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 | | 40 | production verification after an authorized promotion. |
| 41 | 41 | ||
| 42 | `tools/deploy.py` reads `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT`; defaults | 42 | ## Target and state |
| 43 | are the rehearsal connection above. Set both explicitly for Zenith staging | 43 | |
| 44 | and production. Prefer staging previews on Zenith for service and dashboard | 44 | The deployment CLI defaults to Snow Globe, `root@10.0.0.1`, SSH port `22`. |
| 45 | verification; use the VM when host or guest isolation is required. | 45 | `SNOWGLOBE_DEPLOY_HOST` and `SNOWGLOBE_DEPLOY_PORT` override it; set both when targeting |
| 46 | Host settings and dataset names have their canonical home in `nixos/zenith.nix` | 46 | another machine. Confirm the connected host before remote mutations. |
| 47 | and `config/site.pkl`; inspect them instead of copying values into new tooling. | 47 | The configured hostname is `snowglobe`, with pretty name `snow globe`. |
| 48 | 48 | ||
| 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 | | 62 | Preserve persistent state, numeric owners, and existing consumers through |
| 63 | 63 | namespace changes. Read current configuration and host state before changing | |
| 64 | The rehearsal VM has its own Clover dataset. Its media view references the Mac's | 64 | operational assumptions. |
| 65 | mounted share read-only; those bytes are not synthetic fixtures. See | 65 | |
| 66 | `tools/local-vm.sh` for launch/cache overrides and `tools/mac-domains.py` for | 66 | ## Data and credentials |
| 67 | Mac rehearsal routing. Do not hand-edit DNS, trust, or host files to bypass them. | 67 | |
| 68 | 68 | - Infrastructure access and directory listings do not authorize reading private | |
| 69 | ## Where changes belong | 69 | contents. Get authorization per source; keep private material and derived model |
| 70 | 70 | output inside its store. Preview clones do not broaden that authorization. | |
| 71 | - `config/Service.pkl` owns the service schema; `config/site.pkl` owns site | 71 | - Keep credentials and encryption keys out of chat, command arguments, logs, and |
| 72 | defaults and overrides. `config/excluded-services.json` filters deployment | 72 | 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` owns | 78 | 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 the | 80 | - 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. Inspect | 85 | |
| 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 seeded | 87 | Services are discovered from `service/*/*.pkl`. Declare routes, mounts, health, |
| 88 | from `config/identities.json`. Preserve assigned numeric owners; do not | 88 | 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; |
| 90 | 90 | `tools/release.py` activates; `tools/data.py` backs up/restores; | |
| 91 | ## Adding or changing a service | 91 | `tools/router.py` derives Caddy routes. Change sources, not generated jobs/routes. |
| 92 | 92 | - `nixos/` owns the host. `dashboard/src/` and `dashboard/web/` own the app; | |
| 93 | 1. 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. Use | 94 | Read `guest/DESIGN.md` before changing the guest/host boundary. |
| 95 | `prepare` for repeatable work before startup and `setup` for repeatable | 95 | - Review outbound mail, federation, downloads, automation, fixed ports, host |
| 96 | configuration after health. Declare providers instead of hardcoding their | 96 | 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 |
| 98 | 2. 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. Use | 99 | - Repeating `stage <service>` updates its preview and retains preview data. Use |
| 100 | preview-aware configuration or `stageIsolation = "fresh"` when a cloned app | 100 | 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. |
| 102 | 3. Run the relevant local checks, then stage the working files: | 102 | - Dashboard: `cd dashboard && npm run check && npm run build` and |
| 103 | 103 | `cargo test --manifest-path dashboard/Cargo.toml`. Deployment: | |
| 104 | ```sh | 104 | `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 |
| 107 | 107 | 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 its | 109 | - Prefer fewer moving parts. Derive state, remove dead code and false comments, |
| 110 | existing preview and keeps preview data. Storage/isolation or incompatible | 110 | 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. |
| 112 | 4. 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. | ||
| 117 | 5. 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. | ||
| 121 | 6. 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 | |||
| 133 | Code rollback uses `deploy.py rollback [release-id]`. It does **not** restore | ||
| 134 | data. Data restore explicitly discards later writes and is a separate operation; | ||
| 135 | read `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` merely | 114 | Attribution uses `Assisted-by: <model>`, never `Co-authored-by`. |
| 163 | because a task requests a local commit. Use `Assisted-by: <model>` if adding | 115 | |
| 164 | model attribution, never `Co-authored-by`. | 116 | ## References |
| 165 | 117 | ||
| 166 | ## Operational references | 118 | [Storage layout](readme.md) · [Physical host/recovery](tools/snowglobe-hardware.md) · |
| 167 | 119 | [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 | |||
| 179 | Runbooks contain dated rehearsal evidence and migration history. Check current | ||
| 180 | configuration and read-only host state before treating an old observation as | ||
| 181 | today's topology. Keep deployment history and long investigations in their | ||
| 182 | runbooks; AGENTS.md carries the rules and links. |
config/OpenID.pkl+2-1| ... | @@ -3,13 +3,14 @@ module OpenID | ... | @@ -3,13 +3,14 @@ module OpenID |
| 3 | import "Service.pkl" as service | 3 | import "Service.pkl" as service |
| 4 | import "site.pkl" as site | 4 | import "site.pkl" as site |
| 5 | 5 | ||
| 6 | hostname: String = "snowglobe.\(site.domain)" | 6 | const hostname: String = "snowglobe.\(site.domain)" |
| 7 | issuer: String = "https://\(hostname)" | 7 | issuer: String = "https://\(hostname)" |
| 8 | 8 | ||
| 9 | class Client extends service.Requirement { | 9 | class 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: String | 15 | 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 |
| 4 | 4 | ||
| 5 | const nomadHostPort = "{{ if regexMatch \":\" .Address }}[{{ .Address }}]{{ else }}{{ .Address }}{{ end }}:{{ .Port }}" | 5 | const nomadHostPort = "{{ if regexMatch \":\" .Address }}[{{ .Address }}]{{ else }}{{ .Address }}{{ end }}:{{ .Port }}" |
| 6 | 6 | ||
| 7 | /// Name shown in the management UI and service listings. | ||
| 8 | class 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. |
| 17 | class Http { | 8 | class Http { |
| 18 | containerPort: UInt16 | 9 | containerPort: UInt16 |
| ... | @@ -107,7 +98,12 @@ class Container { | ... | @@ -107,7 +98,12 @@ class Container { |
| 107 | id: String = read?("prop:serviceId") | 98 | id: String = read?("prop:serviceId") |
| 108 | /// Stable numeric owner assigned by the deployment tool. | 99 | /// Stable numeric owner assigned by the deployment tool. |
| 109 | uid: Int = read("prop:uid").toInt() | 100 | uid: Int = read("prop:uid").toInt() |
| 110 | meta: Metadata | 101 | /// Name shown in the management UI and service listings. |
| 102 | name: String | ||
| 103 | tagline: String = "" | ||
| 104 | launcher: Boolean = true | ||
| 105 | /// Discovery group; absent uses the public route's auth role. | ||
| 106 | access: 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. |
| 112 | enabled: Boolean = true | 108 | enabled: 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 | else | 152 | else |
| 157 | throw("Declare a container or an input") | 153 | throw("Declare a container or an input") |
| 158 | 154 | ||
| 159 | local vmStartupGrace: String? = if (read?("env:STUDIO_VM_ACCEL") == "qemu") "60m" else null | 155 | local vmStartupGrace: String? = if (read?("env:SNOWGLOBE_VM_ACCEL") == "qemu") "60m" else null |
| 160 | 156 | ||
| 161 | output { | 157 | output { |
| 162 | renderer = new JsonRenderer {} | 158 | renderer = new JsonRenderer {} |
| 163 | value = new { | 159 | value = new { |
| 164 | id = module.id | 160 | id = module.id |
| 165 | name = module.meta.name | 161 | name = module.name |
| 166 | tagline = module.meta.tagline | 162 | tagline = module.tagline |
| 167 | launcher = module.meta.launcher | 163 | launcher = module.launcher |
| 168 | access = module.meta.access | 164 | access = module.access |
| 169 | rollout = module.rollout | 165 | rollout = module.rollout |
| 170 | stageIsolation = module.stageIsolation | 166 | stageIsolation = module.stageIsolation |
| 171 | healthyDeadline = vmStartupGrace ?? module.healthyDeadline | 167 | 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 @@ |
| 1 | module Site | 1 | module Site |
| 2 | 2 | ||
| 3 | /// The path to the root ZFS store | 3 | /// The path to the root ZFS store |
| 4 | root: String = read?("prop:root") ?? read?("env:STUDIO_ROOT") ?? "/srv" | 4 | root: String = read?("prop:root") ?? read?("env:SNOWGLOBE_ROOT") ?? "/srv" |
| 5 | pool: String = read?("prop:pool") ?? read?("env:STUDIO_POOL") ?? "studio-demo" | 5 | pool: String = read?("prop:pool") ?? read?("env:SNOWGLOBE_POOL") ?? "snowglobe-demo" |
| 6 | nodeName: String = read?("prop:nodeName") ?? read?("env:STUDIO_NODE_NAME") ?? "clover-demo" | 6 | nodeName: String = read?("prop:nodeName") ?? read?("env:SNOWGLOBE_NODE_NAME") ?? "snowglobe-rehearsal" |
| 7 | /// The base domain that the infrastructure runs on | 7 | /// The base domain that the infrastructure runs on |
| 8 | domain: String = read?("prop:domain") ?? read?("env:STUDIO_DOMAIN") ?? "studio.test" | 8 | domain: String = read?("prop:domain") ?? read?("env:SNOWGLOBE_DOMAIN") ?? "snowglobe.test" |
| 9 | ownerEmail: String = read?("prop:ownerEmail") ?? read?("env:STUDIO_OWNER_EMAIL") ?? "account@paperclover.net" | 9 | ownerEmail: String = read?("prop:ownerEmail") ?? read?("env:SNOWGLOBE_OWNER_EMAIL") ?? "account@paperclover.net" |
| 10 | cloverRoot: String = read?("prop:cloverRoot") ?? read?("env:STUDIO_CLOVER_ROOT") ?? "\(root)/clover" | 10 | cloverRoot: String = read?("prop:cloverRoot") ?? read?("env:SNOWGLOBE_CLOVER_ROOT") ?? "\(root)/clover" |
| 11 | cloverUid: Int = (read?("prop:cloverUid") ?? read?("env:STUDIO_CLOVER_UID") ?? "3000").toInt() | 11 | cloverUid: Int = (read?("prop:cloverUid") ?? read?("env:SNOWGLOBE_CLOVER_UID") ?? "3000").toInt() |
| 12 | cloverGid: Int = (read?("prop:cloverGid") ?? read?("env:STUDIO_CLOVER_GID") ?? "3000").toInt() | 12 | cloverGid: Int = (read?("prop:cloverGid") ?? read?("env:SNOWGLOBE_CLOVER_GID") ?? "3000").toInt() |
| 13 | cloverReadOnly: Boolean = (read?("prop:cloverReadOnly") ?? read?("env:STUDIO_CLOVER_READ_ONLY") ?? "false") == "true" | 13 | cloverReadOnly: Boolean = (read?("prop:cloverReadOnly") ?? read?("env:SNOWGLOBE_CLOVER_READ_ONLY") ?? "false") == "true" |
| 14 | mediaRoot: String = read?("prop:mediaRoot") ?? read?("env:STUDIO_MEDIA_ROOT") ?? "\(cloverRoot)/Media" | 14 | mediaRoot: String = read?("prop:mediaRoot") ?? read?("env:SNOWGLOBE_MEDIA_ROOT") ?? "\(cloverRoot)/Media" |
| 15 | localAiSsdCache: String = read?("prop:localAiSsdCache") ?? read?("env:STUDIO_LOCAL_AI_SSD_CACHE") ?? "/var/cache/studio/local-ai" | 15 | localAiSsdCache: String = read?("prop:localAiSsdCache") ?? read?("env:SNOWGLOBE_LOCAL_AI_SSD_CACHE") ?? "/var/cache/snowglobe/local-ai" |
| 16 | jellyfinFolders: Mapping<String, String> = new { | 16 | jellyfinFolders: 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 | } |
| 24 | mediaReadOnly: Boolean = (read?("prop:mediaReadOnly") ?? read?("env:STUDIO_MEDIA_READ_ONLY") ?? "false") == "true" | 24 | mediaReadOnly: Boolean = (read?("prop:mediaReadOnly") ?? read?("env:SNOWGLOBE_MEDIA_READ_ONLY") ?? "false") == "true" |
| 25 | tlsInternal: Boolean = (read?("prop:tlsInternal") ?? read?("env:STUDIO_TLS_INTERNAL") ?? "false") == "true" || domain.endsWith(".test") | 25 | tlsInternal: Boolean = (read?("prop:tlsInternal") ?? read?("env:SNOWGLOBE_TLS_INTERNAL") ?? "false") == "true" || domain.endsWith(".test") |
| 26 | preview: Boolean = (read?("prop:preview") ?? "false") == "true" | 26 | preview: Boolean = (read?("prop:preview") ?? "false") == "true" |
dashboard/dev.ts deleted-37| ... | @@ -1,37 +0,0 @@ | ||
| 1 | import { execFile, spawn } from "node:child_process"; | ||
| 2 | import { watch } from "node:fs"; | ||
| 3 | import { promisify } from "node:util"; | ||
| 4 | |||
| 5 | const host = process.env.STUDIO_DEPLOY_HOST ?? "root@127.0.0.1"; | ||
| 6 | const ssh = ["-p", process.env.STUDIO_DEPLOY_PORT ?? "2222", "-o", "BatchMode=yes", "-o", "ConnectTimeout=8"]; | ||
| 7 | const dir = "/root/studio-dashboard-dev"; | ||
| 8 | const run = promisify(execFile); | ||
| 9 | const quote = (value: string) => "'" + value.replaceAll("'", "'\\''") + "'"; | ||
| 10 | const restart = `import os, shlex, subprocess | ||
| 11 | variables = dict(item.split("=", 1) for item in shlex.split(subprocess.check_output(["systemctl", "show", "-P", "Environment", "studio-dashboard"], text=True))) | ||
| 12 | for key in ["STUDIO_INDEX_POOL", "STUDIO_YT_STATE", "STUDIO_FILES_WRITABLE"]: variables.pop(key, None) | ||
| 13 | variables.update(PORT="7070", STUDIO_METRICS="follow", STUDIO_DATA_DIR="${dir}/data") | ||
| 14 | subprocess.run(["systemctl", "stop", "studio-dashboard-dev"], check=False) | ||
| 15 | subprocess.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)`; | ||
| 16 | let pending = false; | ||
| 17 | let rebuilding = false; | ||
| 18 | async 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 | } | ||
| 31 | await rebuild(); | ||
| 32 | watch("src", { recursive: true }, () => rebuild().catch(console.error)); | ||
| 33 | const tunnel = spawn("ssh", [...ssh, "-N", "-o", "ExitOnForwardFailure=yes", "-L", "7070:127.0.0.1:7070", host], { stdio: "inherit" }); | ||
| 34 | tunnel.on("exit", code => process.exit(code ?? 1)); | ||
| 35 | for (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.2 | 25 | specifier: ^26.6.2 |
| 26 | version: 26.6.2 | 26 | version: 26.6.2 |
| 27 | concurrently: | ||
| 28 | specifier: ^10.0.5 | ||
| 29 | version: 10.0.5 | ||
| 30 | esbuild: | 27 | esbuild: |
| 31 | specifier: 0.28.2 | 28 | specifier: 0.28.2 |
| 32 | version: 0.28.2 | 29 | 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] |
| 557 | 554 | ||
| 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==} |
| 592 | 581 | ||
| 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==} |
| 608 | 584 | ||
| ... | @@ -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==} |
| 627 | 603 | ||
| 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'} |
| 661 | 634 | ||
| 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: true | 770 | hasBin: true |
| 806 | 771 | ||
| 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: true | 774 | 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'} |
| 823 | 785 | ||
| 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==} |
| 830 | 788 | ||
| ... | @@ -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'} |
| 839 | 797 | ||
| 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'} |
| 855 | 801 | ||
| 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: true | 883 | optional: true |
| 945 | 884 | ||
| 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==} |
| 956 | 887 | ||
| 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 | |||
| 965 | snapshots: | 888 | snapshots: |
| 966 | 889 | ||
| 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: true | 1240 | optional: true |
| 1318 | 1241 | ||
| 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.7 | 1244 | '@babel/core': 7.29.7 |
| ... | @@ -1348,23 +1267,6 @@ snapshots: | ... | @@ -1348,23 +1267,6 @@ snapshots: |
| 1348 | 1267 | ||
| 1349 | caniuse-lite@1.0.30001812: {} | 1268 | caniuse-lite@1.0.30001812: {} |
| 1350 | 1269 | ||
| 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: {} |
| 1369 | 1271 | ||
| 1370 | csstype@3.2.3: {} | 1272 | csstype@3.2.3: {} |
| ... | @@ -1377,8 +1279,6 @@ snapshots: | ... | @@ -1377,8 +1279,6 @@ snapshots: |
| 1377 | 1279 | ||
| 1378 | electron-to-chromium@1.5.439: {} | 1280 | electron-to-chromium@1.5.439: {} |
| 1379 | 1281 | ||
| 1380 | emoji-regex@10.6.0: {} | ||
| 1381 | |||
| 1382 | entities@6.0.1: {} | 1282 | entities@6.0.1: {} |
| 1383 | 1283 | ||
| 1384 | esbuild@0.28.2: | 1284 | esbuild@0.28.2: |
| ... | @@ -1421,10 +1321,6 @@ snapshots: | ... | @@ -1421,10 +1321,6 @@ snapshots: |
| 1421 | 1321 | ||
| 1422 | gensync@1.0.0-beta.2: {} | 1322 | gensync@1.0.0-beta.2: {} |
| 1423 | 1323 | ||
| 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: {} |
| 1429 | 1325 | ||
| 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.11 | 1435 | '@rolldown/binding-win32-arm64-msvc': 1.2.11 |
| 1540 | '@rolldown/binding-win32-x64-msvc': 1.2.11 | 1436 | '@rolldown/binding-win32-x64-msvc': 1.2.11 |
| 1541 | 1437 | ||
| 1542 | rxjs@7.8.2: | ||
| 1543 | dependencies: | ||
| 1544 | tslib: 2.8.1 | ||
| 1545 | |||
| 1546 | semver@6.3.1: {} | 1438 | semver@6.3.1: {} |
| 1547 | 1439 | ||
| 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: |
| 1551 | 1443 | ||
| 1552 | seroval@1.5.6: {} | 1444 | seroval@1.5.6: {} |
| 1553 | 1445 | ||
| 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.3 | 1448 | csstype: 3.2.3 |
| ... | @@ -1570,27 +1460,11 @@ snapshots: | ... | @@ -1570,27 +1460,11 @@ snapshots: |
| 1570 | 1460 | ||
| 1571 | source-map-js@1.2.1: {} | 1461 | source-map-js@1.2.1: {} |
| 1572 | 1462 | ||
| 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.7 | 1466 | picomatch: 4.0.7 |
| 1589 | 1467 | ||
| 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.2 | 1470 | 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) |
| 1663 | 1537 | ||
| 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 |
| 19 | 19 | ||
| 20 | os.umask(0o007) | 20 | os.umask(0o007) |
| 21 | 21 | ||
| 22 | YT_CONFIG_DIR = os.environ.get("STUDIO_YT_CONFIG", "/srv/clover/Documents/Config/Youtube Downloader") | 22 | YT_CONFIG_DIR = os.environ.get("SNOWGLOBE_YT_CONFIG", "/srv/clover/Documents/Config/Youtube Downloader") |
| 23 | FEED_CONFIG = os.path.join(YT_CONFIG_DIR, "feed.yaml") | 23 | FEED_CONFIG = os.path.join(YT_CONFIG_DIR, "feed.yaml") |
| 24 | STATE_DIR = os.environ.get("STUDIO_YT_STATE", "/srv/prod/ytdl/data") | 24 | STATE_DIR = os.environ.get("SNOWGLOBE_YT_STATE", "/srv/prod/ytdl/data") |
| 25 | INTERVAL = int(os.environ.get("CHECK_INTERVAL", "1800")) | 25 | INTERVAL = int(os.environ.get("CHECK_INTERVAL", "1800")) |
| 26 | SMTP_HOST = os.environ.get("SMTP_HOST", "") | 26 | SMTP_HOST = os.environ.get("SMTP_HOST", "") |
| 27 | SMTP_PORT = int(os.environ.get("SMTP_PORT", "465")) | 27 | SMTP_PORT = int(os.environ.get("SMTP_PORT", "465")) |
| 28 | SMTP_USER = os.environ.get("SMTP_USER", "") | 28 | SMTP_USER = os.environ.get("SMTP_USER", "") |
| 29 | SMTP_PASS = os.environ.get("SMTP_PASS", "") | 29 | SMTP_PASS = os.environ.get("SMTP_PASS", "") |
| 30 | MAIL_FROM = os.environ.get("MAIL_FROM", f"yt-feed@{os.environ.get('STUDIO_DOMAIN', 'studio.test')}") | 30 | MAIL_FROM = os.environ.get("MAIL_FROM", f"yt-feed@{os.environ.get('SNOWGLOBE_DOMAIN', 'snowglobe.test')}") |
| 31 | MAIL_TO = os.environ.get("MAIL_TO", os.environ.get("STUDIO_OWNER_EMAIL", "account@paperclover.net")) | 31 | MAIL_TO = os.environ.get("MAIL_TO", os.environ.get("SNOWGLOBE_OWNER_EMAIL", "account@paperclover.net")) |
| 32 | BASE_URL = os.environ.get("BASE_URL", f"https://snowglobe.{os.environ.get('STUDIO_DOMAIN', 'studio.test')}/youtube").rstrip("/") | 32 | BASE_URL = os.environ.get("BASE_URL", f"https://snowglobe.{os.environ.get('SNOWGLOBE_DOMAIN', 'snowglobe.test')}/youtube").rstrip("/") |
| 33 | READ_ONLY = os.environ.get("STUDIO_MEDIA_READ_ONLY") == "true" | 33 | READ_ONLY = os.environ.get("SNOWGLOBE_MEDIA_READ_ONLY") == "true" |
| 34 | 34 | ||
| 35 | MEDIA_ROOT = os.environ.get("STUDIO_YT_MEDIA", "/srv/clover/Media") | 35 | MEDIA_ROOT = os.environ.get("SNOWGLOBE_YT_MEDIA", "/srv/clover/Media") |
| 36 | INDIE_DIR = os.path.join(MEDIA_ROOT, "Indie Shows") | 36 | INDIE_DIR = os.path.join(MEDIA_ROOT, "Indie Shows") |
| 37 | INDEP_DIR = os.path.join(MEDIA_ROOT, "Videos/Independent") | 37 | INDEP_DIR = os.path.join(MEDIA_ROOT, "Videos/Independent") |
| 38 | MUSIC_DIR = os.path.join(MEDIA_ROOT, "Intake - Music") | 38 | MUSIC_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 | || !hostname | 50 | || !hostname |
| 51 | .bytes() | 51 | .bytes() |
dashboard/src/apps.rs+5-5| ... | @@ -1,7 +1,7 @@ | ... | @@ -1,7 +1,7 @@ |
| 1 | use crate::*; | 1 | use crate::*; |
| 2 | 2 | ||
| 3 | pub fn file_link(path: &str, zip: bool) -> Value { | 3 | pub 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 | } |
| 127 | async fn paper(app: Arc<App>, path: &str, body: Option<Value>) -> Result<Value> { | 127 | async 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 = headers | 421 | 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 = headers | 441 | 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; |
| 5 | 5 | ||
| 6 | pub async fn nomad(app: &App, path: &str) -> Result<Value> { | 6 | pub 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(value | 8 | 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 | } |
| 13 | pub async fn nomad_raw(app: &App, path: &str) -> Result<Option<Bytes>> { | 15 | pub 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 | .await | 21 | .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 | } |
| 355 | async fn summaries(app: Arc<App>) -> Result<Arc<Document>> { | 344 | async 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 | } |
| 446 | 435 | ||
| 447 | async 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 | |||
| 453 | async fn launcher_module(repo: &Path) -> Result<String> { | 436 | async 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 } |
| 488 | value = services.filter((_, s) -> s.enabled && s.meta.launcher).mapValues((_, s) -> | 462 | value = services.filter((_, s) -> s.enabled && s.launcher).mapValues((_, s) -> |
| 489 | let (tasks = s.containers?.toMap() ?? Map("app", s.container)) | 463 | let (tasks = s.containers?.toMap() ?? Map("app", s.container)) |
| 490 | let (routes = tasks.filter((_, task) -> task?.http?.hostname != null).mapValues((_, task) -> task.http)) | 464 | let (routes = tasks.filter((_, task) -> task?.http?.hostname != null).mapValues((_, task) -> task.http)) |
| 491 | let (route = routes.values.firstOrNull) | 465 | let (route = routes.values.firstOrNull) |
| 492 | new 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)") }) }"#); | 466 | new 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 | } |
| 495 | 469 | ||
| ... | @@ -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 | false | 542 | 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 | .await | 547 | .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> { |
| 851 | mod tests { | 825 | mod 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 | .await | 831 | .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 | .await | 834 | .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 | .await | 838 | .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 | module | 846 | 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 | } |
| 53 | impl Explorer { | 53 | impl 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 = root | 56 | 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 | } |
| 1066 | async fn refresh(app: Arc<App>) -> Result<Response> { | 1066 | async 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> { |
| 92 | 92 | ||
| 93 | fn registration(auth: &auth::Store, provider: &str) -> Result<(String, String)> { | 93 | fn 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 | } |
| 97 | 97 | ||
| 98 | async fn response_bytes(mut response: reqwest::Response) -> Result<Vec<u8>> { | 98 | async 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 { |
| 849 | 849 | ||
| 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; |
| 10 | mod host; | 10 | mod host; |
| 11 | mod index; | 11 | mod index; |
| 12 | mod mcp; | 12 | mod mcp; |
| 13 | mod namespace; | ||
| 13 | mod observability; | 14 | mod observability; |
| 14 | mod oidc; | 15 | mod oidc; |
| 15 | mod relay; | 16 | mod relay; |
| ... | @@ -113,6 +114,9 @@ struct App { | ... | @@ -113,6 +114,9 @@ struct App { |
| 113 | } | 114 | } |
| 114 | impl App { | 115 | impl 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> |
| 344 | 353 | ||
| 345 | #[tokio::main(worker_threads = 4)] | 354 | #[tokio::main(worker_threads = 4)] |
| 346 | async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> { | 355 | async 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 | http | 388 | 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 = request | 604 | 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 @@ | ||
| 1 | use crate::*; | ||
| 2 | use serde_json::Map; | ||
| 3 | |||
| 4 | pub 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 | |||
| 9 | fn 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 | |||
| 20 | pub 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 | |||
| 43 | pub fn attributes(values: &mut Map<String, Value>) { | ||
| 44 | keys(values, "."); | ||
| 45 | } | ||
| 46 | |||
| 47 | pub 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)] | ||
| 53 | mod 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 | } |
| 131 | fn visible_span(span: &Value, jobs: &Value, resources: &Value) -> bool { | 131 | fn 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<_> = jobs | 135 | 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 | &resources | 166 | &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 | &resources | 171 | &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 | &resources | 176 | &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 | && !(service | 356 | && !(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 = parts | 362 | let upstream: std::net::SocketAddr = parts |
| 363 | .headers | 363 | .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 = parts | 368 | let uri: axum::http::Uri = parts |
| 369 | .headers | 369 | .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.cache | 47 | 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 | } |
| 73 | 77 | ||
| 74 | const METRICS: &[(&str, &str)] = &[ | 78 | const 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 | ]; |
| 86 | 90 | ||
| 87 | fn series(result: &Value, application: bool) -> Value { | 91 | fn 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 = attributes | 388 | 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::Null | 409 | 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<_> = METRICS | 785 | 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 | stream | 52 | 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) { |
| 78 | 78 | ||
| 79 | 79 | ||
| 80 | const appName = (clientId: string, services: ServiceSummary[]) => | 80 | const 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; |
| 82 | 82 | ||
| 83 | /** "active 3h ago in Jellyfin, Shale", from their open sessions. */ | 83 | /** "active 3h ago in Jellyfin, Shale", from their open sessions. */ |
| 84 | function seen(user: User, services: ServiceSummary[]) { | 84 | function 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"; |
| 3 | 3 | ||
| 4 | inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-26.05"; | 4 | inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-26.05"; |
| 5 | 5 | ||
| ... | @@ -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.nix | 17 | ./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 | }; |
| 42 | 42 | ||
| 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 | }; |
| 111 | 111 | ||
| 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 | }; |
| 129 | 129 | ||
| 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 | }; |
| 147 | 147 | ||
| 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 = let | 224 | 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'; then | 260 | 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:rw | 261 | optional+=(--volume=/srv/prod/ytdl/data:/srv/prod/ytdl/data:rw |
| 261 | --env=STUDIO_YT_STATE=/srv/prod/ytdl/data | 262 | --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 | fi | 265 | 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}.pending | 300 | openssl rand -hex 32 > ${proxyToken}.pending |
| 300 | mv ${proxyToken}.pending ${proxyToken} | 301 | mv ${proxyToken}.pending ${proxyToken} |
| 301 | fi | 302 | fi |
| 302 | chown root:studio-dashboard ${proxyToken} /var/lib/studio/dashboard.token | 303 | chown root:snowglobe-dashboard ${proxyToken} /var/lib/snowglobe/dashboard.token |
| 303 | chmod 0640 ${proxyToken} /var/lib/studio/dashboard.token | 304 | chmod 0640 ${proxyToken} /var/lib/snowglobe/dashboard.token |
| 304 | chown -R studio-dashboard:studio-dashboard /var/lib/studio/dashboard | 305 | chown -R snowglobe-dashboard:snowglobe-dashboard /var/lib/snowglobe/dashboard |
| 305 | systemd-tmpfiles --create --prefix=/srv/prod/ytdl/data | 306 | systemd-tmpfiles --create --prefix=/srv/prod/ytdl/data |
| 306 | if ! podman image exists ${lib.escapeShellArg "${dashboard.image.imageName}:${dashboard.image.imageTag}"}; then | 307 | 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); do | 312 | 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; then | 313 | 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 0 | 314 | exit 0 |
| 314 | fi | 315 | fi |
| 315 | sleep 1 | 316 | 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 | ]; |
| 335 | 336 | ||
| 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 | ../config | 8 | ../config |
| 9 | (lib.fileset.difference ../service (lib.fileset.unions | 9 | ../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, ... }: | ||
| 2 | let | ||
| 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 | }; | ||
| 16 | in | ||
| 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 internal | 37 | tls internal |
| 38 | respond 404 | 38 | 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/clover | 62 | ${pkgs.coreutils}/bin/mkdir -p /var/lib/snowglobe /srv/clover |
| 63 | if ! ${pkgs.zfs}/bin/zpool list studio-demo >/dev/null 2>&1; then | 63 | if ! ${pkgs.zfs}/bin/zpool list snowglobe-demo >/dev/null 2>&1; then |
| 64 | if test -e /var/lib/studio/zpool.img; then | 64 | if test -e /var/lib/snowglobe/zpool.img; then |
| 65 | ${pkgs.zfs}/bin/zpool import -d /var/lib/studio studio-demo | 65 | ${pkgs.zfs}/bin/zpool import -d /var/lib/snowglobe snowglobe-demo |
| 66 | else | 66 | else |
| 67 | ${pkgs.coreutils}/bin/truncate -s 16G /var/lib/studio/zpool.img | 67 | ${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.img | 68 | ${pkgs.zfs}/bin/zpool create -f -o ashift=12 -O mountpoint=none snowglobe-demo /var/lib/snowglobe/zpool.img |
| 69 | fi | 69 | fi |
| 70 | fi | 70 | fi |
| 71 | if test "$(${pkgs.coreutils}/bin/stat -c %s /var/lib/studio/zpool.img)" -lt 17179869184; then | 71 | 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.img | 72 | ${pkgs.coreutils}/bin/truncate -s 16G /var/lib/snowglobe/zpool.img |
| 73 | ${pkgs.zfs}/bin/zpool online -e studio-demo /var/lib/studio/zpool.img | 73 | ${pkgs.zfs}/bin/zpool online -e snowglobe-demo /var/lib/snowglobe/zpool.img |
| 74 | fi | 74 | fi |
| 75 | if ! ${pkgs.zfs}/bin/zfs list studio-demo/clover >/dev/null 2>&1; then | 75 | 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/clover | 76 | ${pkgs.zfs}/bin/zfs create -o mountpoint=/srv/clover -o acltype=posixacl snowglobe-demo/clover |
| 77 | fi | 77 | fi |
| 78 | test "$(${pkgs.zfs}/bin/zfs get -H -o value mountpoint studio-demo/clover)" = /srv/clover | 78 | 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/clover | 80 | ${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/clover | 81 | ${pkgs.coreutils}/bin/chown 3000:3000 /srv/clover |
| 82 | ${pkgs.coreutils}/bin/chmod 2770 /srv/clover | 82 | ${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 1 | 103 | 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 | }; |
| 123 | 123 | ||
| 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, ... }: | ||
| 2 | let | ||
| 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 | }; | ||
| 16 | in | ||
| 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 |
| 8 | farms. | 8 | farms. |
| 9 | 9 | ||
| 10 | The system is built out of a NixOS base (just to install the system itself), | 10 | The system is built out of a NixOS base (just to install the system itself), |
| 11 | using managed docker containers (managed via Nomad) and virtual machines to run | 11 | using Podman containers scheduled by Nomad and virtual machines to run the |
| 12 | all the real services. There is a lot of custom tooling to spawn interactive | 12 | services. Changes automatically get a staging deployment on Snow Globe for |
| 13 | testing environments. For example, without even pushing any code, I can edit the | 13 | testing and review. Production promotion is a separate, explicit step. |
| 14 | configuration 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 | ||
| 16 | production ensures that the new deployment is healthy before routing traffic to | ||
| 17 | it -- It's kind of like "easy kubernetes." | ||
| 18 | 14 | ||
| 19 | [paper clover]: https://paperclover.net | 15 | [paper clover]: https://paperclover.net |
| 20 | 16 | ||
| 17 | ## change → preview → review | ||
| 18 | |||
| 19 | The deployment tool defaults to Snow Globe at `root@10.0.0.1:22`. | ||
| 20 | |||
| 21 | ```sh | ||
| 22 | python3 tools/deploy.py stage shale | ||
| 23 | python3 tools/deploy.py stage dashboard | ||
| 24 | ``` | ||
| 25 | |||
| 26 | These upload working files and print the preview URL. Service previews use | ||
| 27 | separate ZFS storage; the dashboard preview uses disposable accounts and files, | ||
| 28 | with read-only observations of the real host. Test the app and keep its preview | ||
| 29 | available for review. Repeating the command updates that preview. | ||
| 30 | |||
| 31 | After approval, commit the reviewed changes on `main` and run | ||
| 32 | `python3 tools/deploy.py prod`. The release workflow backs up state, activates | ||
| 33 | the release, and checks production health. Single-writer services can have a | ||
| 34 | brief interruption. Code rollback and data restore are separate operations. | ||
| 35 | |||
| 36 | GPU AI changes are tested directly in production. VM integration uses disposable | ||
| 37 | guests on the real machine. Most other work follows the preview workflow above; | ||
| 38 | isolated host testing is documented in [tools/rehearsal.md](tools/rehearsal.md). | ||
| 39 | The complete agent workflow is in [AGENTS.md](AGENTS.md). | ||
| 40 | |||
| 21 | ## filesystem layout | 41 | ## filesystem layout |
| 22 | 42 | ||
| 23 | The computer mounts the ZFS root dataset under `/srv`, meaning "server," loosely | 43 | The 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 videos | 50 | +--- 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 | ``` |
| 54 | 74 | ||
| 55 | Media is it's own dataset so it can be snapshotted independently of my personal | 75 | Media is its own dataset so it can be snapshotted independently of personal |
| 56 | data (less frequent, lower retention), and all my personal files are on the same | 76 | data. Personal files share a dataset to allow fast moves between top-level |
| 57 | dataset to allow fast move/copying between top level folders. Services use their | 77 | folders; services use separate datasets for copy-on-write previews. No automatic |
| 58 | own datasets to implement copy-on-write forks. | 78 | snapshot retention policy is configured. Hardware, encryption, permissions, and |
| 79 | recovery 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" |
| 2 | 2 | ||
| 3 | import "../../config/site.pkl" as site | 3 | import "../../config/site.pkl" as site |
| 4 | 4 | ||
| 5 | meta { name = "Clover DB"; launcher = false } | 5 | name = "Clover DB" |
| 6 | launcher = false | ||
| 6 | 7 | ||
| 7 | local isTest = site.domain.endsWith(".test") | 8 | local isTest = site.domain.endsWith(".test") |
| 8 | 9 | ||
| ... | @@ -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: 3923 | 3 | p: 3923 |
| 4 | shr: /shr | 4 | shr: /shr |
| 5 | hist: /cfg/hists | 5 | hist: /cfg/hists |
| 6 | df: STUDIO_MIN_FREE_GB | 6 | df: SNOWGLOBE_MIN_FREE_GB |
| 7 | ver | 7 | ver |
| 8 | theme: 2 | 8 | theme: 2 |
| 9 | name: clover's nas | 9 | name: clover's nas |
| ... | @@ -19,7 +19,7 @@ | ... | @@ -19,7 +19,7 @@ |
| 19 | auth-ord: pw,idp,ipu | 19 | auth-ord: pw,idp,ipu |
| 20 | idp-h-usr: user-name | 20 | idp-h-usr: user-name |
| 21 | idp-h-grp: user-groups | 21 | idp-h-grp: user-groups |
| 22 | idp-h-key: STUDIO_IDP_HEADER | 22 | 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-out | 24 | idp-logout: /auth/file/sign-out |
| 25 | idp-login-t: with snow globe | 25 | 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() |
| 170 | 170 | ||
| 171 | 171 | ||
| ... | @@ -196,11 +196,11 @@ def rename(source, destination): | ... | @@ -196,11 +196,11 @@ def rename(source, destination): |
| 196 | 196 | ||
| 197 | class Manager: | 197 | class 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 = users | 204 | 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 address | 281 | 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 None | 345 | return None |
| 346 | 346 | ||
| ... | @@ -573,9 +573,9 @@ class Manager: | ... | @@ -573,9 +573,9 @@ class Manager: |
| 573 | 573 | ||
| 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( |
| 20 | items = variable['Items'] | 20 | items = variable['Items'] |
| 21 | state_path = cfg / 'manager.json' | 21 | state_path = cfg / 'manager.json' |
| 22 | state = json.loads(state_path.read_text()) if state_path.exists() else {'accounts': [], 'grants': [], 'names': {}} | 22 | state = json.loads(state_path.read_text()) if state_path.exists() else {'accounts': [], 'grants': [], 'names': {}} |
| 23 | canonical_root = Path(os.environ.get('STUDIO_CLOVER_ROOT', str(Path(os.environ.get('STUDIO_ROOT', '/srv')) / 'clover'))) | 23 | canonical_root = Path(os.environ.get('SNOWGLOBE_CLOVER_ROOT', str(Path(os.environ.get('SNOWGLOBE_ROOT', '/srv')) / 'clover'))) |
| 24 | origin = Path(state.get('root', str(canonical_root))) | 24 | origin = Path(state.get('root', str(canonical_root))) |
| 25 | if origin != canonical_root: | 25 | if 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" |
| 2 | 2 | ||
| 3 | import "../../config/site.pkl" as site | 3 | import "../../config/site.pkl" as site |
| 4 | 4 | ||
| 5 | meta { name = "Copyparty" } | 5 | name = "Copyparty" |
| 6 | rollout = "simple" | ||
| 7 | prepare = "prepare.py" | 6 | prepare = "prepare.py" |
| 8 | 7 | ||
| 9 | secrets { | 8 | secrets { |
| ... | @@ -12,8 +11,6 @@ secrets { | ... | @@ -12,8 +11,6 @@ secrets { |
| 12 | 11 | ||
| 13 | container { | 12 | container { |
| 14 | image = "docker.io/copyparty/ac@sha256:9658d60c7fec0bffb968cacc677712be3c8a6e73bb388b6b47b7f2b178a754a6" | 13 | image = "docker.io/copyparty/ac@sha256:9658d60c7fec0bffb968cacc677712be3c8a6e73bb388b6b47b7f2b178a754a6" |
| 15 | cpu = 200 | ||
| 16 | memory = 512 | ||
| 17 | 14 | ||
| 18 | http { | 15 | http { |
| 19 | containerPort = 3923 | 16 | containerPort = 3923 |
service/dawarich/redis-insight.pkl+1-2| ... | @@ -1,6 +1,6 @@ | ... | @@ -1,6 +1,6 @@ |
| 1 | amends "../../config/Service.pkl" | 1 | amends "../../config/Service.pkl" |
| 2 | 2 | ||
| 3 | meta { name = "Redis Insight" } | 3 | name = "Redis Insight" |
| 4 | dependsOn { "dawarich" } | 4 | dependsOn { "dawarich" } |
| 5 | 5 | ||
| 6 | secrets { | 6 | secrets { |
| ... | @@ -10,7 +10,6 @@ secrets { | ... | @@ -10,7 +10,6 @@ secrets { |
| 10 | container { | 10 | container { |
| 11 | image = "docker.io/redis/redisinsight@sha256:0131987fd5fefe3828ed33666f9742bd071b729f5a95cf923c593c14a8995c2c" | 11 | image = "docker.io/redis/redisinsight@sha256:0131987fd5fefe3828ed33666f9742bd071b729f5a95cf923c593c14a8995c2c" |
| 12 | cpu = 150 | 12 | cpu = 150 |
| 13 | memory = 512 | ||
| 14 | 13 | ||
| 15 | http { | 14 | http { |
| 16 | containerPort = 5540 | 15 | 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 = true | 36 | 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 | """ |
| 45 | 45 | ||
| 46 | meta { name = "Dawarich"; access = "infra-admin" } | 46 | name = "Dawarich" |
| 47 | access = "infra-admin" | ||
| 47 | healthyDeadline = "20m" | 48 | healthyDeadline = "20m" |
| 48 | 49 | ||
| 49 | requirements { | 50 | requirements { |
| 50 | database | 51 | database |
| 51 | new sso.Client { | 52 | new sso.Client { |
| 52 | clientId = module.id | 53 | clientId = module.id |
| 53 | name = module.meta.name | 54 | 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 = true | 68 | imageUser = true |
| 68 | lifecycle = "prestart" | 69 | lifecycle = "prestart" |
| 69 | cpu = 200 | ||
| 70 | memory = 1024 | 70 | memory = 1024 |
| 71 | volumes = sharedVolumes | 71 | volumes = sharedVolumes |
| 72 | env = commonEnv | 72 | env = commonEnv |
| ... | @@ -75,7 +75,6 @@ containers { | ... | @@ -75,7 +75,6 @@ containers { |
| 75 | 75 | ||
| 76 | ["web"] { | 76 | ["web"] { |
| 77 | image = dawarichImage | 77 | 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 = true | 80 | 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 = true | 108 | imageUser = true |
| 110 | cpu = 200 | ||
| 111 | memory = 1024 | 109 | memory = 1024 |
| 112 | volumes = sharedVolumes | 110 | 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 | } |
| 18 | 18 | ||
| 19 | meta { name = "DDNS" } | 19 | name = "DDNS" |
| 20 | provide = "provide.py" | 20 | provide = "provide.py" |
| 21 | enabled = !site.preview && !site.domain.endsWith(".test") | 21 | enabled = !site.preview && !site.domain.endsWith(".test") |
| 22 | 22 |
service/evil-forgejo/api.py deleted-33| ... | @@ -1,33 +0,0 @@ | ||
| 1 | import json | ||
| 2 | import os | ||
| 3 | import subprocess | ||
| 4 | import urllib.request | ||
| 5 | |||
| 6 | |||
| 7 | def 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 | |||
| 16 | def 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 @@ | ||
| 1 | APP_NAME="evil inc" | ||
| 2 | APP_SLOGAL="be evil. take control back." | ||
| 3 | RUN_MODE=prod | ||
| 4 | RUN_USER=git | ||
| 5 | WORK_PATH=/data/work | ||
| 6 | |||
| 7 | [repository] | ||
| 8 | MAX_CREATION_LIMIT=20000 | ||
| 9 | ROOT=/data/git/repositories | ||
| 10 | DEFAULT_CLOSE_ISSUES_VIA_COMMITS_IN_ANY_BRANCH=true | ||
| 11 | DEFAULT_REPO_UNITS=repo.code,repo.issues,repo.pulls | ||
| 12 | DISABLE_STARS=true | ||
| 13 | DEFAULT_BRANCH=master | ||
| 14 | |||
| 15 | [repository.local] | ||
| 16 | LOCAL_COPY_PATH=/data/work/tmp/local-repo | ||
| 17 | |||
| 18 | [repository.upload] | ||
| 19 | TEMP_PATH=/data/work/uploads | ||
| 20 | |||
| 21 | [ui] | ||
| 22 | EXPLORE_PAGING_NUM=100 | ||
| 23 | ISSUE_PAGING_NUM=500 | ||
| 24 | MEMBERS_PAGING_NUM=100 | ||
| 25 | THEMES=evil,evil-dark,evil-light | ||
| 26 | DEFAULT_THEME=evil | ||
| 27 | |||
| 28 | [server] | ||
| 29 | APP_DATA_PATH=/data/work | ||
| 30 | DOMAIN=$GIT_HOST | ||
| 31 | SSH_DOMAIN=$GIT_HOST | ||
| 32 | HTTP_ADDR=0.0.0.0 | ||
| 33 | HTTP_PORT=$FORGEJO_HTTP_PORT | ||
| 34 | ROOT_URL=https://$GIT_HOST/ | ||
| 35 | LFS_JWT_SECRET=$FORGEJO_SERVER_LFS_JWT_SECRET | ||
| 36 | LFS_START_SERVER=true | ||
| 37 | OFFLINE_MODE=true | ||
| 38 | LANDING_PAGE=/evil | ||
| 39 | START_SSH_SERVER=false | ||
| 40 | SSH_CREATE_AUTHORIZED_KEYS_FILE=false | ||
| 41 | |||
| 42 | [database] | ||
| 43 | DB_TYPE=postgres | ||
| 44 | HOST=$DB_HOST | ||
| 45 | NAME=$DB_NAME | ||
| 46 | USER=$DB_USER | ||
| 47 | PASSWD=$DB_PASSWORD | ||
| 48 | LOG_SQL=false | ||
| 49 | SCHEMA= | ||
| 50 | SSL_MODE=disable | ||
| 51 | |||
| 52 | [indexer] | ||
| 53 | ISSUE_INDEXER_PATH=/data/work/indexers/issues.bleve | ||
| 54 | |||
| 55 | [session] | ||
| 56 | PROVIDER_CONFIG=/data/work/sessions | ||
| 57 | PROVIDER=file | ||
| 58 | |||
| 59 | [picture] | ||
| 60 | AVATAR_UPLOAD_PATH=/data/work/avatars | ||
| 61 | REPOSITORY_AVATAR_UPLOAD_PATH=/data/work/repo-avatars | ||
| 62 | |||
| 63 | [admin] | ||
| 64 | DISABLE_REGULAR_ORG_CREATION=true | ||
| 65 | |||
| 66 | [attachment] | ||
| 67 | PATH=/data/work/attachments | ||
| 68 | |||
| 69 | [log] | ||
| 70 | MODE=console | ||
| 71 | LEVEL=info | ||
| 72 | ROOT_PATH=/data/work/log | ||
| 73 | |||
| 74 | [security] | ||
| 75 | INSTALL_LOCK=true | ||
| 76 | REVERSE_PROXY_LIMIT=1 | ||
| 77 | REVERSE_PROXY_TRUSTED_PROXIES=* | ||
| 78 | PASSWORD_HASH_ALGO=pbkdf2_hi | ||
| 79 | SECRET_KEY=$FORGEJO_SECURITY_SECRET_KEY | ||
| 80 | INTERNAL_TOKEN=$FORGEJO_SECURITY_INTERNAL_TOKEN | ||
| 81 | |||
| 82 | [service] | ||
| 83 | ENABLE_INTERNAL_SIGNIN=true | ||
| 84 | DISABLE_REGISTRATION=false | ||
| 85 | ALLOW_ONLY_EXTERNAL_REGISTRATION=true | ||
| 86 | SHOW_REGISTRATION_BUTTON=false | ||
| 87 | REQUIRE_SIGNIN_VIEW=false | ||
| 88 | REGISTER_EMAIL_CONFIRM=true | ||
| 89 | ENABLE_NOTIFY_MAIL=true | ||
| 90 | DEFAULT_KEEP_EMAIL_PRIVATE=false | ||
| 91 | DEFAULT_ALLOW_CREATE_ORGANIZATION=true | ||
| 92 | DEFAULT_ENABLE_TIMETRACKING=false | ||
| 93 | |||
| 94 | [lfs] | ||
| 95 | PATH = /data/git/lfs | ||
| 96 | |||
| 97 | [mailer] | ||
| 98 | ENABLED=$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 | ||
| 101 | FROM=noreply.evil-git@paperclover.net | ||
| 102 | PROTOCOL=smtps | ||
| 103 | SMTP_PORT=465 | ||
| 104 | SMTP_ADDR=$MAILER_ADDRESS | ||
| 105 | USER=$MAILER_USERNAME | ||
| 106 | PASSWD=$MAILER_PASSWORD | ||
| 107 | |||
| 108 | [repository.pull-request] | ||
| 109 | DEFAULT_MERGE_STYLE=squash | ||
| 110 | |||
| 111 | [repository.signing] | ||
| 112 | DEFAULT_TRUST_MODEL=committer | ||
| 113 | |||
| 114 | [oauth2] | ||
| 115 | JWT_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 | ||
| 2 | import json | ||
| 3 | import sys | ||
| 4 | import urllib.error | ||
| 5 | import urllib.request | ||
| 6 | |||
| 7 | from api import instance | ||
| 8 | |||
| 9 | |||
| 10 | data = json.load(sys.stdin) | ||
| 11 | request = data["request"] | ||
| 12 | if request["kind"] != "oauth-client": | ||
| 13 | raise ValueError("unsupported Forgejo input") | ||
| 14 | stage = data.get("stageId") | ||
| 15 | existing = data.get("existing") or {} | ||
| 16 | if data.get("operation") == "delete" and not stage: | ||
| 17 | raise ValueError("refusing to delete a production OAuth client") | ||
| 18 | _, address = instance() | ||
| 19 | authorization = "token " + data["providerSecrets"]["automation_token"] | ||
| 20 | |||
| 21 | |||
| 22 | def 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 | |||
| 38 | application_id = existing.get("applicationId") | ||
| 39 | if data.get("operation") == "delete": | ||
| 40 | if application_id: | ||
| 41 | api("/user/applications/oauth2/" + application_id, "DELETE") | ||
| 42 | sys.exit(0) | ||
| 43 | |||
| 44 | suffix = request["name"] + (":" + stage if stage else "") | ||
| 45 | name = "Snow Globe: " + suffix | ||
| 46 | desired = {"name": name, "redirect_uris": request["redirectUris"], "confidential_client": True} | ||
| 47 | if 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 | ||
| 56 | if 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"] | ||
| 64 | if not client_id or not client_secret: | ||
| 65 | raise ValueError("Forgejo OAuth client has no credentials") | ||
| 66 | print(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 @@ | ||
| 1 | extends "../../config/Service.pkl" | ||
| 2 | |||
| 3 | import "../../config/Service.pkl" as service | ||
| 4 | import "../../config/site.pkl" as site | ||
| 5 | import "../postgres/service.pkl" as postgres | ||
| 6 | |||
| 7 | class 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 | |||
| 15 | local gitHost = if (site.domain.endsWith(".test")) "git.evil.\(site.domain)" else "git.evil.inc" | ||
| 16 | |||
| 17 | meta { name = "evil.inc Git" } | ||
| 18 | healthyDeadline = "20m" | ||
| 19 | healthRestartGrace = "2m" | ||
| 20 | setup = "setup.py" | ||
| 21 | provide = "provide.py" | ||
| 22 | |||
| 23 | requirements { new postgres.Database { name = "evil_forgejo" } } | ||
| 24 | |||
| 25 | secrets { | ||
| 26 | ["lfs_jwt"] {} | ||
| 27 | ["oauth_jwt"] {} | ||
| 28 | ["security_key"] {} | ||
| 29 | ["internal_token"] {} | ||
| 30 | ["anubis_key"] {} | ||
| 31 | ["automation_password"] {} | ||
| 32 | } | ||
| 33 | |||
| 34 | requiredSecrets = if (site.domain.endsWith(".test")) new Listing {} else new Listing { | ||
| 35 | "mailer_address" | ||
| 36 | "mailer_username" | ||
| 37 | "mailer_password" | ||
| 38 | } | ||
| 39 | |||
| 40 | containers { | ||
| 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 | ||
| 2 | import json | ||
| 3 | import os | ||
| 4 | import secrets | ||
| 5 | import subprocess | ||
| 6 | import sys | ||
| 7 | import tempfile | ||
| 8 | import urllib.error | ||
| 9 | import urllib.request | ||
| 10 | |||
| 11 | from api import instance | ||
| 12 | |||
| 13 | |||
| 14 | data = json.load(sys.stdin) | ||
| 15 | container, address = instance(data["serviceId"]) | ||
| 16 | script = """ | ||
| 17 | IFS= read -r password | ||
| 18 | cd /app/gitea | ||
| 19 | su-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 | ||
| 22 | su-exec git /usr/local/bin/gitea admin user change-password \ | ||
| 23 | --username studio-automation --password "$password" >/dev/null | ||
| 24 | su-exec git /usr/local/bin/gitea admin user must-change-password \ | ||
| 25 | --unset studio-automation >/dev/null | ||
| 26 | """ | ||
| 27 | result = 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 | ) | ||
| 32 | if result.returncode: | ||
| 33 | raise RuntimeError("could not prepare Forgejo automation account") | ||
| 34 | |||
| 35 | path = "nomad/jobs/" + data["serviceId"] | ||
| 36 | request = urllib.request.Request( | ||
| 37 | "http://127.0.0.1:4646/v1/var/" + path, | ||
| 38 | headers={"X-Nomad-Token": os.environ["NOMAD_TOKEN"]}, | ||
| 39 | ) | ||
| 40 | with urllib.request.urlopen(request, timeout=5) as response: | ||
| 41 | variable = json.load(response) | ||
| 42 | current = variable["Items"].get("automation_token") | ||
| 43 | if 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 | ||
| 52 | if 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 | ||
| 2 | set -eu | ||
| 3 | |||
| 4 | mkdir -p /custom/conf | ||
| 5 | envsubst < /studio/app.ini > /custom/conf/app.ini | ||
| 6 | chown "$USER_UID:$USER_GID" /custom/conf /custom/conf/app.ini | ||
| 7 | chmod 750 /custom/conf | ||
| 8 | chmod 600 /custom/conf/app.ini | ||
| 9 | # The image's s6 bundle starts an SSH daemon on the host's port 22. | ||
| 10 | exec /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 @@ | ||
| 1 | amends "../../config/Service.pkl" | ||
| 2 | |||
| 3 | import "../../config/site.pkl" as site | ||
| 4 | import "../evil-forgejo/service.pkl" as forgejo | ||
| 5 | import "../postgres/service.pkl" as postgres | ||
| 6 | |||
| 7 | local host = if (site.preview) "\(module.id).evil.\(site.domain)" else if (site.domain.endsWith(".test")) "md.evil.\(site.domain)" else "md.evil.inc" | ||
| 8 | |||
| 9 | meta { name = "evil.inc Notes" } | ||
| 10 | healthyDeadline = "15m" | ||
| 11 | healthRestartGrace = "5m" | ||
| 12 | |||
| 13 | requirements { | ||
| 14 | new postgres.Database { name = "evil_hedgedoc" } | ||
| 15 | new forgejo.OAuthClient { | ||
| 16 | name = "HedgeDoc" | ||
| 17 | redirectUris { "https://\(host)/auth/oauth2/callback" } | ||
| 18 | } | ||
| 19 | } | ||
| 20 | |||
| 21 | secrets { ["session_secret"] {} } | ||
| 22 | |||
| 23 | container { | ||
| 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 @@ |
| 1 | amends "../../config/Service.pkl" | 1 | amends "../../config/Service.pkl" |
| 2 | 2 | ||
| 3 | meta { name = "FlareSolverr" } | 3 | name = "FlareSolverr" |
| 4 | rollout = "overlapped" | 4 | rollout = "overlapped" |
| 5 | 5 | ||
| 6 | container { | 6 | container { |
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 |
| 5 | 5 | ||
| 6 | local isPreview = read?("prop:preview") == "true" | 6 | local isPreview = read?("prop:preview") == "true" |
| 7 | 7 | ||
| 8 | meta { name = "Forward Auth" } | 8 | name = "Forward Auth" |
| 9 | rollout = "overlapped" | 9 | rollout = "overlapped" |
| 10 | 10 | ||
| 11 | requirements { | 11 | requirements { |
| 12 | new sso.Client { | 12 | new sso.Client { |
| 13 | clientId = module.id | 13 | clientId = module.id |
| 14 | name = module.meta.name | 14 | 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 = 100 | 30 | cpu = 100 |
| 31 | memory = 256 | 31 | memory = 256 |
| 32 | extraHosts { "\(sso.hostname):host-gateway" } | ||
| 33 | 32 | ||
| 34 | http { | 33 | http { |
| 35 | containerPort = 4180 | 34 | containerPort = 4180 |
| ... | @@ -39,7 +38,7 @@ container { | ... | @@ -39,7 +38,7 @@ container { |
| 39 | 38 | ||
| 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 = true | 42 | 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" |
| 2 | 2 | ||
| 3 | import "../../config/site.pkl" as site | 3 | import "../../config/site.pkl" as site |
| 4 | 4 | ||
| 5 | meta { name = "JSON Intake"; launcher = false } | 5 | name = "JSON Intake" |
| 6 | launcher = false | ||
| 6 | 7 | ||
| 7 | secrets = if (site.domain.endsWith(".test")) new { ["key"] {} } else new {} | 8 | secrets = if (site.domain.endsWith(".test")) new { ["key"] {} } else new {} |
| 8 | requiredSecrets = if (site.domain.endsWith(".test")) new {} else new { "key" } | 9 | requiredSecrets = if (site.domain.endsWith(".test")) new {} else new { "key" } |
service/jackett/service.pkl+1-3| ... | @@ -1,11 +1,9 @@ | ... | @@ -1,11 +1,9 @@ |
| 1 | amends "../../config/Service.pkl" | 1 | amends "../../config/Service.pkl" |
| 2 | 2 | ||
| 3 | meta { name = "Jackett" } | 3 | name = "Jackett" |
| 4 | 4 | ||
| 5 | container { | 5 | container { |
| 6 | image = "lscr.io/linuxserver/jackett@sha256:139a0819074ef16556399a66ee3c492f0d202ec20467cf9300d7126b8a31f2b5" | 6 | image = "lscr.io/linuxserver/jackett@sha256:139a0819074ef16556399a66ee3c492f0d202ec20467cf9300d7126b8a31f2b5" |
| 7 | cpu = 200 | ||
| 8 | memory = 512 | ||
| 9 | 7 | ||
| 10 | http { | 8 | http { |
| 11 | containerPort = 9117 | 9 | containerPort = 9117 |
service/jellyfin/configure.py+2-2| ... | @@ -10,13 +10,13 @@ import urllib.request | ... | @@ -10,13 +10,13 @@ import urllib.request |
| 10 | 10 | ||
| 11 | config = json.load(sys.stdin) | 11 | config = json.load(sys.stdin) |
| 12 | base = f"https://{config['host']}" | 12 | base = f"https://{config['host']}" |
| 13 | context = ssl.create_default_context(cafile="/var/lib/studio/ca-bundle.crt") | 13 | context = ssl.create_default_context(cafile="/var/lib/snowglobe/ca-bundle.crt") |
| 14 | 14 | ||
| 15 | 15 | ||
| 16 | def request(path, data=None, token=None): | 16 | def 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"] = token | 22 | 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" |
| 3 | import "../../config/site.pkl" as site | 3 | import "../../config/site.pkl" as site |
| 4 | import "../../config/OpenID.pkl" as sso | 4 | import "../../config/OpenID.pkl" as sso |
| 5 | 5 | ||
| 6 | meta { name = "Jellyfin" } | 6 | name = "Jellyfin" |
| 7 | // SQLite under /config requires one writer during rollout. | ||
| 8 | rollout = "simple" | ||
| 9 | healthyDeadline = "20m" | 7 | healthyDeadline = "20m" |
| 10 | healthRestartGrace = "20m" | 8 | healthRestartGrace = "20m" |
| 11 | prepare = "prepare.py" | 9 | prepare = "prepare.py" |
| ... | @@ -16,7 +14,7 @@ secrets { ["admin_password"] {} } | ... | @@ -16,7 +14,7 @@ secrets { ["admin_password"] {} } |
| 16 | requirements { | 14 | requirements { |
| 17 | new sso.Client { | 15 | new sso.Client { |
| 18 | clientId = module.id | 16 | clientId = module.id |
| 19 | name = module.meta.name | 17 | 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 = 500 | 27 | cpu = 500 |
| 30 | memory = 3072 | 28 | memory = 3072 |
| 31 | extraHosts { "\(sso.hostname):host-gateway" } | ||
| 32 | 29 | ||
| 33 | http { | 30 | http { |
| 34 | containerPort = 8096 | 31 | 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 = true | 54 | readOnly = true |
| 58 | } | 55 | } |
| 59 | } | 56 | } |
service/keycloak/api.py deleted-83| ... | @@ -1,83 +0,0 @@ | ||
| 1 | import http.client | ||
| 2 | import io | ||
| 3 | import json | ||
| 4 | import os | ||
| 5 | import socket | ||
| 6 | import ssl | ||
| 7 | import time | ||
| 8 | import urllib.error | ||
| 9 | import urllib.parse | ||
| 10 | |||
| 11 | |||
| 12 | class 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 | |||
| 18 | class 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 | ||
| 2 | import json | ||
| 3 | import sys | ||
| 4 | |||
| 5 | from api import Keycloak | ||
| 6 | |||
| 7 | |||
| 8 | config = json.load(sys.stdin) | ||
| 9 | keycloak = Keycloak(config["host"], config["password"]) | ||
| 10 | keycloak.configure_profile() | ||
| 11 | keycloak.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 | ) | ||
| 27 | roles_path = "/admin/realms/master/roles" | ||
| 28 | roles = {role["name"]: role for role in keycloak.request(roles_path)} | ||
| 29 | for 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 | |||
| 34 | users = keycloak.request("/admin/realms/master/users?username=admin&exact=true") | ||
| 35 | if len(users) != 1: | ||
| 36 | raise ValueError("expected one bootstrap admin user") | ||
| 37 | if 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 | ) | ||
| 42 | mapping_path = f"/admin/realms/master/users/{users[0]['id']}/role-mappings/realm" | ||
| 43 | assigned = {role["name"] for role in keycloak.request(mapping_path)} | ||
| 44 | missing = [roles[name] for name in ("admin", "media", "media-manage") if name not in assigned] | ||
| 45 | if missing: | ||
| 46 | keycloak.request(mapping_path, "POST", missing) | ||
| 47 | |||
| 48 | snow = keycloak.request("/admin/realms/master/users?username=snow&exact=true") | ||
| 49 | if 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") | ||
| 56 | if len(snow) != 1: | ||
| 57 | raise ValueError("expected one snow user") | ||
| 58 | if 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 | ) | ||
| 63 | mapping_path = f"/admin/realms/master/users/{snow[0]['id']}/role-mappings/realm" | ||
| 64 | assigned = {role["name"] for role in keycloak.request(mapping_path)} | ||
| 65 | missing = [roles[name] for name in ("infra-admin", "media", "media-manage") if name not in assigned] | ||
| 66 | if 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 | ||
| 2 | import json | ||
| 3 | import sys | ||
| 4 | import urllib.parse | ||
| 5 | |||
| 6 | from api import Keycloak | ||
| 7 | |||
| 8 | |||
| 9 | data = json.load(sys.stdin) | ||
| 10 | request = data["request"] | ||
| 11 | if request["kind"] != "client": | ||
| 12 | raise ValueError("unsupported Keycloak input") | ||
| 13 | stage_id = data.get("stageId") | ||
| 14 | client_id = request["clientId"] | ||
| 15 | if stage_id and client_id != stage_id: | ||
| 16 | client_id += "-" + stage_id[-8:] | ||
| 17 | if data.get("operation") == "delete" and not stage_id: | ||
| 18 | raise ValueError("refusing to delete a production client") | ||
| 19 | existing = data.get("existing") or {} | ||
| 20 | if existing.get("clientId") and existing["clientId"] != client_id: | ||
| 21 | raise ValueError("client ID changed; migrate the existing client before deployment") | ||
| 22 | keycloak = Keycloak(data["host"], data["providerSecrets"]["password"]) | ||
| 23 | desired = { | ||
| 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 | } | ||
| 37 | path = "/admin/realms/master/clients" | ||
| 38 | query = "?" + urllib.parse.urlencode({"clientId": client_id}) | ||
| 39 | found = keycloak.request(path + query) | ||
| 40 | matches = [client for client in found if client["clientId"] == client_id] | ||
| 41 | if len(matches) > 1: | ||
| 42 | raise ValueError(f"duplicate Keycloak client: {client_id}") | ||
| 43 | if data.get("operation") == "delete": | ||
| 44 | if matches: | ||
| 45 | keycloak.request(f"{path}/{matches[0]['id']}", "DELETE") | ||
| 46 | sys.exit(0) | ||
| 47 | if 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}") | ||
| 53 | uuid = matches[0]["id"] | ||
| 54 | current = keycloak.request(f"{path}/{uuid}") | ||
| 55 | attributes = {**(current.get("attributes") or {}), **desired["attributes"]} | ||
| 56 | if 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}) | ||
| 58 | aliases = request.get("usernameAliases", {}) | ||
| 59 | if 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"]}) | ||
| 97 | secret = keycloak.request(f"{path}/{uuid}/client-secret")["value"] | ||
| 98 | if not secret: | ||
| 99 | raise ValueError(f"Keycloak client has no secret: {client_id}") | ||
| 100 | print(json.dumps({"clientId": client_id, "clientSecret": secret, "issuerUrl": f"https://{data['host']}/realms/master"})) | ||
service/keycloak/service.pkl deleted-73| ... | @@ -1,73 +0,0 @@ | ||
| 1 | extends "../../config/Service.pkl" | ||
| 2 | |||
| 3 | import "../../config/Service.pkl" as service | ||
| 4 | import "../../config/site.pkl" as site | ||
| 5 | import "../postgres/service.pkl" as postgres | ||
| 6 | |||
| 7 | class 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 | |||
| 17 | local database = new postgres.Database { name = "keycloak_next" } | ||
| 18 | |||
| 19 | meta { name = "Keycloak"; launcher = false } | ||
| 20 | traceServiceName = module.id | ||
| 21 | dependsOn { "victoria" } | ||
| 22 | healthyDeadline = "20m" | ||
| 23 | setup = "configure.py" | ||
| 24 | provide = "provide.py" | ||
| 25 | |||
| 26 | requirements { database } | ||
| 27 | |||
| 28 | container { | ||
| 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 | |||
| 70 | secrets { | ||
| 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 deletedservice/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 @@ | ||
| 1 | const 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 | |||
| 74 | function 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 | |||
| 89 | function 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 @@ | ||
| 1 | import { base64url } from "rfc4648"; | ||
| 2 | |||
| 3 | export 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 | |||
| 69 | function doRegister(publicKey) { | ||
| 70 | return navigator.credentials.create({ publicKey }); | ||
| 71 | } | ||
| 72 | |||
| 73 | function 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 | |||
| 90 | function 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 | |||
| 106 | function getTransportsAsString(transportsList) { | ||
| 107 | if (!Array.isArray(transportsList)) { | ||
| 108 | return ""; | ||
| 109 | } | ||
| 110 | |||
| 111 | return transportsList.join(); | ||
| 112 | } | ||
| 113 | |||
| 114 | function 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 | |||
| 151 | function 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 @@ | ||
| 1 | parent=base | ||
| 2 | import=common/keycloak | ||
| 3 | |||
| 4 | styles=css/styles.css | ||
| 5 | stylesCommon= | ||
| 6 | |||
| 7 | darkMode=false | ||
| 8 | |||
| 9 | kcFormGroupClass=pf-v5-c-form__group | ||
| 10 | kcFormGroupLabelClass=pf-v5-c-form__group-label pf-v5-u-pb-xs | ||
| 11 | kcFormLabelClass=pf-v5-c-form__label | ||
| 12 | kcFormLabelTextClass=pf-v5-c-form__label-text | ||
| 13 | |||
| 14 | kcLabelClass=pf-v5-c-form__label | ||
| 15 | kcInputClass=pf-v5-c-form-control | ||
| 16 | kcInputGroup=pf-v5-c-input-group | ||
| 17 | kcFormHelperTextClass=pf-v5-c-form__helper-text | ||
| 18 | kcInputHelperTextClass=pf-v5-c-helper-text pf-v5-u-display-flex pf-v5-u-justify-content-space-between | ||
| 19 | kcInputHelperTextItemClass=pf-v5-c-helper-text__item | ||
| 20 | kcInputHelperTextItemTextClass=pf-v5-c-helper-text__item-text | ||
| 21 | kcInputGroupItemClass=pf-v5-c-input-group__item | ||
| 22 | kcFill=pf-m-fill | ||
| 23 | kcError=pf-m-error | ||
| 24 | kcLoginFooterBand=pf-v5-c-login__main-footer-band | ||
| 25 | kcLoginFooterBandItem=pf-v5-c-login__main-footer-band-item | ||
| 26 | |||
| 27 | kcCheckboxClass=pf-v5-c-check | ||
| 28 | kcCheckboxInputClass=pf-v5-c-check__input | ||
| 29 | kcCheckboxLabelClass=pf-v5-c-check__label | ||
| 30 | kcCheckboxLabelRequiredClass=pf-v5-c-check__label-required | ||
| 31 | |||
| 32 | kcInputRequiredClass=pf-v5-c-form__label-required | ||
| 33 | kcInputErrorMessageClass=pf-v5-c-helper-text__item-text pf-m-error kc-feedback-text | ||
| 34 | kcFormControlUtilClass=pf-v5-c-form-control__utilities | ||
| 35 | kcInputErrorIconStatusClass=pf-v5-c-form-control__icon pf-m-status | ||
| 36 | kcInputErrorIconClass=fas fa-exclamation-circle | ||
| 37 | kcAlertClass=pf-v5-c-alert pf-m-inline pf-v5-u-mb-md | ||
| 38 | kcAlertIconClass=pf-v5-c-alert__icon | ||
| 39 | kcAlertTitleClass=pf-v5-c-alert__title | ||
| 40 | kcAlertDescriptionClass=pf-v5-c-alert__description | ||
| 41 | kcFormPasswordVisibilityButtonClass=pf-v5-c-button pf-m-control | ||
| 42 | kcFormControlToggleIcon=pf-v5-c-form-control__toggle-icon | ||
| 43 | kcFormActionGroupClass=pf-v5-c-form__actions pf-v5-u-pt-xs | ||
| 44 | kcFormReadOnlyClass=pf-m-readonly | ||
| 45 | |||
| 46 | kcPanelClass=pf-v5-c-panel pf-m-raised | ||
| 47 | kcPanelMainClass=pf-v5-c-panel__main | ||
| 48 | kcPanelMainBodyClass=pf-v5-c-panel__main-body | ||
| 49 | kcListClass=pf-v5-c-list | ||
| 50 | |||
| 51 | kcButtonClass=pf-v5-c-button | ||
| 52 | kcButtonPrimaryClass=pf-v5-c-button pf-m-primary | ||
| 53 | kcButtonSecondaryClass=pf-v5-c-button pf-m-secondary | ||
| 54 | kcButtonBlockClass=pf-m-block | ||
| 55 | kcButtonLinkClass=pf-v5-c-button pf-m-link | ||
| 56 | kcCommonLogoIdP=pf-v5-c-login__main-footer-links-item | ||
| 57 | kcFormSocialAccountListClass=pf-v5-c-login__main-body pf-v5-u-pl-0 pf-v5-u-pr-0 | ||
| 58 | kcFormSocialAccountListItemClass=pf-v5-u-pb-sm | ||
| 59 | kcFormSocialAccountNameClass=pf-v5-u-m-auto | ||
| 60 | kcFormSocialAccountListButtonClass=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 | ||
| 61 | kcFormSocialAccountListButtonDisabledClass=pf-m-aria-disabled | ||
| 62 | kcFormSocialAccountListGridClass=pf-v5-l-grid pf-m-gutter pf-m-all-6-col-on-xl pf-m-all-6-col-on-sm | ||
| 63 | kcFormSocialAccountGridItem=pf-v5-l-grid__item | ||
| 64 | |||
| 65 | kcLoginClass=pf-v5-c-login__main | ||
| 66 | kcFormClass=pf-v5-c-form pf-v5-u-w-100 | ||
| 67 | kcFormCardClass=card-pf | ||
| 68 | |||
| 69 | kcResetFlowIcon=pf-icon fas fa-share-square | ||
| 70 | |||
| 71 | kcSelectAuthListClass=pf-v5-c-data-list select-auth-container | ||
| 72 | kcSelectAuthListItemWrapperClass=pf-v5-c-data-list__item pf-m-clickable | ||
| 73 | kcSelectAuthListItemClass=pf-v5-c-data-list__item-row select-auth-box-parent | ||
| 74 | kcSelectAuthListItemHeadingClass=pf-v5-u-font-family-heading select-auth-box-headline | ||
| 75 | kcSelectAuthListItemBodyClass=pf-v5-c-data-list__cell pf-m-no-fill pf-v5-u-pt-md pf-v5-u-pb-md | ||
| 76 | kcSelectAuthListItemIconClass=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 | ||
| 77 | kcSelectAuthListItemFillClass=pf-v5-c-data-list__item-action | ||
| 78 | kcSelectAuthListItemDescriptionClass=pf-v5-c-data-list__cell pf-m-no-fill select-auth-box-desc | ||
| 79 | |||
| 80 | kcRecoveryCodesWarning=pf-v5-c-alert pf-m-warning pf-m-inline pf-v5-u-mb-md kc-recovery-codes-warning | ||
| 81 | kcLogin=pf-v5-c-login | ||
| 82 | kcLoginContainer=pf-v5-c-login__container | ||
| 83 | kcLoginMain=pf-v5-c-login__main | ||
| 84 | kcLoginMainHeader=pf-v5-c-login__main-header | ||
| 85 | kcLoginMainFooter=pf-v5-c-login__main-footer | ||
| 86 | kcLoginMainFooterBand=pf-v5-c-login__main-footer-band | ||
| 87 | kcLoginMainFooterBandItem=pf-v5-c-login__main-footer-band-item | ||
| 88 | kcLoginMainFooterHelperText=pf-v5-u-font-size-sm pf-v5-u-color-200 | ||
| 89 | kcLoginMainTitle=pf-v5-c-title pf-m-3xl | ||
| 90 | kcLoginMainHeaderUtilities=pf-v5-c-login__main-header-utilities | ||
| 91 | kcLoginMainBody=pf-v5-c-login__main-body | ||
| 92 | |||
| 93 | kcContentWrapperClass=pf-v5-u-mb-md-on-md | ||
| 94 | kcWebAuthnDefaultIcon=pf-v5-c-icon pf-m-lg | ||
| 95 | kcMarginTopClass=pf-v5-u-mt-md-on-md | ||
| 96 | |||
| 97 | kcLoginOTPListClass=pf-v5-c-tile | ||
| 98 | kcLoginOTPListItemHeaderClass=pf-v5-c-tile__header pf-m-stacked | ||
| 99 | kcLoginOTPListItemIconBodyClass=pf-v5-c-tile__icon | ||
| 100 | kcLoginOTPListItemIconClass=fa fa-mobile | ||
| 101 | kcLoginOTPListItemTitleClass=pf-v5-c-tile__title | ||
| 102 | kcLoginOTPListSelectedClass=pf-m-selected | ||
| 103 | |||
| 104 | kcCopyIconClass=fas fa-copy | ||
| 105 | kcCheckIconClass=fas fa-check | ||
| 106 | kcAngleRightIconClass=fas fa-angle-right | ||
| 107 | kcAngleDownIconClass=fas fa-angle-down | ||
| 108 | kcExpandedClass=pf-m-expanded | ||
| 109 | |||
| 110 | kcCodeClipboardCopyClass=pf-v5-c-clipboard-copy | ||
| 111 | kcCodeClipboardCopyGroupClass=pf-v5-c-clipboard-copy__group | ||
| 112 | kcCodeClipboardCopyContentClass=pf-v5-c-clipboard-copy__expandable-content | ||
| 113 | |||
| 114 | kcDarkModeClass=pf-v5-theme-dark | ||
| 115 | |||
| 116 | kcHtmlClass=login-pf | ||
| 117 | kcLogoIdP-facebook= | ||
| 118 | kcLogoIdP-google= | ||
| 119 | kcLogoIdP-github= | ||
| 120 | kcLogoIdP-linkedin= | ||
| 121 | kcLogoIdP-instagram= | ||
| 122 | kcLogoIdP-microsoft= | ||
| 123 | kcLogoIdP-bitbucket= | ||
| 124 | kcLogoIdP-gitlab= | ||
| 125 | kcLogoIdP-paypal= | ||
| 126 | kcLogoIdP-stackoverflow= | ||
| 127 | kcLogoIdP-twitter= | ||
| 128 | kcLogoIdP-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 |
| 14 | 14 | ||
| 15 | bundle = json.loads(Path(__file__).with_name("bundle.json").read_text()) | 15 | bundle = json.loads(Path(__file__).with_name("bundle.json").read_text()) |
| 16 | if subprocess.run(["podman", "image", "exists", bundle["image"]]).returncode: | 16 | if 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 |
| 5 | 5 | ||
| 6 | local bundle = (new json.Parser {}).parse(read("bundle.json")) | 6 | local bundle = (new json.Parser {}).parse(read("bundle.json")) |
| 7 | 7 | ||
| 8 | meta { name = "The Knife"; access = "infra-admin" } | 8 | name = "The Knife" |
| 9 | access = "infra-admin" | ||
| 9 | requirements { | 10 | requirements { |
| 10 | new sso.Client { | 11 | new sso.Client { |
| 11 | clientId = module.id | 12 | clientId = module.id |
| 12 | name = module.meta.name | 13 | 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 |
| 24 | RUN set -e; SP=$(venv/bin/python -c 'import vllm,os; print(os.path.dirname(vllm.__file__))' | tail -n1); \ | 24 | RUN 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 --install | 26 | bash verify.sh --install |
| 27 | COPY cache /tmp/studio-ai-cache | 27 | COPY cache /tmp/snowglobe-ai-cache |
| 28 | RUN venv/bin/pip install /tmp/studio-ai-cache && venv/bin/pip check && rm -rf /tmp/studio-ai-cache | 28 | RUN venv/bin/pip install /tmp/snowglobe-ai-cache && venv/bin/pip check && rm -rf /tmp/snowglobe-ai-cache |
| 29 | ENV HOME=/cache VLLM_NO_USAGE_STATS=1 DO_NOT_TRACK=1 HF_HUB_OFFLINE=1 | 29 | ENV HOME=/cache VLLM_NO_USAGE_STATS=1 DO_NOT_TRACK=1 HF_HUB_OFFLINE=1 |
| 30 | RUN mkdir -p /cache && chmod 1777 /cache | 30 | RUN mkdir -p /cache && chmod 1777 /cache |
| 31 | COPY steering /app/steering | 31 | COPY steering /app/steering |
| 32 | RUN patch --batch -p1 -d /app/venv/lib/python3.12/site-packages/vllm < /app/steering/runtime.patch | 32 | RUN patch --batch -p1 -d /app/venv/lib/python3.12/site-packages/vllm < /app/steering/runtime.patch |
| 33 | ENV PYTHONPATH=/app/steering STUDIO_STEERING_DIR=/app/steering | 33 | ENV 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"] |
| 3 | build-backend = "setuptools.build_meta" | 3 | build-backend = "setuptools.build_meta" |
| 4 | 4 | ||
| 5 | [project] | 5 | [project] |
| 6 | name = "studio-ai-cache" | 6 | name = "snowglobe-ai-cache" |
| 7 | version = "1.0.0" | 7 | version = "1.0.0" |
| 8 | dependencies = ["cryptography==50.0.2"] | 8 | dependencies = ["cryptography==50.0.2"] |
| 9 | 9 | ||
| 10 | [project.entry-points."vllm.general_plugins"] | 10 | [project.entry-points."vllm.general_plugins"] |
| 11 | studio_ai_cache = "studio_ai_cache_vllm:register" | 11 | snowglobe_ai_cache = "snowglobe_ai_cache_vllm:register" |
| 12 | 12 | ||
| 13 | [tool.setuptools] | 13 | [tool.setuptools] |
| 14 | py-modules = ["studio_ai_cache", "studio_ai_cache_vllm"] | 14 | py-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.""" | ||
| 2 | from collections import OrderedDict | ||
| 3 | import fcntl | ||
| 4 | import logging | ||
| 5 | import mmap | ||
| 6 | import os | ||
| 7 | from pathlib import Path | ||
| 8 | import struct | ||
| 9 | import threading | ||
| 10 | |||
| 11 | from cryptography.exceptions import InvalidTag | ||
| 12 | from cryptography.hazmat.primitives.ciphers.aead import AESGCM | ||
| 13 | |||
| 14 | |||
| 15 | class 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.""" | ||
| 2 | import functools | ||
| 3 | import hashlib | ||
| 4 | import os | ||
| 5 | from pathlib import Path | ||
| 6 | |||
| 7 | import vllm | ||
| 8 | from vllm.v1.kv_offload.base import LookupResult, Medium | ||
| 9 | from vllm.v1.kv_offload.file_mapper import FileMapper | ||
| 10 | from vllm.v1.kv_offload.tiering.base import JobResult, RequestOffloadingContext, SecondaryTierManager | ||
| 11 | from vllm.v1.kv_offload.tiering.factory import SecondaryTierFactory | ||
| 12 | from vllm.v1.kv_offload.tiering.fs.thread_pool import DualQueueThreadPool | ||
| 13 | |||
| 14 | from snowglobe_ai_cache import DiskCache | ||
| 15 | |||
| 16 | |||
| 17 | class 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 | |||
| 72 | def 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.""" | ||
| 2 | from collections import OrderedDict | ||
| 3 | import fcntl | ||
| 4 | import logging | ||
| 5 | import mmap | ||
| 6 | import os | ||
| 7 | from pathlib import Path | ||
| 8 | import struct | ||
| 9 | import threading | ||
| 10 | |||
| 11 | from cryptography.exceptions import InvalidTag | ||
| 12 | from cryptography.hazmat.primitives.ciphers.aead import AESGCM | ||
| 13 | |||
| 14 | |||
| 15 | class 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.""" | ||
| 2 | import functools | ||
| 3 | import hashlib | ||
| 4 | import os | ||
| 5 | from pathlib import Path | ||
| 6 | |||
| 7 | import vllm | ||
| 8 | from vllm.v1.kv_offload.base import LookupResult, Medium | ||
| 9 | from vllm.v1.kv_offload.file_mapper import FileMapper | ||
| 10 | from vllm.v1.kv_offload.tiering.base import JobResult, RequestOffloadingContext, SecondaryTierManager | ||
| 11 | from vllm.v1.kv_offload.tiering.factory import SecondaryTierFactory | ||
| 12 | from vllm.v1.kv_offload.tiering.fs.thread_pool import DualQueueThreadPool | ||
| 13 | |||
| 14 | from studio_ai_cache import DiskCache | ||
| 15 | |||
| 16 | |||
| 17 | class 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 | |||
| 72 | def 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 |
| 5 | import tempfile | 5 | import tempfile |
| 6 | import unittest | 6 | import unittest |
| 7 | 7 | ||
| 8 | from studio_ai_cache import DiskCache | 8 | from snowglobe_ai_cache import DiskCache |
| 9 | 9 | ||
| 10 | 10 | ||
| 11 | class CacheTests(unittest.TestCase): | 11 | class 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 |
| 13 | from vllm.v1.kv_offload.tiering.factory import SecondaryTierFactory | 13 | from vllm.v1.kv_offload.tiering.factory import SecondaryTierFactory |
| 14 | from vllm.v1.kv_offload.tiering.manager import CPUPrimaryTierOffloadingManager, TieringOffloadingManager | 14 | from vllm.v1.kv_offload.tiering.manager import CPUPrimaryTierOffloadingManager, TieringOffloadingManager |
| 15 | 15 | ||
| 16 | from studio_ai_cache_vllm import register | 16 | from snowglobe_ai_cache_vllm import register |
| 17 | 17 | ||
| 18 | 18 | ||
| 19 | class VllmCacheTests(unittest.TestCase): | 19 | class 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 |
| 13 | 13 | ||
| 14 | WAIT_SECONDS = 8 * 60 * 60 | 14 | WAIT_SECONDS = 8 * 60 * 60 |
| 15 | HOP_HEADERS = {"connection", "transfer-encoding", "content-length", "host", "accept-encoding"} | 15 | HOP_HEADERS = {"connection", "transfer-encoding", "content-length", "host", "accept-encoding"} |
| 16 | STEERING_DIR = Path(os.environ.get("STUDIO_STEERING_DIR", Path(__file__).with_name("steering"))) | 16 | STEERING_DIR = Path(os.environ.get("SNOWGLOBE_STEERING_DIR", Path(__file__).with_name("steering"))) |
| 17 | STEERING_REVISION = hashlib.sha256(b"".join( | 17 | STEERING_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() |
| 21 | 21 | ||
| 22 | 22 | ||
| ... | @@ -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 |
| 7 | local model = models[0] | 7 | local model = models[0] |
| 8 | local weights = (new json.Parser {}).parse(read("models.json")) | 8 | local weights = (new json.Parser {}).parse(read("models.json")) |
| 9 | 9 | ||
| 10 | meta { name = "Local AI"; launcher = false; access = "admin" } | 10 | name = "Local AI" |
| 11 | enabled = (read?("env:STUDIO_LOCAL_AI") ?? "false") == "true" | 11 | launcher = false |
| 12 | rollout = "simple" | 12 | access = "admin" |
| 13 | enabled = (read?("env:SNOWGLOBE_LOCAL_AI") ?? "false") == "true" | ||
| 13 | stageIsolation = "fresh" | 14 | stageIsolation = "fresh" |
| 14 | prepare = "prepare.py" | 15 | prepare = "prepare.py" |
| 15 | healthyDeadline = "30m" | 16 | healthyDeadline = "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. |
| 13 | Normal rows preserve both residual branches unchanged. The MTP drafter uses | 13 | Normal rows preserve both residual branches unchanged. The MTP drafter uses |
| 14 | the resulting target hidden states; its separate layer is not steered. | 14 | the resulting target hidden states; its separate layer is not steered. |
| 15 | 15 | ||
| 16 | GPU verification at full strength on 2026-10-16 used Swift's existing INT4 weights on Zenith's | 16 | GPU verification at full strength on 2026-10-16 used Swift's existing INT4 weights on Snow Globe's |
| 17 | RTX 3090. CUDA graph replay preserved normal rows exactly. Sixteen concurrent | 17 | RTX 3090. CUDA graph replay preserved normal rows exactly. Sixteen concurrent |
| 18 | mixed-model requests selected the correct behavior. Identical 7,526-token | 18 | mixed-model requests selected the correct behavior. Identical 7,526-token |
| 19 | prompts had zero cross-model cache hits and 6,656 same-model reuse hits. | 19 | prompts 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 torch | 5 | import torch |
| 6 | from torch import nn | 6 | from torch import nn |
| 7 | +from studio_ai_steering import GoldenGateSteering | 7 | +from snowglobe_ai_steering import GoldenGateSteering |
| 8 | 8 | ||
| 9 | from vllm._aiter_ops import rocm_aiter_ops | 9 | from vllm._aiter_ops import rocm_aiter_ops |
| 10 | from vllm.compilation.decorators import support_torch_compile | 10 | from vllm.compilation.decorators import support_torch_compile |
| ... | @@ -37,7 +37,7 @@ | ... | @@ -37,7 +37,7 @@ |
| 37 | from vllm.platforms import current_platform | 37 | from vllm.platforms import current_platform |
| 38 | from vllm.pooling_params import PoolingParams | 38 | from vllm.pooling_params import PoolingParams |
| 39 | from vllm.sampling_params import SamplingType | 39 | from vllm.sampling_params import SamplingType |
| 40 | +from studio_ai_steering import GoldenGateSteering | 40 | +from snowglobe_ai_steering import GoldenGateSteering |
| 41 | from vllm.sequence import IntermediateTensors | 41 | from vllm.sequence import IntermediateTensors |
| 42 | from vllm.tasks import GenerationTask, PoolingTask, SupportedTask | 42 | from vllm.tasks import GenerationTask, PoolingTask, SupportedTask |
| 43 | from vllm.tracing import instrument | 43 | from vllm.tracing import instrument |
service/local-ai/steering/snowglobe_ai_steering.py created+38| ... | @@ -0,0 +1,38 @@ | ||
| 1 | from pathlib import Path | ||
| 2 | |||
| 3 | import torch | ||
| 4 | from safetensors.torch import load_file | ||
| 5 | |||
| 6 | |||
| 7 | class 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 @@ | ||
| 1 | from pathlib import Path | ||
| 2 | |||
| 3 | import torch | ||
| 4 | from safetensors.torch import load_file | ||
| 5 | |||
| 6 | |||
| 7 | class 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 |
| 3 | 3 | ||
| 4 | import torch | 4 | import torch |
| 5 | 5 | ||
| 6 | from studio_ai_steering import GoldenGateSteering | 6 | from snowglobe_ai_steering import GoldenGateSteering |
| 7 | 7 | ||
| 8 | 8 | ||
| 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() |
| 26 | 26 | ||
| 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" |
| 2 | 2 | ||
| 3 | import "../../config/site.pkl" as site | 3 | import "../../config/site.pkl" as site |
| 4 | 4 | ||
| 5 | meta { name = "Navidrome" } | 5 | name = "Navidrome" |
| 6 | 6 | ||
| 7 | container { | 7 | container { |
| 8 | image = "docker.io/deluan/navidrome@sha256:59ce76e6e06193fbfbb1736a93b8468227e1ea663fc7b25b1da13fbb97f5197b" | 8 | image = "docker.io/deluan/navidrome@sha256:59ce76e6e06193fbfbb1736a93b8468227e1ea663fc7b25b1da13fbb97f5197b" |
| 9 | cpu = 200 | ||
| 10 | memory = 512 | ||
| 11 | 9 | ||
| 12 | http { | 10 | http { |
| 13 | containerPort = 4533 | 11 | containerPort = 4533 |
service/openclaw/service.pkl+4-5| ... | @@ -1,7 +1,8 @@ | ... | @@ -1,7 +1,8 @@ |
| 1 | amends "../../config/Service.pkl" | 1 | amends "../../config/Service.pkl" |
| 2 | 2 | ||
| 3 | meta { name = "OpenClaw"; access = "infra-admin" } | 3 | name = "OpenClaw" |
| 4 | enabled = (read?("env:STUDIO_LOCAL_AI") ?? "false") == "true" | 4 | access = "infra-admin" |
| 5 | enabled = (read?("env:SNOWGLOBE_LOCAL_AI") ?? "false") == "true" | ||
| 5 | stageIsolation = "fresh" | 6 | stageIsolation = "fresh" |
| 6 | healthyDeadline = "30m" | 7 | healthyDeadline = "30m" |
| 7 | healthRestartGrace = "30m" | 8 | healthRestartGrace = "30m" |
| ... | @@ -14,7 +15,6 @@ containers { | ... | @@ -14,7 +15,6 @@ containers { |
| 14 | hostNetwork = true | 15 | 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 = 256 | 18 | memory = 256 |
| 19 | http { | 19 | http { |
| 20 | containerPort = 18889 | 20 | 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 = true | 35 | 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 = 256 | 38 | 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 @@ |
| 1 | amends "../../config/Service.pkl" | 1 | amends "../../config/Service.pkl" |
| 2 | 2 | ||
| 3 | meta { name = "Open Speed Test" } | 3 | name = "Open Speed Test" |
| 4 | rollout = "overlapped" | 4 | rollout = "overlapped" |
| 5 | healthRestartGrace = "30s" | 5 | healthRestartGrace = "30s" |
| 6 | 6 |
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 |
| 4 | 4 | ||
| 5 | local isolated = site.preview || site.domain.endsWith(".test") | 5 | local isolated = site.preview || site.domain.endsWith(".test") |
| 6 | 6 | ||
| 7 | meta { name = "ATProto PDS"; launcher = false } | 7 | name = "ATProto PDS" |
| 8 | launcher = false | ||
| 8 | traceServiceName = module.id | 9 | traceServiceName = module.id |
| 9 | metricsPushed = true | 10 | metricsPushed = true |
| 10 | rollout = "simple" | ||
| 11 | stageIsolation = "fresh" | 11 | stageIsolation = "fresh" |
| 12 | dependsOn { "victoria" } | 12 | dependsOn { "victoria" } |
| 13 | 13 | ||
| ... | @@ -29,9 +29,8 @@ requiredSecrets = if (isolated) new {} else new { | ... | @@ -29,9 +29,8 @@ requiredSecrets = if (isolated) new {} else new { |
| 29 | container { | 29 | container { |
| 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 = 250 | 33 | cpu = 250 |
| 34 | memory = 512 | ||
| 35 | 34 | ||
| 36 | http { | 35 | http { |
| 37 | containerPort = 3000 | 36 | containerPort = 3000 |
| ... | @@ -41,7 +40,7 @@ container { | ... | @@ -41,7 +40,7 @@ container { |
| 41 | 40 | ||
| 42 | volumes { | 41 | volumes { |
| 43 | ["/pds"] {} | 42 | ["/pds"] {} |
| 44 | ["/studio/start.sh"] { config = "start.sh" } | 43 | ["/snowglobe/start.sh"] { config = "start.sh" } |
| 45 | } | 44 | } |
| 46 | 45 | ||
| 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" |
| 3 | import "service.pkl" as postgres | 3 | import "service.pkl" as postgres |
| 4 | import "../../config/site.pkl" as site | 4 | import "../../config/site.pkl" as site |
| 5 | 5 | ||
| 6 | meta { name = "pgAdmin" } | 6 | name = "pgAdmin" |
| 7 | healthyDeadline = "15m" | 7 | healthyDeadline = "15m" |
| 8 | requirements { new postgres.AdminConnection {} } | 8 | requirements { new postgres.AdminConnection {} } |
| 9 | 9 | ||
| ... | @@ -14,9 +14,8 @@ secrets { | ... | @@ -14,9 +14,8 @@ secrets { |
| 14 | container { | 14 | container { |
| 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 = 150 | 18 | cpu = 150 |
| 19 | memory = 512 | ||
| 20 | 19 | ||
| 21 | http { | 20 | http { |
| 22 | containerPort = 5050 | 21 | containerPort = 5050 |
| ... | @@ -27,7 +26,7 @@ container { | ... | @@ -27,7 +26,7 @@ container { |
| 27 | 26 | ||
| 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 | } |
| 32 | 31 | ||
| 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 | } |
| 18 | 18 | ||
| 19 | meta { name = "Postgres" } | 19 | name = "Postgres" |
| 20 | provide = "provide.py" | 20 | provide = "provide.py" |
| 21 | 21 | ||
| 22 | container { | 22 | container { |
service/qbittorrent/service.pkl+1-3| ... | @@ -2,8 +2,7 @@ amends "../../config/Service.pkl" | ... | @@ -2,8 +2,7 @@ amends "../../config/Service.pkl" |
| 2 | 2 | ||
| 3 | import "../../config/site.pkl" as site | 3 | import "../../config/site.pkl" as site |
| 4 | 4 | ||
| 5 | meta { name = "qBittorrent" } | 5 | name = "qBittorrent" |
| 6 | rollout = "simple" | ||
| 7 | healthyDeadline = "15m" | 6 | healthyDeadline = "15m" |
| 8 | prepare = "prepare.py" | 7 | prepare = "prepare.py" |
| 9 | 8 | ||
| ... | @@ -15,7 +14,6 @@ requiredSecrets { | ... | @@ -15,7 +14,6 @@ requiredSecrets { |
| 15 | container { | 14 | container { |
| 16 | image = "docker.io/binhex/arch-qbittorrentvpn@sha256:7320d195ca582b236207b88f483319cd49b08c0665b22b945c3d4cebcb601a17" | 15 | image = "docker.io/binhex/arch-qbittorrentvpn@sha256:7320d195ca582b236207b88f483319cd49b08c0665b22b945c3d4cebcb601a17" |
| 17 | imageUser = true | 16 | imageUser = true |
| 18 | cpu = 200 | ||
| 19 | memory = 1024 | 17 | 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" |
| 2 | 2 | ||
| 3 | import "../../config/site.pkl" as site | 3 | import "../../config/site.pkl" as site |
| 4 | 4 | ||
| 5 | meta { name = "Radarr" } | 5 | name = "Radarr" |
| 6 | setup = "tools/configure-arr.py" | 6 | setup = "tools/configure-arr.py" |
| 7 | dependsOn { | 7 | dependsOn { |
| 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" |
| 2 | 2 | ||
| 3 | import "../../config/site.pkl" as site | 3 | import "../../config/site.pkl" as site |
| 4 | 4 | ||
| 5 | meta { name = "Samba" } | 5 | name = "Samba" |
| 6 | 6 | ||
| 7 | container { | 7 | container { |
| 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") |
| 18 | path = root / "data/astheno.shale.db" | 18 | path = root / "data/astheno.shale.db" |
| 19 | if path.exists(): | 19 | if path.exists(): |
| 20 | domain = os.environ["STUDIO_DOMAIN"] | 20 | domain = os.environ["SNOWGLOBE_DOMAIN"] |
| 21 | old, new = "auth." + domain + "/realms/master", "snowglobe." + domain | 21 | 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" |
| 3 | import "../../config/OpenID.pkl" as sso | 3 | import "../../config/OpenID.pkl" as sso |
| 4 | import "../../config/site.pkl" as site | 4 | import "../../config/site.pkl" as site |
| 5 | 5 | ||
| 6 | meta { | 6 | name = "Shale" |
| 7 | name = "Shale" | ||
| 8 | } | ||
| 9 | requirements { | 7 | requirements { |
| 10 | new sso.Client { | 8 | new sso.Client { |
| 11 | clientId = module.id | 9 | clientId = module.id |
| 12 | name = module.meta.name | 10 | 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 = true | 13 | allowGuests = true |
| ... | @@ -21,7 +19,6 @@ prepare = "prepare.py" | ... | @@ -21,7 +19,6 @@ prepare = "prepare.py" |
| 21 | container { | 19 | container { |
| 22 | memory = 4096 | 20 | memory = 4096 |
| 23 | image = "docker.io/astheno/shale@sha256:b55cc42c4eb2c1e21733405bec795e49ddd7c71fb1755d2aa2ee4361f750cebd" | 21 | image = "docker.io/astheno/shale@sha256:b55cc42c4eb2c1e21733405bec795e49ddd7c71fb1755d2aa2ee4361f750cebd" |
| 24 | extraHosts { "\(sso.hostname):host-gateway" } | ||
| 25 | 22 | ||
| 26 | http { | 23 | http { |
| 27 | containerPort = 8000 | 24 | 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 = true | 46 | 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" |
| 2 | 2 | ||
| 3 | import "../../config/site.pkl" as site | 3 | import "../../config/site.pkl" as site |
| 4 | 4 | ||
| 5 | meta { name = "Sonarr" } | 5 | name = "Sonarr" |
| 6 | setup = "tools/configure-arr.py" | 6 | setup = "tools/configure-arr.py" |
| 7 | dependsOn { | 7 | dependsOn { |
| 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" |
| 2 | 2 | ||
| 3 | import "../../config/site.pkl" as site | 3 | import "../../config/site.pkl" as site |
| 4 | 4 | ||
| 5 | meta { name = "Tailscale" } | 5 | name = "Tailscale" |
| 6 | 6 | ||
| 7 | container { | 7 | container { |
| 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 @@ |
| 1 | amends "../../config/Service.pkl" | 1 | amends "../../config/Service.pkl" |
| 2 | 2 | ||
| 3 | meta { name = "Victoria"; tagline = "Metrics, logs, and traces" } | 3 | name = "Victoria" |
| 4 | tagline = "Metrics, logs, and traces" | ||
| 4 | 5 | ||
| 5 | containers { | 6 | containers { |
| 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 = 300 | 9 | cpu = 300 |
| 9 | memory = 512 | ||
| 10 | args { "-storageDataPath=/logs"; "-retentionPeriod=30d" } | 10 | args { "-storageDataPath=/logs"; "-retentionPeriod=30d" } |
| 11 | 11 | ||
| 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 = 300 | 24 | cpu = 300 |
| 25 | memory = 512 | ||
| 26 | args { "-storageDataPath=/metrics"; "-retentionPeriod=30d"; "-usePromCompatibleNaming" } | 25 | args { "-storageDataPath=/metrics"; "-retentionPeriod=30d"; "-usePromCompatibleNaming" } |
| 27 | 26 | ||
| 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 = 300 | 40 | cpu = 300 |
| 42 | memory = 512 | ||
| 43 | args { "-storageDataPath=/traces"; "-retentionPeriod=30d" } | 41 | args { "-storageDataPath=/traces"; "-retentionPeriod=30d" } |
| 44 | 42 | ||
| 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 |
| 4 | 4 | ||
| 5 | data_path = "/var/lib/prosody" | 5 | data_path = "/var/lib/prosody" |
| 6 | pidfile = "/var/lib/prosody/prosody.pid" | 6 | pidfile = "/var/lib/prosody/prosody.pid" |
| 7 | plugin_paths = { "/opt/prosody-modules", "/studio" } | 7 | plugin_paths = { "/opt/prosody-modules", "/snowglobe" } |
| 8 | admins = { "clover@" .. domain } | 8 | admins = { "clover@" .. domain } |
| 9 | bootstrap_password = ENV_XMPP_PASSWORD | 9 | bootstrap_password = ENV_XMPP_PASSWORD |
| 10 | authentication = "internal_hashed" | 10 | authentication = "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) |
| 8 | local host = read?("prop:hostname") ?? "xmpp.\(site.domain)" | 8 | local host = read?("prop:hostname") ?? "xmpp.\(site.domain)" |
| 9 | local accountDomain = if (site.preview) host else site.domain | 9 | local accountDomain = if (site.preview) host else site.domain |
| 10 | 10 | ||
| 11 | meta { name = "XMPP"; launcher = false } | 11 | name = "XMPP" |
| 12 | launcher = false | ||
| 12 | stageIsolation = "fresh" | 13 | stageIsolation = "fresh" |
| 13 | healthyDeadline = "10m" | 14 | healthyDeadline = "10m" |
| 14 | setup = "setup.py" | 15 | setup = "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 = true | 33 | hostNetwork = true |
| 33 | lifecycle = "prestartSidecar" | 34 | lifecycle = "prestartSidecar" |
| 34 | cpu = 100 | 35 | cpu = 100 |
| 35 | memory = 256 | 36 | memory = 256 |
| 36 | volumes { ["/tls"] {}; ["/studio"] { config = "runtime" } } | 37 | volumes { ["/tls"] {}; ["/snowglobe"] { config = "runtime" } } |
| 37 | env { | 38 | env { |
| 38 | ["XMPP_DOMAIN"] = accountDomain | 39 | ["XMPP_DOMAIN"] = accountDomain |
| 39 | ["XMPP_HOST"] = host | 40 | ["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 = true | 49 | 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 = true | 76 | hostNetwork = true |
| 77 | memory = 256 | 77 | 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() |
| 23 | 23 | ||
| 24 | stage = sys.argv[1] | 24 | stage = sys.argv[1] |
| 25 | metadata = Path("/var/lib/studio/stages") / (stage + ".json") | 25 | metadata = Path("/var/lib/snowglobe/stages") / (stage + ".json") |
| 26 | network = json.loads(Path(__file__).with_name("network.json").read_text()) | 26 | network = json.loads(Path(__file__).with_name("network.json").read_text()) |
| 27 | rules = [ | 27 | rules = [ |
| 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 |
| 4 | 4 | ||
| 5 | local passive = site.preview || site.mediaReadOnly | 5 | local passive = site.preview || site.mediaReadOnly |
| 6 | 6 | ||
| 7 | meta { name = "YTDL" } | 7 | name = "YTDL" |
| 8 | 8 | ||
| 9 | requiredSecrets { | 9 | requiredSecrets { |
| 10 | "smtp_host" | 10 | "smtp_host" |
| ... | @@ -43,7 +43,6 @@ containers { | ... | @@ -43,7 +43,6 @@ containers { |
| 43 | else | 43 | 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 512 | 46 | memory = if (passive) 256 else 512 |
| 48 | 47 | ||
| 49 | http = if (passive) new { | 48 | http = if (passive) new { |
tools/check-legacy-handoff.sh deleted-24| ... | @@ -1,24 +0,0 @@ | ||
| 1 | #!/bin/sh | ||
| 2 | set -eu | ||
| 3 | |||
| 4 | handoff=${1:?Expected a legacy handoff directory} | ||
| 5 | target=${2:?Expected a production target} | ||
| 6 | port=${3:?Expected a target SSH port} | ||
| 7 | printf '%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 | } | ||
| 11 | ssh -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 |
| 6 | import urllib.request | 6 | import urllib.request |
| 7 | import xml.etree.ElementTree as ET | 7 | import xml.etree.ElementTree as ET |
| 8 | 8 | ||
| 9 | from studio import load | 9 | from snowglobe import load |
| 10 | 10 | ||
| 11 | 11 | ||
| 12 | data = json.load(sys.stdin) | 12 | data = json.load(sys.stdin) |
tools/copyparty-cutover-test.py deleted-299| ... | @@ -1,299 +0,0 @@ | ||
| 1 | #!/usr/bin/env python3 | ||
| 2 | import importlib.util | ||
| 3 | import json | ||
| 4 | import os | ||
| 5 | from pathlib import Path | ||
| 6 | import sqlite3 | ||
| 7 | import sys | ||
| 8 | import tempfile | ||
| 9 | import unittest | ||
| 10 | from unittest.mock import patch | ||
| 11 | |||
| 12 | spec = importlib.util.spec_from_file_location('cutover', Path(__file__).with_name('copyparty-cutover.py')) | ||
| 13 | cutover = importlib.util.module_from_spec(spec) | ||
| 14 | spec.loader.exec_module(cutover) | ||
| 15 | copyparty = cutover.copyparty | ||
| 16 | public_statuses = cutover.public_statuses | ||
| 17 | |||
| 18 | |||
| 19 | class 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 | |||
| 298 | if __name__ == '__main__': | ||
| 299 | unittest.main() | ||
tools/copyparty-cutover.py deleted-279| ... | @@ -1,279 +0,0 @@ | ||
| 1 | #!/usr/bin/env python3 | ||
| 2 | import argparse | ||
| 3 | import concurrent.futures | ||
| 4 | import copy | ||
| 5 | import hashlib | ||
| 6 | import importlib.util | ||
| 7 | import json | ||
| 8 | import os | ||
| 9 | import re | ||
| 10 | from pathlib import Path | ||
| 11 | import sqlite3 | ||
| 12 | import socket | ||
| 13 | import subprocess | ||
| 14 | import stat | ||
| 15 | import time | ||
| 16 | import uuid | ||
| 17 | from urllib.parse import quote | ||
| 18 | |||
| 19 | |||
| 20 | spec = importlib.util.spec_from_file_location("copyparty", Path(__file__).resolve().parent.parent / "service/copyparty/manage.py") | ||
| 21 | copyparty = importlib.util.module_from_spec(spec) | ||
| 22 | spec.loader.exec_module(copyparty) | ||
| 23 | |||
| 24 | |||
| 25 | MOVES = ( | ||
| 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 | |||
| 35 | def digest(value): | ||
| 36 | return hashlib.sha256(json.dumps(value, ensure_ascii=False, separators=(',', ':')).encode()).hexdigest() | ||
| 37 | |||
| 38 | |||
| 39 | def 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 | |||
| 48 | def mappings(manager): | ||
| 49 | return [(manager.root / source, manager.root / 'Share' / name) for source, name in MOVES] | ||
| 50 | |||
| 51 | |||
| 52 | def 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 | |||
| 67 | def 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 | |||
| 89 | def 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 | |||
| 113 | def 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 | |||
| 126 | def 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 | |||
| 147 | def 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 | |||
| 155 | def 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 | |||
| 258 | def 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 | |||
| 278 | if __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 cutover | 1 | # Copyparty administration |
| 2 | 2 | ||
| 3 | Snowglobe's admin Shares page manages native public links and separate API | 3 | Snow Globe's Shares page manages native public links and separate API |
| 4 | accounts. A person's page assigns folder permissions. Existing Copyparty | 4 | accounts. A person's page assigns folder permissions. Existing Copyparty |
| 5 | permissions remain additive; changing a folder is an explicit retarget or move | 5 | permissions remain additive; changing a folder is an explicit retarget or move |
| 6 | action. New shared folders default to `Share/Name - Description` under Clover. | 6 | action. New shared folders default to `Share/Name - Description` under Clover. |
| 7 | The legacy `clover/Public` mount is retired; use managed links and grants. | ||
| 8 | 7 | ||
| 9 | Copyparty owns its native `cfg/copyparty/shares.db` and selected-file records. | 8 | Copyparty owns its native `cfg/copyparty/shares.db` and selected-file records. |
| 10 | `cfg/manager.json` stores API account labels, UUID-based folder grants, and link | 9 | `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 |
| 13 | config file cannot recover managed accounts. `prepare.py` regenerates config | 12 | config file cannot recover managed accounts. `prepare.py` regenerates config |
| 14 | from the canonical service policy and managed state on every deployment. | 13 | from the canonical service policy and managed state on every deployment. |
| 15 | 14 | ||
| 16 | ## Six-folder production move | 15 | A folder move must update the native share paths and selected-file records |
| 17 | 16 | while Copyparty is stopped, preserving keys, passwords, permissions, expirations, | |
| 18 | `copyparty-cutover.py` contains the requested six source/destination pairs. | 17 | and selected files. Code rollback does not undo filesystem moves. Rehearse on |
| 19 | It requires a reviewed plan, absent destinations, and same-filesystem renames. | 18 | clones, retain restricted database/config backups, and verify the original |
| 20 | The plan binds the host, service, roots, source metadata, and complete native | 19 | public links after restart. The completed six-folder move's recovery evidence |
| 21 | share projection. No file contents are read. Public HEAD responses are captured | 20 | remains at `/var/lib/snowglobe/copyparty-cutover/20261016T082910Z-424b5410`. |
| 22 | before stopping the service and verified after restart; existing keys, | 21 | |
| 23 | passwords, permissions, expirations, and selected-file records must agree. | 22 | The privileged host unit reaches Copyparty through Podman's declared bridge |
| 24 | 23 | subnet. A loopback-only network allowlist prevents configuration reloads even | |
| 25 | Run the script from the reviewed immutable release on the confirmed target: | 24 | when its destination is a loopback-forwarded container port. Keep the derived |
| 26 | 25 | bridge access when changing host restrictions. | |
| 27 | ```sh | ||
| 28 | umask 077 | ||
| 29 | python3 tools/copyparty-cutover.py --plan /root/copyparty-cutover-plan.json | ||
| 30 | python3 tools/copyparty-cutover.py --apply --plan /root/copyparty-cutover-plan.json | ||
| 31 | ``` | ||
| 32 | |||
| 33 | Copyparty remains stopped through all folder and database changes. A mismatch | ||
| 34 | restores the old paths and records before restarting the frozen original job. | ||
| 35 | Mutation verification has an 80-second cutoff; public readiness has a | ||
| 36 | 150-second forward deadline, leaving recovery time within the 285-second | ||
| 37 | overall 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 | |||
| 42 | Zenith preview `copyparty-preview-9909de81` verified API account scope, | ||
| 43 | permission changes, password/session revocation, signed UUID identity grants, | ||
| 44 | symlink confinement, selected-file retention, and nested public links. A | ||
| 45 | disposable offline move completed in 6.94 seconds. The six requested clone | ||
| 46 | folders were then renamed with unchanged inode/metadata manifests: all 20 | ||
| 47 | share records and four selected-file rows matched the expected path-only | ||
| 48 | projection, and all nine affected public URLs returned their original 200 | ||
| 49 | responses within a 78.2-second upper bound. Production source metadata and | ||
| 50 | share records remained unchanged during rehearsal. | ||
| 51 | |||
| 52 | ## 2026-10-16 production evidence | ||
| 53 | |||
| 54 | Release `765dec72842b4d08` deployed described main revision | ||
| 55 | `e0cc66a00eb2757846148a241961225d1f9b1253`. All production routes passed | ||
| 56 | the release workflow's checks. The canonical host unit now serves share | ||
| 57 | operations; obsolete Win10/ARM host overrides were archived with the release | ||
| 58 | backup after their effective VM code matched main byte for byte. | ||
| 59 | |||
| 60 | The six requested folders moved to `Share` with their requested names. | ||
| 61 | All 2,184 metadata entries retained their device, inode, mode, size, and mtime. | ||
| 62 | All 20 native shares and four selected-file rows matched the path-only | ||
| 63 | projection, and all nine affected public URLs returned their original 200 | ||
| 64 | responses. Meadow had no native public link; its folder moved without creating | ||
| 65 | one. Copyparty remained stopped throughout the folder and database changes. | ||
| 66 | |||
| 67 | The move's stop-to-public-readiness interval was 13.44 seconds. Independent | ||
| 68 | one-second HTTPS HEAD sampling bounded total public unavailability across | ||
| 69 | release activation and the move to 55.12 seconds over three intervals. | ||
| 70 | Restricted plan, database/config backups, frozen job, and result evidence are | ||
| 71 | in `/var/lib/studio/copyparty-cutover/20261016T082910Z-424b5410`. | ||
| 72 | |||
| 73 | ## 2026-10-16 account creation timeout | ||
| 74 | |||
| 75 | The production host unit allowed only loopback traffic, but Podman's loopback | ||
| 76 | port forwarding translates requests onto its bridge. A read-only health probe | ||
| 77 | under the same IP restrictions timed out after 3.003 seconds; allowing the | ||
| 78 | existing Podman subnet returned HTTP 200 in 0.0013 seconds. Account creation | ||
| 79 | waited for config reload and its recovery reload before returning an error. | ||
| 80 | The host allowlist now derives the bridge range from the declared Podman default | ||
| 81 | subnet, preserving the existing network. | ||
| 82 | |||
| 83 | The hardened preview created an account in 0.54 seconds and rotated its | ||
| 84 | password in 0.60 seconds. Double-clicked submits sent one request each. | ||
| 85 | Shares-list checks also caught absolute copy-status text expanding the document | ||
| 86 | outside its scroller. Anchoring that hidden text and bounding the list during | ||
| 87 | refresh errors kept the document at 720 × 320 in a 720 × 320 viewport, with | ||
| 88 | only the table scrolling. Its headers and last-row keyboard actions stayed | ||
| 89 | reachable; the hidden live status remained in the accessibility tree. | ||
| 90 | |||
| 91 | Production account creation completed in 0.60 seconds, rotation in 0.47 | ||
| 92 | seconds, and deletion in 0.15 seconds under the effective host restrictions. | ||
| 93 | The disposable account was removed; shares and grants remained unchanged. | ||
| 94 | |||
| 95 | The first rollout, `a8982234e99ab23c`, also exported newer sibling Clover DB | ||
| 96 | sources. That image failed before database startup because its nonroot user | ||
| 97 | could not create its launcher cache. Clover DB was restored through the | ||
| 98 | previous immutable release's service deployment. Its newer source also carries | ||
| 99 | database migrations outside this change's scope. The build manifest now pins | ||
| 100 | sitegen revision `13f64d71038f5e72ab34dc1f55805e2fee05f368`; all 183 exported | ||
| 101 | files, 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().hex | 62 | 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.stderr | 70 | 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) |
| 98 | 98 | ||
| 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' * 16 | 34 | 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') / revision | 36 | 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 = run | 46 | 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__) |
| 12 | parser.add_argument("--clients", type=int, default=24) | 12 | parser.add_argument("--clients", type=int, default=24) |
| 13 | parser.add_argument("--rounds", type=int, default=20) | 13 | parser.add_argument("--rounds", type=int, default=20) |
| 14 | parser.add_argument("--port", type=int, default=7072) | 14 | parser.add_argument("--port", type=int, default=7072) |
| 15 | parser.add_argument("--unit", default="studio-dashboard.service") | 15 | parser.add_argument("--unit", default="snowglobe-dashboard.service") |
| 16 | parser.add_argument("--include-files", action="store_true") | 16 | parser.add_argument("--include-files", action="store_true") |
| 17 | args = parser.parse_args() | 17 | args = parser.parse_args() |
| 18 | if args.clients < 1 or args.rounds < 1: | 18 | if 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 = 0 | 28 | depth = 0 |
| 29 | end = None | 29 | end = None |
| ... | @@ -33,9 +33,9 @@ def main(): | ... | @@ -33,9 +33,9 @@ def main(): |
| 33 | end = position + 1 | 33 | end = position + 1 |
| 34 | break | 34 | break |
| 35 | assert end is not None | 35 | 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 == 0 | 38 | 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") |
| 40 | 40 | ||
| 41 | def install(value): | 41 | def install(value): |
| ... | @@ -47,9 +47,9 @@ def main(): | ... | @@ -47,9 +47,9 @@ def main(): |
| 47 | 47 | ||
| 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.timeout | 54 | 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") |
| 18 | 18 | ||
| 19 | class DeploymentBoundary(unittest.TestCase): | 19 | class 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() |
| 77 | 77 | ||
| 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"] = digest | 96 | 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="") |
| 171 | 171 | ||
| 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) |
| 175 | 175 | ||
| ... | @@ -205,7 +205,7 @@ class DeploymentBoundary(unittest.TestCase): | ... | @@ -205,7 +205,7 @@ class DeploymentBoundary(unittest.TestCase): |
| 205 | root = runs.HOST_STATE | 205 | 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): |
| 249 | 249 | ||
| 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-" + suffix | 29 | 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-" + suffix | 32 | 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") |
| 97 | 97 | ||
| 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 = destination | 148 | 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"], result | 158 | 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 = True | 188 | 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_value | 220 | 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 |
| 18 | def main(): | 18 | def 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-" + suffix | 27 | 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-" + suffix | 30 | container = "snowglobe-dashboard-files-test-" + suffix |
| 31 | 31 | ||
| 32 | def run(*argv): | 32 | def run(*argv): |
| 33 | return subprocess.run(argv, check=True, capture_output=True, text=True).stdout | 33 | 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)) |
| 77 | 77 | ||
| 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 |
| 4 | from pathlib import Path | 4 | from pathlib import Path |
| 5 | parser=argparse.ArgumentParser(description=__doc__) | 5 | parser=argparse.ArgumentParser(description=__doc__) |
| 6 | parser.add_argument('binary') | 6 | parser.add_argument('binary') |
| 7 | parser.add_argument('--pool',default='studio-demo') | 7 | parser.add_argument('--pool',default='snowglobe-demo') |
| 8 | args=parser.parse_args() | 8 | args=parser.parse_args() |
| 9 | run=lambda *argv:subprocess.run(argv,check=True,capture_output=True,text=True) | 9 | run=lambda *argv:subprocess.run(argv,check=True,capture_output=True,text=True) |
| 10 | dataset=args.pool+'/dashboard-test-'+uuid.uuid4().hex[:8] | 10 | dataset=args.pool+'/dashboard-test-'+uuid.uuid4().hex[:8] |
| 11 | unit='studio-dashboard-files-test' | 11 | unit='snowglobe-dashboard-files-test' |
| 12 | with tempfile.TemporaryDirectory(prefix='studio-files-test-') as temporary: | 12 | with 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()+120 | 20 | 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) |
| 19 | 19 | ||
| 20 | class Boundary(unittest.TestCase): | 20 | class 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") |
| 23 | 23 | ||
| 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): |
| 94 | 94 | ||
| 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") |
| 101 | 101 | ||
| 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"]) |
| 108 | 108 | ||
| 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") |
| 113 | 113 | ||
| 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): |
| 128 | 128 | ||
| 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") |
| 139 | 139 | ||
| 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)") |
| 144 | 144 | ||
| 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): |
| 35 | def main(): | 35 | def 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) |
| 431 | 431 | ||
| 432 | 432 | ||
| 433 | def serve_connection(connection, host, allowed_uid): | 433 | def 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_SLOTS | 460 | 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): |
| 484 | 489 | ||
| 485 | 490 | ||
| 486 | def main(): | 491 | def 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_uid | 493 | 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 | ||
| 2 | import argparse | ||
| 3 | import importlib | ||
| 4 | import json | ||
| 5 | from pathlib import Path | ||
| 6 | import subprocess | ||
| 7 | import sys | ||
| 8 | import time | ||
| 9 | import urllib.error | ||
| 10 | import urllib.parse | ||
| 11 | import urllib.request | ||
| 12 | import uuid | ||
| 13 | |||
| 14 | |||
| 15 | def 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 | |||
| 155 | if __name__ == "__main__": | ||
| 156 | main() | ||
tools/dashboard-mcp-test.py deleted-237| ... | @@ -1,237 +0,0 @@ | ||
| 1 | #!/usr/bin/env python3 | ||
| 2 | import argparse | ||
| 3 | import base64 | ||
| 4 | import hashlib | ||
| 5 | import importlib | ||
| 6 | import json | ||
| 7 | from pathlib import Path | ||
| 8 | import subprocess | ||
| 9 | import sys | ||
| 10 | import time | ||
| 11 | import urllib.error | ||
| 12 | import urllib.parse | ||
| 13 | import urllib.request | ||
| 14 | import uuid | ||
| 15 | |||
| 16 | |||
| 17 | class NoRedirect(urllib.request.HTTPRedirectHandler): | ||
| 18 | def redirect_request(self, request, fp, code, message, headers, newurl): | ||
| 19 | return None | ||
| 20 | |||
| 21 | |||
| 22 | def 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 | |||
| 236 | if __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) |
| 50 | for server in [metrics, nomad]: | 50 | for server in [metrics, nomad]: |
| 51 | threading.Thread(target=server.serve_forever, daemon=True).start() | 51 | threading.Thread(target=server.serve_forever, daemon=True).start() |
| 52 | 52 | ||
| 53 | unit = "studio-dashboard-metrics-test" | 53 | unit = "snowglobe-dashboard-metrics-test" |
| 54 | with tempfile.TemporaryDirectory(prefix="studio-metrics-test-") as temporary: | 54 | with 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.stderr | 51 | 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().hex | 26 | proof = uuid.uuid4().hex + uuid.uuid4().hex |
| 27 | 27 | ||
| 28 | def shell(*argv): | 28 | def shell(*argv): |
| 29 | return subprocess.run(argv, capture_output=True, text=True, check=True, timeout=60).stdout | 29 | return subprocess.run(argv, capture_output=True, text=True, check=True, timeout=60).stdout |
| 30 | 30 | ||
| 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:" + port | 54 | 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"] = supplied | 61 | 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.error | 85 | neighbor = f"""import urllib.request, urllib.error |
| 86 | request = urllib.request.Request('http://{address}:7072/api/me', headers={{ | 86 | request = 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 | }}) |
| 89 | try: | 89 | try: |
| 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.stderr | 101 | assert unsecured.returncode != 0 and "Set SNOWGLOBE_PROXY_TOKEN_FILE" in unsecured.stderr, unsecured.stderr |
| 102 | 102 | ||
| 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), apps | 173 | assert any(app["id"] == "shale" for app in apps), apps |
| 174 | assert all(app["url"].endswith(".studio.test") for app in apps), apps | 174 | 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, denied | 187 | 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 | ||
| 2 | import argparse | ||
| 3 | from concurrent.futures import ThreadPoolExecutor | ||
| 4 | import http.cookiejar | ||
| 5 | import importlib | ||
| 6 | import json | ||
| 7 | from pathlib import Path | ||
| 8 | import ssl | ||
| 9 | import subprocess | ||
| 10 | import sys | ||
| 11 | import time | ||
| 12 | import urllib.parse | ||
| 13 | import urllib.request | ||
| 14 | import uuid | ||
| 15 | |||
| 16 | |||
| 17 | def 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 | |||
| 140 | if __name__ == '__main__': | ||
| 141 | main() | ||
tools/dashboard-relay-test.py deleted-454| ... | @@ -1,454 +0,0 @@ | ||
| 1 | #!/usr/bin/env python3 | ||
| 2 | import argparse | ||
| 3 | import base64 | ||
| 4 | from concurrent.futures import ThreadPoolExecutor | ||
| 5 | import hashlib | ||
| 6 | import importlib | ||
| 7 | import json | ||
| 8 | import os | ||
| 9 | from pathlib import Path | ||
| 10 | import queue | ||
| 11 | import re | ||
| 12 | import tempfile | ||
| 13 | import socket | ||
| 14 | import sqlite3 | ||
| 15 | import struct | ||
| 16 | import subprocess | ||
| 17 | import sys | ||
| 18 | import threading | ||
| 19 | import time | ||
| 20 | import urllib.error | ||
| 21 | import urllib.parse | ||
| 22 | import urllib.request | ||
| 23 | import uuid | ||
| 24 | |||
| 25 | |||
| 26 | class NoRedirect(urllib.request.HTTPRedirectHandler): | ||
| 27 | def redirect_request(self, request, fp, code, message, headers, newurl): | ||
| 28 | return None | ||
| 29 | |||
| 30 | |||
| 31 | class 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 | |||
| 136 | def 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 | |||
| 453 | if __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().hex | 24 | 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().hex | 27 | trace_id = uuid.uuid4().hex |
| 28 | redirected = [] | 28 | redirected = [] |
| 29 | 29 | ||
| ... | @@ -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()) |
| 51 | 51 | ||
| 52 | def log_message(self, *args): | 52 | def log_message(self, *args): |
| 53 | pass | 53 | pass |
| 54 | 54 | ||
| 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 | continue | 71 | 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.nomad | 76 | real_nomad = router.nomad |
| 77 | 77 | ||
| 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 value | 87 | return value |
| 88 | 88 | ||
| 89 | router.nomad = discovery | 89 | 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.error | 111 | client = f"""import json, ssl, time, urllib.request, urllib.error |
| 112 | base = 'https://{host}:{port}' | 112 | base = 'https://{host}:{port}' |
| 113 | proof = open('/proxy.token').read().strip() | 113 | proof = 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') |
| 116 | def request(path, supplied=proof, method='GET', body=None, content_type='application/json'): | 116 | def 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'] = supplied | 119 | 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] == 403 | 127 | assert request('/nomad/v1/services', supplied)[0] == 403 |
| 128 | status, body = request('/nomad/v1/services') | 128 | status, body = request('/nomad/v1/services') |
| 129 | assert status == 200 and isinstance(json.loads(body), list), (status, body) | 129 | assert status == 200 and isinstance(json.loads(body), list), (status, body) |
| 130 | assert request('/nomad/v1/var/studio-routing-fixture')[0] == 403 | 130 | assert request('/nomad/v1/var/snowglobe-routing-fixture')[0] == 403 |
| 131 | status, 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()) | 131 | status, 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()) |
| 132 | assert status == 403, (status, body) | 132 | assert status == 403, (status, body) |
| 133 | assert request('/services/unknown-fixture/health')[0] == 404 | 133 | assert request('/services/unknown-fixture/health')[0] == 404 |
| 134 | for service in ['victoria-metrics', 'victoria-logs', 'victoria-traces']: | 134 | for service in ['victoria-metrics', 'victoria-logs', 'victoria-traces']: |
| ... | @@ -139,7 +139,7 @@ result = json.loads(body) | ... | @@ -139,7 +139,7 @@ result = json.loads(body) |
| 139 | assert status == 200 and result == {{'path': '/probe?fixture=1', 'host': '127.0.0.1:{fixture.server_port}', 'proof': None, 'user': None}}, result | 139 | assert 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. |
| 141 | at = time.time() - 60 | 141 | at = time.time() - 60 |
| 142 | metric = 'studio_service_cpu_cores{{service="{fixture_id}"}} 0.125 ' + str(int(at * 1000)) + '\\n' | 142 | metric = 'snowglobe_service_cpu_cores{{service="{fixture_id}"}} 0.125 ' + str(int(at * 1000)) + '\\n' |
| 143 | status, body = request('/services/victoria-metrics/api/v1/import/prometheus', method='POST', body=metric.encode(), content_type='text/plain') | 143 | status, body = request('/services/victoria-metrics/api/v1/import/prometheus', method='POST', body=metric.encode(), content_type='text/plain') |
| 144 | assert status == 204, (status, body) | 144 | assert status == 204, (status, body) |
| 145 | row = {{'_time': str(at), '_msg': 'Routing fixture', 'source': 'nomad', 'job': '{fixture_id}', 'task': 'probe', 'stream': 'stdout'}} | 145 | row = {{'_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"] |
| 180 | 180 | ||
| 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 = { |
| 28 | ACTIONS = {"deploy", "destroy", "rollback", "start", "stop", "restart", "secret-set", "secret-rotate"} | 28 | ACTIONS = {"deploy", "destroy", "rollback", "start", "stop", "restart", "secret-set", "secret-rotate"} |
| 29 | MAX_LOG = 1024 * 1024 | 29 | MAX_LOG = 1024 * 1024 |
| 30 | MAX_METADATA = 65536 | 30 | MAX_METADATA = 65536 |
| 31 | HOST_STATE = Path(os.environ.get("STUDIO_HOST_STATE_ROOT", "/var/lib/studio/host")) | 31 | HOST_STATE = Path(os.environ.get("SNOWGLOBE_HOST_STATE_ROOT", "/var/lib/snowglobe/host")) |
| 32 | 32 | ||
| 33 | 33 | ||
| 34 | class Error(Exception): | 34 | class 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): |
| 98 | def secret(action, target, key, value=None): | 98 | def 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] |
| 181 | 181 | ||
| 182 | 182 | ||
| 183 | def last(): | 183 | def 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 = None | 375 | 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(): |
| 127 | 127 | ||
| 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 | ||
| 2 | import argparse | ||
| 3 | import base64 | ||
| 4 | from concurrent.futures import ThreadPoolExecutor | ||
| 5 | import copy | ||
| 6 | import http.cookiejar | ||
| 7 | import hashlib | ||
| 8 | import importlib | ||
| 9 | import json | ||
| 10 | import math | ||
| 11 | from pathlib import Path | ||
| 12 | import sqlite3 | ||
| 13 | import ssl | ||
| 14 | import subprocess | ||
| 15 | import sys | ||
| 16 | import time | ||
| 17 | import urllib.error | ||
| 18 | import urllib.parse | ||
| 19 | import urllib.request | ||
| 20 | import uuid | ||
| 21 | |||
| 22 | |||
| 23 | class NoRedirect(urllib.request.HTTPRedirectHandler): | ||
| 24 | def redirect_request(self, request, fp, code, message, headers, newurl): | ||
| 25 | return None | ||
| 26 | |||
| 27 | |||
| 28 | def 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 | |||
| 462 | if __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">'}}})) |
| 137 | 137 | ||
| 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'}} |
| 146 | 146 | ||
| ... | @@ -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) |
| 157 | 157 | ||
| 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}' |
| 171 | 171 | ||
| 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) + path | 174 | 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 body | 199 | 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 None | 200 | 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] == 200 | 211 | 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] == 200 | 213 | 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')) == 2 | 217 | 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 == 200 | 219 | 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] == blob | 223 | 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] == 403 | 227 | assert request('/submit', body=b'blocked', headers={'Origin': 'https://other.example'})[0] == 403 |
| 228 | assert request('/auth/shale/page', direct=True)[0] == 403 | 228 | 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] == 403 | 229 | 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 | ||
| 2 | import argparse | ||
| 3 | import base64 | ||
| 4 | from contextlib import closing, contextmanager | ||
| 5 | import copy | ||
| 6 | from html.parser import HTMLParser | ||
| 7 | import http.client | ||
| 8 | import http.cookiejar | ||
| 9 | import http.server | ||
| 10 | import importlib | ||
| 11 | import json | ||
| 12 | import os | ||
| 13 | from pathlib import Path | ||
| 14 | import re | ||
| 15 | import sqlite3 | ||
| 16 | import ssl | ||
| 17 | import socket | ||
| 18 | import subprocess | ||
| 19 | import sys | ||
| 20 | import tempfile | ||
| 21 | import threading | ||
| 22 | import time | ||
| 23 | import urllib.error | ||
| 24 | import urllib.parse | ||
| 25 | import urllib.request | ||
| 26 | import uuid | ||
| 27 | |||
| 28 | |||
| 29 | class 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 | ||
| 72 | def 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 | |||
| 233 | def 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 | |||
| 467 | if __name__ == "__main__": | ||
| 468 | main() | ||
tools/dashboard-stage-test.py created+113| ... | @@ -0,0 +1,113 @@ | ||
| 1 | #!/usr/bin/env python3 | ||
| 2 | from importlib import import_module | ||
| 3 | import json | ||
| 4 | import os | ||
| 5 | from pathlib import Path | ||
| 6 | import struct | ||
| 7 | import subprocess | ||
| 8 | import tempfile | ||
| 9 | import unittest | ||
| 10 | from unittest.mock import Mock, patch | ||
| 11 | |||
| 12 | |||
| 13 | stage = import_module("dashboard-stage") | ||
| 14 | boundary = import_module("dashboard-host") | ||
| 15 | |||
| 16 | |||
| 17 | class 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 | |||
| 87 | class 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 | |||
| 112 | if __name__ == "__main__": | ||
| 113 | unittest.main() | ||
tools/dashboard-stage.py created+214| ... | @@ -0,0 +1,214 @@ | ||
| 1 | #!/usr/bin/env python3 | ||
| 2 | import concurrent.futures | ||
| 3 | from importlib import import_module | ||
| 4 | import json | ||
| 5 | import os | ||
| 6 | from pathlib import Path | ||
| 7 | import re | ||
| 8 | import secrets | ||
| 9 | import shlex | ||
| 10 | import shutil | ||
| 11 | import socket | ||
| 12 | import subprocess | ||
| 13 | import sys | ||
| 14 | import threading | ||
| 15 | import time | ||
| 16 | |||
| 17 | import snowglobe | ||
| 18 | |||
| 19 | |||
| 20 | OPERATIONS = 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 | }) | ||
| 26 | STAGE_ID = re.compile(r"dashboard-preview-[0-9a-f]{8}\Z") | ||
| 27 | boundary = import_module("dashboard-host") | ||
| 28 | |||
| 29 | |||
| 30 | class 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 | |||
| 50 | def 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 | |||
| 59 | def 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 | |||
| 84 | def 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 | |||
| 188 | def 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 | |||
| 210 | if __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 | ||
| 2 | import argparse | ||
| 3 | from contextlib import ExitStack | ||
| 4 | import importlib | ||
| 5 | import json | ||
| 6 | import os | ||
| 7 | from pathlib import Path | ||
| 8 | import pwd | ||
| 9 | import re | ||
| 10 | import shutil | ||
| 11 | import socket | ||
| 12 | import subprocess | ||
| 13 | import sys | ||
| 14 | import tempfile | ||
| 15 | import time | ||
| 16 | import urllib.request | ||
| 17 | import uuid | ||
| 18 | |||
| 19 | import router | ||
| 20 | |||
| 21 | |||
| 22 | def 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 | |||
| 302 | if __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() - started | 120 | elapsed = time.monotonic() - started |
| 121 | assert attempt.returncode == 1, attempt.stderr | 121 | 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 rollback | 1 | # Production data restore |
| 2 | 2 | ||
| 3 | Every 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. | 3 | Every production promotion and code rollback backs up the active release |
| 4 | before switching it. One ZFS snapshot operation captures mounted managed | ||
| 5 | service datasets and PostgreSQL data together. A temporary isolated PostgreSQL | ||
| 6 | clone produces service-owned database dumps and is destroyed before the | ||
| 7 | backup is published. A failed deployment can leave a completed backup without | ||
| 8 | a successful release-history entry. | ||
| 4 | 9 | ||
| 5 | The 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 |
| 11 | private manifest records the service snapshots, database dumps and checksums, | ||
| 12 | and a private `nomad.snap`. The Nomad snapshot includes jobs, ACLs, and secret | ||
| 13 | variables. It is for explicit cluster recovery; service restore does not apply | ||
| 14 | it. Earlier backups may lack this snapshot. Manifests and dumps remain on the | ||
| 15 | OS disk; see [hardware and recovery](snowglobe-hardware.md) for off-server | ||
| 16 | recovery requirements. | ||
| 6 | 17 | ||
| 7 | At 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`. | 18 | To restore one service after production data restore is explicitly authorized: |
| 8 | |||
| 9 | To restore one service, roll its code back first, then run: | ||
| 10 | 19 | ||
| 11 | ```sh | 20 | ```sh |
| 12 | python3 tools/deploy.py backups | 21 | python3 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> |
| 14 | python3 tools/deploy.py data-restore <service-id> --backup <backup-id> --discard-writes | 23 | python3 tools/deploy.py data-restore <service-id> --backup <backup-id> --discard-writes |
| 15 | ``` | 24 | ``` |
| 16 | 25 | ||
| 17 | The 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. | 26 | The backup's `fromRelease` must match the active release. The command verifies |
| 18 | 27 | backup snapshots and dumps before stopping the service, saves the current | |
| 19 | The 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. | 28 | dataset and database as a safety copy, restores the selected data, then |
| 20 | 29 | deploys and checks the service. **Writes after the chosen backup are discarded | |
| 21 | On 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. | 30 | from the live service.** The safety snapshot and dump remain on the host. |
| 22 | 31 | ||
| 23 | # VM restore rehearsal | 32 | Restore PostgreSQL owner services individually; the PostgreSQL service itself |
| 24 | 33 | is shared. Clover, Media, and external archive mounts are outside managed | |
| 25 | On 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. | 34 | service restore. Restoring an entire shared dataset discards unrelated writes. |
| 26 | 35 | For Shale, keep the complete service dataset together: repository visibility, | |
| 27 | The `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. | 36 | repository objects, issue database, attachment files, and their manifest must |
| 37 | agree. For Copyparty, also preserve its Nomad API-account hashes as described | ||
| 38 | in [administration](copyparty.md). For Knife, preserve the external archive | ||
| 39 | store and identity as described in [operations](knife.md). | ||
| 40 | |||
| 41 | Verify the real application, authentication, persistence, provider connections, | ||
| 42 | allocation health and logs after recovery. Code rollback only changes code; | ||
| 43 | it 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 |
| 4 | from datetime import datetime, timezone | 4 | from datetime import datetime, timezone |
| 5 | import hashlib | 5 | import hashlib |
| 6 | import json | 6 | import json |
| 7 | from importlib import import_module | ||
| 7 | import os | 8 | import os |
| 8 | from pathlib import Path | 9 | from pathlib import Path |
| 9 | import re | 10 | import re |
| ... | @@ -14,8 +15,10 @@ import subprocess | ... | @@ -14,8 +15,10 @@ import subprocess |
| 14 | import time | 15 | import time |
| 15 | 16 | ||
| 16 | 17 | ||
| 17 | ROOT = Path("/opt/studio") | 18 | transition = import_module("namespace-transition") |
| 18 | STATE = Path("/var/lib/studio") | 19 | |
| 20 | ROOT = Path("/opt/snowglobe") | ||
| 21 | STATE = Path("/var/lib/snowglobe") | ||
| 19 | BACKUPS = STATE / "backups" | 22 | BACKUPS = STATE / "backups" |
| 20 | BACKUP_ID = re.compile(r"\d{8}T\d{6}Z-[0-9a-f]{6}\Z") | 23 | BACKUP_ID = re.compile(r"\d{8}T\d{6}Z-[0-9a-f]{6}\Z") |
| 21 | SERVICE_ID = re.compile(r"[a-z][a-z0-9-]*\Z") | 24 | SERVICE_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 release | 40 | return release |
| 38 | 41 | ||
| ... | @@ -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 = False | 125 | 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_id | 178 | 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_id | 181 | 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 / name | 265 | 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 | return | 283 | 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}") |
| 326 | 330 | ||
| 327 | 331 |
tools/dawarich-migration.md deleted-31| ... | @@ -1,31 +0,0 @@ | ||
| 1 | # Dawarich migration | ||
| 2 | |||
| 3 | The 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 | |||
| 5 | The 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 | ||
| 10 | python3 tools/import-personal-postgres.py dawarich \ | ||
| 11 | /mnt/storage1/apps/studio-handoff/20261004T230507Z-e75419 \ | ||
| 12 | --container PERSONAL_POSTGRES_INITIALIZER | ||
| 13 | ``` | ||
| 14 | |||
| 15 | The 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 | |||
| 17 | The 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 | |||
| 19 | The 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 | |||
| 21 | The 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 | |||
| 23 | Before 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 | |||
| 25 | The 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 | |||
| 27 | The 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 | |||
| 31 | The 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 | |||
| 3 | The `.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 | |||
| 5 | The 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 | |||
| 7 | Snow 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 | |||
| 9 | At 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 |
| 15 | 15 | ||
| 16 | class MainExport(unittest.TestCase): | 16 | class 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).stdout | 39 | 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.run | 43 | original = subprocess.run |
| 43 | 44 | ||
| 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.run | 117 | original = subprocess.run |
tools/deploy.py+29-38| ... | @@ -12,13 +12,13 @@ import sys | ... | @@ -12,13 +12,13 @@ import sys |
| 12 | import tempfile | 12 | import tempfile |
| 13 | import time | 13 | import time |
| 14 | 14 | ||
| 15 | from release import SOURCES, excluded_services, tree_digest | 15 | from release import SOURCES, tree_digest |
| 16 | 16 | ||
| 17 | 17 | ||
| 18 | REPO = Path(__file__).resolve().parent.parent | 18 | REPO = Path(__file__).resolve().parent.parent |
| 19 | HOST = os.environ.get("STUDIO_DEPLOY_HOST", "root@127.0.0.1") | 19 | HOST = os.environ.get("SNOWGLOBE_DEPLOY_HOST", "root@10.0.0.1") |
| 20 | PORT = os.environ.get("STUDIO_DEPLOY_PORT", "2222") | 20 | PORT = os.environ.get("SNOWGLOBE_DEPLOY_PORT", "22") |
| 21 | REMOTE = Path("/opt/studio") | 21 | REMOTE = Path("/opt/snowglobe") |
| 22 | NAME = re.compile(r"[a-z][a-z0-9-]*\Z") | 22 | NAME = re.compile(r"[a-z][a-z0-9-]*\Z") |
| 23 | RELEASE_ID = re.compile(r"[0-9a-f]{16}\Z") | 23 | RELEASE_ID = re.compile(r"[0-9a-f]{16}\Z") |
| 24 | 24 | ||
| ... | @@ -32,18 +32,27 @@ def ssh(command, capture=False): | ... | @@ -32,18 +32,27 @@ def ssh(command, capture=False): |
| 32 | 32 | ||
| 33 | def run_logged(mode, target, command): | 33 | def 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}") |
| 39 | 39 | ||
| 40 | 40 | ||
| 41 | def 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 | |||
| 41 | def sync_manager(release): | 49 | def 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") | ||
| 44 | 53 | ||
| 45 | 54 | ||
| 46 | def export_revision(source, commit, paths, destination, excluded=frozenset()): | 55 | def 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 / relative | 67 | 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()): |
| 70 | 74 | ||
| 71 | 75 | ||
| 72 | def upload(main=False): | 76 | def 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 = None | 79 | 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 staging | 90 | 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"] = revision | 151 | 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 release | 162 | 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}") | ||
| 263 | 254 | ||
| 264 | 255 | ||
| 265 | if __name__ == "__main__": | 256 | if __name__ == "__main__": |
tools/evil-forgejo-migration.md deleted-27| ... | @@ -1,27 +0,0 @@ | ||
| 1 | # evil.inc Forgejo cutover | ||
| 2 | |||
| 3 | Zenith'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 | |||
| 5 | Snow 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 | ||
| 8 | bash 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 | |||
| 19 | The 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 | |||
| 21 | For 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 | |||
| 23 | A 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 | |||
| 25 | A 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 | |||
| 27 | After 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 | ||
| 2 | set -euo pipefail | ||
| 3 | |||
| 4 | source_host=${STUDIO_MIGRATION_SOURCE:-zenith} | ||
| 5 | root=/mnt/storage1/apps/studio-handoff | ||
| 6 | id=$(date -u +%Y%m%dT%H%M%SZ)-$(python3 -c 'import secrets; print(secrets.token_hex(3))') | ||
| 7 | pending=$root/.pending-$id | ||
| 8 | final=$root/$id | ||
| 9 | |||
| 10 | ssh "$source_host" 'test "$(findmnt -n -o SOURCE --mountpoint /mnt/storage1/apps)" = storage1/apps; test "$(findmnt -n -o FSTYPE --mountpoint /mnt/storage1/apps)" = zfs' | ||
| 11 | ssh "$source_host" 'sudo -n docker info >/dev/null' | ||
| 12 | |||
| 13 | check_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 | |||
| 24 | check_stopped | ||
| 25 | ssh "$source_host" 'sudo -n docker exec postgres pg_isready -U postgres >/dev/null' | ||
| 26 | ssh "$source_host" 'test -r /mnt/storage1/apps/home-infra/.env' | ||
| 27 | ssh "$source_host" "set -e; test ! -e '$final'; mkdir -m 700 -p '$root'; mkdir -m 700 '$pending'" | ||
| 28 | for 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" | ||
| 30 | done | ||
| 31 | check_stopped | ||
| 32 | ssh "$source_host" python3 - "$pending" "$id" <<'PY' | ||
| 33 | import hashlib | ||
| 34 | import json | ||
| 35 | from pathlib import Path | ||
| 36 | import subprocess | ||
| 37 | import sys | ||
| 38 | |||
| 39 | folder = Path(sys.argv[1]) | ||
| 40 | manifest = {"id": sys.argv[2], "databases": {}} | ||
| 41 | queries = { | ||
| 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 | } | ||
| 45 | for 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} | ||
| 58 | legacy_env = (Path("/mnt/storage1/apps/home-infra/.env")).read_text().splitlines() | ||
| 59 | forgejo_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 | } | ||
| 69 | fingerprints = {} | ||
| 70 | for 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() | ||
| 75 | manifest["databases"]["evil-forgejo"]["secretSha256"] = fingerprints | ||
| 76 | (folder / "manifest.json").write_text(json.dumps(manifest, indent=2) + "\n") | ||
| 77 | PY | ||
| 78 | ssh "$source_host" "set -e; chmod 600 '$pending/manifest.json'; mv '$pending' '$final'; sync" | ||
| 79 | check_stopped | ||
| 80 | echo "Legacy PostgreSQL handoff: $final" | ||
tools/export-offline-postgres.py deleted-220| ... | @@ -1,220 +0,0 @@ | ||
| 1 | #!/usr/bin/env python3 | ||
| 2 | import argparse | ||
| 3 | from contextlib import contextmanager | ||
| 4 | from datetime import datetime, timezone | ||
| 5 | import hashlib | ||
| 6 | import json | ||
| 7 | import os | ||
| 8 | from pathlib import Path | ||
| 9 | import secrets | ||
| 10 | import shutil | ||
| 11 | import subprocess | ||
| 12 | import tempfile | ||
| 13 | |||
| 14 | |||
| 15 | def 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 | |||
| 26 | def 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 | |||
| 34 | def 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 | |||
| 45 | def identifier(value): | ||
| 46 | return '"' + value.replace('"', '""') + '"' | ||
| 47 | |||
| 48 | |||
| 49 | @contextmanager | ||
| 50 | def 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 | |||
| 83 | def 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 | |||
| 88 | def 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 | |||
| 116 | parser = argparse.ArgumentParser(description='Export and restore-check stopped PostgreSQL clusters from private copies.') | ||
| 117 | parser.add_argument('--cluster', nargs=2, action='append', required=True, metavar=('SOURCE', 'RUNTIME')) | ||
| 118 | parser.add_argument('--locale-archive', type=Path, required=True) | ||
| 119 | args = parser.parse_args() | ||
| 120 | if os.geteuid() != 0: | ||
| 121 | parser.error('Run as root on the installer') | ||
| 122 | os.umask(0o077) | ||
| 123 | os.environ['LOCALE_ARCHIVE'] = str(args.locale_archive) | ||
| 124 | os.environ.pop('PGOPTIONS', None) | ||
| 125 | root = Path('/mnt/storage1/apps/studio-handoff') | ||
| 126 | mounted = subprocess.check_output(['findmnt', '-n', '-o', 'SOURCE,FSTYPE', '--mountpoint', str(root.parent)], text=True).split() | ||
| 127 | if 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') | ||
| 129 | if subprocess.run(['pgrep', '-x', 'postgres'], stdout=subprocess.DEVNULL).returncode == 0: | ||
| 130 | parser.error('Stop PostgreSQL before taking an offline copy') | ||
| 131 | handoff_id = datetime.now(timezone.utc).strftime('%Y%m%dT%H%M%SZ-') + secrets.token_hex(3) | ||
| 132 | root.mkdir(mode=0o700, exist_ok=True) | ||
| 133 | destination = root / ('.pending-' + handoff_id) | ||
| 134 | destination.mkdir(mode=0o700) | ||
| 135 | manifest = {'id': handoff_id, 'clusters': {}, 'databases': {}} | ||
| 136 | work = Path(tempfile.mkdtemp(prefix='infra2-pg-export-', dir='/run')) | ||
| 137 | os.chown(work, 65534, 65534) | ||
| 138 | try: | ||
| 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) | ||
| 219 | finally: | ||
| 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"}) |
| 27 | 27 |
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 |
| 22 | parser.add_argument('provider', choices=['github', 'astheno']) | 22 | parser.add_argument('provider', choices=['github', 'astheno']) |
| 23 | parser.add_argument('--client-id') | 23 | parser.add_argument('--client-id') |
| 24 | parser.add_argument('--disable', action='store_true') | 24 | parser.add_argument('--disable', action='store_true') |
| 25 | parser.add_argument('--host', default=os.environ.get('STUDIO_DEPLOY_HOST', 'root@zenith')) | 25 | parser.add_argument('--host', default=os.environ.get('SNOWGLOBE_DEPLOY_HOST', 'root@10.0.0.1')) |
| 26 | parser.add_argument('--port', default=os.environ.get('STUDIO_DEPLOY_PORT', '22')) | 26 | parser.add_argument('--port', default=os.environ.get('SNOWGLOBE_DEPLOY_PORT', '22')) |
| 27 | args = parser.parse_args() | 27 | args = parser.parse_args() |
| 28 | if not args.disable and not args.client_id: | 28 | if 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} |
| 31 | if not args.disable: | 31 | if 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: ')) |
| 33 | result = subprocess.run(['ssh', '-p', args.port, args.host, | 33 | result = 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) |
| 36 | if result.returncode: | 36 | if 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 | |||
| 5 | The 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 | |||
| 7 | For 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 | |||
| 9 | For 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 | ||
| 2 | set -euo pipefail | ||
| 3 | |||
| 4 | service=${1:?usage: tools/import-arr.sh sonarr|radarr [preview-id]} | ||
| 5 | [[ $service == sonarr || $service == radarr ]] || { echo 'Expected sonarr or radarr' >&2; exit 1; } | ||
| 6 | instance=${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 | |||
| 9 | source_host=${STUDIO_MIGRATION_SOURCE:-zenith} | ||
| 10 | target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1} | ||
| 11 | target_port=${STUDIO_DEPLOY_PORT:-2222} | ||
| 12 | remote=(ssh -p "$target_port" "$target_host") | ||
| 13 | source_copy_host=$source_host | ||
| 14 | source_rsh=ssh | ||
| 15 | offline=false | ||
| 16 | if [[ -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 | ||
| 24 | fi | ||
| 25 | source_ssh() { | ||
| 26 | if [[ $offline == true ]]; then | ||
| 27 | "${remote[@]}" "$@" | ||
| 28 | else | ||
| 29 | ssh "$source_host" "$@" | ||
| 30 | fi | ||
| 31 | } | ||
| 32 | if [[ $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 | ||
| 47 | else | ||
| 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; } | ||
| 51 | fi | ||
| 52 | dataset=$("${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 | |||
| 55 | scratch=$(mktemp -d) | ||
| 56 | source_backup= | ||
| 57 | cleanup() { | ||
| 58 | rm -rf "$scratch" | ||
| 59 | if [[ -n $source_backup ]]; then | ||
| 60 | source_ssh "rm -f '$source_backup'" | ||
| 61 | fi | ||
| 62 | } | ||
| 63 | trap cleanup EXIT | ||
| 64 | |||
| 65 | source_backup=$(source_ssh "python3 - '/mnt/storage1/apps/$service/$service.db'" <<'PY' | ||
| 66 | import os | ||
| 67 | import sqlite3 | ||
| 68 | import sys | ||
| 69 | import tempfile | ||
| 70 | |||
| 71 | source = sqlite3.connect(f"file:{sys.argv[1]}?mode=ro", uri=True) | ||
| 72 | fd, name = tempfile.mkstemp(prefix="studio-arr-", suffix=".db") | ||
| 73 | os.close(fd) | ||
| 74 | try: | ||
| 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() | ||
| 81 | except BaseException: | ||
| 82 | os.unlink(name) | ||
| 83 | raise | ||
| 84 | print(name) | ||
| 85 | PY | ||
| 86 | ) | ||
| 87 | rsync -a --exclude="/$service.db*" --exclude='/logs.db*' --exclude='/*.pid' --exclude='/logs/' \ | ||
| 88 | -e "$source_rsh" "$source_copy_host:/mnt/storage1/apps/$service/" "$scratch/config/" | ||
| 89 | if [[ $offline == true ]]; then | ||
| 90 | scp -q -P "$target_port" "$source_copy_host:$source_backup" "$scratch/config/$service.db" | ||
| 91 | else | ||
| 92 | scp -q "$source_copy_host:$source_backup" "$scratch/config/$service.db" | ||
| 93 | fi | ||
| 94 | |||
| 95 | if [[ $instance != "$service" ]]; then | ||
| 96 | "${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance" | ||
| 97 | fi | ||
| 98 | for _ 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 | ||
| 103 | done | ||
| 104 | [[ $running == 0 ]] || { echo "$instance still has a running allocation" >&2; exit 1; } | ||
| 105 | |||
| 106 | snapshot="$dataset@before-arr-import-$(date +%s)-$$" | ||
| 107 | "${remote[@]}" "zfs snapshot $snapshot" | ||
| 108 | rsync -a --delete -e "ssh -p $target_port" "$scratch/config/" "$target_host:$root/config/" | ||
| 109 | uid=$("${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\"'" | ||
| 111 | local_hash=$(shasum -a 256 "$scratch/config/$service.db" | cut -d ' ' -f 1) | ||
| 112 | remote_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 | |||
| 115 | if [[ $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" | ||
| 123 | else | ||
| 124 | python3 "$(dirname "$0")/deploy.py" stage "$service" | ||
| 125 | "${remote[@]}" "zfs destroy $snapshot" | ||
| 126 | echo "Imported and tested $instance" | ||
| 127 | fi | ||
tools/import-dashboard-auth.py deleted-59| ... | @@ -1,59 +0,0 @@ | ||
| 1 | #!/usr/bin/env python3 | ||
| 2 | import argparse | ||
| 3 | import hashlib | ||
| 4 | import json | ||
| 5 | import os | ||
| 6 | from pathlib import Path | ||
| 7 | import subprocess | ||
| 8 | |||
| 9 | |||
| 10 | parser = argparse.ArgumentParser(description="Copy Keycloak accounts into a private dashboard import") | ||
| 11 | parser.add_argument("--host", required=True) | ||
| 12 | parser.add_argument("--output", required=True, type=Path) | ||
| 13 | args = parser.parse_args() | ||
| 14 | if args.output.exists(): | ||
| 15 | parser.error("output already exists") | ||
| 16 | |||
| 17 | remote = r''' | ||
| 18 | import json, subprocess, urllib.request | ||
| 19 | request = 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()}) | ||
| 20 | allocations = [a["ID"] for a in json.load(urllib.request.urlopen(request)) if a["ClientStatus"] == "running" and a["DesiredStatus"] == "run"] | ||
| 21 | assert len(allocations) == 1 | ||
| 22 | containers = [line.split()[0] for line in subprocess.check_output(["podman", "ps", "--format", "{{.ID}} {{.Names}}"], text=True).splitlines() if line.split()[1].endswith(allocations[0])] | ||
| 23 | assert len(containers) == 1 | ||
| 24 | sql = """ | ||
| 25 | BEGIN TRANSACTION ISOLATION LEVEL REPEATABLE READ READ ONLY; | ||
| 26 | SELECT 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 | ); | ||
| 39 | COMMIT; | ||
| 40 | """ | ||
| 41 | result = 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) | ||
| 42 | print(next(line for line in result.stdout.splitlines() if line.startswith('{'))) | ||
| 43 | ''' | ||
| 44 | result = subprocess.run(["ssh", "-o", "BatchMode=yes", args.host, "python3", "-"], input=remote, text=True, capture_output=True, check=True) | ||
| 45 | data = json.loads(result.stdout) | ||
| 46 | if not data["users"]: | ||
| 47 | raise ValueError("source realm has no accounts") | ||
| 48 | content = (json.dumps(data, separators=(",", ":")) + "\n").encode() | ||
| 49 | args.output.parent.mkdir(mode=0o700, parents=True, exist_ok=True) | ||
| 50 | with 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()) | ||
| 54 | counts = {} | ||
| 55 | for user in data["users"]: | ||
| 56 | for credential in user["credentials"]: | ||
| 57 | kind = credential["type"] | ||
| 58 | counts[kind] = counts.get(kind, 0) + 1 | ||
| 59 | print(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 | ||
| 2 | set -euo pipefail | ||
| 3 | |||
| 4 | instance=${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 | |||
| 10 | source_host=${STUDIO_MIGRATION_SOURCE:-zenith} | ||
| 11 | target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1} | ||
| 12 | target_port=${STUDIO_DEPLOY_PORT:-2222} | ||
| 13 | remote=(ssh -p "$target_port" "$target_host") | ||
| 14 | |||
| 15 | root=/srv/staging/$instance | ||
| 16 | source_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; } | ||
| 18 | snapshot=$(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; } | ||
| 20 | source_root=/mnt/storage1/apps/.zfs/snapshot/${snapshot#*@}/dawarich_storage | ||
| 21 | |||
| 22 | dataset=$("${remote[@]}" "findmnt -n -o SOURCE --mountpoint $root") | ||
| 23 | [[ $dataset == */staging/$instance ]] || { echo 'Preview dataset is not mounted' >&2; exit 1; } | ||
| 24 | |||
| 25 | source_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())') | ||
| 27 | own=$("${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 | |||
| 31 | db_json=$("${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad var get -out json nomad/jobs/$instance/inputs/database") | ||
| 32 | read -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 | |||
| 35 | allocation=$("${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])') | ||
| 37 | container=app-$allocation | ||
| 38 | podman='podman --url unix:///run/podman/podman.sock' | ||
| 39 | scratch=$(mktemp -d) | ||
| 40 | trap 'rm -rf "$scratch"' EXIT | ||
| 41 | rsync -a "$source_host:$source_root/" "$scratch/" | ||
| 42 | drift=$(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; } | ||
| 44 | source_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" | ||
| 47 | for _ 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 | ||
| 52 | done | ||
| 53 | [[ $running == 0 ]] || { echo 'Dawarich allocation is still running' >&2; exit 1; } | ||
| 54 | |||
| 55 | backup_snapshot=$dataset@before-dawarich-import-$(date +%s)-$$ | ||
| 56 | "${remote[@]}" "zfs snapshot $backup_snapshot" | ||
| 57 | rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/var/app/storage/" | ||
| 58 | uid=$("${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" | ||
| 60 | drift=$(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 | |||
| 63 | backup=/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" | ||
| 66 | ssh "$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" | ||
| 68 | target_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 | |||
| 71 | python3 "$(dirname "$0")/deploy.py" stage dawarich | ||
| 72 | "${remote[@]}" "zfs destroy $backup_snapshot" | ||
| 73 | echo "Imported $instance from $snapshot. Previous database: $backup" | ||
tools/import-evil-forgejo.sh deleted-77| ... | @@ -1,77 +0,0 @@ | ||
| 1 | #!/usr/bin/env bash | ||
| 2 | set -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 | |||
| 7 | target_port=${STUDIO_DEPLOY_PORT:-22} | ||
| 8 | remote=(ssh -p "$target_port" "$STUDIO_DEPLOY_HOST") | ||
| 9 | sh "$(dirname "$0")/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$STUDIO_DEPLOY_HOST" "$target_port" | ||
| 10 | root=/srv/prod/evil-forgejo | ||
| 11 | source_dir=/mnt/storage1/apps/evil-infra/forgejo | ||
| 12 | database=evil_forgejo | ||
| 13 | owner=svc_evil_forgejo | ||
| 14 | podman='podman --url unix:///run/podman/podman.sock' | ||
| 15 | |||
| 16 | entry=$("${remote[@]}" "python3 - '$STUDIO_LEGACY_HANDOFF' evil-forgejo" < "$(dirname "$0")/verify-legacy-dump.py") | ||
| 17 | source_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 | |||
| 20 | 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-forgejo') | ||
| 21 | [[ ${response##*$'\n'} == 200 ]] || { echo 'evil.inc Forgejo is unavailable on the home server' >&2; exit 1; } | ||
| 22 | stopped=$(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; } | ||
| 24 | for _ 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 | ||
| 29 | done | ||
| 30 | [[ $running == 0 ]] || { echo 'evil.inc Forgejo did not stop on the home server' >&2; exit 1; } | ||
| 31 | |||
| 32 | db_json=$("${remote[@]}" 'NOMAD_TOKEN=$(cat /var/lib/studio/nomad.token) nomad var get -out json nomad/jobs/evil-forgejo/inputs/database') | ||
| 33 | read -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' | ||
| 37 | import hashlib | ||
| 38 | import json | ||
| 39 | import os | ||
| 40 | from pathlib import Path | ||
| 41 | import subprocess | ||
| 42 | import sys | ||
| 43 | |||
| 44 | legacy = json.loads((Path(sys.argv[1]) / "manifest.json").read_text())["databases"]["evil-forgejo"]["secretSha256"] | ||
| 45 | environment = {**os.environ, "NOMAD_TOKEN": Path("/var/lib/studio/nomad.token").read_text().strip()} | ||
| 46 | result = subprocess.run(["nomad", "var", "get", "-out", "json", "nomad/jobs/evil-forgejo"], | ||
| 47 | check=True, capture_output=True, text=True, env=environment) | ||
| 48 | actual = json.loads(result.stdout)["Items"] | ||
| 49 | for 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}") | ||
| 52 | PY | ||
| 53 | |||
| 54 | allocation=$("${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])') | ||
| 56 | container=app-$allocation | ||
| 57 | source_manifest=$("${remote[@]}" "python3 - '$source_dir'" < "$(dirname "$0")/tree-hash.py") | ||
| 58 | source_bytes=$(python3 -c 'import json,sys; print(json.load(sys.stdin)["bytes"])' <<<"$source_manifest") | ||
| 59 | available=$("${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 | |||
| 62 | dataset=$("${remote[@]}" "findmnt -n -o SOURCE --mountpoint $root") | ||
| 63 | [[ $dataset == */prod/evil-forgejo ]] || { echo 'Unexpected production dataset' >&2; exit 1; } | ||
| 64 | snapshot=$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/'" | ||
| 66 | target_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; } | ||
| 68 | uid=$("${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 | |||
| 71 | backup=$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" | ||
| 75 | counts=$("${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; } | ||
| 77 | echo "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.""" | ||
| 3 | import argparse | ||
| 4 | from collections import Counter, defaultdict | ||
| 5 | from datetime import datetime, timezone | ||
| 6 | import hashlib | ||
| 7 | import grp | ||
| 8 | import json | ||
| 9 | import os | ||
| 10 | from pathlib import Path | ||
| 11 | import re | ||
| 12 | import shutil | ||
| 13 | import sqlite3 | ||
| 14 | import sys | ||
| 15 | import tempfile | ||
| 16 | import urllib.request | ||
| 17 | from urllib.parse import quote | ||
| 18 | |||
| 19 | ALPHABET = '0123456789ABCDEFGHJKMNPQRSTVWXYZ' | ||
| 20 | EPOCH = 1577836800 # Shale's ULIDs use 2020-01-01, rather than the Unix epoch. | ||
| 21 | CLOSED = ('done', 'not_planned', 'duplicate', 'invalid') | ||
| 22 | EVENTS = ['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 | |||
| 33 | def timestamp(epoch): | ||
| 34 | return datetime.fromtimestamp(int(epoch), timezone.utc).isoformat(timespec='seconds') | ||
| 35 | |||
| 36 | |||
| 37 | def 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 | |||
| 46 | def digest(path): | ||
| 47 | return hashlib.sha256(path.read_bytes()).hexdigest() | ||
| 48 | |||
| 49 | |||
| 50 | def 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 | |||
| 62 | def 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 | |||
| 409 | def 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 | |||
| 472 | def 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 | |||
| 511 | if __name__ == '__main__': | ||
| 512 | main() | ||
tools/import-forgejo-to-shale.py deleted-240| ... | @@ -1,240 +0,0 @@ | ||
| 1 | #!/usr/bin/env python3 | ||
| 2 | import argparse | ||
| 3 | from datetime import datetime, timezone | ||
| 4 | import hashlib | ||
| 5 | import json | ||
| 6 | import os | ||
| 7 | from pathlib import Path | ||
| 8 | import re | ||
| 9 | import secrets | ||
| 10 | import shutil | ||
| 11 | import sqlite3 | ||
| 12 | import tempfile | ||
| 13 | import urllib.error | ||
| 14 | import urllib.request | ||
| 15 | |||
| 16 | |||
| 17 | SOURCE = Path('/mnt/storage1/apps/forgejo/git/repositories') | ||
| 18 | ACCESS = ('access_git_webui', 'access_git_proto', 'access_git_proto_push', 'access_issues', | ||
| 19 | 'access_issues_submit', 'access_issues_comment', 'access_readme') | ||
| 20 | |||
| 21 | |||
| 22 | def 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 | |||
| 30 | def 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 | |||
| 51 | def 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 | |||
| 69 | def 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 | |||
| 236 | if __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 | ||
| 2 | set -euo pipefail | ||
| 3 | |||
| 4 | instance=${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; } | ||
| 6 | if [[ $instance == evil-hedgedoc ]]; then | ||
| 7 | root=/srv/prod/evil-hedgedoc | ||
| 8 | else | ||
| 9 | root="/srv/staging/$instance" | ||
| 10 | fi | ||
| 11 | |||
| 12 | source_host=${STUDIO_MIGRATION_SOURCE:-zenith} | ||
| 13 | target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1} | ||
| 14 | target_port=${STUDIO_DEPLOY_PORT:-2222} | ||
| 15 | remote=(ssh -p "$target_port" "$target_host") | ||
| 16 | path="nomad/jobs/$instance/inputs/database" | ||
| 17 | handoff=${STUDIO_LEGACY_HANDOFF:-} | ||
| 18 | if [[ -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" | ||
| 28 | else | ||
| 29 | upload_host=$source_host | ||
| 30 | upload_rsh=ssh | ||
| 31 | fi | ||
| 32 | |||
| 33 | if [[ $instance != evil-hedgedoc ]]; then | ||
| 34 | "${remote[@]}" "test -f /var/lib/studio/stages/$instance.json" | ||
| 35 | else | ||
| 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 | ||
| 56 | fi | ||
| 57 | "${remote[@]}" "test \$(findmnt -n -o FSTYPE --mountpoint $root) = zfs" | ||
| 58 | db_json=$("${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad var get -out json $path") | ||
| 59 | read -r database owner < <(python3 -c 'import json,sys; d=json.load(sys.stdin)["Items"]; print(d["name"], d["username"])' <<<"$db_json") | ||
| 60 | if [[ $instance == evil-hedgedoc ]]; then | ||
| 61 | [[ $database == evil_hedgedoc && $owner == svc_evil_hedgedoc ]] || { echo 'Unexpected production database' >&2; exit 1; } | ||
| 62 | else | ||
| 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; } | ||
| 64 | fi | ||
| 65 | |||
| 66 | alloc_json=$("${remote[@]}" 'NOMAD_TOKEN=$(cat /var/lib/studio/nomad.token) nomad job allocs -json postgres') | ||
| 67 | allocation=$(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") | ||
| 68 | container="app-$allocation" | ||
| 69 | podman='podman --url unix:///run/podman/podman.sock' | ||
| 70 | scratch=$(mktemp -d) | ||
| 71 | trap 'rm -rf "$scratch"' EXIT | ||
| 72 | rsync -a -e "$upload_rsh" "$upload_host:/mnt/storage1/apps/evil-infra/hedgedoc/" "$scratch/uploads/" | ||
| 73 | drift=$(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 | |||
| 76 | if [[ $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; } | ||
| 84 | fi | ||
| 85 | |||
| 86 | uploads="$root/hedgedoc/public/uploads" | ||
| 87 | rsync -a --delete -e "ssh -p $target_port" "$scratch/uploads/" "$target_host:$uploads/" | ||
| 88 | drift=$(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; } | ||
| 90 | uid=$("${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 | |||
| 93 | backup="/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 | |||
| 97 | if [[ -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" | ||
| 99 | else | ||
| 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" | ||
| 102 | fi | ||
| 103 | |||
| 104 | counts_sql='SELECT (SELECT count(*) FROM "Notes"), (SELECT count(*) FROM "Users"), (SELECT count(*) FROM "Revisions"), (SELECT count(*) FROM "Authors");' | ||
| 105 | if [[ -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) | ||
| 107 | fi | ||
| 108 | target_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; } | ||
| 110 | echo "Verified HedgeDoc Notes, Users, Revisions, and Authors counts: $target_counts" | ||
| 111 | |||
| 112 | if [[ $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" | ||
| 120 | else | ||
| 121 | python3 "$(dirname "$0")/deploy.py" stage evil-hedgedoc | ||
| 122 | echo "Preview database imported; previous preview dump: $backup" | ||
| 123 | fi | ||
tools/import-jackett.sh deleted-100| ... | @@ -1,100 +0,0 @@ | ||
| 1 | #!/bin/sh | ||
| 2 | set -eu | ||
| 3 | |||
| 4 | instance=${1:?usage: tools/import-jackett.sh jackett|jackett-preview-XXXXXXXX} | ||
| 5 | case $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 ;; | ||
| 17 | esac | ||
| 18 | |||
| 19 | source_host=${STUDIO_MIGRATION_SOURCE:-zenith} | ||
| 20 | target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1} | ||
| 21 | target_port=${STUDIO_DEPLOY_PORT:-2222} | ||
| 22 | offline=false | ||
| 23 | copy_host=$source_host | ||
| 24 | copy_rsh=ssh | ||
| 25 | if [ -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" | ||
| 31 | fi | ||
| 32 | if [ "$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; } | ||
| 46 | else | ||
| 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" | ||
| 54 | fi | ||
| 55 | |||
| 56 | dataset=$(ssh -p "$target_port" "$target_host" "findmnt -n -o SOURCE --mountpoint $mount") | ||
| 57 | if [ "$production" = true ]; then | ||
| 58 | case $dataset in */prod/jackett) ;; *) echo 'Production dataset is not mounted' >&2; exit 1 ;; esac | ||
| 59 | else | ||
| 60 | case $dataset in */staging/"$instance") ;; *) echo 'Preview dataset is not mounted' >&2; exit 1 ;; esac | ||
| 61 | fi | ||
| 62 | |||
| 63 | scratch=$(mktemp -d) | ||
| 64 | trap 'rm -rf "$scratch"' EXIT | ||
| 65 | rsync -a --exclude='/log.txt*' -e "$copy_rsh" "$copy_host:$source_root/" "$scratch/" | ||
| 66 | python3 - "$scratch" <<'PY' | ||
| 67 | import json | ||
| 68 | from pathlib import Path | ||
| 69 | import sys | ||
| 70 | |||
| 71 | root = Path(sys.argv[1]) | ||
| 72 | config = json.loads((root / "ServerConfig.json").read_text()) | ||
| 73 | if not config.get("APIKey") or not list((root / "Indexers").glob("*.json")): | ||
| 74 | raise ValueError("Jackett configuration is incomplete") | ||
| 75 | PY | ||
| 76 | |||
| 77 | if [ "$production" = false ]; then | ||
| 78 | ssh -p "$target_port" "$target_host" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance" | ||
| 79 | fi | ||
| 80 | snapshot="$dataset@before-jackett-import-$(date +%s)-$$" | ||
| 81 | ssh -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 | |||
| 83 | rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/" | ||
| 84 | owner=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"jackett\"])'") | ||
| 85 | ssh -p "$target_port" "$target_host" "chown -R $owner:$owner $root" | ||
| 86 | drift=$(rsync -rlnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/" "$target_host:$root/") | ||
| 87 | test -z "$drift" || { echo "Jackett copy differs from source; restore $snapshot" >&2; exit 1; } | ||
| 88 | |||
| 89 | if [ "$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" | ||
| 96 | else | ||
| 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" | ||
| 100 | fi | ||
tools/import-jellyfin.sh deleted-103| ... | @@ -1,103 +0,0 @@ | ||
| 1 | #!/bin/sh | ||
| 2 | set -eu | ||
| 3 | |||
| 4 | instance=${1:?usage: tools/import-jellyfin.sh jellyfin|jellyfin-preview-XXXXXXXX} | ||
| 5 | case $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 ;; | ||
| 17 | esac | ||
| 18 | |||
| 19 | source_host=${STUDIO_MIGRATION_SOURCE:-zenith} | ||
| 20 | target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1} | ||
| 21 | target_port=${STUDIO_DEPLOY_PORT:-2222} | ||
| 22 | offline=false | ||
| 23 | if [ -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 | ||
| 27 | fi | ||
| 28 | if [ "$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 | ||
| 46 | else | ||
| 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" | ||
| 55 | fi | ||
| 56 | |||
| 57 | dataset=$(ssh -p "$target_port" "$target_host" "findmnt -n -o SOURCE --mountpoint $mount") | ||
| 58 | if [ "$production" = true ]; then | ||
| 59 | case $dataset in */prod/jellyfin) ;; *) echo 'Production dataset is not mounted' >&2; exit 1 ;; esac | ||
| 60 | else | ||
| 61 | case $dataset in */staging/"$instance") ;; *) echo 'Preview dataset is not mounted' >&2; exit 1 ;; esac | ||
| 62 | fi | ||
| 63 | |||
| 64 | if [ "$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/" | ||
| 69 | fi | ||
| 70 | |||
| 71 | if [ "$production" = false ]; then | ||
| 72 | ssh -p "$target_port" "$target_host" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance" | ||
| 73 | fi | ||
| 74 | snapshot="$dataset@before-jellyfin-import-$(date +%s)-$$" | ||
| 75 | ssh -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 | |||
| 77 | if [ "$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/'" | ||
| 79 | else | ||
| 80 | rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/" | ||
| 81 | fi | ||
| 82 | owner=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"jellyfin\"])'") | ||
| 83 | ssh -p "$target_port" "$target_host" "chown -R $owner:$owner $root" | ||
| 84 | if [ "$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/'") | ||
| 86 | else | ||
| 87 | drift=$(rsync -rlnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/" "$target_host:$root/") | ||
| 88 | fi | ||
| 89 | test -z "$drift" || { echo "Jellyfin copy differs from source; restore $snapshot" >&2; exit 1; } | ||
| 90 | ssh -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 | |||
| 92 | if [ "$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" | ||
| 99 | else | ||
| 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" | ||
| 103 | fi | ||
tools/import-legacy-secrets.sh deleted-54| ... | @@ -1,54 +0,0 @@ | ||
| 1 | #!/bin/bash | ||
| 2 | set -euo pipefail | ||
| 3 | |||
| 4 | service=${1:?usage: tools/import-legacy-secrets.sh SERVICE ENV_NAME...|KEY=ENV_NAME...} | ||
| 5 | shift | ||
| 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; } | ||
| 8 | sources=() | ||
| 9 | keys=() | ||
| 10 | for 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") | ||
| 21 | done | ||
| 22 | (( ${#keys[@]} == 0 || ${#keys[@]} == ${#sources[@]} )) || { echo 'Use a target key for every source name' >&2; exit 1; } | ||
| 23 | options=() | ||
| 24 | for key in "${keys[@]}"; do | ||
| 25 | options+=(--key "$key") | ||
| 26 | done | ||
| 27 | : "${STUDIO_DEPLOY_HOST:?Set STUDIO_DEPLOY_HOST to the production target}" | ||
| 28 | |||
| 29 | source_host=${STUDIO_MIGRATION_SOURCE:-zenith} | ||
| 30 | repo=$(cd "$(dirname "$0")/.." && pwd) | ||
| 31 | names=$(printf ' %s' "${sources[@]}") | ||
| 32 | if [[ -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") | ||
| 35 | else | ||
| 36 | source_remote=(ssh "$source_host") | ||
| 37 | fi | ||
| 38 | |||
| 39 | "${source_remote[@]}" "python3 -$names <<'PY' | ||
| 40 | from pathlib import Path | ||
| 41 | import sys | ||
| 42 | |||
| 43 | lines = Path('/mnt/storage1/apps/home-infra/.env').read_text().splitlines() | ||
| 44 | if len(set(sys.argv[1:])) != len(sys.argv[1:]): | ||
| 45 | raise SystemExit('Duplicate source secret name') | ||
| 46 | secrets = [] | ||
| 47 | for 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]) | ||
| 52 | for value in secrets: | ||
| 53 | print(value) | ||
| 54 | PY" | python3 "$repo/tools/deploy.py" secrets "$service" --file - "${options[@]}" | ||
tools/import-navidrome.sh deleted-102| ... | @@ -1,102 +0,0 @@ | ||
| 1 | #!/bin/sh | ||
| 2 | set -eu | ||
| 3 | |||
| 4 | instance=${1:?usage: tools/import-navidrome.sh navidrome|navidrome-preview-XXXXXXXX} | ||
| 5 | case $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 ;; | ||
| 17 | esac | ||
| 18 | |||
| 19 | source_host=${STUDIO_MIGRATION_SOURCE:-zenith} | ||
| 20 | target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1} | ||
| 21 | target_port=${STUDIO_DEPLOY_PORT:-2222} | ||
| 22 | offline=false | ||
| 23 | if [ -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 | ||
| 27 | fi | ||
| 28 | if [ "$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; } | ||
| 44 | else | ||
| 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" | ||
| 52 | fi | ||
| 53 | |||
| 54 | dataset=$(ssh -p "$target_port" "$target_host" "findmnt -n -o SOURCE --mountpoint $mount") | ||
| 55 | if [ "$production" = true ]; then | ||
| 56 | case $dataset in */prod/navidrome) ;; *) echo 'Production dataset is not mounted' >&2; exit 1 ;; esac | ||
| 57 | else | ||
| 58 | case $dataset in */staging/"$instance") ;; *) echo 'Preview dataset is not mounted' >&2; exit 1 ;; esac | ||
| 59 | fi | ||
| 60 | |||
| 61 | if [ "$offline" = true ]; then | ||
| 62 | ssh -p "$target_port" "$target_host" "test -s '$source_root/navidrome.db'" || { echo 'Navidrome database is missing' >&2; exit 1; } | ||
| 63 | else | ||
| 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; } | ||
| 68 | fi | ||
| 69 | |||
| 70 | if [ "$production" = false ]; then | ||
| 71 | ssh -p "$target_port" "$target_host" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance" | ||
| 72 | fi | ||
| 73 | snapshot="$dataset@before-navidrome-import-$(date +%s)-$$" | ||
| 74 | ssh -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 | |||
| 76 | if [ "$offline" = true ]; then | ||
| 77 | ssh -p "$target_port" "$target_host" "rsync -a --delete --delete-excluded --exclude='*-shm' '$source_root/' '$root/'" | ||
| 78 | else | ||
| 79 | rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/" | ||
| 80 | fi | ||
| 81 | owner=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"navidrome\"])'") | ||
| 82 | ssh -p "$target_port" "$target_host" "chown -R $owner:$owner $root" | ||
| 83 | if [ "$offline" = true ]; then | ||
| 84 | drift=$(ssh -p "$target_port" "$target_host" "rsync -rlnc --delete --delete-excluded --exclude='*-shm' --out-format='%n' '$source_root/' '$root/'") | ||
| 85 | else | ||
| 86 | drift=$(rsync -rlnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/" "$target_host:$root/") | ||
| 87 | fi | ||
| 88 | test -z "$drift" || { echo "Navidrome copy differs from source; restore $snapshot" >&2; exit 1; } | ||
| 89 | ssh -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 | |||
| 91 | if [ "$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" | ||
| 98 | else | ||
| 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" | ||
| 102 | fi | ||
tools/import-pds-secrets.py deleted-44| ... | @@ -1,44 +0,0 @@ | ||
| 1 | #!/usr/bin/env python3 | ||
| 2 | import os | ||
| 3 | from pathlib import Path | ||
| 4 | import re | ||
| 5 | import subprocess | ||
| 6 | |||
| 7 | |||
| 8 | if not os.environ.get("STUDIO_DEPLOY_HOST"): | ||
| 9 | raise SystemExit("Set STUDIO_DEPLOY_HOST to the production target") | ||
| 10 | |||
| 11 | if 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"]] | ||
| 13 | else: | ||
| 14 | ssh = ["ssh", "-o", "BatchMode=yes", os.environ.get("STUDIO_MIGRATION_SOURCE", "zenith")] | ||
| 15 | |||
| 16 | source = subprocess.run( | ||
| 17 | [*ssh, "cat", "/mnt/storage1/apps/home-infra/.env"], | ||
| 18 | check=True, capture_output=True, text=True, | ||
| 19 | ).stdout | ||
| 20 | names = { | ||
| 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 | } | ||
| 28 | values = {} | ||
| 29 | for 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() | ||
| 36 | if len(values) != len(names) or not all(values.values()): | ||
| 37 | raise ValueError("PDS source secrets are incomplete") | ||
| 38 | if not re.fullmatch(r"[0-9a-fA-F]{64}", values["plc_rotation_key"]): | ||
| 39 | raise ValueError("invalid PDS rotation key") | ||
| 40 | |||
| 41 | subprocess.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 | ||
| 2 | set -eu | ||
| 3 | |||
| 4 | instance=${1:?usage: tools/import-pds.sh pds|pds-preview-XXXXXXXX} | ||
| 5 | case $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 ;; | ||
| 17 | esac | ||
| 18 | |||
| 19 | source_host=${STUDIO_MIGRATION_SOURCE:-zenith} | ||
| 20 | target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1} | ||
| 21 | target_port=${STUDIO_DEPLOY_PORT:-2222} | ||
| 22 | offline=false | ||
| 23 | copy_host=$source_host | ||
| 24 | copy_rsh=ssh | ||
| 25 | if [ -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" | ||
| 31 | fi | ||
| 32 | source_ssh() { | ||
| 33 | if [ "$offline" = true ]; then | ||
| 34 | ssh -p "$target_port" "$target_host" "$@" | ||
| 35 | else | ||
| 36 | ssh "$source_host" "$@" | ||
| 37 | fi | ||
| 38 | } | ||
| 39 | if [ "$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; } | ||
| 51 | else | ||
| 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; } | ||
| 56 | fi | ||
| 57 | scratch=$(mktemp -d) | ||
| 58 | source_backup= | ||
| 59 | cleanup() { | ||
| 60 | rm -rf "$scratch" | ||
| 61 | if [ -n "$source_backup" ]; then | ||
| 62 | source_ssh "rm -rf '$source_backup'" | ||
| 63 | fi | ||
| 64 | } | ||
| 65 | trap cleanup EXIT | ||
| 66 | |||
| 67 | dataset=$(ssh -p "$target_port" "$target_host" "findmnt -n -o SOURCE --mountpoint $mount") | ||
| 68 | if [ "$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" | ||
| 71 | else | ||
| 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; } | ||
| 75 | fi | ||
| 76 | snapshot="$dataset@before-pds-import-$(date +%s)-$$" | ||
| 77 | |||
| 78 | source_backup=$(source_ssh python3 - <<'PY' | ||
| 79 | from pathlib import Path | ||
| 80 | import shutil | ||
| 81 | import sqlite3 | ||
| 82 | import tempfile | ||
| 83 | |||
| 84 | out = Path(tempfile.mkdtemp(prefix="studio-pds-")) | ||
| 85 | try: | ||
| 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() | ||
| 94 | except BaseException: | ||
| 95 | shutil.rmtree(out) | ||
| 96 | raise | ||
| 97 | print(out) | ||
| 98 | PY | ||
| 99 | ) | ||
| 100 | rsync -a -e "$copy_rsh" "$copy_host:$source_backup/" "$scratch/" | ||
| 101 | rsync -a --exclude='*.sqlite*' -e "$copy_rsh" "$copy_host:/mnt/storage1/apps/pds/" "$scratch/" | ||
| 102 | drift=$(rsync -rnc --delete --exclude='*.sqlite*' --out-format='%n' -e "$copy_rsh" "$copy_host:/mnt/storage1/apps/pds/" "$scratch/") | ||
| 103 | test -z "$drift" || { echo 'PDS source changed during copy; retry the import' >&2; exit 1; } | ||
| 104 | |||
| 105 | if [ "$production" = false ]; then | ||
| 106 | ssh -p "$target_port" "$target_host" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance" | ||
| 107 | fi | ||
| 108 | ssh -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 | |||
| 110 | rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/" | ||
| 111 | owner=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"pds\"])'") | ||
| 112 | ssh -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)'" | ||
| 113 | drift=$(rsync -rnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/" "$target_host:$root/") | ||
| 114 | test -z "$drift" || { echo "PDS copy differs from source backup; restore $snapshot" >&2; exit 1; } | ||
| 115 | |||
| 116 | if [ "$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" | ||
| 123 | else | ||
| 124 | python3 "$(dirname "$0")/deploy.py" stage pds | ||
| 125 | ssh -p "$target_port" "$target_host" "zfs destroy $snapshot" | ||
| 126 | echo "Imported and tested $instance" | ||
| 127 | fi | ||
tools/import-personal-files.py deleted-114| ... | @@ -1,114 +0,0 @@ | ||
| 1 | #!/usr/bin/env python3 | ||
| 2 | import argparse | ||
| 3 | import json | ||
| 4 | import os | ||
| 5 | from pathlib import Path | ||
| 6 | import sqlite3 | ||
| 7 | import subprocess | ||
| 8 | import time | ||
| 9 | import urllib.error | ||
| 10 | import urllib.request | ||
| 11 | |||
| 12 | |||
| 13 | parser = argparse.ArgumentParser(description="Copy retained app files on the new host before starting the service.") | ||
| 14 | parser.add_argument("service", choices=["tailscale", "ddns-updater", "copyparty", "ytdl", "pds"]) | ||
| 15 | |||
| 16 | |||
| 17 | def 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 | |||
| 113 | if __name__ == "__main__": | ||
| 114 | main() | ||
tools/import-personal-postgres.py deleted-215| ... | @@ -1,215 +0,0 @@ | ||
| 1 | #!/usr/bin/env python3 | ||
| 2 | import argparse | ||
| 3 | import hashlib | ||
| 4 | import json | ||
| 5 | import os | ||
| 6 | from pathlib import Path | ||
| 7 | import re | ||
| 8 | import subprocess | ||
| 9 | import tempfile | ||
| 10 | import urllib.error | ||
| 11 | import urllib.request | ||
| 12 | |||
| 13 | |||
| 14 | def identifier(value): | ||
| 15 | return '"' + value.replace('"', '""') + '"' | ||
| 16 | |||
| 17 | |||
| 18 | def 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 | |||
| 26 | def 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 | |||
| 51 | def 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 | |||
| 211 | if __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 | ||
| 2 | set -euo pipefail | ||
| 3 | |||
| 4 | : "${STUDIO_DEPLOY_HOST:?Set STUDIO_DEPLOY_HOST to the production target}" | ||
| 5 | source_host=${STUDIO_MIGRATION_SOURCE:-zenith} | ||
| 6 | target_host=$STUDIO_DEPLOY_HOST | ||
| 7 | target_port=${STUDIO_DEPLOY_PORT:-2222} | ||
| 8 | remote=(ssh -p "$target_port" "$target_host") | ||
| 9 | root=/srv/prod/qbittorrent | ||
| 10 | source_copy_host=$source_host | ||
| 11 | source_rsh=ssh | ||
| 12 | offline=false | ||
| 13 | if [[ -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 | ||
| 18 | fi | ||
| 19 | |||
| 20 | if [[ $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; } | ||
| 23 | fi | ||
| 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 | |||
| 28 | 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/qbittorrent') | ||
| 29 | status=${response##*$'\n'} | ||
| 30 | if [[ $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; } | ||
| 33 | elif [[ $status != 404 ]]; then | ||
| 34 | echo "Could not verify qBittorrent job state on the home server: $status" >&2 | ||
| 35 | exit 1 | ||
| 36 | fi | ||
| 37 | dataset=$("${remote[@]}" "findmnt -n -o SOURCE --mountpoint $root") | ||
| 38 | [[ $dataset == */prod/qbittorrent ]] || { echo "Expected a mounted service dataset at $root" >&2; exit 1; } | ||
| 39 | |||
| 40 | scratch=$(mktemp -d) | ||
| 41 | trap 'rm -rf "$scratch"' EXIT | ||
| 42 | mkdir "$scratch/qBittorrent" | ||
| 43 | rsync -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/" | ||
| 45 | resume_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 | |||
| 48 | snapshot="$dataset@before-qbittorrent-import-$(date +%s)-$$" | ||
| 49 | "${remote[@]}" "zfs snapshot $snapshot" | ||
| 50 | rsync -a --delete -e "ssh -p $target_port" "$scratch/qBittorrent/" "$target_host:$root/config/qBittorrent/" | ||
| 51 | changes=$(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 | |||
| 55 | uid=$("${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" | ||
| 57 | copied=$("${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; } | ||
| 59 | if [[ $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 | } | ||
| 64 | fi | ||
| 65 | "${remote[@]}" 'python3 /opt/studio/current/tools/studio.py deploy qbittorrent' | ||
| 66 | echo "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 | ||
| 2 | set -euo pipefail | ||
| 3 | |||
| 4 | instance=${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; } | ||
| 6 | source_host=${STUDIO_MIGRATION_SOURCE:-zenith} | ||
| 7 | target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1} | ||
| 8 | target_port=${STUDIO_DEPLOY_PORT:-2222} | ||
| 9 | remote=(ssh -p "$target_port" "$target_host") | ||
| 10 | job_status=200 | ||
| 11 | handoff=${STUDIO_LEGACY_HANDOFF:-} | ||
| 12 | if [[ -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" | ||
| 20 | else | ||
| 21 | source_copy_host=$source_host | ||
| 22 | source_rsh=ssh | ||
| 23 | fi | ||
| 24 | |||
| 25 | if [[ $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 | ||
| 41 | else | ||
| 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 | ||
| 48 | fi | ||
| 49 | |||
| 50 | dataset=$("${remote[@]}" "findmnt -n -o SOURCE --mountpoint $root") | ||
| 51 | if [[ $instance == shale ]]; then | ||
| 52 | [[ $dataset == */prod/shale ]] || { echo 'Production Shale dataset is not mounted' >&2; exit 1; } | ||
| 53 | else | ||
| 54 | [[ $dataset == */staging/$instance ]] || { echo 'Preview Shale dataset is not mounted' >&2; exit 1; } | ||
| 55 | fi | ||
| 56 | |||
| 57 | scratch=$(mktemp -d) | ||
| 58 | trap 'rm -rf "$scratch"' EXIT | ||
| 59 | for 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; } | ||
| 63 | done | ||
| 64 | python3 - "$scratch/data/astheno.shale.db" <<'PY' | ||
| 65 | import sqlite3 | ||
| 66 | import sys | ||
| 67 | |||
| 68 | db = sqlite3.connect(f"file:{sys.argv[1]}?mode=ro", uri=True) | ||
| 69 | assert db.execute("PRAGMA integrity_check").fetchone()[0] == "ok" | ||
| 70 | PY | ||
| 71 | |||
| 72 | if [[ $instance != shale ]]; then | ||
| 73 | "${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance" | ||
| 74 | fi | ||
| 75 | if [[ $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; } | ||
| 83 | fi | ||
| 84 | |||
| 85 | snapshot=$dataset@before-shale-import-$(date +%s)-$$ | ||
| 86 | "${remote[@]}" "zfs snapshot $snapshot" | ||
| 87 | for 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; } | ||
| 92 | done | ||
| 93 | uid=$("${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 | |||
| 97 | if [[ $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" | ||
| 102 | else | ||
| 103 | python3 "$(dirname "$0")/deploy.py" stage shale | ||
| 104 | "${remote[@]}" "zfs destroy $snapshot" | ||
| 105 | echo "Imported and tested $instance from $source_snapshot" | ||
| 106 | fi | ||
tools/import-source-data.sh deleted-68| ... | @@ -1,68 +0,0 @@ | ||
| 1 | #!/usr/bin/env bash | ||
| 2 | set -euo pipefail | ||
| 3 | |||
| 4 | : "${STUDIO_DEPLOY_HOST:?Set STUDIO_DEPLOY_HOST to the production target}" | ||
| 5 | source_host=${STUDIO_MIGRATION_SOURCE:-zenith} | ||
| 6 | target_host=$STUDIO_DEPLOY_HOST | ||
| 7 | target_port=${STUDIO_DEPLOY_PORT:-22} | ||
| 8 | remote=(ssh -p "$target_port" "$target_host") | ||
| 9 | target_dir=/srv/prod/clover-source-of-truth/data | ||
| 10 | tree_hash="$(dirname "$0")/tree-hash.py" | ||
| 11 | |||
| 12 | if [[ -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'" | ||
| 17 | else | ||
| 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 | } | ||
| 24 | fi | ||
| 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" | ||
| 26 | dataset=$("${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; } | ||
| 28 | 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/clover-source-of-truth') | ||
| 29 | job_status=${job_response##*$'\n'} | ||
| 30 | if [[ $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; } | ||
| 40 | elif [[ $job_status != 404 ]]; then | ||
| 41 | echo "Could not verify the home server job: $job_status" >&2 | ||
| 42 | exit 1 | ||
| 43 | fi | ||
| 44 | |||
| 45 | source_manifest=$("${source[@]}" "python3 - '$source_dir'" < "$tree_hash") | ||
| 46 | source_bytes=$(python3 -c 'import json,sys; print(json.load(sys.stdin)["bytes"])' <<<"$source_manifest") | ||
| 47 | available=$("${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 | |||
| 50 | snapshot=$dataset@before-source-data-import-$(date +%s)-$$ | ||
| 51 | "${remote[@]}" "set -e; zfs snapshot $snapshot; rm -rf -- '$target_dir'; mkdir -p -- '$target_dir'" | ||
| 52 | if [[ -n ${STUDIO_MIGRATION_SNAPSHOT:-} ]]; then | ||
| 53 | "${remote[@]}" "bash -c \"set -euo pipefail; tar -C '$source_dir' -cf - . | tar -C '$target_dir' -xf -\"" | ||
| 54 | else | ||
| 55 | "${source[@]}" "tar -C '$source_dir' -cf - ." | | ||
| 56 | "${remote[@]}" "tar -C '$target_dir' -xf -" | ||
| 57 | fi | ||
| 58 | target_manifest=$("${remote[@]}" "python3 - '$target_dir'" < "$tree_hash") | ||
| 59 | [[ $source_manifest == "$target_manifest" ]] || { echo "Source and target trees differ; restore $snapshot" >&2; exit 1; } | ||
| 60 | uid=$("${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\"'" | ||
| 62 | if [[ -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 | } | ||
| 67 | fi | ||
| 68 | echo "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 | ||
| 2 | set -eu | ||
| 3 | |||
| 4 | instance=${1:?usage: tools/import-source-index.sh clover-source-of-truth-preview-XXXXXXXX} | ||
| 5 | printf '%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 | |||
| 10 | source_host=${STUDIO_MIGRATION_SOURCE:-zenith} | ||
| 11 | target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1} | ||
| 12 | target_port=${STUDIO_DEPLOY_PORT:-2222} | ||
| 13 | root="/srv/staging/$instance/data" | ||
| 14 | mount="/srv/staging/$instance" | ||
| 15 | source_id=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'") | ||
| 16 | test "$source_id" = clover-source-of-truth || { echo 'Preview belongs to another service' >&2; exit 1; } | ||
| 17 | dataset=$(ssh -p "$target_port" "$target_host" "findmnt -n -o SOURCE --mountpoint $mount") | ||
| 18 | case $dataset in */staging/"$instance") ;; *) echo 'Preview dataset is not mounted' >&2; exit 1 ;; esac | ||
| 19 | |||
| 20 | scratch=$(mktemp -d) | ||
| 21 | source_backup= | ||
| 22 | cleanup() { | ||
| 23 | rm -rf "$scratch" | ||
| 24 | if [ -n "$source_backup" ]; then | ||
| 25 | ssh "$source_host" "rm -rf '$source_backup'" | ||
| 26 | fi | ||
| 27 | } | ||
| 28 | trap cleanup EXIT | ||
| 29 | |||
| 30 | source_backup=$(ssh "$source_host" sh -s <<'REMOTE' | ||
| 31 | set -eu | ||
| 32 | out=$(mktemp -d /tmp/studio-source-index-XXXXXX) | ||
| 33 | trap 'rm -rf "$out"' EXIT | ||
| 34 | source='/mnt/storage1/clover/Documents/Config/paper clover/cache.sqlite' | ||
| 35 | sqlite3 -readonly "$source" ".backup '$out/cache.sqlite'" | ||
| 36 | test "$(sqlite3 -readonly "$out/cache.sqlite" 'PRAGMA integrity_check;')" = ok | ||
| 37 | trap - EXIT | ||
| 38 | printf '%s\n' "$out" | ||
| 39 | REMOTE | ||
| 40 | ) | ||
| 41 | rsync -a "$source_host:$source_backup/cache.sqlite" "$scratch/cache.sqlite" | ||
| 42 | python3 - "$scratch/cache.sqlite" <<'PY' | ||
| 43 | import sqlite3 | ||
| 44 | import sys | ||
| 45 | |||
| 46 | db = sqlite3.connect('file:' + sys.argv[1] + '?mode=ro&immutable=1', uri=True) | ||
| 47 | assert db.execute('PRAGMA integrity_check').fetchone()[0] == 'ok' | ||
| 48 | PY | ||
| 49 | |||
| 50 | ssh -p "$target_port" "$target_host" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance" | ||
| 51 | snapshot="$dataset@before-source-index-import-$(date +%s)-$$" | ||
| 52 | ssh -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 | |||
| 54 | rsync -a -e "ssh -p $target_port" "$scratch/cache.sqlite" "$target_host:$root/cache.sqlite" | ||
| 55 | owner=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"clover-source-of-truth\"])'") | ||
| 56 | ssh -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" | ||
| 57 | drift=$(rsync -rnc --out-format='%n' -e "ssh -p $target_port" "$scratch/cache.sqlite" "$target_host:$root/cache.sqlite") | ||
| 58 | test -z "$drift" || { echo "Index copy differs from source backup; restore $snapshot" >&2; exit 1; } | ||
| 59 | |||
| 60 | python3 "$(dirname "$0")/deploy.py" stage clover-source-of-truth | ||
| 61 | ssh -p "$target_port" "$target_host" "python3 - <<'PY' | ||
| 62 | import sqlite3 | ||
| 63 | source = sqlite3.connect('file:$root/cache.sqlite?mode=ro', uri=True) | ||
| 64 | assert source.execute('PRAGMA integrity_check').fetchone()[0] == 'ok' | ||
| 65 | for table in ('media_files', 'derived_files', 'derived_refs'): | ||
| 66 | print(table, source.execute('SELECT count(*) FROM ' + table).fetchone()[0]) | ||
| 67 | PY" | ||
| 68 | echo "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 | ||
| 2 | set -euo pipefail | ||
| 3 | |||
| 4 | instance=${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 | |||
| 10 | source_host=${STUDIO_MIGRATION_SOURCE:-zenith} | ||
| 11 | target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1} | ||
| 12 | target_port=${STUDIO_DEPLOY_PORT:-2222} | ||
| 13 | remote=(ssh -p "$target_port" "$target_host") | ||
| 14 | source_copy_host=$source_host | ||
| 15 | source_rsh=ssh | ||
| 16 | offline=false | ||
| 17 | if [[ -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 | ||
| 25 | fi | ||
| 26 | if [[ $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 | ||
| 45 | else | ||
| 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; } | ||
| 49 | fi | ||
| 50 | dataset=$("${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 | |||
| 56 | scratch=$(mktemp -d) | ||
| 57 | trap 'rm -rf "$scratch"' EXIT | ||
| 58 | rsync -a -e "$source_rsh" "$source_copy_host:/mnt/storage1/apps/yt-feed/" "$scratch/" | ||
| 59 | python3 - "$scratch" <<'PY' | ||
| 60 | import json | ||
| 61 | from pathlib import Path | ||
| 62 | import sys | ||
| 63 | |||
| 64 | root = Path(sys.argv[1]) | ||
| 65 | files = list(root.glob("*.json")) | ||
| 66 | if not files: | ||
| 67 | raise ValueError("no YouTube Triage JSON state was copied") | ||
| 68 | for file in files: | ||
| 69 | json.loads(file.read_text()) | ||
| 70 | print(f"Copied {len(files)} valid JSON state files") | ||
| 71 | PY | ||
| 72 | drift=$(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 | |||
| 75 | if [[ $instance != ytdl ]]; then | ||
| 76 | "${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance" | ||
| 77 | else | ||
| 78 | "${remote[@]}" 'systemctl stop studio-dashboard' | ||
| 79 | fi | ||
| 80 | for _ 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 | ||
| 85 | done | ||
| 86 | [[ $running == 0 ]] || { echo "$instance still has a running allocation" >&2; exit 1; } | ||
| 87 | |||
| 88 | snapshot="$dataset@before-yt-feed-import-$(date +%s)-$$" | ||
| 89 | "${remote[@]}" "zfs snapshot $snapshot" | ||
| 90 | rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/data/" | ||
| 91 | uid=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"ytdl\"])'") | ||
| 92 | "${remote[@]}" "chown -R $uid:$uid $root/data" | ||
| 93 | drift=$(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 | |||
| 96 | if [[ $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" | ||
| 105 | else | ||
| 106 | python3 "$(dirname "$0")/deploy.py" stage ytdl | ||
| 107 | "${remote[@]}" "zfs destroy $snapshot" | ||
| 108 | echo "Imported and tested $instance" | ||
| 109 | fi | ||
tools/intake-migration.md deleted-7| ... | @@ -1,7 +0,0 @@ | ||
| 1 | # JSON Intake migration | ||
| 2 | |||
| 3 | Zenith'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 | |||
| 5 | Existing 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 | |||
| 7 | On 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 | |||
| 3 | An 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 | |||
| 5 | The 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 | |||
| 7 | A 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 | |||
| 9 | Production 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 | |||
| 11 | After 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 | |||
| 13 | The 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: |
| 38 | 38 | ||
| 39 | ```sh | 39 | ```sh |
| 40 | ssh -p 22 root@10.0.0.1 | 40 | ssh -p 22 root@10.0.0.1 |
| 41 | export NOMAD_TOKEN="$(cat /var/lib/studio/nomad.token)" | 41 | export NOMAD_TOKEN="$(cat /var/lib/snowglobe/nomad.token)" |
| 42 | knife_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])') | 42 | knife_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])') |
| 43 | knife_container="app-$knife_allocation" | 43 | knife_container="app-$knife_allocation" |
| 44 | podman exec "$knife_container" knife auth devices revoke-all | 44 | podman 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 |
| 75 | and update `service/knife/bundle.json`, then use the normal stage → main → prod | 75 | and update `service/knife/bundle.json`, then use the normal stage → main → prod |
| 76 | workflow. Runtime downloads under `data/runtime/knife-container` survive an infra | 76 | workflow. Runtime downloads under `data/runtime/knife-container` survive an infra |
| 77 | image rollback; rolling back code does not restore state or archive objects. | 77 | image rollback; rolling back code does not restore state or archive objects. |
| 78 | |||
| 79 | ## 2026-10-16 SSO verification | ||
| 80 | |||
| 81 | A fresh Zenith preview completed Clover's real Snow Globe sign-in, verified the | ||
| 82 | issuer/subject account binding, renewed its browser session, and opened an | ||
| 83 | authenticated WebSocket through HTTPS. Anonymous access, missing CSRF, invalid | ||
| 84 | OIDC/native transactions, and corrupt archive objects were rejected. A synthetic | ||
| 85 | object uploaded and downloaded identically with working byte ranges; temporarily | ||
| 86 | removing the preview's archive marker returned 503 and its original marker was | ||
| 87 | restored unchanged. The private allocation JSON matched its separate Nomad client, | ||
| 88 | used 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 | |||
| 3 | The 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 | |||
| 5 | If 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 | |||
| 7 | If 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 | ||
| 10 | python3 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 | |||
| 16 | It 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 | |||
| 18 | The 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 | ||
| 21 | export STUDIO_LEGACY_HANDOFF=/mnt/storage1/apps/studio-handoff/20261004T230507Z-e75419 | ||
| 22 | ``` | ||
| 23 | |||
| 24 | After 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 | |||
| 28 | The 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 |
| 20 | fall back to another copy or become misses. Key rotation invalidates reuse; | 20 | fall back to another copy or become misses. Key rotation invalidates reuse; |
| 21 | old entries remain encrypted and subject to eviction. | 21 | old entries remain encrypted and subject to eviction. |
| 22 | 22 | ||
| 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). |
| 24 | The prepare hook creates it with the assigned service owner. HDD blocks use | 24 | The prepare hook creates it with the assigned service owner. HDD blocks use |
| 25 | the managed service dataset. Fresh previews use separate managed directories | 25 | the managed service dataset. Fresh previews use separate managed directories |
| 26 | for both disk tiers. | 26 | for 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 |
| 48 | when the endpoint reported busy; end-to-end disk restore timing remains | 48 | when the endpoint reported busy; end-to-end disk restore timing remains |
| 49 | unverified. | 49 | unverified. |
| 50 | 50 | ||
| 51 | ## Zenith measurements — 2026-10-09 | 51 | ## Snow Globe measurements — 2026-10-09 |
| 52 | 52 | ||
| 53 | HyperQwen, vLLM 0.27.1, MTP with three draft tokens, 150,000-token | 53 | HyperQwen, vLLM 0.27.1, MTP with three draft tokens, 150,000-token |
| 54 | context, GPU prefix caching enabled. Production stayed running; no cache | 54 | context, 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. |
| 98 | 98 | ||
| 99 | ```sh | 99 | ```sh |
| 100 | ssh -o BatchMode=yes root@10.0.0.1 \ | 100 | ssh -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.py | 102 | < tools/benchmark-local-ai-cache.py |
| 103 | ssh -o BatchMode=yes root@10.0.0.1 \ | 103 | ssh -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.py | 105 | < tools/benchmark-local-ai-cache.py |
| 106 | ssh -o BatchMode=yes root@10.0.0.1 \ | 106 | ssh -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.py | 108 | < tools/benchmark-local-ai-cache.py |
| 109 | ``` | 109 | ``` |
| 110 | 110 |
tools/local-vm.sh+3-3| ... | @@ -1,7 +1,7 @@ | ... | @@ -1,7 +1,7 @@ |
| 1 | #!/bin/sh | 1 | #!/bin/sh |
| 2 | set -eu | 2 | set -eu |
| 3 | 3 | ||
| 4 | cache=${STUDIO_VM_CACHE_DIR:-$HOME/Library/Caches/clover-studio-vm-x86} | 4 | cache=${SNOWGLOBE_VM_CACHE_DIR:-$HOME/Library/Caches/clover-snowglobe-vm-x86} |
| 5 | mode=${1:-} | 5 | mode=${1:-} |
| 6 | qemu=$(command -v qemu-system-x86_64 || true) | 6 | qemu=$(command -v qemu-system-x86_64 || true) |
| 7 | if [ -z "$qemu" ]; then | 7 | if [ -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" |
| 26 | fi | 26 | fi |
| 27 | if [ "$mode" = installed ]; then | 27 | if [ "$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; then | 29 | if ! mount | grep -F " on $media (" >/dev/null; then |
| 30 | echo "Mount the media share at $media before starting the VM" >&2 | 30 | echo "Mount the media share at $media before starting the VM" >&2 |
| 31 | exit 1 | 31 | exit 1 |
| 32 | fi | 32 | 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" |
| 34 | fi | 34 | fi |
| 35 | if [ "${STUDIO_VM_HEADLESS:-0}" = 1 ]; then | 35 | if [ "${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" |
| 37 | else | 37 | else |
| 38 | set -- "$@" -display cocoa -serial mon:stdio | 38 | set -- "$@" -display cocoa -serial mon:stdio |
tools/log-shipper.py+2-2| ... | @@ -9,13 +9,13 @@ import time | ... | @@ -9,13 +9,13 @@ import time |
| 9 | from urllib.request import Request, urlopen | 9 | from urllib.request import Request, urlopen |
| 10 | 10 | ||
| 11 | 11 | ||
| 12 | STATE = Path("/var/lib/studio/log-shipper.json") | 12 | STATE = Path("/var/lib/snowglobe/log-shipper.json") |
| 13 | LOGS = Path("/var/lib/nomad/alloc") | 13 | LOGS = Path("/var/lib/nomad/alloc") |
| 14 | CRI = re.compile(r"^(\S+) (stdout|stderr) [FP] ?(.*)$") | 14 | CRI = re.compile(r"^(\S+) (stdout|stderr) [FP] ?(.*)$") |
| 15 | 15 | ||
| 16 | 16 | ||
| 17 | def nomad(path): | 17 | def 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) |
| 21 | 21 |
tools/media-cutover.md deleted-222| ... | @@ -1,222 +0,0 @@ | ||
| 1 | # Media dataset cutover | ||
| 2 | |||
| 3 | Before 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 | |||
| 5 | The 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 | |||
| 7 | Zenith's NFSv4 ACLs need a separate [permission cutover](storage-acl-cutover.md) before this dataset is served by NixOS. | ||
| 8 | |||
| 9 | The 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 | |||
| 11 | Run 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 | |||
| 15 | The 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 | ||
| 18 | zpool export storage1 | ||
| 19 | zpool import -N -f -d /dev/disk/by-id -o cachefile=none 8944904502819631621 | ||
| 20 | zpool get readonly,altroot storage1 | ||
| 21 | ``` | ||
| 22 | |||
| 23 | The last command must show `readonly=off` and `altroot=-` before continuing. Leave `boot-pool` alone. | ||
| 24 | |||
| 25 | ### Record identity and take a snapshot | ||
| 26 | |||
| 27 | Keep 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 | ||
| 30 | media_guid=$(zfs get -H -o value guid storage1/media) | ||
| 31 | zfs snapshot -r storage1@before-infra2-layout | ||
| 32 | ``` | ||
| 33 | |||
| 34 | ### Rename the pool to globe | ||
| 35 | |||
| 36 | The 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 | ||
| 39 | zpool export storage1 | ||
| 40 | zpool import -N -d /dev/disk/by-id -o cachefile=none 8944904502819631621 globe | ||
| 41 | zpool get guid,readonly,altroot globe | ||
| 42 | zfs list -r -o name,mountpoint,mounted globe | ||
| 43 | ``` | ||
| 44 | |||
| 45 | Expect 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 | |||
| 47 | From 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 | |||
| 61 | The 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 | ||
| 66 | test "$(zfs get -H -o value guid globe/clover/Media)" = "$media_guid" | ||
| 67 | zfs list -o name,mountpoint,mounted globe globe/apps globe/clover globe/clover/Media | ||
| 68 | zfs get encryptionroot globe/apps globe/clover globe/clover/Media | ||
| 69 | zfs list -t snapshot -r -o name globe/clover/Media | ||
| 70 | ``` | ||
| 71 | |||
| 72 | The identity check must succeed. Expect these mountpoint properties, with `mounted=no` throughout: | ||
| 73 | |||
| 74 | ```text | ||
| 75 | globe /srv | ||
| 76 | globe/apps /mnt/storage1/apps | ||
| 77 | globe/clover /srv/clover | ||
| 78 | globe/clover/Media /srv/clover/Media | ||
| 79 | ``` | ||
| 80 | |||
| 81 | Media'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 | |||
| 83 | A 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 | |||
| 85 | The 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 | |||
| 89 | The 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 | |||
| 91 | These 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 | ||
| 94 | zfs destroy -vr globe/apps-hourly-2026-09-06_21-00-clone | ||
| 95 | zfs destroy -vr globe/apps-hourly-2026-09-08_23-00-clone | ||
| 96 | zfs destroy -vr globe/apps-hourly-2026-09-11_07-00-clone | ||
| 97 | zfs destroy -vr globe/apps-hourly-2026-09-11_12-00-clone | ||
| 98 | zfs destroy -vr globe/apps-hourly-2026-09-12_14-00-clone | ||
| 99 | zfs destroy -vr globe/apps/snowglobe-rehearsal-20261002 | ||
| 100 | ``` | ||
| 101 | |||
| 102 | Check the remaining app datasets and source snapshots afterward: | ||
| 103 | |||
| 104 | ```sh | ||
| 105 | zfs list -r -o name,used,mountpoint globe/apps | ||
| 106 | zfs list -t snapshot -d 1 -o name globe/apps | ||
| 107 | ``` | ||
| 108 | |||
| 109 | ### Unlock and mount Clover and Media | ||
| 110 | |||
| 111 | Clover 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 | |||
| 113 | Run 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 | ||
| 116 | if [ "$(zfs get -H -o value mounted globe)" = no ]; then zfs mount globe; fi | ||
| 117 | test "$(findmnt -n -o SOURCE --mountpoint /srv)" = globe | ||
| 118 | ``` | ||
| 119 | |||
| 120 | Load 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 | ||
| 123 | zfs load-key -L file:///run/infra2-keys/clover.hex globe/clover | ||
| 124 | zfs load-key -L file:///run/infra2-keys/media.hex globe/clover/Media | ||
| 125 | zfs mount globe/clover | ||
| 126 | zfs mount globe/clover/Media | ||
| 127 | rm /run/infra2-keys/clover.hex /run/infra2-keys/media.hex | ||
| 128 | test "$(findmnt -n -o SOURCE --mountpoint /srv/clover)" = globe/clover | ||
| 129 | test "$(findmnt -n -o SOURCE --mountpoint /srv/clover/Media)" = globe/clover/Media | ||
| 130 | findmnt -rn -o SOURCE,TARGET,FSTYPE --mountpoint /srv/clover/Media | ||
| 131 | ``` | ||
| 132 | |||
| 133 | The 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 | |||
| 137 | The 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 | ||
| 140 | zfs load-key -L file:///run/infra2-keys/apps.hex globe/apps | ||
| 141 | zfs mount globe/apps | ||
| 142 | rm /run/infra2-keys/apps.hex | ||
| 143 | test "$(findmnt -n -o SOURCE --mountpoint /mnt/storage1/apps)" = globe/apps | ||
| 144 | findmnt -rn -o SOURCE,TARGET,FSTYPE --mountpoint /mnt/storage1/apps | ||
| 145 | ``` | ||
| 146 | |||
| 147 | Expect `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 | |||
| 151 | The 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 | |||
| 153 | Zenith'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 | |||
| 157 | Manual 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 | |||
| 161 | Clover 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 | ||
| 164 | test ! -e .music-case-rename && test ! -L .music-case-rename && | ||
| 165 | mv -T -- music .music-case-rename && | ||
| 166 | mv -T -- .music-case-rename Music | ||
| 167 | ``` | ||
| 168 | |||
| 169 | Lowercase 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 | |||
| 171 | Zenith'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 | ||
| 174 | test -d /srv/clover/Media/torrent | ||
| 175 | test ! -e /srv/clover/Media/Seedbox | ||
| 176 | mv /srv/clover/Media/torrent /srv/clover/Media/Seedbox | ||
| 177 | ln -s Seedbox /srv/clover/Media/torrent | ||
| 178 | test "$(stat -c %d:%i /srv/clover/Media/Seedbox)" = "$(stat -Lc %d:%i /srv/clover/Media/torrent)" | ||
| 179 | ``` | ||
| 180 | |||
| 181 | The 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 | ||
| 184 | test -d /srv/clover/Media/music_intake | ||
| 185 | test ! -e '/srv/clover/Media/Intake - Music' | ||
| 186 | mv /srv/clover/Media/music_intake '/srv/clover/Media/Intake - Music' | ||
| 187 | ln -s 'Intake - Music' /srv/clover/Media/music_intake | ||
| 188 | ``` | ||
| 189 | |||
| 190 | ### Service paths for the reorganized tree | ||
| 191 | |||
| 192 | The 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 | |||
| 194 | Navidrome 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 | |||
| 196 | Before 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 | |||
| 198 | The 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 | |||
| 200 | A 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 | |||
| 202 | The 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 | |||
| 204 | The 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 | |||
| 206 | The 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 | |||
| 208 | At 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 | |||
| 210 | After 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 | |||
| 212 | The 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 | |||
| 216 | With `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 | |||
| 218 | Sonarr 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 | |||
| 222 | For 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 | ||
| 2 | from importlib import import_module | ||
| 3 | import io | ||
| 4 | import json | ||
| 5 | import os | ||
| 6 | from pathlib import Path | ||
| 7 | import shutil | ||
| 8 | import subprocess | ||
| 9 | import sys | ||
| 10 | import tempfile | ||
| 11 | from types import SimpleNamespace | ||
| 12 | import unittest | ||
| 13 | from unittest.mock import patch | ||
| 14 | import xml.etree.ElementTree as ET | ||
| 15 | |||
| 16 | import release | ||
| 17 | import snowglobe | ||
| 18 | |||
| 19 | |||
| 20 | transition = import_module("namespace-transition") | ||
| 21 | |||
| 22 | |||
| 23 | class 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 | |||
| 337 | if __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.""" | ||
| 3 | import argparse | ||
| 4 | import grp | ||
| 5 | import json | ||
| 6 | import os | ||
| 7 | from pathlib import Path | ||
| 8 | import pwd | ||
| 9 | import subprocess | ||
| 10 | import urllib.request | ||
| 11 | |||
| 12 | |||
| 13 | NAMESPACE = 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 | ) | ||
| 17 | PREVIOUS = NAMESPACE["previous"] | ||
| 18 | NIXOS_STATE = Path("/var/lib/nixos") | ||
| 19 | DIRECTORIES = tuple((Path(parent) / "snowglobe", Path(parent) / PREVIOUS) | ||
| 20 | for parent in ("/opt", "/var/lib", "/var/lib/caddy", "/var/cache")) | ||
| 21 | |||
| 22 | |||
| 23 | def 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 | |||
| 36 | def 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 | |||
| 42 | def 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 | |||
| 51 | def 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 | |||
| 56 | def 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 | |||
| 67 | def 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 | |||
| 76 | def stop_preview(identity): | ||
| 77 | for prefix in ("snowglobe", PREVIOUS): | ||
| 78 | subprocess.run(["systemctl", "stop", prefix + "-preview-" + identity], capture_output=True) | ||
| 79 | |||
| 80 | |||
| 81 | def 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 | |||
| 88 | def 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 | |||
| 97 | def 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 | |||
| 115 | def 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 | |||
| 125 | def 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 | |||
| 158 | def 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 | |||
| 195 | def 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 | |||
| 222 | def 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 | |||
| 232 | def 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 | |||
| 244 | if __name__ == "__main__": | ||
| 245 | main() | ||
tools/oidc-provider.py+2-1| ... | @@ -1,6 +1,7 @@ | ... | @@ -1,6 +1,7 @@ |
| 1 | #!/usr/bin/env python3 | 1 | #!/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.""" |
| 3 | import json | 3 | import json |
| 4 | from importlib import import_module | ||
| 4 | import subprocess | 5 | import subprocess |
| 5 | import sys | 6 | import sys |
| 6 | 7 | ||
| ... | @@ -8,7 +9,7 @@ data = json.load(sys.stdin) | ... | @@ -8,7 +9,7 @@ data = json.load(sys.stdin) |
| 8 | if data["request"]["kind"] != "client": | 9 | if data["request"]["kind"] != "client": |
| 9 | raise ValueError("unsupported Snowglobe input") | 10 | raise ValueError("unsupported Snowglobe input") |
| 10 | result = subprocess.run( | 11 | result = 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 | ) |
| 14 | sys.stdout.write(result.stdout) | 15 | sys.stdout.write(result.stdout) |
tools/openclaw-verify.py+1-1| ... | @@ -5,7 +5,7 @@ import subprocess | ... | @@ -5,7 +5,7 @@ import subprocess |
| 5 | 5 | ||
| 6 | 6 | ||
| 7 | parser = argparse.ArgumentParser() | 7 | parser = argparse.ArgumentParser() |
| 8 | parser.add_argument("--host", default="root@zenith") | 8 | parser.add_argument("--host", default="root@10.0.0.1") |
| 9 | task = parser.add_mutually_exclusive_group() | 9 | task = parser.add_mutually_exclusive_group() |
| 10 | task.add_argument("--prepare-task", action="store_true") | 10 | task.add_argument("--prepare-task", action="store_true") |
| 11 | task.add_argument("--check-task", action="store_true") | 11 | task.add_argument("--check-task", action="store_true") |
tools/pds-migration.md deleted-7| ... | @@ -1,7 +0,0 @@ | ||
| 1 | # PDS data migration | ||
| 2 | |||
| 3 | The 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 | |||
| 5 | For 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 | |||
| 7 | For 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 | |||
| 3 | The 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 | ||
| 6 | export STUDIO_DEPLOY_HOST=root@10.0.0.1 | ||
| 7 | export STUDIO_DEPLOY_PORT=22 | ||
| 8 | export STUDIO_LEGACY_HANDOFF=/mnt/storage1/apps/studio-handoff/20261004T230507Z-e75419 | ||
| 9 | ``` | ||
| 10 | |||
| 11 | Provision 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 | ||
| 27 | ssh root@10.0.0.1 'python3 - tailscale' < tools/import-personal-files.py | ||
| 28 | ssh root@10.0.0.1 'python3 - ddns-updater' < tools/import-personal-files.py | ||
| 29 | ssh root@10.0.0.1 'python3 - copyparty' < tools/import-personal-files.py | ||
| 30 | ssh root@10.0.0.1 'python3 - ytdl' < tools/import-personal-files.py | ||
| 31 | ``` | ||
| 32 | |||
| 33 | Tailscale 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 | |||
| 35 | YouTube 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 | |||
| 37 | Samba 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 | |||
| 39 | Activate 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 | |||
| 41 | Do 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 | |||
| 43 | October 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 | |||
| 45 | Before 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 | |||
| 3 | Normal service and dashboard previews run on Snow Globe. Use the optional NixOS | ||
| 4 | VM only when a change needs an isolated host, OS, storage, or guest boundary. | ||
| 5 | It has no production GPU; do not download model weights or enable inference. | ||
| 6 | |||
| 7 | The VM configuration is `nixos/vm.nix` (flake `vm`), with hostname `snowglobe-rehearsal`, | ||
| 8 | domain `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 | ||
| 12 | SNOWGLOBE_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`. | ||
| 19 | Those media bytes are personal source data, not synthetic fixtures. The VM's | ||
| 20 | own Clover dataset is separate. Use disposable test data and do not inspect | ||
| 21 | private source contents without authorization. | ||
| 22 | |||
| 23 | Use the configured DNS and TLS routing for the VM. Do not hand-edit host files, | ||
| 24 | DNS, or trust to bypass a failed setup. Keep VM console/browser checks inside the | ||
| 25 | normal browser panel. Rehearsal evidence belongs in its relevant runbook; the | ||
| 26 | primary agent workflow remains staging on Snow Globe. | ||
tools/release-host-test.py created+90| ... | @@ -0,0 +1,90 @@ | ||
| 1 | #!/usr/bin/env python3 | ||
| 2 | import json | ||
| 3 | import os | ||
| 4 | from pathlib import Path | ||
| 5 | import subprocess | ||
| 6 | import tempfile | ||
| 7 | from types import SimpleNamespace | ||
| 8 | import unittest | ||
| 9 | from unittest.mock import patch | ||
| 10 | |||
| 11 | import release | ||
| 12 | |||
| 13 | PREVIOUS_HOST = release.transition.NAMESPACE["previousHost"] | ||
| 14 | |||
| 15 | |||
| 16 | class 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 | |||
| 44 | class 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 | |||
| 89 | if __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 |
| 4 | import fcntl | 4 | import fcntl |
| 5 | import hashlib | 5 | import hashlib |
| 6 | import json | 6 | import json |
| 7 | from importlib import import_module | ||
| 7 | import os | 8 | import os |
| 8 | from pathlib import Path | 9 | from pathlib import Path |
| 9 | import re | 10 | import re |
| ... | @@ -11,34 +12,23 @@ import subprocess | ... | @@ -11,34 +12,23 @@ import subprocess |
| 11 | import time | 12 | import time |
| 12 | 13 | ||
| 13 | 14 | ||
| 14 | ROOT = Path("/opt/studio") | 15 | transition = import_module("namespace-transition") |
| 16 | |||
| 17 | ROOT = Path("/opt/snowglobe") | ||
| 15 | RELEASES = ROOT / "releases" | 18 | RELEASES = ROOT / "releases" |
| 16 | STATE = Path("/var/lib/studio") | 19 | STATE = Path("/var/lib/snowglobe") |
| 17 | HISTORY = STATE / "deployments.json" | 20 | HISTORY = STATE / "deployments.json" |
| 18 | SOURCES = ("config", "service", "tools", "nixos", "dashboard", "guest", "flake.nix", "flake.lock", "readme.md") | 21 | SOURCES = ("config", "service", "tools", "nixos", "dashboard", "guest", "flake.nix", "flake.lock", "readme.md", "AGENTS.md") |
| 19 | RELEASE_ID = re.compile(r"[0-9a-f]{16}\Z") | 22 | RELEASE_ID = re.compile(r"[0-9a-f]{16}\Z") |
| 20 | STAGE_ID = re.compile(r"[a-z][a-z0-9-]*\Z") | 23 | STAGE_ID = re.compile(r"[a-z][a-z0-9-]*\Z") |
| 21 | 24 | ||
| 22 | 25 | ||
| 23 | def 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 | |||
| 28 | def files(root): | 26 | def files(root): |
| 29 | excluded = excluded_services(root) | ||
| 30 | for name in SOURCES: | 27 | for name in SOURCES: |
| 31 | source = root / name | 28 | source = root / name |
| 32 | if not source.exists() and not source.is_symlink(): | 29 | if not source.exists() and not source.is_symlink(): |
| 33 | continue | 30 | 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 / release | 79 | 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 None | 96 | 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.name | 100 | return target.name |
| 111 | 101 | ||
| ... | @@ -116,7 +106,7 @@ def main_release(version=None): | ... | @@ -116,7 +106,7 @@ def main_release(version=None): |
| 116 | return None | 106 | 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): |
| 137 | 127 | ||
| 138 | def jobs(path): | 128 | def 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 | ).stdout | 132 | ).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 result | 136 | return result |
| 147 | 137 | ||
| 148 | 138 | ||
| 139 | def 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 | |||
| 149 | def activate(release, legacy=False, initial=False): | 148 | def 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 None | 161 | 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 = None | 166 | 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 backup | 222 | return backup |
| 217 | 223 | ||
| 218 | 224 | ||
| 219 | def main(): | 225 | def 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) |
| 41 | 41 | ||
| 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'}} |
| 51 | 51 | ||
| ... | @@ -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 |
| 10 | import urllib.request | 10 | import urllib.request |
| 11 | 11 | ||
| 12 | ROUTES = "/var/lib/caddy/routes.caddy" | 12 | ROUTES = "/var/lib/caddy/routes.caddy" |
| 13 | TOKEN = "/var/lib/studio/router.token" | 13 | TOKEN = "/var/lib/snowglobe/router.token" |
| 14 | ROUTE_DIR = "/var/lib/studio/routes" | 14 | ROUTE_DIR = "/var/lib/snowglobe/routes" |
| 15 | HOST = re.compile(r"[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?\Z") | 15 | HOST = re.compile(r"[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?\Z") |
| 16 | 16 | ||
| 17 | 17 | ||
| ... | @@ -39,13 +39,13 @@ def proxy(upstreams, indent, uncompressed=False, host=None): | ... | @@ -39,13 +39,13 @@ def proxy(upstreams, indent, uncompressed=False, host=None): |
| 39 | 39 | ||
| 40 | 40 | ||
| 41 | def shale_mcp_routes(port): | 41 | def 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}", " "), " }"] |
| 50 | 50 | ||
| 51 | 51 | ||
| ... | @@ -100,13 +100,12 @@ def shale_git_routes(upstreams): | ... | @@ -100,13 +100,12 @@ def shale_git_routes(upstreams): |
| 100 | 100 | ||
| 101 | 101 | ||
| 102 | def render(token): | 102 | def 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 | continue | 181 | 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 { |
| 13 | 13 | ||
| 14 | let fm = FileManager.default | 14 | let fm = FileManager.default |
| 15 | let directory = URL(fileURLWithPath: CommandLine.arguments[1], isDirectory: true) | 15 | let 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) |
| 17 | var failures = 0 | 17 | var failures = 0 |
| 18 | 18 | ||
| 19 | func check(_ condition: Bool) throws { | 19 | func 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 checks | 1 | # Service dependencies and rollout |
| 2 | 2 | ||
| 3 | On 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. | 3 | Declare providers and requirements in Pkl. Provisioning allocates private |
| 4 | 4 | inputs, and Nomad templates discover provider endpoints. Watched endpoint | |
| 5 | Redis 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/). | 5 | changes restart consumers; applications that persist internal endpoints must |
| 6 | 6 | receive repeatable setup updates. [configure-arr.py](configure-arr.py), for | |
| 7 | After 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). | 7 | example, derives Jackett/qBittorrent endpoints and remote path mappings from |
| 8 | 8 | the service declarations. | |
| 9 | Evil.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 | |
| 10 | 10 | A successful non-sidecar prestart task is not rerun on every application | |
| 11 | Release `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. | 11 | restart. Dependent jobs therefore also need runtime retry and health recovery. |
| 12 | 12 | The schema and renderer own retry delays, health-restart grace, and deployment | |
| 13 | After 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. | 13 | deadlines. Verify the actual client connection after provider reallocation; |
| 14 | 14 | a healthy application HTTP route alone does not prove database connectivity. | |
| 15 | Keycloak 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 | |
| 16 | 16 | The default single-allocation rollout stops the old writer before starting the | |
| 17 | Shale 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. | 17 | new one. Writable SQLite stores cannot safely overlap writers. Stateless jobs |
| 18 | 18 | can declare canary rollout when their ports and mounts allow it. Generated | |
| 19 | Open 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. | 19 | Caddy proxies retry connection failures while service discovery catches up; |
| 20 | 20 | this does not guarantee uninterrupted long-running requests or WebSockets. | |
| 21 | For 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 | |
| 22 | 22 | A new cloned preview snapshots its service dataset, writable external ZFS | |
| 23 | Writable 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. | 23 | mounts, and PostgreSQL dataset in one operation. An isolated PostgreSQL clone |
| 24 | 24 | supplies the preview database. The temporary database clone is removed after | |
| 25 | The 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. | 25 | copying. Repeating staging retains existing preview data; fresh isolation |
| 26 | 26 | starts empty and rejects writable external mounts. Review outbound side | |
| 27 | An 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. | 27 | effects independently of filesystem isolation. |
| 28 | 28 | ||
| 29 | Promotion 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. | 29 | ZFS clones retain their source encryption root, even below the independently |
| 30 | 30 | encrypted staging parent. Keep source keys available while clones exist. | |
| 31 | Release `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`. | 31 | Fresh previews inherit staging encryption. Verify actual mount bindings before |
| 32 | 32 | allowing disposable writes, especially read-only personal mounts. | |
| 33 | Read-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 | |
| 34 | 34 | Inspect generated-job changes before expecting a restart. A provider script | |
| 35 | Release `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. | 35 | change can alter setup without changing a running job. Prepared startup files |
| 36 | 36 | are included in task change detection; unrelated files are not. A Nomad plan | |
| 37 | The 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. | 37 | reporting 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 |
| 15 | 15 | ||
| 16 | 16 | ||
| 17 | def database(mode, timeout): | 17 | def 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) |
| 20 | 20 | ||
| 21 | 21 | ||
| ... | @@ -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.Row | 123 | 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 | |||
| 3 | Shale 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 | |||
| 5 | The 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 | |||
| 7 | The 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 | |||
| 9 | After 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 | ||
| 12 | SELECT 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 | ||
| 22 | python3 tools/import-forgejo-to-shale.py \ | ||
| 23 | --target /srv/prod/shale \ | ||
| 24 | --metadata /run/personal-forgejo-repositories.json | ||
| 25 | ``` | ||
| 26 | |||
| 27 | The 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 | |||
| 29 | New 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 | |||
| 31 | Existing 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 | |||
| 33 | A 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 | |||
| 35 | After 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 | |||
| 37 | The 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 | |||
| 39 | Run this while the target job is stopped and its allocations have exited: | ||
| 40 | |||
| 41 | ```sh | ||
| 42 | python3 tools/import-forgejo-issues.py \ | ||
| 43 | --target /srv/prod/shale \ | ||
| 44 | --source /var/lib/studio/forgejo-issue-migration/source.json | ||
| 45 | ``` | ||
| 46 | |||
| 47 | For 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 | |||
| 49 | Six 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 | |||
| 51 | The 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 | |||
| 53 | Production 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 | |||
| 55 | The 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 | |||
| 57 | The 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 | |||
| 59 | Shale 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 | |||
| 61 | Production 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 | |||
| 63 | The 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 | |||
| 65 | Zenith'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 | |||
| 67 | For 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 | |||
| 69 | After 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 | |||
| 73 | The 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 | |||
| 75 | Shale 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 | |||
| 79 | The 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 | |||
| 81 | The 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 | |||
| 83 | An 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 | |||
| 5 | Snow Globe is the existing Ryzen 9 5950X computer, with 128 GB RAM, an RTX 3090, | ||
| 6 | a 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 | ||
| 11 | settings. Use the release deployment workflow for host changes. | ||
| 12 | |||
| 13 | Read-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 | ||
| 15 | mounted production, staging, Clover, and Media datasets. The host configuration | ||
| 16 | names it `snowglobe`. Renaming the computer preserves the existing hardware, | ||
| 17 | pool, 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 | |||
| 31 | The retained apps tree and other old datasets are not active deployment | ||
| 32 | sources. Removing obsolete repository import tools does not authorize destroying | ||
| 33 | those datasets, snapshots, or private migration evidence. | ||
| 34 | |||
| 35 | Clover and Media are case-insensitive POSIX-ACL filesystems. Their current | ||
| 36 | properties are `acltype=posix`, `aclmode=discard`, `aclinherit=discard`. | ||
| 37 | Production and staging also use POSIX ACLs. Preserve allocated UIDs and the | ||
| 38 | shared group 3000. Test permission changes on a clone; do not recursively | ||
| 39 | change personal ownership to repair one service. | ||
| 40 | |||
| 41 | The [site mapping](../config/site.pkl) owns media folder names. Saved application | ||
| 42 | paths are preserved by the service bind mounts: qBittorrent sees Seedbox at | ||
| 43 | both `/data/media/Seedbox` and `/data/media/torrent`; Jellyfin keeps its | ||
| 44 | `/media/jellyfin/...` paths. Preserve those mappings and YouTube archive files | ||
| 45 | alongside their videos when reorganizing media. | ||
| 46 | |||
| 47 | Samba serves these datasets directly using POSIX permissions. Its declaration | ||
| 48 | preserves shared editing with `0660` files and `2770` directories and uses | ||
| 49 | kernel oplocks for service-write visibility. Run | ||
| 50 | `swift tools/samba-macos-test.swift <mounted-share>` against disposable files | ||
| 51 | after changing permissions or SMB configuration. The probe exercises Cocoa | ||
| 52 | safe saves, packages, metadata/resource forks, and cleanup. | ||
| 53 | |||
| 54 | ## Unlock and recovery | ||
| 55 | |||
| 56 | The host configuration lists six encrypted roots and their systemd credential | ||
| 57 | names. TPM-encrypted blobs live in `/etc/credstore.encrypted`; the unlock unit | ||
| 58 | runs after pool import and before mounting. Plaintext keys must stay outside | ||
| 59 | the Nix store and tracked configuration. Nomad refuses to start without the | ||
| 60 | actual pool, Clover, Media, production, and staging mounts. | ||
| 61 | |||
| 62 | Credentials are bound to the machine's TPM and PCR 7. Clearing/replacing the | ||
| 63 | TPM or changing firmware can require manual unlock and resealing. Secure Boot | ||
| 64 | is disabled, so automatic TPM unlock does not establish a trusted boot chain. | ||
| 65 | Keep independent recovery keys when replacing hardware. | ||
| 66 | |||
| 67 | The private off-server recovery archive on Clover's Mac includes the additional | ||
| 68 | production/staging keys in `postgres-backups/new-os-dataset-keys.json` and the | ||
| 69 | verified pre-install PostgreSQL logical/physical exports in | ||
| 70 | `postgres-backups/20261004T230507Z-e75419.tar`. Original dataset keys | ||
| 71 | and the former OS configuration are in the same private recovery collection. | ||
| 72 | These paths document locations only; they do not establish current backup | ||
| 73 | completeness or authorize opening private contents. | ||
| 74 | |||
| 75 | For manual unlock on a confirmed recovery host, recover the required key into | ||
| 76 | a root-only file in `/run`, then run these commands one at a time with the | ||
| 77 | verified dataset substituted: | ||
| 78 | |||
| 79 | ```sh | ||
| 80 | zfs load-key -L file:///run/<private-key-file> <dataset> | ||
| 81 | rm /run/<private-key-file> | ||
| 82 | zfs mount <dataset> | ||
| 83 | findmnt --mountpoint <expected-mountpoint> | ||
| 84 | ``` | ||
| 85 | |||
| 86 | Loading a key does not mount the filesystem. Mount parents before children; | ||
| 87 | never overlay a nonempty mountpoint to bypass a mount failure. | ||
| 88 | |||
| 89 | ## Control state and backups | ||
| 90 | |||
| 91 | The NVMe contains both Nomad state and `/var/lib/snowglobe`: service identities, | ||
| 92 | ACL token files, dashboard accounts, release history, and backup manifests and | ||
| 93 | database dumps. Read-only `findmnt` inspection on 2026-10-16 confirmed both | ||
| 94 | control-state locations remain on the ext4 OS filesystem, outside the ZFS | ||
| 95 | service datasets. Replacing the OS disk without recovering this state loses | ||
| 96 | more than service files. A Nomad snapshot contains jobs, ACLs, and secret | ||
| 97 | variables; it does not contain the separate dashboard account database or UID | ||
| 98 | registry. See [data restore](data-restore.md) for service recovery boundaries. | ||
| 99 | |||
| 100 | No automatic ZFS snapshot or release-backup retention schedule is configured. | ||
| 101 | Release backups do not substitute for independent off-server recovery copies. | ||
| 102 | Before destructive storage or OS work, verify key recovery and application/ | ||
| 103 | database restores from at least two restricted copies stored separately off | ||
| 104 | this computer. Preserve the existing encrypted roots, pool host ID, numeric | ||
| 105 | owners, 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 | ||
| 2 | import json | ||
| 3 | import os | ||
| 4 | from pathlib import Path | ||
| 5 | import subprocess | ||
| 6 | import tempfile | ||
| 7 | import unittest | ||
| 8 | |||
| 9 | import snowglobe | ||
| 10 | |||
| 11 | |||
| 12 | class 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 | |||
| 71 | if __name__ == "__main__": | ||
| 72 | unittest.main() | ||
tools/snowglobe-sso-test.py created+77| ... | @@ -0,0 +1,77 @@ | ||
| 1 | #!/usr/bin/env python3 | ||
| 2 | import json | ||
| 3 | import os | ||
| 4 | from pathlib import Path | ||
| 5 | import subprocess | ||
| 6 | import tempfile | ||
| 7 | import unittest | ||
| 8 | from unittest.mock import patch | ||
| 9 | |||
| 10 | import snowglobe | ||
| 11 | |||
| 12 | |||
| 13 | class 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())} | ||
| 24 | import {json.dumps((snowglobe.REPO / "config/OpenID.pkl").as_uri())} as sso | ||
| 25 | name = "Fixture" | ||
| 26 | requirements {{ {requirements} }} | ||
| 27 | containers {{ | ||
| 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 | |||
| 76 | if __name__ == "__main__": | ||
| 77 | unittest.main() | ||
tools/snowglobe.py created+1303| ... | @@ -0,0 +1,1303 @@ | ||
| 1 | #!/usr/bin/env python3 | ||
| 2 | import argparse | ||
| 3 | from contextlib import nullcontext | ||
| 4 | import fcntl | ||
| 5 | import hashlib | ||
| 6 | import json | ||
| 7 | from importlib import import_module | ||
| 8 | import os | ||
| 9 | from pathlib import Path | ||
| 10 | import re | ||
| 11 | import secrets | ||
| 12 | import shutil | ||
| 13 | import subprocess | ||
| 14 | import sys | ||
| 15 | import tempfile | ||
| 16 | import time | ||
| 17 | |||
| 18 | from data import cloned_postgres, dataset_for | ||
| 19 | |||
| 20 | |||
| 21 | transition = import_module("namespace-transition") | ||
| 22 | transition.inherit_environment() | ||
| 23 | |||
| 24 | REPO = Path(__file__).resolve().parent.parent | ||
| 25 | SERVICES = REPO / "service" | ||
| 26 | STATE = Path("/var/lib/snowglobe") | ||
| 27 | IDENTITIES = STATE / "identities.json" | ||
| 28 | ASSETS = Path("/var/lib/caddy/snowglobe") | ||
| 29 | NAME = re.compile(r"[a-z][a-z0-9-]*\Z") | ||
| 30 | |||
| 31 | |||
| 32 | def command(*args, capture=False, **kwargs): | ||
| 33 | return subprocess.run(args, check=True, text=True, capture_output=capture, **kwargs) | ||
| 34 | |||
| 35 | |||
| 36 | def 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 | |||
| 49 | def services(): | ||
| 50 | return sorted(service_files()) | ||
| 51 | |||
| 52 | |||
| 53 | def service_dir(name): | ||
| 54 | path = service_files()[name] | ||
| 55 | return path.parent if path.name == "service.pkl" else path.parent / name | ||
| 56 | |||
| 57 | |||
| 58 | def dependencies(data): | ||
| 59 | return set(data["dependsOn"]) | {item["provider"] for item in data["inputs"].values() if item["provider"] != "snowglobe"} | ||
| 60 | |||
| 61 | |||
| 62 | def 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 | |||
| 79 | def 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 | |||
| 98 | def 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 | |||
| 157 | def q(value): | ||
| 158 | return json.dumps(value, ensure_ascii=False) | ||
| 159 | |||
| 160 | |||
| 161 | def 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 | |||
| 173 | def 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 | |||
| 182 | def 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 | |||
| 190 | def 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 | |||
| 210 | def 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 | |||
| 495 | def token(): | ||
| 496 | if "NOMAD_TOKEN" not in os.environ: | ||
| 497 | os.environ["NOMAD_TOKEN"] = (STATE / "nomad.token").read_text().strip() | ||
| 498 | |||
| 499 | |||
| 500 | def 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 | |||
| 509 | def 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 | |||
| 626 | def 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 | |||
| 638 | def 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 | |||
| 646 | def 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 | |||
| 651 | def 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 | |||
| 666 | def 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 | |||
| 676 | def 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 | |||
| 701 | def 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 | |||
| 709 | def 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 | |||
| 747 | def 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 | |||
| 813 | def 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 | |||
| 857 | def 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 | |||
| 900 | def 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 | |||
| 916 | def 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 | |||
| 935 | def 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 | |||
| 1298 | if __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 | |||
| 3 | The existing preview can take a consistent copy of Zenith's live SQLite index without stopping the old service: | ||
| 4 | |||
| 5 | ```sh | ||
| 6 | sh tools/import-source-index.sh clover-source-of-truth-preview-6311ec97 | ||
| 7 | ``` | ||
| 8 | |||
| 9 | The 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 | |||
| 11 | On 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 | |||
| 13 | The `clo` account used by the stream importer had zero unreadable files and zero untraversable directories in the source tree at inspection. | ||
| 14 | |||
| 15 | For 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 | |||
| 17 | If 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 | |||
| 19 | Run `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 | |||
| 3 | Zenith 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 | |||
| 9 | The 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 | |||
| 11 | A 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 | |||
| 13 | A 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 | |||
| 17 | A 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 | |||
| 19 | An 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 | |||
| 21 | The 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 | |||
| 23 | With 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 | |||
| 25 | Zenith'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 | |||
| 27 | The 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 | |||
| 29 | Copyparty'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 | |||
| 31 | Snow 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 | |||
| 37 | Zenith 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 | |||
| 39 | The [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 | |||
| 43 | Kernel 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 | |||
| 45 | The 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 | |||
| 47 | REAPER 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 | |||
| 49 | Production 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 | ||
| 2 | import json | ||
| 3 | import os | ||
| 4 | from pathlib import Path | ||
| 5 | import subprocess | ||
| 6 | import tempfile | ||
| 7 | import unittest | ||
| 8 | |||
| 9 | import studio | ||
| 10 | |||
| 11 | |||
| 12 | class 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 | |||
| 71 | if __name__ == "__main__": | ||
| 72 | unittest.main() | ||
tools/studio.py deleted-1286| ... | @@ -1,1286 +0,0 @@ | ||
| 1 | #!/usr/bin/env python3 | ||
| 2 | import argparse | ||
| 3 | from contextlib import nullcontext | ||
| 4 | import fcntl | ||
| 5 | import hashlib | ||
| 6 | import json | ||
| 7 | import os | ||
| 8 | from pathlib import Path | ||
| 9 | import re | ||
| 10 | import secrets | ||
| 11 | import shutil | ||
| 12 | import subprocess | ||
| 13 | import sys | ||
| 14 | import tempfile | ||
| 15 | import time | ||
| 16 | |||
| 17 | from data import cloned_postgres, dataset_for | ||
| 18 | from release import excluded_services | ||
| 19 | |||
| 20 | |||
| 21 | REPO = Path(__file__).resolve().parent.parent | ||
| 22 | SERVICES = REPO / "service" | ||
| 23 | STATE = Path("/var/lib/studio") | ||
| 24 | IDENTITIES = STATE / "identities.json" | ||
| 25 | ASSETS = Path("/var/lib/caddy/studio") | ||
| 26 | NAME = re.compile(r"[a-z][a-z0-9-]*\Z") | ||
| 27 | |||
| 28 | |||
| 29 | def command(*args, capture=False, **kwargs): | ||
| 30 | return subprocess.run(args, check=True, text=True, capture_output=capture, **kwargs) | ||
| 31 | |||
| 32 | |||
| 33 | def 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 | |||
| 49 | def services(): | ||
| 50 | return sorted(service_files()) | ||
| 51 | |||
| 52 | |||
| 53 | def service_dir(name): | ||
| 54 | path = service_files()[name] | ||
| 55 | return path.parent if path.name == "service.pkl" else path.parent / name | ||
| 56 | |||
| 57 | |||
| 58 | def dependencies(data): | ||
| 59 | return set(data["dependsOn"]) | {item["provider"] for item in data["inputs"].values() if item["provider"] != "snowglobe"} | ||
| 60 | |||
| 61 | |||
| 62 | def 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 | |||
| 79 | def 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 | |||
| 98 | def 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 | |||
| 151 | def q(value): | ||
| 152 | return json.dumps(value, ensure_ascii=False) | ||
| 153 | |||
| 154 | |||
| 155 | def 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 | |||
| 167 | def 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 | |||
| 176 | def 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 | |||
| 184 | def 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 | |||
| 204 | def 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 | |||
| 489 | def token(): | ||
| 490 | if "NOMAD_TOKEN" not in os.environ: | ||
| 491 | os.environ["NOMAD_TOKEN"] = (STATE / "nomad.token").read_text().strip() | ||
| 492 | |||
| 493 | |||
| 494 | def 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 | |||
| 503 | def 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 | |||
| 620 | def 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 | |||
| 632 | def 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 | |||
| 640 | def 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 | |||
| 645 | def 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 | |||
| 660 | def 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 | |||
| 670 | def 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 | |||
| 695 | def 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 | |||
| 703 | def 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 | |||
| 741 | def 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 | |||
| 806 | def 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 | |||
| 850 | def 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 | |||
| 893 | def 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 | |||
| 909 | def 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 | |||
| 928 | def 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 | |||
| 1281 | if __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 | ||
| 2 | import hashlib | ||
| 3 | import json | ||
| 4 | import os | ||
| 5 | from pathlib import Path | ||
| 6 | import stat | ||
| 7 | import sys | ||
| 8 | |||
| 9 | |||
| 10 | root = Path(sys.argv[1]).resolve(strict=True) | ||
| 11 | if not root.is_dir(): | ||
| 12 | raise ValueError("Expected a directory") | ||
| 13 | digest = hashlib.sha256() | ||
| 14 | files = 0 | ||
| 15 | size = 0 | ||
| 16 | |||
| 17 | |||
| 18 | def fail(error): | ||
| 19 | raise error | ||
| 20 | |||
| 21 | |||
| 22 | for 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) | ||
| 48 | print(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 | ||
| 2 | import hashlib | ||
| 3 | import json | ||
| 4 | from pathlib import Path | ||
| 5 | import re | ||
| 6 | import sys | ||
| 7 | |||
| 8 | |||
| 9 | folder = Path(sys.argv[1]) | ||
| 10 | if not folder.is_dir(): | ||
| 11 | raise SystemExit("Legacy handoff directory is unavailable") | ||
| 12 | folder = folder.resolve(strict=True) | ||
| 13 | database = sys.argv[2] | ||
| 14 | if 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") | ||
| 16 | if database not in {"evil-forgejo", "evil-hedgedoc"}: | ||
| 17 | raise ValueError("Unexpected legacy database") | ||
| 18 | manifest = json.loads((folder / "manifest.json").read_text()) | ||
| 19 | if manifest["id"] != folder.name: | ||
| 20 | raise ValueError("Legacy handoff ID changed") | ||
| 21 | entry = manifest["databases"][database] | ||
| 22 | if entry["file"] != database + ".dump": | ||
| 23 | raise ValueError("Legacy dump filename changed") | ||
| 24 | dump = folder / entry["file"] | ||
| 25 | digest = hashlib.sha256() | ||
| 26 | with dump.open("rb") as file: | ||
| 27 | for chunk in iter(lambda: file.read(1024 * 1024), b""): | ||
| 28 | digest.update(chunk) | ||
| 29 | if dump.stat().st_size != entry["bytes"] or digest.hexdigest() != entry["sha256"]: | ||
| 30 | raise ValueError("Legacy dump checksum mismatch") | ||
| 31 | if 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") | ||
| 33 | if 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") | ||
| 37 | print(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 |
| 24 | 24 | ||
| 25 | 25 | ||
| 26 | MAX_PIXELS = 3840 * 2160 | 26 | MAX_PIXELS = 3840 * 2160 |
| 27 | STUN = os.environ.get("STUDIO_VM_STUN_SERVER", "stun://stun.cloudflare.com:3478") | 27 | STUN = os.environ.get("SNOWGLOBE_VM_STUN_SERVER", "stun://stun.cloudflare.com:3478") |
| 28 | SLOTS = asyncio.Semaphore(4) | 28 | SLOTS = asyncio.Semaphore(4) |
| 29 | GUEST_PROTOCOL = json.loads(Path(os.environ.get("STUDIO_VM_GUEST_PROTOCOL", Path(__file__).resolve().parent.parent / "guest/protocol.json")).read_text()) | 29 | GUEST_PROTOCOL = json.loads(Path(os.environ.get("SNOWGLOBE_VM_GUEST_PROTOCOL", Path(__file__).resolve().parent.parent / "guest/protocol.json")).read_text()) |
| 30 | GUESTS = {} | 30 | GUESTS = {} |
| 31 | TWCC = "http://www.ietf.org/id/draft-holmer-rmcat-transport-wide-cc-extensions-01" | 31 | TWCC = "http://www.ietf.org/id/draft-holmer-rmcat-transport-wide-cc-extensions-01" |
| 32 | 32 | ||
| ... | @@ -312,7 +312,7 @@ class GuestDesktop: | ... | @@ -312,7 +312,7 @@ class GuestDesktop: |
| 312 | writer = None | 312 | 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 python3 | 1 | #!/usr/bin/env python3 |
| 2 | import json | 2 | import json |
| 3 | from importlib import import_module | ||
| 3 | import os | 4 | import os |
| 4 | from pathlib import Path | 5 | from pathlib import Path |
| 5 | import re | 6 | import re |
| ... | @@ -15,10 +16,11 @@ import xml.etree.ElementTree as ET | ... | @@ -15,10 +16,11 @@ import xml.etree.ElementTree as ET |
| 15 | 16 | ||
| 16 | 17 | ||
| 17 | DISKS = Path("/srv/vm") | 18 | DISKS = Path("/srv/vm") |
| 18 | IMAGES = Path(os.environ.get("STUDIO_VM_IMAGES_ROOT", "/srv/clover/Media/vm")) | 19 | IMAGES = Path(os.environ.get("SNOWGLOBE_VM_IMAGES_ROOT", "/srv/clover/Media/vm")) |
| 19 | PRESETS = Path(os.environ.get("STUDIO_VM_PRESETS_ROOT", str(IMAGES / "Presets"))) | 20 | PRESETS = Path(os.environ.get("SNOWGLOBE_VM_PRESETS_ROOT", str(IMAGES / "Presets"))) |
| 20 | UPLOADS = Path(os.environ.get("STUDIO_VM_UPLOADS_ROOT", str(IMAGES / "Install Disks"))) | 21 | UPLOADS = Path(os.environ.get("SNOWGLOBE_VM_UPLOADS_ROOT", str(IMAGES / "Install Disks"))) |
| 21 | NS = "{https://paperclover.net/studio}" | 22 | transition = import_module("namespace-transition") |
| 23 | NS = "{https://paperclover.net/snowglobe}" | ||
| 22 | NAME = re.compile(r"[a-z0-9][a-z0-9-]{0,62}\Z") | 24 | NAME = re.compile(r"[a-z0-9][a-z0-9-]{0,62}\Z") |
| 23 | GUEST_CHANNEL = json.loads((Path(__file__).resolve().parent.parent / "guest/protocol.json").read_text())["channel"] | 25 | GUEST_CHANNEL = json.loads((Path(__file__).resolve().parent.parent / "guest/protocol.json").read_text())["channel"] |
| 24 | PROFILES = { | 26 | PROFILES = { |
| ... | @@ -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 | continue | 241 | 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 None | 245 | 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 | continue | 252 | 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): |
| 456 | 458 | ||
| 457 | def change_media(spec): | 459 | def 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 None | 463 | 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): |
| 575 | 577 | ||
| 576 | 578 | ||
| 577 | def console_target(name): | 579 | def 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): |
| 590 | 592 | ||
| 591 | def secure_firmware(arch): | 593 | def 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 = name | 771 | 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 = emulator | 844 | 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 result | 952 | 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 None | 969 | source = console.find("source") if console is not None else None |
| 968 | target = console.find("target") if console is not None else None | 970 | 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 / name | 1016 | 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. It | 20 | `setup.py` installs a transient firewall service tagged with the preview ID. It |
| 21 | removes its rules within ten seconds of preview destruction, and on service stop. | 21 | removes its rules within ten seconds of preview destruction, and on service stop. |
| 22 | After a host reboot, repeat the staging command to restore these runtime rules. | 22 | After a host reboot, repeat the staging command to restore these runtime rules. |
| 23 | Production firewall rules are declared in `nixos/zenith.nix`. The DNS provider | 23 | Production firewall rules are declared in `nixos/snowglobe.nix`. The DNS provider |
| 24 | provisions client, direct-TLS client, and federation SRV records pointing at | 24 | provisions client, direct-TLS client, and federation SRV records pointing at |
| 25 | `xmpp.paperclover.net`; the website keeps its existing apex address. Router | 25 | `xmpp.paperclover.net`; the website keeps its existing apex address. Router |
| 26 | forwarding must send the TCP listeners, UDP TURN listeners, and UDP relay range | 26 | forwarding must send the TCP listeners, UDP TURN listeners, and UDP relay range |
| 27 | to Zenith. `xmpp-nat.service` refreshes UPnP mappings on startup and every five | 27 | to Snow Globe. `xmpp-nat.service` refreshes UPnP mappings on startup and every five |
| 28 | minutes, using the Archer AX3000's description URL at the configured gateway. | 28 | minutes, using the Archer AX3000's description URL at the configured gateway. |
| 29 | The description is fetched directly; multicast SSDP discovery failed on this | 29 | The description is fetched directly; multicast SSDP discovery failed on this |
| 30 | host. Production activation uses the normal described-main deployment: | 30 | host. Production activation uses the normal described-main deployment: |
| 31 | 31 | ||
| 32 | ```sh | 32 | ```sh |
| 33 | STUDIO_DEPLOY_HOST=root@10.0.0.1 STUDIO_DEPLOY_PORT=22 python3 tools/deploy.py prod | 33 | SNOWGLOBE_DEPLOY_HOST=root@10.0.0.1 SNOWGLOBE_DEPLOY_PORT=22 python3 tools/deploy.py prod |
| 34 | ``` | 34 | ``` |
| 35 | 35 | ||
| 36 | ## Zenith production, 2026-10-10 | 36 | ## Client connections and verification |
| 37 | 37 | ||
| 38 | The owner-readable connection file on Clover's Mac is | 38 | The owner-readable connection file on Clover's Mac is |
| 39 | `~/.local/share/snowglobe/xmpp.json`. Monal can use the production JID and its | 39 | `~/.local/share/snowglobe/xmpp.json`. Monal can use the production JID and its |
| 40 | generated password; the explicit server is `xmpp.paperclover.net`, port `5223`, | 40 | generated password; the explicit server is `xmpp.paperclover.net`, port `5223`, |
| 41 | with direct TLS. Client and federation SRV records resolve to that server. | 41 | with direct TLS. Client and federation SRV records resolve to that server. |
| 42 | 42 | A preview has its own connection file and account domain; never copy its | |
| 43 | Verified through the public address from the home LAN: TLS authentication, two | 43 | account database into production. |
| 44 | resources, carbons, MAM retrieval, stream resumption, PEP publication/deletion, | 44 | |
| 45 | private group creation/history/destruction, PNG upload/download, WebSocket, | 45 | Test client authentication, two-resource carbons, MAM retrieval, resumable |
| 46 | authenticated UDP TURN allocation/deallocation, relay address/range, rejection | 46 | streams, OMEMO/PEP keys, private group history, uploads, and WebSocket after |
| 47 | of a private peer, STARTTLS, and TURN TLS certificate validation. All three tasks | 47 | changing the service. Calling also requires authenticated TURN, the configured |
| 48 | had zero restarts. The normal deployment took backup | 48 | public relay range, and an off-LAN client check. Push discovery alone does not |
| 49 | `20261011T015942Z-a7e251` and passed all service route checks. A transient systemd | 49 | prove delivery through an iOS client's push provider. Recheck external |
| 50 | probe confirmed UPnP refresh works with `DynamicUser`. Off-LAN calls, iOS push | 50 | connectivity after router or forwarding changes. |
| 51 | delivery, federation with another server, and recovery after a router restart | ||
| 52 | need client-side verification. | ||
| 53 | |||
| 54 | ## Zenith preview, 2026-10-10 | ||
| 55 | |||
| 56 | Stage: `xmpp-preview-c035f9fb` | ||
| 57 | Hostname: `xmpp-preview-c035f9fb.paperclover.net` | ||
| 58 | JID: `clover@xmpp-preview-c035f9fb.paperclover.net` | ||
| 59 | Dataset: `globe/staging/xmpp-preview-c035f9fb` | ||
| 60 | |||
| 61 | The preview Nomad job and its transient firewall service were stopped for the | ||
| 62 | production cutover. Its dataset, Nomad variables, and owner-readable Mac | ||
| 63 | connection file at `~/.local/share/snowglobe/xmpp-preview.json` are retained. | ||
| 64 | Preview account data was not copied into production. | ||
| 65 | |||
| 66 | Delete the preview, including its accounts and history: | ||
| 67 | |||
| 68 | ```sh | ||
| 69 | STUDIO_DEPLOY_HOST=root@10.0.0.1 STUDIO_DEPLOY_PORT=22 python3 tools/deploy.py destroy xmpp-preview-c035f9fb | ||
| 70 | ``` | ||
| 71 | |||
| 72 | Verified with synthetic data: certificate validation and TLS 1.3 login, two | ||
| 73 | simultaneous resources, carbons, stream resumption after transport loss, MAM | ||
| 74 | retrieval, PEP publication/deletion, private group creation/history/destruction, | ||
| 75 | PNG upload/download over public HTTPS, WebSocket stream opening, external-service | ||
| 76 | credentials, authenticated UDP TURN allocation/deallocation, advertised public | ||
| 77 | relay address/range, and rejection of a private-network peer. Push support was | ||
| 78 | discovered; delivery through an iOS client's push provider and calls across the | ||
| 79 | public router were not exercised. All 25 pre-existing service jobs rendered | ||
| 80 | byte-identically after the TCP schema migration. The active production release | ||
| 81 | was 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 | |||
| 3 | The 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 | |||
| 5 | On 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 | |||
| 7 | For 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 | |||
| 9 | For 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 | |||
| 3 | NixOS 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 | |||
| 5 | Read-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 | |||
| 11 | On 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 | |||
| 13 | TrueNAS'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 | |||
| 15 | The 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 | |||
| 17 | The 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 | |||
| 19 | The 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 | |||
| 21 | The 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 | |||
| 23 | The 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 | |||
| 25 | The 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 | |||
| 29 | A `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 | |||
| 31 | The 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 | |||
| 33 | With 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 | |||
| 35 | The 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. | ||