Skip to content

feat(lab): garuda's ingest token, and its own age key (#921) - #1144

Merged
Gerrrt merged 1 commit into
mainfrom
gerrrt/garuda-ingest-token
Oct 10, 2026
Merged

Gerrrt merged 1 commit into
mainfrom
gerrrt/garuda-ingest-token

Conversation

@Gerrrt

@Gerrrt Gerrrt commented Oct 10, 2026

Copy link
Copy Markdown
Owner

This is runbook §6 for garuda, the analyst workstation. It is the PR that lets garuda's Alloy push to alexander.

Encrypted values, made on the hosts

  • .sops.yaml: garuda's own key replaces the analyst placeholder. It was written by make secrets-init STACK=analyst on garuda.
  • secrets/analyst.sops.yaml: INGEST_TOKEN, readable only by garuda.
  • secrets/lab.sops.yaml: INGEST_TOKEN_GARUDA, set on alexander.
    • It is one token: generated on Saruman and sent to both hosts on stdin.
    • It went in through make secrets-edit, with an editor that reads the value from the environment, so it was never an argument.
    • The two hosts' SHA-256s match.
    • alexander's lab.sops.yaml was identical to main's beforehand.

The lab side, in the same places as eden's (#834's rule: the name and the value land together, or alexander's next render fails):

  • stacks/lab/Caddyfile: map entry garuda agent, plus the client list.
  • stacks/lab/compose.yaml: the caddy environment.
  • scripts/render-config.sh: COMPOSE_VARS.
  • scripts/seed-validation-env.sh.
  • secrets/lab.example.yaml.
  • stacks/lab/README.md: the client count.

Runbook §6: Kali has age but not sops. It now installs the checksummed sops 3.9.4 release binary, matching alexander, and clones to ~/code/Gerrrt/HomeLab.

After merge: make up STACK=lab on alexander, then make up STACK=analyst on garuda.

validate.sh passes locally; checks that need Docker are left to CI.

🤖 Generated with Claude Code

Runbook §6 for garuda, as run on 2026-10-10:

- .sops.yaml: garuda's key (from `make secrets-init STACK=analyst` on
  garuda) in place of the analyst placeholder.
- secrets/analyst.sops.yaml: INGEST_TOKEN, encrypted to garuda alone.
- secrets/lab.sops.yaml: INGEST_TOKEN_GARUDA, set on alexander. The same
  value as garuda's; set on both from stdin, never an argument, and the
  hashes compared.
- The lab side, in the five places eden's went: the Caddyfile map and
  header, the caddy environment, render-config.sh's COMPOSE_VARS,
  seed-validation-env.sh and lab.example.yaml; plus the README's clients.
- Runbook §6: age and sops on Kali, and the checkout at ~/code/Gerrrt.

alexander's `make up STACK=lab` and garuda's `make up STACK=analyst`
follow the merge.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI balanced review requested due to automatic review settings October 10, 2026 14:43
@Gerrrt
Gerrrt enabled auto-merge (squash) October 10, 2026 14:43

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

The token, recipient, proxy, rendering, validation, and documentation changes are complete and internally consistent.

0 open findings

What changed in this PR

Adds authenticated telemetry ingestion for garuda, completing runbook §6 of issue #921.

Changes:

  • Adds matching encrypted ingest tokens for garuda and alexander.
  • Registers garuda with the lab Caddy proxy and rendering workflow.
  • Documents SOPS installation, key initialization, and deployment.
File Description
.sops.yaml Registers garuda’s age recipient.
docs/​runbooks/​build-the-analyst-workstation.md Documents setup and deployment.
scripts/​render-config.sh Renders the new token.
scripts/​seed-validation-env.sh Seeds validation credentials.
secrets/​analyst.sops.yaml Adds garuda’s encrypted token.
secrets/​lab.example.yaml Documents the lab-side token.
secrets/​lab.sops.yaml Adds the encrypted proxy token.
stacks/​lab/​Caddyfile Authorizes garuda ingestion.
stacks/​lab/​compose.yaml Supplies the token to Caddy.
stacks/​lab/​README.md Updates the documented client list.

🧠 Review effort: Balanced


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@Gerrrt
Gerrrt merged commit e07767f into main Oct 10, 2026
9 checks passed
@Gerrrt
Gerrrt deleted the gerrrt/garuda-ingest-token branch October 10, 2026 14:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants