Agent skill · software engineering · aiskillstore
deploying-cloud-k8s
Deploys applications to cloud Kubernetes (AKS/GKE/DOKS) with CI/CD pipelines. Use when deploying to production, setting up GitHub Actions, troubleshooting deployments. Covers build-time vs runtime vars, architecture matching, and battle-tested debugging.
Why this skill is useful
Provides specific CI/CD patterns and troubleshooting commands for deploying to cloud Kubernetes that the AI wouldn't reliably generate on its own.
What it needs
Requires docker, helm, kubectl installed locally. About 4k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Deploying Cloud K8s Quick Start 1. Check cluster architecture: kubectl get nodes -o jsonpath='{.items[].status.nodeInfo.architecture}' 2. Match build platform to cluster (arm64 vs amd64) 3. Set up GitHub Actions with path filters 4. Deploy with Helm, passing secrets via --set Critical: Build-Time vs Runtime Variables The Problem Next.js NEXTPUBLIC variables are embedded at build time, not runtime: Build-Time (Next.js) Variable Purpose ---------- --------- NEXTPUBLICSSOURL SSO endpoint for browser OAuth NEXTPUBLICAPIURL API endpoint for browser fetch NEXTPUBLICAPPURL App URL for redirects Runtime (ConfigMaps/Secrets) Variable Source ---------- -------- DATABASEURL Secret (Neon/managed DB) SSOURL ConfigMap (internal K8s: http://sso:3001) BETTERAUTHSECRET Secret Architecture Matching BEFORE ANY DEPLOYMENT, check architecture: Docker Build Why provenance: false? Buildx attestation creates complex manifest lists that cause "no match for platform" errors. GitHub Actions CI/CD Selective Builds with Path Filters Next.js Build Args Helm Deployment Troubleshooting Guide Quick Diagnosis Flow Diagnostic Commands Error: ImagePullBackOff "not found" Causes: Tag doesn't exist (short vs full SHA) Wrong registry path Builds skipped by path filters Fix: Verify image was pushed with exact tag used in deployment Error: "no match for platform in manifest" Cause: Image built for wrong architecture OR buildx provenance issue Fix: Error: "exec format error" Cause: Binary architecture doesn't match node Fix: Rebuild with correct platform, use no-cache: true Error: Helm comma parsing Cause: Helm interprets commas as array separators Fix: Use heredoc values file: Error: Password authentication failed Cause: Password with special characters (base64 +/=) Fix: Use hex passwords: Error: Logout redirects to 0.0.0.0 Cause: request.url returns container bind address Fix: Pre-Deployment Checklist Architecture [ ] Checked cluster node architecture [ ] Build platform matches cluster Docker Build [ ] pr …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/deploying-cloud-k8s