Telagod Code Abyss Infrastructure

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

部署策略

K8s Checklist

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

GitOps 持续部署

ArgoCD vs Flux

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 核心模式

项目结构：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 集成自动化

最佳实践

触发词

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

Converted and distributed by TomeVault — claim your Tome and manage your conversions.