deploy-operator

Automate Cogni operator and node deployment to k3s clusters with Argo CD.

4|5|Updated Nov 5, 2025
One-click install
npx skills add https://github.com/cogni-dao/cogni --skill deploy-operator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deploy-operator
Source: https://github.com/cogni-dao/cogni/tree/main/.claude/skills/deploy-operator
Command: npx skills add https://github.com/cogni-dao/cogni --skill deploy-operator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the end-to-end deployment of Cogni operator and node applications to a k3s cluster using Argo CD, including VM provisioning, bootstrap, DNS setup, image promotion, and health verification.

Core Features & Use Cases

  • Provision and bootstrap VMs (Cherry Servers + OpenTofu) and bootstrap k3s with Argo CD.
  • GitOps-based deployment, image promotion, and health checks across canary, staging, and production environments.
  • Troubleshoot Argo CD sync issues and re-provision resources as needed.

Quick Start

Provision a VM, bootstrap k3s, and deploy Cogni components to canary/production with Argo CD.

Frequently Asked Questions about deploy-operator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate k3s cluster deployment using Argo CD and OpenTofu?

You can automate k3s cluster deployment by provisioning and bootstrapping VMs with OpenTofu, then using Argo CD ApplicationSets to deploy and sync Cogni operator and node applications to the cluster.

What is the best way to promote container images across canary, staging, and production environments?

The best way to promote images across canary, staging, and production is through a GitOps-based workflow using Argo CD, which automates deployment and tracks image promotion states across environments.

Do I need Cherry Servers and OpenTofu to bootstrap k3s for Argo CD deployment?

Yes, meeting prerequisites for Cherry Servers provisioning and OpenTofu-based VM bootstrap is required to provision and bootstrap k3s clusters for Argo CD deployment.

Can I configure DNS and verify deployment health through Argo CD?

Yes, the deployment process includes configuring DNS and verifying deployment health through k3s health checks across canary, staging, and production environments via Argo CD.

Why does my Argo CD sync fail when bootstrapping a new k3s node?

Argo CD sync issues during k3s node bootstrapping can be troubleshooted and resolved by re-provisioning resources, verifying OpenTofu VM bootstrap configurations, and checking k3s health.

How does GitOps handle VM provisioning and k3s health checks for Cogni operators?

GitOps handles VM provisioning and bootstrap via OpenTofu, then applies Argo CD ApplicationSets to deploy Cogni operators and run k3s health checks, ensuring end-to-end deployment health.