AgentSkillsCN

kustomize-patterns

运用 base、组件与叠加层结构，覆盖 Kustomize 部署模式。适用于为不同环境整理 Kubernetes 清单时使用。

SKILL.md
--- frontmatter
name: kustomize-patterns
description: Covers Kustomize deployment patterns using base, components, and overlays structure. Use when organizing Kubernetes manifests for different environments.

Kustomize Patterns

This skill covers Kustomize deployment patterns for Datum Cloud services.

Overview

Services use a base + components + overlays model:

code
config/
├── base/                    # Core resources
├── components/              # Toggleable features
└── overlays/               # Environment-specific

Key Files

FilePurpose
components.mdComponent patterns
overlays.mdEnvironment overlays

Base Structure

yaml
# config/base/kustomization.yaml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization

resources:
  - deployment.yaml
  - service.yaml
  - serviceaccount.yaml

commonLabels:
  app.kubernetes.io/name: myservice
  app.kubernetes.io/component: apiserver

Components

Independently toggleable features:

ComponentPurpose
api-registrationAPIService registration
cert-manager-caTLS certificates
observabilityMetrics and health
tracingDistributed tracing

Overlays

One per environment:

OverlayPurpose
developmentLocal development
stagingPre-production
productionProduction deployment

Validation

Run scripts/validate-kustomize.sh to verify:

  • •All overlays build successfully
  • •No invalid references

Run scripts/check-security.sh to verify:

  • •Security contexts set
  • •No root containers
  • •Resource limits defined

Related Files

  • •components.md — Component details
  • •overlays.md — Overlay patterns
  • •scripts/validate-kustomize.sh — Build validation
  • •scripts/check-security.sh — Security validation