Docker-in-Docker环境下Python SDK配置及K8s部署问题排查

一、DinD镜像构建方案选择 #

优先选择基于Python镜像构建，理由如下：

• 你的后端本身是Python应用，基于Python镜像构建能省去重复安装Python环境的步骤，镜像体积更小，构建流程更简洁，和应用栈的兼容性也更好。
• 官方Python镜像（如python:3.11-slim）已经做了轻量化优化，比Ubuntu这类通用发行版镜像更适合K8s场景下的资源高效利用。
• 若选择Alpine这类极致轻量的发行版，虽然体积更小，但容易遇到Python依赖与Docker CLI的兼容性问题（比如部分C扩展依赖缺失），调试成本更高。

二、解决docker ps的DNS解析错误 #

你遇到的error during connect: Get "http://docker:2375/v1.46/containers/json": dial tcp: lookup docker on 192.168.65.7:53: no such host错误，核心是应用容器无法找到DinD服务的网络地址，可按以下步骤解决：

错误原因 #

Docker CLI默认会读取DOCKER_HOST环境变量（默认值为tcp://docker:2375），尝试连接名为docker的主机，但你的K8s集群中并未创建对应服务，导致DNS解析失败。

解决步骤 #

1. 部署DinD并创建Service：在K8s中将DinD部署为独立Pod或StatefulSet，再创建一个ClusterIP类型的Service（例如命名为docker-dind），让后端Pod能通过Service名称访问DinD服务。
2. 配置后端Pod的环境变量：在后端的Deployment配置里，覆盖DOCKER_HOST指向DinD的Service地址：

   env:
     - name: DOCKER_HOST
       value: tcp://docker-dind:2375
   

3. 验证端口映射：确保DinD容器暴露了2375端口（启用TLS则为2376），且Service的端口与容器端口完全对应。
4. 替代方案建议：DinD需要以特权模式运行，存在安全风险和资源开销。如果你的需求仅为构建镜像或容器管理，更推荐使用Kaniko这类原生适配K8s的工具，或直接调用K8s容器运行时接口（CRI），这是更符合K8s生态的做法。

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