免费工具
Docker Compose 转 Kubernetes 工具
粘贴 compose.yaml 或 docker-compose.yml,然后选择“转换”。每个服务都会变成一个 Deployment,发布的端口变成 Service,环境变量移入 ConfigMap 和 Secret,命名卷会得到 PersistentVolumeClaim。检查 YAML,下载为 kubernetes.yaml,并以 Kubernetes 图的形式查看结果。
示例输出
使用方法
粘贴 Compose 文件
粘贴完整文件,包括锚点和扩展字段。有 version 行或 x- 块也没关系。
选择“转换”并决定如何处理值
默认是“仅名称”,不会把任何值写入输出。想复制看起来不像机密的值时,切换到“保留值”。
检查、下载或打开
填写标出的值,下载 kubernetes.yaml,或在 Archboard 中打开图。注册只需 Google 或 GitHub 账号。
你会得到哪些 Kubernetes 对象
- 每个 Compose 服务生成一个 Deployment,包含镜像、容器端口、资源限制以及来自 deploy.replicas 的副本数。标签和选择器使用 app: 和服务名。
- 每个发布了端口的 Compose 服务生成一个 Service;port 为发布端口,targetPort 为容器端口。每个端口都有类似 tcp-8080 的名称。
- 环境变量会被拆分:普通设置放入 ConfigMap,看起来像密码、令牌或密钥的名称放入 Secret。顶层的 secrets 会变成带占位值的 Secret 对象。
- 每个在顶层声明并被服务使用的命名卷都会生成一个 PersistentVolumeClaim,并挂载到容器内的相同路径。
把输出当作初稿
这些清单是用来阅读和完善的,不应不加检查就直接应用。Secret 的值写成 REPLACE_ME,空的 ConfigMap 值带有 set value 注释,每个卷申领都请求 1Gi 并带有 adjust size 注释。健康检查会标记为 not converted,因此探针、存储类、Ingress 和命名空间需要你自己设置。摘要会显示还有多少值需要填写。
Compose 转 Kubernetes 转换器跳过的内容
- Helm Chart、Kustomize 覆盖层和模板:输出是一个包含多个文档的普通 YAML 文件。
- 没有发布端口的容器的 Service。只使用 expose 或没有任何端口的服务不会生成 Service;如果其他服务按名称调用它们,警告会告诉你需要手动添加哪些。
- 绑定挂载、tmpfs 挂载和匿名卷。它们会计入警告,不会创建 hostPath 卷。
- 镜像构建和 depends_on 顺序。只有 build 部分的服务会得到一个占位镜像名,depends_on 会在 Deployment 上方标记为 not converted。
“仅名称”还是“保留值”
“仅名称”只复制变量名,不输出值、命令和入口点,因此包含真实凭据的 Compose 文件不会出现在输出中。“保留值”会把普通值复制到 ConfigMap,并把 command 和 entrypoint 分别移到 args 和 command。看起来像密码、令牌或密钥的名称在两种模式下都会写成 REPLACE_ME。
Compose 转 Kubernetes 常见问题
每个 Deployment 有几个副本?
副本数取自 Compose 文件中的 deploy.replicas,没有该字段的服务为 1 个副本。deploy.resources 中的 CPU 和内存限制会被保留,512m 这样的内存单位会转换为 512Mi。
可以直接对输出执行 kubectl apply 吗?
请先检查。替换所有 REPLACE_ME,填写空的 ConfigMap 值,设置卷的大小,并添加警告中提到的 Service。文件是普通的 Kubernetes YAML,补全后可以直接应用、拆分,或改写成 Helm Chart。
Kubernetes 不允许的服务名会怎样处理?
名称会转为小写并缩短,以符合 Kubernetes 的命名规则,对象之间的引用使用调整后的名称。警告会统计有多少名称被修改,方便你在应用文件前检查。
在 Archboard 中打开图后会发生什么?
预览不会被保存。选择“在 Archboard 中打开”后,生成对象的图会作为新图保存到你的工作区,你可以在那里重新排列、添加注释和分享。kubernetes.yaml 本身不会被保存:离开页面前请复制或下载。
Compose 转 Kubernetes 转换器免费吗?
免费。转换文件、复制清单和以 SVG 或 PNG 格式下载图都不需要账号。在 Archboard 中打开图需要一个免费账号。