+86 189 8218 1436 周一至五 10:00-22:00

docker compose on gcp 部署实战

TL;DR:复用本地 compose 上云?讲清 docker compose on gcp 在 VM 的 3 步部署,对比 Cloud Run,附自启、密钥与省钱实践。

它是什么:docker compose on gcp 指什么

先记住一句话

“docker compose on gcp”不是 Google Cloud 的产品名,也不是一键按钮。它通常指:你用 docker-compose.yml 定义了 Web、API、数据库等多个容器,想放到 GCP 上运行。Compose 像“应用说明书”,写明容器、端口和依赖;GCP 提供机器、网络、镜像仓库、日志和权限。

本地执行 docker compose up 即可启动;上云则要决定:镜像存哪、容器跑在哪、用户怎么访问、数据是否持久化、密钥怎么注入、挂了谁重启。

常见落地方式

  • Compute Engine:在虚拟机里安装 Docker 和 Compose,最接近本地,适合学习和小项目。
  • Cloud Run:把服务分别做成镜像部署;它不直接读 Compose 文件,要拆成服务、环境变量和托管数据库。
  • GKE:用 Kubernetes 运行,需把 Compose 转成 Deployment、Service、ConfigMap,可用 kompose 辅助。

所以,这个关键词更像一条“上云路线”:先选平台,再补齐镜像仓库、数据库、密钥、负载均衡和监控。别误以为 GCP 会直接托管一份 Compose 文件。

解决什么问题:为什么把 Compose 搬上云

把 Compose 搬上云,不是让 docker compose up 变复杂,而是让服务不再只活在笔记本里。本地一键启动前端、API、数据库和缓存很方便;但关机、换网络、同事访问、数据丢失或端口冲突,都会让演示中断。环境变量、镜像版本、卷挂载和启动顺序散落在个人电脑里,也常造成“我这里是好的”。

在 Google Cloud(GCP)上,最简单的 docker compose on gcp 路径是开一台 Compute Engine 虚拟机:装好 Docker 和 Compose,上传同一份 compose.yaml,再配置外部 IP、VPC 防火墙规则和域名。这样团队就能通过公网访问,云主机还提供稳定算力、持久磁盘、快照、可接入 Cloud Logging 的日志和按需计费;以后可逐步换用 Cloud SQL、Cloud Storage 或 Secret Manager。

它主要解决四个问题:

  • 把临时本机环境变成长期在线的演示或测试环境;
  • 让多人使用同一套依赖和版本,减少重复配置;
  • 用最小改动理解云端网络、存储、权限和费用;
  • 为迁移到 Cloud Run 或 GKE 留出清晰路线。

注意,Compose 擅长单机编排,不负责自动扩缩容和多机调度。作为 GCP 入门,先用一台 VM 跑通,最容易排错,也最能看清容器与云资源的对应关系。

怎么上手:3 步在 VM 跑起来

怎么上手:3 步在 VM 跑起来

在 GCP 上试 Docker Compose,先用一台 Compute Engine VM 最省心:不用先学 Kubernetes,也能用 compose.yaml 把服务一起启动。下面把 Nginx 映射到 80 端口,适合学习和小 demo;生产环境再考虑 Cloud Run 或 GKE。准备好项目、结算账号和 Cloud Shell 里的 gcloud,实验完删除实例,避免继续计费。

  1. 第 1 步:建 VM 并放行 80

    在 Cloud Shell 创建 Debian 12 小实例并加 http-server 标签。默认 VPC 已有 HTTP 规则时可跳过第二条;自定义网络请补一条允许 tcp:80 的入站规则。

    gcloud compute instances create compose-demo --zone=asia-east1-a --machine-type=e2-micro --image-family=debian-12 --image-project=debian-cloud --tags=http-server
    gcloud compute firewall-rules create allow-http-80 --network=default --allow=tcp:80 --source-ranges=0.0.0.0/0 --target-tags=http-server
  2. 第 2 步:装 Docker 与 Compose

    第一行从本地 SSH 进 VM,后面都在 VM 内执行。官方便利脚本会装好 Docker Engine 与 Compose 插件;下载后可先看一眼再运行。V2 命令是 docker compose,不是旧的 docker-compose。

    gcloud compute ssh compose-demo --zone=asia-east1-a
    curl -fsSL https://get.docker.com -o get-docker.sh
    sudo sh get-docker.sh
    sudo docker compose version
  3. 第 3 步:写文件并启动

    接着在刚才的 SSH 会话里写 compose.yaml;ports 做端口映射,-d 表示后台运行。

    mkdir demo && cd demo
    cat > compose.yaml <<'EOF'
    services:
      web:
        image: nginx:alpine
        ports:
          - "80:80"
    EOF
    sudo docker compose up -d
    sudo docker compose ps

    到“Compute Engine > VM 实例”复制外部 IP,访问 http://外部IP。看到 Nginx 欢迎页即成功;若失败,先查标签、防火墙和 sudo docker compose logs。

