从 Docker Compose 迁移到 Kubernetes

适用场景

单机 Docker Compose 已经无法满足高可用、弹性和多环境发布。迁移到 Kubernetes 可以复用 Compose 的服务定义，但需要重新设计网络、存储、配置和发布。

前置条件

• 可用的 docker-compose.yml。
• Kubernetes 集群和镜像仓库。
• 明确哪些服务需要持久化。
• 入口域名和 TLS 证书。

步骤

1. 盘点 Compose 服务：

docker compose config
docker compose ps
docker compose images

2. 用 Kompose 生成初始清单：

kompose convert -f docker-compose.yml -o k8s/
ls k8s/

3. 修正生成结果：

• build: 改为已推送的镜像。
• ports: 改为 Service，外部入口用 Ingress。
• volumes: 改为 PVC 或 ConfigMap。
• environment: 改为 ConfigMap/Secret。
• depends_on: 改为启动探针或 initContainer。

4. 创建 ConfigMap 和 Secret：

kubectl create configmap app-config --from-env-file=.env
kubectl create secret generic app-secret \
  --from-literal=DB_PASSWORD='***'

5. 部署：

kubectl apply -f k8s/
kubectl get pods,svc,ingress

6. 配置持久化：

kubectl apply -f - <<'EOF'
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: app-data
spec:
  accessModes: [ReadWriteOnce]
  resources:
    requests:
      storage: 20Gi
EOF

7. 灰度切流，保留 Compose 环境作为回滚。

验证

• 所有服务 Running，探针正常。
• 服务间通过 Service DNS 互通。
• 配置和密钥正确注入。
• 数据持久化并能在 Pod 重建后恢复。
• Ingress/TLS 正常。
• 日志和指标接入。

回滚

• 保留原 Compose 主机和数据卷。
• DNS 切回旧入口。
• 数据库迁移保留备份和反向同步。
• 确认新环境稳定后再删除旧环境。

常见坑

• depends_on 在 Kubernetes 不生效，启动顺序需要探针或 initContainer。
• Compose 的默认网络和 Kubernetes DNS 不同，服务名要改。
• 容器内 localhost 访问其他服务，迁移后失败。
• 命名卷没有对应 PVC，数据丢失。
• 环境变量包含密钥，直接写进 ConfigMap。
• 单副本 Deployment 没有 PDB，升级时服务中断。
• 端口映射和 Ingress 路径不一致，404。
• 直接删除 Compose 环境，回滚时没有数据。

相关命令

• kompose — Compose 转 Kubernetes 清单
• docker compose — 查看旧环境
• kubectl — 部署和排查
• helm / kustomize — 管理清单