如何在Cloud Run中用Python连接Google Cloud Docker服务及配置env文件

错误原因 #

Cloud Run是无服务器托管环境，没有内置Docker守护进程，docker.from_env()默认尝试连接本地Unix socket（/var/run/docker.sock），因此会触发FileNotFoundError。

环境变量配置说明 #

要通过Python的Docker客户端操作GCP项目中的容器，你需要连接到GCP内运行Docker守护进程的目标环境（比如GCE虚拟机、GKE集群节点），此时env文件需配置以下核心变量：

• DOCKER_HOST：远程Docker守护进程的访问地址，格式为tcp://<目标实例公网IP>:2376（2376是Docker TLS连接的默认端口）
• DOCKER_TLS_VERIFY：设为1，启用TLS加密连接（必须配置，否则连接不安全且可能被拒绝）
• DOCKER_CERT_PATH：指向存放TLS证书的目录路径（这些证书需要从目标Docker环境获取，或在GCE实例上生成后同步到Cloud Run服务的文件系统中）

额外注意事项 #

1. 确保目标Docker环境（如GCE实例）的防火墙开放2376端口，且Cloud Run的服务账号拥有访问该实例的权限。
2. 若目标是GKE集群，更推荐通过gcloud container clusters get-credentials配置Docker上下文，而非手动设置env变量；如果坚持用env变量，需先获取集群的Docker endpoint地址。
3. 若你是想管理GCP的Cloud Run服务本身，建议使用GCP官方Python客户端库（如google-cloud-run），而非原生Docker客户端——Cloud Run是托管式无服务器服务，本身不支持直接通过Docker客户端启停容器。

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