Claymorphism design system skill. Use when building soft, puffy, clay-like UI components with large radii, dual inner shadows, and offset outer shadows.

2026-03-315.6k

name	infrastructure
description	云原生基础设施。Kubernetes、Helm、Kustomize、Operator、CRD、GitOps、ArgoCD、Flux、IaC、Terraform、Pulumi、CDK。当用户提到 K8s、Helm、GitOps、IaC 时路由到此。
license	MIT
user-invocable	false
disable-model-invocation	false

云原生基础设施 · Infrastructure

域概览

                    GitOps 控制平面
                          |
        +-----------------+-----------------+
        |                 |                 |
    ArgoCD/Flux      Kubernetes         IaC 层
        |                 |                 |
   Git Repo ------> Helm/Kustomize --> Terraform/Pulumi
        |                 |                 |
    声明式配置        容器编排          云资源管理

Kubernetes 容器编排

Helm Chart 开发

标准结构：Chart.yaml + values.yaml + templates/ + charts/

核心要点：

Chart.yaml：apiVersion: v2, dependencies 声明子 Chart（condition 控制启用）
values.yaml 设计：image / replicaCount / resources / autoscaling / service / ingress / probes / env / persistence
Deployment 模板：使用 _helpers.tpl 定义 fullname / labels / selectorLabels
配置校验：checksum/config: {{ include ... | sha256sum }} 触发滚动更新
安全上下文：runAsNonRoot: true, runAsUser: 1000

关键命令：

helm lint / helm template --debug 验证
helm install -f values-prod.yaml 部署
helm upgrade --reuse-values 升级
helm rollback <release> <revision> 回滚
helm push <chart>.tgz oci://registry 推送 OCI

Kustomize 配置管理

目录结构：base/ + overlays/{dev,staging,production}/

核心能力：

base/kustomization.yaml：resources / commonLabels / images / configMapGenerator / secretGenerator
overlay：namespace / patchesStrategicMerge / patchesJson6902 / replicas / images / configMapGenerator(behavior: merge)
命令：kubectl apply -k overlays/production / kubectl diff -k

Operator 模式

CRD 定义：openAPIV3Schema 声明 spec/status，subresources(status/scale)
Controller 核心循环：Get CR → 构建期望状态 → Create/Update 子资源 → 更新 Status
OwnerReferences：子资源关联 CR，级联删除
初始化：operator-sdk init → create api → make manifests → make install

部署策略

策略	实现方式	适用场景
滚动更新	`strategy.rollingUpdate` maxSurge/maxUnavailable	默认策略
蓝绿部署	两个 Deployment + Service selector 切换	零停机切换
金丝雀	stable(9) + canary(1) 共享 Service	渐进式验证
Flagger	`Canary` CRD + 自动分析指标	自动化金丝雀

K8s Checklist

健康检查：livenessProbe + readinessProbe 必配
资源限制：requests + limits 防止资源耗尽
HPA：CPU/Memory/自定义指标自动扩缩容
PDB：minAvailable 防止滚动更新中断
ResourceQuota + LimitRange：命名空间资源配额
镜像使用 Digest 确保一致性
Pod 反亲和性分散到不同节点
密钥外部化：External Secrets Operator

GitOps 持续部署

ArgoCD vs Flux

特性	ArgoCD	Flux
Web UI	功能强大	无（可用 Weave GitOps）
多租户	Projects + RBAC	需额外配置
多集群	原生支持	原生支持
镜像自动更新	需 Image Updater	原生支持
渐进式交付	Argo Rollouts	Flagger
CNCF	Graduated	Graduated

ArgoCD 核心模式

Application：source(repoURL/path/targetRevision) + destination(server/namespace)
syncPolicy：automated(prune: true, selfHeal: true) + retry
ignoreDifferences：忽略 HPA 修改的 /spec/replicas
ApplicationSet：Git 目录生成器，一套模板管理多环境
多集群：argocd cluster add 注册集群
Notifications：ConfigMap 配置 Slack/Email 通知模板
Rollouts：Canary CRD + steps(setWeight/pause) + AnalysisTemplate(Prometheus 查询)

Flux 核心模式

GitRepository：interval: 1m, ref branch, secretRef
Kustomization：path + prune + healthChecks + postBuild substitute
HelmRepository + HelmRelease：chart + values + install/upgrade remediation
ImageRepository + ImagePolicy + ImageUpdateAutomation：自动检测新镜像并提交 Git

多环境管理

fleet-infra/
├── clusters/{dev,staging,production}/  # 每集群入口
├── infrastructure/base + overlays/     # 基础组件
└── apps/base + overlays/              # 应用配置

密钥管理

Sealed Secrets：kubeseal 加密 → 提交 Git → Controller 解密
External Secrets Operator：SecretStore(AWS SM) + ExternalSecret → 自动同步

GitOps Checklist

Git 为唯一真相源，所有变更通过 PR
自动同步 + 自愈（selfHeal）
密钥加密存储（Sealed Secrets / External Secrets）
渐进式交付（Rollouts / Flagger）
多环境目录隔离
回滚策略：保留历史版本

基础设施即代码 (IaC)

工具对比

工具	语言	状态管理	云支持	学习曲线
Terraform	HCL	显式(S3/TF Cloud)	全平台	中等
Pulumi	Python/TS/Go	自动(Pulumi Cloud)	全平台	较低
AWS CDK	Python/TS	CloudFormation	AWS	中等

Terraform 核心模式

项目结构：modules/{vpc,eks,rds}/ + environments/{dev,staging,prod}/

Provider：版本锁定 required_providers + default_tags
Backend：S3 + DynamoDB 锁 + KMS 加密
模块化：variable → resource → output，环境通过 module 引用
远程状态：data "terraform_remote_state" 跨模块引用
命令流：init → validate → fmt → plan -out=tfplan → apply tfplan
状态管理：state list/show/mv/rm / import 导入现有资源
Workspace：workspace new/select 多环境隔离

Pulumi 核心模式

ComponentResource：自定义资源组（VPC/EKS 封装为类）
Config：pulumi.Config() 读取 stack 配置
Outputs：pulumi.export() 导出值
命令：preview → up → stack output / destroy

AWS CDK 核心模式

Stack：继承 Stack，使用 L2 Constructs（ec2.Vpc / eks.Cluster）
跨 Stack 引用：通过构造函数参数传递
命令：synth → diff → deploy --all / bootstrap

IaC Checklist

模块化：可复用组件抽象为模块
环境隔离：不同环境不同 State
远程状态 + 状态锁定
Provider 版本锁定
密钥管理：Secrets Manager / SSM
统一资源标签
Plan 后人工审查再 Apply
CI/CD 集成自动化

最佳实践

层级	工具选择	原则
应用部署	Helm + Kustomize	模板化 + 环境差异
持续交付	ArgoCD / Flux	Git 为唯一真相源
基础设施	Terraform / Pulumi	声明式 + 状态管理
配置管理	External Secrets	密钥外部化
可观测性	Prometheus + Grafana	指标 + 可视化

触发词

Kubernetes、K8s、Helm、Kustomize、Operator、CRD、GitOps、ArgoCD、Flux、IaC、Terraform、Pulumi、CDK、基础设施即代码