Kubernetes GitOps
GitOps workflows using Flux and ArgoCD with kubectl-mcp-server tools.
When to Apply
Use this skill when:
- User mentions: "Flux", "ArgoCD", "GitOps", "sync", "reconcile"
- Operations: checking sync status, triggering reconciliation, drift detection
- Keywords: "out of sync", "deploy from git", "continuous delivery"
Priority Rules
| Priority | Rule | Impact | Tools |
|---|---|---|---|
| 1 | Check source readiness before troubleshooting | CRITICAL | flux_sources_list_tool |
| 2 | Verify sync status before deployments | HIGH | argocd_app_get_tool |
| 3 | Reconcile after git changes | MEDIUM | flux_reconcile_tool |
| 4 | Suspend before manual changes | LOW | flux_suspend_tool |
Quick Reference
| Task | Tool | Example |
|---|---|---|
| List Flux kustomizations | flux_kustomizations_list_tool | flux_kustomizations_list_tool(namespace) |
| Reconcile Flux | flux_reconcile_tool | flux_reconcile_tool(kind, name, namespace) |
| List ArgoCD apps | argocd_apps_list_tool | argocd_apps_list_tool(namespace) |
| Sync ArgoCD | argocd_sync_tool | argocd_sync_tool(name, namespace) |
Flux CD
Check Flux Status
flux_kustomizations_list_tool(namespace="flux-system")
flux_helmreleases_list_tool(namespace)
flux_sources_list_tool(namespace="flux-system")
Reconcile Resources
flux_reconcile_tool(
kind="kustomization",
name="my-app",
namespace="flux-system"
)
flux_reconcile_tool(
kind="helmrelease",
name="my-chart",
namespace="default"
)
Suspend/Resume
flux_suspend_tool(kind="kustomization", name="my-app", namespace="flux-system")
flux_resume_tool(kind="kustomization", name="my-app", namespace="flux-system")
See FLUX.md for detailed Flux workflows.
ArgoCD
List Applications
argocd_apps_list_tool(namespace="argocd")
Get App Status
argocd_app_get_tool(name="my-app", namespace="argocd")
Sync Application
argocd_sync_tool(name="my-app", namespace="argocd")
Refresh App
argocd_refresh_tool(name="my-app", namespace="argocd")
See ARGOCD.md for detailed ArgoCD workflows.
GitOps Troubleshooting
Flux Not Syncing
| Symptom | Check | Resolution |
|---|---|---|
| Source not ready | flux_sources_list_tool() | Check git credentials |
| Kustomization failed | flux_kustomizations_list_tool() | Check manifest errors |
| HelmRelease failed | flux_helmreleases_list_tool() | Check values, chart version |
ArgoCD Out of Sync
| Symptom | Check | Resolution |
|---|---|---|
| OutOfSync | argocd_app_get_tool() | Manual sync or check auto-sync |
| Degraded | Check health status | Fix unhealthy resources |
| Unknown | Refresh app | argocd_refresh_tool() |
Environment Promotion
With Flux Kustomizations
flux_reconcile_tool(kind="kustomization", name="staging", namespace="flux-system")
flux_reconcile_tool(kind="kustomization", name="production", namespace="flux-system")
With ArgoCD
argocd_sync_tool(name="app-staging", namespace="argocd")
argocd_app_get_tool(name="app-staging", namespace="argocd")
argocd_sync_tool(name="app-production", namespace="argocd")
Multi-Cluster GitOps
Manage GitOps across clusters:
flux_kustomizations_list_tool(namespace="flux-system", context="cluster-1")
flux_kustomizations_list_tool(namespace="flux-system", context="cluster-2")
flux_reconcile_tool(
kind="kustomization",
name="apps",
namespace="flux-system",
context="production-cluster"
)
Drift Detection
Compare live state with desired:
argocd_app_get_tool(name="my-app", namespace="argocd")
flux_kustomizations_list_tool(namespace="flux-system")
Prerequisites
- Flux: Required for Flux tools
flux install - ArgoCD: Required for ArgoCD tools
kubectl create namespace argocd kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
Related Skills
- k8s-deploy - Standard deployments
- k8s-helm - Helm chart management