与替代方案对比:VM / Cloud Run / GKE

在 GCP 上,docker compose 是单机工具,不是托管服务。先看三点:是否愿管服务器、流量是否波动、是否依赖共享磁盘或常驻进程。

  • VM:最像本地。开一台 Compute Engine,装 Docker/Compose,运行 docker compose up -d 即可;适合教程和小工具,但补丁、防火墙、备份、监控、扩容都要自己做。
  • Cloud Run:每个服务单独打镜像部署,按请求扩缩容,适合无状态 Web/API;不读 Compose 文件,变量、密钥、服务调用要改平台配置,共享卷和长连接需重设计。
  • GKE:用 Kubernetes 管多服务,支持灰度、自愈和复杂网络;但 Compose 要转成 Deployment/Service 等对象,成本和学习曲线最高。

建议:学习用 VM,上线简单容器选 Cloud Run,有 K8s 经验再上 GKE;Compose 留在本地,部署配置按平台改写。

最佳实践:新手避坑清单

最佳实践:新手避坑清单

在 GCP 上跑 Docker Compose,适合本地联调、演示或单台 Compute Engine 小应用。Compose 不是集群编排器,生产可评估 Cloud Run 或 GKE。部署前按下面清单检查,能少踩权限、网络、数据和账单坑。

  1. 先选对项目、启用结算,开启 Compute Engine、Artifact Registry、Secret Manager 等 API;服务账号只给最小权限,别下载长期密钥。
  2. 镜像推到 Artifact Registry 并写明确版本,别用 latest,也别只在 VM 里临时 build,方便复现和回滚。
  3. 配置放 .env,密码、API Key、数据库串放 Secret Manager;不要提交 .env 或把凭据写进 compose 文件。
  4. 数据库用 Cloud SQL,文件用 Cloud Storage 或 Filestore;本地 bind mount 依赖 VM 磁盘,重建实例或 docker compose down -v 清理卷都可能丢数据。
  5. 只开放必要端口和来源 IP,设置 healthcheck、restart、资源限制;日志接入 Cloud Logging,别只靠 SSH 看输出。
  6. 设置预算提醒、标签和固定区域;练习结束删除 VM、磁盘、镜像和防火墙规则,避免持续计费。
gcloud config set project PROJECT_ID
docker compose config
docker compose up -d

每次改完 compose.yml 先校验再重启,并把命令写进 README,新人也能稳定复现。

常见问题(FAQ)

Cloud Run 能直接读 docker-compose.yml 吗?

不能。它只接单容器镜像,需手动或用 Kompose 把 compose 拆成多个独立服务再分别部署。

跑 docker compose on gcp 会不会很贵?

用 e2-micro 加按需关机很便宜,常在免费额度内;记得设预算告警,别漏关 VM 和持久磁盘。

Container-Optimized OS 自带 Compose 吗?

只带 Docker,不带插件。在 cloud-init 启动脚本里补装 docker-compose-plugin 即可。

不想自己折腾 GCP?我们提供云平台代维护、上云迁移与账单代付服务,一对一技术支持。

查看代维服务 →

发表评论