kompose转换docker-compose为K8S Deployment异常如何解决

kompose转换出现警告、生成7个文件不是程序故障，核心是你的docker-compose配置和K8s的资源模型不匹配：

• 4条挂载警告的来源：K8s不支持直接识别docker-compose里写的./api、./worker这类相对路径的宿主机目录挂载，kompose无法自动把这类本地开发用的路径映射为K8s合法的卷配置，只能放弃原有宿主机路径，自动生成PersistentVolumeClaim（PVC）占位文件，这4个*-claim*-persistentvolumeclaim.yaml就是这么来的。
• /var/run/docker.sock的挂载警告：这类直接访问节点套接字的高风险特殊配置，kompose不会做自动转换，所以也会抛出提示。
• 额外生成的api-service.yaml是正常逻辑：你给api服务配置了8050端口映射，kompose会自动为带端口暴露的服务生成K8s Service资源，用于集群内/外的访问入口，不属于异常生成的文件。
• 你预期只生成单个Deployment本身不符合K8s的资源设计：两个服务本来就需要独立的Deployment配置，加上端口暴露需要Service、卷需要PVC，多文件是K8s的资源拆分逻辑决定的。

两种方案都可行，针对你这个双服务的简单场景，手动编写配置效率更高。

方案1：修正kompose生成的文件 #

如果不想从零写配置，可以按以下步骤裁剪转换结果：

1. 直接删除4个自动生成的PVC文件。你配置的./api、./worker挂载是本地开发用的代码热更新映射，生产部署时应该把代码直接打进镜像，不需要这类卷挂载，对应把两个Deployment里关联的volumes、volumeMounts配置块删掉即可。
2. 如果确实需要挂载docker.sock，手动在api服务的Deployment配置中添加hostPath卷：

volumes:
- name: docker-sock
  hostPath:
    path: /var/run/docker.sock
    type: Socket

再在api容器的volumeMounts段添加对应挂载规则即可。
3. 保留自动生成的两个Deployment和一个Service文件，修改镜像地址、环境变量参数后即可使用。

方案2：手动编写部署配置 #

简单场景下手写配置不会生成无用的占位资源，逻辑更可控。你可以把所有资源写在同一个yaml文件里，用---分隔即可，不需要拆成多个独立文件，参考最小配置如下：

# API服务对应的Service，用于暴露访问端口
apiVersion: v1
kind: Service
metadata:
  name: api-svc
spec:
  selector:
    app: api
  ports:
    - port: 8050
      targetPort: 8050
  # 集群内部访问用默认ClusterIP即可，需要外部访问可改为NodePort/LoadBalancer
  type: ClusterIP
---
# Worker服务Deployment
apiVersion: apps/v1
kind: Deployment
metadata:
  name: worker
spec:
  replicas: 1
  selector:
    matchLabels:
      app: worker
  template:
    metadata:
      labels:
        app: worker
    spec:
      containers:
      - name: worker
        # 提前将构建好的镜像推送到镜像仓库，单机测试可存放在节点本地并设置imagePullPolicy: IfNotPresent
        image: your-registry/worker:latest
        env:
        - name: PYTHONUNBUFFERED
          value: "1"
---
# API服务Deployment
apiVersion: apps/v1
kind: Deployment
metadata:
  name: api
spec:
  replicas: 1
  selector:
    matchLabels:
      app: api
  template:
    metadata:
      labels:
        app: api
    spec:
      containers:
      - name: api
        image: your-registry/api:latest
        ports:
        - containerPort: 8050
        volumeMounts:
        - name: docker-sock
          mountPath: /var/run/docker.sock
      volumes:
      - name: docker-sock
        hostPath:
          path: /var/run/docker.sock
          type: Socket

手动编写注意事项 #

• K8s没有docker-compose中depends_on的强制启动顺序机制，Pod可能随时被调度重建，不要依赖启动顺序做服务连通，在代码中添加服务访问的重试逻辑即可。
• 不需要手动指定container_name，K8s会自动为Pod生成唯一名称，手动指定反而可能因为名称冲突导致Pod启动失败。
• 非单机调试场景不要用hostPath挂载本地代码目录，把代码直接构建进镜像才是标准部署方式。

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