mcp-adr-analysis-server

--- version: '1.0' id: 'kubernetes-v1' name: 'Kubernetes' description: >- Production-ready container orchestration platform for deploying, scaling, and managing containerized applications composition: infrastructure: 'kubernetes' strategy: 'container' # Authoritative sources - LLMs should query these URLs for deployment guidance authoritativeSources: - type: 'documentation' url: 'https://kubernetes.io/docs/' purpose: 'Official Kubernetes documentation - primary reference for all K8s concepts' priority: 10 requiredForDeployment: true queryInstructions: | Essential reading for Kubernetes deployments: 1. Review core concepts (Pods, Services, Deployments, StatefulSets) 2. Understand workload resources and controllers 3. Study networking (Services, Ingress, Network Policies) 4. Learn storage concepts (PersistentVolumes, StorageClasses) 5. Review security best practices (RBAC, Pod Security) 6. Check version-specific features and deprecations This is the PRIMARY source for Kubernetes knowledge. - type: 'documentation' url: 'https://kubernetes.io/docs/tutorials/' purpose: 'Official tutorials for hands-on learning' priority: 10 requiredForDeployment: true queryInstructions: | Use these tutorials to: 1. Follow step-by-step deployment examples 2. Learn Kubernetes basics through practice 3. Understand common deployment patterns 4. See real-world configuration examples 5. Practice troubleshooting techniques Work through tutorials relevant to your deployment scenario. - type: 'repository' url: 'https://github.com/kubernetes/kubernetes' purpose: 'Main Kubernetes source code repository' priority: 9 requiredForDeployment: false queryInstructions: | Reference for: 1. Latest feature development and roadmap 2. Issue tracking and known bugs 3. Code examples and integration patterns 4. Community discussions and RFCs 5. Release notes and changelogs - type: 'examples' url: 'https://github.com/kubernetes/examples' purpose: 'Official example applications and configurations' priority: 9 requiredForDeployment: true queryInstructions: | Review examples for: 1. Application deployment patterns 2. Configuration best practices 3. Multi-tier application architectures 4. Stateful application deployments 5. Service mesh integration examples - type: 'documentation' url: 'https://kubernetes.io/docs/tasks/' purpose: 'Task-based how-to guides for common operations' priority: 8 requiredForDeployment: false queryInstructions: | Consult for: 1. Step-by-step operational tasks 2. Configuration management 3. Monitoring and logging setup 4. Scaling and performance tuning 5. Security hardening tasks - type: 'documentation' url: 'https://kubernetes.io/docs/reference/kubectl/' purpose: 'kubectl CLI reference documentation' priority: 8 requiredForDeployment: false queryInstructions: | Use for: 1. kubectl command reference 2. Resource manipulation commands 3. Debugging and troubleshooting commands 4. Configuration management 5. Cluster administration tasks - type: 'community' url: 'https://github.com/kubernetes/community' purpose: 'Kubernetes community resources and SIGs' priority: 7 requiredForDeployment: false queryInstructions: | Reference for: 1. Community guidelines and processes 2. Special Interest Group (SIG) resources 3. Contributing guidelines 4. Community best practices baseCodeRepository: url: 'https://github.com/kubernetes/examples' purpose: 'Official Kubernetes example applications' integrationInstructions: | To use Kubernetes examples: 1. Clone the examples repository 2. Choose an example matching your application type 3. Adapt the manifests to your requirements 4. Apply manifests using kubectl 5. Verify deployments and services requiredFiles: - 'deployment.yaml' - 'service.yaml' scriptEntrypoint: 'kubectl apply -f .' dependencies: - name: 'kubectl' type: 'buildtime' required: true installCommand: >- curl -LO https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl verificationCommand: 'kubectl version --client' - name: 'kubeconfig' type: 'buildtime' required: true installCommand: 'Configure via cloud provider or cluster admin' verificationCommand: 'kubectl cluster-info' - name: 'helm' type: 'buildtime' required: false installCommand: 'curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash' verificationCommand: 'helm version' configurations: - path: 'deployment.yaml' purpose: 'Kubernetes Deployment manifest for application' required: true canAutoGenerate: true template: | apiVersion: apps/v1 kind: Deployment metadata: name: app-name labels: app: app-name spec: replicas: 3 selector: matchLabels: app: app-name template: metadata: labels: app: app-name spec: containers: - name: app-name image: app-image:tag ports: - containerPort: 8080 - path: 'service.yaml' purpose: 'Kubernetes Service manifest for network exposure' required: true canAutoGenerate: true template: | apiVersion: v1 kind: Service metadata: name: app-name spec: selector: app: app-name ports: - protocol: TCP port: 80 targetPort: 8080 type: LoadBalancer - path: 'ingress.yaml' purpose: 'Ingress resource for HTTP routing' required: false canAutoGenerate: true template: | apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: app-name spec: rules: - host: app.example.com http: paths: - path: / pathType: Prefix backend: service: name: app-name port: number: 80 - path: 'hpa.yaml' purpose: 'Horizontal Pod Autoscaler for automatic scaling based on CPU and memory metrics' required: false canAutoGenerate: true template: | apiVersion: autoscaling/v2 kind: HorizontalPodAutoscaler metadata: name: app-name spec: scaleTargetRef: apiVersion: apps/v1 kind: Deployment name: app-name minReplicas: 2 maxReplicas: 10 metrics: - type: Resource resource: name: cpu target: type: Utilization averageUtilization: 70 - type: Resource resource: name: memory target: type: Utilization averageUtilization: 80 behavior: scaleDown: stabilizationWindowSeconds: 300 policies: - type: Percent value: 50 periodSeconds: 60 scaleUp: stabilizationWindowSeconds: 0 policies: - type: Percent value: 100 periodSeconds: 15 - type: Pods value: 2 periodSeconds: 15 selectPolicy: Max - path: 'network-policy.yaml' purpose: 'Network Policy for pod-to-pod communication security and network isolation' required: false canAutoGenerate: true template: | apiVersion: networking.k8s.io/v1 kind: NetworkPolicy metadata: name: app-name-network-policy spec: podSelector: matchLabels: app: app-name policyTypes: - Ingress - Egress ingress: - from: - namespaceSelector: matchLabels: name: default - podSelector: matchLabels: app: app-name ports: - protocol: TCP port: 8080 egress: - to: - namespaceSelector: {} ports: - protocol: TCP port: 53 - protocol: UDP port: 53 - to: - podSelector: matchLabels: app: app-name ports: - protocol: TCP port: 8080 - to: [] ports: - protocol: TCP port: 443 - protocol: TCP port: 80 secrets: - name: 'image-pull-secret' purpose: 'Credentials for pulling private container images' environmentVariable: 'N/A' required: false - name: 'app-secrets' purpose: 'Application-specific secrets' environmentVariable: 'N/A' required: false infrastructure: - component: 'Kubernetes Cluster' purpose: 'Production Kubernetes cluster (1.24+)' required: true minimumVersion: '1.24' setupCommands: - 'kubectl cluster-info' - 'kubectl get nodes' healthCheckCommand: 'kubectl get nodes' - component: 'Container Registry' purpose: 'Registry for container images (Docker Hub, GCR, ECR, etc.)' required: true setupCommands: - 'docker login <registry>' healthCheckCommand: 'docker info' deploymentPhases: - order: 1 name: 'Prerequisites Validation' description: 'Verify cluster access and required tools' estimatedDuration: '2-5 minutes' canParallelize: false prerequisites: [] commands: - description: 'Verify kubectl is installed' command: 'kubectl version --client' expectedExitCode: 0 - description: 'Verify cluster connectivity' command: 'kubectl cluster-info' expectedExitCode: 0 - description: 'Check cluster nodes' command: 'kubectl get nodes' expectedExitCode: 0 - order: 2 name: 'Namespace Setup' description: 'Create and configure namespace for deployment' estimatedDuration: '1-2 minutes' canParallelize: false prerequisites: ['Prerequisites Validation'] commands: - description: 'Create namespace' command: 'kubectl create namespace <app-namespace>' expectedExitCode: 0 - description: 'Set default namespace context' command: 'kubectl config set-context --current --namespace=<app-namespace>' expectedExitCode: 0 - order: 3 name: 'Deploy Application Resources' description: 'Apply Kubernetes manifests' estimatedDuration: '5-10 minutes' canParallelize: false prerequisites: ['Namespace Setup'] commands: - description: 'Apply deployment manifest' command: 'kubectl apply -f deployment.yaml' expectedExitCode: 0 - description: 'Apply service manifest' command: 'kubectl apply -f service.yaml' expectedExitCode: 0 - description: 'Apply ingress (if configured)' command: 'kubectl apply -f ingress.yaml' expectedExitCode: 0 - description: 'Apply HPA (if configured)' command: 'kubectl apply -f hpa.yaml' expectedExitCode: 0 optional: true - description: 'Apply NetworkPolicy (if configured)' command: 'kubectl apply -f network-policy.yaml' expectedExitCode: 0 optional: true - order: 4 name: 'Verify Deployment' description: 'Check deployment status and health' estimatedDuration: '5 minutes' canParallelize: false prerequisites: ['Deploy Application Resources'] commands: - description: 'Wait for deployment to be ready' command: 'kubectl wait --for=condition=available --timeout=300s deployment/<app-name>' expectedExitCode: 0 - description: 'Check pod status' command: 'kubectl get pods -l app=<app-name>' expectedExitCode: 0 - description: 'Check service endpoints' command: 'kubectl get endpoints <app-name>' expectedExitCode: 0 - description: 'Check HPA status (if configured)' command: 'kubectl get hpa <app-name>' expectedExitCode: 0 optional: true - description: 'Check NetworkPolicy status (if configured)' command: 'kubectl get networkpolicy <app-name>-network-policy' expectedExitCode: 0 optional: true validationChecks: - id: 'cluster-connection' name: 'Cluster Connection' description: 'Verify connection to Kubernetes cluster' command: 'kubectl cluster-info' expectedExitCode: 0 severity: 'critical' failureMessage: 'Cannot connect to Kubernetes cluster' remediationSteps: - 'Verify kubeconfig is set: echo $KUBECONFIG' - 'Check cluster status with cloud provider' - 'Verify kubectl version matches cluster version' - id: 'deployment-ready' name: 'Deployment Ready' description: 'Verify all pods are running' command: 'kubectl get pods -l app=<app-name> --no-headers | grep -v Running && exit 1 || exit 0' expectedExitCode: 0 severity: 'critical' failureMessage: 'Some pods are not in Running state' remediationSteps: - 'Check pod status: kubectl describe pod <pod-name>' - 'View pod logs: kubectl logs <pod-name>' - 'Check resource limits and requests' - 'Verify image pull secrets if using private registry' - id: 'service-endpoints' name: 'Service Has Endpoints' description: 'Verify service has healthy endpoints' command: "kubectl get endpoints <app-name> -o jsonpath='{.subsets[*].addresses[*].ip}' | grep -q ." expectedExitCode: 0 severity: 'error' failureMessage: 'Service has no healthy endpoints' remediationSteps: - 'Check if pods are running: kubectl get pods -l app=<app-name>' - 'Verify service selector matches pod labels' - 'Check pod readiness probes' - id: 'hpa-status' name: 'HPA Status' description: 'Verify HPA is configured and functioning (if enabled)' command: 'kubectl get hpa <app-name> -o jsonpath="{.status.currentReplicas}" | grep -q .' expectedExitCode: 0 severity: 'warning' failureMessage: 'HPA not found or not functioning' remediationSteps: - 'Check if HPA manifest exists: kubectl get hpa <app-name>' - 'Verify metrics server is installed: kubectl top nodes' - 'Check HPA events: kubectl describe hpa <app-name>' - 'Ensure deployment has resource requests/limits set' optional: true - id: 'network-policy-status' name: 'NetworkPolicy Status' description: 'Verify NetworkPolicy is applied (if enabled)' command: 'kubectl get networkpolicy <app-name>-network-policy' expectedExitCode: 0 severity: 'warning' failureMessage: 'NetworkPolicy not found' remediationSteps: - 'Check if NetworkPolicy manifest exists: kubectl get networkpolicy' - 'Verify NetworkPolicy is applied: kubectl describe networkpolicy <app-name>-network-policy' - 'Check if CNI plugin supports NetworkPolicy (Calico, Cilium, etc.)' optional: true healthChecks: - name: 'Pod Health' endpoint: 'kubectl get pods -l app=<app-name> --no-headers | grep -v Running && exit 1 || exit 0' interval: 60000 timeout: 5000 healthyThreshold: 1 unhealthyThreshold: 3 - name: 'Node Health' endpoint: 'kubectl get nodes --no-headers | grep -v Ready && exit 1 || exit 0' interval: 300000 timeout: 10000 healthyThreshold: 1 unhealthyThreshold: 2 - name: 'HPA Scaling Status' endpoint: >- kubectl get hpa <app-name> -o jsonpath="{.status.conditions[?(@.type==\"AbleToScale\")].status}" | grep -q True interval: 60000 timeout: 5000 healthyThreshold: 1 unhealthyThreshold: 3 optional: true environmentOverrides: - environment: 'development' overrides: deploymentPhases: - order: 3 name: 'Deploy Application (Dev Mode)' commands: - description: 'Deploy with single replica' command: 'kubectl apply -f deployment.yaml --replicas=1' metadata: source: 'Kubernetes Official Documentation' lastUpdated: '2025-12-15' maintainer: 'Cloud Native Computing Foundation' tags: - 'kubernetes' - 'k8s' - 'container-orchestration' - 'cloud-native' - 'cncf' - 'autoscaling' - 'network-policy' - 'security' contributors: - name: 'Kubernetes Community' github: 'kubernetes' changeLog: - version: '1.1' date: '2025-12-15' changes: - 'Added Horizontal Pod Autoscaler (HPA) template for automatic scaling' - 'Added NetworkPolicy template for pod-to-pod security' - 'Updated deployment phases to include HPA and NetworkPolicy application' - 'Added validation checks for HPA and NetworkPolicy' - 'Added health checks for HPA scaling status' - 'Updated detection hints to include HPA and NetworkPolicy files' - version: '1.0' date: '2025-01-19' changes: - 'Initial Kubernetes pattern definition' - 'Added official documentation links' - 'Included kubectl and cluster validation steps' detectionHints: requiredFiles: - 'deployment.yaml' - 'service.yaml' optionalFiles: - 'ingress.yaml' - 'hpa.yaml' - 'network-policy.yaml' - 'kustomization.yaml' - 'helm/' confidence: deployment.yaml: 0.90 service.yaml: 0.85 ingress.yaml: 0.70 hpa.yaml: 0.60 network-policy.yaml: 0.55 kustomization.yaml: 0.80