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

Retire legacy infrastructure tooling and make Snow Globe staging-first

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

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

AGENTS.md+119-181
......@@ -1,182 +1,120 @@
1# Snow Globe infrastructure
2
3This repo runs Clover's home server: her creative file store, shared apps, and
4virtual machines. NixOS provides the host; Nomad schedules Podman containers;
5Pkl describes services; the Rust/Solid dashboard manages the system. Treat
6availability and existing data as part of correctness.
7
8## Access and authorization
9
10- Local edits and staging previews on Zenith are always implied by a task.
11 Carry them through verification without asking for permission again. Use
12 disposable preview data for writes and keep active production services intact.
13- Production changes require a request to take the work to prod. A request to
14 fix, stage, test, or commit something does not authorize production deployment.
15 Once prod is requested, complete the normal deployment workflow.
16- Read-only infrastructure inspection over SSH is allowed for the task. Confirm
17 the target host before a remote mutation. Set both deployment host and port
18 explicitly; the CLI's legacy defaults still point at the rehearsal VM.
19- Private file contents require authorization per source. Infrastructure access,
20 a mounted share, or permission to list a tree does not authorize opening its
21 contents. Keep private material and derived model output inside its store.
22- Never print credentials or encryption keys into chat, command arguments,
23 ordinary logs, or tracked files. Use existing private files or stdin for
24 imports; keep secret files owner-readable only. Nomad variables own service
25 secrets; configuration declares names and references, not values.
26- Before destructive storage or OS work, require verified recovery: tested key
27 recovery and app/database restores, with at least two restricted copies stored
28 separately off the server. Local snapshots and a key archive alone do not
29 establish data recovery. Follow the linked cutover runbooks.
30- Agent/model trials use disposable data and credentials, separated from the
31 personal archive and host credentials. A service preview may clone production
32 data and secrets; staging does not itself grant permission to inspect them.
33
34## Machines and paths
35
36| Surface | Connection / role | Configuration |
37| --- | --- | --- |
38| Mac checkout | `/Users/clo/dev/infra-2`; edit and upload here | This working copy |
39| Optional rehearsal NixOS VM | `root@127.0.0.1`, SSH port `2222` | `nixos/vm.nix`, `studio.test`, demo pool |
40| Zenith production | `root@10.0.0.1`, SSH port `22` | `nixos/zenith.nix`, `paperclover.net`, physical pool |
41
42`tools/deploy.py` reads `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT`; defaults
43are the rehearsal connection above. Set both explicitly for Zenith staging
44and production. Prefer staging previews on Zenith for service and dashboard
45verification; use the VM when host or guest isolation is required.
46Host settings and dataset names have their canonical home in `nixos/zenith.nix`
47and `config/site.pkl`; inspect them instead of copying values into new tooling.
48
49| Local / logical location | Remote location | Meaning |
50| --- | --- | --- |
51| Checkout release sources | `/opt/studio/releases/<digest>` | Uploaded, immutable release trees |
52| Published main revision | `/opt/studio/main` | Release exported from described `main` |
53| Active deployment | `/opt/studio/current` | Active release link; not an editable checkout |
54| Zenith host installation | `/etc/nixos` | Installed host configuration; release activation also manages NixOS |
55| Mac SMB `/Volumes/clover` | Zenith `/srv/clover` | Live personal files; not a disposable test tree |
56| `/Volumes/clover/Media` | Zenith `/srv/clover/Media` | Media child dataset |
57| Mac `/Volumes/media` (launcher default) | VM `/mnt/media-source` → `/srv/clover/Media` | Read-only 9P export and bindfs view for rehearsal |
58| Managed service storage | `/srv/prod/<service>` | Persistent, per-service ZFS datasets |
59| Preview storage | `/srv/staging/<stage>` | Disposable service clones, with separate external clones where needed |
60| VM storage | `/srv/vm` | Guest disks, access files, and installation library |
61| Deployment/control state | `/var/lib/studio` | UID registry, stages, history, backups, dashboard state, run logs |
62| Nomad state | `services.nomad.settings.data_dir` in `nixos/configuration.nix` | Separate from service data; includes ACLs and secrets |
63
64The rehearsal VM has its own Clover dataset. Its media view references the Mac's
65mounted share read-only; those bytes are not synthetic fixtures. See
66`tools/local-vm.sh` for launch/cache overrides and `tools/mac-domains.py` for
67Mac rehearsal routing. Do not hand-edit DNS, trust, or host files to bypass them.
68
69## Where changes belong
70
71- `config/Service.pkl` owns the service schema; `config/site.pkl` owns site
72 defaults and overrides. `config/excluded-services.json` filters deployment
73 sources. Services are discovered from `service/*/*.pkl`.
74- `service/<name>/service.pkl` owns a service's containers, routes, mounts,
75 requirements, secret declarations, health checks, and resource limits.
76 Sibling Pkl files define additional services, e.g. Postgres's pgAdmin.
77- `tools/studio.py` owns rendering, provisioning, staging, and service setup.
78 `tools/deploy.py` uploads local sources or `main`; `tools/release.py` owns
79 release activation and code rollback; `tools/data.py` owns backup/restore.
80- `tools/router.py` generates Caddy routes from service discovery. Change the
81 declaration or generator, not generated routes or Nomad jobs.
82- `nixos/` owns host units, packages, isolation, mounts, and hardware settings.
83 `dashboard/src/` owns the HTTP server and auth; `dashboard/web/` owns the UI;
84 `tools/dashboard-host.py` and `tools/vms.py` own privileged host operations.
85- `guest/` owns guest capture/provisioning and its shared protocol. Inspect
86 `guest/DESIGN.md` before changing the guest/host boundary.
87- Runtime identities live in `/var/lib/studio/identities.json`, initially seeded
88 from `config/identities.json`. Preserve assigned numeric owners; do not
89 renumber services or recursively change ownership as a shortcut.
90
91## Adding or changing a service
92
931. Read the closest existing service and the schema. Declare managed storage,
94 explicit external mounts, health checks, auth, and requirements. Use
95 `prepare` for repeatable work before startup and `setup` for repeatable
96 configuration after health. Declare providers instead of hardcoding their
97 current addresses or credentials.
982. Check side effects before staging: outbound mail, federation, downloads,
99 automation, fixed host ports, host networking, and exclusive GPU use. Use
100 preview-aware configuration or `stageIsolation = "fresh"` when a cloned app
101 would act as production. Fresh stages reject writable external mounts.
1023. Run the relevant local checks, then stage the working files:
103
104 ```sh
105 STUDIO_DEPLOY_HOST=root@10.0.0.1 STUDIO_DEPLOY_PORT=22 python3 tools/deploy.py stage <service>
106 ```
107
108 The command prints `stage`, `release`, `host`, and `dataset`. Use that host;
109 do not invent a staging hostname. Repeating `stage <service>` updates its
110 existing preview and keeps preview data. Storage/isolation or incompatible
111 requirement changes can require destroying and recreating that preview.
1124. Verify the actual app path, authentication, persistence, provider connections,
113 and healthy allocations. Check logs/restarts and sampled unaffected services.
114 An HTTP health response alone does not establish that the app works.
115 Writable external ZFS mounts get clones; read-only external mounts can still
116 reference the source. Review the actual bindings for host-networked services.
1175. Clean up previews when finished using `python3 tools/deploy.py destroy
118 <stage-id>` against the same target. Destruction deletes preview state; retain
119 anything the task needs first. The physical RTX 3090 fits one model instance;
120 stop its AI preview before a production AI deployment.
1216. Commit reviewed changes. Production exports a described, conflict-free
122 **main**, not the working copy and not the preview's edited database. Only
123 after production is requested and the intended changes are on `main`:
124
125 ```sh
126 STUDIO_DEPLOY_HOST=root@10.0.0.1 STUDIO_DEPLOY_PORT=22 python3 tools/deploy.py prod
127 ```
128
129 Check deployment history and real production paths. The release workflow
130 takes a pre-switch backup and performs health checks; use it instead of an
131 ad hoc container replacement or edits inside `/opt/studio/current`.
132
133Code rollback uses `deploy.py rollback [release-id]`. It does **not** restore
134data. Data restore explicitly discards later writes and is a separate operation;
135read `tools/data-restore.md` before proposing it.
136
137## Verification and change hygiene
138
139- Run checks that cover the change. Inspect a test's entry point first: some
140 `tools/*-test.py` scripts mutate host services or require Linux/real guests.
141 Run those against isolated staging fixtures. Tests that alter host services,
142 storage, or guests require a disposable VM or explicit production scope.
143- Dashboard: `cd dashboard && npm run check && npm run build`; run Rust tests
144 with `cargo test --manifest-path dashboard/Cargo.toml`. Host tests include
145 `python3 tools/dashboard-host-test.py` and `python3 tools/dashboard-vms-test.py`.
146- Deployment: `python3 tools/deploy-test.py`. On the target, the uploaded
147 `tools/studio.py validate` checks generated Nomad jobs; `check` checks routes.
148 Even render loads/allocates identities, so it is not a pure local formatter.
149- Local AI: use the unit checks and live client probes in `tools/local-ai.md`.
150 Rehearsal has no production GPU/model instance; do not download model weights
151 or enable GPU inference there.
152- UI changes need real browser verification, keyboard checks, and screenshots
153 or recordings for Clover to judge. Test VM consoles in the normal browser
154 panel. Metrics/traces must represent observed app telemetry.
155- Prefer fewer names, fields, branches, casts, and public promises. Derive state
156 instead of storing it. Delete dead code and comments describing removed
157 behavior. One artifact has one home; link additional consumers to it.
158- When a trade depends on how likely something is to change, report the trade
159 and ask Clover. Do not decide it by asserting that the thing is stable.
1# Snow Globe
2
3Snow Globe is Clover's physical home computer: NixOS, Nomad/Podman services,
4ZFS storage, and virtual machines. Pkl describes services; the Rust/Solid
5web app manages the system. Availability and existing data are part of correctness.
6
7## Default workflow
8
9Finish a requested change through verification without another permission round:
10
111. Inspect the current code, Jujutsu state, and relevant service/runbook.
122. Implement the change and run the checks that cover it.
133. Automatically deploy the working changes to staging on Snow Globe:
14 `python3 tools/deploy.py stage <service>` or `stage dashboard`.
154. Test the real preview: app behavior, authentication, persistence, dependencies,
16 logs/restarts, and effects on other services. For UI, use the normal browser
17 panel, check the keyboard, and capture screenshots or recordings.
185. Present the working preview URL and evidence. Keep it available for review.
19 Wait for Clover to request production promotion.
20
21A request to change, fix, test, stage, or commit does not authorize production.
22Once Clover requests production, finish the normal deployment without asking
23again: put the reviewed changes on a described, conflict-free **main**, run
24`python3 tools/deploy.py prod`, and verify the actual production paths and history.
25Production exports **main**; it never promotes a preview database or the working
26copy. Do not move main or push merely because a local commit was requested.
27
28Two surfaces use the real machine during iteration:
29
30- **Local AI:** deploy and test changes directly in production without waiting
31 for a separate promotion request. The physical GPU is required; do not start a
32 competing preview model. Use disposable prompts, credentials, and workspaces.
33- **Virtual machines:** iterate on Snow Globe using disposable guests and disks.
34 Test actual guest/host integration and consoles. Preserve active personal
35 guests; a VM task does not authorize unrelated guest or storage changes.
36
37Other service/dashboard changes follow staging first. Host/OS changes that cannot
38be exercised in a service preview need isolated host testing; see
39[host rehearsal](tools/rehearsal.md). Do not substitute an isolated test for
40production verification after an authorized promotion.
41
42## Target and state
43
44The deployment CLI defaults to Snow Globe, `root@10.0.0.1`, SSH port `22`.
45`SNOWGLOBE_DEPLOY_HOST` and `SNOWGLOBE_DEPLOY_PORT` override it; set both when targeting
46another machine. Confirm the connected host before remote mutations.
47The configured hostname is `snowglobe`, with pretty name `snow globe`.
48
49| Path | Purpose |
50| --- | --- |
51| `nixos/snowglobe.nix`, `config/site.pkl` | Host and site configuration |
52| `/opt/snowglobe/releases/<digest>` | Immutable uploaded releases |
53| `/opt/snowglobe/main`, `/opt/snowglobe/current` | Published main and active release links |
54| `/etc/nixos` | Installed host configuration, managed by release activation |
55| `/srv/prod/<service>` | Persistent service ZFS datasets |
56| `/srv/staging/<stage>` | Disposable preview data and external mount clones |
57| `/srv/clover` (`/Volumes/clover` on Mac) | Live personal files |
58| `/srv/clover/Media` | Separate media dataset |
59| `/srv/vm` | Guest disks, access files, installation library |
60| `/var/lib/snowglobe` | Identities, previews, history, backups, dashboard state, logs |
61
62Preserve persistent state, numeric owners, and existing consumers through
63namespace changes. Read current configuration and host state before changing
64operational assumptions.
65
66## Data and credentials
67
68- Infrastructure access and directory listings do not authorize reading private
69 contents. Get authorization per source; keep private material and derived model
70 output inside its store. Preview clones do not broaden that authorization.
71- Keep credentials and encryption keys out of chat, command arguments, logs, and
72 tracked files. Use private files/stdin. Nomad variables own service secrets;
73 configuration declares references. Restrict private files to their consumers.
74- Preserve assigned numeric owners in `/var/lib/snowglobe/identities.json`, seeded
75 from `config/identities.json`. Never renumber services or recursively chown data
76 as a shortcut.
77- Before destructive storage or OS work, verify key recovery and application/
78 database restores with at least two restricted copies off the server, stored
79 separately. Snapshots or a key archive alone do not establish recovery.
80- Use the release workflow for activation and rollback, not ad hoc replacement
81 containers or edits inside `/opt/snowglobe/current`. Code rollback does not restore
82 data. Read [data restore](tools/data-restore.md) before proposing data loss.
83
84## Implementation and checks
85
86- `config/Service.pkl` owns the schema; `config/site.pkl` owns site settings.
87 Services are discovered from `service/*/*.pkl`. Declare routes, mounts, health,
88 authentication, resources, and provider requirements in the service definition.
89- `tools/snowglobe.py` owns rendering/provisioning; `tools/deploy.py` uploads;
90 `tools/release.py` activates; `tools/data.py` backs up/restores;
91 `tools/router.py` derives Caddy routes. Change sources, not generated jobs/routes.
92- `nixos/` owns the host. `dashboard/src/` and `dashboard/web/` own the app;
93 `tools/dashboard-host.py` and `tools/vms.py` own privileged operations.
94 Read `guest/DESIGN.md` before changing the guest/host boundary.
95- Review outbound mail, federation, downloads, automation, fixed ports, host
96 networking, and GPU use before staging. Use preview-aware settings or fresh
97 isolation. Fresh previews reject writable external mounts. Read-only mounts
98 can still expose their source; inspect actual bindings.
99- Repeating `stage <service>` updates its preview and retains preview data. Use
100 the printed hostname. Clean up superseded previews with
101 `python3 tools/deploy.py destroy <stage-id>`; retain evidence first.
102- Dashboard: `cd dashboard && npm run check && npm run build` and
103 `cargo test --manifest-path dashboard/Cargo.toml`. Deployment:
104 `python3 tools/deploy-test.py`; target-side `tools/snowglobe.py validate` checks
105 jobs and `check` checks routes. Rendering can allocate identities.
106- Read a test's entry point before running it. Host/service/storage/guest mutation
107 tests need disposable fixtures or the explicit production scope above. A health
108 response alone does not prove the app works. Metrics/traces must be observed.
109- Prefer fewer moving parts. Derive state, remove dead code and false comments,
110 and keep one home for each artifact. When a trade depends on how likely a
111 default or interface is to change, explain the trade and ask Clover.
160112- Use Jujutsu, never standalone `git`. Inspect `jj st`, the current description,
161 and `jj diff --git` before editing or committing; preserve unrelated work.
162 Split independent changes when committing. Do not push or move `main` merely
163 because a task requests a local commit. Use `Assisted-by: <model>` if adding
164 model attribution, never `Co-authored-by`.
165
166## Operational references
167
168- Storage layout: [readme.md](readme.md).
169- Physical host and recovery context: [tools/zenith-hardware.md](tools/zenith-hardware.md).
170- Storage and permissions: [tools/media-cutover.md](tools/media-cutover.md),
171 [tools/storage-acl-cutover.md](tools/storage-acl-cutover.md).
172- Legacy recovery and app imports: [tools/legacy-handoff.md](tools/legacy-handoff.md),
173 [tools/personal-cutover.md](tools/personal-cutover.md), and the service's
174 `tools/*-migration.md` runbook.
175- Provider behavior: [tools/service-dependencies.md](tools/service-dependencies.md).
176- Copyparty administration and folder moves: [tools/copyparty.md](tools/copyparty.md).
177- Local inference: [tools/local-ai.md](tools/local-ai.md).
178
179Runbooks contain dated rehearsal evidence and migration history. Check current
180configuration and read-only host state before treating an old observation as
181today's topology. Keep deployment history and long investigations in their
182runbooks; AGENTS.md carries the rules and links.
113 and `jj diff --git`; preserve unrelated work and split independent changes.
114 Attribution uses `Assisted-by: <model>`, never `Co-authored-by`.
115
116## References
117
118[Storage layout](readme.md) · [Physical host/recovery](tools/snowglobe-hardware.md) ·
119[Service dependencies](tools/service-dependencies.md) · [Files](tools/copyparty.md) ·
120[AI steering](service/local-ai/steering/README.md) · [AI cache](tools/local-ai-cache.md)
config/OpenID.pkl+2-1
......@@ -3,13 +3,14 @@ module OpenID
33import "Service.pkl" as service
44import "site.pkl" as site
55
6hostname: String = "snowglobe.\(site.domain)"
6const hostname: String = "snowglobe.\(site.domain)"
77issuer: String = "https://\(hostname)"
88
99class Client extends service.Requirement {
1010 alias: String = "oidc"
1111 fixed provider = "snowglobe"
1212 fixed kind = "client"
13 fixed issuerHostname = module.hostname
1314 clientId: String(isNotEmpty)
1415 name: String
1516 redirectUris: Listing<String>
config/Service.pkl+11-15
......@@ -4,15 +4,6 @@ import "site.pkl" as site
44
55const nomadHostPort = "{{ if regexMatch \":\" .Address }}[{{ .Address }}]{{ else }}{{ .Address }}{{ end }}:{{ .Port }}"
66
7/// Name shown in the management UI and service listings.
8class Metadata {
9 name: String
10 tagline: String = ""
11 launcher: Boolean = true
12 /// Discovery group; absent uses the public route's auth role.
13 access: String?
14}
15
167/// One HTTP listener and its public route.
178class Http {
189 containerPort: UInt16
......@@ -107,7 +98,12 @@ class Container {
10798id: String = read?("prop:serviceId")
10899/// Stable numeric owner assigned by the deployment tool.
109100uid: Int = read("prop:uid").toInt()
110meta: Metadata
101/// Name shown in the management UI and service listings.
102name: String
103tagline: String = ""
104launcher: Boolean = true
105/// Discovery group; absent uses the public route's auth role.
106access: String?
111107/// Allows site-specific services to stay out of deployments where they would cause side effects.
112108enabled: Boolean = true
113109/// Simple replaces one allocation; overlapped runs a canary alongside it.
......@@ -156,16 +152,16 @@ local deploymentContainers: Mapping<String, Container> =
156152 else
157153 throw("Declare a container or an input")
158154
159local vmStartupGrace: String? = if (read?("env:STUDIO_VM_ACCEL") == "qemu") "60m" else null
155local vmStartupGrace: String? = if (read?("env:SNOWGLOBE_VM_ACCEL") == "qemu") "60m" else null
160156
161157output {
162158 renderer = new JsonRenderer {}
163159 value = new {
164160 id = module.id
165 name = module.meta.name
166 tagline = module.meta.tagline
167 launcher = module.meta.launcher
168 access = module.meta.access
161 name = module.name
162 tagline = module.tagline
163 launcher = module.launcher
164 access = module.access
169165 rollout = module.rollout
170166 stageIsolation = module.stageIsolation
171167 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 @@
11module Site
22
33/// The path to the root ZFS store
4root: String = read?("prop:root") ?? read?("env:STUDIO_ROOT") ?? "/srv"
5pool: String = read?("prop:pool") ?? read?("env:STUDIO_POOL") ?? "studio-demo"
6nodeName: String = read?("prop:nodeName") ?? read?("env:STUDIO_NODE_NAME") ?? "clover-demo"
4root: String = read?("prop:root") ?? read?("env:SNOWGLOBE_ROOT") ?? "/srv"
5pool: String = read?("prop:pool") ?? read?("env:SNOWGLOBE_POOL") ?? "snowglobe-demo"
6nodeName: String = read?("prop:nodeName") ?? read?("env:SNOWGLOBE_NODE_NAME") ?? "snowglobe-rehearsal"
77/// The base domain that the infrastructure runs on
8domain: String = read?("prop:domain") ?? read?("env:STUDIO_DOMAIN") ?? "studio.test"
9ownerEmail: String = read?("prop:ownerEmail") ?? read?("env:STUDIO_OWNER_EMAIL") ?? "account@paperclover.net"
10cloverRoot: String = read?("prop:cloverRoot") ?? read?("env:STUDIO_CLOVER_ROOT") ?? "\(root)/clover"
11cloverUid: Int = (read?("prop:cloverUid") ?? read?("env:STUDIO_CLOVER_UID") ?? "3000").toInt()
12cloverGid: Int = (read?("prop:cloverGid") ?? read?("env:STUDIO_CLOVER_GID") ?? "3000").toInt()
13cloverReadOnly: Boolean = (read?("prop:cloverReadOnly") ?? read?("env:STUDIO_CLOVER_READ_ONLY") ?? "false") == "true"
14mediaRoot: String = read?("prop:mediaRoot") ?? read?("env:STUDIO_MEDIA_ROOT") ?? "\(cloverRoot)/Media"
15localAiSsdCache: String = read?("prop:localAiSsdCache") ?? read?("env:STUDIO_LOCAL_AI_SSD_CACHE") ?? "/var/cache/studio/local-ai"
8domain: String = read?("prop:domain") ?? read?("env:SNOWGLOBE_DOMAIN") ?? "snowglobe.test"
9ownerEmail: String = read?("prop:ownerEmail") ?? read?("env:SNOWGLOBE_OWNER_EMAIL") ?? "account@paperclover.net"
10cloverRoot: String = read?("prop:cloverRoot") ?? read?("env:SNOWGLOBE_CLOVER_ROOT") ?? "\(root)/clover"
11cloverUid: Int = (read?("prop:cloverUid") ?? read?("env:SNOWGLOBE_CLOVER_UID") ?? "3000").toInt()
12cloverGid: Int = (read?("prop:cloverGid") ?? read?("env:SNOWGLOBE_CLOVER_GID") ?? "3000").toInt()
13cloverReadOnly: Boolean = (read?("prop:cloverReadOnly") ?? read?("env:SNOWGLOBE_CLOVER_READ_ONLY") ?? "false") == "true"
14mediaRoot: String = read?("prop:mediaRoot") ?? read?("env:SNOWGLOBE_MEDIA_ROOT") ?? "\(cloverRoot)/Media"
15localAiSsdCache: String = read?("prop:localAiSsdCache") ?? read?("env:SNOWGLOBE_LOCAL_AI_SSD_CACHE") ?? "/var/cache/snowglobe/local-ai"
1616jellyfinFolders: Mapping<String, String> = new {
1717 ["Anime"] = "Anime"
1818 ["Movies"] = "Movies"
......@@ -21,6 +21,6 @@ jellyfinFolders: Mapping<String, String> = new {
2121 ["Independent"] = "Videos/Independent"
2222 ["Paper Clover"] = "Videos/Paper Clover"
2323}
24mediaReadOnly: Boolean = (read?("prop:mediaReadOnly") ?? read?("env:STUDIO_MEDIA_READ_ONLY") ?? "false") == "true"
25tlsInternal: Boolean = (read?("prop:tlsInternal") ?? read?("env:STUDIO_TLS_INTERNAL") ?? "false") == "true" || domain.endsWith(".test")
24mediaReadOnly: Boolean = (read?("prop:mediaReadOnly") ?? read?("env:SNOWGLOBE_MEDIA_READ_ONLY") ?? "false") == "true"
25tlsInternal: Boolean = (read?("prop:tlsInternal") ?? read?("env:SNOWGLOBE_TLS_INTERNAL") ?? "false") == "true" || domain.endsWith(".test")
2626preview: Boolean = (read?("prop:preview") ?? "false") == "true"
dashboard/dev.ts deleted-37
......@@ -1,37 +0,0 @@
1import { execFile, spawn } from "node:child_process";
2import { watch } from "node:fs";
3import { promisify } from "node:util";
4
5const host = process.env.STUDIO_DEPLOY_HOST ?? "root@127.0.0.1";
6const ssh = ["-p", process.env.STUDIO_DEPLOY_PORT ?? "2222", "-o", "BatchMode=yes", "-o", "ConnectTimeout=8"];
7const dir = "/root/studio-dashboard-dev";
8const run = promisify(execFile);
9const quote = (value: string) => "'" + value.replaceAll("'", "'\\''") + "'";
10const restart = `import os, shlex, subprocess
11variables = dict(item.split("=", 1) for item in shlex.split(subprocess.check_output(["systemctl", "show", "-P", "Environment", "studio-dashboard"], text=True)))
12for key in ["STUDIO_INDEX_POOL", "STUDIO_YT_STATE", "STUDIO_FILES_WRITABLE"]: variables.pop(key, None)
13variables.update(PORT="7070", STUDIO_METRICS="follow", STUDIO_DATA_DIR="${dir}/data")
14subprocess.run(["systemctl", "stop", "studio-dashboard-dev"], check=False)
15subprocess.run(["systemd-run", "--unit=studio-dashboard-dev", "--collect", "--property=WorkingDirectory=${dir}/result/lib/home-dashboard", *["--setenv="+key+"="+value for key,value in variables.items()], "${dir}/result/bin/home-dashboard"], check=True)`;
16let pending = false;
17let rebuilding = false;
18async function rebuild() {
19 pending = true;
20 if (rebuilding) return;
21 rebuilding = true;
22 try {
23 while (pending) {
24 pending = false;
25 await run("rsync", ["-a", "--delete", ...[".jj", ".git", "node_modules", "target", "dist", ".cache", "data", "result"].map(name => "--exclude=" + name), "-e", ["ssh", ...ssh].join(" "), "../", `${host}:${dir}/`]);
26 await run("ssh", [...ssh, host, `cd ${dir} && nix --extra-experimental-features 'nix-command flakes' build path:.#dashboard --cores 2 --max-jobs 1 -o result && python3 -c ${quote(restart)}`], { maxBuffer: 16 * 1024 * 1024 });
27 console.log("Rust dashboard ready");
28 }
29 } finally { rebuilding = false; }
30}
31await rebuild();
32watch("src", { recursive: true }, () => rebuild().catch(console.error));
33const tunnel = spawn("ssh", [...ssh, "-N", "-o", "ExitOnForwardFailure=yes", "-L", "7070:127.0.0.1:7070", host], { stdio: "inherit" });
34tunnel.on("exit", code => process.exit(code ?? 1));
35for (const signal of ["SIGINT", "SIGTERM"] as const) process.on(signal, () => {
36 run("ssh", [...ssh, host, "systemctl stop studio-dashboard-dev"]).finally(() => tunnel.kill());
37});
dashboard/package.json+1-2
......@@ -3,7 +3,7 @@
33 "private": true,
44 "type": "module",
55 "scripts": {
6 "dev": "concurrently -k -n server,web \"node dev.ts\" \"vite\"",
6 "dev": "python3 ../tools/deploy.py stage dashboard",
77 "build": "vite build",
88 "check": "tsc --noEmit",
99 "start": "cargo run --release"
......@@ -16,7 +16,6 @@
1616 "@novnc/novnc": "^1.7.0",
1717 "@solidjs/router": "^1.0.0",
1818 "@types/node": "^26.6.2",
19 "concurrently": "^10.0.5",
2019 "esbuild": "0.28.2",
2120 "lucide-solid": "^1.48.0",
2221 "solid-js": "^1.9.15",
dashboard/pnpm-lock.yaml-145
......@@ -24,9 +24,6 @@ importers:
2424 '@types/node':
2525 specifier: ^26.6.2
2626 version: 26.6.2
27 concurrently:
28 specifier: ^10.0.5
29 version: 10.0.5
3027 esbuild:
3128 specifier: 0.28.2
3229 version: 0.28.2
......@@ -555,14 +552,6 @@ packages:
555552 cpu: [x64]
556553 os: [win32]
557554
558 ansi-regex@6.3.0:
559 resolution: {integrity: sha512-WpDfL7NO6j7tH88IDBNVdUJxDh9nmCteAVW9dsep846XdwF4naCBK+/tGLX3KJgcpgMRXCFlTM2hKGoK9FsdrQ==}
560 engines: {node: '>=12'}
561
562 ansi-styles@6.2.3:
563 resolution: {integrity: sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==}
564 engines: {node: '>=12'}
565
566555 babel-plugin-jsx-dom-expressions@0.40.10:
567556 resolution: {integrity: sha512-lxve6Y02YiZTldB7efKpnbf1BH00XCFZNYYW235jSGsYaJNFtHrYlKV6/O+miHbjqpIr9FTe5+0no4hofAMbfA==}
568557 peerDependencies:
......@@ -590,19 +579,6 @@ packages:
590579 caniuse-lite@1.0.30001812:
591580 resolution: {integrity: sha512-qN+QNNBr93TCmFrmte0bBCjSDMuRvt78VlHT99qIGPszm4QsqCX8lnyWUFkHi8B7ZBAPq8SH+UqyXNy/odMdng==}
592581
593 chalk@5.6.2:
594 resolution: {integrity: sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==}
595 engines: {node: ^12.17.0 || ^14.13 || >=16.0.0}
596
597 cliui@9.0.1:
598 resolution: {integrity: sha512-k7ndgKhwoQveBL+/1tqGJYNz097I7WOvwbmmU2AR5+magtbjPWQTS1C5vzGkBC8Ym8UWRzfKUzUUqFLypY4Q+w==}
599 engines: {node: '>=20'}
600
601 concurrently@10.0.5:
602 resolution: {integrity: sha512-JaP/CoftUrCcAFW/g//RbgEGwlelnEae6cfBLgH6ZdO6s8jPkn6p9SB9u6pdVxYXoiSnFqseOlHfrEfF82TVOg==}
603 engines: {node: '>=22'}
604 hasBin: true
605
606582 convert-source-map@2.0.0:
607583 resolution: {integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==}
608584
......@@ -625,9 +601,6 @@ packages:
625601 electron-to-chromium@1.5.439:
626602 resolution: {integrity: sha512-qu6QIPXhsb+CRcAiTMNjR4A1y/7tCYKkKjr5CZXRVih6qkDf79peZ2BpEU3qoDBNCRrcy3Mra3X9nG5oruuA7Q==}
627603
628 emoji-regex@10.6.0:
629 resolution: {integrity: sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==}
630
631604 entities@6.0.1:
632605 resolution: {integrity: sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==}
633606 engines: {node: '>=0.12'}
......@@ -659,14 +632,6 @@ packages:
659632 resolution: {integrity: sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==}
660633 engines: {node: '>=6.9.0'}
661634
662 get-caller-file@2.0.5:
663 resolution: {integrity: sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==}
664 engines: {node: 6.* || 8.* || >= 10.*}
665
666 get-east-asian-width@1.7.0:
667 resolution: {integrity: sha512-XjH1AECxf0giL2V1aU8vKyRR2ppRUb5c0EvT7zuJTokQ74bNo52zOtghqdWIqrhUD79fo3x0WfKZdOqxF6LG1Q==}
668 engines: {node: '>=18'}
669
670635 hono@4.13.9:
671636 resolution: {integrity: sha512-7dMkQmZoC4E6F7AtaQSPhlWAdnBti+j7rreMZl8QB4jFiEhP9TWbGWUMi8WYzBCgmgulxuvLQupKqo+Co6Omyg==}
672637 engines: {node: '>=16.9.0'}
......@@ -804,9 +769,6 @@ packages:
804769 engines: {node: ^20.19.0 || >=22.12.0}
805770 hasBin: true
806771
807 rxjs@7.8.2:
808 resolution: {integrity: sha512-dhKf903U/PQZY6boNNtAGdWbG85WAbjT/1xYoZIC7FAY0yWapOBQVsVrDl58W86//e1VpMNBtRV4MaXfdMySFA==}
809
810772 semver@6.3.1:
811773 resolution: {integrity: sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==}
812774 hasBin: true
......@@ -821,10 +783,6 @@ packages:
821783 resolution: {integrity: sha512-rVQVWjjSvlINzaQPZH5JFqsqEsIWdTxY3iJZCnTL/5gQbXIRooVZKI60tVCkOVfzcRPejboxO2t0P89dg5mQaA==}
822784 engines: {node: '>=10'}
823785
824 shell-quote@1.9.0:
825 resolution: {integrity: sha512-Iov+JwFv/2HcTpcwNMKd8+IWNb8tboQJNQTkAY/LLVK7gGH9jy+LGkVqPxfekHl+yMmiqXszdGWXgkfml7hjqA==}
826 engines: {node: '>= 0.4'}
827
828786 solid-js@1.9.15:
829787 resolution: {integrity: sha512-EeiY2xfpZJqPLjXspVEKjAII4yv8NyG//NxZ3IpOFHdUNnnTyL0uJOeS9LWGvA7cFCz5y94cjFwYlmw5Luncsg==}
830788
......@@ -837,29 +795,10 @@ packages:
837795 resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==}
838796 engines: {node: '>=0.10.0'}
839797
840 string-width@7.2.0:
841 resolution: {integrity: sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==}
842 engines: {node: '>=18'}
843
844 strip-ansi@7.2.0:
845 resolution: {integrity: sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==}
846 engines: {node: '>=12'}
847
848 supports-color@10.2.2:
849 resolution: {integrity: sha512-SS+jx45GF1QjgEXQx4NJZV9ImqmO2NPz5FNsIHrsDjh2YsHnawpan7SNQ1o8NuhrbHZy9AZhIoCUiCeaW/C80g==}
850 engines: {node: '>=18'}
851
852798 tinyglobby@0.2.17:
853799 resolution: {integrity: sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==}
854800 engines: {node: '>=12.0.0'}
855801
856 tree-kill@1.2.2:
857 resolution: {integrity: sha512-L0Orpi8qGpRG//Nd+H90vFB+3iHnue1zSSGmNOOCh1GLJ7rUKVwV2HvijphGQS2UmhUZewS9VgvxYIdgr+fG1A==}
858 hasBin: true
859
860 tslib@2.8.1:
861 resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==}
862
863802 tsx@4.23.15:
864803 resolution: {integrity: sha512-Yiex1Ovn8z2xPpOWckIiysV1SSyRMY9BkLF++q0yKiDxCqRhosKfMg3janKkiLBwZ5c/YryloKwGZcrEmtwxKw==}
865804 engines: {node: '>=18.0.0'}
......@@ -943,25 +882,9 @@ packages:
943882 vite:
944883 optional: true
945884
946 wrap-ansi@9.0.2:
947 resolution: {integrity: sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==}
948 engines: {node: '>=18'}
949
950 y18n@5.0.8:
951 resolution: {integrity: sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==}
952 engines: {node: '>=10'}
953
954885 yallist@3.1.1:
955886 resolution: {integrity: sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==}
956887
957 yargs-parser@22.0.0:
958 resolution: {integrity: sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw==}
959 engines: {node: ^20.19.0 || ^22.12.0 || >=23}
960
961 yargs@18.0.0:
962 resolution: {integrity: sha512-4UEqdc2RYGHZc7Doyqkrqiln3p9X2DZVxaGbwhn2pi7MrRagKaOcIKe8L3OxYcbhXLgLFUS3zAYuQjKBQgmuNg==}
963 engines: {node: ^20.19.0 || ^22.12.0 || >=23}
964
965888snapshots:
966889
967890 '@babel/code-frame@7.29.7':
......@@ -1316,10 +1239,6 @@ snapshots:
13161239 '@typescript/typescript-win32-x64@7.0.2':
13171240 optional: true
13181241
1319 ansi-regex@6.3.0: {}
1320
1321 ansi-styles@6.2.3: {}
1322
13231242 babel-plugin-jsx-dom-expressions@0.40.10(@babel/core@7.29.7):
13241243 dependencies:
13251244 '@babel/core': 7.29.7
......@@ -1348,23 +1267,6 @@ snapshots:
13481267
13491268 caniuse-lite@1.0.30001812: {}
13501269
1351 chalk@5.6.2: {}
1352
1353 cliui@9.0.1:
1354 dependencies:
1355 string-width: 7.2.0
1356 strip-ansi: 7.2.0
1357 wrap-ansi: 9.0.2
1358
1359 concurrently@10.0.5:
1360 dependencies:
1361 chalk: 5.6.2
1362 rxjs: 7.8.2
1363 shell-quote: 1.9.0
1364 supports-color: 10.2.2
1365 tree-kill: 1.2.2
1366 yargs: 18.0.0
1367
13681270 convert-source-map@2.0.0: {}
13691271
13701272 csstype@3.2.3: {}
......@@ -1377,8 +1279,6 @@ snapshots:
13771279
13781280 electron-to-chromium@1.5.439: {}
13791281
1380 emoji-regex@10.6.0: {}
1381
13821282 entities@6.0.1: {}
13831283
13841284 esbuild@0.28.2:
......@@ -1421,10 +1321,6 @@ snapshots:
14211321
14221322 gensync@1.0.0-beta.2: {}
14231323
1424 get-caller-file@2.0.5: {}
1425
1426 get-east-asian-width@1.7.0: {}
1427
14281324 hono@4.13.9: {}
14291325
14301326 html-entities@2.3.3: {}
......@@ -1539,10 +1435,6 @@ snapshots:
15391435 '@rolldown/binding-win32-arm64-msvc': 1.2.11
15401436 '@rolldown/binding-win32-x64-msvc': 1.2.11
15411437
1542 rxjs@7.8.2:
1543 dependencies:
1544 tslib: 2.8.1
1545
15461438 semver@6.3.1: {}
15471439
15481440 seroval-plugins@1.5.6(seroval@1.5.6):
......@@ -1551,8 +1443,6 @@ snapshots:
15511443
15521444 seroval@1.5.6: {}
15531445
1554 shell-quote@1.9.0: {}
1555
15561446 solid-js@1.9.15:
15571447 dependencies:
15581448 csstype: 3.2.3
......@@ -1570,27 +1460,11 @@ snapshots:
15701460
15711461 source-map-js@1.2.1: {}
15721462
1573 string-width@7.2.0:
1574 dependencies:
1575 emoji-regex: 10.6.0
1576 get-east-asian-width: 1.7.0
1577 strip-ansi: 7.2.0
1578
1579 strip-ansi@7.2.0:
1580 dependencies:
1581 ansi-regex: 6.3.0
1582
1583 supports-color@10.2.2: {}
1584
15851463 tinyglobby@0.2.17:
15861464 dependencies:
15871465 fdir: 6.5.0(picomatch@4.0.7)
15881466 picomatch: 4.0.7
15891467
1590 tree-kill@1.2.2: {}
1591
1592 tslib@2.8.1: {}
1593
15941468 tsx@4.23.15:
15951469 dependencies:
15961470 esbuild: 0.28.2
......@@ -1661,23 +1535,4 @@ snapshots:
16611535 optionalDependencies:
16621536 vite: 8.3.1(@types/node@26.6.2)(esbuild@0.28.2)(tsx@4.23.15)
16631537
1664 wrap-ansi@9.0.2:
1665 dependencies:
1666 ansi-styles: 6.2.3
1667 string-width: 7.2.0
1668 strip-ansi: 7.2.0
1669
1670 y18n@5.0.8: {}
1671
16721538 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
1919
2020os.umask(0o007)
2121
22YT_CONFIG_DIR = os.environ.get("STUDIO_YT_CONFIG", "/srv/clover/Documents/Config/Youtube Downloader")
22YT_CONFIG_DIR = os.environ.get("SNOWGLOBE_YT_CONFIG", "/srv/clover/Documents/Config/Youtube Downloader")
2323FEED_CONFIG = os.path.join(YT_CONFIG_DIR, "feed.yaml")
24STATE_DIR = os.environ.get("STUDIO_YT_STATE", "/srv/prod/ytdl/data")
24STATE_DIR = os.environ.get("SNOWGLOBE_YT_STATE", "/srv/prod/ytdl/data")
2525INTERVAL = int(os.environ.get("CHECK_INTERVAL", "1800"))
2626SMTP_HOST = os.environ.get("SMTP_HOST", "")
2727SMTP_PORT = int(os.environ.get("SMTP_PORT", "465"))
2828SMTP_USER = os.environ.get("SMTP_USER", "")
2929SMTP_PASS = os.environ.get("SMTP_PASS", "")
30MAIL_FROM = os.environ.get("MAIL_FROM", f"yt-feed@{os.environ.get('STUDIO_DOMAIN', 'studio.test')}")
31MAIL_TO = os.environ.get("MAIL_TO", os.environ.get("STUDIO_OWNER_EMAIL", "account@paperclover.net"))
32BASE_URL = os.environ.get("BASE_URL", f"https://snowglobe.{os.environ.get('STUDIO_DOMAIN', 'studio.test')}/youtube").rstrip("/")
33READ_ONLY = os.environ.get("STUDIO_MEDIA_READ_ONLY") == "true"
30MAIL_FROM = os.environ.get("MAIL_FROM", f"yt-feed@{os.environ.get('SNOWGLOBE_DOMAIN', 'snowglobe.test')}")
31MAIL_TO = os.environ.get("MAIL_TO", os.environ.get("SNOWGLOBE_OWNER_EMAIL", "account@paperclover.net"))
32BASE_URL = os.environ.get("BASE_URL", f"https://snowglobe.{os.environ.get('SNOWGLOBE_DOMAIN', 'snowglobe.test')}/youtube").rstrip("/")
33READ_ONLY = os.environ.get("SNOWGLOBE_MEDIA_READ_ONLY") == "true"
3434
35MEDIA_ROOT = os.environ.get("STUDIO_YT_MEDIA", "/srv/clover/Media")
35MEDIA_ROOT = os.environ.get("SNOWGLOBE_YT_MEDIA", "/srv/clover/Media")
3636INDIE_DIR = os.path.join(MEDIA_ROOT, "Indie Shows")
3737INDEP_DIR = os.path.join(MEDIA_ROOT, "Videos/Independent")
3838MUSIC_DIR = os.path.join(MEDIA_ROOT, "Intake - Music")
dashboard/src/ai.rs+2-2
......@@ -29,7 +29,7 @@ pub async fn route(
2929 {
3030 return Err(Error::new(
3131 403,
32 "Open Local AI in Snowglobe to copy its key.",
32 "Open Local AI in Snow Globe to copy its key.",
3333 ));
3434 }
3535 let jobs = core::nomad(&app, "/v1/jobs").await?;
......@@ -45,7 +45,7 @@ pub async fn route(
4545 )
4646 })?;
4747 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"]);
4949 if hostname.is_empty()
5050 || !hostname
5151 .bytes()
dashboard/src/apps.rs+5-5
......@@ -1,7 +1,7 @@
11use crate::*;
22
33pub fn file_link(path: &str, zip: bool) -> Value {
4 let root = env("STUDIO_STORE_ROOT", "/srv");
4 let root = env("SNOWGLOBE_STORE_ROOT", "/srv");
55 let Some(relative) = std::path::Path::new(path).strip_prefix(&root).ok() else {
66 return Value::Null;
77 };
......@@ -10,7 +10,7 @@ pub fn file_link(path: &str, zip: bool) -> Value {
1010 .map(|c| encoded(&c.as_os_str().to_string_lossy()))
1111 .collect::<Vec<_>>()
1212 .join("/");
13 let Ok(files) = std::env::var("STUDIO_FILES_URL") else {
13 let Ok(files) = std::env::var("SNOWGLOBE_FILES_URL") else {
1414 return Value::Null;
1515 };
1616 json!(format!("{files}/{path}{}", if zip { "?zip" } else { "" }))
......@@ -126,7 +126,7 @@ fn validate_vm(mut spec: Value) -> Result<Value> {
126126}
127127async fn paper(app: Arc<App>, path: &str, body: Option<Value>) -> Result<Value> {
128128 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"]
130130 .as_str()
131131 .ok_or_else(|| Error::new(502, "Paper Clover is unavailable."))?;
132132 let key = host::call(
......@@ -141,7 +141,7 @@ async fn paper(app: Arc<App>, path: &str, body: Option<Value>) -> Result<Value>
141141 if path == "scan" {
142142 path.into()
143143 } else {
144 format!("studio/{path}")
144 format!("{}/{path}", namespace::PREVIOUS.as_str())
145145 }
146146 );
147147 let request = if let Some(body) = body {
......@@ -422,7 +422,7 @@ pub async fn route(
422422 }
423423 ["paper-clover"] if method == Method::GET => {
424424 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")
426426 .ok()
427427 .map(|p| file_link(&p, false))
428428 .unwrap_or(Value::Null);
dashboard/src/auth.rs+4-4
......@@ -170,7 +170,7 @@ impl Store {
170170 {
171171 return Err(Error::new(
172172 500,
173 "Set separate HTTPS origins for Snowglobe and Files.",
173 "Set separate HTTPS origins for Snow Globe and Files.",
174174 ));
175175 }
176176 let rp_origin = url::Url::parse(&format!("https://{rp}"))?;
......@@ -419,7 +419,7 @@ impl Store {
419419 }
420420 db.execute("DELETE FROM sessions WHERE expires<=?", [now() as i64])?;
421421 let ip = headers
422 .get("X-Studio-Client-IP")
422 .get("X-Snowglobe-Client-IP")
423423 .and_then(|v| v.to_str().ok())
424424 .unwrap_or("unknown");
425425 db.execute(
......@@ -439,7 +439,7 @@ impl Store {
439439 }
440440 pub(crate) fn limit(&self, headers: &HeaderMap, name: &str) -> Result<()> {
441441 let ip = headers
442 .get("X-Studio-Client-IP")
442 .get("X-Snowglobe-Client-IP")
443443 .and_then(|v| v.to_str().ok())
444444 .unwrap_or("unknown");
445445 let db = self.db.lock().unwrap();
......@@ -479,7 +479,7 @@ impl Store {
479479 if headers.get("origin").and_then(|v| v.to_str().ok())
480480 != Some(self.origin.origin().ascii_serialization().as_str())
481481 {
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."));
483483 }
484484 let cookie = cookie(headers, CSRF_COOKIE).unwrap_or_default();
485485 if cookie.is_empty()
dashboard/src/core.rs+23-60
......@@ -5,16 +5,18 @@ use std::path::Path;
55
66pub async fn nomad(app: &App, path: &str) -> Result<Value> {
77 let value = nomad_raw(app, path).await?;
8 Ok(value
8 let mut value = value
99 .map(|bytes| serde_json::from_slice(&bytes))
1010 .transpose()?
11 .unwrap_or(Value::Null))
11 .unwrap_or(Value::Null);
12 namespace::nomad(&mut value);
13 Ok(value)
1214}
1315pub async fn nomad_raw(app: &App, path: &str) -> Result<Option<Bytes>> {
1416 let request = async {
1517 let token = tokio::fs::read_to_string(env(
16 "STUDIO_NOMAD_TOKEN_FILE",
17 "/var/lib/studio/dashboard.token",
18 "SNOWGLOBE_NOMAD_TOKEN_FILE",
19 "/var/lib/snowglobe/dashboard.token",
1820 ))
1921 .await
2022 .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> {
222224 if !valid_id(id) {
223225 return Err(Error::new(400, "Invalid service ID."));
224226 }
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 }
232227 let direct = app.repo.join("service").join(id).join("service.pkl");
233228 if tokio::fs::try_exists(&direct).await? {
234229 return Ok(direct);
235230 }
236231 let mut dirs = tokio::fs::read_dir(app.repo.join("service")).await?;
237232 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 }
244233 let file = dir.path().join(format!("{id}.pkl"));
245234 if tokio::fs::try_exists(&file).await? {
246235 return Ok(file);
......@@ -264,7 +253,7 @@ async fn icons(app: Arc<App>, id: String) -> Result<Arc<Document>> {
264253 let mut found = serde_json::Map::new();
265254 for file in ["icon.svg","icon-light.svg","icon-dark.svg"] {
266255 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);
268257 let path = if tokio::fs::try_exists(&candidate).await? { candidate } else { fallback };
269258 if let Ok(bytes) = tokio::fs::read(&path).await {
270259 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 {
350339 }
351340 })
352341 .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})
354343}
355344async fn summaries(app: Arc<App>) -> Result<Arc<Document>> {
356345 let state = app.clone();
......@@ -444,19 +433,11 @@ async fn issues(app: Arc<App>) -> Result<Value> {
444433 Ok(json!(issues))
445434}
446435
447async fn excluded_services(repo: &Path) -> Result<Vec<String>> {
448 Ok(serde_json::from_slice(
449 &tokio::fs::read(repo.join("config/excluded-services.json")).await?,
450 )?)
451}
452
453436async fn launcher_module(repo: &Path) -> Result<String> {
454 let excluded = excluded_services(repo).await?;
455437 let mut files = Vec::new();
456438 let mut directories = tokio::fs::read_dir(repo.join("service")).await?;
457439 while let Some(directory) = directories.next_entry().await? {
458 let directory_name = directory.file_name().to_string_lossy().into_owned();
459 if excluded.contains(&directory_name) || !directory.file_type().await?.is_dir() {
440 if !directory.file_type().await?.is_dir() {
460441 continue;
461442 }
462443 let mut entries = tokio::fs::read_dir(directory.path()).await?;
......@@ -465,14 +446,7 @@ async fn launcher_module(repo: &Path) -> Result<String> {
465446 if !path.extension().is_some_and(|extension| extension == "pkl") {
466447 continue;
467448 }
468 let name = if entry.file_name() == "service.pkl" {
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 }
449 files.push(path);
476450 }
477451 }
478452 files.sort();
......@@ -485,11 +459,11 @@ async fn launcher_module(repo: &Path) -> Result<String> {
485459 }
486460 module.push_str(&format!("local services = Map({})\n", services.join(", ")));
487461 module.push_str(r#"output { renderer = new JsonRenderer { omitNullProperties = false }
488value = services.filter((_, s) -> s.enabled && s.meta.launcher).mapValues((_, s) ->
462value = services.filter((_, s) -> s.enabled && s.launcher).mapValues((_, s) ->
489463let (tasks = s.containers?.toMap() ?? Map("app", s.container))
490464let (routes = tasks.filter((_, task) -> task?.http?.hostname != null).mapValues((_, task) -> task.http))
491465let (route = routes.values.firstOrNull)
492new Dynamic { name = s.meta.name; tagline = s.meta.tagline; hostname = route?.hostname; access = s.meta.access ?? route?.authRole; urls = routes.mapValues((_, http) -> "https://\(http.hostname)") }) }"#);
466new Dynamic { name = s.name; tagline = s.tagline; hostname = route?.hostname; access = s.access ?? route?.authRole; urls = routes.mapValues((_, http) -> "https://\(http.hostname)") }) }"#);
493467 Ok(module)
494468}
495469
......@@ -534,7 +508,7 @@ async fn service(app: Arc<App>, id: &str) -> Result<Arc<Document>> {
534508 .map(|s| json!({"id":other,"name":s["name"],"kind":kind,"health":s["health"]}))
535509 };
536510 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"]))
538512 .ok()
539513 };
540514 let requirements = needs(id).map(|n| {
......@@ -557,7 +531,7 @@ async fn service(app: Arc<App>, id: &str) -> Result<Arc<Document>> {
557531 };
558532 let mut summary = summarize(app.clone(), id, found).await;
559533 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"]
561535 .as_str()
562536 .filter(|s| !s.is_empty())
563537 {
......@@ -568,7 +542,7 @@ async fn service(app: Arc<App>, id: &str) -> Result<Arc<Document>> {
568542 false
569543 };
570544 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" {
572546 telemetry::metric_names(app.clone(), id)
573547 .await
574548 .unwrap_or(json!([]))
......@@ -576,7 +550,7 @@ async fn service(app: Arc<App>, id: &str) -> Result<Arc<Document>> {
576550 json!([])
577551 };
578552 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"]))
580554 .ok()
581555 .map(|v| {
582556 array(&v)
......@@ -851,34 +825,23 @@ async fn definition(app: Arc<App>, id: &str) -> Result<Value> {
851825mod tests {
852826 use super::*;
853827 #[tokio::test]
854 async fn launcher_excludes_directories_and_grouped_definitions_before_import() {
855 let root = std::env::temp_dir().join(format!("studio-launcher-{}", uuid::Uuid::new_v4()));
856 tokio::fs::create_dir_all(root.join("config"))
828 async fn launcher_discovers_direct_and_grouped_definitions() {
829 let root = std::env::temp_dir().join(format!("snowglobe-launcher-{}", uuid::Uuid::new_v4()));
830 tokio::fs::create_dir_all(root.join("service/personal"))
857831 .await
858832 .unwrap();
859 for directory in ["retired", "personal"] {
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"]"#)
833 tokio::fs::write(root.join("service/README.md"), "not a service")
865834 .await
866835 .unwrap();
867 for file in [
868 "retired/service.pkl",
869 "personal/retired.pkl",
870 "personal/service.pkl",
871 "personal/fixture.pkl",
872 ] {
873 tokio::fs::write(root.join("service").join(file), "unread fixture")
836 for file in ["service.pkl", "fixture.pkl", "icon.svg"] {
837 tokio::fs::write(root.join("service/personal").join(file), "unread fixture")
874838 .await
875839 .unwrap();
876840 }
877841 let module = launcher_module(&root).await.unwrap();
878 assert!(!module.contains("retired"));
879 assert!(!module.contains("import*"));
880842 assert!(module.contains("/personal/service.pkl"));
881843 assert!(module.contains("/personal/fixture.pkl"));
844 assert!(!module.contains("icon.svg"));
882845 assert_eq!(
883846 module
884847 .lines()
dashboard/src/deploys.rs+1-1
......@@ -15,7 +15,7 @@ async fn stages(app: Arc<App>) -> Result<Value> {
1515 for stage in values.as_array_mut().unwrap() {
1616 let job = jobs.as_ref().map(|jobs| &jobs.value[string(&stage["id"])]);
1717 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())
1919 .filter(|hostname| !hostname.is_empty())
2020 );
2121 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 {
5252}
5353impl Explorer {
5454 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"));
5656 let scope = root
5757 .strip_prefix(&store)
5858 .map_err(|_| Error::new(500, "Library root is outside the store."))?
......@@ -577,7 +577,7 @@ async fn prune(ops: &Value) -> Result<()> {
577577 let mounts = mounts().await?;
578578 let datasets: HashSet<_> = array(&mounts)
579579 .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")))
581581 .map(|m| string(&m["source"]))
582582 .collect();
583583 if datasets.is_empty() {
......@@ -605,11 +605,11 @@ pub async fn route(
605605) -> Result<Response> {
606606 let root = if media {
607607 env(
608 "STUDIO_MEDIA_ROOT",
609 &format!("{}/clover/Media", env("STUDIO_STORE_ROOT", "/srv")),
608 "SNOWGLOBE_MEDIA_ROOT",
609 &format!("{}/clover/Media", env("SNOWGLOBE_STORE_ROOT", "/srv")),
610610 )
611611 } else {
612 env("STUDIO_STORE_ROOT", "/srv")
612 env("SNOWGLOBE_STORE_ROOT", "/srv")
613613 };
614614 let explorer = Explorer::new(root.into()).await?;
615615 if parts == ["refresh"] && media && method == Method::POST {
......@@ -719,7 +719,7 @@ async fn change(
719719 parts: &[&str],
720720 body: Value,
721721) -> Result<Response> {
722 if env("STUDIO_FILES_WRITABLE", "") != "1" {
722 if env("SNOWGLOBE_FILES_WRITABLE", "") != "1" {
723723 return Err(Error::new(
724724 501,
725725 "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<()> {
10641064 Ok(())
10651065}
10661066async 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")
10681068 .map_err(|_| Error::new(501, "Jellyfin isn't connected to the dashboard."))?;
10691069 let password = host::call(
10701070 json!({"operation":"deploy.secret.get","service":"jellyfin","key":"admin_password"}),
......@@ -1078,7 +1078,7 @@ async fn refresh(app: Arc<App>) -> Result<Response> {
10781078 .post(format!("{base}/Users/AuthenticateByName"))
10791079 .header(
10801080 "Authorization",
1081 "MediaBrowser Client=\"home server\", Device=\"server\", DeviceId=\"studio\", Version=\"1\"",
1081 "MediaBrowser Client=\"home server\", Device=\"server\", DeviceId=\"snowglobe\", Version=\"1\"",
10821082 )
10831083 .json(&json!({"Username":"snow","Pw":password}))
10841084 .send()
dashboard/src/guest.rs+3-3
......@@ -92,7 +92,7 @@ pub fn providers(auth: &auth::Store, next: &str) -> Result<Value> {
9292
9393fn registration(auth: &auth::Store, provider: &str) -> Result<(String, String)> {
9494 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."))
9696}
9797
9898async fn response_bytes(mut response: reqwest::Response) -> Result<Vec<u8>> {
......@@ -528,7 +528,7 @@ async fn handle(app: &App, request: Request) -> Result<Response> {
528528 if !current.is_null() && !is_guest(&current) {
529529 return Err(Error::new(
530530 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.",
532532 ));
533533 }
534534 let callback = format!("{}auth/guest/callback/{provider}", auth.origin);
......@@ -616,7 +616,7 @@ async fn handle(app: &App, request: Request) -> Result<Response> {
616616 let http = reqwest::Client::builder()
617617 .timeout(Duration::from_secs(10))
618618 .redirect(reqwest::redirect::Policy::none())
619 .user_agent("Snowglobe guest sign-in")
619 .user_agent("Snow Globe guest sign-in")
620620 .default_headers({
621621 let mut headers = HeaderMap::new();
622622 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)> {
4141 };
4242 tokio::time::timeout(Duration::from_secs(timeout), async {
4343 let mut socket = tokio::net::UnixStream::connect(env(
44 "STUDIO_HOST_SOCKET",
45 "/run/studio-host/host.sock",
44 "SNOWGLOBE_HOST_SOCKET",
45 "/run/snowglobe-host/host.sock",
4646 ))
4747 .await?;
4848 #[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>) -
820820 })?
821821 .clone();
822822 let _slot = app.heavy.acquire().await?;
823 let root = env("STUDIO_STORE_ROOT", "/srv");
823 let root = env("SNOWGLOBE_STORE_ROOT", "/srv");
824824 let rel = crate::files::relative(
825825 query.get("path").map(String::as_str).unwrap_or_default(),
826826 false,
......@@ -849,7 +849,7 @@ mod tests {
849849
850850 #[test]
851851 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") {
853853 let db = Connection::open(file).unwrap();
854854 db.execute_batch("PRAGMA cache_size=1; BEGIN IMMEDIATE; UPDATE file SET size=99;")
855855 .unwrap();
......@@ -869,7 +869,7 @@ mod tests {
869869 assert!(
870870 std::process::Command::new(std::env::current_exe().unwrap())
871871 .args(["--exact", thread.name().unwrap()])
872 .env("STUDIO_INDEX_CRASH_TEST_DB", &file)
872 .env("SNOWGLOBE_INDEX_CRASH_TEST_DB", &file)
873873 .status()
874874 .unwrap()
875875 .success()
dashboard/src/main.rs+62-33
......@@ -10,6 +10,7 @@ mod guest;
1010mod host;
1111mod index;
1212mod mcp;
13mod namespace;
1314mod observability;
1415mod oidc;
1516mod relay;
......@@ -113,6 +114,9 @@ struct App {
113114}
114115impl App {
115116 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 }
116120 let url = url::Url::parse(address)?;
117121 let client = match &self.internal {
118122 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>
264268 return users::picture(&app, &parts).await;
265269 }
266270 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 }
267276 let headers = request.headers().clone();
268277 let section = match parts.first().copied().unwrap_or_default() {
269278 "host" | "metrics" | "live" => Some("metrics"),
......@@ -344,8 +353,8 @@ async fn api(State(app): State<Arc<App>>, request: Request) -> Result<Response>
344353
345354#[tokio::main(worker_threads = 4)]
346355async 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()?;
348 let proof = match std::env::var_os("STUDIO_PROXY_TOKEN_FILE") {
356 let address: std::net::IpAddr = env("SNOWGLOBE_LISTEN_ADDRESS", "127.0.0.1").parse()?;
357 let proof = match std::env::var_os("SNOWGLOBE_PROXY_TOKEN_FILE").filter(|file| !file.is_empty()) {
349358 Some(file) => {
350359 let token = std::fs::read_to_string(file)?.trim().to_owned();
351360 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>> {
359368 None if address.is_loopback() => None,
360369 None => {
361370 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.",
363372 )
364373 .into());
365374 }
366375 };
367376 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"))
369378 {
370379 reqwest::Certificate::from_pem_bundle(&std::fs::read(path)?)?
371380 } else {
......@@ -378,7 +387,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
378387 }
379388 http
380389 };
381 let internal = std::env::var("STUDIO_INTERNAL_URL")
390 let internal = std::env::var("SNOWGLOBE_INTERNAL_URL")
382391 .ok()
383392 .map(
384393 |address| -> std::result::Result<_, Box<dyn std::error::Error>> {
......@@ -392,17 +401,17 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
392401 || base.fragment().is_some()
393402 {
394403 return Err(std::io::Error::other(
395 "STUDIO_INTERNAL_URL must be an HTTPS origin.",
404 "SNOWGLOBE_INTERNAL_URL must be an HTTPS origin.",
396405 )
397406 .into());
398407 }
399408 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.")
401410 })?;
402411 let mut value = axum::http::HeaderValue::from_str(token)?;
403412 value.set_sensitive(true);
404413 let mut headers = HeaderMap::new();
405 headers.insert("Studio-Proxy-Token", value);
414 headers.insert("Snowglobe-Proxy-Token", value);
406415 Ok((
407416 base,
408417 client()
......@@ -425,35 +434,55 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
425434 let mut token = axum::http::HeaderValue::from_str(proof.as_ref().unwrap())?;
426435 token.set_sensitive(true);
427436 let mut headers = HeaderMap::new();
428 headers.insert("Studio-Proxy-Token", token);
437 headers.insert("Snowglobe-Proxy-Token", token);
429438 shale_http = shale_http.default_headers(headers);
430439 }
431440 let shale_http = shale_http.build()?;
432441 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| {
434443 Arc::new(index::Index::new(
435444 pool,
436 env("STUDIO_INDEX_DIR", ".cache/index").into(),
445 env("SNOWGLOBE_INDEX_DIR", ".cache/index").into(),
437446 ))
438447 });
439448 let origin = env(
440 "STUDIO_PUBLIC_ORIGIN",
441 &format!("https://snowglobe.{}", env("STUDIO_DOMAIN", "studio.test")),
449 "SNOWGLOBE_PUBLIC_ORIGIN",
450 &format!("https://snowglobe.{}", env("SNOWGLOBE_DOMAIN", "snowglobe.test")),
442451 );
443452 let auth = auth::Store::new(
444 &PathBuf::from(env("STUDIO_DATA_DIR", "data")),
453 &PathBuf::from(env("SNOWGLOBE_DATA_DIR", "data")),
445454 &origin,
446455 &env(
447 "STUDIO_FILE_ORIGIN",
448 &format!("https://file.{}", env("STUDIO_DOMAIN", "studio.test")),
456 "SNOWGLOBE_FILE_ORIGIN",
457 &format!("https://file.{}", env("SNOWGLOBE_DOMAIN", "snowglobe.test")),
449458 ),
450459 &env(
451 "STUDIO_AUTH_RP_ID",
452 &format!("auth.{}", env("STUDIO_DOMAIN", "studio.test")),
460 "SNOWGLOBE_AUTH_RP_ID",
461 &format!("auth.{}", env("SNOWGLOBE_DOMAIN", "snowglobe.test")),
453462 ),
454463 )
455464 .map_err(|error| std::io::Error::other(error.message))?;
456465 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 }
457486 if path == "--import-commit-identity" {
458487 let input = serde_json::from_reader(std::io::stdin())?;
459488 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>> {
486515 println!("{result}");
487516 return Ok(());
488517 }
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");
490519 if import.exists() {
491520 auth.import(serde_json::from_slice(&std::fs::read(&import)?)?)
492521 .map_err(|error| std::io::Error::other(error.message))?;
493522 std::fs::remove_file(&import)?;
494523 }
495 if env("STUDIO_AUTH_REQUIRED", "0") == "1" && !auth.ready() {
524 if env("SNOWGLOBE_AUTH_REQUIRED", "0") == "1" && !auth.ready() {
496525 return Err(std::io::Error::other(
497526 "Import accounts before starting native authentication.",
498527 )
......@@ -500,13 +529,13 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
500529 }
501530 let app = Arc::new(App {
502531 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)
504533 .map_err(|error| std::io::Error::other(error.message))?,
505534 relay: relay::Broker::default(),
506535 shale: shale::Backend::new(
507536 &env(
508 "STUDIO_SHALE_URL",
509 &format!("https://shale.{}", env("STUDIO_DOMAIN", "studio.test")),
537 "SNOWGLOBE_SHALE_URL",
538 &format!("https://shale.{}", env("SNOWGLOBE_DOMAIN", "snowglobe.test")),
510539 ),
511540 client(),
512541 )
......@@ -517,8 +546,8 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
517546 cache: cache::Cache::default(),
518547 nomad_slots: Semaphore::new(4),
519548 specs: Mutex::new(HashMap::new()),
520 repo: env("STUDIO_REPO", "..").into(),
521 data: env("STUDIO_DATA_DIR", "data").into(),
549 repo: env("SNOWGLOBE_REPO", "..").into(),
550 data: env("SNOWGLOBE_DATA_DIR", "data").into(),
522551 live,
523552 usage: Mutex::new(HashMap::new()),
524553 vm_usage: Mutex::new(HashMap::new()),
......@@ -534,7 +563,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
534563 index.start(state).await;
535564 });
536565 }
537 if std::env::var("STUDIO_YT_STATE").is_ok() {
566 if std::env::var("SNOWGLOBE_YT_STATE").is_ok() {
538567 for parts in [&[][..], &["library"][..]] {
539568 let state = app.clone();
540569 tokio::spawn(async move {
......@@ -546,7 +575,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
546575 }
547576 core::start(app.clone());
548577 telemetry::start(app.clone());
549 let dist = env("STUDIO_WEB_DIR", "dist");
578 let dist = env("SNOWGLOBE_WEB_DIR", "dist");
550579 let router = Router::new()
551580 .route("/api/{*path}", any(api))
552581 .route("/auth/{*path}", any(auth::route))
......@@ -568,20 +597,20 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
568597 async move {
569598 request.headers_mut().remove("User-Id");
570599 if mcp::public(request.uri().path()) {
571 request.headers_mut().remove("Studio-Proxy-Token");
600 request.headers_mut().remove("Snowglobe-Proxy-Token");
572601 request.headers_mut().remove("User-Name");
573602 request.headers_mut().remove("User-Groups");
574603 } else if let Some(proof) = proof {
575604 let supplied = request
576605 .headers()
577 .get("Studio-Proxy-Token")
606 .get("Snowglobe-Proxy-Token")
578607 .map(|value| value.as_bytes())
579608 .unwrap_or_default();
580609 if supplied.ct_eq(proof.as_bytes()).unwrap_u8() == 0 {
581610 return Error::new(403, "Open the dashboard through its sign-in page.")
582611 .into_response();
583612 }
584 request.headers_mut().remove("Studio-Proxy-Token");
613 request.headers_mut().remove("Snowglobe-Proxy-Token");
585614 }
586615 if request.uri().path() == "/auth/shale/page" {
587616 return next.run(request).await;
......@@ -605,7 +634,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
605634 };
606635 if account.is_null() {
607636 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()
609638 } else {
610639 (
611640 StatusCode::FOUND,
......@@ -634,7 +663,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
634663 "location",
635664 format!(
636665 "https://shale.{}/",
637 env("STUDIO_DOMAIN", "studio.test")
666 env("SNOWGLOBE_DOMAIN", "snowglobe.test")
638667 ),
639668 )],
640669 )
......@@ -650,7 +679,7 @@ async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
650679 .and_then(|v| v.to_str().ok())
651680 != Some(app.auth.origin.origin().ascii_serialization().as_str())
652681 {
653 return Error::new(403, "Open Snowglobe and try again.")
682 return Error::new(403, "Open Snow Globe and try again.")
654683 .into_response();
655684 }
656685 if !array(&account["requiredActions"]).is_empty()
dashboard/src/mcp.rs+2-2
......@@ -969,8 +969,8 @@ mod tests {
969969 let path = std::env::temp_dir()
970970 .canonicalize()
971971 .unwrap()
972 .join(format!("studio-mcp-test-{}", uuid::Uuid::new_v4()));
973 let store = Arc::new(Store::new(&path, "https://globe.studio.test").unwrap());
972 .join(format!("snowglobe-mcp-test-{}", uuid::Uuid::new_v4()));
973 let store = Arc::new(Store::new(&path, "https://globe.snowglobe.test").unwrap());
974974 Self { store, path }
975975 }
976976 fn code(&self, client: &str, code: &str) -> HashMap<String, String> {
dashboard/src/namespace-transition.json created+4
......@@ -0,0 +1,4 @@
1{
2 "previous": "studio",
3 "previousHost": "zenith"
4}
dashboard/src/namespace.rs created+87
......@@ -0,0 +1,87 @@
1use crate::*;
2use serde_json::Map;
3
4pub static PREVIOUS: std::sync::LazyLock<String> = std::sync::LazyLock::new(|| {
5 serde_json::from_str::<Value>(include_str!("namespace-transition.json")).unwrap()["previous"]
6 .as_str().unwrap().to_owned()
7});
8
9fn keys(values: &mut Map<String, Value>, separator: &str) {
10 let prefix = format!("{}{separator}", PREVIOUS.as_str());
11 let renamed: Vec<_> = values.keys().filter_map(|key| {
12 key.strip_prefix(&prefix).map(|suffix| (key.clone(), format!("snowglobe{separator}{suffix}")))
13 }).collect();
14 for (old, new) in renamed {
15 let value = values.remove(&old).unwrap();
16 values.entry(new).or_insert(value);
17 }
18}
19
20pub fn nomad(value: &mut Value) {
21 match value {
22 Value::Object(values) => {
23 if let Some(meta) = values.get_mut("Meta").and_then(Value::as_object_mut) {
24 keys(meta, "_");
25 }
26 if let Some(tags) = values.get_mut("Tags").and_then(Value::as_array_mut) {
27 let prefix = format!("{}-metrics-path=", PREVIOUS.as_str());
28 for tag in tags {
29 if let Some(path) = tag.as_str().and_then(|tag| tag.strip_prefix(&prefix)) {
30 *tag = json!(format!("snowglobe-metrics-path={path}"));
31 }
32 }
33 }
34 for value in values.values_mut() {
35 nomad(value);
36 }
37 }
38 Value::Array(values) => values.iter_mut().for_each(nomad),
39 _ => {}
40 }
41}
42
43pub fn attributes(values: &mut Map<String, Value>) {
44 keys(values, ".");
45}
46
47pub fn metric_selector(metric: &str, labels: &str) -> String {
48 let previous = metric.replacen("snowglobe_", &format!("{}_", PREVIOUS.as_str()), 1);
49 format!("sum without (__name__) ({metric}{labels}) or sum without (__name__) ({previous}{labels})")
50}
51
52#[cfg(test)]
53mod tests {
54 use super::*;
55
56 #[test]
57 fn persisted_metadata_is_read_once_with_current_values_winning() {
58 let old = PREVIOUS.as_str();
59 let mut value = json!({"Meta": {
60 format!("{old}_name"): "old name", "snowglobe_name": "Snow Globe",
61 format!("{old}_hostname"): "knife.example.test"
62 }, "TaskGroups": [{"Services": [{"Tags": [format!("{old}-metrics-path=/metrics"), "caddy-host=knife.example.test"]}]}],
63 "Config": {"Env": {format!("{}_DOMAIN", old.to_uppercase()): "untouched"}}});
64 nomad(&mut value);
65 assert_eq!(value["Meta"]["snowglobe_name"], "Snow Globe");
66 assert_eq!(value["Meta"]["snowglobe_hostname"], "knife.example.test");
67 assert!(value["Meta"].get(format!("{old}_name")).is_none());
68 assert_eq!(value["TaskGroups"][0]["Services"][0]["Tags"][0], "snowglobe-metrics-path=/metrics");
69 assert_eq!(value["Config"]["Env"][format!("{}_DOMAIN", old.to_uppercase())], "untouched");
70 let normalized = value.clone();
71 nomad(&mut value);
72 assert_eq!(value, normalized);
73 }
74
75 #[test]
76 fn historical_trace_ownership_remains_explicit() {
77 let mut values = Map::from_iter([
78 (format!("{}.service", PREVIOUS.as_str()), json!("private")),
79 (format!("{}.kind", PREVIOUS.as_str()), json!("edge")),
80 ("snowglobe.service".into(), json!("current")),
81 ]);
82 attributes(&mut values);
83 assert_eq!(values["snowglobe.service"], "current");
84 assert_eq!(values["snowglobe.kind"], "edge");
85 assert_eq!(values.len(), 2);
86 }
87}
dashboard/src/observability.rs+6-6
......@@ -129,14 +129,14 @@ impl ServerHandler for Observability {
129129 }
130130}
131131fn 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() {
133133 return array(resources).iter().any(|r| r == id);
134134 }
135135 let owners: Vec<_> = jobs
136136 .as_object()
137137 .into_iter()
138138 .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"])
140140 .map(|(id, _)| id)
141141 .collect();
142142 owners.len() == 1 && array(resources).iter().any(|r| r == owners[0])
......@@ -153,7 +153,7 @@ mod tests {
153153 use super::*;
154154 #[test]
155155 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"}}}});
157157 let resources = json!(["allowed"]);
158158 assert!(visible_span(
159159 &json!({"service":"backend","attributes":{}}),
......@@ -166,17 +166,17 @@ mod tests {
166166 &resources
167167 ));
168168 assert!(!visible_span(
169 &json!({"service":"backend","attributes":{"studio.service":"private"}}),
169 &json!({"service":"backend","attributes":{"snowglobe.service":"private"}}),
170170 &jobs,
171171 &resources
172172 ));
173173 assert!(visible_span(
174 &json!({"service":"allowed","attributes":{"studio.service":"allowed"}}),
174 &json!({"service":"allowed","attributes":{"snowglobe.service":"allowed"}}),
175175 &jobs,
176176 &resources
177177 ));
178178 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");
180180 assert!(!visible_span(
181181 &json!({"service":"backend","attributes":{}}),
182182 &ambiguous,
dashboard/src/relay.rs+3-3
......@@ -801,7 +801,7 @@ pub fn router(app: Arc<App>) -> Router {
801801 let state = app.clone();
802802 let expected_host =
803803 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");
805805 Router::new()
806806 .route("/pairing", any(pairing))
807807 .route("/agent/connect", any(connect))
......@@ -848,8 +848,8 @@ mod tests {
848848 let path = std::env::temp_dir()
849849 .canonicalize()
850850 .unwrap()
851 .join(format!("studio-relay-test-{}", uuid::Uuid::new_v4()));
852 let store = Arc::new(mcp::Store::new(&path, "https://globe.studio.test").unwrap());
851 .join(format!("snowglobe-relay-test-{}", uuid::Uuid::new_v4()));
852 let store = Arc::new(mcp::Store::new(&path, "https://globe.snowglobe.test").unwrap());
853853 let machine = uuid::Uuid::new_v4().to_string();
854854 let grant = uuid::Uuid::new_v4().to_string();
855855 {
dashboard/src/shale.rs+5-5
......@@ -586,7 +586,7 @@ pub async fn manage(
586586 600,
587587 )?;
588588 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())
590590 }
591591 Method::DELETE => {
592592 let session = {
......@@ -639,7 +639,7 @@ pub async fn oauth(app: Arc<App>, request: Request) -> Response {
639639 tx.commit()?;
640640 return Ok((StatusCode::FOUND, [
641641 ("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")),
643643 ]).into_response());
644644 }
645645 if !callback {
......@@ -647,7 +647,7 @@ pub async fn oauth(app: Arc<App>, request: Request) -> Response {
647647 }
648648 let cookies: Vec<_> = request.headers().get_all("cookie").iter()
649649 .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();
651651 if cookies.len() != 1 || cookies[0].len() != 43 {
652652 return Err(Error::new(400, "This Shale link cookie is missing. Start linking again."));
653653 }
......@@ -724,7 +724,7 @@ pub async fn oauth(app: Arc<App>, request: Request) -> Response {
724724 if callback {
725725 response.headers_mut().append(
726726 "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"
728728 .parse()
729729 .unwrap(),
730730 );
......@@ -754,7 +754,7 @@ mod tests {
754754 }
755755 #[test]
756756 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();
758758 for name in [
759759 "",
760760 ".",
dashboard/src/shale_page.rs+6-6
......@@ -350,7 +350,7 @@ pub async fn proxy(app: Arc<App>, request: Request) -> Result<Response> {
350350 .get("host")
351351 .and_then(|v| v.to_str().ok())
352352 .unwrap_or_default();
353 let domain = env("STUDIO_DOMAIN", "studio.test");
353 let domain = env("SNOWGLOBE_DOMAIN", "snowglobe.test");
354354 let service = host.strip_suffix(&format!(".{domain}")).unwrap_or_default().to_owned();
355355 if service != "shale"
356356 && !(service
......@@ -361,13 +361,13 @@ pub async fn proxy(app: Arc<App>, request: Request) -> Result<Response> {
361361 }
362362 let upstream: std::net::SocketAddr = parts
363363 .headers
364 .get("studio-shale-upstream")
364 .get("snowglobe-shale-upstream")
365365 .and_then(|v| v.to_str().ok())
366366 .ok_or_else(|| Error::new(403, "Open Shale to continue."))?
367367 .parse()?;
368368 let uri: axum::http::Uri = parts
369369 .headers
370 .get("studio-shale-uri")
370 .get("snowglobe-shale-uri")
371371 .and_then(|v| v.to_str().ok())
372372 .ok_or_else(|| Error::new(403, "Open Shale to continue."))?
373373 .parse()?;
......@@ -398,9 +398,9 @@ pub async fn proxy(app: Arc<App>, request: Request) -> Result<Response> {
398398 }
399399 strip_hop_headers(&mut parts.headers);
400400 for name in [
401 "studio-shale-upstream",
402 "studio-shale-uri",
403 "studio-proxy-token",
401 "snowglobe-shale-upstream",
402 "snowglobe-shale-uri",
403 "snowglobe-proxy-token",
404404 "user-name",
405405 "user-groups",
406406 "user-id",
dashboard/src/shares.rs+2-2
......@@ -68,8 +68,8 @@ pub async fn route(
6868 .await?;
6969 if value.is_object() {
7070 value["filesUrl"] = json!(env(
71 "STUDIO_FILES_URL",
72 &format!("https://file.{}", env("STUDIO_DOMAIN", "studio.test")),
71 "SNOWGLOBE_FILES_URL",
72 &format!("https://file.{}", env("SNOWGLOBE_DOMAIN", "snowglobe.test")),
7373 ));
7474 }
7575 Ok(Document::new(value).response())
dashboard/src/storage.rs+1-1
......@@ -147,7 +147,7 @@ pub async fn route(
147147 [] if method == Method::GET => {
148148 let found=app.cache.get("storage".into(),Duration::from_secs(30),move || async move {
149149 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}))
151151 }).await?;
152152 return Ok(found.response());
153153 }
dashboard/src/telemetry.rs+37-34
......@@ -47,7 +47,11 @@ pub async fn read(
4747 app.cache
4848 .get(key, Duration::from_secs(2), move || async move {
4949 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 }
5155 } else {
5256 state.request(Method::GET, &url)?
5357 };
......@@ -72,16 +76,16 @@ pub async fn read(
7276}
7377
7478const METRICS: &[(&str, &str)] = &[
75 ("host.cpu", "studio_host_cpu_percent"),
76 ("host.memory", "studio_host_memory_bytes"),
77 ("host.temperature", "studio_host_temperature_celsius"),
78 ("host.power", "studio_host_power_watts"),
79 ("host.gpu", "studio_host_gpu_percent"),
80 ("host.network", "studio_host_network_bytes_per_second"),
81 ("service.cpu", "studio_service_cpu_cores"),
82 ("service.memory", "studio_service_memory_bytes"),
83 ("vm.cpu", "studio_vm_cpu_percent"),
84 ("vm.memory", "studio_vm_memory_bytes"),
79 ("host.cpu", "snowglobe_host_cpu_percent"),
80 ("host.memory", "snowglobe_host_memory_bytes"),
81 ("host.temperature", "snowglobe_host_temperature_celsius"),
82 ("host.power", "snowglobe_host_power_watts"),
83 ("host.gpu", "snowglobe_host_gpu_percent"),
84 ("host.network", "snowglobe_host_network_bytes_per_second"),
85 ("service.cpu", "snowglobe_service_cpu_cores"),
86 ("service.memory", "snowglobe_service_memory_bytes"),
87 ("vm.cpu", "snowglobe_vm_cpu_percent"),
88 ("vm.memory", "snowglobe_vm_memory_bytes"),
8589];
8690
8791fn series(result: &Value, application: bool) -> Value {
......@@ -173,9 +177,7 @@ pub async fn metrics(
173177 .find(|(key, _)| *key == name)
174178 .ok_or_else(|| Error::new(400, "Invalid metric."))?
175179 .1;
176 format!(
177 "{metric}{}",
178 service
180 let labels = service
179181 .map(|id| format!(
180182 "{{{}={}}}",
181183 if name.starts_with("vm.") {
......@@ -185,8 +187,8 @@ pub async fn metrics(
185187 },
186188 quote(id)
187189 ))
188 .unwrap_or_default()
189 )
190 .unwrap_or_default();
191 namespace::metric_selector(metric, &labels)
190192 };
191193 let key = if window.is_some() {
192194 format!("series:{selector}:fixed:{from}:{to}")
......@@ -225,8 +227,8 @@ pub async fn metric_names(app: Arc<App>, id: &str) -> Result<Value> {
225227 (
226228 "match[]",
227229 format!(
228 "{{{label}={},__name__!~\"studio_.*\"}}",
229 serde_json::to_string(id).unwrap()
230 "{{{label}={},__name__!~\"(snowglobe|{})_.*\"}}",
231 serde_json::to_string(id).unwrap(), namespace::PREVIOUS.as_str()
230232 ),
231233 )
232234 }));
......@@ -366,6 +368,7 @@ fn span(row: &Value) -> Value {
366368 .map(|key| (key.into(), value.clone()))
367369 })
368370 .collect();
371 namespace::attributes(&mut attributes);
369372 for (from, to) in [
370373 ("http.request.method", "http.request.method"),
371374 ("http.response.status_code", "http.response.status_code"),
......@@ -383,7 +386,7 @@ fn span(row: &Value) -> Value {
383386 .cloned()
384387 .unwrap_or(Value::Null);
385388 let service = attributes
386 .get("studio.service")
389 .get("snowglobe.service")
387390 .cloned()
388391 .unwrap_or_else(|| {
389392 row["resource_attr:service.name"]
......@@ -405,7 +408,7 @@ fn span(row: &Value) -> Value {
405408 } else {
406409 Value::Null
407410 };
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") {
409412 format!("edge: {}", row["name"].as_str().unwrap_or("request"))
410413 } else {
411414 string(&row["name"]).into()
......@@ -500,7 +503,7 @@ pub async fn traces(
500503 visible: impl Fn(&Value) -> bool,
501504) -> Result<Value> {
502505 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"]
504507 .as_str()
505508 .filter(|s| !s.is_empty())
506509 else {
......@@ -611,7 +614,7 @@ pub async fn traces(
611614 let value = |trace: &Value| {
612615 array(&trace["spans"])
613616 .iter()
614 .find(|s| s["service"] == service && s["attributes"]["studio.kind"] != "edge")
617 .find(|s| s["service"] == service && s["attributes"]["snowglobe.kind"] != "edge")
615618 .map(|s| number(&s[if key == "_time" { "start" } else { "duration" }]))
616619 .unwrap_or(0.0)
617620 };
......@@ -695,21 +698,21 @@ impl Recorder {
695698 };
696699 let mut lines = vec![
697700 format!(
698 "studio_host_cpu_percent {} {timestamp}",
701 "snowglobe_host_cpu_percent {} {timestamp}",
699702 number(&live["host"]["cpu"])
700703 ),
701704 format!(
702 "studio_host_memory_bytes {} {timestamp}",
705 "snowglobe_host_memory_bytes {} {timestamp}",
703706 number(&live["host"]["memory"])
704707 ),
705708 ];
706709 for (id, (cpu, memory)) in usage {
707710 let id = serde_json::to_string(&id)?;
708711 lines.push(format!(
709 "studio_service_cpu_cores{{service={id}}} {cpu} {timestamp}"
712 "snowglobe_service_cpu_cores{{service={id}}} {cpu} {timestamp}"
710713 ));
711714 lines.push(format!(
712 "studio_service_memory_bytes{{service={id}}} {memory} {timestamp}"
715 "snowglobe_service_memory_bytes{{service={id}}} {memory} {timestamp}"
713716 ));
714717 }
715718 let sample = host::sample(app.clone()).await?;
......@@ -719,22 +722,22 @@ impl Recorder {
719722 let network_at = number(&sample["at"]);
720723 if let Some((old_rx, old_tx, t)) = self.network.filter(|(_, _, t)| network_at > *t) {
721724 lines.push(format!(
722 "studio_host_network_bytes_per_second{{direction=\"down\"}} {} {timestamp}",
725 "snowglobe_host_network_bytes_per_second{{direction=\"down\"}} {} {timestamp}",
723726 ((rx - old_rx) / (network_at - t)).max(0.0)
724727 ));
725728 lines.push(format!(
726 "studio_host_network_bytes_per_second{{direction=\"up\"}} {} {timestamp}",
729 "snowglobe_host_network_bytes_per_second{{direction=\"up\"}} {} {timestamp}",
727730 ((tx - old_tx) / (network_at - t)).max(0.0)
728731 ));
729732 }
730733 self.network = Some((rx, tx, network_at));
731734 if let Some(value) = live["host"]["temperature"].as_f64() {
732735 lines.push(format!(
733 "studio_host_temperature_celsius {value} {timestamp}"
736 "snowglobe_host_temperature_celsius {value} {timestamp}"
734737 ));
735738 }
736739 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}"));
738741 }
739742 if let Ok(Ok(stats)) = tokio::time::timeout(
740743 Duration::from_secs(8),
......@@ -757,11 +760,11 @@ impl Recorder {
757760 usage.insert(id.clone(), json!({"cpu":cpu,"memory":stat["memory"]}));
758761 next.insert(id.clone(), (number(&stat["cpu"]), at));
759762 lines.push(format!(
760 "studio_vm_cpu_percent{{vm={}}} {cpu} {timestamp}",
763 "snowglobe_vm_cpu_percent{{vm={}}} {cpu} {timestamp}",
761764 serde_json::to_string(id)?
762765 ));
763766 lines.push(format!(
764 "studio_vm_memory_bytes{{vm={}}} {} {timestamp}",
767 "snowglobe_vm_memory_bytes{{vm={}}} {} {timestamp}",
765768 serde_json::to_string(id)?,
766769 number(&stat["memory"])
767770 ));
......@@ -778,7 +781,7 @@ pub fn start(app: Arc<App>) {
778781 loop {
779782 let result = async {
780783 let base = endpoint(app.clone(), "victoria-metrics").await?;
781 if env("STUDIO_METRICS", "") == "follow" {
784 if env("SNOWGLOBE_METRICS", "") == "follow" {
782785 let names: Vec<_> = METRICS
783786 .iter()
784787 .filter(|(k, _)| k.starts_with("service.") || k.starts_with("vm."))
......@@ -828,7 +831,7 @@ pub fn start(app: Arc<App>) {
828831 .flat_map(|group| array(&group["Services"]))
829832 .flat_map(move |service| {
830833 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(
832835 |path| {
833836 (
834837 id.clone(),
dashboard/src/vms.rs+2-2
......@@ -45,8 +45,8 @@ pub async fn console(request: Request, name: &str, serial: bool) -> Result<Respo
4545 .map(|(_, stream)| stream);
4646 }
4747 let mut stream = tokio::net::UnixStream::connect(env(
48 "STUDIO_VM_SCREEN_SOCKET",
49 "/run/studio-vm-screen/screen.sock",
48 "SNOWGLOBE_VM_SCREEN_SOCKET",
49 "/run/snowglobe-vm-screen/screen.sock",
5050 ))
5151 .await?;
5252 stream
dashboard/src/youtube.rs+6-6
......@@ -27,14 +27,14 @@ impl Worker {
2727 }
2828 let response = tokio::time::timeout(Duration::from_secs(25), async {
2929 if child.is_none() {
30 if std::env::var("STUDIO_YT_STATE").is_err() {
30 if std::env::var("SNOWGLOBE_YT_STATE").is_err() {
3131 return Err(Error::new(
3232 501,
3333 "YouTube isn't connected to this home server. Configure its archive state, then retry.",
3434 ));
3535 }
36 let python = env("STUDIO_YT_PYTHON", "python3");
37 let script = env("STUDIO_YT_WORKER", "server/youtube-worker.py");
36 let python = env("SNOWGLOBE_YT_PYTHON", "python3");
37 let script = env("SNOWGLOBE_YT_WORKER", "server/youtube-worker.py");
3838 let mut command = tokio::process::Command::new(python);
3939 for (key, name) in [
4040 ("SMTP_HOST", "smtp_host"),
......@@ -156,8 +156,8 @@ pub async fn route(
156156 move || async move {
157157 if call == "library" {
158158 let _slot = state.heavy.acquire().await?;
159 let python = env("STUDIO_YT_PYTHON", "python3");
160 let script = env("STUDIO_YT_WORKER", "server/youtube-worker.py");
159 let python = env("SNOWGLOBE_YT_PYTHON", "python3");
160 let script = env("SNOWGLOBE_YT_WORKER", "server/youtube-worker.py");
161161 return Ok(serde_json::from_slice(
162162 &command(&python, &[&script, "--library"], None).await?,
163163 )?);
......@@ -167,7 +167,7 @@ pub async fn route(
167167 if call == "snapshot" {
168168 let archive = core::read_json(
169169 std::path::Path::new(&env(
170 "STUDIO_YT_ARCHIVE_STATUS",
170 "SNOWGLOBE_YT_ARCHIVE_STATUS",
171171 "/srv/prod/ytdl-sub/config/archive-status.json",
172172 )),
173173 Value::Null,
dashboard/tsconfig.json-1
......@@ -24,7 +24,6 @@
2424 },
2525 "include": [
2626 "web",
27 "dev.ts",
2827 "vite.config.ts"
2928 ]
3029}
dashboard/vite.config.ts-13
......@@ -8,17 +8,4 @@ export default defineConfig({
88 plugins: [solid()],
99 resolve: { alias: { "@novnc/keyboard": resolve(dirname(createRequire(import.meta.url).resolve("@novnc/novnc")), "input/keyboard.js") } },
1010 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 },
2411});
dashboard/web/pages/Account.tsx+2-2
......@@ -70,7 +70,7 @@ export function Account() {
7070 <a class="button" href="/">maybe later</a>
7171 </section>
7272 </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>
7474 <Profile user={user()} />
7575 <SignIn user={user()} />
7676 <CommitIdentity user={user()} identity={user().commitIdentity} refetch={refetchAccount} />
......@@ -212,7 +212,7 @@ function SignIn(props: { user: Self }) {
212212 });
213213 return <section class="card">
214214 <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>
216216 <div class="credentials">
217217 <span class="label">password</span><span>{password() ? "set" : "none"}</span>
218218 <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() {
4848 };
4949 return <main class="mcp-authorization">
5050 <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>
5252 <Show when={details()} fallback={<>
5353 <h1 id="connection-title">{consent.state === "errored" ? "Connection unavailable" : "Loading connection…"}</h1>
5454 <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) {
7878
7979
8080const appName = (clientId: string, services: ServiceSummary[]) =>
81 clientId === "dashboard" ? "Snowglobe" : clientId === "file" ? "Files" : services.find((service) => service.id === clientId)?.name ?? clientId;
81 clientId === "dashboard" ? "Snow Globe" : clientId === "file" ? "Files" : services.find((service) => service.id === clientId)?.name ?? clientId;
8282
8383/** "active 3h ago in Jellyfin, Shale", from their open sessions. */
8484function seen(user: User, services: ServiceSummary[]) {
......@@ -531,7 +531,7 @@ function Profile(props: { user: User; data: Data; refetch: () => unknown }) {
531531 const name = props.user.username;
532532 showTextDialog({
533533 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.`,
535535 label: `type ${name} to confirm`,
536536 validateInput: (value) => value === name,
537537 confirmLabel: "delete user",
flake.nix+4-4
......@@ -1,5 +1,5 @@
11{
2 description = "Clover infrastructure prototype";
2 description = "Snow Globe infrastructure";
33
44 inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-26.05";
55
......@@ -14,7 +14,7 @@
1414 system = "x86_64-linux";
1515 modules = [
1616 "${nixpkgs}/nixos/modules/installer/cd-dvd/installation-cd-minimal.nix"
17 ./nixos/zenith-network.nix
17 ./nixos/snowglobe-network.nix
1818 ({ lib, pkgs, ... }: {
1919 networking.hostName = "infra-2-installer";
2020 networking.networkmanager.enable = lib.mkForce false;
......@@ -40,9 +40,9 @@
4040 modules = [ ./nixos/configuration.nix ./nixos/vm.nix ];
4141 };
4242
43 nixosConfigurations.zenith = nixpkgs.lib.nixosSystem {
43 nixosConfigurations.snowglobe = nixpkgs.lib.nixosSystem {
4444 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 ];
4646 };
4747 };
4848}
nixos/configuration.nix+88-87
......@@ -3,10 +3,10 @@ let
33 dashboard = pkgs.callPackage ./dashboard.nix { };
44 dashboardPort = "7072";
55 internalPort = 8448;
6 proxyToken = "/var/lib/studio/dashboard-proxy.token";
6 proxyToken = "/var/lib/snowglobe/dashboard-proxy.token";
77 hostTools = lib.fileset.toSource {
88 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 ];
1010 };
1111 nativePkl = pkgs.callPackage ./pkl.nix { };
1212 screenPython = pkgs.python3.withPackages (packages: [ packages.pygobject3 packages.gst-python ]);
......@@ -70,7 +70,7 @@ in
7070 };
7171 };
7272 systemd.services.caddy.environment = {
73 OTEL_SERVICE_NAME = "studio-caddy";
73 OTEL_SERVICE_NAME = "snowglobe-caddy";
7474 OTEL_EXPORTER_OTLP_TRACES_ENDPOINT = "http://127.0.0.1:10428/insert/opentelemetry/v1/traces";
7575 OTEL_TRACES_SAMPLER = "parentbased_traceidratio";
7676 OTEL_TRACES_SAMPLER_ARG = "0.25";
......@@ -109,14 +109,14 @@ in
109109 };
110110 };
111111
112 systemd.services.studio-log-shipper = {
112 systemd.services.snowglobe-log-shipper = {
113113 wantedBy = [ "multi-user.target" ];
114114 after = [ "nomad.service" ];
115115 wants = [ "nomad.service" ];
116 unitConfig.ConditionPathExists = "/opt/studio/current/tools/log-shipper.py";
116 unitConfig.ConditionPathExists = "/opt/snowglobe/current/tools/log-shipper.py";
117117 path = [ pkgs.systemd ];
118118 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";
120120 Restart = "always";
121121 RestartSec = 5;
122122 };
......@@ -127,16 +127,16 @@ in
127127 requires = [ "podman.socket" ];
128128 };
129129
130 systemd.services.studio-router = {
130 systemd.services.snowglobe-router = {
131131 wantedBy = [ "multi-user.target" ];
132132 wants = [ "nomad.service" "caddy.service" ];
133133 after = [ "nomad.service" "caddy.service" ];
134 unitConfig.ConditionPathExists = "/var/lib/studio/router.token";
134 unitConfig.ConditionPathExists = "/var/lib/snowglobe/router.token";
135135 environment = {
136 STUDIO_DOMAIN = config.environment.variables.STUDIO_DOMAIN;
137 STUDIO_DASHBOARD_PORT = dashboardPort;
138 STUDIO_INTERNAL_PORT = toString internalPort;
139 STUDIO_PROXY_TOKEN_FILE = proxyToken;
136 SNOWGLOBE_DOMAIN = config.environment.variables.SNOWGLOBE_DOMAIN;
137 SNOWGLOBE_DASHBOARD_PORT = dashboardPort;
138 SNOWGLOBE_INTERNAL_PORT = toString internalPort;
139 SNOWGLOBE_PROXY_TOKEN_FILE = proxyToken;
140140 };
141141 serviceConfig = {
142142 ExecStart = "${pkgs.python3}/bin/python3 ${../tools/router.py}";
......@@ -145,26 +145,27 @@ in
145145 };
146146 };
147147
148 users.groups.studio-dashboard = { };
149 users.users.studio-dashboard = {
148 users.groups.snowglobe-dashboard.gid = 994;
149 users.users.snowglobe-dashboard = {
150 uid = 997;
150151 isSystemUser = true;
151 group = "studio-dashboard";
152 group = "snowglobe-dashboard";
152153 };
153 systemd.services.studio-vm-screen = {
154 systemd.services.snowglobe-vm-screen = {
154155 wantedBy = [ "multi-user.target" ];
155 wants = [ "studio-host.service" ];
156 after = [ "studio-host.service" ];
156 wants = [ "snowglobe-host.service" ];
157 after = [ "snowglobe-host.service" ];
157158 environment = {
158159 GST_PLUGIN_SYSTEM_PATH_1_0 = lib.makeSearchPath "lib/gstreamer-1.0" screenPlugins;
159160 GI_TYPELIB_PATH = lib.makeSearchPath "lib/girepository-1.0" (map lib.getLib ([ pkgs.gst_all_1.gstreamer ] ++ screenPlugins));
160161 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;
162163 };
163164 serviceConfig = {
164165 ExecStart = "${screenPython}/bin/python3 ${../tools/vm-screen.py}";
165 User = "studio-dashboard";
166 Group = "studio-dashboard";
167 RuntimeDirectory = "studio-vm-screen";
166 User = "snowglobe-dashboard";
167 Group = "snowglobe-dashboard";
168 RuntimeDirectory = "snowglobe-vm-screen";
168169 RuntimeDirectoryMode = "0700";
169170 RuntimeDirectoryPreserve = "yes";
170171 UMask = "0077";
......@@ -182,29 +183,29 @@ in
182183 RestartSec = 2;
183184 };
184185 };
185 systemd.services.studio-host = {
186 systemd.services.snowglobe-host = {
186187 wantedBy = [ "multi-user.target" ];
187188 wants = [ "podman.socket" ];
188189 after = [ "podman.socket" ];
189190 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 ]
190191 ++ 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 STUDIO_POOL = lib.attrByPath [ "STUDIO_POOL" ] "studio-demo" config.environment.variables;
193 STUDIO_DASHBOARD_USER = "studio-dashboard";
194 STUDIO_VM_ACCEL = lib.attrByPath [ "STUDIO_VM_ACCEL" ] "kvm" config.environment.variables;
192 environment = (lib.filterAttrs (name: _: lib.hasPrefix "SNOWGLOBE_" name) config.environment.variables) // {
193 SNOWGLOBE_POOL = lib.attrByPath [ "SNOWGLOBE_POOL" ] "snowglobe-demo" config.environment.variables;
194 SNOWGLOBE_DASHBOARD_USER = "snowglobe-dashboard";
195 SNOWGLOBE_VM_ACCEL = lib.attrByPath [ "SNOWGLOBE_VM_ACCEL" ] "kvm" config.environment.variables;
195196 };
196197 serviceConfig = {
197198 ExecStart = "${pkgs.python3}/bin/python3 ${hostTools}/tools/dashboard-host.py";
198199 Type = "notify";
199 Group = "studio-dashboard";
200 StateDirectory = "studio/host";
200 Group = "snowglobe-dashboard";
201 StateDirectory = "snowglobe/host";
201202 StateDirectoryMode = "0700";
202 RuntimeDirectory = "studio-host";
203 RuntimeDirectory = "snowglobe-host";
203204 RuntimeDirectoryMode = "0750";
204205 RuntimeDirectoryPreserve = "yes";
205206 UMask = "0077";
206207 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" ];
208209 ProtectHome = true;
209210 PrivateTmp = true;
210211 NoNewPrivileges = true;
......@@ -220,49 +221,49 @@ in
220221 RestartSec = 2;
221222 };
222223 };
223 systemd.services.studio-dashboard = let
224 environment = (lib.filterAttrs (name: _: lib.hasPrefix "STUDIO_" name) config.environment.variables) // {
225 STUDIO_DATA_DIR = "/data";
226 STUDIO_PROXY_TOKEN_FILE = "/run/secrets/dashboard-proxy.token";
227 STUDIO_NOMAD_TOKEN_FILE = "/run/secrets/dashboard-nomad.token";
228 STUDIO_CA_BUNDLE = "/run/secrets/ca-bundle.crt";
229 STUDIO_INDEX_DIR = "/data/index";
230 STUDIO_INTERNAL_URL = "https://dashboard.internal.${config.environment.variables.STUDIO_DOMAIN}:${toString internalPort}";
231 STUDIO_FILES_URL = "https://file.${config.environment.variables.STUDIO_DOMAIN}";
232 STUDIO_AUTH_REQUIRED = "1";
233 STUDIO_AUTH_RP_ID = "auth.${config.environment.variables.STUDIO_DOMAIN}";
234 STUDIO_FILE_ORIGIN = "https://file.${config.environment.variables.STUDIO_DOMAIN}";
235 STUDIO_PUBLIC_ORIGIN = "https://snowglobe.${config.environment.variables.STUDIO_DOMAIN}";
236 STUDIO_JELLYFIN_URL = "https://jelly.${config.environment.variables.STUDIO_DOMAIN}";
237 STUDIO_SHALE_URL = "https://shale.${config.environment.variables.STUDIO_DOMAIN}";
238 STUDIO_PUBLISHED_ROOT = "/srv/clover/Published";
239 STUDIO_DOMAIN = config.environment.variables.STUDIO_DOMAIN;
240 STUDIO_POOL = lib.attrByPath [ "STUDIO_POOL" ] "studio-demo" config.environment.variables;
241 STUDIO_NODE_NAME = config.networking.hostName;
242 STUDIO_MEDIA_READ_ONLY = lib.attrByPath [ "STUDIO_MEDIA_READ_ONLY" ] "false" config.environment.variables;
243 STUDIO_CLOVER_READ_ONLY = lib.attrByPath [ "STUDIO_CLOVER_READ_ONLY" ] "false" config.environment.variables;
224 systemd.services.snowglobe-dashboard = let
225 environment = (lib.filterAttrs (name: _: lib.hasPrefix "SNOWGLOBE_" name) config.environment.variables) // {
226 SNOWGLOBE_DATA_DIR = "/data";
227 SNOWGLOBE_PROXY_TOKEN_FILE = "/run/secrets/dashboard-proxy.token";
228 SNOWGLOBE_NOMAD_TOKEN_FILE = "/run/secrets/dashboard-nomad.token";
229 SNOWGLOBE_CA_BUNDLE = "/run/secrets/ca-bundle.crt";
230 SNOWGLOBE_INDEX_DIR = "/data/index";
231 SNOWGLOBE_INTERNAL_URL = "https://dashboard.internal.${config.environment.variables.SNOWGLOBE_DOMAIN}:${toString internalPort}";
232 SNOWGLOBE_FILES_URL = "https://file.${config.environment.variables.SNOWGLOBE_DOMAIN}";
233 SNOWGLOBE_AUTH_REQUIRED = "1";
234 SNOWGLOBE_AUTH_RP_ID = "auth.${config.environment.variables.SNOWGLOBE_DOMAIN}";
235 SNOWGLOBE_FILE_ORIGIN = "https://file.${config.environment.variables.SNOWGLOBE_DOMAIN}";
236 SNOWGLOBE_PUBLIC_ORIGIN = "https://snowglobe.${config.environment.variables.SNOWGLOBE_DOMAIN}";
237 SNOWGLOBE_JELLYFIN_URL = "https://jelly.${config.environment.variables.SNOWGLOBE_DOMAIN}";
238 SNOWGLOBE_SHALE_URL = "https://shale.${config.environment.variables.SNOWGLOBE_DOMAIN}";
239 SNOWGLOBE_PUBLISHED_ROOT = "/srv/clover/Published";
240 SNOWGLOBE_DOMAIN = config.environment.variables.SNOWGLOBE_DOMAIN;
241 SNOWGLOBE_POOL = lib.attrByPath [ "SNOWGLOBE_POOL" ] "snowglobe-demo" config.environment.variables;
242 SNOWGLOBE_NODE_NAME = config.networking.hostName;
243 SNOWGLOBE_MEDIA_READ_ONLY = lib.attrByPath [ "SNOWGLOBE_MEDIA_READ_ONLY" ] "false" config.environment.variables;
244 SNOWGLOBE_CLOVER_READ_ONLY = lib.attrByPath [ "SNOWGLOBE_CLOVER_READ_ONLY" ] "false" config.environment.variables;
244245 };
245246 in {
246247 inherit environment;
247248 wantedBy = [ "multi-user.target" ];
248 wants = [ "nomad.service" "studio-router.service" "studio-host.service" "studio-vm-screen.service" ];
249 after = [ "nomad.service" "studio-host.service" "studio-vm-screen.service" ];
250 unitConfig.ConditionPathExists = [ "/var/lib/studio/dashboard.token" "/var/lib/studio/ca-bundle.crt" "/opt/studio/current" ];
249 wants = [ "nomad.service" "snowglobe-router.service" "snowglobe-host.service" "snowglobe-vm-screen.service" ];
250 after = [ "nomad.service" "snowglobe-host.service" "snowglobe-vm-screen.service" ];
251 unitConfig.ConditionPathExists = [ "/var/lib/snowglobe/dashboard.token" "/var/lib/snowglobe/ca-bundle.crt" "/opt/snowglobe/current" ];
251252 path = [ pkgs.podman pkgs.coreutils pkgs.curl pkgs.openssl pkgs.systemd ];
252253 serviceConfig = {
253254 Type = "notify";
254255 NotifyAccess = "all";
255 ExecStart = pkgs.writeShellScript "studio-dashboard-start" ''
256 uid=$(id -u studio-dashboard)
257 gid=$(id -g studio-dashboard)
256 ExecStart = pkgs.writeShellScript "snowglobe-dashboard-start" ''
257 uid=$(id -u snowglobe-dashboard)
258 gid=$(id -g snowglobe-dashboard)
258259 optional=()
259260 if test -d /srv/prod/ytdl/data && test -d '/srv/clover/Documents/Config/Youtube Downloader'; then
260261 optional+=(--volume=/srv/prod/ytdl/data:/srv/prod/ytdl/data:rw
261 --env=STUDIO_YT_STATE=/srv/prod/ytdl/data
262 '--env=STUDIO_YT_CONFIG=/srv/clover/Documents/Config/Youtube Downloader'
263 --env=STUDIO_YT_MEDIA=/srv/clover/Media)
262 --env=SNOWGLOBE_YT_STATE=/srv/prod/ytdl/data
263 '--env=SNOWGLOBE_YT_CONFIG=/srv/clover/Documents/Config/Youtube Downloader'
264 --env=SNOWGLOBE_YT_MEDIA=/srv/clover/Media)
264265 fi
265 exec podman run --rm --replace --name=studio-dashboard --pull=never \
266 exec podman run --rm --replace --name=snowglobe-dashboard --pull=never \
266267 --sdnotify=conmon --cgroups=no-conmon --log-driver=journald \
267268 --user="$uid:$gid" \
268269 --group-add=${toString config.users.groups.chloe.gid} --network=podman \
......@@ -272,20 +273,20 @@ in
272273 --tmpfs=/tmp:rw,noexec,nosuid,nodev,size=256m,mode=1777 \
273274 --tmpfs=/run:rw,noexec,nosuid,nodev,size=16m,mode=755 \
274275 --env=HOME=/data --env=XDG_CACHE_HOME=/data/cache \
275 --volume=/var/lib/studio/dashboard:/data:rw \
276 --volume=/run/studio-host:/run/studio-host:ro \
277 --volume=/run/studio-vm-screen:/run/studio-vm-screen:ro \
276 --volume=/var/lib/snowglobe/dashboard:/data:rw \
277 --volume=/run/snowglobe-host:/run/snowglobe-host:ro \
278 --volume=/run/snowglobe-vm-screen:/run/snowglobe-vm-screen:ro \
278279 --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/studio/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/Media,dst=/srv/clover/Media,bind-nonrecursive,bind-propagation=rslave,ro="$STUDIO_MEDIA_READ_ONLY" \
280 --volume=/var/lib/snowglobe/dashboard.token:/run/secrets/dashboard-nomad.token:ro \
281 --volume=/var/lib/snowglobe/ca-bundle.crt:/run/secrets/ca-bundle.crt:ro \
282 --mount=type=bind,src=/srv/clover,dst=/srv/clover,bind-nonrecursive,bind-propagation=rslave,ro="$SNOWGLOBE_CLOVER_READ_ONLY" \
283 --mount=type=bind,src=/srv/clover/Media,dst=/srv/clover/Media,bind-nonrecursive,bind-propagation=rslave,ro="$SNOWGLOBE_MEDIA_READ_ONLY" \
283284 ${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" ]} \
285286 "''${optional[@]}" ${lib.escapeShellArg "${dashboard.image.imageName}:${dashboard.image.imageTag}"}
286287 '';
287 ExecStop = "${pkgs.podman}/bin/podman stop --ignore --time=8 studio-dashboard";
288 ExecStopPost = "${pkgs.podman}/bin/podman rm --ignore --force studio-dashboard";
288 ExecStop = "${pkgs.podman}/bin/podman stop --ignore --time=8 snowglobe-dashboard";
289 ExecStopPost = "${pkgs.podman}/bin/podman rm --ignore --force snowglobe-dashboard";
289290 CPUWeight = 1000;
290291 KillMode = "mixed";
291292 TimeoutStartSec = 180;
......@@ -299,9 +300,9 @@ in
299300 openssl rand -hex 32 > ${proxyToken}.pending
300301 mv ${proxyToken}.pending ${proxyToken}
301302 fi
302 chown root:studio-dashboard ${proxyToken} /var/lib/studio/dashboard.token
303 chmod 0640 ${proxyToken} /var/lib/studio/dashboard.token
304 chown -R studio-dashboard:studio-dashboard /var/lib/studio/dashboard
303 chown root:snowglobe-dashboard ${proxyToken} /var/lib/snowglobe/dashboard.token
304 chmod 0640 ${proxyToken} /var/lib/snowglobe/dashboard.token
305 chown -R snowglobe-dashboard:snowglobe-dashboard /var/lib/snowglobe/dashboard
305306 systemd-tmpfiles --create --prefix=/srv/prod/ytdl/data
306307 if ! podman image exists ${lib.escapeShellArg "${dashboard.image.imageName}:${dashboard.image.imageTag}"}; then
307308 podman load --quiet --input ${dashboard.image}
......@@ -309,7 +310,7 @@ in
309310 '';
310311 postStart = ''
311312 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
313314 exit 0
314315 fi
315316 sleep 1
......@@ -325,20 +326,20 @@ in
325326 "d /srv/vm 0755 root root -"
326327 "d /srv/logs 0770 clo chloe -"
327328 "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/studio/dashboard 0700 studio-dashboard studio-dashboard -"
330 "d /var/lib/studio/routes 0700 root root -"
331 "d /var/lib/caddy/studio 0755 caddy caddy -"
329 "d /var/lib/snowglobe 0700 root root -"
330 "d /var/lib/snowglobe/dashboard 0700 snowglobe-dashboard snowglobe-dashboard -"
331 "d /var/lib/snowglobe/routes 0700 root root -"
332 "d /var/lib/caddy/snowglobe 0755 caddy caddy -"
332333 "f /var/lib/caddy/routes.caddy 0640 caddy caddy -"
333334 "d /var/lib/swtpm-localca 0750 tss tss -"
334335 ];
335336
336 environment.variables.STUDIO_NODE_NAME = config.networking.hostName;
337 environment.variables.STUDIO_DOMAIN = lib.mkDefault "studio.test";
338 environment.variables.STUDIO_VM_SECURE_OVMF_CODE = secureOvmf.firmware;
339 environment.variables.STUDIO_VM_SECURE_OVMF_VARS = secureOvmf.variablesMs;
340 environment.variables.STUDIO_VM_SECURE_AAVMF_CODE = "${secureAavmf}/code.fd";
341 environment.variables.STUDIO_VM_SECURE_AAVMF_VARS = "${secureAavmf}/vars.fd";
342 environment.variables.STUDIO_VM_WINDOWS_ARM_EMULATOR = "${windowsArmQemu}/bin/qemu-system-aarch64";
337 environment.variables.SNOWGLOBE_NODE_NAME = config.networking.hostName;
338 environment.variables.SNOWGLOBE_DOMAIN = lib.mkDefault "snowglobe.test";
339 environment.variables.SNOWGLOBE_VM_SECURE_OVMF_CODE = secureOvmf.firmware;
340 environment.variables.SNOWGLOBE_VM_SECURE_OVMF_VARS = secureOvmf.variablesMs;
341 environment.variables.SNOWGLOBE_VM_SECURE_AAVMF_CODE = "${secureAavmf}/code.fd";
342 environment.variables.SNOWGLOBE_VM_SECURE_AAVMF_VARS = "${secureAavmf}/vars.fd";
343 environment.variables.SNOWGLOBE_VM_WINDOWS_ARM_EMULATOR = "${windowsArmQemu}/bin/qemu-system-aarch64";
343344 environment.systemPackages = with pkgs; [ acl curl jq openssl python3 rsync zfs qemu ] ++ [ nativePkl ];
344345}
nixos/dashboard.nix+6-8
......@@ -6,9 +6,7 @@ let
66 root = ../.;
77 fileset = lib.fileset.unions [
88 ../config
9 (lib.fileset.difference ../service (lib.fileset.unions
10 (builtins.filter builtins.pathExists (map (name: ../service + "/${name}")
11 (builtins.fromJSON (builtins.readFile ../config/excluded-services.json))))))
9 ../service
1210 ];
1311 };
1412 web = stdenv.mkDerivation (finalAttrs: {
......@@ -49,17 +47,17 @@ let
4947 };
5048 dashboard = runCommand "home-dashboard-0.1.0" {
5149 passthru.image = dockerTools.buildLayeredImage {
52 name = "studio-dashboard";
50 name = "snowglobe-dashboard";
5351 contents = [ dashboard coreutils nativePkl youtubePython yt-dlp ffmpeg dockerTools.caCertificates ];
5452 config = {
5553 User = "65534:65534";
5654 Cmd = [ "${dashboard}/bin/home-dashboard" ];
5755 WorkingDir = "${dashboard}/lib/home-dashboard";
5856 Env = [
59 "STUDIO_LISTEN_ADDRESS=0.0.0.0" "PORT=7072"
60 "STUDIO_PROXY_TOKEN_FILE=/run/secrets/dashboard-proxy.token"
61 "STUDIO_REPO=${source}"
62 "STUDIO_YT_PYTHON=${youtubePython}/bin/python3"
57 "SNOWGLOBE_LISTEN_ADDRESS=0.0.0.0" "PORT=7072"
58 "SNOWGLOBE_PROXY_TOKEN_FILE=/run/secrets/dashboard-proxy.token"
59 "SNOWGLOBE_REPO=${source}"
60 "SNOWGLOBE_YT_PYTHON=${youtubePython}/bin/python3"
6361 "PATH=${lib.makeBinPath [ coreutils nativePkl youtubePython yt-dlp ffmpeg ]}"
6462 ];
6563 };
nixos/snowglobe-network.nix created+10
......@@ -0,0 +1,10 @@
1{
2 networking.useDHCP = false;
3 networking.interfaces.enp4s0.useDHCP = false;
4 networking.interfaces.enp4s0.ipv4.addresses = [
5 { address = "10.0.0.1"; prefixLength = 24; }
6 { address = "192.168.0.1"; prefixLength = 24; }
7 ];
8 networking.defaultGateway = { address = "10.0.0.2"; interface = "enp4s0"; };
9 networking.nameservers = [ "1.1.1.1" "1.0.0.1" ];
10}
nixos/snowglobe.nix created+102
......@@ -0,0 +1,102 @@
1{ config, lib, pkgs, ... }:
2let
3 adminKey = lib.fileContents ../config/admin.pub;
4 pool = "globe";
5 xmppNetwork = builtins.fromJSON (builtins.readFile ../service/xmpp/network.json);
6 xmppTCPPorts = map (name: xmppNetwork.${name}) [ "c2s" "c2s_tls" "s2s" "turn" "turn_tls" ];
7 xmppUDPPorts = [ xmppNetwork.turn xmppNetwork.turn_tls ];
8 encryptionRoots = {
9 apps = "apps";
10 clover = "clover";
11 media = "clover/Media";
12 logs = "logs";
13 prod = "prod";
14 staging = "staging";
15 };
16in
17{
18 imports = [ ./snowglobe-network.nix ];
19
20 networking.hostName = "snowglobe";
21 environment.etc."machine-info".text = ''
22 PRETTY_HOSTNAME="snow globe"
23 '';
24 networking.hostId = "4fa19ccb";
25 services.nomad.settings.name = config.networking.hostName;
26 networking.firewall.allowedTCPPorts = [ 80 443 ] ++ xmppTCPPorts;
27 networking.firewall.allowedUDPPorts = xmppUDPPorts;
28 networking.firewall.allowedUDPPortRanges = [{ from = xmppNetwork.relay_first; to = xmppNetwork.relay_last; }];
29 networking.firewall.interfaces.enp4s0.allowedTCPPorts = [ 445 ];
30
31 systemd.services.xmpp-nat = {
32 wantedBy = [ "multi-user.target" ];
33 wants = [ "network-online.target" ];
34 after = [ "network-online.target" ];
35 startAt = "*:0/5";
36 serviceConfig = { Type = "oneshot"; DynamicUser = true; };
37 script = ''
38 ${pkgs.miniupnpc}/bin/upnpc -u http://${config.networking.defaultGateway.address}:1900/whaoc/rootDesc.xml -e "Snow Globe XMPP" -r \
39 ${lib.concatMapStringsSep " " (port: "${toString port} TCP") xmppTCPPorts} \
40 ${lib.concatMapStringsSep " " (port: "${toString port} UDP") (xmppUDPPorts ++ lib.range xmppNetwork.relay_first xmppNetwork.relay_last)}
41 '';
42 };
43
44 boot.loader.systemd-boot.enable = true;
45 boot.loader.efi.canTouchEfiVariables = true;
46 boot.zfs.forceImportRoot = false;
47 boot.zfs.extraPools = [ pool ];
48 boot.zfs.requestEncryptionCredentials = false;
49 security.tpm2.enable = true;
50
51 systemd.services.snowglobe-zfs-unlock = {
52 requires = [ "zfs-import-${pool}.service" "dev-tpmrm0.device" ];
53 after = [ "zfs-import-${pool}.service" "dev-tpmrm0.device" ];
54 before = [ "zfs-mount.service" ];
55 requiredBy = [ "zfs-mount.service" ];
56 unitConfig.DefaultDependencies = false;
57 serviceConfig = {
58 Type = "oneshot";
59 RemainAfterExit = true;
60 LoadCredentialEncrypted = lib.mapAttrsToList
61 (name: _: "zfs-${name}:/etc/credstore.encrypted/zfs-${name}") encryptionRoots;
62 };
63 script = lib.concatStrings (lib.mapAttrsToList (name: dataset: ''
64 if test "$(${pkgs.zfs}/bin/zfs get -H -o value keystatus ${pool}/${dataset})" = unavailable; then
65 ${pkgs.zfs}/bin/zfs load-key -L "file://$CREDENTIALS_DIRECTORY/zfs-${name}" ${pool}/${dataset}
66 fi
67 '') encryptionRoots);
68 };
69
70 services.xserver.videoDrivers = [ "nvidia" ];
71 hardware.graphics.enable = true;
72 hardware.nvidia.open = false;
73 hardware.nvidia.nvidiaPersistenced = true;
74 hardware.nvidia.nvidiaSettings = false;
75
76 systemd.services.nomad = {
77 requires = [ "zfs-import-${pool}.service" ];
78 after = [ "zfs-import-${pool}.service" "zfs-mount.service" ];
79 preStart = ''
80 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv)" = ${pool}
81 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/clover)" = ${pool}/clover
82 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/clover/Media)" = ${pool}/clover/Media
83 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/prod)" = ${pool}/prod
84 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/staging)" = ${pool}/staging
85 '';
86 };
87
88 users.groups.chloe.gid = 3000;
89 users.users.root.openssh.authorizedKeys.keys = [ adminKey ];
90 users.users.clo = {
91 isNormalUser = true;
92 uid = 3000;
93 group = "chloe";
94 extraGroups = [ "wheel" ];
95 openssh.authorizedKeys.keys = [ adminKey ];
96 };
97 environment.variables.SNOWGLOBE_POOL = pool;
98 environment.variables.SNOWGLOBE_DOMAIN = "paperclover.net";
99 environment.variables.SNOWGLOBE_LOCAL_AI = "true";
100
101 system.stateVersion = "26.05";
102}
nixos/vm.nix+33-33
......@@ -1,16 +1,16 @@
11{ lib, pkgs, ... }:
22{
3 networking.hostName = "clover-demo";
3 networking.hostName = "snowglobe-rehearsal";
44 networking.hostId = "d3c10e01";
55 networking.useDHCP = true;
66 networking.dhcpcd.denyInterfaces = [ "veth*" "podman*" ];
7 environment.variables.STUDIO_JAVA_OPTIONS = "-XX:TieredStopAtLevel=1";
8 environment.variables.STUDIO_INDEX_POOL = "studio-demo";
9 environment.variables.STUDIO_API_TIMEOUT = "600";
10 environment.variables.STUDIO_MEDIA_READ_ONLY = "true";
11 environment.variables.STUDIO_VM_ACCEL = "qemu";
12 environment.variables.STUDIO_VM_PRESETS_ROOT = "/srv/vm/.library/presets";
13 environment.variables.STUDIO_VM_UPLOADS_ROOT = "/srv/vm/.library/iso";
7 environment.variables.SNOWGLOBE_JAVA_OPTIONS = "-XX:TieredStopAtLevel=1";
8 environment.variables.SNOWGLOBE_INDEX_POOL = "snowglobe-demo";
9 environment.variables.SNOWGLOBE_API_TIMEOUT = "600";
10 environment.variables.SNOWGLOBE_MEDIA_READ_ONLY = "true";
11 environment.variables.SNOWGLOBE_VM_ACCEL = "qemu";
12 environment.variables.SNOWGLOBE_VM_PRESETS_ROOT = "/srv/vm/.library/presets";
13 environment.variables.SNOWGLOBE_VM_UPLOADS_ROOT = "/srv/vm/.library/iso";
1414 services.nomad.settings.client.cpu_total_compute = 16000;
1515 services.nomad.settings.client.preferred_address_family = "ipv4";
1616 services.nomad.settings.plugin.nomad-driver-podman.config.client_http_timeout = "10m";
......@@ -30,10 +30,10 @@
3030 settings = {
3131 interface = "tailscale0";
3232 bind-dynamic = true;
33 address = "/studio.test/100.95.50.31";
33 address = "/snowglobe.test/100.95.50.31";
3434 };
3535 };
36 services.caddy.virtualHosts."*.studio.test".extraConfig = ''
36 services.caddy.virtualHosts."*.snowglobe.test".extraConfig = ''
3737 tls internal
3838 respond 404
3939 '';
......@@ -54,35 +54,35 @@
5454 };
5555 services.getty.autologinUser = "root";
5656 users.groups.chloe.gid = 3000;
57 systemd.services.studio-demo-pool = {
57 systemd.services.snowglobe-demo-pool = {
5858 wantedBy = [ "multi-user.target" ];
59 before = [ "studio-media-view.service" "nomad.service" ];
59 before = [ "snowglobe-media-view.service" "nomad.service" ];
6060 serviceConfig.Type = "oneshot";
6161 script = ''
62 ${pkgs.coreutils}/bin/mkdir -p /var/lib/studio /srv/clover
63 if ! ${pkgs.zfs}/bin/zpool list studio-demo >/dev/null 2>&1; then
64 if test -e /var/lib/studio/zpool.img; then
65 ${pkgs.zfs}/bin/zpool import -d /var/lib/studio studio-demo
62 ${pkgs.coreutils}/bin/mkdir -p /var/lib/snowglobe /srv/clover
63 if ! ${pkgs.zfs}/bin/zpool list snowglobe-demo >/dev/null 2>&1; then
64 if test -e /var/lib/snowglobe/zpool.img; then
65 ${pkgs.zfs}/bin/zpool import -d /var/lib/snowglobe snowglobe-demo
6666 else
67 ${pkgs.coreutils}/bin/truncate -s 16G /var/lib/studio/zpool.img
68 ${pkgs.zfs}/bin/zpool create -f -o ashift=12 -O mountpoint=none studio-demo /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 snowglobe-demo /var/lib/snowglobe/zpool.img
6969 fi
7070 fi
71 if test "$(${pkgs.coreutils}/bin/stat -c %s /var/lib/studio/zpool.img)" -lt 17179869184; then
72 ${pkgs.coreutils}/bin/truncate -s 16G /var/lib/studio/zpool.img
73 ${pkgs.zfs}/bin/zpool online -e studio-demo /var/lib/studio/zpool.img
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/snowglobe/zpool.img
73 ${pkgs.zfs}/bin/zpool online -e snowglobe-demo /var/lib/snowglobe/zpool.img
7474 fi
75 if ! ${pkgs.zfs}/bin/zfs list studio-demo/clover >/dev/null 2>&1; then
76 ${pkgs.zfs}/bin/zfs create -o mountpoint=/srv/clover -o acltype=posixacl studio-demo/clover
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 snowglobe-demo/clover
7777 fi
78 test "$(${pkgs.zfs}/bin/zfs get -H -o value mountpoint studio-demo/clover)" = /srv/clover
79 ${pkgs.zfs}/bin/zfs mount studio-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
78 test "$(${pkgs.zfs}/bin/zfs get -H -o value mountpoint snowglobe-demo/clover)" = /srv/clover
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 snowglobe-demo/clover
8181 ${pkgs.coreutils}/bin/chown 3000:3000 /srv/clover
8282 ${pkgs.coreutils}/bin/chmod 2770 /srv/clover
8383 '';
8484 };
85 systemd.services.studio-media-source = {
85 systemd.services.snowglobe-media-source = {
8686 serviceConfig = {
8787 Type = "oneshot";
8888 RemainAfterExit = true;
......@@ -103,9 +103,9 @@
103103 exit 1
104104 '';
105105 };
106 systemd.services.studio-media-view = {
107 after = [ "studio-demo-pool.service" "studio-media-source.service" ];
108 requires = [ "studio-demo-pool.service" "studio-media-source.service" ];
106 systemd.services.snowglobe-media-view = {
107 after = [ "snowglobe-demo-pool.service" "snowglobe-media-source.service" ];
108 requires = [ "snowglobe-demo-pool.service" "snowglobe-media-source.service" ];
109109 serviceConfig = {
110110 Type = "oneshot";
111111 RemainAfterExit = true;
......@@ -116,9 +116,9 @@
116116 };
117117 };
118118 systemd.services.nomad = {
119 wants = [ "studio-demo-pool.service" ];
120 requires = [ "studio-media-view.service" ];
121 after = [ "studio-demo-pool.service" "studio-media-view.service" ];
119 wants = [ "snowglobe-demo-pool.service" ];
120 requires = [ "snowglobe-media-view.service" ];
121 after = [ "snowglobe-demo-pool.service" "snowglobe-media-view.service" ];
122122 };
123123
124124 system.stateVersion = "26.05";
nixos/zenith-network.nix deleted-10
......@@ -1,10 +0,0 @@
1{
2 networking.useDHCP = false;
3 networking.interfaces.enp4s0.useDHCP = false;
4 networking.interfaces.enp4s0.ipv4.addresses = [
5 { address = "10.0.0.1"; prefixLength = 24; }
6 { address = "192.168.0.1"; prefixLength = 24; }
7 ];
8 networking.defaultGateway = { address = "10.0.0.2"; interface = "enp4s0"; };
9 networking.nameservers = [ "1.1.1.1" "1.0.0.1" ];
10}
nixos/zenith.nix deleted-98
......@@ -1,98 +0,0 @@
1{ config, lib, pkgs, ... }:
2let
3 adminKey = lib.fileContents ../config/admin.pub;
4 pool = "globe";
5 xmppNetwork = builtins.fromJSON (builtins.readFile ../service/xmpp/network.json);
6 xmppTCPPorts = map (name: xmppNetwork.${name}) [ "c2s" "c2s_tls" "s2s" "turn" "turn_tls" ];
7 xmppUDPPorts = [ xmppNetwork.turn xmppNetwork.turn_tls ];
8 encryptionRoots = {
9 apps = "apps";
10 clover = "clover";
11 media = "clover/Media";
12 logs = "logs";
13 prod = "prod";
14 staging = "staging";
15 };
16in
17{
18 imports = [ ./zenith-network.nix ];
19
20 networking.hostName = "zenith";
21 networking.hostId = "4fa19ccb";
22 networking.firewall.allowedTCPPorts = [ 80 443 ] ++ xmppTCPPorts;
23 networking.firewall.allowedUDPPorts = xmppUDPPorts;
24 networking.firewall.allowedUDPPortRanges = [{ from = xmppNetwork.relay_first; to = xmppNetwork.relay_last; }];
25 networking.firewall.interfaces.enp4s0.allowedTCPPorts = [ 445 ];
26
27 systemd.services.xmpp-nat = {
28 wantedBy = [ "multi-user.target" ];
29 wants = [ "network-online.target" ];
30 after = [ "network-online.target" ];
31 startAt = "*:0/5";
32 serviceConfig = { Type = "oneshot"; DynamicUser = true; };
33 script = ''
34 ${pkgs.miniupnpc}/bin/upnpc -u http://${config.networking.defaultGateway.address}:1900/whaoc/rootDesc.xml -e "Snow Globe XMPP" -r \
35 ${lib.concatMapStringsSep " " (port: "${toString port} TCP") xmppTCPPorts} \
36 ${lib.concatMapStringsSep " " (port: "${toString port} UDP") (xmppUDPPorts ++ lib.range xmppNetwork.relay_first xmppNetwork.relay_last)}
37 '';
38 };
39
40 boot.loader.systemd-boot.enable = true;
41 boot.loader.efi.canTouchEfiVariables = true;
42 boot.zfs.forceImportRoot = false;
43 boot.zfs.extraPools = [ pool ];
44 boot.zfs.requestEncryptionCredentials = false;
45 security.tpm2.enable = true;
46
47 systemd.services.studio-zfs-unlock = {
48 requires = [ "zfs-import-${pool}.service" "dev-tpmrm0.device" ];
49 after = [ "zfs-import-${pool}.service" "dev-tpmrm0.device" ];
50 before = [ "zfs-mount.service" ];
51 requiredBy = [ "zfs-mount.service" ];
52 unitConfig.DefaultDependencies = false;
53 serviceConfig = {
54 Type = "oneshot";
55 RemainAfterExit = true;
56 LoadCredentialEncrypted = lib.mapAttrsToList
57 (name: _: "zfs-${name}:/etc/credstore.encrypted/zfs-${name}") encryptionRoots;
58 };
59 script = lib.concatStrings (lib.mapAttrsToList (name: dataset: ''
60 if test "$(${pkgs.zfs}/bin/zfs get -H -o value keystatus ${pool}/${dataset})" = unavailable; then
61 ${pkgs.zfs}/bin/zfs load-key -L "file://$CREDENTIALS_DIRECTORY/zfs-${name}" ${pool}/${dataset}
62 fi
63 '') encryptionRoots);
64 };
65
66 services.xserver.videoDrivers = [ "nvidia" ];
67 hardware.graphics.enable = true;
68 hardware.nvidia.open = false;
69 hardware.nvidia.nvidiaPersistenced = true;
70 hardware.nvidia.nvidiaSettings = false;
71
72 systemd.services.nomad = {
73 requires = [ "zfs-import-${pool}.service" ];
74 after = [ "zfs-import-${pool}.service" "zfs-mount.service" ];
75 preStart = ''
76 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv)" = ${pool}
77 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/clover)" = ${pool}/clover
78 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/clover/Media)" = ${pool}/clover/Media
79 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/prod)" = ${pool}/prod
80 test "$(${pkgs.util-linux}/bin/findmnt -n -o SOURCE --mountpoint /srv/staging)" = ${pool}/staging
81 '';
82 };
83
84 users.groups.chloe.gid = 3000;
85 users.users.root.openssh.authorizedKeys.keys = [ adminKey ];
86 users.users.clo = {
87 isNormalUser = true;
88 uid = 3000;
89 group = "chloe";
90 extraGroups = [ "wheel" ];
91 openssh.authorizedKeys.keys = [ adminKey ];
92 };
93 environment.variables.STUDIO_POOL = pool;
94 environment.variables.STUDIO_DOMAIN = "paperclover.net";
95 environment.variables.STUDIO_LOCAL_AI = "true";
96
97 system.stateVersion = "26.05";
98}
readme.md+33-12
......@@ -8,16 +8,36 @@ from Jellyfin and Navidrome for media consumption to git hosting and render
88farms.
99
1010The system is built out of a NixOS base (just to install the system itself),
11using managed docker containers (managed via Nomad) and virtual machines to run
12all the real services. There is a lot of custom tooling to spawn interactive
13testing environments. For example, without even pushing any code, I can edit the
14configuration of a service or upgrade it, then spin up an isolated domain like
15`shale-4c84f9da.staging.paperclover.net` to verify changes. Then, pushing to
16production ensures that the new deployment is healthy before routing traffic to
17it -- It's kind of like "easy kubernetes."
11using Podman containers scheduled by Nomad and virtual machines to run the
12services. Changes automatically get a staging deployment on Snow Globe for
13testing and review. Production promotion is a separate, explicit step.
1814
1915[paper clover]: https://paperclover.net
2016
17## change → preview → review
18
19The deployment tool defaults to Snow Globe at `root@10.0.0.1:22`.
20
21```sh
22python3 tools/deploy.py stage shale
23python3 tools/deploy.py stage dashboard
24```
25
26These upload working files and print the preview URL. Service previews use
27separate ZFS storage; the dashboard preview uses disposable accounts and files,
28with read-only observations of the real host. Test the app and keep its preview
29available for review. Repeating the command updates that preview.
30
31After approval, commit the reviewed changes on `main` and run
32`python3 tools/deploy.py prod`. The release workflow backs up state, activates
33the release, and checks production health. Single-writer services can have a
34brief interruption. Code rollback and data restore are separate operations.
35
36GPU AI changes are tested directly in production. VM integration uses disposable
37guests on the real machine. Most other work follows the preview workflow above;
38isolated host testing is documented in [tools/rehearsal.md](tools/rehearsal.md).
39The complete agent workflow is in [AGENTS.md](AGENTS.md).
40
2141## filesystem layout
2242
2343The computer mounts the ZFS root dataset under `/srv`, meaning "server," loosely
......@@ -29,7 +49,7 @@ srv/
2949 +--- Archive/<year> personal archive. one folder per year, scrambled within.
3050 +--- Asset/ resources, sample packs, audio plugins, stock videos
3151 +--- Blender/
32 +--- Font/ (moved from zenith Documents/Font, will be stable index)
52 +--- Font/
3353 +--- Samples/
3454 +--- Texture/
3555 +--- Video/
......@@ -52,7 +72,8 @@ srv/
5272 +--- clover-sandbox/ [dataset]
5373```
5474
55Media is it's own dataset so it can be snapshotted independently of my personal
56data (less frequent, lower retention), and all my personal files are on the same
57dataset to allow fast move/copying between top level folders. Services use their
58own datasets to implement copy-on-write forks.
75Media is its own dataset so it can be snapshotted independently of personal
76data. Personal files share a dataset to allow fast moves between top-level
77folders; services use separate datasets for copy-on-write previews. No automatic
78snapshot retention policy is configured. Hardware, encryption, permissions, and
79recovery boundaries are documented in [tools/snowglobe-hardware.md](tools/snowglobe-hardware.md).
service/clover-source-of-truth/service.pkl+3-2
......@@ -2,7 +2,8 @@ amends "../../config/Service.pkl"
22
33import "../../config/site.pkl" as site
44
5meta { name = "Clover DB"; launcher = false }
5name = "Clover DB"
6launcher = false
67
78local isTest = site.domain.endsWith(".test")
89
......@@ -31,6 +32,6 @@ container {
3132 ["CLOVER_FILE_DERIVED"] = "/data/derived"
3233 ["CLOVER_SOT_KEY"] = "${secret.own.key}"
3334 ["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"
3536 }
3637}
service/copyparty/copyparty.conf+2-2
......@@ -3,7 +3,7 @@
33 p: 3923
44 shr: /shr
55 hist: /cfg/hists
6 df: STUDIO_MIN_FREE_GB
6 df: SNOWGLOBE_MIN_FREE_GB
77 ver
88 theme: 2
99 name: clover's nas
......@@ -19,7 +19,7 @@
1919 auth-ord: pw,idp,ipu
2020 idp-h-usr: user-name
2121 idp-h-grp: user-groups
22 idp-h-key: STUDIO_IDP_HEADER
22 idp-h-key: SNOWGLOBE_IDP_HEADER
2323 idp-login: /auth/file/sign-in?rd={dst}
2424 idp-logout: /auth/file/sign-out
2525 idp-login-t: with snow globe
service/copyparty/manage.py+9-9
......@@ -165,7 +165,7 @@ def configuration(cfg, state, items, source=None):
165165 raise Error(503, 'Copyparty sign-in configuration is unavailable. Redeploy the service.')
166166 capacity = os.statvfs(cfg)
167167 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))
169169 return render(base, state, items).encode()
170170
171171
......@@ -196,11 +196,11 @@ def rename(source, destination):
196196
197197class Manager:
198198 def __init__(self, users):
199 root = Path(os.environ.get('STUDIO_ROOT', '/srv'))
200 self.root = Path(os.environ.get('STUDIO_CLOVER_ROOT', str(root / 'clover'))).resolve()
201 self.cfg = Path(os.environ.get('STUDIO_COPYPARTY_CFG', str(root / 'prod/copyparty/cfg')))
199 root = Path(os.environ.get('SNOWGLOBE_ROOT', '/srv'))
200 self.root = Path(os.environ.get('SNOWGLOBE_CLOVER_ROOT', str(root / 'clover'))).resolve()
201 self.cfg = Path(os.environ.get('SNOWGLOBE_COPYPARTY_CFG', str(root / 'prod/copyparty/cfg')))
202202 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')
204204 self.users = users
205205 self.path = self.cfg / 'manager.json'
206206 self.changed = set()
......@@ -280,7 +280,7 @@ class Manager:
280280 raise Error(503, 'Copyparty address is unavailable. Redeploy its service.')
281281 address = '[' + address + ']' if ':' in address else address
282282 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',
284284 })
285285 try:
286286 with urllib.request.urlopen(request, timeout=remaining(deadline, 30)) as response:
......@@ -340,7 +340,7 @@ class Manager:
340340 if virtual == 'clover' or virtual.startswith('clover/'):
341341 return self.root / virtual[len('clover'):].lstrip('/')
342342 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')))
344344 return media / virtual[len('media'):].lstrip('/')
345345 return None
346346
......@@ -573,9 +573,9 @@ class Manager:
573573
574574 def apply(self, action, payload):
575575 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')))
577577 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)))
579579 if origin != self.root:
580580 for grant in self.data['grants']:
581581 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(
2020items = variable['Items']
2121state_path = cfg / 'manager.json'
2222state = json.loads(state_path.read_text()) if state_path.exists() else {'accounts': [], 'grants': [], 'names': {}}
23canonical_root = Path(os.environ.get('STUDIO_CLOVER_ROOT', str(Path(os.environ.get('STUDIO_ROOT', '/srv')) / 'clover')))
23canonical_root = Path(os.environ.get('SNOWGLOBE_CLOVER_ROOT', str(Path(os.environ.get('SNOWGLOBE_ROOT', '/srv')) / 'clover')))
2424origin = Path(state.get('root', str(canonical_root)))
2525if origin != canonical_root:
2626 for grant in state['grants']:
service/copyparty/service.pkl+1-4
......@@ -2,8 +2,7 @@ amends "../../config/Service.pkl"
22
33import "../../config/site.pkl" as site
44
5meta { name = "Copyparty" }
6rollout = "simple"
5name = "Copyparty"
76prepare = "prepare.py"
87
98secrets {
......@@ -12,8 +11,6 @@ secrets {
1211
1312container {
1413 image = "docker.io/copyparty/ac@sha256:9658d60c7fec0bffb968cacc677712be3c8a6e73bb388b6b47b7f2b178a754a6"
15 cpu = 200
16 memory = 512
1714
1815 http {
1916 containerPort = 3923
service/dawarich/redis-insight.pkl+1-2
......@@ -1,6 +1,6 @@
11amends "../../config/Service.pkl"
22
3meta { name = "Redis Insight" }
3name = "Redis Insight"
44dependsOn { "dawarich" }
55
66secrets {
......@@ -10,7 +10,6 @@ secrets {
1010container {
1111 image = "docker.io/redis/redisinsight@sha256:0131987fd5fefe3828ed33666f9742bd071b729f5a95cf923c593c14a8995c2c"
1212 cpu = 150
13 memory = 512
1413
1514 http {
1615 containerPort = 5540
service/dawarich/service.pkl+4-6
......@@ -32,7 +32,7 @@ local sharedVolumes: Mapping<String, service.Volume> = new {
3232 ["/var/app/storage"] {}
3333 ["/var/app/tmp/imports/watched"] {}
3434 ["/etc/ssl/certs/ca-certificates.crt"] {
35 src = "/var/lib/studio/ca-bundle.crt"
35 src = "/var/lib/snowglobe/ca-bundle.crt"
3636 readOnly = true
3737 }
3838}
......@@ -43,14 +43,15 @@ local databaseEnv = """
4343 {{ range nomadService 1 (env "NOMAD_ALLOC_ID") "\(module.id)-redis" }}REDIS_URL=redis://\(module.nomadHostPort){{ end }}
4444 """
4545
46meta { name = "Dawarich"; access = "infra-admin" }
46name = "Dawarich"
47access = "infra-admin"
4748healthyDeadline = "20m"
4849
4950requirements {
5051 database
5152 new sso.Client {
5253 clientId = module.id
53 name = module.meta.name
54 name = module.name
5455 redirectUris { "https://\(module.containers["web"].http.hostname)/users/auth/openid_connect/callback" }
5556 }
5657}
......@@ -66,7 +67,6 @@ containers {
6667 args { "ruby"; "-e"; "exit 0" }
6768 imageUser = true
6869 lifecycle = "prestart"
69 cpu = 200
7070 memory = 1024
7171 volumes = sharedVolumes
7272 env = commonEnv
......@@ -75,7 +75,6 @@ containers {
7575
7676 ["web"] {
7777 image = dawarichImage
78 extraHosts { "\(sso.hostname):host-gateway" }
7978 entrypoint = "web-entrypoint.sh"
8079 args { "bin/rails"; "server"; "-p"; "3000"; "-b"; "::" }
8180 imageUser = true
......@@ -107,7 +106,6 @@ containers {
107106 entrypoint = "sidekiq-entrypoint.sh"
108107 args { "sidekiq" }
109108 imageUser = true
110 cpu = 200
111109 memory = 1024
112110 volumes = sharedVolumes
113111 env = (commonEnv) {
service/ddns-updater/service.pkl+1-1
......@@ -16,7 +16,7 @@ class DnsCredentials extends service.Requirement {
1616 srv: Listing<SrvRecord> = new {}
1717}
1818
19meta { name = "DDNS" }
19name = "DDNS"
2020provide = "provide.py"
2121enabled = !site.preview && !site.domain.endsWith(".test")
2222
service/evil-forgejo/api.py deleted-33
......@@ -1,33 +0,0 @@
1import json
2import os
3import subprocess
4import urllib.request
5
6
7def nomad(path):
8 request = urllib.request.Request(
9 "http://127.0.0.1:4646/v1/" + path,
10 headers={"X-Nomad-Token": os.environ["NOMAD_TOKEN"]},
11 )
12 with urllib.request.urlopen(request, timeout=5) as response:
13 return json.load(response)
14
15
16def instance(job="evil-forgejo"):
17 running = [item["ID"] for item in nomad(f"job/{job}/allocations")
18 if item["ClientStatus"] == "running" and item["DesiredStatus"] == "run"]
19 if len(running) != 1:
20 raise ValueError(f"{job} needs one running allocation")
21 allocation = running[0]
22 services = [item for item in nomad(f"service/{job}-forgejo") if item["AllocID"] == allocation]
23 if len(services) != 1:
24 raise ValueError(f"{job} has no Forgejo listener")
25 result = subprocess.run(
26 ["podman", "--url", "unix:///run/podman/podman.sock", "ps", "--format", "{{.ID}} {{.Names}}"],
27 check=True, capture_output=True, text=True,
28 )
29 containers = [parts[0] for line in result.stdout.splitlines()
30 if len(parts := line.split()) == 2 and parts[1] == "forgejo-" + allocation]
31 if len(containers) != 1:
32 raise ValueError(f"{job} Forgejo task is unavailable")
33 return containers[0], f"http://{services[0]['Address']}:{services[0]['Port']}"
service/evil-forgejo/app.ini deleted-115
......@@ -1,115 +0,0 @@
1APP_NAME="evil inc"
2APP_SLOGAL="be evil. take control back."
3RUN_MODE=prod
4RUN_USER=git
5WORK_PATH=/data/work
6
7[repository]
8MAX_CREATION_LIMIT=20000
9ROOT=/data/git/repositories
10DEFAULT_CLOSE_ISSUES_VIA_COMMITS_IN_ANY_BRANCH=true
11DEFAULT_REPO_UNITS=repo.code,repo.issues,repo.pulls
12DISABLE_STARS=true
13DEFAULT_BRANCH=master
14
15[repository.local]
16LOCAL_COPY_PATH=/data/work/tmp/local-repo
17
18[repository.upload]
19TEMP_PATH=/data/work/uploads
20
21[ui]
22EXPLORE_PAGING_NUM=100
23ISSUE_PAGING_NUM=500
24MEMBERS_PAGING_NUM=100
25THEMES=evil,evil-dark,evil-light
26DEFAULT_THEME=evil
27
28[server]
29APP_DATA_PATH=/data/work
30DOMAIN=$GIT_HOST
31SSH_DOMAIN=$GIT_HOST
32HTTP_ADDR=0.0.0.0
33HTTP_PORT=$FORGEJO_HTTP_PORT
34ROOT_URL=https://$GIT_HOST/
35LFS_JWT_SECRET=$FORGEJO_SERVER_LFS_JWT_SECRET
36LFS_START_SERVER=true
37OFFLINE_MODE=true
38LANDING_PAGE=/evil
39START_SSH_SERVER=false
40SSH_CREATE_AUTHORIZED_KEYS_FILE=false
41
42[database]
43DB_TYPE=postgres
44HOST=$DB_HOST
45NAME=$DB_NAME
46USER=$DB_USER
47PASSWD=$DB_PASSWORD
48LOG_SQL=false
49SCHEMA=
50SSL_MODE=disable
51
52[indexer]
53ISSUE_INDEXER_PATH=/data/work/indexers/issues.bleve
54
55[session]
56PROVIDER_CONFIG=/data/work/sessions
57PROVIDER=file
58
59[picture]
60AVATAR_UPLOAD_PATH=/data/work/avatars
61REPOSITORY_AVATAR_UPLOAD_PATH=/data/work/repo-avatars
62
63[admin]
64DISABLE_REGULAR_ORG_CREATION=true
65
66[attachment]
67PATH=/data/work/attachments
68
69[log]
70MODE=console
71LEVEL=info
72ROOT_PATH=/data/work/log
73
74[security]
75INSTALL_LOCK=true
76REVERSE_PROXY_LIMIT=1
77REVERSE_PROXY_TRUSTED_PROXIES=*
78PASSWORD_HASH_ALGO=pbkdf2_hi
79SECRET_KEY=$FORGEJO_SECURITY_SECRET_KEY
80INTERNAL_TOKEN=$FORGEJO_SECURITY_INTERNAL_TOKEN
81
82[service]
83ENABLE_INTERNAL_SIGNIN=true
84DISABLE_REGISTRATION=false
85ALLOW_ONLY_EXTERNAL_REGISTRATION=true
86SHOW_REGISTRATION_BUTTON=false
87REQUIRE_SIGNIN_VIEW=false
88REGISTER_EMAIL_CONFIRM=true
89ENABLE_NOTIFY_MAIL=true
90DEFAULT_KEEP_EMAIL_PRIVATE=false
91DEFAULT_ALLOW_CREATE_ORGANIZATION=true
92DEFAULT_ENABLE_TIMETRACKING=false
93
94[lfs]
95PATH = /data/git/lfs
96
97[mailer]
98ENABLED=$MAILER_ENABLED
99; TODO: get evil mailing credentials. we likely will not need this
100; for a while and can just use clover's email. its not that deep
101FROM=noreply.evil-git@paperclover.net
102PROTOCOL=smtps
103SMTP_PORT=465
104SMTP_ADDR=$MAILER_ADDRESS
105USER=$MAILER_USERNAME
106PASSWD=$MAILER_PASSWORD
107
108[repository.pull-request]
109DEFAULT_MERGE_STYLE=squash
110
111[repository.signing]
112DEFAULT_TRUST_MODEL=committer
113
114[oauth2]
115JWT_SECRET=$FORGEJO_OAUTH2_JWT_SECRET
service/evil-forgejo/icon.svg deleted-1
......@@ -1 +0,0 @@
1<svg fill="#fb923c" role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Forgejo</title><path d="M16.7773 0c1.6018 0 2.9004 1.2986 2.9004 2.9005s-1.2986 2.9004-2.9004 2.9004c-1.0854 0-2.0315-.596-2.5288-1.4787H12.91c-2.3322 0-4.2272 1.8718-4.2649 4.195l-.0007 2.1175a7.0759 7.0759 0 0 1 4.148-1.4205l.1176-.001 1.3385.0002c.4973-.8827 1.4434-1.4788 2.5288-1.4788 1.6018 0 2.9004 1.2986 2.9004 2.9005s-1.2986 2.9004-2.9004 2.9004c-1.0854 0-2.0315-.596-2.5288-1.4787H12.91c-2.3322 0-4.2272 1.8718-4.2649 4.195l-.0007 2.319c.8827.4973 1.4788 1.4434 1.4788 2.5287 0 1.602-1.2986 2.9005-2.9005 2.9005-1.6018 0-2.9004-1.2986-2.9004-2.9005 0-1.0853.596-2.0314 1.4788-2.5287l-.0002-9.9831c0-3.887 3.1195-7.0453 6.9915-7.108l.1176-.001h1.3385C14.7458.5962 15.692 0 16.7773 0ZM7.2227 19.9052c-.6596 0-1.1943.5347-1.1943 1.1943s.5347 1.1943 1.1943 1.1943 1.1944-.5347 1.1944-1.1943-.5348-1.1943-1.1944-1.1943Zm9.5546-10.4644c-.6596 0-1.1944.5347-1.1944 1.1943s.5348 1.1943 1.1944 1.1943c.6596 0 1.1943-.5347 1.1943-1.1943s-.5347-1.1943-1.1943-1.1943Zm0-7.7346c-.6596 0-1.1944.5347-1.1944 1.1943s.5348 1.1943 1.1944 1.1943c.6596 0 1.1943-.5347 1.1943-1.1943s-.5347-1.1943-1.1943-1.1943Z"/></svg>
service/evil-forgejo/provide.py deleted-67
......@@ -1,67 +0,0 @@
1#!/usr/bin/env python3
2import json
3import sys
4import urllib.error
5import urllib.request
6
7from api import instance
8
9
10data = json.load(sys.stdin)
11request = data["request"]
12if request["kind"] != "oauth-client":
13 raise ValueError("unsupported Forgejo input")
14stage = data.get("stageId")
15existing = data.get("existing") or {}
16if data.get("operation") == "delete" and not stage:
17 raise ValueError("refusing to delete a production OAuth client")
18_, address = instance()
19authorization = "token " + data["providerSecrets"]["automation_token"]
20
21
22def api(path, method="GET", body=None, missing_ok=False):
23 query = urllib.request.Request(
24 address + "/api/v1" + path,
25 data=json.dumps(body).encode() if body is not None else None,
26 method=method,
27 headers={"Authorization": authorization, "Content-Type": "application/json"},
28 )
29 try:
30 with urllib.request.urlopen(query, timeout=10) as response:
31 return json.load(response) if response.status != 204 else None
32 except urllib.error.HTTPError as error:
33 if error.code == 404 and (method == "DELETE" or missing_ok):
34 return None
35 raise RuntimeError(f"Forgejo OAuth API returned HTTP {error.code}") from error
36
37
38application_id = existing.get("applicationId")
39if data.get("operation") == "delete":
40 if application_id:
41 api("/user/applications/oauth2/" + application_id, "DELETE")
42 sys.exit(0)
43
44suffix = request["name"] + (":" + stage if stage else "")
45name = "Snow Globe: " + suffix
46desired = {"name": name, "redirect_uris": request["redirectUris"], "confidential_client": True}
47if application_id:
48 current = api("/user/applications/oauth2/" + application_id, missing_ok=True)
49 if current and current["client_id"] == existing.get("clientId") and existing.get("clientSecret"):
50 if any(current[key] != value for key, value in desired.items()):
51 api("/user/applications/oauth2/" + application_id, "PATCH", desired)
52 client_id = existing["clientId"]
53 client_secret = existing["clientSecret"]
54 else:
55 application_id = None
56if not application_id:
57 applications = api("/user/applications/oauth2?limit=100")
58 if any(item["name"] in (name, "studio:" + suffix) for item in applications):
59 raise ValueError("Forgejo OAuth client exists without its stored secret")
60 created = api("/user/applications/oauth2", "POST", desired)
61 application_id = str(created["id"])
62 client_id = created["client_id"]
63 client_secret = created["client_secret"]
64if not client_id or not client_secret:
65 raise ValueError("Forgejo OAuth client has no credentials")
66print(json.dumps({"applicationId": application_id, "clientId": client_id,
67 "clientSecret": client_secret, "providerUrl": "https://" + data["host"]}))
service/evil-forgejo/public/assets/css/theme-evil-dark.css deleted-118
......@@ -1,118 +0,0 @@
1@import "theme-forgejo-dark.css";
2
3:root {
4 --f: 0.75;
5 --l: 4;
6 --steel-900: lch(from #10161d l calc(c * var(--f)) 320);
7 --steel-850: lch(from #131a21 l calc(c * var(--f)) 320);
8 --steel-800: lch(from #171e26 l calc(c * var(--f)) 320);
9 --steel-750: lch(from #1d262f l calc(c * var(--f)) 320);
10 --steel-700: lch(from #242d38 l calc(c * var(--f)) 320);
11 --steel-650: lch(from #2b3642 l calc(c * var(--f)) 320);
12 --steel-600: lch(from #374351 l calc(c * var(--f)) 320);
13 --steel-550: lch(from #445161 l calc(c * var(--f)) 320);
14 --steel-500: lch(from #515f70 l calc(c * var(--f)) 320);
15 --steel-450: lch(from #5f6e80 l calc(c * var(--f)) 320);
16 --steel-400: lch(from #6d7d8f l calc(c * var(--f)) 320);
17 --steel-350: lch(from #7c8c9f l calc(c * var(--f)) 320);
18 --steel-300: lch(from #8c9caf l calc(c * var(--f)) 320);
19 --steel-250: lch(from #9dadc0 l calc(c * var(--f)) 320);
20 --steel-200: lch(from #aebed0 l calc(c * var(--f)) 320);
21 --steel-150: lch(from #c0cfe0 l calc(c * var(--f)) 320);
22 --steel-100: lch(from #d2e0f0 l calc(c * var(--f)) 320);
23 --zinc-50: lch(from #fafafa l calc(c * var(--f)) 320);
24 --zinc-100: lch(from #f4f4f5 l calc(c * var(--f)) 320);
25 --zinc-150: lch(from #ececee l calc(c * var(--f)) 320);
26 --zinc-200: lch(from #e4e4e7 l calc(c * var(--f)) 320);
27 --zinc-250: lch(from #dcdce0 l calc(c * var(--f)) 320);
28 --zinc-300: lch(from #d4d4d8 l calc(c * var(--f)) 320);
29 --zinc-350: lch(from #babac1 l calc(c * var(--f)) 320);
30 --zinc-400: lch(from #a1a1aa l calc(c * var(--f)) 320);
31 --zinc-450: lch(from #898992 l calc(c * var(--f)) 320);
32 --zinc-500: lch(from #71717a l calc(c * var(--f)) 320);
33 --zinc-550: lch(from #61616a l calc(c * var(--f)) 320);
34 --zinc-600: lch(from #52525b l calc(c * var(--f)) 320);
35 --zinc-650: lch(from #484850 l calc(c * var(--f)) 320);
36 --zinc-700: lch(from #3f3f46 l calc(c * var(--f)) 320);
37 --zinc-750: lch(from #333338 l calc(c * var(--f)) 320);
38 --zinc-800: lch(from #27272a l calc(c * var(--f)) 320);
39 --zinc-850: lch(from #1f1f23 l calc(c * var(--f)) 320);
40 --zinc-900: lch(from #18181b l calc(c * var(--f)) 320);
41 --color-primary: #e286f3;
42 --color-primary-contrast: lch(from var(--color-primary) 95% 0 h);
43 --color-primary-dark-1: lch(from var(--color-primary) l c h);
44 --color-primary-dark-2: lch(from var(--color-primary) calc(l * 0.85) c h);
45 --color-primary-dark-3: lch(from var(--color-primary) calc(l * 0.85) c h);
46 --color-primary-dark-4: lch(from var(--color-primary) calc(l * 0.72) c h);
47 --color-primary-dark-5: lch(from var(--color-primary) calc(l * 0.72) c h);
48 --color-primary-dark-6: lch(from var(--color-primary) calc(l * 0.72) c h);
49 --color-primary-dark-7: lch(from var(--color-primary) calc(l * 0.72) c h);
50 --color-primary-light-1: lch(from var(--color-primary) calc(l * 1.15) c h);
51 --color-primary-light-2: lch(from var(--color-primary) calc(l * 1.28) c h);
52 --color-primary-light-3: lch(from var(--color-primary) calc(l * 1.48) c h);
53 --color-primary-light-4: lch(from var(--color-primary) calc(l * 1.68) c h);
54 --color-primary-light-5: lch(
55 from
56 var(--color-primary)
57 calc(l * 1.82)
58 calc(c * 0.6)
59 h
60 );
61 --color-primary-light-6: lch(
62 from
63 var(--color-primary)
64 calc(l * 1.92)
65 calc(c * 0.3)
66 h
67 );
68 --color-primary-light-7: lch(
69 from
70 var(--color-primary)
71 calc(l * 1.98)
72 calc(c * 0.15)
73 h
74 );
75 --color-primary-alpha-10: lch(from var(--color-primary) l c h / 0.1);
76 --color-primary-alpha-20: lch(from var(--color-primary) l c h / 0.2);
77 --color-primary-alpha-30: lch(from var(--color-primary) l c h / 0.3);
78 --color-primary-alpha-40: lch(from var(--color-primary) l c h / 0.4);
79 --color-primary-alpha-50: lch(from var(--color-primary) l c h / 0.5);
80 --color-primary-alpha-60: lch(from var(--color-primary) l c h / 0.6);
81 --color-primary-alpha-70: lch(from var(--color-primary) l c h / 0.7);
82 --color-primary-alpha-80: lch(from var(--color-primary) l c h / 0.8);
83 --color-primary-alpha-90: lch(from var(--color-primary) l c h / 0.9);
84 --color-active: var(--steel-600);
85 --color-secondary-alpha-10: lch(from var(--color-secondary) l c h / 0.1);
86 --color-secondary-alpha-20: lch(from var(--color-secondary) l c h / 0.2);
87 --color-secondary-alpha-30: lch(from var(--color-secondary) l c h / 0.3);
88 --color-secondary-alpha-40: lch(from var(--color-secondary) l c h / 0.4);
89 --color-secondary-alpha-50: lch(from var(--color-secondary) l c h / 0.5);
90 --color-secondary-alpha-60: lch(from var(--color-secondary) l c h / 0.6);
91 --color-secondary-alpha-70: lch(from var(--color-secondary) l c h / 0.7);
92 --color-secondary-alpha-80: lch(from var(--color-secondary) l c h / 0.8);
93 --color-secondary-alpha-90: lch(from var(--color-secondary) l c h / 0.9);
94}
95
96.organization.profile:has(.overflow-menu-items > a[href="/evil"]) {
97 .org-avatar, .org-title {
98 clip: rect(1px, 1px, 1px, 1px);
99 clip-path: inset(50%);
100 height: 1px;
101 width: 1px;
102 margin: -1px;
103 overflow: hidden;
104 padding: 0;
105 position: absolute;
106 }
107 #org-info .render-content p {
108 display: none;
109 }
110 .org-header::before {
111 content: " ";
112 height: 60px;
113 width: 215px;
114 margin-left: 10px;
115 margin-bottom: 10px;
116 background: url(data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCAxNDUzIDQwNiI+PHBhdGggZD0iTTQ2IDQ2YzIgMTctNyAxMzUtMiAxNDBzMTI1LTQgMTQyLTJjMjYgNSAyNiA0MS0xIDQ1LTE3IDItMTM2LTgtMTQxLTMtNCA0IDUgMTA1IDMgMTE5IDE0LTQgMjktNiA0My03IDIzLTEgODgtNCAxMDggMCAyMiA0IDI0IDM5LTEgNDQtMzAgNi03NCAwLTEwNyAzLTI3IDItODYgMjYtODgtMTgtMi00MiAxNC05OSA2LTE0MiAwLTQtNi03LTctMTItNC0xOSA1LTE3IDctMjYgOC0zOC0xMS0xNDQgMi0xNzFDMTQgOSAyMCA1IDI4IDRjMTktMyAxMjQtNSAxNDEtMSAyMyA1IDE4IDQzLTMgNDNINDZabTEwMzYgMTc2Yy0xNS0xMC0zMyAzNC0zNyA0NC01IDE0LTEwIDMxLTEzIDQ2cy02IDU3LTExIDY3Yy0xMCAyMC00MSAxNC00My0xMi0xLTE3IDAtMTQxIDQtMTUxIDQtMTMgMjItMTUgMzMtOGw3IDljMSAwIDEyLTE5IDE2LTIyIDQ2LTUxIDc4IDMgMTAzIDQwIDE5IDI4IDc4IDExNCA4OCAxNDAgNyAyMS0xMCAzOC0yOSAyOS05LTUtMzctNjAtNDUtNzNsLTczLTEwOVptMzI2LTEwMWMyNS0xIDMyIDMwIDEwIDM5LTM0IDE0LTU4IDgtOTEgMzgtNjggNjAtMTIgMTIzIDU0IDE0NiAxOCA2IDY3IDkgNzEgMjcgMTAgNDUtODUgMTItMTAzIDUtMTUyLTY0LTExNS0yMDkgMjktMjQ4IDctMiAyMy03IDMwLTdaTTYzNiA1YzcgNyA1IDQyIDQgNTMgMCA3OC04IDE1Ni02IDIzNCAwIDI0IDkgNjYgNSA4Ni0zIDE5LTMxIDIxLTM0LTEtNC0yNiA1LTcwIDUtMTAwIDEtNzgtMTQtMTg0LTUtMjU4IDItMTYgMTktMjYgMzEtMTRaTTMxMyAzMTBjMjEtMzIgMzQtNzAgNTktOTkgMTAtMTEgMzItMzYgNDgtMjQgMjQgMTktMTMgMzgtMjMgNDgtMjAgMjMtMzkgNTctNTAgODYtNSAxMS0xNyA1Ni0yMyA2MS0xMyAxMC0yNiAzLTMyLTExLTktMTctNDQtMTIwLTQ3LTEzNy0zLTI1IDIzLTM2IDM2LTE5czIwIDc0IDMyIDk1Wm0xNzAtMTEzYzEyLTEyIDMyLTQgMzQgMTIgNSAyOC0xIDg0LTEgMTE3IDAgMTQgNyA1Mi00IDYyLTggNy0yMiA3LTI5LTItMTEtMTEtMy02OC0zLTg1IDAtMjctNi03MC0xLTk1IDAtMyAyLTYgNC05Wm0xNS01MmEyMSAyMSAwIDEgMCAwLTQyIDIxIDIxIDAgMCAwIDAgNDJaIiBmaWxsPSIjZTZkYmU3Ii8+PHBhdGggZmlsbD0iI0UxODZGNCIgZD0iTTk1MSA0MGMyMyAyMS0xIDUzLTE2IDcwLTEzIDE1LTQ1IDUyLTY0IDUxLTYgMC00Ni0yMi01My0yNy0zOS0yNy0zNS0xMDIgMjctODkgOCAyIDI4IDE1IDMwIDE1IDMtMSAxMi0xNSAxNy0xOCAxNC0xMSA0NS0xNSA1OS0yWiIvPjxwYXRoIGQ9Ik04NjAgMzg3Yy0zLTQtNS05LTYtMTQtMy0yMi0zLTE1NSAwLTE3NiA0LTI0IDM3LTI1IDQwIDIgMyAyMCAzIDE1NiAwIDE3NS0yIDE3LTIyIDI0LTM0IDEzWiIgZmlsbD0iI2U2ZGJlNyIvPjwvc3ZnPg);
117 }
118}
service/evil-forgejo/public/assets/css/theme-evil-light.css deleted-175
......@@ -1,175 +0,0 @@
1@import "theme-forgejo-light.css";
2
3:root {
4 --f: 5;
5 --l: 4;
6 --steel-900: lch(from #10161d l calc(c * var(--f)) 320);
7 --steel-850: lch(from #131a21 l calc(c * var(--f)) 320);
8 --steel-800: lch(from #171e26 l calc(c * var(--f)) 320);
9 --steel-750: lch(from #1d262f l calc(c * var(--f)) 320);
10 --steel-700: lch(from #242d38 l calc(c * var(--f)) 320);
11 --steel-650: lch(from #2b3642 l calc(c * var(--f)) 320);
12 --steel-600: lch(from #374351 l calc(c * var(--f)) 320);
13 --steel-550: lch(from #445161 l calc(c * var(--f)) 320);
14 --steel-500: lch(from #515f70 l calc(c * var(--f)) 320);
15 --steel-450: lch(from #5f6e80 l calc(c * var(--f)) 320);
16 --steel-400: lch(from #6d7d8f l calc(c * var(--f)) 320);
17 --steel-350: lch(from #7c8c9f l calc(c * var(--f)) 320);
18 --steel-300: lch(from #8c9caf l calc(c * var(--f)) 320);
19 --steel-250: lch(from #9dadc0 l calc(c * var(--f)) 320);
20 --steel-200: lch(from #aebed0 l calc(c * var(--f)) 320);
21 --steel-150: lch(from #c0cfe0 l calc(c * var(--f)) 320);
22 --steel-100: lch(from #d2e0f0 l calc(c * var(--f)) 320);
23 --zinc-50: lch(from #fafafa l calc(c * var(--f)) 320);
24 --zinc-100: lch(from #f4f4f5 l calc(c * var(--f)) 320);
25 --zinc-150: lch(from #ececee l calc(c * var(--f)) 320);
26 --zinc-200: lch(from #e4e4e7 l calc(c * var(--f)) 320);
27 --zinc-250: lch(from #dcdce0 l calc(c * var(--f)) 320);
28 --zinc-300: lch(from #d4d4d8 l calc(c * var(--f)) 320);
29 --zinc-350: lch(from #babac1 l calc(c * var(--f)) 320);
30 --zinc-400: lch(from #a1a1aa l calc(c * var(--f)) 320);
31 --zinc-450: lch(from #898992 l calc(c * var(--f)) 320);
32 --zinc-500: lch(from #71717a l calc(c * var(--f)) 320);
33 --zinc-550: lch(from #61616a l calc(c * var(--f)) 320);
34 --zinc-600: lch(from #52525b l calc(c * var(--f)) 320);
35 --zinc-650: lch(from #484850 l calc(c * var(--f)) 320);
36 --zinc-700: lch(from #3f3f46 l calc(c * var(--f)) 320);
37 --zinc-750: lch(from #333338 l calc(c * var(--f)) 320);
38 --zinc-800: lch(from #27272a l calc(c * var(--f)) 320);
39 --zinc-850: lch(from #1f1f23 l calc(c * var(--f)) 320);
40 --zinc-900: lch(from #18181b l calc(c * var(--f)) 320);
41 --color-primary: #b734cf;
42 --color-primary-contrast: lch(from var(--color-primary) 95% 0 h);
43 --color-primary-dark-1: lch(from var(--color-primary) l c h);
44 --color-primary-dark-2: lch(from var(--color-primary) calc(l * 0.85) c h);
45 --color-primary-dark-3: lch(from var(--color-primary) calc(l * 0.85) c h);
46 --color-primary-dark-4: lch(from var(--color-primary) calc(l * 0.72) c h);
47 --color-primary-dark-5: lch(from var(--color-primary) calc(l * 0.72) c h);
48 --color-primary-dark-6: lch(from var(--color-primary) calc(l * 0.72) c h);
49 --color-primary-dark-7: lch(from var(--color-primary) calc(l * 0.72) c h);
50 --color-primary-light-1: lch(from var(--color-primary) calc(l * 1.15) c h);
51 --color-primary-light-2: lch(from var(--color-primary) calc(l * 1.28) c h);
52 --color-primary-light-3: lch(from var(--color-primary) calc(l * 1.48) c h);
53 --color-primary-light-4: lch(from var(--color-primary) calc(l * 1.68) c h);
54 --color-primary-light-5: lch(
55 from
56 var(--color-primary)
57 calc(l * 1.82)
58 calc(c * 0.6)
59 h
60 );
61 --color-primary-light-6: lch(
62 from
63 var(--color-primary)
64 calc(l * 1.92)
65 calc(c * 0.3)
66 h
67 );
68 --color-primary-light-7: lch(
69 from
70 var(--color-primary)
71 calc(l * 1.98)
72 calc(c * 0.15)
73 h
74 );
75 --color-primary-alpha-10: lch(from var(--color-primary) l c h / 0.1);
76 --color-primary-alpha-20: lch(from var(--color-primary) l c h / 0.2);
77 --color-primary-alpha-30: lch(from var(--color-primary) l c h / 0.3);
78 --color-primary-alpha-40: lch(from var(--color-primary) l c h / 0.4);
79 --color-primary-alpha-50: lch(from var(--color-primary) l c h / 0.5);
80 --color-primary-alpha-60: lch(from var(--color-primary) l c h / 0.6);
81 --color-primary-alpha-70: lch(from var(--color-primary) l c h / 0.7);
82 --color-primary-alpha-80: lch(from var(--color-primary) l c h / 0.8);
83 --color-primary-alpha-90: lch(from var(--color-primary) l c h / 0.9);
84 --color-active: var(--steel-600);
85 --color-secondary-alpha-10: lch(from var(--color-secondary) l c h / 0.1);
86 --color-secondary-alpha-20: lch(from var(--color-secondary) l c h / 0.2);
87 --color-secondary-alpha-30: lch(from var(--color-secondary) l c h / 0.3);
88 --color-secondary-alpha-40: lch(from var(--color-secondary) l c h / 0.4);
89 --color-secondary-alpha-50: lch(from var(--color-secondary) l c h / 0.5);
90 --color-secondary-alpha-60: lch(from var(--color-secondary) l c h / 0.6);
91 --color-secondary-alpha-70: lch(from var(--color-secondary) l c h / 0.7);
92 --color-secondary-alpha-80: lch(from var(--color-secondary) l c h / 0.8);
93 --color-secondary-alpha-90: lch(from var(--color-secondary) l c h / 0.9);
94 --color-body: lch(from #fff l calc(c * var(--f) + var(--l)) h);
95 --color-text-dark: lch(from #000 l calc(c * var(--f) + var(--l)) h);
96 --color-input-background: lch(from #fff l calc(c * var(--f) + var(--l)) h);
97 --color-input-toggle-background: lch(
98 from
99 #fff
100 l
101 calc(c * var(--f) + var(--l))
102 h
103 );
104 --color-header-wrapper-transparent: lch(
105 from
106 #d2e0f000
107 l
108 calc(c * var(--f) + var(--l))
109 h
110 );
111 --color-light-border: lch(from #0000001d l calc(c * var(--f) + var(--l)) h);
112 --color-hover: lch(from #e4e4e4aa l calc(c * var(--f) + var(--l)) h);
113 --color-active: lch(from #e2e2e5 l calc(c * var(--f) + var(--l)) 320);
114 --color-markup-table-row: lch(
115 from
116 #ffffff06
117 l
118 calc(c * var(--f) + var(--l))
119 h
120 );
121 --color-shadow: lch(from #00000060 l calc(c * var(--f) + var(--l)) h);
122 --color-text-focus: lch(from #fff l calc(c * var(--f) + var(--l)) h);
123 --color-reaction-bg: lch(from #0000000a l calc(c * var(--f) + var(--l)) h);
124 --color-tooltip-text: lch(from #ffffff l calc(c * var(--f) + var(--l)) h);
125 --color-tooltip-bg: lch(from #000000f0 l calc(c * var(--f) + var(--l)) h);
126 --color-label-bg: lch(from #cacaca7b l calc(c * var(--f) + var(--l)) h);
127 --color-label-hover-bg: lch(
128 from
129 #cacacaa0
130 l
131 calc(c * var(--f) + var(--l))
132 h
133 );
134 --color-label-active-bg: lch(
135 from
136 #cacacaff
137 l
138 calc(c * var(--f) + var(--l))
139 h
140 );
141 --color-label-bg-alt: lch(from #cacacaff l calc(c * var(--f) + var(--l)) h);
142 --color-overlay-backdrop: lch(
143 from
144 #080808c0
145 l
146 calc(c * var(--f) + var(--l))
147 h
148 );
149 --checkerboard-color-1: lch(from #ffffff l calc(c * var(--f) + var(--l)) h);
150 --checkerboard-color-2: lch(from #e5e5e5 l calc(c * var(--f) + var(--l)) h);
151}
152
153.organization.profile:has(.overflow-menu-items > a[href="/evil"]) {
154 .org-avatar, .org-title {
155 clip: rect(1px, 1px, 1px, 1px);
156 clip-path: inset(50%);
157 height: 1px;
158 width: 1px;
159 margin: -1px;
160 overflow: hidden;
161 padding: 0;
162 position: absolute;
163 }
164 #org-info .render-content p {
165 display: none;
166 }
167 .org-header::before {
168 content: " ";
169 height: 60px;
170 width: 215px;
171 margin-left: 10px;
172 margin-bottom: 10px;
173 background: url(data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCAxNDUzIDQwNiI+PHBhdGggZmlsbD0iIzIwMTQyMiIgZD0iTTQ2IDQ2YzIgMTctNyAxMzUtMiAxNDBzMTI1LTQgMTQyLTJjMjYgNSAyNiA0MS0xIDQ1LTE3IDItMTM2LTgtMTQxLTMtNCA0IDUgMTA1IDMgMTE5IDE0LTQgMjktNiA0My03IDIzLTEgODgtNCAxMDggMCAyMiA0IDI0IDM5LTEgNDQtMzAgNi03NCAwLTEwNyAzLTI3IDItODYgMjYtODgtMTgtMi00MiAxNC05OSA2LTE0MiAwLTQtNi03LTctMTItNC0xOSA1LTE3IDctMjYgOC0zOC0xMS0xNDQgMi0xNzFDMTQgOSAyMCA1IDI4IDRjMTktMyAxMjQtNSAxNDEtMSAyMyA1IDE4IDQzLTMgNDNINDZabTEwMzYgMTc2Yy0xNS0xMC0zMyAzNC0zNyA0NC01IDE0LTEwIDMxLTEzIDQ2cy02IDU3LTExIDY3Yy0xMCAyMC00MSAxNC00My0xMi0xLTE3IDAtMTQxIDQtMTUxIDQtMTMgMjItMTUgMzMtOGw3IDljMSAwIDEyLTE5IDE2LTIyIDQ2LTUxIDc4IDMgMTAzIDQwIDE5IDI4IDc4IDExNCA4OCAxNDAgNyAyMS0xMCAzOC0yOSAyOS05LTUtMzctNjAtNDUtNzNsLTczLTEwOVptMzI2LTEwMWMyNS0xIDMyIDMwIDEwIDM5LTM0IDE0LTU4IDgtOTEgMzgtNjggNjAtMTIgMTIzIDU0IDE0NiAxOCA2IDY3IDkgNzEgMjcgMTAgNDUtODUgMTItMTAzIDUtMTUyLTY0LTExNS0yMDkgMjktMjQ4IDctMiAyMy03IDMwLTdaTTYzNiA1YzcgNyA1IDQyIDQgNTMgMCA3OC04IDE1Ni02IDIzNCAwIDI0IDkgNjYgNSA4Ni0zIDE5LTMxIDIxLTM0LTEtNC0yNiA1LTcwIDUtMTAwIDEtNzgtMTQtMTg0LTUtMjU4IDItMTYgMTktMjYgMzEtMTRaTTMxMyAzMTBjMjEtMzIgMzQtNzAgNTktOTkgMTAtMTEgMzItMzYgNDgtMjQgMjQgMTktMTMgMzgtMjMgNDgtMjAgMjMtMzkgNTctNTAgODYtNSAxMS0xNyA1Ni0yMyA2MS0xMyAxMC0yNiAzLTMyLTExLTktMTctNDQtMTIwLTQ3LTEzNy0zLTI1IDIzLTM2IDM2LTE5czIwIDc0IDMyIDk1Wm0xNzAtMTEzYzEyLTEyIDMyLTQgMzQgMTIgNSAyOC0xIDg0LTEgMTE3IDAgMTQgNyA1Mi00IDYyLTggNy0yMiA3LTI5LTItMTEtMTEtMy02OC0zLTg1IDAtMjctNi03MC0xLTk1IDAtMyAyLTYgNC05Wm0xNS01MmEyMSAyMSAwIDEgMCAwLTQyIDIxIDIxIDAgMCAwIDAgNDJaIi8+PHBhdGggZmlsbD0iI0UxODZGNCIgZD0iTTk1MSA0MGMyMyAyMS0xIDUzLTE2IDcwLTEzIDE1LTQ1IDUyLTY0IDUxLTYgMC00Ni0yMi01My0yNy0zOS0yNy0zNS0xMDIgMjctODkgOCAyIDI4IDE1IDMwIDE1IDMtMSAxMi0xNSAxNy0xOCAxNC0xMSA0NS0xNSA1OS0yWiIvPjxwYXRoIGZpbGw9IiMyMDE0MjIiIGQ9Ik04NjAgMzg3Yy0zLTQtNS05LTYtMTQtMy0yMi0zLTE1NSAwLTE3NiA0LTI0IDM3LTI1IDQwIDIgMyAyMCAzIDE1NiAwIDE3NS0yIDE3LTIyIDI0LTM0IDEzWiIvPjwvc3ZnPg);
174 }
175}
service/evil-forgejo/public/assets/css/theme-evil.css deleted-189
......@@ -1,189 +0,0 @@
1@import "theme-forgejo-light.css";
2@import "theme-forgejo-dark.css" (prefers-color-scheme: dark);
3
4:root {
5 --f: 5;
6 --l: 4;
7 --steel-900: lch(from #10161d l calc(c * var(--f)) 320);
8 --steel-850: lch(from #131a21 l calc(c * var(--f)) 320);
9 --steel-800: lch(from #171e26 l calc(c * var(--f)) 320);
10 --steel-750: lch(from #1d262f l calc(c * var(--f)) 320);
11 --steel-700: lch(from #242d38 l calc(c * var(--f)) 320);
12 --steel-650: lch(from #2b3642 l calc(c * var(--f)) 320);
13 --steel-600: lch(from #374351 l calc(c * var(--f)) 320);
14 --steel-550: lch(from #445161 l calc(c * var(--f)) 320);
15 --steel-500: lch(from #515f70 l calc(c * var(--f)) 320);
16 --steel-450: lch(from #5f6e80 l calc(c * var(--f)) 320);
17 --steel-400: lch(from #6d7d8f l calc(c * var(--f)) 320);
18 --steel-350: lch(from #7c8c9f l calc(c * var(--f)) 320);
19 --steel-300: lch(from #8c9caf l calc(c * var(--f)) 320);
20 --steel-250: lch(from #9dadc0 l calc(c * var(--f)) 320);
21 --steel-200: lch(from #aebed0 l calc(c * var(--f)) 320);
22 --steel-150: lch(from #c0cfe0 l calc(c * var(--f)) 320);
23 --steel-100: lch(from #d2e0f0 l calc(c * var(--f)) 320);
24 --zinc-50: lch(from #fafafa l calc(c * var(--f)) 320);
25 --zinc-100: lch(from #f4f4f5 l calc(c * var(--f)) 320);
26 --zinc-150: lch(from #ececee l calc(c * var(--f)) 320);
27 --zinc-200: lch(from #e4e4e7 l calc(c * var(--f)) 320);
28 --zinc-250: lch(from #dcdce0 l calc(c * var(--f)) 320);
29 --zinc-300: lch(from #d4d4d8 l calc(c * var(--f)) 320);
30 --zinc-350: lch(from #babac1 l calc(c * var(--f)) 320);
31 --zinc-400: lch(from #a1a1aa l calc(c * var(--f)) 320);
32 --zinc-450: lch(from #898992 l calc(c * var(--f)) 320);
33 --zinc-500: lch(from #71717a l calc(c * var(--f)) 320);
34 --zinc-550: lch(from #61616a l calc(c * var(--f)) 320);
35 --zinc-600: lch(from #52525b l calc(c * var(--f)) 320);
36 --zinc-650: lch(from #484850 l calc(c * var(--f)) 320);
37 --zinc-700: lch(from #3f3f46 l calc(c * var(--f)) 320);
38 --zinc-750: lch(from #333338 l calc(c * var(--f)) 320);
39 --zinc-800: lch(from #27272a l calc(c * var(--f)) 320);
40 --zinc-850: lch(from #1f1f23 l calc(c * var(--f)) 320);
41 --zinc-900: lch(from #18181b l calc(c * var(--f)) 320);
42 --color-primary: #b734cf;
43 --color-primary-contrast: lch(from var(--color-primary) 95% 0 h);
44 --color-primary-dark-1: lch(from var(--color-primary) l c h);
45 --color-primary-dark-2: lch(from var(--color-primary) calc(l * 0.85) c h);
46 --color-primary-dark-3: lch(from var(--color-primary) calc(l * 0.85) c h);
47 --color-primary-dark-4: lch(from var(--color-primary) calc(l * 0.72) c h);
48 --color-primary-dark-5: lch(from var(--color-primary) calc(l * 0.72) c h);
49 --color-primary-dark-6: lch(from var(--color-primary) calc(l * 0.72) c h);
50 --color-primary-dark-7: lch(from var(--color-primary) calc(l * 0.72) c h);
51 --color-primary-light-1: lch(from var(--color-primary) calc(l * 1.15) c h);
52 --color-primary-light-2: lch(from var(--color-primary) calc(l * 1.28) c h);
53 --color-primary-light-3: lch(from var(--color-primary) calc(l * 1.48) c h);
54 --color-primary-light-4: lch(from var(--color-primary) calc(l * 1.68) c h);
55 --color-primary-light-5: lch(
56 from
57 var(--color-primary)
58 calc(l * 1.82)
59 calc(c * 0.6)
60 h
61 );
62 --color-primary-light-6: lch(
63 from
64 var(--color-primary)
65 calc(l * 1.92)
66 calc(c * 0.3)
67 h
68 );
69 --color-primary-light-7: lch(
70 from
71 var(--color-primary)
72 calc(l * 1.98)
73 calc(c * 0.15)
74 h
75 );
76 --color-primary-alpha-10: lch(from var(--color-primary) l c h / 0.1);
77 --color-primary-alpha-20: lch(from var(--color-primary) l c h / 0.2);
78 --color-primary-alpha-30: lch(from var(--color-primary) l c h / 0.3);
79 --color-primary-alpha-40: lch(from var(--color-primary) l c h / 0.4);
80 --color-primary-alpha-50: lch(from var(--color-primary) l c h / 0.5);
81 --color-primary-alpha-60: lch(from var(--color-primary) l c h / 0.6);
82 --color-primary-alpha-70: lch(from var(--color-primary) l c h / 0.7);
83 --color-primary-alpha-80: lch(from var(--color-primary) l c h / 0.8);
84 --color-primary-alpha-90: lch(from var(--color-primary) l c h / 0.9);
85 --color-active: var(--steel-600);
86 --color-secondary-alpha-10: lch(from var(--color-secondary) l c h / 0.1);
87 --color-secondary-alpha-20: lch(from var(--color-secondary) l c h / 0.2);
88 --color-secondary-alpha-30: lch(from var(--color-secondary) l c h / 0.3);
89 --color-secondary-alpha-40: lch(from var(--color-secondary) l c h / 0.4);
90 --color-secondary-alpha-50: lch(from var(--color-secondary) l c h / 0.5);
91 --color-secondary-alpha-60: lch(from var(--color-secondary) l c h / 0.6);
92 --color-secondary-alpha-70: lch(from var(--color-secondary) l c h / 0.7);
93 --color-secondary-alpha-80: lch(from var(--color-secondary) l c h / 0.8);
94 --color-secondary-alpha-90: lch(from var(--color-secondary) l c h / 0.9);
95}
96@media (not (prefers-color-scheme: dark)) {
97 :root {
98 --color-body: lch(from #fff l calc(c * var(--f) + var(--l)) h);
99 --color-text-dark: lch(from #000 l calc(c * var(--f) + var(--l)) h);
100 --color-input-background: lch(from #fff l calc(c * var(--f) + var(--l)) h);
101 --color-input-toggle-background: lch(
102 from
103 #fff
104 l
105 calc(c * var(--f) + var(--l))
106 h
107 );
108 --color-header-wrapper-transparent: lch(
109 from
110 #d2e0f000
111 l
112 calc(c * var(--f) + var(--l))
113 h
114 );
115 --color-light-border: lch(from #0000001d l calc(c * var(--f) + var(--l)) h);
116 --color-hover: lch(from #e4e4e4aa l calc(c * var(--f) + var(--l)) h);
117 --color-active: lch(from #e2e2e5 l calc(c * var(--f) + var(--l)) 320);
118 --color-markup-table-row: lch(
119 from
120 #ffffff06
121 l
122 calc(c * var(--f) + var(--l))
123 h
124 );
125 --color-shadow: lch(from #00000060 l calc(c * var(--f) + var(--l)) h);
126 --color-text-focus: lch(from #fff l calc(c * var(--f) + var(--l)) h);
127 --color-reaction-bg: lch(from #0000000a l calc(c * var(--f) + var(--l)) h);
128 --color-tooltip-text: lch(from #ffffff l calc(c * var(--f) + var(--l)) h);
129 --color-tooltip-bg: lch(from #000000f0 l calc(c * var(--f) + var(--l)) h);
130 --color-label-bg: lch(from #cacaca7b l calc(c * var(--f) + var(--l)) h);
131 --color-label-hover-bg: lch(
132 from
133 #cacacaa0
134 l
135 calc(c * var(--f) + var(--l))
136 h
137 );
138 --color-label-active-bg: lch(
139 from
140 #cacacaff
141 l
142 calc(c * var(--f) + var(--l))
143 h
144 );
145 --color-label-bg-alt: lch(from #cacacaff l calc(c * var(--f) + var(--l)) h);
146 --color-overlay-backdrop: lch(
147 from
148 #080808c0
149 l
150 calc(c * var(--f) + var(--l))
151 h
152 );
153 --checkerboard-color-1: lch(from #ffffff l calc(c * var(--f) + var(--l)) h);
154 --checkerboard-color-2: lch(from #e5e5e5 l calc(c * var(--f) + var(--l)) h);
155 }
156}
157@media (prefers-color-scheme: dark) {
158 :root {
159 --f: 0.75;
160 --color-primary: #e286f3;
161 }
162}
163
164.organization.profile:has(.overflow-menu-items > a[href="/evil"]) {
165 .org-avatar, .org-title {
166 clip: rect(1px, 1px, 1px, 1px);
167 clip-path: inset(50%);
168 height: 1px;
169 width: 1px;
170 margin: -1px;
171 overflow: hidden;
172 padding: 0;
173 position: absolute;
174 }
175 #org-info .render-content p {
176 display: none;
177 }
178 .org-header::before {
179 content: " ";
180 height: 60px;
181 width: 215px;
182 margin-left: 10px;
183 margin-bottom: 10px;
184 background: url(data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCAxNDUzIDQwNiI+PHBhdGggZmlsbD0iIzIwMTQyMiIgZD0iTTQ2IDQ2YzIgMTctNyAxMzUtMiAxNDBzMTI1LTQgMTQyLTJjMjYgNSAyNiA0MS0xIDQ1LTE3IDItMTM2LTgtMTQxLTMtNCA0IDUgMTA1IDMgMTE5IDE0LTQgMjktNiA0My03IDIzLTEgODgtNCAxMDggMCAyMiA0IDI0IDM5LTEgNDQtMzAgNi03NCAwLTEwNyAzLTI3IDItODYgMjYtODgtMTgtMi00MiAxNC05OSA2LTE0MiAwLTQtNi03LTctMTItNC0xOSA1LTE3IDctMjYgOC0zOC0xMS0xNDQgMi0xNzFDMTQgOSAyMCA1IDI4IDRjMTktMyAxMjQtNSAxNDEtMSAyMyA1IDE4IDQzLTMgNDNINDZabTEwMzYgMTc2Yy0xNS0xMC0zMyAzNC0zNyA0NC01IDE0LTEwIDMxLTEzIDQ2cy02IDU3LTExIDY3Yy0xMCAyMC00MSAxNC00My0xMi0xLTE3IDAtMTQxIDQtMTUxIDQtMTMgMjItMTUgMzMtOGw3IDljMSAwIDEyLTE5IDE2LTIyIDQ2LTUxIDc4IDMgMTAzIDQwIDE5IDI4IDc4IDExNCA4OCAxNDAgNyAyMS0xMCAzOC0yOSAyOS05LTUtMzctNjAtNDUtNzNsLTczLTEwOVptMzI2LTEwMWMyNS0xIDMyIDMwIDEwIDM5LTM0IDE0LTU4IDgtOTEgMzgtNjggNjAtMTIgMTIzIDU0IDE0NiAxOCA2IDY3IDkgNzEgMjcgMTAgNDUtODUgMTItMTAzIDUtMTUyLTY0LTExNS0yMDkgMjktMjQ4IDctMiAyMy03IDMwLTdaTTYzNiA1YzcgNyA1IDQyIDQgNTMgMCA3OC04IDE1Ni02IDIzNCAwIDI0IDkgNjYgNSA4Ni0zIDE5LTMxIDIxLTM0LTEtNC0yNiA1LTcwIDUtMTAwIDEtNzgtMTQtMTg0LTUtMjU4IDItMTYgMTktMjYgMzEtMTRaTTMxMyAzMTBjMjEtMzIgMzQtNzAgNTktOTkgMTAtMTEgMzItMzYgNDgtMjQgMjQgMTktMTMgMzgtMjMgNDgtMjAgMjMtMzkgNTctNTAgODYtNSAxMS0xNyA1Ni0yMyA2MS0xMyAxMC0yNiAzLTMyLTExLTktMTctNDQtMTIwLTQ3LTEzNy0zLTI1IDIzLTM2IDM2LTE5czIwIDc0IDMyIDk1Wm0xNzAtMTEzYzEyLTEyIDMyLTQgMzQgMTIgNSAyOC0xIDg0LTEgMTE3IDAgMTQgNyA1Mi00IDYyLTggNy0yMiA3LTI5LTItMTEtMTEtMy02OC0zLTg1IDAtMjctNi03MC0xLTk1IDAtMyAyLTYgNC05Wm0xNS01MmEyMSAyMSAwIDEgMCAwLTQyIDIxIDIxIDAgMCAwIDAgNDJaIi8+PHBhdGggZmlsbD0iI0UxODZGNCIgZD0iTTk1MSA0MGMyMyAyMS0xIDUzLTE2IDcwLTEzIDE1LTQ1IDUyLTY0IDUxLTYgMC00Ni0yMi01My0yNy0zOS0yNy0zNS0xMDIgMjctODkgOCAyIDI4IDE1IDMwIDE1IDMtMSAxMi0xNSAxNy0xOCAxNC0xMSA0NS0xNSA1OS0yWiIvPjxwYXRoIGZpbGw9IiMyMDE0MjIiIGQ9Ik04NjAgMzg3Yy0zLTQtNS05LTYtMTQtMy0yMi0zLTE1NSAwLTE3NiA0LTI0IDM3LTI1IDQwIDIgMyAyMCAzIDE1NiAwIDE3NS0yIDE3LTIyIDI0LTM0IDEzWiIvPjwvc3ZnPg);
185 @media (prefers-color-scheme: dark) {
186 background: url(data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCAxNDUzIDQwNiI+PHBhdGggZD0iTTQ2IDQ2YzIgMTctNyAxMzUtMiAxNDBzMTI1LTQgMTQyLTJjMjYgNSAyNiA0MS0xIDQ1LTE3IDItMTM2LTgtMTQxLTMtNCA0IDUgMTA1IDMgMTE5IDE0LTQgMjktNiA0My03IDIzLTEgODgtNCAxMDggMCAyMiA0IDI0IDM5LTEgNDQtMzAgNi03NCAwLTEwNyAzLTI3IDItODYgMjYtODgtMTgtMi00MiAxNC05OSA2LTE0MiAwLTQtNi03LTctMTItNC0xOSA1LTE3IDctMjYgOC0zOC0xMS0xNDQgMi0xNzFDMTQgOSAyMCA1IDI4IDRjMTktMyAxMjQtNSAxNDEtMSAyMyA1IDE4IDQzLTMgNDNINDZabTEwMzYgMTc2Yy0xNS0xMC0zMyAzNC0zNyA0NC01IDE0LTEwIDMxLTEzIDQ2cy02IDU3LTExIDY3Yy0xMCAyMC00MSAxNC00My0xMi0xLTE3IDAtMTQxIDQtMTUxIDQtMTMgMjItMTUgMzMtOGw3IDljMSAwIDEyLTE5IDE2LTIyIDQ2LTUxIDc4IDMgMTAzIDQwIDE5IDI4IDc4IDExNCA4OCAxNDAgNyAyMS0xMCAzOC0yOSAyOS05LTUtMzctNjAtNDUtNzNsLTczLTEwOVptMzI2LTEwMWMyNS0xIDMyIDMwIDEwIDM5LTM0IDE0LTU4IDgtOTEgMzgtNjggNjAtMTIgMTIzIDU0IDE0NiAxOCA2IDY3IDkgNzEgMjcgMTAgNDUtODUgMTItMTAzIDUtMTUyLTY0LTExNS0yMDkgMjktMjQ4IDctMiAyMy03IDMwLTdaTTYzNiA1YzcgNyA1IDQyIDQgNTMgMCA3OC04IDE1Ni02IDIzNCAwIDI0IDkgNjYgNSA4Ni0zIDE5LTMxIDIxLTM0LTEtNC0yNiA1LTcwIDUtMTAwIDEtNzgtMTQtMTg0LTUtMjU4IDItMTYgMTktMjYgMzEtMTRaTTMxMyAzMTBjMjEtMzIgMzQtNzAgNTktOTkgMTAtMTEgMzItMzYgNDgtMjQgMjQgMTktMTMgMzgtMjMgNDgtMjAgMjMtMzkgNTctNTAgODYtNSAxMS0xNyA1Ni0yMyA2MS0xMyAxMC0yNiAzLTMyLTExLTktMTctNDQtMTIwLTQ3LTEzNy0zLTI1IDIzLTM2IDM2LTE5czIwIDc0IDMyIDk1Wm0xNzAtMTEzYzEyLTEyIDMyLTQgMzQgMTIgNSAyOC0xIDg0LTEgMTE3IDAgMTQgNyA1Mi00IDYyLTggNy0yMiA3LTI5LTItMTEtMTEtMy02OC0zLTg1IDAtMjctNi03MC0xLTk1IDAtMyAyLTYgNC05Wm0xNS01MmEyMSAyMSAwIDEgMCAwLTQyIDIxIDIxIDAgMCAwIDAgNDJaIiBmaWxsPSIjZTZkYmU3Ii8+PHBhdGggZmlsbD0iI0UxODZGNCIgZD0iTTk1MSA0MGMyMyAyMS0xIDUzLTE2IDcwLTEzIDE1LTQ1IDUyLTY0IDUxLTYgMC00Ni0yMi01My0yNy0zOS0yNy0zNS0xMDIgMjctODkgOCAyIDI4IDE1IDMwIDE1IDMtMSAxMi0xNSAxNy0xOCAxNC0xMSA0NS0xNSA1OS0yWiIvPjxwYXRoIGQ9Ik04NjAgMzg3Yy0zLTQtNS05LTYtMTQtMy0yMi0zLTE1NSAwLTE3NiA0LTI0IDM3LTI1IDQwIDIgMyAyMCAzIDE1NiAwIDE3NS0yIDE3LTIyIDI0LTM0IDEzWiIgZmlsbD0iI2U2ZGJlNyIvPjwvc3ZnPg);
187 }
188 }
189}
service/evil-forgejo/public/assets/img/apple-touch-icon.png deleted
Binary files a/service/evil-forgejo/public/assets/img/apple-touch-icon.png and /dev/null differ
service/evil-forgejo/public/assets/img/avatar_default.png deleted
Binary files a/service/evil-forgejo/public/assets/img/avatar_default.png and /dev/null differ
service/evil-forgejo/public/assets/img/favicon.png deleted
Binary files a/service/evil-forgejo/public/assets/img/favicon.png and /dev/null differ
service/evil-forgejo/public/assets/img/favicon.svg deleted-14
......@@ -1,14 +0,0 @@
1<svg width="78" height="78" viewBox="0 0 78 78" fill="none" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
2<g clip-path="url(#clip0_555_6)">
3<rect x="-0.5" y="8" width="78.7516" height="61" fill="url(#pattern0_555_6)"/>
4</g>
5<defs>
6<pattern id="pattern0_555_6" patternContentUnits="objectBoundingBox" width="1" height="1">
7<use xlink:href="#image0_555_6" transform="scale(0.000717875 0.000926784)"/>
8</pattern>
9<clipPath id="clip0_555_6">
10<rect width="78" height="78" fill="white"/>
11</clipPath>
12<image id="image0_555_6" width="1393" height="1079" preserveAspectRatio="none" xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABXEAAAQ3CAYAAAC+Zy3wAAAAAXNSR0IArs4c6QAAAERlWElmTU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAA6ABAAMAAAABAAEAAKACAAQAAAABAAAFcaADAAQAAAABAAAENwAAAADMnD1aAABAAElEQVR4Aey9aZcc6X3d+WyxZWataABdaJCNboJNnWppLBuSfUxSImTNnDMvNJ7lHPAjzNdo4GPopd8OPMeeOfNiNFoMWiZFUYI4tqgaWSqSIInuwlprbhHxLHP/kZUFoNnN3oEq1I1CZmxPRDzxi6gs5M2b968UBxIgARIgARIgARIgARIgARIgARIgARI45QSSSvqUI+DpkwAJHGMCfIE6xheHXSMBEiABEiABEiABEiABEiABEiABEvjkBESQ1UqnD9uyE2yfXntDzfSRd2TD2XYpPSXqytp5e0w/ve+n2823/bDjcjkJkAAJfFoCFHE/LTluRwIkQAIkQAIkQAIkQAIkQAIkQAIkcKwIdOLs9SeC7DOdmysgIsaKaLt+2O6w0U11U13buDaTat/BwpvPrr+1cavbw9X1q0ltzCTdm+s39dmNs/qquqqwv6SuqTgXcru+yL7n4u9cKJZlEItl9EHDfPsPWvdZls3F5i9q/5+lb9yWBEjgownMX8I+uiVbkAAJkAAJkAAJkAAJkAAJkAAJkAAJkMDnQOBI4Hx6X3NZ82mxU9aL4Dlf9j7h9enNRWS9unZVq5WZ+LqxsaHW19bTbXW7a3blrSvdEW7/w219RV1RGysbv6yJbKDpulL5vfyX1z11sMuvXk4bUHLX8bN5b/Oo7eXicpwf76nms+PjmEfDWzin7xzOfetoaTdx6zu3IAlfjc8sfVr0nbOQBvPl82Xz+Wc2ft8Meqt/hUv5fa05SwIkcEwIHL3QHJP+sBskQAIkQAIkQAIkQAIkQAIkQAIkQAInnECSfNm5KCvKw3z6pjLqrNIipM5PUQTVzXrTXFaX1Z3tO1q9Pl/z7NjtOK0uXlR2Z+toW2lhKtPNPz4w+lyp9b7fN7I81ss46rZMquX+cnosE48eqzOvnJEptTuabdfNHD1tq1X87I61NsXeM8eRJku9pbSzs6OWe8tJ9mzGu3plZUXtYHq5Tli2rcIkzM9WNlGrg9W0Pdye7esVzE9Xu/VxIR61u39fqbOLT+bD6Nl9+BWfLh1c6trfWQAjDP7Ap+bVRlzBan0dyrMMOyAtArEM38FD3MFPuYY7p7EIvdjDrxJy5fr9qvXd/vlEAiTwXAnMXkSe6yF5MBIgARIgARIgARIgARIgARIgARIggZNK4EigFffn3Bm7IbKgUrfwcxg3oNXabNncmVptVTpfXdeuEyEvofUdPGS4pB43W+bivtGmNxNW94I1q1gjYqqIpBpiqS60Hu4aY/LZfmVL3SAcIFO6rwZqnI10v1F6kkF/HEM3ztKhSDpWKe8dCaa6GaOvPdn8aBhhg14rbUaHy/pKZ9Lu2SF1bWSZtOt3K+ftnj7G0W66Fk/aymzKEbaLPkh72Vb2mQqV+kVKw4OhiuUgpSalWEr/9/CDI9mFuOhC7IRo2QnE6NrUcfX11c6xa3ds11cRfzvB9/ylpDY31QZE3snOJIkLuXMgixv54aHIew3jG7KzpwYReJ8esFeKuU8D4TQJvDgCv/SC9OK6wiOTAAmQAAmQAAmQAAmQAAmQAAmQAAkcFwLPiLXSKRFsEVlwe21BX1m5otU9pcUVekldUnd37nb6wsWVi50IKPO2PxMWZVMZzKFIayHQiji73FtJu+MdbabiesWjXtI6P9AGQqxSC902uh7qfjE4EhZHEHAH3ZrZ06gZ6kE20J2A2/b1JE2MiLo6aaOd0tN2qktVHm1R+1rLbKkKVU9rUxSlagKWeejBFuKvqtG2wI+aLe+2lDkZapXb4qgvsiQ5CK1hJnyCV0xepcIVaaqmsvqZodAl1o+TylRCn2LSKaq8n0ajkepB2O2k3lal4eFWGhxSDkvs4ViE3W7VIYDYzAXXfWVyoyN2GUyIjR+E5X5MaQohGG7ftmzjxZFclzudbC6O3k21qcTFu76z3u1ThPYrWxB4n3LuHnV+LuzKFZbWGH+YsHt0z0izwwJxR/vhBAmQwGciIL+CHEiABEiABEiABEiABEiABEiABEiABF5yAkcCmzhoP2w4dNZ2+bJIZr29NsuPlZxZyX512067RdcJtHNRVg8hwCLSQEOYPUjGLEOQ1dNFPVJDM4BDVoTWfj5IMp4fVubFdTofdDHQuhlBxIX21/S17imj/QTtK6UgxjZ+aqWthtiqILxq+FCx0miLdQHbqNbopIzPtTGZdjKtTIsmUHSj19gHBqc8pmXSG2wTsBxDwClp7EOmj4au/dHch0xAsYWKiyMlE6xXsZ2JrGjtTJba+VZe5iHAWkigEW2Ta9UEimyRRdWgh3kep00dM5eHAsLuRIRgrSD4QofFPiAhd4JvBcfuGBbfBBF4vmvxAo9bOf+JUVkvVXAfizg8Qrue7sX9Eg7fNoQEs+9jxD2EycMUEO9wBuJunED0XUFsw12lRHwXiVciGiTvV651l/srucLfWo9H7l05cOe6voWJq7O4Bkx1kQ0i9sq99ZToK2Jvd9+hyYcJv7I5BxIggY8m8OyL1Ee3ZwsSIAESIAESIAESIAESIAESIAESIIFjTuAZwRbC7C0IbwsiyD7loFXqEs7iDp5lrDo3rbhnRZx9jFiDs1i2DYFWEmR3YXDtsmLLQ+esuGeRP6trrRdhmh127lkFyVaGBaVzCLZYphFtAPHOTMZwxkJ0bTJtK8xDu5zNQ5SV9XgyHkKstfDRQmCVvYjQajLvfMDaDAsgtEbjrUPrIG0ORVgDKTfAgypCLY5m1Y5eVg4BBXJILJADQK7U2LnsVsUYu/1DgU3WORu21dlkIR8jSRf652xd19KoqJ+e7xYePXXBu5iD+7a1Z9IjaLg4LZwYBNt5VTITLQTXgB8FDdeqGHybVuO29qad68QmmRYbQHx1MYYGYjCEYQzOuBQ9pFysg9ybQhu9uH4zm6WmaVVmRRjOk7NZSHUd0cTnrgjYPIiQCwNuUHDyilQu10XGfTh+cV3SENdn0EBIx1jiGxagKe+WuynWMXW5vwjXXXSLMWyH2L4+c/KKyPv+4RJEX4lsWD/7lNArGbyHQi7gHwnO79+W8yRAAp+MwFMvTp9sQ7YmARIgARIgARIgARIgARIgARIgARJ4vgSOxNn5YW9AzOxE2lv6MIt2JpqJo1Yck8il3YCLNj900arXLym3g7jXcN9I/uzMRfsKXLSQPOEplYc4aGX34qIV6a/zyx7MDihLRpBHB8iinXTiK5RSmF0V3KA15o2GQ1bcsg4KL/TM0IOM61vYVLHvwmfQYU3UIQseEq2ItNY4CJzIAoBSmzkbd+JqJ6hCkXSFy+KuOtfNw8KqIfC2u+ECxFqYU7F3/IOtNQ878Ry8tBm0WlmmZ9PQY2V61u1u+XxyPhZQst5gvyjjNWuKhdjsSHicu0i7hoftZ1vN9gKxtNsu+YgKY6gXhgWzNR/yjEYRuqgcDXIqpFbVZivqQfIaQq6eZosIqQgGKCOyclNjl2fisAjEZjluRx87g69RNsJ67CEMR5Nsa5MNEckJeIQyunoKVXtgc6BNEIZV6GIf4PCFMTciLlgMyqnCtFy3LkMYY1kGXy9U4qobQ8COvuqFfj+EmEH6hsA7j2g4PzmfttSWWltZS2IOVgebScHBOy+sdvPhzXTt2rVOy/6kQu4Rc3Tz6WvxIUS5mARODYHZi9SpOV2eKAmQAAmQAAmQAAmQAAmQAAmQAAmcPAKdsCXy4A24atUtc1W+yi6FwyDQzrNpsVapn3XP3VMXe7AvubRryvTvd+//zei8Ppjs2NVqRe9P97plS0tLUGD3EX+gzUK+oKfDsZhdkQigLcy0IspCam1s4yHHQYWtnS+UlSiCTFkHpyz01eCCE7OshxgrzljpAJ6N3zHLEEllX1nYNmdtYfvtXlyD8lhoa7J2x59XDi5YRL92kp1MQ+HUs3lj866MWScq4/S1cTIP6VampRmkYOy9xLHkmNJOlskgOqn4deXnwwcoqWgqT1AiIeWKttrN/fImovM+LTBKi24ZPLQylkE2xvRsD5ie7wqdwEx3hPmi7oAIShDbboNxwDjAeVvDNhzRCCswYB4W26DxgBMXTl9Zg32F1LoV/QhZvmO3pB+kWg3z1fTY13FkXxGnrwjFKPuW8hpCbTfgMsDlC0cvRGQcK2WIfFBto1ye+Uzl0NlTLCD4jg6dvBCRk0Q3zPN650XfEgqwST6v5O+iiFpEBENcWF4I58vzUQTdTQi6l4u9qFauxKOYBeDpGMy6cvTcETnkP1+IvR9dsSOW85Uck8ApJnD0i3GKGfDUSYAESIAESIAESIAESIAESIAESOCFEhAx66gDT2S+2aIbM+F2AQXFqq1K56v5h2TTntW7k+1Z7MEEsQfVobJ4uGMpILaklpChemBtAWlVslSzvjZ+YmsItuKoNV7bqWsLC39tKkIBbTFH1S8ToOpi2okgG3fMKnyvGcRaF3bTWV3Zgd8JF5LDl/exXdxOZ+H8hDCLCAHIv11wAmRJjRwAiHIIPND4Uv/sfA1EW0zh3PEs4qT8zJ6MqLSHIp/orMh56JRQyLZYJUtmcm3n6MWZYsfKJlhUsTeDQUyxSKuV5TO0h7vuGuL4MsYI4/eLiNIXbNI9HbKTUdfnJ1dJutnt66kmT0/OJFxp88z+0YvZjmCR7ZrMkxeke3Llu3GCmIpDSQsMkM5hhJUpmZfl0gptJL4BY0i/GMGji3kowLItXLlmQd3NFu3PIfQ2wYc2W9WP/DgOzXK7raODwJtaQKod8hckygHG21qP3DSDiCuiLg4CKRjiMnJ2JYKhwlWTeIxxO9YSVVzpCoXZEM3QDmEijrHttWGAompt3YbWtnHqpvFycTnCsDsrmHYN4xtyFhgOs5fV08tma548v4P2GOQ6PVnIKRI4vQSefvk5vRR45iRAAiRAAiRAAiRAAiRAAiRAAiTwnAlAeBOVUqmbcIzOow+2NjqRVqnLyi3c0W4HRcTgpjV9CJcjo7dRPOzMmVeUgVi7D61yGZvvQ5yVri/JE4aDw6xaqJmQMpE/O4F/FYXCTNC2xe4Qrgp5tnUWJcAaM0UGLWQyuGnRwCLUwKrHbsH1Ui8c2IthpN+ADAuhNSHKQME1m0rEFTjoqaJxSnSBlDHDWDJoxfkqHl5VQGVFOTKJvRURrhNcZ9OimeKkRSbtFmBW5mR6Jp127UWsnO0fu8Ma6aHMG/TDYlLmZdeiaMpEt06eMTNbMVveNfnoJ/TgfY2e3VzWHh7vfe1+9ewHbYdlIlZjmB31l4RkWSzrocp2Ei6CEcQ3i0e3ibSfibiyj65XnYwN9t12WI8J9D+mBqXLajXCpuLslbCFWsRhiWRAWkOjB/FutgCRN8BX2yDXd0VtucVwT031JCAewkbcDjBgG+/qHEXZEvJ3c4fWcOzK/kTgLTNIxnDrjtAXcexKn4YtiqktQktGQTW/6APCM2JXRG0UkhRQUwdw66pN1RVOw40v/9bX1tNtdVtd2boyE3xlRzIc5uvienf7ni3kMwmcTgKf5lXodJLiWZMACZAACZAACZAACZAACZAACZDAZyQAAWwm3N6AzgY34u0dZZbqTeO2oYwuzgRbd3bN2IfKDIs9a1A4bClf1MPmQA9QMGwIBUyKifWLQRoju3Yygr6LPkmdsU5BhZvW43vyVjUOumweUBgMVs08xGAtDiFuWrVnlmyZVWGkvhSG6nV4V7FVyvxuPK/gkkVObedmtbnN4W0VSVjkQ6nMBVduN31oX8W5dDoiHK84OH7ELTuLNBBB18JzKxt3y9BGZjqhF7IxfsBCJFosg2tWhFzMdGM5BpY/PT1bIitkTTfG5NOD9EVWn7jhl8VJnLicxZMRBFnMHebtipF3JudCqJ2frbCSDTCIS7d7oL2YfWGShXArkQzdchFDsbsIEdarKeIaprI/kIPoGmGfjSOzkO5mA/cLP4kHerG9ly2ZLef1BEXaWtxEIdSxFWFXHLtJ5djZNGaqEDdwlMxdJCrMXMMQd5N4riHqBhF1TYwLFhG9LsQuW3cM1/Ai7sgViLujmbirXkXvd/B4v3v3ne4G+WVWcwAck8ApIHAiX+FOwXXhKZIACZAACZAACZAACZAACZAACZxAAodiWpddK92/CaH2mkwcOm0lw/bOxh1z6fVL6i4KjNl9+FX7GEfU10JRsYPdPbMssimE29HBsHPSLui+21VTB1+kbUKNpAOonrkUCPP5RLUmq2zpm6luDcyScNeqbbPoClP6Xf0KSoANwj5CcTMziLvpPGIOEKRgnDhaRaTF1+MLCANdiiwk12ImuEJY7RILDlXRwwzaTgSUc8EGUNNEc+3GUI9FwjWQZNG3WaQBxFwRgmeiLtZ1/2bi60yE7aZF2MV+ZIdHw6EYCwXyUJR9euVRq1M60am3kDOfEjNlcua+xcWQyyLP4saFhKuhlkq4gvKQVSUPN3QyL9ZIGwGLJ8nJmAm/Mo/lcNhOYhPHUTzAcO+qOh3YBfWeHei7cOyOzKJ/YBfTfajDqFSXN1rNXLveI4lDatdhgH4bM5e32LFHFoSUfQtxMBN3Zf0oG+me7sVY7nfZuhLDUBe1D+LWdRfjxqsbabIzSQdbB+mZgn2ysQzvyLlieOruwKk8xaVbyycSeKkIPHW7v1TnxZMhARIgARIgARIgARIgARIgARIggS+UwKEO1imZUnCsy/k8q/TGdzYgiq6rfHXzMLv2UifWOvXQ7KFG2JlyVYtYK/m0ulT6oIbhsVhA7oGyEwiqNTJqe7oyTTa10ZkiZC2SR0OZTCg8QmuhwWWSTRt29LLtuaX65/GfohxYH8qrhZv2HATenghakFQRaQCHK3JqBQRCFZBu2omjM+Wv0/Hg1xUTLyRYNBGfrDhmRcJFWbJZHMNhhEHHEtOi3aLloQQ4Kx4mW0E/hoAr287kXSyTic6BK4zQJfzMhvn4cJajz5mAXF/cnt1eJZRBRFqIuRBSZ+KuOHtl/WydyLyYhpYL2RdtZ9uKvis5DDOxVzy6ErsA5RZ7aSNCGSAFezNQ72ZL9q4f+h33hv9H49VQh6xBEPJE+WJqumjc3GcWcnCGLSHmijtXetbrKTXGuNKIZ8BjpxdDg/SFhcNMXRRNSyialppXmzSPXJDt1Fvo7UM8ns7TfQf9ZORCh4dPLy8BvnC+vNeWZ0YCJEACJEACJEACJEACJEACJPA5Euj0LJGfns6whbO2B2ftPArB9NeQXauQXftI257piozpidJ71a6WwmLL5ZIe10NrUUAMNlVXw10L+6oLBaIPXJtJQbFGTXMRa4vcZNMHetlVpgoH5mIap0sxTwt+J51DNm0BURaFxJR1pSQqdEEG2BMiD0SA7URTvOUXvUwKeIkahzlJqcUiEWtlCs9ikhW5FRm2ItvCPXu4ViRXKSEmAm0n8Mr5d7KsjGVz+TcTZ4Uy5vDoVnTTsozD8SAgF1/uXLkFMJo5VmWmy93tRN4uebcTeqHzw7U7c+d28Qwi68ptgPsB28gtINda7iPk7qZRQPYupoKfIqCjVbVdVO/a3GzqQfi5XfD3TOOGWdQTP7W1Sa5Bsm5Mbop83QJyMD6d6CU/alOquigG7BcfWYjQG8xe7Pf7YR6/4J2P4tSdi7uSqdtFL6xAeJbs3OsiONONK9eGw8tJoPvFezlPjWdFAiRAAiRAAiRAAiRAAiRAAiRAAp+MwMyperiNvGMWzQvDzW/fNNfeviZuWyNxCJ1o27+o93cf2WLiLJyHRrJqFyW3Fvm1sg0csXpQDPRkhIpkmdY1hNtgTO6cglVxUrkcLluYGeGsLcKeXsF8L43Ma15yarM48LvpHLbri7RqMnhtUTAMKhrkVszNlDjRrMTHKH5YiS6ADCsyqgi6kkc7m5OuHAq0svboATWua90t68S5TqOVvs8eh2Ld4TxGHF5SApB4ZRDHbpe/24m+kEPFwRslWBd3xFwGFgW/S96FzCu+3YibpWsnojDm4NeNE+TrTiDuNqmOQ4Q5v2tLtWmreAeV+O6lRo8rlU/9OE5L06u7YmkQc8WpK/m5GGaZupKnK7kMC5gfDpUvffDax8HiIDyYPkgrbiXWeR3H/XFcV+thXgRN7l6KuS/pnXrKT0temDmQAAmQAAmQAAmQAAmQAAmQAAmQwKkhADVq9l5YBNob0HuQWysnf2vjll5YW9DVVnX4XhnSEJZvIhbhsrqs7v70rrFLEG7Hj+zZ3itQQHeNni5rUx7Y6cg4cdY28MIa1CdrQyOFxBAQquGvnZYe3z6Hc9aFR6hTVukiDs2FMNKXUq4Hfiee10UawPQKsdcgsxZJtiLDOgi3M2esRTdmfYLsKv3HDJQ1kXel5WFrCyFXHLXmyFULBy2WzMRYeYaxttsUpkrZnRgXZf5w35jgQAKHBDohF9O4z6Dh4rOCTqTFjMyLXIupcCjkIvcAmbuIbEizOAbxhUsbtEohNGkca3homzhNyNd1A/2uztOP3SD9Aoki902bDgoFhbZFtq4XOzrMuA61+JCnK05daMhenLmYjwqe81TgyM1Banu9MCnu+f5e31+8eDGos+iTxCx8DFcuuia/GPIKwIEETgyB2R+BE9NddpQESIAESIAESIAESIAESIAESIAEPhkB+PmevPe98USwvKVumatrV7UUG9u8t4k2lyElQajdt5heU2Z4X6vz55XEI+gxdKlep02ZycGBs5BaxVlrMwi2GhGgypa6DyetnsJdC70W7lqPzNqsny1OfxF+E9m3K2E7vQJnYU90UzTIO5FWVFbk28oZQR3rFNVuGoXHIMbKvKTVdhEHshlybuHcTbOCYeK+leJhDtvrhEfnrO2ctthOdNrOWgtZq5vGfrGYAwl8ZgIiz4oAil8tyLSir0bIuEGjgJporfNlKKgmsi6ydWUJxmiKFm2axlZNkJIr5dN2iktmI4zSdhr4+27ZvIekhT0RdX1rpwVyFzKX2qItA353wrgZpwqC7ujQoSuRC1Ws2hY5uudfOR8g8sYuYmELvVjHQwTdd/CQ33sZz4fD3wT8YjxZNl/HMQkcUwJ8AT+mF4bdIgESIAESIAESIAESIAESIAES+HQEoC/Jl787l+1cqN2sN41bgNq547r3wSLUmr7RuxGFxuaHeazULnJszWSmpa5W0EDhtJ3ooesybJFRO9ZtGXOTJxsKGBFzcdhKji2ctWf01L4eDtQl+GgXuigEuGzFI+sKZNaK4GrhrIUTVop9oXviie0EJFHCMHRPGIvgKmm12K2GgJucsfDmmk7UFTF3FpugId2iqyLoSjvZDtPYZXd63ZPslAMJfPEEcAPjBzewjCHiIpJBhF2EI8BD26IYWotMhgApVwqoyX0++y2Q9iiOFiZxv2vtY+0PwuPydfMjP0yP3UK8bxbTVtbaPdz2ja7DNLMLAUbcGJ0KMP36ChEMBxIo8lSG7oPdEJfXELf7qI0X3cWoXsVxdvCYF0QTYVeGd8SOSxG3Y8GnE0GAL+wn4jKxkyRAAiRAAiRAAiRAAiRAAiRAAr+KALShI+FW4hFu79w21dYVvb6q9F24a7OQmYNRZs+Uq3o03bdL+aJWjYLBdmj69SAN1RC7h+aqRyKIKtQiM6gQlsdMFz6bDlC2KUM9pkJt62Xds720by7CPYg4BNX32+ksGvcRpJCZTBVimIV3NoOQNXvPDYVKXLIzYRZiqwi6EoEgYlaXSjsvLtaJu9i8E3JlHYRatMXeYKbtHLYiBneirbQSwZcDCRw/Ap2YC1UXOisEV3HpQqzFI2DZzJULoTcGfAKSdJCbeCYDzzJ2/SQeYCusjXUcpZ3ykvlRs+vvFW+mfzQ+e5x7CLreT6waNJKnGx1cuuNxLPMYhiiK1oegK7/NvV4MwYcQLHaFomhr+VrcPNhMzatNmuxM0pWVK1FdQ4ovhdzjdwexRx9IgC/4H4iFC0mABEiABEiABEiABEiABEiABI4jgWfEWumg5NluQLRdU/oKYhGOio7tX0TGwEOzB80zn1prSq2Xagi3xUy4da3N2gwJtDDSetU4cdcigNNGmHVjrLNkQqZ2swXbs4vtz9U/sT212kh2LURbiD5asmstHuiByKySXduJvzLfya2dKgXvIcRlSLnYYCbciiiLLsFRi/iDWYatrJtHJkCgxZqZoVaOIsZaLMK+RcKVMYVbIOBwggiIbBtgfRV3roi7+IVAsTTY2CHrNnhuINdKki4eGtEL0gL3urRVmIfki9CFA+Tler/vH5Rv2B/F/fig/GrYjAfqUWHKtm3CtKcGviuQ5pDBO0GWboa9wrHbG6Qogm4sIe62ITyyj2K/6HsRdLvoBYXjUsg9QbfT6e4qRdzTff159iRAAiRAAiRAAiRAAiRAAiRwrAkcibbSyxsQd45ctpXOV9f1PMNWohHM6Lx25Y41aQXBsYiyPRiaAdy1Uz12WvdM46dWV0oUVFcbXyXjEb2ZerAIFmlPn9W5qeJeuhDq9FW/F1+Du1YCFZLJDXJsO3m1y649AiYC60xenYmtSKztYg9QoQw9xU/qvjbeTWEae5CcW9s5cqHrdu5cBCfMio1hXyIEzx4iZfH9+hFoTrw0BETShUIbMcanG5Khi6JoKHcWIPSK2AvfLu59SdbFErTBxxbyq9RJu3gxQHG0EbaJ4SA8yCVLdw85um+qf0w1snXb3ig2ZlipDA5dFERDrm6JHN3UjpJChm5aSPGgSWnu0K2L2o/qtXD5N3CkeUG0p0G/M/stlF/kpxdzmgReFAH+UXhR5HlcEiABEiABEiABEiABEiABEiCBZwh0gq0smUsmN6DefEuZzb/dtG4bFtlFp7cRi7A2MloctpJdK7m1+1NIrHDaLqpFbHAArXTBNGqStx5+WQi2MddljXnlYgmrH9Jlm1ztZMvZglma/Cz9Mwi7Z5Ble0E5VVi4aiHmlrDxFgi7dZ2MI0ENCPZEtyQfASIUVB0pRwYnLX4yLEM8AtReCUoQaVbEXSzARjMRVzbDQolXkJVdG3kWZy3WyP7w4EACp42AmHPhtYWICtdtF7wgIm9Urfh0IdaiLFpC3AKiFzCHT0G6363uYw+sQ5buQYRE60dhB6nTd3We/r54Xf+tmqZd1+iJUuXU1KkZ2DyoAsKvhkMXpdYicnTx2wz7b4r4MMf3L6z49hECdlfuJH/gEbdwGXELCnEL6MlhYTQceP6qdNquEc/3GBHgH4pjdDHYFRIgARIgARIgARIgARIgARI4bQQ64VbkkRuHQuZRPMJtXW1Vuqd6pupX1sbzBsGwxk6VHYlQWy+gahikHwimUGvMdDIxVa9CzC2k2KyplPODlKMGUhar+mFYtQt2ufmZ+k1VxtV2J71iJcNWNNRSL3Q6KrbC7rAAQqyMxTNrUDwMIi18tZjTOPyhSDsLTBBJqWvfSUtzIXYmymIXFGYFAgcS+AQERMJFbm4XIi0aK5JxxY8Lry4ydLFO/OkaY/kgpRNVIa12bVIbJ7FOYz/y23hheDcr1aau0h27kO4htGHXtfm4aO0kKyU1JYWyV/mhGsVQxNA3CzGVe+nxfoytRlE0g6JoFkXRLl4M6iyO9R083sEnMRRyP8GlZNMvggBF3C+CKvdJAiRAAiRAAiRAAiRAAiRAAiTwoQSeEW5FtN1RZmNrA/EIuZ47bmXj7D3UCRuct8PpHgyyxiwWC7puxhmqfeU1FNi2blzqI5sW1Y5apF7CZqdtbjJ94M7EqXojTPTXUO3+S6aET0/csYUeGMmjNShHJgJtp+KKLDQrQAaVRuRZyap1xsKLa1Im4m23rWzfqThohQWyFbrI99QfepW5ggQ+EwG8THSCLjTdzgEvIbnyazcrldbJvVgfFH71ka4rIm9nmId/t1ajLnahjVP8/m/nX9I/RInCzXzVbsVRfJTV5VjcuQmRC8hT8aNs3OXnijs3oShaMCk2/RAqNW3rvI6XmktBbUFMvi79oCP3M11VbvyZCPAPzmfCx41JgARIgARIgARIgARIgARIgAQ+LgGoMXqeayvFyBSKkW3WmwbJlcbuQ6btr+mD0bY9U65qs7tndLmkzVC5aT62NfTZ1tQOGQdlXYTS5Lav8tgLO2HZlna5/oX6p6qKKwEuWwQi9KyD1zaDbGskDXPWwy4HAWEKncdWCo05fAG7c9pCsJUiYxB2Ow9uJ9h2Ai3jDj7uxWU7EngeBES8nRdJk0JoIvQiUmEWvYAIBnySg2Vo04mtMuUldgGF0aZxGHbsq+kHxZfNbTM0jzLELWSNHQaX2hzu3Ah3bmiHoTcYxGT2YdFdDGH3UWyX2zCqR8jOvRzUVezxBnoAZ66cLt25QoHD8yJAEfd5keZxSIAESIAESIAESIAESIAESOCUETgSbRFPcHvttr6yckXf2bhjHqvCZEOj1wYwt46RaYvw2RW1opBNK3WMkGmrTL07ziyajTTyazNbhaweRMTiqkdhxS7mi8278V8043gZztu+lBNDiu0izLrw0CLLtisgJrvCAHVHiihhRoIS4KvVmQQuiLgLV66DVCuiru1cuZ3RrxNv+V75lN2rPN0TSUDcuhEWXeTpdj8entxG3LldYTQJWpAWs0KDCq28H8XtdtdvlZfsj8JeuJddTv/gRvp+HssJDP11VxDtMG4hQtA9wAtIWEyx34TgF3zwzkdx50p27l6xF69sXQmMWjiR986J7DT/MJ3Iy8ZOkwAJkAAJkAAJkAAJkAAJkMDxJdB9+/m60rfULXNOXTU9dccUEG6dWjMH5Y49k1bMQQ0TW32gUYFMaoJJjTJkHijVaDTr+R6CEpZN9DZlptAT85p/T/3zBKet38NO4KC1lR1AvM1xLIs3tp1AKyXLRIyF31dctohCUEhewJJ5lm1Xfqxz20qUQheTAMlW3hfzvfHxvZ3YMxL4aAJPxFzJ0D0Ucbu4BRFyO6FX5iRDFztLYZL2Ioqj+d32gbto/sbl4R+yFftemsTHNhYHA3hzEcEb59m5VdEP+BAo7qt95VFnbbDowysLr/jNe5vx8jYculLw8B3m5n70hWKLz0KAf6g+Cz1uSwIkQAIkQAIkQAIkQAIkQAKnnEAn2MoXi29ACEW+7e2d22ZekMwtXtLF/kN7MHEWaipiZme5tmak3L6Z5ibUVpclQhLaqlXTEtXnbXIxV/v2Vb+lf0v3zGq7G9ZMbnq2MgtdDILVRTcW4XZWhEwkWykw5owzmeTZYjqD41YkWytt8MYXUi1kW5nuipGhFQcSIIGXj0An2MKHK2LtbFpycz3mELUAh25IDaZFyO0+uREXL+IW9kMdJmGUHmfn018Wl9RtO9aPxHaLF5TxQOUer3NRYhfKvApDPYySn1vZ4O83PvSzqZciaLc2VLwKMVdfl3xeDiTw+ROgiPv5M+UeSYAESIAESIAESIAESIAESOClJ/CMeIv4gw21Acdtz4hwuw/htoRwu1qt6FF9YJfaBTvNFXJtJ9YidzbpdpZr69Ig5KlnDtwrcaov+VH4Kr6//JrOUoWcWzHmKkixeSfGQBuBECsZtVJ8TMqNIRYBRcxMQo4t5uDZPXTewo172A5tpb3s5qW/IDxBEiCB9xPAyxRcuHDcwiPbRsnLFTFXRF3J1Q0oViaZL/IBD8YQdGMYxZ12398rXjd/F/bi/eIr4R/U0N2rVIngFzfOdeGLTAW8Gvn98YFvixgG/aXQLiuowCpcarDPFRzlGl6wNIugvf+CcP6zEeAfss/Gj1uTAAmQAAmQAAmQAAmQAAmQwKkh0Am312cxCVfXrh4VJcsC4mWjNfvbCJmF23ZZCpLVCnqtcnWYHubaBuTapsNcW41cW7XcvKv/hZ/Ey7pUg3khMuVSdRSBALKQWKCt4N9MvHXIsbVJQhYQlYCiZM5IDq7GFIRbSDGIUhDnLaY4kAAJkMCcwKErF2JuELkWXtmAjAU8iztXxFyELXQvcHg1wXSchF0Re9u99l52wfyNLdV/dYP0i6x2u1lTDfMi+TyUbex1Dt+wW+6Hfh+5uX6Wmzuq18LlbexXYhau46jY7bwrHJPApyXAP2yflhy3IwESIAESIAESIAESIAESIIFTQqDTNuaRCWvK3tm6YyXjNqsyO5SoBNQV0/Widq2y9tBxm6TUWOkH3tSVsrHUU/tau2V/O5VxNeyrNSTWlqY0fai+KGcGsRZu3g4ncm0lEkEcuMhfgLs2GayDBiIyrhQgEx/ubAyjm4i38r6W721Pyb3I0ySBz0wAgi72MSuFNnPqenHs4keefSftdi96CL8NsY2IW2jHfs/29E+Vi3+fXdL/2e67d02j9weuaNE0FlnVQqmNsexcutE3j+DObcOoHoXLv4HM3O9gz+8wM/czX7tTvgP+oTvlNwBPnwRIgARIgARIgARIgARIgATeT+AZ0RY5t2pD6Xlcgoi3I1U4EW6z2lrkGbjWm0xiEqLTRdQwqGVxoIZhLUzMl+M0fbU9iF9GebL+Ya6tFB0rIMW67rjinsUEYhHgsNXIslU5QhJyiLgZXLVd8THotKLUipkNPwhPoNP2/ZeM8yRAAp+GwFzQlTFe+DBIzEIrRdAwbiDoisCLz4tSCE0apyaOm12/Zc+pv6i+lP5KDfV9fKbUlN7WmVtqo5sExDaEMu+37UC1ErPQPlJx6lS8C2fu1XdUwKuZvORxIIFPTIAi7idGxg1IgARIgARIgARIgARIgARI4OUkIN8yfrZA2RXdU3eQc+t0Fi6ag9G2zafWruolN9VjV3ttfWwyM7B9n7crad+cM5VZ9O+m3451egvCbQ8hB8iuVYUQw9eURX4VJ22XYgvHLeoGdW5baMKYQjt4eiXjFqkMWCtt6bJ9OW82nhUJHD8CkHHFoQsJN6IMmoi5EHGjCLpRpvHcya9QdEdpu93zW9lr+oeqDP/V9fVPTMiGvVgdZCG1RVYiiUG1tdr1g8qHNEjpbO+s3/jZRlxfXw/MzD1+F/8k9Igi7km4SuwjCZAACZAACZAACZAACZAACXwBBI4ctzchlsJtu7m6aR/60lzatxpBB9qMzms9ltpiO2bUWOtKY10w2di0iEqwvdo0C86ZXI3iq80D881Yq18zmSlMoQbw1JadexaiB6Rh/Ot8tCLNYufw20IXFtetOHLhwkVsAuY0HihUBqfaLFrhCzhn7pIESIAEPoLAkZgL0VYkXOTmygPOXA9xt3tJm+3Bj+OOPwgPs9fU3/i9+F51Gdm5++694M3Bgjhzs3HwOvpKD3xrENUweJi8gy48CunixYsBr7tdtANzcz/iinB1R4AiLm8EEiABEiABEiABEiABEiABEjhlBES8vXH9hn5n/R29sbFhe6oH3fVJxu3KdFkflBBvkVNrhspM9AgJB8Y1ue+rMi1p2/TM2F5sH5hvtMP4BtJvezZ3PZQaK6DZdgIsHLcSlABRFqItfiDhQr6FzxbLOncuipNBtJXsW+TcwqtL1+0puwt5uiRwAgh0ztwkbtwGcmuTgkaxMil9Bl8unvXMnRvDJO2GgAjdfX/Pvar/wl6IP7DDbKsHMbdNeVNkiFhQfT/EKbfFXlgsl1KbK+/dVnx/bq5QYeTCCbg3XkAXKeK+AOg8JAmQAAmQAAmQAAmQAAmQAAk8TwKd41YOeF3pW+qWubp2VW/Wm8YtXNbjnz10pRQn0wZ1xJBze5hxawKiEipEG7i2CqbutyYWbmjP+4cQbifxLVuYni2NOG6lMBn0XhkkL0F+MMBrC9lW3LbYrbhttUWJMrhsJSYBSzDG86xQmWzFgQRIgASOJ4FZUm7SXiIVoN5GHbVELkjoQo05uHMRnIvl4twN47hbP27vmlfV98uL6Qd6kj+slPP4zGqcaQjCuvJlrsLuaN/3Vhd9sA+jd2fjWg1puIBUvILHNRUp5B7Pm+FF9op/KF8kfR6bBEiABEiABEiABEiABEiABL4gAkdRCbJ/xCXc2rilz6lzRly3+/3K9kaZnRcny1GYrIF4ayCuQlV1o3I8iEYt6CpW5sC+1jxI30AG5BsmNyWE2x5k2BK6qxFDGkTaLuEWfloRbDtHLcRaOG670ISsE20lKkGJYIu2s4e8F+X7Ubk2HEiABE4MAbyuSnVF8d/CkatCRBkz+HFbKYcGQbfFGlkuZdJiOw67Hrm5+SX7o7iv3rWvx//sGrdrJ/qgD3du7FW+KFS7gzJqg74KDyeP0uLyK0HE3NvF7Xhl60rQ17XELXAggY4A/2jyRiABEiABEiABEiABEiABEiCBl4TA08LtzW/fNNfevtbl3JbIubXIud0f79uiV1gzXdErekliEpzz/czndTGK474pU1/ZWKY6f9VvpW/6afqqLlTfVXaAEmQ9EWRRV71TMcRNK8KtRChIJAKEW4QlGIPV0IK7t5ryBIEX8Qniy+VAAiRAAi8XAbzcITNXwhXwI7m5UQqg+S5D18vnVZ2aO417fhS37Wvqr8NOvNv7Svp7e+Du4ksMwxzbBYVX6L7yB6OD2CtieKxjXFjwQQqhqQZ73sLjuuSK49WXw6kmQBH3VF9+njwJkAAJkAAJkAAJkAAJkMBJJ9AJt3IS8vb+sEDZ7bXbutqqtLhuK7huRyF3ZgqLrVo2eTPqXLfWIy4h1llcyBZj3izoqXrT31PfaEfxEqISKnhuB8bBcQvhVnaNLFtEK4jbVudYkmMdXLdmJt7OCpF1QQrSFQx8rznjwGcSIIHTQKDLzoV8KwELkp0rUQsSs4DQBXHuYghxEvcRxRDaXbhzX7XfsxfDX5UH2Xv43GwvV4hZUFWci7ktxNzeuSXfYg8jOHMvb0PIfQeeX00h9zTcTh92jvzD+mFkuJwESIAESIAESIAESIAESIAEjjmBTsCFwnrjxg39LfUtI3EJDyDcXl6E2hoykyEyYTi1NmuNzYLNTF+7YZDY27YX8mZgqtRvf27fDlH9N2mi37A9GHThuFXiscW5i/ULTlqH8mM5tiplLKKuLJM1EBSkGd9XHvP7hN0jARJ4TgTmztzOgisSbkLkAvy0XsGZ2w0SvNCGUdypd9r3svP6e/YCxNxptpUaM15wRYhV6cNk5IvFfuOd6jJz6/ps2N/fCOtq3TNi4Tldy2N4GP6xPYYXhV0iARIgARIgARIgARIgARIggV9F4Bn37Y1ORDWbq5tWYhP29wv7qkKygVo1k4MDlxXQcCHcoppO1pa+54q4hBTHy/5e/IYfpddtZRZRfqw0LpVdTgLybEXEhc+2gHBbwL4rcQkZhFvk23YFycyv6hvXkQAJkAAJgIAIusjOPXTneoi3+FHIz5XsXKTnwrIrYm67175nz+vv519Sf23HaqtqF3adK9qolW9b1dZK+UGlQrtMV+5pv68o4p72O4DnTwIkQAIkQAIkQAIkQAIkcCIIJCisaibYKrUO4XZjJt7eUXdMAb11pAonhcrcHh6IwHUoVCbi7SQ2hSvTYshiL9X2y+Fh+p1Yq7fsgl2FcFvh5Gffz51l1xqItjnyb3PEOWadAxfjTtSl4/ZE3CfsJAmQwDEjALVWYhQg3HZxCwhckKTbBoJukFBdjRd3P467iFl4155Tf+FeM39ZjvV7WVMNM6wqsqpFdTOPimm+Pas83LmxzlV83NwOV/7XK54RC8fsen+B3aGI+wXC5a5JgARIgARIgARIgARIgARI4PMg8JSAa9Sa0pv1ppm7bsuJE8HWWBQqy1CorJkYZyHFNpXvpTwuqtwvp63s14OPb4ehumQGBuItRFopOiaRCFaybk3eibcWbltx4Rqk38pDCpKhzedxDtwHCZAACZxqAk/EXAi4KH4mubkeubkQeIULCqTFMArb7c5MzC0h5qah3yrV4m6WlRByRxEWXt8zqHqmVZw7c+9u3wpX37nKvNxTcHNRxD0FF5mnSAIkQAIkQAIkQAIkQAIkcDIJzDNvu4JlO8rc2bpjxXW7P85s0YN4O3fdQrhtEX4gkQkqa6smbxZ1oy/5++obcaq+YnpmCWm2lbamQIotfuDqldxbiUvIVAnBVly3knMrAq7k4Yp4K+8X+Z7xZN467DUJkMBxJTDLzRVXLkIVVIh4IFmhxbOHZTcqpOaGcdxutv1d96r+Xn4h/MBN3FaMZpS3RVhaqtr9sfLFqmqQtYD4XBUurWHrLRQ+u449cnhpCfAP8kt7aXliJEACJEACJEACJEACJEACJ5XAB4m3jyHevl6hUBmct1ltbe5NZhGZUAdtg9F5LMNirJqBGqlL7UP99Vinr9q+W1IuIjJBFFlk3VoItHDYKtQ8Uy51ebcG6QtY7g6FW7puT+pNw36TAAmcLAJw3uJbFnhAfI0aYq7IuVqiFmqIuliloh/57XpXMnPT94sv6R+UB9l7xpS7mS9bn6t22qi26qu2tXfj/v5+WF9fD+qaioxYOFm3wsftLUXcj0uK7UiABEiABEiABEiABEiABEjgCybwtHh7e+e2ObN1xlb9yh6MMjvPu122izDgTvLQNrmubC/kcZAqv5B+YX49BP0bYZzesAPk3WYK4i0ct+K5RXBCcrqAXFt0gq2ULUNUgkQndKIuHbdf8JXl7kmABEjgVxA4LIImxdDgxpWQhQaeXA8xV/J0YxyHnWYHztyz6bvmgvm+GZl7PVXtS8xCoVWzo/fixLS+n73iL15U4dbGrciIhV/B+4Suooh7Qi8cu00CJEACJEACJEACJEACJPByEDgSbnE6N79901x7+5refLxpyzdKM2pLV8B5WxxY5+CYNb5vh3YK8db3VJaWQ5u+4h+kb4QRhNtKL6ncoKRZKiHbSpptV5hMZ5i3CEuQkmXixJ1FJYisC9ct3xK+HHcRz4IESOClICDOXBRAg5gLARfiLYRcFEJrxZcrom5EZu50p72bn1f/yZxTf5635qHVvf3Mh7aFcbcpQ1hYWAn+4VbcUTt+Xa17Riy8FHdGdxL8i/3yXEueCQmQAAmQAAmQAAmQAAmQwAkj0Am416GkruOxofQGio3t7d21q9nIZfqcgXXWSWyCNzYfN01uqzgINvV1q77sH5pvojTO12zfrEKureColSgEKUNmJe3WlKoP6bbAPAqUQb6VNfLgQAIkQAIkcLwJiCMXsq3ELEDKDSnoFmJuo2V5iN4fxPvRhb/DS/4P89fifzJD92hRFT70Kl9Wqn2wv+37atWPVjfD3e3L4ep1BDXgk7vjfdLs3UcRoIj7UYS4ngRIgARIgARIgARIgARIgAQ+ZwJH7tubykhswpWtK/qOumP2h5W9ODhvx3v7rnA2t7rvhu1e3trYg7J7Jm2l3/I+vh2H6XU7MCuQZwsIs9BokwQkIOu2i0wou2Jl1sB9qzIKt5/zxePuSIAESOB5Eehyc5GSK85cSLkpqCa2aiJJusmnut3zW2HJ/2l5Qf1FOc7ea6LaW8xWWthy27JUbWPv+8loEh6vXQpXWPjseV21L+w4FHG/MLTcMQmQAAmQAAmQAAmQAAmQAAk8IYC33FrdgKQK1+1cuP0LuG77FzLTGx1YMzkjmQem8DZrg82CReattb1UNUthqt8Ij+G8jfptU6gF+GpLg8gEiMGHvltUPct0CRk3R2xCJlEKOJJ9cnROkQAJkAAJnFgCs6xcKYCGeIVUd2KuT62GlNtO4kG7g+JnZ+Ofm9fUX9hJul/Fpb0Mcm87iL5nFvzW9GHoqbN+rFRcxwMcImMWTt7dQBH35F0z9pgESIAESIAESIAESIAESOAEETiKTEBUwobaMA9Uz1xedBqVxG05Ka3TZ8y0RV4CMm8dchNEvG1t6Om+Xs5a+0a9lb4Rmy42YRmyLJy3Uo5MIhMg1GYQb53O5+KtsilDGu4sVuEEMWJXSYAESIAEPpIAPguEI1eKnoXUSl4uEnPbbisReUdhp0Zerj6r/txeSP8xG1cPM1UPnXqlqdUu4hWWfezfT609H6duM15+9bLX39bhI4/KBseGAEXcY3Mp2BESIAESIAESIAESIAESIIGXicCReHvovF2ql0y/6Nv93cwWk6EdK4c8hCXjxzYfaOOGsYYoa6vGtkvIvL0UHplvhDp9zUlsQqZKpCZI6i3KkUGoRWyCxeNQvHWSe6tMcl2ywssEkedCAiRAAiTwLAEpdiYCbkw+Im4BYQsN3LkzMRfL2n1/P9jwt1jzw/yi/65pyy4v1+e9NjUHqV4Kvp8v+72g2h++qvy3KeQ+y/cYz1HEPcYXh10jARIgARIgARIgARIgARI4eQSOxNtD522+muuHvjRvhsyMQu7yqbWuNtYFg9gEk4XYZG2Fb7r29HKs1ZvhXvp6qvXlWeatKvCmTcRbKVaGzFuJTYAb1+FhtEOigpV1oMT3difvVmGPSYAESODTEkDZM/hx4cAVMRfhCKETcoOuJS4XRS8nyMu9lxb9H+sL6nvZJG51EQtZbMu233qlfL2m/NoWxOB17OPb2AMLn33aa/HctuMf+ueGmgciARIgARIgARIgARIgARJ4WQl0wq3U/T7MvN3Y2LAi3u5t9+2X4bg9mDjEJhhj8fATm+eQYn3Umc/GfVWqJYXM2/ax/iaSDt+yfb2KcNxSCpJBuDVIvc1NoQtMZViSQbK1yMN1zLx9We8mnhcJkAAJfGwCUvoMYq6GkIspCLqz4mepkeV+Evb8XnxXrcb/kJ0Jf1Y01SPn8jbLqrZp99usv1hPRiqM1UZcX18PjFf42NxfSEOKuC8EOw9KAiRAAiRAAiRAAiRAAiTwshB4umCZ2lBacm9hqzX7/cr2RplFzoEpDqxzyLyFJuuGxqD4WNvzZbuiW/0Vf19/IzTpq65vu9gEcBHPrfyUSLutjDMZIhTEdTvLuoVdCm34Xu5luYF4HiRAAiTwGQngg0T5LNHDUxsU3LmQdX1s8Z0OpWPEVLvjfxGX/R9nr6rv6r34no75/vn+6vRRs9v2VesRrhtHq6Nwd/tu+L3rvwejLofjSIB/+I/jVWGfSIAESIAESIAESIAESIAETgSBuYB7S90y59Q5I+7bEtEJo3ulK3rOZrW1uYfrFnXLxHnbmnEv9dWimao32kfqd/AW+y07QGWzzJRw3EKkTShXpnOTI1zBwX0rc1LGjKLtibgf2EkSIAESeKEEJGQhoVhZF7OAYmctymJ6NZVCaGESDtq9eFev+lvFmfjHpq4eLWR56+vY+iKGQtXNSI38JXXJq+sqMF7hhV7JDzw4RdwPxMKFJEACJEACJEACJEACJEACJPDhBI7iE25CeN1RZrPeNG7b6Qru2wO4byX3tvC2E29jaooGBct0r102E/2V5kH6Rmr0V93AriqXqsO8W3Hf5lKwrHPgIi4BvluJTBD3LQcSIAESIAES+PgEELIQu6xcZN56VUvEgsi7UhCt3W5/7gfN/2PPx+9m++a9qsj3bZ3X49g2w9D43pfP+8vbcPS+AyFXawkK4nBMCFDEPSYXgt0gARIgARIgARIgARIgARI4/gSOxFvJvkXBsc3VTbu3vWcr9WWYZ63Jp0ObtSs2KzBC0bLJpCnUQlrSKf5a+8jAeZveMn27isYz8VYKlsFxq7L0JDZBnLcz8Zbv147/LcEekgAJkMBxJSC+XC/CLcYIWtANfLlTycqN07g33Wnv2uX0p/kr5s/MxD5aqPIGwbp+MvHtTjVtr6yttWoLW13X8bie4GnrF/9TcNquOM+XBEiABEiABEiABEiABEjgExN4RrxdV/r2zm2zVC+Zcb3geqMDO0TxsrP1mVl0QmPzsWny6OLALocz8Z77rbCtfs8s6fNSsAzGJtvFJKBcGcTbHqIUcoWiZXA8GYi38h6N79M+8RXiBiRAAiRAAh9EAGm5LeIUAqRYHxGroLyu4dIVabdpdvzPQ7/9I3chfc+O0v1eUxxMbFO7omwLNWnW1JpHXFC8+s5VunI/CO5zXsb/HDxn4DwcCZAACZAACZAACZAACZDAySOQricjubcLawu62rqie+qOkeiEyWiSObVq2h0x35rcrLkkMQAAQABJREFUJ5M1ZlSaBb0aHpt/Ge6nb4p4awo9UHDYapWMzlSO4IQellVYgiJnKjt03p48MOwxCZAACZDA8Scgkq3qyp6FiKTcLicXhc/gz0VWrj9oHvufp5XwZ+5c8x/LJn88sLYehmxawZE7Wl0Lez+6Ha9cuEJX7gu+0hRxX/AF4OFJgARIgARIgARIgARIgASOLwFx4N68dtO8+d++2TlvJff2sSrMYJxZKVxWHFiXoXZZF50A922rmyWr7NfSjvmmCmZd9+Kq0vDfisPWKQcHbo5yZT1k31YG0yLs4uz5vuz43gLsGQmQAAm8HAQkXCFqJCYgYgGO3BiQldvEWmMZHLq+QbxCGDR/VKxCzG0G9/sQcYvBoGnVQz9SZ/3jtdvhysqVqL6tIouevZhbgv9ZeDHceVQSIAESIAESIAESIAESIIFjTOAoPuGwcNmdrTu2E28riLeToRX3bTGaibfivm3tuGcW1Yp/APftTvx9u+jOa5vEZYvUW8m9hWAL4RYu3MI4k2F5DulWBFwOJEACJEACJPC8CKC6GVy5iFeQvFwpehaaOJExxN3U7vp3w6D9Y3c+fDcbFXeXyv64VaGpVfCFWsb4Tnz83uNw5Q+veBY9e16X7MlxKOI+YcEpEiABEiABEiABEiABEiCBU05AxNsb15Ve/7ub+uzbZ/U5dc70VM/sIzqhN8og3hpTDV3ujc2DQZatbsvWtSsmqDf8Q/MNvC3+9a5wGQTaZOC8zVKG5xItS0i5GeITxJXrgJnvxU75vcbTJwESIIEXRiCpgFzczpErAm70agpvbiPSbqzjwfRh+9P8K/7flzb9v1H3dvoxn5aFbx+pGPuq9pKVi757Fj17vleQ/3F4vrx5NBIgARIgARIgARIgARIggWNKoHPfQsC9pZS5uqb0xtYGsm97ph7XWdE7b7PaWj+xeUT2bWqbPC2lRT2Nb7U75neQLPg1O9CrkGmLTqS1XdJthdJlfWNNBs8tCpfhmYXLjunVZ7dIgARI4JQRgJArrlyUO5NohTa1aYq03KlKKsKVG+oH7U/TcviT6kzzH8w4ezRYWKyRxeDnrtwdteHX1TqF3Od421DEfY6weSgSIAESIAESIAESIAESIIHjSQDfL9UK0Qm3dxSybzfNw5/CPLtk9QDxCdVO5gpvswzu2yHE20aFKi2FM3on/7p/FK+6BXsW3toSsq2V8AQpXKYzyLd5goArhcsQpqDhy6X59nhefPaKBEiABE4rAQi2nZAbVQspt0HAQo0x4hUwhT9aza7fioP2j6pz6VYc+60y9qaZLdtiqW1G+Uqzv78R1tfXA3Nyn88NxAym58OZRyEBEiABEiABEiABEiABEjiGBES8xWDUd5QdPxzbpeHI9k3fOVO6gcpd+di56LPSBFvs2yaPGaITXLYe7uk/UI35HbtozkO6lezbmXhb6L4u8ch0D9m3OeITMmi3FHCP4bVnl0iABEjg1BPAt0PwLREj30Qx8tews3riCQug4UaDOp56ar5cP0qr9ktpp53Ece50QqKCboeP9ZJb0g8fPtQ/fuvH+g//hz9UN27dwHYcvigCdOJ+UWS5XxIgARIgARIgARIgARIggWNLoHPeSu/Effsnt0114Yre27trl5YKW06cbczYnfHLWaONC63JpXCZWjLn0oP422HbXLWL+nxXqEynQ/etyeG97R06ct3MfSviLQcSIAESIAESOPYEEgqdIRFXYhXiVEXdwJHbwo/bKFh1EbUwmdxrNt3l5v9UKv6wavPtfrE4bVP0VdG2P4Wqe2VtrVVbKjAn94u71hRxvzi23DMJkAAJkAAJkAAJkAAJkMAxJPAk+/aWOSpcNkThskFm86m1LaITSilcBvG2MaPS9/xSntyv1X+v/sAu2wum0Avw3SL1NmXw2eJHV0i9LbAsR3yCOG/5jcdjeN3ZJRIgARIggY8ggGJnMSInN0G29V1ObiNZuZB3sUyl5nF7Jy22f1KdC39mh/ljZ7J2Ypv6zFKBeIVRc79/0V+hkPsRkD/9av7n4tOz45YkQAIkQAIkQAIkQAIkQAInjEDnwH1bmY2HG25ldcX0s74d1pXrBeTeZohOGGZlmdkCZbrLWE5WtMrejg/0v47b5l+5M+51k6u+dtoZp3JTmp4u1YLNdYVl0H3n0QknDAq7SwIkQAIkQAJCAPFCyFSQCCDTRQHJsxTqlGJnEHFtzy2lob7QhqjDQvMwel+vVpXa8a32dZmWzWO1uLqo3q7e1jc3bjJa4XO+q+jE/ZyBcnckQAIkQAIkQAIkQAIkQALHi0DnvJW3kjeUvr122y7VS2Zve89WqjLlZM0i+0DCa52fwn2L3FtlbFkPJq+kh+7raVtdtUv2VRFptVVOS3xCjulMSeZtBs9thgxBO8u9PV7nzd6QAAmQAAmQwKckgHgFOHLFmetTk4JqUhMncOU2EHhVs9fciwvtn5Znm1vlvnvXGluPg5lmrm6H5bDNH+ft5d+57Fnw7FPS/5DNKOJ+CBguJgESIAESIAESIAESIAESOPkExHl789s3zbW3r+kNtWF60F73+5WdjA7s2ckZ3RjnqgnE21RnWW6yOmuXUMTs19pt87s6pLfhtV2GL2km1iL1Fk7cqsu9hev2ULyV91R8X3XybxWeAQmQAAmQwPsJzOMVYqqjxCs0EdEKqoW4m8I47LS++Wv3Zv3vsgP34zL2ptPYNnYwacZq7NfVeqP+TgVkz0fUT6Mr9/1sP8U8/7PxKaBxExIgARIgARIgARIgARIggeNPYJ59i56azcebFnEIGm8sXaN67hW1arKhcR7Zt+MW7tvMowa3WY0PzdfDdvx9u2jPG6dzvO90kHAzuG97sOtKbEKOL5ZK7q0ULeP7qeN/G7CHJEACJEACn4UAHLmi2eKnVXjEVk9UG+HIVTpM4349mX6/+qr/t2Zb/7TKEZDbuNr162Z7uF27gWvX19eD/rYOn6UL3HZGgP/p4J1AAiRAAiRAAiRAAiRAAiTw0hHosm8Rn4ATM5urm/YoPqFcs8Wec0WwRRtMNo5Nlqq0aNr4tXZH/a6O+tdN364iNgHJtxKgoAoUMuvDd1t24q3pipbxfdRLd8fwhEiABEiABD6UADJxJV4hwZmL5xrFz1rIuY2OKoRpOBAhN/u18H/Z7fSP/WJhOG3aOoVsWlXTdvR4FCRagULuh9L92Cv4n4+PjYoNSYAESIAESIAESIAESIAETgKBTsC9qcztndtG8m/H9YLrjTLrlDHFgXV56Yph3eQhmgxVtl9pH6ivqz39+w7Zt0i9hVibMsi3Vhe6gvu236XgSvYtKr6chPNnH0mABEiABEjgCyDwJCe3c+WqJtZx3EUrtHE63Wr+Mfuq/z9K1f6gDMu7pmqm9bRuJ3Hii17R3lF3/NXrVwOjFT79leF/Qj49O25JAiRAAiRAAiRAAiRAAiRwzAhcv37dfEt9y5xT58wD5N9+DUbakSpcPrW28DYL0RYxtcU094Ue2PPtT8L/aLT9TYTlriL7NkeEgoOEW+gs9UwGDy7KmCE4weI0+d7pmF1rdocESIAESOC5E8DnpPDjiis3IFLB61pychUcucjM9c2D+ifm9eZmHpvvl2551yXfTOO0mcQehNzhTMhVV6O+Dg8vh09MgP8R+cTIuAEJkAAJkAAJkAAJkAAJkMBxItA5b6VDiE+4pW51Au7e3qLtX8jM4FHu8sractcVrTX5BPm3qdcsxmS/FlG8zCj9T3ShFhGVINEJIt/2pXiZRlsIuMy+PU4Xmn0hARIgARI4HgQS0nElWkEycsOhI9cnxC2oUN9vNs2l5mYRmx9Urtp3yMhtXNMOw7ARR+7j9x6HKxeuBAq5n/xSuk++CbcgARIgARIgARIgARIgARIggeNBIF1PBpWv9a2NW3rhvQV97sJVvbh419px6SbvDm1ley7tu2qsm2zi20yvprPqkftm2NX/yi2q88i9zbr4BBFwS2TfIj7BSOEyum+PxwVmL0iABEiABI4fAY3IIaNV6lKGQrK5qaKKE+VVzM/nl5s76tr0zWi9P/jL3C7u9Qt8Ojqt4mQ8UWcunFG3124rFB9NjFb4ZJdWvhbEgQRIgARIgARIgARIgARIgAROHAFx4N76zi07fji2fdXX/df7ZjipnaurrAzO5a0prFbl2Cbk34bKnNVfbn+i/2ftzbfsonkVXtvKIC4BoQmVKc0C4hN6Bkm4CvkKgMFvLZ64O4IdJgESIAESeG4END7uVMloDEkn/NHER6IpBVFnXd+u+Hf1q/qMOrCxeWSDDXmZqyzLTDtp9VK+lP7mX/5N+je3/g1jFT7BBeN/TD4BLDYlARIgARIgARIgARIgARI4HgTwHlGr/w1vIHeU2aw3zd1tpxfUYzOoXrf9e3mWsqYMjctjbJFuqxej0r/hf6z/tTtjLyH5tlIuFRBt8yfZtwnZtxRvj8fVZS9IgARIgARODAFEK0REKyQfa0i4jarTGGOPZam+X//EfcX/76YdfX/Bndv1mW8nqm2MGjVqVdU//PMf+ms3r0U6cj/e1aaI+/E4sRUJkAAJkAAJkAAJkAAJkMAxIdAJuNeVvv3ebbv060um9KXZ3y9srqzxdZYthLZC5m1Rx1CYBb3aPlJfT4/V77kz7qLSyUnWrSkg5BZp0BUvk/gEvIPE6fH90TG5xuwGCZAACZDAiSGQpLCZZORCuG1R8qyJdeyEXFleP2h+Ihm5NrR/VWS9/X6000epbmKxV+MMm/X19aCuqSiG3hNzxi+oo/xPygsCz8OSAAmQAAmQAAmQAAmQAAl8MgKdeIu3eDdvKvMmHLhLcODubfftYJzZonE2uDovzWIekykmZjLQMa2HbfUtHfXbtm9WtFOISlAGAm5fl2pBW8nDRTkziref7EKwNQmQAAmQAAk8SwB/oiHjRjhwQ2xUUG0SR65XDZam+kH9Y/t6/W9dVN/rq+zAVa4ZqdG0UEUzWh2Fy9uXg7quAh25z0J9/xxF3PcT4TwJkAAJkAAJkAAJkAAJkMCxITAXbtUNpW/+3U197e1rekMps4fiZUv7+7acrNm8staPbB6bJo+5yVrVLiF27zeRf/u/ZKv2NQi3BaTazGTIv0XhMlVoyb7N4btljZBjc6XZERIgARIggRNOAJG4GCDk6gA3LqIV0jQOY4CUG1Wavjv9/4rfbv7Q7th/qIypbbLT6cK0qeqqhaDrL6lLXl/X/oQz+EK7TxH3C8XLnZMACZAACZAACZAACZAACXwWAng7qG9++6Y5+/ZZvbC2oJfqWXzC6N7IZfqcqbzLom3LcWtzbUKpl/RKeqi+6Xf077sV+xq+nekg4kKy1QVKli1gXBqjJT4BBVk4kAAJkAAJkAAJfI4E8Nlr58n1KcCL26YGP4hWSCH6NK0Ppt8pv+b/nXmsf1LmZup6rmnaph1Vo7aYFO0ddcdffedqYLTCB18RfvL8wVy4lARIgARIgARIgARIgARI4AUT6Fy4+G7l21ff1o/dJbP0o7Epl0ozule6yiy5NG0Kq1U50bbQWbMUlVmP9/QfqNb+rl3S55F9W+DhTKHLLj4ho4D7gi8pD08CJEACJPByE5CE+e4HQqxO+NEoGiruXHyAavGZ6rn2QRzotbAVvRrattI+GBh3M+2rcVpeXE7/5f/+L+qNq2+oW7duMSP3ffcKnbjvA8JZEiABEiABEiABEiABEiCBF09AHLjzCIU3V940XQGzn0LAzUTAzVwyWRlrxCdEk4WiXVH79nfjXvrv3JI9j6TbShm8I3Qmg/sWzTFvFZy6zL998VeWPSABEiABEnjZCYgdF/ptSAllznxsku88uWNk5Xo/DQfNpP5u+Zb/99We+akpelOnfPNQ1c2ZflYfFAe+y8h9Bxm5LHb2zK1CJ+4zODhDAiRAAiRAAiRAAiRAAiTwognMBVy1rvR0a2qWiiUzHi247XbszqjFrPJZqaPJ2zbmadGfTbv2m2qo/3vEJ1xE8bIS7lsJTyhNqfsITugZhznYf3BeNLG86IvL45MACZAACbz0BMSKK35crZKUE8W4+/urkY7bSlFRfEnmfH0/9t1a/JkJfgogeqCy1OrW9Kt+2iq30urPV9ONmzfoxn3qbpFKrBxIgARIgARIgARIgARIgARI4FgQ6CIUbnRv9ozaUVoE3NKVJhhrlvtn8ZVMV46iKRo/KvVqOt/ecf+T1eafmUW9omxCrILKdG7gvlVVgpiL944Oe2P+7bG4uuwECZAACZDAKSLQybhQcF1yBs7cGFFStNKtmqQSn8iG/J9PH7T39Cvxj9PUP8xd7rOUpcn+JPbrfkRJ0ihl0ujGfXLHUMR9woJTJEACJEACJEACJEACJEACL5BAJ+Benwm4G2rD5HWu+2f6dvS4cKnJMt23BeITiondG5iYrce75qrLzG8iLGFZm+QOi5cNIODCeYtQBRFvKeC+wCvKQ5MACZAACZxyAvINGLHiOiTUIyI3SEqu1v8/e2/+Y0eWXondLba35UImyWSxVFksdreU1ZvMtgz3VuyBPAIkzSKPSQHzB8j+L0j+4l+8wICNgQHDHtmSPEYnxoYxwggatQZs2IbVarEleVSppdndrCoWk2SSubx8W0Tcxee78V4yq6q7q6qryMrlC/JlbDdu3DgRL9695557vlIOTVss2l3xKyNR+2ze/UGw1huRKJcI4efScHfjrl9ZW/E43p1wDPcvn4cT7UPBC4wAI8AIMAKMACPACDACjAAj8DwRiLYJdEJqlWDA5No1oS7+8m01V86pTfjftnWiWp1E+70kbVd1Ps51VumqB7nt56sfhatm0byoDNS3BqRtpvBPdAOW0VrUyJNy5fYO4csTI8AIMAKMACPwCSLQeOQK5xHgDB65JUwVxr7ypQzCl0+qN8zPVf8iUeI72iZ7hVHjWtSVaqsx+ePe27rnvi2+7W/cuEGE7ome2BP3RN9+vnhGgBFgBBgBRoARYAQYAUbgk0PghryhxLeFXFtaU6+KV+WrIF5H6UiP3hyZLgxu4YmgQz/NWg4ErrCZzcK83tVX3Kb4DbOoV0wmW4JUt/C+BYXbldH7dt8+gQncT+7W8pkZAUaAEWAEGIF9BGK/Kilw0ctKfzFORlHnLTS2NQyQ5up74pxv28dBjB91so6VMFGo6kqMxm2xsJiFl+Zfkue/dF7cunXrRHvksp3C/iPFC4wAI8AIMAKMACPACDACjAAj8LwQiNYJdDIEL1sSS1KsC/xfV+OtBd1R82pcDXQaliC6LdNxrVNX+AXRV6/5kfo1ELjLcNjLiMAFeduO5C38b6G7Ze/b53UD+TyMACPACDACjMCHQ4A6VzUCm2EGWjcly1vhVC3K9HT6UvXEf1W/LN4eDAc/UqHldQJP/NzqYgv+uIuoLry+euKVuFzJ+XAPHKdmBBgBRoARYAQYAUaAEWAEGIGPAwFoaW6JW+r29m11RpxR4HDV7m5Pzz0ZGihwzXyylAdRIYCZy8UptyRG+u+JAQjcnjoL/9tEIbQ1aNs2nG8LslNgAvfjuCmcByPACDACjAAj8MwRQDxSYUDmpvjXwq85ftNlkpjsS+X39T8a52HZukGSVGVSTEwyFJnB8Bx59dWrJ36EzYkH4Jk/mnwCRoARYAQYAUaAEWAEGAFGgBHYRyD64N4Ukgjc7vIVOVfeif63K3Na9keJdnWa9ERd2KCTSrtczYWz9Q/VbyitvmTa6jQ19qC8TVUm2xJ2CmgIpsic2zX7CPMCI8AIMAKMACNw+BEIPljYKVShDmNf+pHwwtmBfezS6v/MT03+jZwUjzrKlJN0UibtpCR/3EvnLllxTXjoeE+krQJXdg7/c80lZAQYAUaAEWAEGAFGgBFgBI4FAmShsHZ1TS29uiS797vyUTanPvdyroYPhiaRZ1RhTeJ8lTlt0pGYtJVNfl7syW+AwL0M39sFBfsEULipTERLpSpH+DLEsGYLhWPxcPBFMAKMACPACJw0BEIkcm0oQeeWfuIHAR65dqfe8O3q95Ne/S3js62WUuNJd1Ili0k5LIeOiFx5TbqTBhZdL3vinsS7ztfMCBwjBPajWh+8Jqh74ur1aJXe7DmwDUbq+7120Y9vtkZH0TLmJ7VnrwGL/zICjAAjwAgwAs8agSuiOL8ufwGjKfv9TFNcsuCqLIQ8m1ifhiJ0k5B9rnoz/CfJonpxapmAYZcgbrPQgqNeJnUAgStZlPKsbxXnzwgwAowAI8AIPBsEKNCZCVrAGjfAI1fZMPHOLCTny03/H9WtsBFE+We179o0LPrR9iO/O2kLdOeSmS5Cnz1t1z+b4h2+XLnSc/juCZeIEWAE3oXAPlH7LnJ1NhxzP/l1IW7dvKWuvHal2bQpwppYE1fx79b6rfi+uyKueDEjd4nYRTCVWZr9fK5GKrehdmdvyRnRS4mmhPBNLFy/fv3gniaL6TGHhQiORDVKdljK04DEfxkBRoARYAROGgKz322yUSAP3BbEtCPRNvnY6OCSrBhV2UjbVHQRpfqx+noYyL+fLqgLQkF3C/db2Ce0VC7a4H1zBLfW+GHj+B4n7SHi62UEGAFGgBE4fggEkLI+1L4GhVv6gajFxFd+XI4n/0/7Fft7SV9uKN0qR76aqLlRpSaqXFldqU+iGndGTxy/h4CviBFgBJ4bAjOSMJ7wvZTm+5fj4JtodjwRpdcbUra73D2YIuZ3+dOXw+2/uy0vi8v7+a9vrMt0Md1Pi2EWAVGuwdOuijsP7sTtl7JL/ra4jaMui/WF9f20+5lMF1a3V0NMh/Ps7/v2/hIFYhFXVq8E8MMBXO6Pn0AQ7+9Yj8RwXF3D9qv7Oz74QiSb16+Gd5DQP+nwGVFN+xssw0nsqfxJ8PB2RoARYAQYgWeLANUNDnYehhtBUcfp7W/dVsX5Qh4kcOWkzjOyT6htattqPmypr8mx/lUzJ5ah0ElB4BoQuB2Vq46AfQIyZgL32d4+zp0RYAQYAUaAEXiuCKCj1wlYKkR/XNgqeAtSd+ieuGLyr4oz4o9bNnk0rtS4TOt6QZjJptisVq+v1ietjfuUYHiut4dPxggwAkcNgX01LBGCNKEhdmtdyCuvYfnvmm1EoopVokzFPmkqxCVKjemOIFI1LoFQpeiSQqxg9S5t2p/MNrZfEEJva7nZ35SmZeSSWBJb+XS45GMkPY0P5qdojmlnuCPnx/Nhp9iRaqSkypT05VyYb4Wwhf1qtCPFghDz5XzwbR+ePH4Sjzt1+lScN2vIL641fyjNYmfxKYE73ee7Pm57+PChWOotBTd0wS7Yd6VbEWb7XoMTriVO96ZzzB62ddx3dsE1xx3Y9zRVs3Qw75W9lbB+bj0QwUx790lohPNeXV4NDf5Ypv2fBmkMJfI78iMi+SC5SztRkoON7Hekx8qMoP9pad59DK8zAowAI8AIMAIzEnf2OyK+KdTtbRC4G4Xc3e1pnwzNC9VZHUKS+bpMS+GydMGfto+TL4uB/BUzp5YpeBk0uJnIZUcjiBmo2xSNNVLfNr+xDDMjwAgwAowAI8AIHBcEQOOGWrhQuTKM4JI7wIWFeqt+O3Ttv05OlX/UFr3HSeLqST0p9bKeLG8sV2jfupNE5HIF6Lg87nwdjMCHRCA2qt5J8TU5HCBpIWKV4jUhSPFKja5VELQzRSuRs0TP3u3eje+RSL6CfdXtDan6Sj4ZKgnuFf9BwA4ey1Mz5hVzVQjZdztqIZuXe5O+7Oa9WBI5EXLo9yCz6YphNZBouElZvdfrTiYjGdJWGFWjeO4WzHKo8LLGeqvVXMdoJIZYasfV6TYxavbFv822kL6L6JylGA5Fa/8c8N2ZTiGFXc+BKWTN8aF6ur2Ti9CfpunmIfSx4jE/cFhc9CVt2xFzrbmwHbc0f+fbECFtEf0shMPy4iQE9DSKBbPgiTSOOw78ubBwIdydkuEr2H4XH7tnQ3WuCriHRLi/l9id3tt9orexkCDV7jun6wfwAdrvJnP3G+c46t373plRs0bpP0i6H3csb2MEGAFGgBE4Oggc/H2IvyQ3hf6DJ3f0vNlUc3OXtHs4TuZ1qxgak8pgM7UQztof6H+stP5F+CwsKgPqFgHMVCG7+NuOAcxIgcsTI8AIMAKMACPACBxPBOBz672oocGdhEqM0MYe40JDtVn/SJ6f/PNc6e/1VDask7RM87rcneyWaAfbK9evnBgiNxIgx/Pu81UxAowAIRAbUUT7vYucvb08tSJYEPIpMdtQs0TMrogVcQ9qUg3V6CZI2bPIQrXgQAdulaSwO+MtuYhtO1DIqgk+GT4l+sCgkREgYeO0tye6WfcA6TilNns9QYTtoNqTHUrYadJLELdYwdt6qNogcMcBgyhpgEQhVDkuVZHnAr1uMhe5KC1OZsAbYkClxCsbQy9kLSqoczKRIssqFkCIlEzSXQilKEWapV44ETKToUylmCBNZmmZJlrL4xItx7UkD3Q+2ojBHeBrMy+SccjT3A3rEFoggMH1guxtIw/qKHw6RQK57qD7cCDaaSeeg4jppyl+/BIR1wf3DEBFt7N2IJLYgxx2yvsekb/zTSra/qR8Eoj4nR33RDwR88m892Mf3Ezti50Xhk/J3llaIntnthNE+K6+turFt7F3tSFvD1g4NATv9QOkLp6paA1xQOH7k3pB9xvzVEpcIRO5szvAc0aAEWAEjh8C+3UPujSqf2D0zvr6uu71enr4YGgKdc5MStsKsE9wSWglIfmM6+sr6P7991Sh5qUKRkCBKwvVUSlsFHT8dWQC9/g9KnxFjAAjwAgwAozAOxHwwmIUMPnjVhA9DbE0FlWYTEaT/yu7aP9FMZD3Zd6a6LQqtyo9XhVLFeoZTlwT/iS0Md9BFrwTOV5jBBiBw4rAOxpHVEhqIL2LXItlR6MJQlhJdgezofbpg1SaLSNNz0jd11K10WQSZ0HQggwdCAR6FkqFXXyUAhsqh1DCygp5xIko14asJGKSCEqx1+yRWaOahXNdVM8Sr0t7opq2xjZysANJKsVEUSgSDJGUskRAkqw5nkhYHKuIkI1krBLSilqpJDMy1Mo6IQ1iUNNkKQ4l9gtXS5EkAo0742qr4Jn3YyaLANbGg+x0AXNKYhWOw2RUEqx97yFGPSUqa9pta6Q1sFsHiRp8bVzi9o8yIiQuDSCTI1lMJDGankFgDEgA6RvoJwjrRALHY2gZ22g5T0QY1SLktJ6QmniE8SIghxGzhXTEhNkY6uJCQDVc4ADqh8QxdCylpalIioD7FIg0biGm93AwBNscQlu1vQfh6zX6MjEF8MAwiQ8Bqt6ZJQRtJ6J3eWE53BPwdMB/sm9YObsS4H6B/40FxsxXGA1wMV4eB/Ij3n+mkAdZOYgNlAvE7z7pS5kfnGbP5/RJ+kk/sPHZxnE/af/BLHmZEWAEGAFG4PAhsF9HoboJ6iGNB+5lWCjc04uwUCACV4HAdfDA7bu9Tq7zz9Vv6Kvpor4gkpCjfpBhnsEaCQSuaqFiQjULDmB2+G41l4gRYAQYAUaAEXg2CIDI9Qh0Bk3u2MEfF23k2g7d41BU/8qcLr+V+dZmC/64g3QwBq9RXmhfsGiPOnlDxrbvsynU4ch12pw+HIXhUjACjMB7EdhvDNEuNIjWVtfk0vqSpGBfxcJlmZK/LEhZ8VJzbGNrAE9ZKGjJ1kB7rXbGKqpmZ7lLqGf3dhSGM4Isg6CV9LG9uBMKWTSVBBSyMu1KCUIXFgUaolkwvfTBOuYlCNccKlioXVVF5CvIVhygiHR1UMukRLCCcCXi1SXWSGelQ1ESImaRUioLAhZpppPHUchZGmhsnMe+KRsLElP7Jx5DKkHfBupYo2Ma6S3NQX0S1WzqHXmGhlxSdpLSzSakJ75XwhRdnwqPfQVBbswDBT9A1M7e9CCupwRpw9HSdhQbgTJdbD16sL9qoX6CdLXzDnt0IA6Yyq2EqoM3QcbygzQF4UvkMcJsRh6Y2Ffra0nEMWJvBl8BASiEDUhoIod9XdngoUWalQtpIvHbXKY3FvwxkmUZiGEpwMyOfCEKHxJyK8bZQAa/2+phSDLh2dRuizbSDKPSFwQxyHmypCClb0uC7M1xQqh6OwsdIrwjDu8hfh+iqL1G3UuexbOsZ77AK1D1ilkwuWlgOEpzeQOkLyl7Dyh247HTHHBLprjPcuQ5I8AIMAKMwFFFINZbbuDXdkrgzn12TrW32ro/SjRc7JKeKIohFLgYXdJGteCL7s3kanJarYC8TfBja6C/balUdDCyJ1cqKnCZwD2qDwOXmxFgBBgBRoAR+NkQQIMZTW0bSgciV0zCAA1r53bshm/b309A5JI/LkbQjoYiq4zoVytixYobIHKPedtyvxH+s+HKRzECjMBHRSA2dmaZgMpaW1tTV8VVRK2aKi5JTQv/UrI/AB0mCgQPSxdnatoVmbiHagdErQZReypfxAjEXTUAtamgnkXjCM0fUsCCVITCs02Kzamqlki8qJpFGkoHElCWSIvEcd3pOsOCxmblXK2zJDXWgIL1IGaDM5Q5WEiiZDUoT2yHhJZI122zGLSPhCoNf3Q7conUNHbXxQAlICAl6Eb6G8sFVtPYbX9GmABDhmbbDI6YiIZQ/tRJCvjmgXomjpkmINosxMxARyIBtlpQuNg+TTRN8eFnHkzs7KgoDEKm+IGpzUJ4JCzx2sQtN+fBEJAymVcPQNI27g6RLQZLC7N2ueCe4CemJNIZP0yVmvdboFIrHQlsK4goDlZ7GXQdlcHa4IesDhDX1sa3oCqGX1AVbAJCN6QJzoBTaBj2Sshty+BTkL3otpxaQIhQgMAl7W5UAZOal9TRZgw4Zn7BzVURKRyXpl7BoR5CuVtA1Yvz1X3YOXQ8efnOw85hZ2dHePj5etg5zOk5TwrffWXvvXv7qt47d+6IaqsK+1YNdIL32jXQncJ/JnSbO8F/GQFGgBE4mghQvWbtKuoyr16V5IH7OZOrYZJjxMwkSW2rlWQ6GVWTtkr0F9xb+jfTM+ZlVF4S9M0msGZqqRy+ShomClgHAh/1Z/togsilZgQYAUaAEWAEGAG0f2GkQO142CqgDRqHolaP6x+pC/VvJ6n/004yv1vVru6LskoXd+tLW5fq467G5YoRfzEYgU8AgUjcElV2813KWgQPI4KWnGlpor/kTzsLGkbbdB+Bw9rLYEvhIkBK2cmO7MO7YA6yWtgTyKHYU91IzHZMZSaJtFJXtoRsMoMlQR395GpZK41wITVkqpB4GgeDAXCgmtSlaDHBwgDLT8ICZKEJ6OCg0Ziyu3IJvgQUFTqpd8M5oUG6ooFVEwGL7aAHiX2TaJSBV4xcHM2kThUZJkBbIxuSFpQqMcWRXAVjh2U6X44UUY2LtNhLx+MvTaAlKRHlH3dNt0N/GnfTvtkyNsS92IZNT/fTdsK8IQhpO5Jhf5MCa6Q5fr9pml9z9IH02A5uNoDRroiPBaPrSVmL7OgI0Lue1L90ejoh+F5spTn9GCElSkKpvcM6pcBeePwSKSwfQ9g80PPhESwmiHonurYCWfyEeiStszZdklsHSeVI/HodiPSNCmDIhMkGwnvc4rqGfNfUuD0gcCtImGEBgSIYnbhEJJDQInew8zTPDTx/JZS+IP7JvuGAnle0sI3WqXOAAszRMimAaTvZODjYOHSmNg7OOB8mj4KlgGzw5rVDWDXsrYR32DRAsXtr41a4Iq74fUsQgNLcq/e7Kc1+wEYI00Ef6rgPljunYgQYAUaAEfigCMT38Q0hb+F3/4xYV2MxNp3RS7pQCSwU0taw7qdeQYGbyC+Et5JrZkm9DAVujvoE/W2hptClugXqJAbnxFudJ0aAEWAEGAFGgBE4sQjApJDGnMa2MxG5NcwBEfSsHpXfzi5Wv9sa9u6ZpC7HWVom5ai8v3y/vvxbl+0Hat8fUVC5cnREbxwX+2ghEBs1VGQimmi6GRsmSiw3XrVRWdu9JLNqQ5EFQvSoHW4ioBe0nuPTsDvYUfPTSFb9ya6cE3NiIPeUqaUGI0pqWFWBeAXxhZGHQnmjMqdqGLfW0LeqTEMZS8P8yd7AwxYWdGYid+UCGNuW29Wn9VQpCx1Mm1SxpGylcf9EpM3KrrSigfg4lUS4MXgCNOQqaGS42mJ7/EcXGLlczGO5InkKzS7+RX6NqGIcQZrLZgtcCEDq0k6UOxDVCzKXDiWY6NzE36IQcZ2WZ2067KNMpojSrGFKKeN43Gxfc6b9bUTu0nGz42frlDNNdCwSUJrZOlLPzjNNMT0rrRFfTDSspwPjEshQ2h6LjQU6ES0TYYv9WIl07tTCIf4s4bqmOZJkmEqEVYvIa1jwDspfKk9THOFhDYGtVErsCzACnu4A8asX5CZMGvAjBwXwAhTAUPpCeYvt4Ymb1EO5KJ8orANqqHwDxLUKKl8ofLHsggHDT4YRpkp86sAFQ2gNfhbz0UT4LAHBS5YNpNQFB4xraqZ2o+Udwbs3boC3b0ig3pWwesgGIHXRNYCP1ZAw79R+fvlAwLV7jQcvBVcjpe6+3y4yuv13CLxH3rubB841PeW+Sn22TvPr03SE1ezeH9zPy4wAI8AIMALPFAH8ekmxJtQ7PXBzeOAmRvoEQzrqbCSgwA1RgXstPaNfQZ0gRV0ExgmyDf/b9tT/lgOYPdM7xZkzAowAI8AIMAJHCAFqMaMlik+FgaYDKHNL33ebNhv/H+0z6g9Tjzau6E6GeV2qyW55V9y1V65fwTDhg234I3S971PUaev/fVLxbkaAEfhQCIB7a2i5m5Fhey9Z+wbIWgQUU0Mlt0ZQq7awPJZyEaQtqWpnJ4NlLcxn52gDsZpqMhoRtaoHrkogU0kdWkalsKlWcJ6Fz6zyIHVTp+1jOYd0CRwQTLUjfw7xHF+G3SuFDUtA0p5Fgykj7zlkr2BUSwFDUAgEEgGrp6CFachUYlJxaok1KkEkF6dcIpxfqYxgI2dlRbp4rbM5JSR+cfahdHEflL37y7Ntszl2NPk1eWHzs5wiVRpPgNNFUjLet+kpZwWhVUr5TiJ3mugdsyYVUbD7+dFy5JSJYMQ56B+yg20CQUehzoj7jdQvdsQyxDTTdNPsicieFYdUzAQTDqKHrNlOtwYbKJ8KJsDorQT1W+GuNyrf4KAGxn5QvpDewh7eLIhHoRIDs6AfSlg5oBSVnpebtqqHcEXYxi2vwbxatKJRVNC68OptrBx0jdOQnYKFerfxzKCTgAZOTQqHX6QvsB/+vUUkfRvVLtl4NOHwpleEgHi0XvSg1IX/brvddo1qF6eBJYOA9y7+i8+/dNbfm9oy0JGk4hXnRIiB1qaeu5Ho/TZ2Tu0ZKN0aPlevAo0I0Dt/vFF+grDBmhLzxAgwAowAI/CREaB3K1koXPzli2qunFO78MDtwAN3RuC6qkrHpuygUvBFBwVuSgpcqncY9BUWivxvQeCiXiIxKocnRoARYAQYAUaAEWAEDiCAxi4pcqH8gRJ34ndp2Gm5Wf3QvAhbBSn/1Jh0z2C46bYwk2ircO6SFddo1Ovxa/ehicsTI8AIfFQEqPEypeAalS0F89gWaMjcUbnNlW5fkNsbm+oMSFrET9QGDgIUUGx23p7oIrzUABtBnKZtCbJWtfA2KkGyQpqaOogjK+UKGKJmZH0A/izzT9SCzlURhvoFPwJJm4iO2/JnMAARPnI0DLFhsKCozUjlQpJXIvpI9UKMH73QaI6FSAyCVWzsDMDgoWRIrhBBrNlHiVHWhpKlbVimKW5ptuMY0MRRQhuXdGR+Z8fhYGItm9Xmqqdk2gyC4zR/L0GIi51dNeBqlrEtPjVEvUaPBRDjT4+kvaS3JdiardMFwpBkvzTbTx9pYOTTTNHOId5rbMecfvCQnIh3HOglLOLhKkQTLCBwZyifADuHqPwF0VtDgQtSV2yCCN5LQPRi2EpFH71gn+Bnc6gWieiVNZG95NFLAd2MMD41eYnooSUewWjPQAJl8LeW5qTeLdot2EsMAlkxjMiTNyFPXpSArBiIJ+5iP0hdBLtBkLXdUIHcrXce+XkYBlNANUo7C6JG6t1LFERtfV3sK3i/TSmEuIV/V1avNIHUaEPjK93geH2KGj3Es3tBaXhiBBgBRoAR+FAI4KfjnXUf1FnuLN7RVO8ZPhhCgXvO6KFrj4xNrQ4tVCu+4N4gD9yowDVRhZujSzsTsFCIYVU5gNmHugOcmBFgBBgBRoARODkIoA0MqRAsDKswDKUfQag0qcfVt7OV8n9pV7234cY0GYp6Ynrz5YU2xrVuYFzqjUZ8dpxQig3o43RBfC2MwLNEYL/BchP8D03ToGNki4CXhIR0X5mekVsuUctQ2e4RYQvvAZWD8QRp28MhQ1geaPjUaqkMWFsDIkkNJLQoZgSCVhqXOBOgrKXsQdomYdt0yVc2DNQLduhfBiHbsTvyDLZ0QINBW4uwYUbkKAHllmELka/0j8hYWo5SybgFFwAmD3+p5YUFpKIAZVjSCCICOTDsDFAWULhkekB7sEoHoJBYwpy2zT4Njxv5YCSKWSJ1c0BTgmaNdvL0XgTifYjoRjKx4RjfDzI6iPhcmmOiOxmXAXjMj7hZbCYil8hbUsc6LNM++os+S9qPCVw7ccQ4DluabfEWIxUdA9p2TOk92TogQ1CrEOMiLigxyFbQcJZadcO9pKPuYS/s5BGGrece6DnxEGkwfCWtJJS/2ufQ9AbrYAuRBAx2cZVMsiSqdYngpYydyDAfwky4aIhoWDTQNyXUsGZAIvLcpS1Pyd3KdW3XIdCeJ1L3grngyWe3OofYdetIuIoPzafT6vJquC1ui8sbl8M7CN7rQI9w4IkRYAQYAUbgQyGAH5BYKVi7tqaWXl2S3eWuLODrP/PAnQUxw09Fgnd3G9ULKHAVFLj6IuoxNPInUTnGIWWyg1oL2TIxgfuh7gAnZgQYAUaAEWAEThgC1JaNcWjIGVfs+dpVds9tuqL639OF6t8okT4uhBgNRVYZ0a/IVuEbN76BKDHHayK6hSdGgBF4HwRANMnoYxsVtrcVNVSij+3WJWl69yRCQynttTqoslUIRUVhwIiwBVGkEN0KhKuAL22VpLnO60y1gytBuoJ9S0NeP3aLutCtsCfPu5F4yRnfDjvyNI5pEbEHyhdGCoIsEbAK3S3xq/SP1iCJBMlKtCsRrCBkEduKIpI1JC5tQ+KYmg6K8k46lI7DDMeiOUWEMG0kKjeStVDkUhriuTCPUzMj9u/ptmYP/33+CEzJR8xwI5vT0ywqrOkWgW0F+Un/YgoJawTYOMxI26jXjUpdom3xITKXfhg9efdSgDPkOiWI4z7Y3OKuI7fpU4CjQNKSRy9tJ+YXxrqVA12L/k4QuvKe6cp7fozuh457ACPnDZg0UNoKAdtKrbTTlalr50pTJhauHrDlnYAbzqAFDm6hhTJBvTuMKt1hEO3I7OJShiQm9q285WhuezjhFgoNpS4Rug0O7/xrF8Aik3I3uxRJ4hmhGy0Y1nFF1yNG9A3Zn4DTj81rPwEvMAKMACNwQhHAz4oUN/DGnHZkw+JGNXUiIxFTJCEFbgUFbpgpcGcELhS4qKGk6HjOGg9cBDJjBe4JfYr4shkBRoARYAQYgQ+PAFqIiNZNY0cxPrSEYx/GllaP6x+p5fK3TSr+pFPN79Zhx+4i0JkQm9WqWLXHTY17oMn64QHkIxiB44pAbKCAwllbW1NX169KaqC0RCuqbHUfGtroZ3sWnOqW2oletgtysNtXc3M9VVajpHYqUa7UYKyMz1XqtYWFrS8sgovpNE3Cnl8SE/1yPfArpEKptu0ZiYAeClmTmlYnMsXpaRmkLQJ9RVKViDIim/BnSi+hAES8EgGLI6GiRXRnpDdoWkFXGzlYImSJi4ukK11XJGan68iXVuk98HR+XG/qybuu5imhZyZy8fHJoRsNvpV2RfsGWqYUpMaN6l0sRwVvVPJGFS+2xyevGYqCdNCuTglOCkUn8HyqqYCKOg0wIUfYIvgRflzHkRaGdxFFFCWbBiJ2NT5h5AaQpj8IXftAQuMrnYJyV6LX1HjkGix6VjOr4b6bhjTLGuUugqzlSeEGYAeKFAJeUunCfqFPJ8XUg9Sdln3efEN8uR16uufr+dr5sQ/L6bJHj2z01o3KXQRTW31t1d/69q3GfoEymZK6IJun3zLayBMjwAgwAozADAH6HYj1I3FV3N6+HT1wyUKh38+0m4yThbLdctqkMYjZuzxwYfaUgMDtYgwRPHDxFkcdZpYvzxkBRoARYAQYAUaAEfipCMR2K4hc0LgYMQoiF5IhtDnL4eTfZq+UvyMn6T1ZoQ3ZSybq7EJ5941bxy7IGZO4P/UJ4Z0nAQEiNkFcPZ1uoklB6hJ42t7duKszQW4FRpE1AgUeG0z9bElpS+pX+iAWWbRI8GR7kNc5PGw7zlttsjR1T9yCauu56i3xi2CCFyz51mYUhRkmCSpgSGHUwcLDNpJfJGqc/YsqWSJqQZtBWYs5EbtkdEB6WRC3Yaa4JTsEbKOcIq3bjLiPWU0vjL/rT+8wLz1FAI8U/Z8qbkHsEptLpC59sBV2DAjA1pgw0Pbmm4InlB6oZuVpZrSBCNxIA9PumD4GcKNcaSe0umGMvyW5M8CHF4HWiNyVter4t3RXvQmjhsqS/27XbchegHpXwDhXwZahcNLpEmresgPPXQ9C19eFE2YUCthHDEDmkvI9uiqKkRCtFuwYhrBigKRX7vlWq+We6Ce+Z3oeliWeSF0qORG7d/buRH9dfOeD+DQ+m/gQmXuDXg5M5h64w7zICDACjABe5Xg1rqG+sS5iJ/fu7q6em7ukWyIx1a5rZyBw+26vg4hlX7BvCXjgJhdRY4ECF47o6LhmApcfIkaAEWAEGAFGgBH4CAg4tCfhj4sPgnVjbOjEDdwjl0z+Zbbk/3VaFls6Sct+UZZu/KgkNe5xatcxsfMRnhw+9OghAE6pIWxvgvLEtLa6JpfWl+SV5StyfWN9apFgYJGwAosEoYaPt81i0ahsNWwGdKa0sVDZQiOLuExmAsIW/rWQCU5g96mS8Nh0VVv0yjfEF3Vbnqq2wxmVwrsWY8d1IbugfImCJQsFomahPgHpRLLGhhwjmWwkaGFkgCOiqhYWCmj6KJC0TeIZgUumBzg+5tHoaOkvT4zAx4NAw89On0ua7atvD+RP24m3Bc2J2VThGzfiJxUR+JCU5g4t/kgKo90f7QwiAQwSF3M6D+2lUGsjWDPAc5fWwSVjiIybhIHuiHuqE+750g9NRzxUi+KhcXKirKpg3+DSkRrDaQQEL75JKQKpmdRlRsCRBLlUAYpd5JiIQIHUyJgENkmCPHY9IrI5BR4Yhg7ttG3JX3ef0CXbhQWQ0VNVLn2zmMwl7HhiBBiBk45AVOHCB/fqq80opV6vp4cPckMeuEYUeOXqZGzKDupMv+jeSK4lS/plqG9zWEM1BG6qYKHACtyT/hzx9TMCjAAjwAgwAh8JgWb0KOlxq1CKXeG8mzyo/jq/7P47s1v9dSYWB2WG0Gfn5sbHTY3LpM9HenL44KOAADihp8TtuzxthbgkcntPkUUCqW13yYUA9ggUjGw+n5PjwcBAL6sn47HSaVtXiW2b3M+B/NEh8Rk8a2GLkLxkR+5Tbi+ch6FBizSKJpdtnBX0K7Kl0edUhuYfFLQNUQtqNgnY36hnsY3+0XB0sk8gkhdK27iM9ET1xuNpYDz9Y8L2KDx6J6mMsR+iIXrRxG88dEHuRtIW2lzvoHtt7BrwF8wt9Z7CtiGQfy5ksVD9wgUhPtbkzAtFMNaJ4BX46S1DLcooBgbnCrJ3iIBqG6aj79V71VZ6KXxfTrAtKETPSUv0fdgwUsNEgeAVmYdanY5ycJGmgvlI6iJfaHUFbSOVbjFf2Cf9J77b7bqlpSV3d3g3rLRXfFTmbqAcq/gQoUvT9en8Zvwexk3722ht+quKr2mTvknBfxkBRoAROPII3LgR1PUD9SiymZp54KrStobapniRtxN44NZQ4CZRgYuO6yRkKlcd2EYVkcDdf1MeeUj4AhgBRoARYAQYAUbgk0KAiFxEUCU7BRrtCTp3WPYnf2hern9H2db9rkgrXUzGj6DGff311921tWvukyrqx3neaXPz48yS82IEPnkEiEWKgchQlFviliKl7Z3yjjJdI5+8kakL8LTdQSAyPVZyUSwKhFOWe3KXLGnVnOiqiRslVqm0NLbwvoZ/my+C8pkY6XPV2/Lfh8p20e4E2CKINhhf+C3A2ZaCc0TytaFx8OWK3y+SIBIFC0YH+loiZoMBTRv9a0lti+1TshbU7YzgJdZ2uoxL4O/pJ/9IcQk+PAINiUnK2vifAqfhiwkyFzP84EJ9S6HLMIfwlnx4LQjdSOFOT0W0L3mWYDV671J+1B8ScMTEkf8REcBjP8DRpemEt/G9fAsuvNvpJfsDPTFD6xE50OW1Fb7SQ1/DwSQInQVvJi41WSR38wC33rSNiGh9vwc7BrDKvovPI+n8/HJju0AB0yg42j6xexCLg/YLB7dPyV58kRscDu7jZUaAEWAEjhAC9OKN3VewUCAP3GLjstzdvQcLhUx3JmlCQcwSuPlHD1ylv+De0L+ZLikocOF+azBOqVBdELiNApfrNEfoznNRGQFGgBFgBBiBQ40AWpXwx8VfyH4GUOWWdtu9qc+U/0wl/rtKpAiXMpzgCiYrYsVCeIOxm0e/bcbk0KF+JrlwHwaBWSPj1s1bmkhbDIeWdx4ISUrbLZeo5dZZube3rdOJ1rKEiW0GbpXm+K9EWzVqW6nLom7BgnMuGJ/6neQUTN7m6/vhl9xQvIwBgEVS6DZYGdgZQFtChBQaJJKEhMgHJC551pKKluwOok8t6WpRNoozRvtB4AYEOUMqCggFohb0FEYdTglcbtx8mFvOaY8eAsTj0leGVLhRmYtVcKywXgA1S9ugwYUwFxMlIyUv1LP4h68QUjUfWo7MbuwbIWoBSfGjTab2EzL1BcE7EqUYJC+FdT8MT2TXPVDz4QH56yqvaq3gr+t9mYvWJEHfrU9yl4NOHqbDUIDQHVYDWDNQrihCuhecavsODvAabLOG2zWsF2ifW3DhwvBCiJ66ZMFAhC6m/UBpMzsG2jib3vWry4rdGTA8ZwQYgcOIAF6wTwncb4HAPd8QuIvJ0BTqnNHetUe1TSeiaqdJ/nl7V4LA1RfRaZ2oBEEFiMClIGYKxjbUOc0TI8AIMAKMACPACDACHxMCaEtSq7KmANrQ4+650g0R5OyPspfc76g9db8oOiMjJpMlsVRhdKWT1xCv5YhP72pOHvGr4eKfOAT2Gxc3I6mj1sU6Yoe1VL9d6AxKW/gVKAP+VPeV6omuGIqB6mQdORmNjEHzYuCqxOR5WrpRVidVjlHcmZmkZ+v78kuikIuuHy6IVOYGwwBhlZADYLRDyB6Uzoezg1SKitlI34K0jT62jcoWCaPCltS54G8jkRv1tUQANypbyoUaNPw9PHFPLl8wECA+F6RnDHxGZC2t4atFRCj9GmOZOknIL5dM67200WGXelpB1OLLAzOGhmfFMi3EbyV9LWmdvptu4vuk+fXWwe5e7KmufzvpyHthIkdqwT9SXfEAgtt+bgsrSjUCM+tTjUNt5jB3Phk5X+WOPHTjHZt66g6wXkw9ddt125WnyvpsftbjBRPEHj7n8KEgaTMrhtntPkjqHvjWT8s/S8VzRoARYAQODQJ4I8o1eOBeXLgIAreAArenF5PctOs0kYltEYEL4/M2SNsvuLfIA1e+jF7rNHrgIhaASmGjwB64h+Z+ckEYAUaAEWAEGIHjhgBaanUMc1aFQaj8uN6q3xAvVL8tfPl/m0lrW3eyyvTmy4ft2/byb122R12Ne6AZedxuJV/PcUeAGhaz6MhiWci7G3f1E4g+fg7etkMxNF2BNAMAAEAASURBVEYswq0AwcgqpRX8bKHC0+VkojRChfmWBGsz6SAkWSv05RmVi/nJ2+FLfuhX0ODIYY7QjtwqWSRICioG3pYIVwQYAzkLNS24YUnqWtpBqtwpMRuJ26nKtlHeanzJSJFL3zX+vh33h5Kv76MiAAqW+kaING3MFbAEmTsIVTJgQC9rJHVho0A8L06GvXRKkLZTtW5MH3PBvvi9w9cuviwkGSdUCJ5W0lcRy9Duup1sRa+7HfvAvOLuyFLvaSdGFDQtgNRtZQkkt6l19dhlSQbHJeRE+vtieplQ63pk62zfFbqwtmed23L+7EtnffTV3VsJd8SdmLjaqsLqa6t+X6VLW6ek7lGvSEzR4BkjwAgcMwTwKpWI5izJluqMOKN2d3e1TxZNTxWm8J22QI+XtQE2CfsE7iuoccESN6S6iB64IHcxhqnpsD5m6PDlMAKMACPACDACjMAhQQANslBD4lOTcIdsFcZvTf6//HL9X8Ex84etpDseiroSi1vlpXOX7FFX4zKpdEieOi7GB0dg1qi4vXxbz5VzymwZaXpGDuscjYrEkOqWyFsEJzO1VKmtpNGyMpVxhctJLeJzOTSnEN/+ZVv6z9iRv6gM2F8a7pfIAoQK2B8YIoCkpVKR3QEoWvKwTaIlAhojAWQuNUqQCFQtDiBWaPbBcdhO9BFZJvDECDACPzsCRMeCngVhG+dRqUsi3dn2RnVLpibTCKWgfMlfF5/os9vsx87mCxq7YqhjpZnwVbdDv0tp3djvwUtpr1hRf+V2w4PkFfcDU6ptB+JX+rxOrYVhfuqTNPWpQf4IlgYm2VLZfBsUco2laMEwEK285XbyndCxHefbEAwnjbfucrrs70Cpe2mq1L0tbovLC5c9k7mzG8JzRoAR+KQRiHUsKgReqzdvCkmBzDCyQP2/f3PPkAduSyRG7qQFfMSzkcbQJym/6N9MEcRMoi6l4IGLulIuKYgZE7if9M3k8zMCjAAjwAgwAicEAbTEHMwSoMj1Ew9bPTuEO64a/64+Hf4wm2SP4KmJANh6cn/5fv37G7/vbty4EaVARxEecxQLzWU+mQhQw2Lt6poSrwpJtgmnNk7B1jZT/SLRom90p9R6Luvqyo3TCqSrRxAxJ23LdV3LZqEnh+KC21Bf8YPwskx9Eb3a0NhI5jS54yp88Yl4BfUaDBoiaQzIQYHHoLyN1E9kZmMKcECRpJ1xQbP59Ma8a/Vk3i6+akbg40AgfiPx1YsdIvhmEXkLaoE+cM/FMiaBiIQ0w1cV/a/E+eInHGQuCFZYMFBqfF0xpy8mrcE0ATPy28Wq6erTJJY3HbFEil/X9xco0/Ffii3dEwiWpu7ZvfJJfcl+X4/8tvdVWYl8AjeFEmIzm+SQotW5HQq4MQyQYbsnqrEwhT0V0m7ww60hiuI9KXUfm8euWzq/se0DEbqX9y7H0onXhF9bWwvhBq7iOkp2DAz3I878hxFgBI4mAvRmQhCz18QteXu7K6nDfG6u0vl4WcOAPE+zkOyMdWIW/HL5l+Y3ivPqIjq0UW8SCAQre/DAbWGEEnvgHs27z6VmBBgBRoARYASOHAJoPyH0CYR2WmZoSk1gh9mzm+bvq3n3NmJbf8eU83Y0VyfgkPxr4jVq7h3ZNhezTUfu8TxZBQYvE2WxAmoQXLm6s3hH5xZuB/1M7+VGz/xuSXnbkx1TSZEOqj6YFd/WHd0FIXM+VPLTk/vuP0CTYkFlug3KtiCfWiJm0U4hdoe0sxqNjxTy3YRIXFjYIvgYbBNoCCDRSDHdycKer5YROEIIEOWArzJI0EjkgkzFP1qNhCjtpW8x7aY9sF/AX+hvPVk0kHKXgqu5mJ7yIXsGOOkKK0cwxx8j0ppDb+6W7qi3VOp/aDrhLRC8D/FuGRkvxwKkbmGhxRVQ6YIixkm8h1o3N8GNxEgggcjbhfdy4D3Y3woUbwfOC4vZor03hEWvmfhLCIx2Cx66V1ZRsoPeubE8zR8mdw+AwYuMACPwsSKAlyL1TtN7U1Kd6/b925o8cNPFVI7e7Bpvx8l80s6d00kZXIaOr+X6Tfkfp4X5GkYy9eJopTYI3JkCt3nrfqxl5MwYAUaAEWAEGAFGgBH4iQhgZCbZKuDfOJRh4BHkrB7Xf5xdKP/ntGzdN76udufN5DPj0yUFORPXyLYvxlb5iVkexh3UrOWJETh0CFBjgnzY8OWSIDSi8pYClhUIWDZ8nJrIsuZzOqkwbM/C6xbeCNrLZJiPO7IQ87LSr9QP/ZfdOFxCL0wLwck6RNySSC/OiaBFSA4o+KJyBNtS7AWxG80RiLjlgGOH7qngAjECHwsCkcAlpgKvmWjTQIQuVkHmRt9dMm9AMDVEOcX2+M6gOVUKLKzyqzDytatDFYayK+7rXPxA5+GunkeQtInexYukkmM9hp9uNUYu0XqBSF18YukTyH1T0McSdk117VqqZev52pVp6e2ehdXCpRgU7dbGrXDl+hUPNVzzO83+uR/LzedMGAFG4L0IxDoXdXbNJqhw19fXdUPgjkxHv4guqSoTPskqO8rTufaZ6m74J7rQX9UFEbcIBQsFLsYwkT9ugmy4fTHDkueMACPACDACjAAj8LwQoBZdjZabJZu8UPpxuVPfS87V/71K/HdB+fTnRTIZ9AblhfYFiyDUTt6g0ZlHa+JK1tG6X8e+tDMFCJG3TQNiVW7+6J66qBO110kw7lmpIWwT5mXXlJNxOkTIshrxh1QR2i7xhRmmy9Vm+Lqvw8+bll5AwyIHaNPuFYy2JiI3kSmCm2VBB/K4jXYJmJPHLXvYHvsnjC+QEXgPAkRdRLKWJLQwaYA6F25KjmKcxkBqpNaFLQNI2Gi5QibYpOSFkLcKYwEy11V+YgduK39ZvR525IP05/0dvys3M1XUcuzGRoO3FRl89oPvmbweiKEtRNsPyX8hHQQLD10rt3yn14mB0Wpde7tgw0p7xcOLMohP47MpwhoKevWASpeVue+5l7yBEWAEfkYEqP5FHrirr6/JiwsX1dxn5xQpcDs6bQjcUZKNtU3Tnj4FAvdaViRfhuvtImpPeNWhSyuXXXSMM4H7M+LPhzECjAAjwAgwAozAx4BAAIGLdhwkOaWfhD7I3GE9Gv/b9GX/v8pd+VZatAeZKKvdxd36qAY5YxL3Y3hOOIuPjkBUgUB5Oxu+R6rbmd/tmS0NjnVBgSVJdNrRyo71oK5Sm/q26Zo5X7lX6gfyy3boVjR82HSOgc6JyBrCBTSHCUYY2CPALoEsEkDepkpR3LN9u4QYwOyjXwXnwAgwAscAAXAZIGxhoRB9dT30t43lApG5UblLNgwgchHXDHYN0VsXS456fD38Eryr+/5R9pJ6vd6xD4tPhe+LsdoxNh0hUNpA6xQMLUhdELs+QV/xVKHbBEdDPuleqFsgdTXipRWV9ePGP1ecBZFLnrtE6i6gHETm0nSDhi0cvWFAx+A54UtgBI4sAlTnOvjemNXBqAP99rduq7kMBG7WNbUemnnXzmSd5vCCSepuPRe2xDfURP9D3VVnNNW1MtnShZpDHIEMgHC74sg+FVxwRoARYAQYAUbgWCDwDjWur2GqsOceuNz+y2R+8vuiTDdNltemN18+bN+2l3/rsj1qwhiubB2L5/RoXkRsNBANAeUH/ka/2/ZWW2+Dcc2hXSPLBE3mtCNlQOOaOpNJFWy7Kqqu0T53A33ObcqvQgT/81CBQHULIwUZidnoZIsWCnxusZUaGaS/heqWlLgIYUZet1Dd8uN/NJ8cLjUj8OwRwPvpKUELKwVidrGJaFxQsHBagkoXvbwOodTIWZdIXZCpzUsFCZ0foecXBgxuFLZh5vK21uJvkhW7biq1I70qZa0mqjRVkgafmsyh18kOoXcrJIKh1ThXawQOGT66veBbOIODh25d1u7s6bNOtIW/tS78FVIQX5+SuVNIjlol5NnfST4DI8AIvB8CeL1JCmR2e1uoufLOvgIXvG1aDHSGIQeZbNfz1Y76Omy+fy2ZM8uoUSFAgSxQ8+ohGGze1Kve70y8nxFgBBgBRoARYAQYgWeMALXdPLXVMD57Ivogcqtyo3o9+2z5X8ph64edJC0TUU0WFxdLcQ5RUK5BnHOEJmaxjtDNOi5FBcHxY/1u+/C77Twewu/2VCRvIbhNExCvGp89TZYJkON6+Yp9GL5SD8JLOlWFylVHIhYyccGIgIYQ86BtibiF2paWGtUtliKBi/0Nx8LP/XF5mPg6GIHniQB55wpS6FLFgBx0G88lUK7NNqJ5QexCT0uvuaiUxRLMGeCgW/lRPXQ7qgtCtxA/VK3whuq6B6pKt0KpxrnVpckQkxFkLqobLhTxuBBawRd52wW155/UzrXT2pZl6SgY2m626y8vXH6qyiUsQOoykfs8Hwo+FyNwdBCIZG3sbXqq3r9x44ZClGbVXb4iicClzvT743EyNzqDTvAqD7VNbVvNBxC4aqR+Tc+pZYx2KuB/m2tYKKCGlUerKu4ZPzoPApeUEWAEGAFGgBE43gjEGCdRfIM2GCwVBhi1vW3V+PfUgv/Dts6fSJFOkva4PNs7W5E37lEa3chk1vF+eA/d1RGzsfbNNXVx+6IqNi7LlrirnsBO7aUi0QOobxP43aa2m9RunID3SGrtW4gE33OVXHGP1FcRVOgzuq0WYI5QgCPRkShRQSOQBmhaDOUzgVS3Bh5tUNvGrdiDZW5cHLpngQvECBxhBIiupTCJUaELFW7jqUumCk7Ch8lb6HLJUxeEbrzKZnQArBdg/0IVCQRHg4/u0G0l59X3ZOrvJAthgwKjyVpXAhxtK+1YCoqGscrWJ+hJroXbE3vekTLXWOs0TmLg4ICAaDPv3BgMTVyJ6lwmco/w08VFZwSeAQJU/4rvo4M1f3o/zRS4f3VH7Z5q6zmRGfGkygoxBwXuXmbbbj5sZV+TY/WrZl69QB64MkMYswwK3FTlXMd6BjeLs2QEGAFGgBFgBBiBj4YAtdUgpcHQxhr2dLsOtgqTjclfp1+w/3U61j/Iy85wNFdXarJb3hUr9sp1tOLk007uj3byZ3v0warcsz0T535iEaCGw80bN+V1SMRuiVvqjDijyPOWyNufg3XCHsjbtNA6G8Is0qlI3lYp4h2n9TyUtxerR/IrohSfQgCNhUjUikCRhcgUIVEJtCAm5NhOdgk6YCvmCg82BSqj55uf8RP75PGFMwLPDYGG1I0B0ojcjTpdVBpQGQBxG4W5qEiA0iV/3SYCKghfUL/WjhwqFWEShn4rgY+u6/uH5hX3/WQoN4XPSvLRbatumSXCDSvhvBj6YrHtBmJPOBXAFsM7F+rcdxC6sFrAlfuj1KP83O4Un4gROKEIRBUuXfu0VnTzhpDXyQN3aqGwCwVuZ5Todp0m0trWCFUzWcBC4bH8qhrrXzdzEhYKsE9IBMZByZ5MVYsJ3BP6MPFlMwKMACPACDACRwGBOEYSIyLrMEaQsz20u3asqf634pT9A+OzTSOyaltMJkJsVq+vvu6uXbt2JGwVmOA6Cg/fES4jNRrWrkF5i0jHxfkCytsmYNlQwDZBnFZmF563WhnjdDLQMrVi3BZQ3sqJfMmCvEXfyc9DebsIR9scQ5TROYLmB8KUkYUC6NsCipBUkAY3+tyiOUF6N54YAUaAEfhkEThI6pK3AgYOgG21nohdWHsLMkyoo+1Cw6ggjqqo/MTvOQRGsyBy0xflX4HQfZB+SvydGaQPMcRgomxSBjHxSZ7aMBY+T7wbwn/Bd4MnQrcNuwXbs26yO7H9ft+trq46cRVnxC89efZ+spDw2RkBRuCTRIA61OP5Z2+CqMBFELNyThGBO4d6WbWbm3ZYjB64Kqvm7Jb+uhqrX4cC9zy6xjOYVeXQ3nahwG2h/pUgP25HfJI3lc/NCDACjAAjwAgwAj8NATSSQk3CGZC4uwEjISeb9Q/Vhep/TKX/s06x0B/oakJq3BWocSGAiXFOflqGh2EfV74Ow104pmU4SODOfbZpJHRGfZ3IMyqtYJtQ6ESPldlDwDIrRy1QseR5e7F6KL8sKihvW1PlrQJNS+QsBSVLYqCyXCShUApr2IImBBG3/Cwf0+eIL4sROAYI4HVI6lxUDKgSQYHRYLYPZS7ZMURvXVgveOqFoonS+dLvYW7rnfpR8qL6c5m6v0u76s20NrthjJDxOqlTk8Ouf+zypIAyd+BDiohqsFsoB9YWCwv1sBRuN7v91Df3+tTcYQroURkyNC0uzxgBRuAjIhCJXCJxb8aXjfqDJ3f0GVgokAK3UiPTm5zOYcCdTPJRVwf/RX9P/9NkQb2I2laGQGYUxowsFNpM4H7EG8GHMwKMACPACDACjMDzQQCjHxGEuoaEZuxKMYRsZjgZjL+VrbjflWP5dpZ0hlvwxjXDJ/WqWLXyBlprh3wir1CeGIGPDYFZA4HUt9RIePXVV6N1wmirbRZyjM3bbevUg33IVDKuJFiIUStpwVdtJFfsffXVqg6fSYi8hdtazAucBvS10NpSoDKVgbzNoQZJlYYrLqlwmbz92O4dZ8QIMALPDAHwpehy0uhwQqcTIjeCHyHKFSHPnETFAl1YDl1XCJfmyXQBPt+6pebx+gumlc3bgT9nx+LLPvd3J9qu5yv1X5Wj8rFVkzpIMC9W2iwYyHzzuvNY2N10TxSjHcQksq5bXvD3hsLbl+6GlbUVf3v7dpgFQwOBHN+grNJ9ZvedM2YEPnEEqC5F33Gak4XCazdvIYhZVxYbhfyFUy1pocAdqyXddacyF8pkCEvurM4+a99S/yRZUhdi9zmpbjPZhoVVwRYKn/gt5QIwAowAI8AIMAKMwAdFQNJo7UBRklJlRRnQMY1B3J9HrKVP6cQ9RjbDbFOrrNUiYaAi5c1hF7qwevGD3nxO9xMRiGQrGgYC3mpiHZ9lIe8gwrHZMrI/6OtW54JOJ1DeSm0SpdNBCbfbMCpkV8yHSl50j8RXRCWhvFXwvBUZTgSagzgPEB4GHrcGhC3IW9AcOSlv4TedYL+O6X5iqXgHI8AIMAKHGAF4NMEslxxyQd2S6T5ZLMBUIa6TQheMC2KXecw1XoZY9wiGVnpEWK133cMM/rl2LzzIYLcQ9sSD3Gd7bdGtojK3VVgKhAaa2G3L3dib3MtDeKzhn5uVdhYMLRK6v3XZocNNwLJ8NsgaMSHZeuEQPzlcNEbgQyEQ62h0BL7ht27e0hSXIF1clWbrrhyJtnGTcdIocEv4tdhMnZIX6r9Q/1n2gl5Fh1MSdAB1qzoqgw8uOs/xfmDbqg91BzgxI8AIMAKMACPACHySCICXpXDT8MaFLx1GO7rSjaph+cfmQv3bRiy8mUxcvWMnlekcDTUuk7if5NN0DM5NHRWkuL29fFuTrxoRtxSwbGabALNaldQKnRxT9a3fy+pUziUh/XT9MHwVNtOf0R25CGo2x8MIsQj+QoUGtW0SnW8xVwhgJqG8BaWL4GXswXYMHhu+BEaAEXiKABG5nghdvAAbLS4cconQhe2ChQEDyF0MAvLQ6kZFHZnbgt4d+77H9rrvHpoz8jvZi/Z7oVY7upLDpMxHSZZaSOdsbhAQzY6IEwaDi4+E3YJ2ttObd7XdcMvlskPXmRcL+NC0PiVzb+Bk7KP79C7xEiNwRBGIJC510UQPXKH2Nu7qRXSwZ+o8VCdGh+0EI5+qjAjc9LQ5U34//EbS1ldA2naoLgYTqxZCzfbQkZ6hlkYd6DwxAowAI8AIMAKMACNwlBA46I3bhwp3VG9Vb8kz5T/LE/PdzLUHI19XqoA37upKLa6h5XWI20FM4h6lR++QlTUSuGgUCEQ2votGQb/d12a4LFOBSGUYMZztQXkLAW4tlRn6MhG66ukFfdrd15ftY3HF9OQZClgGjZmGvF2jcYCAZcpA6QHCFkJ3aHAlGSnIYCDMpf2s/jhkzwAXhxFgBD52BBDbDIRukCByPalzG4UulLhEr5IiV5C7LunqmnUQum6vHrot3RFv4435N+lL8i/VxD9OZGeSWD3wYGd6eW7BytqBEN5le66tut5V2852rSvLJTcxd/yl7JIXG8h1FR8ic5nI/dhvLmfICDwPBGL9jE5EtXwicG8+7WynIGbkgTuuBnoutEDgJpHANXNqsXpDXkty/TUEL5tD13kC3W1L5aIDC6uMxkZRljwxAowAI8AIMAKMACNw5BCYeeNaMXFj1w9lGEz2xn/Ueln+Xlom96VPJyrrju8vi/ryBmQ0h9gbl0ncI/f0ffIFjqqOmX3ClMAdiZEZj3O9BO8DjfhkdqzTFL631sOWEdYJZkEu1Q/CL1Wb4WtJVy/BW62rEKgM/0DTopmQoslAKltS4VIAM4lsqMFAaZpmyCd/4VwCRoARYASeFwIga0HYOhAwFPyMVLHwyyVzBZC4ROxSgDTS6YKURZDHqI5zsFrAEKEBgqE9SFf0v3M7fqO4JP422TP3RaVHbdOtA5S5ToxxrHfwbrB15l0XWZM1bz1fu2i1UK24qMwFkXuYKzDP61bweRiBo4ZAfGWAuJ2V+5a4pcZPLuhfOGVkWXSSantkOuM8FSbNJ3WNGpidC4Psihyrf6i7ClU5+MalCGMGH1yMlGIf3BmQPGcEGAFGgBFgBBiBo4rAVI0ra4xo3EW7aWy37Bvyhep/akn9J8oVO2k2KZfEUgVBizvMatz9Ct5RvRNc7ueLADUM1qC+vbh9W5F9wqbN1UWXqKFLDfne1pVOsolKbaiSKnWFS+08ZLa/UP21+FWzoM+jQdCD1pbIWdAO8LZF4wBmuUWkcuEwHZ1wo61CbHzw8/l8by+fjRFgBA4nAqSlI9sF8Lr0F3660WIhkry0jldz3O+g4MVycG7odrDNkn+uORe+k/6c+K7sq822zCahNn1TZ3WeIB8B64aO8P1qDzHWvLf4tHVlx6fPutEb6351ddWJqxhSxD65h/PJ4FIxAu9C4B0d7RSnANM6jKp2d+/pi+dRX3ucmuCqrKXTfOw1LK6qOfdEvaZG6tf0vDqHDvYUVgoFxkl1UFtDBzv+8kiod6HMq4wAI8AIMAKMACNw5BCACCa4UDkEaAKRuwdrz1ENb9x0xf12bzJ3P03b5Q/ERnV5ebnG6MRDq8ZlkuzIPXnPt8BE2u6fEaoOUnNQUIyWaClS36binBpPBvp0vaCjdYJTychXsGKs5rzTn/Zb4muhlqsYprcEu1uDuIAUmR0aD9GSiSgUBS0j+4SmgfD0XPsn5QVGgBFgBBiBdyEQFbmRuJ2Su5HYJW2ulxUCpUXrBRzjUVGxbhS26+367fQl/e/8rr2fXdR/Y0byfjpqDdMcPrkmdzlUvcMWvHnlIPrm1vW2G/SKutUa2ifVE3d54/Khrci8CxteZQRONAJE4q59cw2d7RdVsVHIdDGVmz/K1eK53CRbWnlVpspnRah0alvVvNtWV9RA/WokcOF7SzU0CQsFKHBbUPkTgUt1M66fneinii+eEWAEGAFGgBE4BgjQSEeQuBjcCDWu6IPSLScPyzvZ591/3t7N70JjOBm4ahK9ccWKReBndxiFLOxvdQyexWd1CZHApeF4q03lHcHL1JmNK7Il7kYCNx8vawpcptWpVNgqm/iQImBOjsjGi24z+bKD763uibOyDasEGYOVgb6VOfzVWnBdyIQOiHIMTS43Dp7VLeR8GQFG4HgiQLQKbGei3Qy9QaP1goINDZY0wqCRDQMqKbLGGzYgeORp3UrnXd9fED6pB7ftA31W/El6of9nZpQ80JNqUJm0zkY5Du1YdLDBsEGITt+L8UDKs8mKXMfvQPgmHHqhyj0I6WGs2BwsHy8zAicOAcj1l24uYYjTZfkI9bWVLSHaUOAmj2FsqwwMVfKsD+8E1XJQ4IrX1Fj9WrKgltGhnoK4zUQa2ipBvY062Ll+duIeH75gRoARYAQYAUbg2CJALSiy7gzSqyRkFEg6nUvOuLfcL+0tDXdOlfnjtIA0cXlFrW+sq9fXXqfRkAgufbgm7lk/XPfj0JRmNhwPxK0mJQcVjNQcu1u7CIjR0VnrrK4QuGwRgctspdKRGqSiED3h9Gfslvp6sOFV3dYLRN5CfWsQ6Qz6DlWIJBRKRfVtGr9Ch+aKuSCMACPACBxxBIi4bTx0KTCaI99bkLk2WAF1rrT0IievBbjsWjf02/WOfduck39izvvbZiIeZr4olU3KxGQ1aivWiYHNs069WW65Cs4Lvd6Su2BA4mb4UAA0UgFfh+yPrRaO+IPDxT8uCMzqbmJZ6FsIOHupZ+TW/US1Oom2ZZJ0XV2Mao36WtWzj/UVNVH/QM+pc6BrCxC4KeytWpI+DYHLwWSPy4PB18EIMAKMACPACDACDQLRli4gvgg+E6hx61BNHlTr+Rf9f6N3ww9q1x7Mz3cmg/HdeuWQqnFZicsP83sQIAUu+d5eRdCy6Hvb21QvihfFVpmoObGoU6W12zZpV1TZWKXJwCBwWScsysfmy3ZbfIPUtypHU0AihA5Cl+kEzmoZNQokgmhA40XbBTRkPDECjAAjwAh8fAigb5lGN6CTORKsUOZSUDQMhw5K0uAhColGGlvY2hh0sumOWnQD/8L4z8OX9Qvyz8ts9LdZ1/ygcnaQjPVeYjrKlEKdFYvWZwiIBjfzO2JLdItFV/eEv3BBuFs3iTiG5peJ3I/vPnJOjMCHQCASt5SevvU03cT3tLyjuqKt+n2jOnoPrO1pHRz8b5UztRrnxiafC0P5K7pR4KKuJiHVJZurGMSMFLhM4EYw+Q8jwAgwAowAI8AIHCsEpu0l0FEacsNMWGHNvL5Q3XNfSnv1Qwx1HA3GOzpbXnGkxl29uUqjEGe1rEMBBRNph+I2HI5CxIYAPZ4gcNfX1zX53j4RJJ81KhVapfC+ncD7ttBlapxJHETow6SaVx7etzvia/Bi/JxuqQUQt0kkEpIYHAPWCTKDmUI69VbjhsHhuN1cCkaAETgJCEzVudDMOo+4ZUTiRmUuok/SNrzyyfhcurHfqfv+UfKC/J7dsfeLV8LfJpP2RlLpQQrP3CDGPkuKGon9rtjzIQ8hn6vq2tZueWHZAspDHcX1JNxqvsaThcA+eTu7bHyZ19bW1Kvrr+per6eHD4YmkWdUpUam7bLMlB0zUlXqT09err5n/tP0vPkFxChI0YQx0OF20PXeiZ3taNzMsuQ5I8AIMAKMACPACDACxwwBtI7QBvIYOw4hShjLXV+7qnxQv56+Ovkviqr1A52m5UjVlZrslt9d/W597dq1Q2WpwCTuMXsif9bLmQ3BOxi4rN/uazNclvkYvgnylMqVSR0iGlvfSko7zGGWsIiIxl+xM+9b+N1iCJ5BGIwEmo4MutuWMGCBn0Y25uftZ71BfBwjwAgwAh8NgWmFBSSuCyU++EcVGGGllyBp0cmMP7BZ2IG01tm+e5Auq+9kF+R3xZ58oL3aQ19cRYRuLoUd1INAVgsepG6lH9rxcOwO65CjjwYbH80IHD4EaMQUlWqmgH9ahxPqwuIdPSq7pn48NEWV6ja+qUGYzEllqtb4tL+X/Gba0t9ALa2D+hrV2ApVyC4I3Yxtrg7fveYSMQKMACPACDACjMDHjADaPA2Ji7ZQFcZoGQ1s3z4IZ8r/Ng3Jd7te9EfdZKKyuckFGC6IGwhw1ox0/JgL8rNlx6Taz4bbsTrqaeX/lrqyfEWSj9piu9CtIchbcVolpdaZ1GldqnQMFUfQVU+K9NP1E/camv+v0pBcCYNo/AOBC+MEkLcYkheDYkgicDkwxrF6XvhiGAFG4AgjgEoLIrJaeOZaGOR6T1QuiNypby56mUmbC4YIPdR24nerLfs2BUHLz/vv2FH6KLWmzIWZJHluMwmvXZC4j4udup3O27K85yZm4i9tXaLeai9vIBeeGAFG4JkgQHU3alDEOtyBUVS7UOEu1rkpthPjnckyr7NxXaV1dzjnt9O/pyb6H5ieOgvVrYEON5d56CFCbQb9LVusPZM7xZkyAowAI8AIMAKMwCFDAK0d0LhoA4HOtX4sd/zY7ZXD8R93LqrfS6vkbSEwgKndHZ/tiQqxQNxhatcwiXvInqbnXZwZgYvzqnV8WohknEE8OxSZSScgb62GbQJmoUoqpXM9V5+qH4mv+Oh9i0YAKW51wHA8OKrBeUEiqrFUyoDUhQ9jHJLHz9jzvql8PkaAEWAE3g8B6oEmCwRS44ZI5VpUZGpQr1GjC1ddELB4fYPntQO/Xe7Ub5sX5G2Tib82RfqDllQjX5t+kuQ1IqYhCNqez3S3Cp3NUJalu3DhAhG5bLHwfveB9zMCPyMCsf5Gx94Q8uAoqpFom5ZIDKptWV7qnDrf67SaC7vqihioX9cgcHUicklOWVnoqFTlqLORDy7X1whPnhgBRoARYAQYAUbgBCBANK6kEYo2lGIv1H5cb9l78kX7P7SF+pMkKXYT3Z4stMREnAPZexWtpEMSA4QrbCfg8fxxlzir/N+8cVO+Jl7D8LsLur3V1v1RgjhkOnqoFeOF1Gv4p/k6CYXsyUp/2u6I12TQn1NtCfVtSEiBK9EAEETe0lIMXAZNLk+MACPACDACRwEB/BxEda4DcRvtFaDNBaFLZgsgdR16nz1SqCDqYdiyu/VD82LyvbBVv6VX5F90RbYnKjNKDMhcK+pWR3ia265wpMx92L5gL/8WxmwckkrPUbghXEZG4P0QiHU4Ut/ejMTrfid8f1BomNsar8q0Vab5SMPpNq/nq03zdTWSv24W5QV0uicBo6ZA4bagxC2wnkLRy+2B9wOd9zMCjAAjwAgwAozAcUIgqnGhsa187SsicmE6N6yG1a18xf3zdJjcHydp2Wl3hvegxr18iNS4PHTqOD2GH+BaZhX/m6j4X0f618R1dQYK3N2tDe1A4I6rgdbudNIVReaMTjHONldzZtE/Fl922+obqifOKVT60aAH1wsntQxearROwTGaoXjcEPgA94GTMAKMACNwSBAAf4PIlRpvdFLfxnc79UqDwNVCeRsMliuQudYUclHn6bzf9edcJbf1QL28vV2+lb5U/XkKF11jzF45AJmbCtkqhds1LXue1H1rQn7zm8FduyYPVVCAQ4I/F4MR+FAIzOpx7yVw+zpTndgJn5RFPgw6CarshEfmq6qUv67n5XnqbIfJVYohVxDrov6mJCtwPxT6nJgRYAQYAUaAEWAEjgkCZEsFh7mAceTKOOupTlRIrz8bKv+pKgm7c0I5NdzSc9kWgr5Gu7hDcelMuB2K2/B8ChEr/hh2J1bxWcdnWcg7f3VH7Z5q67mpfQL5p/mK1LcqEe2q5635TNhWX8MA28+qjl5EA78JXGZgo5CFtiI7BSVSGCeQ+pafp+dzK/ksjAAjwAg8OwTIaiGQRxRZLWCIkcUAIyJ1a9j+++ilS1GVghv7PV+GHX1O/Cksdu7qlfAXSZXuogdwbJK8TGtRWiFs3Rbu7Gnh1tvCr66TTQM+18nQE9pfnhgBRuADI3CQwL2FDvgzYh02WC31BDZYc2IIG6wlrUrbctqkYz3pSGG+4O+pf5qcgm4elgkYL5WBwO0gbkFU4KLWRvU2rrt94DvACRkBRoARYAQYAUbgGCEA4zhEBqH4INTOqeTAT/ygGoy/1fq0+L1snN4vxEJ/R4jJCto0aL+4w9B+YSXuMXoCf9qloCFOaih1e/u2KtZhXbuYys2/yVU766Lin+h815iA8bDBw/vWukzM16fVdvof+u3wy2ZOnoF7GnnfGgpeplD5Fzl81KDoEPDDRQcGeiZ4YgQYAUaAETgWCMDPHF3T1DmHwRhQ6Ar0UIPsCcT1ePwKOCh1MamWmtctMed2/aKfhG3RDy/XO/Wb4YXyz0R/8rDTncdPh9CjYd9tZT176rFwG8silKnwo5vrPkCde5j8pY7FveOLOHYIEHFLXz+a30RH/HUo228v31ZnNgr5CAQuLE1UZ9TXY1Vo5+siCyYZhXGBKtvn3f/P3psFR3Ke55r/mlttQGFroNFkq9WSZVCLZZ4jWzIptjSyJYqURNlCyz4nfDtxTszV8YzH58yNuu8nYi58RcVEzJlwxEwEETP3M+EQW6HNW1ubjfECmxAFCb1hqUJVZeX6z/slUCBIiUs30WgsX4KFqgKqsjKfzCa+fP/3f7+fqqvepLpQCbiIu1IYfMd3FnBP3VnCO8QEmAATYAJMgAk8AAGJix6ExqHWQsPXEjPLETcVICrufaVX1LM4g166Y8LaQC/3Z8qFJeoAjeujR7yw+PaID8BRfDydlEtXl5TYEqqVtBR1Lh4kDTPVGtpm3bf1xPNlbqNykPn9Io7MjJh1r5qvlH3xRdM259HuIqLpd5h0F6D0b4pQNCsHLk3LYwH3KA4hfwYTYAJM4FEQ0DTTgjrX4//5AYbtQiRsRhjSizCYF0DeNRB6lQl102ubx1THfFYMxFfie+53son0cifbmtjpDyMp8PdlZ1DDg7DWR2G0vR147XPB+pbwV/50xYOYq6uBxkexh/yZTOAEEKA6ji4bKAbrJmq5J8efrAbjLzeNJAduqM6ZRjHhN2XdDFXu2TE7l/+L+pI3Zd6LqxMfNRz9C4YDF1UcHrMD9wQcdN5EJsAEmAATYAJM4OETQJxCZUokXUs7HzWSQrU0Vu64xxzMjTKRcqdv4VtZVTSb/Thcs/AUqod/Whz5J4yK/f0Pvl5NlVMr7RXdQfMyW1MywonoDbUui9R3pfUpPsH5ZQNZIO8TW+h1JtRHdaiaGJcwuEy3mIQXaFy443EASxZduHN8wj5gfsAEmAATOOUEdiMWCghJRVmWuUSsgqO4hZK+YwoS5enijw+CGIpiUHaybv5zzPX+rn2s/CvdFbdU6ncbxssCGxY7Wa8Im/X8XrpVNBrjaIAmivkapigdo4YBp/xo8u6dAAL7tdyoUifvB2ZULS8va3LgXsTTsBbquO/bKLV+kWTBALVcVh9OlT/RX7V18wyEW9Rx6FoQyAb6F0So3GjwndY4Wise8sIEmAATYAJMgAkwgTNLgK5gClcgQM65ohyIbQQr9NJB+o3gsfy/1gaNn/iNWrrji+FxuV7hOIXTeK6i0Cfn7eLiorixfAOF+hVBuWnNvKkKTLmz8bQapn095tp+pn1vgAgFGaVjxYZ5uuzIz5imOgfXLaISSrhv4b0i5xUcWLCYW5qSR6MTpxEb7xMTYAJMgAm8CYHdiAX6f7+BPdc4hCpAsMWsI4XvKHoKKn6QmpsjhbOu2rqmxiHmziV/nX3cnBPfVbPJX3Z65e1elvYw/TvPBnERqfE07nbyNCnU7SJTM+2Z3F3DWo5J3tSbkOAfM4EjITBKMKEPI0H3+vXrGGF/Rs6356WfGzno+rq8Z3StMF7hsiBWysts2pRb9mlj5b+BaFuDi94INDEb1XCo31jAPZKjxx/CBJgAE2ACTIAJnBACVBvBjUsaF/qckYGxdKHM9UIR54/Hqne37LrS92O9Yjrl5WPQ4IxH4k/ImfVON7Oyd+85b5ch3Ap0MfPaK9JsouAXNRPHO3omndSUf1ukysMgg48L7olsQ3xc9PVnTVOcc4hJUOS0pSmz1ADD0HN2377TY8CvYwJMgAmcCQLku0UuFEauCwTm5mh+luO+KGkkG6IuBeuSQzfv51vZZr4GMfd7Zt79terZ9SAJtq0NstDi9VLkG+l2UZsay/O76+Xswiz6oUEkvopEXori5YUJnFEC+25c7P/S0pK6tLWoJtZXdRcO3Po9zyDXxHOlCWOVBblJW/mGe0YNzHO2pWYx7B7gq4ZstxqiT0b9C7juP6PnEu82E2ACTIAJMAEm8KYEqtmEmF+Ylzl8uEPZccOiG3fi/yd4j/s/bGrXm8XkoBOK5CIanMlraPT8CBcu5h4h/MP+6IMCLrRbtbq8qtaRl+Z1Nc6yPqJuJ1WeGCt6qW99bVOVo7OZPpf9a/mCkOrXdCTbyDm0kGvJfVvT+G019Q4Bz9hWPlcO+4Dx+pgAE2ACp4IA/vo4/JkhORclUNXh1cGfSw3QcpHhjwfcung6KDfTjfynasZ9L5hTf2ljGHCF7DXFWO5HVDSJLFcizxuiiljodpeLhYWFQl6Vj7yBwKk4TLwTJ47Avoi7NzhPsVjU06B+r4/mG5FXK/0wLnMfQVdjKQRc2TefVxBwlcXsKU+GFIOFgfgA3hKOwDpxR583mAkwASbABJgAEzgiAhSpUM0uhI0kK4auI1IXx+vp/xd9JPufg61gtVSmb9qN4UZ/OVsQCyTklke0bb/wMRyn8AtITt4PqiIfHYuRlVZ1LA7Xn5QRBFwfHYtb3S2lw2mZbnnawbGhBqmfyMLPZNnwSv3+fM1d0Z75NcpLk9pR8zJPBQrNLzD9TlfRCVT488IEmAATYAJM4E0IVCmbVhjIRVUBhAzOUhalKrVCDA8cuqnIVWZqckIjQwFi7oXBD/JP2HP5X+gL7q8Gva31Tkd2m+GYLuDozToir0HM1bML2cqtFYmIBckRC2+Cnn98KglQXXed6jpaUNvhu6TZVZ1XmmqqtaNTFRpTeH6Owq4MRL3c0E9hutWzZkzP0UA8huN95Tv0MZA+C7gVRf7GBJgAE2ACTIAJMIG3IlDVW5SogMrLwJgiMOVprOjrx4Y2vh0Wc3H/3paJwgUylyjUavTCRzJjcLdAfKtd4d8dewK4wFU3xA30kJlWXturohNoql3U39Hx0NPjwZgsto3vodgfqB0vj+SY21JXXEf+tmnqaRT8AW5I/0DzMlwMSINWGBB0qy59x37veQOZABNgAkzgmBGg0Ww0QMOkJAcXLQI7q9zcTCTw6sKZS41d8YJBuZUiZkFNu+96F+T3vL66YzO03XRl6nlRkoYYCVe3y0xnZbc7XyzsTl96ZKPex4wxb84pJTAamF9aEHIKfQ2uiCtohrxc1XeDVxsYKkm85jAKnDB+5sUhmtN+pPi5/kM7qd+DBNwAtZynfFknJ27Vx4BnUp3SM4V3iwkwASbABJgAEzgkAnTtQtcnuz0+MheXsUODs3KQDrMbwWPFnzXL5s8ygUDSWiPe6Au4catYhUdyXUJNSng5QQSq4v7A9uJEk4hOkNPiiuo0m7qzWdMDMTD1wjNpJzCYT2dEx4aeVl5H94IsctPltv6U7KlnbdvMY8odItVg2fURnxDJlrSKHLgs4B5gzA+ZABNgAkzgvghUI9jkwlWY0YGmmGiUiXv8rcFPfEcRPXiFqZt2OO99yOT2avx98cf9LfeFuN6fhnJr03SA/gHCTzZmvCCbNxO123ZVrHp/8+LfWBq4vK+t4RczgZNEYM/TsYhtPijg1lDfRXWro7xtPb9ukVYCn60/VmzKp01LzUGwpX9nyNBClALl4VIjWhZwT9KR521lAkyACTABJsAEHiUB9PPA/ELcqllQWuG6Ref6CTeQl4Z5v2ZTbfsF3LjUCI3cuKTFPYKFL4QeAfT7+Ug6MUa30ftIyB39jBpdiC0BAfd7utXt6npodSoi43eMicw44hP8sNCptyP6oRkTs+VPzVUViy/pljq3G59QXVbXVKialJu2F6HA58UINt8zASbABJjAgxKgEsjQwKAyyqNCCE2WKKczxLMAf8mqSCddU+1ozntC9dRzyW33ubjdf9/ADcd3sjiMAhEWcS8M+zN+Lpre3PqTFrmgJORimtOjKZweFAa/jwm8HYHRQP11vPAGXLg3Z4WkGVY0QN8Xvil3rBco7WUyMXmUj2Wb7pNKqo9IH5FYFqIt3Lf4d8YO3LcDzb9nAkyACTABJsAEmMAbCWAgvarFSJrF3CcaV9d1PTH8uftY6hVjqZRmwo0jtlQomiUlrldi7xvX8tCfPxLl+KHv1Sn6gP2LVBwpXA1jAiouWq/hIdy3mF8nBQr8lWRFDZKBifuRnhFGDROrw3jccyL1S4u8NJ3URaEvw61xRSn96/DajjvlrIJfAw5ccmyEiFPwsTYSb/mcOEXnD+8KE2ACTOCYEMCfLwQr0I2+SrQ8Q24uPccXHtOtdFlcdPKt8mdqqvyWf979pe3bWzoLOp4L87yOpmdpt+iHaVazk3m3K9D4DO9exJrko8mkOiZseTNOOIGReHuwzruBC4Rp3JrNNf2TW30zoeueKcJQuNyXaGSWbYhPydg8DxfuLKITIki4AQZIapXzXTr0M+By7oSfFrz5TIAJMAEmwASYwNEQQClGC2LgnMsRBDcsUhEjCG6AcLg8uZ2uBB8p/hfbkasouXa0H8ed9lS2tnmjuHLtSkH129Fs5u6ncIV3lLQf4LMOFvb09ur5SxBb4b4l8ZZ+FuSB6meBSbcGCEiDgKstCv263c52PNWQLXFP/VbZlb9jW/ocNbmQnkMGLu59UYNjg9y3iE9gAZdY8sIEmAATYAIPlQBan0HIFRBfqQesw60ScWWOnyA7F2IuXlH08s2E8nJn3He8c8VfuL69XTe1vkEWlefXkgyNz7IxURT9NTc0w3Jt8zKKKHHkRdRDJcUrP5ME6AqCnB1w4eqd9VU9O6hb2GuNLLNwmJVBUUdzwNviaZOY5/W4uoAcXB9hJSGquToiTDxUc9SQluv7M3n28E4zASbABJgAE2ACD0BgT8TFNQquU3CNkpap6KM185AE3axb3LFz+f/myuKvm7Kx0SvSoTfTT+dr87n4b5GNe8Rmkmoq4wPsJL/lIRGoineU3gfV/H1nBn0mafwo7jGdVHU2O3pOzEHPNaoY7gq4UTDmF0nqxVlqSMAtN8zTciCRfwtDB5qVSYXpq8hKgwe8BkGXG5g9pOPIq2UCTIAJMIFfSoCGDA3+zGkETpXkxqXcqbIsdZWbm8shRN1MN8xkWFMTaH52If4xBKtJ8c2dyf7Lpl+73cBqA7zfxHDmhvOFRal1uYlpTdeWqVNsLq9hvbwwgRNIoBqoR4138+c3davdUrY30H4+pkub+mhgZodeUtO35CfUUD4HAXeOMqfhubXaQ4NaZFCzgHsCDzpvMhNgAkyACTABJnAMCJCb1lWZuEi71egtoEtoZ/ih1IFqpj8TH9UXsmVVyC0v1Nrv+nrFrJTfv/p9MlYWR7kDnH16lLTf5rMqARevIdF2/6V0KpErg35CtyU4cNsrmhpc1MPHq4w0zKGDA3dc17QfmELaokSEQm046TbVJ1VPfk431AxW6VHeLWTbCAJuXRqFWDU4NiROT16YABNgAkyACRwtAfypE7r6u6TRXNMoaoCGACARSeuowaaVSkkdIS931l8QPflctll8Lm933heLzTbl5eZiEAWxQF6u8CMMT07UJuyqEGh+5uzo7+nR7hJ/GhN4cAKVgHttT8D9YEsNXm2YqD6v88JYkysdl5kN6nJGbMtPmXFznv6N4F8QBFwZVoPy1DCQSkhemAATYAJMgAkwASbABB6QAPXcUCTJoUEz5q+jvlKeDMqhfC9qr7BbJNZDg7PY9yxpcotPLEK8o/cc3cJO3KNjfd+fdO3aNQXRdjf7Fu++OXtThushgs8i2R10tQ2s6g+NogiFSsAtI9sZ9H07qaezfzEvKIP824YaQySzh8xbi5MvkgEEXI1HFKHAxf59HxN+AxNgAkyACRwqgUrMRaGklURGrhQ5jSyW0kHBxUBjLjOEJAy9cfNYkajF7EfZJ8rp4lve3M5fFcjLTY3sFLkzthdleRoW9VBk/vo6/nbOypdecsXVq8i24oUJHEMCVPCPBu1HAu4NXDXEfkvNICarUFqFibV9k3j9LPfsuJgY/pP+vD+pLuKCguo4FICo6zzKwXUWu3ikFxDHEClvEhNgAkyACTABJsAEHoTASIilWorKM4X+UbZ0IiMdzaXoMBXopojNvFLlHdh0C5uogmbEz6JHVWW2PMIq7Ag/6kFYnq33vDFKAd231Q1xQ12ZvSKX15erDsVmE2G2MC3FQWC9odYmUbooMNtukNqhzjxc6M4MXxEvaKt+A/loTVwhKJx2PhX6SE2rU4dwKv6rk/Ns4eW9ZQJMgAkwgeNOAHm4VfMzJOWimsopL7ek9gKFSCWaDTg0PysH5Wayka/pc+479lzxl17i3bFC9rQdT9Ksm0WimWc1UcR9UQygB9/B7crXIAUfcV7VcUfN23c8CLwm4N5A7tW0anaaug/ptpbNQpi1YSx2/NgUY3Zg/xsVmy+ahpqiZrS7M6tQ51WzqlDr8cIEmAATYAJMgAkwASbwQARQjzm61qCGHbgGoesRdFx2sctE7BLXL1MXp7305fp73Uv+wFvXAeQ3kQzaoj3EBx5pnBuLuA90iA//TVURj9W+zpWB+IQb14WeFsvKay/Iu6+sKa+lZT20uoiHtp0gJy3RQe4g4MKlocbdTPYT9WXjm9+QvoPjVloU+p70VAgHbtWxmAXcwz92vEYmwASYABM4ZAIonFA9Ie0WQi7+yOFvY1FmLkHbs3Q3Wwjht/1iO90qfqan5beCKfGyzs29yLbiHG7eELdM3csLNVlmWpRDg9zcTeRVcfOzQz5QvLr7JTCq96r3UUzWdSFpwJ4EXMy0UgNRM9E2GpnhNE5lGeahGivviWf0UH/BjOlzJODSzCoVydaegEuNzHhhAkyACTABJsAEmAATeHACkG8h3eIaZHRDk7MEAu6gHLq+K1yWbRc/txfy/93K4m9qptXpiRR+ke3hqljNr1y7cmQNljlO4cEP8qG983UF/Wite4X9FTxfaSOEA026W62ujuNAh8NIZXlgcBoFuSoM5aTpSXEu+1f1gvFIwBUtpHdQi4tA+phmZ12AbEHkC3Je2ggv3zMBJsAEmMAxJoBZJIhXUBgKpzsJB25BD6oGA4VMEZKQI0doIoz0eL5VNFO/qAmb/rgQd/4xEM3t3LgiSCYz54lio79djIVjxfrserF1bTbH39wjHS0/xpR50x4lgb06j5qYTc9NU1SWCmuh3v5Z30S2FhTK2FKXdXdX/pYeyuf1mJ5B8z+fZldJH3ov5llh5J8F3Ed5DPmzmQATYAJMgAkwgdNC4LWYK1hdK41OorEZXYsY6GiFzExdTaDB2a+pS/If0mTYszWrVXoRM+cvHmmkAk+/eoSnHJ0Y5NauMjSomMeNnlc/23NmLMOFSxEK3W4XzYfPYQ7dBARcbSNnwtjTPuI5QtMWc+kr+vfgwP040tFaEG9R4EO8DWRLeaoGQRddi1HsI2vtEe4ufzQTYAJMgAkwgfsigAgEan7mIx7Uh1wVwIEYVM3P8DdOIekdfQe0nbAXdez9bvFz9R+THfXCsDn4QFwO23fEMEhSND2zY34W7/h+MmsmarctmoNa95Jj8eu+jgS/+FAJoN67fv06zYZT4dyT+wLuTt/qWTPpISbLIkMkdKn6oOjLZ/W4mVXoZYB6DvFYqoE6L8TYBhsxDvWg8MqYABNgAkyACTABJrBLANcgAjdFX9WgucJVB647dGjGhXJ+JrXxUmX7YtOsJCvUy+rItLYj+yA+GV5PoFL2Xyvid38J4Zam1e2dANXUujtwZmzg+jWAAzcQxsCZ4ek8j2KVenlRRqUUH8xe1V+1nv63KoQDVzmvusgNRRPNLkJqYEYnHz6AozNefwj4GRNgAkyACZwMApTubtAh1tsVcpH4bl1IQhby3jHbRAQaI+PBjP9+k5qvDP62/E+9TvkFV+tf7oitdpkNQ880fNsT1itmTLrZsmtra5570dlq0PRkMOCtPAUERrUf7crXFr4maaC+01nT3V6o+/f6pp54fgYBt3TaikZxvnhFvmDb6gJqOwsPiMVQRojBC8yuwlnPCxNgAkyACTABJsAEmMAhE0C1BrMlReRCQcM1CGowdDLDNQhdi1jRF4/Jgb4oiyJUmdLUpypAQ1qxjHZo9J4jWI7kQ45gP07MRxws4A9uNDkyqKC/uXVThevhfhMzEnDrg64O1Tnjw4FbkgMXAu5QJDUj1UeKn6ivmLa5IA2al1F8gqfd7CsLAABAAElEQVQCFYi6gFuD4xMOEubHTIAJMAEmcEoIUFpVgUIJmbkIVnAIW0B2LhJvU2pDgMdF2c+30k65ZqbEt4JZ+Q09NPeg+g58FaYIrEJersiHFjezgqzcy4Xgxmen5NQ4vrtB9d/1awK1Hi4IUOiTgLubgTswNNOqtmO9UpugV6a28OMp9xPzVa9ur0CyRY8DNKTFPR43qsEMHpg/vgeat4wJMAEmwASYABM4mQSqPFxX0gR5lFp053DFkZWp6LnUDdG+LC3TMs52sv83vFT838HQv1VIvaMuNuKt9eV8YWGhEIu4OnnIzZRZxD3i02sk4tKBHT3e3wRYsJeXl7WHDNy7rwSqNmdVhKl1BtGAQYJsNDQxK7LUG/hJTSr90eJVtWgnzUVqcgGXhpEh2lx4oir2yeqN9fLx3YfLD5gAE2ACTOCUEdgVcwXk23JPvkVxhSYEGY2EQ+JN8638VTkpbgiZ/9D69h9EIraROJRbG2aJ38nCpJXlYr3st2cLbnx2ys6OY7I7Va1H24JLAZpptTtY/yQG61fk4NWBqeu6KVWE9GbPd2hSm4fFmNu2n9ax/qJu6BkM0FvMqaqhRW2zEnDJl84LE2ACTIAJMAEmwASYwOES2GtqhtqN1ovLCco/FXmZlWhDJYciRZPlTMRlkf+lvZD+WS2J1lyqd6RX63faK1llDBEQca/J8nA37PVr40Lw9Twe/jPS9PeUebizXSWz7kmtN+DMEGJBUAZuTW8q/65WJOAWPeO5QRYW+oCA+1N11U6bS5WAa6vghAYamjVU5cCtctJYwH34R5M/gQkwASbABB4dgSpmAbNOvMqpiCnm+KLc3FoVK2Sk542bx2VfUV7uf0i20xeKifRXUn/YLrLYdzs2CIQIClELxmLhrTUhlr0ojLvmuDZ6dMf0dH4yXQsgLuvG8g1Js63uiFXV2axpX82pVE0ZmXgB+u35GIwfc1tw3w70c6qhJyHgesLKUJMLl6bwsYB7Os8P3ismwASYABNgAkzg0ROo4hNQbeELYhpku73vGl0J0EyWOnXgkS0H6iIMlpfiYuDDRCk7YhN9rC7Lm7M3j0SD46YIR3iq7Lsx3viZKO6Xri6pJ554oppa5yNCIarP6xj5Gt5W4kHJDbZd7qENSx2BHB/JVxGhMIkcjiqfA+W9LyO6aMUphVOIHRpvxMvPmQATYAJM4FQToGJLQ+RSGDGX5MqVDiPg1gXU+EwrZXTo1cteMZHczH9DTuffVrP976iButsTSc8XXjqMoeYC0fq6kIkQGnm5hVhHH9qHPJJ+qo8K71xFACfn7syr6tkVfF8WftPIvNs3RTRtTCcNkABiMysbckM9LWP1rB5T51D7WcyxsuhqGyIiiwRcbsZXMeRvTIAJMAEmwASYABN4KARIhFX4VqXb0sw+0nPxzaAK07jG0ND0lKrJyXRVPiEuiR/LUm6R8dIX6xSLWsKT+dCFXHabPJRj/yYrrVzZNKOOXNm7N3JqL2F63aXPLFYCbrfX1d3BboTCNDJwg6DpJ3BnIAetJTf1leKn6g8g4F5Cce+hpPcQlluHgIsIBRZw34Q6/5gJMAEmwATOBgEqsixcuRbuXIx5wsWIQVDMUCEBzOi6ngzm/Q97mf39/g/Fnww67os9r5yNhYkCZCxksfBhzbU1Icy6EHalLezL1142VMCdDXy8l4dFYL/GwwrpMa13CUV9Aw4Nr70gaz+3akZMIjJLexihR2CC9k2mf8XtyN+xLdhz0ciP+hrAiRuSE7e6eDisjeP1MAEmwASYABNgAkyACbwZgcqHSw4R+tq9Q1gpzfxTmPEO0yQWoULRMqb00myobaIRgTqrFlDjHUWDM3bivtmhO8Sfjwp4Ogf2l9HUuus31KXZhmwlLdXtDTQ5cM02IhRK4xWl9reLHU/bvOk6/ifVUH1ejavZPQGXHLh1BClE1TRSduDuo+UHTIAJMAEmcKYJoLJCgeWkgiVXkbIrtTPIsErR/izRNT0RRqaVbmbN0itrqen+KFflPwSZ3S5s2xZJL48267lV9/KgeTkXX4eV8iUk7V6Fw7dqcnCm2fLOvwMCv+w8mUJkVqvdUoNXbyMHFy7cXs1TLvOHJTy4kRuXP7WftGNqDh4PxINgsl41ywpJuBBz8ZEHK8h3sAX8EibABJgAE2ACTIAJMIEHJED6LVyX9B8e4UtpYdA82ZBZBJ04wnJLnU/viQkZ6VuBr7J42CnX/VY5Owu/7vWqbtuzcD7gFrzF21jEfQs4h/GrSsClw7cr4lcHssrbWxKUmaGm16ell3gyyANV4Ku33VXnwklqYubHKO6VL1tuy/+kiNVzuqnOoZSvHLgo7pH5h0ZmaGq2u/bD2FpeBxNgAkyACTCBU0KARsolJLDqXuVIWFAarlxqeCbwzE6Yi2Vc/G7SdU+ptvyGmM2/F/e3UIgF22kidFCf1KYr9O1CqKy/VnavzRduwRXyqixOCSHejaMgQJUfZlxNi2V195Wmmmrt6DKpezWRBXGZewrj+O6e+iTO01/DwDx6G6DSQ41XDdQjUgHv5llzR3Gc+DOYABNgAkyACTABJrBLABIunBvVEDrcILt+XLhxnXHIaRMFnCIGWlyAXgZF7GvXSv1Alzvrm8VKe7NYE2uYyEdZDJiA/xAWHtl/CFAPrnLkwoV4vyvgQtBfWlxCfMIlZGbsdiemRmYDUTPpdt80TOjJzAucyr0MAq7YUs8gH+3zqiGQj4bgBOpRHCgIuIIjFA6C5sdMgAkwASbABN6MALrNYiS9cCVE2BJdZgtIuU5mLnc5irQ87+Wb6Va+ZmbEt8ys/J4ZyNueifpGlqmX1ZJM4DXoNou83PLirOC83DfjzD/fj08YoRjVfDvrE3paDIzoND2YbGvCM36u07FiS1xRsXleN9SM9kVE8Qk6UKjxEAfCObgjjHzPBJgAE2ACTIAJMIGjJAApD65aUmMFrh4criJKl7lEDsph2Xex66Q78cu1D6j/K+yJWzKoDazIhr1mL5mvzediHDP4HpLxg0f3H/JpQOLtSMCtPgpS7tQTU+hO/KTsNNc0dSfu1lCvx0ZHiEQLS+uPBNxiU3xSDMRzukURChBwPXQ8o8KeBdyHfNR49UyACTABJnCqCMCNC0+uRfMz5ORKT1kaFHWhomAiND8zDTsRzfsfUqn9g/iH7k/ibfHFnh6c63VTPxP9IMDf39283LtmrS/MMnJzq1k1pwoS78yhEqCh+2tCLj6xKFt/11Ltqtab1ZEZ93KVmTwfRuWmekr19ecN6jwk4wYIUQi0j3YZLOAe6qHglTEBJsAEmAATYAJM4H4J7BoyyfdaeXJhrIULF1Ft1Xow6I6Y3AUMxp/LTWi1UKbvaW0Lq1aSFfUws3FZxL3fI/kAr6eDT25qutGUuiuzV2QkVlUNB7iO453d6xtfGVPTY0EfDS4SI+puUzxthoYE3HMo5v1dAbfKwK1VF6GcgfsAR4LfwgSYABNgAmeawK6Yi8xRak4ACdfKQHiuhhxSHzKvwXSYidpcsKB66vn8TvFs3k7fF4uk3U3jsChEFHpTYSMRwZQQ3qpY9SDkcuOzM31CvcnOk4CLPLQbiEKA4K86E7Wq1ouU9fJhYkyhtJ4Q59yW/JRp6VlqloHBhQCtjUd9DvSbrJl/zASYABNgAkyACTABJvDwCVBXjepTqin1VaoCBFzIuKjbNH7jpFGBbLh2UsZ+kiXapFJb3+rLjctyGTFae9m4h76lu1t16KvlFY4IkIB7/dp1ubCwIBeXF6uD6bV3M3C7XV+nom8mRVvJQR6hpvcGbliDXfuj7qf233lt/Rgyby08Q4H0XR2+oRDNLjysm4/bCDDfMwEmwASYABN4UALOIWIBsQo0PaoKXEDrs1wOywJfw7KbItZKTeXfUufF98K+vWWycAdD7Ikv6ilFLCRNUcx3Ea+wgBs3PnvQo3Di31c5NajCp+rsgIBLObjNZlP3bwVGFuhzgMS0wtdW14cz6ar5fRuZZ2QgW9TGDF2Om9qqABcH3K/ixJ8RvANMgAkwASbABJjAiSdQxSkgkg1xaohToP8QyuYGRez6LhF9kbpBHqffDt6T/p9hXr+ty2w4aNihb4bpjr+TXz6HBskP4fqAnbgP+8zCEV9Y+NrrBFzKwN2ECzeOd/RUMqFFJwuRj2x6WRxIpz/sVu1XbFudrwRcZOAq30VoYsYC7sM+Vrx+JsAEmAATOFsEJIZG4YLEd19phCwgagGtpEKJuAVTM+PheX9BZ/7V7Af6j/qb+fOxvz3dR0OqPB2EFLEQdYVdnxVmdXnVipfh5722N8XqbFE883tbRWcdbF6xICQJuHdEpEjAdTrxlPYDZ3JPe9l4dlc/rZV+Es1r6+h2rNHnoIr2YAH3zJ9KDIAJMAEmwASYABM4pgQqMy4N2auqZ5nEFUSIjNz3FlpEWS61kjXjOW129ty4YguVHaK1Dnt3eLT/sIkeWB85M5aWltTUngOXivnGpq9sTcmob3UaetplJih06W3GfS+cNHPpD9SX/Tn9XpwYmOaJ0wIFPi4mI1wawoG7d9oc+Ax+yASYABNgAkyACbwLAhSxgDIMJVZR4obHSMnFX91MJNTLwNR120SqlWwWrUSLwM5l3x0I9/N+T2z5rlTlhrOt4GK+/k2hZttonvaiK6mZgVhEQ4ODwt672ER+6/EnULlxsZlLiM1aRNEeoeb7VeTg3hlaMz6UQSzQsDaUTcRlPaMT/ZxqyikM1lcxCtKTEbKZuSY//oeZt5AJMAEmwASYABM4UwRGU61op6HHKhg2KGeBIhVyUahA18VAXxCquIdJ84VGpMKEj6uJLbxmHrdx3A55YSfuIQN93epwvKeWp2Rj9qakCIXLTSNDYVQl4Apk4KZtXyMbLS4zG47bmeyf9fPelH6PQAYu3EBWUXMLT1YNLnCeHPrBf9228hMmwASYABNgAmeZgIQjUuNvb5WXi7++aDQFh2SEIs3iz7nyxvUFk9rfS76v/tPOVvqFtNl/XxwN2yJFN4Oh8MOW8DY3N/27ufB/9JPbgfhTpO2+5PRI3DvLaM/Kvl+H2+LSn99Uq+ureiBqpn/PM/U48dJS6UyVAZpefFDuqN82TT2HOi+giCzk4FKvAxJwuc47KycK7ycTYAJMgAkwASZwYgi8rpYn+ZZcGrB8YABeqUA1s5+qD5ZR3kxxUaAM+h70tb5d3FYrt1YkNTg77B1lEfcQiNJB3W9ctre+6kBfF/KKuCLC9RAH7rIYRSjEw56O+tpzg9SPlfJcWLSzVf27yEZ7ClPrGtQ1G+EJTfgz6tXUTjpReGECTIAJMAEmwAQeNgH8xUVCKQm51FSUskrR/Ax/mzGoqgLbtFPRBf/DfhH8++Hfif+SbLov901n7m62HeaDQeh5bT/t7PgXihlzOzkQs0CNTXk5tQSqmg8C7tcQoxDOPSl9jMV7GBMo0cjMK40tEJmlWmYq/2f5gj9lLik4cNFUDw0SZA2/8VHec513as8O3jEmwASYABNgAkzg5BI4WMIjRgGD7gpz+BQiFai3GU3nU4hgK6wLc5EZuHNlv8SvI1xQIEZVPHP4e85Ttw6BKWWhQcaV1MyCxNxqlRBw0eikslF7CTUyW1NFGSiTejoy455fZn5sMwpMaImO90kEaDyJYn4M7SzgwEV3YnLh4iIS6zp41hzC1vIqmAATYAJMgAkwgbckQFIuXLlUl5XKacycKtDWwENQAiZOyUy3zExU0+1sI2vl2gXmfPrteOBuZaXakcKUeSqyTHTT2tTFdO37Qna/iclX11wur8nyLT+Xf3niCIwEXGy4Wl5eRozCguoOrJZFgswsEcRB7hVBMibueB+34/oxyLU+JuBVObgYJKBGZhrv5VrvxB153mAmwASYABNgAkzgVBMgjQ8lWnVXda7F3uLpbu1GblzUcDB7lBviguu4qVIXd1SWaJ1YbRpGm6Ypbv7TTUm1Iq3lsFixiHtYJA+uBwLuDRTz0yjmKUbhbh6oVtfXkTDaITdBlBmy0ZTNIOCWHflp2ZPPmZaaqjJwKReNIhQwfROr5KL+IFd+zASYABNgAkzg6AhQkWYwZ0qjbitRxhUYbseMeGTUO5GTHOtN2seKgb46/Nv0E8lU8S0z1/0L1bPrGJDt2LxZxt0OOpNmUs9OypVkRSJeIees3KM7gA/zkyrxlj7gWlWrqWXUfZSDOxB3TaFiMyYmvcRlXh6UY+WG+pQa6meRgzuGMwghChistxJRHQ51OJk6eGECTIAJMAEmwASYABM4XgSoRMMVAPW4qLyapMMiS0E6NK3FVUIB0we5cTGPXoWmlSM/S9gAUl6p+ohUsIVV1az86m2Ht2c8fevwWL62Jjhwr8yKKgeXBNwaDl663TduK/VdP/WLRJnMS1vFlrgid/SzdlzNVQW9jxAFmrJJDly6dOSFCTABJsAEmAATeNQEaMwd3kkMsdLfZy0Qt4DsXJoMj5/pmmoH58MFk5mrw+/LP0q3yufisj9dimEQJTbMiyDINjt+a7NlRR8DtF8XBq5ctS8CPuq948+/bwL7xw5F+Q1y4OLWbK7pLhqZpdvWNIrQz4vUlkFSl3fUU3pgnjVNdQ7JtwHOHh9nUkiNzOiq4L4/nN/ABJgAE2ACTIAJMAEmcEQEfqFUq5y4VR2HWfTkytWhbKWviCcKndeSPJEqG0LAVcb6Vi/A1CnQ9PYwN5aduO+CZhWdgGOKIpzkebdf1GOdy+vLsFhEstazKqpbHYaRlonxtl3PU/WiJTbUM3qgntMk4MKCjcOPBios4L6Lw8FvZQJMgAkwASbwcAnsNj/DADuKMcRhYagd2QkuxUi8MHU9FYV6LNvMWpkuguFc97sDuHKDNNgObF3lQujVn2znYW0si8VqsfHixcKtu4IjFh7uITvstVe13t6EuKWlJXVpdlHeWV9VojvAjKtzqqa1KWVpdrzcl7H8laInP+tNqQvUNA+1HhqZyRBZapYH6w/7yPD6mAATYAJMgAkwASZwqATIyKHIhwvBD9+xbgpGoJlUZOxAngJmVVEXjajcku+VyMVVQ0RmBVGpyxJ5ClqL8HLV3IzqR9IMD2PrfkFWPoyVnsV1jIr6Jajsl7ZuqlbSUoNXByaqz+ugY8wwzyPra9uXvZbshs+oofqCGlPz6ILtKzhwVSAbcGhQcwvKRuOFCTABJsAEmAATOM4EnCiQkVugrENerigg5mYIWYjLoiyKuNzOtrKf6WnxTTNbfE8n5lYTw7r4c59mSqSpFnmmRTlvRHnTF+WT64hq4Lzc43y0qXKveh+I60IuLSzJqeWpqnntyIU77Ea23Em8qPT8vs491TTTxavqD9Gs9rdMJFvoYmx1UEVm1eHo5sisY320eeOYABNgAkyACTABJrBPADU/qn7Eq+1JuQ7PM3S7SFzqEjg1knSrWPfmsv/VKveDumv1eqafNJpm0BXdeL42n4tDrPXZibt/XO7/QVXQj95GmvqegBuuPynvNtdUWxUq7QxMICbCwnc2E8OaMcGH8p58VrfVLBXx6HqNfteyzgLuCCTfMwEmwASYABM4AQSqiAWMv5c0sI6BeGxyiQF2PElM3bRNZMaKOJ8b/kg+LdvlN9Pp/jfqqbhlRChDuHKh4uW3a6KYydeQrjtPebmFuIpVHNIo/QkgePI2EQIuNa1dXF6UArFZy+sCs65WVRcu3PqwoYcQcAttPO258eKu+iSO5UepxsPJYZSHgXorQs7BPXmHnbeYCTABJsAEmAATOMMEqLynpfqOb/DlSgU7piyRjAtfLgb6TaQbw7Xk19371CvZMB1iVn7WLzOlG3r3vYeIj0XcB4A5ilE4+Nalq0tq8YlFXJiFVUEvujWdqtIYF/gZLDiFLiPEZXw4/xf1FTujL0C09ZCGRiV9o7JicwbuQZz8mAkwASbABJjASSCAIg7SHIo7/KcwTV5iKj01OkhR6OWmZiZ1aMaSjbRZbpb+cLb7HTMcrO8UcsfaoJjIony73yzuhSIbrq3l3WvdAoVgzq7c43foSVx3X8OI/ZKQN2dvSmpUcQeNzKZFzURizJSF8eG+MKVXNrItCLgDiZ4HelIaNMKrcnCRsYVzhdphHL+94y1iAkyACTABJsAEmAAT+KUERlEKlYpLSapVwILCID3i1fakXYpXSMwlG5bIUJP3oPdJ1UPlh6lYy/1luQAXwGEthxqwe1gbdZzXUwm4extIBf1oWxcXFwW5MqgzcbcX6iBGAAYaW/hO21Sju1kmPlD+RH/VntPvg/s2oBxcJOE20cmO2teRmM5F/Qgm3zMBJsAEmAATOEkEJDU7Q/GmkHmKlmcCmVjSF3XcR0I735u07zG5+f3hj82fDDbL35M19/6sGLa7ZRx4VltbCtPPAjMuFsxKW9iXryFri5fjRwCVGnJwq+3y0KiigQYH6HSnil7ieUVS1Xtpmn9AdOXvoGntPATckARcysGtGuOR5M/13vE7rrxFTIAJMAEmwASYABN4pwRIuKUvuDTxFmqQVdV3aHccZRuuPVToi5AjGxfD97rUamEBAi5mcr3T1b/d6/gi4e0IHfj9G+MTHB0uWq4JeWP5how35tV5v6GrRmY7aEanA9N1PV83xVTxirsCR8aFyoWhnVWBqldCLgu4BwjzQybABJgAE2ACJ5YASXQGrlyFgfkCg74lZlhpp/BViEwZYyliIe/n5wc/zH5LT4lvqon+n6sdc08FAqXCZBoEeF0i5EUqCK9hnPhryMql0X5eHjmBUQ1Ig/bLy0J2xLquD8Z0WSQedHp/2xUQa13b/dw+Y8bUeYi2FjdqZ4aji5YXEjI/Ffy8MAEmwASYABNgAkyACZwcAtTWjCZSlXsu3N0tR2mnqMqHhIvvpOmi7vNrtiWzHN0vhKxlUt7SWvX6q+riTy6WVEtiRe+6rmcn7v2cOiPcoxKcnpOAK25gOt20+tUJsltoFSbWFqXxY7eDsIRyIvtn/bvGmI8hPIGyb+G9rQTciBtb3A98fi0TYAJMgAkwgWNPgGQ6lHD4W0/ynYaoS48t0pag9GHw1yAvd7J2Pvyg7psvptvi+Xwy/ZWO2GrnYuAlpfDCvvCbQnirAu/9ujAvLTp9cBbQsSdwyjaQCu5KwKWa7yU4LbaEohzc+sAiNmtgQt3yHBqZ+XU0L9tUT2kpf036soGGxVZ4LqIBe8RsYFIdviDOnzI8vDtMgAkwASbABJgAEzi9BKq2tpX0im8o40jQHYm6lJWA2h7BCfQCjZlXjf5K+f7cuCgViRpmUk80lbq4dRG9FG7uNsg9BFJcTL5DiPsFPL2eqFExf50EXAEBdxkFfaQGyEWrDz2rkjyKReHLlhpL74hP66H5km6qaZTwATW4wMGt0UXd7lmA9fDCBJgAE2ACTIAJnE4CTqCjLVJyBW4lxvBzl5aZS/A4LwZFJ+0Ua3qq/KY5V3y3HLjbMOvuGBWmHqq/DI3PMr1WdrvzBWZiFWIRjc/YmXuk58mo/kOKgrq0dVO1kpYavNowzbpvBTIwytR4SU00xb3iMyozX9QteR5RWZGiJmao90jQxzGjypFr7iM9cvxhTIAJMAEmwASYABM4FAIoB10JKy31MHYkBVb1OJ67rByWqRi4oYsRoRA7V/ytP5//16Dvr2tjY1PPBgM3iDf6GxlycQ+l7wU7cd/BMa0cMNWRoqN14A3ItSABl3LRBmKAxhbWyNKG1JkYbSwayS3xjBro5+C7nULvOnLgRiTgQqi3LOAe4MgPmQATYAJMgAmcVgJ7zlyKU4KP06CpKWWkRtKToWmZqWDO+5Ap7L9PfmT+c9E1Xxrowdww3a7laT8kV26aznsTNWFXl1ctOXMRs8C120M+V0i4pdpvJODSoP0iIhSomVlns4bYrB2dbwytyet6qPqeqGWzrqOvUIwCHNjUuNZKqvr0fiOzg9XjQ956Xj0TYAJMgAkwASbABJjAIRIg+Q6u291yrhJwRyun32ChKAVU+mG2Xc5g9l2QoxpU6HQ2LJU57FxcvhAYwX+rezpWB8tvCLpLV5fUTUypIwG3hoI+FZFxqfWNTMyOGgTOqQ/KrvqMaehpZTCR0sNFm8VFGwRcrIu5vxVv/h0TYAJMgAkwgdNGgJqfkZBLwp5BVYCIhWqGjhG+rpnp8Lz/QeTjfsF13BeyJP31HS+d6mZxWC9EEGUiaIqL3vq6sKPGZxyx8HBOkIPC7WjWFTWjWK4G7RckxSjkSWhLY72eQ35W3U6U/6Q+b9rysT2hHiEaiM7QGM6nlOTXV5APZ6N5rUyACTABJsAEmAATYAIPkwBJuK+pgmTyrGIV8DP0ysKXokcmNE0R6/OuLHyhg+r1KkTcwq3d9x5G/c5i4js4zHRU9l9Gj67DkfHEomwlK9WUOhhlTKMXev5Qef0yszoyU/m/qC/ZCXOxik1ADi4u12pU1OPQMfN9mPyACTABJsAEmMAZIoAaYFfocx7uq7xc1Achhnd9VAfWjJvHEbP6e+m6+u+STvrFfrPz/kG2MZ64gRd7wvrIya1tCn0R9ze/fpNduQ/71EG9twQB9yZiFLz2ghy8+iODbmUqlONVDm7ZyMazDf0UWtZ9DL7bBo4hVXyBMrhRI7ODxf7D3lZePxNgAkyACTABJsAEmMAREYAwuOvMhVyIClBhwSPlq3r/lfKDReQaWZFqOZBqeyDl6uaqFJjVdRgbx4Li21CsHBkHX4OCfuTI2J1SZ3W5Yz2nrNeHFTcPijGxoT5u2/oCOWxws9IXSFoQIVzWVNDzwgSYABNgAkyACZxhAjTrqspKJVcuTb/CPWbrBDQJX0d6PJz2LuvU+2r2I/PfDzbd89tF/5xI47AQ/ajuiXBMiGC++6Qn2sIiXsEcxqj+GT4cr9t11N+vDdxDwL3057s5uOnmso3q8xpht14+HBqtbSTuqqchun/e1NVkdTzp+CEPF8eUZ129jio/YQJMgAkwASbABJjACSfwWoU4EnBJx60cuFAJZYlGZ0KhwVmoWqWENghjLr7kuBgX4vG9fSc98V0uLOK+BcCDAu7Bop4cGdTILBRGpR1k4QapL1zuF/VsvNyyn5J9/XlVE20KUUDuXR0NLmpVZ+K3+Cz+FRNgAkyACTABJnC2CNDgLhy55MqliAVfea6G2gGuXOnZBkUseB9Ctv4LybZ7vlfrvr8jdtqd/kYwhCs3yYV3LxbeWhPDxNch5r6ECfzIcj1bBB/e3i79/VLlmAjnQnn3lUB5G54qdxIvK4Y21rlXNt05sa0+bcfUPARcH8fPCk9AwOVZVw/vqPCamQATYAJMgAkwASbwiAhQlQ3V9jXzBOpuispVsGMgUIEWMmbk22IG9owgE5mKoOTK4ba8KC4e2kaziPsWKA8Kt9WF0TUhbwihwvUn9xuZ1Vzg54W2zsqGuwdHRk89a5tqFhdhND0ylBBx6eIMH8MXVm/Bmn/FBJgAE2ACTOCMEiBfroEQaCk3n7JydagaqCECem7H9WMms1fTH6o/zrbMc/0wnd1J7zSiZBD6MTU+2/LWEa9Ajc+Wr7GY+27PoZEQvri4KMSskHcwaN9q+Tow00aUnj8ore8HejL7J/ecbavHnXLWwU1dHS8NAZ5zcN/tIeD3MwEmwASYABNgAkzgGBIgs0Ql1u7l4VYSH2RDoSHljhQ/iTq+LrflpCqkjvf2Ym0Lr0JdeRg7xSLuL6FIBfyoiKdfHxRwpyHiNptr2hPnVNEzXuFrm8oicJn+FdcVn7Vj5kJVyMNRg68autTxlLpfwph/xASYABNgAkyACRwggAIQUqAHJ6eHUXyDpqie8mREzVG9mm1Hs/6C6Okvll3zQp65f7upelO3RRzUCy+oIV6hDFr+RE3YtbU1T7yIFH5qtsDL2xIY1Xz7dR+myo2a16783Ypq90IdxDs6N0mVg6vDdCzbcE9bz/wGAjAamGmlcJxg1cWxghiP8pxr67elzi9gAkyACTABJsAEmMAJIgADbqXSkhOXZr6RaOtIlKUIBaExqG8chaXRb+DCzXfUXKlzKzI89/Gj4rYS6/gtorre7V6/6xW82w04ju+ngzJy4dLj63DgPgPxdhqdiWMxbuqDrq7rOU8UWRgjRiGviRn3M/2HNjBPqUC2aEokvurVlEgyVPPCBJgAE2ACTIAJMIF3TsCJUhTOibwsykzkIsX3RJQuL4flTrZT3Jbt/Bty1n0n6NtbDRPtZKpIMaicwzeaZ/F6sSW28gWxkMtriOji5U0J7Iu39AqU59S8Ft/VMm6dzpqeakU2TKx1wzToetmY2rafRtfhL+pxeUEjx1ig5tOhbFLth3dyzUcceWECTIAJMAEmwASYwOkigJIRlTgWiLm4UdFI3k88dy53mRi6XKYicbFLZb9Iku94jxd/hs7EPxNW923YSCZDkYpNUYiviQLJC7SCB1rYLXAAGxXydBsJuKNfLSAXrQHr834OrgpNr0j8gdJeHqgxt6GfhvHioxBwqyIeHYrr5MblYn5EkO+ZABNgAkyACTCB+yBAfk5DeblKw5GLnFzlixq+RxhFnvJnvA+YzP+D/If6vww65Qsd0Z8dpFkYJi0/Q8RCKGa9cbFgVtor9mVufHYf2PFSOCRuVjXfahWj4A21zuPE67nMmppu51vi03ZcXdh1TcNrgUZzkG49rvnuDzO/mgkwASbABJgAE2ACJ4xAFXsLLy4N+OO258itUnExG4uycXGDFujnO2JeygwRq0hHQ3CudltqLV9TN2dvyj3DwAPvunngd57CNx4Ub0nMrXYRLtxFsShXkhXV7TVw7YSGxDoKnDBe6pJGeU89I4fqOTOmJ8iFAQG3hsM3ykQ7hZR4l5gAE2ACTIAJMIEjIUBSLsUroDhE1hacuchfVRJ9ElCFNMwkJN1WtpnVY5lbM5N/e5Bu3MqHsqdsOwkCzO9KLssrKDKXrwv10qIrri7J4ki2+6R+yK4LV97ZWFHhRGqi7THjRBYMtPFs5Maz2/I3bdPMYOKcVVQ0mir2ApPkcJx4YQJMgAkwASbABJgAEzi9BFD7YedwQxezPS8uXLj0HJV6CRFXFqWWRmEmncY8reyeappa5o8ZnW4Oka2grXpSPPmu+XDR+UsQVgIumZuvVQepmlJX26zpqG61K6yfD5XplXEolP4wLpU+h6Yjcwq5F2hfFlKHYryLp9P9Eq78IybABJgAE2ACTOD+CKBepPF9u9f4zGCg2MPE/QiVhoWyq+24fczLvKvZj/V/7m+WXyrQ+CwW21E6FH6QC29FbMKVK8ziE5CDX3IaQvDuIPX9bcbpfzXVfXDhLiM6a8wEKo4DELZBCQFXmqSZ3dPPyFg/r0IxrjTRR3AW1X1wTKPuY6an/wzhPWQCTIAJMAEmwATOLgGq9ehGGuprdR9l41IuLlXrGNTHd4XMBaretVc3raLM7TCTuiWaSvVhARjHq1Bvvpt6nEVcID+47Dtwr+8eIMpEo0Zmr270TbljPU8pg0g6q1t6Pl0Rv2snzOOYUuejH3QAJ26AQ8ru5oNA+TETYAJMgAkwASbw7glUjc8q4RbirTKVQ9c4TNMSnq7pyWgu/IDs6udc1zyfJcWv98TW9O3eRtRM/bCOKf//GmyFa2uY9v91ND27hvYLoxlH737LTscaUPfd/PObyMFt6jaaHJxTU8bkQ53qHGqu/pDoys/Yhp7RJKFDSleIzaKoCyrYAeC1Yv500OC9YAJMgAkwASbABJgAE/hFAlTzvX74vhJyq4qwqglphhaa3zb7/yreL70y0rKqG7VuT6nV5VUllvHaXb3xF9f+Dn7CguMvgwQ3xo3rN9DIbFp1mk0tur4+b5pmUKb+QOaebLlJt2Kf98+Zy3DEhMpIT6GRGR7bX7Y6/hkTYAJMgAkwASbABA6BAEmGhopDWuAH1WiAZsuyLKj7rTdp3+OGbiLtZk/JsfQbdk5/e9Af3kpS2Z2CHzfrCrfeFXK2LdTNF2+Wbt0VZ7Hx2f6Mq5H0Si7cJSFDGGttz6pQWZPlyg6Rg6vqejr9kf6yf15fIhe0Q9IZJPQIfuiIHNJvKOMP4RDzKpgAE2ACTIAJMAEmwASOLQFIuHtOWlSQu3ouPUCvMrWXklvCmCt1pMZROYZpnhqblVptpgqyohQ1vGn9wfeORdw3sqNCHqp4Y7YhvQR67aavI2FNERrfpbFX1vW42BDPaK3+DdwYdVxKYUKdqGOao4d3ji4H3rhWfs4EmAATYAJMgAkwgcMhQCP8EgKiE+SoRaGIKgQ1pCqQl4u6xA+8VjnQU/EPsk/IyfLlYKL/591U3rU2RDSXyLYGopjbfDITEHP/5kVXPrmOLrnXZHk4G3dC1jKq2Pbqvhuo4S6KSOWJ1UWWeC4oPR3pseyW/JhtazQyQ50H2RwO3FB6MoSEPhJwR2s6ITvOm8kEmAATYAJMgAkwASbwbghQ8UclJC3VPblxUZCjMkdcrkPslguKbXWh3M6nSlNspFmZ6vExY4skqyIVKFbhARcWcQ+AG00tvCHgwl2/IjtiXY/HBi4XZKKVqZcb2ZR3xKd0or+gm3oaXoxABa5RybjkjeGFCTABJsAEmAATYAJHQ4CG/g0inVAtutKhcIQzVLvcZRTKJet6qhaqZrKRNxKR+fm5zrdVMrjlp2HHE0UWBA1xd1OomaYoVtorCnm5ubgqSrxzVJMezV4c8aeMar39j70OWMgmm15eRgPbCT1W0zouS525Yc1sek/JgfycGpMtsKU04lD5KqJ8YkKMdTxwAb7/+fyACTABJsAEmAATYAJM4BQQQDWOvYAb12GmXEl9szCjayzPMvQ5a8pBj3oPW41IheKiuPjA5gkWHvdOlaqop8uWJVHFKFAObj20Os+HdpSJZjRloqnPmBYamaGQl56LkG7BjcxOwT833gUmwASYABNgAieUAORESLnkDKUGaEb6qFFqFPXklNLeuLlgc38x/7H543yjeC6rDWYTUdSLrogCIYJaKrxGctmgoLSIWKjyck8oh/vfbKr7IODe3BIqFuOmmfs2Q90Hk4TxIjFRbMhPmTFzXlETM/Dca2RGAi7n4N4/bX4HE2ACTIAJMAEmwAROCQFYKH5hT6gkr7y4Gt+VCmQ9/ufyfbBYhOkwUXVMmlNFW11sXpRidj+S4RfW8nY/YCfuiBCOwBIE3EUU8l7bk13EKDSFZws/sr0yta4ez5Q/9JGJZt5bOXDR0AIT60KU8cxwxJDvmQATYAJMgAkwgUdDAEUjFY4kMFJTXJrTRSZdZC0MtUbjs0g3k82skXXKVqGzH5Xh1j+WPbeFxmc682pZU1zM/fWL+Vly5VJ81s3Zm2pifUIng7oOjfHulqWvmsOJ/J75TTuuzyP/1qdJcWhhFsH37IOwxgFmB+6jOcv5U5kAE2ACTIAJMAEm8GgJwAFKGQqQbN+g42JyHHJxaWocWXEpFtcFqpWLFAJugNcXqh/v6Kw11FPjUwUZSLEjxf3uzJkVIPedtyB2/fp16g4nFnEc6OKltlnTCjEKhU59h2IeKcTj2R3vN+2EfgxZaL5UjlqZUUOLM8vvfk80fj0TYAJMgAkwASZwBASk0KTgQmqEoEtlpJBl4VKXidIbMxfKuPxy1i1+s6DGZ7Pld7d65e0JW+uabG/bNi+L1c1VufHixYIan4lrNCvsjUXqEezHQ/iIqvaj9VLJDQEX31UreVINxF0jMs9uZ0PjNWQtv2OfkrH+7F6Mgka158PjHCAHl+o+FnABgRcmwASYABNgAkyACZxVAiTXop6kkrsScqk4xE+o9BauslSgHkcfhXzDzXjzyu/DGBpltrDWFRAaM8yAUxcRqUAN0rC8QQx+a6ocp4AifuHvFyTl4C6jmB+8OjBdxCj4yphcKpPbYa3Y1M/IrnoWsu04bC1W+bLGjcze+sTi3zIBJsAEmAATYAKPiAC5cklwxA0xAIhYED5FAkCI9HSoWsG0fZ/Jvd8f/sj8SdEtv7BdbJ/riEGQJsKvIWKhFVz059YRz9AWdvnasn352stmrwvvI9qhd/+xBwXcpatLCg5cctSi7rttqIFtWGpraxqk0kmxpRCjoOfBDZEUTiOeAgIuntEkOV6YABNgAkyACTABJsAEziqBfdH2IICRCkv1cuXCxS8pbwHTvBpyoM5rP0csV6JrtibRb0FefPyioEiFPVPBwVW97WMWcYFo6okpOS2mVaezpqN6pOvbvudL7eXIRMsjMZVvuk+bcT2vLXJwoaZX0+loyiIvTIAJMAEmwASYABM4ngTIhmtx8zAA7UlPBJhNFJIvAE4BZWp2PJr1F1TPPp9uZp8bBv3Lsb7XzkyM3C7hh0J492LhTdQWbLv2q774UwiaLyFY4CQvVGFj8P7S+CU4cFvqplg3de0Z0bfB0HSD0ssRo2B/Ezm4c5QpDHYgh0QzDScueZt5YQJMgAkwASbABJgAE2ACIwKk1O4puJSlUP2YhvzJkosvam3We9U9gSbDzTQPtMzwG1/Kta21BzYGnHkhcmlhSTZmr8g7IlKX5iyizyZVWSQ+cnB9US8nxG37ca9VNbUIyMGCS6FRjMIDQx8db75nAkyACTABJsAEmMBDJQA3roIUiaFnuHEVOXJDfK+TOxcSpUFU1CWbm3+X/Fj9T8Md90JH9Gf78VaQiX6QxcLP+l2/XnjmdnLbiFuCGp+ZfVfrQ93wh7RyNDIL50JJ0Vmtjb6JlPVKlXpoVNvM7ohPqp5+bnfmFZzMqPm0B1Y0IY4XJsAEmAATYAJMgAkwASbwCwR2tdvqOxTW3fYUVdYCJSwoE5pmCalRmVQLiLjdIfpW1Cj97MGWs5vpuqeWTy1PyRZycOdrDd3HRUqtZ7y+diZRSV1u+ldET35Wj1OMgvDQ1KKGcGLOQ3uwc43fxQSYABNgAkyACTwKAqgmIeRaV6LZAry58AkUpSoNMl6RzCUzXTcTYeha2VZeH6rcN+eS78SxWzeZ2hHClnWr86EbT5f7d2X0+JS8+CICwJCXK6/J8lHszv1+5r7oDBfuzZ/fVK0PtmR3zep6fcbmw8QTpvTRu+z9+Y78jJ5UMwpPQMqQcxn1Hwm4D1xo3++28uuZABNgAkyACTABJsAETggByrNFhML+1pJ2S22F8XP8VDrtbHannAre67wskzrSsRp3LTWAkisex2vH77/GPHNOXCrk94t5dIMjF67ZNHKnv6PLTuLlcGOUZWa9lp4q74lPeRP68aqJGfLQaDoiEJ85ZvsnJD9gAkyACTABJsAETioBxCsgIRfxCggG8OAHsPCX+kjKjeie/AG2rR+3uf1q+mPvf+xvZ1/uNbvvH9q4lWXKjidCB8GUDu8JvdYXZlkskyv32NdE+zXfNYH+B0KRCzfIA+VHRlczr5y2RVC2s013xbTU+Sr7lkRvi37CBsP3HKNwUs933m4mwASYABNgAkyACTwkAq/ptgc/gFIUKEsBEQuIxkXWQilKqZRxujRZkckYTty+6CkVKYkZbtVK9mvVgyt6i8fHvvh+i21/8F+RCxcC7s0t6kq8orq1UHvDKR2olhd7ua8aup3fVU+ZcTWP/NuIphzCuRJyIf/gyPmdTIAJMAEmwASYwDEgAIESpWWVlYtH5MuFfKvQ9AxiLu7JlRvNh0+Ywv/99If6j7Kt8rnY9qfviq2o2R1EZV+EZdIJpsSCt9Zc8//mRWePe9Oz69euU5GspsWyajabetiNrNuyPgwRRkfZWHZP/5Yu1UfQwCzCUL1G7YcMYRVC8D67M9aOwanKm8AEmAATYAJMgAkwgRNBgLJxsZAgizqbrJ8SVofqSyLOzG3IJn5k0iLROpV6Z8fo1caqFMt47V5KwDvdz7NZnNJ0ullMp0NTC8pEGwu1KgJth3nqGSMbyYb6tByqz+sxNYmQXB+lPBXynIf2Ts8qfh0TYAJMgAkwASZwvAnAYYqIBYXCUZWlw7wveq5sWZSZKERiGqYa3U63i7H0XhbqOfntrTxeDzPZ9RKdWh/v7M6LGdpL1FVoelaIRfgNIJfS7LHjtPMLf78gl59YVl7bk/21AG6I2AbKmdiltfyu9wk5lJ/T43oSg/YeTXtTvqzBkWuxI2fT7HCcDh5vCxNgAkyACTABJsAEjiUBUmtHfc12H5MJF+Zb6LU0AQ7BCghVkKivBVox5EPYB/ZkxTaam42Jiw+0V2eqOK1synRZQU0t1sMqRqEbWp1s+14+SL2kyP08k0+UHffbpinnqiw0g95xKOgfiC6/iQkwASbABJgAE2ACx5cAVZzIxoUHF65TB2GTIgQweF2jXgAoOrUd0xdM5n0l/4H7H5Lt4rlh1J8ZlFm4MxhERdIL613h364Ju7qMqnQJt2tCP+qYBar3RlPTriNGYeqJKUkCLg3cU4xCkI/ZfpZ7LhIT5Za8YsfMXOW6pZLbImACtR/kW318DxtvGRNgAkyACTABJsAEmMAjIUDK7d5tdzYanox+VnkZyIuLqppmv2m0pYhkI/7n8jI6LgQoNZVMpew5pda21uhdlRmiun+H386MiDsScJeuLiFG4Wblxuj2Qu3HyETzE3+gck83ioliS33aGzcX0LE5QBdndCumjsQ4CLwwASbABJgAE2ACTOA0EiDHaVVmwosKIReFJyIFnIdiM6SsXHTQbYdz3q/qgflCcqf4fNZO3jv0Oq1cJV4shPEKYcKa0OvLwiBiwWKw3MCZq0dC6lEhq8RbaiOx5wMmMfkZcQMxCtOqAwG3v9E3BRrYFkVi9Xgxlt/WHzNjalfAlXgfmr9pxGdVubi75fhRbTp/DhNgAkyACTABJsAEmMAJIlC1LjuwvSg/aSoaPLgk4qK2ru4pEhf5Xb5uSF3AIBBU78AsMDlfm5ditpJ/D6zl7R+eGRGXCvrr18mNsVi5cMmNUdd9E2FCYBZrIwLZzO7qZ2SpP6wC2YILt2r8AaTsxHj784hfwQSYABNgAkyACZxsAlXBWWXkUgM0rQy+oyeACBG7YFBGaTuuL9jc/0r6QwNXrn5uaNOZON6Kiq6I3GYvEmInKpNG8I+v3PNX+3DlvgxX7sGOvUfJBxtMM69IwI1EpB4fWB2YaWPyoR7IpJbd8j+uevZ3NOq/ynWLKAW0MQsdN7E9yqPEn8UEmAATYAJMgAkwgZNLQJJuS0Xn7gInAc0GU5jhhS9KxcXcNkS0pttiCpljVSYurKK6ZRv63vY9LcahOKJevZ96+UyIuJUTBF7ahb9fklegdN9BMd9FMR+GUzaXiZfZIiwL9UGxrX7btuDIgAsDDS2iamrd6GjwPRNgAkyACTABJsAETj8B8g4YeAiqpmcYyka8ggio6RdmKAUYAZ+K5rwn1MB8Kd6Uz5Erd0utjxV+6utUad1Vyjqtwnu39eo3Vw3ych+NkIsGtsvLy5oE3BANbAfKmqwc2sJp60UOMQriCly45yFUo5TGBnto7kazsDSKbXbhnv6znPeQCTABJsAEmAATYAKHSYDyb8mCizjcKgmXWgnTU/qmMLdNl4Z+h+dqmA60HtNqdXlViSm84D6WMyHiAhJ0XCEWFxfFSrKi2r2uDsetKUUWDGURyLqbEpvyU2ZcXYD/Ft2Z0cxsN3H4vmDeB3d+KRNgAkyACTABJsAEji8BKjoh5kLEtRB1fYicATX8ouZf5Crw2/qCV/iLlSt3U39+RyUzfZkFgTJBvesFyUbgDUTNiMexjq8jXgHRBke2s9dRDG8JRGctSNqGuO/bsDB+qRGlUBu0yw3vY6alMKyPvSHHBHKB8RVy7XdkR4g/iAkwASbABJgAE2ACp4IAUhN2rbjQbCHeoq6EOQC9FSioCzW0xheFtPrZXdko8EgNE6PQ40wVSl18/KIQ/4S6lWrXd7igeD39S+XEBZSbszeV2JzTrXpbh4nxkePmiZobc3fLKyD96zpULTgw4MigHNx3DvH0E+Q9ZAJMgAkwgf+fvXttjiNL78R+bplZFxRuvIDo5sxwJIy0g/FoJXG10ko7M5y9aCXvOkIRFve1w6/9xvYH4PAz+FuIH0KQX6wj7OBaljSIjQ1qh92iGs0mGyAKQF0y85zj/3OyChcCIEE2SALsfwJVlZWVlXXyB77I/vdTz6EABb51AlI4IP28pMcXLk/xP8XxRTD0ysUSa1O6jp63qM0tv6665fPY0svj/+tpf/TlrJnbzlpzvjXcCk+fq1hZpftqXaNPrlf/UQUc5eB7Z+eEmq71JkfF9Z6dG9823c0Na4YtW7StK/XYBTeeqZ+1/lCP9Z/YWT2PkBo1uApVuKkCN8epShXu+wubz+nceRgKUIACFKAABShAgQ8jcPiiNiWxuHjGtGYIcKWtQgp10RfXuKyXz5pYO91qo0wiaOmLq0a4uO6+2bi/HReqjaqZG8+ZGWmjMM6yUo3dwI+64y/Dv1Lb7k9sz12TGYnla3Vg/Ha4vNm/Fe5NAQpQgAIUoMC3T0CuiiwuM6UqF71yUUGA6yX0j22hthbxrFLZortZ1PmfV/+f/V/DtvnTUbF7fVAN29YWnbC3057pq+KaWs2fPFH5+i9U9hd3cWF73sv0ChrtG+R6rzd+6vbUnisM2uAOxvmgqvM4o66GF+rnbs6hjQLOABfYUhmR2mihDzCv/877j8LjUYACFKAABShAgW+PAC5HU/EDrptlYjPcpCACt47pDf4+/IbOQ0fXynZqlA5gzjPV3dBqI73nzEgfbSVuqsgQBrmoR1+0R4uPrExmVqEnmvTBVbXPTE9dr3+l72Sfuu9Jrzf8h0kB6o/W5Mz/KrgjBShAAQpQgAIUOBCQS1GH+lmZoMHLNZZcmeL7TDpWiEK9qkzX4mtOdrbaqmdHz6tWtrT9n2yVbdSq3cc3n9RYvVDd/jzmb9jQv/OTZR1/hC+Z3VNevnV28DFvt7Z/zXfoem9vuOdyfc1gHrM8tlyez9Xze1+q30cbhU9T2wTUSOB/3Gf4kes/BLoIpLlQgAIUoAAFKEABClDgDAIHF7Cylmpwm3fJV85w5ZyCXGyRV1GSi4ZjZi6YkFWusl454+Ryur2skVXqlRsrhw7QHOa0+487sITWgwcPzK9t/Zr5BG0Uhq1WZsusNQzDQia1UF9lf+TmUY2RpT64015op1lxOwUoQAEKUIACFPj2CjQXpLgmla+JYVYGXJFGaUjgdR2qWKoQQzZvb5qR/vPql/4PygX/l+3Fvb8cj0fPZl1RlXHHjkOr7n3+VD+eGerB/YFBr9wA0KB+gWT4Ldos7LdRQIArfXBbNbryyoWxvmKK2mahGGd7cdytN7I/MiP3x6ane1IVgcg2w498A6vAecj18Jkvnr+9/wB45hSgAAUoQAEKUOBbLjBNb6UQQdblhqtIuZCcXJeiRkEiXDRVkFrcdN0Z8/KFul7gyhRtvZyux3YUMjeqnhvXc1qty0VwmhhtevRTkT/KtgH7F/T3lb67flfL1+r67cx2trM86O08w1Rm42fuX4e+/VOHWZZB2MJNerzxAv7Ufyp8gQIUoAAFKEABCqRLUYdL0wyXpjLpWYYgFxWtqMvN0rwCBhW5c60b+Q/Nnv0fRtvhT+reYGXLDOerwmTttsuKmaWsq265BbWaJj5DBUK29gv0p8Wsvm/iu3+9NwlwH288tv1+YVMbhZbNfCiLvVBl6DV21W+qO27WfWosmkEgejYZvoMl13/SUEHqJbhQgAIUoAAFKEABClDgTALIWidxaypCmEavuEBO15US4crEZhGVDzLfGfbGVGYZrjtd5ZVuFS3VrdBvoUAlwZaT+buw15k+GJfeH/OyqvQ6KpeljUJ7C20UzDhH2J2Frr4RNs3P8yvue2igMGOsfCHwI7f4mP/OPDcKUIACFKAABd6vAK6bpIJVLkYxaUOGy9TcZKqFplQt6TUrV7bFQvZJVhZ/Xv5d8b/5rfDvgxl9p18PenU50GDhzgAAQABJREFUaNdKtbzqt7aeqmJ+OJ+vzKps/T4C4V8gGk7Xuq8+nbTPX+DabS21QbApwO327cxomLXGrSyrbLGX11neMvPVV0baKCwjvEVgi/dgzKjC7RhnClxYY6xyxc2FAhSgAAUoQAEKUIACbyFw6EpSLjWRx+IyGdeXaWIzqcnFRLoZviT2TM8ZVbvxGK/gKtr2rbVdq2+r22f+0I+3nQKqcJFmm6XZJbvVL8wVVGSM6lGuC7fgn/o/yuftd1IfXKnAxczEZxbjjhSgAAUoQAEKUIACIiCXp1JVgGoDrOGLYFJpgPl20W4hWDRJqF3PFHamWKj7/vrgH/wP7DX7V9v5+O/iYPRirlPU46B8XeZ+NNzUC8uLGs1zNVor+HgvntovV4JefHa6PX782BSfFabdbet6b9YiwbV1leXlYCcLtpwZbnd+Yobu39lZM49euE7aP6DqoYvp2VroRCah7qHLbv5RKUABClCAAhSgAAUocHaBwwW0clGJ51IdIO0RZAoJ2YQqW1wpO5VnPTtXybVuViKIzNRggO+IYZoG9T1sQ4bZvP3Vn/3RVeJOv1q3ptZMe+O2lq/VzapxXqsyHzjVrZ+rf212sj9B2r2I6DbHBTz7oL363whfpQAFKEABClCAAqcLoJo1BaQG11WZbuOqtCNBKepcZ1BlkOOK1OCidaloZ3fiP+j/efh19adqvv5OfzSYCXuYsaB0xXW16IqNTfd0rNyT2Seoyl3P4l8gcsVF7/5NqnSxbV2tuw21kT/97GnW/azrMrTMyn3uWmrgyjLLnLdZLdUNc26xfh7/pZnVnxi53kNga3KEt5lpTwJcuQ6WC2YuFKAABShAAQpQgAIU+MYCTWqLC0xks3Ltme4tKnNburf3X/0PVLvsYJsZYcJg64xd6ixp9SX2RCeBs3wb7aOqxE0n/Aul1+6vmTvLdzS+WmdqNWvyciHb05XNZ+O18d+rO+1P3XfxHxWFfAUQVB9dkP2N/9XxABSgAAUoQAEKUODNBKxBRS4mN5Nvj6HbF6ppjVTT4jrLaBvxf9NxwdUqrme/Xu3o2eGv6h/Yxfr/DNnu342GbnO2VKrIF81wcyfWxYy/por6yZMnfvR/jGTis7RgwjLtnmDKsu4VkxWZfTF4odG8QZnhos5ya6syd/MIcHdDaUPme/WG/WfSRgHfZ8OlM0YkE5nlCJbZRmtKykcKUIACFKAABShAgTcWkKh2ukjLW2lpe3RiMilCkEW2Sn0ueuJa13ZzIY5dhYjX1biLuHZuKf3YPNa31K1UxotDvXL5aNoI7Ae4qMCVAPfR+JEZDXuYOCPPSj/O6ryc9Zv6j22W/T4m3FhAKwVMZpF64b6G6JV+fJECFKAABShAAQpQoBGQegMJceVRLlkRn6IGVkcrYS4uYlFWqwIqYTvO2k/9V/qWj+ife3W8HcYxBHy/LGu5lLe2MNHDYJDb+XbLDtXQoW+u3cl27GyYNbth19ZlbSUddmOHVrzeuqF3ZuRyrKIdrip8HX8cn2d/5ubcklzvyVfYUmVw00bhoypi4D8+ClCAAhSgAAUoQIH3LJBy20kzhRTU4spXeimkxDZlukFai+HK16sQpDJXl19XZbYc/3MW8kEWaxQ82NBeyMoX4YWffzQf9c/1fvHCaWfzUV3EPkD58a9t9VKAO/h84GZnriLcHucDX2dFOyyFX7V+XiybJUy/gSpcVUCXVbin/cvgdgpQgAIUoAAFKPA2AtJeQa6xtA4BIS0SXY86A/xIR1o0XKhVheswW1x3K2Evzvt/VD8c+PCfw434n/RO9SxrFbZUwbfy6Ie7MbTVElrl9lW31Y0jNVJ5P0+jQlWtxnPbK3u6ql2WWZvjm1cuduKV+A/5H9k5/QlqgOV/2mf6oA/uR3Xt+zZ/Hr6HAhSgAAUoQAEKUOA8BBDZNr/NtLzTBrl4TKu4CFY6YI9mQXFDZrI6qyplWhZXyqjE3dpT+lZ+K+3wcjVv866j9x9PiAmhuzi39kZbu030Srj2ifEIcGOVFfmsulo/dX9oe+a6wUv4zwi5fTRVyEf/pHxGAQpQgAIUoAAFPriAXLZaFB2gFhd1sAhv0W4hN5lumVzhYg2dc/EiOudezWzxe2po/mz03P+b8fzo+3UY9OoheiOUJptTPWNKfANNzZnMz7t8mGeZytwoH9lRObKudLbU1rmAPrgS4GaqVz0zfxSj+i2bp963+HS5YJ5MZJYutT+4DQdAAQpQgAIUoAAFKHAZBSaRbDOfL04AbRP2T+NgTbJdXHXKl9BwL6UMCqUMzuT1cz2HC+QMF8pyhayN3zaqi92XcUvJ7/7RTlz5KIJMSavv40c9u2MWFq+Z9nBo5+siC5VuVUU5Wz/L/g3muvizfC77FFUbXQS5MhvxxxNgn/in5UYKUIACFKAABSjwgQVwhYrLVxTmpl+5npVwt2m4INsUvmiGxbZML47NSvm5+nFlQo6Otl/7Uo/9SLlC4l/U8ppqaMYG3zszYzTARWMxNWPsuGWREGc2mqxvBm0dsh/7Z/rPsjn7KeY+yDGdmUMDrRnj0HHMoB6YIa5wc6EABShAAQpQgAIUeFsBuYKVwDXFrulJutSVbXiGWgKsoYUYbmilkFoqBOkvFss4yK/qdbz+3ERTad2p9/Kqmi2LWi1g73Wl7j+4L0c+dfk4gkyc4r3Ve/q6WjeD8VO3pwrMTlwWZar5CHMo9PgdzIq8jA64HVR+SID7UYTXp/5V+QIFKEABClCAAhS4IALpqlYa2GoEqlIXmypzMc0YAlZlUTubvh2FF1u2276R/0Dvmj8tN/W/HXfHvzaw27P1CFW5I5O7aibrDLWxdde6Cu0TVJ3XocqsN9mgqlzeLebrTfOHbt59gvqGDFd7BrW/LZnMFnkxA9wL8u+Bw6AABShAAQpQgAIfh8ChKlw5IclzJw94JVXhNqULeEWKGpxpVVtxKRgv178a8/Oq2aynn/afTt6Z3v7Ku0sf4sqMb+o+QNaFa1W5PaPb42H2Al+tG/mdnn+a/TSW5ocGvdAMSpdxCc9eaK/8J8EXKUABClCAAhSgwDkLYFJe/EgtrMxclsJcrOe4NpMuubnOYwsdc9HsVqt8PvvU1fn/WK6b/33cN/+h3xpd3/VlVuHmvSvsyLiOXjCmbtuObrs6aFvbsjP6Qv8LXC3/GO0augiMEeBK6wZc/+Era/LZ53xGPBwFKEABClCAAhSgwLdMQDoBoGZWrmuxyB2eoLvtlEHCW9ks3zdL0/ym/VJ5LkJcnVfb6kbUoZDr13E90nq8m/Z49OWjyZ7TI538eKkDzYQn54UJzR5uPdRXNq6YMJyzVVBZ3q0y1bY3/Gfm561P3DL+A0EmM8uw95lgTubiVgpQgAIUoAAFKECBbyAgcapLPRbw7ahYB1zCSm2C8QYXxfLdsxjQ3LZtZ7K2Xam2qs44BqdujP7valc9RZvbIQoXXOU1uiq0MEOaNoNqz/kr+nr8Qv/E3rDXcTzU9sp3r3Qblb45rqAZ4H6DPxjfSgEKUIACFKAABSjQCEzSW3ki2SLKa9EmQZ5NYtwmcJSNiHPTZukcdhDyYrrdFq5M0SpsUmAwntFqaU+tvFiR3V+7XNqL2v0A977Sa6jCnRvPmf5u2xZm4HxuM19gZuJn2R+6OfMJ2ijM4FK+BWK2UXjtPwnuQAEKUIACFKAABd6dAC5+Md0Z/se6QSsFXJ9hsjNMdBZz1MtKEwRU50b0r402hBjsvFtGVe6fjf7W/C97W+qPh254JXoVK4+muNi7rkqHySDmzGb+e27efIIJIjB5bRPgoidugU+6tNe67+4vwCNTgAIUoAAFKEABCryxwMsloXgu2a1UIaTV/Xrcl44sVQqo30V1ri03/dWYVVmNOc0KeS++L7akltTj3uNJh4GX3vvS00tdiZvOBVW419fRC/fz2s3OuKxS3SzU4xm/YX9mxu6/t4vuGr6ql+ES/vKf60t/PD6lAAUoQAEKUIACl1QA8SpqZSfXvQh2pWduGXCJmyZC8/KC9sHHgGZY7WLJ/Xq9FTq48M3U4vAvs53Oizrs6VEeurFvfqqG+t8ixJ03FlOYofpWqnAn134vX25fUi4OmwIUoAAFKEABClDggwpIFCuLNFSQwFaqbRHNYhXPm7YKKdRNu2D2XryO69vpRGcx1eQaXKvWOIxXeozChiwq87x6bty2C2oZl7/pPYcqd+XzDi2XuzoBOlKFmy+u6sJ8YmLZKWJVF7pn5jB58W+7WbcsF/64iGcvtEN/dK5SgAIUoAAFKECBCyEgrRXQFTf9D3epyi10x2amJc+Vi4VU5+ILZ+mbVG7Bfar37J+UO+rf+evD7/ez3bZaqK6GF+pnbsHeRHCb4ztXFpOZtVOlL/vgXog/MQdBAQpQgAIUoAAFPjKB1FUh3U1OTNoqyKqkvFhpXpfGuBL8ykbcm6YiF99IC65WtUztq4d7Q2Mwt5e89yzLpaxO3Z/M7AGqcFVThTvvvictgu2OH82Yp8XPzdj+E93BjwS4adbjs3BwHwpQgAIUoAAFKECB9yqAr5bhGhfXtbrGha5MdGYw4QMqc7G1lukhcDWnsBaid7P2Whjp/zD46/p33Y3iodrKMjdjrij83/t0ySzXfRZtGthG4b3+CflhFKAABShAAQpQgAKNgCSyqLqVBBfXtCnC3adBoULut8K8y9TGeDxStoXpG9AA7GZ9U61vrOtVTPr1quVShrhyQmtqzfS2evqKwmRmV+dcq+/yzdEwt1fsUvjc/dwuW/RFk8nMUMPRhOGvcuBrFKAABShAAQpQgAIfTkBi1wwhbpCKBVzDGflBa4VR8KHC5a9RQdcRP7Zteu7T4jfDMHyqSgy4o2ZReSs1uNJTt4XsVyp3z1zR8OFOmZ9MAQpQgAIUoAAFKHDZBFJBrXTBxUXr9JKzmcis2YbctqnKRT2C1CRIqzC8Lrvi6hbvQgFDXSvVsy3l66D1QOuN7oZe7SPAvZ+uYdP7T3K5nCEuTqq33NO3N27rp92nNuy5bDfvF1mhrtRfuT+0PXMDXSY66IKLiTE4mdlJf3huowAFKEABClCAAhdNABe6BpeuOR5RgxtxoWsc6nPH6I1b66ADpj6r0WAMLcZiND20T9C42sNOKbzNNCY1k+fp4veinRrHQwEKUIACFKAABSjwEQjgUvMgZE25bfrmWGgqCHB/8Coa4qa0tzlrucrF18dQrGDRATeO1QgXrricHWm93Fk+k8ylCXGRdEuGjew66ge/fKB/pH6kn8w+sZ1+x/b3Rm7UrWbMRutnauz+fX7FXcdUZi1U4cr5NY5n4uBOFKAABShAAQpQgAIfXADhLK7jLC6C0S1MeuZKhIs63IBpINKlXZolAqULeNWaDF9Wy7BuJv/zntd+H/wPyAFQgAIUoAAFKECBb5+AhLaSXR65GMUG1OBKtKsx60PuN+2cnq3xLbKuilWIO7Naj/pP9ZJaSmDT/PMkvUsT4srg5UQk0b52/5ruqI7p9/tWj+cyl0ebOzsbtP0dO2tvpBmJpY2CXMxzoQAFKEABClCAAhS4jAJyySthrsS2uAxEhe5+5QMuCFGqm0odsDFV8PJ/3F/GvzHHTAEKUIACFKAABS6lgKSyxxZEuNgud3KhimfpanW6m2xCAzHdUqpSZT3WbYvoEpW4aCqmUjvc9eYN0oLh4Lp3+nbU8R6sXpK1+2il8EVPf60KgyDXZXroBtlOr/4q+5dxrP+JdqaT+uCyjcIl+YNymBSgAAUoQAEKUOC1AhLVypfQUJmbqnMtrmIdqhqkfQJ74L6WjztQgAIUoAAFKEABCpyLwInpLcLaSesECW4nlbhSkisdcSdP0XEBlbj1c38lOO0KVaThGHRUMB2jH335SCPIbfY95TMuV4iLk5AJzeaKOTMz6Nt63Mp2dJ2b3C2Fr/W/yuYy6YWbS659YHYufyIehAIUoAAFKEABClCAAhSgAAUoQAEKUIACFPi2CqRCW6muPSFl1U2vXPSBlTraFN8ikcVjE8zKNuwhUS+y2FqVZWk0pu81u5jOF1Pzuk2n1TXse7/Z/yTiCx3iSvsESbJTmg2fB//xgbmurpvtK11bdJasq62NWd3zT90fZPNuGbUYLbRS4GRmJ/2luY0CFKAABShAAQpQgAIUoAAFKEABClCAAhT4RgKS0OJbYseS3FRGK3cS1eInLU2Qi3uZ+wy/MosDlvR9smwoXzUz/Wd942YR4v5X7DCtxj1hhBe7J65wHEqg7/7orn6oNtz32pnd2S6LkNeZbudL8e/dHbNsroIhwxQYrMI94Q/NTRSgAAUoQAEKUIACFKAABShAAQpQgAIUoMBbChyLbZuetym8lSJUCW4R8EpHWwly8SPtwORZqt3VLub1M30t+15wpVe6rTt6lO2ahYUFtbe3p9SCpLxYmvu0evjuQlfiyqDv4yctSKLX1br5rnJmc1gVvq6ymJle/YX957bnrqP42KKVAvqiIcTmQgEKUIACFKAABShAAQpQgAIUoAAFKEABClDgfQkgrkXOm0JbZLcSxkqmKzklHpu4EtllZqyWyXvRQwH7uu6xyFbedNKQL3zgee/evfgAAe7DrYcmX1zVO8Mdu6Ccc8a60PbL/rn6me2YBYm30+QWp+bVJ50+t1GAAhSgAAUoQAEKUIACFKAABShAAQpQgAIUeI3Asbj1YP/DqWtqDyt1uWi60MS4qSLXpLpTq3K1ZeZCqDKFalxd4zZIue/BwU5Zu7DtFOSE05jvK31Nrem2uq67asP69lU7GpTGd/RMTL1ws2VldY55iSXDltmJuVCAAhSgAAUoQAEKUIACFKAABShAAQpQgAIUOD+Bw0ntS0fdz3fTSlNL2zRYSD1wJaU10l4B2aUKTqM2tanEbUs1bqH1zas3lfoSke8mbqcsF6oSNyXV0/BWBiw4qMLtLff07Oys3VOFq/fG+Y6unG/XS/6Z+4ntmkWcv0EJcoHTvFDnc4o5N1OAAhSgAAUoQAEKUIACFKAABShAAQpQgAIfr4DktRLaogEs8kr8oKMCIlv8BISfVsLasdE19hhpvbG1oVUP25alqe6ksPUlm4tViTtJtFNSLeuowsU9qnDbuq/6dm48l8U84tSrXvwi/2dZz15DXi0UyLB1C3ufmla/dN58SgEKUIACFKAABShAAQpQgAIUoAAFKEABClDgrQUkiJTQVUptDxaZ4gw3mdYspHsJcdNzg0XnSDGD0mXQOkOaied6Gentk60n+ubNvlb3VyXITQ1j5UDT417MytXp8KQXLhLor1TH5OqGyQuT7foqK2btkn9uf2baehFGGjl2Cw2BM5zUEbLpSfKRAhSgAAUoQAEKUIACFKAABShAAQpQgAIUoMC5CiC9PRLgpipaqTJNkavcIb7VSG5lwXqh2nFLL1rrM2wwqh5plWH3tkKAi5YKaElw2nKxQtxDEez9+00ge3tD6d9UhWltD9xoMDRZS8/4f3S/n81lN9A/QnrhZibT0kqB/XBP+ytzOwUoQAEKUIACFKAABShAAQpQgAIUoAAFKPCNBdI8XkdaHkwCTdmWEl30GGgKTRHbNgkuckv8RKS5SDNbpqsztFko8Kpt6UFfm2c7z5qWCjK6e2i3oKWU96AKVzZfqBA3DW5y3vcwuIdbD81DteFSL1xX5JW2qRdu+Nr+1M7oK5jKDBEuei1IdwkuFKAABShAAQpQgAIUoAAFKEABClCAAhSgAAXehYBklrhJHnt8mW5rgtz0DDviUSY0kw648gwlqLEoN/3VoHyODSmXnUFNrhxPWio8+vLR9EDHPuJChbgyOpxAaqawptZMe+O2/q5ypqvGeYYAd2x3Z9WX+e/ZnruO83YS4RqHTguTGuVjZ8cNFKAABShAAQpQgAIUoAAFKEABClCAAhSgAAXetUCTxUqT3FRGK6ktPnJ6wyoKbE0qx7XeelN5JJtO6yEKdHVL66ftp3plZeXUUV64EHc60t5yT3fUY7Mz3LFlmWW7YScr5vKl+pn+qemgClckMlWkmd0akOlb+UgBClCAAhSgAAUoQAEKUIACFKAABShAAQpQ4PwFTqyVlZpUueHFaZibolxJMGVjeglNEqQeV1tUpWpjlW2hRrfjUJJbGL2klpR6in3vN/untg3pjc2dO7T+QVabPhKTj54iYLBtdEko0AvXt72NA5Tntu1MtaH+IJtzy6n6VhopWFbhfpA/Gj+UAhSgAAUoQAEKUIACFKAABShAAQpQgAIUOFkg9cxF7awOTYg7yTy11Vm9Fa5Xpi60d3qMW41K3H7VN37gw3g81jdXb6a98cbUrWD6AR++EleGIwmz3LB+/xf3NSZiQxVux/QHfTvezdxYjWVCs6v+a/OTSRWuMZlqoavEBw+hp5B8pAAFKEABClCAAhSgAAUoQAEKUIACFKAABb6tAtPq1OPnH1GBK1W6AS0VojMZuiigXhf9BeqxVpXSCzlmQENLhZs3bx5/82TLBw1BXy4LliB39Zer+uEXD4365BNzpTNv1V5ldvO65zbat103uyLTuCG1dpjUDA2ABYALBShAAQpQgAIUoAAFKEABClCAAhSgAAUoQIF3JxBRXYvg9Uh17PFPa15GRIvdpbOCRJfNNpnyLO2PQFQeU4hbFKhRjWgna3RnYPRGvaG/UF8Y7CIlvM0b05uU+qAh7mQMzQOqb2XlmrqWWinYQWZRRJyXMRSusEth0/w8WzaL2Elj1Dmyanvk/XxCAQpQgAIUoAAFKEABClCAAhSgAAUoQAEKUOAdCEwz2NcfWpoNIPBFgBtCM8nZ9D1GgtkQlMeKy9AMty61ameY9ws7Ly4qtbehbuMnxbxN5Dt9q/og7RQkud6vwp0MaG19Tat1pe8s39Gz27O2jcpiX7isvegWzGbxB3bWLmkTc4zYohI3R5TLEHf/z8gVClCAAhSgAAUoQAEKUIACFKAABShAAQpQ4MMJHCmcValyN1XiYkSSf+Im7RSUaeLYOtRaeaXHaKkwq2aV3tvSy2pZqQXseT+948ipfJhK3ENJspQGS6DbW+7p9Y11vf1fZu1i1kJyO85rrTujx+H3lHd/7ObNPE5SqnClzhjjPnSQI6fEJxSgAAUoQAEKUIACFKAABShAAQpQgAIUoAAFzlNAQtrX5JES2k6aJcgno+wWzQRQkYsAVKNDgpF6WumUgGUayrZaBZ5VsumVywepxJXg9uVRtTfaOl/M9dxcYbudPBvXxo60z928XTa57eHsrLRQMJku5Lxffj+fU4ACFKAABShAAQpQgAIUoAAFKEABClCAAhR4FwIvh5lSlCrVtgefNV2V7rfSP1eWprVCs8/09eZZus8P1rcHzVseffnohB3Vh2mncDA8SaSjfrD6IA2uVbdMa+hsVY6yPVPnxYy/Xj5Rt23LzGGkk164OsPaBwmfD4+b6xSgAAUoQAEKUIACFKAABShAAQpQgAIUoMC3QwDJ7P6JSr/bIyWm6UUEt1HmMpP9EN5KkIvV9C55/eDtkx6xGfbL1RitCHazXT0/r9TT/lO9olaUmswdtv+BWHnvYWhKqXEaTWkxRoAY+9r6tVSFu/nFpslLa83AmGiqmWrD/UE27z7VmMgMI7Vo8tvG47Ta+PB5cJ0CFKAABShAAQpQgAIUoAAFKEABClCAAhSgwLsUSNW3km9KPNvktc26PEnPU4I72SaVuugOe/JSqdJjYjP0ItD47Q/x7iWlHvce6zXMG/bye957iJvC22n9sTzex2Rm6o6SKtzCfGIya9yOKZ3pmmvhmf2J7ZpFDNuYzOTaIM7lQgEKUIACFKAABShAAQpQgAIUoAAFKEABClDgAwgcKalNWWuTt8p9E+5iRQLd9IA61tRy4VAmi4nNPF6rcTu8zOHJkqS46pa68zMc60irhvdciSsncv/+/UOjVuoByoPX1brJfGa6nVFWmpErOnombmS3Xc9dxRmjF662qDPOUZNsD58c1ylAAQpQgAIUoAAFKEABClCAAhSgAAUoQAEKXBSB/eATK9NQd/qInDNNcKbqWjmjYtMStzUZusS4k+WvpisHx3i/lbiovL2Hn/0FVbjXUB4sE5rt7O3Y0djZEhOa+a5f8l+bn6I0tydniwYKzjhT4DT3HfaPwRUKUIACFKAABShAAQpQgAIUoAAFKEABClCAAh9QQBoOyLL/OKmknYaZ0yBXW6d1lllVKVU2bzl2vyZbDoXA8vT9hrjyiff2z0Weqd7yQy2tFJy6aubqnvVF7MbH+arrmiuov20CaaMKZVM4PT3v9F7eUYACFKAABShAAQpQgAIUoAAFKEABClCAAhR4bwJIJ1OzBIS002B2+tnYPs1wp5tSECqB5mSWM20yVfgtvaAzZXKvYoHbjJrZ3x9dcdWd1aP5qbz4fkPcNGIZNW6owpWZ1tobt7W0UsjGFm18h5i2bFRkC/amtuiBK60UZDqzTGNdv9+xig4XClCAAhSgAAUoQAEKUIACFKAABShAAQpQgAKHBSTIPaFhQEpwJ3d4/SDQRWvc/bejbyxST1eblJCqcTWSpFTtjPrpcX8/ecf0htX3Foy+nEynAaGVwvb2E7uzl9mqHmV15jLbcVfKf4i/7WbMFYlwVYZqXES72P/oiaQD8I4CFKAABShAAQpQgAIUoAAFKEABClCAAhSgwPsXOC2sTBW5CGAPV+ZGPEft7sFbQp3WixZ64jrsOtuM/9bSLYlujy3vJcQ9HOBOB7+m1oxMaDY317f1eJghfrajuNOrvjT/PJt11xHgoqgYvXAz0zYaYS4XClCAAhSgAAUoQAEKUIACFKAABShAAQpQgAIXTiAeqsttMthpEjutyEVimzbFEJTyJ5xAf7Lt0QmvYdN7CXEPFQynUdz/xX3d+6Kn869znavcLBRzdreoMrdQ3Ahf65/ZrlmUqNrkqo34FhOavadxnmzErRSgAAUoQAEKUIACFKAABShAAQpQgAIUoAAFjgqkWlqprpWI9lCV7eG9kNmiClf2THsffkmhAUFZj9P2Xms2Pj364pFn0qbg3S+Hhjityn14+6FyGw6vzJvRi5GNHT0T/sH+rpuxV5UxGdpGoA5XF4hvWYX77v9C/AQKUIACFKAABShAAQpQgAIUoAAFKEABClDgjQQOhZ7T90kv3EkZrrRQ2F8mux5+R2nLQ0+3sevc/u6HVyRPfeeVuNPQdjr49JgmNGsjoS2M2zZmlCvtWqqLwf0WmifMYlQWvSBaeMyw7dDJHB4+1ylAAQpQgAIUoAAFKEABClCAAhSgAAUoQAEKfHgBNFRADNrkt012K/fy/HCS+/pxntJN4T20KThpnGlCs1m79/Wecy1jo6nzsBO/G3fMTZ3rmWhipjONEPfdh8yvp+MeFKAABShAAQpQgAIUoAAFKEABClCAAhSgAAVOE5jEtvtVuOifgFnMFJ5LT1w0zD0pIT1yMKnDVU8PNVSQstZDpa3vtBI3TntBTIcpj/eVfrisdNdmJu9es+PhyIVYdmNtf6ALPYOxaeN0ZmRisyNDxTMuFKAABShAAQpQgAIUoAAFKEABClCAAhSgAAU+kAAqaxHJSkLbPDbDaKpwJ0OSl1JNLrLRyXRmB4OdxqTTLehUkFZn23NHXsJ0YfgACYIlIJW+s+9yOZQWp49BgLum1szc3z0yhbEm19b5wmZ2Nr/uN9S/sB0zj9EGVOJa9sJ9l38YHpsCFKAABShAAQpQgAIUoAAFKEABClCAAhR4UwEEqniL3B8OPiV/TbW3WJF1KcJtQtggz+VXNp+yDMYDHOzFKa82m99JiCsVuPtVuNPzmQS419V10/p+C61vMzfWqMI145n4lf39bD67YazChGaY1swYmXBt+s5XngBfpAAFKEABClCAAhSgAAUoQAEKUIACFKAABSjwzgWmaaU84jZ9Ov1cyWkR7qYK2sNFuE1+e3KKO1Zj1Sk66cWl2SU8ntwV99xD3FRKPB354UdMZiYBbkd1zN6Xey6rjK1qY/2MWgrP9U+bKlxtTKYKdMKVEJcLBShAAQpQgAIUoAAFKEABClCAAhSgAAUoQIGLIZCaGxzLbjG2gzj35KgWe6ByVZZ0b5WqQ7Mq7RSaStz0slq5sRLVeirnneyPlgpYzj3EnRw9PaSPk49BFS4+XOeLuR6ogStN25V+nNk8dMPn5oduxi4oq3IJb7UzLez9bsbVjIr3FKAABShAAQpQgAIUoAAFKEABClCAAhSgAAXeVkCmKkMeOw1vUXyblibCbe7D/rGneylsQv8Cjce0KXoVpRI3FqjbRTeFjek77h2EuNNN5x6WSsnw8Y9RyHDXzbO6ZXJ1w1zTiy7rdl3tYtstZJ+kqcwkkM5UrkzMGeJO/zx8pAAFKEABClCAAhSgAAUoQAEKUIACFKAABS6WgHRMkJ/UOQGBrGSyEt1K1aw8NjHu9DFKeisLktgYVAh1rJzJ0k6xjrHjOiF2pAEDYtwtvHk/9W3eNnnrwZPzWNvvhXv4YGilIE/zvtXD0a6VXriDcifXM3apeuJv265ZlJpi4zTmOtMoKOZCAQpQgAIUoAAFKEABClCAAhSgAAUoQAEKUOAiCqSoEyGuNshxDyJXKW2d5rcy7Om6ZLiyLpW4VRy7K/FFVGUoLLZmuFX7eyr1G4fW5RiT5dwrcacHPv64qrKu0QuteW3qjjat2AlP4u/aGXcNp5ul7LrphXtw4scPwi0UoAAFKEABClCAAhSgAAUoQAEKUIACFKAABS6CQFORiyYJ0ypcKc+VgaUyXT1ZN4hg9xNP1OUGNFII00pcFfuqj74KUok7WbCGNHj/HbL1XEPclw+ePnbycfniI728Z1Bmq82wGuo6cy0V7apt6zmMwjQ9cVmFO/lT8YECFKAABShAAQpQgAIUoAAFKEABClCAAhS4FAKpvayEsCmJRXUumhXIkyaXxYP00EXhLu4l9vUeUWgMY7yhcEWzE9aX95aj+qvJCe9vbZ6fa4g7TZonH9U84APX1te09MPdGTprS2O9KZ0v/Lx/EZZ1honMsBi0UcCJnOt4joyDTyhAAQpQgAIUoAAFKEABClCAAhSgAAUoQAEKnK+AxK3NLTVTkLvpJpnHDDeEt/KQngVdYU6wqDCpWRoG2in0ql4M3RCfqCdKrU62vzTGcw1N02Be+gB1X+neck/fQj/cUXvPluh8m/dMTz8xv2UKM4vdUYcbM+10gRz6XMfz8lD4nAIUoAAFKEABClCAAhSgAAUoQAEKUIACFKDA+Qrsh7ZSaNuEs80HSC1ujKGZ2AyTmlV2QT3TPi9dlqGpAl7SMbwoX8Q4irFeqA+/98gQ3ZFn3+BJkyYfOgDCW3m2ptbM9Y3rut/O7OKLnsXI7LhQXRfNj03bzBjp/etiLu0UsPuk+cKh43CVAhSgAAUoQAEKUIACFKAABShAAQpQgAIUoMBFFHgpdkULBck30TYBYa6XCFdKcE3KctENV0UfahViLEMZe4WJO36Ix14o+2W85W9F9dmkEvellPTcQtx9w0l4m56vogp3q6fz8ap2my+sQxXuMBtnRc8sln+vbrrrqiv7GWcy3Uxqtn8YrlCAAhSgAAUoQAEKUIACFKAABShAAQpQgAIUuIwCk364iHDxm1opIMHFgjYEpla1Qo1rHWsfC41pzroGRbohPho/Uiv3VtB+4Ug1bzr9829fcA/jkttkaW+09fbmhs3G1o5rbes8zvjPze+YlsGEZsaiMYTD6CVMfilfnh6BjxSgAAUoQAEKUIACFKAABShAAQpQgAIUoAAFLofAoZYKkpFOKnGlr4K0VlC1VRatFJCfulZEnhs3NzfTia3cWNnPVF8+0/MPcaefgCB3bV3pfDHXM2ilMCrQRkGPjDehrYP5kW2bOYTKTueqxSrcKRofKUABClCAAhSgAAUoQAEKUIACFKAABShAgcsoME1g0yMCW0ltVdABPXHTs1CFsb1ivgre1sqWcaxGeLkd5rvzcXlhefr2E0/93ELclDBLLe30hrYKveWHurvZtcXQ2bnSpHYKuuUX/Au1bAvdVVZbtFLI8Z5zG8eJZ8mNFKAABShAAQpQgAIUoAAFKEABClCAAhSgAAXepcB+DJs6JyDCRYArlbhaAt3mR9exssqFTGVBjfFiJUkvlidPXjmycwtPMQ6MR6M8uLk9+OUD3d64rfuDvi13hq7U2vlO7PkvzG9LFW5ECwXjUIXLCc1e+QfiixSgAAUoQAEKUIACFKAABShAAQpQgAIUoMAFFXi5Qey0n62Etsho5QctFKQi16fn0vAWE5vhxRCtih15NopRItz19fVTG86ey8RmEuDic2RMKciV9Ws/uoZWCo+w/ZruqdzEEdopmLJr6+xHpm16choS5OIN5xYky+dyoQAFKEABClCAAhSgAAUoQAEKUIACFKAABSjwXgSaOtr0UYhn8QxppyzT6tvUUyEiscWmqHys60qZLMZSgtwY+61+dAMX66t1XP2d1ZC6HaQDHL07nwBVBju5SZCLIeg76k76JDPUerinTeXG1s2aK35H3dSFmsGJaG3QDZcLBShAAQpQgAIUoAAFKEABClCAAhSgAAUoQIHLLCDZ6LRWVdanHRWk6jbqINWvvgxjtxA3fRVr5ZDg4uZ3fAizIdY7dVTPUsJ6osI3rsSVUaj7qROuUvdkOPgcPH/4xUO9o67o704+tspDJ37m/qlpqzmEtw5tFDJEuPbEUXEjBShAAQpQgAIUoAAFKEABClCAAhSgAAUoQIGLLiB1tynAlUfpNCtFuFKSK7+Tn0n5a8AEZ3VV13nhsBJjS7Vi61oMe3t7seyXUW3uH+nYWZ9rJez9aZgrH3NbqVv4MWMUEmcKAxy3Qh1/iFYKCHExpZnTMqEZQ9xjfxJuoAAFKEABClCAAhSgAAUoQAEKUIACFKAABS6FgAS4TYi7f5+qXFH5impcSXUD2iigFjd6HQ26y6IRrpeEFx0WXIxbW1vq5sLNuLq82rz/lJP+RpW48vnpuPeaod6bfMiDVaXvbt1WG6gh9tqYgR45NaNnw+dxKV82LbxLGil8o88+5Xy4mQIUoAAFKEABClCAAhSgAAUoQAEKUIACFKDAexOQ9BVBrdzhHjWzqQg33YeICFd6z05qckMc17UyLspuIzVU8535+Fg9Vrd+41aUMFXyVqnkfXnw3yxIPXY4HB7VuNfUmn60eNP4wbydty2H1LnnP7c/Ni3Tw6gR4DbtFF4eDJ9TgAIUoAAFKEABClCAAhSgAAUoQAEKUIACFLhMAhK6Sko7CXKl7LUJbVONLhJcVOTKDr6qS3NVbfld9CuohzHWedxED4WVnZWo/mpyxikMPn7259pOIR0eVbi95Tt68HnPtU3mXpiRK4tyBsXCPzaFmUlxskFHXGkPwYUCFKAABShAAQpQgAIUoAAFKEABClCAAhSgwMciICEsqlgRfcpkZtJQIW2ZxLqxHlfBqSzEqoWJzWKcH87HR+qRUqvYQ5ZTEtPzDXFRhavWlZ4bPzKdmcxWtc2icXnRtfOhH2/aTHfSOFCNmwbFOwpQgAIUoAAFKEABClCAAhSgAAUoQAEKUIACl1ggtUBIPRNwEnhE/olNqL0NUn+LbDZImIub9FowmD9sjNpcN5QmuSHOxLhyA5W4styTIt7jrRTkpbcOU2VwcoD9BQHumlozjxYf2e5m15bbzrnc2GjGM/4z89u2bWYxSKs0uuHKDxcKUIACFKAABShAAQpQgAIUoAAFKEABClCAAh+JQBPeIsFNzROmtbcS4yLYbYJcrzCxGbLdUMQitKqWr10d1tfXFQpj0Qz35ABXeN4qTE0BbpMPHxBP2ii43orutzO7gM63doibdW2r3H+n22YufZ6LOQLnt/rcgw/jGgUoQAEKUIACFKAABShAAQpQgAIUoAAFKECBDyyA5Ha/0rXJSxGdNj9Nl1wEs9jufSxdL26Y2ta5VXGIYW+rneD3fBwuD6NU4b7qTM41TL2NT/r6sw2TbVpjej1jc21DXnWrrXDDZqYtU6vhh/1wX/UX4WsUoAAFKEABClCAAhSgAAUoQAEKUIACFKDAJRFouhWg1lZyz/0FrXCbKDdMkt06VnbefhV0QDWuUm3cOspLiwV1e+P2KwNc2eetQlyM6MQDr2+s66xrtJs3xg6UG2VV2+4VywYBLloppDYK2kpLhcOnJMPgQgEKUIACFKAABShAAQpQgAIUoAAFKEABClDgcglMQ1LJb7GuJ/W0CHBNqsBNOShaKTT7oReu7GdjHGVKz8zNhHqhjmhRK5tfubhXvnrWF+9LP1ylr2MatSI8N9nY2EqPnM99R++p75tM52j1IO1w0UkhtVI4lEuf9UO4HwUoQAEKUIACFKAABShAAQpQgAIUoAAFKECBiyOgJyW3MiIEnlKQi/BWZjObVOLKdumIG32MPgStEMfWeLGrYrAh3Nq5FW+t3ppmwaee2FtV4qajTWNYBLgPfql0b1npfPGRllYKg12ktZmyXpUdVevfNIWaSc17LSp/9dtV/556BnyBAhSgAAUoQAEKUIACFKAABShAAQpQgAIUoMAHEkgJbApvMQCZ1Swqqb1FvHvQzSCUYWzmwjMTokeOm5LVMAzxkXqkHjx48NqRv32IeygfvnsXfRzQSsFtOr2H/Nai2raqS2tzNVO9CMs619LmAb18lU1NFV47LO5AAQpQgAIUoAAFKEABClCAAhSgAAUoQAEKUOCiC8j0ZQdhLeJbaaMgbRMQ4+Ie6wHNFIIPlZtVz703VYGJzaJD1jsT48qNlXj3R3clN33l8vYh7qHDrq2vTT7mlpqbbK+1dmacf2Jy3UHRMLrg4tdgUrNmYrND7+YqBShAAQpQgAIUoAAFKEABClCAAhSgAAUoQIFLJoAOuKl9ApJaWUujb7riSoybNkjAi/ay3gRdVb6qC+fqMXaMNZrPDpDurq/vnzTS31Oj3DcKceVA09v+0bFyZ/VOqst1s0/wQXNqJkP9cFHn9Yu4LI0VsNHgneiHm1opnDqYw8fkOgUoQAEKUIACFKAABShAAQpQgAIUoAAFKECBCyvQVNo2w5N2CrJIHa4EqHieNqCuNVaqtD21oX1WOrTCzV0eW50YwmyI0whXdpNbc7Dj928U4qa3Hx7ckeOtqs0vMmNaSg9rpb2vbTbjFtDjoUjlwBgFqnEZ4B4x4xMKUIACFKAABShAAQpQgAIUoAAFKEABClDgUgukfriTKtqUnaLKViJc+ZWbj5Wb0xtohVuW5RitFsYq6CAtF9Tq8mpU92TPVy9vFuKecri1dYWeCY9NZyaz2e6uq/TYxSLrDR/Vq65jmg4LRlu8nSHuq/8efJUCFKAABShAAQpQgAIUoAAFKEABClCAAhS4DAKTqtuU1ErtqiSfqQIX0e2kT25MU5wpryo9xMZgrfNyarGK0e/5qH4DAe4ZEtM3C3EnePfvTw49eewtP9Ru9pYu1cCVxriobR53w7Jt6R7Giz64GhGuzLsWjZwbFwpQgAIUoAAFKEABClCAAhSgAAUoQAEKUIACl1wA1bRN14TmPPbT2NSTFq8hDo1e1XFsFv12qCw64SLWRU+FTquTwlz1V5L9nt5GYerzViHuvXsYwTTIXVW6vdHW/f4z63bmjK211Zlvx221jC64DvmtQoxr8eAQ5cr0ZtPP5iMFKEABClCAAhSgAAUoQAEKUIACFKAABShAgcsogDxWAlwJYHFLfROkeFVu8hwpqFTl4inaKURfViNsDLnFnraIsfUi1gs1Xl0707m/VYibjixBLpa19TWksqsqV9bM9TCNWa5tFUaF6dmrxqlM9jEyoRlCXFmV51woQAEKUIACFKAABShAAQpQgAIUoAAFKEABClxaASSyh8NbCWyllQK2Nj84MWmMi+A0SE/cfFG/yEpbBpXh+TBujUNUn2Gn1TvIeSf9dF+BceZQ9cSD3ZPB3lHSD9epRTMqjd0bY5K1mXy2/Lz+p7Zj5mUPqcRFfGtRhnvmz3vFmPkSBShAAQpQgAIUoAAFKEABClCAAhSgAAUoQIEPJ6BTWNt8fiq4DdP0VhLZVPyKxgnSPCEgzK2rqvY2hjqXOc9UEWbtbLi1eCvtd5aT+EahqvTGbfrhOj0a71iktMZlJnMDexMTms0jfEYfXETJqZUCcl7E02cZFPehAAUoQAEKUIACFKAABShAAQpQgAIUoAAFKHBhBZqYFmlnap0g9a9RSY6LABfBrQS6KQeNtRrZntrIYlbFHFW4Di+3Y3g2fBYfqUdKrTeB7+vO8xuFuPdw9Nv46fcLO6+06ai2KTt1EfvxEwwzU8ZIGwWpwJWeuAbnwhD3dX8Rvk4BClCAAhSgAAUoQAEKUIACFKAABShAAQpcdIFJ+4RpmiuprQ7TKtxm8CjRrWNZzJsvgzdVHI8R7ypV5MEvziymN571JM8e4p50WExqpjaUln64ukDuXCttVe3sjLliM5NjEDKTmUGA2wS5eHrWgXE/ClCAAhSgAAUoQAEKUIACFKAABShAAQpQgAIXUACFtghL5Zbu8TStYUtTgitVueiGm1opeF9FTGpmg7POF0URfO197eqwcmPlpMRVjnRsOXuI+3L8ilYKKPfVj1M/XCm5nTF9P7Jexc7ov4Uf2q5exB6IbzGhGdos4JNfPsKxwXADBShAAQpQgAIUoAAFKEABClCAAhSgAAUoQIHLISBtB9INw0UeK31yJdSVVWkxi6nNQhlHeq56ZlSsc4vXdAyVrerlPR/X19eVupcqeF8b5p49xD3hUA+XlXazt7RD3wQktKbjtM1nXFfnuqutkepbiXHRVgFRrqxzoQAFKEABClCAAhSgAAUoQAEKUIACFKAABShwyQWi9MJFZovEVjLPlHum9FYqcfGD6cuwhpfrMFY9/0xXpowxDwMVQsd16scLdVxVq6m9wlkozh7ivhzBopXCbXzCpn9q9Fjrajhy6IfbrX6lf9NkpoVhohMu2ijghjVW4p7lr8F9KEABClCAAhSgAAUoQAEKUIACFKAABShAgYst0MSzzRilcFWKcdM2CXDRQgFPsFFiXK+qWGpvSmNslbvocx1qb78M9U4d1Sr2T2Hw60/37CHuCcda31jXbg8tb6UfLoLakPnczpmrRlooSBSNbXgBtxTinnAEbqIABShAAQpQgAIUoAAFKEABClCAAhSgAAUocGkEpAIXN8S1TecClL6alOTiDAIWCXKbV0o9NLPxH733pZMpzmIRal3XtVsIK8VKUHdT59wznfg3CnEV4mKZ1GwPlbjatXSlfeG34yc6wzRnTYgrWbScxTf8nDOdC3eiAAUoQAEKUIACFKAABShAAQpQgAIUoAAFKPBuBVJMKzkuPgbVq2lBcCsNFFIFbhPwxlDHcTZvvkDd69jZzMdsGFvtVjXeGAe1oMJZq3Dl+GcKV9PnS358qKXC2vpaeraIzTP4KdXYhOCtykI3Sh9cdH7ADk2IK5/EhQIUoAAFKEABClCAAhSgAAUoQAEKUIACFKDAZRaYVtmmczgISyebpYVCKtSNHq0UUJkba+WDDT6oUA8w0dnz7RBurd4Kan1SrXtGi9eGuPsB7vSAMjbc7uAnX3yk+5jUbKj3TDVGiOtit/o6LhqnWqmqWGpwm+j34Iymx+EjBShAAQpQgAIUoAAFKEABClCAAhSgAAUoQIHLJHAk5URLW4x9f5MEqbjJpGaY2swrZLexrIbGtypU5UqQG3rdyqstBLj3zjnEPfFwTVcHDHElEetKaa+Ny4b5ss51N9XfStlwU4m7fx5pZ95RgAIUoAAFKEABClCAAhSgAAUoQAEKUIACFLjsApNWCikElQnKpA5XfpDWyn29F7ezH6jHajwc5bbwRRb8kl0KaqNJXLHrmXPT11binmb58IuH2m0qvTNqRmsL7ep+XDYWdbgoFZZGDYicUYuLGxcKUIACFKAABShAAQpQgAIUoAAFKEABClCAApde4CB4lQQ21bpGZLYIcFF/G7AqlbnRV7HUs/5pPfBD6YcrzWd95T164UZMM7ZfIntWjjcOWNHktvmQ20q52Se610qdHlCKW6IXr3LSvRfDwE7aIMg12PjGn3HWwXM/ClCAAhSgAAUoQAEKUIACFKAABShAAQpQgAIfQqAJcOUeUaiU1cocYVKPG9BKoY7DfM48DZhELNTBD6pBbM+1a7UzCXCR9O7nrGcY/OsD1lOLem8r27faoBJXV1oPVY2qW51JhjtZtCS4b1IWPH0jHylAAQpQgAIUoAAFKEABClCAAhSgAAUoQAEKXGgBqW2V+DNNZSbNFJDgyr0U5vrg/ajaRdOCWExOoi5r/0g9UjKp2ZsEuPL214a4Jx7wvtLtjXX9bNekxNbUiJuDz8Ju/NTkui0DR/2t5Mkozt0PdSfD5QMFKEABClCAAhSgAAUoQAEKUIACFKAABShAgcsqkGpwm8GjgjV1wg3Ka7RT0M0jAtywl/9a/G+uUgNlVUQzg/DV8KtYbpaH3nz2839tiHv6oVZVgQa4Ztz0xI3WZNVWuK4zJSGu1APbdD9pDZG28Y4CFKAABShAAQpQgAIUoAAFKEABClCAAhSgwKUVSJW3k9EjtpXsEwFtRNsEqcBFKCqVuDVC3N165IfSSkF2Dt0Q6m4dV5dXo7o3aanwBgavDXGPtEPAMOT5g1Wl88VH2naMtkabMoxsMN6i7lbKbqUGV/rhoj8uJzV7g78Fd6UABShAAQpQgAIUoAAFKEABClCAAhSgAAUuskDKRxHkoo3CJMBFDwXl0y31w1U+DOP2zK+7X4YqDnS0pbfey6Rmi3YxqA2Eq00Lhjc6y9eGuMdyYQz0Lj7Cba5oM8SsZfiNts7znfyadsYhxsVEbNqYZlIz9lJ4oz8Hd6YABShAAQpQgAIUoAAFKEABClCAAhSgAAUurACyT4xNqm9TH4WAdax6RLNSj4uNTT/cul9+nZui6hqXKnE7RcffXKjjmlp7q1Nzr3oXPlMr9L/d3+cehoHnD5cfmk/UJ+a57phsZFxZuEL39Q00UMixh9YOwS6iXQS6EhIfvH//QFyhAAUoQAEKUIACFKAABShAAQpQgAIUoAAFKHDJBFKEK3fSVqEJbZGHIsRFkIqKXAS5PozDoL3qP6u3zF5QeR0ylOJ2vX/8mVJ3Vu/ImxCbHm7L8HqD11fi4hjSPiEdSgJdrLc32ro/yOwiCm5trm10daaLMGvQWgF7ILqNTls1DXFfPwruQQEKUIACFKAABShAAQpQgAIUoAAFKEABClDgwgtIgIsFUSyC27SC1YBIFg/SogDtFEZxUA/92EZ0xEV9bpEFj5YKoV6so1pv3iXvfJPl1SHuZEzSPkHCW3lYW5d+uLnOFq0ZKumHqy3qbltqpL+vsthJqXMKc7VU+bIKV9C4UIACFKAABShAAQpQgAIUoAAFKEABClCAApdaQNrIStsE6Yfb3FJ8G5RMa4ZJzWR6Mz8I/ZkV+1+UzsboPOtjaxBqXde1q8PKZom0Vapk36wKV9BODXFlREn13iFbBLm9ZQlmV5R7gbrbSlonKO1NKOp++NQWpo2RBJwHWuWiHleqcrlQgAIUoAAFKEABClCAAhSgAAUoQAEKUIACFLjkAohsJTFNNbdNJa6EsbIVC0puMdWZRLm+Hocdp1zIVR5i1YqlLmu/56NaXo3qF/ea/d/Q4tQQVwp770swfB9HlDLfSalve2Ndu02U4La07uUzaWIzm5sM9biIc5XD22T0CHAR5L7hYLg7BShAAQpQgAIUoAAFKEABClCAAhSgAAUoQIELKCDhLapuJTVFXCsRKPJb/KZteO4R5HpVqbGdDV8p78fyWujg13Tquo9WChuSAb95Fa5YnB7i4sV792RQk+UeHietFL5WG0aPZ/VQDYx3ZeZG7hOdmVzGL115cQwgyXoAAEAASURBVFRpjisZLnPcqR8fKUABClCAAhSgAAUoQAEKUIACFKAABShAgcspIHmtVNo2nXCRz0p+mwLcNKmZvIgNvtyrXuhZ/8yUpowuxrpEP1zjwy11K6BdLd7ydsuJIS7GdBC+ToPcB0o/nLRSuNld1qZQult3ENvWud5zy8apQvLbFOKiCleC3LcbEt9FAQpQgAIUoAAFKEABClCAAhSgAAUoQAEKUODCCEj4ishUQlj5RUtcpLaIcFF9qzxCUKmwDXEUdzrfN7/0g7hjja+CDT7Ly6qyVXi4/DCqu9j7LZdjIa6kxjKW/eX+JIxFFa60UpDtpoOsdryrdYbXbI4mCrpQxsixJMVtbjIdGxcKUIACFKAABShAAQpQgAIUoAAFKEABClCAApdaIAW3knZipWmlIBkuFnTCxTZpsZC64ao6DEPfZKZ2plthUxipUT1yo3B74XYKcLH7W2Wm+yGuHODIQabhrQwHE5ohLd7/AL2LqLaYkX4JRtsmrMVMZtJGQZ5Jmosgt9kub+dCAQpQgAIUoAAFKEABClCAAhSgAAUoQAEKUOASCkhkKtOWSVSbktvmAdtSN1y8hAgXNx/rUNp59Vx5M/ZV9B49dHvdnl/ZXGnmG9tPV99cYT/ETW9Nwzh0kENB7u2N23FVZlBTj5QZIsQtlR4jxPW+tqbQLW2iTGwmUTQmNUu9dr/BsA6NgasUoAAFKEABClCAAhSgAAUoQAEKUIACFKAABT6MgNTcBuSeeJiGp9JMAREugluEoQhzpR43Bl+GkZmttnRtx0UrhFbe8mEvRLWMPe/tv/mtzmI/xJX89VVHWMOLDyc76BZCXExjhjnXdMSEZqEfZWKzlqS2Uo8rRblcKEABClCAAhSgAAUoQAEKUIACFKAABShAAQpccgEJaFMf3HQeaR2dEaQcV2px06MKoYwjOxueeu9LVwc/QCuFSoV6/L1xWNtYi8hLUffa3N7GYz/ETW8+nL0eTofvHk2Kt0cv9KAcaI3aW7wFLRWwhqnMZDRIpeWYh4/0NuPieyhAAQpQgAIUoAAFKEABClCAAhSgAAUoQAEKfFiBVPYqXWjTj4xFtqSblOOiRjfg1RCrOHIz8YnxeaVqxL5VjB1V1/VOHe+oO289odn05I+EuKdV4z54oPQdvOP25F1on6C7XcxuJu0UVG1wDk4qcPGyRo9chrgTJz5QgAIUoAAFKEABClCAAhSgAAUoQAEKUIACl1xAqm9lQTVtE+amfri1Dnj06IUrLRXQD1fP+H9UwY9zF2PbKXkplJvlN26lIB99JMRFeHysgvYBJjW7ix1lYrP1jXW8vqLMGJFthWHXUgMcsvq5X0R4i2gXMbCEuVKPy4UCFKAABShAAQpQgAIUoAAFKEABClCAAhSgwMciIGGutMNFGwW0ma3xVH6R24a63vNbai5+hbC0VBa9FLohbHQ3JnOMfXMA97pDSIDbLE0drus91nr3isZ8bFqmMpNHZYzU3yK4TSEwQ9wpGR8pQAEKUIACFKAABShAAQpQgAIUoAAFKECByy+AytWmN26qxUX1rTRSwI9U4o7jTvv76pd+FHZczEpslsQ0LNrFoDZS64VvfP77lbgnVeFOj762vqYlwl1dVWpjy2mT92TYpoUQN+0j/R8mNbiIcXHMuH/c6TH4SAEKUIACFKAABShAAQpQgAIUoAAFKEABClDgEgk07RMw4CYERRmuRLlSiysdFlCNi5rWFOSW2/Vz5fXYKl/HVkRvhbKuF+qoVhHiNm/+Rqf92krc5uh3lLRSyMe5zvtdrXMktmilUCLIRX9c5yftEzCe1EyB3RS+0d+Eb6YABShAAQpQgAIUoAAFKEABClCAAhSgAAU+tIDEtWhGcGQYQfonILhFjJuiXB8rTF72rPXP46/cltv12tSFMrWbddX2znZU/xP2fvkYRw54tidnr5iVMlz0w73ZNXoGa1paKRhldd8toM9DpiWETuW4qanCOeTLZzsB7kUBClCAAhSgAAUoQAEKUIACFKAABShAAQpQ4JwFJOoMOCZy3FSBK4eXQHca43qJc+th2Mm/o/+m3gt9a3yVWe/RYaGuHWY6k0nNziklPQhxX3HAOxidRLhu87H+umP0XrmrUSysK6nEdRLgIsLF2aTWEJMgF7tzoQAFKEABClCAAhSgAAUoQAEKUIACFKAABShw+QRSIwVkthLbSpwr91LDihpc1OZiajNMbCb1uGUcBDf+FdaHcRRDqIIfF+PK7/k4XB6i8+xLlbxvKbEf4p71gNcmH6St0rWtrMl0ro3Et7KkhrjNKu8pQAEKUIACFKAABShAAQpQgAIUoAAFKEABClxSgaaVQiqmnUS60kJBeUxbJmFujD6W9W69ZWbDV+06G3qb+byT1+3ZdjVymOVsY0ci4HNZXtsT9wE+RoLbO5OP29zVer6LhgqoxA2qyvxzdc04naUkeprlTvblAwUoQAEKUIACFKAABShAAQpQgAIUoAAFKECBSyYgya1U3krPgYOaXJnCDDcdEN9KjDuM263vmL/Wpd2xxlXoPOu387HvuhhW3EpYUSvSjuFclv1KXDka+iEcS4fv3pWC4bXmw76n1BV1Na2PEeJKBS4C3Fzeipuc2CuaMjSH4D0FKEABClCAAhSgAAUoQAEKUIACFKAABShAgQstIAEu0k6JcLEqJbhooRBrrPtQxxrPoq/i2LTrz2zMBlkdfGjH4MpRNc7HYW1jLap7kquez3IkxD1yyPspmFUPHjSP09dMu3leuGYQTXffNJ4U4OLMGOROsfhIAQpQgAIUoAAFKEABClCAAhSgAAUoQAEKXDYBxLb4kQnNJMxF61upwEU33Fp56YSLDWil4Ad1P875zSKakQ++zjGh2UAN6luf3Qp37t3xJxXMvi3E6SGuHPGeUnfxcGf1zn5q/GKwpXW5lyY2UwaBLppApNRWpjWTH2zkQgEKUIACFKAABShAAQpQgAIUoAAFKEABClDgEgpIDorsFp1kJchN9bhpDTFuCnA9ngVMYtZvf9f8bRjFga+HvrCFr1Vdr87OerwnnGeAK4ZnTlzXZe/PlFpYWMBKV2mHLBrvN4VupcYKODfZJQW6ssKFAhSgAAUoQAEKUIACFKAABShAAQpQgAIUoMBlEkBwm6LaJutE3okOuBLaelWlalw8yuu+9OPYGj9Gue5I2SIOskFstVrV434dH6w+SDnpeZ72q0Pc+8c/Sg8Q2VZNJW4VfV714ycmU0XKo4/vzi0UoAAFKEABClCAAhSgAAUoQAEKUIACFKAABS6LQNNKQTUTmik0wkV4W6Mlbo38Ey0VJMKN47AXNtVc/MrVapg59FLICr8x2vBopxDu3r17bhOaTdGOh7jTUtp7GNaRBbW430P2XKDYttNVpUeYa2tjM5VhN3nXS/sfeTOfUIACFKAABShAAQpQgAIUoAAFKEABClCAAhS4yAKTAPcg5sSaVOZWiG89qnFTQwU/jNvFp/H/VSPTbxtbhViEVu79wvJCWP3Z6qT37Pme5vEQ9+Xj3z0azqJAGJW4A13kzY5oidssOEW0xD04w5ePw+cUoAAFKEABClCAAhSgAAUoQAEKUIACFKAABS6sQAo4Jd+UMFfiW1mTXrjSBzeiHtfLTGexDGPd9r9ySqEfrvfYJZS6rJfzcVDP3k1GeizEPRbEvtRSYWe0M63VxZlgqE0rXJyNrDLDBQMXClCAAhSgAAUoQAEKUIACFKAABShAAQpQ4HIJSIIrrRIQcEqhanpoIlxsl8w0bazRoGDgt+OM34y1HjrrqrwT6vZsu3q0U0d1N8Wk537mx0LcI59wT0Y7WdLMZremz9QY7RSaJ83Dqw+0/zauUIACFKAABShAAQpQgAIUoAAFKEABClCAAhS4UAJIOBHipgrVlIcitEWgm7agDy764uJeBR3CKPbz7+i/0eO450aoww15XWGpn9VhpVh5J60UBOr12asEueu4rR527Rw8SRnukTz34DWuUYACFKAABShAAQpQgAIUoAAFKEABClCAAhS40AIpt20qbWWcWJOqW9wkuvVSmRvQUgHNcaOvwkjn9a+ijsOg8lBjUrM9tVcuLy57tYCY9x21m319iDsBXkWK67ZQfTvbOyAPfpLeyqZDqwd7cI0CFKAABShAAQpQgAIUoAAFKEABClCAAhSgwAUWQKsEVN2mH8k4NdopSFWu1OKGGOSZ/ERppbBbb8bZ+FVW58Ms93UR67q73K1VgX3fUSsFgTsW4mI8J6axj758pG13QxvpiVs1ia0zVk4g5bfyPiTNF/iPwaFRgAIUoAAFKEABClCAAhSgAAUoQAEKUIACFDgiIPGs1N4i5ZReuOk+PUewW0f0w0UBLgpv0UphGLdb34l/rcu4Yw164brcl7NlPZYJzaQKV8Lfd7QcC3FTKHv4w+4jmV2VdHZFPesbrUtkte1mh3pSiZui22l+O308fAyuU4ACFKAABShAAQpQgAIUoAAFKEABClCAAhS4iAIyoVkqVZUMNmW6KrVRQIiLCDdGL2EuGuP6ONbt8JmN2SBDMBqy4NvjdjX4bPBOq3CF7HiIewrkCrYvLcmLM0pXQ10c2g+nhmQXh5JS3CiBb7od2oOrFKAABShAAQpQgAIUoAAFKEABClCAAhSgAAUunACS21RAi7sUa0qbAmmkgB64aKaARXtdh1pVflD3TU99HWM1qk1W1aqux7Njjza077QKV8SOh7inVNI+7j3WX++gEjfbTXuUXmmP+da0US7d48ykrngS4Z5ylAv3R+KAKEABClCAAhSgAAUoQAEKUIACFKAABShAgW+rQIpwp20Q5ElqjyvZrUeMi1pcVaYkdxi23VL4f3xZ7nQrtFLo+LrValUjNwoPfvkgpcDvkvBYiIsU9uBDpZWCLOvyeEtdm4xkOHmMNuT1ZriibCzkTU2Ce3JP3clb+EABClCAAhSgAAUoQAEKUIACFKAABShAAQpQ4GIJoM8A0k1pqhCVT80U6tQrVxothFCXW+WXenn8t3YcBzJwlOqG0pb1SrES7v7F3fCuT+ZYiHvsA+9hy8+UcltPmkAXT1t1OwW96BYhDSOcNin6TdvYSeGYIDdQgAIUoAAFKEABClCAAhSgAAUoQAEKUIACF1JAIk3cmmRT7lF4qyqJcnXQqMZVdRioF+1b+m/CSL1QphgHG3ylqrqyVZrQbFIG+07P7liIK20ejnzig2YYNxduNqeCnrhHFkmnA36xUXrjHnmNTyhAAQpQgAIUoAAFKEABClCAAhSgAAUoQAEKXGiBSaSJ9BY/8is9cVVE01vpq4Cnvt4NX2dOly76Omtn9UiNammlgA4G0l92kpu+u5M8FuLuf9S0lcJkw2M8Pkvru5Mthx8OZbdYZZh72IbrFKAABShAAQpQgAIUoAAFKEABClCAAhSgwMUUmASwyDQnvQYk2kxNFKSpAjrjVn47PLPfq39lxm7XmZlqpwy+q7r1drEd9C+w73tYTg9x8eEPVg8VA3/2/7N3J81xZWea588dfAJAkATJYCBEpZAq5GBeVtkLmrVZLsqE/BCMfW+qPgbJXfdHyF2tm9WbbKWk7KpqITSFJmrIbMFKWezsUCpEkMEgZh/uPVO/77nuIEgiQDDEAQD/F3T36yOu/9xXD1885xNzaSgjtwM9qlT9kA5P3lyzoFm61pzpbWwIIIAAAggggAACCCCAAAIIIIAAAggggMAJFpAJ2idDtJLe6lWdwpVlzaLTBc3COOwU7/mfhZHdKHJZ0KwMfuFcp65MFf7lv/7LGwlw1e/IEPfGjcm7+MiYpYWl+FCeMNuei9OFzdIHIK9w5IukB3GGAAIIIIAAAggggAACCCCAAAIIIIAAAgicGAHNbHXqtglypUVBEtwU4aZzvT1GZzfsevyK/cduLIdtXeGs5azUKNSPFx/7N7Gg2VTr6Pz19uRhfRM/2fgkuzq52ps+Wy4lkE7Dxke/0IEnsIsAAggggAACCCCAAAIIIIAAAggggAACCLx9gSdjuNprqxO4uqCZl05cWdIsjOJOb8n8YzH2W3nWq1zVstW4sqPByOsUbpZNqhjewPt4cfY6ncb9mhzN1atmUO9JaDuTDs0HL/uyNedplzMEEEAAAQQQQAABBBBAAAEEEEAAAQQQQOBUCEhTbPpJ+W2qUtAA12qVQpTB27SgWdaqCuts63zHdi510hTuh3c+9G/y/b04xL0ziWh/p4clhQqzzx+ezh03SS5p7vM63IIAAggggAACCCCAAAIIIIAAAggggAACJ0pAo9tUMhAl/JTFyZqlzLwJMURnXHSxdtv+UfvPzL9IE+6gVbSsNcHpFO719etvNMBVtxeHuPKg1TWTaSeuZrhHbUS4R+lwHwIIIIAAAggggAACCCCAAAIIIIAAAgicAIFpjUKawtWhW9nxUSZwo41jmcINcr7Tfj/81G6PNovg6iALmo3NZ25ohsHcTAHwG30bR4e4/WYKd0UO6Z6cUoY7ePr4JKlOD5KuXzLcp2m4hgACCCCAAAIIIIAAAggggAACCCCAAAInUUBqFCS5baZwTerAdVKjoCedxrX1hv1D9sHo17ksaGZKI9luz82aWfeZ+Sw0iembfVNHh7h6LDKF2xzSPXNl/mp8qk6hmB5s8zIEuVMPLhFAAAEEEEAAAQQQQAABBBBAAAEEEEDghAqkRcw0xpUcV8+CTOFqhYINcikLmm23ZUGzMIibndAd+9p7HzdDZaqwYlbC23hPLw5x949q2eQ7DyXQndu/ZX+HGdx9CnYQQAABBBBAAAEEEEAAAQQQQAABBBBA4MQKSHOCZrfSgisB7uRHO3GlTkGiXKlS8DaMw274vNXq1NKi4Nq9tut9tWeX+kupSkF6CaZ1DG/sTb44xO03HQ/Lk0PK6kE2tqOnYlt5b9lTN7yxw+cXIYAAAggggAACCCCAAAIIIIAAAggggAACxxaQBDcLOoErZQqynFkIUqLgog9NnUJthnnL32v9m/A/go0DJwua1e3aVlXl727ejVn25gNcfWdHh7hrTYBrJkGuuXo1aXRbvUPS5kmlQqQb99hfGR6IAAIIIIAAAggggAACCCCAAAIIIIAAAm9OYJpq6qXWKWiVQkxtuFb30xRu6X9rd8c7uS1se6brOqZT7+zs+Ovr1/2bO9Cnf9PRIa4+9sYkyJXdx7uPstienb7Vp19pco2J3ENZuBEBBBBAAAEEEEAAAQQQQAABBBBAAAEE3rrANNrUS5mq1SIFqVJIU7k+Orfl1suvxd/kWTFodduuGns7MAPX7/d9dksmd9/S9uIQ94gDK/Ji+q6PeBR3IYAAAggggAACCCCAAAIIIIAAAggggAACb1VAckyZtW16cOVCAtworQqpCzdoH24IlSxo9hXz8zD0m52iV7Wjd6OL1i0tLnkZdH1rAa6qHTvEvScPvnRO6yL2ZG+ozzU++Exf4eD0LaluouEMAQQQQAABBBBAAAEEEEAAAQQQQAABBE6UgHbg6o+EualKIfOTKgUnka73I79T9sL/18tbo1ZsORut64z2rFk3/m114U75Xhzi3plmtBLjPpSnDeTUmklZbSG78n5lQbZc3n2QLFd2p6/MJQIIIIAAAggggAACCCCAAAIIIIAAAgggcCIEJM7U7FYncHUaVxc1k/nb5mRsqOPAdMPv/Dn3mbH5qK69rcJMM4V7Ux//drcXh7h6fGtNNqsZ7tObxrjZJMCd3kOMO5XgEgEEEEAAAQQQQAABBBBAAAEEEEAAAQTesoDGl1HrE54EuDKYGqLGuDZWku0GX4dR3om/zWzYa0mNQmfWuV5vbM1FmVzN0vPe6ps4OsTtS0KrAe43mmO8Mn+1SZ3tcJLU+pTuaqdCc5KpXDYEEEAAAQQQQAABBBBAAAEEEEAAAQQQQOCkCOgAbtMnoNmmXNPYNnqZxXXRGSt9uLXbdOvtpeo3hQsDSXfDTGfGV6YKb7sLd0p4dIg7fdT+5XqzN6lT0Csp1ZXoNmZNnUJKdfcfzw4CCCCAAAIIIIAAAggggAACCCCAAAIIIPDWBDTClQhz2ocr+5LSSpGCCzbWWcx8GMXt4n3/42rTbuQxr13pvM2tG5rhiZjCVbmXDHGNmW3PRTOdxI2Fptj6kzcrnDVzyW/tI+EXI4AAAggggAACCCCAAAIIIIAAAggggAACBwUkvNThW9n0LM3hGmnDlR8bfPB2yz4oPhj9Yzvr7pZ1actY1nuyoFm/3/cHX+Zt7pcv98sXzaDeywozl56Wl1lL0tv0IxZZs/tyr8ijEUAAAQQQQAABBBBAAAEEEEAAAQQQQACB1yKgAW5a0quZRDUmBCNduNKGW8s8bvSjsFVc9R/7Qdyci/k4n8+rolfUX7nwFW8+lEeekO0lJnGXTb7zMHXeZnaU2dwUZrdYyCTI1feiAa6WKpyQ98VhIIAAAggggAACCCCAAAIIIIAAAggggAACzfxtWpwsDeTqgmZO4tlUqVBv1evFNftPvVAOQ+wEa3pOp3DNuvGSd6bx3ZNA+OJJ3H4aM86W5WgfzeRZGDSHnYU6y1sa4OrbySTR1klcNgQQQAABBBBAAAEEEEAAAQQQQAABBBBA4EQIaBWsTJ1KdikTubKr8a2TOVwXZEmzOA7b3T/J/zHafDvL21Xbe5f1gr18Ycln/1E6dE/QdvQk7loKcI35yJhPNj45kNH2TC1vwsvIsb6XJsCVu3Uc98CjTtD75FAQQAABBBBAAAEEEEAAAQQQQAABBBBA4N0R0Ng2RFnQbNqHK0GmVilIjBvrdJ/sx4F73DZZ7a33vuz5y63Lzlw8OTUK04/r6BBXH3XDxFWzOn28ibqwmWytvC0MEkhPslsNctODRGb/wewggAACCCCAAAIIIIAAAggggAACCCCAAAJvViDN3U6WMEthrokSZMpCZrGZwrUyh1v7Xfeo/W/8/ytTuYOycLae9+5eeS+Y6WDrmz3mI3/bi0Pc28as9Ffi0sJSCm+N2ZMXHMlJZ3F1k/hWFzVLZQrkt40J5wgggAACCCCAAAIIIIAAAggggAACCCDwFgW0QkDHTeVCpnEnHbgS41ZpHreK2633zU/qgd2YcaVtz7Rdr6rt8sayNzf1OSdre3GIOzneeweOWyPc6ablEBLgTt7YiXt/08PkEgEEEEAAAQQQQAABBBBAAAEEEEAAAQTeFQGdv9WFydKltCpojYKXegW9jJmrttwD85Xxrzqx2AtF8NW4awdm4IQnPMk6Tw7WsUNcPeRHcpqd1CkY007vIp+s0jbplmhc0j2cIYAAAggggAACCCCAAAIIIIAAAggggAACb1RAY1tJbTXEbU4ykqvhrTd+0oU79lut9/yPskH8PJP521arZevuIz80w3ASp3BV7yVC3Hvm0vBKHNR7Wc/0npY/MIB7EpPqpw+WawgggAACCCCAAAIIIIAAAggggAACCCBwBgUkwJXItpk21TBXfkKIspRZJn24EuM6DXOrTfug/Gr4deFag1b0Tu523fmu7Zv+iZzC1c/pxSHuzec/ztjSFLueLNMmC5oJRyYTuXp6/tHcggACCCCAAAIIIIAAAggggAACCCCAAAIIvFaBSWgr/bdNRinXZZMuXMkubbSxDj76MHTbnQ+yn9u98VY3ZuOyV9ajbtdeu3bN3/nNnRObbb44xL1jstW11cmKZQ+fSId21BFkUUkFwfsh94l9q08OnT0EEEAAAQQQQAABBBBAAAEEEEAAAQQQOHMCT2oUdFkzGcPV6VvJMKVOIQW63u64z0zH3ytjaxyKttcp3HZ7UJs1E2787zd0+a8TuR0d4vZl/TbZVuRHt/0IVyZxo5H89rzbjC5ancvVomCdxNVMlw0BBBBAAAEEEEAAAQQQQAABBBBAAAEEEHgzApJHNnO48ut0v7kuF81CZiFzslyZjaOw1bmW/9yc85+2887I24HvyhTuuBxreHtiqxTU8OgQVx6wutYEufrgK/NX9xPalmvHLBYa4Ookrv5LAS6VCirFhgACCCCAAAIIIIAAAggggAACCCCAAAJvRkArXjW21JPuZxLKRlnITHpwZRY32mB1FlfbccOufSSJ5rC03raKlr3Yvlgvbyz77JY+5+RuLwxxV/TYvzF9A+uyMze9Ynxwso6ZpreS5Mp0cgp01YoNAQQQQAABBBBAAAEEEEAAAQQQQAABBBB43QK6WldKbydduGkKt+nC1Q5cCXHTFK4saVa5Lfeg+Hq8J4O3e0VRVJ3znXptZ82bWxL3nvCtPP7xLT/90I4xZVGaStc0Y0MAAQQQQAABBBBAAAEEEEAAAQQQQAABBN60QIpwJbSVzgAdMJWWAGm/DbqcmZXZWhdsqDXKDeOwU7wfflLtDje67YXajysfi+j6/b4/Dc0CL5zEfdZ9OoebeZP5IO/xwCZvOPUqHLiJXQQQQAABBBBAAAEEEEAAAQQQQAABBBBA4DUJSIqrAa5O48pUrvYFyFnqwpXw1mUuqzMf63rD3s+/Uv8yd8UgDIfBtqwfDUbe3JC49xRsLxniap3Ck63ICwXa38RLQ92ngt39O9lBAAEEEEAAAQQQQAABBBBAAAEEEEAAAQReqcCkD7eJcXUWV6dwnTTh+uikDVc2PwrbxXvhY7dbb3TyXtXutd3MxRk3NMMTvZjZQaaXDHGN2Tv4bNk/DePGzxwyVxFAAAEEEEAAAQQQQAABBBBAAAEEEEDgLAikEVOdKU07MoMrbQpRItw0iythruxb6cLNv1r/Y9fne2XlbN3u2vGDseubz07FFK5+TMcKce/+890D07VPYlytU0hVE/sf+IGH7d/GDgIIIIAAAggggAACCCCAAAIIIIAAAggg8LoEJMDNmk5c2dNJXK81ClqrEIZxq3jP/9gP7KaRKdxW0bJj85nbOb8ji5mtnK0Q15jr5pllzZJ4YYp9+WyaB5Pj7puwgwACCCCAAAIIIIAAAggggAACCCCAAAJvQCAN4srcbYpwZWkzF53Eus5u2Qf5B/bX3aw3aNfeW29daco6LWh2S6oXTsl2rElcY+4eeDvTpc0O3LS/K1oN2P4t7CCAAAIIIIAAAggggAACCCCAAAIIIIAAAq9LQFY0S+uZGelQ0ClcWdCs1ji36cL1P3ajeiOr8zSF2znfqR8vPvbZh5lM4p6e7Vgh7vU/v/4F0eyT96pCzfYFDz09JhwpAggggAACCCCAAAIIIIAAAggggAACCJwWAYlw5VClCzeTQlwJcWUKV674ess+1CncjunullKj0C27dnvhir2+/s0noeYpeY8vDHFXJ2/kk3OfZI928qYswQ6fKk2YLm6WRUm9NflmQwABBBBAAAEEEEAAAQQQQAABBBBAAAEEXr+AZJES3RqpRtAZXCtTuLIXRmGrvOo+9lW92St0CtdZe9G65Y4J2a1b02nU1390r+g3vDDEXek/KUi4uv9LZ4zU4aaZ4xTcTmLbdDHZ338oOwgggAACCCCAAAIIIIAAAggggAACCCCAwKsX0Bnc5ifIEG4wLvpgpVXBVhv1/bg4/lURy2G0MbqO8+PW2JmL+3UCr/5oXuMrHh7i3jZPTdo+//uHxngTC/mZPDJhyZMk9ibFfd6LWxBAAAEEEEAAAQQQQAABBBBAAAEEEEDgFQpoCCkluBLKSs+rzuBGa6rojAujuNX+wPzMjMJGO5pxXdZ2bGbcuBwHc+Mshbg3J0nsWnO5+pExS7tLKZ2dbcttrZkYCxNzbQt2xgbZ9APQsyyjTkEt2BBAAAEEEEAAAQQQQAABBBBAAAEEEEDgtQg0Aa4u0iXlt3IKOoUrJQperjm34z/LuvF/tGJ73Aot1xq1bGl26uWNZX9as8vDJ3GfsdVKhXtyW5i/GvfMruzJJK5ej4VtXSk2MpfVMpGbHevF0jM5QwABBBBAAAEEEEAAAQQQQAABBBBAAAEEXlogNQKk+dsU4kpEqTUKztRpGncUd7tfNb80c+M/FHlrUIay7r7ftUMz1PnTU9eFO9V5Ye56Z/LI5cnlXH1Okm7pxJWtkFFcWfPNxUymcyXGnjyECwQQQAABBBBAAAEEEEAAAQQQQAABBBBA4JULTBNICSi1REEDXS/RrJwkwpV9P/Jb1a57lNVZ3ZEWAddqunD7/b7PbsniZ6d0e2GIe0Pe2OraagpoH+08zHaef6P74e0BhVS98PxDuQUBBBBAAAEEEEAAAQQQQAABBBBAAAEEEPhyAhLbSh+AxLUa4hoZL/Xy46QLVxpxQxV3ysX44/afhF/nodyr65btXOjU12avOfPh6Z3CVakXhrgN50q6uCJ1CibVKTS3HjzfT3IP3sg+AggggAACCCCAAAIIIIAAAggggAACCCDwagR08jbIj/bg6kn3XTqXaVw/9Lt2u/7MV3EwE4u6M+vc5dFla9aNl+T3VA+dHh3i3mx0p524B607srDZweuSfAuFFCuwIYAAAggggAACCCCAAAIIIIAAAggggAACr1ZAskiNIyW93e/ClQXNvCxo5oL1Y7/dej983P0T/095DHtFUVSjbteaRQlwT3GNwpTw6BD3jiSz+5subabbuebiwLlMMEuULQHugUcfuJtdBBBAAAEEEEAAAQQQQAABBBBAAAEEEEDgjxNoIkhNcqXVNc3fSoQbaxMypxO61Y77rJIp3NJ5L6udhdmiduaiPvb0b0eHuDfk7etJtuX3l+Vy3czPH/GmUxh+xP3chQACCCCAAAIIIIAAAggggAACCCCAAAIIfEkBGSNNCWQMmXbh2uCkDdfFym66P7SX3G9zFwZFd67udrp2t7PrJNs8EyFueaTX7ebeO31j/q3sXpTT3ng3az0zjSt9wjFPZQr0KRzpyZ0IIIAAAggggAACCCCAAAIIIIAAAggg8LIC2oUr4a0WKWghgASzEuFqeKt7bux3C6lScIP4+UycqTt18A/PP/R7nb2QZae7C3cKdfQk7uRRN6aPPnBZ+cPLE5LngcexiwACCCCAAAIIIIAAAggggAACCCCAAAIIfEmBFOBKi2tIXbh6qT/eyASunKRQwW+5B8VX6l9l0e+VhbN2ruc6o469fvH6mZjCVbcXh7g3G14ZxpVtsbly6LlOMrMhgAACCCCAAAIIIIAAAggggAACCCCAAAKvVEAKcHUWNwu6rpnEuD7aUMt+8CO/lb8XfuSHdtOM89rGtqu2H7mlxSV/VqoUVPLFIe5Ti5t9MX6KcOVMVjcTSQLdL5biHgQQQAABBBBAAAEEEEAAAQQQQAABBBA4lkCaw03BrQaOMoMrS5lZU6UpXNn32+5Btlj9Qspe92Y7RV3Gqv76X369kqW9/FmpUlCnF4e4E817D+7J1PLh25PQtumYyHSlODYEEEAAAQQQQAABBBBAAAEEEEAAAQQQQODLCWi+2AS3aQJX2m9D0C5crVCwco93W+7T/Kr5QRjZrXbsjlutlu1c6NSmlgD3lkztnqHt6BD35rPvdN2E7rnnAloNbZvgVu567t5nX4PrCCCAAAIIIIAAAggggAACCCCAAAIIIIDACwS0OEEXMZPaBPn7fx+0B9easVYphCrulVfDT1uLox/P5Z3t0jpbdbp2b7RnzUV5zhnbjg5xD7zZ5feX4329vrMrZ8Mn92T5JLZNzRSS4crVjCj3CRB7CCCAAAIIIIAAAggggAACCCCAAAIIIPBSAtMahdSFqy24EuFqiOulSCEY6wdus9q292NlRqUtbXum7WZye+a6cKdmxw5x9QlXLy7GKJO4sTUTO4UEtXmhi8FJd0JTqKA9E6lrgmncqS+XCCCAAAIIIIAAAggggAACCCCAAAIIIPBSAilclCHcFDpK8KgRpJQk2ChTuLH2Y79bvB9+WF4b/SqzxW4VynpkOvV0CvcsdeFO2crpzlGXq2ur2bWFa9lsZzbzZjE9tKqNKbqSe3tTyWJmvjHVIVw2BBBAAAEEEEAAAQQQQAABBBBAAAEEEEDgSwlIaKszo5rhSq+tVipoAik/cpkWNvPjuG2Me1DOFIMsFnVn1rl8Ntir80vefHj2qhRU8ZiTuCsHxHfSflsmcTNf1Pm5/A+SgFdGIu5UiMsU7gErdhFAAAEEEEAAAQQQQAABBBBAAAEEEEDgWAJa0dr8hDgJcHUxM4lzpQs31NFJCjmKO6334g9bX42/MON8JyuKajTq2quDq9asy4JmRgLgM7gdM8Q9/J1HU4bMmUpUowAJc9Z0DYs2GwIIIIAAAggggAACCCCAAAIIIIAAAgggcEyBtIRZmryVMdw0idssbObSFK724QbjfOX37JZ7mA3DXhaK2lbe7/narZrVkN2Syd0zuh0rxF35hr775UQgK781CW0ppNbp8K2O4MomN8tdmnbrT7qJMwQQQAABBBBAAAEEEEAAAQQQQAABBBBA4FgCqUNBcsVpjULQZcxkCldaAKRSIQz9Vpyv/qH1lfEvbPB7szP5OBY71V/92dX6b279jQSVZ3c7OsS901Tc3v3nu1l57pND6m6lUnfyCprapuSW+Pbsflt4ZwgggAACCCCAAAIIIIAAAggggAACCLwOgWmRwqROQYZFvfzIFG5zqVO4dsd9Viy6u8YVj3rjrKpMz/3FzF9U5j+YMx3gKvfRIa48YHXNZNfN9fTR3Jfz0JVx2+EgXTetY7xA80jOEUAAAQQQQAABBBBAAAEEEEAAAQQQQACBwwTSfKj8jX8zJyotuEGXMguZlR5cncJ1MoW7mS3Y72WD8Lg7yMZFVlQdM6rlxZws1XXmx0pfGOIeVL06WIxapxBbs/swZ7Zo4uAbZx8BBBBAAAEEEEAAAQQQQAABBBBAAAEEXp9AWnMr/aG/9uEGKVRounBdlhY0q7bc/eIr7pd5KPdc6fzYjd2m2XTmZlMO8PoO7GS88tEh7g1FWD1wpJ+aMBPjTFsonYllONCgoNByItQ9wMUuAggggAACCCCAAAIIIIAAAggggAACCBwloKFtjFk61zW3dEEur/UJ0oVbS5jrwyhulVf8D10dHps6r8Zly3b/tGv7/b5/F6ZwFe/oEPf2Qd+l/SupTEEXNpMQN2ixsO6JsCxxFmWVs/0p3f0nsIMAAggggAACCCCAAAIIIIAAAggggAACCBwqoKOhGilKZKszohLcat6onbghBF9t2vX8Wv3rti12z3XLuuyM7LWdazb7MPOHvtwZvPHoEPdm847X1tcmi5pdMxdmF/ZD2qJo2eKCeaSrxAmy5uVpdTNRP4NUvCUEEEAAAQQQQAABBBBAAAEEEEAAAQQQeA0CEiY2fbgykhskxpX4NkreaIJO4RZX/cfZOGz0iryqR7Xtbnet1Ci8MwGueh8d4t4xEt6uGNPXhz7ZZnW3Srl49HXUAuGU2upZ2nkHyoSVgA0BBBBAAAEEEEAAAQQQQAABBBBAAAEE/ggBnQZNoaKcpf00iStTuMZGn7l6yz4oPqh/VdjWwNUdX7drf+0vr70Ti5kdVD06xJVHrvSFb236lE9NHCdWYwq5lPg2y3XOWVorJC1vfhL39AlcIoAAAggggAACCCCAAAIIIIAAAggggAACXyDQJLeSKErEqE24B7twvU7h/jCTLlydwu0E53q9njXr79YUrsIdGeLemdD2F/sShX9i3MVr8ZF5ZIb1IKu8Tuk2m+S4aQBXr6XgfHI7FwgggAACCCCAAAIIIIAAAggggAACCCCAwCECGiPqbKicdL0tqVGI0oKrC5pJlULwwdltt97+SvhVJl24VSzrUTmyi4uL1txKEeQhL3l2bzoyxDVmGuM+D9DRSVw9yZYmcaPWVcjaZhKeS7q7H+o+/0xuQQABBBBAAAEEEEAAAQQQQAABBBBAAIF3XkBSW1liqwlxZQWzNIVbSw9AyHzqwr3sflQNhpvdMDMuQqeeTuFmBwZK3xXDI0PcG+bGvsPS1aX9YHamPRtjKQPOsk5csMamumG5VwH3H7T/THYQQAABBBBAAAEEEEAAAQQQQAABBBBAAIEDAjIIKuOgMoGrcWJKF53kjONYxyqGYKsNe9981d9t591dV+36uvvIb5pNl93S57x725EhrnKsrq1md+Xy3j299om5dO5KymnHsrBZS1eKu+C3tGhYE1x9RJrCJclVCjYEEEAAAQQQQAABBBBAAAEEEEAAAQQQOEwgk7/k1xncpkahWcjMSoBrjLfbfr183//AbNcb3ZiNWxdbtjvftf1+3x/2Uu/Cbc+HuPtNt83bX+mvxOt/rqApxU03aiduVyZxW9KkkNlg0/itrHCWaojfBTXeIwIIIIAAAggggAACCCCAAAIIIIAAAgh8WYFJgNtUKUgTrvyYWsZFfaj8bpy334nvjT/uZjO7ZSjrwXBgr+1cs9mHGSHui8Tr95fj0u5SmrGNkzqFWp7kQpZNc98saiOuzkCnh73oJbkfAQQQQAABBBBAAAEEEEAAAQQQQAABBN4tAY0Og6SHupCZbEGncHUpMyehoq827QOzOPylGbc2srysxp2uLUZFLYuZvbMBrn49np/EPZC/7i9r9lHzTdJZ3IcPH8r5njHj5rZSL1KKKwluGsnVBFfCXDYEEEAAAQQQQAABBBBAAAEEEEAAAQQQQOBZgTQGaqI0KoToZDkz6cLVv/ePo7BVXI7fM4P88YUir8pY1R0zqpcvLdt3cTGzg2zPh7gH753sr6bLtXR+Zf5qlAg3ZbiCHE1eaHQrMW4zhatD0GlPWonTEzhDAAEEEEAAAQQQQAABBBBAAAEEEEAAAQRUIP0VvySIOonrZbpWahSiky5cWXOr2rIPiq9Wv2yFmZ0qlnXHd+pFs1i/q4uZHfzCHCvEXdl/RtOLO2vnYkc6cY2colbhBmN18jmtbaalxHpiQwABBBBAAAEEEEAAAQQQQAABBBBAAAEEngikKoWUJmqiGKRGoY5j6cINfug2y8v++9KIuxGLusra7WprtFWbm+92jcKU7sgQ98bkUat62QziTm7RWdxmkw4FWy4UmzL4XOs8ro7lNq0K00dwiQACCCCAAAIIIIAAAggggAACCCCAAALvuIDO4GoPrvwdv07hBh9dliZwJUt0dtOtm6/6u+282D3XKqqOudDUKGTUtur35sgQd78T96lv2LqJ7bk4Ho2M1imUQi8fgJWHaJKecty0l6499USuIIAAAggggAACCCCAAAIIIIAAAggggMA7KaARYiY1CpmkibKumU7huiDpYgxuw/8+vxK/l+3ZTflb/3F31LX370tT7i1NG9lUIIW4koDromTpdDyWXdNt9ZpKBelUyLNcIvGUisunoR+GAFOpcDxKHoUAAggggAACCCCAAAIIIIAAAggggMBZF2gywzSFmxYxq8042liHcdzLPnA/MR+MftLOutvnxkX1e1+7639r3Lu+mNnBr8SRk7jGHD6LG+pzcWRGptJXKiWxzaQOdxqM6wSujkXrR8KGAAIIIIAAAggggAACCCCAAAIIIIAAAu+ugA56an3CpEbBBFlYS4oUZAq3lplSa4duy296mbvN9/LYqqtzPVfOPbYZNQpPfWdeEOI+9dgDV2QSt+xFrVMoNKzdX9FM81s96T+JcfeT3QNPZRcBBBBAAAEEEEAAAQQQQAABBBBAAAEEzr7AfoAri5PFzDcBrrFBJnB1BDSM3HZx3n3HfLX6ZRb8XlVZu7NX2b7pu7OP83LvUOZov9ymAa5M4UpYWwbjQ2XyVEosE7nSbCFJuaa46cqXe3mehQACCCCAAAIIIIAAAggggAACCCCAAAKnV0B7bzUj1HMdA9VzWc5MahKc0RBXElv/KP+f6l+2B8XnZatbmVbL/fnihdr8R3k021MCR07i3rhx4xmw5fTk3clLdCTI9SHaYt481BHoLNf8ViJ2mYV+6rdwBQEEEEAAAQQQQAABBBBAAAEEEEAAAQTeHQEJbeUnhbfypmXuNnqZx7XGxpEEu94P/WZ+yX8vDuNjXcwsH4+qcnuvMv+BLtzDviS5aB4vcO33958/19U5W2PGcpJRXsnQs0o/ColwU7yuF3rafwI7CCCAAAIIIIAAAggggAACCCCAAAIIIPCuCEgu2JSu6gBuDPIjAW5wspiZkyoFF2295dbzD6qfG1vsFlXL7nV79tpfX6vpwj38K3LkJO5hT/GDxRiqKAubDSd3t6Q3ITRBsGS7adU4acNtYt7DXoHbEEAAAQQQQAABBBBAAAEEEEAAAQQQQOCMCqTcVlJCSQglNNQuXJm8lfoEJ+deMsNot/ynxRX/fT+Im+2QjVtlZY15VJsPZUiU7VCB/Kh52Tt3mlrbFXnqkznc5nV69Uxa2MzIFLQxkgXr5O206UI6cTP9uJqHco4AAggggAACCCCAAAIIIIAAAggggAAC74iADHk2NQopKwz69/tOJnFrncaN47hbvh8+ju/7HxV5tm2Kotpynbp/s2/TcOg7YvSyb/PISdwb01f7hjH3HtzLyo1P0sRtkDqFgUzixkKC2tCK0Ya0opwJWZCUPcW3GuDq3vQluEQAAQQQQAABBBBAAAEEEEAAAQQQQACBMy4geaD+kb62KOjApwS3LliZwrWxlklcJ124W3Y73DejsNsOveFCp1391dzVihqFo78XR4a4+tTVtdXs7j/flfBWFjX7mjEPd9Yzs23MTHsmCn8sfLTmvP88yMJmWo+rH5H+0Il7NDz3IoAAAggggAACCCCAAAIIIIAAAgggcMYEUnCr4a2eYghNjYILY0l202Jm5rz9llkc/KKTl7tFGNc7Zqc2t2TJM7YjBQ4PcSWyvT152kp/JV7/8+tx+X2h/50xV+elEzctbDaQR4ybadwq2pSt63P0o2IGd6LHBQIIIIAAAggggAACCCCAAAIIIIAAAu+EQApwJRiUAFcWMpPxz6jzt1UcRZtVEuc6u+Memivjn+fj3mcx5OOZMOOW+kvUKBzj63F4iDspQbgzfYGPZGfTRLewJPd8aoLU4WqEG8tuNDJ/awppxZWPST4cHcXVD0xfYT/XlX02BBBAAAEEEEAAAQQQQAABBBBAAAEEEDjLAqlCQRNCCXFlETOZr7VyWctArncb7l+zC+6/xbF/3PXFOA+d+vLM5YrFzI73hcibpcuef/BNuenGmoka5K4+f/fkltH+PZPoNkW5URY5k+vy0tKKy4YAAggggAACCCCAAAIIIIAAAggggAACZ1tAU0Fd0ExOsmiWlCdIgOtkDtcZH6q4l112q2Fx/LGp8t1ytlO364GOhjryw+N9LfLjQq2tr2XSittsG9OdyaVvFpyTa80Urn5kaRL3mcdxFQEEEEAAAQQQQAABBBBAAAEEEEAAAQTOmoBmglKhoGOeIWSymJnEuKlOQW61ftd/Frvhv+fjuNXtzI67w9pe++trdXZLQ1+24wgcXqdw4Jk6jatX+4v9eE8u3cVr0fdCnKklXbfNfTHXMgX9qFIJsexlOohLM67CsSGAAAIIIIAAAggggAACCCCAAAIIIHB2BVIqKFlgkL/JlyKFdHJSojDWWNdLcCs1Cv/VdOvfFaE9zNrtauva5ZoahZf7QrwwxNWXW+mbeNfcNc3iZp8YP5p04rZ68kmYaMdeFzbTD0ny9pSga4xLlcLLfRY8GgEEEEAAAQQQQAABBBBAAAEEEEAAgdMnkCZwNQuUXFAncK0031ojXbjRVlv2ofnA3c2d2Zz3ZT001i1vGBYze8lPuQlxpfsgdePq5Rdsu+vX49ramtHFzdysNFvoNhyZVt722UW7GazM5e7XKUiYK7246TGcIYAAAggggAACCCCAAAIIIIAAAggggMDZFJA53DTcmQY803Jm2oVby4Cnd1v+fnnZfxR3q8ft0BuOypHtmytjc4vc8GW/DKU+4WAvrnYh6G235ceYm7pr+nK6IsubjRZXYru6l10ZzMa8HWPtetHUtZE5XEnPJWdPIa58bDKHq/UKmuLK7ZMLucKGAAIIIIAAAggggAACCCCAAAIIIIAAAmdJQLK/TKoUQgjeeFnIzEqxgvdjtxfnxt8OC9WPemZmp/CdOq8lSPzfjD+YRZ4liNf5Xr6wTuHmzZtRI1w96bbSX4nX15uU3M8vxj25rVeaWMllaQp9SBPh6hpnsjdpU9B9NgQQQAABBBBAAAEEEEAAAQQQQAABBBA4ewKaAWoaKM0JabUsiXCjlSvebvv75oPxrzq+3DBVUY2CdffO36NG4Ut+Bw4PcXUWV0/PbKsyjbv8/rIEs5+a2baJAzM07UI+Kq1OmP7oRK4muJNp3GdegqsIIIAAAggggAACCCCAAAIIIIAAAgggcPoFNA2U1bI0Cwwx89KF60wla5mFMPRbxSX/UTHKP89CUReuUxejrXrl5oo//W/77byDw0PcybHclss7fZPdmFzXaVypxU3b3q5cDOWko7j6kUlRseTu8kFI44WcMjpxkxNnCCCAAAIIIIAAAggggAACCCCAAAIInDkBTQNTiJv56I0N1gx1QTNJB+tqy62bq+NfxNDbmSuKanhBFjO7tGyzTCpY2b6UwJEh7s2bJt5Yk4D2qU0WN7t4Lc52ZNy2JafCxNJkdX4h+1yqi+tUgSuhrg7jyvbMc596Ia4ggAACCCCAAAIIIIAAAggggAACCCCAwGkTSAFuU6MgRQpSnpDZWEvrqtYobLk/lJfjR7YOG11fjMejsS5mVrOY2R/3IT8X4moiruXCX1Qw3F/sR/O7T0yQOoXpr5a0PTalxWlxM23ElRPJ+tSHSwQQQAABBBBAAAEEEEAAAQQQQAABBM6IQPqbfP27fKlRSAFucNFqIOiruGvO23+IVwYfn8tmdltlbXtlz5rfsJjZH/vZPxfiPvWCh/Ti3jV3jVtYkk/EmNmDD9ZX2h+J1gBXklydyD34GPYRQAABBBBAAAEEEEAAAQQQQAABBBBA4PQKTKdwTRZikCoFCXAzFysd8LRb9f34XnW3bcvHWV1VVZhxj+ceW3NnMvh5et/1Wz/yo0PcA4d3R/b1dH39espl5+ooC5tJVCt1Cpq760O1CEODW4luZcuC3i1xLjmu4rAhgAACCCCAAAIIIIAAAggggAACCCBwmgU0wJUIUNK+oNUJspSZlRB3rOtkuT3/WXbRf2RG9UY7nxkZa8Z572LVv9m3X/QX/6eZ4k0f+wtDXF3cTDftxtXTarpmzI78pJXNnAxO6+x0FccS2OqKdLKlAFc/UALciRcXCCCAAAIIIIAAAggggAACCCCAAAIInFoBDW41wE1TnM0EbnBmHLQN18ZRKN1/j4v2J3k4t1XGqi7/ZKlaMqZmMbNX84m/MMR99tes9Jtg1nfkE2vNSEhbmczmdXEuX/fyocnjMw1v0wSu7rEhgAACCCCAAAIIIIAAAggggAACCCCAwKkUyFLSlwJc+ct7vZQA1wcvU53WSBYoK2t5t+MeyeN+nY3MZifPR71Oz97bMTa7lQY9T+X7PmkHffwQ9+bBQ79nfBXijFQqtE0nFHmpH12tNQoa4UbJd1OzgnyashHkHqRjHwEEEEAAAQQQQAABBBBAAAEEEEAAgdMhIDlfM4GbAlytUwhBb5EG3FhplOtGbsec99/yi9VPO3m5W4ROvWMW6pVb8hf7bK9M4Pgh7rRXQX718vvLcc7Mh92W9CjIR1m4lpfRaasTuCm9lYumC1fSdioVXtmHxQshgAACCCCAAAIIIIAAAggggAACCCDwhgQ01UsduCnI1RrVELycS32CqYKTGgWZxnVbYd1eGf5cmnE3ZkM+7nVru/QbmcI1kg6yvTKBY4W4uqDZdNP9tbU143sSvMsk7kgWNvOxcuWF+Ll8eE56LprlzORcPkjNdNM47vT5XCKAAAIIIIAAAggggAACCCCAAAIIIIDASReQDDYle/r39roOls7dZlaWM5NRzmYxM7/l75sr/rsyjfvonO8NhzKFe8Vcqc0d8sBX/ekeK8R96pcRVxvNAABAAElEQVTeuWP6i/14Ifdhtm1iR6La0rRCsNamjgyJ2fcfr5O5TZ0Cyfs+CjsIIIAAAggggAACCCCAAAIIIIAAAgiccIGYyRSudtrKSSoUojMyvqktuHEkQa6TGHc3zNffDgvV9yXA3SldVe/52sm7ckzhvvrP9qVD3Bv/9ka8K8cRBlKkoAmujlU7Ga4uCl3SrKk6lqvTLdUqUKkw5eASAQQQQAABBBBAAAEEEEAAAQQQQACBky2gf1k/6UxNlQrBpIXMpEZhrFUKOo073qj/kF0e/VSWN9vMQlmP3Yz7qz+7WptbB4LBk/0uT9XRHSvEvXHjWfy7xs/LZzeOUqUQQytve9mXKFcGb3VpM91kLDeTV09xrka7bAgggAACCCCAAAIIIIAAAggggAACCCBw0gU0x2umcGUGV+I+7cG1epIahbSYmd126+ayX61H/vF8PjMq3KguL+3U5j8whfu6PtxjhbjmwKJmeiDX169Hd/FaDN0Yu+WM99KG4S/abWnEdWkaV3NcWdtMHqo7kyT3db0FXhcBBBBAAAEEEEAAAQQQQAABBBBAAAEEXoFAs5iZnqdhzaAxrsxwyiRuHSvjpVeh8rtxrv529p77/jkzuzuKVd250Kl/9pufSdUqi5m9gs/g0Jd4YYh786Z8aHo6sK3q/u8+MWEkn2a1J5UK45DFoglws5inz3jyDD68A3DsIoAAAggggAACCCCAAAIIIIAAAgggcDIFUnQ7qVGQOgWdwpVTkP5ba2qJcq0U5Pp6y61n741+Jp24G7O9fFx2evb+/fv2wzsf+pP5ts7GUR0Z4n5xCfGqcQsuxbQ7ba3G7YRSo1tN5Zu5W8luJ0D6KP0KsCGAAAIIIIAAAggggAACCCCAAAIIIIDASRaQeG8S30qFqlQoyHJmEuLKFG6QUgW35e/nl+NqrIrP2yEbj0ynLs1Off1vr+uCZmyvUeDIEPeLfu9KfyWFsqEX42zbxJEZyWdauPJStqUfbpZPIlyi2y8i5HYEEEAAAQQQQAABBBBAAAEEEEAAAQROkkCaxJUUVwc1pURBwtsgPbi1RH/RuFDHvThffydcqr7XycvdWXt+vLNX2SWzVPOX+K//YzxeiHtbu20n283np2q7RS+W0o6hk7hpQbO0pFmzmhk57hSOSwQQQAABBBBAAAEEEEAAAQQQQAABBE6kQBPgyoJm0morrQlSnjAJcIM1lQa69Ub9B3959NP2SGoUQj7utmprdz6ts1uZPJ7tdQscL8SdHsWBALfcKPeD3Vg2wW5emFzi3v3bZR5XVzfTJc7IcqeGXCKAAAIIIIAAAggggAACCCCAAAIIIHByBDS3S/23kuDJpUS2PrMyqmklwLU6mGt37AOtUSikRiG0zXgYOvVnM59V1Ci8uQ+xfOGv0khWs/iD07gHnjSoTTajD8lbMZMPOCskrW+C3CbBl69BWpduP9o98GR2EUAAAQQQQAABBBBAAAEEEEAAAQQQQODtCugyZhLkphBXmnBlDtebOlTaihvGfi/O2W/Hi8Mf9Fxvr13PVkZ6cL/+v/YtNQpv7mN7uUncg8f1taV07Zycj53J2nlhzbx56KUpI4W4KcKVSVyZwtVdNgQQQAABBBBAAAEEEEAAAQQQQAABBBA4cQL7U7hBtkwmcE0dxzKFW2szbr3p7vv3Rj+LvtyYybNR53xVX/vra/TgvuGP8YUhrgzVHp3ASorblToFierlQ461DNxqD4YW5B6YxH3Ba7zhN82vQwABBBBAAAEEEEAAAQQQQAABBBBAAAHN8JoJXJ3ClXZbXczM6Ryu2Hi3E+7nl/2q2/Wfn/O9odYoPDJXavNhyv/ge4MCL65TOHgw00qFvt74ifG9uWhGxgzlWqtoxzrULtfoNoQoa5tph0bMdRC3qcnVMJhSBaVjQwABBBBAAAEEEEAAAQQQQAABBBBA4O0KaHzr5RBkNjPqNK4PEuDqFK4uayZlCgM/N/6HOD/6/nw9szsua3vRBvd1Y9wLhz7f7vs6k7/9hZO4X/Su3e5SXJiLcXfXmF4rxiJGJ3UKnwf5qOU5EuXKx95M5eqVL3oZbkcAAQQQQAABBBBAAAEEEEAAAQQQQACBNy2g6Z0OX0p8m/55yfZqM5bzSmZybbVR/6F4r/pp17Q2825Zt8OM2612nblF0PemPyr9fccLcQ+dn71nwlAmbrUUV7Y6DVmHOgQvn6TWJ+SpVmHysWqOS5LbUHGOAAIIIIAAAggggAACCCCAAAIIIIDA2xSQpE6qUbUBN0afenB1BreOVZAp3HrLPjCX/Ef1yD/uhplxITUKm72xXf73y0zhvqVP7VghbhqRvnkghF0zsd5YjmE+RFmPLgbpxNXjz3JZxky3IBm+ViponC8Lm+lP+pfu5AwBBBBAAAEEEEAAAQQQQAABBBBAAAEE3pJAqlGQ0E6rFLxcSg+unLRGQRYyC5XfM+fst/Mrox+0y9m9kbf1Xre2181inX2YnvOWDvvd/rXHCnElgM3MtA9332vN+IGP0qZgoo2xJX0K3kYrVzW61VA3hbdNvKv7Uo3MhgACCCCAAAIIIIAAAggggAACCCCAAAJvT0ALFCS8lbROZm6l/dZFF6xM4EquJ/0Kvtq0D8J7ez+P49ZGNxbjsuxK3ieLmd1K/blv77jf8d98rBB3EsQ+RdVf7Ee34+JcRxLblomla/vsot2UauNaI9v0I8/QNDeLUq+gP83Vp16HKwgggAACCCCAAAIIIIAAAggggAACCCDwBgQ0wNXFzNJJ/ozeRy/XalPFkdzu/LZbzy6H74a97PN2O0s1Cu2rF+s+i5m9gQ/n6F9xvBD36NfYv9fbXGZyJwO3GtzKpv0KTX6bQtz9x7KDAAIIIIAAAggggAACCCCAAAIIIIAAAm9IoCk+1eBO/4pewtzMyiJmNoziUHpwnR9JhDtnv2PODz+aK2Z2zo2LSmsUru0Ym93iL+zf0Kf0hb/meCGuJrE3Dwlhv/b065ZyddKKKwFuU6mgAW7q1NUd/WFDAAEEEEAAAQQQQAABBBBAAAEEEEAAgTcpoJlckP5bOaVNZnA1wo0jmcd1sl9ZW//MXRj8qFu1NvNQ1pWvXHvhiqVG4U1+TF/8u44X4h7y/LsHbgu1BLaF9Crkpa5np/0ZT/XfatAvGwHuATN2EUAAAQQQQAABBBBAAAEEEEAAAQQQeAMCOlYp4a2OV+oE7iS+lYXMpAe3ltnNUD2u/mD+bPh3HZd9NtMq6tJ16s6FTr38vhSnSlHqGzhGfsULBF4uxL0pH7aeptvv5FOW7Ha2NRc7clsry+tyIXssQW6VHiKP1A9aT/o9kStPnjt9DS4RQAABBBBAAAEEEEAAAQQQQAABBBBA4NULpAoFWcCsuZQahcxn3ljpwZVlzExlfObspnuYLcTvxu34oO2747FM4Q5atV1cXLTmxtODmq/+AHnF4wocK8Q9LHG/Lr/BLSzFUMnXwOyl3ycTuNqEayWq1bBWSxj2t/QaRLj7HuwggAACCCCAAAIIIIAAAggggAACCCDw2gQmwW36i3mZvpW0TmoTZPbWZ3WsYyXxbAh12PNz1bfcheH3OqYcmLyo4lxrXIy26tvrt32WMYX72j6fl3zhY4W4X/Sa5cYnWehqiDuXHlLmRSrA1X7kyZbi3DSvrQ9rwt3pfVwigAACCCCAAAIIIIAAAggggAACCCCAwKsWaOoTvLxsc0oBbpQAVydwZSTTm1q6cH29aR+Ul+ufFlX5uOvMuFVWtjQL9fKlZXvr1q39gO9VHx6v9/ICXzrEXVtfe2rSNpbaquFitNlYwlr9kCWqlxoFCW6b1H5SqfDyx8gzEEAAAQQQQAABBBBAAAEEEEAAAQQQQOA4Atp7GyW81SBXfuQ8LWIWdCEzXcqsNpXsB7/j1+NF992w5z6fjzOjrMrGHenC/cSsuuxWRoB7HOs3+JgvFeLe6d9pAtyvLT11qJnp1vlc9ocgX4ZUpqABrq58JzULMoarZQt8AZ4S4woCCCCAAAIIIIAAAggggAACCCCAAAKvTED6b6X1dlKlMAlw0wRuJgGuzOCONMz1w7AZ5upvx/P1R9327G67sLZ3tWevzl21KzdXdHqX7YQJvFyIe1uiWTndkFbjg1tm91Ko2w2lNmvUaQGzFNvqHK4JKcj18rXRQgU2BBBAAAEEEEAAAQQQQAABBBBAAAEEEHi1AmnyNv11vI5TykkacIP04AaZvvXGhTqO5FYny5zVztY/DxcHP5LHbWbjoqp8z1XblYa34elVrl7tIfJqX17gWCGuDtTe1gD3qa3/5JpW4rrJ18PJ2nYa3UpgKwUKOr4tJ53CTad0+5MnsocAAggggAACCCCAAAIIIIAAAggggAACf6RAGqRMmVyTy2keJzUKxkqxgpYojLVGIYbg68f2X4uvD/7O7WaPOnletfLa9qQL9+FfXnNyDDKMyWJmf+Rn8VqefqwQd/qb7/QlyL3ZXOtPMtwLMxLTytaRTlxfR9e6aD73GuRqJ24T3TbtG0ZGuZnEVSo2BBBAAAEEEEAAAQQQQAABBBBAAAEEXpVACnAloGuGJyW9lS1oeCtxrItOwlxnap2zdNvhQXbRrdbbYX2u2xnN+7IetLqpRuH6uvF04b6qj+TVv85Lhbjp198x2eqaye49uJcmczc2moMay0Wr3Q5W1rjLm8RfbpEO3DS+rV0cqVpB70mhb/MszhFAAAEEEEAAAQQQQAABBBBAAAEEEEDgjxJoErfJuQa4Etymc6lHsGYcfPB+FHZdb/Stem70/fl8dm+uKKrOuU5djLZq+d0sZvZHfQCv/8kvFeLeuNEEsCsHjsv3tOpWon6pU5AR7ViYQr4dssnad02Aq6vhpVoFWeSMcWylYUMAAQQQQAABBBBAAAEEEEAAAQQQQOCVCEh0K6HbZBBXa00zDXCl+1aiXBurIGUKWci823Lr8ero57OhfGxcMR6PxnY4v2CXHywT4L6SD+L1vshLhbiyqFmzfUMvlidXJMBtz0VJb2NLpm5t7ZzM32qO26T/sq+9uBLgarlCGsfdfyI7CCCAAAIIIIAAAggggAACCCCAAAIIIPBlBXS4UjM43TTOnc7fSoVCrCXEreU2b3fcg3jB/bdi2H7Ubc2Ms6xdPR526ns7qza7kypQ0wtwdnIFXirETZ248l7u/vPd/UXOFiS/TW9PJ3FrCWvPuy1J+LUIOUuzuJrbTgJcSXaZxj253wWODAEEEEAAAQQQQAABBBBAAAEEEEDg9AhoeJuGJ/VSUjevg5Q6hRtDpitW1fK38d7tuM/DjPt2cd7+0LjWXultrQuZ7X6wWP/Nrb/RDI/tFAi8VIh7Q96Q9uEac33/rT16pLt7ptNrvjTBSYQrM9ryqGb0VksV5Nsjo9wS5qa8twl991+BHQQQQAABBBBAAAEEEEAAAQQQQAABBBB4aYE0PKkBroRvIUhkK4WnGuJWQWoUogvjuONmqm+Fhb3v5SFu9kxRjcqufTz32K7cksIFtlMj8FIh7p39t3VX9u4Z87tPjJuddOJaSWhdFYu8jJLhylyuTOWm4DYlujqEK8+RIJcId1+RHQQQQAABBBBAAAEEEEAAAQQQQAABBL6UgE7d6gxlGqDUpcwyKxGuDVUcyRRupfOVdtM9CAvVT1rj4nEnzoy0RiHvbVf9m30r95PSfSn4t/OkY4e4N2+aeGPNxJX+8zGsNGzEkRx/LDsxj4UrLxcb+qXJ9NugLbgp59UAlwz37XzM/FYEEEAAAQQQQAABBBBAAAEEEEAAgTMjoAGunCSl07xN92UxM03j4ljqTiu92+3Yh/lF+3/no/xzCXsrDXA7F0b1klmqs4wA97R9F44d4j77xpbfX05p/dX9OzTGNaZolfoF0nFsyW+lArcZwZXH7of7+zv6eDYEEEAAAQQQQAABBBBAAAEEEEAAAQQQOKZAmsBN2VvK4CTAleIEY2WFKjlltZEA1+/Gz+Oc/U62YH/Uy1t787ZMPbj37y9ac+tJSHfM38jDToBAedxjuH3bZP2+ya5IJ+7K4pNO3KeeX0idgimD9c7KCK43RSaTuZn+b0C+vxLaU0/gCgIIIIAAAggggAACCCCAAAIIIIAAAggcS2Aa4DYlCrKImeRvXsJbOaUaBbkml7teenDjueF3XZ1vtMuiquzAjfKRu/7BVU+NwrGkT9yDjh3i6pHrwmbTbU12ZuT0UE6X2pLgW5m1dZ2Y1bYuuv5f/TD+u7JtunKP9OFOEn7pyNUxXAJdQWBDAAEEEEAAAQQQQAABBBBAAAEEEEDg+AJaniDTtxKvxczLhUS2UXpwpQu3lhoFDXOD8dXn9vemP/q4vV087rnuMDsvPbgfXK2+bqT69JZ06LKdSoGXrlNYlbepy5qZtTXjFpbilfmrcdfs6C1pKyTKDXN+PVby5ZHEVtbFa/o5UlmyNHDo140NAQQQQAABBBBAAAEEEEAAAQQQQAABBI4roIma16hNg1zdtEQhODnXGVyJcWVRqlBv1L8v/9T957AVH3TCzKjojup2PaiX+gS4x4U+qY87doirC5uZycJm19dN7C/25Xtzz/iBiTPZXErxYymPkeYN+b8Ap0O3Etj6TP5nQC71fwlkAjel/YS4J/XbwHEhgAACCCCAAAIIIIAAAggggAACCJw8AV15SmPclLFp1pa5FOMGWcrMmlpGKL3bi4/iOf8PJve/WZid3ys7lfTg9uzDwUMnf17PBO7J+1Rf6oiOFeLud2VMgtxV+RU6jdssbvapdCbLvG1LvktWvkoyihu9c9LF4fWLJffIGnl6TPplaza9orewIYAAAggggAACCCCAAAIIIIAAAggggMCRAhLepsHINIUrA7c+ygClRLlWChS0RsH5od8Mneqb/vz4e9GWO6W39aDVtbvVrvTgXvd0mx7peyruPFaI++w7WZEbdGmzew+ar0CYkZxWhrZNOY6la/swb7a8DHSn/yGQouXJBK48Q/6fQKdx9X8N2BBAAAEEEEAAAQQQQAABBBBAAAEEEEDgSAFZWyqkGgUdlEw9uLqQWWaD9uBaiXNDtDJL+U/hcvWjtu1s9IwsZOYr15nZs8v/ftkZGcrcH9A88jdx50kWOFaIq3H/7dsS2OqpL6dFk61dNFm58UmzRtmGLHLWlq+RlVNRS4mCRLo+q+QrJiveaZQr/0RBv2my0/ycZBWODQEEEEAAAQQQQAABBBBAAAEEEEAAgbcvIBlt04ObFjOTGdyQljOTCDf14EqNwrZ/YBbcdyXS3Zhtl3XR69SdCx3pwV2y5kMZrsyk6JTt1AscK8Tdf5ca4K5JgLu+lvX3bzTmQi/EwfS6dOK28rYtLsTHUq5spQlXgl7N+3P5wmTyxZP/NqBOYarFJQIIIIAAAggggAACCCCAAAIIIIAAAocJaHzr5SQ/GqhFrS+VKVzpwJUeXInbotvz0oPr/q9YjH47W3aGpe/Uo2Ddptl0KcCVLO6wF+a20yfwUiHuHXl/q/LTLGr25M0+lt2Zlgza6sJmRTsWpgzSy6EFCzKJqzPfEuXqFK6Gt9rhobO4bAgggAACCCCAAAIIIIAAAggggAACCCBwmICmZ17StKYHV/aNkx85j1KjIK24zu/5Dd+t/t5fGK8WVbadjYuqWzqrNQp903dUKBzGenpve6kQ98aaiSv9laiLmq2tGeMWllIYuzAX42AwncWV7NbG4OtYyYJm2tkho7ga4cpeOqXz0yvGkSOAAAIIIIAAAggggAACCCCAAAIIIPD6BJ4EuEZiW6krlShX22+dTOBKfanc5mPlXf3zeKn6QdvFjU6cGWVZuxpcvVgvmaU6u5UWQnt9R8grv3GB8ji/MYWwNyfDs7fTomZxzazJkG3buIvLsTN8ZEJ7Jsr/B8gcd5Sy5LIu58MDs5dV8qBz8ju0VUHz3CiJrtzPJO5x3HkMAggggAACCCCAAAIIIIAAAggggMA7JaABrv5ReypRkFFIXbjMSWWpLGVmxjKFW8t9vn7sfp//u+qb+UbxmcS7VeHHdd6tq2sfX6izOwS4Z/Eb81KTuFOAVdnRSoXljeWU7D56JKlsuwlmpUsh5rV8uYZhL8g2GcOVBzSTuE2rwvSVuEQAAQQQQAABBBBAAAEEEEAAAQQQQAABEZhO4DY9uDKFq4FtDBLfSg+uLGVWSbrr7a79zCz478YNs95uZeO5c3m1l/Xstb++pgGuR/JsChw/xJXxWXNbKpNlW+k/P0kb6t0YpRe3HTuhcKU1F6WXQ/+fQDaZv00/Wrgsc7jy/ZtM9eqdbAgggAACCCCAAAIIIIAAAggggAACCLzbApMJ3BSbBaHw0WvzrSxmJicpLR0GH6wf+o3Ys9/MpAc3y1t7c0VR7cliZua9R7UuZPZuE57td39oiNskrZq2Tk6pAeEAxJrJ1ta1TsGY9c1P02Voy/8F2BjHTqtwtZ0jt3nMU1qr07fpK9ikt+nl5akkuQdI2UUAAQQQQAABBBBAAAEEEEAAAQQQeGcFZAEzTc+kCkGqFHST6VudwLWhiiONcnUa11b2Z25+/MNsN2wsZPloPBqzkNk78pU5NMQ98r33m2lcrVOQXlyzuONSGCsj3TGUJraK6Fv6ZdP/KWj+AyCFvPqaku5qmquPJ8A9Epk7EUAAAQQQQAABBBBAAAEEEEAAAQTeAQHNyLQ+QQKz1GUrXbhST6oLmQWZwa3jOC1mJiFbtWE/NX82+Pt8VDxq92ZGg6JdlVlZsZDZO/Atkbd4aIirC5k1Ue0XI9w1d1MvrltYipdmQ5w5Pxd0Ele+cWFkKx/m3Y7se5nlzTW6lVeSBc2yIDtyU7qFIPeLebkHAQQQQAABBBBAAAEEEEAAAQQQQOBsC2hCliZvJSRrLiXAjTJ9K6OR9kmAK5Hbrn2Unw//pdgt75/v9UatQWXb9aBOPbi3WMjsbH9Nmnd3aIj73BtPEeyBW6UTd3f9etQg15h7JgxClNFu6cQdxFhE6cWVymXp6ZAvnU+BsNTianSrAW6KcJtJXELcA6TsIoAAAggggAACCCCAAAIIIIAAAgi8UwKalUmolqJcmcCVPW+cFCk4ydRkCtdIZ2m0Mib5MPTc39lzuz/oxHJ3MKiqlm9V1z69Rg/uO/R1OV6IOwG5Pbm8I5e6uNl1CXLrjeXo5xdTIBs0vdUqBVncLIuyvNmVbEuql22WSaPC/vStRrlpYpcQ9x36ovFWEUAAAQQQQAABBBBAAAEEEEAAAQQOCKS/Z0+JWbOQWZAULWR1ppO4VmoUNGMbyehkr/qWmxmvtnz+ONp8nM126sUPFmtzx4TJ8OSBF2X3rAq8VIirCHfu3DE31uQLtr+tyd6nJszIN0+mcYdmaGIxjnleeC/Fy7Lc2XRlvLRKmsmaiVx59PT2/VdiBwEEEEAAAQQQQAABBBBAAAEEEEAAgTMvoHOQWqWwX6Mgs7fSgyvFpLqcWaUTuZK++WrD/au5PPxxqMJGO8yM8plOXYy2anNz/6/fzzwVb7AR+OIQ90BM+yzWncniZtPbf687GxsmdGLstXoxlp3YDkVtZs2nsuCZ/M+B1OFqQfPkNeVSaxX0i3rEb5m+OpcIIIAAAggggAACCCCAAAIIIIAAAgicEQFdQypkEtLKzK3uR2nA1elbrVCQEgUpKK21WMFKgFss1f+53jUPz+W9YV516nZ9sV6+tKx/9U6mdka+Dsd9G4eGuJqwHvUCN566s5+u+d4F+cbNBp3ENWZsMlfafDauB/3fg1SgICPe0ozbPFUvmii3uc45AggggAACCCCAAAIIIIAAAggggAACZ1lA8rAYJcCVyFb/Ql0DXB909lZCW61SkOlbm41TD+62e+Bn7T9YM/pNJ5/fa7vatWcv1tfOy5zurWm+dpateG/PChwa4h7Zp/F0gpte76vp/LHxna3YLaVXoTCxVUhBrg0juUv6cWUOV+uZU4SrAbH+Bq1VmGS6zx4V1xFAAAEEEEAAAQQQQAABBBBAAAEEEDhLAvJX6RKGNcuYmUzC3EmFgs7fOpnCHcdhkCXNpDphEGbd3/tL4+91Wxc2z2XjqiM9uJMA1x+Z250lL97LUwKHhrhPPeLAlZs3TbyxdiMlr6trq5NpXe3ENWZhbiHOZudkzbyBfAc7IeTSzXExbsn/KVjpTZDbUoj7VG7Ll+4ALrsIIIAAAggggAACCCCAAAIIIIAAAmdVQDMxDXA1V5MGBZ3HnUzf6u3WjCXItXKXrx6539mFvZ+2d8PG3KBTjd3YPZ57rBO4BLhn9dtxjPf1UiHuwddb6a+kMLe/2I/u4rX46JGM3OriZi052VFsF1KEK3tax5wF7b+NafpWFzbTWgVmcA9qso8AAggggAACCCCAAAIIIIAAAgggcGYFJLyVLCwFuBrh6qijnGsXrtf1pGQCt9Y1zuyG/33xp/X/0Rq2H7R7M6PKPnLGLFd903cMQ57Zb8ex3tiXCnHvTF56VS7v6v7vPjFuNsTHsriZn5sJnV5Xmjz0i5nV5UL2eXChbn6RBrnpq0qQq25sCCCAAAIIIIAAAggggAACCCCAAAJnXUDDWxlwlKws/cgUrvbfeolyZRpX9irjgnfb4UHs1d+yxv8mi91B4Tp1/sHXq+VLMiB5Swck2d5lgS8V4hrzdIzrFpbilfkQL/SkzqOOca8epl7ctuk6N4p78j8LstKeFOFKhCu9CjKhK19V+f8GDXTfZXzeOwIIIIAAAggggAACCCCAAAIIIIDAGReYDDSmADd14UpkKyFuKlSwuqiZZLmjuCkLmX2zXhj/YKE1sznbbY3LbK9aMqYmwD3j349jvr0vGeI+++r3jB/4eCG/EGQAN3RneqFtOqGsu+O8G38XqzjO5DdpgJsGxieXqWPh2ZfiOgIIIIAAAggggAACCCCAAAIIIIAAAmdDQEcYm8XMdLQxSGIrNQoyV+tjLYmZlzDXZZUP7tf+0ujjdt3ZyItO1dup7bW/vkaAeza+A6/kXZR/zKukXlxZ12zNrMXSlHFjtmXmTQi9dh6lySNkRazMbFgPe4X0esgk7uRLq0GuTuMyifvH6PNcBBBAAAEEEEAAAQQQQAABBBBAAIETLKBJmPx1uszc6p4M3EoaZqU+QRpw5W/Znanldm93/IN4pVpt7YbH7XY+7u1Zu/Deldp8KM9hQ2Ai8NKTuLfliTfWbkRJblMVwqpZNbq42Sdyux1IL253I8ZqTv5rwYRWJYlunY3kkVqmoEuaNQPkRv6/obmNOoXJB8EFAggggAACCCCAAAIIIIAAAggggMCZEZgEuBrEZqn9NlUopMnbUAdrRhLvOrftHhrpwfWt6rd5d37QKrt2WA6tKLCQ2Zn5KryaN3JoiKt1tanBVmLXZ3/NzZtNeKu335EfncbVxc2uLbh4dd7HuWw+7Jk9qbwdBfmvBpdfMdsS5er/HMh4rpEYNxUx6+tqjKvbc78j3coZAggggAACCCCAAAIIIIAAAggggAACp09AMi+db5QAV6dwJxUKspCZDVKeIH+3PpapXOf23KMw4/7eSA9u13c2Z2173HHj+tqn1Cicvo/89R/xoSFupjOzsgiZ/nrdf/YwdBpXtxvys7q2KguWNdvv5cLPybezI4ubyf83RPlK+lEtRc2Ze/IiuX6RddtPcafP5xIBBBBAAAEEEEAAAQQQQAABBBBAAIFTLKCBl/Tepr9CT1O4qffWS42ChLimikOJdW0Yh70wY//eXhx9N/j249n6/Lhzvqqvzl2tsjsyucuGwDMCh4a4zzzmkKu3zZ3+nUl4uyL33zXL7y/HxYvy3wlD6WiuTJQcV5uaQysvbHk539SeDw1um9XNdPpWyxWeD4gP+WXchAACCCCAAAIIIIAAAggggAACCCCAwEkXmAS4OoHbnGQe12toK/O3LozjSPIxq8O51efu9+ZS/ZP2bti4lJ0bdWbP1f96/0plbknUy4bAIQL7U7SH3Ld/k3wDdVGyp7fbJpM+XAmBV+QnLW6Wf2Zm8r9Y7OR2Y6bjd8u2qYqubdXvuYfxf2m1s//ZtLKZvJ21TNt081bs5a18NitNR55+rON4+gC4hgACCCCAAAIIIIAAAggggAACCCCAwIkRaHpw5Q/VZQ5XwluZbwxZHa0sY6YTuJX04MpWb7pPsw/G/ykL8Rcd39r2oRzVlx6M+zf79rC/iD8x744DeasCh07iptD2wGFNqxUO3JR2tQ/XyMJmq3JttDiK2ovrB9LKnIUw056NsZT01web98y/hjp9UeWl5eurY+WTuoZnX5PrCCCAAAIIIIAAAggggAACCCCAAAIInDqBVKMgE7jyp+kpwJX6BJnAlQhXJnBrI3+3LkW4u/5zM2e/JTnv/zNbdvaKelwvm4Wqb/qOAPfUfeJv9IDLQ3+bth5I/vrUl2c6K/vMRG4T5MqrrF03pm/ip59+amQ8PO7t7Ul9cxGzVmn9XLVutrOq3Wvp/0D4LBXiyrk8bfqyhx4HNyKAAAIIIIAAAggggAACCCCAAAIIIHDSBaYBrs7iykijhF6yRpSEuDbUMthYSdLm3W74zPfs/5mdH32vcOc2Mz8al75VmavSlXvrub+BP+nvmON7wwKHTuJOw1vJWvczVp3GfXYi944crJ6m29qaMe7iNfnPBR9iS3txTWjJKVRhKF9e+X8IOckwecqI03fzmUR4+kJcIoAAAggggAACCCCAAAIIIIAAAgggcBoEmszL61+fS9ylyZeVxczqNIVrs7HcFvwwbMe5+jtubvejMNCFzMbjVnGt+u0Hv601wH02czsNb5tjfLMCh4a4eggS5B56JNOA97bce2PNxBtyubpmsruLd/ef4GZDnJWVzeS/HYJ3LZ8WNqviQOJcLWeW5cxyvpyH6nIjAggggAACCCCAAAIIIIAAAggggMCpEdDQVk4a3soMrpcaXC8BrjVOJnGrONYFzWRJs8pZ9zN3ofpBu5rd6Bb5uDPbqa/umHrl5oonwD01n/ZbPdAvDHHlqLRP4blR2Wlf7s2baZQ2HfzKN4y5Lj/N9om5Mi+tCW0TezMzoS3/2xCGfpRfyB4Fl9X6GLlXniytuIe8/uRFuEAAAQQQQAABBBBAAAEEEEAAAQQQQODkCjQTuGn6VkNcrVAwspCZ7DmZw5UAV2oU5G/S68fu99ny6JvZXv5Z2+ejBdOutkZbtflbQw/uyf10T9yRHRXipoM9WKmQ9p+JdVfXVrO7/9xM4fYXjRQ0L8X768Zs1zHu1nsS1xrJcwv5P4ewJ19op+O6UsyQfuTLzYYAAggggAACCCCAAAIIIIAAAggggMApE5CUrJnA1RBX5hXlD9IlvJUfr4uYeVnOTG/1e/FhmHf/ZbwZ758resOi26mH5dAuX1q2DDeeso/8LR/u4QubPXNQB4Pc6V36RdNv68qdlWikC9fINK5u9Ucm1vM+Fjsb4eLcUqjG41CG7vj/Z+/emuM673PBv+869BkHgqQoyLTMJJzK3ti79uwqTu2qXA2rZr7BFH0/N7mYLwHycm4zV963O6lUjKQ8OzpkaseiKMe27DjyIbEYK5ZtWaJECSfi0N1rrfc4z/9tAKJkSaYkkECjn4Ya3WgAje5fH1R81n89b9Zp3vZN+M+5zjKMieP5jUHf9BtHLQzpK36iAAUoQAEKUIACFKAABShAAQpQgAIUoMApFkBsq6UDV+ItrAGFAgUpUQiYxPU6LWYm1QpuGLZ8p34hX2i+23bFXo4J3DKv7KX/ctmoryMa44ECn0Pg907iSlj7O1sGHspd08JmKyreeeWOuvOKUjKNu7zn4mBpHgua7ceW6XgXo/E9+z5qnS1u28HflCj3d+saPsdt549SgAIUoAAFKEABClCAAhSgAAUoQAEKUOBJCkhDKIJbxLQIcBHkIsBF/60EuKkHN1TBB+fH/oHvNS+6gbnTMe3teVeY2jm33+w7dQMRMDOxJ/mYnYm/9XtD3MN7eRjmptPDJxrCXFncTH7m+sr1eB1h7mvqNeWWrkRf4fmMxc32zdh3bWlDoyrpUMD4bYYRczTuTrZXyOnh3+ApBShAAQpQgAIUoAAFKEABClCAAhSgAAVOpUDasTzlWalCAYmWVCikGgWZwA1NHKdIF724yGv/yc8Pv9NqwnYss3rca5vi/J5hjcKpfGSn4kY9coj7qPfm2v1rCGXfVH4QY6hjXOz0nM2izZ/Kd6LTjUaZgozgYgZXktzJk/5Rr5w/RwEKUIACFKAABShAAQpQgAIUoAAFKECBJy6AGEtSLJnATecwoogpXCRbFpekhcywEpSRYLd53/xa/5F5rmvn1ztFv85d27TMyPzo9R9ZfRPTuzxQ4AsIHEuImyoVDv44ShWUefpqdGO0N3cwidsMUakQfWhcVV7UOwHtIJmWP5ti3IChXD55v8ADx1+hAAUoQAEKUIACFKAABShAAQpQgAIUeEICqTrhoEYh4FShRAELmaUqBRPrgApRJLza7br39B/av7Yb6l4rZlWVGdteXDSXFy7br6993T+hW8s/cwYFvnSIewsoN27IVO3kILUK6u5dZUeTEDe0sF2iULEVuy5UcSdtoYhIcKX7+WALBs4d/f7h9fCUAhSgAAUoQAEKUIACFKAABShAAQpQgAKnQEByK0my8J/M4x6UKATtootGWd1IqBuGYSN27Qsh1D9f6reHuW415/OyWVbKqFXEvTxQ4EsIfOkQV/722toaOhI+PFTLK/HSvI8b9VYKZ8f4Vlnkdf4V9XNf+SG+xJNee/wSipxxlK0ZPFCAAhSgAAUoQAEKUIACFKAABShAAQpQ4LQJSHQrHyrlV1Kh4NB9a1OJglVGUt2wHzZj3zwfz9ff6enOzmjUNGVeNff27qUAV9aYOm13i7dnugSOIcRNs7gfu9evqXdwyWJ3Maq5ybeCicGNnUziOjy1Y1qxTwbP8SLAkSHuxwT5JQUoQAEKUIACFKAABShAAQpQgAIUoMCJC0j4iv5bmcDFqXxgKTPEuS6YYHCp90O/HXvmBdtvXs7q9oO+zeoL/ba5t3fJXPuv1xwD3BN/DM/EDTiGEFccHm7FVUoWN1s+h40SWNxMvtst0ajQaoXyotpFQ0iFrRUIcvE5aIySH5QqyHQuDxSgAAUoQAEKUIACFKAABShAAQpQgAIUOB0CMn+L2DbtSY4cS7IsjCUi18Icbgpwg4sNvv0ze676bhlaW2304I57bbNTXTDXvoGlzmRNKB4ocAwCxZe5DnkixlU8F2UYd0WhGWFyuIOTK7/Fp4uTr4N04loVnS1GxTm9GZ1extpmXZk2x0dUGQoVJiHu0XVMfpOfKUABClCAAhSgAAUoQAEKUIACFKAABShwAgJp73EZPtRIr0IKc/EVljNDB66Vfc6Vd7v+/ezp8LIyvY2O03XURaO7i80fdtGUywqFE3jQzu6f/NKTuOkJuariGqZxZR5XjtdXENguXYlujOd3C1EtFjdTeTvmWeHtKG4HjzX78AqQ9c1ki8bBkVsmzu7zjPeMAhSgAAUoQAEKUIACFKAABShAAQpMk4DsXn6wFzmCW9mbXHpwra6VjTW+6cIorKuBf9EUzRu9sj/UnXHdXqzMj15fs/om13+apgd7Gm7rlw5x053E/OyNuzfijRsPVyK8qS7Oh9jT2FJhEOQWTew0nVH+TPznUEVZ3EynbRmywBmqFfBTskofg9xpeNbwNlKAAhSgAAUoQAEKUIACFKAABShAgbMrICOHUp0gazghwA04F110WMTMhBoVCtbvhQ9Cx/xtPDf+Tjf2HuSVa8rOs83yynLz9bWvS8bFAwWOVeB4QtyDm7S2pvQNnL9zd1Kt8N59ND93ZMMFTlU75Hlp41jt4JKQ5VKigJdAVAhw0REStEsTuQfXxRMKUIACFKAABShAAQpQgAIUoAAFKEABCjxhgRTgSl4lQe5kGTPM3qYAV41x6vzY74S+edH0q5eDKTf7vqnbC41ZXlGN+noKfp/wTeafmwWBYwtxb0Hrxt3JJO31Q7llhLcNWkNQp9AqsFpfg7D2nCxuphqZwpWPdIpV/ZDmWk7jHsLxlAIUoAAFKEABClCAAhSgAAUoQAEKUOAJC0wmcFGVgMzKIbRChYLEttpEE6tokWi5WDlr/zHOm++UIWyd13NVmZfN2++9nQJcLmT2hB+xGfpzxxbirq5OAlzpxJXD1aevxksjH632oTcYYNg2Td2GzOlxeUE/QHmCvCBQDa09unHlReHx9STanVwFP1OAAhSgAAUoQAEKUIACFKAABShAAQpQ4MkIHOwxjoFDLPIUJanCBK42GFAcB4MpW+RYzZZ7p7hqnzOV+2BRXRiNjDW/3blQX/vGNccA98k8TLP6V44lxD16kiLIlWncO+qOunv3rnLnLkdfxbhr9vH8VwhymxBVEbyUKgS8EGQMd9Ix4mPqxmXp86w+EXm/KUABClCAAhSgAAUoQAEKUIACFKDAiQmgPiFlVAirkNVKlYJTXiPExSJmJkqAG/wwfKAXw9+bPXv/6e4kwFVqu7n2DczqapSG8kCBxyhwLCFuun1Y3OzDw3VVLa9E9du3lOtPFjcLZhzxxI+lyk3e0297GUOfTN5iAheTuLKomcaRi5t9yMhzFKAABShAAQpQgAIUoAAFKEABClCAAo9XQAJc6cCVnEqGDbGEWZrCtQHxbTT448GPwkbsu+fKC+a78+3B7njLGnN+qb56/qplgPt4Hx5e+0SgOFaIW4hhV5S+fvfgWpeuxPvt+7F6EMKg3wsjXYdWXjTjgbkXHqgq7+Y+2OB1ho8c+W38SBJ8rDeNV0YBClCAAhSgAAUoQAEKUIACFKAABShAgY8IPDSBq1D3iTDXYVdyTOHiaPQYc7kuDMOW75nn1Zx7uXDdTb0/rEP72XplVTHA/Qgmv3icAsc2iSuVCreULG82ObwmJ09j/ny0HEMvxtFopNqqg0YRNChUcYztGHXaqoEtHHqyvBleFzKxnqZxD66FJxSgAAUoQAEKUIACFKAABShAAQpQgAIUeAwChwGuSlO4mL8NaQJXO1SANrEKKFjATG6D2tsfxfnmFfTibrayfBQuPVtd/TNEvKxQeAwPCq/y0wSOLcSVP7C6ujrp/1hR8dp9hLEPJJC9pxYwcNsd9LEhowq5a9lyQb+vF9T9YGOtsbQZvoEZXPThTgqkw0GtwqfdZl5OAQpQgAIUoAAFKEABClCAAhSgAAUoQIEvI3BQoYAmXCRTsowZzlmZwA1W1Ti12GXcmw33K/U/med1VXywGAejtqvNFaUMsiseKPBEBY41xJVbvnZ48xHkKgS5bs/F++MQ97C4GV4dQXpwi5hVbj9sRtmygRXNEOTiRH5xEuSif2QSBh9eF08pQAEKUIACFKAABShAAQpQgAIUoAAFKHAcAjJEKO238hElvNUWA4YIcLGQmbTgymdc6h74d7OvNX+T7ap7C24wGpXGbg22rLqZhhGZXR3HY8HreGSBYw9xb9xFACvHGzgiyB2rK2EpvxQ67eDxyggo4cUWjXxcXo7/4uswRAvDJMGVpz6qFOS/dPLId4E/SAEKUIACFKAABShAAQpQgAIUoAAFKECBRxCY7AUui5jhKM2eWNTMR4cKBRdNaBDl1hqhrt8PH/iuf87E8c9V0x52M2v/uHehWVldsVIp+gh/iT9CgWMVOPYQ9/DWra1NBstXljGNew5HtCZ0Wn0fTOV1U5hm3+9KWitLmqXtHnI+xbgS5eKDBwpQgAIUoAAFKEABClCAAhSgAAUoQAEKHJ+AJE6pzlNmcZFLpQ5cqVBAkGuC0bUsaub2/YbrNM+p+eF3W3Fxu9cq6739PYOb4diDe3wPBq/p8wkcb4j7CX0grykscfbbt5Qsbhaa/Wg7XZdbZctzcRfbOuQFoA5eAKlsAdsy8GJCrQIPFKAABShAAQpQgAIUoAAFKEABClCAAhQ4LoHJFG4KcbEfuE+9twhtUaOAEgVVKR9cGPrtgAA3ztvb82ZuY063mr2isVdGV6y+ybzquB4KXs/nFzjeEPehv59qFfD1tfvXolu6En2Fjuh5FEXbUfSZvFCKUbao1/GCMdgKojGqjuBWe2wGkQB3Uq7w0PXxLAUoQAEKUIACFKAABShAAQpQgAIUoAAFvoCATODKQmaTKVwJcIN2UqUQkFCFJjTpvFUja8w/hbnR9/xQbemyVUsP7n8aXGqwCBQHDr8APH/l+ASONcRNnSCreFnIEQdZ5OwOPpR6U/lKJnGlLTqGtgS1Lm9CGd/0dRzhB3CJrAQ4eTFha4i8uFipABgeKEABClCAAhSgAAUoQAEKUIACFKAABb6wgCRMUp0wCXAVwlykUsigMIGLz02s8NnKYmbemtf0H9TfykfZxoV8oe4gwJUeXORcnj24X9ifv3hMAsca4h7dpluTPlyZxr2+cj2abRNdH2UjHbxkcIiFiqUuGtUKvw0mVLgI2z40JnJRIy1VCvLiwovq6Pp4hgIUoAAFKEABClCAAhSgAAUoQAEKUIACn09AolvMEyK2xSnSJlnETKJbi0sdhg2r6HAeMa/b9e+GBXdbjbvvt9u9qrHO7VQX2IP7+bz5049R4PhD3MNe3FVM4q5MwtxqeSVenEeIi17cWGLqFi+PXl764pxe900cBWz/wBzuYXgr4+nYKoKvJ7UKj/Hu86opQAEKUIACFKAABShAAQpQgAIUoAAFzqDAQYCL+DZoj6D2YAIXqdRkObMaKzU1crl94N5Vl+2ft7S62yt6Q40e3OyZc83V84o9uGfwiTGtd6l4HDf8Fq50ZU3pG0dX/pp67/4zakFtKzX3tJJOBQytR6z6V5VLegtr+y1rrdpSqYBu3LRNJFOZVxleaFrlR1fDMxSgAAUoQAEKUIACFKAABShAAQpQgAIU+GyBowAXs4apCxfDgmi/RYA7qU6oEOAaZE7R7YVN1bcvogv354NOd1dbb/JxZZbfXbR6jQuZfTYzv/skBY5/Ehe3fnVVxcOFzeTOyOJmZh7ZbHcx9luYYUedQlTt0FKFs6OwjbX/rPzcwSxu1DEtcHa4yJl8iwcKUIACFKAABShAAQpQgAIUoAAFKEABCnymAELbVJ2QKhQQQUmRAs5L/63FeYfPTcAErpz3+2E9tu234mL1SifvPdC2VZd51bzxzBuGC5l9JjO/eQICxx7ipqLnw0qFh+7Q8h5m1bG42S6abyOC3Jg3sZ239/Wl+GNXx6HSMUN4ixeWRrNCqpvGqHva4sEFzh5y5FkKUIACFKAABShAAQpQgAIUoAAFKECBTxRI7bcpVVJSoSD7gkeHDxu9xuJlWI/JaalQCG4/bIaeeTHOjb+D6Hazp8qq3TTm0t4lc331Ohcy+0ReXniSAsce4h7eGalUUFjYTE7u4MMt4TWDxc16ktEiyC3ztnfjaH3XvRubOMaPZdg+Ij8uqwamrhLZeiJf8EABClCAAhSgAAUoQAEKUIACFKAABShAgc8QkAhJciQJkibrLsmiZqlCQbtUp2BlIbPo/Mhvx755QQ38Sx3f2uqG+RTgbjy1YW49o7zWmmHUZ0DzWycj8Akzs1/+huAFg1YRXM+tycJmShY4e6CyeyNVGPOgFeuyrfbydivPWqNi9FTcyf6vQuv/nLXyli51Oxax1Lkqs5YaZLlu47cfW9j85e8tr4ECFKAABShAAQpQgAIUoAAFKEABClDgRAUkwE1DgVKggPWWYkAHrjL4jCoFHK2qJcANCHLtvr2tnqn/So/yD8pMY7Cw1Vz9j0uV+lPM6TLAPdGHkX/80wUeSziaKhXkb65OxmjX5Px9lEWfQ+1tjVl2nLSK6GUaNys6zg/Ri+vRR4KXFdY2w5JneHnh09H1yO/zQAEKUIACFKAABShAAQpQgAIUoAAFKECB3xVIU7gYwpW5woBMSQJcTN8qnyHQ1VY1CG9RqaBc84H7lbravJCZYr3lsypr2kap7YYB7u+i8pLTJfBYQtzDu3jrYBJXFjlLlQr7Ck0KPnTawcsmkTG2kuQ+VPlX1b/4cdzDaw210tqiGRchbgqAJyPwh1fIUwpQgAIUoAAFKEABClCAAhSgAAUoQAEKPCyA6Db14EqAKz24+ECYaxHfyuSt8TiiYMG7Hfdu8QfN39gNda8sBmMdWk32zLnm6vmrlhO4D4Py/GkUeHwhLooaVg/u8RrqFK6vXI9X2ypUygUnvbglXla2ioVrebvvdwIulhccOkpwKi86jOsi1JUheFwNu0hO47OHt4kCFKAABShAAQpQgAIUoAAFKEABCpysAOIk9NimHlzJkSROQgeux6kNBvO3jcbXfj+sq55/Pmr/L0v99jB3zkiAe+V1ZfVNmd7lgQKnW+DxhbgH91sCXDkrlQp37t+JC0vLvq5dmsSVSgUfa6fPxx3pJMGQLl5kqXwapbo64CUkE7mykiBfTILIAwUoQAEKUIACFKAABShAAQpQgAIUoMChAMYBkR1hAFCGAJEf4TzKE9B9G1OFAqo7sc+32/eboWv/e1g0/1Bm/Z1s1G7ai4tGAlwEVsycDjV5eqoFisd661ZVvHHrob+wcl1hgbPwz/0QC5lvH8VQuLbPG8zituKb3sQLeTfMxZjhu0phS0l6ESLQ9SpPi5ulQPiha+RZClCAAhSgAAUoQAEKUIACFKAABShAgdkTkBIFmbqVvbkDvjjowcWp00YZGRaM1u/Fjdg3L5pe9Z2Bn9uK1jTtfjAX1JyRAJfrMc3eE2da7/Fjm8RNL4KPR67oxpUFzpZyi9XLdoOPw+CztJVkqJ8OP/FNHOoMH5jBlRchglx5QXr5xD6FaX2K8XZTgAIUoAAFKEABClCAAhSgAAUoQIFjFpDgVuZwZe9tWVspLWSmsXwZ4ts6jhE6eV/FXY8AN/Sq231bbPR0Uy2pVnPhjy7U6ABFBYNm3HTMDwuv7vEJPLYQV25yejGsIoiV4+FhRUW359AoPcDrqRcwfes7trSox92LDttKUpN01HgZycekyUSqFeSFyQMFKEABClCAAhSgAAUoQAEKUIACFKDAbAtEqd6UABd7bsvwH0Jcmb9NNQoIcGMINjRx31r7T2p+9A+6aW33W/N127TN3vk9o/405U8fZlWzrcl7PyUCjzXE/TQDt3QlDlQIbg51Cp3gMkS52XzYLs7rrSBdJmjExXaUFOIiCk5BLjavMMT9NFBeTgEKUIACFKAABShAAQpQgAIUoAAFZkPgIMBNE7hSw4kQF/UJaMENjUJxp3KYGsSyZeaH+tnqb9w421jqzlVV4awEuFfUFZPmB2fDivfyDAk8/hD345UKCe9N5bvYTFKjJsGgtCRr+7YuKzfyO3jpOYlv0YebXpQygYutK05WEpTJ3DNkz7tCAQpQgAIUoAAFKEABClCAAhSgAAUo8KgCkgtJSqTkVHKjVKOQFjLD5G0VLVImxE3Nhv1N/ofmb1t7+v58t1c1o237h91zTQpwb6JDlwcKTKHA4w9xBeUWmhUeOphtE5vMh/5iCL6HoXd0KRS2U+WXwo/dOOxJBW5wqM3F1hQpN0Gwi9UFo8fr1D90NTxLAQpQgAIUoAAFKEABClCAAhSgAAUoMAsCqT4B6ZBChULai1tKOdF/63GUCVynGkl33W54N/+a/Wa919wrOp2RsmUdLj1b4VtGM8CdhWfKmb2PTyTEvYUUV60gyJUjDtXySrQjTLxjEle+7hTdmMXofD/e83UYplH4VEiNl+XBi1RG4WUrC36cnSWCxgMFKEABClCAAhSgAAUoQAEKUIACFJgFgcMAdzKJixk/6cCNLnosZCbLmFnVIN4NYeg3Qs+8iIjp560wv58Nq6bQQ0zgMsCdhafJWb+Pjz3ElcXNVldX49ra2pHltfsqmnm83lCpoOaUGuND5a1Y2mKczen3go1jCW/RhiurC3qktujJTcdJL3mGJwAAQABJREFUU+7RNfEMBShAAQpQgAIUoAAFKEABClCAAhSgwBkVkPWSJBOSEoWAyUCp3nS4xEaHHlwbK2U1JnDxQ6O4Gbrmb9Vc/d151d/pd8q69GVz+d5lTuCe0SfHrN2txx7iJlC8ym78hxtR3VVRotw7+LhYXD7oIBmqdrcbSvSZdMtOHVvql75WYxnZxSJneJGiC1dqFXAeQ7jyYmWlwqw9S3l/KUABClCAAhSgAAUoQAEKUIACFJg1gYMF7ycBLto2ZeF7GfZLIS5OjW9igz23vdvz67Frnrdz+68o39rSpq7brjZvPPOGUWuSJ/FAgekXeDIhrjitYrMIDjcQ5F5fuY7zWNyswoC76ofYklci1hKsika14ttYUVB6TDKN+gSZxpV6BfxqOid1uTifrkuujwcKUIACFKAABShAAQpQgAIUoAAFKECBMyZwMH2LFEhyIJnGRX2CVChEi1WUUo0CLguhCg9i3/5ds1jd7vvexoIbjFqx1VwaXGqu37zuZQ/xMybDuzOjAk8kxD16wRwEuTKNK4ubnVu+GDpd7/FKDK1ceReiyRYw/m5RSY1DkGRX6qrxYsV1yOlRR658nwcKUIACFKAABShAAQpQgAIUoAAFKECBMycgiyh9mAFNBvxkrSSDcT804MYqTCLd2lrzI9sff2ewV276oa6qzNqL//PFBsOEDHDP3NNitu/QEwlxj4hvTRY2u4ELZHGz9+7fV6FBGzVCXI/1BAsMxGtfjlQvvhPRa5KCW0zhIr7FCxfrD0acwxFnJdDlgQIUoAAFKEABClCAAhSgAAUoQAEKUOCsCUjuIxFuCnLTHtoOM7jowVUOg38Gc7kS0Hq74X5VXLXPtVzng46eGy8tlhgKXGpu3cf3NSdwz9rTYtbvz5MLcaXkVg4rkyBXFje7hMXNQr0VexLidrGKoFQqOD/Kl+M/2VHYlZcpEl4roS2O0qOANgVcIi9iHihAAQpQgAIUoAAFKEABClCAAhSgAAXOmsBkeE/qNINERVjMDNkQkiApUWhwrsGF3u24e/kfhL+utuK9stBjmcDdqXbM1fPK3ryZ9uY+ay68PzMu8ORC3Ieg79y9kyLdGoubzfXnvOl4jw0seGWqULjS26HfDTZUeLliCldLJ25MU7lIcKXv5GBrDDtNHjLlWQpQgAIUoAAFKEABClCAAhSgAAUoMOUCEt1KseZBBy4Wu3fK4LNVRtWYwW0QHvmwH9djz73gffX6gm7t6b0WJnC3m6vnr1p1M03wTjkDbz4FflfgREJcWdjsjrqjrrZVsLkNVnssJhiDy6LvZKUt59V6PqfeQ79JJdtcJjUKeAnLgmb4GkmuhLkMcX/38eQlFKAABShAAQpQgAIUoAAFKEABClBgGgUk6UHvbQpwZfpWhvosTqVCoUkBLqKjsBffDy3zLTfffKdXdLe0bjXZM+dSgKsxgYshQOZF0/jo8zb/XoEnFuKmF9GqirKomRxSkItKBZnGbTIf3BwWNysCziif+6yy+3ETL1uH5gSdYlsZoJcpXCxwNpnKTaHu5Mr4mQIUoAAFKEABClCAAhSgAAUoQAEKUGBaBSTxkdBWmnAR4KL9NmD21qMH16BCQSZwcbnfjxu+Y5/3c+Y7A91ez4atpr24aK68jkldTuBO62PP2/2IAk8sxD28PTfufhjkKkzjmu27cf7CJd8x3rsi+jJEl9n2SF90P3MV1hXMMo0cN03hYiYXr1mM7EonikLEywMFKEABClCAAhSgAAUoQAEKUIACFKDANAtMAlzJeSTARV3C4QSuVCgEqVHARK7f8x+EdvO3cWF4p4ydTQlwy0sLzbLCT60hOeIE7jQ/B3jbH0HgiYe4k9s0mceVadxquYpuX8kmFgzhYi6+HVypi0r3wrsRZdV4DWapP0EaUdJILsbiZcvMZOsMFzh7hAeZP0IBClCAAhSgAAUoQAEKUIACFKAABU6hwCTATUkP4tsQJP2xyiEmwgyuxwSu7KXt9v0mOnBfjIP6lWK/2Oipsmr3a/OGBLg3sZ4SA9xT+NDyJh23wJMNcdNyZkrduHsjKkzkyp25du5auPq0iuaiDz28Wl2DFQYxjVvqcqT64R1scanSnZYXNCZxDwDkd2XE/vDrg4t5QgEKUIACFKAABShAAQpQgAIUoAAFKDAFAh8GuJMQFwGudtKBG702MoGrULoZxv5B7JgXQs/cbtflZj9fqNtNYy4NLjXXGeBOwcPMm3hcAk80xD3sxVXoxk134KBa4e7du8qNkdwuYpMLtru08eINNqvyZf1jj0oFLGaGoXqsRYgaBfyedOMi7pWx3IPrOS4NXg8FKEABClCAAhSgAAUoQAEKUIACFKDA4xZIbZkIdtKAHhZDcqhMmHThYgZXNbFKtQpWj51xP2r6o39o153NXneuqjJrL7qLDbIlTuA+7keJ13+qBJ5oiJvu+cE07qGCdORKpYIdIb2t0Xd7HuFsGWMn9p2r3K63eOEerE4onbiIbScLm00mcSdh8OGV8ZQCFKAABShAAQpQgAIUoAAFKEABClDgdAsg24lBSwcuch7M80l8KzUKMoVrYp2mcRu17xr7avEH9lsd29tQwTbVvrPF+SWjnsFPfixfOt13mLeOAl9e4MmHuB+7zWsrk5fdpXkft9R2+i5G5mOZK9+ZL9ezrno7yhYYGbzFSxsxLsZxcV6+4iTuxzT5JQUoQAEKUIACFKAABShAAQpQgAIUOMUCsngZZvhwCxHiRocW3FSfoKQFt1aj9HWQy/zP9Feqb+nt/L1OkdelbmyrPzJXVhD23kQ+xB7cU/wg86Y9DoETD3Fv4F5du38tvoPTxe4iJmvRniDluPKCNq09Xao3golV2sDi0YaCFztmcXHE9yXKZZD7OJ4XvE4KUIACFKAABShAAQpQgAIUoAAFKHC8AjKBK0N5kuvI9C0CXJQiGJx3oVbjYLHEPWoV7LZ7N867v9fj7P2QZ3WuW0156dnm8p9cNurraQ9t7pl9vI8Mr20KBJ54iJu2lDw08r4GpDv4+JPLl32T+dC0ex6bZEIZOq6Vhca11Nu+UaMDS3m5ywd+BGEuA9wpeIrxJlKAAhSgAAUoQAEKUIACFKAABSgw8wIS3srAHkJamcDFOVnEDBUKCHBlD2w5j7zIbbl3sq/av/S6+td+1h72y1Zd5vPN8nv4PgPcmX8azTJAcRJ3XoLcuDrZaHLjFm7BynWlLqowumfDxXbpO43W3o99VrdMvujuaxPX0ZDyjM6yQqfwVmeYwc1lEPdgfP6hWPgk7hH/JgUoQAEKUIACFKAABShAAQpQgAIUoMAnCqQAV6ZwMYGLGoXUeSuhrQS5RtU4Nrg8uJ1wP361+UvT2J+ej4NdFcq6FefMxlN37aXBChcy+0RcXjgrAk98EvcI9qHYNU3jvnJHXSwuB5P74FB765roXYgut1ntR2o7yuqEMmzvlNOYxJUhXB0R6XKA/oiUZyhAAQpQgAIUoAAFKEABClCAAhSgwKkSOApwpR5TAtxUozBZxKzBImZWGaW1ckO/pQbu77KY/bRf9HdjUYyL7lyNANesqRWnb2KVJB4oMMMCJxfiCvotpddW1rT04srBbKt4rriYQtzOub5vZdHnIR+rS+7Hdi9spFF7GbuXNlyNaV4muBM4fqYABShAAQpQgAIUoAAFKEABClCAAqdNQAJcmbxN6xvJKZYt84htZRbXxgbjeo0schaGYUN1wnNqYF9pxdZuT5dVu2nMpT2VAtybDHBP2yPL23MCAicW4qYahFUVb6jDCFepalnFt0b34sJFH/bVvopljJ1YmqwX3lJz8T4qFWRLTcA7QMpvMYQrbwacxT2BJw7/JAUoQAEKUIACFKAABShAAQpQgAIU+FQBhLMS3qYWXJnATQEuoltZzEwqFDCBix2sdRiFrdh1L5bnmpd1k20rZ+pq39ndfNeqbyjHAPdThfmNGRM4sRD30FmqFA4P1+6rKJUK98dYu6xR0RXRj/EqL0LWeLyoUaRg5GcPahQkyJ2sanh4BTylAAUoQAEKUIACFKAABShAAQpQgAIUOEkByWsQ2qL/ViZxU4CL6NZrG52WkswGVZkNAp3g9jGB2/UvqDnzUjHMttshq7RuNa3+yPzk/atOYy/sk7wj/NsUOE0CJx7i3rir4tramrq+cj3egYzZvhuXchs6be9tK/gCvbiZ7Yz0JfVTV4eRylSGLTlYyBBvBWmrDrbpcBr3ND2neFsoQAEKUIACFKAABShAAQpQgAIUmE2BDwfuJnWYkwlczN5KgQJmcOtgopFk1u+HLY0ANw7MtzuhtxVyPVatsm6PK3P53mVzYy3tfT2birzXFPgEgZMNcWVxs1VUKvyHG1EhzL2+omK1XEV3zkW3FEJPYasMpnGV9U0YuPvRBaMzlSO+VfhVvDGg1FqOk1qFT7h7vIgCFKAABShAAQpQgAIUoAAFKEABClDgiQjIuN3B9C1SGwS4mLn12qQ1jhDhIr5tkOI4v+fX45x/Uc2PX8qr/EHURRU7ZV3oYbP8vy83CgFuquF8Ijeaf4QC0yFwoiFuekEeBLmJC0HutXPXME5/JfoqxAftGFsIcfNW27VMOVYD9W5Ab4psi8EbQHpjwK/LaD7H66fj+cZbSQEKUIACFKAABShAAQpQgAIUoMAZFUgZjYS46SgVCpMOXPTf4iNWMo7nx2FXzfn/L+vbv89G7e0yz8bK2rplRmkCV32dAe4ZfXrwbn1JgRMNceW2H21ZwUTuh/flTeUHMfrmQZS5e+lJUbo9yp/yr7qx20UpLuZv0aOC+HbyzYd/98Nr4TkKUIACFKAABShAAQpQgAIUoAAFKECBJyCA4BYr0acAV7La9CF9uGkhs1jJ19jPemid+1GYb+5gEbMtCXB1M5nAvfwnlw0ncJ/A48Q/MbUCJx7ifpKc2TbxXOHCQM2HgGncNuZu53XZ+E685+s4RIDrgwsOI/geW3k8aq4nZdmfdGW8jAIUoAAFKEABClCAAhSgAAUoQAEKUODxCSDARY3CwUJmKbZ18lmWMVNNlD2qfWjiKDj3w9Yf2b8u9ooPykKPoyqq0o+bFOByAvfxPT685jMhcHpC3FtSczs5rKiV8NYIm2i6G7HfUnEfk7hVo0LHd/azvv6Nb9RYZm9lHhczuj7ic5A3Cy5wdkjIUwpQgAIUoAAFKEABClCAAhSgAAUo8PgFJMDFgJ0sPi9HdF9OAl3Ja0ys0wSuDU2w7ofqWbtmN917nSKvs2GrOerAZYD7+B8n/oWpFzgdIa7Et4d1CujFVVjg7GJRhyZbDF6HIL24RRZ9W3WGain80I39HiJfXCKFCijGjspiGtfhNx+qZJj6x4Z3gAIUoAAFKEABClCAAhSgAAUoQAEKnFqBow5cSWew13SaxpX6SylRwJpGMo0rl5kt99vsqv9W3PXvlrFXDU1dl5cWOIF7ah9Z3rDTKFCchhslvbhRR30Uwq4pLZUKdjlE9yAEp7LQzTs+2qbxA/eufgel1zGTmmx5W/Baox5bx0xpXeD86QimTwMsbwMFKEABClCAAhSgAAUoQAEKUIACFHhMAgho8V+qUfDSg4uZXOwtjTBXFqV3ymC3aW83/Vv519xfxe3wTqm6VWdQVoVdqi8pxLycwH1Mjwyv9iwKnMrAcw3SK//rSjjfwrQ96m8tqnFtHDmM2rrSlKNsoN7xJoyjDxLiOgzsp64VGdnHr3Ia9yw+U3mfKEABClCAAhSgAAUoQAEKUIACFDg9AlKjgOG6NGCHtekR2iKb0TZatOBiDE8WqbcP3Dvq2fovkd78LMvbw55uqla7bi7tIcBVmN3FUN/puUO8JRQ43QKnJsRNL1ypVUA37g2c3Hnljhr3r4T5Reu7jfcOlQotTOOq2JJKhe/7YdhObxQODStpPF+2+GgucHa6n2+8dRSgAAUoQAEKUIACFKAABShAAQpMu8AkwMWsnWQxQaJcCXMxe4sJ3NSDq5zbCffyZ92f2+B+0tatvW6OCdy55XpDXTTqGexVfRPL1fNAAQo8ssCpCXEfvsUyiXt95XpcuavCqFn2c/0lH9oyZluFNsqwfd/d83Uc4gKLtQ4Ntv24gy0/0rXi8OvckvMwKM9TgAIUoAAFKEABClCAAhSgAAUoQIHjEDgKcJG/IINJ07cyeYsJXOxG3WBZMx+GYUMN3N9Fa352PuvvTCZw55qLy6pZUUhyGOAexyPB65gxgdMX4mKBsxtY3EyCXFngzGzfjfdG92NPxeBM8HlsuY7r7sV2/FWo4whvDnh7QDcuirOxDSeFuRLoztjjyLtLAQpQgAIUoAAFKEABClCAAhSgAAUet4AsKT8Jb8NDFZdNrGMTquii9Xvhg9B2/z0O7J3S5juZb+rJBO5do+4jr7nJwbvH/SDx+s+mwKkKcY8qFR4KcqvlKp7Hxhy3EEK7H1zZjk432VBdiK+akd9WGRY0k7lbKVtJ/6F5RZY8k2XSeKAABShAAQpQgAIUoAAFKEABClCAAhQ4DgEsRZTWJULuIuN02iKStVKhgB7cWvpx/Shs+r55Ps6NXp7X7fV2bzAq8/JgAnfFSYDLHtzjeCh4HbMocKpCXHkAjl7MB0HutXPXglty0eXYxINpXG8xlh98nfXC2/mi2pj04KIIe1KmLYucyRQu8lxmuLP4hOZ9pgAFKEABClCAAhSgAAUoQAEKUODYBVKAi8QF0UzaHxp7RCsfTGiixRQuwt2wH9ZVzzynFvxLbdPaVKOyGvrGrPfWG/WnmN5lgHvsDwqvcLYETl2Im/hlgTM5IMhVqFa42r4a5hrr0ZUQdrHA2Vxoofc2M6hTeIBIV2oU5M1DeljwI5jEDYh2ZZEzHihAAQpQgAIUoAAFKEABClCAAhSgAAW+jMBkcC4FuAhuPXIXTOFi+hYBLo6ouUSAuxkH/gXbb15WjdrqFoPxsN+YP965UK+srlitNSdwv8wjwN+lAAROZYh7NI178BDduX8n/jrHeoYIcVut4Id4+2hbPdJPxdfMvt+QNxCdAtyACVzt8W0v1Qr4dY7j8mlOAQpQgAIUoAAFKEABClCAAhSgAAW+mAAiljQshx5cpC/YNVrWI0rhbRPRgaus2w/vx557Lg7MS4UpN8+15sYjY1OAq76BRcwQ4H6xP83fogAFHhY4lSFuuoEH07i38MV1dT38yeXL3mCDT2ip2O4ioM0GTd5v/TIW+t+w+mGN0BaRLd5K8PaSAt0oI/4oWeCBAhSgAAUoQAEKUIACFKAABShAAQpQ4PMKHHTgYq/nFOAedOBipaJoJhUKbhg2VN+/GBbsS6Vpry/k/eFwaJqr/3GpUs+gNZcB7uc1589T4FMFik/9zin5xurB7XjtgUzVunBRh2Bb2g+qzI0qu2vPu1fduv73rU7eRytLKlYIGWLcSdl2rvM0bXxY0HBK7hVvBgUoQAEKUIACFKAABShAAQpQgAIUOLUCsnQ8wlsJcKU+YVJjqZ2WFtxxxCxuqMK2xiJmZlDf7vu5zXa7GJfowDXnpQN3iRO4p/ah5Q2bVoFTH+Iewl47p8KbzTKmcbe928uyfRN9O+9VdXf4Lkq0K7ypKB0yvLmgLDvEDHO4edS6RJiLb+CDBwpQgAIUoAAFKEABClCAAhSgAAUoQIHfJyD7NdvJQvIS4CKyRQeulCj4Ro3la+wRPbLO/Ugvmlf6bm4jjJsKwYz9SnOhvvB/X2CA+/uE+X0KfAGB01unIHcG0avUKchhDR9m+2402z502t6X3eB8jtF8p0eqp36LLUGjIHO4DluKgnbSjZvqFFipMAHkZwpQgAIUoAAFKEABClCAAhSgAAUo8NkCssKQwxGZioS3CGzxNRIWExs1xNhcgyKFPV/b7+aXzVo2Kta7rhgr1WrM+aWaHbifjcvvUuDLCJzqCVUM0WopUUiHW0rfwUJsV9RbRdMdlHq93e51inZl/Xzjx/+LXi//z9ZicSmTAoW26uqW6ug89nSuW7isxHWc6vs6uZP8TAEKUIACFKAABShAAQpQgAIUoAAFTkQgdeBiCtdhSSIsYqaxD3RaSN6EsQzOIdA1OG3cq+py81dxR7+bd9TogmmbJQlw0YGpb2KtIh4oQIHHInC6J3HlLh9Gr6sqbry+FsdqHPrlBefmYtgfyQJnvvF9ew+fhwHLJOJNBYuboVtBFjpTeOuRSVxO44oFDxSgAAUoQAEKUIACFKAABShAAQpQ4JMEkJxI8y0+cJqmcaUHFx24vkIHLuoVsAf00DXmVf1s8001yt6bV4NhdhjgrirLAPeTWHkZBY5P4FSHuKiyPZzDTff4xjdvhHW1HupCBV/vRKlUKKy8yeQjzN7+BqP9FX5wMr0bUxtu0FEH5Lnh4NLjk+M1UYACFKAABShAAQpQgAIUoAAFKECB6ReQ1AT1CVjETCG4TR/aoqzSxBozuBLqYhkz58w/qj9wa6rK31v0g1E3s9acf79WNxHg6o/mN9NPwntAgdMncKpDXOH6eJB7XV0P0o3b7Qx8K3pXhrbrhnJPXXA/cCP/IP1CyALegNIErkznpklc+cwDBShAAQpQgAIUoAAFKEABClCAAhSgwKGALAePdYXSERO4GJSTOgUsYiYBLlYiQpCr9oxUKHzN/VW5m7/Xsnrc7tlUobCyumI/ntscXjFPKUCB4xU49SFuuruHlQoH971axix/33o0bWMUN/jS9CvVUb8JnfjrgIaW1KIgW5GwwBkmcR3ekDzekPzx0vHaKEABClCAAhSgAAUoQAEKUIACFKDA1AqkDtxUopAWig+T8NYpG40a43Ln0YZrnf1H9dXxmts0787nvaHWrWZrvFUrqVDgBO7UPvi84dMnMB0h7sdcr527FuZHlbdLHiHuvi87EVluuZc/HV8LVdzVAesmBmUQ26YVFQN+TPpcJMz92FXxSwpQgAIUoAAFKEABClCAAhSgAAUoMGsCk0XMpAM3YhEzyU2itmny1qhRsJjE9bGJ0f9Yf82slcP2u/1OZySdCmpxp776Z1cNA9xZe8rw/p60wFSEuB8ZzccCZ+quSgucNRneZVQf7zYxdPK+VXX2IFpV4QJsN0LpNlpbsCsAjrKiIt6CJMjlgQIUoAAFKEABClCAAhSgAAUoQAEKzK5AqlBAfIsAF3suB/TfIjfB/K0NdUwBLnKY4HbCu3He/Q+9F94vCz3OXTsFuFfUFQa4s/vc4T0/QYGpCHGTj1QqHNYqIMiVSoWL82i8bcfoTPAZ+lryJXU/lvHfZMVEhLdpXUUZ/8fKijjiTUmquqVrgQcKUIACFKAABShAAQpQgAIUoAAFKDB7AmkRs1ShgDgF47iTPZcxDBcaNUKNQiMLnJkt91Z+2fy3PPf/2slbe8qWtUzgpgD3pmauMnvPG97jUyBQnILb8Og34aGlyaRS4bW791ULIa7fxyRu6Di75x7Ypfr77gP977NOPpdFvLHg7SnFuTrmGbYkIciN+jAMfvS/zJ+kAAUoQAEKUIACFKAABShAAQpQgALTLSDdt1jELFUoYB2hNPjmMYNbqSHmci2G56Ldcm+rr5g/VyH8rMyKHQlwr/jFSq0ucgJ3uh993vopF5iaSdxUqfBw+IpKhfOqCd2+950yeFcoH4Kvfce9Fw3aFhDWoj5hEuBGdOQqje/j7UkWPOOBAhSgAAUoQAEKUIACFKAABShAAQrMkgDC27Toe1r8HQEuKieRlljszTxGIy72Xg7BbNm39eXqz/MYflq6/MFCVlROAtw/UwxwZ+m5wvt6KgWmJsT9JL2t5St+3Fi/gTcaG4dY3KzlSqdGqhveDk0YY6cAKVOQXlx0vCC+lRBXpc4Xjv5/EigvowAFKEABClCAAhSgAAUoQAEKUODsCchC7+mIAAUHpCNW8hLpwMXaQjKBq9wDf08/a/8i1/qnrWx+Z7FT1ue656qrDHDP3vOB92gqBaYqxH14GvcWuK+dU2F+VPnLF4wztUzjRl+EYi+ec98ze3497SLgNXYTSHO58nlSryBvXDxQgAIUoAAFKEABClCAAhSgAAUoQIGzLjAJcLFWELIQxLcaawZhJhcduHGMANfIZXbL/1Zdtv8NE7k/7ahyd9Haemu8VatVZbXWD5VbnnUs3j8KnF6BqQpxhfEwyF29iUgWlQoyjVuNLnmzEEILIW6pB1XoxTdjEX4RZKcAqcAN2EEAlQoRx7TFCc3dp/ch4S2jAAUoQAEKUIACFKAABShAAQpQgALHIPBQgItFgrCXsjYoTrBYvkwCXBuRz7pt906GCVz0K/xkLi92YlZWOzs79dU/u8oKhWN4CHgVFDgugakLcT9yx1dVlGlct/RmHKBxu4nBlTi2TP4guxBftfthEz8fgzThIr1NdQoIchEES50Cg9yPYPILClCAAhSgAAUoQAEKUIACFKAABc6IgOyNLB240n3rJcDFHK5F7aSNRlXBqQb5rQ874V39bPMX3tY/mTMLO3G/rLJmob5y5YqRigUeKECB0yMwlSFumsY9NMQ07m77ahj3rW8tOOea6Fs+r7Ne9pYaxHewgwB2DUg7DODNC9UK0vxyUKtweBU8pQAFKEABClCAAhSgAAUoQAEKUIACZ0RAUg9ZGygt7o4WXIlvMYGL6gRM4KIgoZapNjfC4Nuc+zvr/T/Ph/6ubmyddRbqy/fwc9j7+SPZyxmB4d2gwDQLTGWI+xHwg2ncUW6D3fah6QXnig4WNNMjbFR63VVxX6UtTuh8QZmCrMSINoXJmxmncT9CyS8oQAEKUIACFKAABShAAQpQgAIUmGqBSYCLCdw0iSsBrkeFgixkZmLlm1jL4u9+P6zHrn0uO2/udEP2QClM4EqAu4CYd00FBrhT/RzgjT+jAtMd4spovxwxjbuwt+eHPestNjG1MI2b+3wcLtu7buR3goS3Hh+oUkhboxDxHoS5rFQ4o09s3i0KUIACFKAABShAAQpQgAIUoMCMCTwc4GJ4LTpEuUYqFGQC12MOVxYpQ06yGfvN82He3FZNZ6MdB6N8NEoBrr6JVYUUFzKbsecN7+6UCExtiPuRNxVM466srPh91QTfidEWweM/l1etbd2Ov8LbVYXdCGQ7lJR4yxQuQlw0wEioy2ncKXmq8mZSgAIUoAAFKEABClCAAhSgAAUo8KkCac9jVCjIqVRJOsS3MoGLTARFkw32Ug5u32/ErnsuDNxLrVHcuJjlKcD97oPvNlKh8KnXzW9QgAInLjC1Ia7IHQW5Mo17Q4Xry1d8d+x8UThrQscVPu7pi/EHdugfaGxMQngrC5zJNC7iXBxlGxUPFKAABShAAQpQgAIUoAAFKEABClBgigUwO5v2OJbFyrCDskS4qFDQqQMXC5k1CulPGIbNbOCej/3Ry22jNjvF3Pi3rjbLD5abG2s3OIE7xY8/b/psCEx1iCsP0UeC3HMqbD9du7nuOV/64Eo9qHQr+7Uq4y+x20B9VKUg5QqTKVyZz+WWptl4rvNeUoACFKAABShAAQpQgAIUoAAFzpqAjKe58OEiZhhew5pAMoVrQh2sQgeu8pjAXY9997wfjBHgzm92mrlxu2nMf/ovl2p24J61pwTvz1kVmPoQVx6YwyD31kE3bjN/zxv0KVhsd8pNa9cvmR/6sd9Nga3Dm5m8uR1sncIpp3HP6rOb94sCFKAABShAAQpQgAIUoAAFKHB2BQ47cI8qFGT6FpWSaQI3GN3IXfdDv5UhwA0L9qVWVW50i3rc7jfmbXexUV/nImZn9+nBe3bWBM5EiHv4oKyiv2VdrYe6qIORBc4Q5LZ12cQ5f882YRRwGRY0Q68Cglsccd5hDJe9uIeAPKUABShAAQpQgAIUoAAFKEABClBgGgQ+DHAxqBYjChTQf4v9jm00EaEIFjHD8Job+g303z7nuqPbrTputN1gNDJtc6F3obn2DeUOh+Km4Q7zNlJg1gXOVIgrD+Z1dT2YbRMHiyHYMnqfR1+GfJR19W/QA1PjRzQCXJUWOkuLnKWmXAlyeaAABShAAQpQgAIUoAAFKEABClCAAqdd4MMAV/YyjtEhvjVSoBAbNcYkbhMzfAMTuKpnXojz9nbLz23YJqYJXKWWZELXaY2YlwcKUGBqBM5WiHvw9lMtV3Gub33RtrbA4os9099VT8UfuFHYRnyr0RUjP4n3OZnIxZqN6PeWr6fmUeMNpQAFKEABClCAAhSgAAUoQAEKUGAWBQ4DXFms3WGH4zSBq2QRM4MA16gKCYfze2FdJnDDgn+p06itnm4qXbXNem+9uXpeWX1Ts1pyFp89vM9TLVBM9a3/+I3XuAALle3f2o+Vqvy4r9T5ZsnGrBrnmf2V74RfRZ89neVZISXfOtMFMl1548sR6EaN/Qg+fpX8mgIUoAAFKEABClCAAhSgAAUoQAEKnAqByRo/kmN4jKQ5dOBiETPM4WLKFvO4RqbTMIG7GXsIcAfmdrvubFoEuCYvmz8uLmDv5Ate3cRv80ABCkydwNmaxBV+xLBSqeCWXFzKL4XtuBsspnFzF3f1Bf99txfXg8db20OrN8qbH44Ov803sql7CvMGU4ACFKAABShAAQpQgAIUoAAFZkBAgltktAhvA7pvvQynIb5FiUKoU4WCXL4f1mPPPB/m0YE76mx0mnK8hADXowNXPYPsAwEue3Bn4LnCu3gmBc5MiHv0JnQQw15tXw3unIpzHfQlmBjbZtCUg+LXvuPeQqpbI8SVXQ4cljpzAR/pawlzeaAABShAAQpQgAIUoAAFKEABClCAAqdJIE3eIrMIskg7ItyAqduDCgVldIPLdBiGLT+wL8S+v9025WanKMatWDfrCHBXVpVlgHuaHlDeFgp8foEzE+Ie3XVM4t7CF3fu34lv/fYtFRDiHi5wFmu9jxLcf/F12Mc2K9lyhZUbsetB1FaKwFGpIBO57IU5wuQZClCAAhSgAAUoQAEKUIACFKAABU5MAEuzY/kxyStQoSBJBjpwg1QoYAq3iVWwqkaq6/1w0oGrBuOX26az2WnmxmU+31x86mItAa4sYnY0/HZid4Z/mAIU+DICZyrEPXxDWl1VUSoVnlLjYLUPddt7WeBMBz3Ul8PdUMU9VOBKZIuPVK2AMBdvgbLrAXZNAChrFb7Ms4q/SwEKUIACFKAABShAAQpQgAIUoMCXFUi5BRZnn6QXqQMXE7hWmYAOXOxT3CDbQAduQAeueT52R7dDVW60XTGSCdxLA9Vg+tZLgPtlbwh/nwIUOHmBMxXiCmcKcmV5MgS562o9DCvru13nTQiuH1pGV2EntsNvPLZYYfcDeSO06MhNnbipVQZBLqdxT/6JyVtAAQpQgAIUoAAFKEABClCAAhSYYQHJZw8mcOUUA2ioT8AS7QYxboXZ2loG0fx+2Jh04FYvtUblxoILo2HVGJnARS7iD4fdZtiRd50CZ0bgzIW48sgcBrkyjbuwNPLzCHJbc965IvrCF3vqonvV7btNaZHBlqu0yBlKFOTUYgcDTORyGvfMPMN5RyhAAQpQgAIUoAAFKEABClCAAtMlMAlwJZvAoG30aXl2BLjKYPZ27PFZ7o4fxTSBa/pV6sBttweYwG01w+LCJMDlBO50Peq8tRT4PQJnMsQ9us+Yxr26fdWPlpa9U4vBNsG3fF5n3eKXPvevY8GzMZpx8baoMY0bJLy12JIlW7ikLJyLnB1B8gwFKEABClCAAhSgAAUoQAEKUIACT0BAVuqR/YVTLpECXOxBjEtsaEIVjKqkI9ft+/XYtc9FBLiFaaEDN473mskE7rVvKMcKhSfwSPFPUOAJC5ztEBeYaysqmu270aiNINO4ed62sfbb6kL4gRv5bTTjKsS3eIPE4mYoB0/duAhxUY4rIS4XOXvCT0j+OQpQgAIUoAAFKEABClCAAhSgwMwKSICbFjFLE7hIKzB9i6N04KYKBYzm2qHfih3zfJgf3S7rufX5rD/cxQTuilQosAN3Zp86vONnX+DMhriHlQo37qq4olZCpRyaE9CegEqFlpur817x61DGNzB3WyGqDdrJli3sooAAF5UKNk3i4vKz/xTgPaQABShAAQpQgAIUoAAFKEABClDgxAUmHbiTCgV04MrewghwLcoTKkymNQh3Uweu6pjnwmJ1uzUqNjpFkSZwU4DLDtwTfwh5AyjwOAXObIh7hIZKBZxP3bjjvvWmDr7sIs814YG64H7g9vymFCoE7KogpzKJK+eVvGFOJnG5iuMRJs9QgAIUoAAFKEABClCAAhSgAAUocNwCUpGAkPagAxd7C0v/LRYxi40aI8FosPiP8jKB23cvxLnq5bYpNztFHJf5fFO5t5u0iBk7cI/7YeH1UeBUCZzpEPdwGhdvZvHq01fd/KjynZb30o3bqYsmL+ObIXd3g/E1ol4sbYZ53NSHizfMiHZcHE7Vo8UbQwEKUIACFKAABShAAQpQgAIUoMBZEkhpRMBQmXzI3sFIJ6QD10UTZQK3lkXZ/X7YiD33vJ0fv6zGrS0/1FW7aZtLA9Vc+8Y1duCepWcE7wsFPkXgTIe4R/cZW6xuoVZhjA1YdslPunEzdOP6bFtf0OjGDdsKY7gHFQrY8qUdKhXkNKRw9+iKeIYCFKAABShAAQpQgAIUoAAFKEABChyLAAJchLbSgYtTBLgO54xM4aYJXIMIFwc/CpuxZ543/dHtflVuLHbUKC6WzdsygcsO3GN5IHglFJgGgTMf4qZpXDwSq5jGXVfrYb6yvhk7b4vgF/SgUj3361DEX3gTa+S4eNuUaVyU506mcINULDDInYanMm8jBShAAQpQgAIUoAAFKEABClBgagSw/y8qFLBCj9Qo4OiQPlgEuDaaUEdpwkU24YYeE7iyiJl7qe/LDVep8ci0zR//0YU6TeAqFDHwQAEKzITAmQ9x5VE8rFW4rq6jCHfZ9Z++4NCq4AzWOVMmf6DONz+w2LKFaVzZBibduFEmcVGogDdT2RqGN1OFt08eKEABClCAAhSgAAUoQAEKUIACFKDAlxOQsTFM36ahMRQnBHygPAHH0IRxkEXMcP1+LBO46MDtV7fbprPZjoPREiZwr55fqtWfohCSHbhf7lHgb1NgygRmIsQ9ekzSNK4KdfFmaFrONz64UmeVbutfYgPY676JFWZxUaIgjTN4O5VIV95YD7eKHV0Rz1CAAhSgAAUoQAEKUIACFKAABShAgc8tIB24qf8Wg2SpQgH5g8U+wZjAVWNldCULrft9vx677rnYtwhw5zc7TTluN425sHOhxro/lgHu53bnL1Bg6gVmK8TFw3V9RUWzjXqZgG7chXmX5x3bctl2vBR+KN24srVrMo2L7WBIdiXETRO5PvXToDiXBwpQgAIUoAAFKEABClCAAhSgAAUo8LkFUoB7sLcvAlxUKbiIAFdL++0IR0zgYopsP25KgBvmR7dbPm60XTFqxTl04F5s1Dc4gfu51fkLFDgjAjMT4h5WKigscLaiVsLSMxZ7KGwEUyPNdXmdt+KvY8v/G7Z9VWkK12ssfKYctovJFjKH35eFzvwZedx5NyhAAQpQgAIUoAAFKEABClCAAhR4ggJor/UYHPNpv1/Z81eWMZNKR2nBlTIFfDPshy2s3fOi6o1f6dULDzJfmMY6t5sre+0Z/DQWbueBAhSYTYGZCXHl4U1B7k1s1sL74t7eZT8/3/gOynEX8zYqw/MH2YXwfbuP0nBppLHYPQGl4niLtGjKdbjMYiJXQlz5fR4oQAEKUIACFKAABShAAQpQgAIUoMCjCSDADahRQK6AEscgAa4MjlmFCgXkD41cid93277nX4w9e7vjW1sdX4wWQlFlZhc9uPhZ5Bkp13i0v8ifogAFzpjATIW4R4/dQTfum3toSujG+ABvovNxUOXd/JdYGBLduGGMABfBrbypSniLUwS4Mo2bKhaOrohnKEABClCAAhSgAAUoQAEKUIACFKDAZwigRAFZAvbujUHW4FFpz9/JMmZYm6eRvMHth/XQDc/pBfPtbtPbjjGrhso0S1jE7MqVK4YB7mf48lsUmBGBmQtx01Yr7H5wHdO4T6krqFSQblznLEoVdFVuq4vhVTcMW/K+GrBrQwptZRIXXTUhSE8uvoEtaDPy/ODdpAAFKEABClCAAhSgAAUoQAEKUOCLCkiFwmS9HYQMGBOTABdfR+nBxRyuZBSoUNjUg/ii7o9e6tR6q9PJRx4TuFcR4OLPOn1TB07gftEHgL9HgbMjMHMh7tFDh2ncFQS58/MXvQS5nSL4jivrEt24ofC/QLpb6fTGil0WAj6wxSytIIllz3COIe4RJM9QgAIUoAAFKEABClCAAhSgAAUo8DGBtEZZyg9kEAwBLuoU0qCYRpUCljCT9Xh8qMJO6Pu/s/36JYUKBV/r8X5janMQ4MoE7seul19SgAIzKjCTIe7hNC4ec3TjKj+/23iDblxX7Hsr3bjn/fftntvAkmdoV8BqkQe7PqQ3X1yC35MQl0HujL5oeLcpQAEKUIACFKAABShAAQpQgAKfKZD6b9F8GzEIFmWdHbTfem0kvvV1rBDNBkzijrzzP4qD+k5h9OZC3h8uzOdpAncNE7isUPhMYX6TAjMnMJMhrjzKKcjFFq3XX1e+dnVA+W2wlfPz6J0JRXzTa/dzdOPijTUFuVjgDG+66MbFNK5LW9CwEwSuhlvEZu4lwztMAQpQgAIUoAAFKEABClCAAhT4DAGpUJDBr4MJXKQJaQI3ymJmdRzjK+uaMPSV/X72bPPX2XjwQYkJ3DJvmvXeuixy5m6yQuEzgPktCsymwMyGuPJwS5B7Y02F3WY3NBi7LS52rUWpgqqyB/GC/0c38ttYNhIFCngDxkJnqFew2P3BBix2ptGRK1vOZvNpw3tNAQpQgAIUoAAFKEABClCAAhSgwO8ITDpwUZ8gHwElCujAlYXT0YCLJczSBC7Gw0bBuB+Gr5k1PczfbeXNWIdWs1PtmBW1kjpwf+d6eQEFKDDzAsWsC0iQG5+J/i31lu8OldoqCl8UWRVz/au449+ItriId952lmkbsphnGuGt1hnei+V8oXOdz7oh7z8FKEABClCAAhSgAAUoQAEKUGDmBQ4D3MMJ3INFzDROgwlYd0c7X4eRN+EH2bPmm/pBdm++0xuNRrYJ7a366vmrVhYxm3lHAlCAAp8oMNOTuEciqFVAiOuqQeVbzrmFomNbVm+rxfi9Zsfex/azySyudNagXiFiW1q6TGnsIoFRXR4oQAEKUIACFKAABShAAQpQgAIUmF2BFOAiK8Aphr687MErlYzRKBMbNcbevB6VjeNg3Q/j5TpN4C7o/lAWMTsMcLmI2ew+fXjPKfAoAvpRfmgWfgZhrFbfUMXd+xvt3k5ZxFi2q2z/QrMT/7d26PwfxSA7lxVZqVqxjfnbEsdOXuquzlRbZWrmJ5pn4TnC+0gBClCAAhSgAAUoQAEKUIACFPgdgd+ZwEV4KwGudOBW6MCVwTATh874H6qvNmvFDiZws/6wCE31/vmlegUduJzA/R1VXkABCnxMgJO4ByBpobNzKszPN368aF2ZeZvb4kH7GfVjs+s+wMAt1pTEombygVlc6cPFSTgoK+fuDh97YvFLClCAAhSgAAUoQAEKUIACFKDAmRf4SICLCdyAZcuwMDp6b4066sCNIwlw8yv1NyXAXej0R2WnX2+r7WZlVbFC4cw/SXgHKXA8AgxxH3a8ocLe3mU/v9v4GrUKue5YX6vN7Hz4nt33mxE7RKiANpuID4UYVxY2Ozw+fD08TwEKUIACFKAABShAAQpQgAIUoMDZFogY8kpHqVxEgQK6b5UcEeGGOlYBQ2BYzGzf1f7V+JX6m81W/m6ZZ+PS2nr3g7ca6cDFius8UIACFHgkAYa4DzPhzfP115XfW7jszXkfTBF8Ky/31FP2By7an8oWNayDJmYylyvxbQpx0zSuhLo8UIACFKAABShAAQpQgAIUoAAFKHD2BQICWtQkIL71OMX0LQoT5GhUHRs90jKhaycTuNKBW4zze/1MDefb+Xioh82VK1eMdOCmvYLPvhbvIQUocAwCDHEfQpQ3z6+vaY8+mnBOuVC1Nn1eYZGzqvhAn3ffdzKNKwe8SWPrmkOMizdrfIU4N50+dF08SwEKUIACFKAABShAAQpQgAIUoMAZFJAsAEckAThNCQH6bzGBa2KNCHcUXHQeE7jYxfd72Vfrvyq283tF6I8WQlFtjc/Vr967zAD3DD4teJco8LgFuCDXJwuHRjXhsu+7xvksz7LKtPLfqDK8EU28hN0dujGLOtNY1kwh+ZUh3EzJV7IjRP7JV8lLKUABClCAAhSgAAUoQAEKUIACFJhqgTTMJWvlTCZwEeQisk0BbhUMYlzZabeOu8G6H2VfNWvxQfZuHuPIh6ZewiJmS1jE7Or/wwncqX4O8MZT4IQEOIn7CfCyKuRYjYN9xqJSwftWr+tUlT0IF+wP7K7/QLaqoaTcorLcoWJBVp2UN2qbtr99wvXxIgpQgAIUoAAFKEABClCAAhSgAAWmXGAS4MreuJMJ3LSIGQJcG+tg0H6LyVy3H9Zjx/2/+VfcX8Td7N0F3R8uzF+qrjZLFe69Y4XClD8HePMpcIICDHE/BX9Frbj6N3gfRjeurbyfy/W4bOs3fOF+EWxopLJcOW2wzc0EGw2WO5MgN72Zf8pV8mIKUIACFKAABShAAQpQgAIUoAAFplEg1SiiQiEFuahRwMI5WLgM8S0WMMOuvBE76YaR2tSD+KLpmG+7vfD+IPb2cj+oLuyoWj2D32UH7jQ+8rzNFDg1AgxxP+2hwJvrvfP3/Pz8Rd8tGltmHavHejs/F/7B7rj3Ylp5EvO4CHK1TOEGnMcRe044XCUXOfs0V15OAQpQgAIUoAAFKEABClCAAhSYJoFJgOuwxDl6cDHSJXvn+kkHLioUaiQALuz5dd+zz8e5+tsD1d3M7WBUdMf1xafw/f+K5AB7/HIRs2l60HlbKXD6BBjifspjIm+u129e9x/84jW331xytXOuLAZjX7o34oK/7Yd+C2UKshqlCwdv4xLiHvXifMr18mIKUIACFKAABShAAQpQgAIUoAAFpkTgKMBNi5k5xLhSpWhRnlBhn9xGVslxyAdiLz6v+ubbbdvd7Kh85Iq6vjS41GD61jO8nZLHmjeTAqdcgCHuZzxA8kb7/DPX/G7zWjAeNeR+x/Wa/k5+SX3fefcTLHJWK8S42J6GrXDRSz9uCBLs4i1dYVcJHihAAQpQgAIUoAAFKEABClCAAhSYToHDRcxwigXMUKl4sIiZ1TX2x22wJ64P+3Fddd1zplff7oy7WxLgFlVdrzx1sVarDHCn84HnrabA6RRgiPt7HpdV1CrsP7Mfzz3lQqfV97rdMnml1uM593078ttoTkCVuUS5qFHwCHPlVKEfx6cQl7UKv8eX36YABShAAQpQgAIUoAAFKEABCpw6AfzbPv07P52m5c0b/NvfYJhrjPi2xj/2Yxj6Td9zL4SBfWlQq82WyocS4L7tLjYpwNUY0+WBAhSgwDEJMMT9PZCpVkFdD2/t+lh3nW/74NrjrCr6+lcxd//qsfUN296wM4XsUoFT6cVJQS5CXOx28Xuunt+mAAUoQAEKUIACFKAABShAAQpQ4DQJoPtWpmzl3/ZYDwdjWwhvpULBKCxihgA3Ruf3wwehF/5WKhQ6ARO4ncGoFevmIiZwr0kHLgPc0/SI8rZQ4EwIMMR9hIdRCshb/+6ym99t/AetTW+6HWfq7EE8H79nH9j73mP7XPrQ6MeRRc40jihXkDd9bJ17hD/BH6EABShAAQpQgAIUoAAFKEABClDgpAXw7/gY0162+Jd+2sfWRod/40sHrlWNQu2i2w+bse2eD/P1S23TSR24MoErAS47cE/6AeTfp8DZFWCI+4iP7bU/VW5vYc93u3N+7L1biFlVFvYXbuC+7UdxC5Et+nHwIVvqZK3KyVa7gAiXQe4jGvPHKEABClCAAhSgAAUoQAEKUIACJyYgAa782z5IkBtQk4h/20sTrg1NMIhxcbnb9xuq756L8/Z2p+puuaoeHwW4q+zAPbHHjn+YAjMgwBD3ER9k2RViZWXFyzRuy1hXZcZmWXe79ZT/gVfm53hrb/DmPlmlUuLcoI286Uu4e7DQGSdyH9GaP0YBClCAAhSgAAUoQAEKUIACFHiiAinATf+WlwoF/Ktem3Q0ahyxkJlULfqh39K9+Hzs29sygdt2xWhhfrk6msBlhcITfcj4xygwawIMcT/PI/51FWQat/fURddyPTfv26asWxt6sfmu2TObwaFYATtaYJsdjinQNVjBMpWhYzIXC57xQAEKUIACFKAABShAAQpQgAIUoMCpEsB6NjJlO5nAxXgW/j2POVyHRczq0KhaBrPcMKyrLiZwe/VtbfV2tyjGRXeu/tcBKhZucgL3VD2evDEUOKMCxRm9X4/lbsmWt6gQ0C6r/IOh9ZXLXEtlle0Vv0TL+U/wnfMxD0Xmc4MwV+NGyFGpLJZyonOVKY3PPFCAAhSgAAUoQAEKUIACFKAABShw8gKTANdJFSIWLEsBrnTgKnTgYhSrQQagwzBuqK59IQzsS7KImfeoUDBz6MBVzSUGuCf/GPIWUGBGBDiJ+zkfaFnkTJ1ToRpUfrxoXdFtY31KvdX5d/5/1OvNr1GfkNauxDY7i+YcWcGy0UE3+B+CLHgm/2MIn/NP8scpQAEKUIACFKAABShAAQpQgAIUOG6BwwoFnCpUKKQOXKx1IwuYYTCrCVjAHAHueuza5yXAPVzEbME/jQoFVatVTuAe90PC66MABT5dgCHup9t8+ndQq7D13pbvqZFrgnPtMqvDrrqXXbXP+b3wfnDBYSrXYHcMnEbj0ZeL/yUYBLgOIS+D3E+X5XcoQAEKUIACFKAABShAAQpQgAKPXUDj3+fyb/a0ODlGsTB926R/xzdxLDUKEXvihlHcjP1wFOBeyM4NMz03CXBlApcduI/9ceIfoAAFPhRgiPuhxSOfk1qFa9+45q4sX/FYySw03ro52xkXWf6v1prXvPF1CnKNrvE/AfyPAFvwPP43gEBXR+2C7KLBAwUoQAEKUIACFKAABShAAQpQgAJPXgCTt5iyxfQtZm+xIDn+hZ46cLGUWRWsdOAq5/fDB+H/Z+9en+S4zjPBn3MyT2ZWVd+AJtBosEVhZChsg2HvSpBkyzPjoUc3e+zYDxtBRmzsd82HjZh/gc0/YGM3YmM3VorYjdlYWTsGHbEzFknJIinBOzuWRAmU7TVhU4I0FAni1hegu6sqM891n5MNkJRNUhTQl+rup6DqS3V3VeYvi6rKN9983p77s9Bvug7cNMRsNCuaBWbg7v324iNSgAKdAIu49/lE6I64IVZhpm99pivbSmdxBG9N/3p43tzyP8VLQYgG//ePiZYIYHD43qILF9dgUyE35e3c50PzzyhAAQpQgAIUoAAFKEABClCAAhS4H4GUgZv2x7vPKQMX+bddBi4KuAZn0KYfDMNq7Ntn8hmPAq5YTQXcvDduXhX4OTNw70edf0MBCuyAAIu4D4L4uAivirYr5BaDnut7bdQmYhU+0j7jNt2NdGQPnbgo56Yk9O6zTS8QweNUjRSrkF4deKEABShAAQpQgAIUoAAFKEABClBg9wXuFXAxyyZ14aKUm6IQtzNw01m0qUN3K94Kff+1OLDfUrVbK91UV8Bd+NRC89iTzMDd/Y3ER6AABd5LgEXc95L5ALdv59+ccamQa0beW+9cbntjXWV/76X/2+A98nUCXgZS4TZl7SBQIRVvg7Ao6zq8QKRCLi8UoAAFKEABClCAAhSgAAUoQAEK7KbAWwXcrgsXZ8ti+LhHgIKRY/TXNqnHyo/8Wuy7Z+Og/dasL1cKNRgqO13/3dRCKzAbhxm4u7mBeN8UoMAvEmAR9yxGALMAAEAASURBVBcJ/YKfP4ZTKaYX1/x0af0wa2yOwm3WZrfjnPuO2wjXEJ8Q05G9dHpGOs6Ha1fETfEKKOgG3D27cX+BMX9MAQpQgAIUoAAFKEABClCAAhS4b4F3FnBFd5ZsGmpmo0FHlg0t9s2934w3VT/+WZwxL1ahtxZbPc5Go2bxtmjTfn+ajXPfj88/pAAFKLADAiziPiBiN+Ts+nlfT9W+mBs4LStbadUUff0jP7AX/SisYcgZyrfByyC9REk3fReRnp6idkT6zAsFKEABClCAAhSgAAUoQAEKUIACuyEQu31vgf3vVMBNDVVOmNhigJnFx3TjKK7KQXjGzWKIme2tViIbqRPT9eLtxVY8jQ5cFnB3Y7vwPilAgV9SgEXcXxLs3X5dLstwRpxxMxutX9Hem+CRqRM2y5Phe87bv8LXberAjQajzlJXLgq5KN2ioJuKuRhyhteMd7tf3kYBClCAAhSgAAUoQAEKUIACFKDAfQukAq5HC61HCRfnwqKE67oO3Ab7502aXeORgRt7/hk5iyFmo2rVinqU1832ELMLLODetzz/kAIU2HEBFnF3inRZ+M3ZTd8rbnqdV7Zvc4OjeqvqofiX9g6GnKXjfSjjooRruoIu8ndwGyIW0r9U2GUhd6c2Be+HAhSgAAUoQAEKUIACFKAABY68wHYBN+1rp7Nhw3YHLsaXIQM31tCJDh24sW+fjTPNi/1GIQM3G85KVZ84eWJ7iJlkhMKRfxYRgAITJMAi7g5tjHR6xTlxzg1ODdywMtY45wonG6H8lTBjv+22PGIV0uRLaXEE0KMbN2XkokMXp2/EkDpzUyGX0Qo7tD14NxSgAAUoQAEKUIACFKAABShwNAWkxN41ogsxTDx14KY4Q+yLY3yZEWO0VtUhdeBuhpuxsl+L0+aFFKEQYj4SYqZe+NlCI9CkxSFmR/O5w7WmwCQLsIi7g1snxSosbS7Zvhi5/FhlM6Xx9eCOPGm+b6P9/6JPxdoQhcWQs1TQ9TiBw4sUsWDwEuPwIxZyd3B78K4oQAEKUIACFKAABShAAQpQ4MgJpMkziE6Qb3fgWjRQtamAG5vUORVGHh247tkwMC8UdbVSNNkwFXCXrmLfnBm4R+4JwxWmwEERYBF3p7cUjtitXTvjm57zQ9MYZZ3Jh/mqPO6+Y+/YGzgWiBQeZPBYXNMpHenrVMj1wUrk4+JQIbp02ZG705uF90cBClCAAhSgAAUoQAEKUIACh14g7U2j83Y7shDV3LczcNvQ4LuAAu5K7HtEKJgXS1Otli4f5b1x0xVwmYF76J8gXEEKHGQBFnF3eOulWIWf3n469MUJly30bCMrm5e9OtPiSpzxf+GHfj244KSTLUaapUxci7KuwQuNCQG3I1ahK+Qin2eHF413RwEKUIACFKAABShAAQpQgAIUOJwCKN+mmMKugJs+o1EKcYatqOMQe95dBm4YhdSB+7Uwsx2hkDJw11DAXZhaaLsOXGbgHs7nBteKAodEIDsk6zFRq3Hh8gXxk/9GyPGbt6VUWpW+ENHbEGfDpl0LU5nITopMaCmUQFbP3WotvkAF+N4lrZBU+IV0Ky8UoAAFKEABClCAAhSgAAUoQAEKvLtAKuB2+bc4s1XINFQcRVxpIoaY4SzYFpm4wd0J18OUeS7OjF8sMMSsJ6uxGs7UZ//5VCv+OxFSQ9a73zlvpQAFKDAZAvlkLMbhWor0f/7xevRXXKN8r/K5ESL3M+2wHd3KP2r+3P7M9LXRn8JaSyVVxMG+7l/6FunrXdFWZkhi9/iRkqnQzkLu4XqKcG0oQAEKUIACFKAABShAAQpQYGcEsBuNc1tTEm5EATed7YrIwtjEMcaaGVRmo1sPV7NH7FetHf9VNSrXCzUY3W4ac+70tBFPsIC7M5uB90IBCuy2AOMUdkt4WcSz82f9sG99Wzjvsi3fQzlX1tkteTz+J3PbXccJHghUCFY4aZDYk6IV2uAFrmngGY4X4hQQvBjhSCIvFKAABShAAQpQgAIUoAAFKEABCvycQCrebmfgYrYMCrix68G1XQHXigajxb1bc6+LR5qvNr69VKnZ9dJNjbLZmaZ2r7fiSeHZgftzovyGAhSYYAEWcXdp46QXgqcw9LInFt3g1EOuHvScKYKbzvtNzONPxIy7aEf+Doq2SMTFSR4OubgeRdtUwHU4Wogibgi4lYXcXdpCvFsKUIACFKAABShAAQpQgAIUOMACaSj49j5zysB16MA1wohGbqUIBexPR3vbvaEesV8xxv5g3vbvPGSyobLDevEV0Z7/0nmHOENGKBzgJwAXnQJHTYCn6e/iFu+iES4IdfHya3pJuMK1PZ0Pez3jfeX75oT7z+q/KqfKf57pTCuN2IRS9GUucnylZS7LdMv2VeXIxy2wqNxeu7i9eNcUoAAFKEABClCAAhSgAAUocAAEcMYqGp5SERdXlGu9xBCzVLoVQ5zr2uBnwaGAGx9uvhqtfXlWT22IUV2rEw93BdxuiBkzcA/AhuYiUoAC7xRgJ+47NXb46+60DOTrTF9b8wMxcHnZs41yttLOZONiJfvV8EJ9w/wkJbDjNI8gUuC6x0dc490u3O7WlOqTOnJ5oQAFKEABClCAAhSgAAUoQAEKHFEBDAZPnbOITcBeMz7jvFYMMcMAs1S+RQcuCrhpX1rYdfe6/JD9yr0CbrT5WJ1Q9eI5/N7TzMA9ok8frjYFDrwAB5vt8ibshpydjv4yumjd8KbMlbWqLWWlczG+466VZ/2z5qoZlPN6KdrM4nSONOQslynXRyItd/t7iZwfvF7hf0pwm+3yNuPdU4ACFKAABShAAQpQgAIUoMDECaTRZQHXuwXc7us0acaEJo5SRCFKusZu+GvZkvtj3zZ/da8DNzvxcLP4ykwrllnAnbitygWiAAU+sAA7cT8w1f3/olyW4ZwQrv/Ilst0Zbdi3VrvnVaqUVr8KM6Eb9uhu42BZkjFxUtPdzyxO6rY5fvg1JAuIxdHG7eHnd3/ovAvKUABClCAAhSgAAUoQAEKUIACB00AaYVdhEIa/o1ZMmnvGRm4Dtm3KOBi7xl5uHGMsu4PstPmf/c+/HBGDO6kDty8lzfswD1om5vLSwEKvJsAi7jvprILt6VC7g//49luyFkxXTtZlmagc6NbvVme8Jdca18KrU/FWgQnyC5WIX0VfbCIWrAo7LZdxEIKbo/4jhcKUIACFKAABShAAQpQgAIUoMBREEACYRehkLpww90M3DS8rN7uwPVN2HTWfTcsjr4iZPib6Sy/I4Sus9mZZuFTC41AzGEXd3gUrLiOFKDAoRVgEXcPN+3jyN65+feXUMhFPm7ubJs5q2Ru9VCv6F8P325W3E/TAUWUbZHkI1scX9yetBmR8hMlCrro0g0BL1rSdgHue7jsfCgKUIACFKAABShAAQpQgAIUoMCeC7xdwEXaLfaK05mqqYCLDlyZZspYMfLOvZQ/Yv4kWw2vV6bYjAoF3NFouwOXBdw932R8QApQYHcEWMTdHdd3vdd05O/8l8+7zc1NP/TGbbnaZMJb1dM2rmc3sl9x37CrmKCZQhVQyEX/bXpx6gadpWONIqJ4mwq4KS83DTrDi9m7PhBvpAAFKEABClCAAhSgAAUoQAEKHHSBlIKLs1FlGmSW9n899oWtMPFuBm5o45Yz/rviEXNBjrI3Z6vjIwygaVS71SyeXmQH7kHf/lx+ClDg5wQ4JOvnOHb/m27QmYjuSntFjstpMZatyus2m1ZTzbgYvWqQj+tH/o/EIDsmhWhUeqVSmGfmY4aKrVIZBp/FsD3kDIPOZCY0lhq/ygsFKEABClCAAhSgAAUoQAEKUODgC2CH9+0hZqmAi6amLm4QHbhdATcgDRcduNbal8Qj4wv5Rnl1pjcY1bedeWRhthbVrEmRhgdfgmtAAQpQ4G0BduK+bbFnX6UXk7PzZ+36VO23XONCJpssd10+bjbfvty27cvBeuTiIkLByqaLVUiniYRoQkBgOwacIRd3Oxt3ezLnni07H4gCFKAABShAAQpQgAIUoAAFKLCbAijYBsyESWejuq6A2w0uE003xAz7xL5BB25r/1P2sPl3fk28mQcxGo9tq6qtBsvFAu5ubhzeNwUosG8CLOLuE30q5D527ozN5wdODoamNqXp57nJTH8l/6j9VnPd/iR6zC/DSxbKtyYdZ8RLGKIVQroFV9mdUoKCbopV4KCzfdqOfFgKUIACFKAABShAAQpQgAIU2DkBnGaaum5TAXd7iFka9G1Fg73iMWIVHAq4G90Qs6Xxn5o77tpUVY2OyaLN5bD9ztUlFnB3blPwnihAgQkTYBF3PzcIAtZ74rZbtwM37nt3WzlbudzIO/pN9U/c1+2aewMjONOJIumfQRE3vZihmIsXMdyKGWj4Pv3rirhxP1eFj00BClCAAhSgAAUoQAEKUIACFHggAaQJ4uzT1KTUZeB2+8AOQ79NrIOLzm3Em7Hv/4Naar5aNOLadNYbq6xoh3KuXUIBNw0Tf6DH5x9TgAIUmGABZuLu48a5l497efaycENtnauFyk/IKUTdjoJ51U37i5iAlvJx51TEMUcZM8TgYokj/lQiHVdk6MJNN0i8VCn84/bcx+3Jh6YABShAAQpQgAIUoAAFKECB+xTAGabbHbgo4N7LwEUBF+O+a7QveTcMK3HKfkMO3PNiK1udiXN103NGtbPN0qeFEWiSSvvY9/no/DMKUIACEy+QTfwSHvIFXL64LE6cOCG2fnNKuK1WeEwu841Fhdb7cMxvmZXYV0IuyBz/pMILUlQo3iqZeqhR7E3V3PR9V9ZNP8Hws0NOxtWjAAUoQAEKUIACFKAABShAgUMk0EUopJjA7ppKtilQUDaYCtOgNGv9VrgV+/ZZP9W8oGy+ppUc+yhN5tGBywLuIXomcFUoQIH3E2DB7/109uBn3ZFCnPJx9pRw/XbLbblbLvqm7YWZtlfrW72z8Xnn/A9x9NGELhkXRyLTwDMELGC0mQ0BVx8N5m6mzFyHRWY+7h5sNz4EBShAAQpQgAIUoAAFKEABCuyAQBehgB7c7t92+TYN+N7uwBXWbvrVMGWfQwH3xSlXrBZWjo8jQkHMzbEDdwf4eRcUoMDBEWARdwK2VVfIxakfV+ev+jToLJuvrC03XS9Ot2pT3xKz/jvjW/ZnMQ01S+VbK1ocjUwZuRaFXBMcXuAcbkPIe0BuLj4zB2gCtisXgQIUoAAFKEABClCAAhSgAAXeRyDtu6Zh3XdzcFOcAoaYdREK2Pu1bsujA9d/zfebF4q2XItS1XOVbjZ6G+0ZwQiF95HljyhAgUMokE6/52VCBGKM8tKXRT5/XWShvl3GDV22wVZCt9Nt639dXNP/de+kfkTlWSYLUYhS9mUetcxEjvyFEp8rlasiqqiVkikfl9t3QrYtF4MCFKAABShAAQpQgAIUoAAF3hKIAkO8Me7FdaO6U/E2pHHeosEZqCkD17ktZOD27DNyrnk+jvRqGVUtZdE6P1efnUfYwjLOR+WFAhSgwBESYCfuBG1shNvG89eFX7smfK93zMpZi1iFoq1suaV1/FGcFn9hbrsb3gbnLY5Pmth0H/FSh4gFgxc9XHELXvzwmbEKE7RtuSgUoAAFKEABClCAAhSgAAUo0Amg/xZl2rTfmtJv02dEBcYW+7epgIuvkYF7Exm4X5Nz7vmqLdbuFXBzOWxZwOWziAIUOKoC7NScwC0fl6O6LC7n9bVj+Xy/V9Rj15PKlS6PD9l1+UlVZ58r5zSGnak8deTiWmLsWYFrqXJ8neG21KurYoHCMIfXTeA25iJRgAIUoAAFKEABClCAAhQ4ggLbBVx04KKQi3/ovu1iAtGQlJqU7nbgyin/jO2PX0gZuClCQVjdpAzcM+fQgfuEZMPSEXzicJUpQAEh2Ik7gc+CdFrIOXHOzZYj3xbOS10aJbStTHZbL8Tv+57/FiagrUeHlCCDF7uUjJte+HwwyMRN1zYNO+teEJmPO4FbmItEAQpQgAIUoAAFKEABClDgyAkgQTCdNYoCbkR8Aq7pLNI08yW02x24iFC4FVHAFbP2rQzcVMBNHbhnXsFvYpbMkVPjClOAAhS4K8Ai7oQ+FVIh9+r8WT/sWy8HrWmEs0Z4q9r8jj7pL7XWvewaPw7dsUvZIkTB4iUQp6EgQciigIuBZ0gIsl0hV+AlkhcKUIACFKAABShAAQpQgAIUoMD+CHQFXJRuMYgbLUepISnFAhrRenTgpn1ZNwyrceCfU337Qqzlqs7l+F4Bd+nTS0Y8jfHeQnLfdn+2Hx+VAhSYAAEWcSdgI7zXIjz2pPCza6OukBuq0oRe1uKlzeR1sao/El9wxv8wWHTfpvJtShBKL4P4CscmW2TkvtWNe7eQ+14Pw9spQAEKUIACFKAABShAAQpQgAK7JYAhZt2+Kgq4KQW3+zp14HZDzFIrkt/yt2LPPxN69QtVq9aO2am7Bdy5dukqCrjowGUBd7c2D++XAhQ4KAIs4k7wlkqDzs7On7WpkKvy1vYr3fTzGSNyjZmd+lY2L/6yWbFv4EBmSIXcdBQzOolYBbwshpAiFgxyhtKwM+QN4YWSFwpQgAIUoAAFKEABClCAAhSgwN4JpIC/NLwMBVzhU/8t9lPRiiRrRCigAzc6NwqrYuCfDYP6RW2L1V4+GI+lbc8gA3fp09inZQfu3m0tPhIFKDDRAiziTvTmESLFKpy9cdbNTNW+2XJ+XHqjpLNFzFtRxJ9kH7Z/1t5yXSG3i1RAlAKOUQZcuyOcOFEldeYaxC6k3CHmB0349ubiUYACFKAABShAAQpQgAIUOCQCXQduysFNBVw0F3mJPNzYyhqtRjh7NDp7O1yLff81MWVfLGKxVkRVa2u7DFxxNwOXHbiH5NnA1aAABR5YgEXcBybcgzvAkcfXxBnXP3nCFbPOxdi2Cvm4M6IaCi1/HGfjRXPb38Rgsy5ZKMUqpG5cpAVtH+VEITd143aFXObj7sEG40NQgAIUoAAFKEABClCAAhQ40gIxxfp10X4hZeBinzQN4TaijujDRayCM+vuqnq4/WNbjp6XiFDQVo1lO26GGGLGDNwj/dzhylOAAu8hIN/jdt48YQI4hCkvffFSfvr0ab051tnwji2nVVHGPC+sGM+3K/KTpdN/kM/lJzIttSxkKQtRCRW1yKRWOb7PRU/m+JkUesJWj4tDAQpQgAIUoAAFKEABClCAAodDoCvgItoPMX/bhdzUdSuMHKeJLijsWruKs0mX7L+L3l0qrR7qDAVcxAfqatwunltsmYF7OJ4IXAsKUGBnBdiJu7Oeu3Zv6RSS818+726L227dNs6VGHSWFY0QtkVS7po+5V62zv/Q1W7oLcacOWlSKm535DN14kbExqdrysZlPu6ubSfeMQUoQAEKUIACFKAABShAgSMscLeAmzJwca4ozghF+RZjuJGBm0ZyY1/UogM3/7D/airgFlFvpQJuFHmt2tlmUSwa8TiHmB3h5w9XnQIUeB8BduK+D84k/ih15Iplkb0mRP7meFXPj8pCyrZUPlR2yj9sfpb9UVkWv6Uq2VdFpkURqtR9i07cYrsTV5QCnbgyw1XiIy8UoAAFKEABClCAAhSgAAUoQIEHFcAMlojCLQq1vvucYv4CBm+3Yoy2om7gdurAlUvmqzK6l3u+GEZk4KYCbn4vQiEVcDHg+0EXhX9PAQpQ4DAKsBP3gG3VLtR9Wfgz54RdqB8yI7vicuedtLnJhvpWdiz+ZbPiX+8yhxAWL1pRo/fWprRcTAI1+Br5Q+jI9TJ15nqsPl8gD9hzgItLAQpQgAIUoAAFKEABClBgogRSAffuWZ+Yx4JzQ4XBlBYjWjlGKTcN2vZ2zV2VS/6rzriXSze1GXLZdeCmAu6V2SXbRSiwgDtRm5ULQwEKTJYAi7iTtT0+0NKkQq58Qvqr88KfPv0Re2e2aE3hXaHyRmj70+wj9s/qG/aKN97ihBUc85QN4hXS9M/We9GgmNviEGkKlmch9wOJ85coQAEKUIACFKAABShAAQpQ4D0E0HiLdiE0CaWB2tuDtiVaiuIY47VN8ML5Vf8aCrhfcaZ9eVrrrX7U9azK67W52iyhgPuYYITCe9jyZgpQgAJvCfB0+rcoDt4X//bicnzjMSGdviO060njRroKU95nzWaYDmvupvpQ3pPTKPmmfwExCgpDzZDHgO9E+hBRxN9O1MDtqaDPeI2D9zTgElOAAhSgAAUoQAEKUIACFNgvgbczcENI48vwDw1EbWjQNJQKui0ycK9lH/JftW37Q+31VqZV3erYmN5Ge058yGLBg1zG/iovFKAABSjwvgL5+/6UP5xogVSMvfBK9B87NZK+p23hVCPRalv5YmQze6WdDRfdnfC5/JhaUKl4m8q2Ir04IllXCJWJ7haUd2XA91EqobHCLORO9FbnwlGAAhSgAAUoQAEKUIACFJgIARRwUaYNEtm36MD1iOvrhpjFGlEKLrRhiD3Qv5EL9pumtX+bCrjHMjke4gxS1TvWnnnlmBUXmIE7EVuSC0EBChwIARbsDsRmev+FjBdi9tploVsMOms3fW+qLKrGuiL2/DFzQ53Pxtnn8tlsIddZhvFmhSxjX+SiVLnohp4JFdOQMww7wwg0FnLfH5s/pQAFKEABClCAAhSgAAUocNQF3pGBG0JwEjNXUM7FELNUwBWpgDsK3v8g+7B7WqyHNzMVh305XW+1psnnN82Zc2e2M3DRmHTUKbn+FKAABT6oADNxP6jUJP/eEyK8JoRbt42zyMeN2jSlyNrSqHV90v/AVf6bOIXlTYeMXETKG2Tk1oiab5GN2+C7Bl83OGa6fbpLCqPnsLNJ3tpcNgpQgAIUoAAFKEABClCAAvsnkLJv07Bs7Dti7ortum8xyCzUYYTJKzY0YYj5LN8Lp5sLzZp/Y6AqfC/HmWrqs+J4+/1Xvs8C7v5tPT4yBShwgAXYiXuAN947Fx0BCVIsi+ySuF5MjXU2rl0144uqdujIrfycvaU+njf6c/mcOq20ypFDVAh05Mpc5MhVyEUmK6XRmYteXRwM1VLhJ7xQgAIUoAAFKEABClCAAhSgAAW2BdB/2xVwvQgo36KA2w3LttKg87aO6WdtHHnrX1Ifsk+LUXhzWvTq8aitZ04tjE8silZcR/vQ8vacFqJSgAIUoMAvJ8BO3F/Oa2J/O+Xj4sXQnxeLJqsfMtOiaDcz01Qhbyub3RYn25ddz71o7/gbwQaHqxUWHbkOR0wRP48X3DQ11HZZRqkbF0dXJ3ZluWAUoAAFKEABClCAAhSgAAUosJcC3QAz7DciAxdxCa4r4KYhZja0cdx15bZxaI37Xni4vtAiQqHwsmmcaWZnsnpFXDapgJsGmHX7rnu55HwsClCAAodEgJ24h2RD3luNriP3glCvXX5Nvzme0id8WZp6q1fGgW6r8XGzkp3Ph/nn9DG1qHL806n/NvaQj1uIHN24eaxU6sZVKSMXt3HQ2T1afqYABShAAQpQgAIUoAAFKHAUBdJk7G5wGSq5SLyVpivmpuiEVtSpgOtbP3bGvSSW2gtuS745JdAw1Komat2Y+ePNOcT/pQLuUcTjOlOAAhTYKQGeMr9TkhNyP91RzSdwGsvjeJU9JeKaWJdFpmSFm6oROnJP+EutE1KsZ5/Jj4nFtNgKlxAjZpoFFVG93U6WjwrDzrxQiFrghQIUoAAFKEABClCAAhSgAAWOpkAXoYCybcT+YTp7M53JaWWbhpihuBvQiTuyjf2uWDJ/6tfktalC1r1cjPNjqtlYO25ZwD2aTxuuNQUosPMCjFPYedOJuEf5tPQ/vCHcwvxxU85ntUC8gulpq9r8Trnof2D6/gV3J9zoJodi2Nl2tII0OL6aBpy1OJq6fXQ1pR7xQgEKUIACFKAABShAAQpQgAJHTSDtDToMMfMo4aYMXJf6cGMajo0Cbirr+nHccK37XirgZhvizYGsxg4F3Nt13py4dqI9O489TXbgHrXnDdeXAhTYJQF2We4S7CTc7RMo5H77UQw8EyMx3c9N2VilXNdceyc75S7ZFfTZ3hafLebyUwGvzkqqxsuIFtyIJlyMOkMXLk54QZ8uhpxJ/C4vFKAABShAAQpQgAIUoAAFKHAUBCKKtyjgxoB9wrc6cIUR6MAVTQjIVRj6VTkVvhGnzEUUcG/p2Ku9a+tZqeqr7nUjvnTCYcdy+0TPoyDGdaQABSiwywLZLt8/736fBf7txeV45rE5EcZrQvgy2EJIFb3qu4GNM+2693gZHsslZOOWqPamkHmk4MbueYEX3BSpgIgFFHXxFVYlXXmhAAUoQAEKUIACFKAABShAgUMr0JVu0wAzjwJuysI1uNpokHNr0YWLHUQUcNdSAdf36udLV6z0Mz3Woalrpdv1+g1z/vR5L3+PBdxD+xThilGAAvsiwO7KfWHfuwftMnKXhb85WnIr+dg6OW6rfKZpnTcpWiGetD9sjX3Zjd0wdMH0wXT5Rgirx/c1TphpRMBLNV68sdQ8irp3m46PRAEKUIACFKAABShAAQpQYK8FUu+tS4PMsB+IAi72BV0q4IYUoTBOcXx+06/EvnsuFXArU66XQiG+r67Xenlzzp1on0kFXEYo7PV24+NRgAJHQIBF3COwkVMh9/yXhStGN52fK40PbR16RSslMnJrsVb8mn+xbdz3XB26F+VoRBMdgupxxDU4WWOOKAq5eOFmIfcIPFu4ihSgAAUoQAEKUIACFKDAERVAATcVb1P+bQghZeC6LgO3jq2sEYEr/DCsxanwXJxquwJuiFk9NE2jM93azatGnBZ+mQXcI/r04WpTgAK7LcBM3N0WnpD7T4Xc+GUcQ/2SEFc3rsZhVMpKl/VcJtthfkN/1D5vriAzV+pPIXBhWorYKnyBzwhASmkKiFTIEKmQ0hakSM8bRitMyLblYlCAAhSgAAUoQAEKUIACFHhAgbcKuN0uYJA2deKipNtikFmLCIUQtsKq79uvi0H7QmnL9RBNU+XTY53l7dXNBXP+SwvMwH3AjcA/pwAFKPB+AuzEfT+dQ/azLlrhi8Jtzm56lbf22EP5WOa5qaS3xVjflL/mn2+M/b6vwyhaYQOOtiL3CF25OHnGihqn0rTdqTTsyD1kzwyuDgUoQAEKUIACFKAABShwhAXeLuCmCAXs/+FqU/ctvmrgggzcsJYKuLZqXxBDsV5YOS7c1Ehn9XYBFx24HGJ2hJ9BXHUKUGBPBFjE3RPmyXmQ9MJ6Tpxz/UcW3GvCOq8LvChnbaVz0x+njlz5zba2iFZwWzh5xuAfjryKVnYv5KLBiTUpWsEwWmFytimXhAIUoAAFKEABClCAAhSgwP0KYPyYTxEKqQM3bufgYu8PzTxtQCOPcG4zrPiefS4VcKdEuZ6HHm7XtfZjFHCvmmdSAZcRCvfLz7+jAAUo8IEFeEr8B6Y6XL8Yl6O6snZFm/lZbe7oXEo/GDhfNVlWiCm7YP4u+2xZ6d/O+moqy1UhC1HKIvYRpFBkuSyllpVQopCK0QqH65nBtaEABShAAQpQgAIUoAAFjowAYhLQoIP5JzjvEhm4KMciPCHUoRUtDILfCitxYJ/zlX9e1u72tKowRwUF3IVx+6p41Ty2/Jjvzvg8MmBcUQpQgAL7J5Dt30PzkfdTYPnisnjxwy9GcfKE7DsZy7ISWRTKOcTdOtuoU9lNczOWyom5mMkiZeOKqPAb+IQ43K76L/EdWnuRkZs6unlAYD83KB+bAhSgAAUoQAEKUIACFKDALyNwt4CLMu52ARexeV0HrhE1du5SAXc1DvxzYdC8IMfh7QIuOnAXpxfNmeUzLOD+Mt78XQpQgAIPKMDC2wMCHuQ/jyJKcUGoi5df0z0xU8y2tTbDXq+XZ0W0rrDTft5clx/PtvLPFMeyBZkrjT7dUpSxL9GNq/LtzyITGhPROOzsID8ZuOwUoAAFKEABClCAAhSgwNERSNEJXlgREaKXUnDT3JMUoYA4PewmerflV2PfP+un7fPlSK3rTI2jyOtyXJtXTy+iAxc9uxiefXTAuKYUoAAF9l+Ambj7vw32bQm6F90nkH4kzriwMbahLNo8z8dB6wYv0G3W9lbUSf89O7DfbNfstWA8/uFF3SDg3uEkG4/PXjQy4JQbDjvbt+3IB6YABShAAQpQgAIUoAAFKPABBdIQM4v9OOzDYXgZSrddMTft47VxjL1DZOC6ldi3zyoUcKs2u11GVacCbi6HLQu4H1CZv0YBClBgFwTYibsLqAftLlNH7sXli9nS8aXMrM/qus6zXih6WT3sxZjptmjm7ErxMT3OvlAczxcVOnUz9OMiI3fAjNyDtrW5vBSgAAUoQAEKUIACFKDAkRToBpelAWaIT8AAM3xlg0MHro3owJXowEVb7ggZuBhi5qeb50tfrpc1Crh+XKvqkWbp08IINAGxA/dIPnu40hSgwAQIsBN3AjbCfi9CehFOgfRn18/an61tWNFrrLG28b2pusizRrcz69UJf8lNi+fNbXcDJ9yYYHDE1sgxXvobjyuO4TZ4K4BAfLwJQLbSfq8TH58CFKAABShAAQpQgAIUoAAF7gpgP63bV0PxNmC/TTicTekkCriyja1sAvpzXRpi1vMo4HpEKJTrvivg6nrF6/bK7EXLAi6fTRSgAAX2V4CduPvrP1GP3mXkLgt5aREpt9eva7dW5r3SVoOgy2izoi3q42ZVfyIbqS/oWXUKCblalREduaLXZeRq0VPIykXSLjJy0aO7PfBsotaRC0MBClCAAhSgAAUoQAEKUOBICXSdtyjYhpSDi8Ybj1acVNS1CFBAEReDzaIbpgzc8GwY1C8UdbGWV4ORQGNPOYcMXIEM3CeRgSuZgXuknjdcWQpQYOIEWMSduE2y/wuEs2ikeEpkF8Vr+RIGnoUtXTTGVkpkpUMhN6KQq7bE54pj+WJeYtSZFhWiFbYLubnAwDOMPlOi6IadsZC7/xuUS0ABClCAAhSgAAUoQAEKHE2BexEKKNqGiKkm6MBFJ26KUEAHrmhwCmUMaYjZIDyXCrilLdcLK8ces1JSBu6V2SXLIWZH86nDtaYABSZPIJ+8ReIS7bfA3SOs7sLjF6J49JPi5PQgVFsV8hOsLOrsdnzI/qAJKqo76gvyuFjMYoaDAel/UQbMJ03/y3KZPgvJjtz93px8fApQgAIUoAAFKEABClDgKAog5g4RCsjATdeQgu9SlEIaaYY4POTb4oIC7to/LOCmDNxcP9IuXZ0zS/8DM3CP4lOH60wBCkymQDaZi8WlmgSBpy8/Hf/wxP8Y6+y6kHOllEMj+koL5wubHzO3DXJw5aY6JQrcjGptTHkMqO0KofBVlDLDjQjc7Sq8+DwJ68RloAAFKEABClCAAhSgAAUocOgFtgu4aV6JRynXB48SbribgYsiLkq60Q/Dqui7r4eppuvATRm4edQYYrbQpAzcM//LGQ4xO/RPFK4gBShwkARYWDtIW2ufljUuR4VohUKPp3S/dpXWRVUhI9f06nl7K/+42FSfLY5lSykjNytFKYrYR0ZuofJYyVxVQjEjd582HR+WAhSgAAUoQAEKUIACFDhqAu8o4IbQlW8tEm0tum+baBCjgEtXwB1giFmFCAVfrqUIheh1fWfQmN+cWmgFM3CP2rOG60sBChwAAXRN8kKB9xeQyzKsvHLGLiw9ZKbnMd9M6rrR3pS2vy5PiJfEkrnQ3rA/jta3oQ1GtLLGiTo2ONkGF2sc+cUbBWFxFBiRS7xQgAIUoAAFKEABClCAAhSgwC4JoER7N0IBHbgSxdu3CrhtaCJu81t+RfRsV8CtTLleClWnAq5emG3t5oJhAXeXtgzvlgIUoMADCrCI+4CAR+XPn3ha+rPrwl4Vm8ZNN421RSODN7krNvNcvRr/Sfj39U37nz1mnKJ8a6JRKORi3qmNBt810cU2BATos5B7VJ4yXE8KUIACFKAABShAAQpQYG8FIjJwEZuA3Ftc09f4mPbQ0IEbWixK6sDtMnD9VPt8ZcR6kamxENsduItCmPNfEu7ujJS9XXI+GgUoQAEK/EIBFnF/IRF/4Z7AvY7cn61tWDNvWoeJpaV0bZmVQ52JH6uPxP9gbvmfdrNOMe8UPbko3ooWJ/AYdOS2eANh7hZyPe4zzT3jhQIUoAAFKEABClCAAhSgAAV2QiANMesGmUlk4N4t4lrZxlY2GEAd3JZfjejADQNEKNhyPUScQYkCrs5qdOBeNWIZPbtScj9tJ7YF74MCFKDALggwE3cXUA/7XaaM3CtrV/T4kbO5vbHVm4u218YcabjttLPy1+Kr2R8WC+pXskL1lJZa5LFARm7Kyu2pXJQqw0cpckw8S4PP0oEEPg8P+5OG60cBClCAAhSgAAUoQAEK7J4AIhTQeWtjysBFhAKKuE6kphpc0ZUb3BAF3L57NgzaroCbMnClLhqdzbRXNy+hA/c8O3B3b+vwnilAAQrsiACLZzvCePTuJBVyLwuRZ+PVciNri+O+1xMxK50KfTdlF93fqs8UWf6xbFaeULlCEVegnCsroSOKuPhOobCb4RaVirn4yELu0XsScY0pQAEKUIACFKAABShAgQcXSIPMMIMEvbddeAK6cRFqJxsE2tUpzq7rwB2EtzpwPTJwqyYfd0PMPooM3C8yQuHBNwLvgQIUoMDuC7CIu/vGh/YRkJgvv/5vrhQPl9N5o/tVv7X9KssKE+pSVNlxe0t+Sg3V54qZ7JTS+JenUm4sRSZSZ66WGQq6udJ3u3Kzu125h9aLK0YBClCAAhSgAAUoQAEKUGBHBVIBN80eCdKFEBzKsSa2osZsEgyXjtFvhe0hZsjATREKqQP33hCzlIHLIWY7ujV4ZxSgAAV2VYCZuLvKe7jvPOUl/cH8WZtPLdipcrpVM/loLH2rQ6/JhnIlOxm+awfhz91GuO6RkOvTkLPuDUXKyo0Gs1IbDEFrosfoMxwthlbKyuWFAhSgAAUoQAEKUIACFKAABX6RwN0IBRRwUxeulQ6fjWixp9WgsBv8ll8RA/9cGmL2zgLuih+3r6YCLjNwf5Ewf04BClBgogRYxJ2ozXHwFiYNOzsnhCuOX7FuULdSZSOMP61b7U3R9NaLhfCS6Yev29Xws9CG7g2FaOUIby7qVNINVta4jpHZhMFnKOTijQgUGKZ/8J4KXGIKUIACFKAABShAAQpQYK8E7hVwUbztGmSQgIvWmDoYNMlgdwoZuGui777eVttDzPIoRx6DqTUKuFunXzWPpQKu4BCzvdpcfBwKUIACOyHAOIWdUOR9iJSRKxZF9jc/vln0p3Q2Htoqt0WFANxiXJrZMI6/4n4k/lVvUf8KEnIx4KwbeVZKDD0TuciRk1ukzFyk45ZKpcxchC4wJ5fPLApQgAIUoAAFKEABClCAAu8UQIBCGmKWIhSEC+igEREduC06cNtYox8muq2wGgb2G7HXPl+Zct1lalzEbJTLYXtl9op9bPkxFnDfKcqvKUABChwQARZxD8iGOgiLuYxC7h+hkLt1/bXspBjkvik0wnIrKUxpM1/FaXfavqI+V+r84/lAHVN5lssCA87yWMkMA85QxEVpt0IBt5AKY88kyrsKSbkRV14oQAEKUIACFKAABShAAQocZYHtAWYeKbi43i3g4mzGYGODcARk4Iroh35VDNxzvt8+LxtxezrrjUOJDtxq3C6eW2zFEwhfYAfuUX4Wcd0pQIEDLMDi2AHeeJO46GnY2dNPPK0effTRrBbHclFXes7rsh6bUom8NNPDk/5G9gk9yj+jZ/OFTHcduEUaeIbBZ1pqUaZuXJmjXzcVdlMhV6KUy67cSdzcXCYKUIACFKAABShAAQpQYC8EugJuKt5KdOAijA7FW1xdsKLFxJFxQAduQAduHITnwmA7QsELVVf3CrhicTsDlwXcvdhafAwKUIACuyLAIu6usPJOcRBYigtCvXZZ6LFYyYu1Xk8p22tsVpje+JhfUZ/Uo+zzei5bRLRCV75VheihK1dHJXWuJQq5okRIg0ZRF8VcfGQhl08sClCAAhSgAAUoQAEKUODoCaBCK7bjE3zwMgiDMAUEKcgGQ8zaVL+1W34t9t1z8R8MMdMLs+1iGmL2JDJwMZj66NFxjSlAAQocHgEONjs823Ki1iSdoiOfkP77rwhbrJ2wa8K0G0HXeO/RTpneejnvX7KV/abd8DdSjlMK4xdG1ngjYtKbEudi6x2OKXvc7qVNuU9YQb7pmKitzIWhAAUoQAEKUIACFKAABXZdIO0LdREK6L1NHbj3CrjIwEU2rnebYQURCs+mAm6KUCjRgRu9rvXCuL127ZJ9SqB/lwXcXd9MfAAKUIACuy3ATtzdFub9iwuPx+zEo69pcWuQn+5VlTJ51Yit0vfCvLupzucb2WeK+XxJ5hIpuSpHtEKFWAXEKSBeIe9iFgqhELvQdeRi4Nl2vAJlKUABClCAAhSgAAUoQAEKHG6BFKOQOm8RoZCaW7pBZibWARm46KsNaYhZHPguQuFeBq4Qdb2e6fY3pxZaduAe7qcH144CFDhaAtnRWl2u7X4IXLi8LL5/Yi7+6sx1EQotglEx1whcwLyzYiqshEG8aX7m57JKTiP9NkMPb+q4TdfU0JuSGUL6FkeP8X2XqZA+8wDEfmxMPiYFKEABClCAAhSgAAUosDcC2wXc7bMS72bgCmTgIkAhdeBiiFlYDX339TjVvPB2AVejgBtau3nVnP7vT3v5FCMU9mZj8VEoQAEK7L4AC2G7b8xHuCsQl6O6chwZua/fzJu6j5Zc2+vlWWFF3XMDuWD/Xn220vnHsyl1HCm5udJKizxUqUM35ePitgol3jT4LE9XlHEZB8JnFwUoQAEKUIACFKAABShw+ASQQ7edg4vgOR8t+nAd+nGRgYscXBRw3dCvSmTg+n77gjRifSpUI6mbRqMDd4EduIfv+cA1ogAFKAABFnH5NNhTgRSt8OijiEQQK4VvCp03thI2L2K02kzbk/5G9gk9yj+j5/JTCuEKmRYIVkC8Qp4GncUUsVCgmIuBZ7FQCqVdPof3dPvxwShAAQpQgAIUoAAFKECBXRbYLuDakCIUHHpvU4yCDW1sRI1HDh4RCmFgvxFRwFW1vD2teuOY5+Nsdqa5dk3Y818Sjhm4u7yNePcUoAAF9kGARdx9QD/qD5k6ci8topB7/boWdaVLFHL7QpdtdKXJ/DFMQftUUevPF7P5KRRtsyx15Baxp7QsRBa1zAQKurLqMnNTRy4LuUf9KcX1pwAFKEABClCAAhSgwOEQiMKnzlsk4TqUcLshZvj4rhm4VVPeLmNWCwyQznvTzdXNS+b8l86zgHs4nglcCwpQgAL/SIBF3H9Ewhv2QiDGKC8+dTErN85q5fq6V9oqt0UlUci1VZi3N+TH9TD/l8V89kgXrZB1A89KDDxLBdyii1fIUryC0F20Agu5e7HZ+BgUoAAFKEABClCAAhSgwG4JdAVcdN6igBtRwA0BH41o0IE7DiLGsOUxxMxhiBkiFBpxeyb2uwJuEZt25eSKOffkOcsO3N3aOLxfClCAAvsvkLoYeaHAngukNxeYWOYvLl8US8cfC/7qapR5Hgyqu7op1+Rp8z3Rhjv1j+PvV/PZh2IpBioqpD9FJClg5hn+h2lnQqX7SaPPUMzFtzwosedbkg9IAQpQgAIUoAAFKEABCjywQCrgoniL/Zyfz8BNg8xw537Lr8U0xOxuAXc6Q4SCyOvNtjEiFXDFOXbgPvBG4B1QgAIUmGwBFr0me/sc+qVL9denH39afezU47mZX9HDlaqcHbSlGOvS67rvprLj9o3w8WJU/Et9TJ3GsLNSFejG1cjJzVTqyNWIWMDQM4QtKFEAjM/pQ/+s4QpSgAIUoAAFKEABClDgEAlE9N6G1IGbCrgBEQrSIlABHbiIUXirAzegA7d+IUUoBEQoVMjA1VndLnx0wYjrSM1dlqnHhRcKUIACFDjEAuzEPcQb9yCsmhQyiqdx1Hk5xkuLJ0I1FAi9da7NLUJwqzC6Y5psPuLwsrVyQ/+BnpOnBaq1qP3GmOOUIrzhwdsVvLcJAYXc9CONMi5+gRcKUIACFKAABShAAQpQgAITLoD9GXTfpggFH5CGKzDKLKYIBQwyS0sehn4tvKMDN0SDAu70dgF3aqEVX0QBF2cnTvhacvEoQAEKUGAHBNi1uAOIvIudEUAugrz81GU9s3EuM8XtInpdIsG/rLKsGMl6Pq7qT6rb4jF9PP9QVqk+unBTJ24us1ggGbfMcJUK1xStIJGWywsFKEABClCAAhSgAAUoQIFJFXirA7cr4LrUiZsycEMbx/g6uKFfFYPwnO/b52XjbqcIBSF0nTpwr25e5RCzSd2uXC4KUIACuyTAIu4uwfJu708gFXIvPpUKsK/lJ8UgV21VmqFFU25WKmGmw1w84S+rL+RZ/nE9UMckYhTw2/gYS4w7Q8RCrNCRW3TRCkqw0/z+NgP/igIUoAAFKEABClCAAhTYTYEuAxdF27sRCgEduMLKJraxTQkKXQG3557zvfZ5acT6VKhGUjeNzjQLuLu5XXjfFKAABSZYgEXcCd44R3XRUk6uWBbysric3xInijNC5+ORrSqTF41yRZyKC/aa/EQ+zj9fzGaLIkul3NSTi5zcXJQo61YpOxeF3BLBCizkHtUnEtebAhSgAAUoQAEKUIACkyiQCrcYYIYCrg8uWEQoIANXonwbakQrBLcVVsWU/brv++erJrtdZGocSmTgVrPt4jVEL3xJcIjZJG5XLhMFKECBXRZgEXeXgXn39y+QirkXl0VWblzVx3WVI76/EsKUjXCl6PljdjX/dLalPlscz5eUUijlIlohRSyU6MjNEamrRQ/l3UJKxCvwQgEKUIACFKAABShAAQpQYH8FUoCCRwHXY7LHW0PMMMoMI0BEjZ8EvxVWxJT7cz/dfLNsyjV0pdQpQmEdEQq/mTJwn2QG7v5uQj46BShAgf0TYBF3/+z5yB9QAEPP1JW1K9rMn9ViY7PIrKlinhem746L1v+qfzX7g2o+/xBKtzNZgaJtKuRqfFeKvkIxF526hVK4VSAplxcKUIACFKAABShAAQpQgAJ7LxAiOm9T9y26bTHCLDp85fDRhCaM0u1+HDZi5b/mZ9zzcmTXfz4DdwEZuOzA3fvNxkekAAUoMDkCPNV8crYFl+Q9BOSyDMjKNZe+jLc2YiZkd+6EQttQYvpZE9zf5J+Ib9ZvtOf1Hf1ZeUyekkFGiT9QAmNaIz5gqCvuIOXkakxuVe/xMLyZAhSgAAUoQAEKUIACFKDAbghg7+TnCrgWRVyPnloTUoQChpgFE8fe+x/EOXOxHOdrPut1HbibbWtqhwLuaXbg7saG4X1SgAIUOEgCLOIepK11hJcVxVe88YkOhVzx0MxcvHnzduyFXEyH0o82bC3nwxjnIzlxW/y+nstOZVKlSm4dMBVA4qQlmUmP7tyAjNwC/bgYnMYLBShAAQpQgAIUoAAFKECBPRDA/kj3bztMAR24dwu4dRynWIVgwsgZ9z31iP3TONS3KqcanHlYa0QoiJNr9hlxwn8CjS17sKR8CApQgAIUmGABnl4+wRuHi/aPBVDIlRefSkXY13I9ntLTwfdyW1Raqdz264eaG9mn9Gb+WT2nTmG4WU9qRCsgXgEhCykjt0Qxt8KoM3TkdgPP+Pz/x8S8hQIUoAAFKEABClCAAhTYOYGIGAXbZeGmgWYuWnzXhlagAzf60MahN/4l+eH6gt4srwpvm14+Nc7rpjnhTrQideCygLtzW4P3RAEKUOAAC/DU8gO88Y7ioqeO3N9blm7lle/bhfqOKVVW53k+HgvX6nFvtbcg/zJ8uP2qMfY7buhXIk5QQnJUi1EBY28i0hdCE3GsG8e+bZr8ehQNuc4UoAAFKEABClCAAhSgwJ4IpAKuw15Hl4XbRSg4YVG4rdGN694u4Nq7BdysCUHWm1nbrpw8YZ46/RQLuHuymfggFKAABQ6GADsRD8Z24lK+i8C9gWfjcjqXeVXkja2qLC9q0QxMPxyLt/Lf0sP8C8WMXpCZyLuu3EKgOxdDz7JYqBz9ucjJZbzCu+DyJgpQgAIUoAAFKEABClDgQQRShIKL6LZNhVx04Lrt5pJYp69RwB05a78vHjEX1G3xxnRWjcfWNHO9vHmo/1CLB3bswH0Qfv4tBShAgcMnwE7cw7dNj8wapTc1Z+fP2nxqzZpqttVzD428ycd50Buqzq6ph8L/a0v7TLNqXgvpeDdOW8K/kWjlEG+hWrydavGGyqQ3V0CLRwaOK0oBClCAAhSgAAUoQAEK7KYAOnC74m1XwE0l3DTEDHsg47sF3KG39qXsw/5Psq3yailVq2zRICiuuVM/ZLBgTixz/2Q3NxDvmwIUoMBBFGAn7kHcalzmnxPYzsm9mNVrS9mH52e1uaPzOa0rxEv1fKFmnZG/Fn8k/7CYzz6c9bMZlctS6tjDx17qyJUZ0nJVRKwu0nMlRp/xQgEKUIACFKAABShAAQpQ4P4EsHuCIqzHvxgQmiANSrgW7SPjFOkWmjAK3v8gLDUo4MqrhZddBm6mpupbfdG+8srT/vGnHw9SYDwzLxSgAAUoQIF3CLCI+w4MfnmwBaKI8tIXL+Xzp89naK0tNrauF9OhKEMVB64MD7k34yf1SH9BH9dLmZalyCKKuRJF3G74mZaq+zrFK6RCLv/bONhPBy49BShAAQpQgAIUoAAF9lrgHQVcpN6ihNtd6zhCAdcEExrXuu+ID5uns035Rirgxqjq2WN5vb623qazDBmhsNebjI9HAQpQ4OAI5AdnUbmkFHh/ge5o9ZdxlDtGd/mpy0FMH3Ntk3vMdnWubevsVNv6FR/juvycnlGnVam8wlHymAmHqm0ZVYhKqIASrpZSZOzKfX9v/pQCFKAABShAAQpQgAIUeEsAPSX3OnC7Aq5FAddjwHJ9d6iyt2vudfkb7t/7NXm1ynp1jKaJ1bBZP/6R9uwrx538nyQHL7/FyS8oQAEKUOAfCrCI+w9F+P2BF5BS4gymaC8ui3Dc3ZQ+aF/k2mcjcauZdX9hBu5aWFP/TDfZf5nPZCfSiUoBpyshZiH9XRAZPjNe4cA/D7gCFKAABShAAQpQgAIU2COBiB0KxCdsX+924GIChxxHG0zKx7Wr/nV1xl0wK/b12aJoKtHW+phuxhuFXTqF4u+FtEuyR0vLh6EABShAgQMpwJeJA7nZuNAfVODC4zH72Kkrue/NFdKXpQimi1ewvTAfbqjf0cP8D/RstogCbi4zqUUeC5GLUmUi3YIZA6LAm6nsgz4ef48CFKAABShAAQpQgAIUOFIC6ANBmTZIlwq5MQREKCAHtxVNTEm46Ma1t90bctF8RUb3svLFcC4fjLNBO94Um+aMOJOGLAfGKByp5wxXlgIUoMB9CbCIe19s/KODJJAGn33931wp0tCzPoaeDaMpe1leDGfMorxVfDpbV5/N5+RpVSgMOhNa5SpHMbeSeSyVVkWUEXm5KOrigvXmfzMHaeNzWSlAAQpQgAIUoAAFKLB7AilCAXlt6MBFGbcr4jr03rZy1I0yC9GZVUQoPGy+6ox7uVTFsEAGbhR5LebmmjOvCJs6cNOZhLu3iLxnClCAAhQ4LAKMUzgsW5Lr8Z4Cd+MVDOIVfCmv6uNF5UfBxrIRt8K8/3/8QFwzq/F38yb7jWwqO47j6LnEKU8qSo9zojwKuBY5uQX6cZmV+57K/AEFKEABClCAAhSgAAWOlEAXoYCGERRwUwdul4frhJU1xpmZlIpr1t3VVMAVzl2akvkW2kLQnZs3uRy2V8RfuTMXHmMB90g9ZbiyFKAABR5MgF2FD+bHvz5gAvFCzK78xyv5TcQrzGdloRpT+Tz07QC3OFyHAABAAElEQVTl3GvqU8Uw+309ly+qLlpBFDJPV1mgQxfduSlmoYtY0OjHxSw0XihAAQpQgAIUoAAFKECBIyjwdgE3SsQnoJDrBTpwRY3vDAIVHAq4r8sPmT92tXt5WuutOFa1KHRTztVmUSwa8aTw7MA9gs8crjIFKECBBxBgJ+4D4PFPD56AfELidKcYzFOX40ic81l9x0/H0mYb7bhdiNai89avuN8r5rKlLl4BR9UV3pDFPJQqqhAQeIWTnWJX5GVW7sF7AnCJKUABClCAAhSgAAUo8GAC74hQwL5FCB49uBhfhi5bFHDTUDOHDFz1CDpw7XYBty9VPSpG6MDN22vXltzil1jAfbBNwL+mAAUocDQF2Il7NLc71xoC316O+bS4XvTEovI3N3QxbXs+c3OuL0/5v5OfL/PiE/l09lDKye2uWhRKy6rryMXQM6FigaPnqSOX/x3xGUUBClCAAhSgAAUoQIHDL7BdwEWjR8rCFSEghC0NMYsN0tpSEdfZdf+6+rD/v4Rpf1CJ6a0oTS3sdgH3yuwV+9iTj7ED9/A/T7iGFKAABXZFgMWnXWHlnR4UgeXlqJ4UQl1CMTe70yvyqMsst5Xtt6fCDfHbeqS/oGfzU1J1gQoa8QqYRyB7SosSMQso5HY5uTnjFQ7KFudyUoACFKAABShAAQpQ4L4E3i7gpgzcGB3KuBhjJtrQxjp9bTfddblo/k/Xuh8MisFGv9a1rkyz0dtoz5w7Y8UTGGImOMTsvvT5RxSgAAUowA5CPgcokARSVu7V74jiZnG7mHa5FsGUw9KcUqv5b4vV7J+Wc2ox68lZWahKISNXaNFTKOiKPBYqQ38uirn4rymjJgUoQAEKUIACFKAABShwyAQk+m6DCDF2w8tQwEWEgpdWGNEgQKEJKUJh6FdCz31N9MfPD1zvTmjlOEzndWFGZunTS4YF3EP2nODqUIACFNgHAQ5n2gd0PuTkCaSs3P9tVrRbOEru6qZxQtczobxZnPDfFr/R/M9N0f7fdsPfiC6YdLRdWIGps3jT5nDkPZ065fEWLk2kRT148taOS0QBClCAAhSgAAUoQAEK3LcASrgxRSh0hVy880cGLoq37d0CrnfDsBp77tlsuvkWej02+nF7iJnqHWuvzC5Z8Tg7cO/bnn9IAQpQgAJvCTBO4S0KfkEBVGAxt+zSvxa5nhGFzDcKWbcFBhIU7UCekOv57xTj/PeLY9nDiFKoEK2g0YWboxsX0QqxVFoViFco0JWbBgbyvy0+oShAAQpQgAIUoAAFKHDABfCm3qe+2y4DF1PM0MRh0dRRh1YgQgEduJt+JQ7Cs2ravqC8Wi8xxEzapslms2bx3GLbFXAlIxQO+NOAi08BClBgIgTYiTsRm4ELMSkCGFQWP/FladenRHusnW2qkNe9/kxb+nJFnnLfddPu681N9xM/9uvR4M2biek6ChanS1l87UKDo/QG68OO3EnZqFwOClCAAhSgAAUoQAEK3I8AhpchKgEF3Nhl4EaHIWaIULiXgYsIhdU47Z4Lg80XZavWyjoVcItGZ7q9du3adgcuC7j3I8+/oQAFKECBdxFgt+C7oPAmCiSBlJP72mWhxwKdtRubhRW2F5SdVdPxeLimPl5uFZ/Xx9WSVFmOTtw09KxAH+4gDT1DOm6pMmTnsiOXTyYKUIACFKAABShAAQocRIFUvk0duA5n621HKNjYIlitRj+udZthxffbr4uBfQFRa+vTthpLXTTlbGtWxIo5J845uSzDQVxxLjMFKEABCkymQDrtmxcKUOBdBFJOLt6whUv/+pI/ffp8uHnnTsiks2Kt2MweCmOnEIJ7K/yLYjouqF42rYIMCu/yQpBRFml4LT6jmIu75sGSd/HlTRSgAAUoQAEKUIACFJhIAXTgYoiZx7Kl/QGPIm03FwNn4DW4FUPMkIHbt8+JwfhFYfX6jOjVQmt04Nbtiliw58QJFnAncsNyoShAAQocbAEWlw729uPS75FAXI75JXG9cGtlPhtqLQdl2Uh3TExnx8TV8Ml8S39ez2UPZzorRIaM3EIiI1f0hRYVCrmFFJL/re3RtuLDUIACFKAABShAAQpQ4H4FkF7r0GkbRJTowk0ZuNJgkFnj6zjGeDPnt8KtMGW/4QfN87KVtwsnm96UqDc2ivbcf3GiFV8ULkW03e/j8+8oQAEKUIAC7yXAwtJ7yfB2CvwDgQuPx+xjp0Ru/IpWsiqjbosms4Xsy5PiVvY7+Ub+WT2nFlWh+ijgYjAaCrmFGEiNIWipI1di7BkvFKAABShAAQpQgAIUoMBECmwXcLeHmMWQwhSii1a2mHoxEjgJz9fhji/N18JU803k4q7N6X4zGrXtsV7eLHx0wbCAO5GblQtFAQpQ4NAIZIdmTbgiFNhlgacvPxXn/9Vy/MjZQRCbd2KrtZ+NPeQmYIxB5W+GqfiG2/JKGjklM1UiTwFnXyEHS8YMR+NxQRmXhdxd3kq8ewpQgAIUoAAFKEABCtyHQIpQSB24IUWqhZSGa2OKUTBilEq5EcOMvTEv+RP2a5WLqz3VG8usaKay0LKAex/e/BMKUIACFPilBdiJ+0uT8Q8osD307MoNka/9eL18qCyqOpgylu0A2bjz5ob47XIr/4Ke1afRkYuBZwrxCnEKEQupIzdHMVezmMtnEQUoQAEKUIACFKAABSZEAGMtugzcNMQMkQldBq6LBh24iFBAvEIbR8aa76pH3J8UG/6a03Hc24q1XtDttWuL9vyXGKEwIVuSi0EBClDgUAuwiHuoNy9XbjcFlpej+m+PC23WV7TYaAsZj5et2CyLOXHSXM8+LdfVY+Vcvpj11CyKuRWKuD2Zx0pqhCyomCuJki47c3dzE/G+KUABClCAAhSgAAUo8P4C9wq4KT4BQ8xSBi7KuIhQCGN04rbBhJH3/vv+Q/WFbF28OZ31xkLoOhuNmsXPLrbiCfTu4tS7938Q/pQCFKAABSjw4AIs4j64Ie/hCAukLAWxLLI09EzUle4F11OZr6KSU24qm4/XxCeRlYuhZ+phZOQWKhVwcww+y0WpMpR1MfQMSbn5ESbkqlOAAhSgAAUoQAEKUGB/BLoIBQQnCFw9CrgpQsGL1IE7RAHXCh+st/Ylt9T+sbwT35jW1Vjapslms2bxHAu4+7PR+KgUoAAFjq4ABy0d3W3PNd8BgXTUXS5L99NXFltjRqYYZONaipEfTa307qif+Fl70Uy558Y37Y/cMKz5xo9jG4ehEVvBhhpvElskb7XIzw07sDi8CwpQgAIUoAAFKEABClDggwhsRyd03bepgBs8cm9RwBUYYob8W4Om3GDu+Gth2j8fb7sb2wXcolnPdPuqeNWIx9mB+0GY+TsUoAAFKLBzAuzE3TlL3tMRF4iIV7iydkVvzA+yqbHOvC207OVljJvH3HScF1ez38q3CnTlZqfRgatTF26KWFA5PqNLFx256TYNRv53ecSfS1x9ClCAAhSgAAUoQIFdE8DJdHeHmMU0xAzhCQ4DzJCEi+xbdNoKkyac2TX3unjYfAVRCn89KLKNchhGeS9vrm5eNedPn/do5GATxq5tIt4xBShAAQq8mwBP4343Fd5GgfsQSG/k8I7QPP24UI8+KjI3vBmmfOGNGhhxfXMznpStFc7bm/53y9n8VNaTcwoduD5IKzEBF/EKOJULnb3bhVx2yd/HNuCfUIACFKAABShAAQpQ4H0E0vlvHgG26MDFVykHN6B461ISrqjRf9viZ9Gu+zfkI/arztR/rWN/K3rZlANtHrrzkPlfTy/4T7CA+z7E/BEFKEABCuyWADv+dkuW93vkBe515o7L6Tz3vbLQrm9KM9v2xEPZm+pT+WbqylXoysWoMxRuI7pxs0L0pJYVMnMLAGZHHpEAFKAABShAAQpQgAIU2CmBLkKhK+CmZtuUg2tT+Ta0GGJmEKWAAq7bcNfjafN/IAz35emYb4WRqqPWjZk/3px7UlgpOcRspzYH74cCFKAABX45AXbi/nJe/G0KfGCBrjM3RnP5qctR3Dohi7KIsp7CfFuzKY+bsRMYlHDT/ws9my9mfTUrYwxByKDQFoAOAImOXHxIH3mhAAUoQAEKUIACFKAABR5I4J0RCiGggCsRoSBtNJhTgSTc9BbcjfxamHZfj7b+6ylfbYZWNTKM0J37kZYF3AfS5x9TgAIUoMAOCLCIuwOIvAsKvJfA3SP15tvLMfSFcG686opoQ9OW18WsfUEshpfNzfhb+nb++XxOPYw8hhCDDDi+79GNW6UOXYmsXKTkpq55ds6/FzRvpwAFKEABClCAAhSgwHsI4E20R7cEIhSQgYsOXOTfGnyHDtyYCripA1f4kV+PA/uMmm6+LRq5EYKshdZtNv8R8xHBDtz3oOXNFKAABSiwhwIsCu0hNh/qaAtsxysIbfyK9jOFjq7RKuhSzcRFuxL/mVrNfreYU4uqUrMYdlaqQlYIWUAhV6WhZzmKuRnKuCkrl//dHu2nEteeAhSgAAUoQAEKUOCDCnQduNsRCgIduAhRMBHDy/BvHExs0EEh4lCs+in7nB9svajHg7Uik+NYDxt1WrVnzp2x4gkR0FOBk+V4oQAFKEABCuyfAItB+2fPRz6iAt9e/jY64M/kx4dnstxvdlm5I2TlKmTlxu2s3M/pY9nD6MItJHJyUz5uusYsois35efK1JnLmIUj+vzhalOAAhSgAAUoQAEKfECBtwq46L4NwnXdtxY5uCaOYosyrhTRDxGh0HPP+ul3FHAr3ajeRntGnDFiGf27LOB+QHD+GgUoQAEK7KYAi7i7qcv7psB7CCwvR/VHiyI7fV3our6tb7tcT4c09swshlvlP5Wr8TE9h6zcSs6ikKvT8DOpY4nPqbCLz3djFt7j/nkzBShAAQpQgAIUoAAFjrhA6rpFhAI+pgiFLgMXhds2jrsYhRiRgRvWY989J2frF+QwrpehX4tCN7kctt+5umSeeFr6I27I1acABShAgQkSYBF3gjYGF+XoCVx4PGaPPno5c8N5LfOqyBtbxZ475qazeXENWbmb+nP5bH4aIQpa5SjfpiJuEXvozC3Ri1t2XbmMVzh6TxyuMQUoQAEKUIACFKDAuwpIdNei6zZEdOGmaRO4ui5CwWGQWRvqYGWbfiNshVXft8+F/ta38nawmiIUpCzazby161N/1z725GP+7nyLd30c3kgBClCAAhTYa4GUr8kLBSiwTwLp6P655XPWbl41phq34/+fvXd/kiOtz3zfa2Zd+6ZLSxrhlbHGXmuAGSFgZli8jAOvfTbCv4o/wfy051+Y5l9wHK8D4kQYn/B615qwjbn6YJgR4Fh2A8vY68MY7FkjoNW69EXq7qrKzDfzfd/zvFktMZgZmEG37q6na1p17arMT+ZUVz391Oeb60nh4q3OuvoXfVx/tZ6LXyhu1P/k0RIIafRCE6oAfxc8XgX6BBVekNZYdPq5HtP248OSAAmQAAmQAAmQAAnsKwKpd9sOL8MrZLRwRYOhwXV6zQyFQonX0WUKcJNCITlwU4CbO7vVMbpMAW6+ULj37Cy7r4qvBga4+2q7cmFIgARIgARAgE1c7gYksE8I3B18NslvonPbyfKq6bm+mAuZOxpv6vebbftb2aI5ldq38ONmECzkOhM99HM7bTOX/z/vky3JxSABEiABEiABEiABEngsBOC9bRu4UaCBm4aYtQGuSwFu+41L/ShsxGH9l75f/hVi281QV2XXzxV2eVKtra3VF05d8HJFhsey/HxQEiABEiABEvgpBBji/hQ4vIoEHjUBqLnklY8JY+duZgO9bJpm1xZw5apBPOE344fUuvr32TxcuX21AL1CJozoqFwMEOh2FJQL+LMM2/WPeqPx8UiABEiABEiABEiABB4/gXaIGTq3U43CNMAN+PxaLctQYpAZBAthEu6Ebv05Pyy/HMdiaz52C2mz0uqiWsUn4y584kLDBu7j35RcAhIgARIggTcmYN74Yl5KAiTwOAjsvWis48UYXvs1YZrvlF7NZT6r6uvl0H/Zn2q+Va3F99st81t2QT0hvQwhSK88RAs2dgRaukqhl4sRulh+/pHmcWxEPiYJkAAJkAAJkAAJkMCjJdAGuNAnCAwiSw3cAP9tUig0UI+lFm5ANdfFSVPXf6OW3eU4EltD3YUDt6x2qujOPb3slq8v04H7aLcaH40ESIAESOBtEmDI8zaB8eYk8KgI/HgrNzNBoSZQuY6fcyflevbBuB4/nKdWblfNa4tBZ1Z2FY6hV8jSIDSpMPpM4RAZ5j6qbcbHIQESIAESIAESIAESeLQEJLy3AZqEew3cgPDWRwS4shZVnIQmTZWIo8a5/yl/sXnJbjbXcjRwo7dF3i/d5mCzPifONWJFRPQgOGvi0W4+PhoJkAAJkMDbIMAQ923A4k1J4HEQuOvKdX7dFt2m0zWiJzI5rLriqFpV78t27G+aRfOE1CJTVkGxEDvK4BYaegU0cxHmpmZu0izw//fHsQH5mCRAAiRAAiRAAiRAAg+HwD0HbpIliAY93Dqgfdu2cCs0cPFpNcS5GA7s/2c4Pfmv4ZZYHarORNoSCgULhcKyu3AKDV4GuA9n+/BeSYAESIAEHigBhjoPFCfvjAQeDoGYigGfEObVv1/PRZ5nuVZmrFxme+F4fT3+mthSv2aHkOgO1FGNgWdCY/xZGn5mps3cqKJNl2Dp0je/SIAESIAESIAESIAESOBgE0juWwS3iG/bABfn6vSdmreIbyciDTWDeMxt+O+LZfepRoV/WFL5aOTKcrFryuUnl524jltxiNnB3g+49CRAAiQwQwQY4s7QxuaqHnwCr6y8Ys6IM2Yi+mZQZnbkXe6NWgh9d1Ss2feb2/oFO69PSjR1EeCimSuhVxAdoaJROOxpFu42cw8+EK4BCZAACZAACZAACZDA7BG468Bth5jBgZv8t1MPbhMryBMgUhAh+hoBbnxH9V9FqP8ua/R2N8wVo/6a8z1fJYUCA9zZ23W4xiRAAiRwkAkwxD3IW4/LPpMEWlfuJ6FIuC7s/OaWyfpaF6HuBqOXmkF1JK6p99s79j+YJfOOqVZBGbRyoVaIyZdrpUbEm1QLVCzM5P7DlSYBEiABEiABEiCBg0sAytogGyw/hpclDy6ECUmZ4KVDC7dJQ8y8Ew7DzZr6jl9TJ5v/x4fy77rOjrpqODHdsrxTHHVnj6C1+yI+6ibpwD24+wKXnARIgARmj4CZvVXmGpPAwSaw92KzXlmJ/uKRJTMZ3bTSdMRAmPXdO/GOXnSTJsbQ3Go+nA30Md0Li2jjevhx8SkyhLcGXYUofatYULhmGuYebChcehIgARIgARIgARIggcNPAAEuYlyPlu1dhUIKcFsHrnTo4Do0cNPr4N24IXrhi6Jx/9ARdhcBbjESrhLFHfetG0ebs7/LAPfw7yxcQxIgARI4fATYxD1825RrNEMEkiv3Cly5p9DK3ZlsaF9nthZ113bkfN33S/FaeJ/dzj5ih+qE7qihQBMXHd5cYfhZOo2OroViwUiJSzn4bIb2HK4qCZAACZAACZAACRwwAql1G9HCRYCbVAlThUIaYibr1MBFgJsauN7vxvWQVZ+N8/5yt5JbwugyFrZUp7YraMkch5gdsO3OxSUBEiABErhHgCHuPRQ8QQIHl8Cli1E/9RSGlt1az3zMbGO0sdZ1VMcfUY16Z3TiV8WWecEsqCeSSkEiuE0hrrQxVwrHBooFhZauagef8Xnh4O4KXHISIAESIAESIAESOHwEUoAb0MBNnyaL0CfgAJlCG+DuNXDLNMSsbeB23edir3hF1NlmBwHuosyqkVyoXpsX9QsrGGQmqFA4fDsI14gESIAEZoMAw5rZ2M5cyxkh8MpKNGe3hR3bDTPydd7z89Z06q7rNUfiuvz34lb8sJ0zyxqfKYMb10gTU4CbI7rN0iA0HKdQl4qFGdlfuJokQAIkQAIkQAIksO8J3AtwW43CvSFmOOdjHR3GmJVo5tZtA7fr/rLplC9bl23muSokAtwdU9XvGSxXWM/AQWb7fmtzAUmABEiABH4KAYa4PwUOryKBg0ggKRZeXXnVNqMjNjS5hWChI3FC9/RC3QlLzar+QDayH7Hz+gQ8uSa1chHmZujndjAILQ0/Q6gbM7h39UFcfy4zCZAACZAACZAACZDAISEQ2wFmaODiGA1ckTq4HvKENMSsjnWA5RbXBT8Jd0LmPuP7o5dN0du4G+Dmk8LdPnW7OSfONQxwD8k+wdUgARIggRkmwMFmM7zxueqHk0D7EbEV4dDKDfn2aujK034krje9XeXUJLsjj1aTWjRVfc1/EEHush3qJbz4TTN+vTeyVhnMYhaX3NUu0JV7OHcUrhUJkAAJkAAJkAAJ7GcCCGcjvlNIK+BKaJu3KcANCHB9bFKAC8lCHSsxaermm35p8jVZmK1uqCrppLPL3q1NTtYXxEnPAHc/b2guGwmQAAmQwFslwCbuWyXF25HAASSAxoK88rErRpw6Zec3c/zRJsud2u3WnXoo+3YpXFcX9Kb5sJ03J3WuBmjitoPPZCZ6kCpgAJrKkkNXSNhyGeYewD2Ai0wCJEACJEACJEACB5DANMBFAzcNMZNo36KBGzC4rEFomwLcUkxEky4Prhk1XxfvmPyZ2YmrWd4r9G5Z2UVbLT+57MR1OHBXZDiABLjIJEACJEACJPATBBji/gQSXkACh49AXInqsriand6cy7azKssbrbXxHZF3hs3AHwk/DBfMjv3NfMk8gcAWI88gVzCygzC3q+DLhXbBSgnJgooaTV8+bxy+XYRrRAIkQAIkQAIkQAL7g8CPB7gYaJYUCtElmQI6uQ0MuBOIFBw+SBaqG+5/q191vyc34w+GsjuZBFctnjLlsZPHKga4+2NzcilIgARIgAQeHAGGMQ+OJe+JBPY1gakrV8CVe9MOdGait3mjSuOlNi6rlvWG+TWxIT9kBvqYGagllYJbDDvDv5lAKxeDfFOwa1uHrsS/03buvl5nLhwJkAAJkAAJkAAJkMABIvD6ADe2DVwIv2INlQJCXJx3sUSkW6eGbr3uvx9PVX/sffW3vZCNO3I4GfUrp4uj7uwRUbOBe4C2OxeVBEiABEjgLRFgiPuWMPFGJHA4CKQgV1wS6uqrwl6bbNi+M3poTFaEnVxZNVd342JcU+/Tt80LUCws655cUKmXi0FnQimtTMxTTxeKhex1YW56HuFzyeHYRbgWJEACJEACJEACJPB4CNwLcNG3hQEXOS3Gl0kMMUsKBTRwEeCKCiEuXtDW2/6GWm7+sArV3w+92Q1eFdHa0hzZcVfF1eaFlRd8Oyfi8awJH5UESIAESIAEHgoBBi8PBSvvlAT2PwEMPjMYfGZV07OLmc3QYkBYW2fBhAU/Z46qNfUBtWs/YrpqXuVygFYurm/bubnUEacR52qZKYVrUiuXzdz9v9G5hCRAAiRAAiRAAiSwHwncC3CTAzcFuIhuEdzCaJtC3CZWsYi1dGjgxmYnrPu8+kwc1F/pN4NtYVwpZVYZuVCdfl44+VHp9+MqcplIgARIgARI4H4JMMS9X4L8eRI4wASSK/e1zdfsJB+aGoqF+QnC3G5pq+Ax5syfDGv506YfT4h19bxdMqdlCmyV0FAtGIFWLkLcu8etMxe2XIS5rTOXzy0HeL/gopMACZAACZAACZDAIyNwN8BFeJs0CWjatoPMEOYmC24D+22JaLaIIUQ/ihveus/KueKyLPOtjtKlyGyZLxTupDjpxApiXzjAHtmy84FIgARIgARI4BESYNDyCGHzoUhgvxJIYe6rAubbW+uZy6zJRdOVHZMHGXqNqYdqU38orssP2aE+pnuqVSxEhLmtUiHDADSNli4Gn7XhbmroYjhaOr9f15fLRQIkQAIkQAIkQAIksA8I3A1wEd6KAOctGriIcGuIFOq2kZv0CbVAA1eEZtdvxLz+fNMrXx6qbDNGVaQG7o6p6npn1V345IWGAe4+2KZcBBIgARIggYdGgCHuQ0PLOyaBg0fglZVXoFg4a7Osn3Wd1qKqMjE0mdRurtJ+Xt7Q75Vb5sP5oj6pOnJOKhhzW81C0itg7FkKcJVIA9ByRLhWSVxCzcLB2xG4xCRAAiRAAiRAAiTwsAkgmMVD+FagcM+BK9w0wEWgC+FtdKIUKOc2u3EjdOrP+V55OQv5Vh5U0TZwJ4VbEyfrC5+APVeygfuwNxnvnwRIgARI4PESYIj7ePnz0Ulg3xFAA0K++nFhC3HdiKJj1aTKcq913tG2ysXQd92xgOFndtf+hhmoo8qoFNimAFcLhQFoViHETaoFkWEUGgLgtqWrsKJ8vtl3W5sLRAIkQAIkQAIkQAKPgcC9Bi6C3Dh14CZ1Avy3DqFuIxyOnSyhUPBw4G74XvXF0Bl/JQuDrY7TpdST0npbnTwFhcKLUCgwwH0MG5EPSQIkQAIk8KgJMFR51MT5eCRwAAhg6K986aJQ739K2Ku31s0vDI3e3gtzA8Jc0a2W/bp5TtbynHHmSTMnjyVfLhy5rSW39eUamQLcDKPQOq1LV0aNF9jpOYfPOwdgH+AikgAJkAAJkAAJkMBDIdCGtm14iwB3b5AZ9Alw4daIc33SJ4QyThDghjAWt2tbfib23Mu49namZdn1c4VdnlR04D6UrcM7JQESIAES2McEGKbs443DRSOB/UAgXor6tRvCTH4gTGjuWBMdmrcmU9bNBRPmw3r2AbEuPwhf7nHT1wsIblutAqy46dBRmehO1QoKTd22rWvgK8N/OMcvEiABEiABEiABEiCB2SEwHVyGAWYIcYPEMaaVoXkLE67DJfDhygYShSJFuTgeN6X7RnN8/N9y170ZXFnipWaZ90u3PFiu2MCdnd2Ga0oCJEACJDAlwBCXewIJkMDPJJCauZdXhM63V61qenZojEm+XCmbvBmoaZh7XZ3Xt82v2Xl1wvTUPHq5Fr1cm4afiUx0WuVCGnaWXLlaWagXGOb+TPK8AQmQAAmQAAmQAAkcEgI/plBIDVxEtQhwkwNXtkGu9PDgIsBFK7eOZT1yfy3PNH/q15trw153IisoFJZ/oTq5hk4uHbiHZKfgapAACZAACbwdAgxx3w4t3pYEZpxA8uVe+RhC2VPC6jtXs6E5mjVlaSaxtl2EuVWvORqv6ffZcfYR29XzMhMDaRQkC2jnIsqN7XEKduPUlaukVQrXTlu5fD6a8f2Lq08CJEACJEACJHBICfxEgJsGmrUhrkNo69HKnQ4yg0ohXV7dcP+s3u1+T2xk3ze5KlILd7FrSjZwD+n+wdUiARIgARJ4SwQYmrwlTLwRCZDA6wm8svKKOTv3gr32vS3ba7SWWZVhipmpynEel/TxuGaftgO1HDfU83ZRn1JqT6UwDXPR0EU3d6pdwBA0mcOZC18uLpERioXWm/v6h+NpEiABEiABEiABEiCBg0qgVSgkdUIMMqJtC9Vtq1AIsk5DzSBTCMHFMjpR4TbebTTfk080f1yXk2/1TDbuBlFsx6wqmmPVhU9CuIAXjAcVBZebBEiABEiABO6HAEPc+6HHnyWBGSYwbeVeMa6/bJZsx/g6s03T9KQZZSHLulI1g7hpPxjX1QfzoT2m+2q+bd2m4Wc6IrxFkIvvvUAX7VxcAmdu0i/sDUCjM3eG9y+uOgmQAAmQAAmQwKEgkEaXNdMBZncduLJux5fBgZukCrLBILNKlIhyfXPHr/nj5aeikH+XyWyn77Iyi8Nq/fir7pw418gViBf4RQIkQAIkQAIzSoAh7oxueK42CTwoAisrUV0UwjSjm3bs67zTGN2LxkbTZHUuhz7zc2FVnFcb2fPZoj4JX+6SMjikKNdEi/5tjtMm4lxq4yqLUWhKWJw2HH72oLYS74cESIAESIAESIAEHgMBNG0R1Hq86ZzqE3yrUKjQv/URigXpYMF1shIhNPUO7Le2/oswdC/3orqTGrijfu50ccedPXK2ZoD7GLYfH5IESIAESGBfEWCIu682BxeGBA4mgTT47MrvXDHL//aC2Vq7qeS4g/JElVmvdIAvNw7kwJv6SLyVnZfr9oNmQSLMNfOtKxft26RWEBqe3GTOxeAz/Jujr5uhuZuCXH0wqXCpSYAESIAESIAESGCmCeCDW9Af7DVuUclFhIvAtsHYMoS4bQMXCoW2gbsbNmLmPh2Xmq/mY7nZ6w4Lq6vqVu9odU6gybuCF5vUKMz0zsSVJwESIAESgHySEEiABEjgQRGIaOVeOYnQ9fp1W06sntu1ptfXdgfDz2TTZAphruiGRbGm3iu37L9DjHsCzdzF6fAzRLoqphAXYe5ekDv15bYNXTxbpecrPmc9qI3F+yEBEiABEiABEiCBh0kgtXAR4opkwG2HmCWNgnAIcf3rHLiN343rvlN8XgzdK7IKW5nvFXI+q1R3uzojzjgGuA9zI/G+SYAESIAEDhIBBiIHaWtxWUnggBBIvtzLHxc63161Ab7cxbq0osozE5QuoVlQnXroh/KIWrPnxbr+UDavj6munmvD29TKVUmoIDrKiE7y5mIwWrrsbphLV+4B2Q+4mCRAAiRAAiRAAjNKoNUoILJNg8vuBrj4eBYi3SaiiRtKMUmXN7thvelUXwj90csm9jfySpXTAHexOvNtUYuXoFxgA3dGdyKuNgmQAAmQwL8mwBD3XxPheRIggQdGoB1+9klh7D/fzGo9Nn6Uo3yb5yZLmoXGYlJFX2RxKazJ99px9hE9kIs610O0cRHawpGbKWgVYpbOY+CZbX25EkPRJM6xmfvAthPviARIgARIgARIgAQeGAF4E2IaVwYP7jTAnQa3Ig04wxCzWIoi+FD7Sbjjs/ovml7xSlbGrUXRnYzRwM3c2H1j9Rvu4ksXGeA+sI3COyIBEiABEjgMBBjiHoatyHUggX1O4NLFqJ96SuhCXDfNJjJckeVD4fIJljuHM7ca1sfjzc7TZqCWxS3RDkCLSuk0/AxhLhy58OVameEcAl2cSt9s5u7zrc7FIwESIAESIAESmDkCe4PM0MANqYWLP+j71LxFJ7dGpNvEMk7S6VDGUV1V/90fn1zKJp0bHVWWIluAf2tUnX7+tJMflX7m2HGFSYAESIAESOBnEGCI+zMA8WoSIIEHQyANPxOXhLr86lVrJwPbd0Z3aq2j1ZmotzPfz3q1dX1903wwbMh/l8+ZZdOXCxJRLlQKKc41wsQOhp/ZiNMqhbhw5ibNgkrN3Lu+XDZ0H8wG472QAAmQAAmQAAmQwNshgKYtQtsU3ga8LPPo42J8mUCAixi3wXEKcJvocL5uyuZ/iNPFf/M74tpQdyeysqVdnlQnv32yokLh7UDnbUmABEiABGaJAEPcWdraXFcS2AcEWsXCx66Y3VNH9NKoqwc6M25kTKyrLHZr6ztqPpgwHzD8TG3pD2YIc3Vfzgs0c6FWMArRbfLkRgVXrsUQNGgW0MxNIe407JUIfJHq4vyPgt19sN5cBBIgARIgARIgARI4tATuOXDRoE3t2+TCTc3btoWLgWZlKFKAi/WP1Xr9fX2i/gMRwv+nfBwHLcvFrilXd1bdhU9eaOjAPbR7CVeMBEiABEjgPgmY+/x5/jgJkAAJvC0C8NlG/ECNMLe5/PHLekuc8WK37xd6Y9/TR2qxWzop7J2w5LbUieqb1bXmvFhVH8wWzUnd0wvCo3+bjGoaTrUmZjDnwp+Ll/8qHURq6cK4C90Cwlx4c5M7l4PQ3tYW4o1JgARIgARIgARI4G0QQPN22sCVbQs3Bbh4jdagk9u0QW6FMWYpxkVFt7kdrqlT7o8aWf/jUPd3dVZWOSy464P1+nODC/59HGL2NsDzpiRAAiRAArNGgE3cWdviXF8S2GcEXq9ZSM3ceiczw6Gxrim0r5xRfT30nbgUr4kLcit7Pp/XJ3VfzcOgoKBY0DENQDOpjYt+rkbAixB3+p28uTgPFcNekMvnu3227bk4JEACJEACJEACB5xAG+Aiqk0KhTB14OLfGvoE1w43q2IRajRwoVlodv166NSfbrqjVzo6v90Tc8VOVblzx4858aKo9/7Qf8CBcPFJgARIgARI4OERYKjx8NjynkmABN4GgRTmXl65rIU4Y1KYW1RWDycTUwWjVd5kvqPnVD8uSmgW4oZJzdwTpicXENDCmqsU9AoGegWLWBff6VhaeHOtMipLt0Ezd9rKpTP3bWwV3pQESIAESIAESIAE3oRACnAFPiM1DXJThJs8uA1MuPDeQqHg0MB1sogBV+yKdZ9XfyEGxdcybzeaIIp7CoVPQKEw/aTWmzwQLyYBEiABEiABEkgEGOJyPyABEth3BFZWovrttSva9S+YJbth/GZmc8SxY+ugTxjNi55dTM5csa6ezxftsu7KefRyU1SburkWzdwsBbnw51oMQ8vxxqAdjIb2Lry50eCZD7duPbr7bt25QCRAAiRAAiRAAiRwAAigeYvINiaFQhpmhkFmUGWhgVvtmXCrUIlS4rJ6J2yEbv150Zt85W6AeyRm1Q+aY9WFTwo6cA/AxuYikgAJkAAJ7A8CDHH3x3bgUpAACbwBgXYI2ieFsf98M6t3xmYojtnGlCaI2tZaDf3ALYofmvPmtnkuW8xO6K5YQHCLwFYlzcJemItjnE9ahalyIekWZIYU964zNz0P8rnwDfjzIhIgARIgARIgARJ4AwJJnpCGl7UO3BTi4jQmFkCj4GG/baSLZRxFH3wzDrdDVn1WDKuvhNJuLMo4yfu5u9W7VZ178RwVCm8AlxeRAAmQAAmQwJsR4GCzNyPDy0mABB47gb2P1tWXLl4K50+cN6u+9AvZ2ETf8bnXddg2u/5Yc8e/w/99dT0+I2/I57OFFOYGOHPTKA3lENiaiHYu+rfJj4tuLqYmB7ytSNoFlZQLUkcZFSwLDHIf+xbnApAACZAACZAACexzAj8e4Io01AyvudIoszTILGD8rIsV/hAvklahcfU31bHy65AqbGWNLIq8U9e3dupzZ841/BP6Pt/SXDwSIAESIIF9R4Chxb7bJFwgEiCBNyPwysor+MPTGXP8Vt8UDVy5dQXfrbGdbg3Rghw0mVtUN/PzchNh7ny2rPsyhbkIb5HRpiaujdlUtbA3AC15dJMzF8cYhgxvbhvkJmsu27lvthF4OQmQAAmQAAmQwKwSQDKLuDaNMEN42x4Q1SKshQc31m0X14kJTtUxhKa63nxHvHv0+2arc9U0YizDuFJOVWfGZ2rxFAQMK1Ax8IsESIAESIAESOAtE2CI+5ZR8YYkQAL7hQCauXqAZu6/8fPWx8waX3fqUGnMQDO62wybXlwUq+YZua6fzZayEzIXA2gWDLLc1MXNYMZN7txcWPRyjYAzF+dTyKtwbnqM1BeXMczdL5ucy0ECJEACJEACJPBYCWCEWfLeQqOAILfVKKBtiwYuAlx4rvA5Jwwyi1VwokKA66v15qo61fyRa8bfmo/DHZGNS7wUq07Pn67Ei7gnDjJ7rFuTD04CJEACJHAwCTDEPZjbjUtNAjNPAFUQeXlF6OHa9UyIwvZtbmKdZ3WudKgdzLiuHwdx3v8wf1psqWe7S+YUYlpjemoRvVtYchHrIrAVaOdCp9CadBHipsFncOhCs6CVTZEvglwF2HyunPk9jgBIgARIgARIYKYJpPFlTRvgJh9ukiUgwEWcCwcuglwXCwS4TqCB6277NXm8/IPGu7+fM4NtWdly3U+qC7dPVuIlCBfw8aeZJsmVJwESIAESIIGfkwCDiZ8THH+MBEhgfxCIK1F9cfM1q/OheWdldROsHUOzoJpCNh2Nam4zlAOxGL6nn7QL5kTcNM/bnlrQXTWfNAttkNuGuejlqtaca9HSRVtXTgegIfhFhKuxtny+3B+bnEtBAiRAAiRAAiTwqAm0GgUEt2jjIqhNjVwoFGTdunBT+9aJIrV0/civ+6z6dBpk1qu6mypm1Ui6+tzxYyUauJ4N3Ee94fh4JEACJEACh4kAB5sdpq3JdSGBGSSQfGpogzi0cv3q4KoRtybhdH6iLnSEMmHO9MalH1X1KDsqNkUe+n63uaV6Yrn8oXpPZ9Gc0Ah0lUlWN+VTUxen0nFAnNsOQMNHBTOMPUsD0FIjVyHKTWEuA90Z3Ne4yiRAAiRAAiQwkwSgT8CcMigU4LBNp0OrVajTa6YIiYJoZKtQ8KO43mTVZ+Sg+FrW2G1TVc4uBjcabNZCHAt89TSTew9XmgRIgARI4AESYBDxAGHyrkiABB4vgaRYeOniS+qdv3FRue+smvkq18mZm3ulY1NlI1Obbo4BaHmtZNceqdfie+Ut82xnwS7rnpxHRKugUUD8C6WCERiCtufMhXQB10G/kAai4TD15aZQl18kQAIkQAIkQAIkcJgJ/EijEFP7Fi1cD21CUiikJm4VJyFE77fDrdB1X6h7xVf6zq77RhaxsdWvmKOlOIU/jK/gRRo1Cod5P+G6kQAJkAAJPAICDHEfAWQ+BAmQwKMngAatvPIxYVx/GuZuxcJ2vdWDzGZ1cDpGY6Otek1fLMrr+hm5kT2XLeqTpq8WIE/AEDQFyULy44oM8W3y46ZxaMmji4BX5q8Lc9PzKJ9LH/0m5iOSAAmQAAmQAAk8XAKpf+vxEEmfgAYu7Lepe5uGmDX4LsUk4rwfhdshd59FgPvlYZ1tBq+KRWvLLbFVnf3ds44KhYe7kXjvJEACJEACs0OAOoXZ2dZcUxKYKQJ7bxhqtHMbqBb0GSGandFNPdrZqYfDY3Zc3fF916vK0IzlYn2neUf5v9x1e75e089nC2ZZdMN80izERuGNSjv4DOFtNDGFuPDC4YOEqZWbhqCZvWYuw9yZ2sO4siRAAiRAAiRwqAm0Ae5Uo4AoF21bqBQQ5sKJi0OsMMgMsS5ONd7XV+RC/TU7zjZ7flgUncZN5Kg+u3q2YYB7qPcRrhwJkAAJkMAjJsD22CMGzocjARJ4PASmqgWhzp8QZtWv22Gzq73NjZV5bttmbmNdR/VVLy7Ka+a83LTPo5l7QnXUUGdo4wolhUEzF1/Cxhx6hWmAC9UCFAzw5iLUlbhRuj41c+nOfTwbmo9KAiRAAiRAAiRwvwTuBbh4UYPgFn3bdpBZK1FoQoUGrosVHiSU16t/Uu9yvyc24vd7Ih+JzJb5QuG+K77rXnjxBQ4yu98twZ8nARIgARIggdcRYIj7Ohg8SQIkMBsE4kpUV05CjnD9uhVFYdXkeNY3VeaqSkUI3ATC3GYgluKafq++ZZ+1S/qUhFdBd2Py5kpl0NGVMOfqmCmrLLQLGQafaQS3GtdrmBiMaENdyBcQ7M4GVa4lCZAACZAACZDAQSeAP0UnB27bsU3NW5ybBrjQJ+BcI1wsYi0cWrix3vRX4xPlf/FVdWXRDncFXlRtaVu958llJ34H484kPrvELxIgARIgARIggQdGgCHuA0PJOyIBEjhoBC5djPr9T1211yYD23cjHX3H9uDKTc5cLaUqO7IfOm5J/kv2ZDanT8Qt9azp6gXdlwsw5qYxaKpt4KbBZ4h08WYlmXON0hIeXZGjoZtcuklbI6OMqPLyKfeg7SNcXhIgARIgARKYKQLo4EKh4FsXbkxDzGSDJi4CXFlDoVAGfINHgIjqujrRfMqH8He5zHb8qCoaY8pzzbFKfIIB7kztM1xZEiABEiCBR0aAicIjQ80HIgES2I8E0gC0lz7+qn2/6KmdUVf3Kqu3qyrLu1oL0Re+um1ET/Z1V82FVfO0Gohlvyrfk82bE7or0MxN0S3+aQefRYS5CG2TYgGeBnRzcxhzM4mWLpotqambnnPZzN2POwKXiQRIgARIgARmnUCSKLwuxMVrpAbd23aQWWrgBgeJAq73O+FW6FR/Ifv1l63s3elJW4xd7c4eWSrFi6JmA3fWdySuPwmQAAmQwMMiwMFmD4ss75cESOBAENh7o+FWVlbUhwcfVr3qtN6cG/rTEyl3daWO2J7Yve2crP1EDptRnSOyfVf8WnXDX5DX9XN2Xi/rnphHMxcfPlRp1IeRRqCYEgLGnqHJgtFoGiGumoa5qb+LJDcFufTmHog9hAtJAiRAAiRAAjNA4EcB7jTIFRhkBn1C28qFRKENcPFKpxmFddFtPhP7/nL0ejsGV46FcObIjhNiiQqFGdhVuIokQAIkQAKPjwCbuI+PPR+ZBEhgnxJIQ9DEipCXEbYWm6/pd3YXMrdrjZYu10rCdttkzsiBzMOSvybOi039rF2wJ0xHzk2bufDiwpsbTUQTN2ZSpxgXg9AwDC01dREcp1Yu7gmHaUN3GuruUx5cLBIgARIgARIggUNMIAW4UCQkF+6eEbeBRsHFBk1cHCPALdNpP/Lrsdd8IfabL+VObDSFmKg8R4C75M58G87cl0TAX6jpwT3EuwpXjQRIgARI4PESYIj7ePnz0UmABPY5gRToXvmd5LW9bpt8bMKkY+bzPDNB6Ymorey6fuyIhbCaPaO21HPZgjmp+3oeMS2Gn8GaiwBXtGHu9LzQ6OmmoWdw5SLCNejotrqFNCgN4W56Tubz8j7fJ7h4JEACJEACJHBYCOBFR3LgwpzQqhRaF270oQ4eWoSm9eCOk1TBT/xW6NSfawbllwfObnT8YGy6ZXmnuAONwtlarsgUBPOLBEiABEiABEjgIRJgWPAQ4fKuSYAEDg+BuBLVlTWhXX/VqKZnZSisrvNskAnpdW1QUJkTfbNYXxfvNRsmhbknVEf1EdOieYtgVkubVAoIdDPEujhAtpCCXC2y1qGrFMJdXIowVzDMPTw7DteEBEiABEiABPYrAQS3KcQNCHGTCxcHnzy4CG1d68J1ocRIszrUsahH7rJ/x+RPst3OjTyoIgxNESabJQPc/bpxuVwkQAIkQAKHkQBD3MO4VblOJEACD43AvWbuKTRzN3PTa7TuRW29qGwJzUJt64HK4qK4kT0jNuWzbZgLja7uKwxBQ9sWJxHcIq5NmoU0BC21cVMrt1UtINhtw15YG3AJmrxYET5PP7StyTsmARIgARIggRklECFPiBL57V6AG9sAN3lwa4S4NQQKRazbQWZNuVZ9177H/V9q217NoipkNSnD8i8UZ+DCZQN3RvcfrjYJkAAJkMBjIcBw4LFg54OSAAkcdAIraOb+9toVNHOXzZLtmO1xlVmZ5zY4DdOCaXQ9DMNmSf7v/KxdUMfFLfOBrG/mdBfe3BTOKogUUohrUngbEeZGmzy6CHpzXNOqFlJ/V+F2DHMP+t7C5ScBEiABEiCBfURgqk5IGoXWhQuLrY8heowyQws3yRNkFSq0cINo3EZzVZys/kjJ8DcdvbCjRk1ll+erk98WFR24+2ibclFIgARIgARmggBD3JnYzFxJEiCBh0UgaRZeFa+a1dERe0SPjR/lJmkWuvDljhDoxq7s2kx041r3XbYXj/k1+e58ST+he2ohdXDRzE2d2xTiZinSnSoWMA4N53FVkjHk6Th1d7EOfM5+WBuS90sCJEACJEACs0GgVSfsOXD3FAow4KYGLkLbWMUKNtwy+Ng02+GaPFl8ynv5rblgt0NpJtZPqpOnTjoMgPUcYjYbOwzXkgRIgARIYP8QYCCwf7YFl4QESOAAE7gb5hZi0STNgqmqrAlad4wzrlKq05d9zAdRqieWxM38fNzQrTdXd+QcBAsqTru5BjKFDG3ctp2LABf+XAw+MwLDzxScuhiIliJffpEACZAACZAACZDAz0OgbeGidwuVAn4c4W1q4MJ866ULDY4rUSQ3br3r133uPh2G7svdoG57KYumMOW548dKBrg/D3j+DAmQAAmQAAncPwGGuPfPkPdAAiRAAvcIXLp4SZ8/cd5M8qHZVVrF3Yk5qhZVrKusDpUWHWONjN26F5fQyn1abppn80V1Snf1EDFtLiDFRWhrMQxNiSzm7UA0HXOEuTa1ctum7tSXm56/+Rx+jzxPkAAJkAAJkAAJ/AwCKcL18ODCh4vve4PMYL+tZQUP7gTX1ghwN2K//rzoF1/uhGyz64YT0y3LW71b1bkXz9X4gzLugl8kQAIkQAIkQAKPmgADgEdNnI9HAiQwEwRSM/cKnLm7p47opVFXbzWFXSq7WYRmoSu6YoJjCaNuMxCL6ro5LzezZ7MlfQr5rDJ9OY/POuIEHLnw5cKKmyHWzXAuh3IBrVwEujDq4gn8ri93JphyJUmABEiABEiABO6DQIT1Nkr4b9sQF8eQJgTpRN0OMhuhidv4ib8Tu81nxbD4Uty1G0vdYZHpulqcLJbiCEQLK22D9z4Wgj9KAiRAAiRAAiTw8xJgiPvzkuPPkQAJkMBbIIAwVl5eETrfXrUBA9D6bqT95Ijpico6JVUahFblciB7YcF/Tz2ZLeoTYlM9b3p6QffkAsq8EC2gj5uGoNnYQXSbRZxWCHYR8mZpIBqcdPjvXiuXz+tvYbvwJiRAAiRAAiQwUwTQvIUHFyFuG+A2ECo0iHRr0SDAreIkuOhgxC3d2H09nJr8iR13ri90+uOi2XAQ9Fen509XDHBnao/hypIACZAACexDAnyzvw83CheJBEjg8BGIkM9d+dgVc7eZW+9gCJrNTa+yBjmtqgNi2X7ZD10/J9ayp81ALftr8t3ZvD6p+2oON5m2bg1CWwS46OLmbUM3qRegWkCEq9sRaUnDMA10+fx++HYjrhEJkAAJkAAJvH0C0+B26sCFQiGkALdBaJtCXDhwYcJ1SHhjed19N3/G/V69Fa72Y2csq0mpOr9QvjZ/uf71lV9v3v4D8ydIgARIgARIgAQeJAG+yX+QNHlfJEACJPAWCFy6GPXgxGtGw5vbV3fUyTvH1RhJri5cLrImq/J6oJP3dt4shmvqgtxQz9sFcwJD0AYKw84EGrzw47bDzwQ8udAsYOAZ1AoKx8mdqxDvIsxtvbrJm8tQ9y1sFd6EBEiABEiABA4hgWn7FhHtVKEg9hQKsOCm7m0RYMLFWsdmO6zJU8UfTib13x7vDnZ2x0XhuqbcGvxj9cKLL2CuGT24h3Dv4CqRAAmQAAkcMAIMcQ/YBuPikgAJHB4CSbXw0kWhnnrqVb29Pae7scmj71hVN1lq58ZorOhEeHPrJXnNnkeY+2y2YE6mEFd35XxSLUToFBTOCxOz2Lpy987r1pdrUtybdAz3WrochnZ4diCuCQmQAAmQAAn8NAJ7DVwkuGjhJhdubKBMwEE4HCbexSrpFcIobPhO8+nQ2325azu3u42YKHmyWN254i584kLDAPenQeZ1JEACJEACJPDoCDDEfXSs+UgkQAIk8KYE0iC0y+JqloagBQxB8xOoFoS1SF/R0nWw39aD2DELAd5cOy+WxaaFN1fBm6sWENOm4q6MbRM3mihjcuim0We4Bu5ctHMR+GIgGry6CHSxEHzuf9MtwStIgARIgARI4FAQwN+K4cGFPgG/9FOA65MDF/+mDm4VSjFGN9f7UVj3Hff5Zq54eeCyja4ZTKyuqqO/dLQUvyMY4B6KXYErQQIkQAIkcFgI8I38YdmSXA8SIIFDQSBeivq1rwvzL/lN887K6vXJxPStNcNmIO90Ct3NxKDOJsOwlj+th+JE80P9rhzeXNVL3lzEtGnIWYpudXLlwp8L1QJOQ7mQHLpQMeBytHKnft1DQYwrQQIkQAIkQAIk8BMEUoB7d5BZQP/WBwS40kkEub6MBfq4tZ+E27FTf7buFn9lSrux0BHjscvdWbFUid8Vjg3cn6DKC0iABEiABEjgsRIwj/XR+eAkQAIkQAI/RkB+FG+vUmNmJdavDoTJqsoYqBVudSt1rNJy1LimM+mPqzk3rvNayafNV4tVcV5dM89ni/DmdvUcklzcgwow5KJ5g39NDAFv4BDq1mkYWjAYjIYgt3XmchDaj/HnGRIgARIgARI48ARSgItXAqmJm9q2bQs3yBqvmNti1AAAQABJREFUMJrg4MBNl/lY+br+m3Bs8rVsLLZMVxXFzrg+m5+sxBFRM8A98HsBV4AESIAESOAQEmAT9xBuVK4SCZDA4SKwAtXCi0Kob2yv2mNNzzpjTDG+nRs4EnJhbGEFerhxKayK94pN/Wy+mJ3URuWyE3sgIdshaNAoYBQamrjtIDQMP2sbuq0zNw1Cw/mkWUj5L38vHK7dh2tDAiRAAiQwSwTuNXDxZ9wo0cBtD0420kGkUKGP65Jiobpefce+x/1ntWGvaiVGCx1bbne3q29++5v1xZcuBsxERQ7MLxIgARIgARIggf1EgG/W99PW4LKQAAmQwE8hsLKyoi6KF02xdt0MFqx2u9b0Ymld0HoiaqvyeiB78OauyqdMMOdUNE+aTPZUVy5KDEFLQS0GoaGZK6xQ0bbW3KRXQLyLoDdHhGuSagFOXZR07/16uHfipywaryIBEiABEiABEnjcBO4FuGjhwoaLsLZB57aGFRcW3Fj4GuPMYvTNll+Np4pPyRD/tm/yUdzF34P9pDr5G2jhflQwwH3c25GPTwIkQAIkQAJvQoBvzt8EDC8mARIggf1KIDVzf3vtinb9ZTNf5XorFnYu5jZpFwLC3NiVfUgTFuNqdk4NxHF/Tb4nW9AndVfOSyS2UQWFEi+8ua0zF4Fu29XtIORtA12cnzpzcUuEuSnPTb8r+Ptiv+4QXC4SIAESIAESEK08we95cJMD1yO8hQdXILqNpXeiTAEuBplt+Kz+MzlXvqzK7lbfZuVOVblzx4+V4kX8hGQDlzsTCZAACZAACexXAnxTvl+3DJeLBEiABH4GAYydlpdXhD67LexOta47jdFlX+uwW0KcYLLYrfoh1Fr07GK8oS7Idf2cmdPw5sohBp0hvEVCm+LcNPzMxKwNc1tfLtQKSa+A7/bapFlo3bkMdX/GJuHVJEACJEACJPA4CCT77d0ANwkU2gYuAlyML4tldLKMTaj9KK6HTvWZOF9czsq5jW4oilExcrqv3dkjZ2u5IsPjWHg+JgmQAAmQAAmQwFsjwBD3rXHirUiABEhg3xJIYa64JNRrX3/NbB/p68WiY2/fLq1qbNbHCLNWtTCoBz4XS2LNPCPW9bPZoj2prcx0pjrQJ2hYcW1rxjUxRw/XxKRWSKZcHOMXRRvott5c6BbacBfxbxvssqG7b/cLLhgJkAAJkMBMELgb4MKBi9A2IMBN0S0auDF5cKtQJAeu3w23fMd9vpkrXu6P7bpvZLG0YKs7xZ02wBUr6cUEW7gzscdwJUmABEiABA4sAYa4B3bTccFJgARI4CcJXLoY9bGnrtqlUVfXOjP9kTGYgGacL/TI1Ub2RFItzMsfyHMymn+rg/4VnaOD04c3F81bNHNTTGugWkCQG1utgprGtQZN3aluIXl0lZoOR0uNXQa5P7kheAkJkAAJkAAJPHwCrw9w0cTdC3BTeNsgxK3CJCLQxb+3fdd9ts6Lr9g621xUw8lIuModuVGee/FcTYXCw99QfAQSIAESIAESeBAEGOI+CIq8DxIgARLYRwSmmoXL+vTmaZ2auc1mbnqN1l2jTVlMVIUEVnfKge7pueqqOJcN5bK/bt6TL6gn0mUQ4SbRAvq3iHMR2GIIWjqVTLkWDd0sqRgQ+GYw6WYy+XQlbpV+hl8kQAIkQAIkQAKPisCPAlyBQWZJogAxPv5FAxfHRRynwWYIcSu3677ql8d/go/krMVKlbpTuDP+TCGOCCoUHtXW4uOQAAmQAAmQwAMgwBD3AUDkXZAACZDAfiXQDkE7KfTyd4RJ3txdrVW+q5TPChNcZTrdXi9mjRV5XPTX1TNiQz+fL5lTqqOHCmbddqqZkQYhbWro2ohhaKmlm/QLCHMzxLfQLyDUhV4BYW4KctsfaY/3KxQuFwmQAAmQAAkcZAIpvsU3hpjhOAZIEJoAD25SKEgMMwsuFqGKaZBZrG4035XvKn8/3A5X+yofQbJUGXmmOr0qnHhJBCoUDvKOwGUnARIgARKYNQIMcWdti3N9SYAEZpZAXInqyprQR04JPbm1bgoMQutbY4rJWPVzjKeW1cAvxKVwTZ9XG+Y5u6CWlVQaqoX5FM0ipYWBISZ3bgpy0cSFVsGqHE1dNHOTUTe1ctHRTVqGts27F+rOLHGuOAmQAAmQAAk8cAL3Grh4I4f2bQjtADOPUBaDzFKAGx1OCxHqreaaPFn/gWv83y76bNcbMzFyVJ2eP13DgesZ4D7wbcM7JAESIAESIIGHSoAh7kPFyzsnARIggf1HAMUcefnjAroFhLl3bppiwer5UNimsmYsams6aiB7YSF+z7zTDvVxfz0+ky/qU7qvFpJUIWlzEeJaRLZ5aua2A9DQ0kWIiwN8ugqndatagGYBKgZ87VG4e7z/oHCJSIAESIAESGD/E5gGuKjYokPr0cZtPbjJe4tIto4uVKESRWrp+nHYCLr6czlXv2ya3u0mFMV8rYqTt09WbODu/w3NJSQBEiABEiCBNyLAN9RvRIWXkQAJkMCMEEjt3C9uvma7ft4uTKyJsrRNLHUWjPYD0c0ybUU/Ljar6rzYVM9nC9lJ3RFDhWFpUUbIdXGsYuvLhVoBB4S6CqIFI5JqoT2NFi9aum0rdzoibUbYcjVJgARIgARI4IERQDAbk/s2iRRShIvTex1ceHBFLTDMDBFumTy4za7fiL36c/Wg+MrAZRtdM5js6Kr6lTtHS/FJ3BJ/YX1gy8U7IgESIAESIAESeGQEGOI+MtR8IBIgARLYvwReWXnFCHHGLI26uqisTt7cgTTWdQuNt4NZ6Il+aeslcdOcV5vmuWzeLCPA1aYn0c5NIS3yWRwL6BZSOzc1cltXrk4+3TQYTZoU7iL4bZu56Oam3z/T7x+d3r+AuGQkQAIkQAIk8LgI/CjADViEkA74VE3Tji0LEi5cnC7EGKFu40f+dug2n216xZcHpd3odVUx1lmlutvVGXHGyRWZ7oNfJEACJEACJEACB5AAQ9wDuNG4yCRAAiTwsAhMvblX9K47oq2q7FzeNTHm1gatJ1AtxE4zl/XNovt+/OV8zh7zP5TvyhYN2rlyCK2CjghkUw8X7VwLsQK0CjHpFZIvd+rMneoWoFkQyHRT8ovgF6fp0H1YW5T3SwIkQAIkcMAJIMKFNqFt4aJnmxQK6RBaBy50CtAquFiGOiadQukm9eWwPLlkm/y6LeVEzmdV5sYOHtyKAe4B3xO4+CRAAiRAAjNPgCHuzO8CBEACJEACP0kAn9WUl1eEPiOEufaD79p+yLXqdDPvnAnGGNuN3appjB2Y+XgtPi027LP5kjmF2LarO6qX9AmpqYv7Sf1cjeFn+G4PiHrbUHfa1JVQLkyVDAZJbrqNxtLwd9NPbhJeQgIkQAIkMIsEUgs3Qphw14EbAiLc6RAziQDXw4ILI64TMfjyRv1d/e7i9/2m/N5QdydRmKIdZLZ62smXEPbyiwRIgARIgARI4EAT4BvlA735uPAkQAIk8HAJ3A1zhbhqxK2+WZiMjQtW9zJrVCNl6KGdq2Tf9+NSuBbfbUL2q9LrX9aZ7KhcDTEErY1k76oW0mC0FOLiYNvhaFrmuI3BeYO27vR7r537cNeM904CJEACJEAC+57AtIWL9m3bwE1hLoaYJQduOoV/XXSyRMgbmjvNtXC8+kMd4hWp8lFPFMWWttV7PrBcyo8ywN33W5oLSAIkQAIkQAJvgQBD3LcAiTchARIggVknMA1zL2tx9YwZZrkqG6v7c0bH7dLmUeuxrK2elwPT9XPN9+SvmoE9Vl8T78oXzampagGj0DR+5bS93GhgxsXQMzRyoVyAQ7f15SLoRbArstadi+Yumrl3B6Hxd9Ws74BcfxIgARKYRQJJnRAR1iYLLgLcNLQM/9aIdBtRiSK4WMUQfbMbNkLe/LkfVq/0ZO+Ol1XRFKY81xyrOMhsFnccrjMJkAAJkMBhJcA3xod1y3K9SIAESOAhEUDjR4qXhLr8hatW9CZmITtlehNtxs2dLIdqwWeiVymoFrpmwa/Fp+WG+YBdgDfXopuLhq7EF1q4qX2bxAqZMhiHhvOIbGHTbZu5Gk5dBLtJr5Daubg8BbrULDykLcq7JQESIAES2IcEkjYhKRCgUkB0m0JcdG+Fl6l/W+FQtAHuOGz4vPxMM3CXB8Ju9Ou5ciRc5Y4sleeEaOjB3YdblotEAiRAAiRAAj8nAYa4Pyc4/hgJkAAJkIAQ8WLUl5+6apdGXR2a3PpJAc1Ck2nUaYPRJqiqKzpmPqzKc7jgV5TTv2gHal735KLGqDPRBrro45qYtcFuauemtm46xgHt3QxRbo4wF81dnEpBbjpMv+4ec1OQAAmQAAmQwCEikAQJMjVw2xA3hbVJoxDQxJWNrEIZithE1+z69dBzXxT96iu4dCvr9gqps0p1F6szAp7cFQjuhcRMNH6RAAmQAAmQAAkcBgJ8A3wYtiLXgQRIgAQeM4EU5r52Qpjt6jqC1sIK0cW3tarB+0kEujDkDkIWu343PqG8OStu6At2SZ3Sme4npQLUCQJd3NS6xaFt5eq2nQt3rkKDF7fJkPdaeHNTIzfdBnIG/JDEaX6RAAmQAAmQwOEhsOfBhTwhuXBTCzegfYthZghum1jGCU7Xfuy3Qqf+TNMrXzal3VjqqmLcBrjbCHDPMMA9PPsD14QESIAESIAE7hFgiHsPBU+QAAmQAAncL4G4EtWrAuOw166bJh+bXB9VSbXgRWVHtTO6G3KpDaQKYbG5IZ5R6+a5bMksI+fVaOfOtR5c9HCjREibQt3U0ZUIdRHm4lyGCNcguE0N3aRYSLqFlP8md276ffb67/tdFf48CZAACZAACTxqAtMAV7QWXIS4ARoF2QS0cGWNENeJSXDeRUhvXVH9d32q/i916W8OQmcs5aQSC6I8gwCXCoVHvdn4eCRAAiRAAiTwaAgwxH00nPkoJEACJDBTBFYQ5v722hW9e+qIFrf68OaOTdzuWCGNVVkpQ62N6Ml+HNRHwvf0k2bOHI031PlsqI6Zrp6bxrJIZzVCWyMQ/OLf9nRMjdzU122DXMS2qb2rUcpNQS5KvzjNhu5M7WtcWRIgARI4JAQwQzQNMGuHmWGUGSQKGGqWGrhJpRBLMcYgM4ebxHoz/ECdmPzf6Or+QzfPd0VtS7FwhwHuIdkRuBokQAIkQAIk8GYEGOK+GRleTgIkQAIkcN8E8I5UXl4R+oy4aq4izB02Rns7MXKc2SxUemxrk3c73UaXWTbpPqEq8Uv+pn5vvqifUD05xDA0BL8IZhHgJpVCUi9g6Bm8uejfitherrRqh5/t3SbHdRrXItjFgcPQ7nsb8g5IgARIgAQeCYGUz6bmrZ8GuVMPbmwkottQhFJMIMqNfhTXg63+TBx1r8gqbvUrWarOL5Sn50XFBu4j2U58EBIgARIgARJ4bAQY4j429HxgEiABEpgdAinMfemiUIMTrxmdT8y/UafU1mZpM63htE3uXCG7WZM5GfJmGBfjNfWM2tTPZYv2BCJZoztyHlHtNJTFwDNEtLb14rYD0BDsJneuhjNXw52bjtMQNCgZEOMi7t37udnBzTUlARIgARI4aASmDVw4cNMhNhAp1MJLtHDF3UFmdTMOG6JXfzYMJi+bxqx3yuEEE0Wr75466V5Ywa05xOygbXUuLwmQAAmQAAm8LQIMcd8WLt6YBEiABEjgfglcunhJi6ee0qe35/QuqrbzldW9ZqSbMjNzuZQ7Dg7dfHco+3ZBXs3O6vl4vFmTz3SW0M7t6CGEDKmdK1K4m9q2KcCVOlqB7xTgpoAXo9TgyxUGrl2T1AuIcdMAtNTNnQbB97sS/HkSIAESIAESeFAEUgdXpCFm7QFtXOgTaqgTEOLGSRhDm1D7kd/yOQaZze283Pe99bqKk8WuKf9xsFwxwH1QG4L3QwIkQAIkQAL7mwBD3P29fbh0JEACJHCoCaRBaJeFUKc3hZ7kN00Pga6bTIzR82rc3MnkAN7cGKwcmMWwhnbuhnnOzKsTCGeV7qk5OHBTLJsECmkEWj5t5CK0RZgL7QJCXFw+VTG0A9GSPxc/0P7MoQbLlSMBEiABEjgYBFoPLjwJAhoFHBDgNjg4gUFmoYoFpAop0C3cTvWKPzW5ZOr8+nwzGGexrI4dP1YKNnAPxnbmUpIACZAACZDAAyDAEPcBQORdkAAJkAAJ3B+B1+sWjld9XTZW94PRxrgc08rUqHZG9V1fdeyi+L46q+b18XBNvjtfsk/orpxD/zaTSGwR0pqYurlGZOjgooWLOPeeUxdeXS1xOzkdhsZm7v1tNP40CZAACZDA/RJIES6CW/zbNnFjgyC3DghwBZq2PrVxQ/Duev0deW7yn9Uo/ovxnbEQWeWO3CjPvXiuhjEIJV5+kQAJkAAJkAAJzAIBhrizsJW5jiRAAiRwgAighSSvfOyKcf1ls7TdMVuytB0EuhqqhYgR3OjS9qUOWRyahXAtnheb5vl8PjuewlqFQBduXIXwFgeEuCZmSacA1ULbzsV1WdItpCA3XY7Yt/Xm4rTEIBn+TjxA+wkXlQRIgAQOOIF7AS5++fg0swzahNTCRYQri1CFAud9fae5Fk9Un1JF+Jvc2G0pJ5WRpjo9f7pCCzfioyUMcQ/4jsDFJwESIAESIIG3SoBvWN8qKd6OBEiABEjgkRJI7dwrvzMNc/tw5+ZKq8KhnTtyuTfOYCiawedNB81ALOofds+qgTwW1sTTdlGfMl01VEZlUQYUdFXy48ppoBvR0G09uQhxEewizMXd2tTebXu8d8PcJFxITV1+kQAJkAAJkMCDJtAqFODB3TsWEWPMPALcIJM6ocKhQCfXNaOwHm31582gfrnbyNsZNAppkNlJDDITL2KQGVu4D3rL8P5IgARIgARIYF8T4BvUfb15uHAkQAIkQAKJwArcuR+GO1eIq+bkZGDjuMoaY029W2nb0ToquHM7Day4aOdeV+fFumzbuYhhlYU7Nx2jwTtt59qYo387deSmQWjtNTiPvi7eELeqBRxPG7rTgWjcCCRAAiRAAiTwoAjca+DiEyBexL0GLjQKohFNKMMk4LTf9Tdjr/6C6Bdfzvxw3cuqaApTnkseXAa4D2pb8H5IgARIgARI4EARYIh7oDYXF5YESIAEZptAaufi46P6G9urNtix6UOZ6ye56QlrVSZkhd6tUCUGd8eleNX+kh2I435NvidfsE+0qgWbnLhw5mql0b6FMRfhbWrktiEvZAtw6eK0bY+VgnahDXsRHvOLBEiABEiABO6XQOreytaBizdhU4WCh0AhBbhe1qFMg8xiDZHCjjfVnzb98ivWZ5t5VEXs2PKd3cUCvwNrKhTudzvw50mABEiABEjgYBJgiHswtxuXmgRIgARmmkDy5l7++GV9evMFPclvmnpnbLr9o7oYj9vANbjKdIe9vtA+E/242KyinQt3bragTkCfoHVHzcVWpwB/Apq4UUebAt0U2qKLm+F0hvg2qRdSqJtau+l++Ttzpvc6rjwJkAAJ3A+BHwW4aN+GtoHbKhTaBi5GmIlJSDIFfFWr7tX4K6PftVX3BynA1S53qjNfnl6FLfcl6e9nKfizJEACJEACJEACB5cA35Ae3G3HJScBEiABEgCBSxejfuqpV3VPnFNmW8itjZtq12q1KDMbMBQtYBia7KhBMwyL4vv2STtUx5tr4pkM7lzdunPb9i2iWmWmjdyYo4ubQt02zE1BLuLbaVs3hblULHC/IwESIAESeHsEXq9QQICLFq4PDf4e2SoUooNEoRIF8lvR3PE/lCerP4Qd90pHZjuysmXeL93yYLmiRuHtQeetSYAESIAESOCwEWCIe9i2KNeHBEiABGaYwJ5uQV5Zu6KFuGCFuG371hjnJ9o7ZzqDTt+ldu58XBQ/UOflun7OLBi0c6XWXTkPa24agoZzaN/aiPfPsrOnVEB/N13XOnNbny4w83foDO9rXHUSIAESeIsEIm4X0L1tw1v8i4FmUCg06N6mJq7DGDMnqhAQ647DRpO5P49z9Vd6tb6TY5DZdiwreHAd7qORKzK8xcfkzUiABEiABEiABA4hAb4BPYQblatEAiRAAiQgRMQwtC9uvmafyIemqHZ1ro+q6Eube60b7QyUuAOBdm74vj1rF9Ry80NxPjtinmjDXCvzFNpCs5Cn5i2iW4vBZ2rqy5U5wt5WvcBWLvc0EiABEiCBn0Hg9S1cL0JAC1e42Eh8h1pU0CjAjtvshluiW3+uHuy+MhC9jSDhwUULV4it6ls3vtV89KWPUqPwM0DzahIgARIgARI47AQY4h72Lcz1IwESIIEZJ3Dp4iXoFp5qdQuTW+vGZdZ0aq2NGqvdcW1TO7fOytwOzFK4YS/EDfkhO6+XEdPmKleDqTMXAa6OBh1dSBdEB9dhQBqUC0rYvSCXv09nfD/j6pMACZDAGxJI6oTWgZuauDI1cNMgswr/1ujgYpCZaPzY345589m6V3wpDTJbggd3IrNKLCyUZwQ8uGzgviFaXkgCJEACJEACs0aAbzpnbYtzfUmABEhghgmkdu6rQpi5baF3qnWdaa1CZTPfq6wUTS5yORSDeMRdVec6C/oJv66ftUN5XCiFkWfo4mphYc5FKzfmOM5T0JvauUnBAKz8nTrD+xZXnQRIgAR+ggA6uAhwPcJbNHCnp6OPNUaZuVDFSWzQyK1DVU/qr4l3FJfsRKxlMRays1CqCoPM5kXFAPcnqPICEiABEiABEphZAmZm15wrTgIkQAIkMHME9t4MO7yplpc//m19XLygxK31MKgyP5IxZl433tejzlFxu+mGYTOKt8OW+oieE8eUlxrBLQbR4A057IYQEwYpo1Qas84ClIfJp8sgd+b2Ka4wCZAACbwhgTbAhfU2IMAVbRvX498Gl9T4F01c4TDgLNRbzap6uvm8WNO3OjIvpS0r22CQ2fx8LVZwC36RAAmQAAmQAAmQwB4Btoa4K5AACZAACcwsgXYQ2kWhvnF6NVuyHePrzGaN0k7tdoUyWaOrI+6meV82sf/BpgFoFjoFfAsTO8qitwt3Ls51EeTCk9s2cvnH0Zndm7jiJEACJHCPwF0PbmrgJp0CFApJpCBwiGUsRRlCaPxOvOW77jOhX3/5aNbfDiMzzo6V1bo45s69KGqJvxTeu0eeIAESIAESIAESmHkCauYJEAAJkAAJkMDMEpACVdqXpP/S/OlqdOdouS12CnekKBQmgjeNLrt+uJ4fj//D9/xfNrebteAwR7xO37LEUJoS50t8MBZOQ5gNI9pVqaUr2Zya2R2KK04CJEACmKs5DW6TAzd944MbGGXWBrgew8wqUeL3ReNHcSP06s/rpeprc9qOtM6qQtX1sRTgCtEwwOWuRAIkQAIkQAIk8K8JsIn7r4nwPAmQAAmQwMwSmDpzXzWFWDT6TjfLXN2R0uaFLo6KDX1Bl/o3swVzCm3cvUPsoH+bays7MOV2MewsVxqnFA6RjtyZ3ZG44iRAArNK4F8HuIhv0b31cN82CHCLMI4+1H4c76CB+/kwdH+V1/lWV+hKiKLQ87r862//dfXRlz6aFAz8IgESIAESIAESIIEfI8AQ98dw8AwJkAAJkMCsE2gVC5egWPjGapaNXdY1w64KtlP16sX6evyAreRvZQtZUitYmaUDtAoqZiqTPVyWgtwMg88sWlTp0y78PTvrOxTXnwRIYHYIxKROSB5cHJIHN8QmNPjsRhpkVohR6uOGJjg3qr4mTpd/Ep28sWB7ZeFr1wxNWaz9oLrwyQtN+pTI7EDjmpIACZAACZAACbxVAtQpvFVSvB0JkAAJkMBMEGgVCx+Vvpo/XS/33+l6mS2DqsusslvqmP+bphu/VN9uruONeQOxgsNomioGNKx8LIPHx2QDLgt4y47BZzMBjCtJAiRAAiSQCOBvgHuHaYDbWnAx1qwOVSwQ32KoZghu3X1P/3L1OV3o9VyoKgW4yuEvhpvb9YVTFzwDXO5MJEACJEACJEACb0aAIe6bkeHlJEACJEACM03g11dk89q8qHdMVacgV9SN64feljziv+n69SvNrt9KQW7y5CLIrdG1csGFMqSp4wHm3IABNumDtfwiARIgARI4/AQQ4KI+m/5NX/Dgihq/BRDgwpueVAoyquZOuK5+0f+pvx1Xc6mrodJVCnDNEeO+deNbjVyR/J1x+PcUriEJkAAJkAAJ/NwE+DHPnxsdf5AESIAESOCwE8C7cfnaf3otm+RDkxU9+HF17vyoI/pi2b0m/mO3lz2nemqoDcy4mcwhUuhIIzoq+XGN6kiNS5Uw4MTft4d9Z+H6kQAJzDKBuy7cBn+6gwc31Ahuq1iFAoPMCmS6scEgM5+7T4vB5OWe7NwJUuG63VI8ebY6ewKDzPAJkFkGyHUnARIgARIgARL42QTSG0t+kQAJkAAJkAAJvAGB9LHWeCTWr22+Jnxfu5GvpXW5MhOzbp8c/1X5Wq0gwH1WdE0fH21JDkOFH1EBma1qS7gw4wr8Nw1y3+AReBEJkAAJkMABJpAECgEV3GTB9WjhpiFmNdQ6ddvBTUFuuhABbuxVX4jDydeNU9vBqGKxsuWWENXZLVHL/5MN3AO8D3DRSYAESIAESOCREaBO4ZGh5gORAAmQAAkcRALp462rR1b9qFf7gbZVT2RVpptSbes1c7b5f6uJ+4Yvml0Mq2mEk2X6hh/XhVoWyZOLD9U6vMlvDuK6c5lJgARIgATehMBecNuKEwKi2xh8SBZcH1uNAqJZeNLRyR2HLdF1Xwy9+mU70Zsd1y91k7uJmdRUKLwJW15MAiRAAiRAAiTwhgT48c43xMILSYAESIAESOBHBOA3lOLjQl8WV81pMZftbma5Fi433nfqYXPC/5P6P7KufVZ39VBnMh06MotQHqoMVd0eFAtdpSFbUDhEqhV+RJanSIAESODAEWjbt3gux68G9G/b7za8bVu4rQvXidLXGH3ZxLIuq2/Ux0d/rCf2uq7CpK8Xyrxfun8cLFcvrAgOMjtwm58LTAIkQAIkQAKPjwB1Co+PPR+ZBEiABEjggBCAFAHv1aN/4dKZ+I1vrEJzK8QRkQmhnRC74ob65eZL1T/XMRfiOan0vJaqSj8gLD5hq1S6vUQMnNLbrDUt0JF7QLY8F5MESIAEfoxAG+DCnZPC2/S07uG7TT1cH4OscSlGmcGE26CNi3C33vY3xXJ9WY3VRge/F/7/9t60W67sLvPc4zkx3FnjVSpNkk4oWjIFlPBENY1WYRso6q38EXjZX0HKb9Avumqt5nV1r14pei26gDJdC7DApg1O1AXlStnGsp22lZqvdMeIM+29+/nvc0OpNAYybaV0743nREacaZ9h/87Jq4gnnnj+g7Gut+um3V3YaC+qU1Eie96zd86QAAmQAAmQAAmQwD9BgE7cfwIOV5EACZAACZDA0wTyZ/Y3lLn5pZtuQ62VBdy4i6ooWx2G3bBb775dfLbw5pfN2K5Zb7z2cOOWfbEz6/UQJc7wOV55iMLIzoUrlwMJkAAJkMDhISAVyhIKkIkHt3fhSnyCCLiN6uC7bVUd4cLF+hh244NYdL9vlqo/c9E8Drt6unrGVQ/UiebcOfh1P68o4h6eK88zJQESIAESIIEDQYAfIA/EZeBJkAAJkAAJHAYC4pqSCuKSYzg9tt1Mhq6Kha9CZyu36e74j9ZfqH39R+3j9k5q8WPaDj+nrVWVOlXBmVXBo4WcXN3AeiVVyOnAOgwXnedIAiRAAj0B+R4vO3B7ATfLt5BwkXsuWbhIRU9w4aoQu24r3E+j7g/V8t5fFMluKWNrU5bNntrr3nrrKgVc3lEkQAIkQAIkQAI/FgH7Y23FjUiABEiABEhgjglcvXE1/faJ/yV95KVR1GFHFaGEyRaf7+HGSuP2EUTdOu2m08abkc6/eTGShLv/wC9w4cKlG3eObyB2nQRI4PARgPMW/tv9DFwt4m2XHbiIUEidlgRcKWQZ4jRtxmH7R91o+mdmWmw4ZSuTyqawq813Bivdb/+H83TgHr6rzzMmARIgARIggQNBgJm4B+Iy8CRIgARIgAQOG4HPX8WH+PMpXRvtmnWcvA5l8g1+RFuXSZ+Mb3YPoOpudp8rV9zp/b5JLi4ekHVR4Aw2XK1tFnb5q5jDdvF5viRAAvNFQGIU8JWdxCTAjYscXDhv474DF3m48ODWUXJx8fVd17R/E9amXyqqwaNVp6uqqRp/6mSDfyfas8jSxT8C/BXGfN097C0JkAAJkAAJPDMCFHGfGUruiARIgARIYN4I6Cs6piupuTGCOwvxCObBTurwG5dxKDeq45Ov1liot7rPFcs6C7kpl0TrP78nse5Cz4WQ69GMv4yZt5uH/SUBEjgcBLL7VndPIhRQxgwu3FacuCroHJqTl8TUxdj+rXkt/H6xMbzvnamq2kPADfX6umrVHQi4+DfjcHSaZ0kCJEACJEACJHAQCdD9cxCvCs+JBEiABEjg0BCQD+VXleqKjZttM1ysnHOTrnUTVw8fmuPhq91I/XGzFe4iL7GNLT74t7pKDYrfdKrGB/8mCwEiEnAgARIgARI4WARyITP8pd6PUUBRM3Hi7gu6iFdoouTg4jcYKnTbyMFdCX8WN5r72ndNbdt2Vzftulpv1O+ojgLuwbq0PBsSIAESIAESOIwEclLfYTxxnjMJkAAJkAAJHCQCcOQata7sf/vWvULvDQpX+oFx7aA17bHuvv6Em6jfdCt+3RS6tF4X8N8OdZGG2uuBsbqASbdAf/jv8kG6qDwXEiCB+SUA4RbibR+hgCgFpJ4HBCrAbQtXLVJwY5WmuZiZNNqJ99Og+X2z1P6Zb+3m0KnJtvV1GN2vz10+1yJFhxEK83snseckQAIkQAIk8MwIME7hmaHkjkiABEiABOaZQI5WQFBi+7unlLpzJ6lqpFzVKt/5DX1s+maFIFy1aX7Tr9ozMVc1QzAiypshhQGZDEoblxdKtAKF3Hm+kdh3EiCBF0/giYCLCARk4MJ+K4m3IUa4cGWqTTW8tTUyclPaSxtqFP4ALtw/91O7mbypprZoy+FW+4o611HAffGXk2dAAiRAAiRAAkeFAEXco3Il2Q8SIAESIIEXTkA+rMOt1V3/nXWVlu7prh4oOHJVEdVGOjn5avfQarWVfsstOzRAawnF7TVbqZajNIRcY5T820wh94VfTZ4ACZDAXBJ4j4ALwRYlzSQuAYXNGqTgdihiVqVOt/hbr+NefJhGzR+1w+raQusfDaOeTmzRPH5ctRe+80qrrmJLDiRAAiRAAiRAAiTwjAgwE/cZgeRuSIAESIAESEAISOXxC7+rOrdwqk3jqkF8Yt0lP3XN8KFabb/ajMIXus1wO7SxTq3UNBdBQFXweVVS4zyiOA52ww/+vJ1IgARI4PkTgDabRVsRbiHfZgkX3tscoSDlzBpkm8vf6i7sIkJhHP5zWqr+dDEUG6qzVWWrtmj2mgtnkIN7FS5e/Hvw/LvAI5IACZAACZAACRxVAhRxj+qVZb9IgARIgAReGAH54C7FztzCRtvZad0N2iqpoh7qlYfmJIqdjeMft4/DndCGd4XcVk1jJxmLkHUh5oqA8MI6wAOTAAmQwPwRkL+6AV/FIQcXUwkFzZQ4cCHdQrTFl241SphVWK7CNGypYfuFtNj8iaqKjZTMVOuiLidlc3P5bKuuqEABd/5uIPaYBEiABEiABD5sAvbDPgD3TwIkQAIkQALzSODatdfTyYv/Pv18saCOuUGa1lNtmqn2pmzCuN6MjdlTu+o0SpyNNPJyIRTAtYVBCuD0YQrIW5DEhTzHeIV5vInYZxIggedFIAu40Gfl73Av4EpRMxQwE2EXX65BwtVTJODG2Ki9rm6+qo7t/aGu/YM1CLixqZrieGzWF9ebVyjgPq9rxuOQAAmQAAmQwNwRoBN37i45O0wCJEACJPC8CFy5ouM5OHIfqxudWq6b4ItKh64Zp+GGOta+2YgjdyveCTUcuQhWiLXagw93gqCFCQrnTODMrSHuMl7heV0wHocESGD+CGTXLeTafiwJuH0GbicOXN2qFlm4ja4k8Bx/pyehaf/KvdL9nmvN/RIC7gQO3M1x2dy+fbsFPEYozN8dxB6TAAmQAAmQwHMjQGfPc0PNA5EACZAACcwrAbi39M3/WRW3jj3woweDcnlsSzVpy26hO97cTRfMlvlsedy+bByMus6gEloaaq8L7dNAWzUw1nhtlIcnl1++zutNxH6TAAk8cwL4IBRi/yuIXL6sn0d4gqTfQsTNXtwKX6rhy7RYxd3Qdl81H2neaDa724t2ONH1pPLB1+sX1lt1BxEK+OLumZ8kd0gCJEACJEACJEAC+wT4YZC3AgmQAAmQAAl8yASQipD+92OqPakeNIPhYjVtmkmIbup23UOzlv46fCS8Mb0Xvh3b1MY2NshdnMCDO034+S6K6CArF97cPicXeY0sevYhXy7ungRIYA4I7Au2+wXMxH0bQwzw3u4LuCLi4i/vFAJukL/BEHD/Kp2dXK0ftu8shMFeUm5qBqb65plvNhRw5+CGYRdJgARIgARI4AAQoBP3AFwEngIJkAAJkMB8EBBH7vXfVa75xi1XFOMCDq7Ste3AGLXcxvRz3d+n3y5PmddMaYfw3nrtVAFf7gC5udmRq50pjX3iyOW/4fNx27CXJEACz5oAohOkPhm+EguQb0XAhYMW8i1ScCOeGLeQb7MDF6tic7f7lv2X1f+qHrrvltFMTSrqB2FS70DAvXj5YpAv6p71KXJ/JEACJEACJEACJPDDBNwPL+A8CZAACZAACZDAh0NAPugjVrFTb5yNb99QaYKf8nZ376nFcalbE79mP9lt1F93n/WNvuAW9KqJNkBpiPlnMwU0WyOhjchUsMphJMVJKeR+OJeKeyUBEjiqBPYFXMiuIeffqoSxljiFHJ8ACRc5uKoSBy4QxHaje9v9VPdGfKBulW5holxbb7qqvbCw3ii1HingHtUbhf0iARIgARIggYNHgHEKB++a8IxIgARIgASOMAGtdNKf1+HNt662xcbNduR9FbWbDpvRrrtvvu9eDf+pLdo/aB51twNKnaHAWY1q6IhViDXiFhr4xyRaoYWay2iFI3yfsGskQAIfAoEnDtwkTtyIL9UQoJBdue8KuIizQVHJTv72tg+779mXuv+oU/w7Uwz2bNM15WTatNu3IOCiiBkzcD+Ei8RdkgAJkAAJkAAJ/GME6OD5x8hwOQmQAAmQAAl8yATSlWTeVqqAI9cVG7soZmYH07YpumK6Fh6aX7a79jfKFXfaFrbQRRqYgR5rm0oUOyu00xgjckEcuSx49iFfKe6eBEjgCBAQt61EKEiAQhABF2XIkIOb4xPgv8UXZI2uIekiPyHtIkXhb/W4+ePkwlvD2m9rX1V2+Wy1rlQWcNUVleRLuSPAhV0gARIgARIgARI4JAQo4h6SC8XTJAESIAESOJoE0hvJ3ryr3Ma3HpWFKspF1ZTJ2aIy7WpzL37CT81v+BUPIReibaEHBvm4kG0h4uYnMnKRnmuQk2vwSIxXOJp3CXtFAiTwExEQ4faJC1diFLL/VuIUkH+rO9XpBr95kCJm8luHndiGN83L9VWzZW9bo3etLmpvp/WphVO1uowtmIH7E10ObkwCJEACJEACJPDjEWCcwo/HjVuRAAmQAAmQwLMh8HkVbz26Fk4dW2u2wnTaRY+X0EAyeFScCl9tR/GP263uXkCUAsSFaazUXpK8xk5PU6sxjfI7QdXwl0m8AgcSIAESIIGnCMCx8kTAlRxcBYttzsMNutV4qlbDgYvoGnhq8fd0IgJuPFv/nto0txb0aFvXvvJ2qT61faqPUKCA+xRdTpIACZAACZAACTxPAnTiPk/aPBYJkAAJkAAJ/AgC+FmvVm8o84Uv3XQ/dew1r7a2C9s2g+Rc0drumDhy7Z79N+WqedkWpjDeeuUQq+BSoZzBIw0QrzA0sIvBj8uipT+CMReRAAnMKYFcwAxfdSUt6beIUYATF7ni8N/mr8ZUo6skJSdbtRuq7q/0T3dXzX11uzB6koKf+jCp1y+st+pPIAa/gRxcirhzeiOx2yRAAiRAAiTw4glQxH3x14BnQAIkQAIkQAKZwBuXkl04fdO9VC66ajoaDEw7HOZohclqW5vX0rfNvx2e9q+aQg+ts15ycpVNHgKuR6jCUJ6Sl4tQBYsd8t943lckQALzTUAiFCQyITtwIeBKJi7mUy/gTiVGQUHBDZO0lbr4pj47vaq37Tvemkl24IqAe2a9z8C9DBmYAu5830/sPQmQAAmQAAm8YAL8gPeCLwAPTwIkQAIkQAJPExAh9/z5LMIWuw/eKZd1WSrly9Z1gzBqT4dv6M+UI/8pN7bLWoRcBxHXQ7j1agB/7nDmyIW31+Afef47/zRcTpMACcwPgX0BF9EJHUqVRUSGI3QGQm6npYTZVEksDdrEnfhQL8Q/VmvttWJX3UvJTGcC7jch4F5kBu783DPsKQmQAAmQAAkccALi1OFAAiRAAiRAAiRwQAhcvfF6unjiijprb6o0GMZYl2lceIVM3Nh1ac+9FO61D/QQ3rLVXNwMMY7Qa+Elk0Lp+M/gIcNMwMWiA9I1ngYJkAAJPB8CMweuuG5htIX7FvJtLmDWIkF8kp24+NsZd9NDsxD/c1ys/7TYHtwf6sEkNJBw4cClgPt8LhWPQgIkQAIkQAIk8P4J8IPd+2fFliRAAiRAAiTw3AikK8lcvw1H7pk7Xk0HfiX4sm7bgU5dWY/bk+GuveB33K8XK3ZdUnLxKHQRR7owQ+2RkWt0gaeFmuuQk6vxc2L+m//crh4PRAIk8AIJIPkWX3P1Am4nRR8TlmhEJ4QmVVjTZgfuZrytl9X/Y1cmX7T1aCNNmqkqfOX0bn12+WyL84/6io4vsB88NAmQAAmQAAmQAAm8hwCLn7wHB2dIgARIgARI4GAQEPEApXbStSvfTGcnZ0M3XImdD8q1hSr3yvv12uQrTYhRbanPFSv6NJpqo8w0G3NhyUU2bkw2otCZgUUXZdB0QryCGHQ5kAAJkMCRJZBy7q1EKKTUSXiCiLg66CYiQgFjWdZ0m/GO/Ujzf2Ld35q94WZM9VQXRS0C7s3lm+1ZdZYC7pG9RdgxEiABEiABEji8BPhh7vBeO545CZAACZDAHBCAkKvVFaVvril/79bD4kQoS9O0A6VsuTecHgv31MfdxP9mseLWsx8XCbkoeDZCNm6p+6JnDn7cAvKthyOXBc/m4J5hF0lgLgkgQgG/OED+rRQwE/EW2bcoYZZaXef8Wwi6sUm7KYb/mhCfgD+Gb5lY7oyin07qtnn1zGqtzqHlJThwWcBsLm8hdpoESIAESIAEDjoBc9BPkOdHAiRAAiRAAvNMAO7ZJK7c1x6pdvDR41U3rarGuYlSoS4q+9id0X8TFuN/aR/HW7HFQ/xmld6FWLEXWz2NKN6DpVWE+ww/MW4hcvDnwfN8Q7HvJHDUCMjfNIlOgHArMQpw4rYK0QmpVU1q1BR/+SqsD7FKW5Bxv2o+Ev4PlDP7u9IvPS47t2fDdAoBd3r1rasUcI/avcH+kAAJkAAJkMARI0An7hG7oOwOCZAACZDA0SUgrtzr/5ty/lv3CheGZdd1I+fCAEm4K7EKP9N9w/7b0Sn309qboUVKLry3pS7UANEKHs9C2VQaazxyFzwScvlF7tG9VdgzEpgPAknybhGK0LtwMR0RnoDUW8m/rdNkP/82xJ3wUC/oP9Rr9ZeL3fJeSu10pfbV5NRyva5UA1gRv3iQ6pBpPsCxlyRAAiRAAiRAAoeRAEXcw3jVeM4kQAIkQAJzTeCLV5Jb271X7oW2PKaGQ+PcoE3VsFvWp7u39Geg3/4rv2BWtZNiZxBuvRooh4AFiLnGiaiLqAUKuXN9D7HzJHDICYhsG1CgDAIuZNwcoQAXrpQv6xR+j6CmWCuu3K5F/q1ZSl8wy+0XdWMfjtuiqmzXvrKyUjE+4ZDfBTx9EiABEiABEpgzAhRx5+yCs7skQAIkQAJHg8Df/E7y6swdX9wblZ1thyPly1S0vhvG491d/XG7Yz+LnNxTkG4LeG8L5VOJaThyMYaoa0TgFSFX0ZF7NO4I9oIE5oQA5Nss3ooDF7kyiFGQqRylAAdunZqI+AQdECMzbR+Gt81H2t9TuvnaQj16lBBFs7fVtHZ8vHntGGIXLsN9y/zbOblx2E0SIAESIAESOPwEKOIe/mvIHpAACZAACcwpgfRGsl/5yq3iRDfyblCO6rQ7TNH6pgyr7R31iXJS/IZbNqch2OKhnSrSAK8Qc/H0Cg5eyLtS8IzRCnN6B7HbJHDICPSxCeKwDTP3bXbkSoRCnaYIU+gQiBDDNG2mEN/UH23+7/Qo/GBYL29r31XeLtW3tlVz4Qy2Z3zCIbv4PF0SIAESIAESIAGKuLwHSIAESIAESOAQExAh99qNt/1HpstlFYuhjm2pU1c2w7CW7riPp0fqV8tV85IZmFF233pVwI870D4NIOEiVkH3jlwKuYf4LuCpk8CRJ4BI8Cf5t+K+zdm3EpeQH02aSuFGEXfD43hbr6j/oleqL6WJvr/ixhPfjqtdreqzn0b+7efh02X27ZG/YdhBEiABEiABEjiKBCjiHsWryj6RAAmQAAnMFYE3LiV79tO3CrM98sPddoDkhKEIucmqhWbcHg/fsJ8tnfslv+DWIOCWcOVK0TMRcpGXm4XcUvJy4ci1cwWOnSUBEjj4BJ6OT8hCrgi4yLsNuk0tRFl4cOHKjRHj7kH4rn81/F9o8Hd+t9gcDOxe2bTNmlqrlcQn0H178K83z5AESIAESIAESOAfJcAPa/8oGq4gARIgARIggcNB4I0bV9S3P72Uzqph2iyaNCpdtCj5YzrXht12166nd9pWTfSWPmlKPYILTaEYUNo3oyESEh43hVedDGbM4eg1z5IESOCIExD3reTfdohMwDPBgauCzu5bDflWV5ByJT4hxD31KLbhK/bnmv+Ydrqvu67cHhZu4qZVdbw9XqlT2J4C7hG/Xdg9EiABEiABEjj6BOjEPfrXmD0kARIgARKYAwJQOzRECn1z7aaf1K+5uLfpVzeLoXLtYKfrBt24Xk33i08Ve/Zzftme0hZlzvBEebNSuTTULhc+E5duAY3XzQEydpEESODgEng3PgHCLb5zktJlyMLViE/QNYITGiyLqdV12En3zHL8U30sXEsb3b0yLUxNCrUbLlanFuDSvYz8W3ziYYTCwb3YPDMSIAESIAESIIH3R4Af0t4fJ7YiARIgARIggQNNIAsUcJphaNTrKlxX0/SwTGkYi+Txr31RFY/a09O/RsGzGB+qi27JnLalGaJTSeOnyHC7RVhwE6RghcJn8iUvf61zoK84T44EjiQBEW/xZ0wKl+EpYxFwRcINEHAbPU1dbMShG6dqE78e+JpbT1+Msf2G2/WPUyinKbW1CZP61InFBoQiBdwjeZ+wUyRAAiRAAiQwlwToxJ3Ly85OkwAJkAAJHGUC2ZX7hjI37yq39c7jwTB2Q2P9wGg76Eyz1FXpo+mh/hUf7Tm3YFal4JlCPi5KnA1toeDe1WivSogfjFY4yjcK+0YCB4kAhNkcn6B6AXdWvCxHKXS6DU2sNIRcfOMU46a6bVbVn9jj3ZfDVtoYpeGOaUNVqKbe3tlu3n7lle6iCLiMUDhIV5jnQgIkQAIkQAIk8BMSoIj7EwLk5iRAAiRAAiRwUAlIwbNPf1oV9+49LkrbDkbBl1VjC1NMh+3QrHa39cf9jv03xbJdh4A7QJEziLlqaIo0hrArxc4kWoFC7kG9wDwvEjgaBMR9KwKuZN5GdCkg/XbffYtiZG3Ovm1F1EV8QtU+7L5b/HT4fdh1v1Z0ftOool5Sw+mt+kFzrjtRqzMQgWWggJsx8IUESIAESIAESODoEKCIe3SuJXtCAiRAAiRAAu8hII7ca1eu2XLrNW+WR3659t6FdqiSLaex82oUVsNd/Qm/537LrZh1CLdehFzt1VgXkpOrJSPXY6eMVngPWc6QAAk8IwIi3wZUVkR8gki4It9qCLYSoLAv4IbUicAbdtNDrPzb8mfjH9iH6pZXZs9oNy3sQl09vtOun1lvrr6l0qU3VESBRuySAwmQAAmQAAmQAAkcLQIUcY/W9WRvSIAESIAESOA9BETIvXpJmY+ff9tP1BjpuGXRbrXDgXWFMqZoyulauGM+6Xbsrxdr7mVItiUyceHW1SWmRxB1B9rAn2tY7Ow9YDlDAiTwkxAQz23O4n7Xhdu7byHftrFVDcqYNRpibmz1pHsYvut/Jv0no8MNO3EPbRcaU/jKTavqxMkTjTqHrW5gT5fxB48C7k9yXbgtCZAACZAACZDAASZAEfcAXxyeGgmQAAmQAAk8KwLpSjI31A3X7R7zrS0cCp4h97Yd6NiVdRlWVND/In3d/XZ5zL5sB2YJIu4Asm2JtNyhwVhZ7SHmSskziVfg+4dndWG4HxKYLwJPOW8lQiFCyEXBMoQnwH3baWTfJgi4MUY4cXUV9tJjmHT/zv5s+0fpof3+IA63rOnqOoTO6ZX67DLcusi+fR0vlxmfMF93EntLAiRAAiRAAnNIgB/C5vCis8skQAIkQALzSeAKhNx/t45ohDt3/Opg4OOWL1RoSlUgXqGtRnGUjqf75peL7eJzftW+hExcDwHXKxQ8w3R26Gr8fllr7INZufN5E7HXJPDjEZDcW8TYQq5NCEqQ2IQcn6C7HJ0g4QmNrnPuraybqI2o4383q/HPUxlv2io+Kis7XejW9qrxvWZj4VR7TmEbOG/lKyWtGJ/w410WbkUCJEACJEACJHCYCFDEPUxXi+dKAiRAAiRAAj8hARFyLytlbi0pv739wKKeu491NypL61NofTuIa2nD/o9+x/2mX7anJUYB8QoePtzSoOgZ5FtvLHJzMYZywqzcn/B6cHMSOOIEsngL+VYctyLgingrRctaSb9Fei2m+sJluU3UbdiKd81q+jN7Mv2l2Q4PUmOnWnW1HvjK1MvV2U+rJkcn0Hl7xG8ddo8ESIAESIAESOCHCVDE/WEinCcBEiABEiCBI04Aqoq++oYy52/csFO16pZV6VRdlOLKTcYW00F1Ut11n1AP9P9UrJjT8OEuW2eQkYuc3EINIOAWKHiGTF0IvPpJxMIRp8bukQAJfEACiE6AVNuLt4hOENk2C7cdXjvEJdQR6bcahcwQqhDiVrobnfqGWeu+FGz8VtGl7UG3UJmiq7xdrDenN5vX7r7WKRQuo/v2A14JNicBEiABEiABEjgSBCjiHonLyE6QAAmQAAmQwAcnkMVcFD07f17ZbveejwulL/b8INi9EfJvF9IgrnbvmAt+1/1GuWrPaGudcqmAmDvoc3KT13Dlwpnrkk4WP2nm+4oPfhm4BQkcPQIi3yLjVoRbSK4QcjEtubfiwcXy1KYGIm6TEHgbq7TbbIQflB9Vv5/K8PexTpsL0/Fe1YZmbXmh3mtUc29Pdd95rOIlCLgsXHb0bhf2iARIgARIgARI4P0R4Iet98eJrUiABEiABEjgyBIQMff671x3zfiUO7E88pPddjAIzk9S693YHe/up3/tts2v+xW/Dj/uGC5cjyAFiLnIyc25ubpMNhVGYw5KLkDx/cWRvVvYMRL4JwiIeAthVoTbLN6GBCG3F281xNvYIUYBEi6mAzy4E0Qn3NHL8U/M8e562tH3F9J4r4Z4a1JXl+Pl5tS2aq6KeHsee2F8wj8BnqtIgARIgARIgATmgQA/ZM3DVWYfSYAESIAESOCfITBz5f7Sryo3+f495OAOClf5gbJNkUbtWqjUa2rD/JqL9ufdgl2TbNyclevUAFm5KHoGSdcgZgGFzyDhGoq5/wxwriaBo4m4rXEAACxVSURBVEUA8m123P5Q7m3vvEXubR1D7MXdTlVhT21on76B7Ns/T7b5e9suPjIhNg4CbjlebHZHqn0bhcsuKuyV4u3RulPYGxIgARIgARIggR+bAEXcHxsdNyQBEiABEiCBo0cgofDZDXXDdbvHfGsLtzzxhRo25UTFsV2Ix9t39C+7bfe5YsW9BPG2L3CGfFyDrFxlkjh0UfjMeMQx9GIuXblH7yZhj0jgXQL4/idHJwQsQtGyKB7cDqEHknuLKV0jOqGWbFy4cBuItw+TCW/p1fgXxVL6npoUW2XnJqYN1aRum+GZ1Xb9tmoV3LdK3LeX8TMBrWHu5UACJEACJEACJEACJEARl/cACZAACZAACZDAewiIKxfFg8yNG8rev/+gOFmWhU6uHMCVuzmYnlD33afNY3OxXPGn7SAtKYi21kPGdWmAJwRc+HId3Lky1pB1xZnLgQRI4KgQ6IVb8d7OnlLALCIoQSTcoOWJzNvURCllJtEJEG+1Sf9drYa/0OP0XbPnNorOT1wXmsoutEOn2o2FG+25c+eCukHx9qjcKOwHCZAACZAACZDAsyVAEffZ8uTeSIAESIAESODIEEgoK3/9d5Xz37pXxK70xtWFib6Mpl1WS3E13TK/7Hb9Z/2KfUl7UxoL9y0cuCh8BodugqgLh67J+bkoepaFXEnMpaB7ZO4QdmTOCIgjVgqWZfEWfx+izuIt5Fo4b3NwwqxomThxUdQsTtV2uxnu2BX1RXcmftXupEcq2Eqrotb1qCrHqtlYUBBvsbWIt4xOmLNbit0lARIgARIgARL4IATcB2nMtiRAAiRAAiRAAvNDQH7GDMtdp944Fb/ylVvR1KO4WviYKqRbpnKnPVU3nYGicz/9ql92p9PALGQhN6gGftwyFzKyyUHigbirbS6CJsXP5JEg53IgARI4LATEfSuuWgi4eE1aPLaz2ARx4ErJsgZLWvzRkLm62073kHn7RfcL4c30ODzoHpY7hWprk1bqqXnUulOj5uuz3NvPi/2fsQmH5WbgeZIACZAACZAACbwYAvwA9WK486gkQAIkQAIkcKgISFbuFzZu+p86tuybTe8WnSuatDOcxLBULNvVeNtcsDvFZ8oVuw651idx5MKZi6kiIVbBwIE7K4SmLBy6IubSlXuo7gGe7FwSeDo6QQqTRXHYStptFm5FtJXM2063UVy5bULRsvQQfwO+ro51X442fttXfsuY2Ir7dmUwrqqhatfXkXv7J9jbG3ji0wgF3Lm8t9hpEiABEiABEiCBD0iAIu4HBMbmJEACJEACJDCvBKDmaPzc2b6tlNuYPi7Lqh3E6LwqW5/KdELfLz6NskX/2i9bZOWaBYi1zkg6rkO0goi4JknUwiA/rZKoBRY/m9ebif0+6ATETxvEVZtjE+C8Rc2yAHc93LiSeQsRt9UQb5F7K8s6VYXd8AjhKd/Qa/FLeth8N+zZxwtpvFdPQ2sHXbPt6tYtbOTc26tXlboEAZdFyw76bcDzIwESIAESIAESOEgEKOIepKvBcyEBEiABEiCBA05AhNyrKHr28RvKvzN56P1eXSA5odSuKyDYLqQyrnTvmAvlnvuMP+bXIdx6YxCyIA8peoYiaNoltFelcaZUWA8hx4gVD13n+5IDfv15ekeewMx5C6etZN7mCAVx4OYCZTk0AX5bFC6TzNsYG70XtuN9OG6/aY/FL8dR+33Xui23Zyc6eUQndPWubtrCnmhvHVPhIjJ11WX8EUFUy5EnyQ6SAAmQAAmQAAmQwDMmwA9Lzxgod0cCJEACJEAC80BgFq/wUrnopOhZ0bQDh9Jme03jzFifSo/0r+gH9lNuyZ3yI72soeTup+G65JCeC+XXOIXiZ3DkirCrMSVCbh+xwPcn83ATsY8HhcB+wTL4bhVcthBsxXUrbltM44H8W8QmQMZtEKTQ4aRjnKgtxCY81iP1XXs8fFn59J1Up83QtNNxt9SYFOrdcd2Uo932FfVKp84hUZeFyw7K9eZ5kAAJkAAJkAAJHFIC/JB0SC8cT5sESIAESIAEXjQBOPH09d9VrtlTbu3uQ9cY7+x2U2rdlU2hF7qiWdV3i18wj9yvFCvutB+ZFY1ABSTlotAZHLgQciH+lCbn58oyiLpGWeTlijPXoH98n/KiLzKPf9QI9A5Y8dtqPKVMWX7FFMRZuG+zeCv5thKagFcRb1vk32YhV4Tbbive0WvhL8qX09eCOHHrbuLrwVRyb1PtK73c1sNh1d6+fbv9zuML8dJ5HIfu26N2H7E/JEACJEACJEACL4AAPxy9AOg8JAmQAAmQAAkcFQLQgvTVS8qcP6/sVN1x03ttuVIMCh+MTYhYaBCxoIZRCp/9K7vlfs0t2hMWAq/28OGKeAsRF69w4+LVKp+XoTCajPfFXHmvIoIuBxIggQ9G4F3BVgRaEW7loeQ1u25FwpVyZAH/G/f5t1iSIxSkYJnEJkgmbqumYZLgvI2PzHH9Jf9Se73bixvlpNgOTQzJqmRN2dqmayQ6QZ080dxX1+JFdTEiQxtB2oxO+GCXja1JgARIgARIgARI4EcToIj7o7lwKQmQAAmQAAmQwAcgcOVKMv/u9nWrzpzxCxNvQ4uo3NSUIuZOUutbCLm6Uq+YWr/mHvtfLdfcmZQduDkvF97cVEDEhZALAbcfOwQwFAnF0LKYK97cXszle5cPcF3YdC4JZJEWVluJRsiiLTTbBCk1u23hsu2zbrMDF216L654b8V1G7GBbKdQuGw37MSHycavm+Pxy2Yx3lWTtK3rcsc0sTUIUZm2Afkpi20THsTRyb1u4/ZGuPCZC1FdYtGyubzz2GkSIAESIAESIIEPlQA/CH2oeLlzEiABEiABEpgfAlCOsiv31c8o4791r2ht4fxWg7gEX3axsYORK3ZdteIe+l9JyMstV9xJO9TLEGsRniASbkLUAjJynThyEa8AYRerLHy4Frm5FjKuQ9CCZOfa+aHKnpLAByIg0myA7Tb2oq2WSfHfdhKUILEI2WkrS2ae2043sUsdPhSIGzeFKu0iAXeSynTTrum/MMPu7ThJj+PEVQV25ovQVV3bKFXU42Nr3d7GzbD1sdfizh2VLkrhMrpvP9AFY2MSIAESIAESIAESeL8EKOK+X1JsRwIkQAIkQAIk8L4JpDeSvXbjbe8nC34VrtxuOnVJtT5a66ztFuPQLnW3zS+5R+5TfsWsu7EVMdcmi9RcyLlZwLUQa0WwtdqIeIvlcOvqEnOSqetQ4V7ex/C9zPu+Kmx4RAlkSRbeWfHbwkULqVZiEBICESDaiqiL+YD/VfJcXoaEW4i6iExAoTK0jXWahN30sN2JG8VL+k01Sm/bhXhfT/ROirYyNb6TUbvtpCybk36p/d7mnXDhwnqrINxeA9SLUrgM7lv5v5HxCUf0LmO3SIAESIAESIAEXjgBfvB54ZeAJ0ACJEACJEACR5OARCxcUjfc1tY5u7z8wIZ7hU/Jeh8rO4Gg68Z6URVptbuTfgnFzz5VLPt1OzJLUtksO3PFmwt3rgQuIFYBUi5ycr0ZIHoB7l7bZ+qKyNsXQTuaENkrEvjRBCQmQQqR9Y5aCLhZpI0YIMxCru3gv81iLl77pNsOBcqwLgu3QXfYIqgG4u1e2ogu/j2KlX3ZL3Z3mi7tmHqwZ6rQloNhbEPszKhtxmG1my68HTZuvxJ2zqjsun0dJ3H5MgRcirc/+ipxKQmQAAmQAAmQAAk8QwIUcZ8hTO6KBEiABEiABEjgvQREYXq68Fm3sedKe9yYqi5KZx2qJvk9OHP90K2ImGs3ik8WK+a0GZkVOHMNohTgu4WMC+dtfsKjC0euh1+3NFaLM7fIcQsabbMJUOSk/HzviXCOBA4xAbHaaok/6Ics3YqDNj97MVfCEhCj0MclyHI4buG8TZ2IuMi77bIDV5Z3aRp21aN2L27Zgb5pT6avqIXutt9JW6mzVVfFsOTKZqoW23blYRy3x7uzP6e6axKXII7bG/if+sqTcznEVHnqJEACJEACJEACJHC4CFDEPVzXi2dLAiRAAiRAAoeSwEzMVedv2LNbMNt2lV90J13dNoPFypiJ2vF6cbDQDdo1ddv/gnqoP1Ws+NPIzF1EfILIssaImNsXQEPxs9QLuS6LuJKVC0cuJF2Iuf00pF2KuYfyXuFJ/xCBfbEWVlsRbfMDL5B0EZeQIM5CvBVXrZZyZSLSits2P1QjMq5sARG3hsQbOmTbGq+/pU6G/9cu63fCbrfngt9Uj0PtTQy1KltTts1WXXfDM+vd9Pb1JIXKrl5V6tJ57Il5tz90cThLAiRAAiRAAiRAAs+PAEXc58eaRyIBEiABEiABEgCBPmZBufv3HxQrxZ4btMdsTKh1b2s3gTO3Mc1YD9NKesf9on3oPuFX7bofuyV4co2BWAsXrsQswIULR67Iun1ebi56Jnm5kHI9RF9JZTAi/uI5e78zG/M6kMBBJCARCYi2xaMfnjhuc9otZFvYa7NQC7lWhFtMSwZu/4DTVqTbBt7bnHMrAq4UKQvb8b5ZMLfCJD62p5r/isCSW6bSu9NJV9nguzGE26kPjTNtO67XusdnbnT31f344K2LaSbcyukw63b/qnBEAiRAAiRAAiRAAi+IAD/MvCDwPCwJkAAJkAAJzDMB6FRavaHMzbvKTb5/z7Xbe27sT7g6bA0spNouGmuKdqEr1Wq6bX9Rb7pPDlYcnLl2SYRZRCmIXOuizWKugzO3z8yFXxdlzyRiwYngq6D7Snt5StIumIukK2MOJHAQCIhkK6LtTLDFtEi28j8IpFrJuIUYizfsUqRMRFsRcZ889l23LZbI2lzILIpwO007kHMnulTf8SfjX6pxd0sFU6uduKWmrvYLg9BVO8EOymbStN1SWYezP3c2RyY8eEulG3DdXmFkwkG4P3gOJEACJEACJEACJPCEAEXcJyg4QQIkQAIkQAIk8LwJQK3S116H2Kredn5S+7QzdGNXOLXnvB80tqo6XyyUo65sejH3kftkuQoxFwXQIOTCfat1MvDeoviZMhHOXAlTSB4ybS/zYp1k6fYxC4hj0BB7xaErhdIwoL8UdJ/3RefxhACEWJQly0JtFmUxjf8ZsExEWxFk0aYXbiHPSh6uqLtZ6pUYhey27QVdceSKYBsqvR3qWCkbvuFOqL80K+F+qszU1O0ktMNJaGIYuaJpOhQqKxebSXkvjOpT3Vat4s6Za2nmvGXeLW9QEiABEiABEiABEjiYBCjiHszrwrMiARIgARIggbkiIBEL59QNJ3m5Y+tNawu3+Nj5Km4PYKnNztx20C74xbQS3il+UT1UOTMXMm5hC1NCipVEXIdXOHSziCsF0PCAgJvjFbA8O3OzY1cEXoi72qN4GoRdEZE5kMBzItBLsZJVC1ctJFgIuRhJsm0v3iIWoZdrJTRBHLYRYq7uMN3CjStbiWs3qibtdXWaYElIg/jd4oz5mzAJm3ox3O227GNfdVNsGItYRjtCZELbRyZMyjb8y4VTLXob1X6hMnUZHl98H/KcCPAwJEACJEACJEACJEACPwYBirg/BjRuQgIkQAIkQAIk8OEQ6J251+zZjYsWTkH3qJv6xUnpRsr7NtY2Outai8zckVpJP/DnkKfwL2xnf8aVCFoY62WIuU5yEyDVOqTlZkcuAhVMys5brN136EK2hTaspThaH70g7tw+akHeG/H90Ydzeed5r7MIBBFgIeBmOTZIyC1cttBa8ZDlEG1FoEWRMhF1WxFuMSfTeXmq1W43jdvivE0+fdOdSddTHaZ6DQXLmmKCbzvatg3tKBZdq0Or26Kxg66piy6M2+Pd2WUVrqNY2c6ZHThvH6RLb1yKFG/n+bZk30mABEiABEiABA4TAX5IOUxXi+dKAiRAAiRAAnNEIMGdexXu3Fdvr7quLJ2OEHTbshAxNyREI4z0OJbdYvye/h/8kj0Z33EfG6yZM3pgFyRqQX59joRcCLg5PsH1Au6+O1fEXDh0sb7EEjhyjYXK1ufmZscufLqw9c4Rbnb1JyfwXidrL9tKDELOscUXFIhL0CGG2MFj22U3rQTg9im3cN1qCLaQaxGVgEgFSLfSBq9w3CLjdjuF2CLt+SaE2zfTrtpUi/UDN7GbTRNabwqJX1ABYnBnYnDDQVeE0E1W2q7YONH2kQkqXaTz9ie/ytwDCZAACZAACZAACbwgAvxw8oLA87AkQAIkQAIkQALvj4CIuV/YuOltueiWa28XJ85FXfmoWj/pWleMyqHVrVELfrV9J/2ieeg+Way4k1LUzI/0koi3WZKFD1cjLxcuXcnG7eMV4MiFmFtgiUQxoKaaiLvKy7QUQIOqi6CGJGENs/dMs/H7O3m2OqoEeom2793+NEYSSQB1Ft8fyEwOP4BKC38t3LSYQGBCjlFAKzhrJS4hdRBxJSqhbyuibpOmkosb99ImEm63kw/f8evqTV3pHb3SPNLR7+rG1c12bK0PnVVlW7exG9gQ2hVoxLspbaFQ2fLy2TCF6/bCZy5EdQPnc5mRCUf1ZmS/SIAESIAESIAE5oMAP4jMx3VmL0mABEiABEjgUBMQRezqJWXOn1d2evtOdua6ui6GDoLutPW11wjHta5B1EJaUMf09/xrbsEcCz/Q54tVs24HegFuW2iyeOsjpc5EoHWpyH5cRDAkRC9gFQRcOHwNpkXMFSFXxn1uLoRcbIOoBWyLpvktlIxkgu+nDvXd9YFPXiTaHG8AyTVLtiLd4q7Ic1KEDIZYyLZa3LZZtJUwBFkOERcRCXjtdCuNIN1mR64It6GGYItlblnf7yZxy78UrqdS/cA0ek9BzFVNB6226Ars26E4WQ3xthiFTqISath7Hy1Mw0k1iefUuXgNXXriur2C/3lw237gXnIDEiABEiABEiABEiCBA0WAHzoO1OXgyZAACZAACZAACfxzBMSZe3ND+Vvhge+6HTsOhTW68APk5frYWHHnpqEaGt0ZOxwstbfUL5hH7uN2bNZcYQZuZBchzyILFzZb8eZC4dK+F26htIlkm0VeCLnOWEi9OvUF0Pq83Zkr94mAC+1OBF68p5K3VaKV9W+vRHjOi6VDTyZk5snA92FPUHyoE08LmCK37g/9ZH8RZpditnI2P2ubx7KBiLbZNQsZFzpsDkOIuLy53BjWSckxUXYl6xYt8pQIt+K4lQccuXht9CQivzZO0mPJuNUoTKZPxetYNvVr+jG+jwhx2k1TZapYpWgQwTB2rqlV1070oC0W225p1EL3reMEwu309hQ5txdyXMLVq1fVpfOX6Lx9z6XjDAmQAAmQAAmQAAkcfgI/8h3q4e8We0ACJEACJEACJHDUCbxxKVlx5m5t3bLR77m0M3RLqUQBtMp6VECT/kcIunpsxt3QLMTH8aQN/qPqrr1QrLpTiME1plQLKG4m0QkSnCBjhTkPWVaiFaQkmsNSaQFpFxm6+zELWCPvobJ4C6VWDLoYib4nKh4m92VbmcDCLOaKFXOm5UIL7Kfzsnx02VSaPz1I835fTy/l9D9HIF+HLKWKkIpLIOprdsvitZ8WZ2rfbLYzmQPuvF6WyXS/pUzna5vFWRFjJQgBOxZRVi5ktuPmbcSFC6ctkmxb2VFuCzcucm4ReJCqhEgEEW/tsr4b9uJjfzq92ZXhFva3p6sWRctcp+uuVYOhGmCHohO7Andx6DpnB624bsvRbivCbe+4vaYevHUxXTqPzlyWTspZ7J97P8lXEiABEiABEiABEiCBI0Lghz8sHJFusRskQAIkQAIkQALzQmBWAO3s1lIWc930hB511nbVFDm3zvvU2F08dem81ak0i2pVve0/apbMyXAbcQvL9qS4bt2wL4iGaXhrUxaBId6iIBpeRRfDMqyTNXD+ZgHXQDWDrrsv5grwLLrmYFSYfCETyryoumiEvcqLKH7787k1Qh5ELZT99OvybqR9vzfZixwDD5ns9yErZeiFYZnK7d8zITOHYHivkvoPTlj6iyEj/Qcr+wX7UisAYQqE8n+QRQFalFrIsnDMYg2m5dFLsz+8ryzhyqbSImItPLRPL5ttL/vFo1+b95XnIOrmayvOW9mLOG4h2oap2smxCZXaTcP0XX9a/XWoml23ZjYMZN1uovbSxFTOpNA1IVhfdL4bdGGY4la9k4ZjGHKLJvgw7mZxCfcRl/AkKuEyzlbYcCABEiABEiABEiABEjjyBJ684z/yPWUHSYAESIAESIAEjjQBiG766ueVeXX1ujl25pjd3h3adrtwwTun9yq/hFJmVadRF6pxyBodKR+8Xkgr6dv+Vbdojrc/0B8rVuwpUVORobsI8RYOWymPBpUMCqE4c5NNTos7F5prnhNpVWRdEXJ7GVbcuXiK4ooXrJd9yEgEV7kA/ZsvWd0/sCZvk+VgLJN+5FaYxlHyI+u+eWO0Ft1uNp3bygH2l8s4N353XhRiaT47vkzPhryiX72/337JbP2zGIuqmbslY5yEzOOM8/jd+dyHJ2Jk7sNTB89b/Eghd39f2BvOHK+yZ+kKggyykVWm4ZeVVbJUhNzcQkZ5nRwFh5NZiT/Iy/AaBZdIsrIRohFy6bGIgmM5JiHPiZIbdZd3jTGSbuuuChPcFw6lyhq9oN92p8P/F1q1o1fjY+Ta7iikHpjOtXoSmmjLVGAPhYmhDbDaojBZ40YhVJupWericFiFra2lJwXKds7sIC7hYspFyq7gcko/OJAACZAACZAACZAACcwNgWf/Tn1u0LGjJEACJEACJEACB5UA9LonhdAkbqGut+3QnjZxMnEogGag4PrtWNtF+GArF4qYUNBsEJfV2+ZVyLcn0jvuY35JH7fOeVMikMGpErELXqRaqH3yFGVWCp+JDtnPZx0Q2poEMaAN1ktrCMFw0mYdV8RX2RDUsp6JqX5BL9bKFrN9SCMRaGVJfpHpvnHeJq/LO8pKMYRGWdk/sIG4gGevwiKLvCLuyu7y0E+JUpn3gtZ571jXL3u3pSyRTfolTy+XpaKNyvC0oDhbJktlOf6DACtKKY7Rj/cFVNkWe+x30b/mBfIi5513vf+CPYmm+p4B/cquWLHdygb58WR65qiV0ANJp92XaPuT3m/79Bb5bOU05azlVTJvIe1CqBVxNyaJSJC9SzxCnUJsw17aEqdtbCKiatVNfbr929SGKh2Puy7oOiEcAekc0bShTShJ5iDYWhQnc7prmw5FyYZtN0oLUWISJOP27a2Q6uUuTTe6dPJjr8WdOyrn3Gbh9jLOAUSE4XsgcIYESIAESIAESIAESGAuCLznzfFc9JidJAESIAESIAESmCsCosapK0pfU9fMSXXRTG/fcVXn7XgJubmbStlmW4diCRJnBZE2jVoTSzcMi3E3nTRV8TKSGF41E/OyG5tVMdvasV6ClCaapzh1oZViRkRK8ekiJxfOXDz310uhNBF6RcjtAxbyvGwhYqnIcuL0ld08ech03vH+uJ/BFvstZutltSzrxU5M5Zm+Va+X5mVZ+sur0FxaP9k+7zgfaX/TPJqJuMJtfzNM/ZCgur/pTE1EOzSf7e/dSelmr6n26+TwIoTKkNdlk2w+p35ZfpWVRhqieT8AVN5MtheLbd8NHLFXb+WAordmqRWvEoeADSSRNk+Hdx22+XykPR5Z5M07lgPlNhBkcVnzGSZk22JxiA38syLUSiSCtGpVZVb0/bgbNszZ8Faq1JZebTZDnSa+8jvw2AbVuGZaTPRIjXMHksPJ+JTgCw9dDHFQjMNuaLpRvdO9BrH2+vXrSgqTKXVNidsWtclQnAzneBlPnFzmm/fEFxIgARIgARIgARIggXklIO9ZOZAACZAACZAACZDA3BC4ciWZy28pfVXdsL90utC3dpx+bdXpRw+9wU/cfRZzp61XY+dDUQ1UQpbuQlwM3yleM8vmeLplztuBWjSFGYoyC1vvchZiLSqlQW/LgqeobnDhiv6W5VpZLEJo/8iqXN8CQrC4duU1K7/SRqRWzIs4i0kIh7L7fhmW9EuxNu+715GlbVZcsb7fVkZoKYNsmgVR7EtOIzfJa/rVaJGXZ+EXbWf7kPH+tJzeDwu5sz2gCU5RFNR+kA6LMpqPmuXQWcvZejn1foAkmrs4U2jlPMVGLJvn056dfd7fftyBrJUjigibHbYoIyZBBxJ5IMtFuMUYnRL3LYb9aSyUjsq6fHSslZwFbN3n2aKlbAOVtVatrjBuYqtqs6Buha3wwLzcfi3Uarc4EaH6I9G2gbAbdWUa1xaNrQLmHCqQ1cWw26k61NKD/XYokjOGM0odU+ux27iZmmNNmt6epgsQbfHFwj8oTJZ55o34QgIkQAIkQAIkQAIkQALvEujf3L87zykSIAESIAESIAESmCsCovGJU/f67esoYHbGL8ClO43ODqK1U7tnUJ/KxtY7u6THHoGmAcELyXfD9L3yVb/ojrW31Hk3MFnUhfJo7MAsQICEugs3qY6IXIAEi4NkEVQEWxFGs3SbxVk5Oub6VxFN0ThLujKNCyFrIWsa2UVeLuqmnLOMZT1e+3bSPm+D5sgAgCk4K537zbAKx5AZnEm/yf5llmPLLvK27073S3rRF0qkrMUiGbLam8XJfB44eQil7w759PIe+8Xymrecbb7f+InYm8XWJzvOO8oa8JNd4jD9A7sS3TV7bnHacNiKSKsD5NzswpU1ePZSLdqJtAuckHcxJcfLgi32hXHsUi1bY9xgmy63SaYzS+qOKdJNNYp3uyZO3Yq611ahFpdtUyPhVvm2FNEYQ3QKqQoxLvmyaeCyXSwh3IY2Vl2FwmRbsRdqpeW19zpsseR1PC9fyRflaXrSmAMJkAAJkAAJkAAJkAAJ/AMC+++m/8FyLiABEiABEiABEiCBuSMg+t+1K8q+opTb/vY9u+OtWSonrgmY6HzR1LUxRS+L+hQH2mtdm2aIQmiD9tvFK37ZHAu31Mfs0CwZJw9dwmVr3cgswWFqMW3g10XgQrLyJiyrdxBHc4pu3q2okJA8xdIr+p4MM0l3fyzLsyyK7XohFxvigXN/r2MX83mFvOzLqDKWbXEevRYrI6zPB5KFIvDm3eVjY3H+D8v2zwXt38cgh8Az/wd9NAuwT20mMqsszssxzgXEZJmcWX9EaZ2byIQcfj9GAV2XTbGkt7hCpMVsFlTx2j/EW9uXKIvQsrNFV5y10Fq7MEk7UHlRgkztoqjdvVjHHTUKt+KoveOOhc2YXLQhBp1s13WhdclHNekaq31Ahbyu03vBJt8Wg2Enom0ToAWPYlpaOIWKZipOb19PEotw8Rz6dkMAYLiMcY+xn88L+UICJEACJEACJEACJEACH4xAfs/+wTZhaxIgARIgARIgARI4+gQkduHXIKG+AkH37fs3nJqMXGmdWW21fox802UgCNOYNtvGDZRDtTQ7hvbnolcDbVOhts2xtOdPurFdinfMz5uBXsHm3ngNGRg6qjcDW+gSu8nKpYi1IvKKpRT/QYHVKkI8zbomWmAsumYWYKFcyhJsKmPsoBd+ZVrk2byNWFDznnMLmeq127wsb5LbPbXP/Xms6zVezD85Aib2B1mGfTzRWLHjJ+IkTnv/7POJ9cv3F+VDYgk2FR+rqMJZpoUcmwXZvBdZKIeV/mBadiZREmKvBQoRbGWfUlosO24h20JwlVgFiLxIohUZF1m2NaZRhAxu5KAbzHduxTwIu/GRfzm+1U26LXc8Pm4niEwINcTZsop1iwgFK5psFoTHxUgjLiFJlm0Y7MbCDnKWbYs826FbCONjdbe3sRe2ahQfO9MXH2OOrdwYHEiABEiABEiABEiABD4sAvL2mAMJkAAJkAAJkAAJkMA/QgD6oFaXlJll6D5AdoI0Lfbgz5waXcKkO427drIVinLsrKut2VWN9QNrk7VO+wbqox74EUpbbRXH9K47aUs76ibpZTXVH3EDlEqzysubMsisGk7fgSlUCSlTdE3IuvsrRMPMOmxvPBXhcl/qzIqpiJ1ZIs1qZy/AihAquil2JG0xiHaaJ2QmT8hxnjzynmQ5Fs3286T5k02wm9le846xU/wnh88DlkFwzfvdXzIboUWv2O63E5UZu9rvEPoru4XIK6+5tyLQyoDl+E+pTtdQb1NqUw1Vtc0LcTgpKuZW9IPsrPXpu2Yp3Qlt1+i1uG0jYm5FXVc2mlZPu9p1djLtQiqiQwQuEm27gHwEybNtNey3Y1hxS7hrJ8splhBxhw+gCq/ENcQk3Fzu0kk1iffVuShu26tQbi+dv5QQxyEA8inKaXIgARIgARIgARIgARIggWdNYPZu+1nvl/sjARIgARIgARIggSNJQMRFBJrqq29d1SfOn9BnN87arXpsK2TpjiHmTmG3LSbWBB+Tn0Lg7fb0glpQtTPG+d0yDb13ydimCD6VKH21pU74vfKkWE5hv7Wm0i+riT2rHRy7Vrmsp0IKhkSoZZkIl8apIi+HZxazOY5BFmfgCGvIUqjMSHCDyLcQOqHxYhKRC32rd68N1mcJNiuqaCtbozX0U+iwTzWGSrm/EXaDKTHDyj7xKkpznshC8n6rXrFFl0yuNZazaaURNs67ypZj2Y9It3iFQCt9keMioRZuWnhopS84CQQgdFjc2dW0ESHYmkH6vloKdyD3Ivc2BbeqH0PSncBIG2ytq7buGtP6oOsOGbalErG2cVojAiMWsYRIO4GnNsTWDCDNxjiEBbeRimaLHSrYLcfpyS4ewylM1Cs5ImFWhOziuYtZuL0B4ZZ5tvvXmSMSIAESIAESIAESIIHnQmD2Zvy5HIwHIQESIAESIAESIIGjRkD00devKP1r6pp58NZJc2I8MuUe1NZVq3cePzZ+McffKlef0OXetmm0t4MFhyJqStXVFIm5hddmz0fbx7y6wsHBG1xtgis2BqOEeIawpVawfBR29SkDF6/aVqcg6JYQUQ3iGUq8oZNCahqSbwHVU0RZo524eUVVxQza4HDSIttcZy5ZqK+yWtrLe0L4gJ9MYxZLZcivEHMRT4DVEmOARk9k3NxgJvXCNhtVqyDGiplWjpa1XaTRIoU2q7fITmgTrMlYLruAY1e2wLLaLMa7EG5b5CIEPVTfN4vt/YAdQIWOZqXbRphwwNaSc6s7KUBWW6QUFwohCpKpIJIvEmyh4qK9h1QbDFy2pgipmSASAdm1cRgHEowLp+0oLcSN8lEaDhfDquri21shnUAxsuZYk6br03ThzoV07Ukxst5t+zrOhcItIHAgARIgARIgARIgARJ4IQT6N+cv5NA8KAmQAAmQAAmQAAkcTQIQKDV+Yg+3rtInHlzTFy9eVDfeumHuQ+BdLEqzMX2gjw1PiANVqTvvMvArRj+qNvL7M1+jDloZfOGcmdjgHSqiaRN9Z1qoowVCHDD23qcNtyixDUjTdWrHraEVCqp5H/fiuvamQGMX9/Q6yqxB8RThVJy7OAQUYDHaikYqOb0iuopKKwcXnVbE23wis/l3TzMhcbbZj7Ltl2JL0YOhoDZ6Kd1L8MDifKBew6HbpkovwDUbdC/QLncb4p7FAQyibTu3nDY1xrrDelFgO5VgUc4ZtdFC651C7PZtN3SjpPb2+uONZTRW0e1khpB086lG1wvhwY8THLtpKNEIVUzNUher1MafasddNRNrb09zEbJ+h9fyqHfaKkQkAMFlIQSRmQMJkAAJkAAJkAAJkAAJHAACs/fmB+BUeAokQAIkQAIkQAIkcHQJZGEXkuDrryt9eb+bEslwCYG71yD0KnVRLf7s9afem11Qw8c39P0HEH4XSyMC787Wpjmujqnd0ppG7dmEgNdhWTjZHbJ0dexap4YQX8NQR8TAtq7J+/MQedvQasQwaI0xEn37M8DIItqh21DL1mIthmCgr2LIMzIxm7LYbQww+OpWr3VbIVgYZWGDxb4QT6s9ppLxSEMInWyFCm1a21I8svvLStXUNXbiugLibBO0XvBFrKddOysoVoZB7GCXHVUQc1FUrNZYVUDx3YtpYXEphoH4gB/I7vPQjY6lE9sQbs8odVuW4OXUGJXMkF379Y0u/dbHXovXr1/PbXfOXMC219QsEiFn2eY1+y8QbWeqNQRmtOVAAiRAAiRAAiRAAiRAAgeHwFMfFA7OSfFMSIAESIAESIAESGDeCIjI+/qV1yHwXlYi7vb9v6TEybv4sxf1/R/cnKUWqJ95DVLm3YHZGTwyp9Up5SqjH9daH8dGm4uw4jbQT9stPYV/d1ktqd1uR9sBjLxdNtq+By2aIL/XusbWmKh+5HvDIZTh2lcQgHMsb6jbFgGyIqi+O2SnLGb38JhNK7W732BBjSDK7uzuqvHqOO3sKDUcQRIuFhPMslEKiM32tPHo0WxSdWVIqwOIsjtdWju+Fm8+7tLZxS7l2IPb57DNddXn1c42uZYnfqRQS2ftDBLHJEACJEACJEACJEACh5DAj3yjfgj7wVMmARIgARIgARIggbkgkB296OnVS1fNiQcntEJUw+Lt63r4eIj3defU/fHbTzJ5/RSCLuIZ7qP9yRMnlK0ePXnvt4m4BtegktoYTxkjncEMe5F3W0FlxbDgF9Juu6uX1KLaa/fytmOJKvAQXbfh2kXxttwQL+KYnU3LWOaXy5X0tCib168ptTJcSQ8fbqjFtZW4htJiHcRZWfc2njORVuaniDyQ8c6ZPjZBxFmZl+EqnpduqPQ6xpfFRQuHsyxnDEKmwBcSIAESIAESIAESIIEjRuDJG/kj1i92hwRIgARIgARIgATmikAWd3MO735Ew/k+ouEiKFyfibznz2Um39u4qYc7Tks+745D8bUKgu64L8CmYIRdgfj6UG084ScRDpv1plYQYGfrN8eYxzATZFcHaxBYHygRjNdGXdoLa7GGODuFc1ba/dSx1zC+IZN5kAJiOyggdvEcBFgMIsrOXmZRB69Dmb18+XKOOZhFHMxE7Nm8bMaBBEiABEiABEiABEiABI46AYq4R/0Ks38kQAIkQAIkQAJzSWAmdubOQyZ9Oot3BiRn8l5CJu8NEXw/6NA7gGWrdyMNrj3ZyaxI2L4y+2Q5/LOYvoriYZeyeCvO2eyhlTmcBcXZp1BxkgRIgARIgARIgARIgAT2CfwYb9jJjgRIgARIgARIgARIYJ4IzARhEVhn07n/vQybxVeZpwA7T3cF+0oCJEACJEACJEACJPA8Cfz/7GtATIv3UZUAAAAASUVORK5CYII="/>
13</defs>
14</svg>
service/evil-forgejo/public/assets/img/logo.png deleted
Binary files a/service/evil-forgejo/public/assets/img/logo.png and /dev/null differ
service/evil-forgejo/public/assets/img/logo.svg deleted-14
......@@ -1,14 +0,0 @@
1<svg width="78" height="78" viewBox="0 0 78 78" fill="none" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
2<g clip-path="url(#clip0_555_6)">
3<rect x="-0.5" y="8" width="78.7516" height="61" fill="url(#pattern0_555_6)"/>
4</g>
5<defs>
6<pattern id="pattern0_555_6" patternContentUnits="objectBoundingBox" width="1" height="1">
7<use xlink:href="#image0_555_6" transform="scale(0.000717875 0.000926784)"/>
8</pattern>
9<clipPath id="clip0_555_6">
10<rect width="78" height="78" fill="white"/>
11</clipPath>
12<image id="image0_555_6" width="1393" height="1079" preserveAspectRatio="none" xlink:href="data:image/png;base64,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"/>
13</defs>
14</svg>
service/evil-forgejo/service.pkl deleted-114
......@@ -1,114 +0,0 @@
1extends "../../config/Service.pkl"
2
3import "../../config/Service.pkl" as service
4import "../../config/site.pkl" as site
5import "../postgres/service.pkl" as postgres
6
7class OAuthClient extends service.Requirement {
8 alias: String = "oauth"
9 fixed provider = "evil-forgejo"
10 fixed kind = "oauth-client"
11 name: String(isNotEmpty)
12 redirectUris: Listing<String>
13}
14
15local gitHost = if (site.domain.endsWith(".test")) "git.evil.\(site.domain)" else "git.evil.inc"
16
17meta { name = "evil.inc Git" }
18healthyDeadline = "20m"
19healthRestartGrace = "2m"
20setup = "setup.py"
21provide = "provide.py"
22
23requirements { new postgres.Database { name = "evil_forgejo" } }
24
25secrets {
26 ["lfs_jwt"] {}
27 ["oauth_jwt"] {}
28 ["security_key"] {}
29 ["internal_token"] {}
30 ["anubis_key"] {}
31 ["automation_password"] {}
32}
33
34requiredSecrets = if (site.domain.endsWith(".test")) new Listing {} else new Listing {
35 "mailer_address"
36 "mailer_username"
37 "mailer_password"
38}
39
40containers {
41 ["forgejo"] {
42 image = "code.forgejo.org/forgejo/forgejo@sha256:3d0ba60633e5ce50a4ac8afce06797eda5728411db047373e7d7d68cecb5bfe8"
43 entrypoint = "/bin/sh"
44 args { "/studio/start.sh" }
45 hostNetwork = true
46 imageUser = true
47 cpu = 300
48 memory = 1024
49
50 http {
51 containerPort = 3000
52 checkPath = "/api/healthz"
53 }
54
55 volumes {
56 ["/data"] {}
57 ["/studio/start.sh"] { config = "start.sh" }
58 ["/studio/app.ini"] { config = "app.ini" }
59 ["/custom/public"] { config = "public" }
60 }
61
62 env {
63 ["FORGEJO_CUSTOM"] = "/custom"
64 ["USER_UID"] = "\(module.uid)"
65 ["USER_GID"] = "\(module.uid)"
66 ["GIT_HOST"] = gitHost
67 ["DB_NAME"] = "${secret.database.name}"
68 ["DB_USER"] = "${secret.database.username}"
69 ["DB_PASSWORD"] = "${secret.database.password}"
70 ["FORGEJO_SERVER_LFS_JWT_SECRET"] = "${secret.own.lfs_jwt}"
71 ["FORGEJO_OAUTH2_JWT_SECRET"] = "${secret.own.oauth_jwt}"
72 ["FORGEJO_SECURITY_SECRET_KEY"] = "${secret.own.security_key}"
73 ["FORGEJO_SECURITY_INTERNAL_TOKEN"] = "${secret.own.internal_token}"
74 ["MAILER_ENABLED"] = if (site.domain.endsWith(".test")) "false" else "true"
75 ["MAILER_ADDRESS"] = if (site.domain.endsWith(".test")) "127.0.0.1" else "${secret.own.mailer_address}"
76 ["MAILER_USERNAME"] = if (site.domain.endsWith(".test")) "" else "${secret.own.mailer_username}"
77 ["MAILER_PASSWORD"] = if (site.domain.endsWith(".test")) "" else "${secret.own.mailer_password}"
78 }
79
80 envTemplate = """
81 FORGEJO_HTTP_PORT={{ env "NOMAD_PORT_forgejo_http" }}
82 {{ range nomadService 1 (env "NOMAD_ALLOC_ID") "postgres" }}DB_HOST=\(module.nomadHostPort){{ end }}
83 """
84 }
85
86 ["anubis"] {
87 image = "ghcr.io/techarohq/anubis@sha256:2babd956e4eb6daa06a41a9b3cbde394a0b2dae1872395f02a380436637c1bfa"
88 hostNetwork = true
89 imageUser = true
90 cpu = 100
91 memory = 256
92
93 http {
94 containerPort = 80
95 hostname = gitHost
96 checkPath = "/api/healthz"
97 checkHeaders { ["X-Real-Ip"] = "127.0.0.1" }
98 forwardRealIp = true
99 }
100
101 env {
102 ["COOKIE_DOMAIN"] = gitHost
103 ["REDIRECT_DOMAINS"] = gitHost
104 ["ED25519_PRIVATE_KEY_HEX"] = "${secret.own.anubis_key}"
105 ["COOKIE_PREFIX"] = "anubis_v1"
106 ["DIFFICULTY"] = "5"
107 }
108
109 envTemplate = """
110 BIND=:{{ env "NOMAD_PORT_anubis_http" }}
111 TARGET=http://127.0.0.1:{{ env "NOMAD_PORT_forgejo_http" }}
112 """
113 }
114}
service/evil-forgejo/setup.py deleted-70
......@@ -1,70 +0,0 @@
1#!/usr/bin/env python3
2import json
3import os
4import secrets
5import subprocess
6import sys
7import tempfile
8import urllib.error
9import urllib.request
10
11from api import instance
12
13
14data = json.load(sys.stdin)
15container, address = instance(data["serviceId"])
16script = """
17IFS= read -r password
18cd /app/gitea
19su-exec git /usr/local/bin/gitea admin user create \
20 --username studio-automation --email studio-automation@users.invalid \
21 --password "$password" --must-change-password=false >/dev/null 2>&1 || true
22su-exec git /usr/local/bin/gitea admin user change-password \
23 --username studio-automation --password "$password" >/dev/null
24su-exec git /usr/local/bin/gitea admin user must-change-password \
25 --unset studio-automation >/dev/null
26"""
27result = subprocess.run(
28 ["podman", "--url", "unix:///run/podman/podman.sock", "exec", "-i", container,
29 "/bin/sh", "-ec", script],
30 input=data["automation_password"] + "\n", text=True, capture_output=True,
31)
32if result.returncode:
33 raise RuntimeError("could not prepare Forgejo automation account")
34
35path = "nomad/jobs/" + data["serviceId"]
36request = urllib.request.Request(
37 "http://127.0.0.1:4646/v1/var/" + path,
38 headers={"X-Nomad-Token": os.environ["NOMAD_TOKEN"]},
39)
40with urllib.request.urlopen(request, timeout=5) as response:
41 variable = json.load(response)
42current = variable["Items"].get("automation_token")
43if current:
44 check = urllib.request.Request(address + "/api/v1/user", headers={"Authorization": "token " + current})
45 try:
46 with urllib.request.urlopen(check, timeout=5) as response:
47 response.read()
48 except urllib.error.HTTPError as error:
49 if error.code not in (401, 403):
50 raise
51 current = None
52if not current:
53 generated = subprocess.run(
54 ["podman", "--url", "unix:///run/podman/podman.sock", "exec", container,
55 "/bin/sh", "-ec", "cd /app/gitea; su-exec git /usr/local/bin/gitea admin user generate-access-token --username studio-automation --token-name studio-" + secrets.token_hex(8) + " --raw"],
56 check=True, capture_output=True, text=True,
57 ).stdout.strip()
58 if len(generated) < 20:
59 raise ValueError("Forgejo did not generate an automation token")
60 with tempfile.NamedTemporaryFile("w", suffix=".nv.hcl", delete=False) as file:
61 file.write("items {\n" + "".join(
62 f" {key} = {json.dumps(value)}\n"
63 for key, value in {**variable["Items"], "automation_token": generated}.items()
64 ) + "}\n")
65 filename = file.name
66 try:
67 subprocess.run(["nomad", "var", "put", "-in=hcl", "-out=none",
68 f"-check-index={variable['ModifyIndex']}", path, "@" + filename], check=True)
69 finally:
70 os.unlink(filename)
service/evil-forgejo/start.sh deleted-10
......@@ -1,10 +0,0 @@
1#!/bin/sh
2set -eu
3
4mkdir -p /custom/conf
5envsubst < /studio/app.ini > /custom/conf/app.ini
6chown "$USER_UID:$USER_GID" /custom/conf /custom/conf/app.ini
7chmod 750 /custom/conf
8chmod 600 /custom/conf/app.ini
9# The image's s6 bundle starts an SSH daemon on the host's port 22.
10exec /usr/bin/entrypoint /bin/bash -c 'source /etc/s6/gitea/setup; cd /app/gitea; exec su-exec git /usr/local/bin/gitea web'
service/evil-hedgedoc/icon.svg deleted-1
......@@ -1 +0,0 @@
1<svg fill="#1e81b0" role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>HedgeDoc</title><path d="m12.097.227-1.913 1.341L7.93.914 6.6 2.816l-2.346.142-.586 2.234-2.157.92.23 2.295L.032 9.995l1.015 2.083L0 14.14l1.679 1.616-.267 2.291 2.141.955.549 2.243 2.344.178 1.3 1.925 2.965-.836-6.421-6.298a4.548 4.548 0 0 1-1.491-3.364c0-2.542 2.1-4.601 4.692-4.601 1.406 0 2.668.607 3.527 1.57l.978.959 1.195-1.173a4.725 4.725 0 0 1 3.3-1.332c2.591 0 4.692 2.061 4.692 4.603 0 1.4-.702 2.628-1.644 3.497l-6.291 6.178a1.78 1.78 0 0 0-1.25-.509c-.489 0-.933.195-1.252.51.006.675.563 1.22 1.252 1.22.66 0 1.2-.502 1.248-1.139l2.822.78 1.33-1.901 2.348-.142.585-2.234 2.156-.921-.227-2.297 1.705-1.587-1.015-2.081L24 10.186l-1.68-1.614.266-2.293-2.14-.955-.55-2.243-2.344-.18L16.253.98l-2.265.619ZM9.292 13.58c-.614 0-1.111.489-1.111 1.091a1.1 1.1 0 0 0 1.111 1.09 1.1 1.1 0 0 0 1.112-1.09 1.1 1.1 0 0 0-1.112-1.09zm5.423 0a1.1 1.1 0 0 0-1.11 1.091 1.1 1.1 0 0 0 1.11 1.09c.616 0 1.112-.488 1.112-1.09 0-.602-.496-1.09-1.112-1.09z"/></svg>
service/evil-hedgedoc/service.pkl deleted-66
......@@ -1,66 +0,0 @@
1amends "../../config/Service.pkl"
2
3import "../../config/site.pkl" as site
4import "../evil-forgejo/service.pkl" as forgejo
5import "../postgres/service.pkl" as postgres
6
7local host = if (site.preview) "\(module.id).evil.\(site.domain)" else if (site.domain.endsWith(".test")) "md.evil.\(site.domain)" else "md.evil.inc"
8
9meta { name = "evil.inc Notes" }
10healthyDeadline = "15m"
11healthRestartGrace = "5m"
12
13requirements {
14 new postgres.Database { name = "evil_hedgedoc" }
15 new forgejo.OAuthClient {
16 name = "HedgeDoc"
17 redirectUris { "https://\(host)/auth/oauth2/callback" }
18 }
19}
20
21secrets { ["session_secret"] {} }
22
23container {
24 image = "quay.io/hedgedoc/hedgedoc@sha256:7b3f79667ad58c6419758547f10940638bcdc85ebee2a4e650318a704095975b"
25 cpu = 200
26 memory = 768
27
28 http {
29 containerPort = 3000
30 hostname = host
31 checkPath = "/_health"
32 metricsPath = "/metrics"
33 }
34
35 volumes { ["/hedgedoc/public/uploads"] {} }
36
37 env {
38 ["CMD_DB_DIALECT"] = "postgres"
39 ["CMD_DB_DATABASE"] = "${secret.database.name}"
40 ["CMD_DB_USERNAME"] = "${secret.database.username}"
41 ["CMD_DB_PASSWORD"] = "${secret.database.password}"
42 ["CMD_DOMAIN"] = host
43 ["CMD_PROTOCOL_USESSL"] = "true"
44 ["CMD_URL_ADDPORT"] = "false"
45 ["CMD_EMAIL"] = "false"
46 ["CMD_ALLOW_ANONYMOUS"] = "false"
47 ["CMD_ALLOW_ANONYMOUS_EDITS"] = "false"
48 ["CMD_SESSION_SECRET"] = "${secret.own.session_secret}"
49 ["CMD_OAUTH2_PROVIDERNAME"] = "git.evil.inc"
50 ["CMD_OAUTH2_CLIENT_ID"] = "${secret.oauth.clientId}"
51 ["CMD_OAUTH2_CLIENT_SECRET"] = "${secret.oauth.clientSecret}"
52 ["CMD_OAUTH2_BASEURL"] = "${secret.oauth.providerUrl}"
53 ["CMD_OAUTH2_AUTHORIZATION_URL"] = "${secret.oauth.providerUrl}/login/oauth/authorize"
54 ["CMD_OAUTH2_USER_PROFILE_ID_ATTR"] = "id"
55 ["CMD_OAUTH2_USER_PROFILE_USERNAME_ATTR"] = "username"
56 ["CMD_OAUTH2_USER_PROFILE_DISPLAY_NAME_ATTR"] = "full_name"
57 ["CMD_OAUTH2_USER_PROFILE_EMAIL_ATTR"] = "email"
58 }
59
60 envTemplate = """
61 {{ range nomadService 1 (env "NOMAD_ALLOC_ID") "postgres" }}CMD_DB_HOST={{ .Address }}
62 CMD_DB_PORT={{ .Port }}{{ end }}
63 {{ range nomadService 1 (env "NOMAD_ALLOC_ID") "evil-forgejo-forgejo" }}CMD_OAUTH2_TOKEN_URL=http://\(module.nomadHostPort)/login/oauth/access_token
64 CMD_OAUTH2_USER_PROFILE_URL=http://\(module.nomadHostPort)/api/v1/user{{ end }}
65 """
66}
service/flaresolverr/service.pkl+1-1
......@@ -1,6 +1,6 @@
11amends "../../config/Service.pkl"
22
3meta { name = "FlareSolverr" }
3name = "FlareSolverr"
44rollout = "overlapped"
55
66container {
service/forward-auth/service.pkl+3-4
......@@ -5,13 +5,13 @@ import "../../config/OpenID.pkl" as sso
55
66local isPreview = read?("prop:preview") == "true"
77
8meta { name = "Forward Auth" }
8name = "Forward Auth"
99rollout = "overlapped"
1010
1111requirements {
1212 new sso.Client {
1313 clientId = module.id
14 name = module.meta.name
14 name = module.name
1515 redirectUris {
1616 when (isPreview) { "https://\(module.id).\(site.domain)/snow.oauth2/callback" }
1717 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 {
2929 image = "quay.io/oauth2-proxy/oauth2-proxy@sha256:56e3daedf765c7a1eea6e366fbe684be7d3084830ade14b6174570d3c7960954"
3030 cpu = 100
3131 memory = 256
32 extraHosts { "\(sso.hostname):host-gateway" }
3332
3433 http {
3534 containerPort = 4180
......@@ -39,7 +38,7 @@ container {
3938
4039 volumes {
4140 ["/etc/ssl/certs/ca-certificates.crt"] {
42 src = "/var/lib/studio/ca-bundle.crt"
41 src = "/var/lib/snowglobe/ca-bundle.crt"
4342 readOnly = true
4443 }
4544 }
service/intake/service.pkl+2-1
......@@ -2,7 +2,8 @@ amends "../../config/Service.pkl"
22
33import "../../config/site.pkl" as site
44
5meta { name = "JSON Intake"; launcher = false }
5name = "JSON Intake"
6launcher = false
67
78secrets = if (site.domain.endsWith(".test")) new { ["key"] {} } else new {}
89requiredSecrets = if (site.domain.endsWith(".test")) new {} else new { "key" }
service/jackett/service.pkl+1-3
......@@ -1,11 +1,9 @@
11amends "../../config/Service.pkl"
22
3meta { name = "Jackett" }
3name = "Jackett"
44
55container {
66 image = "lscr.io/linuxserver/jackett@sha256:139a0819074ef16556399a66ee3c492f0d202ec20467cf9300d7126b8a31f2b5"
7 cpu = 200
8 memory = 512
97
108 http {
119 containerPort = 9117
service/jellyfin/configure.py+2-2
......@@ -10,13 +10,13 @@ import urllib.request
1010
1111config = json.load(sys.stdin)
1212base = f"https://{config['host']}"
13context = ssl.create_default_context(cafile="/var/lib/studio/ca-bundle.crt")
13context = ssl.create_default_context(cafile="/var/lib/snowglobe/ca-bundle.crt")
1414
1515
1616def request(path, data=None, token=None):
1717 headers = {
1818 "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"',
2020 }
2121 if token:
2222 headers["X-Emby-Token"] = token
service/jellyfin/service.pkl+3-6
......@@ -3,9 +3,7 @@ amends "../../config/Service.pkl"
33import "../../config/site.pkl" as site
44import "../../config/OpenID.pkl" as sso
55
6meta { name = "Jellyfin" }
7// SQLite under /config requires one writer during rollout.
8rollout = "simple"
6name = "Jellyfin"
97healthyDeadline = "20m"
108healthRestartGrace = "20m"
119prepare = "prepare.py"
......@@ -16,7 +14,7 @@ secrets { ["admin_password"] {} }
1614requirements {
1715 new sso.Client {
1816 clientId = module.id
19 name = module.meta.name
17 name = module.name
2018 redirectUris {
2119 "https://\(module.container.http.hostname)/sso/OID/r/snow"
2220 "https://\(module.container.http.hostname)/sso/OID/redirect/snow"
......@@ -28,7 +26,6 @@ container {
2826 image = "docker.io/jellyfin/jellyfin@sha256:aefb67e6a7ff1debdd154a78a7bbb780fd0c873d8639210a7f6a2016ad2b35db"
2927 cpu = 500
3028 memory = 3072
31 extraHosts { "\(sso.hostname):host-gateway" }
3229
3330 http {
3431 containerPort = 8096
......@@ -53,7 +50,7 @@ container {
5350 }
5451 ["/config/config/branding.xml"] { config = "branding.xml" }
5552 ["/etc/ssl/certs/ca-certificates.crt"] {
56 src = "/var/lib/studio/ca-bundle.crt"
53 src = "/var/lib/snowglobe/ca-bundle.crt"
5754 readOnly = true
5855 }
5956 }
service/keycloak/api.py deleted-83
......@@ -1,83 +0,0 @@
1import http.client
2import io
3import json
4import os
5import socket
6import ssl
7import time
8import urllib.error
9import urllib.parse
10
11
12class LoopbackHTTPS(http.client.HTTPSConnection):
13 def connect(self):
14 sock = socket.create_connection(("127.0.0.1", self.port), self.timeout)
15 self.sock = self._context.wrap_socket(sock, server_hostname=self.host)
16
17
18class Keycloak:
19 def configure_profile(self):
20 profile = self.request("/admin/realms/master/users/profile")
21 if not any(attribute["name"] == "picture" for attribute in profile["attributes"]):
22 profile["attributes"].append({"name": "picture", "displayName": "Profile picture",
23 "permissions": {"view": ["admin", "user"], "edit": ["admin", "user"]},
24 "validations": {"length": {"max": 8192}}})
25 self.request("/admin/realms/master/users/profile", "PUT", profile)
26
27 def __init__(self, host, password, attempts=300, cafile=None):
28 self.host = host
29 self.context = ssl.create_default_context(
30 cafile=cafile or ("/var/lib/caddy/.local/share/caddy/pki/authorities/local/root.crt"
31 if host.endswith(".test") else None)
32 )
33 self.token = None
34 for attempt in range(attempts):
35 try:
36 body = urllib.parse.urlencode({
37 "client_id": "admin-cli",
38 "grant_type": "password",
39 "username": "admin",
40 "password": password,
41 }).encode()
42 self.token = self.request("/realms/master/protocol/openid-connect/token", "POST", body)["access_token"]
43 break
44 except urllib.error.HTTPError as error:
45 if error.code not in (502, 503, 504) or attempt == attempts - 1:
46 raise
47 time.sleep(2)
48 except (ConnectionError, TimeoutError, http.client.HTTPException, ssl.SSLError):
49 if attempt == attempts - 1:
50 raise
51 time.sleep(2)
52
53 def request(self, path, method="GET", body=None, full=False):
54 headers = {}
55 if self.token:
56 headers["Authorization"] = "Bearer " + self.token
57 if isinstance(body, (dict, list)):
58 body = json.dumps(body).encode()
59 headers["Content-Type"] = "application/json"
60 elif body is not None:
61 headers["Content-Type"] = "application/x-www-form-urlencoded"
62 connection = LoopbackHTTPS(
63 self.host,
64 timeout=int(os.getenv("STUDIO_API_TIMEOUT", "10")),
65 context=self.context,
66 )
67 try:
68 connection.request(method, path, body=body, headers=headers)
69 response = connection.getresponse()
70 content = response.read(16 * 1024 * 1024 + 1)
71 if len(content) > 16 * 1024 * 1024:
72 raise ValueError("Keycloak response exceeds 16 MiB")
73 if response.status >= 400:
74 raise urllib.error.HTTPError(
75 "https://" + self.host + path, response.status, response.reason,
76 response.headers, io.BytesIO(content),
77 )
78 value = json.loads(content) if content else None
79 if full:
80 return {"body": value, "id": response.getheader("Location", "").rsplit("/", 1)[-1] or None}
81 return value
82 finally:
83 connection.close()
service/keycloak/configure.py deleted-67
......@@ -1,67 +0,0 @@
1#!/usr/bin/env python3
2import json
3import sys
4
5from api import Keycloak
6
7
8config = json.load(sys.stdin)
9keycloak = Keycloak(config["host"], config["password"])
10keycloak.configure_profile()
11keycloak.request(
12 "/admin/realms/master",
13 "PUT",
14 {
15 "displayName": "snow sign on",
16 "displayNameHtml": '<div class="kc-logo-text"><span>snow sign on</span></div>',
17 "editUsernameAllowed": True,
18 "resetPasswordAllowed": True,
19 "rememberMe": True,
20 "loginWithEmailAllowed": True,
21 "registrationAllowed": False,
22 "webAuthnPolicyRpEntityName": "snow sign on",
23 "webAuthnPolicyPasswordlessPasskeysEnabled": True,
24 "loginTheme": "snow",
25 },
26)
27roles_path = "/admin/realms/master/roles"
28roles = {role["name"]: role for role in keycloak.request(roles_path)}
29for name in ("admin", "infra-admin", "media", "media-manage"):
30 if name not in roles:
31 keycloak.request(roles_path, "POST", {"name": name})
32 roles[name] = keycloak.request(f"{roles_path}/{name}")
33
34users = keycloak.request("/admin/realms/master/users?username=admin&exact=true")
35if len(users) != 1:
36 raise ValueError("expected one bootstrap admin user")
37if users[0].get("email") or users[0].get("emailVerified"):
38 keycloak.request(
39 f"/admin/realms/master/users/{users[0]['id']}", "PUT",
40 {**users[0], "email": None, "emailVerified": False},
41 )
42mapping_path = f"/admin/realms/master/users/{users[0]['id']}/role-mappings/realm"
43assigned = {role["name"] for role in keycloak.request(mapping_path)}
44missing = [roles[name] for name in ("admin", "media", "media-manage") if name not in assigned]
45if missing:
46 keycloak.request(mapping_path, "POST", missing)
47
48snow = keycloak.request("/admin/realms/master/users?username=snow&exact=true")
49if not snow:
50 keycloak.request("/admin/realms/master/users", "POST", {
51 "username": "snow",
52 "enabled": True,
53 "credentials": [{"type": "password", "value": config["snow_password"], "temporary": False}],
54 })
55 snow = keycloak.request("/admin/realms/master/users?username=snow&exact=true")
56if len(snow) != 1:
57 raise ValueError("expected one snow user")
58if snow[0].get("email") != config["ownerEmail"] or not snow[0].get("emailVerified"):
59 keycloak.request(
60 f"/admin/realms/master/users/{snow[0]['id']}", "PUT",
61 {**snow[0], "email": config["ownerEmail"], "emailVerified": True},
62 )
63mapping_path = f"/admin/realms/master/users/{snow[0]['id']}/role-mappings/realm"
64assigned = {role["name"] for role in keycloak.request(mapping_path)}
65missing = [roles[name] for name in ("infra-admin", "media", "media-manage") if name not in assigned]
66if missing:
67 keycloak.request(mapping_path, "POST", missing)
service/keycloak/icon.svg deleted-1
......@@ -1 +0,0 @@
1<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" id="Layer_1" x="0" y="0" version="1.1" viewBox="0 0 512 512"><style>.st9{fill:#d0d0d0}.st11{fill:#d9d9d9}.st13{fill:#d8d8d8}.st14{fill:#e2e2e2}.st16{fill:#dedede}.st21{fill:#00b8e3}.st22{fill:#33c6e9}.st23{fill:#008aaa}</style><g id="g2460" transform="translate(.714 .07)"><path id="path1588" d="M432.9 149.2c-1.4 0-2.7-.7-3.4-2L370.1 44.1c-.7-1.2-2-2-3.5-2H124.2c-1.4 0-2.7.7-3.4 2L58.9 150.9l23.9 34.9c-.7 1.2-6.2 24-5.5 25.2L58.9 360.9l61.9 106.9c.7 1.2 2 2 3.4 2h242.4c1.4 0 2.7-.7 3.5-2l59.4-103.2c.7-1.2 2-2 3.4-2h73.8c2.4 0 4.4-2 4.4-4.4V153.6c0-2.4-2-4.4-4.4-4.4z" style="fill:#4d4d4d"/><path id="path1594" d="M72.7 245.3 6.4 269.4l-6.6-11.3c-.7-1.2-.7-2.7 0-3.9l30-52z" style="fill:#e1e1e1"/><path id="polygon1794" d="M511.3 258.3V309l-43.7-44.5z" style="fill:#c8c8c8"/><path id="path1798" d="m467.5 264.5 43.7 44.5v49.6c0 2.4-2 4.4-4.4 4.4H456z" style="fill:#c2c2c2"/><path id="polygon1802" d="M467.5 264.5 456 362.9h-61.2l-18.5-44.7z" style="fill:#c7c7c7"/><path id="polygon1804" d="M511.3 211.2v47l-43.7 6.2z" style="fill:#cecece"/><path id="path1808" d="M511.3 153.6v57.6l-43.7 53.2-33.1-115.3h72.2c2.4-.1 4.5 1.8 4.6 4.3z" style="fill:#d3d3d3"/><path id="polygon1812" d="M394.8 362.9h-32.3l-8.4-12 22.1-32.7z" style="fill:#c6c6c6"/><path id="polygon1814" d="m467.5 264.5-121.1-51.2 63.7-64.1h24.4z" style="fill:#d5d5d5"/><path id="path1816" d="m346.5 213.3 29.8 105 91.2-53.8z" class="st9"/><path id="polygon1818" d="m353.8 362.9.4-12 8.4 12z" style="fill:#bfbfbf"/><path id="polygon1820" d="m410.1 149.2-63.7 64.1-11.4-57.4 24.6-6.8h50.5z" class="st11"/><path id="path1822" d="m346.5 213.3-147 33.9 154.7 103.7z" style="fill:#d4d4d4"/><path id="path1824" d="m346.5 213.3 7.7 137.6 22.1-32.7z" class="st9"/><path id="path1826" d="m335 155.9-135.5 91.2 147-33.9z" class="st11"/><path id="polygon1828" d="m199.5 247.2-63.7 115.7H99.6L72.7 245.3z" class="st13"/><path id="path1830" d="m134.3 149.2-61.5 96.1L57.3 155l2.2-3.8c.7-1.2 2-1.9 3.4-1.9z" class="st14"/><path id="path1832" d="M99.6 362.9H62.7c-1.4 0-2.8-.8-3.5-2L6.4 269.4l66.4-24.1z" class="st13"/><path id="polygon1834" d="M29.9 202.1 57.1 155l15.7 90.3z" style="fill:#e4e4e4"/><path id="polygon1836" d="m335 155.9-40.8-6.8H159.4l40.1 98z" class="st16"/><path id="polygon1838" d="m199.5 247.2-40.1-98h-25.1l-61.5 96.1z" class="st16"/><path id="polygon1840" d="M324.7 362.9h29.1l.4-12z" style="fill:#c5c5c5"/><path id="polygon1842" d="M266.7 362.9h58l29.5-12-154.7-103.7 27.9 115.7z" class="st9"/><path id="polygon1844" d="m227.4 362.9-27.9-115.7-63.7 115.7z" style="fill:#d1d1d1"/><path id="polygon1856" d="m335.4 149.2-.4 6.8 24.6-6.8z" style="fill:#ddd"/><path id="polygon1858" d="m335 155.9-3.8-6.8h-37z" style="fill:#e3e3e3"/><path id="polygon1860" d="m335 155.9.4-6.8h-4.2z" class="st14"/><path id="path1862" d="m223.9 151-59.7 103.4c-.3.5-.4 1.1-.4 1.7h-41.7l82-142q.75.45 1.2 1.2l18.6 32.3c.5 1.1.5 2.4 0 3.4" class="st21"/><path id="path1864" d="M223.8 364.9 205.3 397q-.45.75-1.2 1.2l-82-142.2h41.7c0 .6.1 1.1.4 1.6l59.6 103.2c.8 1.2.9 2.9 0 4.1" class="st22"/><path id="path1866" d="m204 114.2-82 141.9-20.6 35.6-19.6-34c-.3-.5-.4-1-.4-1.6s.1-1.2.4-1.7l19.9-34.4 60.4-104.5c.6-1.1 1.8-1.8 3-1.8h37.2c.6 0 1.2.2 1.7.5" class="st23"/><path id="path1868" d="M204 398.2c-.5.3-1.1.5-1.8.5h-37.1c-1.3 0-2.4-.7-3-1.8l-55.2-95.6-5.5-9.5 20.6-35.6z" class="st21"/><path id="path1870" d="m368.9 256.1-82 142q-.75-.45-1.2-1.2L267 364.7c-.5-1-.5-2.3 0-3.3L326.7 258c.3-.5.5-1.2.5-1.8z" class="st23"/><path id="path1872" d="M409.4 256.1c0 .6-.2 1.3-.5 1.8l-80.3 139.3c-.6 1-1.8 1.7-3 1.6h-37c-.6 0-1.2-.2-1.8-.5L368.9 256l20.6-35.6 19.5 33.8c.3.7.4 1.3.4 1.9" class="st21"/><path id="path1874" d="M368.9 256.1h-41.7c0-.6-.2-1.2-.5-1.8L267 151.2c-.6-1.1-.6-2.5 0-3.6l18.6-32.2q.45-.75 1.2-1.2z" class="st21"/><path id="path1876" d="m389.4 220.5-20.6 35.6-82-142c.6-.3 1.2-.5 1.8-.5h37.1c1.2 0 2.3.6 3 1.6z" class="st22"/></g></svg>
\ No newline at end of file
service/keycloak/provide.py deleted-100
......@@ -1,100 +0,0 @@
1#!/usr/bin/env python3
2import json
3import sys
4import urllib.parse
5
6from api import Keycloak
7
8
9data = json.load(sys.stdin)
10request = data["request"]
11if request["kind"] != "client":
12 raise ValueError("unsupported Keycloak input")
13stage_id = data.get("stageId")
14client_id = request["clientId"]
15if stage_id and client_id != stage_id:
16 client_id += "-" + stage_id[-8:]
17if data.get("operation") == "delete" and not stage_id:
18 raise ValueError("refusing to delete a production client")
19existing = data.get("existing") or {}
20if existing.get("clientId") and existing["clientId"] != client_id:
21 raise ValueError("client ID changed; migrate the existing client before deployment")
22keycloak = Keycloak(data["host"], data["providerSecrets"]["password"])
23desired = {
24 "protocol": "openid-connect",
25 "clientId": client_id,
26 "name": request["name"],
27 "publicClient": False,
28 "authorizationServicesEnabled": False,
29 "serviceAccountsEnabled": False,
30 "implicitFlowEnabled": False,
31 "directAccessGrantsEnabled": False,
32 "standardFlowEnabled": True,
33 "frontchannelLogout": True,
34 "redirectUris": request["redirectUris"],
35 "attributes": {"post.logout.redirect.uris": "*"},
36}
37path = "/admin/realms/master/clients"
38query = "?" + urllib.parse.urlencode({"clientId": client_id})
39found = keycloak.request(path + query)
40matches = [client for client in found if client["clientId"] == client_id]
41if len(matches) > 1:
42 raise ValueError(f"duplicate Keycloak client: {client_id}")
43if data.get("operation") == "delete":
44 if matches:
45 keycloak.request(f"{path}/{matches[0]['id']}", "DELETE")
46 sys.exit(0)
47if not matches:
48 keycloak.request(path, "POST", desired)
49 found = keycloak.request(path + query)
50 matches = [client for client in found if client["clientId"] == client_id]
51 if len(matches) != 1:
52 raise ValueError(f"Keycloak client was not created: {client_id}")
53uuid = matches[0]["id"]
54current = keycloak.request(f"{path}/{uuid}")
55attributes = {**(current.get("attributes") or {}), **desired["attributes"]}
56if any(current.get(key) != value for key, value in desired.items() if key != "attributes") or current.get("attributes", {}) != attributes:
57 keycloak.request(f"{path}/{uuid}", "PUT", {**current, **desired, "attributes": attributes})
58aliases = request.get("usernameAliases", {})
59if aliases:
60 if len(set(aliases.values())) != len(aliases):
61 raise ValueError("Shale username aliases must be unique")
62 roles_path = f"{path}/{uuid}/roles"
63 roles = {role["name"]: role for role in keycloak.request(roles_path)}
64 if set(roles) - set(aliases.values()):
65 raise ValueError("username alias clients cannot also carry permission roles")
66 for username, alias in aliases.items():
67 users = keycloak.request("/admin/realms/master/users?" + urllib.parse.urlencode({"username": username, "exact": "true"}))
68 if len(users) != 1:
69 raise ValueError(f"expected one alias account: {username}")
70 if alias not in roles:
71 keycloak.request(roles_path, "POST", {"name": alias, "description": "Shale username alias"})
72 roles[alias] = keycloak.request(roles_path + "/" + urllib.parse.quote(alias, safe=""))
73 owners = keycloak.request(roles_path + "/" + urllib.parse.quote(alias, safe="") + "/users")
74 if any(owner["id"] != users[0]["id"] for owner in owners):
75 raise ValueError(f"username alias already assigned: {alias}")
76 assigned = keycloak.request(f"/admin/realms/master/users/{users[0]['id']}/role-mappings/clients/{uuid}")
77 if any(role["name"] != alias for role in assigned):
78 raise ValueError(f"multiple username aliases for {username}")
79 if not assigned:
80 keycloak.request(f"/admin/realms/master/users/{users[0]['id']}/role-mappings/clients/{uuid}", "POST", [roles[alias]])
81 mapper = {
82 "name": "Shale username alias", "protocol": "openid-connect",
83 "protocolMapper": "oidc-usermodel-client-role-mapper",
84 "config": {"usermodel.clientRoleMapping.clientId": client_id,
85 "claim.name": "preferred_username", "jsonType.label": "String",
86 "multivalued": "false", "access.token.claim": "true",
87 "id.token.claim": "true", "userinfo.token.claim": "true"},
88 }
89 mappers_path = f"{path}/{uuid}/protocol-mappers/models"
90 matches = [item for item in keycloak.request(mappers_path) if item["name"] == mapper["name"]]
91 if len(matches) > 1:
92 raise ValueError("duplicate Shale username mapper")
93 if not matches:
94 keycloak.request(mappers_path, "POST", mapper)
95 elif any(matches[0].get(key) != value for key, value in mapper.items()):
96 keycloak.request(f"{mappers_path}/{matches[0]['id']}", "PUT", {**mapper, "id": matches[0]["id"]})
97secret = keycloak.request(f"{path}/{uuid}/client-secret")["value"]
98if not secret:
99 raise ValueError(f"Keycloak client has no secret: {client_id}")
100print(json.dumps({"clientId": client_id, "clientSecret": secret, "issuerUrl": f"https://{data['host']}/realms/master"}))
service/keycloak/service.pkl deleted-73
......@@ -1,73 +0,0 @@
1extends "../../config/Service.pkl"
2
3import "../../config/Service.pkl" as service
4import "../../config/site.pkl" as site
5import "../postgres/service.pkl" as postgres
6
7class OpenIDClient extends service.Requirement {
8 alias: String = "oidc"
9 fixed provider = "keycloak"
10 fixed kind = "client"
11 clientId: String(isNotEmpty)
12 name: String
13 redirectUris: Listing<String> = new { "*" }
14 usernameAliases: Mapping<String, String> = new {}
15}
16
17local database = new postgres.Database { name = "keycloak_next" }
18
19meta { name = "Keycloak"; launcher = false }
20traceServiceName = module.id
21dependsOn { "victoria" }
22healthyDeadline = "20m"
23setup = "configure.py"
24provide = "provide.py"
25
26requirements { database }
27
28container {
29 image = "quay.io/keycloak/keycloak@sha256:82a77884f3af238beab1e7afd63b5f530e1b5c0590bd7aa60b40a40463e29b2c"
30 rootGroup = true
31 cpu = 500
32 memory = 1200
33 args { "start" }
34
35 http {
36 containerPort = 8080
37 subdomain = "auth"
38 plainHostnames { "keycloak.\(site.domain)" }
39 checkPath = "/realms/master"
40 }
41
42 volumes {
43 ["/opt/keycloak/data"] {}
44 ["/opt/keycloak/themes/snow"] { config = "theme" }
45 }
46
47 env {
48 ["JAVA_TOOL_OPTIONS"] = read?("env:STUDIO_JAVA_OPTIONS") ?? ""
49 ["KC_DB"] = "postgres"
50 ["KC_DB_USERNAME"] = "${secret.database.username}"
51 ["KC_DB_PASSWORD"] = "${secret.database.password}"
52 ["KC_BOOTSTRAP_ADMIN_USERNAME"] = "admin"
53 ["KC_BOOTSTRAP_ADMIN_PASSWORD"] = "${secret.own.password}"
54 ["KC_HTTP_ENABLED"] = "true"
55 ["KC_PROXY_HEADERS"] = "xforwarded"
56 ["KC_HOSTNAME"] = "https://\(module.container.http.hostname)"
57 ["KC_TRACING_ENABLED"] = "true"
58 ["KC_TRACING_PROTOCOL"] = "http/protobuf"
59 ["KC_TELEMETRY_SERVICE_NAME"] = module.id
60 ["KC_TRACING_SAMPLER_TYPE"] = "parentbased_traceidratio"
61 ["KC_TRACING_SAMPLER_RATIO"] = "0.25"
62 }
63
64 envTemplate = """
65 {{ range nomadService 1 (env "NOMAD_ALLOC_ID") "\(database.provider)" }}KC_DB_URL=jdbc:postgresql://\(module.nomadHostPort)/{{ with nomadVar "nomad/jobs/\(module.id)/inputs/database" }}{{ .name }}{{ end }}{{ end }}
66 {{ range nomadService 1 (env "NOMAD_ALLOC_ID") "victoria-traces" }}KC_TRACING_ENDPOINT=http://\(module.nomadHostPort)/insert/opentelemetry{{ end }}
67 """
68}
69
70secrets {
71 ["password"] {}
72 ["snow_password"] {}
73}
service/keycloak/theme/login/resources/css/styles.css deleted-1
......@@ -1 +0,0 @@
1../../../../../../dashboard/web/sso/css/styles.css
\ No newline at end of file
service/keycloak/theme/login/resources/font/.gitignore deleted
service/keycloak/theme/login/resources/img/license.txt deleted-1
......@@ -1 +0,0 @@
1../../../../../../dashboard/web/sso/img/license.txt
\ No newline at end of file
service/keycloak/theme/login/resources/img/miku-dark.png deleted-1
......@@ -1 +0,0 @@
1../../../../../../dashboard/web/sso/img/miku-dark.png
\ No newline at end of file
service/keycloak/theme/login/resources/img/miku-light.png deleted-1
......@@ -1 +0,0 @@
1../../../../../../dashboard/web/sso/img/miku-light.png
\ No newline at end of file
service/keycloak/theme/login/resources/js/stars.js deleted-105
......@@ -1,105 +0,0 @@
1const shader = `
2 // Heavily modified off of https://www.shadertoy.com/view/3sKGWw
3 // big thanks to these resources as well:
4 // https://youtu.be/3CycKKJiwis
5 // https://www.shadertoy.com/view/4djSRW
6 // https://www.shadertoy.com/view/3s3GDn
7
8 precision mediump float;
9 uniform vec2 u_resolution;
10 uniform float u_time;
11 uniform bool u_mask;
12
13 float random(vec2 p){
14 vec3 p3 = fract(vec3(p.xyx) * .1031);
15 p3 += dot(p3, p3.yzx + 33.33);
16 return fract((p3.x + p3.y) * p3.z);
17 }
18
19 vec2 random2(vec2 p){
20 vec3 p3 = fract(vec3(p.xyx) * vec3(.1031, .1030, .0973));
21 p3 += dot(p3, p3.yzx+33.33);
22 return fract((p3.xx+p3.yz)*p3.zy);
23 }
24
25 void main() {
26 float glow;
27 vec2 uv;
28 vec2 fl;
29 vec2 local_uv;
30 vec2 seed;
31 vec2 centre;
32 vec2 cell;
33 float t = u_time * 0.00015;
34 float blinkTime = u_time * 0.0068;
35 float rotationAngle = -t * 21.0;
36 mat2 rotation = mat2(cos(rotationAngle), -sin(rotationAngle),
37 sin(rotationAngle), cos(rotationAngle));
38 vec3 col = vec3(0);
39
40 centre = vec2(cos(t), sin(t)) * 5.0 + 0.5;
41
42 // Get uv from the fragment coordinates, rotation and depth
43 uv = (centre - (gl_FragCoord.xy - u_resolution / 2.0) / (1600.0 / 25.0)) * rotation;
44 fl = floor(uv);
45 // The local cell coordinates. uv-fl == frac(uv)
46 local_uv = uv - fl - 0.5;
47
48 // For a 3x3 group of cells around the fragment, find the distance from the points
49 // of each to the current fragment and draw an accumulative glow accordingly
50 // The local cell is (0, 0)
51 for(float j = -1.0; j <= 1.0; j++){
52 for(float k = -1.0; k <= 1.0; k++){
53 cell = vec2(j, k);
54 seed = 128.0 + (fl + cell);
55 glow =
56 ((0.6 + 0.5 * sin((128.0 * random(seed)) * blinkTime))) * 25.0
57 * pow(0.005 / length(local_uv - (cell + 0.9 * (random2(seed) - 0.5))), 2.0);
58 col += vec3(0.2 * glow) + 0.1 * glow;
59 }
60 }
61
62 col = 1.0 - exp(-col);
63 col = pow(col, vec3(0.45));
64
65 if (u_mask) {
66 float mask = smoothstep(100.0, 300.0, length(vec2(gl_FragCoord.x - u_resolution.x/2.0, gl_FragCoord.y - 200.0)));
67 col *= mask;
68 }
69
70 gl_FragColor = vec4(col * (u_mask ? 0.6 : 0.25), 0);
71 }
72`;
73
74function createShader(gl, type, source) {
75 const shader = gl.createShader(type);
76 gl.shaderSource(shader, source);
77 gl.compileShader(shader);
78 const success = gl.getShaderParameter(shader, gl.COMPILE_STATUS);
79 if (success) {
80 return shader;
81 }
82
83 // eslint-disable-next-line no-console
84 console.error(gl.getShaderInfoLog(shader));
85 gl.deleteShader(shader);
86 throw new Error("Failed to compile shader");
87}
88
89function createProgram(gl, vertexShader, fragmentShader) {
90 const program = gl.createProgram();
91
92 gl.attachShader(program, vertexShader);
93 gl.attachShader(program, fragmentShader);
94 gl.linkProgram(program);
95
96 const success = gl.getProgramParameter(program, gl.LINK_STATUS);
97 if (success) {
98 return program;
99 }
100
101 // eslint-disable-next-line no-console
102 console.error(gl.getProgramInfoLog(program));
103 gl.deleteProgram(program);
104 throw new Error("Failed to link program");
105}
service/keycloak/theme/login/resources/js/webauthnRegister.js deleted-159
......@@ -1,159 +0,0 @@
1import { base64url } from "rfc4648";
2
3export async function registerByWebAuthn(input) {
4 // Check if WebAuthn is supported by this browser
5 if (!window.PublicKeyCredential) {
6 returnFailure(input.errmsg);
7 return;
8 }
9
10 const publicKey = {
11 challenge: base64url.parse(input.challenge, { loose: true }),
12 rp: { id: input.rpId, name: input.rpEntityName },
13 user: {
14 id: base64url.parse(input.userid, { loose: true }),
15 name: input.username,
16 displayName: input.username,
17 },
18 pubKeyCredParams: getPubKeyCredParams(input.signatureAlgorithms),
19 };
20
21 if (input.attestationConveyancePreference !== "not specified") {
22 publicKey.attestation = input.attestationConveyancePreference;
23 }
24
25 const authenticatorSelection = {};
26 let isAuthenticatorSelectionSpecified = false;
27
28 if (input.authenticatorAttachment !== "not specified") {
29 authenticatorSelection.authenticatorAttachment =
30 input.authenticatorAttachment;
31 isAuthenticatorSelectionSpecified = true;
32 }
33
34 if (input.requireResidentKey !== "not specified") {
35 if (input.requireResidentKey === "Yes") {
36 authenticatorSelection.requireResidentKey = true;
37 } else {
38 authenticatorSelection.requireResidentKey = false;
39 }
40 isAuthenticatorSelectionSpecified = true;
41 }
42
43 if (input.userVerificationRequirement !== "not specified") {
44 authenticatorSelection.userVerification = input.userVerificationRequirement;
45 isAuthenticatorSelectionSpecified = true;
46 }
47
48 if (isAuthenticatorSelectionSpecified) {
49 publicKey.authenticatorSelection = authenticatorSelection;
50 }
51
52 if (input.createTimeout !== 0) {
53 publicKey.timeout = input.createTimeout * 1000;
54 }
55
56 const excludeCredentials = getExcludeCredentials(input.excludeCredentialIds);
57 if (excludeCredentials.length > 0) {
58 publicKey.excludeCredentials = excludeCredentials;
59 }
60
61 try {
62 const result = await doRegister(publicKey);
63 returnSuccess(result, input.initLabel, input.initLabelPrompt);
64 } catch (error) {
65 returnFailure(error);
66 }
67}
68
69function doRegister(publicKey) {
70 return navigator.credentials.create({ publicKey });
71}
72
73function getPubKeyCredParams(signatureAlgorithmsList) {
74 const pubKeyCredParams = [];
75 if (signatureAlgorithmsList.length === 0) {
76 pubKeyCredParams.push({ type: "public-key", alg: -7 });
77 return pubKeyCredParams;
78 }
79
80 for (const entry of signatureAlgorithmsList) {
81 pubKeyCredParams.push({
82 type: "public-key",
83 alg: entry,
84 });
85 }
86
87 return pubKeyCredParams;
88}
89
90function getExcludeCredentials(excludeCredentialIds) {
91 const excludeCredentials = [];
92 if (excludeCredentialIds === "") {
93 return excludeCredentials;
94 }
95
96 for (const entry of excludeCredentialIds.split(",")) {
97 excludeCredentials.push({
98 type: "public-key",
99 id: base64url.parse(entry, { loose: true }),
100 });
101 }
102
103 return excludeCredentials;
104}
105
106function getTransportsAsString(transportsList) {
107 if (!Array.isArray(transportsList)) {
108 return "";
109 }
110
111 return transportsList.join();
112}
113
114function returnSuccess(result, initLabel, initLabelPrompt) {
115 document.getElementById("clientDataJSON").value = base64url.stringify(
116 new Uint8Array(result.response.clientDataJSON),
117 { pad: false },
118 );
119 document.getElementById("attestationObject").value = base64url.stringify(
120 new Uint8Array(result.response.attestationObject),
121 { pad: false },
122 );
123 document.getElementById("publicKeyCredentialId").value = base64url.stringify(
124 new Uint8Array(result.rawId),
125 { pad: false },
126 );
127
128 if (typeof result.response.getTransports === "function") {
129 const transports = result.response.getTransports();
130 if (transports) {
131 document.getElementById("transports").value = getTransportsAsString(
132 transports,
133 );
134 }
135 } else {
136 console.log(
137 "Your browser is not able to recognize supported transport media for the authenticator.",
138 );
139 }
140
141 // let labelResult = window.prompt(initLabelPrompt, initLabel);
142 // if (labelResult === null) {
143 // labelResult = initLabel;
144 // }
145 document.getElementById("authenticatorLabel").value = "Passkey " +
146 new Date().toString();
147
148 document.getElementById("register").requestSubmit();
149}
150
151function returnFailure(err) {
152 if (err.name === "NotAllowedError") {
153 document.getElementById("error").value =
154 "the operation was cancelled / browser does not support passkey";
155 } else {
156 document.getElementById("error").value = err;
157 }
158 document.getElementById("register").requestSubmit();
159}
service/keycloak/theme/login/template.ftl deleted-209
......@@ -1,209 +0,0 @@
1<#import "footer.ftl" as loginFooter>
2<#macro registrationLayout bodyClass="" displayInfo=false displayMessage=true displayRequiredFields=false>
3<!DOCTYPE html>
4<html class="${properties.kcHtmlClass!}" lang="${lang}"<#if realm.internationalizationEnabled> dir="${(locale.rtl)?then('rtl','ltr')}"</#if>>
5
6<head>
7 <meta charset="utf-8">
8 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
9 <meta name="viewport" content="width=device-width, initial-scale=1.0">
10
11 <#if properties.meta?has_content>
12 <#list properties.meta?split(' ') as meta>
13 <meta name="${meta?split('==')[0]}" content="${meta?split('==')[1]}"/>
14 </#list>
15 </#if>
16 <title>sso (snow sign on)</title>
17 <link rel="icon" href="${url.resourcesPath}/img/favicon.ico" />
18 <#if properties.stylesCommon?has_content>
19 <#list properties.stylesCommon?split(' ') as style>
20 <link href="${url.resourcesCommonPath}/${style}" rel="stylesheet" />
21 </#list>
22 </#if>
23 <#if properties.styles?has_content>
24 <#list properties.styles?split(' ') as style>
25 <link href="${url.resourcesPath}/${style}" rel="stylesheet" />
26 </#list>
27 </#if>
28 <#if properties.scripts?has_content>
29 <#list properties.scripts?split(' ') as script>
30 <script src="${url.resourcesPath}/${script}" type="text/javascript"></script>
31 </#list>
32 </#if>
33 <script type="importmap">
34 {
35 "imports": {
36 "rfc4648": "${url.resourcesCommonPath}/vendor/rfc4648/rfc4648.js"
37 }
38 }
39 </script>
40 <script src="${url.resourcesPath}/js/menu-button-links.js" type="module"></script>
41 <#if scripts??>
42 <#list scripts as script>
43 <script src="${script}" type="text/javascript"></script>
44 </#list>
45 </#if>
46 <script type="module">
47 import { startSessionPolling } from "${url.resourcesPath}/js/authChecker.js";
48
49 startSessionPolling(
50 "${url.ssoLoginInOtherTabsUrl?no_esc}"
51 );
52 </script>
53 <script type="module">
54 document.addEventListener("click", (event) => {
55 const link = event.target.closest("a[data-once-link]");
56
57 if (!link) {
58 return;
59 }
60
61 if (link.getAttribute("aria-disabled") === "true") {
62 event.preventDefault();
63 return;
64 }
65
66 const { disabledClass } = link.dataset;
67
68 if (disabledClass) {
69 link.classList.add(...disabledClass.trim().split(/\s+/));
70 }
71
72 link.setAttribute("role", "link");
73 link.setAttribute("aria-disabled", "true");
74 });
75 </script>
76 <#if authenticationSession??>
77 <script type="module">
78 import { checkAuthSession } from "${url.resourcesPath}/js/authChecker.js";
79
80 checkAuthSession(
81 "${authenticationSession.authSessionIdHash}"
82 );
83 </script>
84 </#if>
85</head>
86
87<body class="${properties.kcBodyClass!}" data-page-id="login-${pageId}">
88<div class="${properties.kcLoginClass!}">
89 <div id="kc-header" class="${properties.kcHeaderClass!}">
90 <div id="kc-header-wrapper"
91 class="${properties.kcHeaderWrapperClass!}">${kcSanitize(msg("loginTitleHtml",(realm.displayNameHtml!'')))?no_esc}</div>
92 </div>
93 <div class="${properties.kcFormCardClass!}">
94 <header class="${properties.kcFormHeaderClass!}">
95 <#if realm.internationalizationEnabled && locale.supported?size gt 1>
96 <div class="${properties.kcLocaleMainClass!}" id="kc-locale">
97 <div id="kc-locale-wrapper" class="${properties.kcLocaleWrapperClass!}">
98 <div id="kc-locale-dropdown" class="menu-button-links ${properties.kcLocaleDropDownClass!}">
99 <button tabindex="1" id="kc-current-locale-link" aria-label="${msg("languages")}" aria-haspopup="true" aria-expanded="false" aria-controls="language-switch1">${locale.current}</button>
100 <ul role="menu" tabindex="-1" aria-labelledby="kc-current-locale-link" aria-activedescendant="" id="language-switch1" class="${properties.kcLocaleListClass!}">
101 <#assign i = 1>
102 <#list locale.supported as l>
103 <li class="${properties.kcLocaleListItemClass!}" role="none">
104 <a role="menuitem" id="language-${i}" class="${properties.kcLocaleItemClass!}" href="${l.url}">${l.label}</a>
105 </li>
106 <#assign i++>
107 </#list>
108 </ul>
109 </div>
110 </div>
111 </div>
112 </#if>
113 <#if !(auth?has_content && auth.showUsername() && !auth.showResetCredentials())>
114 <#if displayRequiredFields>
115 <div class="${properties.kcContentWrapperClass!}">
116 <div class="${properties.kcLabelWrapperClass!} subtitle">
117 <span class="subtitle"><span class="required">*</span> ${msg("requiredFields")}</span>
118 </div>
119 <div class="col-md-10">
120 <h1 id="kc-page-title"><#nested "header"></h1>
121 </div>
122 </div>
123 <#else>
124 <h1 id="kc-page-title"><#nested "header"></h1>
125 </#if>
126 <#else>
127 <#if displayRequiredFields>
128 <div class="${properties.kcContentWrapperClass!}">
129 <div class="${properties.kcLabelWrapperClass!} subtitle">
130 <span class="subtitle"><span class="required">*</span> ${msg("requiredFields")}</span>
131 </div>
132 <div class="col-md-10">
133 <#nested "show-username">
134 <div id="kc-username" class="${properties.kcFormGroupClass!}">
135 <label id="kc-attempted-username">${auth.attemptedUsername}</label>
136 <a id="reset-login" href="${url.loginRestartFlowUrl}" aria-label="${msg("restartLoginTooltip")}">
137 <div class="kc-login-tooltip">
138 <i class="${properties.kcResetFlowIcon!}"></i>
139 <span class="kc-tooltip-text">${msg("restartLoginTooltip")}</span>
140 </div>
141 </a>
142 </div>
143 </div>
144 </div>
145 <#else>
146 <#nested "show-username">
147 <div id="kc-username" class="${properties.kcFormGroupClass!}">
148 <label id="kc-attempted-username">${auth.attemptedUsername}</label>
149 <a id="reset-login" href="${url.loginRestartFlowUrl}" aria-label="${msg("restartLoginTooltip")}">
150 <div class="kc-login-tooltip">
151 <i class="${properties.kcResetFlowIcon!}"></i>
152 <span class="kc-tooltip-text">${msg("restartLoginTooltip")}</span>
153 </div>
154 </a>
155 </div>
156 </#if>
157 </#if>
158 </header>
159 <div id="kc-content">
160 <div id="kc-content-wrapper">
161
162 <#-- App-initiated actions should not see warning messages about the need to complete the action -->
163 <#-- during login. -->
164 <#if displayMessage && message?has_content && (message.type != 'warning' || !isAppInitiatedAction??)>
165 <div class="alert-${message.type} ${properties.kcAlertClass!} pf-m-<#if message.type = 'error'>danger<#else>${message.type}</#if>">
166 <div class="pf-c-alert__icon">
167 <#if message.type = 'success'><span class="${properties.kcFeedbackSuccessIcon!}"></span></#if>
168 <#if message.type = 'warning'><span class="${properties.kcFeedbackWarningIcon!}"></span></#if>
169 <#if message.type = 'error'><span class="${properties.kcFeedbackErrorIcon!}"></span></#if>
170 <#if message.type = 'info'><span class="${properties.kcFeedbackInfoIcon!}"></span></#if>
171 </div>
172 <span class="${properties.kcAlertTitleClass!}">${kcSanitize(message.summary)?no_esc}</span>
173 </div>
174 </#if>
175
176 <#nested "form">
177
178 <#if auth?has_content && auth.showTryAnotherWayLink()>
179 <form id="kc-select-try-another-way-form" action="${url.loginAction}" method="post">
180 <div class="${properties.kcFormGroupClass!}">
181 <input type="hidden" name="tryAnotherWay" value="on"/>
182 <a href="#" id="try-another-way"
183 onclick="document.forms['kc-select-try-another-way-form'].requestSubmit();return false;">${msg("doTryAnotherWay")}</a>
184 </div>
185 </form>
186 </#if>
187
188 <#nested "socialProviders">
189
190 <#if displayInfo>
191 <div id="kc-info" class="${properties.kcSignUpClass!}">
192 <div id="kc-info-wrapper" class="${properties.kcInfoAreaWrapperClass!}">
193 <#nested "info">
194 </div>
195 </div>
196 </#if>
197 </div>
198 </div>
199
200
201 <@loginFooter.content/>
202 </div>
203 </div>
204 <div id='credit'>
205 <a rel="noopener noreferrer" target="_blank" href="https://www.pixiv.net/en/artworks/109102745">art by 紺屋</a>
206 </div>
207</body>
208</html>
209</#macro>
service/keycloak/theme/login/theme.properties deleted-128
......@@ -1,128 +0,0 @@
1parent=base
2import=common/keycloak
3
4styles=css/styles.css
5stylesCommon=
6
7darkMode=false
8
9kcFormGroupClass=pf-v5-c-form__group
10kcFormGroupLabelClass=pf-v5-c-form__group-label pf-v5-u-pb-xs
11kcFormLabelClass=pf-v5-c-form__label
12kcFormLabelTextClass=pf-v5-c-form__label-text
13
14kcLabelClass=pf-v5-c-form__label
15kcInputClass=pf-v5-c-form-control
16kcInputGroup=pf-v5-c-input-group
17kcFormHelperTextClass=pf-v5-c-form__helper-text
18kcInputHelperTextClass=pf-v5-c-helper-text pf-v5-u-display-flex pf-v5-u-justify-content-space-between
19kcInputHelperTextItemClass=pf-v5-c-helper-text__item
20kcInputHelperTextItemTextClass=pf-v5-c-helper-text__item-text
21kcInputGroupItemClass=pf-v5-c-input-group__item
22kcFill=pf-m-fill
23kcError=pf-m-error
24kcLoginFooterBand=pf-v5-c-login__main-footer-band
25kcLoginFooterBandItem=pf-v5-c-login__main-footer-band-item
26
27kcCheckboxClass=pf-v5-c-check
28kcCheckboxInputClass=pf-v5-c-check__input
29kcCheckboxLabelClass=pf-v5-c-check__label
30kcCheckboxLabelRequiredClass=pf-v5-c-check__label-required
31
32kcInputRequiredClass=pf-v5-c-form__label-required
33kcInputErrorMessageClass=pf-v5-c-helper-text__item-text pf-m-error kc-feedback-text
34kcFormControlUtilClass=pf-v5-c-form-control__utilities
35kcInputErrorIconStatusClass=pf-v5-c-form-control__icon pf-m-status
36kcInputErrorIconClass=fas fa-exclamation-circle
37kcAlertClass=pf-v5-c-alert pf-m-inline pf-v5-u-mb-md
38kcAlertIconClass=pf-v5-c-alert__icon
39kcAlertTitleClass=pf-v5-c-alert__title
40kcAlertDescriptionClass=pf-v5-c-alert__description
41kcFormPasswordVisibilityButtonClass=pf-v5-c-button pf-m-control
42kcFormControlToggleIcon=pf-v5-c-form-control__toggle-icon
43kcFormActionGroupClass=pf-v5-c-form__actions pf-v5-u-pt-xs
44kcFormReadOnlyClass=pf-m-readonly
45
46kcPanelClass=pf-v5-c-panel pf-m-raised
47kcPanelMainClass=pf-v5-c-panel__main
48kcPanelMainBodyClass=pf-v5-c-panel__main-body
49kcListClass=pf-v5-c-list
50
51kcButtonClass=pf-v5-c-button
52kcButtonPrimaryClass=pf-v5-c-button pf-m-primary
53kcButtonSecondaryClass=pf-v5-c-button pf-m-secondary
54kcButtonBlockClass=pf-m-block
55kcButtonLinkClass=pf-v5-c-button pf-m-link
56kcCommonLogoIdP=pf-v5-c-login__main-footer-links-item
57kcFormSocialAccountListClass=pf-v5-c-login__main-body pf-v5-u-pl-0 pf-v5-u-pr-0
58kcFormSocialAccountListItemClass=pf-v5-u-pb-sm
59kcFormSocialAccountNameClass=pf-v5-u-m-auto
60kcFormSocialAccountListButtonClass=pf-v5-c-button pf-m-secondary pf-m-block pf-v5-u-display-flex pf-v5-u-align-items-center pf-v5-u-justify-content-space-between
61kcFormSocialAccountListButtonDisabledClass=pf-m-aria-disabled
62kcFormSocialAccountListGridClass=pf-v5-l-grid pf-m-gutter pf-m-all-6-col-on-xl pf-m-all-6-col-on-sm
63kcFormSocialAccountGridItem=pf-v5-l-grid__item
64
65kcLoginClass=pf-v5-c-login__main
66kcFormClass=pf-v5-c-form pf-v5-u-w-100
67kcFormCardClass=card-pf
68
69kcResetFlowIcon=pf-icon fas fa-share-square
70
71kcSelectAuthListClass=pf-v5-c-data-list select-auth-container
72kcSelectAuthListItemWrapperClass=pf-v5-c-data-list__item pf-m-clickable
73kcSelectAuthListItemClass=pf-v5-c-data-list__item-row select-auth-box-parent
74kcSelectAuthListItemHeadingClass=pf-v5-u-font-family-heading select-auth-box-headline
75kcSelectAuthListItemBodyClass=pf-v5-c-data-list__cell pf-m-no-fill pf-v5-u-pt-md pf-v5-u-pb-md
76kcSelectAuthListItemIconClass=pf-v5-c-data-list__cell pf-m-icon pf-v5-u-display-flex pf-v5-u-pt-0 pf-v5-u-align-items-center
77kcSelectAuthListItemFillClass=pf-v5-c-data-list__item-action
78kcSelectAuthListItemDescriptionClass=pf-v5-c-data-list__cell pf-m-no-fill select-auth-box-desc
79
80kcRecoveryCodesWarning=pf-v5-c-alert pf-m-warning pf-m-inline pf-v5-u-mb-md kc-recovery-codes-warning
81kcLogin=pf-v5-c-login
82kcLoginContainer=pf-v5-c-login__container
83kcLoginMain=pf-v5-c-login__main
84kcLoginMainHeader=pf-v5-c-login__main-header
85kcLoginMainFooter=pf-v5-c-login__main-footer
86kcLoginMainFooterBand=pf-v5-c-login__main-footer-band
87kcLoginMainFooterBandItem=pf-v5-c-login__main-footer-band-item
88kcLoginMainFooterHelperText=pf-v5-u-font-size-sm pf-v5-u-color-200
89kcLoginMainTitle=pf-v5-c-title pf-m-3xl
90kcLoginMainHeaderUtilities=pf-v5-c-login__main-header-utilities
91kcLoginMainBody=pf-v5-c-login__main-body
92
93kcContentWrapperClass=pf-v5-u-mb-md-on-md
94kcWebAuthnDefaultIcon=pf-v5-c-icon pf-m-lg
95kcMarginTopClass=pf-v5-u-mt-md-on-md
96
97kcLoginOTPListClass=pf-v5-c-tile
98kcLoginOTPListItemHeaderClass=pf-v5-c-tile__header pf-m-stacked
99kcLoginOTPListItemIconBodyClass=pf-v5-c-tile__icon
100kcLoginOTPListItemIconClass=fa fa-mobile
101kcLoginOTPListItemTitleClass=pf-v5-c-tile__title
102kcLoginOTPListSelectedClass=pf-m-selected
103
104kcCopyIconClass=fas fa-copy
105kcCheckIconClass=fas fa-check
106kcAngleRightIconClass=fas fa-angle-right
107kcAngleDownIconClass=fas fa-angle-down
108kcExpandedClass=pf-m-expanded
109
110kcCodeClipboardCopyClass=pf-v5-c-clipboard-copy
111kcCodeClipboardCopyGroupClass=pf-v5-c-clipboard-copy__group
112kcCodeClipboardCopyContentClass=pf-v5-c-clipboard-copy__expandable-content
113
114kcDarkModeClass=pf-v5-theme-dark
115
116kcHtmlClass=login-pf
117kcLogoIdP-facebook=
118kcLogoIdP-google=
119kcLogoIdP-github=
120kcLogoIdP-linkedin=
121kcLogoIdP-instagram=
122kcLogoIdP-microsoft=
123kcLogoIdP-bitbucket=
124kcLogoIdP-gitlab=
125kcLogoIdP-paypal=
126kcLogoIdP-stackoverflow=
127kcLogoIdP-twitter=
128kcLogoIdP-openshift-v4=
service/keycloak/theme/login/webauthn-error.ftl deleted-36
......@@ -1,36 +0,0 @@
1<#import "template.ftl" as layout>
2<@layout.registrationLayout displayMessage=true; section>
3 <#if section = "header">
4 ${kcSanitize(msg("webauthn-error-title"))?no_esc}
5 <#elseif section = "form">
6
7 <script type="text/javascript">
8 refreshPage = () => {
9 document.getElementById('isSetRetry').value = 'retry';
10 document.getElementById('executionValue').value = '${execution}';
11 document.getElementById('kc-error-credential-form').requestSubmit();
12 }
13 </script>
14
15 <form id="kc-error-credential-form" class="${properties.kcFormClass!}" action="${url.loginAction}"
16 method="post">
17 <input type="hidden" id="executionValue" name="authenticationExecution"/>
18 <input type="hidden" id="isSetRetry" name="isSetRetry"/>
19 </form>
20
21 <input tabindex="4" onclick="refreshPage()" type="button"
22 class="${properties.kcButtonClass!} ${properties.kcButtonPrimaryClass!} ${properties.kcButtonBlockClass!} ${properties.kcButtonLargeClass!}"
23 name="try-again" id="kc-try-again" value="${kcSanitize(msg("doTryAgain"))?no_esc}"
24 />
25
26 <#if isAppInitiatedAction??>
27 <form action="${url.loginAction}" class="${properties.kcFormClass!}" id="kc-webauthn-settings-form" method="post">
28 <button type="submit"
29 class="${properties.kcButtonClass!} ${properties.kcButtonDefaultClass!} ${properties.kcButtonBlockClass!} ${properties.kcButtonLargeClass!}"
30 id="cancelWebAuthnAIA" name="cancel-aia" value="true">${msg("doCancel")}
31 </button>
32 </form>
33 </#if>
34
35 </#if>
36</@layout.registrationLayout>
\ No newline at end of file
service/keycloak/theme/login/webauthn-register.ftl deleted-72
......@@ -1,72 +0,0 @@
1<#import "template.ftl" as layout>
2<#import "password-commons.ftl" as passwordCommons>
3
4<@layout.registrationLayout; section>
5 <#if section = "title">
6 title
7 <#elseif section = "header">
8 <div class="alert-info pf-v5-c-alert pf-m-inline pf-v5-u-mb-md pf-m-danger">
9 <div class="pf-c-alert__icon">
10 <span class=""></span>
11 </div>
12 <span class="pf-v5-c-alert__title">
13 you will be prompted to create a passkey. please contact clover if
14 this doesn't work in your browser.
15 </span>
16 </div>
17 <#elseif section = "form">
18
19 <form id="register" class="${properties.kcFormClass!}" action="${url.loginAction}" method="post">
20 <div class="${properties.kcFormGroupClass!}">
21 <input type="hidden" id="clientDataJSON" name="clientDataJSON"/>
22 <input type="hidden" id="attestationObject" name="attestationObject"/>
23 <input type="hidden" id="publicKeyCredentialId" name="publicKeyCredentialId"/>
24 <input type="hidden" id="authenticatorLabel" name="authenticatorLabel"/>
25 <input type="hidden" id="transports" name="transports"/>
26 <input type="hidden" id="error" name="error"/>
27 </div>
28 </form>
29
30 <script type="module">
31 import { registerByWebAuthn } from "${url.resourcesPath}/js/webauthnRegister.js";
32 function init() {
33 const input = {
34 challenge : '${challenge}',
35 userid : '${userid}',
36 username : '${username}',
37 signatureAlgorithms : [<#list signatureAlgorithms as sigAlg>${sigAlg?c},</#list>],
38 rpEntityName : '${rpEntityName}',
39 rpId : '${rpId}',
40 attestationConveyancePreference : '${attestationConveyancePreference}',
41 authenticatorAttachment : '${authenticatorAttachment}',
42 requireResidentKey : '${requireResidentKey}',
43 userVerificationRequirement : '${userVerificationRequirement}',
44 createTimeout : ${createTimeout?c},
45 excludeCredentialIds : '${excludeCredentialIds}',
46 initLabel : "${msg("webauthn-registration-init-label")?no_esc}",
47 initLabelPrompt : "${msg("webauthn-registration-init-label-prompt")?no_esc}",
48 errmsg : "${msg("webauthn-unsupported-browser-text")?no_esc}"
49 };
50 registerByWebAuthn(input);
51 }
52 init();
53 </script>
54
55<!--
56 <input type="submit"
57 class="${properties.kcButtonClass!} ${properties.kcButtonPrimaryClass!} ${properties.kcButtonBlockClass!} ${properties.kcButtonLargeClass!}"
58 id="registerWebAuthn" value="${msg("doRegisterSecurityKey")}"/>
59-->
60
61 <#if !isSetRetry?has_content && isAppInitiatedAction?has_content>
62 <form action="${url.loginAction}" class="${properties.kcFormClass!}" id="kc-webauthn-settings-form"
63 method="post">
64 <button type="submit"
65 class="${properties.kcButtonClass!} ${properties.kcButtonDefaultClass!} ${properties.kcButtonBlockClass!} ${properties.kcButtonLargeClass!}"
66 id="cancelWebAuthnAIA" name="cancel-aia" value="true">${msg("doCancel")}
67 </button>
68 </form>
69 </#if>
70
71 </#if>
72</@layout.registrationLayout>
service/knife/prepare.py+1-1
......@@ -14,7 +14,7 @@ import uuid
1414
1515bundle = json.loads(Path(__file__).with_name("bundle.json").read_text())
1616if 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:
1818 archive = Path(temporary) / "bundle.tar.gz"
1919 digest = hashlib.sha256()
2020 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
55
66local bundle = (new json.Parser {}).parse(read("bundle.json"))
77
8meta { name = "The Knife"; access = "infra-admin" }
8name = "The Knife"
9access = "infra-admin"
910requirements {
1011 new sso.Client {
1112 clientId = module.id
12 name = module.meta.name
13 name = module.name
1314 redirectUris { "https://\(module.container.http.hostname)/api/auth/oidc/callback" }
1415 }
1516}
service/local-ai/Dockerfile+3-3
......@@ -24,10 +24,10 @@ RUN python3.12 /tmp/model-source/download.py --runtime-only --root /tmp/runtime
2424RUN set -e; SP=$(venv/bin/python -c 'import vllm,os; print(os.path.dirname(vllm.__file__))' | tail -n1); \
2525 for p in patches/*.patch; do patch --batch -p1 -d "$SP" < "$p"; done; \
2626 bash verify.sh --install
27COPY cache /tmp/studio-ai-cache
28RUN venv/bin/pip install /tmp/studio-ai-cache && venv/bin/pip check && rm -rf /tmp/studio-ai-cache
27COPY cache /tmp/snowglobe-ai-cache
28RUN venv/bin/pip install /tmp/snowglobe-ai-cache && venv/bin/pip check && rm -rf /tmp/snowglobe-ai-cache
2929ENV HOME=/cache VLLM_NO_USAGE_STATS=1 DO_NOT_TRACK=1 HF_HUB_OFFLINE=1
3030RUN mkdir -p /cache && chmod 1777 /cache
3131COPY steering /app/steering
3232RUN patch --batch -p1 -d /app/venv/lib/python3.12/site-packages/vllm < /app/steering/runtime.patch
33ENV PYTHONPATH=/app/steering STUDIO_STEERING_DIR=/app/steering
33ENV PYTHONPATH=/app/steering SNOWGLOBE_STEERING_DIR=/app/steering
service/local-ai/cache/pyproject.toml+3-3
......@@ -3,12 +3,12 @@ requires = ["setuptools"]
33build-backend = "setuptools.build_meta"
44
55[project]
6name = "studio-ai-cache"
6name = "snowglobe-ai-cache"
77version = "1.0.0"
88dependencies = ["cryptography==50.0.2"]
99
1010[project.entry-points."vllm.general_plugins"]
11studio_ai_cache = "studio_ai_cache_vllm:register"
11snowglobe_ai_cache = "snowglobe_ai_cache_vllm:register"
1212
1313[tool.setuptools]
14py-modules = ["studio_ai_cache", "studio_ai_cache_vllm"]
14py-modules = ["snowglobe_ai_cache", "snowglobe_ai_cache_vllm"]
service/local-ai/cache/snowglobe_ai_cache.py created+186
......@@ -0,0 +1,186 @@
1"""Bounded, authenticated disk caches with SSD promotion and request pinning."""
2from collections import OrderedDict
3import fcntl
4import logging
5import mmap
6import os
7from pathlib import Path
8import struct
9import threading
10
11from cryptography.exceptions import InvalidTag
12from cryptography.hazmat.primitives.ciphers.aead import AESGCM
13
14
15class DiskCache:
16 def __init__(self, ssd, hdd, ssd_bytes, hdd_bytes, key):
17 if min(ssd_bytes, hdd_bytes) <= 0:
18 raise ValueError("Disk cache capacities must be positive")
19 self.cipher = AESGCM(key)
20 self.roots = (Path(ssd), Path(hdd))
21 if (self.roots[0].resolve().is_relative_to(self.roots[1].resolve())
22 or self.roots[1].resolve().is_relative_to(self.roots[0].resolve())):
23 raise ValueError("Disk cache directories must be distinct")
24 self.limits = (ssd_bytes, hdd_bytes)
25 self.lock = threading.Lock()
26 self.writers = (threading.Lock(), threading.Lock())
27 self.entries = (OrderedDict(), OrderedDict())
28 self.pins = {}
29 self.files = []
30 try:
31 for tier, root in enumerate(self.roots):
32 root.mkdir(mode=0o700, parents=True, exist_ok=True)
33 root.chmod(0o700)
34 descriptor = os.open(root / ".lock", os.O_CREAT | os.O_RDWR, 0o600)
35 self.files.append(descriptor)
36 fcntl.flock(descriptor, fcntl.LOCK_EX | fcntl.LOCK_NB)
37 for path in root.rglob("*.pending"):
38 path.unlink()
39 inventory = sorted((path.stat().st_mtime_ns, path) for path in root.rglob("*.bin"))
40 for _, path in inventory:
41 self.entries[tier][str(path.relative_to(root))] = path.stat().st_size
42 self._evict(tier, 0)
43 except Exception:
44 self.close()
45 raise
46
47 def close(self):
48 for descriptor in self.files:
49 os.close(descriptor)
50 self.files.clear()
51
52 def acquire(self, name, request):
53 with self.lock:
54 for entries in self.entries:
55 if name in entries:
56 entries.move_to_end(name)
57 self.pins.setdefault(name, set()).add(request)
58 return True
59 return False
60
61 def release(self, request):
62 with self.lock:
63 for name, requests in list(self.pins.items()):
64 requests.discard(request)
65 if not requests:
66 del self.pins[name]
67
68 def touch(self, name):
69 with self.lock:
70 for entries in self.entries:
71 if name in entries:
72 entries.move_to_end(name)
73 break
74
75 def _evict(self, tier, needed):
76 removed = []
77 with self.lock:
78 entries = self.entries[tier]
79 size = sum(entries.values())
80 for name in list(entries):
81 if size + needed <= self.limits[tier]:
82 break
83 if name not in self.pins:
84 size -= entries.pop(name)
85 removed.append(self.roots[tier] / name)
86 for path in removed:
87 self._unlink(tier, path)
88 return size + needed <= self.limits[tier]
89
90 def _unlink(self, tier, path):
91 path.unlink(missing_ok=True)
92 parent = path.parent
93 while parent != self.roots[tier]:
94 try:
95 parent.rmdir()
96 except OSError:
97 break
98 parent = parent.parent
99
100 def _put(self, tier, name, buffer):
101 path = self.roots[tier] / name
102 with self.writers[tier]:
103 with self.lock:
104 if name in self.entries[tier]:
105 self.entries[tier].move_to_end(name)
106 present = True
107 else:
108 present = False
109 if present:
110 os.utime(path, None)
111 return
112 if len(buffer) > self.limits[tier] or not self._evict(tier, len(buffer)):
113 return
114 path.parent.mkdir(mode=0o700, parents=True, exist_ok=True)
115 pending = path.with_suffix(".pending")
116 try:
117 descriptor = os.open(pending, os.O_CREAT | os.O_EXCL | os.O_WRONLY | getattr(os, "O_DIRECT", 0), 0o600)
118 try:
119 if os.write(descriptor, buffer) != len(buffer):
120 raise OSError("Short cache write")
121 os.fsync(descriptor)
122 finally:
123 os.close(descriptor)
124 pending.replace(path)
125 with self.lock:
126 self.entries[tier][name] = len(buffer)
127 finally:
128 pending.unlink(missing_ok=True)
129
130 def store(self, name, data):
131 # Page-aligned ciphertext keeps direct I/O on both ext4 and ZFS.
132 size = (len(data) + 36 + mmap.PAGESIZE - 1) // mmap.PAGESIZE * mmap.PAGESIZE
133 with mmap.mmap(-1, size) as buffer:
134 nonce = os.urandom(12)
135 buffer[:20] = struct.pack("!Q", len(data)) + nonce
136 view = memoryview(buffer)[20:20 + len(data) + 16]
137 try:
138 self.cipher.encrypt_into(nonce, data, name.encode(), view)
139 finally:
140 view.release()
141 self._put(1, name, buffer)
142 self._put(0, name, buffer)
143
144 def load(self, name, target):
145 pin = object()
146 if not self.acquire(name, pin):
147 raise FileNotFoundError("Cache block was evicted")
148 try:
149 for tier, root in enumerate(self.roots):
150 path = root / name
151 with self.lock:
152 size = self.entries[tier].get(name)
153 if size is None:
154 continue
155 try:
156 with mmap.mmap(-1, size) as buffer:
157 descriptor = os.open(path, os.O_RDONLY | getattr(os, "O_DIRECT", 0))
158 try:
159 if os.readv(descriptor, [buffer]) != size:
160 raise OSError("Short cache read")
161 finally:
162 os.close(descriptor)
163 if struct.unpack("!Q", buffer[:8])[0] != len(target):
164 raise ValueError("Cache block size mismatch")
165 view = memoryview(buffer)[20:20 + len(target) + 16]
166 try:
167 self.cipher.decrypt_into(buffer[8:20], view, name.encode(), target)
168 finally:
169 view.release()
170 with self.lock:
171 self.entries[tier].move_to_end(name)
172 os.utime(path, None)
173 if tier == 1:
174 try:
175 self._put(0, name, buffer)
176 except OSError:
177 logging.getLogger(__name__).warning("SSD cache promotion failed", exc_info=True)
178 return "ssd" if tier == 0 else "hdd"
179 except (OSError, ValueError, struct.error, InvalidTag):
180 with self.writers[tier]:
181 with self.lock:
182 self.entries[tier].pop(name, None)
183 self._unlink(tier, path)
184 raise FileNotFoundError("No authenticated cache block remains")
185 finally:
186 self.release(pin)
service/local-ai/cache/snowglobe_ai_cache_vllm.py created+73
......@@ -0,0 +1,73 @@
1"""vLLM secondary tier for the bounded SSD/HDD cache."""
2import functools
3import hashlib
4import os
5from pathlib import Path
6
7import vllm
8from vllm.v1.kv_offload.base import LookupResult, Medium
9from vllm.v1.kv_offload.file_mapper import FileMapper
10from vllm.v1.kv_offload.tiering.base import JobResult, RequestOffloadingContext, SecondaryTierManager
11from vllm.v1.kv_offload.tiering.factory import SecondaryTierFactory
12from vllm.v1.kv_offload.tiering.fs.thread_pool import DualQueueThreadPool
13
14from snowglobe_ai_cache import DiskCache
15
16
17class DiskTier(SecondaryTierManager):
18 medium = Medium.STORAGE
19
20 def __init__(self, offloading_spec, primary_kv_view, tier_type, ssd_dir, hdd_dir, ssd_bytes, hdd_bytes):
21 super().__init__(offloading_spec, primary_kv_view, tier_type)
22 key = hashlib.sha256(os.environ["SNOWGLOBE_AI_CACHE_KEY"].encode()).digest()
23 namespace = hashlib.sha256(
24 Path("/models/manifest.json").read_bytes() + vllm.__version__.encode()
25 + Path(__file__).read_bytes() + Path(__file__).with_name("snowglobe_ai_cache.py").read_bytes() + key
26 ).hexdigest()
27 self.mapper = FileMapper.from_offloading_spec(namespace, offloading_spec, offloading_spec.blocks_per_chunk)
28 self.cache = DiskCache(ssd_dir, hdd_dir, ssd_bytes, hdd_bytes, key)
29 self.block_size = primary_kv_view.strides[0]
30 self.pool = DualQueueThreadPool(16, 2, thread_name_prefix="snowglobe_kv_disk")
31
32 def on_new_request(self, req_context):
33 return RequestOffloadingContext()
34
35 def lookup(self, key, req_context):
36 return LookupResult.HIT if self.cache.acquire(self.mapper.get_file_name(key), req_context.req_id) else LookupResult.MISS
37
38 def submit_store(self, job_metadata):
39 tasks = [functools.partial(self._transfer, self.cache.store, key, block_id)
40 for key, block_id in zip(job_metadata.keys, job_metadata.block_ids, strict=True)]
41 self.pool.enqueue_store(job_metadata.job_id, len(tasks), tasks)
42
43 def submit_load(self, job_metadata):
44 tasks = [functools.partial(self._transfer, self.cache.load, key, block_id)
45 for key, block_id in zip(job_metadata.keys, job_metadata.block_ids, strict=True)]
46 self.pool.enqueue_load(job_metadata.job_id, len(tasks), tasks)
47
48 def _transfer(self, operation, key, block_id):
49 offset = int(block_id) * self.block_size
50 with self._primary_kv_view.cast("B")[offset:offset + self.block_size] as view:
51 operation(self.mapper.get_file_name(key), view)
52
53 def get_finished_jobs(self):
54 return [JobResult(job_id, success) for job_id, success in self.pool.get_finished()]
55
56 def touch(self, keys, req_context):
57 for key in keys:
58 self.cache.touch(self.mapper.get_file_name(key))
59
60 def on_request_finished(self, req_context):
61 self.cache.release(req_context.req_id)
62
63 def drain_jobs(self):
64 self.pool.wait_idle()
65
66 def shutdown(self):
67 self.pool.wait_idle()
68 self.pool.shutdown(wait=True)
69 self.cache.close()
70
71
72def register():
73 SecondaryTierFactory.register_tier("snowglobe_disk", __name__, "DiskTier")
service/local-ai/cache/studio_ai_cache.py deleted-186
......@@ -1,186 +0,0 @@
1"""Bounded, authenticated disk caches with SSD promotion and request pinning."""
2from collections import OrderedDict
3import fcntl
4import logging
5import mmap
6import os
7from pathlib import Path
8import struct
9import threading
10
11from cryptography.exceptions import InvalidTag
12from cryptography.hazmat.primitives.ciphers.aead import AESGCM
13
14
15class DiskCache:
16 def __init__(self, ssd, hdd, ssd_bytes, hdd_bytes, key):
17 if min(ssd_bytes, hdd_bytes) <= 0:
18 raise ValueError("Disk cache capacities must be positive")
19 self.cipher = AESGCM(key)
20 self.roots = (Path(ssd), Path(hdd))
21 if (self.roots[0].resolve().is_relative_to(self.roots[1].resolve())
22 or self.roots[1].resolve().is_relative_to(self.roots[0].resolve())):
23 raise ValueError("Disk cache directories must be distinct")
24 self.limits = (ssd_bytes, hdd_bytes)
25 self.lock = threading.Lock()
26 self.writers = (threading.Lock(), threading.Lock())
27 self.entries = (OrderedDict(), OrderedDict())
28 self.pins = {}
29 self.files = []
30 try:
31 for tier, root in enumerate(self.roots):
32 root.mkdir(mode=0o700, parents=True, exist_ok=True)
33 root.chmod(0o700)
34 descriptor = os.open(root / ".lock", os.O_CREAT | os.O_RDWR, 0o600)
35 self.files.append(descriptor)
36 fcntl.flock(descriptor, fcntl.LOCK_EX | fcntl.LOCK_NB)
37 for path in root.rglob("*.pending"):
38 path.unlink()
39 inventory = sorted((path.stat().st_mtime_ns, path) for path in root.rglob("*.bin"))
40 for _, path in inventory:
41 self.entries[tier][str(path.relative_to(root))] = path.stat().st_size
42 self._evict(tier, 0)
43 except Exception:
44 self.close()
45 raise
46
47 def close(self):
48 for descriptor in self.files:
49 os.close(descriptor)
50 self.files.clear()
51
52 def acquire(self, name, request):
53 with self.lock:
54 for entries in self.entries:
55 if name in entries:
56 entries.move_to_end(name)
57 self.pins.setdefault(name, set()).add(request)
58 return True
59 return False
60
61 def release(self, request):
62 with self.lock:
63 for name, requests in list(self.pins.items()):
64 requests.discard(request)
65 if not requests:
66 del self.pins[name]
67
68 def touch(self, name):
69 with self.lock:
70 for entries in self.entries:
71 if name in entries:
72 entries.move_to_end(name)
73 break
74
75 def _evict(self, tier, needed):
76 removed = []
77 with self.lock:
78 entries = self.entries[tier]
79 size = sum(entries.values())
80 for name in list(entries):
81 if size + needed <= self.limits[tier]:
82 break
83 if name not in self.pins:
84 size -= entries.pop(name)
85 removed.append(self.roots[tier] / name)
86 for path in removed:
87 self._unlink(tier, path)
88 return size + needed <= self.limits[tier]
89
90 def _unlink(self, tier, path):
91 path.unlink(missing_ok=True)
92 parent = path.parent
93 while parent != self.roots[tier]:
94 try:
95 parent.rmdir()
96 except OSError:
97 break
98 parent = parent.parent
99
100 def _put(self, tier, name, buffer):
101 path = self.roots[tier] / name
102 with self.writers[tier]:
103 with self.lock:
104 if name in self.entries[tier]:
105 self.entries[tier].move_to_end(name)
106 present = True
107 else:
108 present = False
109 if present:
110 os.utime(path, None)
111 return
112 if len(buffer) > self.limits[tier] or not self._evict(tier, len(buffer)):
113 return
114 path.parent.mkdir(mode=0o700, parents=True, exist_ok=True)
115 pending = path.with_suffix(".pending")
116 try:
117 descriptor = os.open(pending, os.O_CREAT | os.O_EXCL | os.O_WRONLY | getattr(os, "O_DIRECT", 0), 0o600)
118 try:
119 if os.write(descriptor, buffer) != len(buffer):
120 raise OSError("Short cache write")
121 os.fsync(descriptor)
122 finally:
123 os.close(descriptor)
124 pending.replace(path)
125 with self.lock:
126 self.entries[tier][name] = len(buffer)
127 finally:
128 pending.unlink(missing_ok=True)
129
130 def store(self, name, data):
131 # Page-aligned ciphertext keeps direct I/O on both ext4 and ZFS.
132 size = (len(data) + 36 + mmap.PAGESIZE - 1) // mmap.PAGESIZE * mmap.PAGESIZE
133 with mmap.mmap(-1, size) as buffer:
134 nonce = os.urandom(12)
135 buffer[:20] = struct.pack("!Q", len(data)) + nonce
136 view = memoryview(buffer)[20:20 + len(data) + 16]
137 try:
138 self.cipher.encrypt_into(nonce, data, name.encode(), view)
139 finally:
140 view.release()
141 self._put(1, name, buffer)
142 self._put(0, name, buffer)
143
144 def load(self, name, target):
145 pin = object()
146 if not self.acquire(name, pin):
147 raise FileNotFoundError("Cache block was evicted")
148 try:
149 for tier, root in enumerate(self.roots):
150 path = root / name
151 with self.lock:
152 size = self.entries[tier].get(name)
153 if size is None:
154 continue
155 try:
156 with mmap.mmap(-1, size) as buffer:
157 descriptor = os.open(path, os.O_RDONLY | getattr(os, "O_DIRECT", 0))
158 try:
159 if os.readv(descriptor, [buffer]) != size:
160 raise OSError("Short cache read")
161 finally:
162 os.close(descriptor)
163 if struct.unpack("!Q", buffer[:8])[0] != len(target):
164 raise ValueError("Cache block size mismatch")
165 view = memoryview(buffer)[20:20 + len(target) + 16]
166 try:
167 self.cipher.decrypt_into(buffer[8:20], view, name.encode(), target)
168 finally:
169 view.release()
170 with self.lock:
171 self.entries[tier].move_to_end(name)
172 os.utime(path, None)
173 if tier == 1:
174 try:
175 self._put(0, name, buffer)
176 except OSError:
177 logging.getLogger(__name__).warning("SSD cache promotion failed", exc_info=True)
178 return "ssd" if tier == 0 else "hdd"
179 except (OSError, ValueError, struct.error, InvalidTag):
180 with self.writers[tier]:
181 with self.lock:
182 self.entries[tier].pop(name, None)
183 self._unlink(tier, path)
184 raise FileNotFoundError("No authenticated cache block remains")
185 finally:
186 self.release(pin)
service/local-ai/cache/studio_ai_cache_vllm.py deleted-73
......@@ -1,73 +0,0 @@
1"""vLLM secondary tier for the bounded SSD/HDD cache."""
2import functools
3import hashlib
4import os
5from pathlib import Path
6
7import vllm
8from vllm.v1.kv_offload.base import LookupResult, Medium
9from vllm.v1.kv_offload.file_mapper import FileMapper
10from vllm.v1.kv_offload.tiering.base import JobResult, RequestOffloadingContext, SecondaryTierManager
11from vllm.v1.kv_offload.tiering.factory import SecondaryTierFactory
12from vllm.v1.kv_offload.tiering.fs.thread_pool import DualQueueThreadPool
13
14from studio_ai_cache import DiskCache
15
16
17class DiskTier(SecondaryTierManager):
18 medium = Medium.STORAGE
19
20 def __init__(self, offloading_spec, primary_kv_view, tier_type, ssd_dir, hdd_dir, ssd_bytes, hdd_bytes):
21 super().__init__(offloading_spec, primary_kv_view, tier_type)
22 key = hashlib.sha256(os.environ["STUDIO_AI_CACHE_KEY"].encode()).digest()
23 namespace = hashlib.sha256(
24 Path("/models/manifest.json").read_bytes() + vllm.__version__.encode()
25 + Path(__file__).read_bytes() + Path(__file__).with_name("studio_ai_cache.py").read_bytes() + key
26 ).hexdigest()
27 self.mapper = FileMapper.from_offloading_spec(namespace, offloading_spec, offloading_spec.blocks_per_chunk)
28 self.cache = DiskCache(ssd_dir, hdd_dir, ssd_bytes, hdd_bytes, key)
29 self.block_size = primary_kv_view.strides[0]
30 self.pool = DualQueueThreadPool(16, 2, thread_name_prefix="studio_kv_disk")
31
32 def on_new_request(self, req_context):
33 return RequestOffloadingContext()
34
35 def lookup(self, key, req_context):
36 return LookupResult.HIT if self.cache.acquire(self.mapper.get_file_name(key), req_context.req_id) else LookupResult.MISS
37
38 def submit_store(self, job_metadata):
39 tasks = [functools.partial(self._transfer, self.cache.store, key, block_id)
40 for key, block_id in zip(job_metadata.keys, job_metadata.block_ids, strict=True)]
41 self.pool.enqueue_store(job_metadata.job_id, len(tasks), tasks)
42
43 def submit_load(self, job_metadata):
44 tasks = [functools.partial(self._transfer, self.cache.load, key, block_id)
45 for key, block_id in zip(job_metadata.keys, job_metadata.block_ids, strict=True)]
46 self.pool.enqueue_load(job_metadata.job_id, len(tasks), tasks)
47
48 def _transfer(self, operation, key, block_id):
49 offset = int(block_id) * self.block_size
50 with self._primary_kv_view.cast("B")[offset:offset + self.block_size] as view:
51 operation(self.mapper.get_file_name(key), view)
52
53 def get_finished_jobs(self):
54 return [JobResult(job_id, success) for job_id, success in self.pool.get_finished()]
55
56 def touch(self, keys, req_context):
57 for key in keys:
58 self.cache.touch(self.mapper.get_file_name(key))
59
60 def on_request_finished(self, req_context):
61 self.cache.release(req_context.req_id)
62
63 def drain_jobs(self):
64 self.pool.wait_idle()
65
66 def shutdown(self):
67 self.pool.wait_idle()
68 self.pool.shutdown(wait=True)
69 self.cache.close()
70
71
72def register():
73 SecondaryTierFactory.register_tier("studio_disk", __name__, "DiskTier")
service/local-ai/cache/test_cache.py+1-1
......@@ -5,7 +5,7 @@ from pathlib import Path
55import tempfile
66import unittest
77
8from studio_ai_cache import DiskCache
8from snowglobe_ai_cache import DiskCache
99
1010
1111class 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
1313from vllm.v1.kv_offload.tiering.factory import SecondaryTierFactory
1414from vllm.v1.kv_offload.tiering.manager import CPUPrimaryTierOffloadingManager, TieringOffloadingManager
1515
16from studio_ai_cache_vllm import register
16from snowglobe_ai_cache_vllm import register
1717
1818
1919class VllmCacheTests(unittest.TestCase):
......@@ -25,7 +25,7 @@ class VllmCacheTests(unittest.TestCase):
2525 self.temporary = tempfile.TemporaryDirectory()
2626 self.addCleanup(self.temporary.cleanup)
2727 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"
2929 config = OffloadingConfig(
3030 groups=(OffloadingGroupConfig(16, ("attention",)), OffloadingGroupConfig(16, ("recurrent",))),
3131 worker_kv_bytes_per_block=mmap.PAGESIZE,
......@@ -39,7 +39,7 @@ class VllmCacheTests(unittest.TestCase):
3939 primary = CPUPrimaryTierOffloadingManager(4, region)
4040 self.view = primary.get_kv_memoryview()
4141 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"),
4343 "ssd_bytes": 4 * mmap.PAGESIZE, "hdd_bytes": 6 * mmap.PAGESIZE,
4444 }, self.view, spec)
4545 self.manager = TieringOffloadingManager(primary, [self.tier])
service/local-ai/gateway.py+3-3
......@@ -13,10 +13,10 @@ import threading
1313
1414WAIT_SECONDS = 8 * 60 * 60
1515HOP_HEADERS = {"connection", "transfer-encoding", "content-length", "host", "accept-encoding"}
16STEERING_DIR = Path(os.environ.get("STUDIO_STEERING_DIR", Path(__file__).with_name("steering")))
16STEERING_DIR = Path(os.environ.get("SNOWGLOBE_STEERING_DIR", Path(__file__).with_name("steering")))
1717STEERING_REVISION = hashlib.sha256(b"".join(
1818 (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")
2020)).hexdigest()
2121
2222
......@@ -24,7 +24,7 @@ def route_model(data):
2424 golden = data.get("model") == "golden-gate-qwen3.8-27B"
2525 if golden and data.get("use_beam_search"):
2626 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)}
2828 salt = data.get("cache_salt")
2929 if salt is not None and (not isinstance(salt, str) or not salt):
3030 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
77local model = models[0]
88local weights = (new json.Parser {}).parse(read("models.json"))
99
10meta { name = "Local AI"; launcher = false; access = "admin" }
11enabled = (read?("env:STUDIO_LOCAL_AI") ?? "false") == "true"
12rollout = "simple"
10name = "Local AI"
11launcher = false
12access = "admin"
13enabled = (read?("env:SNOWGLOBE_LOCAL_AI") ?? "false") == "true"
1314stageIsolation = "fresh"
1415prepare = "prepare.py"
1516healthyDeadline = "30m"
......@@ -40,7 +41,7 @@ container {
4041 env {
4142 ["LD_LIBRARY_PATH"] = "/nvidia/lib:/usr/local/cuda/lib64"
4243 ["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}"
4445 ["PYTHONHASHSEED"] = "0"
4546 ["PYTORCH_CUDA_ALLOC_CONF"] = "expandable_segments:False"
4647 ["MODEL"] = "/models"
......@@ -59,7 +60,7 @@ container {
5960 ["PORT"] = "8081"
6061 ["VLLM_MAMBA_ALIGN_KEEP_CHECKPOINTS"] = "1"
6162 ["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"
6364 }
6465 args { "/config/gateway.py" }
6566}
service/local-ai/steering/README.md+1-1
......@@ -13,7 +13,7 @@ forward pass, including CUDA graph replay and speculative verification.
1313Normal rows preserve both residual branches unchanged. The MTP drafter uses
1414the resulting target hidden states; its separate layer is not steered.
1515
16GPU verification at full strength on 2026-10-16 used Swift's existing INT4 weights on Zenith's
16GPU verification at full strength on 2026-10-16 used Swift's existing INT4 weights on Snow Globe's
1717RTX 3090. CUDA graph replay preserved normal rows exactly. Sixteen concurrent
1818mixed-model requests selected the correct behavior. Identical 7,526-token
1919prompts 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 @@
44
55 import torch
66 from torch import nn
7+from studio_ai_steering import GoldenGateSteering
7+from snowglobe_ai_steering import GoldenGateSteering
88
99 from vllm._aiter_ops import rocm_aiter_ops
1010 from vllm.compilation.decorators import support_torch_compile
......@@ -37,7 +37,7 @@
3737 from vllm.platforms import current_platform
3838 from vllm.pooling_params import PoolingParams
3939 from vllm.sampling_params import SamplingType
40+from studio_ai_steering import GoldenGateSteering
40+from snowglobe_ai_steering import GoldenGateSteering
4141 from vllm.sequence import IntermediateTensors
4242 from vllm.tasks import GenerationTask, PoolingTask, SupportedTask
4343 from vllm.tracing import instrument
service/local-ai/steering/snowglobe_ai_steering.py created+38
......@@ -0,0 +1,38 @@
1from pathlib import Path
2
3import torch
4from safetensors.torch import load_file
5
6
7class GoldenGateSteering(torch.nn.Module):
8 def __init__(self, config):
9 super().__init__()
10 parallel = config.parallel_config
11 if (parallel.tensor_parallel_size, parallel.pipeline_parallel_size,
12 parallel.data_parallel_size) != (1, 1, 1) or parallel.enable_dbo:
13 raise ValueError("Golden Gate steering requires one GPU without microbatching")
14 vector = load_file(str(Path(__file__).with_name("golden-gate.safetensors")))["steer.layer32"]
15 if vector.shape != (config.model_config.hf_text_config.hidden_size,):
16 raise ValueError("Golden Gate vector does not match the model's hidden dimension")
17 self.register_buffer("vector", (vector * 0.625).to(device="cuda", dtype=config.model_config.dtype), persistent=False)
18 self.register_buffer("mask", torch.zeros(config.scheduler_config.max_num_batched_tokens, 1,
19 device="cuda", dtype=torch.bool), persistent=False)
20 self.cpu_mask = torch.zeros(self.mask.shape, device="cpu", dtype=torch.bool, pin_memory=True)
21
22 def prepare(self, requests, req_ids, counts):
23 self.cpu_mask.zero_()
24 offset = 0
25 for req_id, count in zip(req_ids, counts, strict=True):
26 params = requests[req_id].sampling_params
27 if params and (params.extra_args or {}).get("snowglobe_golden_gate"):
28 self.cpu_mask[offset:offset + count] = True
29 offset += count
30 if offset > len(self.mask):
31 raise ValueError("Golden Gate token mask is smaller than the scheduled batch")
32 self.mask.copy_(self.cpu_mask, non_blocking=True)
33
34 def forward(self, hidden, residual):
35 mask = self.mask[:hidden.shape[0]]
36 # vLLM defers the residual addition until the next layer's fused norm.
37 steered = (hidden + residual) + self.vector
38 return torch.where(mask, 0, hidden), torch.where(mask, steered, residual)
service/local-ai/steering/studio_ai_steering.py deleted-38
......@@ -1,38 +0,0 @@
1from pathlib import Path
2
3import torch
4from safetensors.torch import load_file
5
6
7class GoldenGateSteering(torch.nn.Module):
8 def __init__(self, config):
9 super().__init__()
10 parallel = config.parallel_config
11 if (parallel.tensor_parallel_size, parallel.pipeline_parallel_size,
12 parallel.data_parallel_size) != (1, 1, 1) or parallel.enable_dbo:
13 raise ValueError("Golden Gate steering requires one GPU without microbatching")
14 vector = load_file(str(Path(__file__).with_name("golden-gate.safetensors")))["steer.layer32"]
15 if vector.shape != (config.model_config.hf_text_config.hidden_size,):
16 raise ValueError("Golden Gate vector does not match the model's hidden dimension")
17 self.register_buffer("vector", (vector * 0.625).to(device="cuda", dtype=config.model_config.dtype), persistent=False)
18 self.register_buffer("mask", torch.zeros(config.scheduler_config.max_num_batched_tokens, 1,
19 device="cuda", dtype=torch.bool), persistent=False)
20 self.cpu_mask = torch.zeros(self.mask.shape, device="cpu", dtype=torch.bool, pin_memory=True)
21
22 def prepare(self, requests, req_ids, counts):
23 self.cpu_mask.zero_()
24 offset = 0
25 for req_id, count in zip(req_ids, counts, strict=True):
26 params = requests[req_id].sampling_params
27 if params and (params.extra_args or {}).get("studio_golden_gate"):
28 self.cpu_mask[offset:offset + count] = True
29 offset += count
30 if offset > len(self.mask):
31 raise ValueError("Golden Gate token mask is smaller than the scheduled batch")
32 self.mask.copy_(self.cpu_mask, non_blocking=True)
33
34 def forward(self, hidden, residual):
35 mask = self.mask[:hidden.shape[0]]
36 # vLLM defers the residual addition until the next layer's fused norm.
37 steered = (hidden + residual) + self.vector
38 return torch.where(mask, 0, hidden), torch.where(mask, steered, residual)
service/local-ai/steering/test_steering.py+2-2
......@@ -3,7 +3,7 @@ import unittest
33
44import torch
55
6from studio_ai_steering import GoldenGateSteering
6from snowglobe_ai_steering import GoldenGateSteering
77
88
99@unittest.skipUnless(torch.cuda.is_available(), "requires a CUDA GPU")
......@@ -17,7 +17,7 @@ class Steering(unittest.TestCase):
1717 )
1818 with torch.device("cuda"):
1919 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}))
2121 for name, value in [("normal", 0), ("golden", 1)]}
2222 hidden = torch.randn(8, 5120, device="cuda", dtype=torch.bfloat16)
2323 residual = torch.randn_like(hidden)
service/local-ai/test_gateway.py+4-4
......@@ -25,10 +25,10 @@ class ResponsesCompatibility(unittest.TestCase):
2525 worker.join()
2626
2727 def test_steering_and_cache_namespace_follow_model_selection(self):
28 normal = route_model({"model": "qwen3.8-27b", "vllm_xargs": {"studio_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}})
30 self.assertEqual(normal["vllm_xargs"]["studio_golden_gate"], 0)
31 self.assertEqual(golden["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": {"snowglobe_golden_gate": 0}, "chat_template_kwargs": {"enable_thinking": True}})
30 self.assertEqual(normal["vllm_xargs"]["snowglobe_golden_gate"], 0)
31 self.assertEqual(golden["vllm_xargs"]["snowglobe_golden_gate"], 1)
3232 self.assertNotIn("chat_template_kwargs", normal)
3333 self.assertFalse(golden["chat_template_kwargs"]["enable_thinking"])
3434 self.assertNotEqual(normal["cache_salt"], golden["cache_salt"])
service/navidrome/service.pkl+1-3
......@@ -2,12 +2,10 @@ amends "../../config/Service.pkl"
22
33import "../../config/site.pkl" as site
44
5meta { name = "Navidrome" }
5name = "Navidrome"
66
77container {
88 image = "docker.io/deluan/navidrome@sha256:59ce76e6e06193fbfbb1736a93b8468227e1ea663fc7b25b1da13fbb97f5197b"
9 cpu = 200
10 memory = 512
119
1210 http {
1311 containerPort = 4533
service/openclaw/service.pkl+4-5
......@@ -1,7 +1,8 @@
11amends "../../config/Service.pkl"
22
3meta { name = "OpenClaw"; access = "infra-admin" }
4enabled = (read?("env:STUDIO_LOCAL_AI") ?? "false") == "true"
3name = "OpenClaw"
4access = "infra-admin"
5enabled = (read?("env:SNOWGLOBE_LOCAL_AI") ?? "false") == "true"
56stageIsolation = "fresh"
67healthyDeadline = "30m"
78healthRestartGrace = "30m"
......@@ -14,7 +15,6 @@ containers {
1415 hostNetwork = true
1516 entrypoint = "/usr/sbin/nginx"
1617 args { "-c"; "/cfg/nginx.conf"; "-g"; "daemon off;" }
17 cpu = 200
1818 memory = 256
1919 http {
2020 containerPort = 18889
......@@ -27,7 +27,7 @@ containers {
2727 }
2828 volumes {
2929 ["/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 }
3131 }
3232 }
3333 ["internet"] {
......@@ -35,7 +35,6 @@ containers {
3535 hostNetwork = true
3636 entrypoint = "/usr/sbin/squid"
3737 args { "-N"; "-f"; "/config/squid.conf" }
38 cpu = 200
3938 memory = 256
4039 volumes { ["/config/squid.conf"] { config = "squid.conf" } }
4140 }
service/openspeedtest/service.pkl+1-1
......@@ -1,6 +1,6 @@
11amends "../../config/Service.pkl"
22
3meta { name = "Open Speed Test" }
3name = "Open Speed Test"
44rollout = "overlapped"
55healthRestartGrace = "30s"
66
service/pds/service.pkl+4-5
......@@ -4,10 +4,10 @@ import "../../config/site.pkl" as site
44
55local isolated = site.preview || site.domain.endsWith(".test")
66
7meta { name = "ATProto PDS"; launcher = false }
7name = "ATProto PDS"
8launcher = false
89traceServiceName = module.id
910metricsPushed = true
10rollout = "simple"
1111stageIsolation = "fresh"
1212dependsOn { "victoria" }
1313
......@@ -29,9 +29,8 @@ requiredSecrets = if (isolated) new {} else new {
2929container {
3030 image = "ghcr.io/bluesky-social/pds@sha256:d155af1c906d7848e7dea9d59a8a7def065a04b77aa98ae56ea05a8d4eadb63a"
3131 entrypoint = "/bin/sh"
32 args { "/studio/start.sh" }
32 args { "/snowglobe/start.sh" }
3333 cpu = 250
34 memory = 512
3534
3635 http {
3736 containerPort = 3000
......@@ -41,7 +40,7 @@ container {
4140
4241 volumes {
4342 ["/pds"] {}
44 ["/studio/start.sh"] { config = "start.sh" }
43 ["/snowglobe/start.sh"] { config = "start.sh" }
4544 }
4645
4746 env {
service/postgres/pgadmin.pkl+3-4
......@@ -3,7 +3,7 @@ amends "../../config/Service.pkl"
33import "service.pkl" as postgres
44import "../../config/site.pkl" as site
55
6meta { name = "pgAdmin" }
6name = "pgAdmin"
77healthyDeadline = "15m"
88requirements { new postgres.AdminConnection {} }
99
......@@ -14,9 +14,8 @@ secrets {
1414container {
1515 image = "docker.io/dpage/pgadmin4@sha256:33eb7d070ee7500d1513453773f61df1256fdea08257d4a3f4aebd8cf1cc87cf"
1616 entrypoint = "/bin/sh"
17 args { "/studio/start.sh" }
17 args { "/snowglobe/start.sh" }
1818 cpu = 150
19 memory = 512
2019
2120 http {
2221 containerPort = 5050
......@@ -27,7 +26,7 @@ container {
2726
2827 volumes {
2928 ["/var/lib/pgadmin"] {}
30 ["/studio/start.sh"] { config = "start.sh" }
29 ["/snowglobe/start.sh"] { config = "start.sh" }
3130 }
3231
3332 env {
service/postgres/service.pkl+1-1
......@@ -16,7 +16,7 @@ class AdminConnection extends service.Requirement {
1616 fixed kind = "admin"
1717}
1818
19meta { name = "Postgres" }
19name = "Postgres"
2020provide = "provide.py"
2121
2222container {
service/qbittorrent/service.pkl+1-3
......@@ -2,8 +2,7 @@ amends "../../config/Service.pkl"
22
33import "../../config/site.pkl" as site
44
5meta { name = "qBittorrent" }
6rollout = "simple"
5name = "qBittorrent"
76healthyDeadline = "15m"
87prepare = "prepare.py"
98
......@@ -15,7 +14,6 @@ requiredSecrets {
1514container {
1615 image = "docker.io/binhex/arch-qbittorrentvpn@sha256:7320d195ca582b236207b88f483319cd49b08c0665b22b945c3d4cebcb601a17"
1716 imageUser = true
18 cpu = 200
1917 memory = 1024
2018 capAdd { "NET_ADMIN" }
2119 devices { "/dev/net/tun" }
service/radarr/service.pkl+1-1
......@@ -2,7 +2,7 @@ amends "../../config/Service.pkl"
22
33import "../../config/site.pkl" as site
44
5meta { name = "Radarr" }
5name = "Radarr"
66setup = "tools/configure-arr.py"
77dependsOn {
88 "qbittorrent"
service/samba/service.pkl+1-1
......@@ -2,7 +2,7 @@ amends "../../config/Service.pkl"
22
33import "../../config/site.pkl" as site
44
5meta { name = "Samba" }
5name = "Samba"
66
77container {
88 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"):
1717 file.write("\n[http]\n\treceivepack = true\n")
1818path = root / "data/astheno.shale.db"
1919if path.exists():
20 domain = os.environ["STUDIO_DOMAIN"]
20 domain = os.environ["SNOWGLOBE_DOMAIN"]
2121 old, new = "auth." + domain + "/realms/master", "snowglobe." + domain
2222 db = sqlite3.connect(path, timeout=30)
2323 db.execute("BEGIN IMMEDIATE")
service/shale/service.pkl+5-8
......@@ -3,13 +3,11 @@ amends "../../config/Service.pkl"
33import "../../config/OpenID.pkl" as sso
44import "../../config/site.pkl" as site
55
6meta {
7 name = "Shale"
8}
6name = "Shale"
97requirements {
108 new sso.Client {
119 clientId = module.id
12 name = module.meta.name
10 name = module.name
1311 redirectUris { "https://\(module.container.http.hostname)/-/callback" }
1412 usernameAliases { ["snow"] = "clover" }
1513 allowGuests = true
......@@ -21,7 +19,6 @@ prepare = "prepare.py"
2119container {
2220 memory = 4096
2321 image = "docker.io/astheno/shale@sha256:b55cc42c4eb2c1e21733405bec795e49ddd7c71fb1755d2aa2ee4361f750cebd"
24 extraHosts { "\(sso.hostname):host-gateway" }
2522
2623 http {
2724 containerPort = 8000
......@@ -29,11 +26,11 @@ container {
2926 overrideFiles {
3027 ["/-/theme.css"] = "theme.css"
3128 ["/-/repo-icons/"] = "icons"
32 ["/-/studio-readme/"] = "readme"
29 ["/-/snowglobe-readme/"] = "readme"
3330 }
3431 headHtml {
3532 ["/*"] = """
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>
3734 """
3835 }
3936 }
......@@ -45,7 +42,7 @@ container {
4542 ["/etc/crontabs"] {}
4643 ["/etc/shale/theme.css"] { config = "theme.css" }
4744 ["/etc/ssl/certs/ca-certificates.crt"] {
48 src = "/var/lib/studio/ca-bundle.crt"
45 src = "/var/lib/snowglobe/ca-bundle.crt"
4946 readOnly = true
5047 }
5148 }
service/sonarr/service.pkl+1-1
......@@ -2,7 +2,7 @@ amends "../../config/Service.pkl"
22
33import "../../config/site.pkl" as site
44
5meta { name = "Sonarr" }
5name = "Sonarr"
66setup = "tools/configure-arr.py"
77dependsOn {
88 "qbittorrent"
service/tailscale/service.pkl+1-1
......@@ -2,7 +2,7 @@ amends "../../config/Service.pkl"
22
33import "../../config/site.pkl" as site
44
5meta { name = "Tailscale" }
5name = "Tailscale"
66
77container {
88 image = "docker.io/tailscale/tailscale@sha256:2667499ed87ae29218f292556ba062918402dd5e92e93637af14867e4df12dd3"
service/victoria/service.pkl+2-4
......@@ -1,12 +1,12 @@
11amends "../../config/Service.pkl"
22
3meta { name = "Victoria"; tagline = "Metrics, logs, and traces" }
3name = "Victoria"
4tagline = "Metrics, logs, and traces"
45
56containers {
67 ["logs"] {
78 image = "docker.io/victoriametrics/victoria-logs:v1.52.0"
89 cpu = 300
9 memory = 512
1010 args { "-storageDataPath=/logs"; "-retentionPeriod=30d" }
1111
1212 http {
......@@ -22,7 +22,6 @@ containers {
2222 ["metrics"] {
2323 image = "docker.io/victoriametrics/victoria-metrics:v1.152.0"
2424 cpu = 300
25 memory = 512
2625 args { "-storageDataPath=/metrics"; "-retentionPeriod=30d"; "-usePromCompatibleNaming" }
2726
2827 http {
......@@ -39,7 +38,6 @@ containers {
3938 ["traces"] {
4039 image = "docker.io/victoriametrics/victoria-traces:v0.11.1"
4140 cpu = 300
42 memory = 512
4341 args { "-storageDataPath=/traces"; "-retentionPeriod=30d" }
4442
4543 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
44
55data_path = "/var/lib/prosody"
66pidfile = "/var/lib/prosody/prosody.pid"
7plugin_paths = { "/opt/prosody-modules", "/studio" }
7plugin_paths = { "/opt/prosody-modules", "/snowglobe" }
88admins = { "clover@" .. domain }
99bootstrap_password = ENV_XMPP_PASSWORD
1010authentication = "internal_hashed"
service/xmpp/service.pkl+8-8
......@@ -8,7 +8,8 @@ local network = new json.Parser {}.parse(read("network.json").text)
88local host = read?("prop:hostname") ?? "xmpp.\(site.domain)"
99local accountDomain = if (site.preview) host else site.domain
1010
11meta { name = "XMPP"; launcher = false }
11name = "XMPP"
12launcher = false
1213stageIsolation = "fresh"
1314healthyDeadline = "10m"
1415setup = "setup.py"
......@@ -28,12 +29,12 @@ containers {
2829 ["certificates"] {
2930 build = "."
3031 entrypoint = "/usr/bin/python3"
31 args { "/studio/run.py"; "certificates" }
32 args { "/snowglobe/run.py"; "certificates" }
3233 hostNetwork = true
3334 lifecycle = "prestartSidecar"
3435 cpu = 100
3536 memory = 256
36 volumes { ["/tls"] {}; ["/studio"] { config = "runtime" } }
37 volumes { ["/tls"] {}; ["/snowglobe"] { config = "runtime" } }
3738 env {
3839 ["XMPP_DOMAIN"] = accountDomain
3940 ["XMPP_HOST"] = host
......@@ -44,9 +45,8 @@ containers {
4445 ["prosody"] {
4546 build = "."
4647 entrypoint = "/usr/bin/python3"
47 args { "/studio/run.py"; "prosody" }
48 args { "/snowglobe/run.py"; "prosody" }
4849 hostNetwork = true
49 memory = 512
5050 http { containerPort = 5280; hostname = host; loopback = true; checkPath = "/health"; forwardRealIp = true }
5151 tcp {
5252 new { name = "c2s"; containerPort = network.c2s; hostPort = containerPort; loopback = false }
......@@ -56,7 +56,7 @@ containers {
5656 volumes {
5757 ["/var/lib/prosody"] {}
5858 ["/tls"] { readOnly = true }
59 ["/studio"] { config = "runtime" }
59 ["/snowglobe"] { config = "runtime" }
6060 ["/etc/prosody/prosody.cfg.lua"] { config = "prosody.cfg.lua" }
6161 }
6262 env {
......@@ -72,7 +72,7 @@ containers {
7272 ["turn"] {
7373 build = "."
7474 entrypoint = "/usr/bin/python3"
75 args { "/studio/run.py"; "turn" }
75 args { "/snowglobe/run.py"; "turn" }
7676 hostNetwork = true
7777 memory = 256
7878 tcp {
......@@ -82,7 +82,7 @@ containers {
8282 new { name = "relay-\(port)"; containerPort = port; hostPort = port; loopback = false }
8383 }
8484 }
85 volumes { ["/tls"] { readOnly = true }; ["/studio"] { config = "runtime" } }
85 volumes { ["/tls"] { readOnly = true }; ["/snowglobe"] { config = "runtime" } }
8686 env { ["XMPP_HOST"] = host; ["TURN_SECRET"] = "${secret.own.turn}" }
8787 }
8888}
service/xmpp/setup.py+1-1
......@@ -22,7 +22,7 @@ if len(sys.argv) == 1:
2222 sys.exit()
2323
2424stage = sys.argv[1]
25metadata = Path("/var/lib/studio/stages") / (stage + ".json")
25metadata = Path("/var/lib/snowglobe/stages") / (stage + ".json")
2626network = json.loads(Path(__file__).with_name("network.json").read_text())
2727rules = [
2828 ["-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
44
55local passive = site.preview || site.mediaReadOnly
66
7meta { name = "YTDL" }
7name = "YTDL"
88
99requiredSecrets {
1010 "smtp_host"
......@@ -43,7 +43,6 @@ containers {
4343 else
4444 "sh /config-yt/archive-loop.sh"
4545 }
46 cpu = 200
4746 memory = if (passive) 256 else 512
4847
4948 http = if (passive) new {
tools/check-legacy-handoff.sh deleted-24
......@@ -1,24 +0,0 @@
1#!/bin/sh
2set -eu
3
4handoff=${1:?Expected a legacy handoff directory}
5target=${2:?Expected a production target}
6port=${3:?Expected a target SSH port}
7printf '%s\n' "$handoff" | grep -Eq '^/mnt/storage1/apps/studio-handoff/[0-9]{8}T[0-9]{6}Z-[0-9a-f]{6}$' || {
8 echo 'Invalid legacy handoff directory' >&2
9 exit 1
10}
11ssh -p "$port" "$target" "
12 set -eu
13 test -f '$handoff/manifest.json'
14 pool=\$(findmnt -n -o SOURCE --mountpoint /srv)
15 test \"\$(findmnt -n -o FSTYPE --mountpoint /srv)\" = zfs
16 zpool list \"\$pool\" >/dev/null
17 apps=\$(findmnt -n -o SOURCE --mountpoint /mnt/storage1/apps)
18 test \"\$apps\" = \"\$pool/apps\"
19 test \"\$(findmnt -n -o FSTYPE --mountpoint /mnt/storage1/apps)\" = zfs
20 test \"\$(zfs get -H -o value encryption \"\$apps\")\" = aes-256-gcm
21" || {
22 echo 'Legacy handoff or encrypted apps dataset is unavailable' >&2
23 exit 1
24}
tools/configure-arr.py+1-1
......@@ -6,7 +6,7 @@ from urllib.parse import urlsplit, urlunsplit
66import urllib.request
77import xml.etree.ElementTree as ET
88
9from studio import load
9from snowglobe import load
1010
1111
1212data = json.load(sys.stdin)
tools/copyparty-cutover-test.py deleted-299
......@@ -1,299 +0,0 @@
1#!/usr/bin/env python3
2import importlib.util
3import json
4import os
5from pathlib import Path
6import sqlite3
7import sys
8import tempfile
9import unittest
10from unittest.mock import patch
11
12spec = importlib.util.spec_from_file_location('cutover', Path(__file__).with_name('copyparty-cutover.py'))
13cutover = importlib.util.module_from_spec(spec)
14spec.loader.exec_module(cutover)
15copyparty = cutover.copyparty
16public_statuses = cutover.public_statuses
17
18
19class Cutover(unittest.TestCase):
20 def setUp(self):
21 self.temporary = tempfile.TemporaryDirectory(prefix='copyparty-cutover-')
22 self.addCleanup(self.temporary.cleanup)
23 self.base = Path(self.temporary.name)
24 self.root = self.base / 'clover'
25 self.cfg = self.base / 'cfg'
26 (self.root / 'Share').mkdir(parents=True)
27 (self.cfg / 'copyparty').mkdir(parents=True)
28 self.environment = patch.dict(os.environ, {'STUDIO_CLOVER_ROOT': str(self.root), 'STUDIO_COPYPARTY_CFG': str(self.cfg)})
29 self.environment.start()
30 self.addCleanup(self.environment.stop)
31 self.manager = copyparty.Manager([])
32 self.manager.job = {'ID': 'copyparty', 'Stop': False, 'Meta': {'studio_hostname': 'copyparty.example.invalid'}}
33 self.events = []
34 edge = patch.object(cutover, 'public_statuses', side_effect=lambda host, keys, deadline: {key: 200 for key in keys})
35 edge.start()
36 self.addCleanup(edge.stop)
37
38 def stop():
39 self.events.append('stop')
40 if self.manager.offline_at is None:
41 self.manager.offline_at = cutover.time.monotonic()
42 self.manager.stopped = True
43
44 def start():
45 self.events.append('start')
46 self.manager.stopped = False
47
48 self.manager.stop = stop
49 self.manager.start = start
50 for source, _ in cutover.MOVES:
51 path = self.root / source
52 (path / 'nested').mkdir(parents=True)
53 (path / 'selected.txt').write_text('Disposable fixture')
54 (path / 'nested' / 'child.txt').write_text('Disposable child')
55 (self.cfg / 'copyparty.conf').write_text('Fixture configuration')
56 self.database = self.cfg / 'copyparty/shares.db'
57 with sqlite3.connect(self.database) as db:
58 db.executescript("CREATE TABLE kv(k text,v int); INSERT INTO kv VALUES('sver',2); CREATE TABLE sh(k text,pw text,vp text,pr text,st int,un text,t0 int,t1 int); CREATE TABLE sf(k text,vp text);")
59 db.executemany('INSERT INTO sh VALUES(?,?,?,?,?,?,?,?)', [
60 ('folder-key', 'opaque-hash', 'clover/Documents/Public/Snowbound', 'rw', 0, 'snow', 10, 20),
61 ('nested-key', '', 'clover/Documents/Public/Snowbound/nested', 'r', 0, 'snow', 30, 0),
62 ('selected-key', 'another-hash', 'clover/Documents/EvilTakeout', 'r', 1, 'snow', 40, 50),
63 ('unaffected-key', '', 'clover/Other', 'r', 0, 'snow', 60, 0),
64 ])
65 db.execute('INSERT INTO sf VALUES(?,?)', ('selected-key', 'selected.txt'))
66 with sqlite3.connect(self.database) as db:
67 self.original = cutover.rows(db)
68 self.before_content = {str(path.relative_to(self.root)): path.read_bytes() for path in self.root.rglob('*.txt')}
69
70 def test_move_preserves_keys_selections_passwords_inodes_and_content(self):
71 expected = cutover.plan(self.manager)
72 result = cutover.apply(self.manager, expected, self.base / 'backups')
73 self.assertEqual(result['result'], 'moved')
74 self.assertEqual(self.events, ['stop', 'start'])
75 with sqlite3.connect(self.database) as db:
76 actual = cutover.rows(db)
77 self.assertEqual(actual, cutover.remapped(self.manager, self.original, cutover.mappings(self.manager)))
78 self.assertEqual(actual['sf'], self.original['sf'])
79 for detail in expected['moves']:
80 source, destination = Path(detail['source']), Path(detail['destination'])
81 self.assertFalse(source.exists())
82 self.assertEqual(destination.stat().st_ino, detail['inode'])
83 for old_path, contents in self.before_content.items():
84 old = self.root / old_path
85 if old.is_relative_to(source):
86 self.assertEqual((destination / old.relative_to(source)).read_bytes(), contents)
87 backup = Path(result['backup'])
88 for child in backup.iterdir():
89 self.assertEqual(child.stat().st_mode & 0o777, 0o600)
90 self.assertEqual(backup.stat().st_mode & 0o777, 0o700)
91
92 def test_public_probe_sends_bounded_verified_head_and_preserves_redirect_status(self):
93 response = cutover.subprocess.CompletedProcess([], 0, stdout='302', stderr='')
94 with patch.object(cutover.subprocess, 'run', return_value=response) as run:
95 actual = public_statuses('copyparty.example.invalid', ['selected file'], cutover.time.monotonic() + 1)
96 self.assertEqual(actual, {'selected file': 302})
97 arguments = run.call_args.args[0]
98 self.assertEqual(arguments[:2], ['curl', '--disable'])
99 self.assertIn('--head', arguments)
100 self.assertEqual(arguments[arguments.index('--output') + 1], '/dev/null')
101 self.assertEqual(arguments[arguments.index('--write-out') + 1], '%{http_code}')
102 self.assertEqual(arguments[arguments.index('--noproxy') + 1], '*')
103 self.assertEqual(arguments[-2:], ['--', 'https://copyparty.example.invalid/shr/selected%20file/'])
104 self.assertLessEqual(run.call_args.kwargs['timeout'], 1)
105 self.assertEqual(float(arguments[arguments.index('--max-time') + 1]), run.call_args.kwargs['timeout'])
106 for flag in ['--insecure', '-k', '--location', '-L', '--include', '-i']:
107 self.assertNotIn(flag, arguments)
108
109 def test_public_probe_treats_network_tls_and_process_timeout_as_unavailable(self):
110 for response in [
111 cutover.subprocess.CompletedProcess([], 35, stdout='000', stderr='TLS problem'),
112 cutover.subprocess.CompletedProcess([], 28, stdout='200', stderr='Timeout'),
113 cutover.subprocess.CompletedProcess([], 0, stdout='000', stderr=''),
114 cutover.subprocess.CompletedProcess([], 0, stdout='200 headers', stderr=''),
115 ]:
116 with patch.object(cutover.subprocess, 'run', return_value=response):
117 self.assertEqual(public_statuses('host', ['key'], cutover.time.monotonic() + 1), {'key': None})
118 with patch.object(cutover.subprocess, 'run', side_effect=cutover.subprocess.TimeoutExpired('curl', 0.1)):
119 self.assertEqual(public_statuses('host', ['key'], cutover.time.monotonic() + 0.1), {'key': None})
120 with patch.object(cutover.subprocess, 'run') as run:
121 self.assertEqual(public_statuses('host', ['key'], cutover.time.monotonic() - 1), {'key': None})
122 run.assert_not_called()
123
124 def test_stalled_probe_children_cannot_hold_the_executor_past_its_budget(self):
125 run = cutover.subprocess.run
126 def stalled(arguments, **options):
127 return run([sys.executable, '-c', 'import time; time.sleep(10)'], **options)
128 started = cutover.time.monotonic()
129 with patch.object(cutover.subprocess, 'run', side_effect=stalled):
130 actual = public_statuses('host', ['one', 'two'], started + 0.15)
131 self.assertEqual(actual, {'one': None, 'two': None})
132 self.assertLess(cutover.time.monotonic() - started, 1.5)
133
134 def test_public_poll_recovers_and_timeout_obeys_its_budget(self):
135 clock = [0.0]
136 def sleep(delay):
137 clock[0] += delay
138 with patch.object(cutover.time, 'monotonic', side_effect=lambda: clock[0]), patch.object(cutover.time, 'sleep', side_effect=sleep):
139 with patch.object(cutover, 'public_statuses', side_effect=[{'key': 503}, {'key': 200}]):
140 cutover.wait_public('host', {'key': 200}, 1)
141 self.assertEqual(clock[0], 0.5)
142 with patch.object(cutover, 'public_statuses', return_value={'key': None}), self.assertRaises(TimeoutError):
143 cutover.wait_public('host', {'key': 200}, 1)
144 self.assertEqual(clock[0], 1)
145
146 def test_edge_timeout_rolls_back_and_records_recovery_evidence(self):
147 expected = cutover.plan(self.manager)
148 with patch.object(cutover, 'wait_public', side_effect=[TimeoutError('injected edge timeout'), None]):
149 with self.assertRaisesRegex(TimeoutError, 'edge timeout'):
150 cutover.apply(self.manager, expected, self.base / 'backups')
151 self.assertEqual(cutover.plan(self.manager), expected)
152 self.assertEqual(self.events, ['stop', 'start', 'stop', 'start'])
153 evidence = json.loads(next((self.base / 'backups').glob('*/result.json')).read_text())
154 self.assertEqual(evidence['result'], 'rolled-back')
155 self.assertEqual(evidence['publicStatuses'], {key: 200 for key in expected['affectedKeys']})
156
157 def test_existing_grants_follow_moves_and_configuration_is_rerendered(self):
158 source, destination = cutover.mappings(self.manager)[0]
159 state = {'accounts': [], 'grants': [{'id': 'fixture', 'subject': 'user:fixture', 'path': str(source), 'permissions': 'r'}], 'names': {}}
160 (self.cfg / 'manager.json').write_text(json.dumps(state))
161 expected = cutover.plan(self.manager)
162 with patch.object(copyparty.runs, 'nomad', return_value={'Items': {}}), patch.object(copyparty, 'configuration', return_value=b'Updated configuration') as render:
163 cutover.apply(self.manager, expected, self.base / 'backups')
164 saved = json.loads((self.cfg / 'manager.json').read_text())
165 self.assertEqual(saved['grants'][0]['path'], str(destination))
166 self.assertEqual(render.call_args.args[1]['grants'], saved['grants'])
167 self.assertEqual((self.cfg / 'copyparty.conf').read_bytes(), b'Updated configuration')
168
169 def test_failed_restart_restores_files_and_database_before_restart(self):
170 def start():
171 self.events.append('start')
172 if self.events.count('start') == 1:
173 raise RuntimeError('injected startup failure')
174 self.manager.stopped = False
175 self.manager.start = start
176 expected = cutover.plan(self.manager)
177 with self.assertRaisesRegex(RuntimeError, 'injected startup failure'):
178 cutover.apply(self.manager, expected, self.base / 'backups')
179 self.assertEqual(self.events, ['stop', 'start', 'stop', 'start'])
180 self.assertEqual(cutover.plan(self.manager), expected)
181 with sqlite3.connect(self.database) as db:
182 self.assertEqual(cutover.rows(db), self.original)
183 for path, content in self.before_content.items():
184 self.assertEqual((self.root / path).read_bytes(), content)
185
186 def test_rollback_uses_actual_helper_stop_and_start_with_frozen_nomad_job(self):
187 self.manager.stop = copyparty.Manager.stop.__get__(self.manager)
188 self.manager.start = copyparty.Manager.start.__get__(self.manager)
189 self.manager.job = None
190 requests = []
191 def nomad(path, method='GET', body=None, **_):
192 requests.append((path, method, body))
193 if path == 'job/copyparty' and method == 'GET':
194 return {'ID': 'copyparty', 'Stop': False, 'Meta': {'immutable': 'fixture', 'studio_hostname': 'copyparty.example.invalid'}}
195 if path.endswith('/allocations'):
196 return [{'ClientStatus': 'complete'}]
197 if path.startswith('var/'):
198 return {'Items': {'idp_header': 'fixture'}}
199 return {}
200 expected = cutover.plan(self.manager)
201 with patch.object(copyparty.runs, 'nomad', side_effect=nomad), patch.object(self.manager, 'reload', side_effect=[copyparty.Error(400, 'injected reload rejection'), None]):
202 with self.assertRaisesRegex(copyparty.Error, 'injected reload rejection'):
203 cutover.apply(self.manager, expected, self.base / 'backups')
204 self.assertEqual(cutover.plan(self.manager), expected)
205 registrations = [body for path, method, body in requests if path == 'jobs' and method == 'POST']
206 self.assertEqual(registrations, [{'Job': self.manager.job}, {'Job': self.manager.job}])
207 self.assertEqual(len([path for path, method, _ in requests if method == 'DELETE']), 2)
208 self.assertFalse(self.manager.stopped)
209
210 def test_partial_rename_failure_rolls_back_before_start(self):
211 native_rename = copyparty.rename
212 calls = 0
213 def rename(source, destination):
214 nonlocal calls
215 calls += 1
216 if calls == 3:
217 raise RuntimeError('injected third rename failure')
218 self.assertTrue(self.manager.stopped)
219 native_rename(source, destination)
220 expected = cutover.plan(self.manager)
221 with patch.object(copyparty, 'rename', side_effect=rename), self.assertRaisesRegex(RuntimeError, 'third rename'):
222 cutover.apply(self.manager, expected, self.base / 'backups')
223 self.assertEqual(cutover.plan(self.manager), expected)
224 self.assertEqual(self.events, ['stop', 'start'])
225
226 def test_stop_timeout_still_restarts_the_frozen_job(self):
227 def stop():
228 self.manager.offline_at = cutover.time.monotonic()
229 self.manager.stopped = True
230 raise RuntimeError('injected stop timeout')
231 self.manager.stop = stop
232 expected = cutover.plan(self.manager)
233 with self.assertRaisesRegex(RuntimeError, 'stop timeout'):
234 cutover.apply(self.manager, expected, self.base / 'backups')
235 self.assertEqual(self.events, ['start'])
236 self.assertEqual(cutover.plan(self.manager), expected)
237
238 def test_ambiguous_stop_response_reregisters_even_without_stopped_flag(self):
239 def stop():
240 self.manager.offline_at = cutover.time.monotonic()
241 self.manager.stopped = False
242 raise TimeoutError('lost Nomad stop response')
243 self.manager.stop = stop
244 expected = cutover.plan(self.manager)
245 with self.assertRaisesRegex(TimeoutError, 'lost Nomad stop response'):
246 cutover.apply(self.manager, expected, self.base / 'backups')
247 self.assertEqual(self.events, ['start'])
248 self.assertEqual(cutover.plan(self.manager), expected)
249
250 def test_verification_budget_reserves_time_for_restart(self):
251 expected = cutover.plan(self.manager)
252 original_tree = cutover.tree
253 def timed_tree(path, deadline=None):
254 if deadline is not None:
255 raise TimeoutError('injected verification deadline')
256 return original_tree(path)
257 with patch.object(cutover, 'tree', side_effect=timed_tree), self.assertRaisesRegex(TimeoutError, 'verification deadline'):
258 cutover.apply(self.manager, expected, self.base / 'backups')
259 self.assertEqual(self.events, ['stop', 'start'])
260 self.assertEqual(cutover.plan(self.manager), expected)
261
262 def test_source_and_database_drift_stop_before_mutation(self):
263 expected = cutover.plan(self.manager)
264 (self.root / cutover.MOVES[0][0] / 'changed.txt').write_text('Concurrent disposable write')
265 with self.assertRaisesRegex(ValueError, 'plan changed'):
266 cutover.apply(self.manager, expected, self.base / 'backups')
267 self.assertEqual(self.events, [])
268
269 def test_parent_shares_and_parent_selections_require_explicit_url_preservation(self):
270 for selected in [0, 1]:
271 with sqlite3.connect(self.database) as db:
272 db.execute('INSERT OR REPLACE INTO sh VALUES(?,?,?,?,?,?,?,?)', ('parent', '', 'clover/Documents/Public', 'r', selected, 'snow', 1, 0))
273 if selected:
274 db.execute('INSERT INTO sf VALUES(?,?)', ('parent', 'Snowbound'))
275 with self.assertRaisesRegex(ValueError, 'parent of a moved folder'):
276 cutover.plan(self.manager)
277 with sqlite3.connect(self.database) as db:
278 db.execute("DELETE FROM sh WHERE k='parent'")
279 db.execute("DELETE FROM sf WHERE k='parent'")
280
281 def test_symlinks_mounts_and_existing_destinations_reject_before_downtime(self):
282 source, destination = cutover.mappings(self.manager)[0]
283 destination.mkdir()
284 with self.assertRaises(ValueError):
285 cutover.plan(self.manager)
286 destination.rmdir()
287 link = source / 'link'
288 link.symlink_to('selected.txt')
289 with self.assertRaisesRegex(ValueError, 'symbolic link'):
290 cutover.plan(self.manager)
291 link.unlink()
292 with patch.object(cutover.os.path, 'ismount', side_effect=lambda path: Path(path) == source):
293 with self.assertRaises(ValueError):
294 cutover.plan(self.manager)
295 self.assertEqual(self.events, [])
296
297
298if __name__ == '__main__':
299 unittest.main()
tools/copyparty-cutover.py deleted-279
......@@ -1,279 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import concurrent.futures
4import copy
5import hashlib
6import importlib.util
7import json
8import os
9import re
10from pathlib import Path
11import sqlite3
12import socket
13import subprocess
14import stat
15import time
16import uuid
17from urllib.parse import quote
18
19
20spec = importlib.util.spec_from_file_location("copyparty", Path(__file__).resolve().parent.parent / "service/copyparty/manage.py")
21copyparty = importlib.util.module_from_spec(spec)
22spec.loader.exec_module(copyparty)
23
24
25MOVES = (
26 ('Documents/Public/Snowbound', 'Clover - Snowbound'),
27 ('Documents/Public/Meadow', 'Clover - Meadow Chat'),
28 ('Documents/Public/Bill Wurtz Music', 'Xavier - Bill Wurtz Music'),
29 ('Documents/HOTEWIG Reanimated', 'Collab - HOTEWIG Reanimated'),
30 ('Documents/EvilTakeout', 'Lino - Evil Inc Data Takeout'),
31 ('Documents/Windows7', 'Clover - Windows 7'),
32)
33
34
35def digest(value):
36 return hashlib.sha256(json.dumps(value, ensure_ascii=False, separators=(',', ':')).encode()).hexdigest()
37
38
39def rows(database):
40 if database.execute("SELECT v FROM kv WHERE k='sver'").fetchone() != (2,):
41 raise ValueError('Unsupported Copyparty share database version.')
42 return {
43 'sh': database.execute('SELECT * FROM sh ORDER BY k').fetchall(),
44 'sf': database.execute('SELECT * FROM sf ORDER BY k,vp').fetchall(),
45 }
46
47
48def mappings(manager):
49 return [(manager.root / source, manager.root / 'Share' / name) for source, name in MOVES]
50
51
52def remapped(manager, before, moves):
53 after = copy.deepcopy(before)
54 for index, row in enumerate(before['sh']):
55 source_path = manager.real(row[2].strip('/'))
56 for source, destination in moves:
57 if source_path is not None and source_path.is_relative_to(source):
58 changed = list(row)
59 changed[2] = manager.virtual(destination / source_path.relative_to(source))
60 after['sh'][index] = tuple(changed)
61 break
62 if (source_path is not None and source.is_relative_to(source_path)) or row[2].strip('/') == '':
63 raise ValueError('A share includes a parent of a moved folder. Preserve its URL paths before cutover: ' + row[0])
64 return after
65
66
67def tree(path, deadline=None):
68 def unreadable(error):
69 raise error
70
71 result = []
72 for directory, dirs, files in os.walk(path, followlinks=False, onerror=unreadable):
73 if deadline is not None and time.monotonic() >= deadline:
74 raise TimeoutError("Folder verification exceeded the cutover budget.")
75 base = Path(directory)
76 if base != path and os.path.ismount(base):
77 raise ValueError('A source contains a mounted filesystem: ' + str(base))
78 for entry in [base] + [base / name for name in files] + [base / name for name in dirs if (base / name).is_symlink()]:
79 if deadline is not None and time.monotonic() >= deadline:
80 raise TimeoutError("Folder verification exceeded the cutover budget.")
81 info = entry.lstat()
82 if stat.S_ISLNK(info.st_mode):
83 raise ValueError('Review this source symbolic link before cutover: ' + str(entry))
84 result.append((str(entry.relative_to(path)), info.st_dev, info.st_ino, info.st_mode, info.st_size if not stat.S_ISDIR(info.st_mode) else 0, info.st_mtime_ns))
85 dirs[:] = [name for name in dirs if not (base / name).is_symlink()]
86 return sorted(result)
87
88
89def plan(manager, deadline=None):
90 moves = mappings(manager)
91 details = []
92 for source, destination in moves:
93 manager.path_for(str(source))
94 manager.path_for(str(destination), missing=True)
95 if source.is_symlink() or os.path.ismount(source) or os.path.lexists(destination):
96 raise ValueError('A source is mounted or a destination already exists: ' + str(source))
97 source_info, parent_info = source.stat(), destination.parent.stat()
98 if source_info.st_dev != parent_info.st_dev:
99 raise ValueError('Source and destination must be on the same filesystem: ' + str(source))
100 manifest = tree(source, deadline)
101 details.append({'source': str(source), 'destination': str(destination), 'device': source_info.st_dev,
102 'inode': source_info.st_ino, 'entries': len(manifest), 'tree': digest(manifest)})
103 with sqlite3.connect((manager.native / 'shares.db').as_uri() + '?mode=ro', uri=True) as database:
104 before = rows(database)
105 after = remapped(manager, before, moves)
106 return {'host': socket.gethostname(), 'service': manager.service, 'configRoot': str(manager.cfg), 'moves': details, 'shares': len(before['sh']), 'selections': len(before['sf']),
107 'affectedKeys': [old[0] for old, new in zip(before['sh'], after['sh']) if old != new],
108 'sharesBefore': digest(before), 'sharesAfter': digest(after),
109 'config': digest((manager.cfg / 'copyparty.conf').read_text()),
110 'manager': digest((manager.cfg / 'manager.json').read_text() if (manager.cfg / 'manager.json').exists() else None)}
111
112
113def write_database(database, data):
114 current = rows(database)
115 if current['sf'] != data['sf'] or len(current['sh']) != len(data['sh']) or any(
116 old[:2] + old[3:] != new[:2] + new[3:]
117 for old, new in zip(current['sh'], data['sh'])
118 ):
119 raise ValueError('Share keys, selections, passwords, or permissions changed during cutover.')
120 with database:
121 database.executemany('UPDATE sh SET vp=? WHERE k=?', [(row[2], row[0]) for row in data['sh']])
122 if rows(database) != data:
123 raise ValueError('Copyparty share paths changed while the database was being written.')
124
125
126def public_statuses(host, keys, deadline):
127 def head(key):
128 timeout = min(3, deadline - time.monotonic())
129 if timeout <= 0:
130 return key, None
131 try:
132 response = subprocess.run(
133 ['curl', '--disable', '--noproxy', '*', '--silent', '--show-error',
134 '--head', '--output', '/dev/null', '--write-out', '%{http_code}',
135 '--max-time', str(timeout), '--', 'https://' + host + '/shr/' + quote(key, safe='') + '/'],
136 capture_output=True, text=True, timeout=timeout,
137 )
138 status = response.stdout.strip()
139 return key, int(status) if response.returncode == 0 and re.fullmatch(r'[1-5][0-9]{2}', status) else None
140 except (OSError, subprocess.TimeoutExpired):
141 return key, None
142
143 with concurrent.futures.ThreadPoolExecutor(max_workers=4) as workers:
144 return dict(workers.map(head, keys))
145
146
147def wait_public(host, expected, deadline):
148 while time.monotonic() < deadline:
149 if public_statuses(host, expected, deadline) == expected:
150 return
151 time.sleep(min(0.5, max(0, deadline - time.monotonic())))
152 raise TimeoutError('Public share links did not recover before the cutover deadline.')
153
154
155def apply(manager, expected, backup_root):
156 if plan(manager) != expected:
157 raise ValueError('The cutover plan changed. Review a new plan before applying.')
158 if manager.job is None:
159 manager.job = copyparty.runs.nomad('job/' + manager.service)
160 host = (manager.job or {}).get('Meta', {}).get('studio_hostname', '')
161 if not isinstance(host, str) or not re.fullmatch(r'[a-zA-Z0-9.-]+', host):
162 raise ValueError('Copyparty has no public hostname. Check its deployed service route.')
163 manager.job['Stop'] = False
164 baseline = public_statuses(host, expected['affectedKeys'], time.monotonic() + 15)
165 if any(status is None for status in baseline.values()):
166 raise ValueError('Public shares are unavailable. Restore their current routes before cutover.')
167 backup_root.mkdir(parents=True, exist_ok=True, mode=0o700)
168 metadata = backup_root.lstat()
169 if not stat.S_ISDIR(metadata.st_mode) or metadata.st_uid != os.geteuid() or metadata.st_mode & 0o077:
170 raise ValueError('Cutover backups require an owner-only directory.')
171 backup = backup_root / (time.strftime('%Y%m%dT%H%M%SZ', time.gmtime()) + '-' + uuid.uuid4().hex[:8])
172 backup.mkdir(mode=0o700)
173 database_path = manager.native / 'shares.db'
174 saved_files = {}
175 for path in (manager.cfg / 'copyparty.conf', manager.cfg / 'manager.json'):
176 saved_files[path] = path.read_bytes() if path.exists() else None
177 if saved_files[path] is not None:
178 copyparty.atomic(backup / path.name, saved_files[path])
179 copyparty.atomic(backup / 'plan.json', json.dumps(expected, ensure_ascii=False).encode())
180 moved = []
181 before = None
182 database = None
183 manager.deadline = time.monotonic() + 285
184 mutation_deadline = manager.deadline - 205
185 restart_attempted = False
186 try:
187 manager.stop()
188 copyparty.atomic(backup / 'nomad-job.json', json.dumps(manager.job).encode())
189 if plan(manager, mutation_deadline) != expected:
190 raise ValueError('The source files or share rows changed before Copyparty stopped.')
191 database = sqlite3.connect(database_path)
192 before = rows(database)
193 with sqlite3.connect(backup / 'shares.db') as target:
194 database.backup(target)
195 (backup / 'shares.db').chmod(0o600)
196 after = remapped(manager, before, mappings(manager))
197 data_path = manager.cfg / 'manager.json'
198 data = json.loads(saved_files[data_path]) if saved_files[data_path] is not None else None
199 for source, destination in mappings(manager):
200 copyparty.rename(source, destination)
201 moved.append((source, destination))
202 write_database(database, after)
203 if data is not None:
204 for grant in data.get('grants', []):
205 original = Path(grant['path'])
206 for source, destination in mappings(manager):
207 if original.is_relative_to(source):
208 grant['path'] = str(destination / original.relative_to(source))
209 break
210 copyparty.atomic(data_path, json.dumps(data, ensure_ascii=False).encode())
211 variable = copyparty.runs.nomad('var/nomad/jobs/' + manager.service)
212 rendered = copyparty.configuration(manager.cfg, {**data, 'root': str(manager.root)}, variable['Items'])
213 info = (manager.cfg / 'copyparty.conf').stat()
214 copyparty.atomic(manager.cfg / 'copyparty.conf', rendered, (info.st_uid, info.st_gid))
215 for detail in expected['moves']:
216 destination = Path(detail['destination'])
217 if digest(tree(destination, mutation_deadline)) != detail['tree']:
218 raise ValueError('Moved folder metadata changed: ' + str(destination))
219 if digest(rows(database)) != expected['sharesAfter']:
220 raise ValueError('Share keys, selections, passwords, or permissions changed during cutover.')
221 if time.monotonic() >= mutation_deadline:
222 raise TimeoutError("Folder updates exceeded the cutover budget.")
223 restart_attempted = True
224 manager.start()
225 wait_public(host, baseline, manager.offline_at + 150)
226 result = {'result': 'moved', 'moves': len(moved), 'affectedKeys': expected['affectedKeys'], 'backup': str(backup),
227 'downtimeSeconds': time.monotonic() - manager.offline_at, 'publicStatuses': baseline}
228 copyparty.atomic(backup / 'result.json', json.dumps(result).encode())
229 return result
230 except BaseException as failure:
231 if moved or before is not None:
232 if restart_attempted:
233 manager.stop()
234 if database is None:
235 database = sqlite3.connect(database_path)
236 if before is not None:
237 write_database(database, before)
238 for source, destination in reversed(moved):
239 copyparty.rename(destination, source)
240 for path, content in saved_files.items():
241 if content is None:
242 path.unlink(missing_ok=True)
243 else:
244 owner = path.stat()
245 copyparty.atomic(path, content, (owner.st_uid, owner.st_gid))
246 if manager.job is not None:
247 manager.start()
248 wait_public(host, baseline, manager.deadline)
249 evidence = {'result': 'rolled-back', 'reason': str(failure), 'downtimeSeconds': time.monotonic() - manager.offline_at,
250 'publicStatuses': baseline}
251 copyparty.atomic(backup / 'result.json', json.dumps(evidence).encode())
252 raise
253 finally:
254 if database is not None:
255 database.close()
256
257
258def main():
259 parser = argparse.ArgumentParser(description='Review or apply the six Clover share-folder moves.')
260 parser.add_argument('--apply', action='store_true')
261 parser.add_argument('--plan', type=Path, help='Save the reviewed plan, or read it when applying.')
262 args = parser.parse_args()
263 manager = copyparty.Manager([])
264 if args.apply:
265 if args.plan is None:
266 parser.error('--apply requires --plan from the reviewed preflight')
267 lock = os.open(manager.cfg / '.manager.lock', os.O_WRONLY | os.O_CREAT | os.O_NOFOLLOW, 0o600)
268 with os.fdopen(lock, 'w') as locked:
269 copyparty.fcntl.flock(locked, copyparty.fcntl.LOCK_EX)
270 print(json.dumps(apply(manager, json.loads(args.plan.read_text()), Path('/var/lib/studio/copyparty-cutover'))))
271 else:
272 value = plan(manager)
273 if args.plan is not None:
274 copyparty.atomic(args.plan, json.dumps(value, ensure_ascii=False, indent=2).encode())
275 print(json.dumps(value, ensure_ascii=False))
276
277
278if __name__ == '__main__':
279 main()
tools/copyparty-test.py+2-2
......@@ -32,7 +32,7 @@ class Shares(unittest.TestCase):
3232 self.subject = str(uuid.uuid4())
3333 self.users = [{'id': self.subject, 'username': 'test-user', 'enabled': True, 'kind': None, 'requiredActions': []}]
3434 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)})
3636 self.environment.start()
3737 self.addCleanup(self.environment.stop)
3838 self.nomad = patch.object(shares.runs, 'nomad', side_effect=self.request)
......@@ -312,7 +312,7 @@ class Shares(unittest.TestCase):
312312 clone = self.root.parent / 'clover-clone'
313313 clone.mkdir()
314314 (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)}):
316316 state = self.call('state')
317317 self.assertEqual(state['grants'][0]['path'], str(clone / 'work'))
318318 self.assertEqual(state['links'][0]['path'], str(clone / 'source'))
tools/copyparty.md+13-89
......@@ -1,10 +1,9 @@
1# Copyparty administration and folder cutover
1# Copyparty administration
22
3Snowglobe's admin Shares page manages native public links and separate API
3Snow Globe's Shares page manages native public links and separate API
44accounts. A person's page assigns folder permissions. Existing Copyparty
55permissions remain additive; changing a folder is an explicit retarget or move
66action. New shared folders default to `Share/Name - Description` under Clover.
7The legacy `clover/Public` mount is retired; use managed links and grants.
87
98Copyparty owns its native `cfg/copyparty/shares.db` and selected-file records.
109`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
1312config file cannot recover managed accounts. `prepare.py` regenerates config
1413from the canonical service policy and managed state on every deployment.
1514
16## Six-folder production move
17
18`copyparty-cutover.py` contains the requested six source/destination pairs.
19It requires a reviewed plan, absent destinations, and same-filesystem renames.
20The plan binds the host, service, roots, source metadata, and complete native
21share projection. No file contents are read. Public HEAD responses are captured
22before stopping the service and verified after restart; existing keys,
23passwords, permissions, expirations, and selected-file records must agree.
24
25Run the script from the reviewed immutable release on the confirmed target:
26
27```sh
28umask 077
29python3 tools/copyparty-cutover.py --plan /root/copyparty-cutover-plan.json
30python3 tools/copyparty-cutover.py --apply --plan /root/copyparty-cutover-plan.json
31```
32
33Copyparty remains stopped through all folder and database changes. A mismatch
34restores the old paths and records before restarting the frozen original job.
35Mutation verification has an 80-second cutoff; public readiness has a
36150-second forward deadline, leaving recovery time within the 285-second
37overall budget. Restricted backups and result evidence live under
38`/var/lib/studio/copyparty-cutover`. Code rollback does not undo this file move.
39
40## 2026-10-16 staging evidence
41
42Zenith preview `copyparty-preview-9909de81` verified API account scope,
43permission changes, password/session revocation, signed UUID identity grants,
44symlink confinement, selected-file retention, and nested public links. A
45disposable offline move completed in 6.94 seconds. The six requested clone
46folders were then renamed with unchanged inode/metadata manifests: all 20
47share records and four selected-file rows matched the expected path-only
48projection, and all nine affected public URLs returned their original 200
49responses within a 78.2-second upper bound. Production source metadata and
50share records remained unchanged during rehearsal.
51
52## 2026-10-16 production evidence
53
54Release `765dec72842b4d08` deployed described main revision
55`e0cc66a00eb2757846148a241961225d1f9b1253`. All production routes passed
56the release workflow's checks. The canonical host unit now serves share
57operations; obsolete Win10/ARM host overrides were archived with the release
58backup after their effective VM code matched main byte for byte.
59
60The six requested folders moved to `Share` with their requested names.
61All 2,184 metadata entries retained their device, inode, mode, size, and mtime.
62All 20 native shares and four selected-file rows matched the path-only
63projection, and all nine affected public URLs returned their original 200
64responses. Meadow had no native public link; its folder moved without creating
65one. Copyparty remained stopped throughout the folder and database changes.
66
67The move's stop-to-public-readiness interval was 13.44 seconds. Independent
68one-second HTTPS HEAD sampling bounded total public unavailability across
69release activation and the move to 55.12 seconds over three intervals.
70Restricted plan, database/config backups, frozen job, and result evidence are
71in `/var/lib/studio/copyparty-cutover/20261016T082910Z-424b5410`.
72
73## 2026-10-16 account creation timeout
74
75The production host unit allowed only loopback traffic, but Podman's loopback
76port forwarding translates requests onto its bridge. A read-only health probe
77under the same IP restrictions timed out after 3.003 seconds; allowing the
78existing Podman subnet returned HTTP 200 in 0.0013 seconds. Account creation
79waited for config reload and its recovery reload before returning an error.
80The host allowlist now derives the bridge range from the declared Podman default
81subnet, preserving the existing network.
82
83The hardened preview created an account in 0.54 seconds and rotated its
84password in 0.60 seconds. Double-clicked submits sent one request each.
85Shares-list checks also caught absolute copy-status text expanding the document
86outside its scroller. Anchoring that hidden text and bounding the list during
87refresh errors kept the document at 720 × 320 in a 720 × 320 viewport, with
88only the table scrolling. Its headers and last-row keyboard actions stayed
89reachable; the hidden live status remained in the accessibility tree.
90
91Production account creation completed in 0.60 seconds, rotation in 0.47
92seconds, and deletion in 0.15 seconds under the effective host restrictions.
93The disposable account was removed; shares and grants remained unchanged.
94
95The first rollout, `a8982234e99ab23c`, also exported newer sibling Clover DB
96sources. That image failed before database startup because its nonroot user
97could not create its launcher cache. Clover DB was restored through the
98previous immutable release's service deployment. Its newer source also carries
99database migrations outside this change's scope. The build manifest now pins
100sitegen revision `13f64d71038f5e72ab34dc1f55805e2fee05f368`; all 183 exported
101files, file types, and executable bits match the previous healthy context.
15A folder move must update the native share paths and selected-file records
16while Copyparty is stopped, preserving keys, passwords, permissions, expirations,
17and selected files. Code rollback does not undo filesystem moves. Rehearse on
18clones, retain restricted database/config backups, and verify the original
19public links after restart. The completed six-folder move's recovery evidence
20remains at `/var/lib/snowglobe/copyparty-cutover/20261016T082910Z-424b5410`.
21
22The privileged host unit reaches Copyparty through Podman's declared bridge
23subnet. A loopback-only network allowlist prevents configuration reloads even
24when its destination is a loopback-forwarded container port. Keep the derived
25bridge access when changing host restrictions.
tools/dashboard-auth-test.py+5-5
......@@ -62,9 +62,9 @@ def main():
6262 proof = uuid.uuid4().hex + uuid.uuid4().hex
6363 (data / 'proof').write_text(proof)
6464 (data / 'source.json').write_text(json.dumps(export))
65 environment = {**os.environ, 'STUDIO_DOMAIN': 'paperclover.net', 'STUDIO_DATA_DIR': str(data),
66 'STUDIO_PUBLIC_ORIGIN': origin, 'STUDIO_AUTH_RP_ID': rp, 'STUDIO_FILE_ORIGIN': file,
67 'STUDIO_WEB_DIR': str(Path('dashboard/dist').resolve()), 'STUDIO_PROXY_TOKEN_FILE': str(data / 'proof'), 'STUDIO_AUTH_REQUIRED': '1'}
65 environment = {**os.environ, 'SNOWGLOBE_DOMAIN': 'paperclover.net', 'SNOWGLOBE_DATA_DIR': str(data),
66 'SNOWGLOBE_PUBLIC_ORIGIN': origin, 'SNOWGLOBE_AUTH_RP_ID': rp, 'SNOWGLOBE_FILE_ORIGIN': file,
67 'SNOWGLOBE_WEB_DIR': str(Path('dashboard/dist').resolve()), 'SNOWGLOBE_PROXY_TOKEN_FILE': str(data / 'proof'), 'SNOWGLOBE_AUTH_REQUIRED': '1'}
6868 binary = str(args.binary.resolve())
6969 imported = subprocess.run([binary, '--import-accounts', str(data / 'source.json')], env=environment, capture_output=True, text=True)
7070 assert imported.returncode == 0, imported.stderr
......@@ -97,7 +97,7 @@ def main():
9797 server.terminate(); server.wait(timeout=10)
9898
9999 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'}
101101 if body is not None: headers.update({'Origin': origin, 'Content-Type': 'application/json'})
102102 if cookies: headers['Cookie'] = '; '.join(f'{k}={v}' for k, v in cookies.items())
103103 headers.update(extra or {})
......@@ -120,7 +120,7 @@ def main():
120120 request('/api/account/pictures/missing', status=404)
121121 request('/api/me', status=401, extra={'User-Name': name, 'User-Groups': 'infra-admin'})
122122 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'})
124124 csrf = request('/auth/status', cookies=cookies)['csrf']
125125 csrf_headers = request('/auth/status', cookies=cookies, include_headers=True)
126126 assert csrf_headers['set-cookie'].startswith('__Host-snow-csrf=')
tools/dashboard-backup-test.py+6-3
......@@ -33,11 +33,14 @@ def main():
3333 assert db.execute('SELECT value FROM durable').fetchall() == [(name,)]
3434 revision = 'a' * 16
3535 (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
3740 lifecycle = []
3841 def run(*args, **kwargs):
3942 lifecycle.append(args)
40 if args == ('systemctl', 'stop', 'studio-dashboard'):
43 if args == ('systemctl', 'stop', 'snowglobe-dashboard'):
4144 for db in connections:
4245 db.close()
4346 data.run = run
......@@ -47,7 +50,7 @@ def main():
4750 db.commit()
4851 (live / 'pictures' / 'avatar').write_bytes(b'later picture')
4952 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')]
5154 assert (live / 'pictures' / 'avatar').read_bytes() == b'original picture'
5255 for name in ['accounts.sqlite', 'connections.sqlite']:
5356 with sqlite3.connect(live / name) as db:
tools/dashboard-bench.py+1-1
......@@ -12,7 +12,7 @@ parser = argparse.ArgumentParser(description=__doc__)
1212parser.add_argument("--clients", type=int, default=24)
1313parser.add_argument("--rounds", type=int, default=20)
1414parser.add_argument("--port", type=int, default=7072)
15parser.add_argument("--unit", default="studio-dashboard.service")
15parser.add_argument("--unit", default="snowglobe-dashboard.service")
1616parser.add_argument("--include-files", action="store_true")
1717args = parser.parse_args()
1818if args.clients < 1 or args.rounds < 1:
tools/dashboard-browser-test.py+6-6
......@@ -23,7 +23,7 @@ def main():
2323 original = routes.read_bytes()
2424 metadata = routes.stat()
2525 candidate = router.render(Path(router.TOKEN).read_text().strip())
26 start = "globe." + os.environ["STUDIO_DOMAIN"] + " {"
26 start = "globe." + os.environ["SNOWGLOBE_DOMAIN"] + " {"
2727 begin = original.index(start.encode())
2828 depth = 0
2929 end = None
......@@ -33,9 +33,9 @@ def main():
3333 end = position + 1
3434 break
3535 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()
3737 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
3939 pending = routes.with_name("routes.browser-test.pending")
4040
4141 def install(value):
......@@ -47,9 +47,9 @@ def main():
4747
4848 try:
4949 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)
5151 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")
5353 args.ready_file.chmod(0o600)
5454 deadline = time.monotonic() + args.timeout
5555 while not stop.exists() and time.monotonic() < deadline:
......@@ -60,7 +60,7 @@ def main():
6060 assert hashlib.sha256(routes.read_bytes()).digest() == hashlib.sha256(original).digest()
6161 finally:
6262 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)
6464 pending.unlink(missing_ok=True)
6565 args.ready_file.unlink(missing_ok=True)
6666 stop.unlink(missing_ok=True)
tools/dashboard-deploy-test.py+15-15
......@@ -18,7 +18,7 @@ host = importlib.import_module("dashboard-host")
1818
1919class DeploymentBoundary(unittest.TestCase):
2020 def setUp(self):
21 self.temporary = tempfile.TemporaryDirectory(prefix="studio-deploy-boundary-")
21 self.temporary = tempfile.TemporaryDirectory(prefix="snowglobe-deploy-boundary-")
2222 self.addCleanup(self.temporary.cleanup)
2323 self.root = Path(self.temporary.name).resolve()
2424 self.state = self.root / "state"
......@@ -31,7 +31,7 @@ class DeploymentBoundary(unittest.TestCase):
3131 context = patch.object(release, name, value)
3232 context.start()
3333 self.addCleanup(context.stop)
34 self.host = host.Host("studio-demo")
34 self.host = host.Host("snowglobe-demo")
3535 state_context = patch.object(runs, "HOST_STATE", self.state / "host")
3636 state_context.start()
3737 self.addCleanup(state_context.stop)
......@@ -44,8 +44,8 @@ class DeploymentBoundary(unittest.TestCase):
4444 path.write_text("fixture")
4545 else:
4646 path.mkdir()
47 (self.snapshot / "tools/studio.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"}}))
47 (self.snapshot / "tools/snowglobe.py").write_text("print('fixture')")
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"}}))
4949 (self.state / "stages").mkdir()
5050 self.stage = "fixture-preview"
5151 self.stage_file = self.state / "stages" / (self.stage + ".json")
......@@ -76,13 +76,13 @@ class DeploymentBoundary(unittest.TestCase):
7676 executed.assert_not_called()
7777
7878 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])
8080 self.assertEqual(runs.command("deploy", self.version)[1:], [str(Path(runs.__file__).with_name("release.py")), "deploy", self.version])
8181 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"])
8383 self.assertEqual(runs.command("stop", "fixture"), ["nomad", "job", "stop", "-yes", "fixture"])
8484 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")
8686 for action, target in [("destroy", self.stage), ("deploy", self.version), ("rollback", "1"), ("start", "fixture")]:
8787 with self.subTest(action=action), self.assertRaisesRegex(ValueError, "contents changed"):
8888 runs.command(action, target)
......@@ -91,11 +91,11 @@ class DeploymentBoundary(unittest.TestCase):
9191 with patch.object(release, "SOURCES", tuple(name for name in release.SOURCES if name != "guest")):
9292 digest = release.tree_digest(self.snapshot)
9393 shutil.rmtree(self.snapshot / "guest")
94 manifest = self.snapshot / ".studio-release.json"
94 manifest = self.snapshot / ".snowglobe-release.json"
9595 details = json.loads(manifest.read_text())
9696 details["digest"] = digest
9797 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])
9999 shutil.rmtree(self.snapshot / "tools")
100100 with self.assertRaisesRegex(ValueError, "contents changed"):
101101 runs.command("destroy", self.stage)
......@@ -137,7 +137,7 @@ class DeploymentBoundary(unittest.TestCase):
137137 with self.assertRaisesRegex(ValueError, "main changed"):
138138 release.main()
139139 activate.assert_not_called()
140 manifest = self.snapshot / ".studio-release.json"
140 manifest = self.snapshot / ".snowglobe-release.json"
141141 original = json.loads(manifest.read_text())
142142 for revision in [None, {"commit": "b" * 40, "description": " "}, {"commit": "escape", "description": "main"}]:
143143 manifest.write_text(json.dumps({**original, "main": revision}))
......@@ -169,7 +169,7 @@ class DeploymentBoundary(unittest.TestCase):
169169 output = 'job "fixture" {\n' if argv[-1] == "render" else '"leader"'
170170 return subprocess.CompletedProcess(argv, 0, stdout=output, stderr="")
171171
172 with patch.object(release.subprocess, "run", side_effect=execute):
172 with patch.object(release.subprocess, "run", side_effect=execute), patch.object(release, "host_configuration", return_value="snowglobe"), patch.object(release.transition, "activate"):
173173 self.assertIsNone(release.activate(self.version, initial=True))
174174 self.assertEqual(release.current_release(), self.version)
175175
......@@ -205,7 +205,7 @@ class DeploymentBoundary(unittest.TestCase):
205205 root = runs.HOST_STATE
206206 (root / "runs").mkdir(exist_ok=True)
207207 (root / "runs" / (started["id"] + ".log")).write_text("fixture\n")
208 restored = host.Host("studio-demo")
208 restored = host.Host("snowglobe-demo")
209209 active = subprocess.CompletedProcess([], 0, stdout="ActiveState=active\nExecMainStatus=0\nLoadState=loaded\n")
210210 with patch.object(runs.subprocess, "run", return_value=active):
211211 self.assertEqual(restored.handle({"operation": "deploy.last"}), {**started, "code": None})
......@@ -249,7 +249,7 @@ class DeploymentBoundary(unittest.TestCase):
249249
250250 def test_secret_scope_and_compare_and_set_preserve_siblings(self):
251251 (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}])}}
253253 existing = {"ModifyIndex": 7, "Items": {"token": "old", "sibling": "keep", "undeclared": "private"}}
254254 with patch.object(runs, "nomad", side_effect=[job, existing]) as requested:
255255 self.assertEqual(runs.secret("get", "fixture", "token"), "old")
......@@ -266,11 +266,11 @@ class DeploymentBoundary(unittest.TestCase):
266266 def test_rotations_use_the_recorded_size_and_refuse_external_secrets(self):
267267 (self.state / "nomad.token").write_text("private-fixture-token")
268268 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}])}}
270270 with patch.object(runs, "nomad", side_effect=[job, None]) as requested, self.assertRaises(runs.Error):
271271 runs.secret("rotate", "fixture", "token")
272272 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}]'}}
274274 with patch.object(runs, "nomad", side_effect=[job, None, {}]) as requested, patch.object(runs.subprocess, "run", return_value=subprocess.CompletedProcess([], 0)):
275275 runs.secret("rotate", "fixture", "token")
276276 value = requested.call_args.args[2]["Items"]["token"]
tools/dashboard-deploy-vm-test.py+12-12
......@@ -29,7 +29,7 @@ def main():
2929 service_id = "boundary-service-" + suffix
3030 managed_file = release.STATE / "managed-jobs.json"
3131 managed_bytes = managed_file.read_bytes()
32 container = "studio-dashboard-deploy-test-" + suffix
32 container = "snowglobe-dashboard-deploy-test-" + suffix
3333 current = release.current_release()
3434 history_bytes = release.HISTORY.read_bytes()
3535 stages_before = {path.name for path in (release.STATE / "stages").glob("*.json")}
......@@ -55,7 +55,7 @@ def main():
5555 def http(path, body=None, status=200, section="deploys", groups="infra-admin", method=None):
5656 request = urllib.request.Request("http://127.0.0.1:7076/api/" + section + path,
5757 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"})
5959 try:
6060 response = urllib.request.urlopen(request, timeout=40)
6161 except urllib.error.HTTPError as error:
......@@ -95,7 +95,7 @@ def main():
9595 time.sleep(.1)
9696 raise AssertionError("container deployment view did not start")
9797
98 with tempfile.TemporaryDirectory(prefix="studio-deploy-boundary-", dir="/run") as temporary:
98 with tempfile.TemporaryDirectory(prefix="snowglobe-deploy-boundary-", dir="/run") as temporary:
9999 data = Path(temporary) / "data"
100100 data.mkdir()
101101 os.chown(data, 65534, 65534)
......@@ -139,24 +139,24 @@ def main():
139139 path.write_text("fixture")
140140 else:
141141 path.mkdir()
142 script = fixture_release / "tools/studio.py"
142 script = fixture_release / "tools/snowglobe.py"
143143 script.write_text("import time\ntime.sleep(3)\nprint('approved fixture worker')\n")
144144 digest = release.tree_digest(fixture_release)
145145 destination = release.RELEASES / digest[:16]
146146 assert not destination.exists()
147147 fixture_release.rename(destination)
148148 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}))
150150 value = json.loads(stage_file.read_text())
151151 stage_file.write_text(json.dumps({**value, "release": digest[:16]}))
152152 active = call("deploy.start", action="destroy", target=stage_id)
153153 owned_runs.append(active["id"])
154154 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")
156156 assert call("deploy.last")["id"] == active["id"]
157157 result = done(active["id"])
158158 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')")
160160 call("deploy.start", action="destroy", target=stage_id, status=502)
161161 assert call("deploy.last")["id"] == active["id"]
162162 stage_file.write_text(json.dumps(value))
......@@ -166,9 +166,9 @@ def main():
166166 shell("podman", "run", "-d", "--name=" + container, "--pull=never", "--user=65534:65534",
167167 "--read-only", "--cap-drop=all", "--security-opt=no-new-privileges", "--pids-limit=128",
168168 "--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",
170170 "--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)
172172 overview = ready()
173173 assert overview["current"] == current and overview["recorded"]
174174 assert len(overview["history"]) == len(json.loads(history_bytes))
......@@ -187,7 +187,7 @@ def main():
187187 managed_file.write_text(json.dumps([*json.loads(managed_bytes), service_id]))
188188 service_created = True
189189 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}])},
191191 "TaskGroups": [{"Name": "fixture", "Count": 1, "Tasks": [{"Name": "idle", "Driver": "podman",
192192 "Config": {"image": "docker.io/library/alpine:3.22", "command": "/bin/sleep", "args": ["600"]},
193193 "Resources": {"CPU": 25, "MemoryMB": 32}}]}]}})
......@@ -219,7 +219,7 @@ def main():
219219 assert secret_value not in "\n".join(call("deploy.run", id=saved["id"])["lines"])
220220 assert http(prefix + "fixture", section="services")["value"] == secret_value
221221 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"))
223223 http(prefix + "fixture/rotate", {}, status=204, section="services")
224224 saved = call("deploy.last")
225225 owned_runs.append(saved["id"])
......@@ -284,7 +284,7 @@ def main():
284284 finally:
285285 subprocess.run(["podman", "rm", "--force", container], capture_output=True)
286286 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)
288288 if service_created:
289289 nomad("job/" + service_id + "?purge=true", method="DELETE")
290290 nomad("var/nomad/jobs/" + service_id, method="DELETE")
tools/dashboard-file-boundary-test.py+10-10
......@@ -18,7 +18,7 @@ import uuid
1818def main():
1919 parser = argparse.ArgumentParser()
2020 parser.add_argument("socket", type=Path)
21 parser.add_argument("--pool", default="studio-demo")
21 parser.add_argument("--pool", default="snowglobe-demo")
2222 parser.add_argument("--image", required=True)
2323 parser.add_argument("--output", type=Path)
2424 args = parser.parse_args()
......@@ -27,7 +27,7 @@ def main():
2727 dataset = args.pool + "/files-boundary-test-" + suffix
2828 mount = Path("/srv/.files-boundary-test-" + suffix)
2929 private = Path("/srv/.files-private-test-" + suffix)
30 container = "studio-dashboard-files-test-" + suffix
30 container = "snowglobe-dashboard-files-test-" + suffix
3131
3232 def run(*argv):
3333 return subprocess.run(argv, check=True, capture_output=True, text=True).stdout
......@@ -35,7 +35,7 @@ def main():
3535 def call(path, body=None, status=200):
3636 req = urllib.request.Request("http://127.0.0.1:7075" + path,
3737 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"})
3939 try:
4040 response = urllib.request.urlopen(req, timeout=30)
4141 except urllib.error.HTTPError as error:
......@@ -75,7 +75,7 @@ def main():
7575 time.sleep(.1)
7676 raise AssertionError((tree, meta))
7777
78 with tempfile.TemporaryDirectory(prefix="studio-file-boundary-", dir="/run") as temporary:
78 with tempfile.TemporaryDirectory(prefix="snowglobe-file-boundary-", dir="/run") as temporary:
7979 os.chown(temporary, 65534, 65534)
8080 data = Path(temporary) / "data"
8181 data.mkdir()
......@@ -98,17 +98,17 @@ def main():
9898 launch = ["podman", "run", "-d", "--name=" + container, "--pull=never", "--user=65534:65534",
9999 "--read-only", "--cap-drop=all", "--security-opt=no-new-privileges", "--pids-limit=128",
100100 "--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",
102102 "--volume=" + str(proxy_token) + ":/run/secrets/dashboard-proxy.token:ro",
103103 "--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"]
105105 run(*launch,
106106 "--mount=type=bind,src=" + str(mount) + ",dst=" + str(mount) + ",bind-nonrecursive,bind-propagation=rslave",
107107 "--mount=type=bind,src=" + str(mount / "media") + ",dst=" + str(mount / "media") + ",bind-nonrecursive,bind-propagation=rslave",
108108 "--mount=type=bind,src=" + str(mount / "docs") + ",dst=" + str(mount / "docs") + ",bind-nonrecursive,bind-propagation=rslave",
109 "--env=STUDIO_STORE_ROOT=" + str(mount),
110 "--env=STUDIO_MEDIA_ROOT=" + str(mount / "media"),
111 "--env=STUDIO_INDEX_POOL=" + dataset, "--env=STUDIO_INDEX_DIR=/data/index", args.image)
109 "--env=SNOWGLOBE_STORE_ROOT=" + str(mount),
110 "--env=SNOWGLOBE_MEDIA_ROOT=" + str(mount / "media"),
111 "--env=SNOWGLOBE_INDEX_POOL=" + dataset, "--env=SNOWGLOBE_INDEX_DIR=/data/index", args.image)
112112 ready()
113113 baseline_size = len("media fixture") + len("document fixture")
114114 baseline = indexed(baseline_size, 2)
......@@ -242,7 +242,7 @@ def main():
242242 (partial / "fixture").write_text("partial mount fixture")
243243 os.chown(partial / "fixture", 65534, 65534)
244244 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)
246246 ready()
247247 call("/api/storage/files/delete", {"paths": ["data/fixture"]}, 409)
248248 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
44from pathlib import Path
55parser=argparse.ArgumentParser(description=__doc__)
66parser.add_argument('binary')
7parser.add_argument('--pool',default='studio-demo')
7parser.add_argument('--pool',default='snowglobe-demo')
88args=parser.parse_args()
99run=lambda *argv:subprocess.run(argv,check=True,capture_output=True,text=True)
1010dataset=args.pool+'/dashboard-test-'+uuid.uuid4().hex[:8]
11unit='studio-dashboard-files-test'
12with tempfile.TemporaryDirectory(prefix='studio-files-test-') as temporary:
11unit='snowglobe-dashboard-files-test'
12with tempfile.TemporaryDirectory(prefix='snowglobe-files-test-') as temporary:
1313 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))
15 for key in ['STUDIO_INDEX_POOL','STUDIO_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')
17 proof={'Studio-Proxy-Token':Path(variables['STUDIO_PROXY_TOKEN_FILE']).read_text().strip()} if 'STUDIO_PROXY_TOKEN_FILE' in variables else {}
14 variables=dict(v.split('=',1) for v in shlex.split(run('systemctl','show','-P','Environment','snowglobe-dashboard').stdout))
15 for key in ['SNOWGLOBE_INDEX_POOL','SNOWGLOBE_YT_STATE']:variables.pop(key,None)
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={'Snowglobe-Proxy-Token':Path(variables['SNOWGLOBE_PROXY_TOKEN_FILE']).read_text().strip()} if 'SNOWGLOBE_PROXY_TOKEN_FILE' in variables else {}
1818 def start():
1919 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()))
2020 deadline=time.monotonic()+120
......@@ -75,7 +75,7 @@ with tempfile.TemporaryDirectory(prefix='studio-files-test-') as temporary:
7575 call('/api/media/ops/'+op['id']+'/undo',{},409);assert (media/'new/extra').exists()
7676 (media/'new/extra').unlink();undo(op)
7777 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()
7979 call('/api/media/folder',{'path':'','name':'denied'},501);assert not (media/'denied').exists()
8080 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')
8181 finally:
tools/dashboard-host-test.py+22-22
......@@ -19,7 +19,7 @@ spec.loader.exec_module(host_module)
1919
2020class Boundary(unittest.TestCase):
2121 def setUp(self):
22 self.host = host_module.Host("studio-demo")
22 self.host = host_module.Host("snowglobe-demo")
2323
2424 @unittest.skipUnless(sys.platform == "linux", "Linux Unix peer credentials")
2525 def test_large_json_header_preserves_stream_bytes_and_enforces_limit(self):
......@@ -62,15 +62,15 @@ class Boundary(unittest.TestCase):
6262 {"operation": "storage.datasets", "env": {"PATH": "/tmp"}},
6363 {"operation": "host.sample", "path": "/root/private"},
6464 {"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"},
6666 {"operation": "storage.snapshots"}]
6767 for refresh in [None, [], {}, 0, 1, "true"]:
6868 requests.append({"operation": "host.usage", "refresh": refresh})
69 for dataset in [None, [], "other", "studio-demo-other", "studio-demo/../other",
70 "studio-demo//child", "studio-demo/child\nother", "-r", "studio-demo/a@snap"]:
69 for dataset in [None, [], "other", "snowglobe-demo-other", "snowglobe-demo/../other",
70 "snowglobe-demo//child", "snowglobe-demo/child\nother", "-r", "snowglobe-demo/a@snap"]:
7171 requests.append({"operation": "storage.snapshots", "dataset": dataset})
7272 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",
7474 "from": snapshot, "to": "safe"})
7575 with patch.object(host_module, "command") as command:
7676 for request in requests:
......@@ -94,32 +94,32 @@ class Boundary(unittest.TestCase):
9494
9595 def test_reclaim_is_always_a_dry_run(self):
9696 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",
9898 "from": "snapshot one", "to": "snapshot two"})
9999 command.assert_called_once_with("zfs", "destroy", "-nvp",
100 "studio-demo/a@snapshot one%snapshot two")
100 "snowglobe-demo/a@snapshot one%snapshot two")
101101
102102 def test_mounts_exclude_other_pools(self):
103103 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"]]}
105105 with patch.object(host_module, "command", return_value=json.dumps(mounts)):
106106 self.assertEqual([m["source"] for m in self.host.handle({"operation": "storage.mounts"})["filesystems"]],
107 ["studio-demo", "studio-demo/a"])
107 ["snowglobe-demo", "snowglobe-demo/a"])
108108
109109 def test_snapshot_arguments_cannot_be_options(self):
110110 with patch.object(host_module, "command", return_value="") as command:
111 self.host.handle({"operation": "storage.removed", "dataset": "studio-demo/a", "snapshot": "snapshot -r"})
112 command.assert_called_once_with("zfs", "diff", "-H", "studio-demo/a@snapshot -r", "studio-demo/a")
111 self.host.handle({"operation": "storage.removed", "dataset": "snowglobe-demo/a", "snapshot": "snapshot -r"})
112 command.assert_called_once_with("zfs", "diff", "-H", "snowglobe-demo/a@snapshot -r", "snowglobe-demo/a")
113113
114114 def test_snapshot_mutations_are_scoped(self):
115115 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"]]:
117117 requests.append({"operation": "files.snapshot", "datasets": datasets})
118118 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})
120120 for value in ["before%after", "-r", "before,after", "before@after"]:
121 requests.append({"operation": "storage.destroy", "dataset": "studio-demo/a", "from": value, "to": "after"})
122 requests.append({"operation": "files.snapshot", "datasets": ["studio-demo/a"], "recursive": True})
121 requests.append({"operation": "storage.destroy", "dataset": "snowglobe-demo/a", "from": value, "to": "after"})
122 requests.append({"operation": "files.snapshot", "datasets": ["snowglobe-demo/a"], "recursive": True})
123123 with patch.object(host_module, "command") as command:
124124 for request in requests:
125125 with self.subTest(request=request), self.assertRaises(host_module.Rejected):
......@@ -128,14 +128,14 @@ class Boundary(unittest.TestCase):
128128
129129 def test_file_snapshots_use_only_the_undo_namespace(self):
130130 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"]})
132132 self.assertEqual(name, "dash-123")
133 command.assert_called_once_with("zfs", "snapshot", "studio-demo/a@dash-123", "studio-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"):
135 self.assertEqual(self.host.handle({"operation": "files.snapshots", "datasets": ["studio-demo/a"]}), ["studio-demo/a@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="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": ["snowglobe-demo/a"]}), ["snowglobe-demo/a@dash-123"])
136136 with patch.object(host_module, "command", return_value="") as command:
137 self.host.handle({"operation": "files.discard", "dataset": "studio-demo/a", "snapshot": "dash-123"})
138 command.assert_called_once_with("zfs", "destroy", "studio-demo/a@dash-123")
137 self.host.handle({"operation": "files.discard", "dataset": "snowglobe-demo/a", "snapshot": "dash-123"})
138 command.assert_called_once_with("zfs", "destroy", "snowglobe-demo/a@dash-123")
139139
140140 def test_child_output_is_bounded(self):
141141 with patch.object(host_module, "MAX_RESPONSE", 4096):
......@@ -143,7 +143,7 @@ class Boundary(unittest.TestCase):
143143 host_module.command(sys.executable, "-c", "import os; os.write(2, b'x' * 1000000)")
144144
145145 def test_index_operations_preserve_other_snapshots(self):
146 dataset = "studio-demo/a"
146 dataset = "snowglobe-demo/a"
147147 with patch.object(host_module, "command") as command:
148148 for name in ["manual", "dash-123", "index-fixture", "index-123%manual", "index-../escape"]:
149149 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):
3535def main():
3636 parser = argparse.ArgumentParser()
3737 parser.add_argument("socket")
38 parser.add_argument("--pool", default="studio-demo")
38 parser.add_argument("--pool", default="snowglobe-demo")
3939 parser.add_argument("--user", default="nobody")
4040 parser.add_argument("--client", action="store_true")
4141 args = parser.parse_args()
tools/dashboard-host.py+9-4
......@@ -430,7 +430,7 @@ def stream_upload(connection, request):
430430 Path(temporary).unlink(missing_ok=True)
431431
432432
433def serve_connection(connection, host, allowed_uid):
433def serve_connection(connection, host, allowed_uid, allowed_operations=None):
434434 with connection:
435435 connection.settimeout(65)
436436 _, uid, _ = struct.unpack("3i", connection.getsockopt(socket.SOL_SOCKET, socket.SO_PEERCRED, 12))
......@@ -451,6 +451,11 @@ def serve_connection(connection, host, allowed_uid):
451451 if len(line) > MAX_REQUEST or not line.endswith(b"\n"):
452452 raise Rejected("The host request is too large or incomplete.")
453453 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.")
454459 if isinstance(request, dict) and request.get("operation") in {"vm.console", "vm.serial", "vm.guest", "vm.upload"}:
455460 streams = GUEST_SLOTS if request["operation"] == "vm.guest" else STREAM_SLOTS
456461 if not streams.acquire(blocking=False):
......@@ -484,9 +489,9 @@ def serve_connection(connection, host, allowed_uid):
484489
485490
486491def main():
487 host = Host(os.environ["STUDIO_POOL"])
488 allowed_uid = pwd.getpwnam(os.environ["STUDIO_DASHBOARD_USER"]).pw_uid
489 socket_path = Path(os.environ.get("STUDIO_HOST_SOCKET", "/run/studio-host/host.sock"))
492 host = Host(os.environ["SNOWGLOBE_POOL"])
493 allowed_uid = pwd.getpwnam(os.environ["SNOWGLOBE_DASHBOARD_USER"]).pw_uid
494 socket_path = Path(os.environ.get("SNOWGLOBE_HOST_SOCKET", "/run/snowglobe-host/host.sock"))
490495 socket_path.unlink(missing_ok=True)
491496 with socket.socket(socket.AF_UNIX, socket.SOCK_STREAM) as listener:
492497 listener.bind(str(socket_path))
tools/dashboard-iam-test.py deleted-156
......@@ -1,156 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import importlib
4import json
5from pathlib import Path
6import subprocess
7import sys
8import time
9import urllib.error
10import urllib.parse
11import urllib.request
12import uuid
13
14
15def main():
16 parser = argparse.ArgumentParser()
17 parser.add_argument("--url", required=True)
18 parser.add_argument("--socket", required=True)
19 parser.add_argument("--proof-file", type=Path, required=True)
20 parser.add_argument("--user", default="studio-dashboard")
21 parser.add_argument("--output", type=Path)
22 args = parser.parse_args()
23 if args.output:
24 args.output.unlink(missing_ok=True)
25 sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "service/keycloak"))
26 from api import Keycloak
27 keycloak = Keycloak("keycloak.studio.test", importlib.import_module("dashboard-run").secret("get", "keycloak", "password"), attempts=1)
28 keycloak.configure_profile()
29 name = "iam-fixture-" + uuid.uuid4().hex
30 password = uuid.uuid4().hex + "A1!"
31 identity = None
32 proof = args.proof_file.read_text().strip()
33 admin = keycloak.request("/admin/realms/master/users?username=admin&exact=true")[0]
34 admin = keycloak.request("/admin/realms/master/users/" + admin["id"])
35 admin_roles = keycloak.request("/admin/realms/master/users/" + admin["id"] + "/role-mappings/realm")
36 server_role = next(role for role in admin_roles if role["name"] == "admin")
37
38 def http(path, method="GET", body=None, status=200, actor="fixture-operator", groups="infra-admin"):
39 request = urllib.request.Request(args.url + "/api/" + path, method=method,
40 data=json.dumps(body).encode() if body is not None else None,
41 headers={"User-Name": actor, "User-Groups": groups, "Studio-Proxy-Token": proof, "Content-Type": "application/json"})
42 try:
43 response = urllib.request.urlopen(request, timeout=70)
44 except urllib.error.HTTPError as error:
45 response = error
46 with response:
47 content = response.read()
48 assert response.status == status, (path, response.status, content[:200])
49 return json.loads(content) if content and response.headers.get("Content-Type", "").startswith("application/json") else None
50
51 def broker(path=None, method="GET", body=None, status=200, **fields):
52 payload = {"operation": "iam.request", "path": path, "method": method, "body": body} if path is not None else fields
53 process = subprocess.run([sys.executable, str(Path(__file__).with_name("dashboard-host-vm-test.py")), args.socket,
54 "--client", "--user", args.user], input=json.dumps(payload).encode() + b"\n", capture_output=True, timeout=75)
55 assert process.returncode == 0, "broker client failed"
56 result = json.loads(process.stdout)
57 if status != 200:
58 assert result.get("status") == status, (path, result)
59 return None
60 assert "value" in result, (path, result)
61 return result["value"]
62
63 def sign_in(secret):
64 body = urllib.parse.urlencode({"client_id": "admin-cli", "grant_type": "password", "username": name, "password": secret}).encode()
65 return keycloak.request("/realms/master/protocol/openid-connect/token", "POST", body)
66
67 try:
68 started = time.monotonic()
69 directory = http("users")
70 directory_seconds = time.monotonic() - started
71 assert all(user["username"] != "admin" for user in directory["users"])
72 roles = {role["name"]: role for role in directory["groups"]}
73 assert set(roles) == {"infra-admin", "media", "media-manage"}
74 http("users", status=403, groups="media")
75 created = http("users", "POST", {"profile": {"username": name, "email": name + "@fixture.invalid", "firstName": "Native", "lastName": "Fixture"},
76 "groups": [roles["media"]["id"]], "setup": {"kind": "password", "password": password}}, status=201)
77 identity = created["id"]
78 path = "users/" + identity
79 assert keycloak.request("/admin/realms/master/" + path)["username"] == name
80 http(path, "PATCH", {"requiredActions": [], "emailVerified": True, "firstName": "Verified"}, status=204)
81 http(path + "/password", "PUT", {"password": password, "temporary": False}, status=204)
82 tokens = sign_in(password)
83 assert tokens["access_token"]
84 http(path + "/credentials")
85 http(path + "/groups/" + roles["infra-admin"]["id"], "PUT", status=204)
86 http(path + "/groups/" + roles["infra-admin"]["id"], "DELETE", status=400, actor=name)
87 http(path + "/groups/" + roles["infra-admin"]["id"], "DELETE", status=204)
88 mapped = {role["name"] for role in keycloak.request("/admin/realms/master/" + path + "/role-mappings/realm")}
89 assert mapped & {"infra-admin", "media", "media-manage", "admin"} == {"media"}
90 http("account", "PATCH", {"firstName": "Account"}, status=204, actor=name, groups="media")
91 assert http("account", actor=name, groups="media")["firstName"] == "Account"
92 broker("/" + path, "PUT", {"attributes": {"picture": ["https://fixture.invalid/picture"]}})
93 profile = keycloak.request("/admin/realms/master/" + path)
94 assert profile["attributes"]["picture"] == ["https://fixture.invalid/picture"]
95 assert profile["firstName"] == "Account" and profile["email"] == name + "@fixture.invalid"
96 broker("/" + path, "PUT", {"attributes": {"picture": None}})
97 profile = keycloak.request("/admin/realms/master/" + path)
98 assert "picture" not in profile.get("attributes", {})
99 assert profile["firstName"] == "Account" and profile["email"] == name + "@fixture.invalid"
100 http(path + "/logout", "POST", status=204)
101 try:
102 keycloak.request("/realms/master/protocol/openid-connect/token", "POST", urllib.parse.urlencode({
103 "client_id": "admin-cli", "grant_type": "refresh_token", "refresh_token": tokens["refresh_token"]}).encode())
104 except urllib.error.HTTPError as error:
105 assert error.code == 400
106 else:
107 raise AssertionError("logged-out refresh token remained usable")
108 changed = uuid.uuid4().hex + "A1!"
109 http(path + "/password", "PUT", {"password": changed, "temporary": False}, status=204)
110 assert sign_in(changed)["access_token"]
111 http(path, "PATCH", {"enabled": False}, status=204)
112 try:
113 sign_in(changed)
114 except urllib.error.HTTPError as error:
115 assert error.code == 400
116 else:
117 raise AssertionError("disabled fixture signed in")
118 http(path, "PATCH", {"enabled": True}, status=204)
119 for operation in ["get", "set", "rotate"]:
120 fields = {"operation": "deploy.secret." + operation, "service": "keycloak", "key": "password"}
121 if operation == "set":
122 fields["value"] = "fixture-not-applied"
123 broker(status=403, **fields)
124 for forbidden in ["/clients", "/realm-settings", "/users/" + identity + "/../../clients", "/users?max=1000&first=0"]:
125 broker(forbidden, status=400)
126 broker("/users/" + admin["id"] + "/reset-password", "PUT", {"type": "password", "value": "fixture-not-applied", "temporary": False}, status=403)
127 broker("/users/" + admin["id"], "DELETE", status=403)
128 broker("/" + path + "/role-mappings/realm", "POST", [server_role], status=403)
129 broker("/" + path + "/role-mappings/realm", "POST", [{"id": server_role["id"], "name": "infra-admin"}], status=403)
130 assert keycloak.request("/admin/realms/master/users/" + admin["id"]) == admin
131 assert keycloak.request("/admin/realms/master/users/" + admin["id"] + "/role-mappings/realm") == admin_roles
132 Keycloak("keycloak.studio.test", importlib.import_module("dashboard-run").secret("get", "keycloak", "password"), attempts=1)
133 http(path, "DELETE", status=204)
134 identity = None
135 result = {"native_user_crud": True, "password_sign_in_and_reset": True, "disable_rejects_sign_in": True,
136 "dashboard_role_grants": True, "self_lockout_refused": True, "account_profile": True,
137 "logout_revokes_refresh": True, "non_admin_refused": True, "bootstrap_user_hidden_and_protected": True,
138 "credential_export_and_change_refused": True, "admin_paths_and_forged_roles_refused": True,
139 "existing_realm_preserved": True, "directory_seconds": round(directory_seconds, 3)}
140 result["picture_persists_and_preserves_profile"] = True
141 finally:
142 if identity is not None:
143 keycloak.request("/admin/realms/master/users/" + identity, "DELETE")
144 remaining = keycloak.request("/admin/realms/master/users?username=" + name + "&exact=true")
145 for user in remaining:
146 keycloak.request("/admin/realms/master/users/" + user["id"], "DELETE")
147 assert not keycloak.request("/admin/realms/master/users?username=" + name + "&exact=true")
148 result["owned_fixture_removed"] = True
149 if args.output:
150 args.output.parent.mkdir(parents=True, exist_ok=True)
151 args.output.write_text(json.dumps(result, indent=2) + "\n")
152 print(json.dumps(result))
153
154
155if __name__ == "__main__":
156 main()
tools/dashboard-mcp-test.py deleted-237
......@@ -1,237 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import base64
4import hashlib
5import importlib
6import json
7from pathlib import Path
8import subprocess
9import sys
10import time
11import urllib.error
12import urllib.parse
13import urllib.request
14import uuid
15
16
17class NoRedirect(urllib.request.HTTPRedirectHandler):
18 def redirect_request(self, request, fp, code, message, headers, newurl):
19 return None
20
21
22def main():
23 parser = argparse.ArgumentParser()
24 parser.add_argument("--url", required=True)
25 parser.add_argument("--proof-file", type=Path, required=True)
26 parser.add_argument("--restart-unit")
27 parser.add_argument("--output", type=Path)
28 args = parser.parse_args()
29 if args.output:
30 args.output.unlink(missing_ok=True)
31 origin = "https://globe.studio.test"
32 resource = origin + "/mcp/observability"
33 opener = urllib.request.build_opener(NoRedirect)
34 proof = args.proof_file.read_text().strip()
35 sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "service/keycloak"))
36 from api import Keycloak
37 keycloak = Keycloak("keycloak.studio.test", importlib.import_module("dashboard-run").secret("get", "keycloak", "password"), attempts=1)
38 marker = "mcp-fixture-" + uuid.uuid4().hex
39 names = [marker + "-one", marker + "-two"]
40 identities = {}
41
42 def http(path, method="GET", body=None, status=200, actor=None, groups="infra-admin", token=None, form=False, headers=None):
43 fields = {"Host": "globe.studio.test", "Content-Type": "application/x-www-form-urlencoded" if form else "application/json"}
44 if actor is not None:
45 fields.update({"Studio-Proxy-Token": proof, "User-Name": actor, "User-Groups": groups, "Origin": origin})
46 if token is not None:
47 fields.update({"Authorization": "Bearer " + token, "Accept": "application/json, text/event-stream", "MCP-Protocol-Version": "2025-11-25"})
48 fields.update(headers or {})
49 encoded = urllib.parse.urlencode(body).encode() if form else json.dumps(body).encode() if body is not None else None
50 request = urllib.request.Request(args.url + path, method=method, data=encoded, headers=fields)
51 try:
52 response = opener.open(request, timeout=70)
53 except urllib.error.HTTPError as error:
54 response = error
55 with response:
56 content = response.read()
57 assert response.status == status, (path, response.status, content[:300])
58 if content and response.headers.get("Content-Type", "").startswith("application/json"):
59 value = json.loads(content)
60 else:
61 value = content.decode()
62 return value, response.headers
63
64 def consent(client, actor, chosen, scope="observability:read offline_access"):
65 verifier = uuid.uuid4().hex + uuid.uuid4().hex
66 challenge = base64.urlsafe_b64encode(hashlib.sha256(verifier.encode()).digest()).decode().rstrip("=")
67 request = {"response_type": "code", "client_id": client["client_id"], "redirect_uri": client["redirect_uris"][0],
68 "code_challenge_method": "S256", "code_challenge": challenge, "resource": resource, "scope": scope, "state": marker}
69 _, headers = http("/oauth/authorize?" + urllib.parse.urlencode(request), status=302)
70 pending = urllib.parse.urlsplit(headers["Location"]).path.removeprefix("/connect/")
71 path = "/api/mcp/consent/" + pending
72 details, _ = http(path, actor=actor)
73 assert details["client"] == client["client_name"]
74 http(path, actor=names[1] if actor == names[0] else names[0], status=403)
75 http(path, "POST", {"resources": ["outside-grant"]}, actor=actor, status=403)
76 http(path, "POST", {"resources": chosen}, actor=actor, headers={"Origin": "https://other.invalid"}, status=403)
77 result, _ = http(path, "POST", {"resources": chosen}, actor=actor)
78 query = urllib.parse.parse_qs(urllib.parse.urlsplit(result["redirect"]).query)
79 assert query["state"] == [marker] and query["iss"] == [origin + "/"]
80 http(path, actor=actor, status=404)
81 return {"grant_type": "authorization_code", "client_id": client["client_id"], "redirect_uri": client["redirect_uris"][0],
82 "code_verifier": verifier, "code": query["code"][0], "resource": resource}
83
84 def rpc(token, method, params=None):
85 result, _ = http("/mcp/observability", "POST", {"jsonrpc": "2.0", "id": 1, "method": method,
86 **({"params": params} if params is not None else {})}, token=token)
87 assert "error" not in result, (method, result)
88 return result["result"]
89
90 def ingest(service, path, body, content_type="application/json"):
91 readonly = Path("/var/lib/studio/dashboard.token").read_text().strip()
92 request = urllib.request.Request("http://127.0.0.1:4646/v1/service/" + service, headers={"X-Nomad-Token": readonly})
93 with urllib.request.urlopen(request, timeout=10) as response:
94 upstream = json.load(response)[0]
95 request = urllib.request.Request(f"http://{upstream['Address']}:{upstream['Port']}" + path,
96 data=body, headers={"Content-Type": content_type})
97 with urllib.request.urlopen(request, timeout=10) as response:
98 assert response.status == 200
99
100 try:
101 role = keycloak.request("/admin/realms/master/roles/infra-admin")
102 for name in names:
103 result = keycloak.request("/admin/realms/master/users", "POST", {"username": name, "enabled": True}, full=True)
104 identities[name] = result["id"]
105 keycloak.request("/admin/realms/master/users/" + result["id"] + "/role-mappings/realm", "POST", [role])
106 metadata, _ = http("/.well-known/oauth-protected-resource/mcp/observability")
107 assert metadata["resource"] == resource and metadata["authorization_servers"] == [origin + "/"]
108 metadata, _ = http("/.well-known/oauth-authorization-server")
109 assert metadata["issuer"] == origin + "/" and metadata["code_challenge_methods_supported"] == ["S256"]
110 _, headers = http("/mcp/observability", status=401, headers={"User-Name": names[0], "User-Groups": "infra-admin"})
111 assert headers["WWW-Authenticate"].startswith("Bearer resource_metadata=")
112 http("/api/mcp", status=403, headers={"User-Name": names[0], "User-Groups": "infra-admin"})
113 overview, _ = http("/api/mcp", actor=names[0])
114 assert not overview["connections"] and overview["catalogs"][0]["endpoint"] == resource
115 readonly = Path("/var/lib/studio/dashboard.token").read_text().strip()
116 request = urllib.request.Request("http://127.0.0.1:4646/v1/jobs", headers={"X-Nomad-Token": readonly})
117 with urllib.request.urlopen(request, timeout=10) as response:
118 jobs = json.load(response)
119 aliases = {}
120 for job in jobs:
121 request = urllib.request.Request("http://127.0.0.1:4646/v1/job/" + urllib.parse.quote(job["ID"], safe=""), headers={"X-Nomad-Token": readonly})
122 with urllib.request.urlopen(request, timeout=10) as response:
123 aliases[job["ID"]] = json.load(response).get("Meta", {}).get("studio_trace_service")
124 services = [job for job, alias in aliases.items() if alias and list(aliases.values()).count(alias) == 1]
125 assert len(services) >= 2, "need two trace-enabled services for scoped native fixture"
126 allowed, denied = services[:2]
127 client, _ = http("/oauth/register", "POST", {"client_name": marker, "redirect_uris": ["http://127.0.0.1:29999/callback"],
128 "token_endpoint_auth_method": "none"}, status=201)
129 form = consent(client, names[0], [allowed])
130 wrong = {**form, "code_verifier": "wrong"}
131 http("/oauth/token", "POST", wrong, form=True, status=400)
132 tokens, _ = http("/oauth/token", "POST", form, form=True)
133 http("/oauth/token", "POST", form, form=True, status=400)
134 token = tokens["access_token"]
135 assert rpc(token, "initialize", {"protocolVersion": "2025-11-25", "capabilities": {}, "clientInfo": {"name": marker, "version": "1"}})["capabilities"]["tools"] == {}
136 listed = rpc(token, "tools/list")
137 assert listed["ttlMs"] == 0 and listed["cacheScope"] == "private", listed
138 tools = listed["tools"]
139 assert {tool["name"] for tool in tools} == {"get_logs", "get_traces", "get_trace"}
140 assert all(tool["annotations"]["readOnlyHint"] for tool in tools)
141 refused = rpc(token, "tools/call", {"name": "get_logs", "arguments": {"service": denied}})
142 assert refused["isError"]
143 http("/mcp/observability", "POST", {"jsonrpc": "2.0", "id": 1, "method": "tools/list"}, token=token, headers={"Origin": "https://other.invalid"}, status=403)
144 at = time.time() - 60
145 row = {"_time": str(at), "_msg": marker, "source": "nomad", "job": allowed, "task": "fixture", "stream": "stdout"}
146 ingest("victoria-logs", "/insert/jsonline", (json.dumps(row) + "\n").encode(), "application/stream+json")
147 trace_id = uuid.uuid4().hex
148 spans = []
149 for service, span_id, parent in [(denied, "1234567890abcdef", ""), (allowed, "abcdef1234567890", "1234567890abcdef")]:
150 spans.append({"resource": {"attributes": [{"key": "service.name", "value": {"stringValue": aliases[service]}}]},
151 "scopeSpans": [{"spans": [{"traceId": trace_id, "spanId": span_id, "parentSpanId": parent,
152 "name": marker + ("-foreign-secret" if service == denied else "-allowed"), "kind": 1,
153 "startTimeUnixNano": str(int(at * 1e9)), "endTimeUnixNano": str(int((at + .01) * 1e9)),
154 "status": {"code": 2 if service == denied else 1},
155 "attributes": [{"key": "studio.service", "value": {"stringValue": service}}]}]}]})
156 ingest("victoria-traces", "/insert/opentelemetry/v1/traces", json.dumps({"resourceSpans": spans}).encode())
157 deadline = time.monotonic() + 30
158 while True:
159 try:
160 logs = rpc(token, "tools/call", {"name": "get_logs", "arguments": {"service": allowed, "q": marker}})
161 assert not logs.get("isError") and any(row["text"] == marker for row in logs["structuredContent"]["logs"]), logs
162 trace = rpc(token, "tools/call", {"name": "get_trace", "arguments": {"service": allowed, "trace_id": trace_id}})
163 assert not trace.get("isError") and len(trace["structuredContent"]["trace"]["spans"]) == 1, trace
164 traces = rpc(token, "tools/call", {"name": "get_traces", "arguments": {"service": allowed, "q": marker}})
165 assert not traces.get("isError") and any(row["id"] == trace_id and row["spans"] == 1 for row in traces["structuredContent"]["traces"]), traces
166 assert "foreign-secret" not in json.dumps(trace) + json.dumps(traces)
167 break
168 except (AssertionError, urllib.error.HTTPError):
169 if time.monotonic() > deadline:
170 raise
171 time.sleep(1)
172 overview, _ = http("/api/mcp", actor=names[0])
173 grant_id = overview["connections"][0]["id"]
174 other, _ = http("/api/mcp", actor=names[1])
175 assert not other["connections"]
176 http("/api/mcp/connections/" + grant_id, "DELETE", actor=names[1], status=404)
177 if args.restart_unit:
178 subprocess.run(["systemctl", "restart", args.restart_unit], check=True, capture_output=True, timeout=60)
179 rpc(token, "tools/list")
180 refresh = {"grant_type": "refresh_token", "client_id": client["client_id"], "refresh_token": tokens["refresh_token"], "resource": resource}
181 rotated, _ = http("/oauth/token", "POST", refresh, form=True)
182 assert rotated["refresh_token"] != tokens["refresh_token"]
183 http("/oauth/token", "POST", refresh, form=True, status=400)
184 http("/mcp/observability", token=token, status=401)
185 http("/mcp/observability", token=rotated["access_token"], status=401)
186 second = consent(client, names[0], [allowed], "observability:read")
187 tokens, _ = http("/oauth/token", "POST", second, form=True)
188 assert "refresh_token" not in tokens
189 overview, _ = http("/api/mcp", actor=names[0])
190 http("/api/mcp/connections/" + overview["connections"][0]["id"], "DELETE", actor=names[0], status=204)
191 http("/mcp/observability", token=tokens["access_token"], status=401)
192 for change in ["disable", "remove-role", "delete-user"]:
193 exchange = consent(client, names[0], [allowed])
194 tokens, _ = http("/oauth/token", "POST", exchange, form=True)
195 path = "/admin/realms/master/users/" + identities[names[0]]
196 if change == "disable":
197 keycloak.request(path, "PUT", {"enabled": False})
198 elif change == "remove-role":
199 keycloak.request(path + "/role-mappings/realm", "DELETE", [role])
200 else:
201 keycloak.request(path, "DELETE")
202 refresh = {"grant_type": "refresh_token", "client_id": client["client_id"], "refresh_token": tokens["refresh_token"]}
203 rejected, _ = http("/oauth/token", "POST", refresh, form=True, status=400)
204 assert rejected["error"] == "invalid_grant"
205 http("/mcp/observability", token=tokens["access_token"], status=401)
206 if change == "disable":
207 keycloak.request(path, "PUT", {"enabled": True})
208 elif change == "remove-role":
209 keycloak.request(path + "/role-mappings/realm", "POST", [role])
210 result = {"resource_metadata": True, "pkce_code_single_use": True, "shared_realm_identity": True,
211 "consent_owner_and_origin": True, "sdk_initialization_and_tools": True, "explicit_service_grants": True,
212 "native_log_retrieval": True, "native_trace_retrieval": True, "foreign_spans_and_summary_filtered": True,
213 "cross_user_connections_refused": True, "refresh_rotation_and_replay_revocation": True,
214 "dashboard_revocation_immediate": True, "refresh_requires_consent": True,
215 "refresh_honors_account_disable_role_removal_and_deletion": True,
216 "restart_preserves_tokens": bool(args.restart_unit)}
217 finally:
218 for name in names:
219 try:
220 overview, _ = http("/api/mcp", actor=name)
221 for connection in overview["connections"]:
222 http("/api/mcp/connections/" + connection["id"], "DELETE", actor=name, status=204)
223 except (AssertionError, urllib.error.URLError):
224 pass
225 for name in names:
226 for identity in keycloak.request("/admin/realms/master/users?username=" + name + "&exact=true"):
227 keycloak.request("/admin/realms/master/users/" + identity["id"], "DELETE")
228 assert not keycloak.request("/admin/realms/master/users?username=" + name + "&exact=true")
229 result["owned_users_removed"] = True
230 if args.output:
231 args.output.parent.mkdir(parents=True, exist_ok=True)
232 args.output.write_text(json.dumps(result, indent=2) + "\n")
233 print(json.dumps(result))
234
235
236if __name__ == "__main__":
237 main()
tools/dashboard-metrics-test.py+6-6
......@@ -50,15 +50,15 @@ nomad = ThreadingHTTPServer(("127.0.0.1", 0), Nomad)
5050for server in [metrics, nomad]:
5151 threading.Thread(target=server.serve_forever, daemon=True).start()
5252
53unit = "studio-dashboard-metrics-test"
54with tempfile.TemporaryDirectory(prefix="studio-metrics-test-") as temporary:
55 environment = subprocess.check_output(["systemctl", "show", "-P", "Environment", "studio-dashboard"], text=True)
53unit = "snowglobe-dashboard-metrics-test"
54with tempfile.TemporaryDirectory(prefix="snowglobe-metrics-test-") as temporary:
55 environment = subprocess.check_output(["systemctl", "show", "-P", "Environment", "snowglobe-dashboard"], text=True)
5656 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"]:
5858 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,
6060 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 {}
6262 def request(range=3600):
6363 started = time.monotonic()
6464 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():
4343 data = Path(temporary).resolve()
4444 (data / 'proof').write_text(proof)
4545 (data / 'source.json').write_text(json.dumps(export))
46 environment = {**os.environ, 'STUDIO_DOMAIN': 'paperclover.net', 'STUDIO_DATA_DIR': str(data),
47 'STUDIO_PUBLIC_ORIGIN': origin, 'STUDIO_AUTH_RP_ID': 'auth.paperclover.net', 'STUDIO_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'}
46 environment = {**os.environ, 'SNOWGLOBE_DOMAIN': 'paperclover.net', 'SNOWGLOBE_DATA_DIR': str(data),
47 'SNOWGLOBE_PUBLIC_ORIGIN': origin, 'SNOWGLOBE_AUTH_RP_ID': 'auth.paperclover.net', 'SNOWGLOBE_FILE_ORIGIN': 'https://file.paperclover.net',
48 'SNOWGLOBE_WEB_DIR': str(Path('dashboard/dist').resolve()), 'SNOWGLOBE_PROXY_TOKEN_FILE': str(data / 'proof'), 'SNOWGLOBE_AUTH_REQUIRED': '1'}
4949 binary = str(args.binary.resolve())
5050 result = subprocess.run([binary, '--import-accounts', str(data / 'source.json')], env=environment, capture_output=True, text=True)
5151 assert result.returncode == 0, result.stderr
......@@ -80,7 +80,7 @@ def main():
8080 server.terminate(); server.wait(timeout=10)
8181 cookies = {}
8282 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'}
8484 if body is not None: headers.update({'Origin': origin, 'Content-Type': 'application/x-www-form-urlencoded' if form else 'application/json'})
8585 if session: headers['Cookie'] = '; '.join(f'{k}={v}' for k,v in cookies.items())
8686 headers.update(extra or {})
......@@ -97,7 +97,7 @@ def main():
9797 csrf = request('/auth/status')['csrf']
9898 login = {'csrf': csrf, 'username': 'oidc-test', 'password': password, 'next': '/'}
9999 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'})
101101 assert metadata['issuer'] == origin and metadata['id_token_signing_alg_values_supported'] == ['RS256']
102102 jwk = request('/auth/oidc/jwks')['keys'][0]
103103 decode = lambda s: base64.urlsafe_b64decode(s + '=' * (-len(s) % 4))
tools/dashboard-package-test.py+16-16
......@@ -22,13 +22,13 @@ def main():
2222 parser.add_argument("--image", required=True)
2323 parser.add_argument("--output", type=Path)
2424 args = parser.parse_args()
25 container = "studio-dashboard-package-test-" + uuid.uuid4().hex[:12]
25 container = "snowglobe-dashboard-package-test-" + uuid.uuid4().hex[:12]
2626 proof = uuid.uuid4().hex + uuid.uuid4().hex
2727
2828 def shell(*argv):
2929 return subprocess.run(argv, capture_output=True, text=True, check=True, timeout=60).stdout
3030
31 with tempfile.TemporaryDirectory(prefix="studio-dashboard-package-", dir="/run") as temporary:
31 with tempfile.TemporaryDirectory(prefix="snowglobe-dashboard-package-", dir="/run") as temporary:
3232 data = Path(temporary) / "data"
3333 data.mkdir()
3434 os.chown(data, 65534, 65534)
......@@ -45,10 +45,10 @@ def main():
4545 "--security-opt=no-new-privileges", "--memory=512m", "--cpus=2", "--pids-limit=128",
4646 "--publish=127.0.0.1::7072", "--volume=" + str(data) + ":/data:rw",
4747 "--volume=" + str(token) + ":/run/secrets/dashboard-proxy.token:ro",
48 "--tmpfs=/tmp:rw,noexec,nosuid,size=64m", "--env=STUDIO_DATA_DIR=/data",
49 "--env=STUDIO_DOMAIN=studio.test", "--env=STUDIO_MEDIA_READ_ONLY=true",
50 "--env=STUDIO_YT_STATE=/data/yt", "--env=STUDIO_YT_CONFIG=/data/config",
51 "--env=STUDIO_YT_MEDIA=/data/media", args.image)
48 "--tmpfs=/tmp:rw,noexec,nosuid,size=64m", "--env=SNOWGLOBE_DATA_DIR=/data",
49 "--env=SNOWGLOBE_DOMAIN=snowglobe.test", "--env=SNOWGLOBE_MEDIA_READ_ONLY=true",
50 "--env=SNOWGLOBE_YT_STATE=/data/yt", "--env=SNOWGLOBE_YT_CONFIG=/data/config",
51 "--env=SNOWGLOBE_YT_MEDIA=/data/media", args.image)
5252 info = json.loads(shell("podman", "inspect", container))[0]
5353 port = info["NetworkSettings"]["Ports"]["7072/tcp"][0]["HostPort"]
5454 base = "http://127.0.0.1:" + port
......@@ -58,7 +58,7 @@ def main():
5858 "User-Name": "fixture", "User-Groups": "infra-admin,media,media-manage",
5959 }
6060 if supplied is not None:
61 headers["Studio-Proxy-Token"] = supplied
61 headers["Snowglobe-Proxy-Token"] = supplied
6262 request = urllib.request.Request(base + path, headers=headers)
6363 with urllib.request.urlopen(request, timeout=30) as response:
6464 return response.read()
......@@ -80,11 +80,11 @@ def main():
8080 except urllib.error.HTTPError as error:
8181 assert error.code == 403, (path, error.code)
8282 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="))
8484 address = next(network["IPAddress"] for network in info["NetworkSettings"]["Networks"].values() if network["IPAddress"])
8585 neighbor = f"""import urllib.request, urllib.error
8686request = 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,
8888}})
8989try:
9090 urllib.request.urlopen(request, timeout=5)
......@@ -96,9 +96,9 @@ print('refused')
9696 assert shell("podman", "run", "--rm", "--read-only", "--cap-drop=ALL", "--security-opt=no-new-privileges",
9797 "--entrypoint=" + python, args.image, "-c", neighbor).strip() == "refused"
9898 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],
100100 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
102102
103103 class Auth(BaseHTTPRequestHandler):
104104 def do_GET(self):
......@@ -117,13 +117,13 @@ print('refused')
117117 "/v1/service/forward-auth": [{"ServiceName": "forward-auth", "AllocID": "fixture", "Address": "127.0.0.1", "Port": auth.server_port, "Tags": []}],
118118 "/v1/allocation/fixture/checks": {"ready": {"Status": "success"}},
119119 }[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))
121121 with socket.socket() as reservation:
122122 reservation.bind(("127.0.0.1", 0))
123123 proxy_port = reservation.getsockname()[1]
124124 config = Path(temporary) / "Caddyfile"
125125 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) + " {"
127127 ).replace(" tls internal\n", ""))
128128 config.chmod(0o600)
129129 log = Path(temporary) / "caddy.log"
......@@ -141,7 +141,7 @@ print('refused')
141141 if time.monotonic() >= deadline or caddy.poll() is not None:
142142 raise AssertionError(log.read_text().replace(proof, "<redacted>"))
143143 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}
145145 request = urllib.request.Request("http://127.0.0.1:" + str(proxy_port) + "/api/me",
146146 headers={**forged, "Cookie": "fixture=1"})
147147 with urllib.request.urlopen(request, timeout=10) as response:
......@@ -171,7 +171,7 @@ print('refused')
171171 auth.shutdown()
172172 apps = json.loads(get("/api/launcher"))
173173 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
175175 icon = next(url for app in apps for url in (app["icon"] or {}).values() if url)
176176 assert b"<svg" in get(icon)
177177 library = json.loads(get("/api/youtube/library"))
......@@ -183,7 +183,7 @@ print('refused')
183183 assert {mount["Destination"] for mount in info["Mounts"]} == {"/data", "/run/secrets/dashboard-proxy.token"}, info["Mounts"]
184184 assert not next(mount["RW"] for mount in info["Mounts"] if mount["Destination"] == "/run/secrets/dashboard-proxy.token")
185185 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"]:
187187 assert subprocess.run(["podman", "exec", container, "test", "-e", denied], capture_output=True).returncode == 1, denied
188188 result = {"proxy_proof_required": "passed", "neighbor_identity_forgery_refused": "passed",
189189 "wildcard_startup_without_proof_refused": "passed",
tools/dashboard-public-load-test.py deleted-141
......@@ -1,141 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3from concurrent.futures import ThreadPoolExecutor
4import http.cookiejar
5import importlib
6import json
7from pathlib import Path
8import ssl
9import subprocess
10import sys
11import time
12import urllib.parse
13import urllib.request
14import uuid
15
16
17def main():
18 parser = argparse.ArgumentParser()
19 parser.add_argument('--clients', type=int, default=24)
20 parser.add_argument('--requests', type=int, default=1200)
21 parser.add_argument('--idle-seconds', type=int, default=0)
22 parser.add_argument('--output', type=Path, required=True)
23 args = parser.parse_args()
24 assert 1 <= args.clients <= 64 and 12 <= args.requests <= 50000
25 assert 0 <= args.idle_seconds <= 600
26 for unit in ['studio-dashboard-unit-test', 'studio-host-unit-test']:
27 subprocess.run(['systemctl', 'is-active', '--quiet', unit], check=True)
28 repo = Path(__file__).resolve().parent.parent
29 sys.path.insert(0, str(repo / 'service/keycloak'))
30 from api import Keycloak, LoopbackHTTPS
31 Page = importlib.import_module('dashboard-shale-test').Page
32 secret = importlib.import_module('dashboard-run').secret
33 origin = 'https://globe.studio.test'
34 context = ssl.create_default_context(cafile='/var/lib/studio/ca-bundle.crt')
35
36 class TLS(urllib.request.HTTPSHandler):
37 def https_open(self, request):
38 target = urllib.parse.urlsplit(request.full_url)
39 assert target.scheme == 'https' and target.netloc in ('globe.studio.test', 'keycloak.studio.test')
40 return self.do_open(LoopbackHTTPS, request, context=context)
41
42 class Redirect(urllib.request.HTTPRedirectHandler):
43 def redirect_request(self, request, response, code, message, headers, target):
44 parts = urllib.parse.urlsplit(target)
45 assert parts.scheme == 'https' and parts.netloc in ('globe.studio.test', 'keycloak.studio.test')
46 return super().redirect_request(request, response, code, message, headers, target)
47
48 class NoRedirect(urllib.request.HTTPRedirectHandler):
49 def redirect_request(self, *args):
50 return None
51
52 keycloak = Keycloak('keycloak.studio.test', secret('get', 'keycloak', 'password'), attempts=1)
53 name = 'dashboard-load-' + uuid.uuid4().hex
54 password = uuid.uuid4().hex + 'A1!'
55 user = None
56 try:
57 role = keycloak.request('/admin/realms/master/roles/infra-admin')
58 user = keycloak.request('/admin/realms/master/users', 'POST', {
59 'username': name, 'enabled': True, 'requiredActions': [],
60 'credentials': [{'type': 'password', 'value': password, 'temporary': False}],
61 }, full=True)['id']
62 keycloak.request('/admin/realms/master/users/' + user + '/role-mappings/realm', 'POST', [role])
63 cookies = http.cookiejar.CookieJar()
64 login = urllib.request.build_opener(TLS(), Redirect(), urllib.request.HTTPCookieProcessor(cookies))
65 with login.open(origin + '/snow.oauth2/start?' + urllib.parse.urlencode({'rd': origin + '/'}), timeout=30) as response:
66 target = response.url
67 body = response.read(4 * 1024 * 1024 + 1).decode()
68 assert urllib.parse.urlsplit(target).netloc == 'keycloak.studio.test'
69 forms = [form for form in Page(body).forms if any(field.get('name') == 'password' for field in form['fields'])]
70 assert len(forms) == 1
71 action = urllib.parse.urljoin(target, forms[0]['action'])
72 action_url = urllib.parse.urlsplit(action)
73 assert action_url.scheme == 'https' and action_url.netloc == 'keycloak.studio.test'
74 fields = {field['name']: field.get('value', '') for field in forms[0]['fields'] if field.get('name')}
75 fields.update(username=name, password=password)
76 with login.open(urllib.request.Request(action, data=urllib.parse.urlencode(fields).encode(),
77 headers={'Content-Type': 'application/x-www-form-urlencoded', 'Origin': 'https://keycloak.studio.test'}), timeout=30) as response:
78 assert response.status == 200 and response.url == origin + '/'
79 response.read(4 * 1024 * 1024 + 1)
80 cookie_request = urllib.request.Request(origin + '/api/me')
81 cookies.add_cookie_header(cookie_request)
82 cookie = cookie_request.get_header('Cookie')
83 assert cookie
84 paths = ['/api/me', '/api/host', '/api/services', '/api/launcher', '/api/status', '/api/storage',
85 '/api/mcp', '/api/media/list', *['/api/metrics/' + metric + '?range=3600'
86 for metric in ['host.cpu', 'host.memory', 'service.cpu', 'service.memory']]]
87
88 def request(path):
89 start = time.monotonic()
90 client = urllib.request.build_opener(TLS(), NoRedirect())
91 with client.open(urllib.request.Request(origin + path, headers={'Cookie': cookie}), timeout=30) as response:
92 assert response.status == 200 and response.headers.get_content_type() == 'application/json'
93 body = response.read(8 * 1024 * 1024 + 1)
94 assert len(body) <= 8 * 1024 * 1024
95 value = json.loads(body)
96 if path == '/api/me':
97 assert value['name'] == name
98 if path == '/api/mcp':
99 assert {catalog['endpoint'] for catalog in value['catalogs']} == {origin + '/mcp/' + catalog
100 for catalog in ['observability', 'agents', 'shale']}
101 return path, (time.monotonic() - start) * 1000
102
103 for path in paths:
104 request(path)
105 start = time.monotonic()
106 with ThreadPoolExecutor(max_workers=args.clients) as clients:
107 results = list(clients.map(request, [paths[i % len(paths)] for i in range(args.requests)]))
108 report = {'public_https_and_real_sso': True, 'clients': args.clients, 'requests': len(results),
109 'seconds': round(time.monotonic() - start, 2), 'routes': {}}
110 for path in paths:
111 samples = sorted(ms for route, ms in results if route == path)
112 report['routes'][path] = {'requests': len(samples), 'p95_ms': round(samples[int(len(samples) * .95)], 2),
113 'max_ms': round(samples[-1], 2)}
114 print(json.dumps({'load_complete': report}), flush=True)
115 if args.idle_seconds:
116 units = ['studio-dashboard-unit-test.service', 'studio-host-unit-test.service']
117 before = {}
118 for unit in units:
119 stat = Path('/sys/fs/cgroup/system.slice') / unit / 'cpu.stat'
120 before[unit] = int(dict(line.split() for line in stat.read_text().splitlines())['usage_usec'])
121 start = time.monotonic()
122 time.sleep(args.idle_seconds)
123 elapsed = time.monotonic() - start
124 idle = {'seconds': round(elapsed, 2), 'percent_of_one_core': {}}
125 for unit in units:
126 stat = Path('/sys/fs/cgroup/system.slice') / unit / 'cpu.stat'
127 used = int(dict(line.split() for line in stat.read_text().splitlines())['usage_usec']) - before[unit]
128 idle['percent_of_one_core'][unit] = round(used / elapsed / 10000, 3)
129 request('/api/me')
130 report['idle'] = idle
131 finally:
132 if user:
133 keycloak = Keycloak('keycloak.studio.test', secret('get', 'keycloak', 'password'), attempts=1)
134 keycloak.request('/admin/realms/master/users/' + user, 'DELETE')
135 report['owned_sso_fixture_removed'] = True
136 args.output.write_text(json.dumps(report, indent=2) + '\n')
137 print(json.dumps(report), flush=True)
138
139
140if __name__ == '__main__':
141 main()
tools/dashboard-relay-test.py deleted-454
......@@ -1,454 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import base64
4from concurrent.futures import ThreadPoolExecutor
5import hashlib
6import importlib
7import json
8import os
9from pathlib import Path
10import queue
11import re
12import tempfile
13import socket
14import sqlite3
15import struct
16import subprocess
17import sys
18import threading
19import time
20import urllib.error
21import urllib.parse
22import urllib.request
23import uuid
24
25
26class NoRedirect(urllib.request.HTTPRedirectHandler):
27 def redirect_request(self, request, fp, code, message, headers, newurl):
28 return None
29
30
31class Agent:
32 def __init__(self, address, token, status=101, origin=None, host="globe.studio.test"):
33 target = urllib.parse.urlsplit(address)
34 self.socket = socket.create_connection((target.hostname, target.port), timeout=5)
35 self.socket.settimeout(45)
36 key = base64.b64encode(os.urandom(16)).decode()
37 fields = {"Host": host, "Upgrade": "websocket", "Connection": "Upgrade", "Sec-WebSocket-Version": "13",
38 "Sec-WebSocket-Key": key, "Authorization": "Bearer " + token}
39 if origin is not None:
40 fields["Origin"] = origin
41 self.socket.sendall(("GET /agent/connect HTTP/1.1\r\n" + "".join(k + ": " + v + "\r\n" for k, v in fields.items()) + "\r\n").encode())
42 self.stream = self.socket.makefile("rb", buffering=0)
43 response = self.stream.readline().decode().split()
44 assert int(response[1]) == status, response
45 headers = {}
46 while line := self.stream.readline().strip():
47 k, v = line.decode().split(":", 1)
48 headers[k.lower()] = v.strip()
49 if status != 101:
50 self.close()
51 return
52 expected = base64.b64encode(hashlib.sha1((key + "258EAFA5-E914-47DA-95CA-C5AB0DC85B11").encode()).digest()).decode()
53 assert headers["sec-websocket-accept"] == expected
54 self.lock = threading.Lock()
55 self.frames = queue.Queue()
56 self.mode = "reply"
57 self.pings = 0
58 self.closed = threading.Event()
59 self.machine = self.receive()["machine_id"]
60 self.thread = threading.Thread(target=self.run, daemon=True)
61 self.thread.start()
62
63 def read(self, size):
64 result = b""
65 while len(result) < size:
66 part = self.stream.read(size - len(result))
67 if not part:
68 raise EOFError()
69 result += part
70 return result
71
72 def receive(self):
73 while True:
74 first, size = self.read(2)
75 assert first & 128 and not size & 128
76 size &= 127
77 if size == 126:
78 size = struct.unpack("!H", self.read(2))[0]
79 elif size == 127:
80 size = struct.unpack("!Q", self.read(8))[0]
81 assert size <= 4 * 1024 * 1024
82 data = self.read(size)
83 opcode = first & 15
84 if opcode == 9:
85 self.pings += 1
86 self.send(data, opcode=10)
87 elif opcode == 8:
88 raise EOFError()
89 else:
90 assert opcode == 1
91 return json.loads(data)
92
93 def send(self, value, opcode=1):
94 data = value if isinstance(value, bytes) else json.dumps(value).encode()
95 prefix = bytes([128 | opcode])
96 length = len(data)
97 if length < 126:
98 prefix += bytes([128 | length])
99 elif length < 65536:
100 prefix += bytes([128 | 126]) + struct.pack("!H", length)
101 else:
102 prefix += bytes([128 | 127]) + struct.pack("!Q", length)
103 mask = os.urandom(4)
104 packet = prefix + mask + bytes(byte ^ mask[i % 4] for i, byte in enumerate(data))
105 with self.lock:
106 self.socket.sendall(packet)
107
108 def run(self):
109 try:
110 while True:
111 frame = self.receive()
112 assert set(frame) == {"id", "method", "params"}
113 uuid.UUID(frame["id"])
114 self.frames.put(frame)
115 if self.mode == "reply":
116 self.send({"id": frame["id"], "result": {"fixture": self.machine, "method": frame["method"], "params": frame["params"]}})
117 elif self.mode == "drop":
118 self.socket.shutdown(socket.SHUT_RDWR)
119 break
120 except (EOFError, OSError):
121 pass
122 finally:
123 self.closed.set()
124
125 def close(self):
126 try:
127 self.socket.shutdown(socket.SHUT_RDWR)
128 except OSError:
129 pass
130 self.stream.close()
131 self.socket.close()
132 if hasattr(self, "thread"):
133 self.thread.join(timeout=5)
134
135
136def main():
137 parser = argparse.ArgumentParser()
138 parser.add_argument("--url", required=True)
139 parser.add_argument("--proof-file", type=Path, required=True)
140 parser.add_argument("--data-dir", type=Path, required=True)
141 parser.add_argument("--restart-unit", required=True)
142 parser.add_argument("--output", type=Path)
143 parser.add_argument("--agent-dir", type=Path)
144 parser.add_argument("--agent-origin")
145 parser.add_argument("--agent-ca", type=Path)
146 args = parser.parse_args()
147 if args.output:
148 args.output.unlink(missing_ok=True)
149 origin = "https://globe.studio.test"
150 resource = origin + "/mcp/agents"
151 proof = args.proof_file.read_text().strip()
152 opener = urllib.request.build_opener(NoRedirect)
153 marker = "relay-fixture-" + uuid.uuid4().hex
154 names = [marker + "-one", marker + "-two"]
155 sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "service/keycloak"))
156 from api import Keycloak
157 keycloak = Keycloak("keycloak.studio.test", importlib.import_module("dashboard-run").secret("get", "keycloak", "password"), attempts=1)
158 agents = []
159 credentials = []
160
161 def http(path, method="GET", body=None, actor=None, token=None, status=200, form=False, headers=None):
162 fields = {"Host": "globe.studio.test", "Content-Type": "application/x-www-form-urlencoded" if form else "application/json"}
163 if actor:
164 fields.update({"Studio-Proxy-Token": proof, "User-Name": actor, "User-Groups": "", "Origin": origin})
165 if token:
166 fields.update({"Authorization": "Bearer " + token, "Accept": "application/json, text/event-stream", "MCP-Protocol-Version": "2025-11-25"})
167 fields.update(headers or {})
168 data = urllib.parse.urlencode(body).encode() if form else json.dumps(body).encode() if body is not None else None
169 try:
170 response = opener.open(urllib.request.Request(args.url + path, method=method, headers=fields, data=data), timeout=65)
171 except urllib.error.HTTPError as error:
172 response = error
173 with response:
174 content = response.read()
175 assert response.status == status, (path, response.status, content[:300])
176 value = json.loads(content) if content and response.headers.get("Content-Type", "").startswith("application/json") else content.decode()
177 return value, response.headers
178
179 def pair(actor, label):
180 pending, _ = http("/pairing", "POST", {"name": label, "platform": "fixture"}, status=201)
181 credentials.append(pending["token"])
182 http("/pairing", token=pending["token"], status=202)
183 machine, _ = http("/api/mcp/relay/pair", "POST", {"code": pending["code"]}, actor=actor)
184 http("/api/mcp/relay/pair", "POST", {"code": pending["code"]}, actor=actor, status=410)
185 assert "tokenHash" not in machine and "token" not in machine
186 result, _ = http("/pairing", token=pending["token"])
187 assert result["machine_id"] == machine["id"]
188 return machine, pending["token"]
189
190 def key(actor, machines, write=False):
191 result, _ = http("/api/mcp/relay/keys", "POST", {"name": marker, "resources": machines, "write": write}, actor=actor)
192 credentials.append(result["key"])
193 return result
194
195 def rpc(token, method, params=None, error=False):
196 response, _ = http("/mcp/agents", "POST", {"jsonrpc": "2.0", "id": 1, "method": method, **({"params": params} if params is not None else {})}, token=token)
197 assert "error" not in response, response
198 result = response["result"]
199 if method == "tools/call":
200 assert bool(result.get("isError")) == error, result
201 return result
202
203 def call(token, name, fields=None, error=False):
204 return rpc(token, "tools/call", {"name": name, "arguments": fields or {}}, error=error)
205
206 def command(token, machine, method="list_threads", params=None, status=200):
207 return http("/api/v1/machines/" + machine + "/commands", "POST", {"method": method, "params": params or {}}, token=token, status=status)[0]
208
209 def connect(token):
210 agent = Agent(args.url, token)
211 agents.append(agent)
212 return agent
213
214 try:
215 for name in names:
216 keycloak.request("/admin/realms/master/users", "POST", {"username": name, "enabled": True})
217 first, token1 = pair(names[0], "First fixture")
218 second, token2 = pair(names[0], "Second fixture")
219 foreign, foreign_token = pair(names[1], "Foreign fixture")
220 http("/api/mcp/relay/machines/" + first["id"], "DELETE", actor=names[1], status=404)
221 http("/api/mcp/relay/machines/" + first["id"], "PATCH", {"name": "Renamed fixture"}, actor=names[0])
222 http("/api/mcp/relay/pair", "POST", {"code": "random"}, actor=names[0], status=403, headers={"Origin": "https://other.invalid"})
223 http("/api/mcp/relay/keys", "POST", {"name": marker, "resources": [foreign["id"]]}, actor=names[0], status=403)
224 http("/pairing", "POST", {}, status=421, headers={"Host": "other.invalid"})
225 read = key(names[0], [first["id"], second["id"]])
226 control = key(names[0], [first["id"], second["id"]], write=True)
227 command(control["key"], foreign["id"], status=403)
228 command(read["key"], first["id"], "start_thread", {"provider": "codex", "cwd": "/owned", "message": "fixture"}, status=403)
229 http("/api/v1/machines", status=401, headers={"User-Name": names[0], "User-Groups": "infra-admin", "Studio-Proxy-Token": proof})
230 http("/api/v1/machines", token=read["key"], status=403, headers={"Origin": "https://other.invalid"})
231 Agent(args.url, token1, status=401, origin=origin)
232 Agent(args.url, token1, status=421, host="other.invalid")
233 live = opener.open(urllib.request.Request(args.url + "/api/mcp/relay/live", headers={"Host": "globe.studio.test", "Studio-Proxy-Token": proof, "User-Name": names[0], "User-Groups": ""}), timeout=10)
234 def snapshot():
235 while line := live.readline():
236 if line.startswith(b"data:"):
237 value = json.loads(line.split(b":", 1)[1])
238 assert {m["id"] for m in value} == {first["id"], second["id"]}
239 return value
240 raise AssertionError("Machine stream closed")
241 try:
242 assert not any(m["online"] for m in snapshot())
243 a1 = connect(token1)
244 assert sum(m["online"] for m in snapshot()) == 1
245 a2 = connect(token2)
246 assert all(m["online"] for m in snapshot())
247 http("/api/mcp/relay/machines/" + first["id"], "PATCH", {"name": "Stream renamed fixture"}, actor=names[0])
248 assert next(m for m in snapshot() if m["id"] == first["id"])["name"] == "Stream renamed fixture"
249 finally:
250 live.close()
251 Agent(args.url, token1, status=409)
252 assert a1.machine == first["id"] and a2.machine == second["id"]
253 init = rpc(control["key"], "initialize", {"protocolVersion": "2025-11-25", "capabilities": {}, "clientInfo": {"name": marker, "version": "1"}})
254 assert init["capabilities"]["tools"] == {}
255 listed = rpc(control["key"], "tools/list")
256 assert listed["ttlMs"] == 0 and listed["cacheScope"] == "private", listed
257 tools = listed["tools"]
258 assert len(tools) == 7
259 assert next(t for t in tools if t["name"] == "send_message")["annotations"]["readOnlyHint"] is False
260 call(control["key"], "send_message", {"provider": "codex", "thread_id": str(uuid.uuid4()), "message": "ambiguous fixture"}, error=True)
261 assert a1.frames.empty() and a2.frames.empty()
262 results = call(read["key"], "list_threads")["structuredContent"]["results"]
263 assert len(results) == 2 and all(r["result"]["params"] == {"limit": 30} for r in results)
264 a1.frames.get(timeout=2); a2.frames.get(timeout=2)
265 call(control["key"], "set_target_machines", {"machine_ids": [foreign["id"]]}, error=True)
266 call(control["key"], "set_target_machines", {"machine_ids": [first["id"]]})
267 unchanged, _ = http("/api/v1/machines", token=read["key"])
268 assert len(unchanged) == 2 and all(m["selected"] for m in unchanged)
269 write_params = {"provider": "claude", "thread_id": str(uuid.uuid4()), "message": "owned fixture", "expected_turn_id": str(uuid.uuid4())}
270 call(control["key"], "send_message", write_params)
271 assert a1.frames.get(timeout=2)["params"] == write_params and a2.frames.empty()
272 command(control["key"], first["id"], params={"limit": 101}, status=400)
273 assert a1.frames.empty()
274 call(control["key"], "send_message", {"provider": "codex", "thread_id": str(uuid.uuid4()), "message": "雪" * 100000}, error=True)
275 assert a1.frames.empty()
276 a1.mode = "hold"
277 with ThreadPoolExecutor(max_workers=9) as pool:
278 pending = [pool.submit(command, control["key"], first["id"]) for _ in range(8)]
279 frames = [a1.frames.get(timeout=10) for _ in range(8)]
280 command(control["key"], first["id"], status=429)
281 for frame in frames:
282 a1.send({"id": frame["id"], "result": {"bounded": True}})
283 assert all(future.result(timeout=10)["result"] == {"bounded": True} for future in pending)
284 started = time.monotonic()
285 outcome = command(control["key"], first["id"], status=409)
286 elapsed = time.monotonic() - started
287 frame = a1.frames.get(timeout=2)
288 assert "unknown" in outcome["error"] and 29 <= elapsed < 40 and a1.pings >= 1
289 a1.send({"id": frame["id"], "result": {"late": True}})
290 a1.mode = "reply"
291 assert command(control["key"], first["id"])["result"]["params"] == {"limit": 30}
292 a1.frames.get(timeout=2)
293 a1.mode = "drop"
294 started = time.monotonic()
295 outcome = command(control["key"], first["id"], "send_message", write_params, status=409)
296 assert "unknown" in outcome["error"] and time.monotonic() - started < 5
297 a1.frames.get(timeout=2)
298 a1.close()
299 a1 = connect(token1)
300 time.sleep(.2)
301 assert a1.frames.empty()
302 assert command(control["key"], first["id"])["result"]["method"] == "list_threads"
303 a1.frames.get(timeout=2)
304 metadata, _ = http("/.well-known/oauth-protected-resource/mcp/agents")
305 assert metadata["resource"] == resource and "sessions:write" in metadata["scopes_supported"]
306 client, _ = http("/oauth/register", "POST", {"client_name": marker, "redirect_uris": ["http://127.0.0.1:20001/callback"]}, status=201)
307 verifier = uuid.uuid4().hex + uuid.uuid4().hex
308 fields = {"response_type": "code", "client_id": client["client_id"], "redirect_uri": client["redirect_uris"][0], "resource": resource, "scope": "sessions:read sessions:write offline_access",
309 "code_challenge_method": "S256", "code_challenge": base64.urlsafe_b64encode(hashlib.sha256(verifier.encode()).digest()).decode().rstrip("=")}
310 _, headers = http("/oauth/authorize?" + urllib.parse.urlencode(fields), status=302)
311 request_id = urllib.parse.urlsplit(headers["Location"]).path.removeprefix("/connect/")
312 consent_path = "/api/mcp/consent/" + request_id
313 details, _ = http(consent_path, actor=names[0])
314 assert {r["id"] for r in details["resources"]} == {first["id"], second["id"]}
315 http(consent_path, actor=names[1], status=403)
316 result, _ = http(consent_path, "POST", {"resources": [first["id"]]}, actor=names[0])
317 code = urllib.parse.parse_qs(urllib.parse.urlsplit(result["redirect"]).query)["code"][0]
318 tokens, _ = http("/oauth/token", "POST", {"grant_type": "authorization_code", "client_id": client["client_id"], "redirect_uri": fields["redirect_uri"], "resource": resource, "code_verifier": verifier, "code": code}, form=True)
319 credentials.extend([tokens["access_token"], tokens["refresh_token"]])
320 assert len(call(tokens["access_token"], "list_machines")["structuredContent"]["machines"]) == 1
321 http("/mcp/observability", "POST", {}, token=tokens["access_token"], status=401)
322 http("/oauth/token", "POST", {"grant_type": "refresh_token", "client_id": client["client_id"], "refresh_token": tokens["refresh_token"], "resource": origin + "/mcp/observability"}, status=400, form=True)
323 rotated, _ = http("/oauth/token", "POST", {"grant_type": "refresh_token", "client_id": client["client_id"], "refresh_token": tokens["refresh_token"], "resource": resource}, form=True)
324 credentials.extend([rotated["access_token"], rotated["refresh_token"]])
325 with sqlite3.connect(args.data_dir / "connections.sqlite") as db:
326 rows = db.execute("SELECT key,value FROM records").fetchall()
327 assert all(not any(secret in key + value for secret in credentials) for key, value in rows)
328 expired, _ = http("/pairing", "POST", {"name": marker, "platform": "test"}, status=201)
329 code_hash = hashlib.sha256(expired["code"].replace("-", "").encode()).hexdigest()
330 db.execute("UPDATE records SET expires=1 WHERE key=?", ("pair:" + code_hash,))
331 http("/pairing", token=expired["token"], status=410)
332 subprocess.run(["systemctl", "restart", args.restart_unit], check=True, timeout=180, capture_output=True)
333 for agent in agents:
334 assert agent.closed.wait(5)
335 a1, a2 = connect(token1), connect(token2)
336 assert command(read["key"], first["id"])["result"]["method"] == "list_threads"
337 a1.frames.get(timeout=2)
338 assert len(call(rotated["access_token"], "list_machines")["structuredContent"]["machines"]) == 1
339 http("/api/mcp/connections/" + control["id"], "DELETE", actor=names[0], status=204)
340 http("/api/v1/machines", token=control["key"], status=401)
341 assert a1.frames.empty()
342 http("/api/mcp/relay/machines/" + first["id"], "DELETE", actor=names[0], status=204)
343 assert a1.closed.wait(5)
344 Agent(args.url, token1, status=401)
345 http("/pairing", token=token1, status=410)
346 remaining = call(read["key"], "list_machines")["structuredContent"]["machines"]
347 assert len(remaining) == 1 and remaining[0]["id"] == second["id"] and remaining[0]["selected"]
348 http("/api/v1/targets", "PUT", {"machine_ids": [first["id"]]}, token=read["key"], status=403)
349 a2.send({"id": str(uuid.uuid4()), "result": {}, "error": "malformed"})
350 assert a2.closed.wait(5)
351 original_agent_checks = None
352 if args.agent_dir:
353 node = next(Path("/nix/store").glob("*nodejs-24*/bin/node"))
354 with tempfile.TemporaryDirectory(prefix="studio-relay-cli-") as temporary:
355 local = Path(temporary)
356 home = local / "home"
357 home.mkdir()
358 (home / "codex").mkdir()
359 (home / "claude/projects").mkdir(parents=True)
360 with sqlite3.connect(home / "codex/state_5.sqlite") as catalog:
361 catalog.execute("CREATE TABLE threads(id TEXT,title TEXT,cwd TEXT,updated_at INTEGER,rollout_path TEXT,archived INTEGER)")
362 allowed = local / "workspace"
363 allowed.mkdir()
364 resolver = local / "lookup.cjs"
365 resolver.write_text("const dns=require('node:dns'); const original=dns.lookup; dns.lookup=function(host,opts,callback){if(host==='globe.studio.test'){if(typeof opts==='function'){callback=opts;opts={};} process.nextTick(()=>opts?.all?callback(null,[{address:'127.0.0.1',family:4}]):callback(null,'127.0.0.1',4));}else{return original.apply(this,arguments);}};\n")
366 executable = local / "model-fixture"
367 executable.write_text("#!/bin/sh\nexec " + str(node) + " " + str(args.agent_dir / "fake-cli.mjs") + ' "$@"\n')
368 executable.chmod(0o700)
369 log = local / "agent.log"
370 environment = {**os.environ, "HOME": str(home), "CODEX_HOME": str(home / "codex"), "CLAUDE_CONFIG_DIR": str(home / "claude"),
371 "PATH": str(node.parent) + ":" + os.environ.get("PATH", ""), "NODE_OPTIONS": "--require " + str(resolver), "NODE_EXTRA_CA_CERTS": str(args.agent_ca)}
372 output = queue.Queue()
373 with log.open("w") as stderr:
374 process = subprocess.Popen([str(node), str(args.agent_dir / "dist/agent.js"), "run", "--server", args.agent_origin,
375 "--name", marker, "--data-dir", str(local / "identity"), "--allow-root", str(allowed),
376 "--codex-bin", str(executable), "--claude-bin", str(executable)], env=environment, stdout=subprocess.PIPE, stderr=stderr, text=True)
377 reader = threading.Thread(target=lambda: [output.put(line) for line in process.stdout], daemon=True)
378 reader.start()
379 try:
380 deadline = time.monotonic() + 15
381 code = None
382 while not code and time.monotonic() < deadline:
383 line = output.get(timeout=15)
384 match = re.search(r"code ([A-F0-9]{5}-[A-F0-9]{5})", line)
385 if match:
386 code = match[1]
387 assert code, "Original agent did not begin pairing"
388 machine, _ = http("/api/mcp/relay/pair", "POST", {"code": code}, actor=names[0])
389 deadline = time.monotonic() + 15
390 while time.monotonic() < deadline:
391 overview, _ = http("/api/mcp", actor=names[0])
392 if any(m["id"] == machine["id"] and m["online"] for m in overview["machines"]):
393 break
394 time.sleep(.2)
395 else:
396 raise AssertionError("Original agent did not connect")
397 credential_file = local / "identity/agent.json"
398 assert credential_file.stat().st_mode & 0o777 == 0o600
399 native_key = key(names[0], [machine["id"]], write=True)
400 assert command(native_key["key"], machine["id"])["result"] == {"threads": [], "errors": []}
401 for provider in ["codex", "claude"]:
402 started = command(native_key["key"], machine["id"], "start_thread", {"provider": provider, "cwd": str(allowed), "message": "owned fixture"})["result"]
403 thread = started["thread_id"]
404 time.sleep(.05)
405 read_fields = {"provider": provider, "thread_id": thread}
406 transcript = command(native_key["key"], machine["id"], "read_thread", read_fields)["result"]
407 assert "fixture reply" in json.dumps(transcript)
408 command(native_key["key"], machine["id"], "send_message", {**read_fields, "message": "slow"})
409 if provider == "claude":
410 live = command(native_key["key"], machine["id"], "read_thread", read_fields)["result"]
411 command(native_key["key"], machine["id"], "interrupt_thread", {**read_fields, "expected_turn_id": live["active_turn_id"]})
412 command(native_key["key"], machine["id"], "start_thread", {"provider": "codex", "cwd": str(home), "message": "outside allowed directory"}, status=400)
413 http("/api/mcp/relay/machines/" + machine["id"], "DELETE", actor=names[0], status=204)
414 assert process.wait(timeout=10) != 0
415 original_agent_checks = {"tls_pairing_and_outbound_wss": True, "credential_mode_0600": True, "codex_and_claude_owned_session_roundtrip": True,
416 "session_control_and_expected_turn": True, "local_directory_allowlist": True, "unlink_rejects_reconnect": True}
417 finally:
418 if process.poll() is None:
419 process.terminate()
420 process.wait(timeout=10)
421 process.stdout.close()
422 reader.join(timeout=5)
423 result = {"native_pairing_single_use_and_expiry": True, "existing_agents_wire_protocol": True, "ordinary_realm_user_consent": True,
424 "machine_and_cross_catalog_isolation": True, "explicit_control_scope": True, "single_machine_writes": True,
425 "per_connection_target_selection": True, "native_mcp_tools": True, "owned_machine_stream": True, "eight_pending_limit": True, "unicode_command_frame_budget": True,
426 "heartbeat_and_timeout_unknown_outcome": True, "disconnect_unknown_outcome_no_replay": True,
427 "hash_only_credentials": True, "restart_preserves_pairing_keys_and_oauth": True,
428 "revoke_and_unlink_immediate": True, "origin_host_and_malformed_frames_refused": True,
429 "timeout_seconds": round(elapsed, 2)}
430 if original_agent_checks is not None:
431 result["original_node_agent"] = original_agent_checks
432 finally:
433 for agent in agents:
434 agent.close()
435 keycloak = Keycloak("keycloak.studio.test", importlib.import_module("dashboard-run").secret("get", "keycloak", "password"), attempts=1)
436 for name in names:
437 try:
438 overview, _ = http("/api/mcp", actor=name)
439 for connection in overview["connections"]:
440 http("/api/mcp/connections/" + connection["id"], "DELETE", actor=name, status=204)
441 for machine in overview["machines"]:
442 http("/api/mcp/relay/machines/" + machine["id"], "DELETE", actor=name, status=204)
443 finally:
444 for identity in keycloak.request("/admin/realms/master/users?username=" + name + "&exact=true"):
445 keycloak.request("/admin/realms/master/users/" + identity["id"], "DELETE")
446 assert not keycloak.request("/admin/realms/master/users?username=" + name + "&exact=true")
447 result["owned_users_and_machines_removed"] = True
448 if args.output:
449 args.output.write_text(json.dumps(result, indent=2) + "\n")
450 print(json.dumps(result))
451
452
453if __name__ == "__main__":
454 main()
tools/dashboard-routing-test.py+18-18
......@@ -22,8 +22,8 @@ def main():
2222 parser.add_argument("--output", type=Path)
2323 args = parser.parse_args()
2424 proof = uuid.uuid4().hex + uuid.uuid4().hex
25 container = "studio-dashboard-routing-test-" + uuid.uuid4().hex[:12]
26 fixture_id = "studio-routing-fixture-" + uuid.uuid4().hex[:12]
25 container = "snowglobe-dashboard-routing-test-" + uuid.uuid4().hex[:12]
26 fixture_id = "snowglobe-routing-fixture-" + uuid.uuid4().hex[:12]
2727 trace_id = uuid.uuid4().hex
2828 redirected = []
2929
......@@ -46,19 +46,19 @@ def main():
4646 self.send_header("Content-Type", "application/json")
4747 self.end_headers()
4848 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"),
5050 "user": self.headers.get("User-Name")}).encode())
5151
5252 def log_message(self, *args):
5353 pass
5454
55 with tempfile.TemporaryDirectory(prefix="studio-dashboard-routing-", dir="/run") as temporary, HTTPServer(("127.0.0.1", 0), Fixture) as fixture:
55 with tempfile.TemporaryDirectory(prefix="snowglobe-dashboard-routing-", dir="/run") as temporary, HTTPServer(("127.0.0.1", 0), Fixture) as fixture:
5656 root = Path(temporary)
5757 threading.Thread(target=fixture.serve_forever, daemon=True).start()
5858 token = root / "proxy.token"
5959 token.write_text(proof)
6060 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())
6262 for file in [token, readonly]:
6363 os.chown(file, 0, 65534)
6464 file.chmod(0o440)
......@@ -71,14 +71,14 @@ def main():
7171 continue
7272 else:
7373 raise AssertionError("no fixture listener available")
74 os.environ.update(STUDIO_DOMAIN="studio.test", STUDIO_INTERNAL_PORT=str(port),
75 STUDIO_DASHBOARD_PORT="7072", STUDIO_PROXY_TOKEN_FILE=str(token))
74 os.environ.update(SNOWGLOBE_DOMAIN="snowglobe.test", SNOWGLOBE_INTERNAL_PORT=str(port),
75 SNOWGLOBE_DASHBOARD_PORT="7072", SNOWGLOBE_PROXY_TOKEN_FILE=str(token))
7676 real_nomad = router.nomad
7777
7878 def discovery(path, supplied):
7979 if path in ["/v1/service/routing-fixture", "/v1/service/qbittorrent"]:
8080 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"]}]
8282 if path == "/v1/allocation/routing-fixture/checks":
8383 return {"ready": {"Status": "failure"}}
8484 value = real_nomad(path, supplied)
......@@ -87,7 +87,7 @@ def main():
8787 return value
8888
8989 router.nomad = discovery
90 host = "dashboard.internal.studio.test"
90 host = "dashboard.internal.snowglobe.test"
9191 content = router.render(Path(router.TOKEN).read_text().strip())
9292 gateway = content[content.index(host + ":" + str(port) + " {"):]
9393 config = root / "Caddyfile"
......@@ -107,7 +107,7 @@ def main():
107107 time.sleep(.1)
108108 ca.chmod(0o444)
109109 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="))
111111 client = f"""import json, ssl, time, urllib.request, urllib.error
112112base = 'https://{host}:{port}'
113113proof = open('/proxy.token').read().strip()
......@@ -116,7 +116,7 @@ context = ssl.create_default_context(cafile='/ca.crt')
116116def request(path, supplied=proof, method='GET', body=None, content_type='application/json'):
117117 headers = {{'User-Name': 'forged', 'X-Nomad-Token': nomad, 'Content-Type': content_type}}
118118 if supplied is not None:
119 headers['Studio-Proxy-Token'] = supplied
119 headers['Snowglobe-Proxy-Token'] = supplied
120120 query = urllib.request.Request(base + path, data=body, headers=headers, method=method)
121121 try:
122122 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']:
127127 assert request('/nomad/v1/services', supplied)[0] == 403
128128status, body = request('/nomad/v1/services')
129129assert status == 200 and isinstance(json.loads(body), list), (status, body)
130assert request('/nomad/v1/var/studio-routing-fixture')[0] == 403
131status, body = request('/nomad/v1/jobs', method='POST', body=json.dumps({{'Job': {{'ID': 'studio-routing-fixture', 'Name': 'studio-routing-fixture', 'Type': 'service', 'Datacenters': ['clover'], 'TaskGroups': [{{'Name': 'fixture', 'Count': 0, 'Tasks': [{{'Name': 'probe', 'Driver': 'podman', 'Config': {{'image': 'alpine:3.22'}}, 'Resources': {{'CPU': 100, 'MemoryMB': 32}}}}]}}]}}}}).encode())
130assert request('/nomad/v1/var/snowglobe-routing-fixture')[0] == 403
131status, body = request('/nomad/v1/jobs', method='POST', body=json.dumps({{'Job': {{'ID': 'snowglobe-routing-fixture', 'Name': 'snowglobe-routing-fixture', 'Type': 'service', 'Datacenters': ['clover'], 'TaskGroups': [{{'Name': 'fixture', 'Count': 0, 'Tasks': [{{'Name': 'probe', 'Driver': 'podman', 'Config': {{'image': 'alpine:3.22'}}, 'Resources': {{'CPU': 100, 'MemoryMB': 32}}}}]}}]}}}}).encode())
132132assert status == 403, (status, body)
133133assert request('/services/unknown-fixture/health')[0] == 404
134134for service in ['victoria-metrics', 'victoria-logs', 'victoria-traces']:
......@@ -139,7 +139,7 @@ result = json.loads(body)
139139assert status == 200 and result == {{'path': '/probe?fixture=1', 'host': '127.0.0.1:{fixture.server_port}', 'proof': None, 'user': None}}, result
140140# Keep fixture samples outside VictoriaMetrics' query latency window.
141141at = time.time() - 60
142metric = 'studio_service_cpu_cores{{service="{fixture_id}"}} 0.125 ' + str(int(at * 1000)) + '\\n'
142metric = 'snowglobe_service_cpu_cores{{service="{fixture_id}"}} 0.125 ' + str(int(at * 1000)) + '\\n'
143143status, body = request('/services/victoria-metrics/api/v1/import/prometheus', method='POST', body=metric.encode(), content_type='text/plain')
144144assert status == 204, (status, body)
145145row = {{'_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()
172172 "--add-host=" + host + ":host-gateway", "--publish=127.0.0.1::7072",
173173 "--volume=" + str(ca) + ":/ca.crt:ro", "--volume=" + str(token) + ":/proxy.token:ro",
174174 "--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",
176 "--env=STUDIO_CA_BUNDLE=/ca.crt", f"--env=STUDIO_INTERNAL_URL=https://{host}:{port}",
177 "--env=STUDIO_DATA_DIR=/data", "--env=STUDIO_DOMAIN=studio.test", args.image)
175 "--env=SNOWGLOBE_PROXY_TOKEN_FILE=/proxy.token", "--env=SNOWGLOBE_NOMAD_TOKEN_FILE=/nomad.token",
176 "--env=SNOWGLOBE_CA_BUNDLE=/ca.crt", f"--env=SNOWGLOBE_INTERNAL_URL=https://{host}:{port}",
177 "--env=SNOWGLOBE_DATA_DIR=/data", "--env=SNOWGLOBE_DOMAIN=snowglobe.test", args.image)
178178 info = json.loads(shell("podman", "inspect", container))[0]
179179 app_port = info["NetworkSettings"]["Ports"]["7072/tcp"][0]["HostPort"]
180180
181181 def dashboard(path):
182182 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",
184184 })
185185 with urllib.request.urlopen(request, timeout=20) as response:
186186 return json.load(response)
tools/dashboard-run.py+9-9
......@@ -28,7 +28,7 @@ FIELDS = {
2828ACTIONS = {"deploy", "destroy", "rollback", "start", "stop", "restart", "secret-set", "secret-rotate"}
2929MAX_LOG = 1024 * 1024
3030MAX_METADATA = 65536
31HOST_STATE = Path(os.environ.get("STUDIO_HOST_STATE_ROOT", "/var/lib/studio/host"))
31HOST_STATE = Path(os.environ.get("SNOWGLOBE_HOST_STATE_ROOT", "/var/lib/snowglobe/host"))
3232
3333
3434class Error(Exception):
......@@ -98,7 +98,7 @@ def nomad(path, method="GET", body=None, timeout=10):
9898def secret(action, target, key, value=None):
9999 service(target, key)
100100 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", "[]"))
102102 if not isinstance(specs, list):
103103 raise Error(502, "The service's secret names couldn't be read. Deploy its current release again.")
104104 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):
160160 version = release.current_release()
161161 if version is None:
162162 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]
164164 if action == "rollback":
165165 saved = entry(target)
166166 version = saved["release"]
......@@ -177,7 +177,7 @@ def command(action, target, key=None):
177177 if not isinstance(version, str):
178178 raise Error(409, "This stage has no release. Stage it again.")
179179 root = release.check_release(version)
180 return [sys.executable, str(root / "tools/studio.py"), "destroy", target]
180 return [sys.executable, str(release.transition.layout(root)["script"]), "destroy", target]
181181
182182
183183def last():
......@@ -201,7 +201,7 @@ def run(identity):
201201 raise Error(404, "That run is no longer available.")
202202 code = read(root / (identity + ".exit"), 64)
203203 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],
205205 capture_output=True, text=True, timeout=5)
206206 state = dict(line.split("=", 1) for line in shown.stdout.splitlines() if "=" in line)
207207 if shown.returncode and state.get("LoadState") != "not-found":
......@@ -237,10 +237,10 @@ def start(action, target, key=None, value=None):
237237 pending = HOST_STATE / "last-run.pending"
238238 pending.write_text(json.dumps(metadata) + "\n")
239239 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",
241241 "--property=RuntimeMaxSec=3600", "--property=TimeoutStopSec=10",
242242 "--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_"))
244244 subprocess.run([*args, "--", sys.executable, str(Path(__file__)), identity, action, target, *([key] if key is not None else [])],
245245 check=True, capture_output=True, timeout=10)
246246 except BaseException:
......@@ -256,7 +256,7 @@ def handle(request):
256256 raise Error(400, "Choose a secret from this service's list.")
257257 service(request["service"], request["key"])
258258 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",
260260 "--property=MemoryMax=128M", "--property=TasksMax=8", "--property=ProtectSystem=strict",
261261 "--property=ProtectHome=yes", "--property=NoNewPrivileges=yes", "--property=CapabilityBoundingSet=",
262262 "--property=RestrictAddressFamilies=AF_INET AF_UNIX", "--property=IPAddressDeny=any",
......@@ -372,7 +372,7 @@ def worker(identity, action, target, key=None):
372372 try:
373373 argv = command(action, target, key)
374374 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
376376 if action in {"stop", "restart"}:
377377 environment = {**os.environ, "NOMAD_TOKEN": read(release.STATE / "nomad.token", missing="").strip()}
378378 if not environment["NOMAD_TOKEN"]:
tools/dashboard-shale-attribution-test.py+9-9
......@@ -127,14 +127,14 @@ def main():
127127
128128 host_thread = threading.Thread(target=host_requests, daemon=True)
129129 host_thread.start()
130 origin = 'https://globe.studio.test'
131 environment = {**os.environ, 'PORT': str(port), 'STUDIO_LISTEN_ADDRESS': '127.0.0.1',
132 'STUDIO_DATA_DIR': str(root / 'data'), 'STUDIO_PUBLIC_ORIGIN': origin,
133 'STUDIO_AUTH_RP_ID': 'studio.test', 'STUDIO_FILE_ORIGIN': 'https://file.studio.test',
134 'STUDIO_SHALE_URL': 'https://localhost:' + str(backend.server_port),
135 'STUDIO_CA_BUNDLE': str(cert), 'STUDIO_REPO': str(Path(__file__).resolve().parent.parent),
136 'STUDIO_AUTH_REQUIRED': '0', 'STUDIO_HOST_SOCKET': str(root / 'host.sock')}
137 for name in ('STUDIO_PROXY_TOKEN_FILE', 'STUDIO_INTERNAL_URL', 'STUDIO_YT_STATE', 'STUDIO_INDEX_POOL'):
130 origin = 'https://globe.snowglobe.test'
131 environment = {**os.environ, 'PORT': str(port), 'SNOWGLOBE_LISTEN_ADDRESS': '127.0.0.1',
132 'SNOWGLOBE_DATA_DIR': str(root / 'data'), 'SNOWGLOBE_PUBLIC_ORIGIN': origin,
133 'SNOWGLOBE_AUTH_RP_ID': 'snowglobe.test', 'SNOWGLOBE_FILE_ORIGIN': 'https://file.snowglobe.test',
134 'SNOWGLOBE_SHALE_URL': 'https://localhost:' + str(backend.server_port),
135 'SNOWGLOBE_CA_BUNDLE': str(cert), 'SNOWGLOBE_REPO': str(Path(__file__).resolve().parent.parent),
136 'SNOWGLOBE_AUTH_REQUIRED': '0', 'SNOWGLOBE_HOST_SOCKET': str(root / 'host.sock')}
137 for name in ('SNOWGLOBE_PROXY_TOKEN_FILE', 'SNOWGLOBE_INTERNAL_URL', 'SNOWGLOBE_YT_STATE', 'SNOWGLOBE_INDEX_POOL'):
138138 environment.pop(name, None)
139139 with (root / 'server.log').open('wb') as log:
140140 server = subprocess.Popen([str(args.binary.resolve())], env=environment, stdout=log, stderr=log)
......@@ -162,7 +162,7 @@ def main():
162162 def call(name, fields, error=False):
163163 connection = http.client.HTTPConnection('127.0.0.1', port, timeout=15)
164164 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'})
166166 response = connection.getresponse()
167167 body = response.read()
168168 connection.close()
tools/dashboard-shale-link-test.py deleted-463
......@@ -1,463 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import base64
4from concurrent.futures import ThreadPoolExecutor
5import copy
6import http.cookiejar
7import hashlib
8import importlib
9import json
10import math
11from pathlib import Path
12import sqlite3
13import ssl
14import subprocess
15import sys
16import time
17import urllib.error
18import urllib.parse
19import urllib.request
20import uuid
21
22
23class NoRedirect(urllib.request.HTTPRedirectHandler):
24 def redirect_request(self, request, fp, code, message, headers, newurl):
25 return None
26
27
28def main():
29 parser = argparse.ArgumentParser()
30 parser.add_argument('--url', required=True)
31 parser.add_argument('--proof-file', type=Path, required=True)
32 parser.add_argument('--data-dir', type=Path, required=True)
33 parser.add_argument('--restart-unit', required=True)
34 parser.add_argument('--shale-origin', required=True)
35 parser.add_argument('--shale-database', type=Path, required=True)
36 parser.add_argument('--shale-container', required=True)
37 parser.add_argument('--output', type=Path)
38 args = parser.parse_args()
39 if args.output:
40 args.output.unlink(missing_ok=True)
41 repo = Path(__file__).resolve().parent.parent
42 sys.path.insert(0, str(repo / 'service/keycloak'))
43 from api import Keycloak, LoopbackHTTPS
44 Page = importlib.import_module('dashboard-shale-test').Page
45 keycloak = Keycloak('keycloak.studio.test', importlib.import_module('dashboard-run').secret('get', 'keycloak', 'password'), attempts=1)
46 context = ssl.create_default_context(cafile='/var/lib/studio/ca-bundle.crt')
47 origin = 'https://globe.studio.test'
48 proof = args.proof_file.read_text().strip()
49 marker = 'shale-link-' + uuid.uuid4().hex
50 accounts = [(marker + '-one', uuid.uuid4().hex + 'A1!'), (marker + '-two', uuid.uuid4().hex + 'A1!'),
51 ('ai', uuid.uuid4().hex + 'A1!')]
52 ids = []
53 sessions = {name: uuid.uuid4().hex + uuid.uuid4().hex for name, _ in accounts}
54
55 class TLS(urllib.request.HTTPSHandler):
56 def https_open(self, request):
57 parsed = urllib.parse.urlsplit(request.full_url)
58 assert parsed.netloc in ('keycloak.studio.test', urllib.parse.urlsplit(args.shale_origin).netloc)
59 return self.do_open(LoopbackHTTPS, request, context=context)
60
61 def browser():
62 cookies = http.cookiejar.CookieJar()
63 return urllib.request.build_opener(TLS(), NoRedirect(), urllib.request.HTTPCookieProcessor(cookies)), cookies
64
65 def request(client, url, method='GET', body=None, headers=None, status=None):
66 try:
67 response = client.open(urllib.request.Request(url, method=method, data=body, headers=headers or {}), timeout=45)
68 except urllib.error.HTTPError as error:
69 response = error
70 with response:
71 value = response.read(4 * 1024 * 1024 + 1)
72 assert len(value) <= 4 * 1024 * 1024
73 if status is not None:
74 assert response.status == status, (urllib.parse.urlsplit(url).path, response.status, value[:300])
75 return response.status, response.headers, value.decode()
76
77 def api(actor, method='GET', path='/api/mcp', status=200, body=None):
78 _, _, body = request(urllib.request.build_opener(NoRedirect()), args.url + path, method,
79 body=json.dumps(body).encode() if body is not None else None,
80 headers={'Host': 'globe.studio.test', 'Studio-Proxy-Token': proof, 'User-Name': actor,
81 'Cookie': '__Host-snow-session=' + sessions[actor],
82 'User-Groups': '', 'Origin': origin, 'Content-Type': 'application/json'}, status=status)
83 return json.loads(body) if body and status < 400 else body or None
84
85 def records(prefix):
86 path = args.data_dir / 'connections.sqlite'
87 with sqlite3.connect(path.as_uri() + '?mode=ro', uri=True) as db:
88 return {key: json.loads(value) for key, value in db.execute('SELECT key,value FROM records WHERE substr(key,1,?)=?', (len(prefix), prefix))}
89
90 def session(index):
91 return records('shale-session:').get('shale-session:' + ids[index])
92
93 def session_count(index):
94 with sqlite3.connect(args.shale_database.as_uri() + '?mode=ro', uri=True) as db:
95 return db.execute('SELECT count(*) FROM sessions s JOIN users u ON s.user=u.id WHERE u.snowflake=?', (ids[index],)).fetchone()[0]
96
97 def start(index, pending=None):
98 target = api(accounts[index][0], 'POST', '/api/mcp/shale', body={'request': pending} if pending else {})['redirect']
99 assert target.startswith(args.shale_origin + '/-/studio-mcp/')
100 client, cookies = browser()
101 _, headers, _ = request(client, target, status=302)
102 link_cookies = [cookie for cookie in cookies if cookie.name == 'studio_mcp_shale_link']
103 assert len(link_cookies) == 1
104 cookie = link_cookies[0]
105 assert not cookie.domain_specified and cookie.secure and cookie.path == '/-/callback'
106 assert cookie.has_nonstandard_attr('HttpOnly') and cookie.get_nonstandard_attr('SameSite') == 'Lax'
107 assert headers.get('Referrer-Policy') == 'no-referrer'
108 assert headers.get('Cache-Control') == 'no-store'
109 request(browser()[0], target, status=410)
110 return client, cookies, headers['Location'], target
111
112 def authorize(client, authorization, index):
113 status, headers, body = request(client, authorization, status=200)
114 form = next(form for form in Page(body).forms if any(field.get('name') == 'password' for field in form['fields']))
115 target = urllib.parse.urljoin(authorization, form['action'])
116 assert urllib.parse.urlsplit(target).hostname == 'keycloak.studio.test'
117 fields = {field['name']: field.get('value', '') for field in form['fields'] if field.get('name')}
118 fields.update(username=accounts[index][0], password=accounts[index][1])
119 status, headers, body = request(client, target, 'POST', urllib.parse.urlencode(fields).encode(),
120 {'Content-Type': 'application/x-www-form-urlencoded', 'Origin': 'https://keycloak.studio.test'})
121 for _ in range(6):
122 assert status in (302, 303), status
123 target = urllib.parse.urljoin(target, headers['Location'])
124 parts = urllib.parse.urlsplit(target)
125 if parts.netloc == urllib.parse.urlsplit(args.shale_origin).netloc:
126 assert parts.path == '/-/callback' and 'code' in dict(urllib.parse.parse_qsl(parts.query))
127 return target
128 assert parts.netloc == 'keycloak.studio.test'
129 status, headers, body = request(client, target)
130 raise AssertionError('too many sign-in redirects')
131
132 def finish(client, target, status=303, pending=None):
133 _, headers, _ = request(client, target, status=status)
134 assert headers.get('Cache-Control') == 'no-store'
135 assert all(not cookie.startswith('SessionID=') for cookie in headers.get_all('Set-Cookie', []))
136 assert any('studio_mcp_shale_link=;' in cookie and 'Max-Age=0' in cookie for cookie in headers.get_all('Set-Cookie', []))
137 if status == 303:
138 assert headers['Location'] == origin + ('/connect/' + pending if pending else '/mcp/settings/shale')
139
140 def backend_session(value, status):
141 return request(browser()[0], args.shale_origin + '/-/settings', headers={'Cookie': 'SessionID=' + value['session']}, status=status)
142
143 def link(index, pending=None):
144 client, cookies, authorization, _ = start(index, pending)
145 target = authorize(client, authorization, index)
146 captured = http.cookiejar.CookieJar()
147 for cookie in cookies:
148 captured.set_cookie(copy.copy(cookie))
149 finish(client, target, pending=pending)
150 replay = urllib.request.build_opener(TLS(), NoRedirect(), urllib.request.HTTPCookieProcessor(captured))
151 finish(replay, target, 410)
152 result = session(index)
153 assert result and result['origin'] == args.shale_origin + '/'
154 assert result['linkedAt'] > 0 and len(result['session']) > 20
155 overview = api(accounts[index][0])['shale']
156 assert overview is not None and set(overview) == {'linkedAt'}, overview
157 assert math.isclose(overview['linkedAt'], result['linkedAt'], rel_tol=0, abs_tol=1e-6), overview
158 assert session_count(index) == 1
159 backend_session(result, 200)
160 return result
161
162 def public(path, method='GET', body=None, status=200, token=None, form=False):
163 headers = {'Host': 'globe.studio.test', 'Content-Type': 'application/x-www-form-urlencoded' if form else 'application/json'}
164 if token:
165 headers.update({'Authorization': 'Bearer ' + token, 'Accept': 'application/json, text/event-stream',
166 'MCP-Protocol-Version': '2025-11-25'})
167 encoded = urllib.parse.urlencode(body).encode() if form else json.dumps(body).encode() if body is not None else None
168 _, headers, body = request(urllib.request.build_opener(NoRedirect()), args.url + path, method, encoded, headers, status)
169 return (json.loads(body) if body and headers.get('Content-Type', '').startswith('application/json') else body or None), headers
170
171 def pending_request(client, index, scope):
172 verifier = uuid.uuid4().hex + uuid.uuid4().hex
173 challenge = base64.urlsafe_b64encode(hashlib.sha256(verifier.encode()).digest()).decode().rstrip('=')
174 _, headers = public('/oauth/authorize?' + urllib.parse.urlencode({'response_type': 'code',
175 'client_id': client['client_id'], 'redirect_uri': client['redirect_uris'][0], 'code_challenge_method': 'S256',
176 'code_challenge': challenge, 'resource': origin + '/mcp/shale', 'scope': scope, 'state': marker}), status=302)
177 pending = urllib.parse.urlsplit(headers['Location']).path.removeprefix('/connect/')
178 details = api(accounts[index][0], path='/api/mcp/consent/' + pending)
179 assert details['client'] == marker
180 api(accounts[1 if index == 0 else 0][0], path='/api/mcp/consent/' + pending, status=403)
181 return pending, verifier, details
182
183 def consent(client, index, repository, scope):
184 pending, verifier, details = pending_request(client, index, scope)
185 available = {r['id'] for r in details['resources']}
186 assert details['linked'] and (repository == 'all' or repository in available), details
187 if index == 0:
188 assert {'alpha', 'beta'} <= available, details
189 path = '/api/mcp/consent/' + pending
190 api(accounts[index][0], 'POST', path, 403, {'resources': ['outside-grant']})
191 api(accounts[index][0], 'POST', path, 403 if len(available) >= 2 else 400, {'resources': [repository, repository]})
192 result = api(accounts[index][0], 'POST', path, body={'resources': 'all' if repository == 'all' else [repository]})
193 query = urllib.parse.parse_qs(urllib.parse.urlsplit(result['redirect']).query)
194 assert query['state'] == [marker]
195 tokens, _ = public('/oauth/token', 'POST', {'grant_type': 'authorization_code', 'client_id': client['client_id'],
196 'redirect_uri': client['redirect_uris'][0], 'code_verifier': verifier, 'code': query['code'][0],
197 'resource': origin + '/mcp/shale'}, form=True)
198 return tokens
199
200 def rpc(token, method, params=None, error=False):
201 value, _ = public('/mcp/shale', 'POST', {'jsonrpc': '2.0', 'id': 1, 'method': method,
202 **({'params': params} if params is not None else {})}, token=token)
203 assert 'error' not in value, value
204 value = value['result']
205 assert bool(value.get('isError')) == error, value
206 return value if error or 'structuredContent' not in value else value['structuredContent']
207
208 def call(token, tool, fields=None, error=False):
209 return rpc(token, 'tools/call', {'name': tool, 'arguments': fields or {}}, error=error)
210
211 def backend(index, suffix, fields=None):
212 headers = {'Cookie': 'SessionID=' + session(index)['session']}
213 if fields is not None:
214 headers.update({'Origin': args.shale_origin, 'Referer': args.shale_origin + suffix,
215 'Content-Type': 'application/x-www-form-urlencoded'})
216 return request(browser()[0], args.shale_origin + suffix, 'POST' if fields is not None else 'GET',
217 urllib.parse.urlencode(fields).encode() if fields is not None else None, headers)
218
219 def submit_backend(index, path, changes):
220 status, _, body = backend(index, path)
221 assert status == 200, (path, status, body[:700])
222 forms = [form for form in Page(body).forms if changes.keys() <= {field.get('name') for field in form['fields']}
223 and ('t' not in changes or any(field.get('name') == 't' and field.get('value') == changes['t'] for field in form['fields']))]
224 assert len(forms) == 1, path
225 form = forms[0]
226 assert urllib.parse.urljoin(args.shale_origin + path, form.get('action', '')) == args.shale_origin + path
227 fields = {field['name']: field.get('value', '') for field in form['fields']
228 if field.get('name') and field.get('type') == 'hidden'}
229 fields.update(timezone='UTC', tzoffset='+00:00', **changes)
230 return backend(index, path, fields)
231
232 def repository(index, name):
233 status, headers, _ = submit_backend(1, '/-/new', {'name': name, 'description': 'Owned Shale MCP fixture', 'access': 'private'})
234 assert status == 303, status
235 target = urllib.parse.urlsplit(urllib.parse.urljoin(args.shale_origin, headers['Location']))
236 assert target.netloc == urllib.parse.urlsplit(args.shale_origin).netloc
237 assert target.path.rstrip('/') == '/' + name, target.path
238 if index == 0:
239 with sqlite3.connect(args.shale_database) as db:
240 identity = db.execute('SELECT id FROM users WHERE snowflake=?', (ids[index],)).fetchone()[0]
241 assert db.execute('UPDATE repositories SET owner=? WHERE name=?', (identity, name)).rowcount == 1
242
243 for name, _ in accounts:
244 assert not keycloak.request('/admin/realms/master/users?username=' + name + '&exact=true'), 'Fixture account already exists: ' + name
245 try:
246 for name, credential in accounts:
247 keycloak.request('/admin/realms/master/users', 'POST', {'username': name, 'firstName': name,
248 'lastName': 'Fixture', 'email': name + '@fixture.invalid', 'emailVerified': True, 'enabled': True,
249 'credentials': [{'type': 'password', 'value': credential, 'temporary': False}]})
250 found = keycloak.request('/admin/realms/master/users?username=' + name + '&exact=true')
251 assert len(found) == 1
252 ids.append(found[0]['id'])
253 with sqlite3.connect(args.data_dir / 'accounts.sqlite') as db:
254 profile = {key: found[0].get(key) for key in ['username', 'firstName', 'lastName', 'email', 'emailVerified', 'enabled']}
255 profile['requiredActions'] = []
256 db.execute('INSERT INTO users(id,profile) VALUES (?,?)', (ids[-1], json.dumps(profile)))
257 stamp = int(time.time())
258 db.execute('INSERT INTO sessions VALUES (?,?,?,?,?,?,?,?)',
259 (hashlib.sha256(sessions[name].encode()).hexdigest(), ids[-1], 'dashboard', stamp + 3600, '127.0.0.1', stamp, stamp, stamp))
260 assert all(api(name)['shale'] is None for name, _ in accounts)
261 api(accounts[0][0], 'POST', '/api/mcp/shale', status=200)
262 old_target = api(accounts[0][0], 'POST', '/api/mcp/shale')['redirect']
263 latest_target = api(accounts[0][0], 'POST', '/api/mcp/shale')['redirect']
264 request(browser()[0], old_target, status=410)
265 with sqlite3.connect(args.data_dir / 'connections.sqlite') as db:
266 db.execute("UPDATE records SET expires=1 WHERE substr(key,1,11)='shale-link:'")
267 request(browser()[0], latest_target, status=410)
268 client, cookies, authorization, _ = start(0)
269 request(client, args.shale_origin + '/-/callback?state=other&code=fixture', status=403)
270 request(browser()[0], args.url + '/oauth/shale/link/' + 'a' * 43, headers={'Host': 'globe.studio.test'}, status=403)
271 client, cookies, authorization, _ = start(0)
272 finish(client, authorize(client, authorization, 1), 403)
273 assert session(0) is None and session(1) is None and session_count(1) == 0
274 oauth_client, _ = public('/oauth/register', 'POST', {'client_name': marker,
275 'redirect_uris': ['http://127.0.0.1:29999/shale-callback'], 'token_endpoint_auth_method': 'none'}, status=201)
276 pending, _, details = pending_request(oauth_client, 0, 'shale:read')
277 assert not details['linked'] and not details['resources']
278 api(accounts[1][0], 'POST', '/api/mcp/shale', 403, {'request': pending})
279 first = link(0, pending)
280 api(accounts[0][0], 'POST', '/api/mcp/consent/' + pending, body={'deny': True})
281 assert api(accounts[1][0])['shale'] is None
282 second = link(1)
283 assert first['session'] != second['session']
284 new_first = link(0)
285 assert new_first['session'] != first['session']
286 backend_session(first, 303)
287 backend_session(second, 200)
288 assert session_count(0) == 1
289 for index, name in [(0, 'alpha'), (0, 'beta'), (1, 'foreign')]:
290 repository(index, name)
291 readonly = consent(oauth_client, 0, 'alpha', 'shale:read offline_access')
292 writing = consent(oauth_client, 0, 'alpha', 'shale:read shale:write offline_access')
293 other = consent(oauth_client, 1, 'foreign', 'shale:read shale:write')
294 read = readonly['access_token']
295 write = writing['access_token']
296 initialized = rpc(read, 'initialize', {'protocolVersion': '2025-11-25', 'capabilities': {},
297 'clientInfo': {'name': marker, 'version': '1'}})
298 assert initialized['capabilities']['tools'] == {}
299 assert 'Assisted-by:' in initialized['instructions'] and 'model' in initialized['instructions']
300 listed = rpc(read, 'tools/list')
301 assert listed["ttlMs"] == 0 and listed["cacheScope"] == "private", listed
302 tools = listed["tools"]
303 assert {tool['name'] for tool in tools} == {'list_repositories', 'list_issues', 'get_issue', 'create_issue',
304 'comment_issue', 'set_issue_status', 'set_issue_title', 'list_labels', 'create_label', 'update_label', 'delete_label', 'set_issue_labels'}
305 assert all('model' in tool['inputSchema']['required'] for tool in tools
306 if not tool['annotations']['readOnlyHint'])
307 create_schema = next(tool['inputSchema'] for tool in tools if tool['name'] == 'create_issue')
308 assert create_schema['properties']['status']['enum'] == ['todo', 'triage']
309 assert all(tool['annotations']['readOnlyHint'] == tool['name'].startswith(('list_', 'get_')) for tool in tools)
310 assert {repo['id'] for repo in call(read, 'list_repositories')['repositories']} == {'alpha'}
311 grant = next(value for value in records('grant:').values() if value['scopes'] == ['shale:read', 'offline_access'] and value['user'] == ids[0])
312 endpoint = '/api/mcp/connections/' + grant['id']
313 details = api(accounts[0][0], path=endpoint)
314 assert details['linked'] and details['selected'] == ['alpha']
315 assert {'alpha', 'beta'} <= {resource['id'] for resource in details['resources']}
316 api(accounts[1][0], path=endpoint, status=404)
317 api(accounts[1][0], 'POST', endpoint, 404, {'resources': ['foreign']})
318 api(accounts[0][0], 'POST', endpoint, 403, {'resources': ['foreign']})
319 api(accounts[0][0], 'POST', endpoint, 403, {'resources': ['alpha', 'alpha']})
320 api(accounts[0][0], 'POST', endpoint, 400, {'resources': []})
321 api(accounts[0][0], 'POST', endpoint, 204, {'resources': ['beta']})
322 assert {repo['id'] for repo in call(read, 'list_repositories')['repositories']} == {'beta'}
323 call(read, 'list_issues', {'repository': 'alpha'}, error=True)
324 call(read, 'create_issue', {'repository': 'beta', 'title': 'REFUSED'}, error=True)
325 api(accounts[0][0], 'POST', endpoint, 204, {'resources': 'all'})
326 assert api(accounts[0][0], path=endpoint)['selected'] == 'all'
327 assert {repo['id'] for repo in call(read, 'list_repositories')['repositories']} == {'alpha', 'beta'}
328 call(read, 'list_issues', {'repository': 'foreign'}, error=True)
329 call(read, 'create_issue', {'repository': 'beta', 'title': 'REFUSED'}, error=True)
330 nested = 'userscripts/nested-fixture'
331 repository(0, nested)
332 assert {repo['id'] for repo in call(read, 'list_repositories')['repositories']} == {'alpha', 'beta', nested}
333 assert not call(read, 'list_issues', {'repository': nested})['issues']
334 api(accounts[0][0], 'POST', endpoint, 204, {'resources': [nested]})
335 assert {repo['id'] for repo in call(read, 'list_repositories')['repositories']} == {nested}
336 call(read, 'list_issues', {'repository': 'beta'}, error=True)
337 api(accounts[0][0], 'POST', endpoint, 204, {'resources': ['alpha']})
338
339 assert {repo['id'] for repo in call(other['access_token'], 'list_repositories')['repositories']} == {'foreign'}
340 all_repositories = consent(oauth_client, 0, 'all', 'shale:read')
341 assert {repo['id'] for repo in call(all_repositories['access_token'], 'list_repositories')['repositories']} == {'alpha', 'beta', nested}
342 assert not call(read, 'list_issues', {'repository': 'alpha'})['issues']
343 for token, name in [(read, 'beta'), (read, 'foreign'), (other['access_token'], 'alpha'),
344 (write, 'alpha/../foreign'), (write, 'https://other.invalid')]:
345 call(token, 'list_issues', {'repository': name}, error=True)
346 call(read, 'create_issue', {'repository': 'alpha', 'title': 'REFUSED'}, error=True)
347 call(write, 'create_issue', {'repository': 'alpha', 'title': 'REFUSED', 'url': 'https://other.invalid'}, error=True)
348 public('/mcp/observability', 'POST', {'jsonrpc': '2.0', 'id': 1, 'method': 'tools/list'}, token=read, status=401)
349 call(write, 'create_issue', {'repository': 'alpha', 'title': 'REFUSED'}, error=True)
350 title = 'MCP <angle> & Unicode ☃'
351 status, _, _ = submit_backend(0, '/alpha/issues/new', {'title': title,
352 'description': 'Owned body <script>fixture</script> & Unicode ☃'})
353 assert status == 303
354 created = call(read, 'get_issue', {'repository': 'alpha', 'id': 1})['issue']
355 assert created['title'] == title and created['id'] == 1
356 assert len(created['comments']) == 1 and 'Unicode ☃' in created['comments'][0]['text']
357 assert '<script>fixture</script>' in created['comments'][0]['text']
358 listed = call(read, 'list_issues', {'repository': 'alpha', 'q': 'is:open'})['issues'][0]
359 assert listed['title'] == title and listed['status'] == created['status']
360 rejected = call(read, 'list_issues', {'repository': 'alpha', 'q': 'Unicode'}, error=True)
361 assert 'filter syntax' in rejected['content'][0]['text'], rejected
362 issue_fields = {'repository': 'alpha', 'id': created['id']}
363 status, _, _ = submit_backend(0, '/alpha/issues/labels', {'name': 'Owned ☃', 'description': 'Fixture label', 'color': '#ff40ff'})
364 assert status == 303
365 status, _, _ = submit_backend(0, '/alpha/issues/1', {'t': 'labels', 'labels': '1'})
366 assert status == 303
367 changed = call(read, 'get_issue', issue_fields)['issue']
368 assert changed['labels'] == ['Owned ☃'], changed
369 with sqlite3.connect(args.shale_database) as db:
370 rows = db.execute('SELECT id FROM users WHERE snowflake=?', (ids[1],)).fetchall()
371 assert len(rows) == 1
372 original_owner = db.execute("SELECT owner FROM repositories WHERE name='alpha'").fetchone()[0]
373 db.execute("UPDATE repositories SET owner=?,access_git_webui='private',access_issues='private' WHERE name='alpha'", (rows[0][0],))
374 try:
375 call(read, 'get_issue', issue_fields, error=True)
376 call(write, 'create_issue', {'repository': 'alpha', 'title': 'REFUSED'}, error=True)
377 finally:
378 with sqlite3.connect(args.shale_database) as db:
379 db.execute("UPDATE repositories SET owner=?,access_git_webui='public',access_issues='public' WHERE name='alpha'", (original_owner,))
380 with sqlite3.connect(args.shale_database) as db:
381 assert db.execute("SELECT count(*) FROM issues WHERE title='REFUSED'").fetchone()[0] == 0
382 subprocess.run(['systemctl', 'restart', args.restart_unit], check=True, capture_output=True, timeout=30)
383 assert session(0) == new_first and session(1) == second
384 assert math.isclose(api(accounts[0][0])['shale']['linkedAt'], new_first['linkedAt'], rel_tol=0, abs_tol=1e-6)
385 backend_session(new_first, 200)
386 assert call(read, 'get_issue', issue_fields)['issue'] == changed
387 backend(0, '/-/logout')
388 call(read, 'get_issue', issue_fields, error=True)
389 new_first = link(0)
390 assert call(read, 'get_issue', issue_fields)['issue'] == changed
391 client, cookies, authorization, _ = start(0)
392 target = authorize(client, authorization, 0)
393 subprocess.run(['podman', 'pause', args.shale_container], check=True, capture_output=True)
394 try:
395 with ThreadPoolExecutor(max_workers=2) as pool:
396 callback = pool.submit(finish, client, target, 410)
397 deadline = time.monotonic() + 10
398 while not any(record.get('phase') == 'processing' for record in records('shale-link:').values()):
399 assert time.monotonic() < deadline, 'callback did not reach backend'
400 time.sleep(.05)
401 unlink = pool.submit(api, accounts[0][0], 'DELETE', '/api/mcp/shale', 204)
402 deadline = time.monotonic() + 10
403 while session(0) is not None or records('shale-link:'):
404 assert time.monotonic() < deadline, 'unlink did not cancel the callback'
405 time.sleep(.05)
406 subprocess.run(['podman', 'unpause', args.shale_container], check=True, capture_output=True)
407 callback.result(timeout=30)
408 unlink.result(timeout=30)
409 finally:
410 subprocess.run(['podman', 'unpause', args.shale_container], capture_output=True)
411 assert session(0) is None and session_count(0) == 0
412 assert api(accounts[0][0])['shale'] is None and session(1) == second
413 backend_session(second, 200)
414 public('/mcp/shale', token=read, status=401)
415 public('/mcp/shale', token=write, status=401)
416 public('/oauth/token', 'POST', {'grant_type': 'refresh_token', 'client_id': oauth_client['client_id'],
417 'refresh_token': readonly['refresh_token'], 'resource': origin + '/mcp/shale'}, form=True, status=400)
418 api(accounts[1][0], 'DELETE', '/api/mcp/shale', 204)
419 assert session(1) is None and session_count(1) == 0
420 backend_session(second, 303)
421 api(accounts[2][0], 'DELETE', '/api/mcp/shale', 204)
422 assert session(2) is None
423 assert not records('shale-link:') and not records('shale-session:')
424 result = {'two_user_oidc_linking': True, 'same_realm_ordinary_users': True, 'host_only_callback_cookie': True,
425 'single_use_state_and_expiry': True, 'account_mismatch_refused_and_session_removed': True,
426 'cross_user_session_isolation': True, 'backend_session_not_exposed_to_browser': True,
427 'relink_revokes_previous_backend_session': True, 'restart_preserves_credentials': True,
428 'unlink_cancels_inflight_callback': True, 'unlink_revokes_backend_session': True,
429 'oauth_link_returns_to_consent': True, 'sdk_catalog_and_repository_grants': True,
430 'cross_repository_and_cross_user_tools_refused': True, 'read_only_and_audience_enforced': True,
431 'native_issue_read': True, 'unicode_and_rendered_text': True,
432 'native_issue_labels_read': True,
433 'backend_permission_changes_enforced': True, 'expired_backend_session_refused': True,
434 'all_repository_approval_and_dynamic_access': True, 'nested_repository_paths': True, 'existing_token_resource_edits': True,
435 'restart_preserves_mcp_access': True, 'unlink_revokes_mcp_access_and_refresh': True}
436 finally:
437 keycloak = Keycloak('keycloak.studio.test', importlib.import_module('dashboard-run').secret('get', 'keycloak', 'password'), attempts=1)
438 cleanup_errors = []
439 for (name, _), identity in zip(accounts, ids):
440 try:
441 api(name, 'DELETE', '/api/mcp/shale', 204)
442 except Exception as error:
443 cleanup_errors.append(error)
444 try:
445 keycloak.request('/admin/realms/master/users/' + identity, 'DELETE')
446 except Exception as error:
447 cleanup_errors.append(error)
448 with sqlite3.connect(args.data_dir / 'accounts.sqlite') as db:
449 db.execute('PRAGMA foreign_keys=ON')
450 for identity in ids:
451 for table in ['sessions', 'credentials', 'memberships']:
452 db.execute(f'DELETE FROM {table} WHERE user_id=?', (identity,))
453 db.execute('DELETE FROM users WHERE id=?', (identity,))
454 if cleanup_errors:
455 raise cleanup_errors[0]
456 result['owned_users_and_credentials_removed'] = True
457 if args.output:
458 args.output.write_text(json.dumps(result, indent=2) + '\n')
459 print(json.dumps(result), flush=True)
460
461
462if __name__ == '__main__':
463 main()
tools/dashboard-shale-page-test.py+14-14
......@@ -61,7 +61,7 @@ def main():
6161 return self.respond(b' ' * (9 * 1024 * 1024), 'text/html')
6262 if self.path == '/-/login':
6363 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=''))])
6565 if self.path == '/redirect':
6666 return self.respond(b'', 'text/plain', 302, [('Location', '/snowbound/issues/26'), ('Set-Cookie', 'SessionID=new; Path=/; HttpOnly'), ('Set-Cookie', 'other=kept; Path=/')])
6767 if self.path.startswith('/-/') and args.page:
......@@ -108,8 +108,8 @@ def main():
108108 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)
109109 data = root / 'data'
110110 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')}
112 for key in ['STUDIO_INDEX_POOL', 'STUDIO_AUTH_REQUIRED', 'STUDIO_YT_STATE']:
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 ['SNOWGLOBE_INDEX_POOL', 'SNOWGLOBE_AUTH_REQUIRED', 'SNOWGLOBE_YT_STATE']:
113113 environment.pop(key, None)
114114 log = stack.enter_context((root / 'dashboard.log').open('w'))
115115 dashboard = subprocess.Popen([str(args.binary)], env=environment, stdout=log, stderr=log)
......@@ -130,17 +130,17 @@ def main():
130130 profile = {'kind': 'guest', 'enabled': True, 'username': username, 'guestProvider': provider, 'firstName': name}
131131 db.execute('INSERT INTO users(id,profile) VALUES (?,?)', [username, json.dumps(profile)])
132132 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))
134134 router.ROUTE_DIR = str(root / 'routes')
135135 Path(router.ROUTE_DIR).mkdir()
136 (Path(router.ROUTE_DIR) / 'shale.json').write_text(json.dumps({'headHtml': {'shale.studio.test': {'/snowbound/*': '<meta name="rewrite-test" content="kept">'}}}))
136 (Path(router.ROUTE_DIR) / 'shale.json').write_text(json.dumps({'headHtml': {'shale.snowglobe.test': {'/snowbound/*': '<meta name="rewrite-test" content="kept">'}}}))
137137
138138 def nomad(path, token):
139139 if path == '/v1/services':
140140 return [{'Namespace': 'default', 'Services': [{'ServiceName': 'shale'}, {'ServiceName': 'shale-preview-12345678'}]}]
141141 if path.startswith('/v1/service/'):
142142 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'
144144 return [{'Address': '127.0.0.1', 'Port': fixture.server_port, 'ServiceName': service, 'AllocID': service, 'JobID': service, 'Tags': ['caddy-host=' + host]}]
145145 return {'ready': {'Status': 'success'}}
146146
......@@ -156,8 +156,8 @@ def main():
156156 return rendered[start:end].replace(host + ' {', f'http://127.0.0.1:{listener} {{', 1).replace(' tls internal\n', '').replace(' route {\n', f' route {{\n request_header Host {host}\n', 1)
157157
158158 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)
160 internal_host = f'dashboard.internal.studio.test:{internal_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.snowglobe.test:{internal_port}'
161161 start = rendered.index(internal_host + ' {')
162162 config += '\n' + rendered[start:].replace(internal_host + ' {', f'https://localhost:{internal_port} {{', 1).replace(' tls internal\n', f' tls {certificate} {gateway_key}\n', 1)
163163 config_path = root / 'Caddyfile'
......@@ -170,7 +170,7 @@ def main():
170170 origin = f'http://127.0.0.1:{gateway_port}'
171171
172172 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 {})}
174174 url = (f'http://127.0.0.1:{dashboard_port}' if direct else origin) + path
175175 try:
176176 response = opener.open(urllib.request.Request(url, headers=supplied, data=body), timeout=15)
......@@ -199,25 +199,25 @@ def main():
199199 assert b'rewrite-test' in body
200200 assert headers['Cache-Control'] == 'no-store' and headers.get('ETag') is None and headers.get('Last-Modified') is None
201201 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]
203203 assert observations[-1][2]['cookie'] == 'SessionID=preserved', observations[-1]
204204 status, headers, body = request('/json', headers={'Accept': 'application/json'})
205205 assert status == 200 and headers['Content-Type'].startswith('application/json')
206206 assert body == b'{"issue":{"title":"<angle> & Unicode"}}'
207207 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]
209209 status, headers, body = request('/~guest-github-24465214')
210210 assert status == 302 and headers['Location'] == 'https://github.com/paperclover' and headers['Referrer-Policy'] == 'no-referrer'
211211 assert request('/~guest-astheno-abc/')[0] == 200
212212 assert observations[-1][1] == '/~guest-astheno-abc/'
213213 assert request('/~guest-astheno-unknown')[0] == 200
214214 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']
216216 status, headers, body = request('/redirect')
217217 assert status == 302 and headers['Location'] == '/snowbound/issues/26' and len(headers.get_all('Set-Cookie')) == 2
218218 with opener.open(f'http://127.0.0.1:{preview_port}/snowbound/issues/26') as response:
219219 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'
221221 assert any(link.get('href') == 'https://github.com/paperclover' for link in Links(response.read().decode()).links)
222222 assert b'/~guest-github-24465214' in request('/repo/info/refs')[2]
223223 assert request('/binary')[2] == blob
......@@ -226,7 +226,7 @@ def main():
226226 assert status == 201 and body == b'field=unchanged' and observations[-1][1] == '/submit?keep=yes'
227227 assert request('/submit', body=b'blocked', headers={'Origin': 'https://other.example'})[0] == 403
228228 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
230230 print(json.dumps({'html_links': 'passed', 'provider_redirects': 'passed', 'cookies_forms_and_binary': 'passed', 'proxy_boundary': 'passed', 'head_injection': 'passed', 'origin': origin}), flush=True)
231231 if args.browser_ready_file:
232232 args.browser_ready_file.write_text(json.dumps({'origin': origin}))
tools/dashboard-shale-test.py deleted-468
......@@ -1,468 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import base64
4from contextlib import closing, contextmanager
5import copy
6from html.parser import HTMLParser
7import http.client
8import http.cookiejar
9import http.server
10import importlib
11import json
12import os
13from pathlib import Path
14import re
15import sqlite3
16import ssl
17import socket
18import subprocess
19import sys
20import tempfile
21import threading
22import time
23import urllib.error
24import urllib.parse
25import urllib.request
26import uuid
27
28
29class Page(HTMLParser):
30 def __init__(self, text):
31 super().__init__()
32 self.forms = []
33 self.links = []
34 self.codes = []
35 self.form = None
36 self.code = None
37 self.select = None
38 self.feed(text)
39
40 def handle_starttag(self, tag, attrs):
41 attrs = dict(attrs)
42 if tag == "form":
43 self.form = {**attrs, "fields": []}
44 self.forms.append(self.form)
45 if tag in {"input", "select", "textarea", "button"} and self.form is not None:
46 self.form["fields"].append(attrs)
47 if tag == "select":
48 self.select = attrs
49 attrs["options"] = []
50 if tag == "option" and self.select is not None:
51 self.select["options"].append(attrs)
52 if tag == "a":
53 self.links.append(attrs.get("href", ""))
54 if tag in {"code", "pre", "textarea"}:
55 self.code = ""
56
57 def handle_data(self, data):
58 if self.code is not None:
59 self.code += data
60
61 def handle_endtag(self, tag):
62 if tag == "select":
63 self.select = None
64 if tag == "form":
65 self.form = None
66 if tag in {"code", "pre", "textarea"} and self.code is not None:
67 self.codes.append(self.code)
68 self.code = None
69
70
71@contextmanager
72def instance(keycloak, marker, image, traces_endpoint, traces_env, *, host="localhost", dashboard_port=None):
73 container = "studio-shale-backend-test-" + marker
74 client_name = "shale-fixture-" + marker
75 client_secret = uuid.uuid4().hex + uuid.uuid4().hex
76 client_id = None
77 caddy = None
78 proxy = None
79
80 def run(*argv):
81 try:
82 return subprocess.check_output(argv, text=True, stderr=subprocess.PIPE).strip()
83 except subprocess.CalledProcessError as error:
84 raise AssertionError(f"{argv[0]} failed ({error.returncode})") from None
85
86 with tempfile.TemporaryDirectory(prefix="studio-shale-backend-", dir="/run") as temporary:
87 root = Path(temporary)
88 with socket.socket() as reservation:
89 reservation.bind(("127.0.0.1", 0))
90 backend_port = reservation.getsockname()[1]
91 with socket.socket() as reservation:
92 for port in range(20000, 32001):
93 try:
94 reservation.bind(("127.0.0.1", port))
95 break
96 except OSError:
97 continue
98 else:
99 raise AssertionError("no fixture HTTPS port available")
100 origin = "https://" + host + ":" + str(port)
101 try:
102 keycloak.request("/admin/realms/master/clients", "POST", {
103 "clientId": client_name, "protocol": "openid-connect", "publicClient": False,
104 "standardFlowEnabled": True, "secret": client_secret,
105 "redirectUris": [origin + "/-/callback"], "webOrigins": [origin],
106 })
107 clients = keycloak.request("/admin/realms/master/clients?clientId=" + client_name)
108 assert len(clients) == 1
109 client_id = clients[0]["id"]
110 authority = Path("/var/lib/caddy/.local/share/caddy/pki/authorities/local")
111 run("openssl", "req", "-new", "-newkey", "rsa:2048", "-nodes", "-keyout", str(root / "key.pem"),
112 "-out", str(root / "request.pem"), "-subj", "/CN=" + host,
113 "-addext", "subjectAltName=DNS:" + host + ",IP:127.0.0.1")
114 run("openssl", "x509", "-req", "-in", str(root / "request.pem"), "-CA", str(authority / "root.crt"),
115 "-CAkey", str(authority / "root.key"), "-set_serial", "0x" + marker,
116 "-out", str(root / "cert.pem"), "-days", "1", "-copy_extensions", "copyall")
117 config = root / "Caddyfile"
118 bridge = importlib.import_module("router").shale_mcp_routes(dashboard_port) if dashboard_port else []
119 upstream_port = backend_port
120 if dashboard_port:
121 drop = root / "drop-next-write"
122
123 class Proxy(http.server.BaseHTTPRequestHandler):
124 def log_message(self, *args):
125 pass
126
127 def do_GET(self):
128 with closing(http.client.HTTPConnection("127.0.0.1", backend_port, timeout=20)) as upstream:
129 upstream.request(self.command, self.path,
130 self.rfile.read(int(self.headers.get("Content-Length", 0))), dict(self.headers))
131 response = upstream.getresponse()
132 body = response.read()
133 if self.command == "POST" and drop.exists() and drop.read_text() == self.path:
134 drop.unlink()
135 self.close_connection = True
136 self.connection.shutdown(socket.SHUT_RDWR)
137 return
138 self.send_response(response.status)
139 for name, value in response.getheaders():
140 if name.lower() not in {"connection", "transfer-encoding", "content-length"}:
141 self.send_header(name, value)
142 self.send_header("Content-Length", str(len(body)))
143 self.end_headers()
144 self.wfile.write(body)
145
146 do_POST = do_GET
147
148 proxy = http.server.ThreadingHTTPServer(("127.0.0.1", 0), Proxy)
149 proxy_thread = threading.Thread(target=proxy.serve_forever, daemon=True)
150 proxy_thread.start()
151 upstream_port = proxy.server_port
152 config.write_text("{\n admin off\n auto_https disable_redirects\n skip_install_trust\n}\n" + origin +
153 " {\n tls " + str(root / "cert.pem") + " " + str(root / "key.pem") +
154 "\n" + "\n".join(bridge) + "\n handle {\n reverse_proxy 127.0.0.1:" + str(upstream_port) + "\n }\n}\n")
155 binary = (Path("/proc") / run("systemctl", "show", "-P", "MainPID", "caddy") / "exe").resolve(strict=True)
156 with (root / "caddy.log").open("w") as output:
157 caddy = subprocess.Popen([str(binary), "run", "--config", str(config), "--adapter", "caddyfile"],
158 stdout=output, stderr=output,
159 env={**os.environ, "XDG_DATA_HOME": temporary, "XDG_CONFIG_HOME": temporary})
160 volumes = []
161 for directory, target in [("data", "/data"), ("owned", "/repositories_owned"), ("mirrors", "/repositories_mirrors"), ("cron", "/etc/crontabs")]:
162 path = root / directory
163 path.mkdir()
164 os.chown(path, 65534, 65534)
165 volumes.append("--volume=" + str(path) + ":" + target + ":rw")
166 run("podman", "run", "-d", "--name=" + container, "--pull=never", "--user=65534:65534",
167 "--read-only", "--cap-drop=all", "--security-opt=no-new-privileges", "--memory=512m", "--cpus=2", "--pids-limit=128",
168 "--tmpfs=/tmp:rw,noexec,nosuid,nodev,size=64m", "--publish=127.0.0.1:" + str(backend_port) + ":8000",
169 "--add-host=keycloak.studio.test:host-gateway", "--volume=/var/lib/studio/ca-bundle.crt:/etc/ssl/certs/ca-certificates.crt:ro",
170 "--env=DOMAIN=" + host + ":" + str(port), "--env=SERVER_TITLE=MCP fixture",
171 "--env=SESSION_SECRET=" + uuid.uuid4().hex + uuid.uuid4().hex,
172 "--env=OAUTH2_CLIENT=oidc,keycloak.studio.test/realms/master|" + client_name + "|" + client_secret,
173 "--env=NPROC=2", "--env=MIRRORS_DISABLE_CLONE=true", "--env=MIRRORS_DISABLE_PULL_POLL=true",
174 *(["--env=OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=" + traces_endpoint] if traces_env else []),
175 *volumes, image, *(["--otel-exporter-otlp-traces-endpoint", traces_endpoint] if traces_endpoint and not traces_env else []))
176 deployed = json.loads(run("podman", "inspect", container))[0]
177 assert deployed["ImageName"] == image
178 assert deployed["Config"]["User"] == "65534:65534"
179 context = ssl.create_default_context(cafile="/var/lib/studio/ca-bundle.crt")
180 from api import LoopbackHTTPS
181
182 class HTTPS(urllib.request.HTTPSHandler):
183 def https_open(self, request):
184 assert urllib.parse.urlsplit(request.full_url).netloc == urllib.parse.urlsplit(origin).netloc
185 return self.do_open(LoopbackHTTPS, request, context=context)
186
187 readiness = urllib.request.build_opener(HTTPS())
188 deadline = time.monotonic() + 15
189 while True:
190 try:
191 with readiness.open(origin, timeout=2) as response:
192 assert response.status == 200
193 break
194 except OSError:
195 if time.monotonic() >= deadline:
196 raise AssertionError((root / "caddy.log").read_text())
197 time.sleep(.1)
198 yield origin, root / "data/astheno.shale.db", container
199 except Exception:
200 if subprocess.run(["podman", "container", "exists", container], capture_output=True).returncode == 0:
201 state = json.loads(run("podman", "inspect", container))[0]["State"]
202 print(json.dumps({"fixture_backend_running": state["Running"], "fixture_backend_exit_code": state["ExitCode"],
203 "fixture_backend_oom_killed": state["OOMKilled"]}), flush=True)
204 raise
205 finally:
206 try:
207 subprocess.run(["podman", "rm", "--ignore", "--force", container], check=True, capture_output=True)
208 finally:
209 try:
210 if caddy:
211 caddy.terminate()
212 try:
213 caddy.wait(timeout=10)
214 except subprocess.TimeoutExpired:
215 caddy.kill()
216 caddy.wait(timeout=10)
217 finally:
218 if proxy:
219 proxy.shutdown()
220 proxy.server_close()
221 proxy_thread.join(timeout=5)
222 from api import Keycloak
223 keycloak = Keycloak(keycloak.host, importlib.import_module("dashboard-run").secret("get", "keycloak", "password"), attempts=1)
224 if client_id is None:
225 clients = keycloak.request("/admin/realms/master/clients?clientId=" + client_name)
226 assert len(clients) <= 1
227 client_id = clients[0]["id"] if clients else None
228 if client_id:
229 keycloak.request("/admin/realms/master/clients/" + client_id, "DELETE")
230
231
232
233def main():
234 parser = argparse.ArgumentParser()
235 parser.add_argument("--output", type=Path)
236 parser.add_argument("--image")
237 parser.add_argument("--traces-endpoint")
238 parser.add_argument("--traces-env", action="store_true")
239 args = parser.parse_args()
240 if args.output:
241 args.output.unlink(missing_ok=True)
242 assert not args.traces_env or args.traces_endpoint
243 if args.traces_endpoint:
244 endpoint = urllib.parse.urlsplit(args.traces_endpoint)
245 assert endpoint.scheme in {"http", "https"} and endpoint.hostname
246 assert not endpoint.username and not endpoint.password
247 repo = Path(__file__).resolve().parent.parent
248 image = args.image or re.search(r'^\s*image = "([^"]+)"', (repo / "service/shale/service.pkl").read_text(), re.MULTILINE).group(1)
249 sys.path.insert(0, str(repo / "tools"))
250 sys.path.insert(0, str(repo / "service/keycloak"))
251 from api import Keycloak, LoopbackHTTPS
252 keycloak_host = "keycloak.studio.test"
253 shale_host = "localhost"
254 context = ssl.create_default_context(cafile="/var/lib/studio/ca-bundle.crt")
255
256 class HTTPS(urllib.request.HTTPSHandler, urllib.request.HTTPHandler):
257 def http_open(self, request):
258 raise AssertionError("unencrypted fixture redirect")
259
260 def https_open(self, request):
261 parts = urllib.parse.urlsplit(request.full_url)
262 assert parts.netloc in {keycloak_host, urllib.parse.urlsplit(shale).netloc}
263 return self.do_open(LoopbackHTTPS, request, context=context)
264
265 class NoRedirect(urllib.request.HTTPRedirectHandler):
266 def redirect_request(self, req, fp, code, msg, headers, newurl):
267 return None
268
269 key = uuid.uuid4().hex
270 name = "mcp-fixture-" + key
271 password = uuid.uuid4().hex + "A1!"
272 keycloak = Keycloak(keycloak_host, importlib.import_module("dashboard-run").secret("get", "keycloak", "password"))
273 cookies = http.cookiejar.CookieJar()
274 opener = urllib.request.build_opener(HTTPS(), urllib.request.HTTPCookieProcessor(cookies))
275
276 def request(url, fields=None, headers=None, client=opener):
277 headers = dict(headers or {})
278 data = None
279 if fields is not None:
280 parts = urllib.parse.urlsplit(url)
281 headers.update(Origin=parts.scheme + "://" + parts.netloc, Referer=parts._replace(fragment="").geturl())
282 data = urllib.parse.urlencode(fields).encode()
283 req = urllib.request.Request(url, headers=headers, data=data)
284 try:
285 response = client.open(req, timeout=15)
286 except urllib.error.HTTPError as error:
287 response = error
288 with response:
289 return response.status, response.url, response.headers, response.read().decode()
290
291 def submit(url, form, changes, client=opener):
292 target = urllib.parse.urljoin(url, form.get("action", ""))
293 assert urllib.parse.urlsplit(target).netloc == urllib.parse.urlsplit(shale).netloc
294 fields = {a["name"]: a.get("value", "") for a in form["fields"] if a.get("name") and a.get("type") == "hidden"}
295 fields.update(timezone="UTC", tzoffset="+00:00", **changes)
296 return request(target, fields, client=client)
297
298 accounts = [(name, password), ("mcp-stranger-" + key, uuid.uuid4().hex + "A1!")]
299 try:
300 for username, credential in accounts:
301 keycloak.request("/admin/realms/master/users", "POST", {
302 "username": username, "firstName": username, "lastName": "Fixture", "email": username + "@fixture.invalid",
303 "emailVerified": True, "enabled": True,
304 "credentials": [{"type": "password", "value": credential, "temporary": False}],
305 })
306 users = keycloak.request("/admin/realms/master/users?username=" + username + "&exact=true")
307 assert len(users) == 1
308 with instance(keycloak, key, image, args.traces_endpoint, args.traces_env) as (shale, database, container):
309 def login(client, username, credential):
310 status, url, _, body = request(shale + "/-/login", client=client)
311 assert status == 200, status
312 form = next(f for f in Page(body).forms if any(a.get("name") == "password" for a in f["fields"]))
313 fields = {a["name"]: a.get("value", "") for a in form["fields"] if a.get("name")}
314 fields.update(username=username, password=credential)
315 status, url, _, _ = request(urllib.parse.urljoin(url, form["action"]), fields, client=client)
316 assert status == 200 and urllib.parse.urlsplit(url).hostname == shale_host
317
318 login(opener, *accounts[0])
319 stranger = urllib.request.build_opener(HTTPS(), urllib.request.HTTPCookieProcessor(http.cookiejar.CookieJar()))
320 login(stranger, *accounts[1])
321 status, url, _, body = request(shale + "/-/settings")
322 assert status == 200, status
323 form = next(f for f in Page(body).forms if any(a.get("name") == "label" for a in f["fields"]))
324 assert form.get("enctype", "application/x-www-form-urlencoded") == "application/x-www-form-urlencoded"
325 status, _, _, body = submit(url, form, {"label": name})
326 if status != 200:
327 state = json.loads(subprocess.check_output(["podman", "inspect", container], text=True))[0]["State"]
328 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
329 count = db.execute("SELECT count(*) FROM personal_tokens").fetchone()[0]
330 result = {"oidc_fixture_user": True, "mint_status": status,
331 "backend_exit_code": state["ExitCode"], "token_rows_after_response": count}
332 print(json.dumps(result), flush=True)
333 if args.output:
334 args.output.write_text(json.dumps(result, indent=2) + "\n")
335 raise AssertionError("token mint failed; write outcome recorded without replay")
336 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
337 users = db.execute("SELECT id FROM users WHERE name=?", (name,)).fetchall()
338 assert len(users) == 1
339 identity = users[0][0]
340 tokens = db.execute("SELECT uuid FROM personal_tokens WHERE agent=? AND label=?", (identity, name)).fetchall()
341 assert len(tokens) == 1
342 token_id = tokens[0][0]
343 page = Page(body)
344 tokens = {text.strip() for text in [*page.codes, *[a.get("value", "") for f in page.forms for a in f["fields"]]]
345 if re.fullmatch(r"[A-Za-z0-9_:.=+-]{24,}", text.strip())}
346 assert len(tokens) == 1
347 token = next(iter(tokens))
348 anonymous = urllib.request.build_opener(HTTPS(), NoRedirect())
349 for authorization in ["Bearer " + token, "token " + token,
350 "Basic " + base64.b64encode((name + ":" + token).encode()).decode()]:
351 status, _, _, body = request(shale + "/-/settings", headers={"Authorization": authorization}, client=anonymous)
352 assert status == 303 and name not in body
353 status, url, _, body = request(shale + "/-/new")
354 assert status == 200
355 form = next(f for f in Page(body).forms if any(a.get("name") == "name" for a in f["fields"]))
356 status, url, _, body = submit(url, form, {"name": "fixture", "description": "Disposable MCP adapter test", "access": "private"})
357 assert status == 200, status
358 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
359 assert db.execute("SELECT count(*) FROM repositories WHERE name='fixture' AND owner=?", (identity,)).fetchone()[0] == 1
360 repository_url = url
361 for client in (anonymous, stranger):
362 status, _, _, _ = request(repository_url, client=client)
363 assert status in (403, 404), status
364 issues = next(link for link in Page(body).links if "issues" in link)
365 status, url, _, body = request(urllib.parse.urljoin(repository_url, issues))
366 assert status == 200
367 new_issue = next(link for link in Page(body).links if link == "./new")
368 status, url, _, body = request(urllib.parse.urljoin(url, new_issue))
369 assert status == 200
370 title = "Fixture <angle> & Unicode ☃"
371 description = "Disposable body <script>fixture</script> & Unicode ☃"
372 form = next(f for f in Page(body).forms if any(a.get("name") == "title" for a in f["fields"]))
373 status, url, _, body = submit(url, form, {"title": title, "description": description})
374 assert status == 200, status
375 issue_url = url
376 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
377 issues = db.execute("SELECT id,title FROM issues").fetchall()
378 assert len(issues) == 1 and issues[0][1] == title
379 assert db.execute("SELECT payload FROM issue_actions WHERE issue=?", (issues[0][0],)).fetchone()[0] == description
380 status, _, _, _ = request(issue_url, client=anonymous)
381 assert status in (403, 404), status
382 status, _, _, body = request(issue_url)
383 assert status == 200
384 page = Page(body)
385 comment = "Fixture comment <angle> & Unicode ☃"
386 form = next(f for f in page.forms if any(a.get("name") == "t" and a.get("value") == "comment" for a in f["fields"]))
387 status, _, _, body = submit(issue_url, form, {"comment": comment})
388 assert status == 200, status
389 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
390 assert db.execute("SELECT count(*) FROM issue_actions WHERE payload=?", (comment,)).fetchone()[0] == 1
391 form = next(f for f in Page(body).forms if any(a.get("name") == "t" and a.get("value") == "status" for a in f["fields"]))
392 status_field = next(a for a in form["fields"] if a.get("name") == "status")
393 assert any(option["value"] == "done" for option in status_field["options"])
394 status, _, _, body = submit(issue_url, form, {"status": "done"})
395 assert status == 200
396 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
397 assert db.execute("SELECT status FROM issues").fetchone()[0] == "done"
398 status, _, _, stranger_settings = request(shale + "/-/settings", client=stranger)
399 assert status == 200
400 stranger_csrf = {a["name"]: a["value"] for f in Page(stranger_settings).forms for a in f["fields"] if a.get("name") == "csrf_token"}
401 for client, csrf in [(anonymous, {}), (stranger, stranger_csrf)]:
402 status, _, _, _ = request(issue_url, {"t": "comment", "comment": "UNAUTHORIZED",
403 "timezone": "UTC", "tzoffset": "+00:00", **csrf}, client=client)
404 assert status in ((400, 403, 404) if client is anonymous else (403, 404)), status
405 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
406 assert db.execute("SELECT count(*) FROM issue_actions WHERE payload='UNAUTHORIZED'").fetchone()[0] == 0
407 subprocess.run(["podman", "restart", container], check=True, capture_output=True)
408 deadline = time.monotonic() + 15
409 while True:
410 status, _, _, body = request(issue_url)
411 if status == 200:
412 break
413 assert time.monotonic() < deadline, status
414 time.sleep(.1)
415 assert "Unicode ☃" in body
416 for client in (anonymous, stranger):
417 status, _, _, _ = request(issue_url, client=client)
418 assert status in (403, 404), status
419 status, url, _, body = request(shale + "/-/settings")
420 form = next(f for f in Page(body).forms if any(a.get("name") == "label" for a in f["fields"]))
421 status, _, _, body = submit(url, form, {"label": "second"})
422 assert status == 200, status
423 form = next(f for f in Page(body).forms if any(a.get("name") == "t" and a.get("value") == "token_revoke" for a in f["fields"]))
424 status, _, _, _ = submit(url, form, {})
425 assert status == 200
426 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
427 assert db.execute("SELECT count(*) FROM personal_tokens WHERE agent=?", (identity,)).fetchone()[0] == 1
428 assert db.execute("SELECT count(*) FROM personal_tokens WHERE uuid=?", (token_id,)).fetchone()[0] == 0
429 captured = http.cookiejar.CookieJar()
430 for cookie in cookies:
431 if cookie.domain.startswith("localhost"):
432 captured.set_cookie(copy.copy(cookie))
433 assert len(captured) > 0
434 replay = urllib.request.build_opener(HTTPS(), NoRedirect(), urllib.request.HTTPCookieProcessor(captured))
435 status, _, _, _ = request(issue_url, client=replay)
436 assert status == 200
437 status, _, _, _ = request(shale + "/-/logout")
438 assert status == 200
439 status, _, _, _ = request(issue_url)
440 assert status in (403, 404), status
441 replay_status, _, _, _ = request(issue_url, client=replay)
442 assert replay_status in (200, 303, 403, 404), replay_status
443 with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as db:
444 session_rows = db.execute("SELECT count(*) FROM sessions WHERE user=?", (identity,)).fetchone()[0]
445 result = {"backend_image": image,
446 "backend_image_id": json.loads(subprocess.check_output(["podman", "inspect", container], text=True))[0]["Image"],
447 "traces_endpoint": args.traces_endpoint, "traces_environment_variable": args.traces_env,
448 "logout_cookie_replay_status": replay_status,
449 "backend_session_rows_after_logout": session_rows,
450 "checks": ["two_user_oidc", "personal_token_mint", "pat_not_html_auth", "private_repository_create",
451 "anonymous_read_denied", "other_user_read_denied", "issue_create_unicode", "comment_create_unicode",
452 "issue_close", "anonymous_write_denied", "other_user_write_denied", "session_survives_restart",
453 "second_token_mint", "token_revoke", "logout_denies_private_read",
454 "cross_user_denied_after_restart", "captured_session_valid_before_logout", "logout_cookie_replay_probe"]}
455 finally:
456 for username, _ in accounts:
457 users = keycloak.request("/admin/realms/master/users?username=" + username + "&exact=true")
458 for user in users:
459 assert user["username"] == username
460 keycloak.request("/admin/realms/master/users/" + user["id"], "DELETE")
461 result["checks"].append("fixture_cleanup")
462 print(json.dumps(result), flush=True)
463 if args.output:
464 args.output.write_text(json.dumps(result, indent=2) + "\n")
465
466
467if __name__ == "__main__":
468 main()
tools/dashboard-stage-test.py created+113
......@@ -0,0 +1,113 @@
1#!/usr/bin/env python3
2from importlib import import_module
3import json
4import os
5from pathlib import Path
6import struct
7import subprocess
8import tempfile
9import unittest
10from unittest.mock import Mock, patch
11
12
13stage = import_module("dashboard-stage")
14boundary = import_module("dashboard-host")
15
16
17class PreviewBoundary(unittest.TestCase):
18 def call(self, request):
19 payload = json.dumps(request).encode() + b"\n"
20 connection = Mock()
21 connection.__enter__ = Mock(return_value=connection)
22 connection.__exit__ = Mock(return_value=False)
23 connection.getsockopt.return_value = struct.pack("3i", 1, os.getuid(), 1)
24 connection.recv.side_effect = [payload, payload]
25 host = Mock()
26 host.handle.return_value = {"observed": True}
27 with patch.object(boundary.socket, "SO_PEERCRED", 17, create=True), patch.object(boundary, "stream_console") as stream, patch.object(boundary, "stream_upload") as upload:
28 boundary.serve_connection(connection, host, os.getuid(), stage.OPERATIONS)
29 stream.assert_not_called()
30 upload.assert_not_called()
31 sent = b"".join(call.args[0] for call in connection.sendall.call_args_list)
32 return json.loads(sent[4:]), host
33
34 def test_denies_host_mutations_and_vm_streams_before_dispatch(self):
35 for operation in ["vm.create", "vm.start", "vm.console", "vm.serial", "vm.guest", "vm.upload", "storage.destroy", "deploy.start", "deploy.secret.get", "shale.write", "copyparty.manage", []]:
36 with self.subTest(operation=operation):
37 response, host = self.call({"operation": operation})
38 self.assertEqual(response["status"], 403)
39 host.handle.assert_not_called()
40
41 def test_read_uses_the_real_host_handler(self):
42 for operation in ["host.sample", "vm.node", "vm.domains", "vm.library"]:
43 with self.subTest(operation=operation):
44 request = {"operation": operation}
45 response, host = self.call(request)
46 self.assertEqual(response, {"value": {"observed": True}})
47 host.handle.assert_called_once_with(request)
48
49 def test_stage_identity_rejects_paths_and_production(self):
50 for identity in ["dashboard", "knife-preview-12345678", "dashboard-preview-../private", "dashboard-preview-12345678\n"]:
51 with self.assertRaisesRegex(ValueError, "invalid dashboard stage"):
52 stage.metadata(identity)
53
54 def test_file_operations_cannot_name_production_or_account_dataset(self):
55 dataset = "globe/staging/dashboard-preview-12345678"
56 host = stage.PreviewHost({"clone": dataset})
57 for operation in ["files.snapshot", "files.snapshots", "files.discard"]:
58 for target in ["globe/prod/knife", dataset, dataset + "/files/child", dataset + "/files/../data"]:
59 request = {"operation": operation, "dataset": target} if operation == "files.discard" else {"operation": operation, "datasets": [target]}
60 with self.subTest(request=request), patch.object(boundary.Host, "handle") as handler:
61 with self.assertRaises(boundary.dashboard_runs.Error) as error:
62 host.handle(request)
63 self.assertEqual(error.exception.status, 403)
64 handler.assert_not_called()
65 with patch.object(boundary.Host, "handle", return_value="real snapshot") as handler:
66 request = {"operation": "files.snapshot", "datasets": [dataset + "/files"]}
67 self.assertEqual(host.handle(request), "real snapshot")
68 handler.assert_called_once_with(request)
69
70 def test_failed_child_creation_and_repeated_token_revoke_still_clean_parent(self):
71 identity = "dashboard-preview-12345678"
72 dataset = "globe/staging/" + identity
73 saved = {"clone": dataset, "mount": "/srv/staging/" + identity, "tokenAccessor": "already-revoked",
74 "external": {"files": {"clone": dataset + "/files"}}}
75 missing_token = subprocess.CompletedProcess([], 1, stderr="Error deleting token: Unexpected response code: 400 (Cannot delete nonexistent tokens: already-revoked)")
76 okay = subprocess.CompletedProcess([], 0, stderr="")
77 def process(argv, **kwargs):
78 return missing_token if argv[:4] == ["nomad", "acl", "token", "delete"] else okay
79 with patch.object(stage, "metadata", return_value=saved), patch.object(stage.snowglobe, "token"), patch.object(stage.subprocess, "run", side_effect=process), patch.object(stage.snowglobe, "command", return_value=subprocess.CompletedProcess([], 0, stdout=dataset + "\n")) as commands, patch.object(stage.snowglobe, "destroy_stage") as destroy, patch.object(stage.shutil, "rmtree"):
80 stage.destroy(identity)
81 self.assertEqual(saved["external"], {})
82 self.assertEqual(saved["clone"], dataset)
83 destroy.assert_called_once_with(identity, saved, {})
84 self.assertFalse(any(call.args[:2] == ("zfs", "destroy") for call in commands.call_args_list))
85
86
87class NativePreview(unittest.TestCase):
88 def test_empty_proof_requires_loopback_and_fresh_account_stays_private(self):
89 binary = Path(os.environ.get("DASHBOARD_BINARY", "dashboard/target/debug/home-dashboard")).resolve()
90 if not binary.exists():
91 self.skipTest("build home-dashboard to exercise its native auth CLI")
92 with tempfile.TemporaryDirectory() as temporary:
93 env = {**os.environ, "SNOWGLOBE_LISTEN_ADDRESS": "0.0.0.0", "SNOWGLOBE_PROXY_TOKEN_FILE": "", "SNOWGLOBE_DATA_DIR": temporary,
94 "SNOWGLOBE_DOMAIN": "preview.test", "SNOWGLOBE_PUBLIC_ORIGIN": "https://dashboard.preview.test", "SNOWGLOBE_FILE_ORIGIN": "https://files.preview.test",
95 "SNOWGLOBE_AUTH_RP_ID": "dashboard.preview.test"}
96 rejected = subprocess.run([str(binary), "--preview-account"], env=env, capture_output=True, text=True)
97 self.assertNotEqual(rejected.returncode, 0)
98 self.assertIn("before listening on a non-loopback address", rejected.stderr)
99 self.assertFalse(Path(temporary, "accounts.sqlite").exists())
100 env["SNOWGLOBE_LISTEN_ADDRESS"] = "127.0.0.1"
101 created = subprocess.run([str(binary), "--preview-account"], env=env, capture_output=True, text=True, check=True)
102 credentials = json.loads(created.stdout)
103 self.assertEqual(credentials["username"], "preview")
104 self.assertGreaterEqual(len(credentials["password"]), 32)
105 self.assertEqual(Path(temporary, "accounts.sqlite").stat().st_mode & 0o777, 0o600)
106 again = subprocess.run([str(binary), "--preview-account"], env=env, capture_output=True, text=True)
107 self.assertNotEqual(again.returncode, 0)
108 self.assertIn("empty store", again.stderr)
109 self.assertNotIn(credentials["password"], again.stdout + again.stderr)
110
111
112if __name__ == "__main__":
113 unittest.main()
tools/dashboard-stage.py created+214
......@@ -0,0 +1,214 @@
1#!/usr/bin/env python3
2import concurrent.futures
3from importlib import import_module
4import json
5import os
6from pathlib import Path
7import re
8import secrets
9import shlex
10import shutil
11import socket
12import subprocess
13import sys
14import threading
15import time
16
17import snowglobe
18
19
20OPERATIONS = frozenset({
21 "host.sample", "host.usage", "storage.mounts", "storage.datasets", "storage.pool",
22 "storage.snapshots", "vm.node", "vm.domains", "vm.library", "deploy.current", "deploy.main", "deploy.history",
23 "deploy.stages", "deploy.managed", "deploy.release", "deploy.last",
24 "files.snapshot", "files.snapshots", "files.discard",
25})
26STAGE_ID = re.compile(r"dashboard-preview-[0-9a-f]{8}\Z")
27boundary = import_module("dashboard-host")
28
29
30class PreviewHost(boundary.Host):
31 def __init__(self, saved):
32 super().__init__(saved["clone"].split("/", 1)[0])
33 self.stage = saved
34
35 def handle(self, request):
36 operation = request.get("operation") if isinstance(request, dict) else None
37 if operation in {"files.snapshot", "files.snapshots", "files.discard"}:
38 datasets = request.get("datasets") if operation != "files.discard" else [request.get("dataset")]
39 if not isinstance(datasets, list) or datasets != [self.stage["clone"] + "/files"]:
40 raise boundary.dashboard_runs.Error(403, "File changes are limited to this preview's files.")
41 if operation == "storage.mounts" and set(request) == {"operation"}:
42 mounted = json.loads(snowglobe.command(
43 "findmnt", "--json", "-o", "SOURCE,TARGET,FSTYPE,OPTIONS", "--mountpoint", self.stage["mount"] + "/files", capture=True,
44 ).stdout)
45 mounted["filesystems"][0]["target"] = "/srv"
46 return mounted
47 return super().handle(request)
48
49
50def metadata(stage):
51 if not STAGE_ID.fullmatch(stage):
52 raise ValueError("invalid dashboard stage ID")
53 saved = json.loads((snowglobe.STATE / "stages" / f"{stage}.json").read_text())
54 if saved.get("sourceId") != "dashboard":
55 raise ValueError("not a dashboard stage")
56 return saved
57
58
59def serve(stage):
60 saved = metadata(stage)
61 host = PreviewHost(saved)
62 runtime = Path("/run/snowglobe-preview") / stage
63 runtime.mkdir(parents=True, exist_ok=True)
64 os.chown(runtime, 0, saved["uid"])
65 runtime.chmod(0o750)
66 path = runtime / "host.sock"
67 path.unlink(missing_ok=True)
68 with socket.socket(socket.AF_UNIX, socket.SOCK_STREAM) as listener:
69 listener.bind(str(path))
70 os.chown(path, 0, saved["uid"])
71 path.chmod(0o660)
72 listener.listen(8)
73 slots = threading.BoundedSemaphore(8)
74 with concurrent.futures.ThreadPoolExecutor(max_workers=4) as workers:
75 while True:
76 connection, _ = listener.accept()
77 if not slots.acquire(blocking=False):
78 connection.close()
79 continue
80 work = workers.submit(boundary.serve_connection, connection, host, saved["uid"], OPERATIONS)
81 work.add_done_callback(lambda _: slots.release())
82
83
84def stage():
85 snowglobe.token()
86 site = json.loads(snowglobe.command("pkl", "eval", "-f", "json", str(snowglobe.REPO / "config/site.pkl"), capture=True).stdout)
87 site["hostRoot"] = str(Path(site["root"]) / "prod/dashboard")
88 site["stagingRoot"] = str(Path(site["root"]) / "staging")
89 snowglobe.check_staging_pool(site)
90 directory = snowglobe.STATE / "stages"
91 previous = [path for path in directory.glob("*.json") if json.loads(path.read_text()).get("sourceId") == "dashboard"]
92 if len(previous) > 1:
93 raise ValueError("multiple dashboard stages exist; destroy one first")
94 created = not previous
95 identity = "dashboard-preview-" + secrets.token_hex(4) if created else previous[0].stem
96 hostname = identity + "." + site["domain"]
97 root = Path(site["stagingRoot"]) / identity
98 saved = {"sourceId": "dashboard", "tasks": ["app"], "inputs": {}, "mount": str(root),
99 "clone": site["pool"] + "/staging/" + identity, "uid": snowglobe.identity("dashboard"),
100 "stageIsolation": "fresh"} if created else metadata(identity)
101 nix = ["nix", "--extra-experimental-features", "nix-command flakes"]
102 package = "path:" + str(snowglobe.REPO) + "#dashboard-image"
103 image = subprocess.run([*nix, "eval", "--raw", package, "--apply", 'image: "${image.imageName}:${image.imageTag}"'],
104 stdout=subprocess.PIPE, text=True, check=True).stdout.strip()
105 if subprocess.run(["podman", "image", "exists", image], capture_output=True).returncode:
106 built = subprocess.run([*nix, "build", package, "--no-link", "--print-out-paths"],
107 stdout=subprocess.PIPE, text=True, check=True).stdout.strip()
108 snowglobe.command("podman", "load", "--quiet", "--input", built)
109 env = {
110 "SNOWGLOBE_DOMAIN": site["domain"], "SNOWGLOBE_PUBLIC_ORIGIN": "https://" + hostname,
111 "SNOWGLOBE_FILE_ORIGIN": "https://files-" + hostname, "SNOWGLOBE_AUTH_RP_ID": hostname,
112 "SNOWGLOBE_AUTH_REQUIRED": "1", "SNOWGLOBE_PROXY_TOKEN_FILE": "", "SNOWGLOBE_DATA_DIR": "/data",
113 "SNOWGLOBE_PREVIEW": "1", "SNOWGLOBE_METRICS": "follow",
114 "SNOWGLOBE_LISTEN_ADDRESS": "127.0.0.1", "PORT": "${NOMAD_PORT_http}",
115 "SNOWGLOBE_NOMAD_TOKEN_FILE": "/run/secrets/nomad.token", "NOMAD_ADDR": "http://127.0.0.1:4646",
116 "SNOWGLOBE_HOST_SOCKET": "/run/snowglobe-host/host.sock", "SNOWGLOBE_NODE_NAME": site["nodeName"],
117 "SNOWGLOBE_STORE_ROOT": "/srv", "SNOWGLOBE_MEDIA_ROOT": "/srv/Media",
118 "SNOWGLOBE_FILES_WRITABLE": "1", "SNOWGLOBE_CLOVER_READ_ONLY": "false", "SNOWGLOBE_MEDIA_READ_ONLY": "false",
119 "HOME": "/data", "XDG_CACHE_HOME": "/data/cache",
120 }
121 try:
122 if created:
123 snowglobe.command("zfs", "create", "-o", "mountpoint=" + str(root), saved["clone"])
124 saved["external"] = {"files": {"clone": saved["clone"] + "/files"}}
125 directory.mkdir(parents=True, exist_ok=True)
126 snowglobe.write_private(directory / f"{identity}.json", json.dumps(saved))
127 snowglobe.command("zfs", "create", "-o", "mountpoint=" + str(root / "files"), saved["clone"] + "/files")
128 for path in (root / "data", root / "files", root / "files/Media"):
129 path.mkdir(parents=True, exist_ok=True)
130 os.chown(path, saved["uid"], saved["uid"])
131 path.chmod(0o750)
132 fixture = root / "files/preview.txt"
133 fixture.write_text("Disposable Snow Globe dashboard preview.\n")
134 fixture.chmod(0o644)
135 directory.mkdir(parents=True, exist_ok=True)
136 saved.update(release=snowglobe.REPO.name, ready=False)
137 snowglobe.write_private(directory / f"{identity}.json", json.dumps(saved))
138 if created:
139 policy = 'namespace "default" { capabilities = ["list-jobs", "read-job"] }\nnode { policy = "read" }\n'
140 snowglobe.command("nomad", "acl", "policy", "apply", identity, "-", input=policy)
141 token = json.loads(snowglobe.command("nomad", "acl", "token", "create", "-policy=" + identity,
142 "-name=" + identity, "-json", capture=True).stdout)
143 saved["tokenAccessor"] = token["AccessorID"]
144 snowglobe.write_private(directory / f"{identity}.json", json.dumps(saved))
145 snowglobe.write_private(root / "nomad.token", token["SecretID"] + "\n")
146 os.chown(root / "nomad.token", saved["uid"], saved["uid"])
147 imported = snowglobe.command("podman", "run", "--rm", "--network=none", "--read-only",
148 "--user=" + str(saved["uid"]), "--cap-drop=ALL", "--security-opt=no-new-privileges",
149 "--entrypoint=/bin/home-dashboard",
150 "--volume=" + str(root / "data") + ":/data:rw",
151 *["--env=" + key + "=" + value for key, value in env.items()], image, "--preview-account", capture=True)
152 snowglobe.write_private(root / "access.json", imported.stdout)
153 runtime = "/run/snowglobe-preview/" + identity
154 host_environment = snowglobe.transition.host_environment()
155 host_path = next(value for value in shlex.split(host_environment) if value.startswith("PATH="))
156 snowglobe.transition.stop_preview(identity)
157 snowglobe.command("systemd-run", "--collect", "--quiet", "--unit=snowglobe-preview-" + identity,
158 "--property=Restart=on-failure", "--property=MemoryMax=256M", "--property=TasksMax=32",
159 "--setenv=" + host_path,
160 sys.executable, str(Path(__file__).resolve()), "--serve", identity)
161 for _ in range(100):
162 if Path(runtime, "host.sock").exists():
163 break
164 time.sleep(.1)
165 else:
166 raise RuntimeError("dashboard preview host socket did not start")
167 job = {"ID": identity, "Name": identity, "Type": "service", "Datacenters": ["clover"],
168 "Meta": {"snowglobe_service": "dashboard", "snowglobe_name": "Snow Globe preview", "snowglobe_hostname": hostname},
169 "TaskGroups": [{"Name": "app", "Count": 1, "Networks": [{"Mode": "host", "DynamicPorts": [{"Label": "http", "HostNetwork": "loopback"}]}],
170 "Services": [{"Name": identity, "Provider": "nomad", "PortLabel": "http", "TaskName": "app", "Tags": ["caddy-host=" + hostname],
171 "Checks": [{"Name": "Dashboard sign-in", "Type": "http", "Path": "/sign-in", "Interval": 10000000000, "Timeout": 5000000000}]}],
172 "Tasks": [{"Name": "app", "Driver": "podman", "User": str(saved["uid"]) + ":" + str(saved["uid"]), "Env": env,
173 "Config": {"image": image, "network_mode": "host", "cap_drop": ["ALL"], "security_opt": ["no-new-privileges"],
174 "volumes": [str(root / "data") + ":/data:rw", str(root / "files") + ":/srv:rw,rslave", runtime + ":/run/snowglobe-host:ro",
175 str(root / "nomad.token") + ":/run/secrets/nomad.token:ro"]},
176 "Resources": {"CPU": 1000, "MemoryMB": 2048}}]}]}
177 snowglobe.command("nomad", "job", "run", "-json", "-", input=json.dumps(job))
178 snowglobe.check_http(hostname, "/sign-in", site["tlsInternal"])
179 saved["ready"] = True
180 snowglobe.write_private(directory / f"{identity}.json", json.dumps(saved))
181 except BaseException:
182 if created and (directory / f"{identity}.json").exists():
183 destroy(identity)
184 raise
185 print(f"stage={identity}\nrelease={saved['release']}\nhost={hostname}\ndataset={saved['clone']}\naccess={root / 'access.json'}")
186
187
188def destroy(identity):
189 snowglobe.token()
190 saved = metadata(identity)
191 snowglobe.transition.stop_preview(identity)
192 if saved.get("tokenAccessor"):
193 revoked = subprocess.run(["nomad", "acl", "token", "delete", saved["tokenAccessor"]], capture_output=True, text=True)
194 if revoked.returncode and "400 (Cannot delete nonexistent tokens:" not in revoked.stderr:
195 raise RuntimeError(revoked.stderr.strip())
196 snowglobe.command("nomad", "acl", "policy", "delete", identity, capture=True)
197 datasets = set(snowglobe.command("zfs", "list", "-H", "-o", "name", capture=True).stdout.splitlines())
198 saved["external"] = {name: item for name, item in saved.get("external", {}).items() if item["clone"] in datasets}
199 if saved.get("external", {}).get("files", {}).get("clone") == saved["clone"] + "/files":
200 snapshots = snowglobe.command("zfs", "list", "-H", "-t", "snapshot", "-r", "-o", "name", saved["clone"] + "/files", capture=True).stdout.splitlines()
201 for snapshot in snapshots:
202 if snapshot.startswith(saved["clone"] + "/files@"):
203 snowglobe.command("zfs", "destroy", snapshot)
204 if saved["clone"] not in datasets:
205 del saved["clone"]
206 snowglobe.destroy_stage(identity, saved, {})
207 shutil.rmtree(Path("/run/snowglobe-preview") / identity, ignore_errors=True)
208
209
210if __name__ == "__main__":
211 if len(sys.argv) == 3 and sys.argv[1] == "--serve":
212 serve(sys.argv[2])
213 else:
214 raise SystemExit("Expected --serve STAGE")
tools/dashboard-unit-test.py deleted-303
......@@ -1,303 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3from contextlib import ExitStack
4import importlib
5import json
6import os
7from pathlib import Path
8import pwd
9import re
10import shutil
11import socket
12import subprocess
13import sys
14import tempfile
15import time
16import urllib.request
17import uuid
18
19import router
20
21
22def main():
23 parser = argparse.ArgumentParser()
24 parser.add_argument("--output", type=Path)
25 parser.add_argument("--browser-ready-file", type=Path)
26 parser.add_argument("--browser-timeout", type=int, default=180)
27 parser.add_argument("--relay-agent-dir", type=Path)
28 args = parser.parse_args()
29 assert 1 <= args.browser_timeout <= 600
30 repo = Path(__file__).resolve().parent.parent
31 nix = ["nix", "--extra-experimental-features", "nix-command flakes"]
32 base = "path:" + str(repo) + "#nixosConfigurations.vm.config"
33
34 def shell(*argv, timeout=60):
35 result = subprocess.run(argv, capture_output=True, text=True, timeout=timeout)
36 if result.returncode:
37 raise AssertionError(result.stderr)
38 return result.stdout
39
40 units = {name: shell(*nix, "eval", base + '.systemd.units."' + name + '.service".text',
41 "--offline", "--raw", "--option", "eval-cache", "false")
42 for name in ["studio-dashboard", "studio-host"]}
43 permissions = [rule for rule in json.loads(shell(*nix, "eval", base + ".systemd.tmpfiles.rules",
44 "--offline", "--json", "--option", "eval-cache", "false"))
45 if rule.startswith("A+ /srv/prod/ytdl/data ")]
46 assert len(permissions) == 1, permissions
47 scripts = re.findall(r"^Exec(?:Start|StartPre|StartPost)=(/nix/store/\S+)$", units["studio-dashboard"], re.M)
48 assert len(scripts) == 3, scripts
49 shell(*nix, "build", *[base + '.systemd.units."' + name + '.service".unit'
50 for name in units], "--offline", "--no-link", timeout=1200)
51 try:
52 account = pwd.getpwnam("studio-dashboard")
53 except KeyError:
54 shell("useradd", "--system", "--user-group", "--no-create-home", "studio-dashboard")
55 account = pwd.getpwnam("studio-dashboard")
56 assert account.pw_uid != 0 and account.pw_gid != 0
57 app_unit = "studio-dashboard-unit-test"
58 host_unit = "studio-host-unit-test"
59 container = "studio-dashboard-unit-test"
60 unit_files = [Path("/run/systemd/system/" + name + ".service") for name in [app_unit, host_unit]]
61 assert not any(file.exists() for file in unit_files), unit_files
62 assert not json.loads(shell("podman", "ps", "--all", "--filter=name=^" + container + "$", "--format=json"))
63 proof = uuid.uuid4().hex + uuid.uuid4().hex
64
65 with tempfile.TemporaryDirectory(prefix="studio-dashboard-unit-", dir="/run") as temporary, ExitStack() as fixtures:
66 root = Path(temporary)
67 library = root / "clover"
68 season = library / "Media/jellyfin/Indie Shows/Fixture/Season 1"
69 config = library / "Documents/Config/Youtube Downloader"
70 config.mkdir(parents=True)
71 season.mkdir(parents=True)
72 (config / "feed.yaml").write_text("shows: []\n")
73 (season / "S01E01 - Fixture.mp4").write_bytes(b"fixture")
74 (season / "S01E01 - Fixture.nfo").write_text("<episodedetails><title>Unit fixture</title></episodedetails>")
75 for directory in [library, *[p for p in library.rglob("*") if p.is_dir()]]:
76 os.chown(directory, 3000, 3000)
77 directory.chmod(0o2770)
78 data = root / "data"
79 data.mkdir(mode=0o700)
80 (data / "existing.json").write_text('{"fixture":true}\n')
81 state = root / "yt-state"
82 (state / "nested").mkdir(parents=True)
83 (state / "existing.json").write_text('{"fixture":true}\n')
84 for path in [state, *state.rglob("*")]:
85 os.chown(path, 3118, 3118)
86 path.chmod(0o750 if path.is_dir() else 0o640)
87 token = root / "proxy.token"
88 token.write_text(proof)
89 readonly = root / "nomad.token"
90 readonly.write_bytes(Path("/var/lib/studio/dashboard.token").read_bytes())
91 ca = root / "ca.crt"
92 ca.write_bytes(Path("/var/lib/studio/ca-bundle.crt").read_bytes())
93 ca.chmod(0o444)
94 acl = root / "permissions.conf"
95 acl.write_text(permissions[0].replace("/srv/prod/ytdl/data", str(state)) + "\n")
96 with socket.socket() as reservation:
97 reservation.bind(("127.0.0.1", 0))
98 port = reservation.getsockname()[1]
99 sys.path.insert(0, str(repo / "service/keycloak"))
100 from api import Keycloak
101 keycloak = Keycloak("keycloak.studio.test", importlib.import_module("dashboard-run").secret("get", "keycloak", "password"), attempts=1)
102 shale_image = re.search(r'^\s*image = "([^"]+)"', (repo / "service/shale/service.pkl").read_text(), re.M).group(1)
103 shale_origin, shale_database, shale_container = fixtures.enter_context(importlib.import_module("dashboard-shale-test").instance(
104 keycloak, uuid.uuid4().hex, shale_image, None, False, host="shale.studio.test", dashboard_port=port))
105 with socket.socket() as reservation:
106 for gateway_port in range(20000, 32001):
107 try:
108 reservation.bind(("0.0.0.0", gateway_port))
109 break
110 except OSError:
111 continue
112 else:
113 raise AssertionError("no fixture gateway port available")
114 os.environ.update(STUDIO_DOMAIN="studio.test", STUDIO_INTERNAL_PORT=str(gateway_port),
115 STUDIO_DASHBOARD_PORT=str(port), STUDIO_PROXY_TOKEN_FILE=str(token))
116 rendered = router.render(Path(router.TOKEN).read_text().strip())
117 gateway = rendered[rendered.index(f"dashboard.internal.studio.test:{gateway_port} {{"):]
118 gateway_config = root / "Caddyfile"
119 gateway_config.write_text("{\n admin off\n auto_https disable_redirects\n skip_install_trust\n}\n" + gateway +
120 f"\nglobe.studio.test:{gateway_port} {{\n tls internal\n reverse_proxy 127.0.0.1:{port} {{\n header_up Host globe.studio.test\n }}\n}}\n")
121 gateway_config.chmod(0o600)
122 caddy_binary = (Path("/proc") / shell("systemctl", "show", "-P", "MainPID", "caddy").strip() / "exe").resolve(strict=True)
123 caddy = None
124 replacements = {
125 "https://dashboard.internal.studio.test:8448": f"https://dashboard.internal.studio.test:{gateway_port}",
126 "--name=studio-dashboard ": "--name=" + container + " ",
127 "--volume=/run/studio-host:/run/studio-host:ro": "--volume=/run/" + host_unit + ":/run/studio-host:ro",
128 "/var/lib/studio/dashboard-proxy.token": str(token),
129 "/var/lib/studio/dashboard.token": str(readonly),
130 "/var/lib/studio/ca-bundle.crt": str(ca),
131 "/var/lib/studio/dashboard": str(data),
132 "/srv/prod/ytdl/data": str(state),
133 "/srv/clover": str(library),
134 "--prefix=" + str(state): "--prefix=" + str(state) + " " + str(acl),
135 "--publish=127.0.0.1:7072:7072": f"--publish=127.0.0.1:{port}:7072",
136 "http://127.0.0.1:7072/": f"http://127.0.0.1:{port}/",
137 }
138 text = units["studio-dashboard"]
139 for source in scripts:
140 content = Path(source).read_text()
141 # Only host mount sources move; container paths retain the generated unit's contract.
142 for original, replacement in replacements.items():
143 if original in ["/srv/prod/ytdl/data", "/srv/clover"]:
144 content = content.replace("test -d " + original, "test -d " + replacement)
145 content = content.replace("test -d '" + original, "test -d '" + replacement)
146 content = content.replace("src=" + original, "src=" + replacement)
147 content = content.replace("--volume=" + original + ":", "--volume=" + replacement + ":")
148 content = content.replace("--prefix=" + original, "--prefix=" + replacement)
149 else:
150 content = content.replace(original, replacement)
151 destination = root / Path(source).name
152 destination.write_text(content)
153 destination.chmod(0o700)
154 text = text.replace(source, str(destination))
155 text = text.replace("https://dashboard.internal.studio.test:8448", f"https://dashboard.internal.studio.test:{gateway_port}")
156 text = text.replace('Environment="STUDIO_SHALE_URL=https://shale.studio.test"', 'Environment="STUDIO_SHALE_URL=' + shale_origin + '"')
157 text = re.sub(r'^Environment="STUDIO_INDEX_POOL=.*"\n', "", text, flags=re.M)
158 text = text.replace("studio-host.service", host_unit + ".service").replace("studio-router.service", "")
159 text = text.replace("--time=8 studio-dashboard", "--time=8 " + container).replace("--force studio-dashboard", "--force " + container)
160 for original in ["/var/lib/studio/dashboard.token", "/var/lib/studio/ca-bundle.crt"]:
161 text = text.replace("ConditionPathExists=" + original, "ConditionPathExists=" + replacements[original])
162 unit_files[0].write_text(text)
163 host_text = units["studio-host"].replace("RuntimeDirectory=studio-host", "RuntimeDirectory=" + host_unit).replace("StateDirectory=studio/host", "StateDirectory=studio/host-unit-test")
164 host_text = host_text.replace("[Service]\n", "[Service]\n" + f'Environment="STUDIO_HOST_SOCKET=/run/{host_unit}/host.sock"\nEnvironment="STUDIO_HOST_STATE_ROOT=/var/lib/studio/host-unit-test"\n')
165 unit_files[1].write_text(host_text)
166 try:
167 with (root / "caddy.log").open("w") as log:
168 caddy = subprocess.Popen([str(caddy_binary), "run", "--config", str(gateway_config), "--adapter", "caddyfile"],
169 stdout=log, stderr=log, env={**os.environ, "XDG_DATA_HOME": str(root), "XDG_CONFIG_HOME": str(root)})
170 gateway_ca = root / "caddy/pki/authorities/local/root.crt"
171 deadline = time.monotonic() + 15
172 while not gateway_ca.exists():
173 if caddy.poll() is not None or time.monotonic() > deadline:
174 raise AssertionError("fixture gateway did not start")
175 time.sleep(.1)
176 with ca.open("ab") as bundle:
177 bundle.write(gateway_ca.read_bytes())
178 shell("systemctl", "daemon-reload")
179 shell("systemctl", "start", app_unit, timeout=180)
180 info = json.loads(shell("podman", "inspect", container))[0]
181 assert info["Config"]["User"] == f"{account.pw_uid}:{account.pw_gid}", info["Config"]["User"]
182 host = info["HostConfig"]
183 assert host["ReadonlyRootfs"] and not host["Privileged"] and not host["Devices"]
184 assert host["NetworkMode"] != "host" and host["PidsLimit"] == 256
185 assert host["Memory"] == 2 * 1024 ** 3 and host["NanoCpus"] == 4 * 10 ** 9
186 assert "no-new-privileges" in host["SecurityOpt"]
187 mounts = {mount["Destination"]: mount for mount in info["Mounts"]}
188 sources = {"/data": data, "/run/studio-host": Path("/run/" + host_unit),
189 "/run/secrets/dashboard-proxy.token": token, "/run/secrets/dashboard-nomad.token": readonly,
190 "/run/secrets/ca-bundle.crt": ca, "/srv/clover": library,
191 "/srv/clover/Media": library / "Media", "/srv/prod/ytdl/data": state}
192 assert mounts.keys() == sources.keys(), mounts.keys()
193 for target, source in sources.items():
194 assert mounts[target]["Source"] == str(source), mounts[target]
195 assert mounts[target]["RW"] == (target in ["/data", "/srv/clover", "/srv/prod/ytdl/data"]), mounts[target]
196 for namespace in ["net", "pid", "mnt"]:
197 assert Path(f"/proc/{info['State']['Pid']}/ns/{namespace}").stat().st_ino != Path(f"/proc/self/ns/{namespace}").stat().st_ino
198 status = shell("podman", "exec", container, "/bin/cat", "/proc/1/status")
199 assert f"Uid:\t{account.pw_uid}\t{account.pw_uid}\t{account.pw_uid}\t{account.pw_uid}" in status
200 assert all(field + ":\t0000000000000000" in status for field in ["CapEff", "CapPrm", "CapBnd", "CapAmb"])
201 for denied in ["/var/lib/studio/nomad.token", "/run/podman/podman.sock", "/run/libvirt/libvirt-sock", "/dev/zfs", "/opt/studio/current", "/srv/vm", "/srv/prod/keycloak"]:
202 result = subprocess.run(["podman", "exec", container, "/bin/test", "-e", denied], capture_output=True)
203 assert result.returncode != 0, denied
204 assert data.stat().st_uid == account.pw_uid and (data / "existing.json").stat().st_uid == account.pw_uid
205 python = next(value.split("=", 1)[1] for value in info["Config"]["Env"] if value.startswith("STUDIO_YT_PYTHON="))
206 shell("podman", "exec", container, python, "-c", "import ssl; assert ssl.create_default_context().cert_store_stats()['x509_ca'] > 0")
207 refused = "import socket; s=socket.socket(socket.AF_UNIX); s.connect('/run/studio-host/host.sock'); " + "\ntry:\n s.sendall(b'{\"operation\":\"host.sample\"}\\n'); assert s.recv(4) == b''\nexcept (BrokenPipeError, ConnectionResetError):\n pass\n"
208 shell("podman", "exec", f"--user=65534:{account.pw_gid}", container, python, "-c", refused)
209 shell("podman", "exec", container, python, "-c", "from pathlib import Path; p=Path('/srv/prod/ytdl/data'); (p/'existing.json').write_text('fixture'); (p/'nested/new.json').write_text('fixture')")
210 assert (state / "existing.json").stat().st_uid == 3118 and state.stat().st_uid == 3118
211 assert (state / "nested/new.json").exists()
212 shell("podman", "exec", "--user=3118:3000", container, python, "-c", "from pathlib import Path; p=Path('/srv/prod/ytdl/data'); (p/'nested/new.json').open('a').write('service'); (p/'nested/service.json').write_text('service')")
213 shell("podman", "exec", container, python, "-c", "from pathlib import Path; p=Path('/srv/prod/ytdl/data/nested/service.json'); assert p.read_text() == 'service'; p.open('a').write('dashboard')")
214 assert subprocess.run(["podman", "exec", container, "/bin/touch", "/srv/clover/Media/escaped"], capture_output=True).returncode != 0
215
216 def get(path):
217 request = urllib.request.Request(f"http://127.0.0.1:{port}" + path, headers={
218 "Studio-Proxy-Token": proof, "User-Name": "fixture", "User-Groups": "infra-admin",
219 })
220 with urllib.request.urlopen(request, timeout=30) as response:
221 return json.load(response)
222
223 machine = get("/api/host")
224 assert machine["cores"] > 0 and machine["memory"] > 2 * 1024 ** 3
225 assert get("/api/media/list?path=jellyfin/Indie%20Shows/Fixture/Season%201")["entries"]
226 assert get("/api/youtube/library")
227 assert get("/api/youtube")
228 iam_output = root / "iam-checks.json"
229 shell(sys.executable, str(repo / "tools/dashboard-iam-test.py"), "--url", f"http://127.0.0.1:{port}",
230 "--socket", f"/run/{host_unit}/host.sock", "--proof-file", str(token),
231 "--output", str(iam_output), timeout=180)
232 iam_checks = json.loads(iam_output.read_text())
233 mcp_output = root / "mcp-checks.json"
234 shell(sys.executable, str(repo / "tools/dashboard-mcp-test.py"), "--url", f"http://127.0.0.1:{port}",
235 "--proof-file", str(token), "--restart-unit", app_unit,
236 "--output", str(mcp_output), timeout=240)
237 mcp_checks = json.loads(mcp_output.read_text())
238 relay_output = root / "relay-checks.json"
239 shell(sys.executable, str(repo / "tools/dashboard-relay-test.py"), "--url", f"http://127.0.0.1:{port}",
240 "--proof-file", str(token), "--data-dir", str(data), "--restart-unit", app_unit,
241 "--output", str(relay_output), *(["--agent-dir", str(args.relay_agent_dir), "--agent-origin", f"https://globe.studio.test:{gateway_port}", "--agent-ca", str(gateway_ca)] if args.relay_agent_dir else []), timeout=240)
242 relay_checks = json.loads(relay_output.read_text())
243 shale_output = root / "shale-link-checks.json"
244 shell(sys.executable, str(repo / "tools/dashboard-shale-link-test.py"), "--url", f"http://127.0.0.1:{port}",
245 "--proof-file", str(token), "--data-dir", str(data), "--restart-unit", app_unit,
246 "--shale-origin", shale_origin, "--shale-database", str(shale_database), "--shale-container", shale_container,
247 "--output", str(shale_output), timeout=240)
248 shale_checks = json.loads(shale_output.read_text())
249 worker = "from pathlib import Path; found=[]\nfor p in Path('/proc').iterdir():\n if p.name.isdigit():\n try:\n argv=(p/'cmdline').read_bytes().rstrip(b'\\0').split(b'\\0')\n if argv[1:] == [b'server/youtube-worker.py']:\n found.append((p/'status').read_text())\n except (FileNotFoundError, PermissionError):\n pass\nassert len(found) == 1, len(found)\n" + f"assert 'Uid:\\t{account.pw_uid}\\t{account.pw_uid}\\t{account.pw_uid}\\t{account.pw_uid}' in found[0]\nassert 'CapEff:\\t0000000000000000' in found[0] and 'NoNewPrivs:\\t1' in found[0]\n"
250 shell("podman", "exec", container, python, "-c", worker)
251 socket_inode = Path("/run/" + host_unit).stat().st_ino
252 shell("systemctl", "restart", host_unit)
253 assert Path("/run/" + host_unit).stat().st_ino == socket_inode
254 time.sleep(1.1)
255 assert get("/api/host")["memory"] == machine["memory"]
256 started = time.monotonic()
257 shell("systemctl", "restart", app_unit, timeout=180)
258 restart_seconds = time.monotonic() - started
259 assert restart_seconds < 15, restart_seconds
260 assert get("/api/me")["name"] == "fixture" and (data / "existing.json").exists()
261 browser_checks = None
262 if args.browser_ready_file:
263 browser_checks = json.loads(shell(sys.executable, str(repo / "tools/dashboard-browser-test.py"),
264 "--ready-file", str(args.browser_ready_file), "--timeout", str(args.browser_timeout), timeout=args.browser_timeout + 60))
265 started = time.monotonic()
266 shell("systemctl", "stop", app_unit, timeout=30)
267 elapsed = time.monotonic() - started
268 assert elapsed < 15 and shell("systemctl", "show", "-P", "Result", app_unit).strip() == "success"
269 result = {"image": info["ImageName"], "generated_nixos_unit": True, "dedicated_uid": account.pw_uid, "readonly_rootfs": True,
270 "zero_capabilities": True, "quotas": True, "private_network": True, "bounded_mounts": True,
271 "host_broker_uid_auth": True, "other_uid_same_group_refused": True,
272 "state_ownership_migration": True, "shared_youtube_acl": True,
273 "youtube_owner_preserved": True, "readonly_media": True, "unprivileged_youtube_worker": True,
274 "python_public_tls_roots": True,
275 "iam": iam_checks, "mcp": mcp_checks, "relay": relay_checks, "shale_link": shale_checks,
276 "broker_restart_socket_preserved": True, "container_restart_state_preserved": True,
277 "cached_image_restart_seconds": round(restart_seconds, 2),
278 "systemd_stop_seconds": round(elapsed, 2)}
279 if browser_checks is not None:
280 result["browser_route_fixture"] = browser_checks
281 if args.output:
282 args.output.parent.mkdir(parents=True, exist_ok=True)
283 args.output.write_text(json.dumps(result, indent=2) + "\n")
284 print(json.dumps(result))
285 finally:
286 subprocess.run(["systemctl", "stop", app_unit, host_unit], capture_output=True, timeout=60)
287 subprocess.run(["podman", "rm", "--ignore", "--force", container], capture_output=True, timeout=15)
288 if caddy is not None:
289 caddy.terminate()
290 try:
291 caddy.wait(timeout=10)
292 except subprocess.TimeoutExpired:
293 caddy.kill()
294 caddy.wait(timeout=5)
295 for file in unit_files:
296 file.unlink(missing_ok=True)
297 for directory in ["/var/lib/studio/host-unit-test", "/run/" + host_unit]:
298 shutil.rmtree(directory, ignore_errors=True)
299 shell("systemctl", "daemon-reload")
300
301
302if __name__ == "__main__":
303 main()
tools/dashboard-vm-boundary-test.py+1-1
......@@ -116,7 +116,7 @@ raise AssertionError('interrupted creation reported success')
116116 attempt = subprocess.run([sys.executable, "-c", interrupted, str(Path(__file__).parent), phase],
117117 input=json.dumps({**spec, "image": installer.name if phase == "copy" else "blank"}),
118118 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)})
120120 elapsed = time.monotonic() - started
121121 assert attempt.returncode == 1, attempt.stderr
122122 if phase == "copy":
tools/data-restore.md+33-17
......@@ -1,12 +1,21 @@
1# Production data rollback
1# Production data restore
22
3Every promotion and code rollback backs up the active release before switching it. One ZFS snapshot operation captures the mounted service datasets and PostgreSQL data at the same instant. A temporary clone of that PostgreSQL snapshot runs without a network and produces the service-owned database dumps, including services with multiple database inputs. The clone is destroyed before the backup is published. `python3 tools/deploy.py backups` lists the backup IDs and services. A failed promotion can leave a completed backup even when release history has no new entry.
3Every production promotion and code rollback backs up the active release
4before switching it. One ZFS snapshot operation captures mounted managed
5service datasets and PostgreSQL data together. A temporary isolated PostgreSQL
6clone produces service-owned database dumps and is destroyed before the
7backup is published. A failed deployment can leave a completed backup without
8a successful release-history entry.
49
5The backup now also saves a private `nomad.snap` and its SHA-256 in the manifest. A disposable backup run against the VM's live Nomad server verified the file and digest, then removed it. This snapshot includes jobs, ACLs, and secret variables; keep the backup directory private. Service data restore does not apply the whole Nomad snapshot, which is reserved for an explicit cluster recovery. The backup directory is still on the OS disk until Snow Globe control state has durable storage.
10`python3 tools/deploy.py backups` lists backup IDs and services. Each backup's
11private manifest records the service snapshots, database dumps and checksums,
12and a private `nomad.snap`. The Nomad snapshot includes jobs, ACLs, and secret
13variables. It is for explicit cluster recovery; service restore does not apply
14it. Earlier backups may lack this snapshot. Manifests and dumps remain on the
15OS disk; see [hardware and recovery](snowglobe-hardware.md) for off-server
16recovery requirements.
617
7At inspection, the VM retained 25 release backups: their PostgreSQL dumps and manifests used `275 MB`, and their service snapshots numbered 550. No automatic retention policy deletes these backups yet; choose one before long-running production use. Earlier backup manifests do not contain `nomad.snap`.
8
9To restore one service, roll its code back first, then run:
18To restore one service after production data restore is explicitly authorized:
1019
1120```sh
1221python3 tools/deploy.py backups
......@@ -14,14 +23,21 @@ python3 tools/deploy.py rollback <old-release-id>
1423python3 tools/deploy.py data-restore <service-id> --backup <backup-id> --discard-writes
1524```
1625
17The backup's `fromRelease` must match the active release. Data restore stops that service, saves its current dataset and database as a safety copy, restores the chosen ZFS snapshot and PostgreSQL dump, then deploys and checks the service. **Changes written after the chosen backup are discarded from the live service.** The safety snapshot and dump remain on the host. Postgres itself is shared; restore its owner services individually. Shared Clover and Media mounts are outside this service restore; restoring an entire shared dataset would discard unrelated users' writes.
18
19The CLI checks that the backup snapshot and database dumps exist before stopping the service. A disposable missing-snapshot manifest on the VM was rejected while Redis Insight stayed running; the fixture was removed.
20
21On the VM, backup `20260927T030206Z-67f38b` captured 22 service snapshots and four database dumps from a cloned PostgreSQL snapshot. All dump hashes and snapshots verified; the temporary container and dataset were removed while the production PostgreSQL allocation stayed running. An injected dump failure after clone startup left the ZFS dataset/snapshot list and backup directory list unchanged, with no probe container. Earlier rollback and restore tests are recorded in the release history.
22
23# VM restore rehearsal
24
25On 2026-09-27, backup `20260927T033539Z-123cab` captured the running x86 VM's service datasets and PostgreSQL databases. A throwaway file and table were then added to `evil-hedgedoc`. Running `data.py restore 20260927T033539Z-123cab evil-hedgedoc --discard-writes` stopped the job, saved the pre-restore safety snapshot, restored the dataset and database, and redeployed it. Both probes disappeared, `https://md.evil.studio.test/_health` returned 200 from the Mac, and all 19 VM routes passed their health checks. This proves the explicit data restore path on the VM; the production NAS cutover remains separate.
26
27The `20260927T055034Z-27d895` backup retained all 22 service snapshots and four matching PostgreSQL dumps. Its Dawarich dump restored into a new database owned by `svc_dawarich` in an isolated PostgreSQL ZFS clone, with `pgcrypto` and `postgis` created first and `pg_restore --role=svc_dawarich`. The restored `points` table contained 22,666 rows. The probe container and clone were removed, the live PostgreSQL allocation stayed running, and Dawarich still returned HTTP 200.
26The backup's `fromRelease` must match the active release. The command verifies
27backup snapshots and dumps before stopping the service, saves the current
28dataset and database as a safety copy, restores the selected data, then
29deploys and checks the service. **Writes after the chosen backup are discarded
30from the live service.** The safety snapshot and dump remain on the host.
31
32Restore PostgreSQL owner services individually; the PostgreSQL service itself
33is shared. Clover, Media, and external archive mounts are outside managed
34service restore. Restoring an entire shared dataset discards unrelated writes.
35For Shale, keep the complete service dataset together: repository visibility,
36repository objects, issue database, attachment files, and their manifest must
37agree. For Copyparty, also preserve its Nomad API-account hashes as described
38in [administration](copyparty.md). For Knife, preserve the external archive
39store and identity as described in [operations](knife.md).
40
41Verify the real application, authentication, persistence, provider connections,
42allocation health and logs after recovery. Code rollback only changes code;
43it does not restore data or undo a folder move.
tools/data.py+15-11
......@@ -4,6 +4,7 @@ from contextlib import closing, contextmanager
44from datetime import datetime, timezone
55import hashlib
66import json
7from importlib import import_module
78import os
89from pathlib import Path
910import re
......@@ -14,8 +15,10 @@ import subprocess
1415import time
1516
1617
17ROOT = Path("/opt/studio")
18STATE = Path("/var/lib/studio")
18transition = import_module("namespace-transition")
19
20ROOT = Path("/opt/snowglobe")
21STATE = Path("/var/lib/snowglobe")
1922BACKUPS = STATE / "backups"
2023BACKUP_ID = re.compile(r"\d{8}T\d{6}Z-[0-9a-f]{6}\Z")
2124SERVICE_ID = re.compile(r"[a-z][a-z0-9-]*\Z")
......@@ -32,7 +35,7 @@ def current_release():
3235 if not current.is_symlink():
3336 raise ValueError("No active home server release")
3437 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):
3639 raise ValueError("Active home server release is invalid")
3740 return release
3841
......@@ -118,7 +121,7 @@ def cloned_postgres(snapshot, clone, mountpoint):
118121 image = inspect["Image"]
119122 if not re.fullmatch(r"[0-9a-f]{64}", image):
120123 raise ValueError("Postgres image ID is invalid")
121 probe = "studio-backup-" + clone.rsplit("/", 1)[1]
124 probe = "snowglobe-backup-" + clone.rsplit("/", 1)[1]
122125 created = False
123126 try:
124127 run("zfs", "clone", "-o", f"mountpoint={mountpoint}", snapshot, clone)
......@@ -175,7 +178,7 @@ def backup(from_release, to_release):
175178 directory = BACKUPS / backup_id
176179 manifest = {"id": backup_id, "fromRelease": from_release, "toRelease": to_release,
177180 "time": int(time.time()), "services": {}}
178 snapshot = "studio-" + backup_id
181 snapshot = "snowglobe-" + backup_id
179182 datasets = set()
180183 allocations = {}
181184 for service in sorted(names):
......@@ -262,7 +265,8 @@ def restore(backup_id, service):
262265 path = source / name
263266 if not path.resolve().is_relative_to(source.resolve()) or not path.is_file() or checksum(path) != digest:
264267 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)
266270 safety = BACKUPS / ("before-restore-" + datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ") + "-" + secrets.token_hex(3))
267271 safety.mkdir(mode=0o700)
268272 files = backup_dashboard(safety / "dashboard")
......@@ -273,8 +277,8 @@ def restore(backup_id, service):
273277 if (root / "pictures").exists():
274278 shutil.rmtree(root / "pictures")
275279 shutil.copytree(source, root, dirs_exist_ok=True)
276 run("systemctl", "start", "studio-dashboard")
277 run("systemctl", "is-active", "--quiet", "studio-dashboard")
280 run("systemctl", "start", unit)
281 run("systemctl", "is-active", "--quiet", unit)
278282 print(f"restored=dashboard backup={backup_id} safety={safety.name}")
279283 return
280284 dataset = entry.get("dataset")
......@@ -319,9 +323,9 @@ def restore(backup_id, service):
319323 with (directory / database["dump"]).open("rb") as input_file:
320324 run(*PODMAN, "exec", "-i", container, "pg_restore", "-U", "postgres", "-d", name,
321325 "--no-owner", "--no-acl", "--role=" + owner, stdin=input_file)
322 script = current_release() / "tools/studio.py"
323 run("python3", str(script), "deploy", service)
324 run("python3", str(script), "check", service)
326 script = transition.layout(current_release())["script"]
327 run("python3", str(script), "deploy", service, env=transition.environment(current_release()))
328 run("python3", str(script), "check", service, env=transition.environment(current_release()))
325329 print(f"restored={service} backup={backup_id} safety={safety}")
326330
327331
tools/dawarich-migration.md deleted-31
......@@ -1,31 +0,0 @@
1# Dawarich migration
2
3The 2026-10-04 offline handoff includes Dawarich's PostgreSQL 18 database, with a verified restore and hashes for every table, sequence, and large object. Restore it before starting Dawarich. Keep the original Rails `SECRET_KEY_BASE` and copy `/var/app/storage` into the managed service dataset before the first application boot.
4
5The production database import on 2026-10-04 passed all 63 exported relation and large-object fingerprints before any Dawarich process started. Evidence is `/var/lib/studio/dawarich-import-7hw6v9w1/verified.json`. PostGIS retains its 8,500 built-in spatial references; PostgreSQL extension dumps contain only custom reference rows. Removing the built-ins changes geometry JSON serialization as well as breaking reference lookup. The importer preserves built-ins and replaces only explicitly dumped custom SRIDs.
6
7[import-personal-postgres.py](import-personal-postgres.py) reads the allocated production database from `nomad/jobs/dawarich/inputs/database`. The target database and `svc_dawarich` role must already exist. For initial production migration, keep both Nomad jobs stopped and use an isolated PostGIS initializer with `--network none`, mounting the final PostgreSQL data directory:
8
9```sh
10python3 tools/import-personal-postgres.py dawarich \
11 /mnt/storage1/apps/studio-handoff/20261004T230507Z-e75419 \
12 --container PERSONAL_POSTGRES_INITIALIZER
13```
14
15The importer saves a private target backup under `/var/lib/studio/dawarich-import-*`, restores application objects as the allocated owner, preserves PostGIS reference data, and compares the result with the export's content hashes. It leaves Dawarich stopped. Stop and remove the initializer before deploying the production Postgres job. For a later import into an already running production Postgres allocation, omit `--container`; Dawarich must still be stopped.
16
17The historical preview results below concern the rehearsal VM. Zenith's separate Redis dump was 86,557 bytes and belonged to Dawarich. DB 0 contained caches and track-generation keys; DB 1 held 106 queued `Family::Invitations::CleanupJob` entries. The old image's nightly schedule sent them to `family`, while its worker listened to `families`; that queue reached 107 entries on 2026-09-27. The pinned image schedules this job on `families`, and all 14 of its scheduled queues appear in the worker's queue list.
18
19The rehearsal's source and target used PostgreSQL 18 with PostGIS. The tested transfer used a consistent custom-format dump made with `pg_dump -Fc --no-owner --no-acl --exclude-extension=postgis`, then restored it into a **separate stage database** after creating the PostGIS extension there. It did not write to Zenith or the VM's production database.
20
21The Rails `SECRET_KEY_BASE` must stay the same as the source value so encrypted records remain readable. The old `/var/app/storage` contained one file; its checksum matched the staged copy. The generated `/var/app/public` assets and `/var/app/tmp` cache were not imported. The stage used its own Keycloak client and database; its two imported user records remained intact.
22
23Before the new image ran, the source and staged database both had 22,666 points, 1,011 tracks, 2 users, and 74 visits. The current image rebuilds derived tracks and visits on startup; after a worker restart, the staged database had 22,666 points, 698 tracks, 2 users, 139 visits, and 74 newly generated track segments. Track count is therefore not a row-for-row import check. Point and user counts, storage checksums, HTTPS health, and the SSO login flow should be checked separately.
24
25The first staged boot exposed a startup race: Sidekiq loaded the old `TrackSegment` schema before the web entrypoint finished migrations, then logged `unknown attribute 'start_at'`. Restarting the worker after migrations restored segment creation. The service now runs Redis as a prestart sidecar and completes a migration task before starting web and worker. Its web entrypoint still repeats the upstream migration command, which is idempotent but extends cold startup on the emulated x86 VM.
26
27The corrected deployment is `dawarich-preview-1e4dac4a` at `https://dawarich-preview-1e4dac4a.studio.test` (release `554d23a23d940690`). Nomad marked it healthy; the HTTPS health endpoint returned 200 with certificate verification, and the new worker allocation logged no `start_at` errors.
28
29[import-dawarich.sh](import-dawarich.sh) repeats the preview restore from the latest read-only Zenith app snapshot and copies the small storage directory. It compares the source and target `SECRET_KEY_BASE` by hash, backs up the target ZFS dataset and database, restores the source PostgreSQL dump with PostGIS, and checks point/user counts before starting the preview. The 2026-09-26 run completed successfully: 22,666 points and two users survived migrations, HTTPS health returned 200 from this Mac with certificate verification, Nomad marked the job healthy, and the worker had no `start_at` error.
30
31The shell importer requires the old running source and serves VM previews. The Python importer uses the retained offline handoff for the same-machine production cutover.
tools/ddns-migration.md deleted-9
......@@ -1,9 +0,0 @@
1# DDNS cutover
2
3The `.test` VM does not run DDNS. Evaluating `service/ddns-updater/service.pkl` on the VM with `domain=paperclover.net` produced valid JSON for the Cloudflare `*.paperclover.net` record and required `cloudflare_zone_id` and `cloudflare_api_token`. Zenith's legacy `.env` contains the corresponding `CLOUDFLARE_ZONE_ID` and `CLOUDFLARE_API_TOKEN` keys. No public DNS record was changed during this check.
4
5The current worktree's `config/`, `service/`, and `tools/` generated 27 production-domain jobs, all accepted by `nomad job validate` on the VM. This was validation only; it did not submit jobs or contact Cloudflare.
6
7Snow Globe replaces a service hostname's first label with its stage ID: Shale becomes `shale-preview-12345678.paperclover.net`, while evil.inc Forgejo becomes `evil-forgejo-preview-12345678.evil.paperclover.net`. Cloudflare's wildcard DNS records [cover multiple levels when no specific record takes precedence](https://developers.cloudflare.com/dns/manage-dns-records/reference/wildcard-dns-records/). Read-only DNS queries resolved both a sample Shale stage name and an otherwise nonexistent name under `evil.paperclover.net` to the current public address. The README's `.staging.paperclover.net` example describes a different hostname scheme from the current CLI. No public record changed; ACME issuance still needs a live cutover check.
8
9At production cutover, set `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT` for the new host, then run `bash tools/import-legacy-secrets.sh ddns-updater CLOUDFLARE_ZONE_ID CLOUDFLARE_API_TOKEN`. The order matches the required secret fields in the service definition. Start the Snow Globe DDNS job only after the old updater is stopped; otherwise both updaters can write the wildcard record. Verify the provider status and the public record after the new job starts.
tools/deploy-test.py+12-13
......@@ -15,7 +15,7 @@ import release
1515
1616class MainExport(unittest.TestCase):
1717 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:
1919 root = Path(temporary)
2020 repo = root / "repo"
2121 repo.mkdir()
......@@ -28,11 +28,12 @@ class MainExport(unittest.TestCase):
2828 else:
2929 path.mkdir()
3030 (path / "fixture").write_text("committed")
31 (repo / "config/excluded-services.json").write_text('["retired"]\n')
32 (repo / "service/retired").mkdir()
33 (repo / "service/retired/private").write_text("must not be exported")
31 (repo / "service/app").mkdir()
32 (repo / "service/app/service.pkl").write_text("service definition")
33 (repo / "service/app/worker.pkl").write_text("grouped definition")
3434 executable = repo / "tools/fixture"
3535 executable.chmod(0o755)
36 subprocess.run(["jj", "file", "track", "--include-ignored", "AGENTS.md"], cwd=repo, check=True, capture_output=True)
3637 for args in [["describe", "-m", "Test main"], ["bookmark", "set", "main"]]:
3738 subprocess.run(["jj", *args], cwd=repo, check=True, capture_output=True)
3839 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):
4243 original = subprocess.run
4344
4445 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")
4746 if argv[0] == "ssh":
4847 return subprocess.CompletedProcess(argv, 1)
4948 if argv[0] == "rsync" and "-e" in argv:
......@@ -64,13 +63,13 @@ class MainExport(unittest.TestCase):
6463 self.assertEqual((main / "service/fixture").read_text(), "committed")
6564 self.assertFalse((main / "service/new").exists())
6665 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"})
6867 self.assertEqual((stage / "service/fixture").read_text(), "unfinished")
6968 self.assertEqual((stage / "service/new").read_text(), "new working file")
70 self.assertNotIn("main", json.loads((stage / ".studio-release.json").read_text()))
71 self.assertFalse((main / "service/retired").exists())
72 self.assertFalse((stage / "service/retired").exists())
73 self.assertFalse(any("retired" in relative.parts for _, relative in release.files(repo)))
69 self.assertNotIn("main", json.loads((stage / ".snowglobe-release.json").read_text()))
70 for exported in (main, stage):
71 self.assertEqual((exported / "service/app/service.pkl").read_text(), "service definition")
72 self.assertEqual((exported / "service/app/worker.pkl").read_text(), "grouped definition")
7473 subprocess.run(["jj", "bookmark", "set", "main"], cwd=repo, check=True, capture_output=True)
7574 with self.assertRaisesRegex(ValueError, "commit description"):
7675 deploy.upload(main=True)
......@@ -80,7 +79,7 @@ class BuildSourceExport(unittest.TestCase):
8079 def setUp(self):
8180 stack = ExitStack()
8281 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()
8483 self.repo = root / "repo"
8584 self.source = root / "source"
8685 self.remote = root / "remote"
......@@ -93,7 +92,6 @@ class BuildSourceExport(unittest.TestCase):
9392 else:
9493 path.mkdir()
9594 (path / "fixture").write_text("fixture")
96 (self.repo / "config/excluded-services.json").write_text("[]\n")
9795 (self.source / "lib").mkdir()
9896 (self.source / "lib/committed").write_text("committed library")
9997 (self.source / "src").mkdir()
......@@ -113,6 +111,7 @@ class BuildSourceExport(unittest.TestCase):
113111 self.spec = {"source": "../source", "revision": self.commit,
114112 "dockerfile": "src/app.dockerfile", "include": ["run.sh", "lib"]}
115113 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)
116115 for args in [["describe", "-m", "Pinned build source"], ["bookmark", "set", "main"]]:
117116 subprocess.run(["jj", *args], cwd=self.repo, check=True, capture_output=True)
118117 original = subprocess.run
tools/deploy.py+29-38
......@@ -12,13 +12,13 @@ import sys
1212import tempfile
1313import time
1414
15from release import SOURCES, excluded_services, tree_digest
15from release import SOURCES, tree_digest
1616
1717
1818REPO = Path(__file__).resolve().parent.parent
19HOST = os.environ.get("STUDIO_DEPLOY_HOST", "root@127.0.0.1")
20PORT = os.environ.get("STUDIO_DEPLOY_PORT", "2222")
21REMOTE = Path("/opt/studio")
19HOST = os.environ.get("SNOWGLOBE_DEPLOY_HOST", "root@10.0.0.1")
20PORT = os.environ.get("SNOWGLOBE_DEPLOY_PORT", "22")
21REMOTE = Path("/opt/snowglobe")
2222NAME = re.compile(r"[a-z][a-z0-9-]*\Z")
2323RELEASE_ID = re.compile(r"[0-9a-f]{16}\Z")
2424
......@@ -32,18 +32,27 @@ def ssh(command, capture=False):
3232
3333def run_logged(mode, target, command):
3434 run = f"{int(time.time() * 1000)}-{mode}-{target or 'current'}"
35 path = f"/var/lib/studio/runs/{run}.log"
36 script = f"umask 077; mkdir -p /var/lib/studio/runs; set -o pipefail; {command} 2>&1 | tee {shlex.quote(path)}"
35 path = f"/var/lib/snowglobe/runs/{run}.log"
36 script = f"umask 077; mkdir -p /var/lib/snowglobe/runs; set -o pipefail; {command} 2>&1 | tee {shlex.quote(path)}"
3737 ssh("bash -c " + shlex.quote(script))
3838 print(f"run={run}")
3939
4040
41def prepare_remote():
42 subprocess.run(
43 ["ssh", "-p", PORT, "-o", "BatchMode=yes", HOST, "python3 - prepare"],
44 input="NAMESPACE = " + repr(json.loads((REPO / "dashboard/src/namespace-transition.json").read_text())) + "\n"
45 + (REPO / "tools/namespace-transition.py").read_text(), text=True, check=True,
46 )
47
48
4149def sync_manager(release):
4250 source = REMOTE / "releases" / release / "tools"
43 ssh(f"cp {source}/release.py {source}/data.py {REMOTE}/")
51 ssh(f"cp {source}/release.py {source}/data.py {source}/namespace-transition.py {REMOTE}/")
52 ssh(f"cp {source}/../dashboard/src/namespace-transition.json {REMOTE}/namespace-transition.json")
4453
4554
46def export_revision(source, commit, paths, destination, excluded=frozenset()):
55def export_revision(source, commit, paths, destination):
4756 entries = subprocess.run(
4857 ["jj", "--ignore-working-copy", "file", "list", "-r", commit, "-T",
4958 '\"[\" ++ json(path) ++ \",\" ++ json(file_type) ++ \",\" ++ json(executable) ++ \"]\\n\"',
......@@ -53,11 +62,6 @@ def export_revision(source, commit, paths, destination, excluded=frozenset()):
5362 for entry in entries:
5463 name, kind, executable = json.loads(entry)
5564 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
6165 if kind != "file" or relative.is_absolute() or ".." in relative.parts:
6266 raise ValueError(f"unsupported revision file: {name}")
6367 target = destination / relative
......@@ -70,7 +74,6 @@ def export_revision(source, commit, paths, destination, excluded=frozenset()):
7074
7175
7276def upload(main=False):
73 excluded = set() if main else excluded_services(REPO)
7477 with tempfile.TemporaryDirectory() as temporary:
7578 snapshot = Path(temporary)
7679 revision = None
......@@ -84,23 +87,13 @@ def upload(main=False):
8487 if conflicted or not description.strip():
8588 raise ValueError("main needs a commit description and no conflicts before deployment")
8689 revision = {"commit": commit, "description": description}
87 # Production must use main's exclusions too. A working staging
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)
90 export_revision(REPO, commit, SOURCES, snapshot)
9591 else:
9692 subprocess.run(
9793 ["rsync", "-a", "--exclude=.DS_Store", "--exclude=__pycache__", "--exclude=*.pyc",
9894 "--exclude=.identities.lock", "--exclude=identities.pending", "--exclude=._*",
9995 "--exclude=dashboard/node_modules", "--exclude=dashboard/dist",
10096 "--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)),
10497 *(str(REPO / path) for path in SOURCES),
10598 str(snapshot) + "/"], check=True,
10699 )
......@@ -156,21 +149,21 @@ def upload(main=False):
156149 details = {"id": release, "digest": digest, "version": 2}
157150 if revision:
158151 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")
160153 if subprocess.run(
161154 ["ssh", "-p", PORT, "-o", "BatchMode=yes", HOST, f"test -d {remote_release}"],
162155 check=False,
163156 ).returncode == 0:
164157 ssh(f"python3 {remote_release}/tools/release.py verify {release}")
165158 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)"
167160 subprocess.run(["ssh", "-p", PORT, "-o", "BatchMode=yes", HOST,
168161 "python3 -c " + shlex.quote(script)], input=json.dumps(details) + "\n", text=True, check=True)
169162 return release
170163 ssh(f"mkdir -p {remote_release}")
171164 subprocess.run(
172165 ["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"),
174167 f"{HOST}:{remote_release}/"], check=True,
175168 )
176169 ssh(f"chmod -R a-w {remote_release}")
......@@ -215,29 +208,30 @@ def main():
215208 values = args.file.read_text()
216209 if not values.strip():
217210 raise ValueError("secret input is empty")
211 prepare_remote()
218212 manager = f"python3 {REMOTE}/release.py"
219213 if args.mode == "stage":
220214 release = upload()
221215 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}")
223217 elif args.mode == "secrets":
224218 release = upload()
225219 keys = "".join(f" --key {shlex.quote(key)}" for key in args.key)
226220 subprocess.run(
227221 ["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}"],
229223 input=values, text=True, check=True,
230224 )
231225 elif args.mode == "bootstrap":
232226 release = upload(main=True)
233227 sync_manager(release)
234228 ssh(f"{manager} publish {release}")
235 ssh(f"python3 {REMOTE}/releases/{release}/tools/studio.py pool")
236 ssh(f"python3 {REMOTE}/releases/{release}/tools/studio.py bootstrap")
229 ssh(f"python3 {REMOTE}/releases/{release}/tools/snowglobe.py pool")
230 ssh(f"python3 {REMOTE}/releases/{release}/tools/snowglobe.py bootstrap")
237231 ssh(f"python3 {REMOTE}/releases/{release}/tools/release.py bootstrap {release}")
238232 elif args.mode == "allocate":
239233 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}")
241235 elif args.mode in {"publish", "prod"}:
242236 release = upload(main=True)
243237 sync_manager(release)
......@@ -255,11 +249,8 @@ def main():
255249 release = upload()
256250 run_logged("data-restore", args.target, f"python3 {REMOTE}/releases/{release}/tools/data.py restore {args.backup} {args.target} --discard-writes")
257251 else:
258 metadata = json.loads(ssh(f"cat /var/lib/studio/stages/{args.target}.json", capture=True).stdout)
259 release = metadata.get("release")
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}")
252 release = upload()
253 run_logged("destroy", args.target, f"python3 {REMOTE}/releases/{release}/tools/release.py stage-destroy {args.target}")
263254
264255
265256if __name__ == "__main__":
tools/evil-forgejo-migration.md deleted-27
......@@ -1,27 +0,0 @@
1# evil.inc Forgejo cutover
2
3Zenith's Forgejo database is 21 MB; its app directory is about 14 GB. The VM Forgejo has the same usernames for all seven numeric user IDs referenced by the imported HedgeDoc OAuth profiles. This checks identity continuity without inspecting private repository contents. The app directory must move with the database because it holds Git objects, LFS data, attachments, avatars, and indexes.
4
5Snow Globe generates a new automation account password, but the imported Forgejo database needs the old signing and security keys. The named secret import preserves Snow Globe's automation password while replacing only the legacy values. With `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT` pointing at the production host, run:
6
7```sh
8bash tools/import-legacy-secrets.sh evil-forgejo \
9 mailer_address=MAILER_ADDRESS \
10 mailer_username=MAILER_USERNAME \
11 mailer_password=MAILER_PASSWORD \
12 lfs_jwt=EVIL_FORGEJO_SERVER_LFS_JWT_SECRET \
13 oauth_jwt=EVIL_FORGEJO_OAUTH2_JWT_SECRET \
14 security_key=EVIL_FORGEJO_SECURITY_SECRET_KEY \
15 internal_token=EVIL_FORGEJO_SECURITY_INTERNAL_TOKEN \
16 anubis_key=ANUBIS_PRIVATE_KEY
17```
18
19The source `.env` contains one unquoted value for each named key. The importer streams them through stdin and checks the destination field names against the service definition. Stop the old Forgejo and HedgeDoc before the final database and app-directory copy, and keep both stopped until the new Forgejo and HedgeDoc identities are checked. Do not switch the public route before the repository data and database have been restored together.
20
21For a same-machine OS replacement, use the [legacy PostgreSQL handoff](legacy-handoff.md) before reboot. After the encrypted apps dataset is mounted on NixOS, import the original Forgejo secrets with `STUDIO_LEGACY_HANDOFF` set, stop the Snow Globe Forgejo job, then run `bash tools/import-evil-forgejo.sh`. It checks the retained database dump and secret fingerprints, copies `/mnt/storage1/apps/evil-infra/forgejo` directly into the managed service dataset, compares a content digest without exposing file contents, restores the database, and checks user/repository counts. It keeps the new job stopped and prints the pre-import ZFS snapshot and database dump for recovery. The 14 GB production copy has not run on the VM.
22
23A read-only Zenith `pg_dump` restored into a disposable VM PostgreSQL database on 2026-09-26. The source and restored database both had 10 users and 15 repositories; the disposable database was removed afterward. No repository contents were opened or copied. This verifies the logical database restore separately from the 14 GB file transfer.
24
25A disposable VM fixture also passed the importer's `rsync -aH --numeric-ids --one-file-system --delete` copy and `tree-hash.py` comparison, including a hardlink, symlink, owner, group, and mode. The production 14 GB transfer remains untested.
26
27After a database import, Snow Globe's saved HedgeDoc OAuth application ID may point to a different legacy client. The provider now checks the client ID before updating an application and creates a fresh OAuth client when the saved one is missing or belongs to another client. A VM probe used a real ID collision: the unrelated client remained unchanged, the replacement client was created, and the temporary replacement was deleted after the check.
tools/export-legacy-postgres.sh deleted-80
......@@ -1,80 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
5root=/mnt/storage1/apps/studio-handoff
6id=$(date -u +%Y%m%dT%H%M%SZ)-$(python3 -c 'import secrets; print(secrets.token_hex(3))')
7pending=$root/.pending-$id
8final=$root/$id
9
10ssh "$source_host" 'test "$(findmnt -n -o SOURCE --mountpoint /mnt/storage1/apps)" = storage1/apps; test "$(findmnt -n -o FSTYPE --mountpoint /mnt/storage1/apps)" = zfs'
11ssh "$source_host" 'sudo -n docker info >/dev/null'
12
13check_stopped() {
14 [[ $(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' evil-forgejo") == false ]] || {
15 echo 'Stop Zenith evil-forgejo before exporting the final database' >&2
16 exit 1
17 }
18 [[ $(ssh "$source_host" "sudo -n docker ps -a --filter label=com.docker.compose.service=evil-hedgedoc --format '{{.State}}'") == exited ]] || {
19 echo 'Stop Zenith evil-hedgedoc before exporting the final databases' >&2
20 exit 1
21 }
22}
23
24check_stopped
25ssh "$source_host" 'sudo -n docker exec postgres pg_isready -U postgres >/dev/null'
26ssh "$source_host" 'test -r /mnt/storage1/apps/home-infra/.env'
27ssh "$source_host" "set -e; test ! -e '$final'; mkdir -m 700 -p '$root'; mkdir -m 700 '$pending'"
28for database in evil-forgejo evil-hedgedoc; do
29 ssh "$source_host" "set -e; umask 077; sudo -n docker exec postgres pg_dump -U postgres -Fc --no-owner --no-acl '$database' > '$pending/$database.dump'; test -s '$pending/$database.dump'; sudo -n docker exec -i postgres pg_restore -l < '$pending/$database.dump' >/dev/null"
30done
31check_stopped
32ssh "$source_host" python3 - "$pending" "$id" <<'PY'
33import hashlib
34import json
35from pathlib import Path
36import subprocess
37import sys
38
39folder = Path(sys.argv[1])
40manifest = {"id": sys.argv[2], "databases": {}}
41queries = {
42 "evil-forgejo": 'SELECT (SELECT count(*) FROM "user"), (SELECT count(*) FROM repository)',
43 "evil-hedgedoc": 'SELECT (SELECT count(*) FROM "Notes"), (SELECT count(*) FROM "Users"), (SELECT count(*) FROM "Revisions"), (SELECT count(*) FROM "Authors")',
44}
45for name in ("evil-forgejo", "evil-hedgedoc"):
46 source = folder / f"{name}.dump"
47 digest = hashlib.sha256()
48 with source.open("rb") as file:
49 for chunk in iter(lambda: file.read(1024 * 1024), b""):
50 digest.update(chunk)
51 result = subprocess.run(["sudo", "-n", "docker", "exec", "postgres", "psql", "-U", "postgres", "-d", name,
52 "-At", "-c", queries[name]], check=True, capture_output=True, text=True)
53 counts = [int(value) for value in result.stdout.strip().split("|")]
54 if len(counts) != (4 if name == "evil-hedgedoc" else 2):
55 raise ValueError(f"Unexpected count result for {name}")
56 manifest["databases"][name] = {"file": source.name, "bytes": source.stat().st_size,
57 "sha256": digest.hexdigest(), "counts": counts}
58legacy_env = (Path("/mnt/storage1/apps/home-infra/.env")).read_text().splitlines()
59forgejo_secrets = {
60 "lfs_jwt": "EVIL_FORGEJO_SERVER_LFS_JWT_SECRET",
61 "oauth_jwt": "EVIL_FORGEJO_OAUTH2_JWT_SECRET",
62 "security_key": "EVIL_FORGEJO_SECURITY_SECRET_KEY",
63 "internal_token": "EVIL_FORGEJO_SECURITY_INTERNAL_TOKEN",
64 "anubis_key": "ANUBIS_PRIVATE_KEY",
65 "mailer_address": "MAILER_ADDRESS",
66 "mailer_username": "MAILER_USERNAME",
67 "mailer_password": "MAILER_PASSWORD",
68}
69fingerprints = {}
70for target, source in forgejo_secrets.items():
71 values = [line.split("=", 1)[1] for line in legacy_env if line.startswith(source + "=")]
72 if len(values) != 1 or not values[0]:
73 raise ValueError(f"Legacy Forgejo secret is unavailable: {source}")
74 fingerprints[target] = hashlib.sha256(values[0].encode()).hexdigest()
75manifest["databases"]["evil-forgejo"]["secretSha256"] = fingerprints
76(folder / "manifest.json").write_text(json.dumps(manifest, indent=2) + "\n")
77PY
78ssh "$source_host" "set -e; chmod 600 '$pending/manifest.json'; mv '$pending' '$final'; sync"
79check_stopped
80echo "Legacy PostgreSQL handoff: $final"
tools/export-offline-postgres.py deleted-220
......@@ -1,220 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3from contextlib import contextmanager
4from datetime import datetime, timezone
5import hashlib
6import json
7import os
8from pathlib import Path
9import secrets
10import shutil
11import subprocess
12import tempfile
13
14
15def run(command, *, user=None, output=None):
16 result = subprocess.run(command, stdout=output or subprocess.PIPE,
17 stderr=subprocess.PIPE, user=user, group=user,
18 extra_groups=[] if user is not None else None)
19 if result.returncode:
20 with (destination / 'diagnostics.log').open('ab') as log:
21 log.write(result.stderr)
22 raise RuntimeError(f'{Path(command[0]).name} failed; see private diagnostics.log')
23 return result.stdout
24
25
26def sha256(path):
27 digest = hashlib.sha256()
28 with path.open('rb') as source:
29 for block in iter(lambda: source.read(1024 * 1024), b''):
30 digest.update(block)
31 return digest.hexdigest()
32
33
34def tree_hash(path):
35 digest = hashlib.sha256()
36 for entry in sorted(path.rglob('*')):
37 digest.update(str(entry.relative_to(path)).encode() + b'\0')
38 if entry.is_symlink():
39 raise ValueError(f'External cluster link requires separate backup: {entry}')
40 if entry.is_file():
41 digest.update(bytes.fromhex(sha256(entry)))
42 return digest.hexdigest()
43
44
45def identifier(value):
46 return '"' + value.replace('"', '""') + '"'
47
48
49@contextmanager
50def server(runtime, folder, *, source=None):
51 folder.mkdir(mode=0o700)
52 data = folder / 'data'
53 socket = folder / 'socket'
54 socket.mkdir(mode=0o700)
55 os.chown(folder, 65534, 65534)
56 os.chown(socket, 65534, 65534)
57 if source:
58 run(['rsync', '-aH', '--numeric-ids', str(source) + '/', str(data) + '/'])
59 (data / 'postmaster.pid').unlink(missing_ok=True)
60 for entry in [data, *data.rglob('*')]:
61 os.chown(entry, 65534, 65534)
62 else:
63 run([str(runtime / 'bin/initdb'), '-D', str(data), '-U', 'infra2_backup_verifier',
64 '--auth=trust', '--locale=C.UTF-8'], user=65534)
65 config = folder / 'postgresql.conf'
66 config.write_text("listen_addresses = ''\nssl = off\nlogging_collector = off\n"
67 "shared_preload_libraries = ''\n"
68 f"unix_socket_directories = '{socket}'\n"
69 f"hba_file = '{folder / 'pg_hba.conf'}'\n")
70 (folder / 'pg_hba.conf').write_text('local all all trust\n')
71 os.chown(config, 65534, 65534)
72 os.chown(folder / 'pg_hba.conf', 65534, 65534)
73 control = [str(runtime / 'bin/pg_ctl'), '-D', str(data)]
74 try:
75 run(control + ['-l', str(folder / 'server.log'), '-o', f'-c config_file={config}',
76 '-w', 'start'], user=65534)
77 yield socket
78 finally:
79 if (data / 'postmaster.pid').exists():
80 run(control + ['-m', 'fast', '-w', 'stop'], user=65534)
81
82
83def sql(runtime, socket, database, query, *, role='postgres'):
84 return run([str(runtime / 'bin/psql'), '-X', '-h', str(socket), '-U', role,
85 '-d', database, '-v', 'ON_ERROR_STOP=1', '-At', '-c', query])
86
87
88def fingerprint(runtime, socket, database):
89 relations = json.loads(sql(runtime, socket, database, """
90 SELECT coalesce(json_agg(x ORDER BY n, c), '[]') FROM (
91 SELECT n.nspname n, c.relname c, c.relkind k
92 FROM pg_class c JOIN pg_namespace n ON n.oid=c.relnamespace
93 WHERE n.nspname NOT LIKE 'pg_%' AND n.nspname <> 'information_schema'
94 AND c.relkind IN ('r','m','S')
95 ) x
96 """))
97 result = {}
98 for relation in relations:
99 table = identifier(relation['n']) + '.' + identifier(relation['c'])
100 query = (f'SELECT last_value,is_called FROM {table}' if relation['k'] == 'S' else
101 f"COPY (SELECT row_to_json(t)::text FROM {table} t "
102 'ORDER BY row_to_json(t)::text COLLATE "C") TO STDOUT')
103 content = sql(runtime, socket, database, query)
104 result[table] = {'rows': len(content.splitlines()),
105 'sha256': hashlib.sha256(content).hexdigest()}
106 for name, query in {
107 'large_objects': 'COPY (SELECT loid,pageno,encode(data,\'hex\') FROM pg_largeobject ORDER BY loid,pageno) TO STDOUT',
108 'large_object_owners': 'COPY (SELECT oid,pg_get_userbyid(lomowner),lomacl::text FROM pg_largeobject_metadata ORDER BY oid) TO STDOUT',
109 }.items():
110 content = sql(runtime, socket, database, query)
111 result[name] = {'rows': len(content.splitlines()),
112 'sha256': hashlib.sha256(content).hexdigest()}
113 return result
114
115
116parser = argparse.ArgumentParser(description='Export and restore-check stopped PostgreSQL clusters from private copies.')
117parser.add_argument('--cluster', nargs=2, action='append', required=True, metavar=('SOURCE', 'RUNTIME'))
118parser.add_argument('--locale-archive', type=Path, required=True)
119args = parser.parse_args()
120if os.geteuid() != 0:
121 parser.error('Run as root on the installer')
122os.umask(0o077)
123os.environ['LOCALE_ARCHIVE'] = str(args.locale_archive)
124os.environ.pop('PGOPTIONS', None)
125root = Path('/mnt/storage1/apps/studio-handoff')
126mounted = subprocess.check_output(['findmnt', '-n', '-o', 'SOURCE,FSTYPE', '--mountpoint', str(root.parent)], text=True).split()
127if len(mounted) != 2 or mounted[1] != 'zfs' or not mounted[0].endswith('/apps'):
128 parser.error('Expected retained apps dataset mounted at /mnt/storage1/apps')
129if subprocess.run(['pgrep', '-x', 'postgres'], stdout=subprocess.DEVNULL).returncode == 0:
130 parser.error('Stop PostgreSQL before taking an offline copy')
131handoff_id = datetime.now(timezone.utc).strftime('%Y%m%dT%H%M%SZ-') + secrets.token_hex(3)
132root.mkdir(mode=0o700, exist_ok=True)
133destination = root / ('.pending-' + handoff_id)
134destination.mkdir(mode=0o700)
135manifest = {'id': handoff_id, 'clusters': {}, 'databases': {}}
136work = Path(tempfile.mkdtemp(prefix='infra2-pg-export-', dir='/run'))
137os.chown(work, 65534, 65534)
138try:
139 for source_arg, runtime_arg in args.cluster:
140 source, runtime = Path(source_arg).resolve(), Path(runtime_arg).resolve()
141 if not source.is_relative_to(root.parent) or not (source / 'PG_VERSION').is_file():
142 raise ValueError('Source must be a retained cluster inside the apps dataset')
143 major = (source / 'PG_VERSION').read_text().strip()
144 version = run([str(runtime / 'bin/postgres'), '--version']).decode().strip()
145 if version.split()[-1].split('.')[0] != major or major in manifest['clusters']:
146 raise ValueError('Runtime major must match its unique source cluster')
147 before = tree_hash(source)
148 output = destination / ('pg' + major)
149 output.mkdir(mode=0o700)
150 run(['tar', '-C', str(source), '-czf', str(output / 'cluster.tar.gz'), '.'])
151 cluster = {'source': str(source), 'runtime': version, 'sourceSha256': before, 'databases': {}}
152 with server(runtime, work / ('source' + major), source=source) as socket:
153 databases = json.loads(sql(runtime, socket, 'postgres', """
154 SELECT json_agg(x ORDER BY name) FROM (
155 SELECT datname name, datallowconn connect, datistemplate template,
156 pg_get_userbyid(datdba) owner FROM pg_database WHERE datname <> 'template0'
157 ) x
158 """))
159 tablespaces = json.loads(sql(runtime, socket, 'postgres', "SELECT coalesce(json_agg(spcname), '[]') FROM pg_tablespace WHERE spcname NOT IN ('pg_default','pg_global')"))
160 if tablespaces:
161 raise ValueError('Custom tablespaces require an explicit restore layout')
162 with (output / 'globals.sql').open('wb') as file:
163 run([str(runtime / 'bin/pg_dumpall'), '-h', str(socket), '-U', 'postgres', '--globals-only'], output=file)
164 for index, database in enumerate(databases):
165 name = database['name']
166 if not database['connect']:
167 sql(runtime, socket, 'postgres', f'ALTER DATABASE {identifier(name)} ALLOW_CONNECTIONS true')
168 dump = output / f'{index:03d}.dump'
169 with dump.open('wb') as file:
170 run([str(runtime / 'bin/pg_dump'), '-h', str(socket), '-U', 'postgres', '-d', name,
171 '-Fc', '--create'], output=file)
172 entry = {**database, 'file': str(dump.relative_to(destination)), 'bytes': dump.stat().st_size,
173 'sha256': sha256(dump), 'contents': fingerprint(runtime, socket, name)}
174 cluster['databases'][name] = entry
175 if name in {'evil-forgejo', 'evil-hedgedoc'} and major == '18':
176 query = ('SELECT (SELECT count(*) FROM "user"), (SELECT count(*) FROM repository)' if name == 'evil-forgejo' else
177 'SELECT (SELECT count(*) FROM "Notes"), (SELECT count(*) FROM "Users"), (SELECT count(*) FROM "Revisions"), (SELECT count(*) FROM "Authors")')
178 entry['counts'] = [int(n) for n in sql(runtime, socket, name, query).decode().strip().split('|')]
179 if tree_hash(source) != before:
180 raise RuntimeError('Original cluster changed during export; export is not publishable')
181 with server(runtime, work / ('restore' + major)) as socket:
182 bootstrap = 'infra2_backup_verifier'
183 sql(runtime, socket, 'postgres', f'CREATE DATABASE {bootstrap}', role=bootstrap)
184 run([str(runtime / 'bin/psql'), '-X', '-h', str(socket), '-U', bootstrap, '-d', bootstrap,
185 '-v', 'ON_ERROR_STOP=1', '-f', str(output / 'globals.sql')])
186 sql(runtime, socket, bootstrap, 'ALTER DATABASE template1 IS_TEMPLATE false', role=bootstrap)
187 for name, entry in cluster['databases'].items():
188 run([str(runtime / 'bin/pg_restore'), '-h', str(socket), '-U', bootstrap, '-d', bootstrap,
189 '--clean', '--if-exists', '--create', '--exit-on-error', str(destination / entry['file'])])
190 if fingerprint(runtime, socket, name) != entry['contents']:
191 raise RuntimeError(f'Restored data differs: PostgreSQL {major} database {name}')
192 print(f'PostgreSQL {major}: restored and verified {name}', flush=True)
193 cluster['restoreVerified'] = True
194 manifest['clusters'][major] = cluster
195 for name in ('evil-forgejo', 'evil-hedgedoc'):
196 entry = manifest['clusters']['18']['databases'][name]
197 (destination / (name + '.dump')).symlink_to(entry['file'])
198 manifest['databases'][name] = {key: entry[key] for key in ('bytes', 'sha256', 'counts')}
199 manifest['databases'][name]['file'] = name + '.dump'
200 keys = {'lfs_jwt': 'EVIL_FORGEJO_SERVER_LFS_JWT_SECRET', 'oauth_jwt': 'EVIL_FORGEJO_OAUTH2_JWT_SECRET',
201 'security_key': 'EVIL_FORGEJO_SECURITY_SECRET_KEY', 'internal_token': 'EVIL_FORGEJO_SECURITY_INTERNAL_TOKEN',
202 'anubis_key': 'ANUBIS_PRIVATE_KEY', 'mailer_address': 'MAILER_ADDRESS',
203 'mailer_username': 'MAILER_USERNAME', 'mailer_password': 'MAILER_PASSWORD'}
204 legacy_env = (root.parent / 'home-infra/.env').read_text().splitlines()
205 fingerprints = {}
206 for target, key in keys.items():
207 values = [line.split('=', 1)[1] for line in legacy_env if line.startswith(key + '=')]
208 if len(values) != 1 or not values[0]:
209 raise ValueError(f'Legacy secret unavailable: {key}')
210 fingerprints[target] = hashlib.sha256(values[0].encode()).hexdigest()
211 manifest['databases']['evil-forgejo']['secretSha256'] = fingerprints
212 manifest['files'] = {str(path.relative_to(destination)): {'bytes': path.stat().st_size, 'sha256': sha256(path)}
213 for path in destination.rglob('*') if path.is_file() and not path.is_symlink()}
214 (destination / 'manifest.json').write_text(json.dumps(manifest, indent=2) + '\n')
215 final = root / handoff_id
216 destination.rename(final)
217 os.sync()
218 print(f'Verified PostgreSQL handoff: {final}', flush=True)
219finally:
220 shutil.rmtree(work)
tools/guest-channel-test.py+2-2
......@@ -15,13 +15,13 @@ class ChannelTests(unittest.TestCase):
1515 def test_only_the_running_domains_owned_channel_is_opened(self):
1616 path = f"/run/libvirt/qemu/channel/9-fixture/{vms.GUEST_CHANNEL}"
1717 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),
1919 (path.replace("9-fixture", "8-other"), "running", None),
2020 (path, "paused", None), (path, "running", "org.qemu.guest_agent.0")]:
2121 with self.subTest(source=source, state=state, channel=channel), self.assertRaises(ValueError):
2222 self.request(source, state, channel)
2323 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"})
2525 with self.assertRaises(ValueError):
2626 vms.validate("guest", {"name": "../other"})
2727
tools/guest-provider.py+3-3
......@@ -22,8 +22,8 @@ parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.R
2222parser.add_argument('provider', choices=['github', 'astheno'])
2323parser.add_argument('--client-id')
2424parser.add_argument('--disable', action='store_true')
25parser.add_argument('--host', default=os.environ.get('STUDIO_DEPLOY_HOST', 'root@zenith'))
26parser.add_argument('--port', default=os.environ.get('STUDIO_DEPLOY_PORT', '22'))
25parser.add_argument('--host', default=os.environ.get('SNOWGLOBE_DEPLOY_HOST', 'root@10.0.0.1'))
26parser.add_argument('--port', default=os.environ.get('SNOWGLOBE_DEPLOY_PORT', '22'))
2727args = parser.parse_args()
2828if not args.disable and not args.client_id:
2929 parser.error('--client-id is required unless --disable is used')
......@@ -31,7 +31,7 @@ payload = {'provider': args.provider, 'enabled': not args.disable}
3131if not args.disable:
3232 payload.update(clientId=args.client_id, clientSecret=getpass.getpass('Client secret: '))
3333result = 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'],
3535 input=json.dumps(payload), text=True, capture_output=True)
3636if result.returncode:
3737 raise SystemExit('Provider configuration did not complete. Check the dashboard and SSH connection.')
tools/hedgedoc-migration.md deleted-9
......@@ -1,9 +0,0 @@
1# HedgeDoc migration
2
3`bash tools/import-hedgedoc.sh evil-hedgedoc-preview-f6eb07a4` restored Zenith's HedgeDoc database into a disposable stage and copied its uploads. The importer checked the upload copy by checksum, backed up the stage database, compared the restored table counts with Zenith, and restarted the stage. On 2026-09-26 both sides had 39 notes, 8 users, 183 revisions, and 68 authors. The stage returned HTTPS 200; `/auth/oauth2` redirected to the staged Forgejo OAuth client at `git.evil.studio.test` with the stage callback URL. No note bodies or repository contents were inspected.
4
5The seven HedgeDoc OAuth profile IDs all resolve to the same Forgejo usernames on Zenith and the VM when matched by numeric user ID. That checks account continuity for the imported database; an interactive sign-in remains the final identity check.
6
7For production, keep the Forgejo user IDs stable. Stop Zenith's HedgeDoc and the Snow Globe HedgeDoc job, set `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT` for the new host, then run `bash tools/import-hedgedoc.sh evil-hedgedoc`. The importer refuses a running source or destination, verifies the uploads and four table counts, leaves a pre-import destination database dump, and leaves Snow Globe stopped. Promote a tested preview to start the new service, then verify HTTPS and a Forgejo sign-in before switching the public route. The old HedgeDoc data stays in place until cutover is accepted.
8
9For a same-machine OS replacement, use the [legacy PostgreSQL handoff](legacy-handoff.md) and set `STUDIO_LEGACY_HANDOFF` when running the production importer. It verifies the retained dump and reads uploads from the mounted old apps dataset without contacting old Docker.
tools/import-arr.sh deleted-127
......@@ -1,127 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4service=${1:?usage: tools/import-arr.sh sonarr|radarr [preview-id]}
5[[ $service == sonarr || $service == radarr ]] || { echo 'Expected sonarr or radarr' >&2; exit 1; }
6instance=${2:-$service}
7[[ $instance == "$service" || $instance =~ ^${service}-preview-[0-9a-f]{8}$ ]] || { echo 'Expected the service ID or its preview ID' >&2; exit 1; }
8
9source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
10target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
11target_port=${STUDIO_DEPLOY_PORT:-2222}
12remote=(ssh -p "$target_port" "$target_host")
13source_copy_host=$source_host
14source_rsh=ssh
15offline=false
16if [[ -n ${STUDIO_LEGACY_HANDOFF:-} ]]; then
17 [[ $instance == "$service" && -n ${STUDIO_DEPLOY_HOST:-} ]] || {
18 echo 'Offline handoff requires a production ARR service and target' >&2; exit 1;
19 }
20 sh "$(dirname "$0")/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$target_host" "$target_port"
21 source_copy_host=$target_host
22 source_rsh="ssh -p $target_port"
23 offline=true
24fi
25source_ssh() {
26 if [[ $offline == true ]]; then
27 "${remote[@]}" "$@"
28 else
29 ssh "$source_host" "$@"
30 fi
31}
32if [[ $instance == "$service" ]]; then
33 root="/srv/prod/$service"
34 if [[ $offline == false ]]; then
35 source_running=$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' $service")
36 [[ $source_running == false ]] || { echo "Stop Zenith $service before importing production data" >&2; exit 1; }
37 fi
38 response=$("${remote[@]}" "curl -s -w '\n%{http_code}' -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/$service")
39 status=${response##*$'\n'}
40 if [[ $status == 200 ]]; then
41 stopped=$(python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())' <<<"${response%$'\n'*}")
42 [[ $stopped == true ]] || { echo "Stop production $service before importing" >&2; exit 1; }
43 elif [[ $status != 404 ]]; then
44 echo "Could not verify production $service job state: $status" >&2
45 exit 1
46 fi
47else
48 root="/srv/staging/$instance"
49 source_id=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
50 [[ $source_id == "$service" ]] || { echo 'Preview belongs to another service' >&2; exit 1; }
51fi
52dataset=$("${remote[@]}" "findmnt -n -o SOURCE --mountpoint $root")
53[[ $dataset == */prod/"$service" || $dataset == */staging/"$instance" ]] || { echo "Expected a mounted service dataset at $root" >&2; exit 1; }
54
55scratch=$(mktemp -d)
56source_backup=
57cleanup() {
58 rm -rf "$scratch"
59 if [[ -n $source_backup ]]; then
60 source_ssh "rm -f '$source_backup'"
61 fi
62}
63trap cleanup EXIT
64
65source_backup=$(source_ssh "python3 - '/mnt/storage1/apps/$service/$service.db'" <<'PY'
66import os
67import sqlite3
68import sys
69import tempfile
70
71source = sqlite3.connect(f"file:{sys.argv[1]}?mode=ro", uri=True)
72fd, name = tempfile.mkstemp(prefix="studio-arr-", suffix=".db")
73os.close(fd)
74try:
75 target = sqlite3.connect(name)
76 source.backup(target)
77 if target.execute("PRAGMA integrity_check").fetchone()[0] != "ok":
78 raise ValueError("ARR SQLite backup is invalid")
79 target.close()
80 source.close()
81except BaseException:
82 os.unlink(name)
83 raise
84print(name)
85PY
86)
87rsync -a --exclude="/$service.db*" --exclude='/logs.db*' --exclude='/*.pid' --exclude='/logs/' \
88 -e "$source_rsh" "$source_copy_host:/mnt/storage1/apps/$service/" "$scratch/config/"
89if [[ $offline == true ]]; then
90 scp -q -P "$target_port" "$source_copy_host:$source_backup" "$scratch/config/$service.db"
91else
92 scp -q "$source_copy_host:$source_backup" "$scratch/config/$service.db"
93fi
94
95if [[ $instance != "$service" ]]; then
96 "${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
97fi
98for _ in {1..30}; do
99 running=$("${remote[@]}" "curl -s -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/$instance/allocations" |
100 python3 -c 'import json,sys; print(sum(x["ClientStatus"] == "running" for x in json.load(sys.stdin)))')
101 [[ $running == 0 ]] && break
102 sleep 2
103done
104[[ $running == 0 ]] || { echo "$instance still has a running allocation" >&2; exit 1; }
105
106snapshot="$dataset@before-arr-import-$(date +%s)-$$"
107"${remote[@]}" "zfs snapshot $snapshot"
108rsync -a --delete -e "ssh -p $target_port" "$scratch/config/" "$target_host:$root/config/"
109uid=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"$service\"])'")
110"${remote[@]}" "chown -R $uid:$uid $root/config; chmod 750 $root/config; python3 -c 'import sqlite3; c=sqlite3.connect(\"$root/config/$service.db\"); assert c.execute(\"PRAGMA integrity_check\").fetchone()[0] == \"ok\"'"
111local_hash=$(shasum -a 256 "$scratch/config/$service.db" | cut -d ' ' -f 1)
112remote_hash=$("${remote[@]}" "sha256sum $root/config/$service.db" | cut -d ' ' -f 1)
113[[ $local_hash == "$remote_hash" ]] || { echo 'Copied database hash differs from source backup' >&2; exit 1; }
114
115if [[ $instance == "$service" ]]; then
116 if [[ $offline == false ]]; then
117 [[ $(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' $service") == false ]] || {
118 echo "Zenith $service restarted during import; leave the home server stopped" >&2
119 exit 1
120 }
121 fi
122 echo "Imported production $service from Zenith. Previous dataset state: $snapshot"
123else
124 python3 "$(dirname "$0")/deploy.py" stage "$service"
125 "${remote[@]}" "zfs destroy $snapshot"
126 echo "Imported and tested $instance"
127fi
tools/import-dashboard-auth.py deleted-59
......@@ -1,59 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import hashlib
4import json
5import os
6from pathlib import Path
7import subprocess
8
9
10parser = argparse.ArgumentParser(description="Copy Keycloak accounts into a private dashboard import")
11parser.add_argument("--host", required=True)
12parser.add_argument("--output", required=True, type=Path)
13args = parser.parse_args()
14if args.output.exists():
15 parser.error("output already exists")
16
17remote = r'''
18import json, subprocess, urllib.request
19request = urllib.request.Request("http://127.0.0.1:4646/v1/job/postgres/allocations", headers={"X-Nomad-Token":open("/var/lib/studio/nomad.token").read().strip()})
20allocations = [a["ID"] for a in json.load(urllib.request.urlopen(request)) if a["ClientStatus"] == "running" and a["DesiredStatus"] == "run"]
21assert len(allocations) == 1
22containers = [line.split()[0] for line in subprocess.check_output(["podman", "ps", "--format", "{{.ID}} {{.Names}}"], text=True).splitlines() if line.split()[1].endswith(allocations[0])]
23assert len(containers) == 1
24sql = """
25BEGIN TRANSACTION ISOLATION LEVEL REPEATABLE READ READ ONLY;
26SELECT json_build_object(
27 'issuer','https://auth.paperclover.net/realms/master',
28 'rpId','auth.paperclover.net',
29 'roles',(SELECT coalesce(json_agg(json_build_object('id',id,'name',name)), '[]') FROM keycloak_role WHERE realm_id=(SELECT id FROM realm WHERE name='master') AND client_role=false),
30 'users',(SELECT coalesce(json_agg(json_build_object(
31 'id',u.id,'username',u.username,'email',u.email,'firstName',u.first_name,'lastName',u.last_name,
32 'enabled',u.enabled,'emailVerified',u.email_verified,'createdTimestamp',u.created_timestamp,
33 'requiredActions',(SELECT coalesce(json_agg(required_action),'[]') FROM user_required_action WHERE user_id=u.id),
34 'attributes',(SELECT coalesce(json_object_agg(name,vals),'{}') FROM (SELECT name,json_agg(value) AS vals FROM user_attribute WHERE user_id=u.id GROUP BY name)a),
35 'roles',(SELECT coalesce(json_agg(role_id),'[]') FROM user_role_mapping WHERE user_id=u.id),
36 'credentials',(SELECT coalesce(json_agg(json_build_object('id',id,'type',type,'userLabel',user_label,'createdDate',created_date,'credentialData',credential_data::json,'secretData',secret_data::json)),'[]') FROM credential WHERE user_id=u.id)
37 )),'[]') FROM user_entity u WHERE realm_id=(SELECT id FROM realm WHERE name='master'))
38);
39COMMIT;
40"""
41result = subprocess.run(["podman", "exec", "-i", containers[0], "psql", "-U", "postgres", "-d", "keycloak_next", "-tA", "-v", "ON_ERROR_STOP=1"], input=sql, text=True, capture_output=True, check=True)
42print(next(line for line in result.stdout.splitlines() if line.startswith('{')))
43'''
44result = subprocess.run(["ssh", "-o", "BatchMode=yes", args.host, "python3", "-"], input=remote, text=True, capture_output=True, check=True)
45data = json.loads(result.stdout)
46if not data["users"]:
47 raise ValueError("source realm has no accounts")
48content = (json.dumps(data, separators=(",", ":")) + "\n").encode()
49args.output.parent.mkdir(mode=0o700, parents=True, exist_ok=True)
50with os.fdopen(os.open(args.output, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600), "wb") as output:
51 output.write(content)
52 output.flush()
53 os.fsync(output.fileno())
54counts = {}
55for user in data["users"]:
56 for credential in user["credentials"]:
57 kind = credential["type"]
58 counts[kind] = counts.get(kind, 0) + 1
59print(json.dumps({"accounts": len(data["users"]), "credentials": counts, "sha256": hashlib.sha256(content).hexdigest()}))
tools/import-dawarich.sh deleted-73
......@@ -1,73 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4instance=${1:?usage: tools/import-dawarich.sh dawarich-preview-XXXXXXXX}
5[[ $instance =~ ^dawarich-preview-[0-9a-f]{8}$ ]] || {
6 echo 'Expected a Dawarich preview ID' >&2
7 exit 1
8}
9
10source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
11target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
12target_port=${STUDIO_DEPLOY_PORT:-2222}
13remote=(ssh -p "$target_port" "$target_host")
14
15root=/srv/staging/$instance
16source_id=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
17[[ $source_id == dawarich ]] || { echo 'Preview belongs to another service' >&2; exit 1; }
18snapshot=$(ssh "$source_host" '/usr/sbin/zfs list -H -t snapshot -o name -s creation -r storage1/apps | tail -n 1')
19[[ $snapshot == storage1/apps@* ]] || { echo 'No Zenith app snapshot is available' >&2; exit 1; }
20source_root=/mnt/storage1/apps/.zfs/snapshot/${snapshot#*@}/dawarich_storage
21
22dataset=$("${remote[@]}" "findmnt -n -o SOURCE --mountpoint $root")
23[[ $dataset == */staging/$instance ]] || { echo 'Preview dataset is not mounted' >&2; exit 1; }
24
25source_secret=$(ssh "$source_host" "sudo -n docker inspect -f '{{range .Config.Env}}{{println .}}{{end}}' dawarich-app" |
26 python3 -c 'import hashlib,sys; values=[line.split("=",1)[1] for line in sys.stdin.read().splitlines() if line.startswith("SECRET_KEY_BASE=")]; assert len(values)==1; print(hashlib.sha256(values[0].encode()).hexdigest())')
27own=$("${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad var get -out json nomad/jobs/$instance" |
28 python3 -c 'import hashlib,json,sys; print(hashlib.sha256(json.load(sys.stdin)["Items"]["secret_key_base"].encode()).hexdigest())')
29[[ $source_secret == "$own" ]] || { echo 'Dawarich secret differs from Zenith; import the original before restoring data' >&2; exit 1; }
30
31db_json=$("${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad var get -out json nomad/jobs/$instance/inputs/database")
32read -r database owner < <(python3 -c 'import json,sys; d=json.load(sys.stdin)["Items"]; print(d["name"], d["username"])' <<<"$db_json")
33[[ $database =~ ^dawarich_s_[0-9a-f]{8}$ && $owner == svc_$database ]] || { echo 'Unexpected preview database' >&2; exit 1; }
34
35allocation=$("${remote[@]}" 'NOMAD_TOKEN=$(cat /var/lib/studio/nomad.token) nomad job allocs -json postgres' |
36 python3 -c 'import json,sys; ids=[a["ID"] for a in json.load(sys.stdin) if a["ClientStatus"]=="running" and a["DesiredStatus"]=="run"]; assert len(ids)==1; print(ids[0])')
37container=app-$allocation
38podman='podman --url unix:///run/podman/podman.sock'
39scratch=$(mktemp -d)
40trap 'rm -rf "$scratch"' EXIT
41rsync -a "$source_host:$source_root/" "$scratch/"
42drift=$(rsync -rlnc --delete --out-format='%n' "$source_host:$source_root/" "$scratch/")
43[[ -z $drift ]] || { echo 'Zenith storage changed during copy; retry the import' >&2; exit 1; }
44source_counts=$(ssh "$source_host" 'sudo -n docker exec postgres psql -U postgres -d dawarich -At -c "SELECT (SELECT count(*) FROM points), (SELECT count(*) FROM users)"')
45
46"${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
47for _ in {1..30}; do
48 running=$("${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job allocs -json $instance" |
49 python3 -c 'import json,sys; print(sum(a["ClientStatus"]=="running" for a in json.load(sys.stdin)))')
50 [[ $running == 0 ]] && break
51 sleep 2
52done
53[[ $running == 0 ]] || { echo 'Dawarich allocation is still running' >&2; exit 1; }
54
55backup_snapshot=$dataset@before-dawarich-import-$(date +%s)-$$
56"${remote[@]}" "zfs snapshot $backup_snapshot"
57rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/var/app/storage/"
58uid=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"dawarich\"])'")
59"${remote[@]}" "chown -R $uid:$uid $root/var/app/storage"
60drift=$(rsync -rlnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/" "$target_host:$root/var/app/storage/")
61[[ -z $drift ]] || { echo "Storage copy differs from Zenith; restore $backup_snapshot" >&2; exit 1; }
62
63backup=/var/lib/studio/$instance-before-import.dump
64"${remote[@]}" "umask 077; $podman exec $container pg_dump -U postgres -Fc $database > $backup; test -s $backup"
65"${remote[@]}" "$podman exec $container psql -U postgres -d $database -v ON_ERROR_STOP=1 -c 'DROP SCHEMA public CASCADE; CREATE SCHEMA public AUTHORIZATION $owner; CREATE EXTENSION postgis;' >/dev/null"
66ssh "$source_host" 'sudo -n docker exec postgres pg_dump -U postgres -Fc --no-owner --no-acl --exclude-extension=postgis dawarich' |
67 "${remote[@]}" "$podman exec -i $container pg_restore -U postgres -d $database --no-owner --no-acl --role=$owner"
68target_counts=$("${remote[@]}" "$podman exec $container psql -U postgres -d $database -At -c 'SELECT (SELECT count(*) FROM points), (SELECT count(*) FROM users)'")
69[[ $source_counts == "$target_counts" ]] || { echo "Database counts differ from Zenith; restore $backup" >&2; exit 1; }
70
71python3 "$(dirname "$0")/deploy.py" stage dawarich
72"${remote[@]}" "zfs destroy $backup_snapshot"
73echo "Imported $instance from $snapshot. Previous database: $backup"
tools/import-evil-forgejo.sh deleted-77
......@@ -1,77 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4: "${STUDIO_DEPLOY_HOST:?Set STUDIO_DEPLOY_HOST to the production target}"
5: "${STUDIO_LEGACY_HANDOFF:?Set STUDIO_LEGACY_HANDOFF to the offline PostgreSQL handoff}"
6
7target_port=${STUDIO_DEPLOY_PORT:-22}
8remote=(ssh -p "$target_port" "$STUDIO_DEPLOY_HOST")
9sh "$(dirname "$0")/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$STUDIO_DEPLOY_HOST" "$target_port"
10root=/srv/prod/evil-forgejo
11source_dir=/mnt/storage1/apps/evil-infra/forgejo
12database=evil_forgejo
13owner=svc_evil_forgejo
14podman='podman --url unix:///run/podman/podman.sock'
15
16entry=$("${remote[@]}" "python3 - '$STUDIO_LEGACY_HANDOFF' evil-forgejo" < "$(dirname "$0")/verify-legacy-dump.py")
17source_counts=$(python3 -c 'import json,sys; print("|".join(map(str,json.load(sys.stdin)["counts"])))' <<<"$entry")
18"${remote[@]}" "test \$(findmnt -n -o FSTYPE --mountpoint $root) = zfs; test -d $source_dir"
19
20response=$("${remote[@]}" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/evil-forgejo')
21[[ ${response##*$'\n'} == 200 ]] || { echo 'evil.inc Forgejo is unavailable on the home server' >&2; exit 1; }
22stopped=$(python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())' <<<"${response%$'\n'*}")
23[[ $stopped == true ]] || { echo 'Stop evil.inc Forgejo on the home server before importing' >&2; exit 1; }
24for _ in {1..30}; do
25 running=$("${remote[@]}" 'NOMAD_TOKEN=$(cat /var/lib/studio/nomad.token) nomad job allocs -json evil-forgejo' |
26 python3 -c 'import json,sys; print(sum(a["ClientStatus"] == "running" for a in json.load(sys.stdin)))')
27 [[ $running == 0 ]] && break
28 sleep 2
29done
30[[ $running == 0 ]] || { echo 'evil.inc Forgejo did not stop on the home server' >&2; exit 1; }
31
32db_json=$("${remote[@]}" 'NOMAD_TOKEN=$(cat /var/lib/studio/nomad.token) nomad var get -out json nomad/jobs/evil-forgejo/inputs/database')
33read -r actual_database actual_owner < <(python3 -c 'import json,sys; d=json.load(sys.stdin)["Items"]; print(d["name"], d["username"])' <<<"$db_json")
34[[ $actual_database == "$database" && $actual_owner == "$owner" ]] || { echo 'Unexpected evil.inc Forgejo database on the home server' >&2; exit 1; }
35
36"${remote[@]}" "python3 - '$STUDIO_LEGACY_HANDOFF'" <<'PY'
37import hashlib
38import json
39import os
40from pathlib import Path
41import subprocess
42import sys
43
44legacy = json.loads((Path(sys.argv[1]) / "manifest.json").read_text())["databases"]["evil-forgejo"]["secretSha256"]
45environment = {**os.environ, "NOMAD_TOKEN": Path("/var/lib/studio/nomad.token").read_text().strip()}
46result = subprocess.run(["nomad", "var", "get", "-out", "json", "nomad/jobs/evil-forgejo"],
47 check=True, capture_output=True, text=True, env=environment)
48actual = json.loads(result.stdout)["Items"]
49for name, fingerprint in legacy.items():
50 if name not in actual or hashlib.sha256(actual[name].encode()).hexdigest() != fingerprint:
51 raise ValueError(f"Import the original evil.inc Forgejo secret before restoring data: {name}")
52PY
53
54allocation=$("${remote[@]}" 'NOMAD_TOKEN=$(cat /var/lib/studio/nomad.token) nomad job allocs -json postgres' |
55 python3 -c 'import json,sys; ids=[a["ID"] for a in json.load(sys.stdin) if a["ClientStatus"] == "running" and a["DesiredStatus"] == "run"]; assert len(ids) == 1; print(ids[0])')
56container=app-$allocation
57source_manifest=$("${remote[@]}" "python3 - '$source_dir'" < "$(dirname "$0")/tree-hash.py")
58source_bytes=$(python3 -c 'import json,sys; print(json.load(sys.stdin)["bytes"])' <<<"$source_manifest")
59available=$("${remote[@]}" "df -B1 --output=avail $root | tail -n 1")
60(( available > source_bytes )) || { echo 'Too little free space for the evil.inc Forgejo app directory' >&2; exit 1; }
61
62dataset=$("${remote[@]}" "findmnt -n -o SOURCE --mountpoint $root")
63[[ $dataset == */prod/evil-forgejo ]] || { echo 'Unexpected production dataset' >&2; exit 1; }
64snapshot=$dataset@before-evil-forgejo-import-$(date +%s)-$$
65"${remote[@]}" "set -e; zfs snapshot '$snapshot'; mkdir -p '$root/data'; rsync -aH --numeric-ids --one-file-system --delete '$source_dir/' '$root/data/'"
66target_manifest=$("${remote[@]}" "python3 - '$root/data'" < "$(dirname "$0")/tree-hash.py")
67[[ $source_manifest == "$target_manifest" ]] || { echo "Forgejo app-directory copy differs; restore $snapshot" >&2; exit 1; }
68uid=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"evil-forgejo\"])'")
69"${remote[@]}" "chown -R $uid:$uid '$root/data'"
70
71backup=$root/before-import-$(date +%s)-$$.dump
72"${remote[@]}" "umask 077; $podman exec $container pg_dump -U postgres -Fc $database > '$backup'; test -s '$backup'"
73"${remote[@]}" "$podman exec $container psql -U postgres -d $database -v ON_ERROR_STOP=1 -c 'DROP SCHEMA public CASCADE; CREATE SCHEMA public AUTHORIZATION $owner;' >/dev/null"
74"${remote[@]}" "set -o pipefail; cat '$STUDIO_LEGACY_HANDOFF/evil-forgejo.dump' | $podman exec -i $container pg_restore -U postgres -d $database --no-owner --no-acl --role=$owner"
75counts=$("${remote[@]}" "$podman exec $container psql -U postgres -d $database -At -c 'SELECT (SELECT count(*) FROM \"user\"), (SELECT count(*) FROM repository)'")
76[[ $counts == "$source_counts" ]] || { echo "Forgejo database counts differ; restore $backup" >&2; exit 1; }
77echo "Imported evil.inc Forgejo app files and database; verified user/repository counts: $counts. Previous dataset: $snapshot. Previous database: $backup"
tools/import-forgejo-issues.py deleted-512
......@@ -1,512 +0,0 @@
1#!/usr/bin/env python3
2"""Import a verified personal Forgejo export into stopped Shale, without replacing native issues."""
3import argparse
4from collections import Counter, defaultdict
5from datetime import datetime, timezone
6import hashlib
7import grp
8import json
9import os
10from pathlib import Path
11import re
12import shutil
13import sqlite3
14import sys
15import tempfile
16import urllib.request
17from urllib.parse import quote
18
19ALPHABET = '0123456789ABCDEFGHJKMNPQRSTVWXYZ'
20EPOCH = 1577836800 # Shale's ULIDs use 2020-01-01, rather than the Unix epoch.
21CLOSED = ('done', 'not_planned', 'duplicate', 'invalid')
22EVENTS = ['comment', 'reopened', 'closed', 'issue reference', 'commit reference',
23 'comment reference', 'pull request reference', 'label changed', 'milestone changed',
24 'assignee changed', 'title changed', 'branch deleted', 'time tracking started',
25 'time tracking stopped', 'time added', 'time tracking canceled', 'deadline added',
26 'deadline changed', 'deadline removed', 'dependency added', 'dependency removed',
27 'code comment', 'review', 'locked', 'unlocked', 'target branch changed',
28 'time deleted', 'review requested', 'merged', 'pull request updated',
29 'project changed', 'project column changed', 'review dismissed', 'reference changed',
30 'automatic merge scheduled', 'automatic merge canceled', 'pinned', 'unpinned']
31
32
33def timestamp(epoch):
34 return datetime.fromtimestamp(int(epoch), timezone.utc).isoformat(timespec='seconds')
35
36
37def identifier(kind, key, epoch):
38 milliseconds = (int(epoch) - EPOCH) * 1000
39 if not 0 <= milliseconds < 2 ** 48:
40 raise ValueError('Source creation time is outside Shale ULID range')
41 entropy = int.from_bytes(hashlib.sha256(f'personal-forgejo:{kind}:{key}'.encode()).digest()[:10], 'big')
42 value = (milliseconds << 80) | entropy
43 return ''.join(ALPHABET[(value >> (5 * i)) & 31] for i in range(25, -1, -1))
44
45
46def digest(path):
47 return hashlib.sha256(path.read_bytes()).hexdigest()
48
49
50def stopped(job):
51 token = os.environ.get('NOMAD_TOKEN') or Path('/var/lib/studio/nomad.token').read_text().strip()
52 def read(path):
53 request = urllib.request.Request('http://127.0.0.1:4646/v1/' + path,
54 headers={'X-Nomad-Token': token})
55 with urllib.request.urlopen(request, timeout=10) as response:
56 return json.load(response)
57 if not read('job/' + job).get('Stop') or any(
58 item['ClientStatus'] in ('pending', 'running') for item in read('job/' + job + '/allocations')):
59 raise ValueError('Stop the target Shale job and wait for its allocations before importing')
60
61
62def migrate(database, source, attachments, target, evidence, before_commit=lambda: None):
63 db = sqlite3.connect(database)
64 db.row_factory = sqlite3.Row
65 db.execute('PRAGMA foreign_keys=ON')
66 if db.execute('PRAGMA integrity_check').fetchone()[0] != 'ok':
67 raise ValueError('Shale SQLite integrity check failed')
68 source_hash = digest(source)
69 data = json.loads(source.read_text())
70 for field in ['repositories', 'issues', 'comments', 'labels', 'issue_labels', 'authors',
71 'attachments', 'assignees', 'milestones', 'pull_requests', 'history']:
72 if not isinstance(data.get(field), list):
73 raise ValueError(f'Missing source table: {field}')
74 owners = db.execute("SELECT * FROM users WHERE name='clover'").fetchall()
75 if len(owners) != 1 or owners[0]['snowflake'] != '8c909fab-98b0-4472-9171-9606ccebe9d5':
76 raise ValueError('Clover original identity is missing')
77 owner = owners[0]['id']
78 repos = {r['name']: dict(r) for r in db.execute('SELECT * FROM repositories')}
79 sources = {r['id']: r for r in data['repositories']}
80 issue_sources = {r['id']: r for r in data['issues']}
81 if len(issue_sources) != len(data['issues']):
82 raise ValueError('Duplicate source issue IDs')
83 for r in data['repositories']:
84 if r['name'] not in repos or repos[r['name']]['owner'] != owner:
85 raise ValueError(f'Expected imported Clover repository: {r["name"]}')
86 if any(c['issue_id'] not in issue_sources for c in data['comments']):
87 raise ValueError('Orphan source comment')
88 with sqlite3.connect(evidence / 'before.db') as backup:
89 db.backup(backup)
90 originals = {table: [dict(r) for r in db.execute(f'SELECT * FROM {table}')]
91 for table in ['issues', 'issue_actions', 'issue_labels', 'issues__labels', 'users']}
92 db.execute('BEGIN IMMEDIATE')
93 db.execute('CREATE TABLE IF NOT EXISTS studio_forgejo_records('
94 'kind TEXT NOT NULL, source_id TEXT NOT NULL, target_id INTEGER, '
95 'source_json TEXT NOT NULL, PRIMARY KEY(kind,source_id))')
96 previous = db.execute("SELECT source_json FROM studio_forgejo_records WHERE kind='export' AND source_id='personal'").fetchone()
97 if previous and json.loads(previous[0])['sha256'] != source_hash:
98 raise ValueError('A different export was already imported; review the source before merging')
99
100 def saved(kind, key):
101 row = db.execute('SELECT target_id FROM studio_forgejo_records WHERE kind=? AND source_id=?', (kind, str(key))).fetchone()
102 return row[0] if row else None
103
104 def record(kind, key, target_id, row):
105 db.execute('INSERT OR IGNORE INTO studio_forgejo_records VALUES(?,?,?,?)',
106 (kind, str(key), target_id, json.dumps(row, ensure_ascii=False, sort_keys=True)))
107
108 users = {1: owner}
109 names = {r['name'] for r in db.execute('SELECT name FROM users')}
110 actors = {int(r.get('poster_id') or 0) for r in [*data['issues'], *data['comments'], *data['history']]}
111 actors.update(int(r['assignee_id']) for r in data['assignees'])
112 author_source = {r['id']: r for r in data['authors']}
113 for key in sorted(actors - {1}):
114 row = author_source.get(key, {'id': key, 'name': 'forgejo-system' if key == 0 else f'forgejo-user-{key}',
115 'created_unix': min(i['created_unix'] for i in data['issues']),
116 'updated_unix': max(i['updated_unix'] for i in data['issues'])})
117 existing = saved('user', key)
118 if existing is None:
119 name = row['name']
120 if name in names:
121 name = 'forgejo-' + name
122 if name in names:
123 raise ValueError('Historical author name collision')
124 cursor = db.execute('INSERT INTO users(uuid,provider,snowflake,name,joined_on,last_updated) VALUES(?,?,?,?,?,?)',
125 (identifier('user', key, row['created_unix']), 'personal-forgejo.invalid',
126 str(key), name, timestamp(row['created_unix']), timestamp(row['updated_unix'])))
127 existing = cursor.lastrowid
128 names.add(name)
129 record('user', key, existing, row)
130 users[key] = existing
131 record('user', 1, owner, author_source[1])
132
133 external = {'paperclover': owner}
134 external_rows = defaultdict(list)
135 for row in [*data['issues'], *data['comments']]:
136 if row.get('original_author'):
137 external_rows[row['original_author']].append(row)
138 for name, rows in external_rows.items():
139 if name == 'paperclover':
140 continue
141 if not re.fullmatch(r'[A-Za-z0-9_.-]+', name):
142 raise ValueError('Unsupported external author name')
143 key = 'external:' + name
144 existing = saved('user', key)
145 if existing is None:
146 display = name if name not in names else 'github-' + name
147 if display in names:
148 raise ValueError('External author name collision')
149 created = min(row['created_unix'] for row in rows)
150 updated = max(row['updated_unix'] or row['created_unix'] for row in rows)
151 existing = db.execute('INSERT INTO users(uuid,provider,snowflake,name,joined_on,last_updated) VALUES(?,?,?,?,?,?)',
152 (identifier('user', key, created), 'personal-forgejo-external.invalid', name,
153 display, timestamp(created), timestamp(updated))).lastrowid
154 names.add(display)
155 record('user', key, existing, {'original_author': name})
156 external[name] = existing
157
158 def actor(row):
159 return external[row['original_author']] if row.get('original_author') else users[row['poster_id']]
160
161 labels = {}
162 for row in sorted(data['labels'], key=lambda r: r['id']):
163 if row['repo_id'] not in sources:
164 raise ValueError('Label has no source repository')
165 repo = repos[sources[row['repo_id']]['name']]
166 existing = saved('label', row['id'])
167 if existing is None:
168 color = row['color'].lstrip('#')
169 if not re.fullmatch('[0-9a-fA-F]{6}', color):
170 raise ValueError('Invalid source label color')
171 epoch = row['created_unix'] or sources[row['repo_id']]['created_unix']
172 existing = db.execute('INSERT INTO issue_labels(uuid,repo,name,description,color,last_updated) VALUES(?,?,?,?,?,?)',
173 (identifier('label', row['id'], epoch), repo['id'], row['name'], row['description'],
174 '#' + color, timestamp(row['updated_unix'] or epoch))).lastrowid
175 record('label', row['id'], existing, row)
176 labels[row['id']] = existing
177
178 # Preserve incoming numbers when free; collisions go above BOTH namespaces.
179 occupied = defaultdict(set)
180 ceilings = defaultdict(int)
181 for row in db.execute('SELECT repo,number FROM issues'):
182 occupied[row['repo']].add(row['number'])
183 ceilings[row['repo']] = max(ceilings[row['repo']], row['number'])
184 for row in data['issues']:
185 repo = repos[sources[row['repo_id']]['name']]['id']
186 ceilings[repo] = max(ceilings[repo], row['index'])
187 issue_map = {}
188 collisions = []
189 assignees = defaultdict(list)
190 for row in data['assignees']:
191 assignees[row['issue_id']].append(users[row['assignee_id']])
192 planned = []
193 for row in sorted(data['issues'], key=lambda r: (r['repo_id'], r['index'])):
194 repo = repos[sources[row['repo_id']]['name']]
195 existing = saved('issue', row['id'])
196 number = row['index']
197 if existing is None:
198 if number in occupied[repo['id']]:
199 ceilings[repo['id']] += 1
200 number = ceilings[repo['id']]
201 occupied[repo['id']].add(number)
202 else:
203 number = db.execute('SELECT number FROM issues WHERE id=?', (existing,)).fetchone()[0]
204 planned.append((repo, number, existing, row))
205 # Shale allocates the next number from the issue with the highest row ID.
206 for repo, number, existing, row in sorted(planned, key=lambda item: (item[0]['id'], item[1])):
207 if existing is None:
208 existing = db.execute('INSERT INTO issues(uuid,repo,number,author,last_updated,title,status,assignee) VALUES(?,?,?,?,?,?,?,?)',
209 (identifier('issue', row['id'], row['created_unix']), repo['id'], number,
210 actor(row), timestamp(row['updated_unix']), row['name'],
211 'done' if row['is_closed'] else 'todo',
212 assignees[row['id']][0] if len(assignees[row['id']]) == 1 else None)).lastrowid
213 record('issue', row['id'], existing, row)
214 if number != row['index']:
215 collisions.append({'repo': repo['name'], 'forgejo': row['index'], 'shale': number})
216 issue_map[row['id']] = {'id': existing, 'number': number, 'repo': repo['name'],
217 'url': '/' + quote(repo['name'], safe='/') + '/issues/' + str(number)}
218
219 # Preserve attachment authorization by checking the associated Shale issue
220 # before Caddy serves the copied file. No unauthenticated static directory.
221 attachment_map = {}
222 manifest = []
223 for row in data['attachments']:
224 if row['issue_id'] not in issue_map:
225 raise ValueError('An attachment belongs to an unsupported release or missing issue')
226 if row['external_url']:
227 attachment_map[row['uuid']] = row['external_url']
228 record('attachment', row['id'], None, row)
229 continue
230 key = row['uuid']
231 if not re.fullmatch('[0-9a-f-]{36}', key):
232 raise ValueError('Unsafe attachment UUID')
233 source_file = attachments / key[0] / key[1] / key
234 if source_file.is_symlink() or not source_file.is_file() or source_file.stat().st_size != row['size']:
235 raise ValueError('Source attachment missing or size differs')
236 name = Path(row['name']).name
237 if name != row['name'] or not name or any(c in name for c in '\\"\r\n'):
238 raise ValueError('Unsafe attachment filename')
239 destination = target / 'forgejo-attachments' / key / name
240 destination.parent.mkdir(parents=True, exist_ok=True)
241 if destination.exists() and digest(destination) != digest(source_file):
242 raise ValueError('Attachment copy differs')
243 if not destination.exists():
244 shutil.copyfile(source_file, destination)
245 checksum = digest(source_file)
246 if digest(destination) != checksum:
247 raise ValueError('Attachment checksum failed')
248 # Caddy serves these only after Shale authorizes the associated issue.
249 # Keep them unavailable to other local users.
250 caddy_group = grp.getgrnam('caddy').gr_gid
251 for directory in [target / 'forgejo-attachments', destination.parent]:
252 os.chown(directory, 0, caddy_group)
253 directory.chmod(0o750)
254 os.chown(destination, 0, caddy_group)
255 destination.chmod(0o640)
256 path = '/-/forgejo-attachments/' + key + '/' + quote(name, safe='')
257 attachment_map[key] = path
258 manifest.append({'path': path, 'file': key + '/' + name,
259 'issue': issue_map[row['issue_id']]['url'], 'sha256': checksum})
260 record('attachment', row['id'], None, row)
261
262 source_urls = {}
263 for row in data['issues']:
264 repo = sources[row['repo_id']]
265 owner_name = repo['owner_name']
266 for kind in ['issues', 'pulls']:
267 source_urls[f'/{owner_name}/{repo["name"]}/{kind}/{row["index"]}'] = issue_map[row['id']]['url']
268
269 def rewrite(text, repo_id):
270 def attachment(match):
271 key = match.group(1)
272 if key not in attachment_map:
273 raise ValueError('Issue references an attachment absent from the source export')
274 return attachment_map[key]
275 text = re.sub(r'(?:https?://(?:git|forgejo)\.paperclover\.net)?/attachments/([0-9a-f-]{36})', attachment, text)
276 def link(match):
277 return source_urls.get(match.group(1), match.group(0))
278 text = re.sub(r'https?://(?:git|forgejo)\.paperclover\.net(/[^\s)<>]+/(?:issues|pulls)/[0-9]+)', link, text)
279 text = re.sub(r'(?<=\]\()(/[^\s)<>]+/(?:issues|pulls)/[0-9]+)(?=\))', link, text)
280 # Leave code, quoted text, and bare #references untouched; map explicit links only.
281 return text
282
283 def action(kind, key, issue_id, actor, payload, added, updated=None, source_row=None):
284 existing = saved(kind, key)
285 if existing is not None:
286 return existing
287 created = db.execute('INSERT INTO issue_actions(uuid,issue,actor,kind,payload,added_on,last_updated) VALUES(?,?,?,?,?,?,?)',
288 (identifier(kind, key, added), issue_id, actor, kind if kind in ['comment', 'update_status', 'add_label', 'remove_label'] else 'comment',
289 payload, timestamp(added), timestamp(updated or added))).lastrowid
290 record(kind, key, created, source_row or {})
291 return created
292
293 milestone_source = {r['id']: r for r in data['milestones']}
294 pulls = {r['issue_id']: r for r in data['pull_requests']}
295 body_edits = defaultdict(int)
296 for revision in data['history']:
297 if not revision['comment_id'] and not revision['is_first_created']:
298 body_edits[revision['issue_id']] = max(body_edits[revision['issue_id']], revision['edited_unix'])
299 for row in data['issues']:
300 item = issue_map[row['id']]
301 body = rewrite(row['content'], row['repo_id'])
302 metadata = []
303 if item['number'] != row['index']:
304 metadata.append(f'Original Forgejo issue #{row["index"]}.')
305 if row['is_pull']:
306 pr = pulls[row['id']]
307 metadata.append(f'Imported pull request: `{pr["head_branch"]}` → `{pr["base_branch"]}`.' +
308 (f' Merged as `{pr["merged_commit_id"]}`.' if pr['has_merged'] else ''))
309 if row['milestone_id']:
310 metadata.append('Milestone: ' + milestone_source[row['milestone_id']]['name'] + '.')
311 if row['is_locked']:
312 metadata.append('The original discussion was locked.')
313 if len(assignees[row['id']]) > 1:
314 original_assignees = [author_source[a['assignee_id']]['name'] for a in data['assignees'] if a['issue_id'] == row['id']]
315 metadata.append('Original assignees: ' + ', '.join(original_assignees) + '.')
316 if metadata:
317 body += '\n\n---\n\n' + '\n\n'.join(metadata)
318 action('issue-body', row['id'], item['id'], actor(row), body,
319 row['created_unix'], max(row['created_unix'], body_edits[row['id']]), row)
320 # Shale's status-change renderer requires an initial status action.
321 # Forgejo stores initial state on the issue, rather than as a comment.
322 action('update_status', 'initial-' + str(row['id']), item['id'], actor(row),
323 'todo', row['created_unix'])
324
325 for row in sorted(data['comments'], key=lambda r: (r['created_unix'], r['id'])):
326 item = issue_map[row['issue_id']]
327 kind = 'comment'
328 payload = rewrite(row['content'], issue_sources[row['issue_id']]['repo_id'])
329 if row['type'] in [1, 2]:
330 kind, payload = 'update_status', 'todo' if row['type'] == 1 else 'done'
331 elif row['type'] == 7 and row['label_id'] in labels:
332 kind = 'add_label' if row['content'] == '1' else 'remove_label'
333 payload = str(labels[row['label_id']])
334 elif row['type'] != 0:
335 event = EVENTS[row['type']] if row['type'] < len(EVENTS) else f'event {row["type"]}'
336 detail = []
337 for field in ['old_title', 'new_title', 'old_ref', 'new_ref', 'commit_sha', 'commit_id', 'tree_path', 'line']:
338 if row.get(field):
339 detail.append(f'{field}: {row[field]}')
340 for field in ['old_milestone_id', 'milestone_id']:
341 if row.get(field):
342 detail.append(field + ': ' + milestone_source.get(row[field], {}).get('name', str(row[field])))
343 if row.get('dependent_issue_id'):
344 linked = issue_map.get(row['dependent_issue_id'])
345 detail.append('Dependency: ' + (f'[{linked["repo"]}#{linked["number"]}]({linked["url"]})' if linked else str(row['dependent_issue_id'])))
346 if row.get('ref_issue_id') and row['ref_issue_id'] in issue_map:
347 linked = issue_map[row['ref_issue_id']]
348 detail.append(f'[{linked["repo"]}#{linked["number"]}]({linked["url"]})')
349 payload = 'Forgejo: ' + event + '.' + ('\n\n' + '\n\n'.join(detail) if detail else '') + ('\n\n' + payload if payload else '')
350 existing = saved('forgejo-comment', row['id'])
351 if existing is None:
352 # Every original comment/event maps to exactly one Shale action.
353 action_id = action(kind, 'forgejo-' + str(row['id']), item['id'], actor(row), payload,
354 row['created_unix'], row['updated_unix'], row)
355 record('forgejo-comment', row['id'], action_id, row)
356
357 for row in data['issue_labels']:
358 item = issue_map[row['issue_id']]
359 existing = saved('issue-label', row['id'])
360 if existing is None:
361 label = labels[row['label_id']]
362 epoch = issue_sources[row['issue_id']]['updated_unix']
363 existing = db.execute('INSERT INTO issues__labels(uuid,issue,label) VALUES(?,?,?)',
364 (identifier('issue-label', row['id'], epoch), item['id'], label)).lastrowid
365 record('issue-label', row['id'], existing, row)
366
367 for table in ['history', 'milestones', 'pull_requests', 'assignees']:
368 for row in data[table]:
369 record(table, row['id'], None, row)
370 for source_repo in data['repositories']:
371 repo = repos[source_repo['name']]
372 if any(i['repo_id'] == source_repo['id'] for i in data['issues']):
373 db.execute("UPDATE repositories SET access_issues=? WHERE id=? AND access_issues='off'",
374 ('private' if source_repo['is_private'] else 'public', repo['id']))
375 for field in ['access_issues_submit', 'access_issues_comment']:
376 db.execute(f"UPDATE repositories SET {field}='private' WHERE id=? AND {field}='off'", (repo['id'],))
377 slots = ','.join('?' for _ in CLOSED)
378 db.execute(f'UPDATE repositories SET open_issues=(SELECT count(*) FROM issues WHERE repo=repositories.id AND status NOT IN ({slots}))', CLOSED)
379 db.execute(f'UPDATE issue_labels SET open_issues=(SELECT count(*) FROM issues__labels il JOIN issues i ON i.id=il.issue WHERE il.label=issue_labels.id AND i.status NOT IN ({slots}))', CLOSED)
380 for table, rows in originals.items():
381 for row in rows:
382 current = dict(db.execute(f'SELECT * FROM {table} WHERE id=?', (row['id'],)).fetchone())
383 if table == 'issue_labels':
384 current.pop('open_issues');row = {k:v for k,v in row.items() if k != 'open_issues'}
385 if current != row:
386 raise ValueError(f'Existing Shale {table} row changed')
387 if db.execute('PRAGMA foreign_key_check').fetchall():
388 raise ValueError('Imported data has invalid foreign keys')
389 if db.execute('SELECT 1 FROM issues i WHERE i.id=(SELECT max(id) FROM issues WHERE repo=i.repo) '
390 'AND i.number<>(SELECT max(number) FROM issues WHERE repo=i.repo)').fetchone():
391 raise ValueError('Issue row order would reuse a number; repair it before importing')
392 for kind, rows in [('issue', data['issues']), ('forgejo-comment', data['comments']), ('label', data['labels']),
393 ('issue-label', data['issue_labels']), ('attachment', data['attachments']), ('history', data['history'])]:
394 count = db.execute('SELECT count(*) FROM studio_forgejo_records WHERE kind=?', (kind,)).fetchone()[0]
395 if count != len(rows):
396 raise ValueError(f'Incomplete import: {kind}')
397 record('export', 'personal', None, {'sha256': source_hash})
398 before_commit()
399 db.commit()
400 db.close()
401 report = {'source_sha256': source_hash, 'issues': len(data['issues']), 'comments_and_events': len(data['comments']),
402 'labels': len(labels), 'attachments': len(manifest), 'history_revisions': len(data['history']),
403 'number_collisions': collisions, 'issue_mapping': issue_map}
404 (evidence / 'report.json').write_text(json.dumps(report, indent=2) + '\n')
405 (target / 'forgejo-attachments.json').write_text(json.dumps(manifest, indent=2) + '\n')
406 print(json.dumps({k:v for k,v in report.items() if k != 'issue_mapping'}, indent=2))
407
408
409def repair_issue_order(database, evidence, before_commit):
410 with sqlite3.connect(database) as db:
411 db.row_factory = sqlite3.Row
412 db.execute('PRAGMA foreign_keys=ON')
413 with sqlite3.connect(evidence / 'before.db') as backup:
414 db.backup(backup)
415 db.execute('BEGIN IMMEDIATE')
416 db.execute('PRAGMA defer_foreign_keys=ON')
417 if db.execute('PRAGMA integrity_check').fetchone()[0] != 'ok' or db.execute('PRAGMA foreign_key_check').fetchall():
418 raise ValueError('Shale database integrity failed')
419 if db.execute('SELECT 1 FROM issues GROUP BY repo,number HAVING count(*)>1').fetchone():
420 raise ValueError('Duplicate issue numbers require separate review')
421 tables = [r[0] for r in db.execute("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'")]
422 if any(not re.fullmatch('[a-z_]+', table) for table in tables):
423 raise ValueError('Unexpected table name')
424 references = {table: [r['from'] for r in db.execute(f'PRAGMA foreign_key_list({table})') if r['table'] == 'issues'] for table in tables}
425 for table in tables:
426 for column in db.execute(f'PRAGMA table_info({table})'):
427 if re.fullmatch('(.*_)?issue(_id)?', column['name']) and column['name'] not in references[table]:
428 raise ValueError('Undeclared issue reference requires review')
429 imported = {r[0] for r in db.execute("SELECT target_id FROM studio_forgejo_records WHERE kind='issue'")}
430 swaps = {}
431 for repo in db.execute('SELECT DISTINCT repo FROM issues'):
432 newest = db.execute('SELECT id,number FROM issues WHERE repo=? ORDER BY id DESC LIMIT 1', repo).fetchone()
433 highest = db.execute('SELECT id,number FROM issues WHERE repo=? ORDER BY number DESC LIMIT 1', repo).fetchone()
434 if newest['number'] != highest['number']:
435 if newest['id'] not in imported or highest['id'] not in imported:
436 raise ValueError('Repair would change a native issue ID')
437 swaps[newest['id']], swaps[highest['id']] = highest['id'], newest['id']
438
439 def contents():
440 identities = dict(db.execute('SELECT id,uuid FROM issues'))
441 result = {}
442 for table in tables:
443 rows = []
444 for record in db.execute(f'SELECT * FROM {table}'):
445 row = dict(record)
446 if table == 'issues':
447 row['id'] = identities[row['id']] if row['id'] in imported else row['id']
448 for column in references[table]:
449 row[column] = identities[row[column]]
450 if table == 'studio_forgejo_records' and row['kind'] == 'issue':
451 row['target_id'] = identities[row['target_id']]
452 rows.append(tuple(row.items()))
453 result[table] = Counter(rows)
454 return result
455
456 before = contents()
457 for old, new in [*((old, -old) for old in swaps), *((-old, new) for old, new in swaps.items())]:
458 db.execute('UPDATE issues SET id=? WHERE id=?', (new, old))
459 for table, columns in references.items():
460 for column in columns:
461 db.execute(f'UPDATE {table} SET {column}=? WHERE {column}=?', (new, old))
462 db.execute("UPDATE studio_forgejo_records SET target_id=? WHERE kind='issue' AND target_id=?", (new, old))
463 if before != contents() or db.execute('PRAGMA foreign_key_check').fetchall():
464 raise ValueError('Repair changed issue content or references')
465 before_commit()
466 db.commit()
467 report = {'surrogate_id_swaps': swaps, 'all_table_contents_preserved': True}
468 (evidence / 'report.json').write_text(json.dumps(report, indent=2) + '\n')
469 print(json.dumps(report))
470
471
472def main():
473 parser = argparse.ArgumentParser()
474 parser.add_argument('--target', type=Path, required=True)
475 parser.add_argument('--source', type=Path, required=True)
476 parser.add_argument('--proof', type=Path, help='Verified export proof; defaults to source-proof.json beside the source')
477 parser.add_argument('--attachments', type=Path, default=Path('/mnt/storage1/apps/forgejo/work/attachments'))
478 parser.add_argument('--rehearsal', action='store_true')
479 parser.add_argument('--repair-issue-order', action='store_true')
480 args = parser.parse_args()
481 if os.geteuid() != 0:
482 parser.error('Run as root on Zenith')
483 os.umask(0o077)
484 target = args.target.resolve()
485 if 'evil' in str(target).lower() or target.is_relative_to('/mnt/storage1/apps'):
486 parser.error('Use a managed Shale target or isolated copy')
487 if args.rehearsal:
488 if target.is_relative_to('/srv/prod'):
489 parser.error('Rehearsal must use an isolated target')
490 elif target != Path('/srv/prod/shale'):
491 parser.error('Production imports must target /srv/prod/shale')
492 guard = lambda: None
493 if target == Path('/srv/prod/shale'):
494 guard = lambda: stopped('shale')
495 elif target.parent == Path('/srv/staging'):
496 if not re.fullmatch(r'shale-preview-[0-9a-f]{8}', target.name):
497 parser.error('Expected a managed Shale stage')
498 guard = lambda: stopped(target.name)
499 proof = args.proof or args.source.parent / 'source-proof.json'
500 if not proof.is_file() or json.loads(proof.read_text()).get('sourceSha256') != digest(args.source):
501 parser.error('Verified export proof is missing or the source checksum differs')
502 guard()
503 evidence = Path(tempfile.mkdtemp(prefix='issue-import-', dir=str(args.source.parent)))
504 if args.repair_issue_order:
505 repair_issue_order(target / 'data/astheno.shale.db', evidence, guard)
506 else:
507 migrate(target / 'data/astheno.shale.db', args.source, args.attachments, target, evidence, guard)
508 print('Evidence:', evidence)
509
510
511if __name__ == '__main__':
512 main()
tools/import-forgejo-to-shale.py deleted-240
......@@ -1,240 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3from datetime import datetime, timezone
4import hashlib
5import json
6import os
7from pathlib import Path
8import re
9import secrets
10import shutil
11import sqlite3
12import tempfile
13import urllib.error
14import urllib.request
15
16
17SOURCE = Path('/mnt/storage1/apps/forgejo/git/repositories')
18ACCESS = ('access_git_webui', 'access_git_proto', 'access_git_proto_push', 'access_issues',
19 'access_issues_submit', 'access_issues_comment', 'access_readme')
20
21
22def sha256(path):
23 digest = hashlib.sha256()
24 with path.open('rb') as source:
25 for block in iter(lambda: source.read(1024 * 1024), b''):
26 digest.update(block)
27 return digest.hexdigest()
28
29
30def refs(repository):
31 result = {}
32 packed = repository / 'packed-refs'
33 if packed.exists():
34 for line in packed.read_text().splitlines():
35 if line and line[0] not in '#^':
36 value, name = line.split(' ')
37 result[name] = value
38 for path in (repository / 'refs').rglob('*'):
39 if path.is_symlink():
40 raise ValueError('Repository refs contain a link. Resolve it before importing')
41 if path.is_file():
42 result[str(path.relative_to(repository))] = path.read_text().strip()
43 for name, value in result.items():
44 if not name.startswith('refs/') or any(part in ('', '.', '..') for part in name.split('/')):
45 raise ValueError('Repository has an unsafe ref name. Review its retained refs')
46 if not re.fullmatch('[0-9a-f]{40}', value):
47 raise ValueError('Repository has a symbolic or unsupported ref. Resolve it before importing')
48 return result
49
50
51def stopped():
52 token = os.environ.get('NOMAD_TOKEN') or Path('/var/lib/studio/nomad.token').read_text().strip()
53 def read(path):
54 request = urllib.request.Request('http://127.0.0.1:4646/v1/' + path,
55 headers={'X-Nomad-Token': token})
56 with urllib.request.urlopen(request, timeout=10) as response:
57 return json.load(response)
58 try:
59 job = read('job/shale')
60 except urllib.error.HTTPError as error:
61 if error.code == 404:
62 return
63 raise
64 if not job.get('Stop') or any(item['ClientStatus'] in ('pending', 'running')
65 for item in read('job/shale/allocations')):
66 raise ValueError('Stop Shale and wait for its allocations before importing')
67
68
69def main():
70 parser = argparse.ArgumentParser(description='Import retained personal Forgejo histories into stopped Shale.')
71 parser.add_argument('--target', type=Path, required=True, help='Copied Shale service root')
72 parser.add_argument('--metadata', type=Path, required=True, help='Personal Forgejo repository metadata JSON')
73 args = parser.parse_args()
74 if os.geteuid() != 0:
75 parser.error('Run as root on Zenith')
76 os.umask(0o077)
77 target = args.target.resolve()
78 retained = Path('/mnt/storage1/apps')
79 if target.is_relative_to(retained) or retained.is_relative_to(target):
80 raise ValueError('Target overlaps retained app data. Use the managed Shale copy')
81 database = target / 'data/astheno.shale.db'
82 if not database.is_file():
83 raise ValueError('Shale database is missing. Import its retained state first')
84 metadata = json.loads(args.metadata.read_text())
85 required = {'owner_name', 'lower_name', 'name', 'is_private', 'default_branch', 'is_empty', 'is_mirror'}
86 if not isinstance(metadata, list) or any(not isinstance(row, dict) or not required.issubset(row) for row in metadata):
87 raise ValueError('Forgejo metadata is incomplete. Export the documented personal repository fields')
88 if any(not re.fullmatch(r'[A-Za-z0-9_.-]+', row[field]) or row[field] in ('.', '..')
89 for row in metadata for field in ('owner_name', 'lower_name', 'name')):
90 raise ValueError('Repository metadata has unsafe names. Review the personal Forgejo export')
91 indexed = {(row['owner_name'], row['lower_name']): row for row in metadata}
92 if len(indexed) != len(metadata) or any(type(row[field]) is not bool for row in metadata
93 for field in ('is_private', 'is_empty', 'is_mirror')):
94 raise ValueError('Forgejo metadata has duplicate repositories or missing visibility')
95 sources = sorted(SOURCE.glob('*/*.git'))
96 if not sources:
97 raise ValueError('No retained personal Forgejo repositories were found')
98 if any(path.is_file() for path in (SOURCE.parent / 'lfs').rglob('*')):
99 raise ValueError('Forgejo has LFS data. Preserve its serving path before migrating repositories')
100 for source in sources:
101 if source.is_symlink() or (source.parent.name, source.name[:-4]) not in indexed:
102 raise ValueError('A retained repository has no verified metadata. Export its personal Forgejo database entry')
103 if any((source / folder).is_symlink() for folder in ('objects', 'refs')):
104 raise ValueError('Repository storage contains a link. Preserve its contents before importing')
105 if (source / 'shallow').exists() or (source / 'objects/info/alternates').exists():
106 raise ValueError('Repository history depends on external objects. Preserve them before importing')
107 if any((source / 'objects/pack').glob('*.promisor')):
108 raise ValueError('Repository has promised objects. Retrieve the complete history before importing')
109 expected_paths = {(row['owner_name'], row['lower_name']) for row in metadata if not row['is_empty']}
110 if not expected_paths.issubset({(source.parent.name, source.name[:-4]) for source in sources}):
111 raise ValueError('A nonempty Forgejo repository is missing from retained storage')
112 stopped()
113 evidence = Path(tempfile.mkdtemp(prefix='shale-forgejo-import-', dir='/var/lib/studio'))
114 db = sqlite3.connect(database)
115 db.row_factory = sqlite3.Row
116 if db.execute('PRAGMA integrity_check').fetchone()[0] != 'ok':
117 raise ValueError('Shale database failed integrity checking. Recover the retained copy')
118 owners = db.execute("SELECT id FROM users WHERE name='snow'").fetchall()
119 if len(owners) != 1:
120 raise ValueError('Shale needs one existing snow account. Preserve its original identity before importing')
121 owner = owners[0]['id']
122 stat = database.stat()
123 with sqlite3.connect(evidence / 'before.db') as backup:
124 db.backup(backup)
125 existing = {row['name'].casefold(): dict(row) for row in db.execute(
126 'SELECT id,uuid,owner,name,' + ','.join(ACCESS) + ' FROM repositories')}
127 records = []
128 now = datetime.now(timezone.utc).isoformat(timespec='seconds')
129 try:
130 for key, row in indexed.items():
131 name = row['name'] if key[0] == 'clo' else key[0] + '/' + row['name']
132 entry = existing.get(name.casefold())
133 if entry and entry['owner'] != owner:
134 raise ValueError('Repository belongs to another Shale account. Review its ownership before merging')
135 if entry and row['is_private']:
136 for field in ACCESS:
137 db.execute(f"UPDATE repositories SET {field}='private' WHERE id=? AND {field} IN ('public','unlisted')", (entry['id'],))
138 db.commit()
139 db.execute('BEGIN IMMEDIATE')
140 for key, row in sorted(indexed.items()):
141 source = SOURCE / key[0] / (key[1] + '.git')
142 name = row['name'] if key[0] == 'clo' else key[0] + '/' + row['name']
143 entry = existing.get(name.casefold())
144 if entry:
145 directory = target / 'repositories_owned' / entry['uuid']
146 if not directory.is_dir():
147 raise ValueError('An existing Shale repository directory is missing. Recover it before merging')
148 else:
149 alphabet = '0123456789ABCDEFGHJKMNPQRSTVWXYZ'
150 number = secrets.randbits(128)
151 repo_id = ''.join(alphabet[(number >> (5 * position)) & 31] for position in range(25, -1, -1))
152 directory = target / 'repositories_owned' / repo_id
153 directory.mkdir(mode=0o700)
154 os.chown(directory, stat.st_uid, stat.st_gid)
155 for folder in ('objects', 'refs'):
156 (directory / folder).mkdir(mode=0o700)
157 os.chown(directory / folder, stat.st_uid, stat.st_gid)
158 (directory / 'config').write_text('[core]\nrepositoryformatversion = 0\nbare = true\n[http]\nreceivepack = true\n')
159 access = 'private' if row['is_private'] else 'public'
160 cursor = db.execute(
161 'INSERT INTO repositories(uuid,owner,created_on,name,description,' + ','.join(ACCESS) + ',last_updated) '
162 'VALUES(?,?,?,?,?,?,?,?,?,?,?,?,?)',
163 (repo_id, owner, now, name, '', access, access, 'private', 'off', 'off', 'off', access, now))
164 entry = {'id': cursor.lastrowid, 'uuid': repo_id, 'name': name}
165 existing[name.casefold()] = entry
166 previous = refs(directory)
167 original = refs(source) if source.exists() else {}
168 objects = {}
169 for path in sorted((source / 'objects').rglob('*')) if source.exists() else ():
170 if path.is_symlink():
171 raise ValueError('Repository objects contain a link. Preserve its contents before importing')
172 relative = path.relative_to(source / 'objects')
173 if not path.is_file() or relative.parts[0] == 'info':
174 continue
175 checksum = sha256(path)
176 destination = directory / 'objects' / relative
177 destination.parent.mkdir(mode=0o700, parents=True, exist_ok=True)
178 if destination.exists():
179 if sha256(destination) != checksum:
180 raise ValueError('Object files differ under the same name. Keep Shale stopped and review the copies')
181 else:
182 shutil.copyfile(path, destination)
183 os.chmod(destination, 0o600)
184 os.chown(destination, stat.st_uid, stat.st_gid)
185 if sha256(destination) != checksum:
186 raise RuntimeError('Copied objects failed verification. Keep Shale stopped')
187 objects[str(relative)] = checksum
188 mapped = {}
189 combined = dict(previous)
190 for reference, value in original.items():
191 destination = reference
192 if destination in combined and combined[destination] != value:
193 category = 'heads' if reference.startswith('refs/heads/') else 'tags' if reference.startswith('refs/tags/') else None
194 destination = ('refs/' + category + '/forgejo/' + key[0] + '/' + reference.split('/', 2)[2]
195 if category else 'refs/forgejo/' + key[0] + '/' + reference[5:])
196 if destination in combined and combined[destination] != value:
197 destination += '-'+value
198 path = directory / destination
199 path.parent.mkdir(mode=0o700, parents=True, exist_ok=True)
200 path.write_text(value + '\n')
201 os.chown(path, stat.st_uid, stat.st_gid)
202 combined[destination] = value
203 mapped[reference] = destination
204 if not (directory / 'HEAD').exists():
205 desired = 'refs/heads/' + row['default_branch']
206 if original and desired not in original:
207 desired = next((reference for reference in sorted(original) if reference.startswith('refs/heads/')), desired)
208 (directory / 'HEAD').write_text('ref: ' + desired + '\n')
209 os.chown(directory / 'HEAD', stat.st_uid, stat.st_gid)
210 os.chown(directory / 'config', stat.st_uid, stat.st_gid)
211 final = refs(directory)
212 if any(final.get(reference) != value for reference, value in previous.items()) or any(
213 final.get(mapped[reference]) != value for reference, value in original.items()
214 ):
215 raise RuntimeError('Ref verification failed. Keep Shale stopped and review the retained refs')
216 if source.exists() and refs(source) != original:
217 raise RuntimeError('Source refs changed during import. Keep Shale stopped')
218 for parent in (directory / 'objects', directory / 'refs'):
219 for path in parent.rglob('*'):
220 if path.is_dir():
221 os.chown(path, stat.st_uid, stat.st_gid)
222 records.append({'source': '/'.join(key), 'target': entry['name'], 'uuid': entry['uuid'],
223 'private': row['is_private'], 'sourceMirror': row['is_mirror'], 'objects': objects,
224 'originalRefs': original, 'refMapping': mapped, 'previousRefs': previous,
225 'head': (directory / 'HEAD').read_text().strip()})
226 stopped()
227 if db.execute('PRAGMA foreign_key_check').fetchall():
228 raise RuntimeError('Shale database references are invalid. Keep it stopped')
229 db.commit()
230 finally:
231 db.close()
232 (evidence / 'repositories.json').write_text(json.dumps(records, indent=2) + '\n')
233 print(f'Imported and verified {len(records)} personal repositories. Evidence and previous database: {evidence}')
234
235
236if __name__ == '__main__':
237 try:
238 main()
239 except (ValueError, RuntimeError, OSError, sqlite3.Error, urllib.error.HTTPError) as error:
240 raise SystemExit(str(error)) from None
tools/import-hedgedoc.sh deleted-123
......@@ -1,123 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4instance=${1:?usage: tools/import-hedgedoc.sh evil-hedgedoc[-preview-XXXXXXXX]}
5[[ $instance == evil-hedgedoc || $instance =~ ^evil-hedgedoc-preview-[0-9a-f]{8}$ ]] || { echo 'Expected a HedgeDoc service or preview ID' >&2; exit 1; }
6if [[ $instance == evil-hedgedoc ]]; then
7 root=/srv/prod/evil-hedgedoc
8else
9 root="/srv/staging/$instance"
10fi
11
12source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
13target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
14target_port=${STUDIO_DEPLOY_PORT:-2222}
15remote=(ssh -p "$target_port" "$target_host")
16path="nomad/jobs/$instance/inputs/database"
17handoff=${STUDIO_LEGACY_HANDOFF:-}
18if [[ -n $handoff ]]; then
19 [[ $instance == evil-hedgedoc && -n ${STUDIO_DEPLOY_HOST:-} ]] || {
20 echo 'Offline handoff requires production HedgeDoc and a target' >&2
21 exit 1
22 }
23 sh "$(dirname "$0")/check-legacy-handoff.sh" "$handoff" "$target_host" "$target_port"
24 entry=$("${remote[@]}" "python3 - '$handoff' evil-hedgedoc" < "$(dirname "$0")/verify-legacy-dump.py")
25 source_counts=$(python3 -c 'import json,sys; print("|".join(map(str,json.load(sys.stdin)["counts"])))' <<<"$entry")
26 upload_host=$target_host
27 upload_rsh="ssh -p $target_port"
28else
29 upload_host=$source_host
30 upload_rsh=ssh
31fi
32
33if [[ $instance != evil-hedgedoc ]]; then
34 "${remote[@]}" "test -f /var/lib/studio/stages/$instance.json"
35else
36 [[ -n ${STUDIO_DEPLOY_HOST:-} ]] || { echo 'Set STUDIO_DEPLOY_HOST to the production target' >&2; exit 1; }
37 if [[ -z $handoff ]]; then
38 source_state=$(ssh "$source_host" "sudo -n docker ps -a --filter label=com.docker.compose.service=evil-hedgedoc --format '{{.State}}'")
39 [[ $source_state == exited ]] || { echo 'Stop Zenith evil-hedgedoc before importing production data' >&2; exit 1; }
40 fi
41 job_response=$("${remote[@]}" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/evil-hedgedoc')
42 job_status=${job_response##*$'\n'}
43 if [[ $job_status == 200 ]]; then
44 stopped=$(python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())' <<<"${job_response%$'\n'*}")
45 [[ $stopped == true ]] || { echo 'Stop production HedgeDoc before importing' >&2; exit 1; }
46 for _ in {1..30}; do
47 running=$("${remote[@]}" 'curl -s -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/evil-hedgedoc/allocations' | python3 -c 'import json,sys; print(sum(x["ClientStatus"] == "running" for x in json.load(sys.stdin)))')
48 [[ $running == 0 ]] && break
49 sleep 2
50 done
51 [[ $running == 0 ]] || { echo 'Production HedgeDoc allocation did not stop' >&2; exit 1; }
52 elif [[ $job_status != 404 ]]; then
53 echo "Could not verify production job state: $job_status" >&2
54 exit 1
55 fi
56fi
57"${remote[@]}" "test \$(findmnt -n -o FSTYPE --mountpoint $root) = zfs"
58db_json=$("${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad var get -out json $path")
59read -r database owner < <(python3 -c 'import json,sys; d=json.load(sys.stdin)["Items"]; print(d["name"], d["username"])' <<<"$db_json")
60if [[ $instance == evil-hedgedoc ]]; then
61 [[ $database == evil_hedgedoc && $owner == svc_evil_hedgedoc ]] || { echo 'Unexpected production database' >&2; exit 1; }
62else
63 [[ $database =~ ^evil_hedgedoc_s_[0-9a-f]{8}$ && $owner =~ ^svc_evil_hedgedoc_s_[0-9a-f]{8}$ ]] || { echo 'Unexpected preview database' >&2; exit 1; }
64fi
65
66alloc_json=$("${remote[@]}" 'NOMAD_TOKEN=$(cat /var/lib/studio/nomad.token) nomad job allocs -json postgres')
67allocation=$(python3 -c 'import json,sys; ids=[x["ID"] for x in json.load(sys.stdin) if x["ClientStatus"] == "running" and x["DesiredStatus"] == "run"]; assert len(ids) == 1; print(ids[0])' <<<"$alloc_json")
68container="app-$allocation"
69podman='podman --url unix:///run/podman/podman.sock'
70scratch=$(mktemp -d)
71trap 'rm -rf "$scratch"' EXIT
72rsync -a -e "$upload_rsh" "$upload_host:/mnt/storage1/apps/evil-infra/hedgedoc/" "$scratch/uploads/"
73drift=$(rsync -rnc --delete --out-format='%n' -e "$upload_rsh" "$upload_host:/mnt/storage1/apps/evil-infra/hedgedoc/" "$scratch/uploads/")
74[[ -z $drift ]] || { echo 'Source uploads changed during copy' >&2; exit 1; }
75
76if [[ $instance != evil-hedgedoc ]]; then
77 "${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
78 for _ in {1..30}; do
79 running=$("${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job allocs -json $instance" | python3 -c 'import json,sys; print(sum(x["ClientStatus"] == "running" for x in json.load(sys.stdin)))')
80 [[ $running == 0 ]] && break
81 sleep 2
82 done
83 [[ $running == 0 ]] || { echo 'Preview did not stop' >&2; exit 1; }
84fi
85
86uploads="$root/hedgedoc/public/uploads"
87rsync -a --delete -e "ssh -p $target_port" "$scratch/uploads/" "$target_host:$uploads/"
88drift=$(rsync -rnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/uploads/" "$target_host:$uploads/")
89[[ -z $drift ]] || { echo 'Target uploads differ from source copy' >&2; exit 1; }
90uid=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"evil-hedgedoc\"])'")
91"${remote[@]}" "chown -R $uid:$uid $uploads; chmod 750 $uploads"
92
93backup="/var/lib/studio/$instance-before-import.dump"
94"${remote[@]}" "umask 077; $podman exec $container pg_dump -U postgres -Fc $database > $backup; test -s $backup"
95"${remote[@]}" "$podman exec $container psql -U postgres -d $database -v ON_ERROR_STOP=1 -c 'DROP SCHEMA public CASCADE; CREATE SCHEMA public AUTHORIZATION $owner;' >/dev/null"
96
97if [[ -n $handoff ]]; then
98 "${remote[@]}" "set -o pipefail; cat '$handoff/evil-hedgedoc.dump' | $podman exec -i $container pg_restore -U postgres -d $database --no-owner --no-acl --role=$owner"
99else
100 ssh "$source_host" 'sudo -n docker exec postgres pg_dump -U postgres -Fc evil-hedgedoc' |
101 "${remote[@]}" "$podman exec -i $container pg_restore -U postgres -d $database --no-owner --no-acl --role=$owner"
102fi
103
104counts_sql='SELECT (SELECT count(*) FROM "Notes"), (SELECT count(*) FROM "Users"), (SELECT count(*) FROM "Revisions"), (SELECT count(*) FROM "Authors");'
105if [[ -z $handoff ]]; then
106 source_counts=$(printf '%s\n' "$counts_sql" | ssh "$source_host" sudo -n docker exec -i postgres psql -U postgres -d evil-hedgedoc -At)
107fi
108target_counts=$(printf '%s\n' "$counts_sql" | "${remote[@]}" "$podman exec -i $container psql -U postgres -d $database -At")
109[[ $source_counts == "$target_counts" ]] || { echo 'Restored HedgeDoc record counts differ from Zenith' >&2; exit 1; }
110echo "Verified HedgeDoc Notes, Users, Revisions, and Authors counts: $target_counts"
111
112if [[ $instance == evil-hedgedoc ]]; then
113 if [[ -z $handoff ]]; then
114 [[ $(ssh "$source_host" "sudo -n docker ps -a --filter label=com.docker.compose.service=evil-hedgedoc --format '{{.State}}'") == exited ]] || {
115 echo 'Zenith evil-hedgedoc restarted during import; leave the home server stopped' >&2
116 exit 1
117 }
118 fi
119 echo "Production data imported; promote a tested HedgeDoc preview. Previous database: $backup"
120else
121 python3 "$(dirname "$0")/deploy.py" stage evil-hedgedoc
122 echo "Preview database imported; previous preview dump: $backup"
123fi
tools/import-jackett.sh deleted-100
......@@ -1,100 +0,0 @@
1#!/bin/sh
2set -eu
3
4instance=${1:?usage: tools/import-jackett.sh jackett|jackett-preview-XXXXXXXX}
5case $instance in
6 jackett)
7 test -n "${STUDIO_DEPLOY_HOST:-}" || { echo 'Set STUDIO_DEPLOY_HOST to the production target' >&2; exit 1; }
8 production=true
9 ;;
10 jackett-preview-*)
11 printf '%s\n' "$instance" | grep -Eq '^jackett-preview-[0-9a-f]{8}$' || {
12 echo 'Expected a Jackett preview ID' >&2; exit 1;
13 }
14 production=false
15 ;;
16 *) echo 'Expected jackett or its preview ID' >&2; exit 1 ;;
17esac
18
19source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
20target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
21target_port=${STUDIO_DEPLOY_PORT:-2222}
22offline=false
23copy_host=$source_host
24copy_rsh=ssh
25if [ -n "${STUDIO_LEGACY_HANDOFF:-}" ]; then
26 test "$production" = true || { echo 'Offline handoff requires production Jackett' >&2; exit 1; }
27 sh "$(dirname "$0")/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$target_host" "$target_port"
28 offline=true
29 copy_host=$target_host
30 copy_rsh="ssh -p $target_port"
31fi
32if [ "$production" = true ]; then
33 root=/srv/prod/jackett/config/Jackett
34 mount=/srv/prod/jackett
35 source_root=/mnt/storage1/apps/jackett
36 if [ "$offline" = false ]; then
37 test "$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' jackett")" = false || {
38 echo 'Stop Zenith jackett before importing production data' >&2; exit 1;
39 }
40 fi
41 response=$(ssh -p "$target_port" "$target_host" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/jackett')
42 status=$(printf '%s\n' "$response" | tail -n 1)
43 test "$status" = 200 || { echo "Could not verify jackett on the home server: $status" >&2; exit 1; }
44 stopped=$(printf '%s\n' "$response" | sed '$d' | python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())')
45 test "$stopped" = true || { echo 'Stop jackett on the home server before importing production data' >&2; exit 1; }
46else
47 root="/srv/staging/$instance/config/Jackett"
48 mount="/srv/staging/$instance"
49 source_id=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
50 test "$source_id" = jackett || { echo 'Preview belongs to another service' >&2; exit 1; }
51 source_snapshot=$(ssh "$source_host" '/usr/sbin/zfs list -H -t snapshot -o name -s creation -r storage1/apps | tail -n 1')
52 case $source_snapshot in storage1/apps@*) ;; *) echo 'No apps ZFS snapshot is available' >&2; exit 1 ;; esac
53 source_root="/mnt/storage1/apps/.zfs/snapshot/${source_snapshot#*@}/jackett"
54fi
55
56dataset=$(ssh -p "$target_port" "$target_host" "findmnt -n -o SOURCE --mountpoint $mount")
57if [ "$production" = true ]; then
58 case $dataset in */prod/jackett) ;; *) echo 'Production dataset is not mounted' >&2; exit 1 ;; esac
59else
60 case $dataset in */staging/"$instance") ;; *) echo 'Preview dataset is not mounted' >&2; exit 1 ;; esac
61fi
62
63scratch=$(mktemp -d)
64trap 'rm -rf "$scratch"' EXIT
65rsync -a --exclude='/log.txt*' -e "$copy_rsh" "$copy_host:$source_root/" "$scratch/"
66python3 - "$scratch" <<'PY'
67import json
68from pathlib import Path
69import sys
70
71root = Path(sys.argv[1])
72config = json.loads((root / "ServerConfig.json").read_text())
73if not config.get("APIKey") or not list((root / "Indexers").glob("*.json")):
74 raise ValueError("Jackett configuration is incomplete")
75PY
76
77if [ "$production" = false ]; then
78 ssh -p "$target_port" "$target_host" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
79fi
80snapshot="$dataset@before-jackett-import-$(date +%s)-$$"
81ssh -p "$target_port" "$target_host" "set -eu; for i in \$(seq 1 30); do running=\$(curl -fsS -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/$instance/allocations | python3 -c 'import json,sys; print(sum(a[\"ClientStatus\"] == \"running\" for a in json.load(sys.stdin)))'); test \"\$running\" = 0 && break; sleep 2; done; test \"\$running\" = 0; zfs snapshot $snapshot"
82
83rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/"
84owner=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"jackett\"])'")
85ssh -p "$target_port" "$target_host" "chown -R $owner:$owner $root"
86drift=$(rsync -rlnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/" "$target_host:$root/")
87test -z "$drift" || { echo "Jackett copy differs from source; restore $snapshot" >&2; exit 1; }
88
89if [ "$production" = true ]; then
90 if [ "$offline" = false ]; then
91 test "$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' jackett")" = false || {
92 echo 'Zenith jackett restarted during import; leave the home server stopped' >&2; exit 1;
93 }
94 fi
95 echo "Imported production Jackett. Previous dataset state: $snapshot"
96else
97 python3 "$(dirname "$0")/deploy.py" stage jackett
98 ssh -p "$target_port" "$target_host" "zfs destroy $snapshot"
99 echo "Imported and tested $instance from $source_snapshot"
100fi
tools/import-jellyfin.sh deleted-103
......@@ -1,103 +0,0 @@
1#!/bin/sh
2set -eu
3
4instance=${1:?usage: tools/import-jellyfin.sh jellyfin|jellyfin-preview-XXXXXXXX}
5case $instance in
6 jellyfin)
7 test -n "${STUDIO_DEPLOY_HOST:-}" || { echo 'Set STUDIO_DEPLOY_HOST to the production target' >&2; exit 1; }
8 production=true
9 ;;
10 jellyfin-preview-*)
11 printf '%s\n' "$instance" | grep -Eq '^jellyfin-preview-[0-9a-f]{8}$' || {
12 echo 'Expected a Jellyfin preview ID' >&2; exit 1;
13 }
14 production=false
15 ;;
16 *) echo 'Expected jellyfin or its preview ID' >&2; exit 1 ;;
17esac
18
19source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
20target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
21target_port=${STUDIO_DEPLOY_PORT:-2222}
22offline=false
23if [ -n "${STUDIO_LEGACY_HANDOFF:-}" ]; then
24 test "$production" = true || { echo 'Offline handoff requires production Jellyfin' >&2; exit 1; }
25 sh "$(dirname "$0")/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$target_host" "$target_port"
26 offline=true
27fi
28if [ "$production" = true ]; then
29 root=/srv/prod/jellyfin/config
30 mount=/srv/prod/jellyfin
31 source_root=/mnt/storage1/apps/jellyfin
32 if [ "$offline" = false ]; then
33 test "$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' jellyfin")" = false || {
34 echo 'Stop Zenith jellyfin before importing production data' >&2; exit 1;
35 }
36 fi
37 response=$(ssh -p "$target_port" "$target_host" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/jellyfin')
38 status=$(printf '%s\n' "$response" | tail -n 1)
39 test "$status" = 200 || { echo "Could not verify jellyfin on the home server: $status" >&2; exit 1; }
40 stopped=$(printf '%s\n' "$response" | sed '$d' | python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())')
41 test "$stopped" = true || { echo 'Stop jellyfin on the home server before importing production data' >&2; exit 1; }
42 media_fs=$(ssh -p "$target_port" "$target_host" 'findmnt -n -o FSTYPE --mountpoint /srv/clover/Media')
43 test "$media_fs" = zfs || { echo 'Mount the real Media ZFS dataset before importing production data' >&2; exit 1; }
44 source_label=stopped-live-source
45 if [ "$offline" = true ]; then source_label=mounted-old-apps; fi
46else
47 root="/srv/staging/$instance/config"
48 mount="/srv/staging/$instance"
49 source_id=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
50 test "$source_id" = jellyfin || { echo 'Preview belongs to another service' >&2; exit 1; }
51 source_snapshot=$(ssh "$source_host" '/usr/sbin/zfs list -H -t snapshot -o name -s creation -r storage1/apps | tail -n 1')
52 case $source_snapshot in storage1/apps@*) ;; *) echo 'No apps ZFS snapshot is available' >&2; exit 1 ;; esac
53 source_label=${source_snapshot#*@}
54 source_root="/mnt/storage1/apps/.zfs/snapshot/$source_label/jellyfin"
55fi
56
57dataset=$(ssh -p "$target_port" "$target_host" "findmnt -n -o SOURCE --mountpoint $mount")
58if [ "$production" = true ]; then
59 case $dataset in */prod/jellyfin) ;; *) echo 'Production dataset is not mounted' >&2; exit 1 ;; esac
60else
61 case $dataset in */staging/"$instance") ;; *) echo 'Preview dataset is not mounted' >&2; exit 1 ;; esac
62fi
63
64if [ "$offline" = false ]; then
65 scratch=$(mktemp -d)
66 trap 'rm -rf "$scratch"' EXIT
67 rsync -a --exclude='/cache/' --exclude='/log/' --exclude='/transcodes/' --exclude='*-shm' \
68 "$source_host:$source_root/" "$scratch/"
69fi
70
71if [ "$production" = false ]; then
72 ssh -p "$target_port" "$target_host" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
73fi
74snapshot="$dataset@before-jellyfin-import-$(date +%s)-$$"
75ssh -p "$target_port" "$target_host" "set -eu; for i in \$(seq 1 30); do running=\$(curl -fsS -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/$instance/allocations | python3 -c 'import json,sys; print(sum(a[\"ClientStatus\"] == \"running\" for a in json.load(sys.stdin)))'); test \"\$running\" = 0 && break; sleep 2; done; test \"\$running\" = 0; zfs snapshot $snapshot"
76
77if [ "$offline" = true ]; then
78 ssh -p "$target_port" "$target_host" "rsync -a --delete --delete-excluded --exclude='/cache/' --exclude='/log/' --exclude='/transcodes/' --exclude='*-shm' '$source_root/' '$root/'"
79else
80 rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/"
81fi
82owner=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"jellyfin\"])'")
83ssh -p "$target_port" "$target_host" "chown -R $owner:$owner $root"
84if [ "$offline" = true ]; then
85 drift=$(ssh -p "$target_port" "$target_host" "rsync -rlnc --delete --delete-excluded --exclude='/cache/' --exclude='/log/' --exclude='/transcodes/' --exclude='*-shm' --out-format='%n' '$source_root/' '$root/'")
86else
87 drift=$(rsync -rlnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/" "$target_host:$root/")
88fi
89test -z "$drift" || { echo "Jellyfin copy differs from source; restore $snapshot" >&2; exit 1; }
90ssh -p "$target_port" "$target_host" "python3 -c 'import sqlite3; from pathlib import Path; root=Path(\"$root/data\"); assert all((root / name).is_file() and sqlite3.connect(\"file:\" + str(root / name) + \"?mode=ro\", uri=True).execute(\"PRAGMA integrity_check\").fetchone()[0] == \"ok\" for name in (\"jellyfin.db\", \"introskipper/introskipper.db\"))'"
91
92if [ "$production" = true ]; then
93 if [ "$offline" = false ]; then
94 test "$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' jellyfin")" = false || {
95 echo 'Zenith jellyfin restarted during import; leave the home server stopped' >&2; exit 1;
96 }
97 fi
98 echo "Imported production Jellyfin from $source_label. Previous dataset state: $snapshot"
99else
100 python3 "$(dirname "$0")/deploy.py" stage jellyfin
101 ssh -p "$target_port" "$target_host" "zfs destroy $snapshot"
102 echo "Imported and tested $instance from $source_snapshot"
103fi
tools/import-legacy-secrets.sh deleted-54
......@@ -1,54 +0,0 @@
1#!/bin/bash
2set -euo pipefail
3
4service=${1:?usage: tools/import-legacy-secrets.sh SERVICE ENV_NAME...|KEY=ENV_NAME...}
5shift
6(( $# > 0 )) || { echo 'Expected at least one environment variable name' >&2; exit 1; }
7[[ $service =~ ^[a-z][a-z0-9-]*$ ]] || { echo 'Invalid service name' >&2; exit 1; }
8sources=()
9keys=()
10for item in "$@"; do
11 if [[ $item == *=* ]]; then
12 key=${item%%=*}
13 source=${item#*=}
14 [[ $key =~ ^[A-Za-z_][A-Za-z0-9_]*$ ]] || { echo 'Invalid secret key' >&2; exit 1; }
15 keys+=("$key")
16 else
17 source=$item
18 fi
19 [[ $source =~ ^[A-Z][A-Z0-9_]*$ ]] || { echo 'Invalid environment variable name' >&2; exit 1; }
20 sources+=("$source")
21done
22(( ${#keys[@]} == 0 || ${#keys[@]} == ${#sources[@]} )) || { echo 'Use a target key for every source name' >&2; exit 1; }
23options=()
24for key in "${keys[@]}"; do
25 options+=(--key "$key")
26done
27: "${STUDIO_DEPLOY_HOST:?Set STUDIO_DEPLOY_HOST to the production target}"
28
29source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
30repo=$(cd "$(dirname "$0")/.." && pwd)
31names=$(printf ' %s' "${sources[@]}")
32if [[ -n ${STUDIO_LEGACY_HANDOFF:-} ]]; then
33 sh "$repo/tools/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$STUDIO_DEPLOY_HOST" "${STUDIO_DEPLOY_PORT:-22}"
34 source_remote=(ssh -p "${STUDIO_DEPLOY_PORT:-22}" "$STUDIO_DEPLOY_HOST")
35else
36 source_remote=(ssh "$source_host")
37fi
38
39"${source_remote[@]}" "python3 -$names <<'PY'
40from pathlib import Path
41import sys
42
43lines = Path('/mnt/storage1/apps/home-infra/.env').read_text().splitlines()
44if len(set(sys.argv[1:])) != len(sys.argv[1:]):
45 raise SystemExit('Duplicate source secret name')
46secrets = []
47for name in sys.argv[1:]:
48 values = [line.split('=', 1)[1] for line in lines if line.startswith(name + '=')]
49 if len(values) != 1 or not values[0]:
50 raise SystemExit('Expected one nonempty source secret: ' + name)
51 secrets.append(values[0])
52for value in secrets:
53 print(value)
54PY" | python3 "$repo/tools/deploy.py" secrets "$service" --file - "${options[@]}"
tools/import-navidrome.sh deleted-102
......@@ -1,102 +0,0 @@
1#!/bin/sh
2set -eu
3
4instance=${1:?usage: tools/import-navidrome.sh navidrome|navidrome-preview-XXXXXXXX}
5case $instance in
6 navidrome)
7 test -n "${STUDIO_DEPLOY_HOST:-}" || { echo 'Set STUDIO_DEPLOY_HOST to the production target' >&2; exit 1; }
8 production=true
9 ;;
10 navidrome-preview-*)
11 printf '%s\n' "$instance" | grep -Eq '^navidrome-preview-[0-9a-f]{8}$' || {
12 echo 'Expected a Navidrome preview ID' >&2; exit 1;
13 }
14 production=false
15 ;;
16 *) echo 'Expected navidrome or its preview ID' >&2; exit 1 ;;
17esac
18
19source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
20target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
21target_port=${STUDIO_DEPLOY_PORT:-2222}
22offline=false
23if [ -n "${STUDIO_LEGACY_HANDOFF:-}" ]; then
24 test "$production" = true || { echo 'Offline handoff requires production Navidrome' >&2; exit 1; }
25 sh "$(dirname "$0")/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$target_host" "$target_port"
26 offline=true
27fi
28if [ "$production" = true ]; then
29 root=/srv/prod/navidrome/data
30 mount=/srv/prod/navidrome
31 source_root=/mnt/storage1/apps/navidrone
32 if [ "$offline" = false ]; then
33 test "$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' navidrome")" = false || {
34 echo 'Stop Zenith navidrome before importing production data' >&2; exit 1;
35 }
36 fi
37 response=$(ssh -p "$target_port" "$target_host" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/navidrome')
38 status=$(printf '%s\n' "$response" | tail -n 1)
39 test "$status" = 200 || { echo "Could not verify navidrome on the home server: $status" >&2; exit 1; }
40 stopped=$(printf '%s\n' "$response" | sed '$d' | python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())')
41 test "$stopped" = true || { echo 'Stop navidrome on the home server before importing production data' >&2; exit 1; }
42 media_fs=$(ssh -p "$target_port" "$target_host" 'findmnt -n -o FSTYPE --mountpoint /srv/clover/Media')
43 test "$media_fs" = zfs || { echo 'Mount the real Media ZFS dataset before importing production data' >&2; exit 1; }
44else
45 root="/srv/staging/$instance/data"
46 mount="/srv/staging/$instance"
47 source_id=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
48 test "$source_id" = navidrome || { echo 'Preview belongs to another service' >&2; exit 1; }
49 source_snapshot=$(ssh "$source_host" '/usr/sbin/zfs list -H -t snapshot -o name -s creation -r storage1/apps | tail -n 1')
50 case $source_snapshot in storage1/apps@*) ;; *) echo 'No apps ZFS snapshot is available' >&2; exit 1 ;; esac
51 source_root="/mnt/storage1/apps/.zfs/snapshot/${source_snapshot#*@}/navidrone"
52fi
53
54dataset=$(ssh -p "$target_port" "$target_host" "findmnt -n -o SOURCE --mountpoint $mount")
55if [ "$production" = true ]; then
56 case $dataset in */prod/navidrome) ;; *) echo 'Production dataset is not mounted' >&2; exit 1 ;; esac
57else
58 case $dataset in */staging/"$instance") ;; *) echo 'Preview dataset is not mounted' >&2; exit 1 ;; esac
59fi
60
61if [ "$offline" = true ]; then
62 ssh -p "$target_port" "$target_host" "test -s '$source_root/navidrome.db'" || { echo 'Navidrome database is missing' >&2; exit 1; }
63else
64 scratch=$(mktemp -d)
65 trap 'rm -rf "$scratch"' EXIT
66 rsync -a --exclude='*-shm' "$source_host:$source_root/" "$scratch/"
67 test -s "$scratch/navidrome.db" || { echo 'Navidrome database is missing' >&2; exit 1; }
68fi
69
70if [ "$production" = false ]; then
71 ssh -p "$target_port" "$target_host" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
72fi
73snapshot="$dataset@before-navidrome-import-$(date +%s)-$$"
74ssh -p "$target_port" "$target_host" "set -eu; for i in \$(seq 1 30); do running=\$(curl -fsS -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/$instance/allocations | python3 -c 'import json,sys; print(sum(a[\"ClientStatus\"] == \"running\" for a in json.load(sys.stdin)))'); test \"\$running\" = 0 && break; sleep 2; done; test \"\$running\" = 0; zfs snapshot $snapshot"
75
76if [ "$offline" = true ]; then
77 ssh -p "$target_port" "$target_host" "rsync -a --delete --delete-excluded --exclude='*-shm' '$source_root/' '$root/'"
78else
79 rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/"
80fi
81owner=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"navidrome\"])'")
82ssh -p "$target_port" "$target_host" "chown -R $owner:$owner $root"
83if [ "$offline" = true ]; then
84 drift=$(ssh -p "$target_port" "$target_host" "rsync -rlnc --delete --delete-excluded --exclude='*-shm' --out-format='%n' '$source_root/' '$root/'")
85else
86 drift=$(rsync -rlnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/" "$target_host:$root/")
87fi
88test -z "$drift" || { echo "Navidrome copy differs from source; restore $snapshot" >&2; exit 1; }
89ssh -p "$target_port" "$target_host" "python3 -c 'import sqlite3; db=sqlite3.connect(\"file:$root/navidrome.db?mode=ro\", uri=True); assert db.execute(\"PRAGMA integrity_check\").fetchone()[0] == \"ok\"; assert db.execute(\"select count(*) from user where user_name=\\\"snow\\\" and is_admin=1\").fetchone()[0] == 1'"
90
91if [ "$production" = true ]; then
92 if [ "$offline" = false ]; then
93 test "$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' navidrome")" = false || {
94 echo 'Zenith navidrome restarted during import; leave the home server stopped' >&2; exit 1;
95 }
96 fi
97 echo "Imported production Navidrome. Previous dataset state: $snapshot"
98else
99 python3 "$(dirname "$0")/deploy.py" stage navidrome
100 ssh -p "$target_port" "$target_host" "zfs destroy $snapshot"
101 echo "Imported and tested $instance from $source_snapshot"
102fi
tools/import-pds-secrets.py deleted-44
......@@ -1,44 +0,0 @@
1#!/usr/bin/env python3
2import os
3from pathlib import Path
4import re
5import subprocess
6
7
8if not os.environ.get("STUDIO_DEPLOY_HOST"):
9 raise SystemExit("Set STUDIO_DEPLOY_HOST to the production target")
10
11if os.environ.get("STUDIO_LEGACY_HANDOFF"):
12 ssh = ["ssh", "-o", "BatchMode=yes", "-p", os.environ.get("STUDIO_DEPLOY_PORT", "22"), os.environ["STUDIO_DEPLOY_HOST"]]
13else:
14 ssh = ["ssh", "-o", "BatchMode=yes", os.environ.get("STUDIO_MIGRATION_SOURCE", "zenith")]
15
16source = subprocess.run(
17 [*ssh, "cat", "/mnt/storage1/apps/home-infra/.env"],
18 check=True, capture_output=True, text=True,
19).stdout
20names = {
21 "PDS_JWT_SECRET": "jwt_secret",
22 "PDS_ADMIN_PASSWORD": "admin_password",
23 "PDS_PLC_ROTATION_KEY_K256_PRIVATE_KEY_HEX": "plc_rotation_key",
24 "MAILER_ADDRESS": "mailer_address",
25 "MAILER_USERNAME": "mailer_username",
26 "MAILER_PASSWORD": "mailer_password",
27}
28values = {}
29for line in source.splitlines():
30 key, separator, value = line.partition("=")
31 key = key.strip()
32 if separator and key in names:
33 if names[key] in values:
34 raise ValueError(f"duplicate source secret: {key}")
35 values[names[key]] = value.strip()
36if len(values) != len(names) or not all(values.values()):
37 raise ValueError("PDS source secrets are incomplete")
38if not re.fullmatch(r"[0-9a-fA-F]{64}", values["plc_rotation_key"]):
39 raise ValueError("invalid PDS rotation key")
40
41subprocess.run(
42 ["python3", str(Path(__file__).with_name("deploy.py")), "secrets", "pds", "--file", "-"],
43 input="".join(values[name] + "\n" for name in names.values()), text=True, check=True,
44)
tools/import-pds.sh deleted-127
......@@ -1,127 +0,0 @@
1#!/bin/sh
2set -eu
3
4instance=${1:?usage: tools/import-pds.sh pds|pds-preview-XXXXXXXX}
5case $instance in
6 pds)
7 test -n "${STUDIO_DEPLOY_HOST:-}" || { echo 'Set STUDIO_DEPLOY_HOST to the production target' >&2; exit 1; }
8 production=true
9 ;;
10 pds-preview-*)
11 printf '%s\n' "$instance" | grep -Eq '^pds-preview-[0-9a-f]{8}$' || {
12 echo 'Expected a PDS preview ID' >&2; exit 1;
13 }
14 production=false
15 ;;
16 *) echo 'Expected pds or its preview ID' >&2; exit 1 ;;
17esac
18
19source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
20target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
21target_port=${STUDIO_DEPLOY_PORT:-2222}
22offline=false
23copy_host=$source_host
24copy_rsh=ssh
25if [ -n "${STUDIO_LEGACY_HANDOFF:-}" ]; then
26 test "$production" = true || { echo 'Offline handoff requires production PDS' >&2; exit 1; }
27 sh "$(dirname "$0")/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$target_host" "$target_port"
28 offline=true
29 copy_host=$target_host
30 copy_rsh="ssh -p $target_port"
31fi
32source_ssh() {
33 if [ "$offline" = true ]; then
34 ssh -p "$target_port" "$target_host" "$@"
35 else
36 ssh "$source_host" "$@"
37 fi
38}
39if [ "$production" = true ]; then
40 root=/srv/prod/pds/pds
41 mount=/srv/prod/pds
42 if [ "$offline" = false ]; then
43 source_running=$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' pds")
44 test "$source_running" = false || { echo 'Stop Zenith pds before importing production data' >&2; exit 1; }
45 fi
46 response=$(ssh -p "$target_port" "$target_host" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/pds')
47 status=$(printf '%s\n' "$response" | tail -n 1)
48 test "$status" = 200 || { echo "Could not verify pds on the home server: $status" >&2; exit 1; }
49 stopped=$(printf '%s\n' "$response" | sed '$d' | python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())')
50 test "$stopped" = true || { echo 'Stop pds on the home server before importing production data' >&2; exit 1; }
51else
52 root="/srv/staging/$instance/pds"
53 mount="/srv/staging/$instance"
54 source_id=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
55 test "$source_id" = pds || { echo 'Preview belongs to another service' >&2; exit 1; }
56fi
57scratch=$(mktemp -d)
58source_backup=
59cleanup() {
60 rm -rf "$scratch"
61 if [ -n "$source_backup" ]; then
62 source_ssh "rm -rf '$source_backup'"
63 fi
64}
65trap cleanup EXIT
66
67dataset=$(ssh -p "$target_port" "$target_host" "findmnt -n -o SOURCE --mountpoint $mount")
68if [ "$production" = true ]; then
69 case $dataset in */prod/pds) ;; *) echo 'Production dataset is not mounted' >&2; exit 1 ;; esac
70 python3 "$(dirname "$0")/import-pds-secrets.py"
71else
72 case $dataset in */staging/"$instance") ;; *) echo 'Preview dataset is not mounted' >&2; exit 1 ;; esac
73 origin=$(ssh -p "$target_port" "$target_host" "zfs get -H -o value origin $dataset")
74 test "$origin" = - || { echo 'Expected a fresh preview dataset' >&2; exit 1; }
75fi
76snapshot="$dataset@before-pds-import-$(date +%s)-$$"
77
78source_backup=$(source_ssh python3 - <<'PY'
79from pathlib import Path
80import shutil
81import sqlite3
82import tempfile
83
84out = Path(tempfile.mkdtemp(prefix="studio-pds-"))
85try:
86 for name in ("account", "sequencer", "did_cache"):
87 source = sqlite3.connect(f"file:/mnt/storage1/apps/pds/{name}.sqlite?mode=ro", uri=True)
88 target = sqlite3.connect(out / f"{name}.sqlite")
89 source.backup(target)
90 if target.execute("PRAGMA integrity_check").fetchone()[0] != "ok":
91 raise ValueError(f"Invalid PDS SQLite copy: {name}")
92 target.close()
93 source.close()
94except BaseException:
95 shutil.rmtree(out)
96 raise
97print(out)
98PY
99)
100rsync -a -e "$copy_rsh" "$copy_host:$source_backup/" "$scratch/"
101rsync -a --exclude='*.sqlite*' -e "$copy_rsh" "$copy_host:/mnt/storage1/apps/pds/" "$scratch/"
102drift=$(rsync -rnc --delete --exclude='*.sqlite*' --out-format='%n' -e "$copy_rsh" "$copy_host:/mnt/storage1/apps/pds/" "$scratch/")
103test -z "$drift" || { echo 'PDS source changed during copy; retry the import' >&2; exit 1; }
104
105if [ "$production" = false ]; then
106 ssh -p "$target_port" "$target_host" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
107fi
108ssh -p "$target_port" "$target_host" "set -eu; for i in \$(seq 1 30); do running=\$(curl -fsS -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/$instance/allocations | python3 -c 'import json,sys; print(sum(a[\"ClientStatus\"] == \"running\" for a in json.load(sys.stdin)))'); test \"\$running\" = 0 && break; sleep 2; done; test \"\$running\" = 0; zfs snapshot $snapshot"
109
110rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/"
111owner=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"pds\"])'")
112ssh -p "$target_port" "$target_host" "chown -R $owner:$owner $root; python3 -c 'import sqlite3; from pathlib import Path; root=Path(\"$root\"); names=(\"account\",\"sequencer\",\"did_cache\"); assert all((root / (name + \".sqlite\")).is_file() and sqlite3.connect(\"file:\" + str(root / (name + \".sqlite\")) + \"?mode=ro&immutable=1\", uri=True).execute(\"PRAGMA integrity_check\").fetchone()[0] == \"ok\" for name in names)'"
113drift=$(rsync -rnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/" "$target_host:$root/")
114test -z "$drift" || { echo "PDS copy differs from source backup; restore $snapshot" >&2; exit 1; }
115
116if [ "$production" = true ]; then
117 if [ "$offline" = false ]; then
118 test "$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' pds")" = false || {
119 echo 'Zenith pds restarted during import; leave the home server stopped' >&2; exit 1;
120 }
121 fi
122 echo "Imported production PDS from Zenith. Previous dataset state: $snapshot"
123else
124 python3 "$(dirname "$0")/deploy.py" stage pds
125 ssh -p "$target_port" "$target_host" "zfs destroy $snapshot"
126 echo "Imported and tested $instance"
127fi
tools/import-personal-files.py deleted-114
......@@ -1,114 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import json
4import os
5from pathlib import Path
6import sqlite3
7import subprocess
8import time
9import urllib.error
10import urllib.request
11
12
13parser = argparse.ArgumentParser(description="Copy retained app files on the new host before starting the service.")
14parser.add_argument("service", choices=["tailscale", "ddns-updater", "copyparty", "ytdl", "pds"])
15
16
17def main():
18 service = parser.parse_args().service
19 if os.geteuid() != 0:
20 raise SystemExit("Run this importer as root on the production host.")
21 token = Path("/var/lib/studio/nomad.token").read_text().strip()
22 request = urllib.request.Request(
23 "http://127.0.0.1:4646/v1/job/" + service,
24 headers={"X-Nomad-Token": token},
25 )
26 try:
27 with urllib.request.urlopen(request, timeout=10) as response:
28 job = json.load(response)
29 if not job.get("Stop"):
30 raise SystemExit("Stop " + service + " before copying its files.")
31 except urllib.error.HTTPError as error:
32 if error.code != 404:
33 raise
34 request.full_url += "/allocations"
35 try:
36 with urllib.request.urlopen(request, timeout=10) as response:
37 allocations = json.load(response)
38 except urllib.error.HTTPError as error:
39 if error.code != 404:
40 raise
41 allocations = []
42 if any(item["ClientStatus"] not in ("complete", "failed", "lost") for item in allocations):
43 raise SystemExit("Wait for " + service + " allocations to stop before copying its files.")
44
45 root = Path("/srv/prod") / service
46 dataset = subprocess.check_output(["findmnt", "-n", "-o", "SOURCE", "--mountpoint", str(root)], text=True).strip()
47 if dataset != "globe/prod/" + service:
48 raise SystemExit("Mount globe/prod/" + service + " at " + str(root) + " before copying files.")
49 uid = 0 if service == "tailscale" else json.loads(Path("/var/lib/studio/identities.json").read_text())[service]
50 directories = {
51 "tailscale": ("tailscale", "var/lib/tailscale"),
52 "ddns-updater": ("ddns-updater", "updater/data"),
53 "copyparty": ("copyparty/copyparty", "cfg/copyparty"),
54 "ytdl": ("ytdl-sub", "config"),
55 "pds": ("pds", "pds"),
56 }
57 source_name, target_name = directories[service]
58 source = Path("/mnt/storage1/apps") / source_name
59 target = root / target_name
60 if not source.is_dir():
61 raise SystemExit("Retained app files are missing at " + str(source))
62 if service == "tailscale":
63 json.loads((source / "tailscaled.state").read_text())
64 elif service == "ddns-updater":
65 json.loads((source / "updates.json").read_text())
66 elif service == "copyparty":
67 for database in source.glob("*.db"):
68 with sqlite3.connect("file:" + str(database) + "?mode=ro", uri=True) as connection:
69 if connection.execute("PRAGMA integrity_check").fetchone()[0] != "ok":
70 raise SystemExit("Check the retained Copyparty database before copying " + database.name)
71 if not (source / "shares.db").is_file():
72 raise SystemExit("Restore the retained Copyparty shares.db before importing.")
73 elif service == "pds":
74 for name in ("account", "sequencer", "did_cache"):
75 if not (source / (name + ".sqlite")).is_file():
76 raise SystemExit("Restore the retained PDS " + name + " database before importing.")
77 if list(source.rglob("*-wal")) or list(source.rglob("*-shm")):
78 raise SystemExit("Back up all PDS SQLite databases, including actor stores, before importing WAL files.")
79 for database in source.rglob("*.sqlite"):
80 with sqlite3.connect("file:" + str(database) + "?mode=ro&immutable=1", uri=True) as connection:
81 if connection.execute("PRAGMA integrity_check").fetchone()[0] != "ok":
82 raise SystemExit("Check the retained PDS database before importing " + database.name)
83
84 snapshot = dataset + "@before-files-import-" + str(time.time_ns())
85 subprocess.run(["zfs", "snapshot", snapshot], check=True)
86 target.mkdir(parents=True, exist_ok=True)
87 exclusions = ["--exclude=*.lock", "--exclude=/.ytdl-sub-lock", "--exclude=/.cache/", "--exclude=/work/"]
88 subprocess.run(["rsync", "-aH", "--delete", *exclusions, str(source) + "/", str(target) + "/"], check=True)
89 drift = subprocess.check_output([
90 "rsync", "-rlnc", "--delete", "--out-format=%n", *exclusions, str(source) + "/", str(target) + "/",
91 ], text=True)
92 if drift:
93 raise SystemExit("Copied files differ from the retained source. Restore " + snapshot + " before retrying.")
94 os.chown(target, uid, uid)
95 for directory, children, files in os.walk(target):
96 for name in children + files:
97 os.chown(Path(directory) / name, uid, uid, follow_symlinks=False)
98 if service == "tailscale":
99 os.chmod(target / "tailscaled.state", 0o600)
100 elif service == "copyparty":
101 for database in target.glob("*.db"):
102 with sqlite3.connect("file:" + str(database) + "?mode=ro", uri=True) as connection:
103 if connection.execute("PRAGMA integrity_check").fetchone()[0] != "ok":
104 raise SystemExit("Copied Copyparty database needs recovery from " + snapshot)
105 elif service == "pds":
106 for database in target.rglob("*.sqlite"):
107 with sqlite3.connect("file:" + str(database) + "?mode=ro&immutable=1", uri=True) as connection:
108 if connection.execute("PRAGMA integrity_check").fetchone()[0] != "ok":
109 raise SystemExit("Copied PDS database needs recovery from " + snapshot)
110 print(json.dumps({"service": service, "snapshot": snapshot, "copied": True}))
111
112
113if __name__ == "__main__":
114 main()
tools/import-personal-postgres.py deleted-215
......@@ -1,215 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3import hashlib
4import json
5import os
6from pathlib import Path
7import re
8import subprocess
9import tempfile
10import urllib.error
11import urllib.request
12
13
14def identifier(value):
15 return '"' + value.replace('"', '""') + '"'
16
17
18def digest(path):
19 result = hashlib.sha256()
20 with path.open('rb') as stream:
21 for block in iter(lambda: stream.read(1024 * 1024), b''):
22 result.update(block)
23 return result.hexdigest()
24
25
26def fingerprint(sql, database):
27 relations = json.loads(sql(database, """
28 SELECT coalesce(json_agg(x ORDER BY n, c), '[]') FROM (
29 SELECT n.nspname n, c.relname c, c.relkind k
30 FROM pg_class c JOIN pg_namespace n ON n.oid=c.relnamespace
31 WHERE n.nspname NOT LIKE 'pg_%' AND n.nspname <> 'information_schema'
32 AND c.relkind IN ('r','m','S')
33 ) x
34 """))
35 result = {}
36 for relation in relations:
37 table = identifier(relation['n']) + '.' + identifier(relation['c'])
38 query = (f'SELECT last_value,is_called FROM {table}' if relation['k'] == 'S' else
39 f'COPY (SELECT row_to_json(t)::text FROM {table} t '
40 'ORDER BY row_to_json(t)::text COLLATE "C") TO STDOUT')
41 content = sql(database, query)
42 result[table] = {'rows': len(content.splitlines()),
43 'sha256': hashlib.sha256(content).hexdigest()}
44 content = sql(database, "COPY (SELECT loid,pageno,encode(data,'hex') "
45 'FROM pg_largeobject ORDER BY loid,pageno) TO STDOUT')
46 result['large_objects'] = {'rows': len(content.splitlines()),
47 'sha256': hashlib.sha256(content).hexdigest()}
48 return result
49
50
51def main():
52 parser = argparse.ArgumentParser(description='Restore a personal database before starting its service.')
53 parser.add_argument('service', choices=('keycloak', 'dawarich'))
54 parser.add_argument('handoff', type=Path)
55 parser.add_argument('--container', help='Restore inside the isolated initializer before deploying Postgres')
56 args = parser.parse_args()
57 if os.geteuid() != 0:
58 parser.error('Run as root on Zenith')
59 os.umask(0o077)
60 handoff = args.handoff.resolve()
61 cluster = json.loads((handoff / 'manifest.json').read_text())['clusters']['18']
62 if not cluster.get('restoreVerified'):
63 raise ValueError('PostgreSQL 18 backup is unverified. Use the verified handoff')
64 entry = cluster['databases'][args.service]
65 dump = (handoff / entry['file']).resolve()
66 if not dump.is_relative_to(handoff / 'pg18') or dump.suffix != '.dump':
67 raise ValueError('Dump is outside the PostgreSQL 18 handoff')
68 if dump.stat().st_size != entry['bytes'] or digest(dump) != entry['sha256']:
69 raise ValueError('Backup checksum differs. Recover the verified handoff before importing')
70
71 token = os.environ.get('NOMAD_TOKEN') or Path('/var/lib/studio/nomad.token').read_text().strip()
72
73 def nomad(path):
74 request = urllib.request.Request('http://127.0.0.1:4646/v1/' + path,
75 headers={'X-Nomad-Token': token})
76 with urllib.request.urlopen(request, timeout=10) as response:
77 return json.load(response)
78
79 def stopped(service):
80 try:
81 job = nomad('job/' + service)
82 except urllib.error.HTTPError as error:
83 if error.code == 404:
84 return
85 raise
86 if not job.get('Stop') or any(
87 item['ClientStatus'] in ('pending', 'running')
88 for item in nomad('job/' + service + '/allocations')
89 ):
90 raise ValueError(f'Stop {service} and wait for its allocations before importing')
91
92 stopped(args.service)
93 connection = nomad('var/nomad/jobs/' + args.service + '/inputs/database')['Items']
94 database, owner = connection['name'], connection['username']
95 expected_database = 'keycloak_next' if args.service == 'keycloak' else 'dawarich'
96 if database != expected_database or owner != 'svc_' + database:
97 raise ValueError('Database variable differs from the production service. Allocate its database first')
98 if args.container:
99 stopped('postgres')
100 else:
101 allocations = [item['ID'] for item in nomad('job/postgres/allocations')
102 if item['ClientStatus'] == 'running' and item['DesiredStatus'] == 'run']
103 if len(allocations) != 1:
104 raise ValueError('Postgres needs exactly one running allocation')
105 folder = Path(tempfile.mkdtemp(prefix=args.service + '-import-', dir='/var/lib/studio'))
106 diagnostics = folder / 'diagnostics.log'
107 podman = ['podman']
108
109 def run(command, *, source=None, output=None):
110 with diagnostics.open('ab') as errors:
111 result = subprocess.run(command, input=source if isinstance(source, bytes) else None,
112 stdin=source if source is not None and not isinstance(source, bytes) else None,
113 stdout=output or subprocess.PIPE, stderr=errors)
114 if result.returncode:
115 raise RuntimeError(f'{Path(command[0]).name} failed. See {diagnostics}')
116 return result.stdout
117
118 if args.container:
119 container = json.loads(run(podman + ['inspect', args.container]))[0]
120 if not container['State']['Running'] or container['HostConfig']['NetworkMode'] != 'none':
121 raise ValueError('Initializer must be running with --network none')
122 container_id = container['Id']
123 else:
124 containers = [parts[0] for line in run(podman + ['ps', '--format', '{{.ID}} {{.Names}}']).decode().splitlines()
125 if len(parts := line.split()) == 2 and parts[1].endswith(allocations[0])]
126 if len(containers) != 1:
127 raise ValueError('Postgres allocation container is unavailable')
128 container_id = containers[0]
129 execute = podman + ['exec', '-i', container_id]
130
131 def sql(db, query):
132 return run(execute + ['psql', '-X', '-U', 'postgres', '-d', db,
133 '-At', '-v', 'ON_ERROR_STOP=1'], source=(query + '\n').encode())
134
135 current_owner = sql('postgres', f"SELECT pg_get_userbyid(datdba) FROM pg_database WHERE datname='{database}'").decode().strip()
136 if current_owner != owner:
137 raise ValueError('Production database is missing or has another owner. Allocate it with the Postgres provider')
138 with dump.open('rb') as source:
139 listing = run(execute + ['pg_restore', '--list'], source=source).decode()
140 extensions = re.findall(r'^\d+; \d+ \d+ EXTENSION - (\S+) ', listing, re.MULTILINE)
141 if set(extensions) - {'plpgsql', 'postgis'} or ('postgis' in extensions) != (args.service == 'dawarich'):
142 raise ValueError('Backup extensions differ from the service. Review the personal database before importing')
143 extension_data, application = [], []
144 for line in listing.splitlines():
145 if re.match(r'^\d+; \d+ \d+ (EXTENSION |COMMENT - EXTENSION |SCHEMA - public )', line):
146 continue
147 if re.match(r'^\d+; \d+ \d+ TABLE DATA public spatial_ref_sys ', line):
148 extension_data.append(line)
149 else:
150 application.append(line)
151 contents = {name: value for name, value in entry['contents'].items() if name != 'large_object_owners'}
152 restore_list = '/tmp/' + folder.name + '.list'
153 run(execute + ['tee', restore_list], source=('\n'.join(application) + '\n').encode())
154 try:
155 stopped(args.service)
156 if args.container:
157 stopped('postgres')
158 if sql('postgres', f"SELECT count(*) FROM pg_stat_activity WHERE datname='{database}'").strip() != b'0':
159 raise ValueError('Database has connected clients. Stop them before importing')
160 backup = folder / 'before.dump'
161 with backup.open('wb') as output:
162 run(execute + ['pg_dump', '-U', 'postgres', '-Fc', database], output=output)
163 if not backup.stat().st_size:
164 raise RuntimeError('Target backup is empty. Import stopped')
165 sql('postgres', f'DROP DATABASE {database};')
166 sql('postgres', f'CREATE DATABASE {database} OWNER {owner};')
167 sql(database, f'ALTER SCHEMA public OWNER TO {owner};')
168 if args.service == 'dawarich':
169 sql(database, 'CREATE EXTENSION postgis;')
170 with dump.open('rb') as source:
171 run(execute + ['pg_restore', '-U', 'postgres', '-d', database, '--no-owner', '--no-acl',
172 '--role=' + owner, '--single-transaction', '--exit-on-error',
173 '--use-list=' + restore_list], source=source)
174 if extension_data:
175 run(execute + ['tee', restore_list], source=('\n'.join(extension_data) + '\n').encode())
176 with dump.open('rb') as source:
177 extension_sql = run(execute + ['pg_restore', '-U', 'postgres', '--data-only', '--no-owner',
178 '--no-acl', '--use-list=' + restore_list, '--file=-'], source=source)
179 srids = []
180 copying = False
181 for line in extension_sql.splitlines():
182 if line.startswith(b'COPY public.spatial_ref_sys ('):
183 copying = True
184 elif copying and line == b'\\.':
185 copying = False
186 elif copying:
187 srids.append(int(line.split(b'\t', 1)[0]))
188 # PostGIS dumps include custom SRIDs; the extension supplies built-in definitions.
189 if srids:
190 sql(database, 'DELETE FROM public.spatial_ref_sys WHERE srid IN (' + ','.join(map(str, srids)) + ');')
191 with dump.open('rb') as source:
192 run(execute + ['pg_restore', '-U', 'postgres', '-d', database, '--no-owner', '--no-acl',
193 '--data-only', '--single-transaction', '--exit-on-error',
194 '--use-list=' + restore_list], source=source)
195 actual = fingerprint(sql, database)
196 if actual != contents:
197 changed = sorted(name for name in actual.keys() | contents.keys() if actual.get(name) != contents.get(name))
198 (folder / 'differences.json').write_text(json.dumps(changed, indent=2) + '\n')
199 raise RuntimeError(f'Restored data differs. Keep {args.service} stopped and review {folder}')
200 if dump.stat().st_size != entry['bytes'] or digest(dump) != entry['sha256']:
201 raise RuntimeError('Backup changed during import. Keep the service stopped')
202 (folder / 'verified.json').write_text(json.dumps({
203 'service': args.service, 'database': database, 'source': str(dump),
204 'sha256': entry['sha256'], 'contents': actual,
205 }, indent=2) + '\n')
206 print(f'Imported and verified {args.service}. Previous database: {backup}')
207 finally:
208 run(execute + ['rm', '-f', restore_list])
209
210
211if __name__ == '__main__':
212 try:
213 main()
214 except (ValueError, RuntimeError, OSError, KeyError, urllib.error.HTTPError) as error:
215 raise SystemExit(str(error)) from None
tools/import-qbittorrent.sh deleted-66
......@@ -1,66 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4: "${STUDIO_DEPLOY_HOST:?Set STUDIO_DEPLOY_HOST to the production target}"
5source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
6target_host=$STUDIO_DEPLOY_HOST
7target_port=${STUDIO_DEPLOY_PORT:-2222}
8remote=(ssh -p "$target_port" "$target_host")
9root=/srv/prod/qbittorrent
10source_copy_host=$source_host
11source_rsh=ssh
12offline=false
13if [[ -n ${STUDIO_LEGACY_HANDOFF:-} ]]; then
14 sh "$(dirname "$0")/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$target_host" "$target_port"
15 source_copy_host=$target_host
16 source_rsh="ssh -p $target_port"
17 offline=true
18fi
19
20if [[ $offline == false ]]; then
21 source_running=$(ssh "$source_host" 'sudo -n docker inspect -f "{{.State.Running}}" qbittorrent')
22 [[ $source_running == false ]] || { echo 'Stop Zenith qBittorrent before importing its profile' >&2; exit 1; }
23fi
24"${remote[@]}" 'test "$(findmnt -n -o FSTYPE --mountpoint /srv/clover/Media)" = zfs; test -d /srv/clover/Media/Seedbox; test -L /srv/clover/Media/torrent; test /srv/clover/Media/Seedbox -ef /srv/clover/Media/torrent' || {
25 echo 'Mount Media and point torrent at Seedbox before importing qBittorrent' >&2; exit 1;
26}
27
28response=$("${remote[@]}" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/qbittorrent')
29status=${response##*$'\n'}
30if [[ $status == 200 ]]; then
31 stopped=$(python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())' <<<"${response%$'\n'*}")
32 [[ $stopped == true ]] || { echo 'Stop qBittorrent on the home server before importing its profile' >&2; exit 1; }
33elif [[ $status != 404 ]]; then
34 echo "Could not verify qBittorrent job state on the home server: $status" >&2
35 exit 1
36fi
37dataset=$("${remote[@]}" "findmnt -n -o SOURCE --mountpoint $root")
38[[ $dataset == */prod/qbittorrent ]] || { echo "Expected a mounted service dataset at $root" >&2; exit 1; }
39
40scratch=$(mktemp -d)
41trap 'rm -rf "$scratch"' EXIT
42mkdir "$scratch/qBittorrent"
43rsync -a --exclude=/config/ipc-socket --exclude=/config/lockfile --exclude=/data/logs/ --exclude=/cache/ \
44 -e "$source_rsh" "$source_copy_host:/mnt/storage1/apps/qbittorrent/qBittorrent/" "$scratch/qBittorrent/"
45resume_count=$(find "$scratch/qBittorrent/data/BT_backup" -maxdepth 1 -type f -name '*.fastresume' | wc -l | tr -d ' ')
46[[ $resume_count -gt 0 ]] || { echo 'No saved torrents copied from Zenith' >&2; exit 1; }
47
48snapshot="$dataset@before-qbittorrent-import-$(date +%s)-$$"
49"${remote[@]}" "zfs snapshot $snapshot"
50rsync -a --delete -e "ssh -p $target_port" "$scratch/qBittorrent/" "$target_host:$root/config/qBittorrent/"
51changes=$(rsync -a --checksum --dry-run --itemize-changes -e "ssh -p $target_port" \
52 "$scratch/qBittorrent/" "$target_host:$root/config/qBittorrent/")
53[[ -z $changes ]] || { echo 'Copied qBittorrent profile differs from source' >&2; exit 1; }
54
55uid=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"qbittorrent\"])'")
56"${remote[@]}" "chown -R $uid:$uid $root/config/qBittorrent && chmod -R u+rwX,go-rwx $root/config/qBittorrent && printf '{\"hostRoot\":\"$root\",\"uid\":$uid}' | python3 /opt/studio/current/service/qbittorrent/prepare.py"
57copied=$("${remote[@]}" "find $root/config/qBittorrent/data/BT_backup -maxdepth 1 -type f -name '*.fastresume' | wc -l")
58[[ $copied -eq $resume_count ]] || { echo 'Saved torrent count changed during import' >&2; exit 1; }
59if [[ $offline == false ]]; then
60 [[ $(ssh "$source_host" 'sudo -n docker inspect -f "{{.State.Running}}" qbittorrent') == false ]] || {
61 echo 'Zenith qBittorrent restarted during import; leave the home server stopped' >&2
62 exit 1
63 }
64fi
65"${remote[@]}" 'python3 /opt/studio/current/tools/studio.py deploy qbittorrent'
66echo "Imported $resume_count saved torrents into $dataset; pre-import snapshot: $snapshot"
tools/import-shale.sh deleted-106
......@@ -1,106 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4instance=${1:?usage: tools/import-shale.sh shale|shale-preview-XXXXXXXX}
5[[ $instance == shale || $instance =~ ^shale-preview-[0-9a-f]{8}$ ]] || { echo 'Expected Shale or its preview ID' >&2; exit 1; }
6source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
7target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
8target_port=${STUDIO_DEPLOY_PORT:-2222}
9remote=(ssh -p "$target_port" "$target_host")
10job_status=200
11handoff=${STUDIO_LEGACY_HANDOFF:-}
12if [[ -n $handoff ]]; then
13 [[ $instance == shale && -n ${STUDIO_DEPLOY_HOST:-} ]] || {
14 echo 'Offline handoff requires production Shale and a target' >&2
15 exit 1
16 }
17 sh "$(dirname "$0")/check-legacy-handoff.sh" "$handoff" "$target_host" "$target_port"
18 source_copy_host=$target_host
19 source_rsh="ssh -p $target_port"
20else
21 source_copy_host=$source_host
22 source_rsh=ssh
23fi
24
25if [[ $instance == shale ]]; then
26 [[ -n ${STUDIO_DEPLOY_HOST:-} ]] || { echo 'Set STUDIO_DEPLOY_HOST to the production target' >&2; exit 1; }
27 if [[ -z $handoff ]]; then
28 [[ $(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' shale") == false ]] || { echo 'Stop Zenith Shale before importing production data' >&2; exit 1; }
29 fi
30 root=/srv/prod/shale
31 source_root=/mnt/storage1/apps/shale
32 job_response=$("${remote[@]}" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/shale')
33 job_status=${job_response##*$'\n'}
34 if [[ $job_status == 200 ]]; then
35 stopped=$(python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())' <<<"${job_response%$'\n'*}")
36 [[ $stopped == true ]] || { echo 'Stop Shale on the home server before importing production data' >&2; exit 1; }
37 elif [[ $job_status != 404 ]]; then
38 echo "Could not verify production Shale job: $job_status" >&2
39 exit 1
40 fi
41else
42 root=/srv/staging/$instance
43 source_id=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
44 [[ $source_id == shale ]] || { echo 'Preview belongs to another service' >&2; exit 1; }
45 source_snapshot=$(ssh "$source_host" '/usr/sbin/zfs list -H -t snapshot -o name -s creation -r storage1/apps | tail -n 1')
46 [[ $source_snapshot == storage1/apps@* ]] || { echo 'No Zenith app snapshot is available' >&2; exit 1; }
47 source_root=/mnt/storage1/apps/.zfs/snapshot/${source_snapshot#*@}/shale
48fi
49
50dataset=$("${remote[@]}" "findmnt -n -o SOURCE --mountpoint $root")
51if [[ $instance == shale ]]; then
52 [[ $dataset == */prod/shale ]] || { echo 'Production Shale dataset is not mounted' >&2; exit 1; }
53else
54 [[ $dataset == */staging/$instance ]] || { echo 'Preview Shale dataset is not mounted' >&2; exit 1; }
55fi
56
57scratch=$(mktemp -d)
58trap 'rm -rf "$scratch"' EXIT
59for name in data repositories_owned repositories_mirrors; do
60 rsync -aH -e "$source_rsh" "$source_copy_host:$source_root/$name/" "$scratch/$name/"
61 drift=$(rsync -rlnc --delete --out-format='%n' -e "$source_rsh" "$source_copy_host:$source_root/$name/" "$scratch/$name/")
62 [[ -z $drift ]] || { echo "Zenith Shale $name changed during copy" >&2; exit 1; }
63done
64python3 - "$scratch/data/astheno.shale.db" <<'PY'
65import sqlite3
66import sys
67
68db = sqlite3.connect(f"file:{sys.argv[1]}?mode=ro", uri=True)
69assert db.execute("PRAGMA integrity_check").fetchone()[0] == "ok"
70PY
71
72if [[ $instance != shale ]]; then
73 "${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
74fi
75if [[ $job_status == 200 || $instance != shale ]]; then
76 for _ in {1..30}; do
77 running=$("${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job allocs -json $instance" |
78 python3 -c 'import json,sys; print(sum(a["ClientStatus"] == "running" for a in json.load(sys.stdin)))')
79 [[ $running == 0 ]] && break
80 sleep 2
81 done
82 [[ $running == 0 ]] || { echo 'Shale allocation did not stop' >&2; exit 1; }
83fi
84
85snapshot=$dataset@before-shale-import-$(date +%s)-$$
86"${remote[@]}" "zfs snapshot $snapshot"
87for name in data repositories_owned repositories_mirrors; do
88 "${remote[@]}" "mkdir -p $root/$name"
89 rsync -aH --delete -e "ssh -p $target_port" "$scratch/$name/" "$target_host:$root/$name/"
90 drift=$(rsync -rlnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/$name/" "$target_host:$root/$name/")
91 [[ -z $drift ]] || { echo "Shale $name on the home server differs from the source copy; restore $snapshot" >&2; exit 1; }
92done
93uid=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"shale\"])'")
94"${remote[@]}" "chown -R $uid:$uid $root/data $root/repositories_owned $root/repositories_mirrors"
95"${remote[@]}" "python3 -c 'import sqlite3; db=sqlite3.connect(\"file:$root/data/astheno.shale.db?mode=ro\", uri=True); assert db.execute(\"PRAGMA integrity_check\").fetchone()[0] == \"ok\"'"
96
97if [[ $instance == shale ]]; then
98 if [[ -z $handoff ]]; then
99 [[ $(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' shale") == false ]] || { echo 'Zenith Shale restarted during import; leave the home server stopped' >&2; exit 1; }
100 fi
101 echo "Imported production Shale. Previous dataset state: $snapshot"
102else
103 python3 "$(dirname "$0")/deploy.py" stage shale
104 "${remote[@]}" "zfs destroy $snapshot"
105 echo "Imported and tested $instance from $source_snapshot"
106fi
tools/import-source-data.sh deleted-68
......@@ -1,68 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4: "${STUDIO_DEPLOY_HOST:?Set STUDIO_DEPLOY_HOST to the production target}"
5source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
6target_host=$STUDIO_DEPLOY_HOST
7target_port=${STUDIO_DEPLOY_PORT:-22}
8remote=(ssh -p "$target_port" "$target_host")
9target_dir=/srv/prod/clover-source-of-truth/data
10tree_hash="$(dirname "$0")/tree-hash.py"
11
12if [[ -n ${STUDIO_MIGRATION_SNAPSHOT:-} ]]; then
13 [[ $STUDIO_MIGRATION_SNAPSHOT =~ ^[A-Za-z0-9_-]+$ ]] || { echo 'Invalid source snapshot name' >&2; exit 1; }
14 source=("${remote[@]}")
15 source_dir="/srv/clover/.zfs/snapshot/$STUDIO_MIGRATION_SNAPSHOT/Documents/Config/paper clover"
16 "${source[@]}" "test -d '$source_dir'"
17else
18 source=(ssh "$source_host")
19 source_dir='/mnt/storage1/clover/Documents/Config/paper clover'
20 [[ $("${source[@]}" "sudo -n docker inspect -f '{{.State.Running}}' clover-source-of-truth") == false ]] || {
21 echo 'Stop Zenith Source of Truth before importing production data' >&2
22 exit 1
23 }
24fi
25"${remote[@]}" "set -e; test \$(findmnt -n -o FSTYPE --mountpoint /srv/clover) = zfs; test -d /srv/clover/Published; ! findmnt -n -R '$target_dir' >/dev/null"
26dataset=$("${remote[@]}" 'findmnt -n -o SOURCE --mountpoint /srv/prod/clover-source-of-truth')
27[[ $dataset == */prod/clover-source-of-truth ]] || { echo 'Production service dataset is not mounted' >&2; exit 1; }
28job_response=$("${remote[@]}" 'curl -s -w "\n%{http_code}" -H "X-Nomad-Token: $(cat /var/lib/studio/nomad.token)" http://127.0.0.1:4646/v1/job/clover-source-of-truth')
29job_status=${job_response##*$'\n'}
30if [[ $job_status == 200 ]]; then
31 stopped=$(python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())' <<<"${job_response%$'\n'*}")
32 [[ $stopped == true ]] || { echo 'Stop Source of Truth on the home server before importing production data' >&2; exit 1; }
33 for _ in {1..30}; do
34 running=$("${remote[@]}" 'NOMAD_TOKEN=$(cat /var/lib/studio/nomad.token) nomad job allocs -json clover-source-of-truth' |
35 python3 -c 'import json,sys; print(sum(a["ClientStatus"] == "running" for a in json.load(sys.stdin)))')
36 [[ $running == 0 ]] && break
37 sleep 2
38 done
39 [[ $running == 0 ]] || { echo 'The home server allocation did not stop' >&2; exit 1; }
40elif [[ $job_status != 404 ]]; then
41 echo "Could not verify the home server job: $job_status" >&2
42 exit 1
43fi
44
45source_manifest=$("${source[@]}" "python3 - '$source_dir'" < "$tree_hash")
46source_bytes=$(python3 -c 'import json,sys; print(json.load(sys.stdin)["bytes"])' <<<"$source_manifest")
47available=$("${remote[@]}" "df -B1 --output=avail /srv/prod/clover-source-of-truth | tail -n 1")
48(( available > source_bytes )) || { echo 'Production dataset has too little free space for the source tree' >&2; exit 1; }
49
50snapshot=$dataset@before-source-data-import-$(date +%s)-$$
51"${remote[@]}" "set -e; zfs snapshot $snapshot; rm -rf -- '$target_dir'; mkdir -p -- '$target_dir'"
52if [[ -n ${STUDIO_MIGRATION_SNAPSHOT:-} ]]; then
53 "${remote[@]}" "bash -c \"set -euo pipefail; tar -C '$source_dir' -cf - . | tar -C '$target_dir' -xf -\""
54else
55 "${source[@]}" "tar -C '$source_dir' -cf - ." |
56 "${remote[@]}" "tar -C '$target_dir' -xf -"
57fi
58target_manifest=$("${remote[@]}" "python3 - '$target_dir'" < "$tree_hash")
59[[ $source_manifest == "$target_manifest" ]] || { echo "Source and target trees differ; restore $snapshot" >&2; exit 1; }
60uid=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"clover-source-of-truth\"])'")
61"${remote[@]}" "set -e; chown -R $uid:$uid '$target_dir'; python3 -c 'import sqlite3; db=sqlite3.connect(\"file:$target_dir/cache.sqlite?mode=ro\", uri=True); assert db.execute(\"PRAGMA integrity_check\").fetchone()[0] == \"ok\"'"
62if [[ -z ${STUDIO_MIGRATION_SNAPSHOT:-} ]]; then
63 [[ $("${source[@]}" "sudo -n docker inspect -f '{{.State.Running}}' clover-source-of-truth") == false ]] || {
64 echo 'Zenith Source of Truth restarted during import; leave the home server stopped' >&2
65 exit 1
66 }
67fi
68echo "Imported ${source_bytes} bytes without local staging. Previous dataset state: $snapshot"
tools/import-source-index.sh deleted-68
......@@ -1,68 +0,0 @@
1#!/bin/sh
2set -eu
3
4instance=${1:?usage: tools/import-source-index.sh clover-source-of-truth-preview-XXXXXXXX}
5printf '%s\n' "$instance" | grep -Eq '^clover-source-of-truth-preview-[0-9a-f]{8}$' || {
6 echo 'Expected a Clover Source of Truth preview ID' >&2
7 exit 1
8}
9
10source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
11target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
12target_port=${STUDIO_DEPLOY_PORT:-2222}
13root="/srv/staging/$instance/data"
14mount="/srv/staging/$instance"
15source_id=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
16test "$source_id" = clover-source-of-truth || { echo 'Preview belongs to another service' >&2; exit 1; }
17dataset=$(ssh -p "$target_port" "$target_host" "findmnt -n -o SOURCE --mountpoint $mount")
18case $dataset in */staging/"$instance") ;; *) echo 'Preview dataset is not mounted' >&2; exit 1 ;; esac
19
20scratch=$(mktemp -d)
21source_backup=
22cleanup() {
23 rm -rf "$scratch"
24 if [ -n "$source_backup" ]; then
25 ssh "$source_host" "rm -rf '$source_backup'"
26 fi
27}
28trap cleanup EXIT
29
30source_backup=$(ssh "$source_host" sh -s <<'REMOTE'
31set -eu
32out=$(mktemp -d /tmp/studio-source-index-XXXXXX)
33trap 'rm -rf "$out"' EXIT
34source='/mnt/storage1/clover/Documents/Config/paper clover/cache.sqlite'
35sqlite3 -readonly "$source" ".backup '$out/cache.sqlite'"
36test "$(sqlite3 -readonly "$out/cache.sqlite" 'PRAGMA integrity_check;')" = ok
37trap - EXIT
38printf '%s\n' "$out"
39REMOTE
40)
41rsync -a "$source_host:$source_backup/cache.sqlite" "$scratch/cache.sqlite"
42python3 - "$scratch/cache.sqlite" <<'PY'
43import sqlite3
44import sys
45
46db = sqlite3.connect('file:' + sys.argv[1] + '?mode=ro&immutable=1', uri=True)
47assert db.execute('PRAGMA integrity_check').fetchone()[0] == 'ok'
48PY
49
50ssh -p "$target_port" "$target_host" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
51snapshot="$dataset@before-source-index-import-$(date +%s)-$$"
52ssh -p "$target_port" "$target_host" "set -eu; for i in \$(seq 1 30); do running=\$(curl -fsS -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/$instance/allocations | python3 -c 'import json,sys; print(sum(a[\"ClientStatus\"] == \"running\" for a in json.load(sys.stdin)))'); test \"\$running\" = 0 && break; sleep 2; done; test \"\$running\" = 0; zfs snapshot $snapshot"
53
54rsync -a -e "ssh -p $target_port" "$scratch/cache.sqlite" "$target_host:$root/cache.sqlite"
55owner=$(ssh -p "$target_port" "$target_host" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"clover-source-of-truth\"])'")
56ssh -p "$target_port" "$target_host" "chown $owner:$owner $root/cache.sqlite; rm -f $root/cache.sqlite-wal $root/cache.sqlite-shm $root/db-snapshot.sqlite"
57drift=$(rsync -rnc --out-format='%n' -e "ssh -p $target_port" "$scratch/cache.sqlite" "$target_host:$root/cache.sqlite")
58test -z "$drift" || { echo "Index copy differs from source backup; restore $snapshot" >&2; exit 1; }
59
60python3 "$(dirname "$0")/deploy.py" stage clover-source-of-truth
61ssh -p "$target_port" "$target_host" "python3 - <<'PY'
62import sqlite3
63source = sqlite3.connect('file:$root/cache.sqlite?mode=ro', uri=True)
64assert source.execute('PRAGMA integrity_check').fetchone()[0] == 'ok'
65for table in ('media_files', 'derived_files', 'derived_refs'):
66 print(table, source.execute('SELECT count(*) FROM ' + table).fetchone()[0])
67PY"
68echo "Imported the live SQLite index into $instance; previous dataset: $snapshot"
tools/import-yt-feed.sh deleted-109
......@@ -1,109 +0,0 @@
1#!/usr/bin/env bash
2set -euo pipefail
3
4instance=${1:-ytdl}
5[[ $instance == ytdl || $instance =~ ^ytdl-preview-[0-9a-f]{8}$ ]] || {
6 echo 'Expected ytdl or its preview ID' >&2
7 exit 1
8}
9
10source_host=${STUDIO_MIGRATION_SOURCE:-zenith}
11target_host=${STUDIO_DEPLOY_HOST:-root@127.0.0.1}
12target_port=${STUDIO_DEPLOY_PORT:-2222}
13remote=(ssh -p "$target_port" "$target_host")
14source_copy_host=$source_host
15source_rsh=ssh
16offline=false
17if [[ -n ${STUDIO_LEGACY_HANDOFF:-} ]]; then
18 [[ $instance == ytdl && -n ${STUDIO_DEPLOY_HOST:-} ]] || {
19 echo 'Offline handoff requires production YouTube Triage and a target' >&2; exit 1;
20 }
21 sh "$(dirname "$0")/check-legacy-handoff.sh" "$STUDIO_LEGACY_HANDOFF" "$target_host" "$target_port"
22 source_copy_host=$target_host
23 source_rsh="ssh -p $target_port"
24 offline=true
25fi
26if [[ $instance == ytdl ]]; then
27 root=/srv/prod/ytdl
28 "${remote[@]}" 'test "$(findmnt -n -o FSTYPE --mountpoint /srv/clover/Media)" = zfs; test -d "/srv/clover/Media/Intake - Music"; test -d "/srv/clover/Media/Indie Shows"; test -d /srv/clover/Media/Videos/Independent' || {
29 echo 'Mount Media with Intake - Music, Indie Shows, and Videos/Independent before importing YouTube Triage' >&2
30 exit 1
31 }
32 if [[ $offline == false ]]; then
33 source_running=$(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' yt-feed")
34 [[ $source_running == false ]] || { echo 'Stop Zenith yt-feed before importing production data' >&2; exit 1; }
35 fi
36 response=$("${remote[@]}" "curl -s -w '\n%{http_code}' -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/ytdl")
37 status=${response##*$'\n'}
38 if [[ $status == 200 ]]; then
39 stopped=$(python3 -c 'import json,sys; print(str(json.load(sys.stdin)["Stop"]).lower())' <<<"${response%$'\n'*}")
40 [[ $stopped == true ]] || { echo 'Stop production YTDL before importing' >&2; exit 1; }
41 elif [[ $status != 404 ]]; then
42 echo "Could not verify production YTDL job state: $status" >&2
43 exit 1
44 fi
45else
46 root=/srv/staging/$instance
47 source_id=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/stages/$instance.json\"))[\"sourceId\"])'")
48 [[ $source_id == ytdl ]] || { echo 'Preview belongs to another service' >&2; exit 1; }
49fi
50dataset=$("${remote[@]}" "findmnt -n -o SOURCE --mountpoint $root")
51[[ $dataset == */prod/ytdl || $dataset == */staging/"$instance" ]] || {
52 echo "Expected a mounted YTDL dataset at $root" >&2
53 exit 1
54}
55
56scratch=$(mktemp -d)
57trap 'rm -rf "$scratch"' EXIT
58rsync -a -e "$source_rsh" "$source_copy_host:/mnt/storage1/apps/yt-feed/" "$scratch/"
59python3 - "$scratch" <<'PY'
60import json
61from pathlib import Path
62import sys
63
64root = Path(sys.argv[1])
65files = list(root.glob("*.json"))
66if not files:
67 raise ValueError("no YouTube Triage JSON state was copied")
68for file in files:
69 json.loads(file.read_text())
70print(f"Copied {len(files)} valid JSON state files")
71PY
72drift=$(rsync -rnc --delete --out-format='%n' -e "$source_rsh" "$source_copy_host:/mnt/storage1/apps/yt-feed/" "$scratch/")
73[[ -z $drift ]] || { echo 'Source changed during copy; retry the import' >&2; exit 1; }
74
75if [[ $instance != ytdl ]]; then
76 "${remote[@]}" "NOMAD_TOKEN=\$(cat /var/lib/studio/nomad.token) nomad job stop -yes $instance"
77else
78 "${remote[@]}" 'systemctl stop studio-dashboard'
79fi
80for _ in {1..30}; do
81 running=$("${remote[@]}" "curl -s -H \"X-Nomad-Token: \$(cat /var/lib/studio/nomad.token)\" http://127.0.0.1:4646/v1/job/$instance/allocations" |
82 python3 -c 'import json,sys; print(sum(x["ClientStatus"] == "running" for x in json.load(sys.stdin)))')
83 [[ $running == 0 ]] && break
84 sleep 2
85done
86[[ $running == 0 ]] || { echo "$instance still has a running allocation" >&2; exit 1; }
87
88snapshot="$dataset@before-yt-feed-import-$(date +%s)-$$"
89"${remote[@]}" "zfs snapshot $snapshot"
90rsync -a --delete -e "ssh -p $target_port" "$scratch/" "$target_host:$root/data/"
91uid=$("${remote[@]}" "python3 -c 'import json; print(json.load(open(\"/var/lib/studio/identities.json\"))[\"ytdl\"])'")
92"${remote[@]}" "chown -R $uid:$uid $root/data"
93drift=$(rsync -rnc --delete --out-format='%n' -e "ssh -p $target_port" "$scratch/" "$target_host:$root/data/")
94[[ -z $drift ]] || { echo "Copied state differs from source; restore $snapshot" >&2; exit 1; }
95
96if [[ $instance == ytdl ]]; then
97 if [[ $offline == false ]]; then
98 [[ $(ssh "$source_host" "sudo -n docker inspect -f '{{.State.Running}}' yt-feed") == false ]] || {
99 echo 'Zenith yt-feed restarted during import; leave the home server stopped' >&2
100 exit 1
101 }
102 fi
103 "${remote[@]}" 'systemctl start studio-dashboard'
104 echo "Imported production YTDL from Zenith. Previous dataset state: $snapshot"
105else
106 python3 "$(dirname "$0")/deploy.py" stage ytdl
107 "${remote[@]}" "zfs destroy $snapshot"
108 echo "Imported and tested $instance"
109fi
tools/intake-migration.md deleted-7
......@@ -1,7 +0,0 @@
1# JSON Intake migration
2
3Zenith's `Documents/Intake` exists but contains no files at the 2026-09-26 inspection. Snow Globe already mounts the equivalent Clover folder, so no application dataset copy is required.
4
5Existing Siri shortcuts and webhooks send Zenith's `INTAKE_KEY`. During production cutover, set `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT` for the production host, then run `bash tools/import-legacy-secrets.sh intake INTAKE_KEY` to stream that value from Zenith's `.env` into Snow Globe's Nomad secret. Redeploy Intake to load it. The command does not print or save the key locally; it refuses to run without an explicit target.
6
7On 2026-09-26, `intake-preview-7f29ae9a` inherited the VM production key and cloned the Clover dataset for its writable mount. Its HTTPS route rejected an incorrect key with 401 and accepted a test row with the inherited key; the row appeared only in the clone, then was removed. Release `7b6aac707cf7c55f` promoted successfully after a backup of 22 service datasets and four databases, and all 19 HTTP routes passed. Destroying the stage removed its Nomad job, secret, ZFS clone, and source snapshot. Production Intake remained healthy and its Clover folder stayed empty.
tools/jellyfin-migration.md deleted-13
......@@ -1,13 +0,0 @@
1# Jellyfin media migration proof
2
3An initial small preview used a consistent SQLite backup from Zenith, verified by `PRAGMA integrity_check` before and after transfer. Its 4,879 `/media/...` paths matched Zenith's database by sorted path digest. On Zenith, 4,823 resolved in the existing media dataset; the other 56 were already missing at the source (50 videos, 3 trailers, 2 folders, and 1 photo).
4
5The VM mounts Zenith's media tree read-only at `/srv/clover/Media`, which Jellyfin receives as `/media`. Twenty evenly spaced source paths that exist on Zenith also resolved through the VM mount. The staged app is healthy without copying the 3.97 TiB media dataset. [The media cutover plan](media-cutover.md) moves that dataset to the final `/srv/clover/Media` mountpoint while preserving hardlinks and snapshots.
6
7A full preview restore used the existing read-only `storage1/apps@hourly-2026-09-26_01-00` snapshot as its source. [import-jellyfin.sh](import-jellyfin.sh) copied Jellyfin's metadata, artwork, attachments, subtitles, intro-skipper state, and plugins while excluding caches, logs, and transcodes. The copy was 4.7 GB on the Mac and 3.2 GB in the VM's compressed ZFS dataset; checksums matched before the app started. The pinned 10.11.11 image migrated the 10.11.5 database successfully. Both sides had 17,466 base items, 22 users, 7,717 user-data rows, and the same digest for 4,879 media paths after boot. The source and stage also matched counts for 7,149 metadata files, 873 attachments, and 1,574 subtitles. SQLite integrity and HTTPS health passed; the SSO start endpoint redirected to the staged Keycloak client.
8
9Production import (`STUDIO_DEPLOY_HOST=<new-host> STUDIO_DEPLOY_PORT=22 sh tools/import-jellyfin.sh jellyfin`) uses the stopped live source, requires the new Jellyfin job stopped and the real Media ZFS filesystem mounted, snapshots the destination, verifies the copy, assigns Jellyfin's allocated UID, and leaves the new job stopped for cutover. During the preview boot, a three-second Nomad health probe timed out under load and Caddy briefly removed the stage route. The probe now allows 15 seconds; the updated preview deployment passed. The imported Jellyfin settings also automatically installed newer AniList and Intro Skipper plugins after startup.
10
11After a same-machine OS replacement, set `STUDIO_LEGACY_HANDOFF` to the [offline handoff](legacy-handoff.md) directory. The production importer then copies the old app metadata directly between mounted datasets on the new host, without a Mac scratch copy or old Docker daemon. The 3.97 TiB Media dataset remains a ZFS mount and is not copied.
12
13The service binds the reorganized host folders at their original `/media/jellyfin/...` container paths using the shared [config/site.pkl](../config/site.pkl) mapping. Both existing library settings and new-instance setup keep those paths; no database path rewrite is needed. See the [current service layout](media-cutover.md#service-paths-for-the-reorganized-tree). This follows [Jellyfin's migration guidance](https://jellyfin.org/docs/general/administration/migrate/) to preserve the paths seen by the application.
tools/knife.md+1-12
......@@ -38,7 +38,7 @@ an allocation ID:
3838
3939```sh
4040ssh -p 22 root@10.0.0.1
41export NOMAD_TOKEN="$(cat /var/lib/studio/nomad.token)"
41export NOMAD_TOKEN="$(cat /var/lib/snowglobe/nomad.token)"
4242knife_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])')
4343knife_container="app-$knife_allocation"
4444podman 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
7575and update `service/knife/bundle.json`, then use the normal stage → main → prod
7676workflow. Runtime downloads under `data/runtime/knife-container` survive an infra
7777image rollback; rolling back code does not restore state or archive objects.
78
79## 2026-10-16 SSO verification
80
81A fresh Zenith preview completed Clover's real Snow Globe sign-in, verified the
82issuer/subject account binding, renewed its browser session, and opened an
83authenticated WebSocket through HTTPS. Anonymous access, missing CSRF, invalid
84OIDC/native transactions, and corrupt archive objects were rejected. A synthetic
85object uploaded and downloaded identically with working byte ranges; temporarily
86removing the preview's archive marker returned 503 and its original marker was
87restored unchanged. The private allocation JSON matched its separate Nomad client,
88used mode 0400 and UID 3132, and its intended bind mount rejected writes.
tools/legacy-handoff.md deleted-28
......@@ -1,28 +0,0 @@
1# Same-machine PostgreSQL handoff
2
3The retained apps dataset is an encrypted ZFS root. Keep its mountpoint explicitly at `/mnt/storage1/apps` after renaming the pool to `globe` and replacing Zenith with NixOS; [media-cutover.md](media-cutover.md) gives the command order. The old app directories and `/mnt/storage1/apps/home-infra/.env` remain there; the new `/srv/prod` root is separate.
4
5If TrueNAS is still running, stop the old apps being migrated, leaving old PostgreSQL running long enough to export. Run `bash tools/export-legacy-postgres.sh` before replacing the OS. Zenith grants the `clo` account passwordless `sudo docker` access for the export; this online exporter requires the original `storage1/apps` mount and exports Forgejo and HedgeDoc only. It does not stop apps itself.
6
7If already booted into the installer, [export-offline-postgres.py](export-offline-postgres.py) exports every connectable database and all roles from both retained clusters. It requires all PostgreSQL servers to be stopped, matching-major runtimes with the source extensions installed, and `glibcLocales`. It starts private RAM copies over private Unix sockets, saves complete physical archives including `template0`, checks the original file hashes remain unchanged, and restores every logical dump into fresh temporary clusters. Verification compares every user table's contents, sequence state, and large objects. The originals are never started. Run as root on the installer, with the runtime paths supplied by the pinned Nix builds:
8
9```sh
10python3 tools/export-offline-postgres.py \
11 --cluster /mnt/storage1/apps/pg_data "$postgres17_runtime" \
12 --cluster /mnt/storage1/apps/pg_data18/18/docker "$postgres18_runtime" \
13 --locale-archive "$glibc_locales/lib/locale/locale-archive"
14```
15
16It publishes a private `studio-handoff/<timestamp>-<suffix>` directory only after successful restores. Its `pg17` and `pg18` directories contain all database dumps, `globals.sql`, and `cluster.tar.gz`; the manifest records their hashes and restore evidence. Root-level Forgejo and HedgeDoc dump links select the PG18 exports for the existing importers. Dawarich's old database is retained in the full export even though its new service starts fresh. Copy the complete handoff directory, preserving these links, to a private off-server archive and verify the file hashes before replacing the OS. `globals.sql` contains role password hashes; protect the archive like the recovery keys. Failed exports remain under `.pending-*` and cannot be selected by the importers.
17
18The October 4 installer export restored and verified nine databases and eleven roles from each cluster. Its complete archive is saved on the Mac at `/Users/clo/Library/Application Support/Zenith Recovery/postgres-backups/20261004T230507Z-e75419.tar`; every archived file hash and both physical cluster contents were checked against the server manifest. The production handoff is:
19
20```sh
21export STUDIO_LEGACY_HANDOFF=/mnt/storage1/apps/studio-handoff/20261004T230507Z-e75419
22```
23
24After NixOS has imported and unlocked the apps dataset, set `STUDIO_DEPLOY_HOST`, `STUDIO_DEPLOY_PORT`, and `STUDIO_LEGACY_HANDOFF` to that printed directory. The importers require the mounted pool's encrypted apps dataset at `/mnt/storage1/apps` and a stopped destination job. HedgeDoc and evil.inc Forgejo verify dump hashes and source table counts before restoring their PostgreSQL databases. Shale, Jellyfin, Navidrome, PDS, qBittorrent, Sonarr, Radarr, Jackett, and YouTube Triage can copy their retained app data without the old Docker daemon. Each importer prints its pre-import backup or ZFS snapshot.
25
26`import-legacy-secrets.sh` reads the retained old `.env` from the new host when `STUDIO_LEGACY_HANDOFF` is set. It sends only the requested keys into Snow Globe's Nomad variables; it does not print their values. The handoff directory must exist on the target. Without that variable, the script continues reading from the old Zenith host for a two-host migration.
27
28The handoff contains no Forgejo repository files. [import-evil-forgejo.sh](import-evil-forgejo.sh) checks its `evil-forgejo.dump`, secret fingerprints, and the stopped Snow Globe job, then copies the old 14 GB app directory directly from the mounted dataset. The Forgejo job stays stopped until its files, database, and account identities have been checked together.
tools/local-ai-cache.md+5-5
......@@ -20,7 +20,7 @@ plugin versions, key, KV layout, and parallel configuration. Corrupt blocks
2020fall back to another copy or become misses. Key rotation invalidates reuse;
2121old entries remain encrypted and subject to eviction.
2222
23`config/site.pkl` owns the NVMe path (`/var/cache/studio/local-ai` by default).
23`config/site.pkl` owns the NVMe path (`/var/cache/snowglobe/local-ai` by default).
2424The prepare hook creates it with the assigned service owner. HDD blocks use
2525the managed service dataset. Fresh previews use separate managed directories
2626for both disk tiers.
......@@ -48,7 +48,7 @@ blocks totaling 1,912,086,528 bytes. Forced RAM/disk restore probes stopped
4848when the endpoint reported busy; end-to-end disk restore timing remains
4949unverified.
5050
51## Zenith measurements — 2026-10-09
51## Snow Globe measurements — 2026-10-09
5252
5353HyperQwen, vLLM 0.27.1, MTP with three draft tokens, 150,000-token
5454context, 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.
9898
9999```sh
100100ssh -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' \
102102 < tools/benchmark-local-ai-cache.py
103103ssh -o BatchMode=yes root@10.0.0.1 \
104 'python3 - filesystem /srv/staging --hostname zenith' \
104 'python3 - filesystem /srv/staging --hostname snowglobe' \
105105 < tools/benchmark-local-ai-cache.py
106106ssh -o BatchMode=yes root@10.0.0.1 \
107 'python3 - filesystem /var/tmp --hostname zenith' \
107 'python3 - filesystem /var/tmp --hostname snowglobe' \
108108 < tools/benchmark-local-ai-cache.py
109109```
110110
tools/local-vm.sh+3-3
......@@ -1,7 +1,7 @@
11#!/bin/sh
22set -eu
33
4cache=${STUDIO_VM_CACHE_DIR:-$HOME/Library/Caches/clover-studio-vm-x86}
4cache=${SNOWGLOBE_VM_CACHE_DIR:-$HOME/Library/Caches/clover-snowglobe-vm-x86}
55mode=${1:-}
66qemu=$(command -v qemu-system-x86_64 || true)
77if [ -z "$qemu" ]; then
......@@ -25,14 +25,14 @@ if [ "$mode" != installed ] && [ -f "$cache/nixos-minimal.iso" ]; then
2525 set -- -drive "file=$cache/nixos-minimal.iso,media=cdrom,readonly=on"
2626fi
2727if [ "$mode" = installed ]; then
28 media=${STUDIO_VM_MEDIA_SOURCE:-/Volumes/media}
28 media=${SNOWGLOBE_VM_MEDIA_SOURCE:-/Volumes/media}
2929 if ! mount | grep -F " on $media (" >/dev/null; then
3030 echo "Mount the media share at $media before starting the VM" >&2
3131 exit 1
3232 fi
3333 set -- "$@" -virtfs "local,path=$media,mount_tag=media,security_model=none,readonly=on"
3434fi
35if [ "${STUDIO_VM_HEADLESS:-0}" = 1 ]; then
35if [ "${SNOWGLOBE_VM_HEADLESS:-0}" = 1 ]; then
3636 set -- "$@" -display none -serial "file:$cache/serial.log" -daemonize -pidfile "$cache/qemu.pid"
3737else
3838 set -- "$@" -display cocoa -serial mon:stdio
tools/log-shipper.py+2-2
......@@ -9,13 +9,13 @@ import time
99from urllib.request import Request, urlopen
1010
1111
12STATE = Path("/var/lib/studio/log-shipper.json")
12STATE = Path("/var/lib/snowglobe/log-shipper.json")
1313LOGS = Path("/var/lib/nomad/alloc")
1414CRI = re.compile(r"^(\S+) (stdout|stderr) [FP] ?(.*)$")
1515
1616
1717def nomad(path):
18 token = Path("/var/lib/studio/nomad.token").read_text().strip()
18 token = Path("/var/lib/snowglobe/nomad.token").read_text().strip()
1919 with urlopen(Request("http://127.0.0.1:4646" + path, headers={"X-Nomad-Token": token}), timeout=10) as response:
2020 return json.load(response)
2121
tools/media-cutover.md deleted-222
......@@ -1,222 +0,0 @@
1# Media dataset cutover
2
3Before cutover, TrueNAS mounted `storage1/media` at `/mnt/storage1/media`. It is one 3.97 TiB ZFS filesystem containing `jellyfin`, `music`, `music_intake`, and `torrent`; `jellyfin` and `torrent` report the same filesystem device. The dataset had one snapshot with no clones at inspection. The VM reads it through a read-only mount at `/srv/clover/Media` without copying its contents.
4
5The Mac mounted the VM's `media` SMB share over Tailscale, listed the source folders, and received a write error for a test file. The `clover` share is writable in the VM; both shares use the same `clo` account.
6
7Zenith's NFSv4 ACLs need a separate [permission cutover](storage-acl-cutover.md) before this dataset is served by NixOS.
8
9The new layout needs that same dataset at `/srv/clover/Media`. A disposable VM test moved a ZFS filesystem beneath a different parent with `zfs rename`, changed its mountpoint, and confirmed that its snapshot, inode, and hardlinks survived. A second test renamed an independent encrypted root beneath another encrypted root; it remained its own encryption root. These test the ZFS operations, not the live Zenith cutover.
10
11Run the layout commands as root in the live installer, one step at a time. Stop on any error. The old writers and share services must be stopped; booting the installer leaves the old TrueNAS services stopped.
12
13### Reopen the inspected pool for writes
14
15The recovery inspection imported `storage1` read-only with an alternate root under `/run/infra2-inspection`. Export releases that import; it does not delete the pool. Reimport the verified data pool by its numeric ID, without an alternate root. `-N` leaves every dataset unmounted, `cachefile=none` avoids recording this temporary import, and `-f` permits the installer to take over the pool last used by TrueNAS. This ID identifies the four-disk data pool, not the NVMe's `boot-pool`.
16
17```sh
18zpool export storage1
19zpool import -N -f -d /dev/disk/by-id -o cachefile=none 8944904502819631621
20zpool get readonly,altroot storage1
21```
22
23The last command must show `readonly=off` and `altroot=-` before continuing. Leave `boot-pool` alone.
24
25### Record identity and take a snapshot
26
27Keep this shell open: `media_guid` records the dataset's identity for the check after renaming. The recursive snapshot captures all existing datasets' file state before cutover. It does not undo dataset names or mountpoint properties.
28
29```sh
30media_guid=$(zfs get -H -o value guid storage1/media)
31zfs snapshot -r storage1@before-infra2-layout
32```
33
34### Rename the pool to globe
35
36The top-level dataset has the pool's name. Rename it by exporting and importing the pool with a new name, not with `zfs rename`. These commands also work midway through the mountpoint changes below, provided the datasets remain unmounted.
37
38```sh
39zpool export storage1
40zpool import -N -d /dev/disk/by-id -o cachefile=none 8944904502819631621 globe
41zpool get guid,readonly,altroot globe
42zfs list -r -o name,mountpoint,mounted globe
43```
44
45Expect the same pool GUID `8944904502819631621`, `readonly=off`, and `altroot=-`. Every dataset and snapshot prefix becomes `globe/`; their GUIDs, encryption keys, and snapshots are retained. The explicit `/srv` mountpoint and pinned `/mnt/storage1/apps` path remain unchanged. The production configuration uses `globe` for imports and service startup checks. See [OpenZFS pool import](https://openzfs.github.io/openzfs-docs/man/master/8/zpool-import.8.html).
46
47From here onward, use `globe` in ZFS arguments. Keep `/mnt/storage1/apps` as a filesystem path: the legacy importers still read it there. Existing recovery exports label their keys with the original `storage1/...` names; those same keys now unlock the corresponding `globe/...` datasets.
48
49### Set the layout
50
51`mountpoint` controls where a dataset appears in the filesystem. `rename` changes its name and parent in the ZFS hierarchy. The `-u` flags update metadata without mounting datasets. Encrypted datasets can be renamed while locked; these commands do not change their keys or copy their file contents. See [OpenZFS rename](https://openzfs.github.io/openzfs-docs/man/master/8/zfs-rename.8.html) and [mountpoint properties](https://openzfs.github.io/openzfs-docs/man/master/7/zfsprops.7.html).
52
53| Command | Effect |
54| --- | --- |
55| `zfs set -u mountpoint=/mnt/storage1/apps globe/apps` | Pin the retained app tree at the path used by the legacy importers, before moving the pool root. |
56| `zfs set -u mountpoint=/srv globe` | Move the pool's root mountpoint; default-mountpoint children such as backups, logs, and mirrors follow it. |
57| `zfs set -u mountpoint=/srv/clover globe/clover` | Set Clover's mount location. Its dataset name stays `globe/clover`. |
58| `zfs rename -u globe/media globe/clover/Media` | Move the existing Media dataset beneath Clover and capitalize its name. Its snapshots stay attached to the same dataset. |
59| `zfs set -u mountpoint=/srv/clover/Media globe/clover/Media` | Set Media's mount location. It remains an independent encryption root with its original key. |
60
61The destination dataset must not already exist, and the `Media` directory inside Clover must be absent or empty before mounting there. The live inspection checked both on 2026-10-04: the dataset and directory were absent.
62
63### Verify before mounting
64
65```sh
66test "$(zfs get -H -o value guid globe/clover/Media)" = "$media_guid"
67zfs list -o name,mountpoint,mounted globe globe/apps globe/clover globe/clover/Media
68zfs get encryptionroot globe/apps globe/clover globe/clover/Media
69zfs list -t snapshot -r -o name globe/clover/Media
70```
71
72The identity check must succeed. Expect these mountpoint properties, with `mounted=no` throughout:
73
74```text
75globe /srv
76globe/apps /mnt/storage1/apps
77globe/clover /srv/clover
78globe/clover/Media /srv/clover/Media
79```
80
81Media's `encryptionroot` must be `globe/clover/Media`, not `globe/clover`; apps and Clover must remain their own encryption roots. Media's original snapshots should now use its new dataset prefix, alongside `@before-infra2-layout`. Loading keys and mounting the filesystems follow this metadata check; permission conversion is covered in [storage-acl-cutover.md](storage-acl-cutover.md). Preserve the old NVMe until the PostgreSQL handoff in [legacy-handoff.md](legacy-handoff.md) is verified.
82
83A disposable pool with an altroot reproduced the default child's move when the parent mountpoint changed, then kept the old child path after an explicit mountpoint was set. After loading keys and mounting, Clover and Media must resolve to distinct ZFS filesystems before starting Snow Globe; `tools/studio.py pool` enforces this. Check a known hardlinked download/library pair by device and inode, then verify Jellyfin and Navidrome library paths inside their containers.
84
85The root change also relocates other default-mountpoint children: `backup` (including the 2.07 TB `backup/sandwich`), `mirrors` (266 GB), `agent`, `homes`, `logs`, and `.ix-virt`. They remain datasets under `/srv` until deliberately renamed; the move does not copy their data. `ix-apps` has a local `/mnt/.ix-apps` mountpoint and `.system` uses `legacy`, so neither follows the root. Preserve these datasets during cutover.
86
87### Remove retired app clones and the rehearsal store
88
89The five `apps-hourly-…-clone` entries are cloned filesystems, distinct from the original `globe/apps@hourly-…` snapshots. The rehearsal store is `globe/apps/snowglobe-rehearsal-20261002` (59.8 GiB at inspection). The live installer inspection on 2026-10-04 confirmed that all six are unmounted, and `zfs destroy -nvr` previews succeeded: each would delete only the named filesystem and its own `@before-infra2-layout` snapshot.
90
91These commands permanently remove those six retired filesystems and their snapshots. They preserve `globe/apps`, its original hourly snapshots, and the other datasets' cutover snapshots. Run one command at a time and stop on an error. To preview a command again, replace `-vr` with `-nvr`; lowercase `-r` includes the target's children and snapshots. Do not use uppercase `-R`, which also destroys dependent clones outside the target hierarchy. See [OpenZFS destroy](https://openzfs.github.io/openzfs-docs/man/master/8/zfs-destroy.8.html).
92
93```sh
94zfs destroy -vr globe/apps-hourly-2026-09-06_21-00-clone
95zfs destroy -vr globe/apps-hourly-2026-09-08_23-00-clone
96zfs destroy -vr globe/apps-hourly-2026-09-11_07-00-clone
97zfs destroy -vr globe/apps-hourly-2026-09-11_12-00-clone
98zfs destroy -vr globe/apps-hourly-2026-09-12_14-00-clone
99zfs destroy -vr globe/apps/snowglobe-rehearsal-20261002
100```
101
102Check the remaining app datasets and source snapshots afterward:
103
104```sh
105zfs list -r -o name,used,mountpoint globe/apps
106zfs list -t snapshot -d 1 -o name globe/apps
107```
108
109### Unlock and mount Clover and Media
110
111Clover and Media are independent encryption roots, so each needs its original key. The recovery export labels these `storage1/clover` and `storage1/media`, respectively. For the installer commands below, the recovered keys must be available as `/run/infra2-keys/clover.hex` and `/run/infra2-keys/media.hex`, with directory mode `0700` and file mode `0600`, owned by root. These temporary files disappear at reboot; recover them from the private archive again if needed. Keep keys out of this repository and terminal output.
112
113Run one command at a time and stop on errors. Mount the pool root if needed, then verify that `/srv` is its actual mountpoint:
114
115```sh
116if [ "$(zfs get -H -o value mounted globe)" = no ]; then zfs mount globe; fi
117test "$(findmnt -n -o SOURCE --mountpoint /srv)" = globe
118```
119
120Load the two keys, mount Clover before its Media child, then remove the temporary key files after both mounts succeed. `-L` overrides the key source for this command without changing the datasets' persistent `keylocation=prompt`. Loading keys alone does not mount them; see [OpenZFS load-key](https://openzfs.github.io/openzfs-docs/man/master/8/zfs-load-key.8.html). Use ordinary [ZFS mounts](https://openzfs.github.io/openzfs-docs/man/master/8/zfs-mount.8.html), without overlay options; stop if the Media mountpoint is nonempty.
121
122```sh
123zfs load-key -L file:///run/infra2-keys/clover.hex globe/clover
124zfs load-key -L file:///run/infra2-keys/media.hex globe/clover/Media
125zfs mount globe/clover
126zfs mount globe/clover/Media
127rm /run/infra2-keys/clover.hex /run/infra2-keys/media.hex
128test "$(findmnt -n -o SOURCE --mountpoint /srv/clover)" = globe/clover
129test "$(findmnt -n -o SOURCE --mountpoint /srv/clover/Media)" = globe/clover/Media
130findmnt -rn -o SOURCE,TARGET,FSTYPE --mountpoint /srv/clover/Media
131```
132
133The last command must show `globe/clover/Media /srv/clover/Media zfs`. This mounts only Clover and Media beneath the pool root. Continue to the folder renames below after these checks succeed. Root can perform these renames; service access still requires the separate ACL cutover.
134
135### Unlock retained apps for the legacy handoff
136
137The original apps key is labeled `storage1/apps` in the recovery export. Prepare it as `/run/infra2-keys/apps.hex` with the same root-only permissions as the Clover and Media keys. Unlock and mount the retained dataset at its pinned legacy path:
138
139```sh
140zfs load-key -L file:///run/infra2-keys/apps.hex globe/apps
141zfs mount globe/apps
142rm /run/infra2-keys/apps.hex
143test "$(findmnt -n -o SOURCE --mountpoint /mnt/storage1/apps)" = globe/apps
144findmnt -rn -o SOURCE,TARGET,FSTYPE --mountpoint /mnt/storage1/apps
145```
146
147Expect `globe/apps /mnt/storage1/apps zfs`. Keep this path intact for the [legacy handoff](legacy-handoff.md); mounting the dataset does not start the old apps.
148
149### Keys after installation
150
151The recovery keys remain in the private recovery archive on the Mac. The `/run/infra2-keys` files above are temporary transfer copies; after `load-key`, ZFS holds the loaded key material in memory, so deleting those files does not relock mounted datasets. Reboot loses the loaded keys. The datasets retain `keylocation=prompt` for manual recovery; the installed target loads TPM-encrypted credentials before mounting them. Nomad's mount checks prevent it from starting against locked data.
152
153Zenith's enabled TPM 2.0 (`/dev/tpm0` and `/dev/tpmrm0`) sealed and decrypted all six encryption-root keys during installation preparation on 2026-10-04. A systemd service test successfully loaded the encrypted credentials and unlocked the previously locked logs dataset. [zenith-hardware.md](zenith-hardware.md) records their recovery locations and the installed boot service; the root names and credential paths have one home in [zenith.nix](../nixos/zenith.nix).
154
155[TPM-encrypted systemd credentials](https://github.com/systemd/systemd/blob/main/man/systemd-creds.xml) keep encrypted key blobs on the NVMe and supply decrypted credentials in RAM. These credentials bind to the original TPM and PCR 7. Secure Boot is disabled, so this supplies convenient automatic unlock and protection for detached drives, without establishing a trusted boot chain. Firmware changes affecting PCR 7 or a TPM reset can require resealing the credentials from the recovery keys.
156
157Manual unlock over root SSH remains the recovery path: recover the relevant key to a private `/run` file, use `zfs load-key -L file:///run/<key-file> <dataset>`, remove that file, then mount the dataset. Keep the off-server keys when replacing hardware; encrypted blobs from the old TPM cannot unlock on a replacement machine.
158
159### Rename the media folders
160
161Clover and Media both report `casesensitivity=insensitive` on the live pool. Names differing only by capitalization resolve to the same entry. For a case-only folder rename, use an unused temporary name; ordinary `mv music Music` interprets the existing destination directory as a request to move `music` inside itself. From the Media directory:
162
163```sh
164test ! -e .music-case-rename && test ! -L .music-case-rename &&
165mv -T -- music .music-case-rename &&
166mv -T -- .music-case-rename Music
167```
168
169Lowercase configured paths still resolve after a case-only rename; do not create a separate `music -> Music` or `seedbox -> Seedbox` alias, because those names collide on this filesystem. The distinct `torrent` alias below preserves the old host path. qBittorrent also receives a container mount at `/data/media/torrent` pointing to `Seedbox`, so its saved torrent paths remain valid.
170
171Zenith's qBittorrent `BT_backup` is 21 MB. A checksum-verified copy contained 544 complete bencoded resume files. Their `save_path` values include 498 at `/data/media/torrent`, three in its subfolders, and 43 in Jellyfin folders; 543 also set `qBt-downloadPath` to `/data/media/torrent`. Keep these saved paths working by renaming the real media folder and leaving a relative compatibility symlink, after the media dataset is mounted at its new path and the old writers are stopped:
172
173```sh
174test -d /srv/clover/Media/torrent
175test ! -e /srv/clover/Media/Seedbox
176mv /srv/clover/Media/torrent /srv/clover/Media/Seedbox
177ln -s Seedbox /srv/clover/Media/torrent
178test "$(stat -c %d:%i /srv/clover/Media/Seedbox)" = "$(stat -Lc %d:%i /srv/clover/Media/torrent)"
179```
180
181The same-dataset rename preserves existing hardlinks. New downloads use `/data/media/Seedbox`; saved torrents continue to resolve through `/data/media/torrent`. If `Seedbox` and the `torrent` alias already exist, skip the rename and verify their device/inode identity. Rename the existing music intake folder after stopping YouTube Triage, then keep its current container path working through a relative symlink:
182
183```sh
184test -d /srv/clover/Media/music_intake
185test ! -e '/srv/clover/Media/Intake - Music'
186mv /srv/clover/Media/music_intake '/srv/clover/Media/Intake - Music'
187ln -s 'Intake - Music' /srv/clover/Media/music_intake
188```
189
190### Service paths for the reorganized tree
191
192The service definitions read the current capitalized host folders. Jellyfin and qBittorrent retain their saved paths inside the containers through individual bind mounts; the host needs no `jellyfin` compatibility directory. The shared folder mapping is defined once in [config/site.pkl](../config/site.pkl), under `jellyfinFolders`. Jellyfin mounts its entries beneath `/media/jellyfin`; qBittorrent mounts them beneath `/data/media/jellyfin` and mounts `Seedbox` at both `/data/media/Seedbox` and `/data/media/torrent`.
193
194Navidrome mounts `Music` at `/music`. Jellyfin and Navidrome mounts remain read-only; qBittorrent follows `site.mediaReadOnly`, so read-only rehearsals stay read-only. Keeping the recorded Jellyfin paths follows its [migration guidance](https://jellyfin.org/docs/general/administration/migrate/) and avoids rewriting its database paths or library settings.
195
196Before reorganization, YouTube Archiver kept its download archive JSON beside the videos in `Media/jellyfin/Independent`, not in its `/config` cache ([upstream archive behavior](https://github.com/jmbannon/ytdl-sub/wiki/5.-Optimizing-Your-First-Config)). The source inspection found 12 archive files there (52,345 bytes), and all 12 were visible through the VM's read-only media mount. That folder now lives at `Media/Videos/Independent`; preserve its archive files with the videos. The old app directory contained only a lock, cache, and empty work directory.
197
198The complete 33 MB qBittorrent config was also copied into a disposable ZFS clone in the VM. The pinned container started with `--network none` and no media mount; its API loaded all 544 torrents. All reported `missingFiles`, as expected without `/data/media`. One resume file without `qBt-savePath` adopted the new default `/data/media/seedbox`; the other 543 retained their saved paths. The container, clone, and copied config were removed after the test.
199
200A second disposable restore copied Zenith's qBittorrent profile into the VM and mounted the real read-only media through a temporary `/data/media/seedbox` alias, with `torrent -> seedbox` alongside it. The container ran as UID 3000 with no network and a read-only root filesystem. Its API loaded all 544 torrents; after resume checks, all 544 reported 100% progress, with 539 `queuedUP`, three `stalledUP`, two `forcedUP`, and none `missingFiles`. The container resolved the legacy symlink, and its temporary profile was removed. This tests the saved paths and source files through the VM mount; the actual Zenith folder has not yet been renamed.
201
202The old resume files are owned by UID 3000, while Snow Globe assigns qBittorrent UID 3114. [import-qbittorrent.sh](import-qbittorrent.sh) copies the stopped old profile into the stopped Snow Globe service's dataset, snapshots the destination, checks the copy, changes ownership, applies the new save path, and starts the service. It refuses to run while Zenith's qBittorrent is active. In a disposable VM restore, UID 3114 loaded all 544 imported torrents without a media mount; all correctly reported `missingFiles`. With the same read-only media alias and legacy symlink as above, all 544 reached 100% progress and none remained `missingFiles`.
203
204The production importer requires the real Media ZFS mount and a `torrent` symlink resolving to the same directory as `Seedbox` before it starts qBittorrent. It compares device/inode identity, so `torrent -> Seedbox/` is accepted. For a same-machine OS replacement, set `STUDIO_LEGACY_HANDOFF` to the [offline handoff](legacy-handoff.md) directory; the profile copy then reads the retained old apps dataset without old Docker.
205
206The PIA credentials are the two lines in `~/pia.txt` on the Mac (username, then password). With `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT` set for production, import them through `python3 tools/deploy.py secrets qbittorrent --file ~/pia.txt --key vpn_user --key vpn_pass` before deploying qBittorrent. The CLI requires a private file, sends its contents to the target over SSH, and does not print the values.
207
208At the 2026-09-26 check, Zenith's Sonarr and Radarr databases each had an enabled qBittorrent client and enabled RSS indexers; the VM's production and preview copies had both disabled. The preview setup disables every indexer's RSS and automatic search, including Sonarr's built-in EZTV indexer, while leaving the source untouched. A production [ARR import](import-arr.sh) now requires the corresponding Zenith container to be stopped before copying its database, and checks it remains stopped when the copy finishes. Reenable downloads only after the media dataset is writable at the final mountpoint and qBittorrent's imported profile is serving the same paths.
209
210After a same-machine OS replacement, `STUDIO_LEGACY_HANDOFF` makes the Sonarr and Radarr importer read their stopped databases and app files from the mounted old apps dataset on the new host. A read-only SQLite backup and integrity check passed for each old database.
211
212The VM runs Sonarr `4.0.20.3014` and Radarr `6.4.4.10685`. [Sonarr v4's External mode](https://wiki.servarr.com/sonarr/settings) delegates authentication to a reverse proxy, and [Radarr's current FAQ](https://wiki.servarr.com/radarr/faq) says native OIDC is unsupported. Sonarr's [v5 development settings](https://github.com/Sonarr/Sonarr/blob/v5-develop/src/Sonarr.Api.V5/Settings/GeneralSettingsResource.cs) contain OIDC fields; the latest stable [Sonarr release](https://github.com/Sonarr/Sonarr/releases) remains v4 at this check. Both pinned services use Caddy Forward Auth with External mode. Unauthenticated UI and API requests redirected to sign-in, and forged identity headers sent from the Mac still received HTTP 302 over trusted TLS. Nomad advertised their application ports only on `127.0.0.1`.
213
214[import-jackett.sh](import-jackett.sh) makes the Jackett dependency repeatable: previews copy the latest read-only Zenith app snapshot; production import requires both old and new Jackett stopped. The restored preview kept the same API key as Zenith and the VM's production Jackett, preserved all three indexer definitions, and served `t=caps` for Nyaa and Pirate Bay with HTTP 200. The imported Sonarr and Radarr Jackett indexers use that same key and point to the current Nomad Jackett endpoint.
215
216With `STUDIO_LEGACY_HANDOFF` set, production Jackett import reads its retained config from the new host's mounted old apps dataset after reboot; it no longer needs the old Docker host.
217
218Sonarr and Radarr persist their Jackett and qBittorrent endpoints in their databases, so those two internal ports are static (`30017` and `30038`) across allocation changes. On the VM, both apps' saved Jackett URLs matched the current reserved port. Their public HTTPS routes still use separate Caddy endpoints and forward auth.
219
220[import-navidrome.sh](import-navidrome.sh) restores the old `navidrone` app directory into Navidrome's managed dataset. The preview imported Zenith's `storage1/apps@hourly-2026-09-26_02-00` snapshot, migrated the database under the pinned image, and passed SQLite integrity and HTTP health checks. Its three users, 10,945 media files, 1,046 albums, and 2,655 artists matched the source snapshot; `snow` remained an administrator. A `Remote-User: snow` request to the production Navidrome API returned the existing `snow` user, proving that its external-auth setting accepts the proxy's header. The preview's database is retained, but its job is stopped while the Jackett preview uses the VM's limited memory. Production import requires both Navidrome jobs stopped and the real Media dataset mounted as ZFS.
221
222For a same-machine OS replacement, set `STUDIO_LEGACY_HANDOFF` to the [offline handoff](legacy-handoff.md) directory when importing production Jellyfin or Navidrome. Both importers read their retained app data directly from the mounted old apps dataset on the new host; the Media library stays on its ZFS dataset.
tools/namespace-transition-test.py created+338
......@@ -0,0 +1,338 @@
1#!/usr/bin/env python3
2from importlib import import_module
3import io
4import json
5import os
6from pathlib import Path
7import shutil
8import subprocess
9import sys
10import tempfile
11from types import SimpleNamespace
12import unittest
13from unittest.mock import patch
14import xml.etree.ElementTree as ET
15
16import release
17import snowglobe
18
19
20transition = import_module("namespace-transition")
21
22
23class NamespaceTransition(unittest.TestCase):
24 def setUp(self):
25 temporary = tempfile.TemporaryDirectory()
26 self.addCleanup(temporary.cleanup)
27 self.root = Path(temporary.name).resolve()
28 self.directories = tuple((self.root / parent / "snowglobe", self.root / parent / transition.PREVIOUS)
29 for parent in ("opt", "state", "assets", "cache"))
30 self.addCleanup(patch.stopall)
31 patch.object(transition, "DIRECTORIES", self.directories).start()
32 registry = self.root / "nixos"
33 registry.mkdir()
34 patch.object(transition, "NIXOS_STATE", registry).start()
35 patch.object(transition.pwd, "getpwnam", side_effect=KeyError).start()
36 patch.object(transition.grp, "getgrnam", side_effect=KeyError).start()
37
38 def test_staging_aliases_share_existing_state_and_never_seed_another_registry(self):
39 for _, old in self.directories:
40 old.mkdir(parents=True)
41 new, old = self.directories[1]
42 (old / "identities.json").write_text('{"knife":3132}')
43 transition.prepare()
44 transition.prepare()
45 self.assertTrue(new.is_symlink())
46 self.assertEqual(new.resolve(), old)
47 (new / "identities.json").write_text('{"knife":3132,"dashboard":3133}')
48 self.assertEqual(json.loads((old / "identities.json").read_text()), {"knife": 3132, "dashboard": 3133})
49 self.assertTrue(all(new.resolve() == old for new, old in self.directories))
50
51 def test_staging_bootstrap_starts_the_installed_router_generation_without_restart(self):
52 state = self.root / "bootstrap"
53 state.mkdir()
54 for name in ("nomad", "router", "dashboard"):
55 (state / (name + ".token")).write_text("disposable-" + name)
56 original = transition.layout
57 source = self.root / "installed"
58 (source / "tools").mkdir(parents=True)
59 (source / "tools" / (transition.PREVIOUS + ".py")).touch()
60 with patch.object(snowglobe, "STATE", state), patch.object(snowglobe, "token"), patch.object(
61 snowglobe.os, "geteuid", return_value=0,
62 ), patch.object(Path, "is_symlink", return_value=True), patch.object(
63 transition, "layout", return_value=original(source),
64 ), patch.object(snowglobe, "command", return_value=subprocess.CompletedProcess([], 0)) as command:
65 snowglobe.bootstrap([])
66 units = [call.args for call in command.call_args_list if call.args[0] == "systemctl"]
67 self.assertEqual(units, [("systemctl", "start", transition.PREVIOUS + "-router.service")])
68
69 def test_split_state_is_rejected_before_any_alias_is_created(self):
70 self.directories[0][1].mkdir(parents=True)
71 new, old = self.directories[1]
72 new.mkdir(parents=True)
73 old.mkdir()
74 with self.assertRaisesRegex(ValueError, "independent control stores"):
75 transition.prepare()
76 self.assertFalse(self.directories[0][0].exists())
77
78 def test_promotion_preserves_whole_stores_and_release_links_then_is_idempotent(self):
79 revision = "1" * 16
80 for _, old in self.directories:
81 old.mkdir(parents=True)
82 (old / "durable").write_text("existing bytes")
83 (old / "durable").chmod(0o600)
84 new_root, old_root = self.directories[0]
85 (old_root / "releases" / revision).mkdir(parents=True)
86 for name in ("current", "main"):
87 (old_root / name).symlink_to(old_root / "releases" / revision)
88 before = [(old / "durable").stat().st_ino for _, old in self.directories]
89 with patch.object(transition.subprocess, "run", return_value=subprocess.CompletedProcess([], 0)) as run, patch.object(
90 transition, "migrate_policies",
91 ) as policies:
92 transition.promote(self.root)
93 policies.assert_called_once_with(self.root, self.directories[1][0])
94 self.assertEqual(run.call_count, 6)
95 transition.promote(self.root)
96 self.assertEqual(run.call_count, 6)
97 for index, (new, old) in enumerate(self.directories):
98 self.assertFalse(new.is_symlink())
99 self.assertTrue(old.is_symlink())
100 self.assertEqual((new / "durable").stat().st_ino, before[index])
101 self.assertEqual((new / "durable").stat().st_mode & 0o777, 0o600)
102 for name in ("current", "main"):
103 self.assertEqual(os.readlink(new_root / name), str(new_root / "releases" / revision))
104
105 def test_old_release_manifest_and_canonical_alias_validate_without_rewriting_the_tree(self):
106 new_root, old_root = self.directories[0]
107 revision = "a" * 16
108 source = old_root / "releases" / revision
109 (source / "tools").mkdir(parents=True)
110 (source / "tools" / (transition.PREVIOUS + ".py")).write_text("immutable")
111 manifest = source / ("." + transition.PREVIOUS + "-release.json")
112 manifest.write_text(json.dumps({"id": revision, "digest": release.tree_digest(source), "version": 2}))
113 original = manifest.read_bytes()
114 (old_root / "current").symlink_to(source)
115 transition.prepare()
116 with patch.object(release, "ROOT", new_root), patch.object(release, "RELEASES", new_root / "releases"):
117 self.assertEqual(release.current_release(), revision)
118 self.assertEqual(release.check_release(revision).resolve(), source)
119 self.assertEqual(manifest.read_bytes(), original)
120
121 def test_old_release_activation_uses_its_units_script_and_environment(self):
122 revision = "b" * 16
123 source = self.root / "release"
124 (source / "tools").mkdir(parents=True)
125 (source / "tools" / (transition.PREVIOUS + ".py")).touch()
126 (source / "nixos").mkdir()
127 (source / "nixos/dashboard.nix").touch()
128 transition.layout(source)["manifest"].write_text('{"version":2}')
129 observed = []
130
131 def run(argv, **kwargs):
132 observed.append((argv, kwargs))
133 return subprocess.CompletedProcess(argv, 0, '"leader"')
134
135 with patch.dict(os.environ, {"SNOWGLOBE_POOL": "globe"}), patch.object(release, "ROOT", self.root), patch.object(
136 release, "STATE", self.root,
137 ), patch.object(release, "check_release", return_value=source), patch.object(
138 release, "current_release", return_value=None,
139 ), patch.object(release, "host_digest", return_value="different"), patch.object(
140 release, "host_configuration", return_value=transition.NAMESPACE["previousHost"],
141 ), patch.object(release, "jobs", return_value=set()), patch.object(
142 release.os, "uname", return_value=SimpleNamespace(nodename="snowglobe"),
143 ), patch.object(release.subprocess, "run", side_effect=run), patch.object(transition, "activate") as activate:
144 release.activate(revision, initial=True)
145 activate.assert_called_once_with(source)
146 scripts = [(argv, kwargs) for argv, kwargs in observed if argv[0] == "python3"]
147 self.assertEqual([argv[-1] for argv, _ in scripts], ["preflight", "pool", "deploy", "check"])
148 self.assertTrue(all(argv[1].endswith("/" + transition.PREVIOUS + ".py") for argv, _ in scripts))
149 self.assertTrue(all(kwargs["env"][transition.PREVIOUS.upper() + "_POOL"] == "globe" for _, kwargs in scripts))
150 self.assertIn(["systemctl", "restart", transition.PREVIOUS + "-router.service"], [argv for argv, _ in observed])
151
152 def test_policy_attachment_changes_after_new_policy_exists_without_changing_token_files(self):
153 state = self.root / "state"
154 state.mkdir()
155 for name in ("nomad", "router", "dashboard"):
156 (state / (name + ".token")).write_text("disposable-" + name)
157 responses = [io.BytesIO(json.dumps({"Name": transition.PREVIOUS + "-" + consumer,
158 "AccessorID": consumer, "Policies": [transition.PREVIOUS + "-" + consumer, "other"]}).encode())
159 for consumer in ("router", "dashboard")]
160 with patch.object(transition.urllib.request, "urlopen", side_effect=responses), patch.object(
161 transition.subprocess, "run", return_value=subprocess.CompletedProcess([], 0),
162 ) as run:
163 transition.migrate_policies(self.root, state)
164 commands = [call.args[0] for call in run.call_args_list]
165 for index, consumer in enumerate(("router", "dashboard")):
166 self.assertEqual(commands[index * 2][:5], ["nomad", "acl", "policy", "apply", "snowglobe-" + consumer])
167 self.assertIn("-policy=snowglobe-" + consumer, commands[index * 2 + 1])
168 self.assertIn("-policy=other", commands[index * 2 + 1])
169 self.assertFalse(any("disposable" in argument for argument in commands[index * 2 + 1]))
170 self.assertEqual((state / (consumer + ".token")).read_text(), "disposable-" + consumer)
171
172 def test_existing_vm_owner_profile_and_seed_still_resolve(self):
173 old = "https://paperclover.net/" + transition.PREVIOUS
174 root = ET.fromstring(f'<domain><metadata><vm xmlns="{old}"><owner>owner-id</owner><hardwareProfile>windows-q35-secure</hardwareProfile></vm></metadata><devices><disk><serial>{transition.PREVIOUS}-cloud-init</serial></disk></devices></domain>')
175 transition.normalize_vm(root)
176 namespace = "{https://paperclover.net/snowglobe}"
177 self.assertEqual(root.findtext(f"metadata/{namespace}vm/{namespace}owner"), "owner-id")
178 self.assertEqual(root.findtext(f"metadata/{namespace}vm/{namespace}hardwareProfile"), "windows-q35-secure")
179 self.assertEqual(root.findtext("devices/disk/serial"), "snowglobe-cloud-init")
180
181 def test_account_and_nixos_registries_round_trip_with_fixed_numeric_ownership(self):
182 old, new = transition.PREVIOUS + "-dashboard", "snowglobe-dashboard"
183 users = {old: SimpleNamespace(pw_uid=997, pw_gid=994)}
184 groups = {old: SimpleNamespace(gr_gid=994)}
185 registry = transition.NIXOS_STATE
186 (registry / "uid-map").write_text(json.dumps({old: 997, "other": 888}))
187 (registry / "gid-map").write_text(json.dumps({old: 994}))
188 for name in ("declarative-users", "declarative-groups"):
189 (registry / name).write_text("root " + old + "\n")
190
191 def lookup(values, name):
192 if name not in values:
193 raise KeyError(name)
194 return values[name]
195
196 calls = []
197
198 def command(argv, **kwargs):
199 calls.append(argv)
200 if argv[0] == "groupmod":
201 groups[argv[2]] = groups.pop(argv[3])
202 if argv[0] == "usermod":
203 users[argv[2]] = users.pop(argv[3])
204 return subprocess.CompletedProcess(argv, 0)
205
206 for _, directory in self.directories:
207 directory.mkdir(parents=True)
208 release_path = self.directories[0][1] / "releases" / ("c" * 16)
209 (release_path / "tools").mkdir(parents=True)
210 (release_path / "tools/snowglobe.py").touch()
211 transition.prepare()
212 canonical_release = self.directories[0][0] / "releases" / release_path.name
213 with patch.object(transition, "NIXOS_STATE", registry), patch.object(
214 transition.pwd, "getpwnam", side_effect=lambda name: lookup(users, name),
215 ), patch.object(transition.grp, "getgrnam", side_effect=lambda name: lookup(groups, name)), patch.object(
216 transition.subprocess, "run", side_effect=command,
217 ), patch.object(transition, "migrate_policies"):
218 transition.activate(canonical_release)
219 self.assertEqual(set(users), {new})
220 self.assertEqual((users[new].pw_uid, users[new].pw_gid, groups[new].gr_gid), (997, 994, 994))
221 self.assertEqual(json.loads((registry / "uid-map").read_text()), {new: 997, "other": 888})
222 self.assertEqual((registry / "declarative-users").read_text().split(), ["root", new])
223 previous_release = self.directories[0][0] / "releases" / ("d" * 16)
224 (previous_release / "tools").mkdir(parents=True)
225 (previous_release / "tools" / (transition.PREVIOUS + ".py")).touch()
226 transition.activate(previous_release)
227 self.assertEqual(set(users), {old})
228 self.assertEqual((users[old].pw_uid, users[old].pw_gid, groups[old].gr_gid), (997, 994, 994))
229 self.assertEqual(json.loads((registry / "uid-map").read_text()), {old: 997, "other": 888})
230 self.assertEqual((registry / "declarative-users").read_text().split(), ["root", old])
231 self.assertEqual(calls[0], ["systemctl", "stop", old])
232 self.assertEqual(calls[8], ["systemctl", "stop", new])
233
234 def test_policy_failure_after_directory_move_is_retried_without_moving_state_again(self):
235 for _, old in self.directories:
236 old.mkdir(parents=True)
237 with patch.object(transition.subprocess, "run", return_value=subprocess.CompletedProcess([], 0)) as run, patch.object(
238 transition, "migrate_policies", side_effect=[RuntimeError("interrupted ACL update"), None],
239 ) as policies:
240 with self.assertRaisesRegex(RuntimeError, "ACL update"):
241 transition.promote(self.root)
242 before = [new.stat().st_ino for new, _ in self.directories]
243 transition.promote(self.root)
244 self.assertEqual(policies.call_count, 2)
245 self.assertEqual(run.call_count, 6)
246 self.assertEqual(before, [new.stat().st_ino for new, _ in self.directories])
247
248 def test_only_legacy_transition_stops_the_retired_window_proxy(self):
249 with patch.object(transition.subprocess, "run", return_value=subprocess.CompletedProcess([], 0)) as run:
250 transition.stop_units(transition.PREVIOUS)
251 previous = [call.args[0] for call in run.call_args_list]
252 run.reset_mock()
253 transition.stop_units("snowglobe")
254 canonical = [call.args[0] for call in run.call_args_list]
255 self.assertIn(["systemctl", "stop", transition.PREVIOUS + "-vm-window-host-proxy"], previous)
256 self.assertFalse(any("vm-window-host-proxy" in command[-1] for command in canonical))
257 self.assertTrue(all(command[:2] == ["systemctl", "stop"] for command in previous + canonical))
258
259 def test_missing_reverse_alias_after_directory_move_is_recovered_from_old_releases(self):
260 new, old = self.directories[0]
261 source = new / "releases" / ("e" * 16) / "tools"
262 source.mkdir(parents=True)
263 (source / (transition.PREVIOUS + ".py")).touch()
264 transition.prepare()
265 self.assertTrue(old.is_symlink())
266 self.assertEqual(old.resolve(), new)
267
268 @unittest.skipUnless(sys.platform == "linux" and os.geteuid() == 0 and shutil.which("usermod") and shutil.which("groupmod"),
269 "requires Linux root and shadow tools; all account files stay inside a temporary prefix")
270 def test_real_shadow_tools_and_interrupted_registry_update_resume_with_only_fixture_accounts(self):
271 old, new = transition.PREVIOUS + "-dashboard", "snowglobe-dashboard"
272 prefix = self.root / "accounts"
273 etc = prefix / "etc"
274 etc.mkdir(parents=True)
275 (etc / "passwd").write_text(f"{old}:x:997:994:fixture:/var/empty:/bin/false\n")
276 (etc / "group").write_text(f"{old}:x:994:\n")
277 (etc / "shadow").write_text(f"{old}:!:1:0:99999:7:::\n")
278 (etc / "gshadow").write_text(f"{old}:!::\n")
279 for name in ("shadow", "gshadow"):
280 (etc / name).chmod(0o600)
281 (etc / "login.defs").write_text("")
282 registry = transition.NIXOS_STATE
283 for name, value in (("uid-map", 997), ("gid-map", 994)):
284 (registry / name).write_text(json.dumps({old: value}))
285 for name in ("declarative-users", "declarative-groups"):
286 (registry / name).write_text(old + "\n")
287 command = subprocess.run
288 replace = Path.replace
289 fail_login = True
290 fail_registry = True
291
292 def run(argv, **kwargs):
293 nonlocal fail_login
294 self.assertIn(argv[0], {"usermod", "groupmod"})
295 if argv[0] == "usermod" and fail_login:
296 fail_login = False
297 raise subprocess.CalledProcessError(1, argv)
298 return command([argv[0], "--prefix", str(prefix), *argv[1:]], **kwargs)
299
300 def atomic_replace(path, target):
301 nonlocal fail_registry
302 if Path(target) == registry / "gid-map" and fail_registry:
303 fail_registry = False
304 raise OSError("interrupted registry write")
305 return replace(path, target)
306
307 def user(name):
308 fields = (etc / "passwd").read_text().splitlines()[0].split(":")
309 if fields[0] != name:
310 raise KeyError(name)
311 return SimpleNamespace(pw_uid=int(fields[2]), pw_gid=int(fields[3]))
312
313 def group(name):
314 fields = (etc / "group").read_text().splitlines()[0].split(":")
315 if fields[0] != name:
316 raise KeyError(name)
317 return SimpleNamespace(gr_gid=int(fields[2]))
318
319 with patch.object(transition.pwd, "getpwnam", side_effect=user), patch.object(
320 transition.grp, "getgrnam", side_effect=group,
321 ), patch.object(transition.subprocess, "run", side_effect=run), patch.object(Path, "replace", atomic_replace):
322 with self.assertRaises(subprocess.CalledProcessError):
323 transition.rename_identity(transition.identity_change("snowglobe"))
324 self.assertEqual(group(new).gr_gid, 994)
325 self.assertEqual(user(old).pw_uid, 997)
326 with self.assertRaisesRegex(OSError, "registry write"):
327 transition.rename_identity(transition.identity_change("snowglobe"))
328 self.assertEqual(user(new).pw_uid, 997)
329 transition.rename_identity(transition.identity_change("snowglobe"))
330 self.assertIsNone(transition.identity_change("snowglobe"))
331 self.assertEqual(json.loads((registry / "gid-map").read_text()), {new: 994})
332 transition.rename_identity(transition.identity_change(transition.PREVIOUS))
333 self.assertEqual((user(old).pw_uid, user(old).pw_gid, group(old).gr_gid), (997, 994, 994))
334 self.assertIsNone(transition.identity_change(transition.PREVIOUS))
335
336
337if __name__ == "__main__":
338 unittest.main()
tools/namespace-transition.py created+245
......@@ -0,0 +1,245 @@
1#!/usr/bin/env python3
2"""Bridge the installed namespace and immutable releases during the rename."""
3import argparse
4import grp
5import json
6import os
7from pathlib import Path
8import pwd
9import subprocess
10import urllib.request
11
12
13NAMESPACE = globals().get("NAMESPACE") or json.loads(
14 (Path(__file__).with_suffix(".json") if Path(__file__).with_suffix(".json").exists()
15 else Path(__file__).resolve().parent.parent / "dashboard/src/namespace-transition.json").read_text()
16)
17PREVIOUS = NAMESPACE["previous"]
18NIXOS_STATE = Path("/var/lib/nixos")
19DIRECTORIES = tuple((Path(parent) / "snowglobe", Path(parent) / PREVIOUS)
20 for parent in ("/opt", "/var/lib", "/var/lib/caddy", "/var/cache"))
21
22
23def prepare():
24 for new, old in DIRECTORIES:
25 if new.exists() and old.exists() and new.resolve() != old.resolve():
26 raise ValueError(f"Two independent control stores exist: {new}, {old}")
27 new_root, _ = DIRECTORIES[0]
28 previous_releases = any((new_root / "releases").glob("*/tools/" + PREVIOUS + ".py"))
29 for new, old in DIRECTORIES:
30 if old.exists() and not new.exists() and not new.is_symlink():
31 new.symlink_to(old, target_is_directory=True)
32 elif previous_releases and new.exists() and not old.exists() and not old.is_symlink():
33 old.symlink_to(new, target_is_directory=True)
34
35
36def inherit_environment():
37 for name, value in list(os.environ.items()):
38 if name.startswith(PREVIOUS.upper() + "_"):
39 os.environ.setdefault("SNOWGLOBE_" + name.removeprefix(PREVIOUS.upper() + "_"), value)
40
41
42def environment(path, values=None):
43 values = dict(os.environ if values is None else values)
44 if layout(path)["prefix"] == PREVIOUS:
45 for name, value in list(values.items()):
46 if name.startswith("SNOWGLOBE_"):
47 values[PREVIOUS.upper() + "_" + name.removeprefix("SNOWGLOBE_")] = value
48 return values
49
50
51def layout(path):
52 prefix = "snowglobe" if (path / ".snowglobe-release.json").exists() or (path / "tools/snowglobe.py").exists() else PREVIOUS
53 return {"prefix": prefix, "script": path / f"tools/{prefix}.py", "manifest": path / f".{prefix}-release.json"}
54
55
56def host_configuration(hostname, available):
57 hostname = hostname.split(".", 1)[0]
58 candidates = ("snowglobe", NAMESPACE["previousHost"]) if hostname in {"snowglobe", NAMESPACE["previousHost"]} else (
59 "vm" if hostname in {"snowglobe-rehearsal", "clover-demo"} else hostname,
60 )
61 for name in candidates:
62 if name in available:
63 return name
64 raise ValueError(f"release has no NixOS configuration for {hostname}")
65
66
67def host_environment():
68 for prefix in ("snowglobe", PREVIOUS):
69 result = subprocess.run(["systemctl", "show", prefix + "-host", "--property=Environment", "--value"],
70 capture_output=True, text=True)
71 if result.stdout.strip():
72 return result.stdout
73 raise ValueError("the host service environment is unavailable")
74
75
76def stop_preview(identity):
77 for prefix in ("snowglobe", PREVIOUS):
78 subprocess.run(["systemctl", "stop", prefix + "-preview-" + identity], capture_output=True)
79
80
81def dashboard_container():
82 for name in ("snowglobe-dashboard", PREVIOUS + "-dashboard"):
83 if subprocess.run(["podman", "container", "exists", name], capture_output=True).returncode == 0:
84 return name
85 raise ValueError("the dashboard container is unavailable")
86
87
88def normalize_vm(root):
89 for element in root.iter():
90 if element.tag.startswith("{https://paperclover.net/" + PREVIOUS + "}"):
91 element.tag = element.tag.replace("{https://paperclover.net/" + PREVIOUS + "}", "{https://paperclover.net/snowglobe}", 1)
92 if element.tag == "serial" and element.text == PREVIOUS + "-cloud-init":
93 element.text = "snowglobe-cloud-init"
94 return root
95
96
97def migrate_policies(source, state, prefix="snowglobe"):
98 management = {**os.environ, "NOMAD_TOKEN": (state / "nomad.token").read_text().strip()}
99 for consumer in ("router", "dashboard"):
100 request = urllib.request.Request("http://127.0.0.1:4646/v1/acl/token/self", headers={
101 "X-Nomad-Token": (state / (consumer + ".token")).read_text().strip(),
102 })
103 with urllib.request.urlopen(request, timeout=10) as response:
104 token = json.load(response)
105 old, new = (PREVIOUS if prefix == "snowglobe" else "snowglobe") + "-" + consumer, prefix + "-" + consumer
106 subprocess.run(["nomad", "acl", "policy", "apply", new, str(source / "config/policies" / (consumer + ".hcl"))],
107 env=management, check=True, capture_output=True)
108 policies = [new if value == old else value for value in token.get("Policies", [])]
109 if old in token.get("Policies", []) or token.get("Name") == old:
110 subprocess.run(["nomad", "acl", "token", "update", "-name=" + new,
111 *("-policy=" + value for value in policies), token["AccessorID"]],
112 env=management, check=True, capture_output=True)
113
114
115def stop_units(prefix):
116 units = ("dashboard", "router", "log-shipper", "vm-screen", "host")
117 if prefix == PREVIOUS:
118 units += ("vm-window-host-proxy",)
119 for unit in units:
120 result = subprocess.run(["systemctl", "stop", prefix + "-" + unit], capture_output=True, text=True)
121 if result.returncode and "not loaded" not in result.stderr:
122 result.check_returncode()
123
124
125def identity_change(prefix):
126 old = (PREVIOUS if prefix == "snowglobe" else "snowglobe") + "-dashboard"
127 new = prefix + "-dashboard"
128 users, groups = {}, {}
129 for name in (old, new):
130 try:
131 users[name] = pwd.getpwnam(name)
132 except KeyError:
133 pass
134 try:
135 groups[name] = grp.getgrnam(name)
136 except KeyError:
137 pass
138 if len(users) > 1 or len(groups) > 1:
139 raise ValueError("Two dashboard identities exist; refusing to merge identities")
140 if any((user.pw_uid, user.pw_gid) != (997, 994) for user in users.values()) or any(
141 group.gr_gid != 994 for group in groups.values()
142 ):
143 raise ValueError("The dashboard account must retain UID 997 and GID 994")
144 registries = False
145 for filename, expected in (("uid-map", 997), ("gid-map", 994)):
146 path = NIXOS_STATE / filename
147 if path.exists():
148 values = json.loads(path.read_text())
149 if any(name in values and values[name] != expected for name in (old, new)):
150 raise ValueError("The NixOS identity registry disagrees with the dashboard account")
151 registries |= old in values
152 for filename in ("declarative-users", "declarative-groups"):
153 path = NIXOS_STATE / filename
154 registries |= path.exists() and old in path.read_text().split()
155 return (old, new) if old in users or old in groups or registries else None
156
157
158def rename_identity(change):
159 if change is None:
160 return
161 old, new = change
162 try:
163 grp.getgrnam(old)
164 except KeyError:
165 pass
166 else:
167 subprocess.run(["groupmod", "--new-name", new, old], check=True, capture_output=True)
168 try:
169 pwd.getpwnam(old)
170 except KeyError:
171 pass
172 else:
173 subprocess.run(["usermod", "--login", new, old], check=True, capture_output=True)
174 for filename in ("uid-map", "gid-map", "declarative-users", "declarative-groups"):
175 path = NIXOS_STATE / filename
176 if not path.exists():
177 continue
178 if filename.endswith("-map"):
179 values = json.loads(path.read_text())
180 if old not in values:
181 continue
182 values[new] = values.pop(old)
183 content = json.dumps(values) + "\n"
184 else:
185 names = path.read_text().split()
186 if old not in names:
187 continue
188 content = " ".join(new if name == old else name for name in names) + "\n"
189 pending = path.with_suffix(".namespace-pending")
190 pending.write_text(content)
191 pending.chmod(path.stat().st_mode & 0o777)
192 pending.replace(path)
193
194
195def promote(source):
196 prepare()
197 change = identity_change("snowglobe")
198 moving = any(old.exists() and not old.is_symlink() for _, old in DIRECTORIES)
199 if moving or change is not None:
200 stop_units(PREVIOUS)
201 rename_identity(change)
202 for new, old in DIRECTORIES:
203 if old.exists() and not old.is_symlink():
204 if new.is_symlink():
205 new.unlink()
206 old.rename(new)
207 old.symlink_to(new, target_is_directory=True)
208 new_root, old_root = DIRECTORIES[0]
209 for name in ("current", "main"):
210 link = new_root / name
211 if link.is_symlink():
212 target = Path(os.readlink(link))
213 if target.is_relative_to(old_root):
214 pending = link.with_suffix(".namespace-pending")
215 pending.unlink(missing_ok=True)
216 pending.symlink_to(new_root / target.relative_to(old_root))
217 pending.replace(link)
218 if old_root.exists():
219 migrate_policies(source, DIRECTORIES[1][0])
220
221
222def activate(path):
223 if layout(path)["prefix"] == "snowglobe":
224 promote(path)
225 else:
226 change = identity_change(PREVIOUS)
227 stop_units("snowglobe")
228 rename_identity(change)
229 migrate_policies(path, DIRECTORIES[1][0], PREVIOUS)
230
231
232def main():
233 parser = argparse.ArgumentParser()
234 parser.add_argument("mode", choices=("prepare", "promote"))
235 args = parser.parse_args()
236 if os.geteuid() != 0:
237 raise PermissionError("the namespace transition requires root")
238 if args.mode == "prepare":
239 prepare()
240 else:
241 promote(Path(__file__).resolve().parent.parent)
242
243
244if __name__ == "__main__":
245 main()
tools/oidc-provider.py+2-1
......@@ -1,6 +1,7 @@
11#!/usr/bin/env python3
22"""Provision a first-party OIDC client through the dashboard's host-only CLI."""
33import json
4from importlib import import_module
45import subprocess
56import sys
67
......@@ -8,7 +9,7 @@ data = json.load(sys.stdin)
89if data["request"]["kind"] != "client":
910 raise ValueError("unsupported Snowglobe input")
1011result = 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"],
1213 input=json.dumps(data), text=True, check=True, capture_output=True,
1314)
1415sys.stdout.write(result.stdout)
tools/openclaw-verify.py+1-1
......@@ -5,7 +5,7 @@ import subprocess
55
66
77parser = argparse.ArgumentParser()
8parser.add_argument("--host", default="root@zenith")
8parser.add_argument("--host", default="root@10.0.0.1")
99task = parser.add_mutually_exclusive_group()
1010task.add_argument("--prepare-task", action="store_true")
1111task.add_argument("--check-task", action="store_true")
tools/pds-migration.md deleted-7
......@@ -1,7 +0,0 @@
1# PDS data migration
2
3The 2026-09-26 preview restore copied Zenith's three SQLite databases with SQLite's backup API and copied its blocks and actor keys without writing to Zenith. The restored stage passed SQLite integrity checks and HTTPS health. Source and stage had the same table and row counts: `account` 18/47, `sequencer` 3/76, and `did_cache` 3/5. The preview uses a separate hostname and disables PLC and crawlers, so it cannot validate public federation.
4
5For production, configure the new host's site domain as `paperclover.net` and verify PDS renders `at.paperclover.net`. Stop the old and new PDS instances, then run `STUDIO_DEPLOY_HOST=<new-host> STUDIO_DEPLOY_PORT=22 sh tools/import-pds.sh pds`. The importer requires both instances stopped, imports the existing JWT/admin/PLC and mail secrets, snapshots the destination, copies and verifies the data, and leaves the new instance stopped. Its snapshot name is printed for recovery. Start the new instance only after checking the account DID and handle against Zenith; switch public routing after its health and identity endpoints agree. The importer rechecks that Zenith did not restart during the copy.
6
7For a same-machine OS replacement, set `STUDIO_LEGACY_HANDOFF` to the [offline handoff](legacy-handoff.md) directory. The importer then reads the retained PDS SQLite files and `.env` from the new host's mounted old apps dataset, without old Docker. Its SQLite backup operation was checked read-only against all three old databases.
tools/personal-cutover.md deleted-45
......@@ -1,45 +0,0 @@
1# Personal service cutover
2
3The installed host retains the original encrypted app tree at `/mnt/storage1/apps`. Clover and its Media child are already mounted at `/srv/clover` and `/srv/clover/Media`. Copy each app's state into its managed production dataset, verify it, and only then start that app. Old app trees stay untouched. Personal Forgejo repository migration and PostgreSQL restoration are separate from these file imports.
4
5```sh
6export STUDIO_DEPLOY_HOST=root@10.0.0.1
7export STUDIO_DEPLOY_PORT=22
8export STUDIO_LEGACY_HANDOFF=/mnt/storage1/apps/studio-handoff/20261004T230507Z-e75419
9```
10
11Provision managed service datasets and identities before import. Register a stopped production Nomad job when required: render HCL, parse with `nomad job run -output`, set the returned `Job.Stop=true`, then POST `/v1/jobs` and confirm zero allocations. Do not deploy an empty app to create its dataset. A missing job is accepted by the Shale, qBittorrent, ARR, YouTube, and personal-files importers. Jellyfin, Navidrome, and Jackett importers require `Stop=true` on an existing job.
12
13| App | Retained source → managed destination | Import and pre-start proof |
14| --- | --- | --- |
15| Shale | `apps/shale/{data,repositories_owned,repositories_mirrors}` → `/srv/prod/shale/` | `bash tools/import-shale.sh shale`; three directory checksums and SQLite integrity. Forgejo-only repositories still need import into Shale. |
16| Jellyfin | `apps/jellyfin/` → `/srv/prod/jellyfin/config/` | `sh tools/import-jellyfin.sh jellyfin`; excludes caches/logs/transcodes; verifies both SQLite databases and copy checksums. |
17| Navidrome | `apps/navidrone/` → `/srv/prod/navidrome/data/` | `sh tools/import-navidrome.sh navidrome`; SQLite integrity, checksum, and retained `snow` administrator. The old directory is spelled `navidrone`. |
18| qBittorrent | `apps/qbittorrent/qBittorrent/` → `/srv/prod/qbittorrent/config/qBittorrent/` | `bash tools/import-qbittorrent.sh`; verifies resume-file count and checksum, prepares config, **then starts the service**. Load PIA secrets first. |
19| PDS | `apps/pds/` → `/srv/prod/pds/pds/` | `ssh root@10.0.0.1 'python3 - pds' < tools/import-personal-files.py`; preserve original JWT/admin/PLC/mail secrets first. Checks every SQLite database, including actor stores, and copies actor keys/blocks. Refuses WAL files requiring a consistent SQLite backup. |
20| Sonarr / Radarr | `apps/<app>/` → `/srv/prod/<app>/config/` | `bash tools/import-arr.sh <app>`; consistent SQLite backup, integrity and hash; excludes logs/PIDs. Configure current internal endpoints after startup. |
21| Jackett | `apps/jackett/` → `/srv/prod/jackett/config/Jackett/` | `sh tools/import-jackett.sh jackett`; retains API key and indexer JSON, verifies checksums. |
22| YouTube state | `apps/yt-feed/` → `/srv/prod/ytdl/data/` | `bash tools/import-yt-feed.sh ytdl`; validates JSON and checksums; stops and restarts dashboard's worker around import. Import mail secrets before activating worker. |
23| Clover DB | `/srv/clover/.zfs/snapshot/<snapshot>/Documents/Config/paper clover/` → `/srv/prod/clover-source-of-truth/data/` | `STUDIO_MIGRATION_SNAPSHOT=<snapshot> bash tools/import-source-data.sh`; direct host-local tar stream, tree digest and SQLite integrity. Import original API key. |
24| Tailscale / DDNS / Copyparty / YouTube Archiver / PDS | Sources and mount destinations are defined in [import-personal-files.py](import-personal-files.py). | Run the host-side importer below once per app. No app starts; it checks stopped allocations, snapshots destination, copies, checksum-verifies, and assigns its UID. |
25
26```sh
27ssh root@10.0.0.1 'python3 - tailscale' < tools/import-personal-files.py
28ssh root@10.0.0.1 'python3 - ddns-updater' < tools/import-personal-files.py
29ssh root@10.0.0.1 'python3 - copyparty' < tools/import-personal-files.py
30ssh root@10.0.0.1 'python3 - ytdl' < tools/import-personal-files.py
31```
32
33Tailscale must retain `tailscaled.state` to preserve its node identity; the copy remains root-owned and mode `0600`. The PDS importer copies every actor store, not only its three root SQLite files; `import-pds.sh` excludes nested SQLite files and is unsuitable for this offline cutover. DDNS retains update history; its provider configuration comes from imported Cloudflare secrets and the service's generated `CONFIG`. Copyparty's active state is the **nested** old `copyparty/copyparty/` directory, including `shares.db`, sessions, IdP database, and salts; it stays nested under the new `/cfg/copyparty`. The [container sets `XDG_CONFIG_HOME=/cfg`](https://github.com/9001/copyparty/blob/hovudstraum/scripts/docker/Dockerfile.ac), and Copyparty appends its app directory. The outer legacy policy config is not copied: `prepare.py` generates the current policy. Its share database contained 17 shares and three selected-file records at the October 5 UTC inspection. Per-volume histories already on Clover/Media stay on those datasets.
34
35YouTube Archiver's 12 retained download-archive files stay beside videos in `Media/Videos/Independent`; cache and stale locks in its old app directory are disposable. Its retained subscriptions specify `/media/jellyfin/Independent`, so the service binds that container path to the reorganized folder. The upscaler reads `/media/Videos/Independent` directly. Dashboard's worker reads the actual `Indie Shows`, `Videos/Independent`, and `Intake - Music` folders; it needs no media symlinks.
36
37Samba serves existing Clover/Media directly and needs only its account secret. Intake likewise uses `/srv/clover/Documents/Intake` directly and needs the retained API key. VictoriaMetrics, VictoriaLogs, and VictoriaTraces had no legacy directories at their personal app paths; start new stores. OpenSpeedTest, FlareSolverr, and Forward Auth have no retained application file state. Keycloak and Dawarich require their personal PostgreSQL restores before activation; Dawarich's file-volume migration belongs with its database importer.
38
39Activate telemetry and restored PostgreSQL first, then restored Keycloak and Forward Auth. Start restored Shale and complete Git repository migration. After personal files/secrets are verified, enable Copyparty, Samba, PDS, Navidrome, Jellyfin, Intake, and Clover DB. Bring up Jackett and qBittorrent before Sonarr/Radarr. Start restored YouTube state, dashboard worker, and Archiver after checking final writable media paths. DDNS starts after wildcard routing is ready; preserved Tailscale state can start once its own copy passes.
40
41Do not reuse preview imports for production: those branches can start jobs, use old `storage1` snapshot names, or intentionally disable writers. qBittorrent's production importer starts its job at the end; YouTube's importer restarts dashboard and may resume retained queued work immediately. All other production file importers listed above leave the imported app stopped.
42
43October 5 UTC execution evidence is stored root-only under `/var/lib/studio/migrations/personal-cutover-20261004`; the original app snapshot is `globe/apps@personal-cutover-20261004`. The manual no-start qBittorrent copy retained 550 saved torrents, YouTube retained six valid JSON state files, Copyparty retained 17 shares, PDS retained all four SQLite databases, and pgAdmin passed SQLite integrity. Dawarich retained its storage file, empty watched-import directory, and 95,396-byte Redis dump. YouTube state needs explicit access ACL masks (`m::rwX`) and default masks (`d:m::rwx`) so dashboard and upscaler can both write.
44
45Before ARR activation, the copied databases received a separate `before-arr-path-cutover-*` snapshot. Sonarr translated two root folders and 89 series paths; Radarr translated one root folder and 56 movie paths from `/data/media/jellyfin/<folder>` to `/data/media/<folder>`. All other application table values matched their pre-change hashes. Seven download-path mappings per app are derived from qBittorrent and ARR volume definitions, including `torrent` → `Seedbox` and the saved Jellyfin aliases; [configure-arr.py](configure-arr.py) updates their host alongside the download client. [Servarr maps paths only for the matching download-client host](https://github.com/Servarr/Wiki/blob/master/sonarr/settings.md). All mapped root destinations passed service UID/GID 3000 read/search checks. Three Sonarr series directories were already absent in the pre-layout Media snapshot; the other 86 and all 56 Radarr movie directories resolve. Private proofs are `<app>-path-cutover.json`, `<app>-mapped-directory-proof.json`, and `sonarr-missing-directory-origin.json` in the evidence directory above.
tools/rehearsal.md created+26
......@@ -0,0 +1,26 @@
1# Isolated host rehearsal
2
3Normal service and dashboard previews run on Snow Globe. Use the optional NixOS
4VM only when a change needs an isolated host, OS, storage, or guest boundary.
5It has no production GPU; do not download model weights or enable inference.
6
7The VM configuration is `nixos/vm.nix` (flake `vm`), with hostname `snowglobe-rehearsal`,
8domain `snowglobe.test`, and a demo pool. Its SSH endpoint is
9`root@127.0.0.1`, port `2222`. Both deployment overrides are required:
10
11```sh
12SNOWGLOBE_DEPLOY_HOST=root@127.0.0.1 SNOWGLOBE_DEPLOY_PORT=2222 python3 tools/deploy.py stage <service>
13```
14
15`tools/local-vm.sh` launches the VM. `SNOWGLOBE_VM_CACHE_DIR` overrides its cache;
16`SNOWGLOBE_VM_HEADLESS=1` selects background operation. Installed mode mounts
17`SNOWGLOBE_VM_MEDIA_SOURCE` (default `/Volumes/media`) read-only through 9P at
18`/mnt/media-source`, with a bindfs view at `/srv/clover/Media`.
19Those media bytes are personal source data, not synthetic fixtures. The VM's
20own Clover dataset is separate. Use disposable test data and do not inspect
21private source contents without authorization.
22
23Use the configured DNS and TLS routing for the VM. Do not hand-edit host files,
24DNS, or trust to bypass a failed setup. Keep VM console/browser checks inside the
25normal browser panel. Rehearsal evidence belongs in its relevant runbook; the
26primary agent workflow remains staging on Snow Globe.
tools/release-host-test.py created+90
......@@ -0,0 +1,90 @@
1#!/usr/bin/env python3
2import json
3import os
4from pathlib import Path
5import subprocess
6import tempfile
7from types import SimpleNamespace
8import unittest
9from unittest.mock import patch
10
11import release
12
13PREVIOUS_HOST = release.transition.NAMESPACE["previousHost"]
14
15
16class HostConfiguration(unittest.TestCase):
17 def select(self, hostname, configurations):
18 with patch.object(release.os, "uname", return_value=SimpleNamespace(nodename=hostname)), patch.object(
19 release.subprocess, "run", return_value=subprocess.CompletedProcess([], 0, json.dumps(configurations)),
20 ) as command:
21 result = release.host_configuration(Path("/release"))
22 command.assert_called_once_with(
23 ["nix", "--extra-experimental-features", "nix-command flakes", "eval", "--json", "path:/release#nixosConfigurations", "--apply", "builtins.attrNames"],
24 check=True, capture_output=True, text=True,
25 )
26 return result
27
28 def test_rename_and_rollback(self):
29 for hostname in (PREVIOUS_HOST, "snowglobe", "snowglobe.paperclover.net"):
30 with self.subTest(hostname=hostname):
31 self.assertEqual(self.select(hostname, ["installer", "snowglobe", "vm"]), "snowglobe")
32 self.assertEqual(self.select(hostname, ["installer", PREVIOUS_HOST, "vm"]), PREVIOUS_HOST)
33
34 def test_rehearsal_stays_on_vm(self):
35 self.assertEqual(self.select("snowglobe-rehearsal", ["installer", "snowglobe", "vm"]), "vm")
36
37 def test_unrelated_host_is_not_retargeted(self):
38 self.assertEqual(self.select("fixture", ["fixture", "vm"]), "fixture")
39 for hostname in ("fixture", "snowglobe", "snowglobe-rehearsal"):
40 with self.subTest(hostname=hostname), self.assertRaisesRegex(ValueError, "no NixOS configuration"):
41 self.select(hostname, ["installer"])
42
43
44class ActivationEnvironment(unittest.TestCase):
45 def test_host_switch_refreshes_inherited_name_and_preserves_overrides(self):
46 for before, after, inherited, expected in (
47 (PREVIOUS_HOST, "snowglobe", PREVIOUS_HOST, "snowglobe"),
48 ("snowglobe", PREVIOUS_HOST, "snowglobe", PREVIOUS_HOST),
49 (PREVIOUS_HOST, "snowglobe", None, "snowglobe"),
50 (PREVIOUS_HOST, "snowglobe", "test-override", "test-override"),
51 ("snowglobe-rehearsal", "snowglobe-rehearsal", "snowglobe-rehearsal", "snowglobe-rehearsal"),
52 ):
53 with self.subTest(before=before, inherited=inherited), tempfile.TemporaryDirectory() as temporary:
54 root = Path(temporary)
55 source = root / "release"
56 source.mkdir()
57 (source / "tools").mkdir()
58 (source / "tools/snowglobe.py").touch()
59 (source / ".snowglobe-release.json").write_text('{"version":1}')
60 hostname = before
61 observed = []
62
63 def run(argv, **kwargs):
64 nonlocal hostname
65 if argv[:2] == ["nixos-rebuild", "switch"]:
66 hostname = after
67 if argv[-1] == "deploy":
68 observed.append(os.environ.get("SNOWGLOBE_NODE_NAME"))
69 return subprocess.CompletedProcess(argv, 0, '"leader"')
70
71 with patch.dict(os.environ), patch.object(release, "ROOT", root), patch.object(
72 release, "STATE", root,
73 ), patch.object(release, "check_release", return_value=source), patch.object(
74 release, "current_release", return_value=None,
75 ), patch.object(release, "host_digest", return_value="new"), patch.object(
76 release, "host_configuration", return_value="fixture",
77 ), patch.object(release, "jobs", return_value=set()), patch.object(
78 release.os, "uname", side_effect=lambda: SimpleNamespace(nodename=hostname),
79 ), patch.object(release.subprocess, "run", side_effect=run):
80 if inherited is None:
81 os.environ.pop("SNOWGLOBE_NODE_NAME", None)
82 else:
83 os.environ["SNOWGLOBE_NODE_NAME"] = inherited
84 with patch.object(release.transition, "activate"):
85 release.activate("0123456789abcdef", initial=True)
86 self.assertEqual(observed, [expected])
87
88
89if __name__ == "__main__":
90 unittest.main()
tools/release.py+53-37
......@@ -4,6 +4,7 @@ from datetime import datetime, timezone
44import fcntl
55import hashlib
66import json
7from importlib import import_module
78import os
89from pathlib import Path
910import re
......@@ -11,34 +12,23 @@ import subprocess
1112import time
1213
1314
14ROOT = Path("/opt/studio")
15transition = import_module("namespace-transition")
16
17ROOT = Path("/opt/snowglobe")
1518RELEASES = ROOT / "releases"
16STATE = Path("/var/lib/studio")
19STATE = Path("/var/lib/snowglobe")
1720HISTORY = STATE / "deployments.json"
18SOURCES = ("config", "service", "tools", "nixos", "dashboard", "guest", "flake.nix", "flake.lock", "readme.md")
21SOURCES = ("config", "service", "tools", "nixos", "dashboard", "guest", "flake.nix", "flake.lock", "readme.md", "AGENTS.md")
1922RELEASE_ID = re.compile(r"[0-9a-f]{16}\Z")
2023STAGE_ID = re.compile(r"[a-z][a-z0-9-]*\Z")
2124
2225
23def excluded_services(root):
24 path = root / "config/excluded-services.json"
25 return set(json.loads(path.read_text())) if path.exists() else set()
26
27
2826def files(root):
29 excluded = excluded_services(root)
3027 for name in SOURCES:
3128 source = root / name
3229 if not source.exists() and not source.is_symlink():
3330 continue
34 if name == "service" and source.is_dir():
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]
31 paths = source.rglob("*") if source.is_dir() else [source]
4232 for path in sorted(paths):
4333 relative = path.relative_to(root)
4434 if relative.parts[:2] in (
......@@ -76,7 +66,7 @@ def host_digest(root):
7666 digest = hashlib.sha256()
7767 paths = sorted(path for path, relative in files(root)
7868 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"})
8070 for path in paths:
8171 digest.update(str(path.relative_to(root)).encode())
8272 _hash_contents(digest, path)
......@@ -89,7 +79,7 @@ def check_release(release, legacy=False):
8979 path = RELEASES / release
9080 if not path.is_dir():
9181 raise ValueError(f"release is missing: {release}")
92 manifest = path / ".studio-release.json"
82 manifest = transition.layout(path)["manifest"]
9383 if not manifest.exists():
9484 if not legacy:
9585 raise ValueError(f"release has no manifest: {release}")
......@@ -105,7 +95,7 @@ def current_release(link="current"):
10595 if not current.is_symlink():
10696 return None
10797 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):
10999 raise ValueError(f"{link} points outside releases: {target}")
110100 return target.name
111101
......@@ -116,7 +106,7 @@ def main_release(version=None):
116106 return None
117107 if not RELEASE_ID.fullmatch(version):
118108 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())
120110 revision = details.get("main")
121111 if (not isinstance(revision, dict) or not isinstance(revision.get("commit"), str)
122112 or not re.fullmatch(r"[0-9a-f]{40}", revision["commit"])
......@@ -137,8 +127,8 @@ def save_history(entries):
137127
138128def jobs(path):
139129 rendered = subprocess.run(
140 ["python3", str(path / "tools/studio.py"), "render"],
141 check=True, capture_output=True, text=True,
130 ["python3", str(transition.layout(path)["script"]), "render"],
131 check=True, capture_output=True, text=True, env=transition.environment(path),
142132 ).stdout
143133 result = set(re.findall(r'^job "([a-z][a-z0-9-]*)" \{$', rendered, re.MULTILINE))
144134 if not result:
......@@ -146,22 +136,33 @@ def jobs(path):
146136 return result
147137
148138
139def host_configuration(path):
140 hostname = os.uname().nodename.split(".", 1)[0]
141 available = json.loads(subprocess.run(
142 ["nix", "--extra-experimental-features", "nix-command flakes", "eval", "--json", f"path:{path}#nixosConfigurations", "--apply", "builtins.attrNames"],
143 check=True, capture_output=True, text=True,
144 ).stdout)
145 return transition.host_configuration(hostname, available)
146
147
149148def activate(release, legacy=False, initial=False):
150149 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"]
152154 managed = STATE / "managed-jobs.json"
153155 current = current_release()
154156 previous = set(json.loads(managed.read_text())) if managed.exists() else (
155157 jobs(RELEASES / current) if current and not initial else set()
156158 )
157159 digest = host_digest(path)
158 hostname = os.uname().nodename.split(".", 1)[0]
159 configuration = "vm" if hostname == "clover-demo" else hostname
160160 recorded = ROOT / "host.digest"
161161 old_digest = recorded.read_text().strip() if recorded.exists() else None
162162 if old_digest != digest:
163 configuration = host_configuration(path)
163164 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)
165166 backup = None
166167 if current and not initial:
167168 backup_script = ROOT / "data.py"
......@@ -176,7 +177,12 @@ def activate(release, legacy=False, initial=False):
176177 if old_digest != digest:
177178 if current is None:
178179 (ROOT / "current").symlink_to(path)
180 hostname = os.uname().nodename.split(".", 1)[0]
181 transition.activate(path)
179182 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)
180186 next_link = ROOT / ("next-" + release)
181187 next_link.unlink(missing_ok=True)
182188 next_link.symlink_to(path)
......@@ -193,12 +199,12 @@ def activate(release, legacy=False, initial=False):
193199 time.sleep(2)
194200 else:
195201 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)
197203 if (path / "nixos/dashboard.nix").exists():
198 subprocess.run(["systemctl", "start", "studio-dashboard.service"], check=True)
199 subprocess.run(["systemctl", "is-active", "--quiet", "studio-dashboard.service"], check=True)
200 subprocess.run(["python3", str(script), "pool"], check=True)
201 subprocess.run(["python3", str(script), "deploy"], check=True)
204 subprocess.run(["systemctl", "start", prefix + "-dashboard.service"], check=True)
205 subprocess.run(["systemctl", "is-active", "--quiet", prefix + "-dashboard.service"], check=True)
206 subprocess.run(["python3", str(script), "pool"], check=True, env=environment)
207 subprocess.run(["python3", str(script), "deploy"], check=True, env=environment)
202208 desired = jobs(path)
203209 for name in sorted(previous - desired):
204210 subprocess.run(
......@@ -209,19 +215,29 @@ def activate(release, legacy=False, initial=False):
209215 pending.write_text(json.dumps(sorted(desired)) + "\n")
210216 pending.replace(managed)
211217 if (path / "tools/log-shipper.py").exists():
212 subprocess.run(["systemctl", "restart", "studio-log-shipper.service"], check=True)
213 manifest = path / ".studio-release.json"
218 subprocess.run(["systemctl", "restart", prefix + "-log-shipper.service"], check=True)
219 manifest = transition.layout(path)["manifest"]
214220 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)
216222 return backup
217223
218224
219225def main():
220226 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"])
222228 parser.add_argument("target", nargs="?")
223229 args = parser.parse_args()
230 transition.prepare()
231 transition.inherit_environment()
224232 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
225241 if args.mode == "verify":
226242 if not args.target:
227243 parser.error("verify requires a release ID")
......@@ -255,7 +271,7 @@ def main():
255271 entries = history()
256272 current = current_release()
257273 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()})
259275 save_history(entries)
260276 if args.mode == "deploy":
261277 candidate = main_release()
tools/router-cookie-test.py+7-7
......@@ -30,14 +30,14 @@ def main():
3030 parser = argparse.ArgumentParser()
3131 parser.add_argument('--caddy', required=True, type=Path)
3232 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:
3434 root = Path(temporary)
3535 proof = root / 'proof'
3636 proof.write_text('a' * 64)
37 environment = {**os.environ, 'STUDIO_DOMAIN': 'studio.test', 'STUDIO_DASHBOARD_PORT': '3000',
38 'STUDIO_PROXY_TOKEN_FILE': str(proof), 'XDG_DATA_HOME': str(root / 'data'),
37 environment = {**os.environ, 'SNOWGLOBE_DOMAIN': 'snowglobe.test', 'SNOWGLOBE_DASHBOARD_PORT': '3000',
38 'SNOWGLOBE_PROXY_TOKEN_FILE': str(proof), 'XDG_DATA_HOME': str(root / 'data'),
3939 'XDG_CONFIG_HOME': str(root / 'config')}
40 environment.pop('STUDIO_INTERNAL_PORT', None)
40 environment.pop('SNOWGLOBE_INTERNAL_PORT', None)
4141
4242 def nomad(path, _):
4343 if path == '/v1/services':
......@@ -45,7 +45,7 @@ def main():
4545 if path.startswith('/v1/service/'):
4646 service = path.rsplit('/', 1)[1]
4747 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'] +
4949 (['caddy-secure-cookies=true'] if service == 'knife' else [])}]
5050 return {'http': {'Status': 'success'}}
5151
......@@ -61,8 +61,8 @@ def main():
6161 listener.bind(('127.0.0.1', 0))
6262 port = listener.getsockname()[1]
6363 runtime = root / 'Caddyfile'
64 sites = rendered.split('auth.studio.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', '')
64 sites = rendered.split('auth.snowglobe.test {', 1)[0]
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', '')
6666 runtime.write_text('{\n admin off\n auto_https off\n}\n' + sites)
6767 threading.Thread(target=backend.serve_forever, daemon=True).start()
6868 with (root / 'caddy.log').open('w') as log:
tools/router.py+35-38
......@@ -10,8 +10,8 @@ import urllib.parse
1010import urllib.request
1111
1212ROUTES = "/var/lib/caddy/routes.caddy"
13TOKEN = "/var/lib/studio/router.token"
14ROUTE_DIR = "/var/lib/studio/routes"
13TOKEN = "/var/lib/snowglobe/router.token"
14ROUTE_DIR = "/var/lib/snowglobe/routes"
1515HOST = re.compile(r"[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?\Z")
1616
1717
......@@ -39,13 +39,13 @@ def proxy(upstreams, indent, uncompressed=False, host=None):
3939
4040
4141def 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})$",
4343 " 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",
4545 *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=*", " }",
4747 " 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",
4949 *proxy(f"127.0.0.1:{port}", " "), " }"]
5050
5151
......@@ -100,13 +100,12 @@ def shale_git_routes(upstreams):
100100
101101
102102def render(token):
103 with open(os.environ["STUDIO_PROXY_TOKEN_FILE"]) as file:
103 with open(os.environ["SNOWGLOBE_PROXY_TOKEN_FILE"]) as file:
104104 dashboard_proof = file.read().strip()
105105 if not re.fullmatch(r"[0-9a-fA-F]{64}", dashboard_proof):
106106 raise ValueError("invalid dashboard proxy token")
107 auth_host = "auth." + os.environ["STUDIO_DOMAIN"]
108 legacy_host = "keycloak." + os.environ["STUDIO_DOMAIN"]
109 origins = json.dumps({"origins": ["https://snowglobe." + os.environ["STUDIO_DOMAIN"]]}, separators=(",", ":"))
107 auth_host = "auth." + os.environ["SNOWGLOBE_DOMAIN"]
108 origins = json.dumps({"origins": ["https://snowglobe." + os.environ["SNOWGLOBE_DOMAIN"]]}, separators=(",", ":"))
110109 webauthn = [" handle /.well-known/webauthn {", ' header Content-Type application/json',
111110 f" respond {json.dumps(origins)} 200", " }"]
112111 routes = {}
......@@ -178,7 +177,7 @@ def render(token):
178177 lines = []
179178 for (listener, host), route in sorted(routes.items()):
180179 if host:
181 if host in {auth_host, legacy_host}:
180 if host == auth_host:
182181 continue
183182 role = route["authRole"]
184183 if role and not auth_upstreams:
......@@ -205,18 +204,18 @@ def render(token):
205204 "/srv/staging/" + service)
206205 if service == "shale":
207206 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",
209208 " @logged_out status 200 302 303 404", " handle_response @logged_out {",
210209 " copy_response 303", " }", " }", " }"]
211210 lines += shale_attachment_routes(" ".join(sorted(route["upstreams"])))
212211 lines += [" @userscript path_regexp userscript ^/userscripts/discord-pluralkit-predict(/.*)?$",
213212 " 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"])
215214 if not 1 <= port <= 65535:
216215 raise ValueError("invalid dashboard port for Shale linking")
217216 lines += shale_mcp_routes(port)
218217 lines += [" tracing {", f" span {service}", " span_attributes {",
219 f" studio.service {service}", " studio.kind edge", " }", " }"]
218 f" snowglobe.service {service}", " snowglobe.kind edge", " }", " }"]
220219 manifest = os.path.join(ROUTE_DIR, service + ".json")
221220 assets = {}
222221 headers = {}
......@@ -285,17 +284,17 @@ def render(token):
285284 ]
286285 elif headers and (auth_upstreams or service == "copyparty"):
287286 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))
289288 if native:
290289 lines += [" handle /auth/file/* {", " request_header -User-Name", " request_header -User-Groups",
291 f" request_header Studio-Proxy-Token {dashboard_proof}",
292 " request_header X-Studio-Client-IP {remote_host}", *proxy(auth," "), " }"]
290 f" request_header Snowglobe-Proxy-Token {dashboard_proof}",
291 " request_header X-Snowglobe-Client-IP {remote_host}", *proxy(auth," "), " }"]
293292 else:
294293 lines += [" handle /snow.oauth2/* {", *proxy(auth," "), " }"]
295294 lines += [" handle {"]
296295 lines += [f" request_header -{name}" for name in scrub]
297296 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 []),
299298 " header_up X-Forwarded-Method {method}", " header_up X-Forwarded-Uri {uri}",
300299 " @authenticated status 2xx", " handle_response @authenticated {"]
301300 lines += [f" request_header {name} {{rp.header.{source}}}" for name, source in headers.items()]
......@@ -309,13 +308,13 @@ def render(token):
309308 shale_page = service == "shale" or re.fullmatch(r"shale-preview-[0-9a-f]{8}", service)
310309 page_headers = []
311310 if shale_page:
312 page_upstream = f"127.0.0.1:{int(os.environ['STUDIO_DASHBOARD_PORT'])}"
313 page_headers = [f" request_header Studio-Proxy-Token {dashboard_proof}",
314 f" request_header Studio-Shale-Upstream {json.dumps(sorted(route['upstreams'])[0])}",
315 " request_header Studio-Shale-Uri {uri}",
311 page_upstream = f"127.0.0.1:{int(os.environ['SNOWGLOBE_DASHBOARD_PORT'])}"
312 page_headers = [f" request_header Snowglobe-Proxy-Token {dashboard_proof}",
313 f" request_header Snowglobe-Shale-Upstream {json.dumps(sorted(route['upstreams'])[0])}",
314 " request_header Snowglobe-Shale-Uri {uri}",
316315 " rewrite * /auth/shale/page"]
317316 for index, (request, markup) in enumerate(head_html.items()):
318 name = f"@studio_head_{index}"
317 name = f"@snowglobe_head_{index}"
319318 lines += [f" {name} path {request}", f" handle {name} {{", " route {",
320319 f" replace </head> {json.dumps(markup + '</head>')} {{",
321320 " match {", " header Content-Type text/html*", " }", " }",
......@@ -330,18 +329,16 @@ def render(token):
330329 lines.insert(len(lines) - 1, " }")
331330 else:
332331 lines += [f":{listener} {{", *proxy(" ".join(sorted(route["upstreams"])), " "), "}"]
333 dashboard_host = "snowglobe." + os.environ["STUDIO_DOMAIN"]
334 if any(not HOST.fullmatch(host) for host in [auth_host, legacy_host, dashboard_host]):
332 dashboard_host = "snowglobe." + os.environ["SNOWGLOBE_DOMAIN"]
333 if any(not HOST.fullmatch(host) for host in [auth_host, dashboard_host]):
335334 raise ValueError("invalid login domain")
336 for host in [auth_host, legacy_host]:
337 lines += [f"{host} {{", *([" tls internal"] if host.endswith(".test") else []),
338 *(webauthn if host == auth_host else []), " handle {",
339 f" redir https://{dashboard_host}/ 308", " }", "}"]
335 lines += [f"{auth_host} {{", *([" tls internal"] if auth_host.endswith(".test") else []),
336 *webauthn, " handle {", f" redir https://{dashboard_host}/ 308", " }", "}"]
340337 traces = next((route for route in routes.values() if "victoria-traces" in route["services"]), None)
341338 if traces:
342339 lines += ["http://127.0.0.1:10428 {", " bind 127.0.0.1",
343340 *proxy(" ".join(sorted(traces["upstreams"])), " "), "}"]
344 dashboard_port = int(os.environ["STUDIO_DASHBOARD_PORT"])
341 dashboard_port = int(os.environ["SNOWGLOBE_DASHBOARD_PORT"])
345342 if not 1 <= dashboard_port <= 65535:
346343 raise ValueError("invalid dashboard route")
347344 if (80, dashboard_host) in routes:
......@@ -349,25 +346,25 @@ def render(token):
349346 lines.append(f"{dashboard_host} {{")
350347 if dashboard_host.endswith(".test"):
351348 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", " }", " }"]
353350 lines += [" handle {", " request_header -User-Name", " request_header -User-Groups",
354 f" request_header Studio-Proxy-Token {dashboard_proof}",
355 " request_header X-Studio-Client-IP {remote_host}",
351 f" request_header Snowglobe-Proxy-Token {dashboard_proof}",
352 " request_header X-Snowglobe-Client-IP {remote_host}",
356353 *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")
358355 if internal_port is not None:
359 internal_host = "dashboard.internal." + os.environ["STUDIO_DOMAIN"]
356 internal_host = "dashboard.internal." + os.environ["SNOWGLOBE_DOMAIN"]
360357 if not HOST.fullmatch(internal_host) or not internal_port.isdecimal() or not 1 <= int(internal_port) <= 65535:
361358 raise ValueError("invalid internal dashboard route")
362359 if (80, internal_host) in routes or (int(internal_port), "") in routes:
363360 raise ValueError("internal dashboard route conflicts with a Nomad service")
364361 lines += [f"{internal_host}:{internal_port} {{", " tls internal",
365 f" @dashboard header Studio-Proxy-Token {dashboard_proof}",
366 " handle @dashboard {", " request_header -Studio-Proxy-Token",
362 f" @dashboard header Snowglobe-Proxy-Token {dashboard_proof}",
363 " handle @dashboard {", " request_header -Snowglobe-Proxy-Token",
367364 " request_header -User-Name", " request_header -User-Groups",
368365 " handle_path /nomad/* {", *proxy("127.0.0.1:4646", " ", host="{upstream_hostport}"), " }"]
369366 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}"
371368 lines += [f" handle_path /services/{service}/* {{",
372369 *proxy(" ".join(sorted(upstreams)), " ", host=host), " }"]
373370 lines += [" handle {", " respond 404", " }", " }", " handle {", " respond 403", " }", "}"]
tools/samba-macos-test.swift+2-2
......@@ -13,7 +13,7 @@ guard CommandLine.arguments.count == 2 else {
1313
1414let fm = FileManager.default
1515let 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)
1717var failures = 0
1818
1919func check(_ condition: Bool) throws {
......@@ -68,7 +68,7 @@ do {
6868 try check(Data(contentsOf: package.appendingPathComponent("TXT.rtf")) == first)
6969 }
7070 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)]
7272 for (name, value) in attributes {
7373 let result = value.withUnsafeBytes { setxattr(file.path, name, $0.baseAddress, $0.count, 0, 0) }
7474 guard result == 0 else { throw NSError(domain: NSPOSIXErrorDomain, code: Int(errno)) }
tools/service-dependencies.md+37-37
......@@ -1,37 +1,37 @@
1# Service connection checks
2
3On 2026-09-26, the VM's pgAdmin database contained one configured server, `Clover Postgres`, at the current Nomad address and port. A query from the pgAdmin container using its rendered environment authenticated to the `postgres` database. The `pg.studio.test` health route passed. Zenith's pgAdmin also had one saved server; Snow Globe creates its connection from the Postgres requirement on boot.
4
5Redis Insight's `/api/databases/0/info` initially connected to the VM Redis service. After stopping Redis allocation `7ca6e34a`, Nomad placed a new one and changed its port from `26848` to `26913`. Redis Insight's watched `nomadService` template restarted its task once; its saved connection then used `26913` and `/api/databases/0/info` connected again. A temporary Redis key survived the reallocation and was deleted afterward. Both `redis.studio.test` and `pg.studio.test` passed their HTTP checks. [Nomad's template `change_mode` defaults to `restart`](https://developer.hashicorp.com/nomad/docs/job-specification/template), and [Redis Insight applies changed preconfigured connections after a restart](https://redis.io/docs/latest/operate/redisinsight/configuration/).
6
7After the x86 VM crashed and rebooted on 2026-09-26, Keycloak needed several minutes to start under emulation. Shale's earlier `wait-keycloak-app` prestart task remained marked complete, so Shale restarted 19 times while its OIDC discovery endpoint returned 404. Forward Auth also retried. Both recovered when Keycloak became healthy. [Nomad does not rerun a successful non-sidecar prestart task after a task restart](https://developer.hashicorp.com/nomad/docs/job-specification/lifecycle).
8
9Evil.inc Forgejo and HedgeDoc remained running but unhealthy after the same reboot. Forgejo had tried PostgreSQL before it was ready and then stopped making progress. Targeted `nomad job restart -all-tasks` calls recovered both; the full 19-route Snow Globe check then passed. Snow Globe now renders a one-minute retry delay for dependent services and [Nomad `check_restart`](https://developer.hashicorp.com/nomad/docs/job-specification/check_restart) for unhealthy services. Disposable one- and two-task Nomad jobs proved that a failing group-level check restarts every running task in its group. Eight generated jobs, including Keycloak, Forgejo, and HedgeDoc, passed `nomad job validate`.
10
11Release `7ec7b25654702110` staged Shale from its ZFS clone and promoted to the VM after backup `20260926T134201Z-22d930` captured 22 service datasets. The promotion passed all 19 HTTPS routes. Live Nomad inspection confirmed Shale's one-minute retry delay and five-minute health-check grace, plus Forgejo's 20-minute grace from its declared healthy deadline.
12
13After a clean VM reboot, PostgreSQL passed first, Keycloak became healthy at 14:04 UTC, and Shale recovered on its next one-minute retry. Forgejo remained running but unhealthy after its early database connection failed. At 14:15 UTC, Nomad's group-level `check_restart` restarted both Forgejo and Anubis without intervention; both checks and Forgejo's HTTPS route passed by 14:17 UTC. The full 19-route check passed after reboot. From the Mac, Shale, Keycloak discovery, and the Shale preview returned 200 through `.studio.test` DNS and trusted TLS. The 20-minute grace made Forgejo's recovery too slow, so its service now declares a two-minute health-restart grace, separate from its deployment deadline.
14
15Keycloak preview `keycloak-preview-dbe9aba6` ran with the production `start` command against a cloned database. Its OIDC discovery advertised the preview hostname. Release `47342c5c49f3eb88` promoted that preview after backup `20260926T141745Z-93733a` captured 22 service datasets. The production Keycloak allocation passed its health check with zero restarts; the promotion completed its dependency allocation and all 19 HTTPS checks. From the Mac, discovery returned HTTP 200 with a trusted certificate and issuer `https://keycloak.studio.test/realms/master`. Live job inspection confirmed `start`, the full production hostname, and Forgejo's two-minute check-restart grace.
16
17Shale and Jellyfin currently use writable SQLite datasets, so their single-allocation `simple` rollouts cannot overlap old and new writers. The owner accepted a brief Shale restart after staged validation. A controlled restart of the Shale preview on the x86 VM returned 46 failed HTTPS probes from this Mac between 4.87 and 23.14 seconds into a 0.25-second sampling run. Nomad reported the task restart complete after two seconds, before the Caddy route served requests again. The preview subsequently returned HTTP 200 with trusted TLS and one running allocation. This measures a restart under x86 emulation, not a production release rollout or physical-host downtime.
18
19Open Speed Test has no writable mounts or fixed ports, so its job now uses Nomad's overlapping canary. The first VM promotion automatically promoted a healthy canary, but one of 200 Mac HTTPS probes received HTTP 502 when Caddy dialed the retiring allocation's closed port before a route reload. The router now gives generated reverse proxies a five-second retry window and remembers failed upstream connections for 30 seconds, using [Caddy's documented load balancing options](https://caddyserver.com/docs/caddyfile/directives/reverse_proxy). The next staged release validated the generated Caddyfile and automatically promoted another healthy canary; 510 consecutive Mac HTTPS probes from 03:19:41 to 03:22:11 UTC returned 200, spanning its 03:21:05–03:21:20 rollout. This is a sampled VM result, not a guarantee that every request in future rollouts will succeed.
20
21For a new clone stage with a PostgreSQL database requirement, Snow Globe now snapshots the service dataset and PostgreSQL dataset in one ZFS operation, which [OpenZFS creates atomically](https://openzfs.github.io/openzfs-docs/man/v2.1/8/zfs-snapshot.8.html). It starts an isolated PostgreSQL container from the latter snapshot and copies the database from that container into a stage database on the live PostgreSQL server. The 2026-09-27 HedgeDoc preview `evil-hedgedoc-preview-31768845` completed its Nomad deployment and returned HTTP 200 from the Mac. Its service snapshot remains for the preview; the temporary PostgreSQL snapshot, clone, and container were removed. This aligns the file and database fork point for these services, while applications remain responsible for their own crash recovery from the snapshots.
22
23Writable external ZFS mounts now join that same snapshot operation. The recreated YouTube Feed preview `yt-feed-preview-63d74b72` mounted cloned service data and a cloned writable Clover configuration folder, then completed its Nomad deployment. Both source snapshots report `createtxg=35540`, and the preview's VM health check passed. The Mac route redirected to authentication as configured.
24
25The preview's web container wrote a disposable file through `/yt-config` as its assigned `3118:3000` identity. It appeared in the cloned Clover configuration folder with that owner and was absent from `/srv/clover/Documents/Config/Youtube Downloader`; the file was removed afterward. This verifies writable external mount isolation and group access through the container, beyond snapshot metadata alone.
26
27An encrypted ZFS rehearsal on the VM created separate source and staging encryption roots, then cloned a source snapshot beneath the staging root. The clone mounted, retained the source encryption root and origin, initially used `0B`, and accepted a write without changing the source file. The temporary datasets and keys were destroyed afterward. Production staging therefore needs the source dataset key loaded while its clone exists; placing the clone below a separately encrypted staging parent does not rekey it.
28
29Promotion of `c1f546fe904f4c33` stopped during Keycloak configuration. The old task digest included every file in each service folder, so a change to PostgreSQL's `provide.py` restarted PostgreSQL despite no database job configuration change. Keycloak's watched database endpoint then restarted its existing task; its group-level health check restarted that task again before x86 startup completed. A fresh Keycloak allocation completed startup, and all 19 production routes passed. Snow Globe now hashes source files into a task environment variable only for services with a `prepare` script, since those scripts change startup files under managed volumes. Editing PostgreSQL's provider script left its rendered job identical in a temporary release copy; editing qBittorrent's prepare script changed its rendered job. Single-container Nomad services now associate their checks with the task, and setup waits for its route before calling the app API. All 26 generated jobs validated. The new Keycloak preview reached HTTPS health and completed setup with zero restarts; after a manual in-place restart, it had no health-triggered restart through its nine-minute startup.
30
31Release `c19bee75fad72499` promoted successfully after backup `20260927T042521Z-9fcd75`; all 19 routes passed. Keycloak's production allocation reached health after its slow x86 build and startup with zero restarts. The Mac reached Keycloak and Shale with HTTP 200 and Jellyfin with its expected login redirect. During pgAdmin startup, QEMU paused with a host disk I/O error. Removing the two detached NixOS installer ISOs and moving the unused arm64 demo disk to `/Volumes/Project/Studio VM Archives/clover-studio-vm-arm64.qcow2` freed host space; QEMU resumed and the same promotion process finished. The resulting release history and `/opt/studio/current` both point at `c19bee75fad72499`.
32
33Read-only `nomad job plan` checks against the active release returned no allocation creates or destroys for PostgreSQL, Keycloak, or Shale. Their rendered HCL files were byte-identical to `nomad job inspect -hcl`. Nomad still described each plan as one in-place update without a field-level diff, so that phrase alone is not evidence of a changed job or a task restart. [The Nomad CLI defines exit code 0 as no allocation creation or destruction](https://developer.hashicorp.com/nomad/commands/job/plan). Resubmitting the identical PostgreSQL job retained its allocation `ff3fc333` and version 14; Keycloak retained allocation `d1c5e27a`.
34
35Release `9ee7ba520b01b1e5` staged YouTube Triage with its writable external clone, passed the VM NixOS dry build, and promoted after backup `20260927T053411Z-183aca`. The NixOS switch raised the demo pool size to 16 GB; all 19 routes passed. PostgreSQL, Keycloak, Jellyfin, Shale, and Dawarich kept allocation IDs `ff3fc333`, `d1c5e27a`, `c2b6c232`, `25050918`, and `abad9408` through this promotion. The Mac received HTTP 302 at the protected preview URL and HTTP 200 from Shale.
36
37The manual CLI rolled back from `9ee7ba520b01b1e5` to `c19bee75fad72499` after backup `20260927T054434Z-67d6c0`, switched the NixOS host configuration, and passed all 19 routes. Promoting the same preview again backed up the rollback state as `20260927T055034Z-27d895`, restored NixOS release `9ee7ba520b01b1e5`, and passed the same route sweep. Those five sampled allocations kept their IDs through both switches; the Mac still received Shale HTTP 200 and the protected preview's HTTP 302. Data restore was not invoked by code rollback.
1# Service dependencies and rollout
2
3Declare providers and requirements in Pkl. Provisioning allocates private
4inputs, and Nomad templates discover provider endpoints. Watched endpoint
5changes restart consumers; applications that persist internal endpoints must
6receive repeatable setup updates. [configure-arr.py](configure-arr.py), for
7example, derives Jackett/qBittorrent endpoints and remote path mappings from
8the service declarations.
9
10A successful non-sidecar prestart task is not rerun on every application
11restart. Dependent jobs therefore also need runtime retry and health recovery.
12The schema and renderer own retry delays, health-restart grace, and deployment
13deadlines. Verify the actual client connection after provider reallocation;
14a healthy application HTTP route alone does not prove database connectivity.
15
16The default single-allocation rollout stops the old writer before starting the
17new one. Writable SQLite stores cannot safely overlap writers. Stateless jobs
18can declare canary rollout when their ports and mounts allow it. Generated
19Caddy proxies retry connection failures while service discovery catches up;
20this does not guarantee uninterrupted long-running requests or WebSockets.
21
22A new cloned preview snapshots its service dataset, writable external ZFS
23mounts, and PostgreSQL dataset in one operation. An isolated PostgreSQL clone
24supplies the preview database. The temporary database clone is removed after
25copying. Repeating staging retains existing preview data; fresh isolation
26starts empty and rejects writable external mounts. Review outbound side
27effects independently of filesystem isolation.
28
29ZFS clones retain their source encryption root, even below the independently
30encrypted staging parent. Keep source keys available while clones exist.
31Fresh previews inherit staging encryption. Verify actual mount bindings before
32allowing disposable writes, especially read-only personal mounts.
33
34Inspect generated-job changes before expecting a restart. A provider script
35change can alter setup without changing a running job. Prepared startup files
36are included in task change detection; unrelated files are not. A Nomad plan
37reporting an in-place update alone does not establish that tasks will restart.
tools/shale-labels-test.py+5-5
......@@ -15,20 +15,20 @@ class ShaleTests(unittest.TestCase):
1515 def setUp(self):
1616 self.temp = tempfile.TemporaryDirectory()
1717 self.root = Path(self.temp.name)
18 self.env = patch.dict(os.environ, {'STUDIO_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')})
18 self.env = patch.dict(os.environ, {'SNOWGLOBE_SHALE_DATABASE': str(self.root / 'shale.sqlite'),
19 'SNOWGLOBE_DASHBOARD_DATA': str(self.root), 'SNOWGLOBE_DOMAIN': 'snowglobe.test', 'SNOWGLOBE_SHALE_POLICY': str(self.root / 'policy.json')})
2020 self.env.start()
2121 (self.root / 'policy.json').write_text(json.dumps({'actorOwners': {'ai': 'owner'}, 'statusDelegates': {'ai': ['chat']}}))
2222 with sqlite3.connect(self.root / 'accounts.sqlite') as db:
2323 db.execute("CREATE TABLE users(id TEXT PRIMARY KEY,profile TEXT,username TEXT GENERATED ALWAYS AS (json_extract(profile,'$.username')) STORED UNIQUE)")
2424 for name in ('owner', 'other', 'ai'):
2525 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']}
2727 with sqlite3.connect(self.root / 'connections.sqlite') as db:
2828 db.execute('CREATE TABLE records(key TEXT PRIMARY KEY,value TEXT,last_updated INTEGER)')
2929 db.execute('INSERT INTO records VALUES(?,?,0)', ('grant:fixture', json.dumps(self.grant)))
3030 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/'})))
3232 self.db = sqlite3.connect(self.root / 'shale.sqlite')
3333 self.db.executescript('''
3434 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):
3737 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);
3838 CREATE TABLE issues__labels(id INTEGER PRIMARY KEY,uuid TEXT,issue INTEGER REFERENCES issues(id),label INTEGER REFERENCES issue_labels(id));
3939 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');
4141 INSERT INTO repositories(id,name,owner,last_updated) VALUES(1,'chat',1,''),(2,'other',2,'');
4242 INSERT INTO issues(id,repo,number,status,last_updated) VALUES(1,1,1,'todo',''),(2,1,2,'done',''),(3,2,1,'todo','');
4343 ''')
tools/shale-labels.py+7-7
......@@ -15,7 +15,7 @@ Error = import_module('dashboard-run').Error
1515
1616
1717def 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'))
1919 return sqlite3.connect(path.as_uri() + '?mode=' + mode, uri=True, timeout=timeout)
2020
2121
......@@ -36,7 +36,7 @@ def metadata(request):
3636 or any(not isinstance(n, str) or len(n) > 254 for n in names)
3737 or request['repository'] is not None and not isinstance(request['repository'], str)):
3838 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'))
4040 with closing(database('ro', 2)) as db:
4141 db.execute('ATTACH DATABASE ? AS auth', ((accounts / 'accounts.sqlite').as_uri() + '?mode=ro',))
4242 result = {}
......@@ -46,14 +46,14 @@ def metadata(request):
4646 "JOIN auth.users h ON h.id=json_extract(a.profile,'$.owner') "
4747 "JOIN users o ON o.snowflake=h.id AND o.provider=u.provider "
4848 "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]):
5050 result[name] = {'model': model, 'owner': owner, 'picture': picture}
5151 for name, seed, picture in db.execute(
5252 "SELECT u.name,u.uuid,json_extract(a.profile,'$.attributes.picture[0]') "
5353 "FROM users u JOIN auth.users a ON a.id=u.snowflake "
5454 "WHERE u.provider=? AND coalesce(json_extract(a.profile,'$.kind'),'user') NOT IN ('ai','guest') "
5555 "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]):
5757 if picture:
5858 result[name] = {'avatar': seed, 'picture': picture}
5959 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):
117117 raise Error(400, 'Supply issue text within the tool limits.')
118118 if action == 'create_issue' and args['status'] not in ('needs_triage', 'todo'):
119119 raise Error(400, 'Choose triage or todo for a new issue.')
120 accounts = Path(os.environ.get('STUDIO_DASHBOARD_DATA', '/var/lib/studio/dashboard'))
121 domain = os.environ.get('STUDIO_DOMAIN', 'studio.test')
120 accounts = Path(os.environ.get('SNOWGLOBE_DASHBOARD_DATA', '/var/lib/snowglobe/dashboard'))
121 domain = os.environ.get('SNOWGLOBE_DOMAIN', 'snowglobe.test')
122122 with closing(database('rw', 10)) as db, db:
123123 db.row_factory = sqlite3.Row
124124 db.execute('PRAGMA foreign_keys=ON')
......@@ -139,7 +139,7 @@ def handle(request):
139139 native_caller = db.execute('SELECT id FROM users WHERE provider=? AND snowflake=?', ('snowglobe.' + domain, grant['user'])).fetchone()
140140 if not repo or not native_caller or repo[2] == 'off':
141141 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())
143143 owner = policy.get('actorOwners', {}).get(caller[0], grant['user'])
144144 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()
145145 if 'id' in args and not issue:
tools/shale-migration.md deleted-83
......@@ -1,83 +0,0 @@
1# Shale migration
2
3Shale is the sole Git server on Zenith. Personal Forgejo is retired. Retained Forgejo repositories and database exports remain migration sources; copying the existing Shale directory does not import repositories that only existed in Forgejo. The legacy multi-server SSH router is not part of the target setup.
4
5The 2026-10-04 personal inventory found 12 Shale owned repositories, no Shale mirrors, and 19 retained Forgejo bare repositories: 18 under `clo` and one under `nix`. Forgejo's retained LFS directory contains no files. Complete both imports before Shale's first production activation.
6
7The production data migration on 2026-10-04 completed before activating either production Shale or Postgres. The retained Shale copy passed checksum and SQLite checks, then all 19 Forgejo histories imported with verified object-file hashes and ref mappings. The result contains 21 repository records. All 11 private Forgejo sources retain private access; existing Shale identities, tokens, and sessions survive. The original session secret is preserved in the Nomad variable and its private recovery copy. Production import evidence is `/var/lib/studio/shale-forgejo-import-ldfl9zuy/repositories.json`; the earlier service dataset state is `globe/prod/shale@before-shale-import-1791160403-42496`.
8
9After copying the retained Shale state into `/srv/prod/shale`, [import-forgejo-to-shale.py](import-forgejo-to-shale.py) imports the additional histories while Shale stays stopped. Its metadata JSON comes only from the separately restored **personal** Forgejo PostgreSQL database:
10
11```sql
12SELECT coalesce(json_agg(x), '[]') FROM (
13 SELECT r.id, r.owner_id, u.lower_name AS owner_name,
14 r.lower_name, r.name, r.is_private, r.default_branch,
15 r.is_empty, r.is_mirror
16 FROM repository r JOIN "user" u ON u.id = r.owner_id
17 ORDER BY u.lower_name, r.lower_name
18) x;
19```
20
21```sh
22python3 tools/import-forgejo-to-shale.py \
23 --target /srv/prod/shale \
24 --metadata /run/personal-forgejo-repositories.json
25```
26
27The importer preserves existing Shale identities and repository records. Clover's repositories retain their names; the other namespace becomes `nix/config`. It copies and hashes Git objects without copying Forgejo hooks or configuration. Missing branches, tags, pull refs, and notes retain their names. A divergent branch or tag is retained under `refs/heads/forgejo/<owner>/...` or `refs/tags/forgejo/<owner>/...`; other conflicting refs use `refs/forgejo/<owner>/...`. Existing Shale refs retain their values, including newer histories already migrated from old mirrors. Former Forgejo mirrors become owned histories, with their original mirror status recorded in the private evidence. That directory contains every original ref, its destination, all copied object hashes, and the previous SQLite database.
28
29New repository access follows verified Forgejo visibility, with pushes restricted to the owner and issue submission disabled. When private Forgejo history joins an existing repository, public or unlisted permissions are tightened to private **before objects are copied**; existing `off` permissions remain off. An import failure must leave Shale stopped. Restoring only the previous database can re-expose imported private objects through its old public permissions, so recovery must preserve the tightened access or restore the complete service dataset.
30
31Existing Shale account IDs and OIDC subjects must survive the cutover. A deliberate issuer move uses `service/shale/prepare.py` to rebind the provider before startup; duplicate bindings stop the migration. Shale caches repository metadata and access at startup, so finish SQLite changes before starting the application. An isolated pinned-image test proved direct registration of a new repository: private anonymous web access returned 404 and Git discovery returned 401; after public permissions and a restart, its page and Git advertisement returned 200 with the original branch object ID. The test used copied data, `--network none`, and no published ports.
32
33A full-data test imported all 19 retained Forgejo histories into a disposable copy of the existing Shale state, yielding 21 repository records. Its conservative fixture metadata marked every incoming repository private. Every copied object file and every source ref passed verification. The pinned application then denied anonymous access to a new private repository and a formerly public collision, while preserving an unaffected public repository. On that isolated copy, public test permissions proved HTTP pages and Git advertisements for `bgds`, `home-infra`, and `nix/config`; `home-infra` advertised the original Forgejo `main` and `vllm`. An actual smart HTTP fetch returned a 53-object pack with a verified pack checksum. Production visibility must come from the restored Forgejo metadata, not this test fixture.
34
35After migration and authenticated browser checks, push the new infra `main` to `https://shale.paperclover.net/home-infra.git` with a Shale personal access token. The existing `home-infra` record and UUID are retained; the imported Forgejo branches remain available alongside the tested final `main`.
36
37The October 5 issue migration uses `tools/import-forgejo-issues.py` and the verified personal PostgreSQL export at `/var/lib/studio/forgejo-issue-migration/source.json`. Its sibling `source-proof.json` records the source checksum. The export contains 452 issues, 1,429 comments and events, 60 labels, 24 attachments, and 312 history revisions. Pull request discussions become issues with their original branch and merge metadata. Historical authors retain their names through non-login identities; `paperclover` maps to the existing Clover account. Original creation, update, and comment timestamps are preserved. Every source row is retained in the private `studio_forgejo_records` ledger, including revision history that Shale cannot present as editable comments.
38
39Run this while the target job is stopped and its allocations have exited:
40
41```sh
42python3 tools/import-forgejo-issues.py \
43 --target /srv/prod/shale \
44 --source /var/lib/studio/forgejo-issue-migration/source.json
45```
46
47For an isolated stage, add `--rehearsal` and use `/srv/staging/shale-preview-<id>`. The importer verifies the export checksum, checks that the target job is stopped before writing and immediately before commit, backs up SQLite into a private evidence directory, verifies native issue records remain unchanged, and supports an idempotent rerun of the same export. Take a full service ZFS snapshot before the production import as well. Do not replace production with the stage clone: import again into the stopped production dataset so newer native issues survive.
48
49Six occupied numbers are remapped: `chat` #1→#6 and #2→#7; `home-infra` #1→#38, #2→#39, and #3→#40; `react-mutation` #1→#19. All other original numbers remain. Explicit Forgejo issue links are rewritten and remapped bodies identify their original number. Bare `#references` and code text remain untouched. Attachments are copied with verified SHA-256 hashes and served through an authorization check against their associated Shale issue. Their local files are readable only by root and Caddy; private issue attachments remain private.
50
51The writable ZFS rehearsal `shale-preview-0242cee6` starts from all 104 existing native issues and imports to 556 total. It preserves the original Clover OIDC identity. September's `r1616-ga87d2f5.zig.0.16.0` avoids the `r1758` anonymous deleted-comment crash, but its Markdown scanner uses a shared capture buffer and crashes under concurrent fenced-code rendering. The documented `NPROC=1` worker setting avoids that race. With this setting, 904 authenticated/anonymous imported-issue requests passed with eight clients, all 24 attachment hashes and access checks passed, and browser closing of a disposable copy of `chat` #1 succeeded. Production `chat` #1 remains untouched.
52
53Production issue import completed on October 5 under release `dda941e618934ad9`, from committed main `51be72a9`. Recovery snapshot: `globe/prod/shale@before-forgejo-issues-20261005T080143Z-14c71a`. The private import report and SQLite backup live at `/var/lib/studio/forgejo-issue-migration/issue-import-c726euv2`. All 104 native issues survived alongside the 452 imported issues. After the route reload settled, 904 concurrent HTTPS issue reads passed (644 successful reads, 260 expected private-page denials), all 24 attachment hashes and access checks passed, SQLite integrity passed, and a forged-Origin request returned 403. Browser navigation confirmed historical timestamps, comments, labels, and status on a live imported issue. Native `chat` #1 remains Todo. The disposable Keycloak rehearsal was destroyed after verification; the production recovery snapshot and private evidence remain.
54
55The r1616 build predated hidden form CSRF tokens. The router's exact HTTPS Origin guard preceded all Shale handlers inside an explicit Caddy `route`; default directive ordering could otherwise bypass it. Missing, wrong, and suffix-forged origins returned 403 without a database change on the clone. The valid site origin allowed a status change, while Basic-auth Git requests still reached Shale. At that time, the MCP adapter accepted tokenless issue forms only with the verified `r1616` structural footer and no CSRF-token input anywhere on the page.
56
57The October 5 `r1763-g9f5b1c7.zig.0.16.0` upgrade rehearsal passed anonymous reads of the formerly crashing issues, Unicode issue creation and comments, issue closing with a comment Delete form present, access denial, restart persistence, token revocation, and logout. The Rust adapter parsed its actual owner issue markup and accepted its status/comment CSRF fields. All migrated SQLite rows remained identical. Eight-worker concurrent Markdown rendering still crashed; keep `NPROC=1`, which passed 280 concurrent fenced-code requests. The injected issue-form script is no longer needed. Private evidence lives at `/var/lib/studio/shale-upgrade-0680d28c`; its disposable containers were removed after testing.
58
59Shale allocates an issue number from the issue with the highest SQLite row ID. The importer now inserts by destination number, including remapped collisions. The already-imported database needs `--repair-issue-order` once while its job is stopped: the guarded repair saves a SQLite backup, swaps six imported surrogate IDs, rewrites foreign keys and ledger references, and verifies every table's contents using issue UUIDs. Native IDs, public numbers, timestamps, comments, labels, attachments and history remain intact. It refuses duplicate numbers or changes to native issue IDs. On the repaired native-auth clone, the actual Rust Backend created `home-infra` #41, `react-mutation` #20 and `chat` #8, then commented on and closed the disposable `home-infra` issue. Fresh import, repeated import, repeated repair, and refusal checks passed.
60
61Production upgraded to `r1763` on October 5 in release `9ef0e1fd9c7a72bc`, from main `38ee0683`. The pre-cutover Shale recovery snapshot is `globe/prod/shale@native-auth-20261005T091312Z`. Fresh normal and guest sign-in callbacks returned 200; the existing Clover session and identity remained intact. All 452 imported issue routes passed concurrent anonymous checks (192 successful reads and 260 expected private-page denials), all 24 attachment hash/access checks passed, and all 556 issues remained unique with valid foreign keys. Native `chat` #1 remains Todo. The live proof is recorded in `/var/lib/studio/shale-upgrade-0680d28c/upgrade-validation.json`.
62
63The October 4 transport check inspected the then-pinned image in disposable containers without mounting real app data. Its embedded Git endpoint and account settings use HTTP and personal access tokens; no SSH listener, authorized-key interface, or forced-command handler was found. The [official installation](https://astheno.software/shale/installation/) and [configuration reference](https://astheno.software/shale/reference/environment/) also expose HTTP serving and OAuth login without SSH configuration. A `git` account must either use a Shale-aware SSH bridge or await native SSH support. Direct filesystem Git commands would bypass Shale's authorization.
64
65Zenith's Shale app directory contains a small SQLite database and 419 MB of owned repositories. `bash tools/import-shale.sh shale-preview-4eea0e3b` copied `data`, `repositories_owned`, and `repositories_mirrors` opaquely from the read-only `storage1/apps@hourly-2026-09-26_05-00` snapshot. It verified checksums and SQLite integrity, then restarted the preview. Both sides had 11 top-level owned repository directories; the preview had one healthy Nomad allocation and returned HTTPS 200. Repository contents were not inspected.
66
67For the production copy, stop Zenith's Shale container and the Snow Globe Shale job, set `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT` for the new host, then run `bash tools/import-shale.sh shale`. The importer checks both jobs remain stopped, snapshots the destination dataset, verifies all three copied directories, and leaves Snow Globe stopped. Start the new job after the copy, check the SQLite state and a known login through the new Keycloak client, then switch the public route. The destination snapshot printed by the importer remains available for recovery.
68
69After a same-machine OS replacement, set `STUDIO_LEGACY_HANDOFF` to the [offline handoff](legacy-handoff.md) directory as well. The importer then reads the retained Shale directory from the new host's mounted old apps dataset, with no old Docker dependency.
70
71## Imported repository HTTP pushes
72
73The Forgejo importer originally omitted `http.receivepack=true`, which Shale sets when it creates an owned repository. Shale checks its push ACL before invoking `git-http-backend`, but does not set `REMOTE_USER`; Git's default therefore rejected authorized pushes to imported repositories. The importer now writes the setting, and Shale's prepare step repairs missing settings without replacing an explicit disable. Production `config` remains owner-only for pushes.
74
75Shale also forwards CGI `Status` as an ordinary header on HTTP 200. The Git-specific Caddy handler translates Git's error statuses into HTTP statuses and removes the CGI header. A disposable production database/repository copy verified anonymous and invalid credentials return 401, authenticated non-owners return 403, owner discovery advertises `main=37665e69e1aa954f0dec06b1cafa1612f44dc907`, and an actual `jj git push --bookmark main` advances the clone to `b8e734ce6aabd94a7e1aacfc989467662ca27dbe`. Disabled receive-pack returns actual HTTP 403; invalid method/content type return 400/415 without a `Status` header. No production token was added.
76
77## r1807 JSON upgrade, 2026-10-13 UTC
78
79The pinned image in [service.pkl](../service/shale/service.pkl) serves repository lists, issue lists, and issue details as JSON with `Accept: application/json` on their existing URLs. The MCP reads those responses, retaining issue numbers as `id` and raw Markdown in comment text. Native JSON omits comment IDs and issue-list creation times, so the MCP omits those fields. Account settings return 406 for JSON, and label JSON omits numeric IDs; those two reads retain their HTML checks. Writes still use the host broker for durable model authorship, repository permissions, delegated statuses, and grant revocation.
80
81The inherited `shale-preview-8ff39b2c` contained earlier disposable test writes. Rehearsing its previous pinned image followed by r1807 preserved every row of all 10 existing tables, including 559 issues; SQLite integrity passed and its allocation had zero restarts. Preview mirror cloning and polling are disabled. Public browsing, README/file navigation, open/closed issue filters, issue detail, labels, keyboard navigation, and 390-pixel layouts passed browser checks.
82
83An independent instance used only synthetic databases, credentials, certificates, and native Snowglobe OIDC. The candidate Nix dashboard passed linking, every issue/label operation, raw Markdown and durable model attribution, anonymous/other-user/selected-repository denials, exact-Origin enforcement, uncertain-write handling without replay, 80 concurrent JSON reads, 280 concurrent fenced-Markdown reads, backend/dashboard restart persistence, revocation, unlinking, and SQLite integrity. `NPROC=1` remains in place. The router test also verifies JSON headers and bytes pass through unchanged. Restricted verification evidence is `/var/lib/studio/shale-json-upgrade-20261013`.
tools/snowglobe-hardware.md created+105
......@@ -0,0 +1,105 @@
1# Snow Globe hardware and recovery
2
3## Physical host
4
5Snow Globe is the existing Ryzen 9 5950X computer, with 128 GB RAM, an RTX 3090,
6a 500 GB WD Blue SN5000 NVMe OS disk, and four 8 TB WD80EFPX disks in the
7`globe` RAIDZ1 pool. The onboard RTL8168 Ethernet connection is 1 Gb/s.
8[The host configuration](../nixos/snowglobe.nix),
9[network configuration](../nixos/snowglobe-network.nix), and
10[filesystem configuration](../nixos/hardware-configuration.nix) own installed
11settings. Use the release deployment workflow for host changes.
12
13Read-only inspection on 2026-10-16 confirmed the physical machine at
14`root@10.0.0.1:22`, a healthy `globe` pool with zero known data errors, and
15mounted production, staging, Clover, and Media datasets. The host configuration
16names it `snowglobe`. Renaming the computer preserves the existing hardware,
17pool, and application state.
18
19## Storage boundaries
20
21| Dataset | Mount | Role |
22| --- | --- | --- |
23| `globe` | `/srv` | Pool root; unencrypted |
24| `globe/clover` | `/srv/clover` | Personal files; independent encryption root |
25| `globe/clover/Media` | `/srv/clover/Media` | Media; independent encryption root |
26| `globe/prod` | `/srv/prod` | Encrypted managed service data |
27| `globe/staging` | `/srv/staging` | Encrypted preview data |
28| `globe/apps` | `/mnt/storage1/apps` | Retained application recovery source |
29| `globe/logs` | `/srv/logs` | Independent encrypted dataset |
30
31The retained apps tree and other old datasets are not active deployment
32sources. Removing obsolete repository import tools does not authorize destroying
33those datasets, snapshots, or private migration evidence.
34
35Clover and Media are case-insensitive POSIX-ACL filesystems. Their current
36properties are `acltype=posix`, `aclmode=discard`, `aclinherit=discard`.
37Production and staging also use POSIX ACLs. Preserve allocated UIDs and the
38shared group 3000. Test permission changes on a clone; do not recursively
39change personal ownership to repair one service.
40
41The [site mapping](../config/site.pkl) owns media folder names. Saved application
42paths are preserved by the service bind mounts: qBittorrent sees Seedbox at
43both `/data/media/Seedbox` and `/data/media/torrent`; Jellyfin keeps its
44`/media/jellyfin/...` paths. Preserve those mappings and YouTube archive files
45alongside their videos when reorganizing media.
46
47Samba serves these datasets directly using POSIX permissions. Its declaration
48preserves shared editing with `0660` files and `2770` directories and uses
49kernel oplocks for service-write visibility. Run
50`swift tools/samba-macos-test.swift <mounted-share>` against disposable files
51after changing permissions or SMB configuration. The probe exercises Cocoa
52safe saves, packages, metadata/resource forks, and cleanup.
53
54## Unlock and recovery
55
56The host configuration lists six encrypted roots and their systemd credential
57names. TPM-encrypted blobs live in `/etc/credstore.encrypted`; the unlock unit
58runs after pool import and before mounting. Plaintext keys must stay outside
59the Nix store and tracked configuration. Nomad refuses to start without the
60actual pool, Clover, Media, production, and staging mounts.
61
62Credentials are bound to the machine's TPM and PCR 7. Clearing/replacing the
63TPM or changing firmware can require manual unlock and resealing. Secure Boot
64is disabled, so automatic TPM unlock does not establish a trusted boot chain.
65Keep independent recovery keys when replacing hardware.
66
67The private off-server recovery archive on Clover's Mac includes the additional
68production/staging keys in `postgres-backups/new-os-dataset-keys.json` and the
69verified pre-install PostgreSQL logical/physical exports in
70`postgres-backups/20261004T230507Z-e75419.tar`. Original dataset keys
71and the former OS configuration are in the same private recovery collection.
72These paths document locations only; they do not establish current backup
73completeness or authorize opening private contents.
74
75For manual unlock on a confirmed recovery host, recover the required key into
76a root-only file in `/run`, then run these commands one at a time with the
77verified dataset substituted:
78
79```sh
80zfs load-key -L file:///run/<private-key-file> <dataset>
81rm /run/<private-key-file>
82zfs mount <dataset>
83findmnt --mountpoint <expected-mountpoint>
84```
85
86Loading a key does not mount the filesystem. Mount parents before children;
87never overlay a nonempty mountpoint to bypass a mount failure.
88
89## Control state and backups
90
91The NVMe contains both Nomad state and `/var/lib/snowglobe`: service identities,
92ACL token files, dashboard accounts, release history, and backup manifests and
93database dumps. Read-only `findmnt` inspection on 2026-10-16 confirmed both
94control-state locations remain on the ext4 OS filesystem, outside the ZFS
95service datasets. Replacing the OS disk without recovering this state loses
96more than service files. A Nomad snapshot contains jobs, ACLs, and secret
97variables; it does not contain the separate dashboard account database or UID
98registry. See [data restore](data-restore.md) for service recovery boundaries.
99
100No automatic ZFS snapshot or release-backup retention schedule is configured.
101Release backups do not substitute for independent off-server recovery copies.
102Before destructive storage or OS work, verify key recovery and application/
103database restores from at least two restricted copies stored separately off
104this computer. Preserve the existing encrypted roots, pool host ID, numeric
105owners, SSH trust, and retained recovery sources through a rebuild.
tools/snowglobe-secret-files-test.py created+72
......@@ -0,0 +1,72 @@
1#!/usr/bin/env python3
2import json
3import os
4from pathlib import Path
5import subprocess
6import tempfile
7import unittest
8
9import snowglobe
10
11
12class SecretFiles(unittest.TestCase):
13 @classmethod
14 def setUpClass(cls):
15 with tempfile.TemporaryDirectory(prefix="snowglobe-secret-template-") as temporary:
16 fixture = Path(temporary) / "fixture.pkl"
17 fixture.write_text('amends ' + json.dumps((snowglobe.REPO / "config/Service.pkl").as_uri()) + '\nname = "Fixture"\ncontainer { image = "localhost/fixture:pinned" }\n')
18 result = subprocess.run([os.environ.get("PKL", "pkl"), "eval", "-p", "uid=3132", "-p", "serviceId=fixture", str(fixture)], check=True, capture_output=True, text=True)
19 cls.fixture = json.loads(result.stdout)
20 cls.fixture.update(uid=3132, sourceId="fixture", inputs={})
21 cls.fixture.pop("requirements")
22
23 def setUp(self):
24 self.data = json.loads(json.dumps(self.fixture))
25 self.task = self.data["containers"]["app"]
26 self.task["secretFiles"] = {"/run/secrets/oidc.json": '{{ with nomadVar "nomad/jobs/fixture/inputs/oidc" }}{"clientSecret":{{ .clientSecret.Value | toJSON }}}{{ end }}'}
27
28 def test_private_allocation_template_and_read_only_file_mount(self):
29 rendered = snowglobe.render(self.data, {"fixture": self.data})
30 self.assertIn('"secrets/oidc.json:/run/secrets/oidc.json:ro"', rendered)
31 self.assertIn('destination = "secrets/oidc.json"', rendered)
32 self.assertIn('perms = "0400"', rendered)
33 self.assertIn('uid = 3132', rendered)
34 self.assertIn('gid = 3132', rendered)
35 self.assertIn('error_on_missing_key = true', rendered)
36 self.assertIn(self.task["secretFiles"]["/run/secrets/oidc.json"], rendered)
37 self.assertNotIn('env = true', rendered)
38 self.assertNotIn('change_mode =', rendered)
39
40 def test_services_without_files_gain_no_template_or_mount(self):
41 self.task["secretFiles"] = {}
42 rendered = snowglobe.render(self.data, {"fixture": self.data})
43 self.assertNotIn('template {', rendered)
44 self.assertNotIn('secrets/', rendered)
45
46 def test_unsafe_and_colliding_targets_are_rejected(self):
47 for target in ("relative.json", "/run/../secret.json", "/run/./secret.json", "/run//secret.json", "/run/secrets/", "/secrets/file", "/secrets", "/run/app.env", "/run/app-secret.env", "/run/nomad_token", "/run/line\nbreak"):
48 with self.subTest(target=target):
49 self.task["secretFiles"] = {target: "{}"}
50 with self.assertRaisesRegex(ValueError, "invalid secret file target"):
51 snowglobe.render(self.data, {"fixture": self.data})
52 self.task["secretFiles"] = {"/one/config.json": "{}", "/two/config.json": "{}"}
53 with self.assertRaisesRegex(ValueError, "invalid secret file target"):
54 snowglobe.render(self.data, {"fixture": self.data})
55 self.task["secretFiles"] = {"/run/secrets/oidc.json": "{}"}
56 self.task["volumes"] = {"/run/secrets/oidc.json": {}}
57 with self.assertRaisesRegex(ValueError, "invalid secret file target"):
58 snowglobe.render(self.data, {"fixture": self.data})
59
60 def test_image_user_and_heredoc_injection_are_rejected(self):
61 self.task["imageUser"] = True
62 with self.assertRaisesRegex(ValueError, "service-owned"):
63 snowglobe.render(self.data, {"fixture": self.data})
64 self.task["imageUser"] = False
65 for body in ("EOF", "{}\nEOF\nmalicious", "{}\nEOF\r\nmalicious"):
66 self.task["secretFiles"] = {"/run/secrets/oidc.json": body}
67 with self.assertRaisesRegex(ValueError, "invalid secret template delimiter"):
68 snowglobe.render(self.data, {"fixture": self.data})
69
70
71if __name__ == "__main__":
72 unittest.main()
tools/snowglobe-sso-test.py created+77
......@@ -0,0 +1,77 @@
1#!/usr/bin/env python3
2import json
3import os
4from pathlib import Path
5import subprocess
6import tempfile
7import unittest
8from unittest.mock import patch
9
10import snowglobe
11
12
13class SsoConnectivity(unittest.TestCase):
14 client = '''new sso.Client {
15 clientId = module.id
16 name = module.name
17 redirectUris { "https://fixture.example/api/callback" }
18}'''
19
20 def load(self, requirements=client, extra_hosts=()):
21 with tempfile.TemporaryDirectory(prefix="snowglobe-sso-") as temporary:
22 fixture = Path(temporary) / "fixture.pkl"
23 fixture.write_text(f'''amends {json.dumps((snowglobe.REPO / "config/Service.pkl").as_uri())}
24import {json.dumps((snowglobe.REPO / "config/OpenID.pkl").as_uri())} as sso
25name = "Fixture"
26requirements {{ {requirements} }}
27containers {{
28 ["app"] {{
29 image = "localhost/fixture:pinned"
30 extraHosts {{ {"; ".join(json.dumps(host) for host in extra_hosts)} }}
31 }}
32 ["worker"] {{ image = "localhost/fixture:pinned" }}
33}}
34''')
35 def pkl(*args, capture=False):
36 return subprocess.run([os.environ.get("PKL", "pkl"), *args[1:]], check=True, capture_output=capture, text=True)
37 with patch.object(snowglobe, "service_files", return_value={"fixture": fixture}), patch.object(snowglobe, "identity", return_value=3132), patch.object(snowglobe, "command", side_effect=pkl):
38 return snowglobe.load("fixture", {"domain": "fixture.example"})
39
40 def render(self, data):
41 return snowglobe.render(data, {"fixture": data})
42
43 def test_client_declaration_routes_every_task_without_changing_provider_inputs(self):
44 data = self.load()
45 self.assertEqual(data["inputs"]["oidc"], {
46 "alias": "oidc", "provider": "snowglobe", "kind": "client", "clientId": "fixture",
47 "name": "Fixture", "redirectUris": ["https://fixture.example/api/callback"],
48 "usernameAliases": {}, "allowGuests": False, "usernameRequired": False,
49 })
50 rendered = self.render(data)
51 self.assertEqual(rendered.count('extra_hosts = ["snowglobe.fixture.example:host-gateway"]'), 2)
52 self.assertNotIn("snowglobe.paperclover.net", rendered)
53
54 def test_explicit_hosts_take_precedence_and_duplicates_are_removed(self):
55 data = self.load(extra_hosts=[
56 "Snowglobe.Fixture.Example:192.0.2.10",
57 "other.example:2001:db8::10",
58 "other.example:2001:db8::10",
59 ])
60 rendered = self.render(data)
61 self.assertIn('extra_hosts = ["Snowglobe.Fixture.Example:192.0.2.10", "other.example:2001:db8::10"]', rendered)
62 self.assertEqual(rendered.count("snowglobe.fixture.example:host-gateway"), 1)
63
64 def test_multiple_clients_share_one_host_binding_per_task(self):
65 other = self.client.replace('clientId = module.id', 'alias = "other"; clientId = "other"')
66 data = self.load(requirements=self.client + "\n" + other)
67 self.assertEqual(self.render(data).count("snowglobe.fixture.example:host-gateway"), 2)
68
69 def test_services_without_sso_preserve_their_explicit_hosts(self):
70 data = self.load(requirements="", extra_hosts=["other.example:host-gateway"])
71 rendered = self.render(data)
72 self.assertIn('extra_hosts = ["other.example:host-gateway"]', rendered)
73 self.assertNotIn("snowglobe.fixture.example", rendered)
74
75
76if __name__ == "__main__":
77 unittest.main()
tools/snowglobe.py created+1303
......@@ -0,0 +1,1303 @@
1#!/usr/bin/env python3
2import argparse
3from contextlib import nullcontext
4import fcntl
5import hashlib
6import json
7from importlib import import_module
8import os
9from pathlib import Path
10import re
11import secrets
12import shutil
13import subprocess
14import sys
15import tempfile
16import time
17
18from data import cloned_postgres, dataset_for
19
20
21transition = import_module("namespace-transition")
22transition.inherit_environment()
23
24REPO = Path(__file__).resolve().parent.parent
25SERVICES = REPO / "service"
26STATE = Path("/var/lib/snowglobe")
27IDENTITIES = STATE / "identities.json"
28ASSETS = Path("/var/lib/caddy/snowglobe")
29NAME = re.compile(r"[a-z][a-z0-9-]*\Z")
30
31
32def command(*args, capture=False, **kwargs):
33 return subprocess.run(args, check=True, text=True, capture_output=capture, **kwargs)
34
35
36def service_files():
37 files = {}
38 for directory in SERVICES.iterdir():
39 if not directory.is_dir():
40 continue
41 for path in directory.glob("*.pkl"):
42 name = directory.name if path.name == "service.pkl" else path.stem
43 if name in files:
44 raise ValueError(f"duplicate service definition: {name}")
45 files[name] = path
46 return files
47
48
49def services():
50 return sorted(service_files())
51
52
53def service_dir(name):
54 path = service_files()[name]
55 return path.parent if path.name == "service.pkl" else path.parent / name
56
57
58def dependencies(data):
59 return set(data["dependsOn"]) | {item["provider"] for item in data["inputs"].values() if item["provider"] != "snowglobe"}
60
61
62def ordered(data):
63 pending = {item["id"]: item for item in data}
64 result = []
65 while pending:
66 ready = [
67 item
68 for item in pending.values()
69 if not dependencies(item) & pending.keys()
70 ]
71 if not ready:
72 raise ValueError("cycle in service dependencies")
73 for item in ready:
74 result.append(item)
75 del pending[item["id"]]
76 return result
77
78
79def identity(name):
80 STATE.mkdir(parents=True, exist_ok=True)
81 if not IDENTITIES.exists():
82 write_private(IDENTITIES, (REPO / "config/identities.json").read_text())
83 with (IDENTITIES.parent / ".identities.lock").open("w") as lock:
84 fcntl.flock(lock, fcntl.LOCK_EX)
85 with IDENTITIES.open() as file:
86 ids = json.load(file)
87 if len(set(ids.values())) != len(ids):
88 raise ValueError("duplicate service UIDs")
89 if name not in ids:
90 used = set(ids.values())
91 ids[name] = next(uid for uid in range(3100, 60000) if uid not in used)
92 pending = IDENTITIES.with_suffix(".pending")
93 pending.write_text(json.dumps(ids, indent=2) + "\n")
94 pending.replace(IDENTITIES)
95 return ids[name]
96
97
98def load(name, properties, instance_id=None):
99 files = service_files()
100 if not NAME.fullmatch(name) or name not in files:
101 raise ValueError(f"unknown service: {name}")
102 instance_id = instance_id or name
103 if not NAME.fullmatch(instance_id):
104 raise ValueError(f"invalid instance ID: {instance_id}")
105 uid = identity(name)
106 result = command(
107 "pkl",
108 "eval",
109 *(
110 part
111 for key, value in {**properties, "serviceId": instance_id, "uid": uid, "preview": str(instance_id != name).lower()}.items()
112 for part in ("-p", f"{key}={value}")
113 ),
114 str(files[name]),
115 capture=True,
116 )
117 data = json.loads(result.stdout)
118 if data["id"] != instance_id:
119 raise ValueError(f"service ID must match deployment: {instance_id}")
120 inputs = {}
121 for requirement in data.pop("requirements"):
122 alias = requirement["alias"]
123 if not NAME.fullmatch(alias) or alias == "own" or alias in inputs:
124 raise ValueError(f"invalid or duplicate requirement alias: {alias}")
125 inputs[alias] = requirement
126 issuer_hosts = [request.pop("issuerHostname") for request in inputs.values()
127 if request["provider"] == "snowglobe" and request["kind"] == "client"]
128 data["inputs"] = inputs
129 data["uid"] = uid
130 data["sourceId"] = name
131 for task_name, task in data["containers"].items():
132 task["extraHosts"] = list(dict.fromkeys(task["extraHosts"]))
133 for hostname in issuer_hosts:
134 if all(host.split(":", 1)[0].lower() != hostname.lower() for host in task["extraHosts"]):
135 task["extraHosts"].append(f"{hostname}:host-gateway")
136 if bool(task.get("image")) == bool(task.get("build")):
137 raise ValueError(f"{name}.{task_name} needs one image or build directory")
138 if task.get("build"):
139 if REPO.parent == Path("/opt/snowglobe/releases").resolve():
140 context = config_path(name, task["build"])
141 if not context.is_dir() or not (context / "Dockerfile").is_file():
142 raise ValueError(f"invalid build context: {name}.{task_name}")
143 digest = hashlib.sha256()
144 for path in sorted(context.rglob("*")):
145 if path.is_file():
146 digest.update(str(path.relative_to(context)).encode() + b"\0")
147 digest.update(path.read_bytes())
148 tag = digest.hexdigest()[:16]
149 elif not (service_dir(name) / task["build"] / "Dockerfile").is_file() and not (service_dir(name) / "build-source.json").is_file():
150 raise ValueError(f"missing build source: {name}.{task_name}")
151 else:
152 tag = REPO.name
153 task["image"] = f"localhost/snowglobe/{name}-{task_name}:{tag}"
154 return data
155
156
157def q(value):
158 return json.dumps(value, ensure_ascii=False)
159
160
161def write_private(path, content):
162 pending = None
163 try:
164 with tempfile.NamedTemporaryFile("w", dir=path.parent, delete=False) as file:
165 pending = Path(file.name)
166 file.write(content)
167 pending.replace(path)
168 finally:
169 if pending:
170 pending.unlink(missing_ok=True)
171
172
173def host_path(root, relative):
174 if relative == ".":
175 return root
176 part = Path(relative)
177 if part.is_absolute() or ".." in part.parts or not part.parts:
178 raise ValueError(f"invalid relative path: {relative}")
179 return str(Path(root) / part)
180
181
182def config_path(service, relative):
183 root = service_dir(service).resolve()
184 source = (root / relative).resolve()
185 if not source.is_relative_to(root) or not source.exists():
186 raise ValueError(f"invalid config path: {relative}")
187 return source
188
189
190def config_assets(data):
191 paths = set()
192 for task in data["containers"].values():
193 paths.update(volume["config"] for volume in task["volumes"].values() if volume.get("config"))
194 if task.get("http"):
195 paths.update(task["http"]["overrideFiles"].values())
196 sources = {rel: config_path(data.get("sourceId", data["id"]), rel) for rel in paths}
197 digest = hashlib.sha256()
198 for rel, source in sorted(sources.items()):
199 digest.update(rel.encode())
200 files = sorted(source.rglob("*")) if source.is_dir() else [source]
201 for file in files:
202 if file.is_symlink():
203 raise ValueError(f"config asset cannot be a symlink: {file}")
204 if file.is_file():
205 digest.update(str(Path(rel) / file.relative_to(source)).encode() if source.is_dir() else rel.encode())
206 digest.update(file.read_bytes())
207 return ASSETS / data["id"] / digest.hexdigest()[:16], sources
208
209
210def render(data, definitions):
211 if not data["containers"]:
212 return ""
213 name = data["id"]
214 asset_dir, _ = config_assets(data)
215 prepare_digest = None
216 if data.get("prepare"):
217 source = service_dir(data.get("sourceId", name))
218 digest = hashlib.sha256()
219 for path in sorted(source.rglob("*")):
220 if not path.is_file() or "__pycache__" in path.parts or path.suffix == ".pyc":
221 continue
222 if path.name == "service.pkl" or path.name.startswith("icon"):
223 continue
224 digest.update(str(path.relative_to(source)).encode() + b"\0")
225 digest.update(path.read_bytes())
226 prepare_digest = digest.hexdigest()[:16]
227 routed = [task["http"] for task in data["containers"].values()
228 if task.get("http") and task["http"].get("hostname")]
229 primary = routed[0] if routed else {}
230 requirements = {provider: "startup" for provider in data["dependsOn"]}
231 requirements.update({item["provider"]: item["kind"] for item in data["inputs"].values()})
232 secrets_meta = [
233 {"name": name, "generated": True, "bytes": spec["bytes"]}
234 for name, spec in data["secrets"].items()
235 ] + [{"name": name, "generated": False} for name in data["requiredSecrets"]]
236 lines = [
237 f"job {q(name)} {{",
238 ' datacenters = ["clover"]',
239 ' type = "service"',
240 ' meta {',
241 f" snowglobe_service = {q(data['sourceId'])}",
242 f" snowglobe_name = {q(data['name'])}",
243 f" snowglobe_tagline = {q(data['tagline'])}",
244 f" snowglobe_hostname = {q(primary.get('hostname') or '')}",
245 f" snowglobe_launcher = {q(str(data['launcher']).lower())}",
246 f" snowglobe_auth_role = {q(data.get('access') or primary.get('authRole') or '')}",
247 f" snowglobe_trace_service = {q(data.get('traceServiceName') or '')}",
248 f" snowglobe_metrics_pushed = {q(str(data['metricsPushed']).lower())}",
249 f" snowglobe_requires = {q(json.dumps(requirements))}",
250 f" snowglobe_secrets = {q(json.dumps(secrets_meta))}",
251 ' }',
252 ' group "app" {',
253 ]
254 if dependencies(data):
255 lines += [
256 " restart {",
257 " attempts = 3",
258 ' delay = "1m"',
259 ' interval = "4m"',
260 ' mode = "delay"',
261 " }",
262 ]
263 if data["rollout"] == "overlapped":
264 for task in data["containers"].values():
265 if task["hostNetwork"] or any(
266 endpoint and endpoint.get("hostPort") is not None
267 for endpoint in (task.get("http"), *task["tcp"])
268 ) or any(not volume["readOnly"] for volume in task["volumes"].values()):
269 raise ValueError(f"overlapped rollout requires dynamic ports and read-only mounts: {name}")
270 elif data["rollout"] != "simple":
271 raise ValueError(f"unknown rollout: {data['rollout']}")
272 if data["rollout"] == "overlapped" or data.get("healthyDeadline"):
273 lines.append(" update {")
274 if data["rollout"] == "overlapped":
275 lines += [" canary = 1", " auto_promote = true", " auto_revert = true"]
276 if data.get("healthyDeadline"):
277 lines += [f" healthy_deadline = {q(data['healthyDeadline'])}", ' progress_deadline = "0"']
278 lines.append(" }")
279 if data.get("healthyDeadline"):
280 lines += [" migrate {", f" healthy_deadline = {q(data['healthyDeadline'])}", " }"]
281 ports = {}
282 network = []
283 host_network = any(task["hostNetwork"] for task in data["containers"].values())
284 if host_network and not all(task["hostNetwork"] for task in data["containers"].values()):
285 raise ValueError("mixed host and bridge networking in one group")
286 for task_name, task in data["containers"].items():
287 for kind, endpoint in [("http", task.get("http")), *((port["name"], port) for port in task["tcp"])]:
288 if endpoint:
289 label = kind if len(data["containers"]) == 1 else f"{task_name}-{kind}"
290 if label in ports.values():
291 raise ValueError(f"duplicate port label: {label}")
292 ports[(task_name, kind)] = label
293 network.append(f" port {q(label)} {{")
294 if endpoint.get("hostPort") is not None:
295 network.append(f" static = {endpoint['hostPort']}")
296 if not task["hostNetwork"]:
297 network.append(f" to = {endpoint['containerPort']}")
298 if endpoint.get("loopback") or (not task["hostNetwork"] and kind == "http" and endpoint.get("hostPort") is None):
299 network.append(' host_network = "loopback"')
300 network.append(" }")
301 if network:
302 lines.append(" network {")
303 if host_network:
304 lines.append(' mode = "host"')
305 lines += network + [" }"]
306 for provider_id in sorted(dependencies(data)):
307 provider = definitions[provider_id]
308 for provider_task, container in provider["containers"].items():
309 endpoint = container.get("http")
310 if not endpoint or not endpoint.get("hostname") or endpoint.get("authRole"):
311 continue
312 host = endpoint["hostname"]
313 task_name = f"wait-{provider_id}-{provider_task}"
314 lines += [
315 f" task {q(task_name)} {{",
316 ' driver = "podman"',
317 " lifecycle {",
318 ' hook = "prestart"',
319 " sidecar = false",
320 " }",
321 " config {",
322 ' image = "docker.io/curlimages/curl@sha256:43ebaa53d3806db6b1ce4353b6b26ae638ec1c167ee351524b05690f988bb20d"',
323 f" extra_hosts = {q([host + ':host-gateway'])}",
324 f" args = {q(['--insecure', '--fail', '--silent', '--show-error', '--retry', '999999', '--retry-all-errors', '--retry-delay', '5', '--connect-timeout', '3', '--max-time', '5', 'https://' + host + endpoint['checkPath']])}",
325 " }",
326 " resources {",
327 " cpu = 50",
328 " memory = 64",
329 " }",
330 " }",
331 ]
332 for task_name, task in data["containers"].items():
333 if task.get("http") or task.get("tcp"):
334 kind = "http" if task.get("http") else "tcp"
335 endpoint = task["http"] if kind == "http" else task["tcp"][0]
336 label = ports[(task_name, "http" if kind == "http" else endpoint["name"])]
337 lines += [" service {", f" name = {q(name if task_name == 'app' else name + '-' + task_name)}", ' provider = "nomad"', f" port = {q(label)}"]
338 if len(data["containers"]) == 1:
339 lines.append(f" task = {q(task_name)}")
340 tags = []
341 if kind == "http" and endpoint.get("metricsPath"):
342 tags.append("snowglobe-metrics-path=" + endpoint["metricsPath"])
343 if kind == "http" and endpoint.get("hostname"):
344 tags += ["caddy-host=" + host for host in [endpoint["hostname"], *endpoint["plainHostnames"]]]
345 if endpoint.get("authRole"):
346 tags.append("caddy-auth-role=" + endpoint["authRole"])
347 if endpoint.get("userHeader"):
348 tags.append("caddy-user-header=" + endpoint["userHeader"])
349 if endpoint["forwardRealIp"]:
350 tags.append("caddy-real-ip=true")
351 if endpoint.get("secureCookies"):
352 tags.append("caddy-secure-cookies=true")
353 if endpoint["tlsInternal"]:
354 tags.append("caddy-internal=true")
355 if tags:
356 lines.append(f" tags = {q(tags)}")
357 lines += [" check {", f" type = {q(kind)}"]
358 if kind == "http":
359 lines.append(f" path = {q(endpoint['checkPath'])}")
360 if endpoint["checkHeaders"]:
361 lines.append(" header {")
362 for key, value in endpoint["checkHeaders"].items():
363 if not re.fullmatch(r"[A-Za-z][A-Za-z0-9-]*", key):
364 raise ValueError(f"invalid health check header: {key}")
365 lines.append(f" {key} = [{q(value)}]")
366 lines.append(" }")
367 lines += [
368 ' interval = "10s"',
369 ' timeout = "15s"',
370 ' check_restart {',
371 ' limit = 12',
372 f" grace = {q(data.get('healthRestartGrace') or data.get('healthyDeadline') or '5m')}",
373 ' }',
374 ' }',
375 ' }',
376 ]
377 for task_name, task in data["containers"].items():
378 lines += [f" task {q(task_name)} {{", ' driver = "podman"']
379 if task["lifecycle"] != "main":
380 lines += [' lifecycle {', ' hook = "prestart"',
381 f" sidecar = {str(task['lifecycle'] == 'prestartSidecar').lower()}", ' }']
382 if not task["imageUser"]:
383 uses_clover = any(
384 volume.get("clover") or (
385 volume.get("src")
386 and Path(volume["src"]).resolve().is_relative_to(Path(data["cloverRoot"]).resolve())
387 )
388 for volume in task["volumes"].values()
389 )
390 gid = data["cloverGid"] if uses_clover else 0 if task["rootGroup"] else data["uid"]
391 lines.append(f" user = {q(str(data['uid']) + ':' + str(gid))}")
392 lines += [" config {", f" image = {q(task['image'])}"]
393 if task.get("entrypoint"):
394 lines.append(f" entrypoint = {q(task['entrypoint'])}")
395 if task["args"]:
396 lines.append(f" args = {q(task['args'])}")
397 if task["hostNetwork"]:
398 lines.append(' network_mode = "host"')
399 task_ports = [label for (owner, _), label in ports.items() if owner == task_name]
400 if task_ports and not task["hostNetwork"]:
401 lines.append(f" ports = {q(task_ports)}")
402 for field, values in (("cap_add", task["capAdd"]), ("devices", task["devices"]), ("extra_hosts", task["extraHosts"])):
403 if values:
404 lines.append(f" {field} = {q(values)}")
405 volumes = []
406 secret_files = task.get("secretFiles", {})
407 filenames = set()
408 for target, template in secret_files.items():
409 filename = Path(target).name
410 if (not re.fullmatch(r"/[A-Za-z0-9_./-]+", target) or target.endswith("/")
411 or any(part in {".", "..", ""} for part in target[1:].split("/"))
412 or filename in filenames
413 or filename in {task_name + ".env", task_name + "-secret.env", "nomad_token"}
414 or target in task["volumes"] or target == "/secrets" or target.startswith("/secrets/")):
415 raise ValueError(f"invalid secret file target: {target}")
416 if task["imageUser"]:
417 raise ValueError("secret files require a service-owned container user")
418 if re.search(r"(?m)^EOF\r?$", template):
419 raise ValueError("invalid secret template delimiter")
420 filenames.add(filename)
421 volumes.append(f"secrets/{filename}:{target}:ro")
422 for target, volume in task["volumes"].items():
423 if not target.startswith("/") or ":" in target:
424 raise ValueError(f"invalid volume target: {target}")
425 if volume.get("config") is not None:
426 if volume.get("src") is not None or not volume["readOnly"]:
427 raise ValueError("config mounts must be read only and have no host source")
428 config_path(data.get("sourceId", name), volume["config"])
429 source = host_path(str(asset_dir), volume["config"])
430 elif volume.get("src") is not None:
431 source = volume["src"]
432 if not Path(source).is_absolute():
433 raise ValueError(f"volume source must be absolute: {source}")
434 else:
435 source = host_path(data["hostRoot"], target.lstrip("/"))
436 if ":" in source:
437 raise ValueError(f"invalid volume source: {source}")
438 volumes.append(f"{source}:{target}" + (":ro" if volume["readOnly"] else ""))
439 if volumes:
440 lines.append(f" volumes = {q(volumes)}")
441 if task["tmpfs"]:
442 lines.append(f" tmpfs = {q(task['tmpfs'])}")
443 lines.append(" }")
444 secret_env = []
445 plain_env = {}
446 for key, value in task["env"].items():
447 if not re.fullmatch(r"[A-Za-z_][A-Za-z0-9_]*", key):
448 raise ValueError(f"invalid env key: {key}")
449 parts = re.split(r"(\$\{secret\.[A-Za-z_][A-Za-z0-9_]*\.[A-Za-z_][A-Za-z0-9_]*\})", value)
450 if len(parts) == 1:
451 if "${secret." in value:
452 raise ValueError(f"invalid secret reference: {value}")
453 plain_env[key] = value
454 continue
455 args = []
456 paths = {}
457 for part in parts:
458 match = re.fullmatch(r"\$\{secret\.([A-Za-z_][A-Za-z0-9_]*)\.([A-Za-z_][A-Za-z0-9_]*)\}", part)
459 if match:
460 alias, field = match.groups()
461 if alias != "own" and alias not in data["inputs"]:
462 raise ValueError(f"unknown secret alias: {alias}")
463 path = f"nomad/jobs/{name}" + (f"/inputs/{alias}" if alias != "own" else "")
464 variable = paths.setdefault(path, f"$s{len(paths)}")
465 args.append(f"(index {variable} {q(field)}).Value")
466 elif part:
467 args.append(q(part))
468 start = "".join(f'{{{{ with {variable} := nomadVar {q(path)} }}}}' for path, variable in paths.items())
469 end = "{{ end }}" * len(paths)
470 secret_env.append(f'{start}{key}={{{{ print {" ".join(args)} | toJSON }}}}{end}')
471 if "SNOWGLOBE_PREPARE_DIGEST" in task["env"]:
472 raise ValueError("SNOWGLOBE_PREPARE_DIGEST is reserved")
473 lines.append(" env {")
474 for key, value in plain_env.items():
475 lines.append(f" {key} = {q(value)}")
476 if prepare_digest:
477 lines.append(f" SNOWGLOBE_PREPARE_DIGEST = {q(prepare_digest)}")
478 lines.append(" }")
479 if secret_env:
480 lines += [" template {", " data = <<EOF", *secret_env, "EOF", f' destination = {q("secrets/" + task_name + "-secret.env")}', " env = true", " error_on_missing_key = true", " }"]
481 if task.get("envTemplate"):
482 if "\nEOF\n" in task["envTemplate"]:
483 raise ValueError("invalid env template delimiter")
484 lines += [" template {", " data = <<EOF", task["envTemplate"].rstrip(), "EOF", f' destination = {q("secrets/" + task_name + ".env")}', " env = true", " }"]
485 for target, template in secret_files.items():
486 lines += [" template {", " data = <<EOF", template.rstrip(), "EOF",
487 f' destination = {q("secrets/" + Path(target).name)}', ' perms = "0400"',
488 f' uid = {data["uid"]}', f' gid = {data["uid"]}',
489 " error_on_missing_key = true", " }"]
490 lines += [" resources {", f" cpu = {task['cpu']}", f" memory = {task['memory']}", " }", " }"]
491 lines += [" }", "}"]
492 return "\n".join(lines) + "\n"
493
494
495def token():
496 if "NOMAD_TOKEN" not in os.environ:
497 os.environ["NOMAD_TOKEN"] = (STATE / "nomad.token").read_text().strip()
498
499
500def get_variable(path):
501 result = subprocess.run(["nomad", "var", "get", "-out=json", path], capture_output=True, text=True)
502 if result.returncode == 0:
503 return json.loads(result.stdout)
504 if "Variable not found" in result.stderr + result.stdout:
505 return None
506 raise RuntimeError(f"Nomad variable read failed for {path}: {result.stderr.strip()}")
507
508
509def provision(data):
510 if not data["containers"]:
511 return
512 if os.geteuid() != 0:
513 raise PermissionError("provisioning requires root")
514 root = Path(data["hostRoot"])
515 if data["hasManagedVolumes"]:
516 root.mkdir(parents=True, exist_ok=True)
517 if command(
518 "findmnt", "-n", "-o", "FSTYPE", "--mountpoint", str(root), capture=True
519 ).stdout.strip() != "zfs":
520 raise ValueError(f"expected ZFS dataset at {root}")
521 for task in data["containers"].values():
522 gid = 0 if task["rootGroup"] else data["uid"]
523 for target, volume in task["volumes"].items():
524 if volume.get("config") is not None or volume.get("src") is not None:
525 continue
526 path = Path(host_path(str(root), target.lstrip("/")))
527 path.mkdir(parents=True, exist_ok=True)
528 os.chown(path, data["uid"], gid)
529 path.chmod(0o750)
530 if data["sourceId"] == "ytdl" and target == "/data":
531 command("systemd-tmpfiles", "--create", "--prefix=" + str(path))
532 bundle = STATE / "ca-bundle.crt"
533 if any(
534 volume.get("src") == str(bundle)
535 for task in data["containers"].values()
536 for volume in task["volumes"].values()
537 ):
538 contents = Path("/etc/ssl/certs/ca-certificates.crt").read_bytes()
539 local_ca = Path("/var/lib/caddy/.local/share/caddy/pki/authorities/local/root.crt")
540 if local_ca.exists():
541 contents += b"\n" + local_ca.read_bytes()
542 if not bundle.exists() or bundle.read_bytes() != contents:
543 pending = bundle.with_suffix(".pending")
544 pending.write_bytes(contents)
545 pending.chmod(0o644)
546 pending.replace(bundle)
547 route_dir = STATE / "routes"
548 route_dir.mkdir(parents=True, exist_ok=True)
549 asset_dir, assets = config_assets(data)
550 static = {}
551 directories = {}
552 identity = {}
553 head_html = {}
554 metrics_paths = {}
555 for task in data["containers"].values():
556 if task.get("http"):
557 http = task["http"]
558 if http["identityHeaders"]:
559 identity[http["hostname"]] = http["identityHeaders"]
560 if http["headHtml"]:
561 head_html[http["hostname"]] = http["headHtml"]
562 if http.get("metricsPath") and http["hostname"]:
563 metrics_paths[http["hostname"]] = http["metricsPath"]
564 for request, rel in http["overrideFiles"].items():
565 origin = assets[rel]
566 target = directories if origin.is_dir() else static
567 target[request] = host_path(str(asset_dir), rel)
568 if assets:
569 asset_dir.parent.mkdir(parents=True, exist_ok=True)
570 asset_dir.parent.chmod(0o755)
571 if assets and not asset_dir.exists():
572 temporary = tempfile.mkdtemp(dir=asset_dir.parent)
573 try:
574 for rel, origin in assets.items():
575 destination = Path(temporary) / rel
576 destination.parent.mkdir(parents=True, exist_ok=True)
577 if origin.is_dir():
578 shutil.copytree(origin, destination)
579 for child in destination.rglob("*"):
580 child.chmod(0o755 if child.is_dir() else 0o644)
581 else:
582 shutil.copy2(origin, destination)
583 destination.chmod(0o644)
584 Path(temporary).chmod(0o755)
585 os.replace(temporary, asset_dir)
586 finally:
587 shutil.rmtree(temporary, ignore_errors=True)
588 secret_dir = STATE / "secrets"
589 secret_dir.mkdir(parents=True, exist_ok=True)
590 secret_file = secret_dir / f"{data['id']}.nv.hcl"
591 generated = data["secrets"]
592 required = data["requiredSecrets"]
593 secret_path = "nomad/jobs/" + data["id"]
594 existing = get_variable(secret_path) if generated or required else None
595 if generated and not existing and secret_file.exists():
596 command("nomad", "var", "put", "-in=hcl", "-out=none", secret_path, "@" + str(secret_file))
597 existing = get_variable(secret_path)
598 values = dict(existing["Items"]) if existing else {}
599 if generated:
600 for item, spec in generated.items():
601 if item not in values:
602 values[item] = secrets.token_hex(spec["bytes"])
603 if not existing or values != existing["Items"]:
604 put_variable(secret_path, values, existing["ModifyIndex"] if existing else 0)
605 backup = "items {\n" + "".join(f" {item} = {q(value)}\n" for item, value in values.items()) + "}\n"
606 if not secret_file.exists() or secret_file.read_text() != backup:
607 write_private(secret_file, backup)
608 if required:
609 missing = [name for name in required if not values.get(name)]
610 if missing:
611 raise ValueError(f"missing required secrets for {data['id']}: {', '.join(missing)}")
612 proof = {}
613 for task in data["containers"].values():
614 http = task.get("http")
615 if http and http.get("identityProofSecret"):
616 name = http["identityProofSecret"]
617 if not http["identityHeaders"] or name not in values:
618 raise ValueError(f"missing identity proof secret for {data['id']}")
619 proof[http["hostname"]] = "X-Snowglobe-Idp-" + values[name]
620 write_private(route_dir / f"{data['id']}.json", json.dumps({
621 "files": static, "dirs": directories, "identity": identity,
622 "identityProof": proof, "headHtml": head_html, "metricsPaths": metrics_paths,
623 }))
624
625
626def submit(data, mode, definitions):
627 if not data["containers"]:
628 return
629 with tempfile.NamedTemporaryFile("w", suffix=".nomad.hcl", delete=False) as file:
630 file.write(render(data, definitions))
631 path = file.name
632 try:
633 command("nomad", "job", mode, path)
634 finally:
635 Path(path).unlink()
636
637
638def build_images(data):
639 for task in data["containers"].values():
640 if task.get("build"):
641 image = task["image"]
642 if subprocess.run(["podman", "image", "exists", image]).returncode:
643 command("podman", "build", "-t", image, str(config_path(data["sourceId"], task["build"])))
644
645
646def clone_dataset(source, snapshot, dataset, mount):
647 acltype = command("zfs", "get", "-H", "-o", "value", "acltype", source, capture=True).stdout.strip()
648 command("zfs", "clone", "-o", "mountpoint=" + mount, "-o", "acltype=" + acltype, snapshot, dataset)
649
650
651def check_http(host, path, tls_internal=False, attempts=120):
652 for attempt in range(attempts):
653 try:
654 if subprocess.run(
655 ["curl", "--noproxy", "*", "-sf", *(["--cacert", "/var/lib/caddy/.local/share/caddy/pki/authorities/local/root.crt"] if tls_internal else []), "--resolve", f"{host}:443:127.0.0.1", f"https://{host}{path}"],
656 capture_output=True, timeout=3,
657 ).returncode == 0:
658 print(f"Healthy {host}")
659 return
660 except subprocess.TimeoutExpired:
661 pass
662 time.sleep(2)
663 raise RuntimeError(f"HTTPS route is unhealthy: {host}")
664
665
666def put_variable(path, items, index=None):
667 with tempfile.NamedTemporaryFile("w", suffix=".nv.hcl", delete=False) as file:
668 file.write("items {\n" + "".join(f" {key} = {q(value)}\n" for key, value in items.items()) + "}\n")
669 filename = file.name
670 try:
671 command("nomad", "var", "put", "-in=hcl", "-out=none", *([f"-check-index={index}"] if index is not None else []), path, "@" + filename)
672 finally:
673 Path(filename).unlink()
674
675
676def configure(data):
677 if not data.get("setup"):
678 return
679 if data["setup"].startswith("tools/"):
680 script = (REPO / data["setup"]).resolve()
681 if not script.is_relative_to(REPO / "tools") or not script.is_file():
682 raise ValueError(f"invalid shared setup script: {data['setup']}")
683 else:
684 script = config_path(data.get("sourceId", data["id"]), data["setup"])
685 routes = [task["http"] for task in data["containers"].values()
686 if task.get("http") and task["http"].get("hostname")]
687 if len(routes) != 1:
688 raise ValueError("service setup requires one HTTP hostname")
689 route = routes[0]
690 check_http(route["hostname"], route["checkPath"], route["tlsInternal"], attempts=600)
691 variable = get_variable("nomad/jobs/" + data["id"])
692 own = variable["Items"] if variable else {}
693 command("python3", str(script), input=json.dumps({
694 "serviceId": data["id"], "host": route["hostname"], "hostRoot": data["hostRoot"],
695 "preview": data["id"] != data.get("sourceId", data["id"]),
696 "ownerEmail": data["ownerEmail"], **own,
697 }))
698 print(f"Configured {data['id']}")
699
700
701def prepare(data):
702 if data.get("prepare"):
703 script = config_path(data.get("sourceId", data["id"]), data["prepare"])
704 command("python3", str(script), input=json.dumps({
705 "hostRoot": data["hostRoot"], "uid": data["uid"],
706 }))
707
708
709def provision_inputs(data, definitions, stage_id=None, postgres_source=None):
710 for alias, request in data["inputs"].items():
711 if not NAME.fullmatch(alias):
712 raise ValueError(f"invalid input alias: {alias}")
713 native = request["provider"] == "snowglobe"
714 provider = {"id": "snowglobe", "provide": True, "containers": {}} if native else definitions[request["provider"]]
715 if not provider.get("provide"):
716 raise ValueError(f"{provider['id']} does not provide inputs")
717 path = f"nomad/jobs/{data['id']}/inputs/{alias}"
718 variable = get_variable(path)
719 own = (get_variable("nomad/jobs/" + provider["id"]) or {}).get("Items", {})
720 http = next((task["http"] for task in provider["containers"].values()
721 if task.get("http") and task["http"].get("hostname")), None)
722 if http:
723 check_http(http["hostname"], http["checkPath"], http["tlsInternal"])
724 payload = {
725 "request": request,
726 "existing": variable["Items"] if variable else None,
727 "providerSecrets": own,
728 "host": http["hostname"] if http else None,
729 }
730 if stage_id:
731 payload["stageId"] = stage_id
732 if postgres_source and provider["id"] == "postgres":
733 payload["sourceContainer"] = postgres_source
734 script = REPO / "tools/oidc-provider.py" if native else config_path(provider["id"], provider["provide"])
735 result = command("python3", str(script), input=json.dumps(payload), capture=True)
736 values = json.loads(result.stdout)
737 if not isinstance(values, dict) or not values or any(
738 not re.fullmatch(r"[A-Za-z_][A-Za-z0-9_]*", key) or not isinstance(value, str) or not value
739 for key, value in values.items()
740 ):
741 raise ValueError(f"invalid outputs from {provider['id']}")
742 if not variable or variable["Items"] != values:
743 put_variable(path, values, variable["ModifyIndex"] if variable else None)
744 print(f"Allocated {data['id']}.{alias} from {provider['id']}")
745
746
747def bootstrap(all_data):
748 if os.geteuid() != 0:
749 raise PermissionError("bootstrap requires root")
750 STATE.mkdir(parents=True, exist_ok=True)
751 if not (STATE / "nomad.token").exists():
752 result = command("nomad", "acl", "bootstrap", "-json", capture=True)
753 write_private(STATE / "nomad.token", json.loads(result.stdout)["SecretID"] + "\n")
754 token()
755 command(
756 "nomad",
757 "acl",
758 "policy",
759 "apply",
760 "snowglobe-router",
761 str(REPO / "config/policies/router.hcl"),
762 )
763 command("nomad", "acl", "policy", "apply", "snowglobe-dashboard",
764 str(REPO / "config/policies/dashboard.hcl"))
765 router_token = STATE / "router.token"
766 if not router_token.exists():
767 result = command(
768 "nomad",
769 "acl",
770 "token",
771 "create",
772 "-policy=snowglobe-router",
773 "-name=snowglobe-router",
774 "-json",
775 capture=True,
776 )
777 write_private(router_token, json.loads(result.stdout)["SecretID"] + "\n")
778 dashboard_token = STATE / "dashboard.token"
779 if not dashboard_token.exists():
780 result = command("nomad", "acl", "token", "create", "-policy=snowglobe-dashboard",
781 "-name=snowglobe-dashboard", "-json", capture=True)
782 write_private(dashboard_token, json.loads(result.stdout)["SecretID"] + "\n")
783 for data in all_data:
784 paths = {
785 f"nomad/jobs/{data['id']}/inputs/{alias}" for alias in data["inputs"]
786 }
787 if paths and data["containers"]:
788 policy = (
789 'namespace "default" {\n variables {\n'
790 + "".join(
791 f' path {q(path)} {{ capabilities = ["read"] }}\n'
792 for path in sorted(paths)
793 )
794 + " }\n}\n"
795 )
796 with tempfile.NamedTemporaryFile("w", delete=False) as file:
797 file.write(policy)
798 path = file.name
799 try:
800 for task_name in data["containers"]:
801 command(
802 "nomad", "acl", "policy", "apply", "-namespace", "default",
803 "-job", data["id"], "-group", "app", "-task", task_name,
804 data["id"] + "-" + task_name + "-imports", path,
805 )
806 finally:
807 Path(path).unlink()
808 current = Path("/opt/snowglobe/current")
809 if current.is_symlink():
810 command("systemctl", "start", transition.layout(current)["prefix"] + "-router.service")
811
812
813def destroy_stage(stage, metadata, definitions):
814 subprocess.run(["nomad", "job", "stop", "-purge", "-yes", stage], check=False)
815 for alias, request in metadata["inputs"].items():
816 native = request["provider"] == "snowglobe"
817 provider = {"id": "snowglobe", "provide": True, "containers": {}} if native else definitions[request["provider"]]
818 own = (get_variable("nomad/jobs/" + provider["id"]) or {}).get("Items", {})
819 variable = get_variable(f"nomad/jobs/{stage}/inputs/{alias}")
820 existing = variable["Items"] if variable else None
821 hosts = [task["http"]["hostname"] for task in provider["containers"].values()
822 if task.get("http") and task["http"].get("hostname")]
823 script = REPO / "tools/oidc-provider.py" if native else config_path(provider["id"], provider["provide"])
824 command("python3", str(script), input=json.dumps({
825 "operation": "delete", "request": request, "stageId": stage,
826 "providerSecrets": own, "host": hosts[0] if hosts else None,
827 "existing": existing,
828 }))
829 datasets = list(metadata.get("external", {}).values())
830 if metadata.get("clone"):
831 datasets.append({"clone": metadata["clone"], "snapshot": metadata.get("snapshot")})
832 for dataset in datasets:
833 for attempt in range(30):
834 if subprocess.run(["zfs", "destroy", dataset["clone"]], capture_output=True).returncode == 0:
835 break
836 time.sleep(1)
837 else:
838 raise RuntimeError("preview dataset is still in use")
839 if dataset.get("snapshot"):
840 command("zfs", "destroy", dataset["snapshot"])
841 if not metadata.get("clone"):
842 shutil.rmtree(metadata["mount"], ignore_errors=True)
843 for alias in metadata["inputs"]:
844 subprocess.run(["nomad", "var", "purge", f"nomad/jobs/{stage}/inputs/{alias}"], check=False)
845 subprocess.run(["nomad", "var", "purge", "nomad/jobs/" + stage], check=False)
846 for task in metadata["tasks"]:
847 subprocess.run(["nomad", "acl", "policy", "delete", stage + "-" + task + "-imports"], check=False)
848 for path in (
849 STATE / "stages" / f"{stage}.json",
850 STATE / "routes" / f"{stage}.json",
851 STATE / "secrets" / f"{stage}.nv.hcl",
852 ):
853 path.unlink(missing_ok=True)
854 shutil.rmtree(ASSETS / stage, ignore_errors=True)
855
856
857def check_pool(data):
858 if os.geteuid() != 0:
859 raise PermissionError("pool setup requires root")
860 clover = subprocess.run(
861 ["findmnt", "-n", "-o", "SOURCE,FSTYPE", "--mountpoint", data[0]["cloverRoot"]],
862 capture_output=True, text=True,
863 )
864 clover_info = clover.stdout.split()
865 if clover.returncode or len(clover_info) != 2 or clover_info[1] != "zfs":
866 raise ValueError(f"clover must be a mounted ZFS dataset: {data[0]['cloverRoot']}")
867 media = data[0]["mediaRoot"]
868 mounted = subprocess.run(
869 ["findmnt", "-n", "-o", "SOURCE,FSTYPE", "--mountpoint", media],
870 capture_output=True, text=True,
871 )
872 media_info = mounted.stdout.split()
873 expected = {"fuse"} if os.environ.get("SNOWGLOBE_MEDIA_READ_ONLY") == "true" else {"zfs"}
874 if mounted.returncode or len(media_info) != 2 or media_info[1] not in expected or media_info[0] == clover_info[0]:
875 raise ValueError(f"media must be a separate mounted dataset: {media}")
876 for path, info in ((data[0]["cloverRoot"], clover_info), (media, media_info)):
877 if info[1] == "zfs":
878 acltype = command("zfs", "get", "-H", "-o", "value", "acltype", info[0], capture=True).stdout.strip()
879 if acltype == "nfsv4":
880 raise ValueError(f"{path} uses NFSv4 ACLs, which NixOS cannot enforce. Rehearse a POSIX permission conversion on a ZFS clone before migration.")
881 pool = data[0]["pool"]
882 if subprocess.run(["zpool", "list", pool], capture_output=True).returncode:
883 raise ValueError(f"ZFS pool is unavailable: {pool}")
884 prod = pool + "/prod"
885 acl_source = prod if subprocess.run(["zfs", "list", prod], capture_output=True).returncode == 0 else pool
886 if command("zfs", "get", "-H", "-o", "value", "acltype", acl_source, capture=True).stdout.strip() == "nfsv4":
887 raise ValueError(f"{acl_source} uses NFSv4 ACLs; service datasets need POSIX ACLs on NixOS.")
888 encrypted = any(
889 command("zfs", "get", "-H", "-o", "value", "encryption", info[0], capture=True).stdout.strip() != "off"
890 for info in (clover_info, media_info) if info[1] == "zfs"
891 )
892 if encrypted:
893 root = str(Path(data[0]["hostRoot"]).parent)
894 mounted = subprocess.run(["findmnt", "-n", "-o", "SOURCE", "--mountpoint", root], capture_output=True, text=True)
895 encryption = subprocess.run(["zfs", "get", "-H", "-o", "value", "encryption", prod], capture_output=True, text=True)
896 if encryption.returncode or encryption.stdout.strip() == "off" or mounted.stdout.strip() != prod:
897 raise ValueError(f"Create and mount encrypted {prod} at {root} before deployment; the existing storage is encrypted.")
898
899
900def check_staging_pool(data):
901 check_pool([data])
902 prod = data["pool"] + "/prod"
903 staging = data["pool"] + "/staging"
904 acl_source = staging if subprocess.run(["zfs", "list", staging], capture_output=True).returncode == 0 else data["pool"]
905 if command("zfs", "get", "-H", "-o", "value", "acltype", acl_source, capture=True).stdout.strip() == "nfsv4":
906 raise ValueError(f"{acl_source} uses NFSv4 ACLs; staged datasets need POSIX ACLs on NixOS.")
907 encryption = subprocess.run(["zfs", "get", "-H", "-o", "value", "encryption", prod], capture_output=True, text=True)
908 if encryption.returncode or encryption.stdout.strip() == "off":
909 return
910 mounted = subprocess.run(["findmnt", "-n", "-o", "SOURCE", "--mountpoint", data["stagingRoot"]], capture_output=True, text=True)
911 staging_encryption = subprocess.run(["zfs", "get", "-H", "-o", "value", "encryption", staging], capture_output=True, text=True)
912 if staging_encryption.returncode or staging_encryption.stdout.strip() == "off" or mounted.stdout.strip() != staging:
913 raise ValueError(f"Create and mount encrypted {staging} at {data['stagingRoot']} before staging.")
914
915
916def ensure_pool(data):
917 check_pool(data)
918 STATE.mkdir(parents=True, exist_ok=True)
919 pool = data[0]["pool"]
920 for item in data:
921 if item["hasManagedVolumes"]:
922 dataset = pool + "/prod/" + item["id"]
923 if subprocess.run(["zfs", "list", dataset], capture_output=True).returncode:
924 root = Path(item["hostRoot"])
925 if root.exists() and any(root.iterdir()):
926 raise ValueError(f"refusing to mount over {root}")
927 if subprocess.run(["zfs", "list", pool + "/prod"], capture_output=True).returncode:
928 parent = str(root.parent)
929 if Path(parent).exists() and any(Path(parent).iterdir()):
930 raise ValueError(f"refusing to mount over {parent}")
931 command("zfs", "create", "-o", "mountpoint=" + parent, pool + "/prod")
932 command("zfs", "create", "-o", "mountpoint=" + str(root), dataset)
933
934
935def main():
936 parser = argparse.ArgumentParser()
937 parser.add_argument(
938 "mode",
939 choices=[
940 "render",
941 "secrets",
942 "validate",
943 "check",
944 "bootstrap",
945 "deploy",
946 "preflight",
947 "pool",
948 "allocate",
949 "stage",
950 "destroy",
951 ],
952 )
953 parser.add_argument("name", nargs="?")
954 parser.add_argument("--base-domain")
955 parser.add_argument("--root")
956 parser.add_argument("--pool")
957 parser.add_argument("--media-root")
958 parser.add_argument("--env", action="append", default=[])
959 parser.add_argument("--key", action="append", default=[])
960 args = parser.parse_args()
961 if args.mode == "stage" and args.name == "dashboard":
962 if args.env or args.base_domain or args.root or args.pool or args.media_root:
963 parser.error("dashboard staging uses the host configuration")
964 __import__("dashboard-stage").stage()
965 return
966 if args.mode == "destroy" and args.name and NAME.fullmatch(args.name):
967 saved = STATE / "stages" / f"{args.name}.json"
968 if saved.exists() and json.loads(saved.read_text()).get("sourceId") == "dashboard":
969 __import__("dashboard-stage").destroy(args.name)
970 return
971 if args.mode == "allocate" and not args.name:
972 parser.error("allocate requires a service name")
973 if args.key and args.mode != "secrets":
974 parser.error("--key is available only for secrets")
975 if args.name and args.mode != "destroy" and args.name not in service_files():
976 raise ValueError(f"unknown service: {args.name}")
977 properties = {
978 key: value
979 for key, value in (("domain", args.base_domain), ("root", args.root), ("pool", args.pool), ("mediaRoot", args.media_root))
980 if value
981 }
982 names = [args.name] if args.name else services()
983 if args.mode == "secrets":
984 if not args.name or not NAME.fullmatch(args.name):
985 parser.error("secrets requires a service name")
986 data = load(args.name, properties)
987 declared = [*data["requiredSecrets"], *data["secrets"]]
988 fields = args.key or declared
989 if not declared or len(set(declared)) != len(declared) or any(not re.fullmatch(r"[A-Za-z_][A-Za-z0-9_]*", field) for field in declared):
990 raise ValueError(f"invalid required secrets for {args.name}")
991 if len(set(fields)) != len(fields) or any(field not in declared for field in fields):
992 raise ValueError(f"unknown or duplicate secret key for {args.name}")
993 values = sys.stdin.read().splitlines()
994 if len(values) != len(fields) or any(not value for value in values):
995 raise ValueError(f"expected {len(fields)} nonempty secret lines for {args.name}")
996 token()
997 path = "nomad/jobs/" + args.name
998 existing = get_variable(path)
999 items = dict(existing["Items"]) if existing else {}
1000 items.update(zip(fields, values))
1001 put_variable(path, items, existing["ModifyIndex"] if existing else 0)
1002 print(f"Imported {len(fields)} secrets for {args.name}")
1003 return
1004 if args.mode == "destroy":
1005 if not args.name or not NAME.fullmatch(args.name):
1006 parser.error("destroy requires a stage ID")
1007 token()
1008 metadata = json.loads((STATE / "stages" / f"{args.name}.json").read_text())
1009 names = {metadata["sourceId"]} | {request["provider"] for request in metadata["inputs"].values() if request["provider"] != "snowglobe"}
1010 definitions = {name: load(name, properties) for name in names}
1011 destroy_stage(args.name, metadata, definitions)
1012 return
1013 if args.mode == "stage":
1014 if not args.name:
1015 parser.error("stage requires a service name")
1016 token()
1017 data = load(args.name, properties)
1018 check_staging_pool(data)
1019 definitions = {args.name: data}
1020 definitions.update({provider: load(provider, properties) for provider in dependencies(data)})
1021 if not data["containers"]:
1022 raise ValueError(f"service has no container to stage: {args.name}")
1023 stage_dir = STATE / "stages"
1024 previous = []
1025 for path in stage_dir.glob("*.json"):
1026 saved = json.loads(path.read_text())
1027 if saved.get("sourceId") == args.name:
1028 previous.append((path, saved))
1029 if len(previous) > 1:
1030 raise ValueError(f"multiple stages exist for {args.name}; destroy one first")
1031 created = not previous
1032 stage = f"{args.name}-preview-{secrets.token_hex(4)}" if created else previous[0][0].stem
1033 http = [task["http"] for task in data["containers"].values() if task.get("http") and task["http"].get("hostname")]
1034 if len(http) > 1:
1035 raise ValueError("preview requires at most one HTTP route")
1036 original_host = http[0].get("hostname") if http else None
1037 hostname = stage + "." + original_host.split(".", 1)[1] if original_host else None
1038 data = load(args.name, properties, stage)
1039 data["rollout"] = "simple"
1040 data["hostRoot"] = str(Path(data["stagingRoot"]) / stage)
1041 if data["stageIsolation"] == "fresh" and any(
1042 volume.get("src") and not volume["readOnly"]
1043 for task in data["containers"].values()
1044 for volume in task["volumes"].values()
1045 ):
1046 raise ValueError("fresh stages cannot use writable external mounts")
1047 for task in data["containers"].values():
1048 if task.get("tcp") and not task["hostNetwork"]:
1049 for port in task["tcp"]:
1050 port["hostPort"] = None
1051 if hostname:
1052 for task in data["containers"].values():
1053 if task.get("http") and task["http"].get("hostname") == original_host:
1054 task["http"]["hostname"] = hostname
1055 task["http"]["plainHostnames"] = [stage + "-" + host for host in task["http"]["plainHostnames"]]
1056 task["env"] = {key: value.replace(original_host, hostname) for key, value in task["env"].items()}
1057 if task.get("secretFiles"):
1058 task["secretFiles"] = {key: value.replace(original_host, hostname) for key, value in task["secretFiles"].items()}
1059 for request in data["inputs"].values():
1060 if request["provider"] == "snowglobe":
1061 request["redirectUris"] = [uri.replace(original_host, hostname) for uri in request["redirectUris"]]
1062 for assignment in args.env:
1063 key, separator, value = assignment.partition("=")
1064 if not separator or len(data["containers"]) != 1:
1065 parser.error(f"unknown environment override: {key}")
1066 env = next(iter(data["containers"].values()))["env"]
1067 if key not in env:
1068 parser.error(f"unknown environment override: {key}")
1069 env[key] = value
1070 metadata = (
1071 {"mount": data["hostRoot"], "inputs": data["inputs"],
1072 "tasks": list(data["containers"]), "sourceId": args.name,
1073 "stageIsolation": data["stageIsolation"]}
1074 if created else previous[0][1]
1075 )
1076 if not created:
1077 if metadata.get("stageIsolation", "clone") != data["stageIsolation"]:
1078 raise ValueError("stage isolation changed; destroy the stage before recreating it")
1079 if bool(metadata.get("clone")) != data["hasManagedVolumes"]:
1080 raise ValueError("storage layout changed; destroy the stage before recreating it")
1081 for alias, request in data["inputs"].items():
1082 if alias in metadata["inputs"] and metadata["inputs"][alias] != request:
1083 raise ValueError(f"requirement {alias} changed; destroy the stage before recreating it")
1084 if alias not in metadata["inputs"] and request["provider"] == "postgres":
1085 raise ValueError("new database requirement needs a new stage")
1086 metadata["inputs"].update(data["inputs"])
1087 metadata["tasks"] = sorted(set(metadata["tasks"]) | set(data["containers"]))
1088 stage_dir.mkdir(parents=True, exist_ok=True)
1089 postgres_snapshot = None
1090 pending_snapshots = set()
1091 try:
1092 postgres_inputs = created and data["stageIsolation"] == "clone" and any(
1093 request["provider"] == "postgres" and request["kind"] == "database"
1094 for request in data["inputs"].values()
1095 )
1096 snapshots = []
1097 source = None
1098 if created and data["hasManagedVolumes"]:
1099 pool = data["pool"]
1100 source = subprocess.run(
1101 ["findmnt", "-n", "-o", "SOURCE", "--mountpoint", definitions[args.name]["hostRoot"]],
1102 capture_output=True, text=True,
1103 ).stdout.strip()
1104 dataset = pool + "/staging/" + stage
1105 if subprocess.run(["zfs", "list", pool + "/staging"], capture_output=True).returncode:
1106 command("zfs", "create", "-o", "mountpoint=none", pool + "/staging")
1107 if source and data["stageIsolation"] == "clone":
1108 if source.split("/", 1)[0] != pool:
1109 raise ValueError(f"production dataset belongs to another pool: {source}")
1110 snapshot = source + "@" + stage
1111 snapshots.append(snapshot)
1112 if postgres_inputs:
1113 postgres_dataset = dataset_for("postgres")
1114 if not postgres_dataset:
1115 raise ValueError("Postgres needs a ZFS dataset for consistent stages")
1116 postgres_snapshot = postgres_dataset + "@" + stage
1117 snapshots.append(postgres_snapshot)
1118 external = {}
1119 for task in data["containers"].values():
1120 for volume in task["volumes"].values():
1121 if volume.get("src") and not volume["readOnly"]:
1122 external.setdefault(volume["src"], []).append(volume)
1123 external_mounts = {}
1124 for external_source in external:
1125 path = Path(external_source).resolve(strict=True)
1126 mount = json.loads(command(
1127 "findmnt", "--json", "-o", "SOURCE,TARGET,FSTYPE,OPTIONS", "--target", str(path), capture=True,
1128 ).stdout)["filesystems"][0]
1129 if "ro" not in mount["options"].split(",") and mount["fstype"] != "zfs":
1130 raise ValueError(f"writable external mount is not ZFS: {external_source}")
1131 external_mounts[external_source] = (path, mount)
1132 if created and mount["fstype"] == "zfs" and "ro" not in mount["options"].split(","):
1133 target = mount["source"] + "@" + stage
1134 if target not in snapshots:
1135 snapshots.append(target)
1136 if snapshots:
1137 if len({target.split("/", 1)[0] for target in snapshots}) != 1:
1138 raise ValueError("staged datasets must belong to one ZFS pool")
1139 command("zfs", "snapshot", *snapshots)
1140 pending_snapshots.update(snapshots)
1141 if created and data["hasManagedVolumes"]:
1142 if source and data["stageIsolation"] == "clone":
1143 try:
1144 clone_dataset(source, snapshot, dataset, data["hostRoot"])
1145 except Exception:
1146 command("zfs", "destroy", snapshot)
1147 pending_snapshots.remove(snapshot)
1148 raise
1149 metadata["snapshot"] = snapshot
1150 pending_snapshots.remove(snapshot)
1151 else:
1152 command("zfs", "create", "-o", "mountpoint=" + data["hostRoot"], dataset)
1153 metadata["clone"] = dataset
1154 bindings = {}
1155 for source, volumes in sorted(external.items()):
1156 path, mount = external_mounts[source]
1157 if "ro" in mount["options"].split(","):
1158 binding = {"src": source, "readOnly": True}
1159 elif mount["fstype"] == "zfs":
1160 dataset = mount["source"]
1161 if metadata.get("snapshot") == dataset + "@" + stage:
1162 clone_mount = data["hostRoot"]
1163 else:
1164 staged = metadata.setdefault("external", {})
1165 if dataset not in staged:
1166 if not created:
1167 raise ValueError("external storage changed; destroy the stage before recreating it")
1168 suffix = hashlib.sha256(dataset.encode()).hexdigest()[:8]
1169 pool = dataset.split("/", 1)[0]
1170 clone = pool + "/staging/" + stage + "-external-" + suffix
1171 clone_mount = str(Path(data["stagingRoot"]) / (stage + "-external-" + suffix))
1172 snapshot = dataset + "@" + stage
1173 if subprocess.run(["zfs", "list", pool + "/staging"], capture_output=True).returncode:
1174 command("zfs", "create", "-o", "mountpoint=none", pool + "/staging")
1175 try:
1176 clone_dataset(dataset, snapshot, clone, clone_mount)
1177 except Exception:
1178 command("zfs", "destroy", snapshot)
1179 pending_snapshots.remove(snapshot)
1180 raise
1181 staged[dataset] = {"clone": clone, "snapshot": snapshot, "mount": clone_mount}
1182 pending_snapshots.remove(snapshot)
1183 clone_mount = staged[dataset]["mount"]
1184 relative = path.relative_to(Path(mount["target"]).resolve())
1185 binding = {"src": str(Path(clone_mount) / relative), "readOnly": False}
1186 else:
1187 raise ValueError(f"writable external mount is not ZFS: {source}")
1188 bindings[source] = binding
1189 for volume in volumes:
1190 if path.is_relative_to(Path(data["cloverRoot"]).resolve()):
1191 volume["clover"] = True
1192 volume.update(binding)
1193 if not created and bindings != metadata.get("externalSources", {}):
1194 raise ValueError("external storage changed; destroy the stage before recreating it")
1195 metadata["externalSources"] = bindings
1196 if REPO.parent == Path("/opt/snowglobe/releases").resolve():
1197 metadata["release"] = REPO.name
1198 metadata["ready"] = False
1199 write_private(stage_dir / f"{stage}.json", json.dumps(metadata))
1200 bootstrap([data])
1201 if created and data["stageIsolation"] == "clone" and (data["secrets"] or data["requiredSecrets"]):
1202 source = get_variable("nomad/jobs/" + args.name)
1203 if source:
1204 put_variable("nomad/jobs/" + stage, source["Items"], 0)
1205 if postgres_snapshot:
1206 postgres_clone = postgres_dataset.rsplit("/prod/", 1)[0] + "/staging/" + stage + "-postgres"
1207 postgres_mount = Path(data["stagingRoot"]) / (stage + "-postgres")
1208 source_context = cloned_postgres(postgres_snapshot, postgres_clone, postgres_mount)
1209 else:
1210 source_context = nullcontext(None)
1211 with source_context as postgres_source:
1212 provision_inputs(data, definitions, stage, postgres_source)
1213 provision(data)
1214 prepare(data)
1215 build_images(data)
1216 submit(data, "run", definitions)
1217 except Exception:
1218 if created:
1219 destroy_stage(stage, metadata, definitions)
1220 raise
1221 finally:
1222 for snapshot in sorted(pending_snapshots):
1223 command("zfs", "destroy", snapshot)
1224 if hostname:
1225 check_http(hostname, http[0]["checkPath"], http[0]["tlsInternal"])
1226 configure(data)
1227 if REPO.parent == Path("/opt/snowglobe/releases").resolve():
1228 metadata["ready"] = True
1229 metadata["overrides"] = [assignment.partition("=")[0] for assignment in args.env]
1230 write_private(stage_dir / f"{stage}.json", json.dumps(metadata))
1231 print(f"stage={stage}\nrelease={metadata.get('release', '')}\nhost={hostname}\ndataset={metadata.get('clone', '')}")
1232 return
1233 definitions = {name: load(name, properties) for name in services()}
1234 if args.name and args.name not in definitions:
1235 raise ValueError(f"unknown service: {args.name}")
1236 if not args.name and args.mode == "deploy":
1237 names = [name for name in names if definitions[name]["containers"]]
1238 selected = set(names)
1239 while True:
1240 required = selected | set().union(*(dependencies(definitions[name]) for name in selected))
1241 missing = required - definitions.keys()
1242 if missing:
1243 raise ValueError(f"unknown dependency: {sorted(missing)}")
1244 if required == selected:
1245 break
1246 selected = required
1247 data = ordered([definitions[name] for name in sorted(selected)])
1248 if args.mode == "render":
1249 for item in data:
1250 if item["containers"]:
1251 print(render(item, definitions))
1252 elif args.mode == "validate":
1253 token()
1254 for item in data:
1255 submit(item, "validate", definitions)
1256 elif args.mode == "check":
1257 for item in data:
1258 for task in item["containers"].values():
1259 if task.get("http") and task["http"].get("hostname"):
1260 check_http(task["http"]["hostname"], task["http"]["checkPath"], task["http"]["tlsInternal"])
1261 elif args.mode == "preflight":
1262 check_pool(data)
1263 token()
1264 missing_secrets = {}
1265 for item in data:
1266 if item["containers"] and item["requiredSecrets"]:
1267 variable = get_variable("nomad/jobs/" + item["id"])
1268 values = variable["Items"] if variable else {}
1269 missing = [name for name in item["requiredSecrets"] if not values.get(name)]
1270 if missing:
1271 missing_secrets[item["id"]] = missing
1272 if missing_secrets:
1273 raise ValueError("missing required secrets: " + "; ".join(
1274 f"{name}: {', '.join(keys)}" for name, keys in missing_secrets.items()))
1275 elif args.mode == "pool":
1276 ensure_pool(data)
1277 elif args.mode == "allocate":
1278 ensure_pool(data)
1279 bootstrap(data)
1280 for item in data:
1281 provision_inputs(item, definitions)
1282 provision(item)
1283 prepare(item)
1284 build_images(item)
1285 elif args.mode == "bootstrap":
1286 bootstrap(data)
1287 elif args.mode == "deploy":
1288 bootstrap(data)
1289 for item in data:
1290 provision_inputs(item, definitions)
1291 provision(item)
1292 prepare(item)
1293 build_images(item)
1294 submit(item, "run", definitions)
1295 configure(item)
1296
1297
1298if __name__ == "__main__":
1299 try:
1300 main()
1301 except (OSError, RuntimeError, ValueError, subprocess.CalledProcessError) as error:
1302 print(error, file=sys.stderr)
1303 sys.exit(1)
tools/source-of-truth-migration.md deleted-19
......@@ -1,19 +0,0 @@
1# Clover Source of Truth migration
2
3The existing preview can take a consistent copy of Zenith's live SQLite index without stopping the old service:
4
5```sh
6sh tools/import-source-index.sh clover-source-of-truth-preview-6311ec97
7```
8
9The script stops only that preview, snapshots its ZFS dataset, imports a SQLite `.backup`, checks integrity and checksums, then stages and checks the HTTP route. It retains the pre-import snapshot for recovery. It leaves the preview's own API key in place; the old key must be preserved for the production endpoint because existing clients send it as their authorization header.
10
11On 2026-09-26, Zenith's live index contained 2,592 media files, 136,842 derived file records, and 15,635 derived references. The imported preview passed SQLite integrity, reported the same counts, returned HTTP 200 at `clover-source-of-truth-preview-6311ec97.studio.test`, and had one healthy Nomad allocation. A nonexistent file returned 404. One indexed public raw file and its derived asset were copied from Zenith into the isolated preview, served over HTTPS with HTTP 200, and matched their source SHA-256 hashes; the test files were then removed. The full Published and `derived` trees remain absent from the VM. Zenith's derived tree holds 143,547 files totaling 39,684,661,494 bytes, beyond the demo pool's capacity.
12
13The `clo` account used by the stream importer had zero unreadable files and zero untraversable directories in the source tree at inspection.
14
15For the real cutover, keep `storage1/clover` mounted at `/srv/clover` and point the service's `/published` mount at `/srv/clover/Published`. That avoids copying Published at all. Stop the old source-of-truth container and the new Nomad job, then run `bash tools/import-source-data.sh` with `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT` set for the new host while Zenith remains reachable over SSH. The importer checks both jobs, streams `Documents/Config/paper clover/` into the service's managed ZFS dataset without storing 40 GB on the Mac, compares content digests and SQLite integrity, and leaves Snow Globe stopped with its pre-import snapshot available. A small cross-host fixture verified the stream, including a symlink and hardlink; the full 40 GB transfer remains a production cutover operation. Later staging clones the managed service dataset with ZFS.
16
17If NixOS replaces Zenith on the same machine, stop the old service and take a named `storage1/clover` snapshot before reinstalling. After the pool is mounted at `/srv/clover`, set `STUDIO_MIGRATION_SNAPSHOT=<name>` when running the same importer. It reads the immutable `/srv/clover/.zfs/snapshot/<name>/Documents/Config/paper clover/` tree on the new host and streams directly into the service dataset; no old Docker daemon or second machine is required. The importer rejects a missing or malformed snapshot name before changing the destination.
18
19Run `bash tools/import-legacy-secrets.sh clover-source-of-truth CLOVER_SOT_KEY` during cutover to transfer the old key directly from Zenith's `.env` into Snow Globe's Nomad secret, then deploy the service so its environment receives the imported value. This command changes the production service key; do not run it against the VM while its generated key is in use. Check a representative public raw and derived file over the new hostname before changing the public route. The old container and dataset snapshots remain available until this check passes.
tools/storage-acl-cutover.md deleted-49
......@@ -1,49 +0,0 @@
1# Storage ACL cutover
2
3Zenith mounts `storage1/clover` and `storage1/media` with `nfs4acl`. Their NFSv4 ACLs are nontrivial: Clover grants `group:apps` and `user:1000`; Media grants `user:clo` and TrueNAS built-in groups. Media has 2,431 directories and 28,729 files. Of those, 543 directories and 12,885 files are `root:root` with mode `770`, so UID 3000 relies on the NFSv4 ACL to reach them.
4
5[Stock OpenZFS on Linux does not enforce NFSv4 ACLs](https://openzfs.github.io/openzfs-docs/Basic%20Concepts/Datasets/ACLs.html). The NixOS VM accepted `acltype=nfsv4` on a disposable dataset but rejected `setfacl` and denied UID 3000 access to a root-owned `770` directory. Setting `acltype=posixacl` and granting UID 3000 access made the same check pass. A property value of `nfsv4` alone is therefore insufficient proof of access on NixOS.
6
7`tools/studio.py pool` rejects a mounted Clover or Media ZFS dataset with `acltype=nfsv4` before provisioning service volumes. It also rejects NFSv4 ACLs on the production or staging dataset parent, including values inherited from the pool; a disposable pool proved all three cases and accepted POSIX ACLs. Promotion runs the Clover/Media and production preflight before switching `/opt/studio/current`; a disposable NFSv4 dataset caused promotion to fail while its release link and history stayed unchanged.
8
9The media rename and mountpoint change in [media-cutover.md](media-cutover.md) must be paired with a permission migration. Rehearse it on copy-on-write clones of both datasets, leaving the originals and their snapshots intact. A shared numeric group `3000` with group read/write and setgid directories matches the VM's working Clover, Samba, and Copyparty permissions; a clone test must also verify media writers and readers before choosing that policy for the real tree. Changing `acltype` does not translate existing NFSv4 entries into POSIX ACLs, and [TrueNAS warns against recursive ACL changes without a snapshot](https://www.truenas.com/docs/scale/datasets/permissions/permissions/).
10
11A disposable POSIX-ACL ZFS fixture started with root-owned `0770` directories and a `0660` file that UID 3000 could not read. Granting named group 3000 access and a default ACL on directories, without changing owners, let UID 3000 and Jellyfin UID 3106 read the file. qBittorrent UID 3114 created a file that Copyparty UID 3116 could append to and UID 3000 could edit. The new file kept group 0 from its setgid parent, but inherited the named group 3000 ACL; the fixture was destroyed. This proves local service access on representative modes; SMB has a separate limitation below.
12
13A macOS SMB mount reached the VM over Tailscale and wrote a file as `3000:3000` with mode `0644`, despite Samba's `force create mode = 0660`; Copyparty's group identity could not edit it. A temporary Samba configuration with `acl_xattr` and `acl_xattr:ignore system acls = yes` yielded `0666`. Adding a parent default POSIX ACL (`user::rwx,group::rwx,other::---`) yielded files at `0660`, but Mac-created directories at `2777`. Adding `inherit permissions = yes` yielded directories at `2770` and files at `0660`; Copyparty's UID 3116/GID 3000 then appended to a Mac-created file and created a sibling in its directory. `inherit permissions` and the default ACL without `acl_xattr` instead yielded `0755` directories and `0644` files. That rehearsal introduced the ACL-xattr configuration superseded by the 2026-10-13 macOS fix below, while retaining the image's `catia fruit streams_xattr` Mac VFS modules. A disposable write through the staged Samba share again produced a `0660` file and `2770` directory, both writable by UID 3116/GID 3000; the fixture was removed. VM promotion `b1a2cdde0f6f12a4` passed all 19 HTTP routes and kept four PostgreSQL dumps in its pre-switch backup. The real dataset cutover still needs inherited POSIX ACLs applied through writable directories and verified on clones. [Samba documents the `acl_xattr` behavior](https://www.samba.org/samba/docs/current/man-html/vfs_acl_xattr.8.html).
14
15`acl_xattr:ignore system acls = yes` ignores named POSIX ACL grants for SMB permission checks. A staged Samba version without `acl_xattr` let a Linux SMB client write root-owned files through group ACLs, but a macOS mount then created `0644` files and `0755` directories that Copyparty could not edit. That version was rolled back. With the current Samba settings, a Mac mount created `0660` files and `2770` directories in a group-owned `3000` fixture, and Copyparty could append. The current configuration therefore needs group ownership as well as ACLs on a production clone rehearsal; the local UID test alone does not establish Finder access.
16
17A later disposable Samba test changed only `acl_xattr:ignore system acls` to `no`. In a root-owned, group-0 directory with a named/default POSIX ACL for group 3000, a macOS SMB mount created a file and directory, overwrote an existing root-owned file, and Copyparty UID 3116/GID 3000 appended to the new file. This worked both with and without `inherit permissions`. The new file and directory were `3000:3000` mode `0770`; the existing file retained root ownership. This offers a way to avoid changing ownership across the existing tree, but the executable bits on new regular files need review. The disposable dataset and container were removed, and the managed Samba job was restored without changing its configuration.
18
19An isolated Samba container on port 1445 was reachable from macOS through an SSH tunnel using `mount_smbfs //clo@127.0.0.1:1445/clover`; the managed share stayed online. In that fixture, disabling DOS archive/hidden/system mode mapping and then tightening `create mask` to `0660`, `directory mask` to `0770`, and `acl map full control` to `no` still produced `0770` Finder files and directories. Copyparty could append. The execute bits therefore appear to come from the ACL mapping in this combination, not the tested mode masks. The isolated container, dataset, and tunnel were removed.
20
21The same isolated setup without `acl_xattr` and with `inherit permissions = no` let Finder overwrite an existing root-owned file through its named ACL. New Finder files were `0644` and directories `0755` despite Samba's forced `0660`/`2770` modes, and the new file's inherited group ACL was masked to read-only; Copyparty could not append. That configuration cannot satisfy shared editing without a further permission mechanism. The fixture was removed.
22
23With Samba's default oplocks, a Mac SMB mount returned stale bytes and NULs immediately after Copyparty appended to a mounted file; remounting showed the correct server data. A disposable Samba container with `oplocks = no` returned the correct bytes immediately in the same test. The managed Samba job was restored afterward. Disabling oplocks may reduce SMB client caching performance and has not been promoted.
24
25Zenith's `storage1` pool root is unencrypted; `storage1/apps`, `storage1/clover`, and `storage1/media` are separate AES-256-GCM encryption roots with `keyformat=hex` and `keylocation=prompt`. Creating `storage1/prod` beneath the pool root without encryption would silently expose new app data. Snow Globe now requires an encrypted `prod` dataset mounted at `/srv/prod` whenever Clover or Media is encrypted. A disposable encrypted Clover dataset failed this preflight against the VM's unencrypted demo `prod`. A fresh disposable pool with separate encrypted Clover and `prod` roots passed: the `shale` service dataset inherited `prod` as its encryption root. The current VM predates the mounted-parent change and still has `studio-demo/prod` with `mountpoint=none`; its service children are mounted individually.
26
27The real host must load the selected keys before mounting datasets and starting Nomad; [loading a key does not itself mount the dataset](https://openzfs.github.io/openzfs-docs/man/v2.2/8/zfs-load-key.8.html). Keep keys out of the repository. A separate VM test confirmed that renaming one independent encrypted root beneath another preserves its independent encryption root.
28
29Copyparty's previous `df: 16` reserve rejected every upload on the 8 GB VM pool. Its prepared config now reserves one quarter of the dataset capacity, capped at the original 16 GB. The staged and production VM instances accepted a file and directory upload; the resulting `0664` file and setgid `2775` directory were writable by Clover's separate UID/GID 3000. Test files were removed, the Source of Truth preview was restarted, and the Copyparty preview was stopped to return the VM's reserved memory. Promotion `ec5322fadd8ae7a8` passed all 19 HTTP routes with 22 ZFS snapshots and four PostgreSQL dumps in its backup.
30
31Snow Globe's `zfs clone` of a disposable encrypted Media source stayed AES-256-GCM encrypted under an unencrypted staging parent and shared the Media encryption root; writes to the clone left the source unchanged. [OpenZFS specifies that clones always share their origin's encryption key](https://openzfs.github.io/openzfs-docs/man/master/7/zfsprops.7.html). Fresh stages have no encrypted origin to inherit, so `tools/studio.py stage` now requires an encrypted `pool/staging` mounted at `/srv/staging` when `pool/prod` is encrypted. A disposable pool proved missing and unencrypted staging parents are rejected, while an encrypted parent passes. The VM's existing unencrypted pool still stages normally.
32
33`storage1/apps` is one encrypted dataset with no child datasets: 47.8 GiB live and 65.3 GiB held by 207 snapshots at inspection. It also contains stacks excluded from Snow Globe. Renaming it to `storage1/prod` would preserve that history but leave the service folders as ordinary directories; moving selected data into per-service child datasets would still be necessary. Creating a separate encrypted `prod` root keeps the old tree and its snapshots available during migration.
34
35## macOS saves — 2026-10-13
36
37Zenith ran Samba 4.23.8 with `acl_xattr` but without `CAP_SYS_ADMIN`. On macOS 15.7.5, ordinary writes succeeded while `NSFileManager.replaceItemAt`, `NSDocument.writeSafely`, package replacement, and `chmod` failed with `EACCES`. The ACL module could not store protected `security.NTACL` attributes; [Samba documents that capability requirement](https://gitlab.com/samba-team/samba/-/merge_requests/3501). Only generated disposable files were opened during these probes.
38
39The [service declaration](../service/samba/service.pkl) now uses POSIX permissions directly. Disabling NFS ACE mode updates keeps Mac clients from bypassing the creation masks. Removing inherited mode handling leaves new regular files at `0660` and directories at `2770`; UID 3116/GID 3000 can edit them. A capability-only alternative fixed Cocoa saving but produced `0644` files that the shared group could not edit. Allowing AppleDouble names also fixes client temporary files and resource-fork copies; [Samba warns that vetoing these names breaks archive tools](https://www.samba.org/samba/docs/current/man-html/vfs_fruit.8.html).
40
41[The macOS regression probe](samba-macos-test.swift) creates and removes its own directory: `swift tools/samba-macos-test.swift <mounted-share>`. Its nine checks cover atomic writes, permission-preserving replacement, Cocoa Save As/save/autosave, RTFD packages, metadata and 128 KiB resource-fork copies, AppleDouble filenames, permission updates, replacement with an open reader, and cleanup. All passed in an isolated local Linux rehearsal and Zenith's ZFS preview `samba-preview-84726d65`. The preview used disposable authentication. Files owned by root and by UID 3116 were also editable through Cocoa in the local rehearsal. Blender 5.2 saved an asset and backup, linked it into a project, reopened the project, and read an external PNG from the share.
42
43Kernel oplocks make native service overwrites and appends invalidate SMB caches. The default SMB leases returned stale data even after reopening a file; the revised configuration returned the updated bytes immediately, including service-owned files. UID 3000 granted a kernel read lease on a disposable Zenith ZFS file without extra capabilities. An external atomic replacement retains the old inode while a Mac reader remains open; closing all old handles makes subsequent readers see the replacement. Disabling oplocks entirely showed the same Mac behavior, so the service retains kernel-backed caching.
44
45The live connection negotiated 1 Gb Ethernet. A disposable 128 MiB synthetic file measured 65.3 MiB/s writes with fsync and 76.6 MiB/s reads with the Mac data cache disabled and the server cache warm. Among 512 random 64 KiB reads, median/p95/maximum latency was 1.23/1.53/178.92 ms. These numbers do not establish real-time sample-library playback. Zenith has four 8 TB WD80EFPX HDDs in one RAIDZ1 vdev with 128 KiB records, a gigabit RTL8168 NIC, and 128 GB RAM; the Mac's unused built-in port supports 10 Gb. [RAIDZ streaming bandwidth scales across data disks, but default-record random-read IOPS are roughly one disk's](https://openzfs.github.io/openzfs-docs/Basic%20Concepts/Pool%20Structure/RAIDZ.html). A cable cannot remove the NAS NIC's speed limit.
46
47REAPER supports VST3, while macOS VST3 files are executable bundles ([REAPER](https://www.reaper.fm/about.php), [Steinberg](https://steinbergmedia.github.io/vst3_dev_portal/pages/Technical%2BDocumentation/Locations%2BFormat/Plugin%2BFormat.html)). Actual vendor plug-ins and sample libraries need their own playback trial. [Kontakt streams samples during playback](https://support.native-instruments.com/support/solutions/articles/69000879768-what-is-dfd-), and [NI advises against active libraries on NAS](https://support.native-instruments.com/support/solutions/articles/69000879313-notes-on-network-drives-and-disk-formats). No existing plug-in or sample-library contents were opened or moved during this work.
48
49Production release `94c1aa0a1f6a4a00` activated on 2026-10-14 at 05:45 UTC from main `f9c3a85e`, with pre-switch backup `20261014T054319Z-54be52`. All 22 HTTP routes and the Samba allocation were healthy. The live Mac mount passed all nine regression checks, shared-group writes became visible immediately, and Blender passed the asset round trip. The old mount disconnected during activation; a background NetFS reconnect restored `/Volumes/clover` using saved credentials. Generated files and the ZFS preview were removed afterward.
tools/studio-secret-files-test.py deleted-72
......@@ -1,72 +0,0 @@
1#!/usr/bin/env python3
2import json
3import os
4from pathlib import Path
5import subprocess
6import tempfile
7import unittest
8
9import studio
10
11
12class SecretFiles(unittest.TestCase):
13 @classmethod
14 def setUpClass(cls):
15 with tempfile.TemporaryDirectory(prefix="studio-secret-template-") as temporary:
16 fixture = Path(temporary) / "fixture.pkl"
17 fixture.write_text('amends ' + json.dumps((studio.REPO / "config/Service.pkl").as_uri()) + '\nmeta { name = "Fixture" }\ncontainer { image = "localhost/fixture:pinned" }\n')
18 result = subprocess.run([os.environ.get("PKL", "pkl"), "eval", "-p", "uid=3132", "-p", "serviceId=fixture", str(fixture)], check=True, capture_output=True, text=True)
19 cls.fixture = json.loads(result.stdout)
20 cls.fixture.update(uid=3132, sourceId="fixture", inputs={})
21 cls.fixture.pop("requirements")
22
23 def setUp(self):
24 self.data = json.loads(json.dumps(self.fixture))
25 self.task = self.data["containers"]["app"]
26 self.task["secretFiles"] = {"/run/secrets/oidc.json": '{{ with nomadVar "nomad/jobs/fixture/inputs/oidc" }}{"clientSecret":{{ .clientSecret.Value | toJSON }}}{{ end }}'}
27
28 def test_private_allocation_template_and_read_only_file_mount(self):
29 rendered = studio.render(self.data, {"fixture": self.data})
30 self.assertIn('"secrets/oidc.json:/run/secrets/oidc.json:ro"', rendered)
31 self.assertIn('destination = "secrets/oidc.json"', rendered)
32 self.assertIn('perms = "0400"', rendered)
33 self.assertIn('uid = 3132', rendered)
34 self.assertIn('gid = 3132', rendered)
35 self.assertIn('error_on_missing_key = true', rendered)
36 self.assertIn(self.task["secretFiles"]["/run/secrets/oidc.json"], rendered)
37 self.assertNotIn('env = true', rendered)
38 self.assertNotIn('change_mode =', rendered)
39
40 def test_services_without_files_gain_no_template_or_mount(self):
41 self.task["secretFiles"] = {}
42 rendered = studio.render(self.data, {"fixture": self.data})
43 self.assertNotIn('template {', rendered)
44 self.assertNotIn('secrets/', rendered)
45
46 def test_unsafe_and_colliding_targets_are_rejected(self):
47 for target in ("relative.json", "/run/../secret.json", "/run/./secret.json", "/run//secret.json", "/run/secrets/", "/secrets/file", "/secrets", "/run/app.env", "/run/app-secret.env", "/run/nomad_token", "/run/line\nbreak"):
48 with self.subTest(target=target):
49 self.task["secretFiles"] = {target: "{}"}
50 with self.assertRaisesRegex(ValueError, "invalid secret file target"):
51 studio.render(self.data, {"fixture": self.data})
52 self.task["secretFiles"] = {"/one/config.json": "{}", "/two/config.json": "{}"}
53 with self.assertRaisesRegex(ValueError, "invalid secret file target"):
54 studio.render(self.data, {"fixture": self.data})
55 self.task["secretFiles"] = {"/run/secrets/oidc.json": "{}"}
56 self.task["volumes"] = {"/run/secrets/oidc.json": {}}
57 with self.assertRaisesRegex(ValueError, "invalid secret file target"):
58 studio.render(self.data, {"fixture": self.data})
59
60 def test_image_user_and_heredoc_injection_are_rejected(self):
61 self.task["imageUser"] = True
62 with self.assertRaisesRegex(ValueError, "service-owned"):
63 studio.render(self.data, {"fixture": self.data})
64 self.task["imageUser"] = False
65 for body in ("EOF", "{}\nEOF\nmalicious", "{}\nEOF\r\nmalicious"):
66 self.task["secretFiles"] = {"/run/secrets/oidc.json": body}
67 with self.assertRaisesRegex(ValueError, "invalid secret template delimiter"):
68 studio.render(self.data, {"fixture": self.data})
69
70
71if __name__ == "__main__":
72 unittest.main()
tools/studio.py deleted-1286
......@@ -1,1286 +0,0 @@
1#!/usr/bin/env python3
2import argparse
3from contextlib import nullcontext
4import fcntl
5import hashlib
6import json
7import os
8from pathlib import Path
9import re
10import secrets
11import shutil
12import subprocess
13import sys
14import tempfile
15import time
16
17from data import cloned_postgres, dataset_for
18from release import excluded_services
19
20
21REPO = Path(__file__).resolve().parent.parent
22SERVICES = REPO / "service"
23STATE = Path("/var/lib/studio")
24IDENTITIES = STATE / "identities.json"
25ASSETS = Path("/var/lib/caddy/studio")
26NAME = re.compile(r"[a-z][a-z0-9-]*\Z")
27
28
29def command(*args, capture=False, **kwargs):
30 return subprocess.run(args, check=True, text=True, capture_output=capture, **kwargs)
31
32
33def service_files():
34 excluded = excluded_services(REPO)
35 files = {}
36 for directory in SERVICES.iterdir():
37 if directory.name in excluded or not directory.is_dir():
38 continue
39 for path in directory.glob("*.pkl"):
40 name = directory.name if path.name == "service.pkl" else path.stem
41 if name in excluded:
42 continue
43 if name in files:
44 raise ValueError(f"duplicate service definition: {name}")
45 files[name] = path
46 return files
47
48
49def services():
50 return sorted(service_files())
51
52
53def service_dir(name):
54 path = service_files()[name]
55 return path.parent if path.name == "service.pkl" else path.parent / name
56
57
58def dependencies(data):
59 return set(data["dependsOn"]) | {item["provider"] for item in data["inputs"].values() if item["provider"] != "snowglobe"}
60
61
62def ordered(data):
63 pending = {item["id"]: item for item in data}
64 result = []
65 while pending:
66 ready = [
67 item
68 for item in pending.values()
69 if not dependencies(item) & pending.keys()
70 ]
71 if not ready:
72 raise ValueError("cycle in service dependencies")
73 for item in ready:
74 result.append(item)
75 del pending[item["id"]]
76 return result
77
78
79def identity(name):
80 STATE.mkdir(parents=True, exist_ok=True)
81 if not IDENTITIES.exists():
82 write_private(IDENTITIES, (REPO / "config/identities.json").read_text())
83 with (IDENTITIES.parent / ".identities.lock").open("w") as lock:
84 fcntl.flock(lock, fcntl.LOCK_EX)
85 with IDENTITIES.open() as file:
86 ids = json.load(file)
87 if len(set(ids.values())) != len(ids):
88 raise ValueError("duplicate service UIDs")
89 if name not in ids:
90 used = set(ids.values())
91 ids[name] = next(uid for uid in range(3100, 60000) if uid not in used)
92 pending = IDENTITIES.with_suffix(".pending")
93 pending.write_text(json.dumps(ids, indent=2) + "\n")
94 pending.replace(IDENTITIES)
95 return ids[name]
96
97
98def load(name, properties, instance_id=None):
99 files = service_files()
100 if not NAME.fullmatch(name) or name not in files:
101 raise ValueError(f"unknown service: {name}")
102 instance_id = instance_id or name
103 if not NAME.fullmatch(instance_id):
104 raise ValueError(f"invalid instance ID: {instance_id}")
105 uid = identity(name)
106 result = command(
107 "pkl",
108 "eval",
109 *(
110 part
111 for key, value in {**properties, "serviceId": instance_id, "uid": uid, "preview": str(instance_id != name).lower()}.items()
112 for part in ("-p", f"{key}={value}")
113 ),
114 str(files[name]),
115 capture=True,
116 )
117 data = json.loads(result.stdout)
118 if data["id"] != instance_id:
119 raise ValueError(f"service ID must match deployment: {instance_id}")
120 inputs = {}
121 for requirement in data.pop("requirements"):
122 alias = requirement["alias"]
123 if not NAME.fullmatch(alias) or alias == "own" or alias in inputs:
124 raise ValueError(f"invalid or duplicate requirement alias: {alias}")
125 inputs[alias] = requirement
126 data["inputs"] = inputs
127 data["uid"] = uid
128 data["sourceId"] = name
129 for task_name, task in data["containers"].items():
130 if bool(task.get("image")) == bool(task.get("build")):
131 raise ValueError(f"{name}.{task_name} needs one image or build directory")
132 if task.get("build"):
133 if REPO.parent == Path("/opt/studio/releases"):
134 context = config_path(name, task["build"])
135 if not context.is_dir() or not (context / "Dockerfile").is_file():
136 raise ValueError(f"invalid build context: {name}.{task_name}")
137 digest = hashlib.sha256()
138 for path in sorted(context.rglob("*")):
139 if path.is_file():
140 digest.update(str(path.relative_to(context)).encode() + b"\0")
141 digest.update(path.read_bytes())
142 tag = digest.hexdigest()[:16]
143 elif not (service_dir(name) / task["build"] / "Dockerfile").is_file() and not (service_dir(name) / "build-source.json").is_file():
144 raise ValueError(f"missing build source: {name}.{task_name}")
145 else:
146 tag = REPO.name
147 task["image"] = f"localhost/studio/{name}-{task_name}:{tag}"
148 return data
149
150
151def q(value):
152 return json.dumps(value, ensure_ascii=False)
153
154
155def write_private(path, content):
156 pending = None
157 try:
158 with tempfile.NamedTemporaryFile("w", dir=path.parent, delete=False) as file:
159 pending = Path(file.name)
160 file.write(content)
161 pending.replace(path)
162 finally:
163 if pending:
164 pending.unlink(missing_ok=True)
165
166
167def host_path(root, relative):
168 if relative == ".":
169 return root
170 part = Path(relative)
171 if part.is_absolute() or ".." in part.parts or not part.parts:
172 raise ValueError(f"invalid relative path: {relative}")
173 return str(Path(root) / part)
174
175
176def config_path(service, relative):
177 root = service_dir(service).resolve()
178 source = (root / relative).resolve()
179 if not source.is_relative_to(root) or not source.exists():
180 raise ValueError(f"invalid config path: {relative}")
181 return source
182
183
184def config_assets(data):
185 paths = set()
186 for task in data["containers"].values():
187 paths.update(volume["config"] for volume in task["volumes"].values() if volume.get("config"))
188 if task.get("http"):
189 paths.update(task["http"]["overrideFiles"].values())
190 sources = {rel: config_path(data.get("sourceId", data["id"]), rel) for rel in paths}
191 digest = hashlib.sha256()
192 for rel, source in sorted(sources.items()):
193 digest.update(rel.encode())
194 files = sorted(source.rglob("*")) if source.is_dir() else [source]
195 for file in files:
196 if file.is_symlink():
197 raise ValueError(f"config asset cannot be a symlink: {file}")
198 if file.is_file():
199 digest.update(str(Path(rel) / file.relative_to(source)).encode() if source.is_dir() else rel.encode())
200 digest.update(file.read_bytes())
201 return ASSETS / data["id"] / digest.hexdigest()[:16], sources
202
203
204def render(data, definitions):
205 if not data["containers"]:
206 return ""
207 name = data["id"]
208 asset_dir, _ = config_assets(data)
209 prepare_digest = None
210 if data.get("prepare"):
211 source = service_dir(data.get("sourceId", name))
212 digest = hashlib.sha256()
213 for path in sorted(source.rglob("*")):
214 if not path.is_file() or "__pycache__" in path.parts or path.suffix == ".pyc":
215 continue
216 if path.name == "service.pkl" or path.name.startswith("icon"):
217 continue
218 digest.update(str(path.relative_to(source)).encode() + b"\0")
219 digest.update(path.read_bytes())
220 prepare_digest = digest.hexdigest()[:16]
221 routed = [task["http"] for task in data["containers"].values()
222 if task.get("http") and task["http"].get("hostname")]
223 primary = routed[0] if routed else {}
224 requirements = {provider: "startup" for provider in data["dependsOn"]}
225 requirements.update({item["provider"]: item["kind"] for item in data["inputs"].values()})
226 secrets_meta = [
227 {"name": name, "generated": True, "bytes": spec["bytes"]}
228 for name, spec in data["secrets"].items()
229 ] + [{"name": name, "generated": False} for name in data["requiredSecrets"]]
230 lines = [
231 f"job {q(name)} {{",
232 ' datacenters = ["clover"]',
233 ' type = "service"',
234 ' meta {',
235 f" studio_service = {q(data['sourceId'])}",
236 f" studio_name = {q(data['name'])}",
237 f" studio_tagline = {q(data['tagline'])}",
238 f" studio_hostname = {q(primary.get('hostname') or '')}",
239 f" studio_launcher = {q(str(data['launcher']).lower())}",
240 f" studio_auth_role = {q(data.get('access') or primary.get('authRole') or '')}",
241 f" studio_trace_service = {q(data.get('traceServiceName') or '')}",
242 f" studio_metrics_pushed = {q(str(data['metricsPushed']).lower())}",
243 f" studio_requires = {q(json.dumps(requirements))}",
244 f" studio_secrets = {q(json.dumps(secrets_meta))}",
245 ' }',
246 ' group "app" {',
247 ]
248 if dependencies(data):
249 lines += [
250 " restart {",
251 " attempts = 3",
252 ' delay = "1m"',
253 ' interval = "4m"',
254 ' mode = "delay"',
255 " }",
256 ]
257 if data["rollout"] == "overlapped":
258 for task in data["containers"].values():
259 if task["hostNetwork"] or any(
260 endpoint and endpoint.get("hostPort") is not None
261 for endpoint in (task.get("http"), *task["tcp"])
262 ) or any(not volume["readOnly"] for volume in task["volumes"].values()):
263 raise ValueError(f"overlapped rollout requires dynamic ports and read-only mounts: {name}")
264 elif data["rollout"] != "simple":
265 raise ValueError(f"unknown rollout: {data['rollout']}")
266 if data["rollout"] == "overlapped" or data.get("healthyDeadline"):
267 lines.append(" update {")
268 if data["rollout"] == "overlapped":
269 lines += [" canary = 1", " auto_promote = true", " auto_revert = true"]
270 if data.get("healthyDeadline"):
271 lines += [f" healthy_deadline = {q(data['healthyDeadline'])}", ' progress_deadline = "0"']
272 lines.append(" }")
273 if data.get("healthyDeadline"):
274 lines += [" migrate {", f" healthy_deadline = {q(data['healthyDeadline'])}", " }"]
275 ports = {}
276 network = []
277 host_network = any(task["hostNetwork"] for task in data["containers"].values())
278 if host_network and not all(task["hostNetwork"] for task in data["containers"].values()):
279 raise ValueError("mixed host and bridge networking in one group")
280 for task_name, task in data["containers"].items():
281 for kind, endpoint in [("http", task.get("http")), *((port["name"], port) for port in task["tcp"])]:
282 if endpoint:
283 label = kind if len(data["containers"]) == 1 else f"{task_name}-{kind}"
284 if label in ports.values():
285 raise ValueError(f"duplicate port label: {label}")
286 ports[(task_name, kind)] = label
287 network.append(f" port {q(label)} {{")
288 if endpoint.get("hostPort") is not None:
289 network.append(f" static = {endpoint['hostPort']}")
290 if not task["hostNetwork"]:
291 network.append(f" to = {endpoint['containerPort']}")
292 if endpoint.get("loopback") or (not task["hostNetwork"] and kind == "http" and endpoint.get("hostPort") is None):
293 network.append(' host_network = "loopback"')
294 network.append(" }")
295 if network:
296 lines.append(" network {")
297 if host_network:
298 lines.append(' mode = "host"')
299 lines += network + [" }"]
300 for provider_id in sorted(dependencies(data)):
301 provider = definitions[provider_id]
302 for provider_task, container in provider["containers"].items():
303 endpoint = container.get("http")
304 if not endpoint or not endpoint.get("hostname") or endpoint.get("authRole"):
305 continue
306 host = endpoint["hostname"]
307 task_name = f"wait-{provider_id}-{provider_task}"
308 lines += [
309 f" task {q(task_name)} {{",
310 ' driver = "podman"',
311 " lifecycle {",
312 ' hook = "prestart"',
313 " sidecar = false",
314 " }",
315 " config {",
316 ' image = "docker.io/curlimages/curl@sha256:43ebaa53d3806db6b1ce4353b6b26ae638ec1c167ee351524b05690f988bb20d"',
317 f" extra_hosts = {q([host + ':host-gateway'])}",
318 f" args = {q(['--insecure', '--fail', '--silent', '--show-error', '--retry', '999999', '--retry-all-errors', '--retry-delay', '5', '--connect-timeout', '3', '--max-time', '5', 'https://' + host + endpoint['checkPath']])}",
319 " }",
320 " resources {",
321 " cpu = 50",
322 " memory = 64",
323 " }",
324 " }",
325 ]
326 for task_name, task in data["containers"].items():
327 if task.get("http") or task.get("tcp"):
328 kind = "http" if task.get("http") else "tcp"
329 endpoint = task["http"] if kind == "http" else task["tcp"][0]
330 label = ports[(task_name, "http" if kind == "http" else endpoint["name"])]
331 lines += [" service {", f" name = {q(name if task_name == 'app' else name + '-' + task_name)}", ' provider = "nomad"', f" port = {q(label)}"]
332 if len(data["containers"]) == 1:
333 lines.append(f" task = {q(task_name)}")
334 tags = []
335 if kind == "http" and endpoint.get("metricsPath"):
336 tags.append("studio-metrics-path=" + endpoint["metricsPath"])
337 if kind == "http" and endpoint.get("hostname"):
338 tags += ["caddy-host=" + host for host in [endpoint["hostname"], *endpoint["plainHostnames"]]]
339 if endpoint.get("authRole"):
340 tags.append("caddy-auth-role=" + endpoint["authRole"])
341 if endpoint.get("userHeader"):
342 tags.append("caddy-user-header=" + endpoint["userHeader"])
343 if endpoint["forwardRealIp"]:
344 tags.append("caddy-real-ip=true")
345 if endpoint.get("secureCookies"):
346 tags.append("caddy-secure-cookies=true")
347 if endpoint["tlsInternal"]:
348 tags.append("caddy-internal=true")
349 if tags:
350 lines.append(f" tags = {q(tags)}")
351 lines += [" check {", f" type = {q(kind)}"]
352 if kind == "http":
353 lines.append(f" path = {q(endpoint['checkPath'])}")
354 if endpoint["checkHeaders"]:
355 lines.append(" header {")
356 for key, value in endpoint["checkHeaders"].items():
357 if not re.fullmatch(r"[A-Za-z][A-Za-z0-9-]*", key):
358 raise ValueError(f"invalid health check header: {key}")
359 lines.append(f" {key} = [{q(value)}]")
360 lines.append(" }")
361 lines += [
362 ' interval = "10s"',
363 ' timeout = "15s"',
364 ' check_restart {',
365 ' limit = 12',
366 f" grace = {q(data.get('healthRestartGrace') or data.get('healthyDeadline') or '5m')}",
367 ' }',
368 ' }',
369 ' }',
370 ]
371 for task_name, task in data["containers"].items():
372 lines += [f" task {q(task_name)} {{", ' driver = "podman"']
373 if task["lifecycle"] != "main":
374 lines += [' lifecycle {', ' hook = "prestart"',
375 f" sidecar = {str(task['lifecycle'] == 'prestartSidecar').lower()}", ' }']
376 if not task["imageUser"]:
377 uses_clover = any(
378 volume.get("clover") or (
379 volume.get("src")
380 and Path(volume["src"]).resolve().is_relative_to(Path(data["cloverRoot"]).resolve())
381 )
382 for volume in task["volumes"].values()
383 )
384 gid = data["cloverGid"] if uses_clover else 0 if task["rootGroup"] else data["uid"]
385 lines.append(f" user = {q(str(data['uid']) + ':' + str(gid))}")
386 lines += [" config {", f" image = {q(task['image'])}"]
387 if task.get("entrypoint"):
388 lines.append(f" entrypoint = {q(task['entrypoint'])}")
389 if task["args"]:
390 lines.append(f" args = {q(task['args'])}")
391 if task["hostNetwork"]:
392 lines.append(' network_mode = "host"')
393 task_ports = [label for (owner, _), label in ports.items() if owner == task_name]
394 if task_ports and not task["hostNetwork"]:
395 lines.append(f" ports = {q(task_ports)}")
396 for field, values in (("cap_add", task["capAdd"]), ("devices", task["devices"]), ("extra_hosts", task["extraHosts"])):
397 if values:
398 lines.append(f" {field} = {q(values)}")
399 volumes = []
400 secret_files = task.get("secretFiles", {})
401 filenames = set()
402 for target, template in secret_files.items():
403 filename = Path(target).name
404 if (not re.fullmatch(r"/[A-Za-z0-9_./-]+", target) or target.endswith("/")
405 or any(part in {".", "..", ""} for part in target[1:].split("/"))
406 or filename in filenames
407 or filename in {task_name + ".env", task_name + "-secret.env", "nomad_token"}
408 or target in task["volumes"] or target == "/secrets" or target.startswith("/secrets/")):
409 raise ValueError(f"invalid secret file target: {target}")
410 if task["imageUser"]:
411 raise ValueError("secret files require a service-owned container user")
412 if re.search(r"(?m)^EOF\r?$", template):
413 raise ValueError("invalid secret template delimiter")
414 filenames.add(filename)
415 volumes.append(f"secrets/{filename}:{target}:ro")
416 for target, volume in task["volumes"].items():
417 if not target.startswith("/") or ":" in target:
418 raise ValueError(f"invalid volume target: {target}")
419 if volume.get("config") is not None:
420 if volume.get("src") is not None or not volume["readOnly"]:
421 raise ValueError("config mounts must be read only and have no host source")
422 config_path(data.get("sourceId", name), volume["config"])
423 source = host_path(str(asset_dir), volume["config"])
424 elif volume.get("src") is not None:
425 source = volume["src"]
426 if not Path(source).is_absolute():
427 raise ValueError(f"volume source must be absolute: {source}")
428 else:
429 source = host_path(data["hostRoot"], target.lstrip("/"))
430 if ":" in source:
431 raise ValueError(f"invalid volume source: {source}")
432 volumes.append(f"{source}:{target}" + (":ro" if volume["readOnly"] else ""))
433 if volumes:
434 lines.append(f" volumes = {q(volumes)}")
435 if task["tmpfs"]:
436 lines.append(f" tmpfs = {q(task['tmpfs'])}")
437 lines.append(" }")
438 secret_env = []
439 plain_env = {}
440 for key, value in task["env"].items():
441 if not re.fullmatch(r"[A-Za-z_][A-Za-z0-9_]*", key):
442 raise ValueError(f"invalid env key: {key}")
443 parts = re.split(r"(\$\{secret\.[A-Za-z_][A-Za-z0-9_]*\.[A-Za-z_][A-Za-z0-9_]*\})", value)
444 if len(parts) == 1:
445 if "${secret." in value:
446 raise ValueError(f"invalid secret reference: {value}")
447 plain_env[key] = value
448 continue
449 args = []
450 paths = {}
451 for part in parts:
452 match = re.fullmatch(r"\$\{secret\.([A-Za-z_][A-Za-z0-9_]*)\.([A-Za-z_][A-Za-z0-9_]*)\}", part)
453 if match:
454 alias, field = match.groups()
455 if alias != "own" and alias not in data["inputs"]:
456 raise ValueError(f"unknown secret alias: {alias}")
457 path = f"nomad/jobs/{name}" + (f"/inputs/{alias}" if alias != "own" else "")
458 variable = paths.setdefault(path, f"$s{len(paths)}")
459 args.append(f"(index {variable} {q(field)}).Value")
460 elif part:
461 args.append(q(part))
462 start = "".join(f'{{{{ with {variable} := nomadVar {q(path)} }}}}' for path, variable in paths.items())
463 end = "{{ end }}" * len(paths)
464 secret_env.append(f'{start}{key}={{{{ print {" ".join(args)} | toJSON }}}}{end}')
465 if "STUDIO_PREPARE_DIGEST" in task["env"]:
466 raise ValueError("STUDIO_PREPARE_DIGEST is reserved")
467 lines.append(" env {")
468 for key, value in plain_env.items():
469 lines.append(f" {key} = {q(value)}")
470 if prepare_digest:
471 lines.append(f" STUDIO_PREPARE_DIGEST = {q(prepare_digest)}")
472 lines.append(" }")
473 if secret_env:
474 lines += [" template {", " data = <<EOF", *secret_env, "EOF", f' destination = {q("secrets/" + task_name + "-secret.env")}', " env = true", " error_on_missing_key = true", " }"]
475 if task.get("envTemplate"):
476 if "\nEOF\n" in task["envTemplate"]:
477 raise ValueError("invalid env template delimiter")
478 lines += [" template {", " data = <<EOF", task["envTemplate"].rstrip(), "EOF", f' destination = {q("secrets/" + task_name + ".env")}', " env = true", " }"]
479 for target, template in secret_files.items():
480 lines += [" template {", " data = <<EOF", template.rstrip(), "EOF",
481 f' destination = {q("secrets/" + Path(target).name)}', ' perms = "0400"',
482 f' uid = {data["uid"]}', f' gid = {data["uid"]}',
483 " error_on_missing_key = true", " }"]
484 lines += [" resources {", f" cpu = {task['cpu']}", f" memory = {task['memory']}", " }", " }"]
485 lines += [" }", "}"]
486 return "\n".join(lines) + "\n"
487
488
489def token():
490 if "NOMAD_TOKEN" not in os.environ:
491 os.environ["NOMAD_TOKEN"] = (STATE / "nomad.token").read_text().strip()
492
493
494def get_variable(path):
495 result = subprocess.run(["nomad", "var", "get", "-out=json", path], capture_output=True, text=True)
496 if result.returncode == 0:
497 return json.loads(result.stdout)
498 if "Variable not found" in result.stderr + result.stdout:
499 return None
500 raise RuntimeError(f"Nomad variable read failed for {path}: {result.stderr.strip()}")
501
502
503def provision(data):
504 if not data["containers"]:
505 return
506 if os.geteuid() != 0:
507 raise PermissionError("provisioning requires root")
508 root = Path(data["hostRoot"])
509 if data["hasManagedVolumes"]:
510 root.mkdir(parents=True, exist_ok=True)
511 if command(
512 "findmnt", "-n", "-o", "FSTYPE", "--mountpoint", str(root), capture=True
513 ).stdout.strip() != "zfs":
514 raise ValueError(f"expected ZFS dataset at {root}")
515 for task in data["containers"].values():
516 gid = 0 if task["rootGroup"] else data["uid"]
517 for target, volume in task["volumes"].items():
518 if volume.get("config") is not None or volume.get("src") is not None:
519 continue
520 path = Path(host_path(str(root), target.lstrip("/")))
521 path.mkdir(parents=True, exist_ok=True)
522 os.chown(path, data["uid"], gid)
523 path.chmod(0o750)
524 if data["sourceId"] == "ytdl" and target == "/data":
525 command("systemd-tmpfiles", "--create", "--prefix=" + str(path))
526 bundle = STATE / "ca-bundle.crt"
527 if any(
528 volume.get("src") == str(bundle)
529 for task in data["containers"].values()
530 for volume in task["volumes"].values()
531 ):
532 contents = Path("/etc/ssl/certs/ca-certificates.crt").read_bytes()
533 local_ca = Path("/var/lib/caddy/.local/share/caddy/pki/authorities/local/root.crt")
534 if local_ca.exists():
535 contents += b"\n" + local_ca.read_bytes()
536 if not bundle.exists() or bundle.read_bytes() != contents:
537 pending = bundle.with_suffix(".pending")
538 pending.write_bytes(contents)
539 pending.chmod(0o644)
540 pending.replace(bundle)
541 route_dir = STATE / "routes"
542 route_dir.mkdir(parents=True, exist_ok=True)
543 asset_dir, assets = config_assets(data)
544 static = {}
545 directories = {}
546 identity = {}
547 head_html = {}
548 metrics_paths = {}
549 for task in data["containers"].values():
550 if task.get("http"):
551 http = task["http"]
552 if http["identityHeaders"]:
553 identity[http["hostname"]] = http["identityHeaders"]
554 if http["headHtml"]:
555 head_html[http["hostname"]] = http["headHtml"]
556 if http.get("metricsPath") and http["hostname"]:
557 metrics_paths[http["hostname"]] = http["metricsPath"]
558 for request, rel in http["overrideFiles"].items():
559 origin = assets[rel]
560 target = directories if origin.is_dir() else static
561 target[request] = host_path(str(asset_dir), rel)
562 if assets:
563 asset_dir.parent.mkdir(parents=True, exist_ok=True)
564 asset_dir.parent.chmod(0o755)
565 if assets and not asset_dir.exists():
566 temporary = tempfile.mkdtemp(dir=asset_dir.parent)
567 try:
568 for rel, origin in assets.items():
569 destination = Path(temporary) / rel
570 destination.parent.mkdir(parents=True, exist_ok=True)
571 if origin.is_dir():
572 shutil.copytree(origin, destination)
573 for child in destination.rglob("*"):
574 child.chmod(0o755 if child.is_dir() else 0o644)
575 else:
576 shutil.copy2(origin, destination)
577 destination.chmod(0o644)
578 Path(temporary).chmod(0o755)
579 os.replace(temporary, asset_dir)
580 finally:
581 shutil.rmtree(temporary, ignore_errors=True)
582 secret_dir = STATE / "secrets"
583 secret_dir.mkdir(parents=True, exist_ok=True)
584 secret_file = secret_dir / f"{data['id']}.nv.hcl"
585 generated = data["secrets"]
586 required = data["requiredSecrets"]
587 secret_path = "nomad/jobs/" + data["id"]
588 existing = get_variable(secret_path) if generated or required else None
589 if generated and not existing and secret_file.exists():
590 command("nomad", "var", "put", "-in=hcl", "-out=none", secret_path, "@" + str(secret_file))
591 existing = get_variable(secret_path)
592 values = dict(existing["Items"]) if existing else {}
593 if generated:
594 for item, spec in generated.items():
595 if item not in values:
596 values[item] = secrets.token_hex(spec["bytes"])
597 if not existing or values != existing["Items"]:
598 put_variable(secret_path, values, existing["ModifyIndex"] if existing else 0)
599 backup = "items {\n" + "".join(f" {item} = {q(value)}\n" for item, value in values.items()) + "}\n"
600 if not secret_file.exists() or secret_file.read_text() != backup:
601 write_private(secret_file, backup)
602 if required:
603 missing = [name for name in required if not values.get(name)]
604 if missing:
605 raise ValueError(f"missing required secrets for {data['id']}: {', '.join(missing)}")
606 proof = {}
607 for task in data["containers"].values():
608 http = task.get("http")
609 if http and http.get("identityProofSecret"):
610 name = http["identityProofSecret"]
611 if not http["identityHeaders"] or name not in values:
612 raise ValueError(f"missing identity proof secret for {data['id']}")
613 proof[http["hostname"]] = "X-Studio-Idp-" + values[name]
614 write_private(route_dir / f"{data['id']}.json", json.dumps({
615 "files": static, "dirs": directories, "identity": identity,
616 "identityProof": proof, "headHtml": head_html, "metricsPaths": metrics_paths,
617 }))
618
619
620def submit(data, mode, definitions):
621 if not data["containers"]:
622 return
623 with tempfile.NamedTemporaryFile("w", suffix=".nomad.hcl", delete=False) as file:
624 file.write(render(data, definitions))
625 path = file.name
626 try:
627 command("nomad", "job", mode, path)
628 finally:
629 Path(path).unlink()
630
631
632def build_images(data):
633 for task in data["containers"].values():
634 if task.get("build"):
635 image = task["image"]
636 if subprocess.run(["podman", "image", "exists", image]).returncode:
637 command("podman", "build", "-t", image, str(config_path(data["sourceId"], task["build"])))
638
639
640def clone_dataset(source, snapshot, dataset, mount):
641 acltype = command("zfs", "get", "-H", "-o", "value", "acltype", source, capture=True).stdout.strip()
642 command("zfs", "clone", "-o", "mountpoint=" + mount, "-o", "acltype=" + acltype, snapshot, dataset)
643
644
645def check_http(host, path, tls_internal=False, attempts=120):
646 for attempt in range(attempts):
647 try:
648 if subprocess.run(
649 ["curl", "--noproxy", "*", "-sf", *(["--cacert", "/var/lib/caddy/.local/share/caddy/pki/authorities/local/root.crt"] if tls_internal else []), "--resolve", f"{host}:443:127.0.0.1", f"https://{host}{path}"],
650 capture_output=True, timeout=3,
651 ).returncode == 0:
652 print(f"Healthy {host}")
653 return
654 except subprocess.TimeoutExpired:
655 pass
656 time.sleep(2)
657 raise RuntimeError(f"HTTPS route is unhealthy: {host}")
658
659
660def put_variable(path, items, index=None):
661 with tempfile.NamedTemporaryFile("w", suffix=".nv.hcl", delete=False) as file:
662 file.write("items {\n" + "".join(f" {key} = {q(value)}\n" for key, value in items.items()) + "}\n")
663 filename = file.name
664 try:
665 command("nomad", "var", "put", "-in=hcl", "-out=none", *([f"-check-index={index}"] if index is not None else []), path, "@" + filename)
666 finally:
667 Path(filename).unlink()
668
669
670def configure(data):
671 if not data.get("setup"):
672 return
673 if data["setup"].startswith("tools/"):
674 script = (REPO / data["setup"]).resolve()
675 if not script.is_relative_to(REPO / "tools") or not script.is_file():
676 raise ValueError(f"invalid shared setup script: {data['setup']}")
677 else:
678 script = config_path(data.get("sourceId", data["id"]), data["setup"])
679 routes = [task["http"] for task in data["containers"].values()
680 if task.get("http") and task["http"].get("hostname")]
681 if len(routes) != 1:
682 raise ValueError("service setup requires one HTTP hostname")
683 route = routes[0]
684 check_http(route["hostname"], route["checkPath"], route["tlsInternal"], attempts=600)
685 variable = get_variable("nomad/jobs/" + data["id"])
686 own = variable["Items"] if variable else {}
687 command("python3", str(script), input=json.dumps({
688 "serviceId": data["id"], "host": route["hostname"], "hostRoot": data["hostRoot"],
689 "preview": data["id"] != data.get("sourceId", data["id"]),
690 "ownerEmail": data["ownerEmail"], **own,
691 }))
692 print(f"Configured {data['id']}")
693
694
695def prepare(data):
696 if data.get("prepare"):
697 script = config_path(data.get("sourceId", data["id"]), data["prepare"])
698 command("python3", str(script), input=json.dumps({
699 "hostRoot": data["hostRoot"], "uid": data["uid"],
700 }))
701
702
703def provision_inputs(data, definitions, stage_id=None, postgres_source=None):
704 for alias, request in data["inputs"].items():
705 if not NAME.fullmatch(alias):
706 raise ValueError(f"invalid input alias: {alias}")
707 native = request["provider"] == "snowglobe"
708 provider = {"id": "snowglobe", "provide": True, "containers": {}} if native else definitions[request["provider"]]
709 if not provider.get("provide"):
710 raise ValueError(f"{provider['id']} does not provide inputs")
711 path = f"nomad/jobs/{data['id']}/inputs/{alias}"
712 variable = get_variable(path)
713 own = (get_variable("nomad/jobs/" + provider["id"]) or {}).get("Items", {})
714 http = next((task["http"] for task in provider["containers"].values()
715 if task.get("http") and task["http"].get("hostname")), None)
716 if http:
717 check_http(http["hostname"], http["checkPath"], http["tlsInternal"])
718 payload = {
719 "request": request,
720 "existing": variable["Items"] if variable else None,
721 "providerSecrets": own,
722 "host": http["hostname"] if http else None,
723 }
724 if stage_id:
725 payload["stageId"] = stage_id
726 if postgres_source and provider["id"] == "postgres":
727 payload["sourceContainer"] = postgres_source
728 script = REPO / "tools/oidc-provider.py" if native else config_path(provider["id"], provider["provide"])
729 result = command("python3", str(script), input=json.dumps(payload), capture=True)
730 values = json.loads(result.stdout)
731 if not isinstance(values, dict) or not values or any(
732 not re.fullmatch(r"[A-Za-z_][A-Za-z0-9_]*", key) or not isinstance(value, str) or not value
733 for key, value in values.items()
734 ):
735 raise ValueError(f"invalid outputs from {provider['id']}")
736 if not variable or variable["Items"] != values:
737 put_variable(path, values, variable["ModifyIndex"] if variable else None)
738 print(f"Allocated {data['id']}.{alias} from {provider['id']}")
739
740
741def bootstrap(all_data):
742 if os.geteuid() != 0:
743 raise PermissionError("bootstrap requires root")
744 STATE.mkdir(parents=True, exist_ok=True)
745 if not (STATE / "nomad.token").exists():
746 result = command("nomad", "acl", "bootstrap", "-json", capture=True)
747 write_private(STATE / "nomad.token", json.loads(result.stdout)["SecretID"] + "\n")
748 token()
749 command(
750 "nomad",
751 "acl",
752 "policy",
753 "apply",
754 "studio-router",
755 str(REPO / "config/policies/router.hcl"),
756 )
757 command("nomad", "acl", "policy", "apply", "studio-dashboard",
758 str(REPO / "config/policies/dashboard.hcl"))
759 router_token = STATE / "router.token"
760 if not router_token.exists():
761 result = command(
762 "nomad",
763 "acl",
764 "token",
765 "create",
766 "-policy=studio-router",
767 "-name=studio-router",
768 "-json",
769 capture=True,
770 )
771 write_private(router_token, json.loads(result.stdout)["SecretID"] + "\n")
772 dashboard_token = STATE / "dashboard.token"
773 if not dashboard_token.exists():
774 result = command("nomad", "acl", "token", "create", "-policy=studio-dashboard",
775 "-name=studio-dashboard", "-json", capture=True)
776 write_private(dashboard_token, json.loads(result.stdout)["SecretID"] + "\n")
777 for data in all_data:
778 paths = {
779 f"nomad/jobs/{data['id']}/inputs/{alias}" for alias in data["inputs"]
780 }
781 if paths and data["containers"]:
782 policy = (
783 'namespace "default" {\n variables {\n'
784 + "".join(
785 f' path {q(path)} {{ capabilities = ["read"] }}\n'
786 for path in sorted(paths)
787 )
788 + " }\n}\n"
789 )
790 with tempfile.NamedTemporaryFile("w", delete=False) as file:
791 file.write(policy)
792 path = file.name
793 try:
794 for task_name in data["containers"]:
795 command(
796 "nomad", "acl", "policy", "apply", "-namespace", "default",
797 "-job", data["id"], "-group", "app", "-task", task_name,
798 data["id"] + "-" + task_name + "-imports", path,
799 )
800 finally:
801 Path(path).unlink()
802 if (Path("/opt/studio/current")).is_symlink():
803 command("systemctl", "start", "studio-router.service")
804
805
806def destroy_stage(stage, metadata, definitions):
807 subprocess.run(["nomad", "job", "stop", "-purge", "-yes", stage], check=False)
808 for alias, request in metadata["inputs"].items():
809 native = request["provider"] == "snowglobe"
810 provider = {"id": "snowglobe", "provide": True, "containers": {}} if native else definitions[request["provider"]]
811 own = (get_variable("nomad/jobs/" + provider["id"]) or {}).get("Items", {})
812 variable = get_variable(f"nomad/jobs/{stage}/inputs/{alias}")
813 existing = variable["Items"] if variable else None
814 hosts = [task["http"]["hostname"] for task in provider["containers"].values()
815 if task.get("http") and task["http"].get("hostname")]
816 script = REPO / "tools/oidc-provider.py" if native else config_path(provider["id"], provider["provide"])
817 command("python3", str(script), input=json.dumps({
818 "operation": "delete", "request": request, "stageId": stage,
819 "providerSecrets": own, "host": hosts[0] if hosts else None,
820 "existing": existing,
821 }))
822 datasets = list(metadata.get("external", {}).values())
823 if metadata.get("clone"):
824 datasets.append({"clone": metadata["clone"], "snapshot": metadata.get("snapshot")})
825 for dataset in datasets:
826 for attempt in range(30):
827 if subprocess.run(["zfs", "destroy", dataset["clone"]], capture_output=True).returncode == 0:
828 break
829 time.sleep(1)
830 else:
831 raise RuntimeError("preview dataset is still in use")
832 if dataset.get("snapshot"):
833 command("zfs", "destroy", dataset["snapshot"])
834 if not metadata.get("clone"):
835 shutil.rmtree(metadata["mount"], ignore_errors=True)
836 for alias in metadata["inputs"]:
837 subprocess.run(["nomad", "var", "purge", f"nomad/jobs/{stage}/inputs/{alias}"], check=False)
838 subprocess.run(["nomad", "var", "purge", "nomad/jobs/" + stage], check=False)
839 for task in metadata["tasks"]:
840 subprocess.run(["nomad", "acl", "policy", "delete", stage + "-" + task + "-imports"], check=False)
841 for path in (
842 STATE / "stages" / f"{stage}.json",
843 STATE / "routes" / f"{stage}.json",
844 STATE / "secrets" / f"{stage}.nv.hcl",
845 ):
846 path.unlink(missing_ok=True)
847 shutil.rmtree(ASSETS / stage, ignore_errors=True)
848
849
850def check_pool(data):
851 if os.geteuid() != 0:
852 raise PermissionError("pool setup requires root")
853 clover = subprocess.run(
854 ["findmnt", "-n", "-o", "SOURCE,FSTYPE", "--mountpoint", data[0]["cloverRoot"]],
855 capture_output=True, text=True,
856 )
857 clover_info = clover.stdout.split()
858 if clover.returncode or len(clover_info) != 2 or clover_info[1] != "zfs":
859 raise ValueError(f"clover must be a mounted ZFS dataset: {data[0]['cloverRoot']}")
860 media = data[0]["mediaRoot"]
861 mounted = subprocess.run(
862 ["findmnt", "-n", "-o", "SOURCE,FSTYPE", "--mountpoint", media],
863 capture_output=True, text=True,
864 )
865 media_info = mounted.stdout.split()
866 expected = {"fuse"} if os.environ.get("STUDIO_MEDIA_READ_ONLY") == "true" else {"zfs"}
867 if mounted.returncode or len(media_info) != 2 or media_info[1] not in expected or media_info[0] == clover_info[0]:
868 raise ValueError(f"media must be a separate mounted dataset: {media}")
869 for path, info in ((data[0]["cloverRoot"], clover_info), (media, media_info)):
870 if info[1] == "zfs":
871 acltype = command("zfs", "get", "-H", "-o", "value", "acltype", info[0], capture=True).stdout.strip()
872 if acltype == "nfsv4":
873 raise ValueError(f"{path} uses NFSv4 ACLs, which NixOS cannot enforce. Rehearse a POSIX permission conversion on a ZFS clone before migration.")
874 pool = data[0]["pool"]
875 if subprocess.run(["zpool", "list", pool], capture_output=True).returncode:
876 raise ValueError(f"ZFS pool is unavailable: {pool}")
877 prod = pool + "/prod"
878 acl_source = prod if subprocess.run(["zfs", "list", prod], capture_output=True).returncode == 0 else pool
879 if command("zfs", "get", "-H", "-o", "value", "acltype", acl_source, capture=True).stdout.strip() == "nfsv4":
880 raise ValueError(f"{acl_source} uses NFSv4 ACLs; service datasets need POSIX ACLs on NixOS.")
881 encrypted = any(
882 command("zfs", "get", "-H", "-o", "value", "encryption", info[0], capture=True).stdout.strip() != "off"
883 for info in (clover_info, media_info) if info[1] == "zfs"
884 )
885 if encrypted:
886 root = str(Path(data[0]["hostRoot"]).parent)
887 mounted = subprocess.run(["findmnt", "-n", "-o", "SOURCE", "--mountpoint", root], capture_output=True, text=True)
888 encryption = subprocess.run(["zfs", "get", "-H", "-o", "value", "encryption", prod], capture_output=True, text=True)
889 if encryption.returncode or encryption.stdout.strip() == "off" or mounted.stdout.strip() != prod:
890 raise ValueError(f"Create and mount encrypted {prod} at {root} before deployment; the existing storage is encrypted.")
891
892
893def check_staging_pool(data):
894 check_pool([data])
895 prod = data["pool"] + "/prod"
896 staging = data["pool"] + "/staging"
897 acl_source = staging if subprocess.run(["zfs", "list", staging], capture_output=True).returncode == 0 else data["pool"]
898 if command("zfs", "get", "-H", "-o", "value", "acltype", acl_source, capture=True).stdout.strip() == "nfsv4":
899 raise ValueError(f"{acl_source} uses NFSv4 ACLs; staged datasets need POSIX ACLs on NixOS.")
900 encryption = subprocess.run(["zfs", "get", "-H", "-o", "value", "encryption", prod], capture_output=True, text=True)
901 if encryption.returncode or encryption.stdout.strip() == "off":
902 return
903 mounted = subprocess.run(["findmnt", "-n", "-o", "SOURCE", "--mountpoint", data["stagingRoot"]], capture_output=True, text=True)
904 staging_encryption = subprocess.run(["zfs", "get", "-H", "-o", "value", "encryption", staging], capture_output=True, text=True)
905 if staging_encryption.returncode or staging_encryption.stdout.strip() == "off" or mounted.stdout.strip() != staging:
906 raise ValueError(f"Create and mount encrypted {staging} at {data['stagingRoot']} before staging.")
907
908
909def ensure_pool(data):
910 check_pool(data)
911 STATE.mkdir(parents=True, exist_ok=True)
912 pool = data[0]["pool"]
913 for item in data:
914 if item["hasManagedVolumes"]:
915 dataset = pool + "/prod/" + item["id"]
916 if subprocess.run(["zfs", "list", dataset], capture_output=True).returncode:
917 root = Path(item["hostRoot"])
918 if root.exists() and any(root.iterdir()):
919 raise ValueError(f"refusing to mount over {root}")
920 if subprocess.run(["zfs", "list", pool + "/prod"], capture_output=True).returncode:
921 parent = str(root.parent)
922 if Path(parent).exists() and any(Path(parent).iterdir()):
923 raise ValueError(f"refusing to mount over {parent}")
924 command("zfs", "create", "-o", "mountpoint=" + parent, pool + "/prod")
925 command("zfs", "create", "-o", "mountpoint=" + str(root), dataset)
926
927
928def main():
929 parser = argparse.ArgumentParser()
930 parser.add_argument(
931 "mode",
932 choices=[
933 "render",
934 "secrets",
935 "validate",
936 "check",
937 "bootstrap",
938 "deploy",
939 "preflight",
940 "pool",
941 "allocate",
942 "stage",
943 "destroy",
944 ],
945 )
946 parser.add_argument("name", nargs="?")
947 parser.add_argument("--base-domain")
948 parser.add_argument("--root")
949 parser.add_argument("--pool")
950 parser.add_argument("--media-root")
951 parser.add_argument("--env", action="append", default=[])
952 parser.add_argument("--key", action="append", default=[])
953 args = parser.parse_args()
954 if args.mode == "allocate" and not args.name:
955 parser.error("allocate requires a service name")
956 if args.key and args.mode != "secrets":
957 parser.error("--key is available only for secrets")
958 if args.name and args.mode != "destroy" and args.name not in service_files():
959 raise ValueError(f"unknown service: {args.name}")
960 properties = {
961 key: value
962 for key, value in (("domain", args.base_domain), ("root", args.root), ("pool", args.pool), ("mediaRoot", args.media_root))
963 if value
964 }
965 names = [args.name] if args.name else services()
966 if args.mode == "secrets":
967 if not args.name or not NAME.fullmatch(args.name):
968 parser.error("secrets requires a service name")
969 data = load(args.name, properties)
970 declared = [*data["requiredSecrets"], *data["secrets"]]
971 fields = args.key or declared
972 if not declared or len(set(declared)) != len(declared) or any(not re.fullmatch(r"[A-Za-z_][A-Za-z0-9_]*", field) for field in declared):
973 raise ValueError(f"invalid required secrets for {args.name}")
974 if len(set(fields)) != len(fields) or any(field not in declared for field in fields):
975 raise ValueError(f"unknown or duplicate secret key for {args.name}")
976 values = sys.stdin.read().splitlines()
977 if len(values) != len(fields) or any(not value for value in values):
978 raise ValueError(f"expected {len(fields)} nonempty secret lines for {args.name}")
979 token()
980 path = "nomad/jobs/" + args.name
981 existing = get_variable(path)
982 items = dict(existing["Items"]) if existing else {}
983 items.update(zip(fields, values))
984 put_variable(path, items, existing["ModifyIndex"] if existing else 0)
985 print(f"Imported {len(fields)} secrets for {args.name}")
986 return
987 if args.mode == "destroy":
988 if not args.name or not NAME.fullmatch(args.name):
989 parser.error("destroy requires a stage ID")
990 token()
991 metadata = json.loads((STATE / "stages" / f"{args.name}.json").read_text())
992 names = {metadata["sourceId"]} | {request["provider"] for request in metadata["inputs"].values() if request["provider"] != "snowglobe"}
993 definitions = {name: load(name, properties) for name in names}
994 destroy_stage(args.name, metadata, definitions)
995 return
996 if args.mode == "stage":
997 if not args.name:
998 parser.error("stage requires a service name")
999 token()
1000 data = load(args.name, properties)
1001 check_staging_pool(data)
1002 definitions = {args.name: data}
1003 definitions.update({provider: load(provider, properties) for provider in dependencies(data)})
1004 if not data["containers"]:
1005 raise ValueError(f"service has no container to stage: {args.name}")
1006 stage_dir = STATE / "stages"
1007 previous = []
1008 for path in stage_dir.glob("*.json"):
1009 saved = json.loads(path.read_text())
1010 if saved.get("sourceId") == args.name:
1011 previous.append((path, saved))
1012 if len(previous) > 1:
1013 raise ValueError(f"multiple stages exist for {args.name}; destroy one first")
1014 created = not previous
1015 stage = f"{args.name}-preview-{secrets.token_hex(4)}" if created else previous[0][0].stem
1016 http = [task["http"] for task in data["containers"].values() if task.get("http") and task["http"].get("hostname")]
1017 if len(http) > 1:
1018 raise ValueError("preview requires at most one HTTP route")
1019 original_host = http[0].get("hostname") if http else None
1020 hostname = stage + "." + original_host.split(".", 1)[1] if original_host else None
1021 data = load(args.name, properties, stage)
1022 data["rollout"] = "simple"
1023 data["hostRoot"] = str(Path(data["stagingRoot"]) / stage)
1024 if data["stageIsolation"] == "fresh" and any(
1025 volume.get("src") and not volume["readOnly"]
1026 for task in data["containers"].values()
1027 for volume in task["volumes"].values()
1028 ):
1029 raise ValueError("fresh stages cannot use writable external mounts")
1030 for task in data["containers"].values():
1031 if task.get("tcp") and not task["hostNetwork"]:
1032 for port in task["tcp"]:
1033 port["hostPort"] = None
1034 if hostname:
1035 for task in data["containers"].values():
1036 if task.get("http") and task["http"].get("hostname") == original_host:
1037 task["http"]["hostname"] = hostname
1038 task["http"]["plainHostnames"] = [stage + "-" + host for host in task["http"]["plainHostnames"]]
1039 task["env"] = {key: value.replace(original_host, hostname) for key, value in task["env"].items()}
1040 if task.get("secretFiles"):
1041 task["secretFiles"] = {key: value.replace(original_host, hostname) for key, value in task["secretFiles"].items()}
1042 for request in data["inputs"].values():
1043 if request["provider"] == "snowglobe":
1044 request["redirectUris"] = [uri.replace(original_host, hostname) for uri in request["redirectUris"]]
1045 for assignment in args.env:
1046 key, separator, value = assignment.partition("=")
1047 if not separator or len(data["containers"]) != 1:
1048 parser.error(f"unknown environment override: {key}")
1049 env = next(iter(data["containers"].values()))["env"]
1050 if key not in env:
1051 parser.error(f"unknown environment override: {key}")
1052 env[key] = value
1053 metadata = (
1054 {"mount": data["hostRoot"], "inputs": data["inputs"],
1055 "tasks": list(data["containers"]), "sourceId": args.name,
1056 "stageIsolation": data["stageIsolation"]}
1057 if created else previous[0][1]
1058 )
1059 if not created:
1060 if metadata.get("stageIsolation", "clone") != data["stageIsolation"]:
1061 raise ValueError("stage isolation changed; destroy the stage before recreating it")
1062 if bool(metadata.get("clone")) != data["hasManagedVolumes"]:
1063 raise ValueError("storage layout changed; destroy the stage before recreating it")
1064 for alias, request in data["inputs"].items():
1065 if alias in metadata["inputs"] and metadata["inputs"][alias] != request:
1066 raise ValueError(f"requirement {alias} changed; destroy the stage before recreating it")
1067 if alias not in metadata["inputs"] and request["provider"] == "postgres":
1068 raise ValueError("new database requirement needs a new stage")
1069 metadata["inputs"].update(data["inputs"])
1070 metadata["tasks"] = sorted(set(metadata["tasks"]) | set(data["containers"]))
1071 stage_dir.mkdir(parents=True, exist_ok=True)
1072 postgres_snapshot = None
1073 pending_snapshots = set()
1074 try:
1075 postgres_inputs = created and data["stageIsolation"] == "clone" and any(
1076 request["provider"] == "postgres" and request["kind"] == "database"
1077 for request in data["inputs"].values()
1078 )
1079 snapshots = []
1080 source = None
1081 if created and data["hasManagedVolumes"]:
1082 pool = data["pool"]
1083 source = subprocess.run(
1084 ["findmnt", "-n", "-o", "SOURCE", "--mountpoint", definitions[args.name]["hostRoot"]],
1085 capture_output=True, text=True,
1086 ).stdout.strip()
1087 dataset = pool + "/staging/" + stage
1088 if subprocess.run(["zfs", "list", pool + "/staging"], capture_output=True).returncode:
1089 command("zfs", "create", "-o", "mountpoint=none", pool + "/staging")
1090 if source and data["stageIsolation"] == "clone":
1091 if source.split("/", 1)[0] != pool:
1092 raise ValueError(f"production dataset belongs to another pool: {source}")
1093 snapshot = source + "@" + stage
1094 snapshots.append(snapshot)
1095 if postgres_inputs:
1096 postgres_dataset = dataset_for("postgres")
1097 if not postgres_dataset:
1098 raise ValueError("Postgres needs a ZFS dataset for consistent stages")
1099 postgres_snapshot = postgres_dataset + "@" + stage
1100 snapshots.append(postgres_snapshot)
1101 external = {}
1102 for task in data["containers"].values():
1103 for volume in task["volumes"].values():
1104 if volume.get("src") and not volume["readOnly"]:
1105 external.setdefault(volume["src"], []).append(volume)
1106 external_mounts = {}
1107 for external_source in external:
1108 path = Path(external_source).resolve(strict=True)
1109 mount = json.loads(command(
1110 "findmnt", "--json", "-o", "SOURCE,TARGET,FSTYPE,OPTIONS", "--target", str(path), capture=True,
1111 ).stdout)["filesystems"][0]
1112 if "ro" not in mount["options"].split(",") and mount["fstype"] != "zfs":
1113 raise ValueError(f"writable external mount is not ZFS: {external_source}")
1114 external_mounts[external_source] = (path, mount)
1115 if created and mount["fstype"] == "zfs" and "ro" not in mount["options"].split(","):
1116 target = mount["source"] + "@" + stage
1117 if target not in snapshots:
1118 snapshots.append(target)
1119 if snapshots:
1120 if len({target.split("/", 1)[0] for target in snapshots}) != 1:
1121 raise ValueError("staged datasets must belong to one ZFS pool")
1122 command("zfs", "snapshot", *snapshots)
1123 pending_snapshots.update(snapshots)
1124 if created and data["hasManagedVolumes"]:
1125 if source and data["stageIsolation"] == "clone":
1126 try:
1127 clone_dataset(source, snapshot, dataset, data["hostRoot"])
1128 except Exception:
1129 command("zfs", "destroy", snapshot)
1130 pending_snapshots.remove(snapshot)
1131 raise
1132 metadata["snapshot"] = snapshot
1133 pending_snapshots.remove(snapshot)
1134 else:
1135 command("zfs", "create", "-o", "mountpoint=" + data["hostRoot"], dataset)
1136 metadata["clone"] = dataset
1137 bindings = {}
1138 for source, volumes in sorted(external.items()):
1139 path, mount = external_mounts[source]
1140 if "ro" in mount["options"].split(","):
1141 binding = {"src": source, "readOnly": True}
1142 elif mount["fstype"] == "zfs":
1143 dataset = mount["source"]
1144 if metadata.get("snapshot") == dataset + "@" + stage:
1145 clone_mount = data["hostRoot"]
1146 else:
1147 staged = metadata.setdefault("external", {})
1148 if dataset not in staged:
1149 if not created:
1150 raise ValueError("external storage changed; destroy the stage before recreating it")
1151 suffix = hashlib.sha256(dataset.encode()).hexdigest()[:8]
1152 pool = dataset.split("/", 1)[0]
1153 clone = pool + "/staging/" + stage + "-external-" + suffix
1154 clone_mount = str(Path(data["stagingRoot"]) / (stage + "-external-" + suffix))
1155 snapshot = dataset + "@" + stage
1156 if subprocess.run(["zfs", "list", pool + "/staging"], capture_output=True).returncode:
1157 command("zfs", "create", "-o", "mountpoint=none", pool + "/staging")
1158 try:
1159 clone_dataset(dataset, snapshot, clone, clone_mount)
1160 except Exception:
1161 command("zfs", "destroy", snapshot)
1162 pending_snapshots.remove(snapshot)
1163 raise
1164 staged[dataset] = {"clone": clone, "snapshot": snapshot, "mount": clone_mount}
1165 pending_snapshots.remove(snapshot)
1166 clone_mount = staged[dataset]["mount"]
1167 relative = path.relative_to(Path(mount["target"]).resolve())
1168 binding = {"src": str(Path(clone_mount) / relative), "readOnly": False}
1169 else:
1170 raise ValueError(f"writable external mount is not ZFS: {source}")
1171 bindings[source] = binding
1172 for volume in volumes:
1173 if path.is_relative_to(Path(data["cloverRoot"]).resolve()):
1174 volume["clover"] = True
1175 volume.update(binding)
1176 if not created and bindings != metadata.get("externalSources", {}):
1177 raise ValueError("external storage changed; destroy the stage before recreating it")
1178 metadata["externalSources"] = bindings
1179 if REPO.parent == Path("/opt/studio/releases"):
1180 metadata["release"] = REPO.name
1181 metadata["ready"] = False
1182 write_private(stage_dir / f"{stage}.json", json.dumps(metadata))
1183 bootstrap([data])
1184 if created and data["stageIsolation"] == "clone" and (data["secrets"] or data["requiredSecrets"]):
1185 source = get_variable("nomad/jobs/" + args.name)
1186 if source:
1187 put_variable("nomad/jobs/" + stage, source["Items"], 0)
1188 if postgres_snapshot:
1189 postgres_clone = postgres_dataset.rsplit("/prod/", 1)[0] + "/staging/" + stage + "-postgres"
1190 postgres_mount = Path(data["stagingRoot"]) / (stage + "-postgres")
1191 source_context = cloned_postgres(postgres_snapshot, postgres_clone, postgres_mount)
1192 else:
1193 source_context = nullcontext(None)
1194 with source_context as postgres_source:
1195 provision_inputs(data, definitions, stage, postgres_source)
1196 provision(data)
1197 prepare(data)
1198 build_images(data)
1199 submit(data, "run", definitions)
1200 except Exception:
1201 if created:
1202 destroy_stage(stage, metadata, definitions)
1203 raise
1204 finally:
1205 for snapshot in sorted(pending_snapshots):
1206 command("zfs", "destroy", snapshot)
1207 if hostname:
1208 check_http(hostname, http[0]["checkPath"], http[0]["tlsInternal"])
1209 configure(data)
1210 if REPO.parent == Path("/opt/studio/releases"):
1211 metadata["ready"] = True
1212 metadata["overrides"] = [assignment.partition("=")[0] for assignment in args.env]
1213 write_private(stage_dir / f"{stage}.json", json.dumps(metadata))
1214 print(f"stage={stage}\nrelease={metadata.get('release', '')}\nhost={hostname}\ndataset={metadata.get('clone', '')}")
1215 return
1216 definitions = {name: load(name, properties) for name in services()}
1217 if args.name and args.name not in definitions:
1218 raise ValueError(f"unknown service: {args.name}")
1219 if not args.name and args.mode == "deploy":
1220 names = [name for name in names if definitions[name]["containers"]]
1221 selected = set(names)
1222 while True:
1223 required = selected | set().union(*(dependencies(definitions[name]) for name in selected))
1224 missing = required - definitions.keys()
1225 if missing:
1226 raise ValueError(f"unknown dependency: {sorted(missing)}")
1227 if required == selected:
1228 break
1229 selected = required
1230 data = ordered([definitions[name] for name in sorted(selected)])
1231 if args.mode == "render":
1232 for item in data:
1233 if item["containers"]:
1234 print(render(item, definitions))
1235 elif args.mode == "validate":
1236 token()
1237 for item in data:
1238 submit(item, "validate", definitions)
1239 elif args.mode == "check":
1240 for item in data:
1241 for task in item["containers"].values():
1242 if task.get("http") and task["http"].get("hostname"):
1243 check_http(task["http"]["hostname"], task["http"]["checkPath"], task["http"]["tlsInternal"])
1244 elif args.mode == "preflight":
1245 check_pool(data)
1246 token()
1247 missing_secrets = {}
1248 for item in data:
1249 if item["containers"] and item["requiredSecrets"]:
1250 variable = get_variable("nomad/jobs/" + item["id"])
1251 values = variable["Items"] if variable else {}
1252 missing = [name for name in item["requiredSecrets"] if not values.get(name)]
1253 if missing:
1254 missing_secrets[item["id"]] = missing
1255 if missing_secrets:
1256 raise ValueError("missing required secrets: " + "; ".join(
1257 f"{name}: {', '.join(keys)}" for name, keys in missing_secrets.items()))
1258 elif args.mode == "pool":
1259 ensure_pool(data)
1260 elif args.mode == "allocate":
1261 ensure_pool(data)
1262 bootstrap(data)
1263 for item in data:
1264 provision_inputs(item, definitions)
1265 provision(item)
1266 prepare(item)
1267 build_images(item)
1268 elif args.mode == "bootstrap":
1269 bootstrap(data)
1270 elif args.mode == "deploy":
1271 bootstrap(data)
1272 for item in data:
1273 provision_inputs(item, definitions)
1274 provision(item)
1275 prepare(item)
1276 build_images(item)
1277 submit(item, "run", definitions)
1278 configure(item)
1279
1280
1281if __name__ == "__main__":
1282 try:
1283 main()
1284 except (OSError, RuntimeError, ValueError, subprocess.CalledProcessError) as error:
1285 print(error, file=sys.stderr)
1286 sys.exit(1)
tools/tree-hash.py deleted-48
......@@ -1,48 +0,0 @@
1#!/usr/bin/env python3
2import hashlib
3import json
4import os
5from pathlib import Path
6import stat
7import sys
8
9
10root = Path(sys.argv[1]).resolve(strict=True)
11if not root.is_dir():
12 raise ValueError("Expected a directory")
13digest = hashlib.sha256()
14files = 0
15size = 0
16
17
18def fail(error):
19 raise error
20
21
22for directory, children, names in os.walk(root, followlinks=False, onerror=fail):
23 children.sort()
24 for name in sorted([*children, *names]):
25 entry = Path(directory) / name
26 relative = os.fsencode(entry.relative_to(root))
27 mode = entry.lstat().st_mode
28 if stat.S_ISDIR(mode):
29 kind = b"d"
30 elif stat.S_ISLNK(mode):
31 kind = b"l"
32 elif stat.S_ISREG(mode):
33 kind = b"f"
34 else:
35 raise ValueError(f"Unsupported file type: {entry}")
36 digest.update(kind + len(relative).to_bytes(8, "big") + relative)
37 if kind == b"l":
38 target = os.fsencode(os.readlink(entry))
39 digest.update(len(target).to_bytes(8, "big") + target)
40 elif kind == b"f":
41 files += 1
42 length = entry.stat().st_size
43 size += length
44 digest.update(length.to_bytes(8, "big"))
45 with entry.open("rb") as source:
46 for chunk in iter(lambda: source.read(1024 * 1024), b""):
47 digest.update(chunk)
48print(json.dumps({"sha256": digest.hexdigest(), "files": files, "bytes": size}))
tools/verify-legacy-dump.py deleted-37
......@@ -1,37 +0,0 @@
1#!/usr/bin/env python3
2import hashlib
3import json
4from pathlib import Path
5import re
6import sys
7
8
9folder = Path(sys.argv[1])
10if not folder.is_dir():
11 raise SystemExit("Legacy handoff directory is unavailable")
12folder = folder.resolve(strict=True)
13database = sys.argv[2]
14if folder.parent != Path("/mnt/storage1/apps/studio-handoff") or not re.fullmatch(r"\d{8}T\d{6}Z-[0-9a-f]{6}", folder.name):
15 raise ValueError("Unexpected legacy handoff directory")
16if database not in {"evil-forgejo", "evil-hedgedoc"}:
17 raise ValueError("Unexpected legacy database")
18manifest = json.loads((folder / "manifest.json").read_text())
19if manifest["id"] != folder.name:
20 raise ValueError("Legacy handoff ID changed")
21entry = manifest["databases"][database]
22if entry["file"] != database + ".dump":
23 raise ValueError("Legacy dump filename changed")
24dump = folder / entry["file"]
25digest = hashlib.sha256()
26with dump.open("rb") as file:
27 for chunk in iter(lambda: file.read(1024 * 1024), b""):
28 digest.update(chunk)
29if dump.stat().st_size != entry["bytes"] or digest.hexdigest() != entry["sha256"]:
30 raise ValueError("Legacy dump checksum mismatch")
31if len(entry["counts"]) != (4 if database == "evil-hedgedoc" else 2) or any(not isinstance(value, int) or value < 0 for value in entry["counts"]):
32 raise ValueError("Legacy database counts are invalid")
33if database == "evil-forgejo":
34 keys = {"lfs_jwt", "oauth_jwt", "security_key", "internal_token", "anubis_key", "mailer_address", "mailer_username", "mailer_password"}
35 if set(entry["secretSha256"]) != keys or any(not re.fullmatch(r"[0-9a-f]{64}", value) for value in entry["secretSha256"].values()):
36 raise ValueError("Legacy Forgejo secret fingerprints are invalid")
37print(json.dumps(entry))
tools/vm-screen-test.py+1-1
......@@ -48,7 +48,7 @@ class LifecycleTests(unittest.IsolatedAsyncioTestCase):
4848 with tempfile.TemporaryDirectory() as directory:
4949 socket = str(Path(directory) / "screen.sock")
5050 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})
5252 writers = []
5353 try:
5454 async with asyncio.timeout(5):
tools/vm-screen.py+5-5
......@@ -24,9 +24,9 @@ from gi.repository import GLib, Gst, GstRtp, GstSdp, GstWebRTC
2424
2525
2626MAX_PIXELS = 3840 * 2160
27STUN = os.environ.get("STUDIO_VM_STUN_SERVER", "stun://stun.cloudflare.com:3478")
27STUN = os.environ.get("SNOWGLOBE_VM_STUN_SERVER", "stun://stun.cloudflare.com:3478")
2828SLOTS = asyncio.Semaphore(4)
29GUEST_PROTOCOL = json.loads(Path(os.environ.get("STUDIO_VM_GUEST_PROTOCOL", Path(__file__).resolve().parent.parent / "guest/protocol.json")).read_text())
29GUEST_PROTOCOL = json.loads(Path(os.environ.get("SNOWGLOBE_VM_GUEST_PROTOCOL", Path(__file__).resolve().parent.parent / "guest/protocol.json")).read_text())
3030GUESTS = {}
3131TWCC = "http://www.ietf.org/id/draft-holmer-rmcat-transport-wide-cc-extensions-01"
3232
......@@ -312,7 +312,7 @@ class GuestDesktop:
312312 writer = None
313313 try:
314314 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)
316316 peer = writer.get_extra_info("socket")
317317 if struct.unpack("3i", peer.getsockopt(socket.SOL_SOCKET, socket.SO_PEERCRED, 12))[1] != 0:
318318 raise ValueError("Untrusted guest display broker")
......@@ -801,7 +801,7 @@ async def serve(reader, writer):
801801 if not isinstance(name, str) or not name or len(name) > 63:
802802 raise ValueError("Choose a VM from the list.")
803803 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)
805805 desktop = Desktop(host_reader, host_writer, lambda message: screen.send(message) if message["type"] != "cursor" or screen.source is desktop else None)
806806 host_peer = host_writer.get_extra_info("socket")
807807 if struct.unpack("3i", host_peer.getsockopt(socket.SOL_SOCKET, socket.SO_PEERCRED, 12))[1] != 0:
......@@ -896,7 +896,7 @@ async def main():
896896 task = asyncio.create_task(serve(reader, writer))
897897 clients.add(task)
898898 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"))
900900 path.unlink(missing_ok=True)
901901 server = await asyncio.start_unix_server(connected, path=str(path), limit=131072)
902902 path.chmod(0o600)
tools/vms.py+22-20
......@@ -1,5 +1,6 @@
11#!/usr/bin/env python3
22import json
3from importlib import import_module
34import os
45from pathlib import Path
56import re
......@@ -15,10 +16,11 @@ import xml.etree.ElementTree as ET
1516
1617
1718DISKS = Path("/srv/vm")
18IMAGES = Path(os.environ.get("STUDIO_VM_IMAGES_ROOT", "/srv/clover/Media/vm"))
19PRESETS = Path(os.environ.get("STUDIO_VM_PRESETS_ROOT", str(IMAGES / "Presets")))
20UPLOADS = Path(os.environ.get("STUDIO_VM_UPLOADS_ROOT", str(IMAGES / "Install Disks")))
21NS = "{https://paperclover.net/studio}"
19IMAGES = Path(os.environ.get("SNOWGLOBE_VM_IMAGES_ROOT", "/srv/clover/Media/vm"))
20PRESETS = Path(os.environ.get("SNOWGLOBE_VM_PRESETS_ROOT", str(IMAGES / "Presets")))
21UPLOADS = Path(os.environ.get("SNOWGLOBE_VM_UPLOADS_ROOT", str(IMAGES / "Install Disks")))
22transition = import_module("namespace-transition")
23NS = "{https://paperclover.net/snowglobe}"
2224NAME = re.compile(r"[a-z0-9][a-z0-9-]{0,62}\Z")
2325GUEST_CHANNEL = json.loads((Path(__file__).resolve().parent.parent / "guest/protocol.json").read_text())["channel"]
2426PROFILES = {
......@@ -237,7 +239,7 @@ def domains():
237239 for name in virsh("list", "--all", "--name").splitlines():
238240 if not name:
239241 continue
240 root = ET.fromstring(virsh("dumpxml", name))
242 root = transition.normalize_vm(ET.fromstring(virsh("dumpxml", name)))
241243 state_line = virsh("domstate", name, "--reason").splitlines()[0].lower()
242244 state = next((value for value in ("running", "blocked", "paused", "shutdown", "crashed", "pmsuspended") if state_line.startswith(value)), "shutoff")
243245 reason = state_line.split("(", 1)[1].rstrip(")") if state in {"paused", "crashed"} and "(" in state_line else None
......@@ -246,7 +248,7 @@ def domains():
246248 disks = []
247249 media = []
248250 for element in root.findall("./devices/disk"):
249 if element.findtext("serial") == "studio-cloud-init":
251 if element.findtext("serial") == "snowglobe-cloud-init":
250252 continue
251253 source = element.find("source")
252254 target = element.find("target")
......@@ -456,7 +458,7 @@ def managed_directory(path):
456458
457459def change_media(spec):
458460 name = spec["name"]
459 root = ET.fromstring(virsh("dumpxml", name, "--inactive"))
461 root = transition.normalize_vm(ET.fromstring(virsh("dumpxml", name, "--inactive")))
460462 drives = root.findall("./devices/disk[@device='cdrom']")
461463 source = resolve_image(spec["image"]) if spec["image"] else None
462464 details = profile(inferred_profile(root))
......@@ -511,7 +513,7 @@ def save_preset(spec):
511513 name = spec["name"]
512514 if virsh("domstate", name).strip() != "shut off":
513515 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")))
515517 if root.findtext(f"metadata/{NS}vm/{NS}platform") == "macos":
516518 raise ValueError("Use a prepared OS X preset from the OS library.")
517519 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):
575577
576578
577579def console_target(name):
578 root = ET.fromstring(virsh("dumpxml", name))
580 root = transition.normalize_vm(ET.fromstring(virsh("dumpxml", name)))
579581 graphics = root.find("./devices/graphics[@type='vnc']")
580582 if virsh("domstate", name).strip() not in {"running", "paused", "blocked"} or graphics is None:
581583 raise ValueError("Start this VM before opening its screen.")
......@@ -590,8 +592,8 @@ def console_target(name):
590592
591593def secure_firmware(arch):
592594 firmware = "AAVMF" if arch == "aarch64" else "OVMF"
593 code = Path(os.environ.get(f"STUDIO_VM_SECURE_{firmware}_CODE", ""))
594 variables = Path(os.environ.get(f"STUDIO_VM_SECURE_{firmware}_VARS", ""))
595 code = Path(os.environ.get(f"SNOWGLOBE_VM_SECURE_{firmware}_CODE", ""))
596 variables = Path(os.environ.get(f"SNOWGLOBE_VM_SECURE_{firmware}_VARS", ""))
595597 if not code.is_absolute() or not variables.is_absolute():
596598 raise ValueError("Secure UEFI firmware is unavailable on this host.")
597599 try:
......@@ -764,7 +766,7 @@ def create(spec):
764766 elif not overlay:
765767 command("qemu-img", "create", "-f", "qcow2", str(drive), str(spec["disk"]))
766768 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"
768770 root = ET.Element("domain", type=domain_type)
769771 ET.SubElement(root, "name").text = name
770772 ET.SubElement(root, "description").text = spec["description"]
......@@ -836,7 +838,7 @@ def create(spec):
836838 devices = ET.SubElement(root, "devices")
837839 emulator = f"/run/current-system/sw/bin/qemu-system-{details_profile['arch']}"
838840 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", "")
840842 if not Path(emulator).is_absolute():
841843 raise ValueError("Windows ARM is unavailable on this host. Choose another OS.")
842844 ET.SubElement(devices, "emulator").text = emulator
......@@ -860,7 +862,7 @@ def create(spec):
860862 ET.SubElement(seed, "driver", name="qemu", type="raw")
861863 ET.SubElement(seed, "source", file=str(directory / "seed.iso"))
862864 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"
864866 ET.SubElement(seed, "readonly")
865867 if preset and spec["platform"] == "windows":
866868 windows_seed(directory, spec["username"])
......@@ -946,14 +948,14 @@ def main():
946948 fields = Path(f"/proc/{pid}/stat").read_text().rsplit(") ", 1)[1].split()
947949 resident = int(Path(f"/proc/{pid}/statm").read_text().split()[1]) * os.sysconf("SC_PAGE_SIZE")
948950 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"))}
950952 return result
951953 if action == "library":
952954 return library()
953955 if action == "console":
954956 return console_target(payload["name"])
955957 if action == "guest":
956 root = ET.fromstring(virsh("dumpxml", payload["name"]))
958 root = transition.normalize_vm(ET.fromstring(virsh("dumpxml", payload["name"])))
957959 source = root.find(f"./devices/channel[@type='unix']/target[@name='{GUEST_CHANNEL}']/../source")
958960 expected = f"/run/libvirt/qemu/channel/{root.get('id')}-{payload['name'][:20]}/{GUEST_CHANNEL}"
959961 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():
962964 if action == "serial":
963965 if virsh("domstate", payload["name"]).strip() not in {"running", "blocked"}:
964966 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"])))
966968 console = root.find("./devices/console[@type='pty']")
967969 source = console.find("source") if console is not None else None
968970 target = console.find("target") if console is not None else None
......@@ -971,7 +973,7 @@ def main():
971973 raise ValueError("This VM has no serial console. Add one in its hardware settings.")
972974 return {"path": path}
973975 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")
975977 if action == "access":
976978 try:
977979 with os.fdopen(open_regular(DISKS / payload["name"] / "access.json")) as incoming:
......@@ -988,7 +990,7 @@ def main():
988990 name = payload["name"]
989991 ensure_name(name)
990992 if payload["action"] == "start":
991 root = ET.fromstring(virsh("dumpxml", name, "--inactive"))
993 root = transition.normalize_vm(ET.fromstring(virsh("dumpxml", name, "--inactive")))
992994 if root.find("./devices/interface/source[@network='default']") is not None:
993995 ensure_network()
994996 virsh({"start": "start", "shutdown": "shutdown", "reboot": "reboot", "destroy": "destroy", "resume": "resume"}[payload["action"]], name)
......@@ -1009,7 +1011,7 @@ def main():
10091011 raise ValueError("VM does not exist")
10101012 if virsh("domstate", name).strip() != "shut off":
10111013 virsh("destroy", name)
1012 root = ET.fromstring(virsh("dumpxml", name))
1014 root = transition.normalize_vm(ET.fromstring(virsh("dumpxml", name)))
10131015 virsh("undefine", name, *(["--nvram"] if root.find("./os/nvram") is not None else []), *(["--tpm"] if root.find("./devices/tpm") is not None else []))
10141016 directory = DISKS / name
10151017 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.
2020`setup.py` installs a transient firewall service tagged with the preview ID. It
2121removes its rules within ten seconds of preview destruction, and on service stop.
2222After a host reboot, repeat the staging command to restore these runtime rules.
23Production firewall rules are declared in `nixos/zenith.nix`. The DNS provider
23Production firewall rules are declared in `nixos/snowglobe.nix`. The DNS provider
2424provisions client, direct-TLS client, and federation SRV records pointing at
2525`xmpp.paperclover.net`; the website keeps its existing apex address. Router
2626forwarding must send the TCP listeners, UDP TURN listeners, and UDP relay range
27to Zenith. `xmpp-nat.service` refreshes UPnP mappings on startup and every five
27to Snow Globe. `xmpp-nat.service` refreshes UPnP mappings on startup and every five
2828minutes, using the Archer AX3000's description URL at the configured gateway.
2929The description is fetched directly; multicast SSDP discovery failed on this
3030host. Production activation uses the normal described-main deployment:
3131
3232```sh
33STUDIO_DEPLOY_HOST=root@10.0.0.1 STUDIO_DEPLOY_PORT=22 python3 tools/deploy.py prod
33SNOWGLOBE_DEPLOY_HOST=root@10.0.0.1 SNOWGLOBE_DEPLOY_PORT=22 python3 tools/deploy.py prod
3434```
3535
36## Zenith production, 2026-10-10
36## Client connections and verification
3737
3838The owner-readable connection file on Clover's Mac is
3939`~/.local/share/snowglobe/xmpp.json`. Monal can use the production JID and its
4040generated password; the explicit server is `xmpp.paperclover.net`, port `5223`,
4141with direct TLS. Client and federation SRV records resolve to that server.
42
43Verified through the public address from the home LAN: TLS authentication, two
44resources, carbons, MAM retrieval, stream resumption, PEP publication/deletion,
45private group creation/history/destruction, PNG upload/download, WebSocket,
46authenticated UDP TURN allocation/deallocation, relay address/range, rejection
47of a private peer, STARTTLS, and TURN TLS certificate validation. All three tasks
48had zero restarts. The normal deployment took backup
49`20261011T015942Z-a7e251` and passed all service route checks. A transient systemd
50probe confirmed UPnP refresh works with `DynamicUser`. Off-LAN calls, iOS push
51delivery, federation with another server, and recovery after a router restart
52need client-side verification.
53
54## Zenith preview, 2026-10-10
55
56Stage: `xmpp-preview-c035f9fb`
57Hostname: `xmpp-preview-c035f9fb.paperclover.net`
58JID: `clover@xmpp-preview-c035f9fb.paperclover.net`
59Dataset: `globe/staging/xmpp-preview-c035f9fb`
60
61The preview Nomad job and its transient firewall service were stopped for the
62production cutover. Its dataset, Nomad variables, and owner-readable Mac
63connection file at `~/.local/share/snowglobe/xmpp-preview.json` are retained.
64Preview account data was not copied into production.
65
66Delete the preview, including its accounts and history:
67
68```sh
69STUDIO_DEPLOY_HOST=root@10.0.0.1 STUDIO_DEPLOY_PORT=22 python3 tools/deploy.py destroy xmpp-preview-c035f9fb
70```
71
72Verified with synthetic data: certificate validation and TLS 1.3 login, two
73simultaneous resources, carbons, stream resumption after transport loss, MAM
74retrieval, PEP publication/deletion, private group creation/history/destruction,
75PNG upload/download over public HTTPS, WebSocket stream opening, external-service
76credentials, authenticated UDP TURN allocation/deallocation, advertised public
77relay address/range, and rejection of a private-network peer. Push support was
78discovered; delivery through an iOS client's push provider and calls across the
79public router were not exercised. All 25 pre-existing service jobs rendered
80byte-identically after the TCP schema migration. The active production release
81was unchanged, and Caddy, Nomad, dashboard, and Shale checks passed.
42A preview has its own connection file and account domain; never copy its
43account database into production.
44
45Test client authentication, two-resource carbons, MAM retrieval, resumable
46streams, OMEMO/PEP keys, private group history, uploads, and WebSocket after
47changing the service. Calling also requires authenticated TURN, the configured
48public relay range, and an off-LAN client check. Push discovery alone does not
49prove delivery through an iOS client's push provider. Recheck external
50connectivity after router or forwarding changes.
tools/yt-feed-migration.md deleted-9
......@@ -1,9 +0,0 @@
1# YouTube Triage migration
2
3The service keeps six JSON state files in `/mnt/storage1/apps/yt-feed` and editable `feed.yaml` and `subscriptions.yaml` in Clover's `Documents/Config/Youtube Downloader`. Its downloaded videos and upscaler output live in the existing Media dataset, so that dataset moves by ZFS rename as described in [media-cutover.md](media-cutover.md).
4
5On 2026-09-26, all six JSON files in `yt-feed-preview-e87b1ca1` matched Zenith by SHA-256 and parsed as JSON. Both Clover configuration files had matching SHA-256 hashes in the VM. The preview Media mount was read-only. Globe now owns the review API and worker; Nomad's `ytdl` job runs the thumbnail upscaler and archiver.
6
7For production, set `STUDIO_DEPLOY_HOST` and `STUDIO_DEPLOY_PORT` for the new host, then run `bash tools/import-legacy-secrets.sh ytdl MAILER_ADDRESS MAILER_USERNAME MAILER_PASSWORD`. The order matches `smtp_host`, `smtp_user`, and `smtp_pass` in `service/ytdl/service.pkl`. Stop Zenith's `yt-feed` and the Snow Globe `ytdl` job before running `bash tools/import-yt-feed.sh ytdl`; the importer stops Globe's worker, snapshots the Snow Globe dataset, verifies the JSON copy, then restarts Globe. Clover's configuration and the Media dataset must be mounted at their final paths before import. Verify Globe's YouTube queue and one manual review action before cutover.
8
9For a same-machine OS replacement, set `STUDIO_LEGACY_HANDOFF` to the [offline handoff](legacy-handoff.md) directory while importing both secrets and JSON state. The production importer then reads the retained files from the mounted old apps dataset on the new host, without old Docker.
tools/zenith-hardware.md deleted-35
......@@ -1,35 +0,0 @@
1# Zenith source host inventory
2
3NixOS was installed onto the NVMe on October 4, 2026 and passed two boots over SSH at the existing addresses. The final boot reported `running` with zero failed units: the data pool imported healthy, all six encrypted roots unlocked and mounted automatically through the TPM credentials, and Nomad, Caddy, SSH, the host service, and NVIDIA persistence started successfully. Original dataset GUIDs and all PostgreSQL handoff file hashes matched their pre-install records. The RTX 3090 uses driver 595.71.05; `hardware.graphics.enable` supplies the driver library link needed by its persistence daemon. The historical TrueNAS inventory below describes the earlier layout.
4
5Read-only inspection on 2026-09-27 found a BIOS-booted Ryzen 9 5950X host with a Realtek RTL8111/8168/8411 NIC (`r8169`), RTX 3090, one 500 GB WD Blue SN5000 NVMe boot disk, and four 8 TB WD80EFPX disks. The NVMe is `/dev/disk/by-id/nvme-WD_Blue_SN5000_500GB_24261Z806200`; its GPT has a 1 MB BIOS boot partition, a 512 MB EFI partition, and a TrueNAS `boot-pool` partition with the running root at `boot-pool/ROOT/25.04.2.4`. The four other disks form the healthy `storage1` RAIDZ1 pool. The VM's UEFI boot configuration does not describe this host.
6
7`enp4s0` has static `10.0.0.1/24` and `192.168.0.1/24` addresses, default gateway `10.0.0.2`, and resolvers `1.1.1.1` and `1.0.0.1`. The NixOS target retains these; DHCP would not preserve the NAS address.
8
9`storage1` is unencrypted and mounted at `/mnt/storage1`. Its `apps`, `clover`, and `media` children are separate AES-256-GCM encryption roots. `apps` uses POSIX ACLs; `clover` and `media` use NFSv4 ACLs. Their mountpoints are `/mnt/storage1/apps`, `/mnt/storage1/clover`, and `/mnt/storage1/media`. The pool reported about 16.1 TB free. The [ACL cutover](storage-acl-cutover.md) and [Media cutover](media-cutover.md) describe the data-side migration; no disk or pool changes were made during this inventory.
10
11On 2026-09-27, Zenith ran OpenZFS 2.3.0 and reported `storage1` healthy. The pinned NixOS VM ran OpenZFS 2.4.4; its `zpool upgrade -v` listed every feature currently enabled or active on `storage1`, including encryption and block cloning. This checks feature support, not an actual import of the four-disk pool.
12
13TrueNAS's previous schedule snapshotted Clover hourly for one week, daily for four weeks, and monthly for two years; apps hourly for one week and daily for one month. Media had no scheduled snapshot task. NixOS does not yet replace this retention policy. The pinned NixOS `services.zfs.autoSnapshot` module has global retention counts, so it cannot express these different dataset schedules. Its `services.sanoid` module supports retention per dataset; the owner is choosing the replacement policy before it is enabled.
14
15The October 4 installer boots in UEFI mode on the same hardware. The `zenith` target now uses systemd-boot, host ID `4fa19ccb`, the renamed `globe` pool, and `paperclover.net`. The owner completed the dataset renames in [media-cutover.md](media-cutover.md); retained apps stay at `/mnt/storage1/apps`. Encrypted `globe/prod` and `globe/staging` roots were created with POSIX ACLs for the new service volumes. Nomad's startup guard requires the real pool, Clover, Media, production, and staging mounts; deployment separately checks their ACL types.
16
17The October 4 personal ACL cutover retained `globe/clover@personal-acl-20261004` and `globe/clover/Media@personal-acl-20261004`. Snapshot clones first passed read/write tests for UIDs 3000, 3106, 3114, and 3116 with group 3000. Both original datasets now use `acltype=posix`, `aclmode=discard`, and `aclinherit=discard`; retaining the legacy `aclmode=restricted` caused `EPERM` during rehearsal. One metadata pass processed 1,448,236 Clover entries and 31,187 Media entries without changing owner UIDs: group 3000 receives `g+rwX`, directories have setgid and inheritable group ACLs, and other access is `---`. Traversal stayed on each filesystem and did not follow symlinks. `/var/lib/studio/personal-acl-verified.json` records the completed original passes. The test clones were destroyed after verification; the original snapshots remain.
18
19The ASUS firmware TPM2 successfully sealed and decrypted every ZFS encryption-root key. [zenith.nix](../nixos/zenith.nix) loads encrypted systemd credentials from `/etc/credstore.encrypted` and runs `studio-zfs-unlock` after pool import and before `zfs-mount`. Plaintext keys remain outside the Nix store and NVMe; the running service's credentials exist in RAM. The credentials are bound to this TPM and PCR 7, so firmware changes affecting Secure Boot or clearing/replacing the TPM can require manual recovery. Secure Boot is currently disabled. The original dataset keys and TrueNAS configuration remain in the private Mac recovery archive; new production/staging keys are backed up separately at `/Users/clo/Library/Application Support/Zenith Recovery/postgres-backups/new-os-dataset-keys.json`.
20
21The NVMe installation replaces the old TrueNAS boot pool with a 1 GiB FAT32 EFI partition and an ext4 root partition occupying the remaining space. The only erase target is `/dev/disk/by-id/nvme-WD_Blue_SN5000_500GB_24261Z806200`; no HDD partition is formatted. [legacy-handoff.md](legacy-handoff.md) records the verified exports and off-server backups made before replacing the OS. The generated [hardware configuration](../nixos/hardware-configuration.nix) identifies the new root and EFI filesystems. The installed source lives at `/etc/nixos`; subsequent OS changes use `nixos-rebuild switch --flake /etc/nixos#zenith`.
22
23The target authorizes this Mac's existing ED25519 key for `clo` and root SSH. Its fingerprint `SHA256:52mNGHRsVFBDED9IAX5pe+LRWUefqTbxEReunq21QvU` matches the key Zenith currently accepts from this Mac. The other three keys in Zenith's `clo` authorized-keys file are not copied into the new root account. A synthetic NixOS evaluation confirmed both accounts receive exactly this key.
24
25The original TrueNAS ED25519, ECDSA, and RSA SSH host keys were recovered from the configuration backup, checked against their public keys, and restored into `/etc/ssh` on NixOS. ED25519 fingerprint `SHA256:P8pRWNrL6tceq9KN41Hdb0v0kmIboMf/zFBgOtHJfm0` matches this Mac's existing `git.paperclover.net` trust entry; a fresh connection with strict host checking passed after reloading SSH. The installer keys used during installation are retained privately in `/root/infra2-installer-host-keys`. [Shale migration](shale-migration.md) records the intended Git service scope, transport check, and replacement of the legacy SSH router.
26
27[Nomad stores its server state under `data_dir`](https://developer.hashicorp.com/nomad/docs/configuration), including [variables and their encrypted secret values](https://developer.hashicorp.com/nomad/docs/concepts/variables). Snow Globe stores generated service UIDs, deployment history, backup manifests/dumps, and dashboard state under `/var/lib/studio`. Both paths are on the VM's OS disk, outside its ZFS service datasets. Nomad used `66 MB` at inspection; Snow Globe's `8.7 GB` includes an `8.5 GB` VM-only `zpool.img`, while its release backups used `275 MB` across 25 runs. Reusing or replacing Zenith's NVMe would lose the control records unless they are migrated to encrypted ZFS or backed up separately. The pinned NixOS Nomad module accepts `services.nomad.settings.data_dir = "/srv/prod/nomad"` when `dropPrivileges = false`; a synthetic target evaluation passed. The corresponding Snow Globe state mount and dataset boundary await the storage policy decision before the physical cutover.
28
29A `nomad operator snapshot save` on the VM produced a private, compressed 143,608-byte snapshot in `/run`. Inspection reported 46 variables, 31 jobs, and 25 ACL policies. The snapshot restored into a fresh server-only Nomad agent in an isolated network namespace: its API listed all 31 jobs and 46 variables, and a hash comparison of Shale's secret variable items matched the live server without printing the values. The temporary agent, data, and snapshot were removed; the live leader and jobs stayed healthy. This proves [Nomad's server-state snapshot and restore](https://developer.hashicorp.com/nomad/commands/operator/snapshot/restore) on the pinned version, but Snow Globe's separate UID registry and backup files still need durable storage.
30
31The production target selects NixOS's stable NVIDIA driver for the RTX 3090 and its headless persistence daemon; the synthetic install evaluated with driver 595.71.05. Jellyfin has no GPU device allocation yet, so hardware transcoding still needs a physical-host test.
32
33With root SSH access and Nomad running, `STUDIO_DEPLOY_HOST=root@10.0.0.1 STUDIO_DEPLOY_PORT=22 python3 tools/deploy.py bootstrap` creates the Nomad ACL tokens and service datasets before checking external secrets. The first run reports all missing secret names; load those with `tools/import-legacy-secrets.sh` or `deploy.py secrets`, then rerun bootstrap to launch the jobs. Generated service secrets are created automatically. No Snow Globe job starts before the external-secret check passes. A bootstrap interrupted after switching the release link can be retried until deployment history records success.
34
35The ACL bootstrap ran twice against a disposable Nomad dev agent on the VM, created management, router, and dashboard token files, and left 14 policies. The dev agent and temporary state were removed; the VM's production Nomad agent was untouched.