从Kubernetes集群迁移至docker-compose遇kompose转换错误求助

错误原因 #

你用kubectl get deployments,services,pods -o yaml导出的是Kubernetes List类型的YAML文件，这种文件根结构为apiVersion: v1、kind: List，内部通过items数组包含所有资源。而Kompose不支持直接解析这种List格式，它需要处理单个资源或者用---分隔的多文档YAML（每个文档对应一个Kubernetes资源）。

解决步骤 #

1. 拆分List格式的YAML为多文档结构

推荐用yq工具快速拆分（未安装的话可通过包管理器安装，比如apt install yq或brew install yq）：

yq eval '.items[]' k8s-resources.yaml > split-resources.yaml

该命令会把原List中的每个资源提取出来，生成一个用---分隔的多文档YAML文件，Kompose可正常解析这种格式。

如果没有yq，也可以分别导出单个资源类型再合并：

# 导出Deployment
sudo kubectl get deployments --namespace <NAMESPACE> -o yaml > split-resources.yaml
# 添加分隔符并导出Service
echo "---" >> split-resources.yaml
sudo kubectl get services --namespace <NAMESPACE> -o yaml >> split-resources.yaml
# 若存在独立Pod（非Deployment管理），再追加导出
echo "---" >> split-resources.yaml
sudo kubectl get pods --namespace <NAMESPACE> -o yaml >> split-resources.yaml

注意：由Deployment管理的Pod无需单独转换，Kompose处理Deployment时会自动生成对应的compose服务配置。

2. 重新用Kompose转换

使用拆分后的文件执行转换：

kompose convert --volumes hostPath -f split-resources.yaml

额外注意事项 #

• Kompose对Kubernetes资源的支持有局限性，比如CRD、复杂网络策略、RBAC规则等无法转换，需要手动调整生成的docker-compose.yml。
• 转换完成后，务必检查生成的配置：端口映射是否正确、环境变量是否完整、卷挂载路径是否符合主机实际路径。
• 若遇到特定资源转换失败，可单独导出该资源的YAML文件，单独转换排查问题。

内容的提问来源于stack exchange，提问作者twet