@john/k8s
v2026.03.04.3
Kubernetes operational toolkit — 15 model types covering pods, deployments, services, RBAC, storage, networking, autoscaling, batch jobs, and more. Includes 13 ready-to-run workflows for namespace debugging, security audits, RBAC analysis, cluster health, and operational diagnostics.
Repository
https://github.com/johnrwatson/k8s-swamp-extension
Quality score
How well-documented and verifiable this extension is.
Not yet scored.
A score will be generated the next time this extension is published. The owner can also trigger scoring manually.
Install
$ swamp extension pull @john/k8sRelease Notes
debug-namespace-deep now takes a single 'namespace' input. Model instances must follow the naming convention {namespace}-pod, {namespace}-deployment, {namespace}-service, {namespace}-event, {namespace}-configmap, {namespace}-pvc, {namespace}-secret, {namespace}-netpol. The workflow derives all model references automatically via CEL expressions — no need to pass 8 separate model names.
| Argument | Type | Description |
|---|---|---|
| configMapName | string |
| Argument | Type | Description |
|---|---|---|
| configMapName | string | |
| data | record | |
| labels? | record |
| Argument | Type | Description |
|---|---|---|
| configMapName | string | |
| data | record |
| Argument | Type | Description |
|---|---|---|
| configMapName | string |
Resources
| Argument | Type | Description |
|---|---|---|
| deploymentName | string |
| Argument | Type | Description |
|---|---|---|
| deploymentName | string | |
| image? | string | |
| replicas | number | |
| spec? | any |
| Argument | Type | Description |
|---|---|---|
| deploymentName | string | |
| image? | string | |
| replicas? | number |
| Argument | Type | Description |
|---|---|---|
| deploymentName | string |
| Argument | Type | Description |
|---|---|---|
| deploymentName | string | |
| replicas | number |
| Argument | Type | Description |
|---|---|---|
| deploymentName | string |
| Argument | Type | Description |
|---|---|---|
| deploymentName | string |
| Argument | Type | Description |
|---|---|---|
| deploymentName | string |
| Argument | Type | Description |
|---|---|---|
| deploymentName | string |
| Argument | Type | Description |
|---|---|---|
| deploymentName | string |
Resources
| Argument | Type | Description |
|---|---|---|
| podName | string |
| Argument | Type | Description |
|---|---|---|
| deploymentName | string |
| Argument | Type | Description |
|---|---|---|
| serviceName | string |
Resources
| Argument | Type | Description |
|---|---|---|
| hpaName | string |
| Argument | Type | Description |
|---|---|---|
| hpaName | string | |
| targetDeployment | string | |
| minReplicas | number | |
| maxReplicas | number | |
| cpuTargetPercent | number |
| Argument | Type | Description |
|---|---|---|
| hpaName | string |
Resources
| Argument | Type | Description |
|---|---|---|
| ingressName | string |
| Argument | Type | Description |
|---|---|---|
| ingressName | string | |
| rules | array | |
| ingressClassName? | string | |
| tls? | array | |
| annotations? | record |
| Argument | Type | Description |
|---|---|---|
| ingressName | string | |
| rules? | array | |
| tls? | array | |
| annotations? | record |
| Argument | Type | Description |
|---|---|---|
| ingressName | string |
Resources
| Argument | Type | Description |
|---|---|---|
| jobName | string |
| Argument | Type | Description |
|---|---|---|
| jobName | string |
| Argument | Type | Description |
|---|---|---|
| cronJobName | string |
| Argument | Type | Description |
|---|---|---|
| cronJobName | string |
Resources
Global Arguments
| Argument | Type | Description |
|---|---|---|
| context? | string | |
| kubeconfig? | string | |
| labels? | string |
| Argument | Type | Description |
|---|---|---|
| namespaceName | string |
| Argument | Type | Description |
|---|---|---|
| namespaceName | string | |
| labels? | record |
| Argument | Type | Description |
|---|---|---|
| namespaceName | string |
| Argument | Type | Description |
|---|---|---|
| namespaceName | string | |
| labels? | record | |
| annotations? | record |
| Argument | Type | Description |
|---|---|---|
| namespaceName | string |
| Argument | Type | Description |
|---|---|---|
| namespaceName | string | |
| quotaName | string | |
| hard | record |
| Argument | Type | Description |
|---|---|---|
| namespaceName | string | |
| quotaName | string |
| Argument | Type | Description |
|---|---|---|
| namespaceName | string |
| Argument | Type | Description |
|---|---|---|
| namespaceName | string | |
| limitRangeName | string | |
| limits | array |
| Argument | Type | Description |
|---|---|---|
| namespaceName | string | |
| limitRangeName | string |
| Argument | Type | Description |
|---|---|---|
| namespaceName | string |
Resources
| Argument | Type | Description |
|---|---|---|
| policyName | string |
| Argument | Type | Description |
|---|---|---|
| policyName | string | |
| podSelector | record | |
| policyTypes | array | |
| ingress? | array | |
| egress? | array |
| Argument | Type | Description |
|---|---|---|
| policyName | string |
Resources
Global Arguments
| Argument | Type | Description |
|---|---|---|
| context? | string | |
| kubeconfig? | string | |
| labels? | string |
| Argument | Type | Description |
|---|---|---|
| nodeName | string |
| Argument | Type | Description |
|---|---|---|
| nodeName | string |
| Argument | Type | Description |
|---|---|---|
| nodeName | string |
| Argument | Type | Description |
|---|---|---|
| nodeName | string | |
| key | string | |
| value | string | |
| effect | enum |
| Argument | Type | Description |
|---|---|---|
| nodeName | string | |
| key | string |
| Argument | Type | Description |
|---|---|---|
| nodeName | string |
Resources
| Argument | Type | Description |
|---|---|---|
| podName | string |
| Argument | Type | Description |
|---|---|---|
| podName | string | |
| image? | string | |
| spec? | any |
| Argument | Type | Description |
|---|---|---|
| podName | string |
| Argument | Type | Description |
|---|---|---|
| podName | string | |
| waitSeconds | number |
| Argument | Type | Description |
|---|---|---|
| podName | string | |
| container? | string | |
| tailLines | number | |
| previous | boolean |
| Argument | Type | Description |
|---|---|---|
| podName | string | |
| command | array | |
| container? | string |
Resources
Files
Global Arguments
| Argument | Type | Description |
|---|---|---|
| sourceName | string |
Resources
| Argument | Type | Description |
|---|---|---|
| pvcName | string |
| Argument | Type | Description |
|---|---|---|
| pvcName | string | |
| storageClassName | string | |
| storage | string | |
| accessModes | array |
| Argument | Type | Description |
|---|---|---|
| pvcName | string |
Resources
| Argument | Type | Description |
|---|---|---|
| roleName | string |
| Argument | Type | Description |
|---|---|---|
| clusterRoleName | string |
| Argument | Type | Description |
|---|---|---|
| roleBindingName | string |
| Argument | Type | Description |
|---|---|---|
| clusterRoleBindingName | string |
| Argument | Type | Description |
|---|---|---|
| serviceAccountName | string |
Resources
| Argument | Type | Description |
|---|---|---|
| secretName | string |
| Argument | Type | Description |
|---|---|---|
| secretName | string | |
| data | record | |
| type | string | |
| labels? | record |
| Argument | Type | Description |
|---|---|---|
| secretName | string | |
| data | record |
| Argument | Type | Description |
|---|---|---|
| secretName | string |
Resources
| Argument | Type | Description |
|---|---|---|
| serviceName | string |
| Argument | Type | Description |
|---|---|---|
| serviceName | string |
| Argument | Type | Description |
|---|---|---|
| serviceName | string | |
| selector | record | |
| ports | array | |
| type | string | |
| labels? | record |
| Argument | Type | Description |
|---|---|---|
| serviceName | string | |
| selector? | record | |
| ports? | array |
| Argument | Type | Description |
|---|---|---|
| serviceName | string |
| Argument | Type | Description |
|---|---|---|
| serviceName | string |
Resources
Comprehensive namespace debugging workflow — just pass a namespace name. Expects model instances named {namespace}-pod, {namespace}-deployment, {namespace}-service, {namespace}-event, {namespace}-configmap, {namespace}-pvc, {namespace}-secret, and {namespace}-netpol (all targeting the same namespace). Automatically discovers and diagnoses ALL resources: collects every deployment, pod, service, configmap, PVC, secret, network policy, and event in parallel, then iterates over all discovered servic
Rollout health check for all deployments — replica counts, rollout conditions, ReplicaSet history, and warning events
Service connectivity overview — all services, all pods with labels, endpoints, and warning events for diagnosing routing and selector mismatches
Cluster-wide health overview — node conditions, resource capacity, CPU/memory utilization, pod distribution, and storage status
Audit namespace security posture — deployment security contexts, volumes, secrets, configmaps, ingress TLS, NetworkPolicy coverage, RBAC roles/bindings, and ServiceAccount permissions
RBAC security audit — Roles, ClusterRoles, RoleBindings, ClusterRoleBindings, ServiceAccounts, and permission analysis for identifying overly permissive access, wildcard rules, and cluster-admin bindings
Storage health check — PVC binding status, capacity usage, PersistentVolume inventory, and storage-related events
Autoscaling status report — HPA current vs target metrics, replica counts, scale conditions, and related deployment state
Batch workload status — Job completion rates, CronJob schedules, failure counts, and batch-related warnings
Network policy audit — NetworkPolicy inventory, pod selector coverage, service endpoints, and traffic rule analysis
List all pods via the cluster-pods model and collect per-pod CPU/memory metrics from the metrics-server in a single job
Discover all pods via cluster-pods, then iterate over each to fetch detailed status and the last 50 lines of container logs
Collect pod inventory and metrics from cluster-pods, then aggregate into a summary with counts by phase, node, restart totals, and health status
Kubernetes operational toolkit — 15 model types covering pods, deployments, services, RBAC, storage, networking, autoscaling, batch jobs, and more. Includes 13 ready-to-run workflows for namespace debugging, security audits, RBAC analysis, cluster health, and operational diagnostics.
Release Notes
debug-namespace-deep workflow now automatically discovers and diagnoses all resources in the namespace. Removed the serviceNames, deploymentNames, and netpolNames inputs — the workflow uses data.findBySpec() to iterate over every service, deployment, and network policy found during discovery. Just provide model instance names and the workflow handles the rest.
Kubernetes operational toolkit — 15 model types covering pods, deployments, services, RBAC, storage, networking, autoscaling, batch jobs, and more. Includes 13 ready-to-run workflows for namespace debugging, security audits, RBAC analysis, cluster health, and operational diagnostics.
Release Notes
Replaced namespace-debug workflow with debug-namespace-deep — a comprehensive deep-dive debugging workflow that collects deployments, pods, services, configmaps, PVCs, secrets, network policies, and events in parallel, then runs targeted per-service diagnostics, per-deployment rollout status and ReplicaSet history, and per-netpol rule inspection. Significantly improves namespace debugging quality and coverage.
Kubernetes operational toolkit — 15 model types covering pods, deployments, services, RBAC, storage, networking, autoscaling, batch jobs, and more. Includes 13 ready-to-run workflows for namespace debugging, security audits, RBAC analysis, cluster health, and operational diagnostics.
Kubernetes operational toolkit — 15 model types covering pods, deployments, services, RBAC, storage, networking, autoscaling, batch jobs, and more. Includes 13 ready-to-run workflows for namespace debugging, security audits, RBAC analysis, cluster health, and operational diagnostics.
Kubernetes operational toolkit — 15 model types covering pods, deployments, services, RBAC, storage, networking, autoscaling, batch jobs, and more. Includes 13 ready-to-run workflows for namespace debugging, security audits, RBAC analysis, cluster health, and operational diagnostics.
Kubernetes operational toolkit — 15 model types covering pods, deployments, services, RBAC, storage, networking, autoscaling, batch jobs, and more. Includes 13 ready-to-run workflows for namespace debugging, security audits, RBAC analysis, cluster health, and operational diagnostics.
Kubernetes operational toolkit — 15 model types covering pods, deployments, services, RBAC, storage, networking, autoscaling, batch jobs, and more. Includes 13 ready-to-run workflows for namespace debugging, security audits, RBAC analysis, cluster health, and operational diagnostics.