CtrlK
BlogDocsLog inGet started
Tessl Logo

nitinjain999/platform-skills

Production-grade platform engineering handbook — Kubernetes, Terraform, Flux CD, GitHub Actions, AWS, and more.

67

Quality

84%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

README.mdexamples/demo/flux-stuck-release/

Demo: Flux Stuck Release

Status: Stable

A Flux HelmRelease that goes NotReady and stays there. Platform-skills identifies why it's stuck and what to fix before the next deploy.

What's wrong with bad.yaml

FindingSeverityRisk
version: "*" — unpinned chartCriticalSilent major upgrades; non-reproducible clusters
No dependsOnHighHelmRelease deploys before cert-manager CRDs exist → CrashLoopBackOff
interval: 1h — too longMediumChanges take up to 1 hour to reconcile
No timeoutMediumStuck install blocks other Flux reconciliations
No remediationMediumFailed install retries forever without rollback
replicaCount: 1MediumSingle point of failure during node drain

What changed in fixed.yaml

  • Pinned chart version 4.10.1 — upgrade is an explicit PR decision
  • dependsOn: cert-manager — ensures CRDs exist before ingress deploys
  • interval: 10m — changes reconcile in minutes, not hours
  • timeout: 5m — fail fast, unblock other reconciliations
  • install.remediation.retries: 3 + upgrade.remediation.remediateLastFailure: true — automatic rollback on failure
  • replicaCount: 2 — survives node drain without downtime

Diagnosing a stuck release

flux get helmrelease nginx-ingress -n ingress-system
flux logs --kind HelmRelease --name nginx-ingress --namespace ingress-system
kubectl describe helmrelease nginx-ingress -n ingress-system

Force reconcile after fix

flux reconcile helmrelease nginx-ingress -n ingress-system --with-source
flux get helmrelease nginx-ingress -n ingress-system --watch

Try it yourself

Use $platform-skills to debug this Flux HelmRelease that is stuck NotReady.
Start with evidence collection, then root cause, fix, validation, and rollback.

examples

demo

flux-stuck-release

BEFORE_AFTER.md

CHANGELOG.md

CODE_OF_CONDUCT.md

COMMANDS.md

CONTRIBUTING.md

EDITOR_INTEGRATIONS.md

GETTING_STARTED.md

HOW_IT_WORKS.md

install.sh

INSTALLATION.md

LAUNCH.md

PROMPTS.md

QUICKSTART.md

README.md

renovate.json

SECURITY.md

SKILL.md

tessl.json

tile.json