cogni-dao/cogni / .claude/skills/deploy-operator
deploy-operator
VerifiedDeploy/provision the Cogni operator (k3s + Argo CD). Node apps ship with POST /api/v1/deploy/workloads. Use for provisioning a VM/env, bringing a node live, promoting an image digest, debugging Argo sync / ImagePullBackOff / CreateContainerConfigError, or verifying deployment health. REDIRECT skill — the maintained detail lives in provision-env, devops-expert, cicd-secrets-expert.
Deploy Operator — redirect
This skill was a full playbook for the old deploy stack (canary/staging envs,
resynode, SOPS secrets,.env.operator,provision-test-vm.sh,deploy.sh). All of that is retired. The content was purged 2026-08-05 to stop it misdirecting agents (e.g. it pointed "pods won't start → missing Secret" at SOPS, when the real cause is a missing ESO ExternalSecret leaf). Use the maintained skills below — one source per concern.
Where the current knowledge lives
| You want to… | Skill |
|---|---|
| Provision / reprovision an env (VM→k3s→OpenBao→Compose infra→edge→DNS→operator Argo apps), phase map, gotchas | provision-env |
| CI/CD pipeline, the one node deploy verb, the freeze policy, VM SSH policy | devops-expert |
Secrets: OpenBao vs GitHub-env, ESO, the pnpm secrets:set roll, split-brain | cicd-secrets-expert |
| Promote a SHA to preview/production, or diagnose a stuck promote | promote |
| RBAC / node access grants (register → approve → OpenFGA) | rbac-expert |
| Which DB a table belongs in, migrations, Doltgres | database-expert |
The one mental model to carry over
Provision builds the house; promote fills the furniture; the operator DB is the address book.
- Provision (
provision-env.yml) stands up the substrate + infra (VM, k3s, OpenBao/ESO, Compose infra incl. scheduler-worker/litellm/doltgres, Caddy, DNS, the operator's Argo apps) and seeds the operator deploy branch — often with placeholder image digests. A green provision can still serve 502:/version.buildShafrom outside is the only "really live" signal. - Promote (
/promote, operator only) fills the deploy branch with a real image digest → Argo runs the actual app. A node does not use this path; it callsPOST /api/v1/deploy/workloads. Placeholder digest =ImagePullBackOffthat never self-heals → promote. - A node is only operable the "standard" way once it's a row in the operator
nodestable. The table can be empty even when the node's Postgres DB, k8s overlay, and pod all exist — infra ≠ registration. Without the registry row,resolveNodeRef404s, so self-serve secrets / RBAC / operator-managed deploy don't work on it (you're left hand-patching OpenBao or authoring ESO leaves by hand — the non-standard path). Register via node-formation first.
Failure-mode quick map (all detailed in the skills above):
CreateContainerConfigError → missing ESO ExternalSecret leaf (provision-env Gotcha 18), NOT SOPS.
ImagePullBackOff after a green provision → placeholder digest → /promote.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 468k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 468k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 468k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |