saltext-kubernetes

Salt Extension for interacting with Kubernetes

Release: v3.0.0

Documentation

• Changelog
  • 3.0.0 (2026-09-15)
  • 2.1.0 (2026-05-22)
  • 2.0.0 (2026-04-20)
  • 1.1.0 (2025-01-14)
  • 1.0.1 (2023-12-29)
• Apply-only kinds
  • Which kinds?
  • Recommended pattern
  • What you still get
  • Promoting a kind to typed in the future
• Authentication
  • 1. Kubeconfig file (default, legacy)
  • 2. Inline kubeconfig data
  • 3. Explicit credentials
  • 4. In-cluster service account
  • Proxy settings
  • Environment variables
  • Per-call overrides
  • Precedence summary
• Common Terraform patterns, expressed in Salt
  • 1. App deploy: Namespace + ConfigMap + Secret + Deployment + Service
  • 2. RBAC: ServiceAccount + Role + RoleBinding
  • 3. Ingress with TLS via cert-manager
  • 4. Stateful workload with PVC + StorageClass
  • 5. Multi-tenant namespace: Quota + LimitRange + NetworkPolicy + RBAC
  • 6. HorizontalPodAutoscaler + PodDisruptionBudget
  • 7. Custom Resource Definition + Custom Resource
  • 8. Conditional apply with test=True (Terraform’s plan)
  • What doesn’t translate yet
• Installation
• Salt Resources subsystem
  • How discovery is configured
  • Mode 1 — discover (default)
  • Mode 2 — pillar (declarative inventory, no API call)
  • Mode 3 — merge (declared + discovered)
  • Resource ID schema
  • Discoverable kinds
  • Default kinds: set
  • Targeting examples
  • Pitfalls and edge cases

Provided Modules

• Execution modules

• State modules