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

deploy docker compose gcp 实战

TL;DR:不用懂 K8s!在 GCP 开一台小虚拟机,装好 Docker Compose,上传 yml 一条命令就能把多容器应用跑起来,全程复制粘贴即可。

开始前你需要准备

开始前你需要准备

本文在 GCP 用 Compute Engine 部署 Docker Compose;先本机跑通,再把文件传到 VM。请准备:

  • 启用结算的 Google Cloud 项目,记下 ID 和区域,如 asia-east1。
  • 安装 gcloud、Docker、Compose 插件,执行 gcloud init 登录。
  • docker-compose.yml、Dockerfile 或镜像、.env 等文件;有创建 VM、开放 80 端口的权限。

整体思路

整体思路

在 GCP 部署 Docker Compose,可先理解为“给一组容器找一台云上机器”。Compose 负责描述服务、端口和依赖;Google Cloud 负责镜像仓库、网络、权限和运行环境。入门建议用 Compute Engine VM,而不是一上来拆成多个托管服务。

  • 准备项目、gcloud、Artifact Registry,把镜像推到仓库。
  • 配置 VM 的 Docker/Compose、防火墙、.env 与服务账号。
  • 上传 docker-compose.yml,执行 docker compose up -d,用日志和公网 IP 验证。

详细步骤一:创建 VM 并放通端口

在 GCP 控制台打开 Compute Engine > VM 实例,点“创建实例”。名称用 compose-demo,区域选就近,机型 e2-micro,镜像 Ubuntu 22.04 LTS;防火墙勾选允许 HTTP/HTTPS,并保留 SSH,稍后装 Docker Compose。

  1. 到 VPC 网络 > 防火墙新建入站规则:来源 0.0.0.0/0,端口 tcp:80,443,8080,目标标记 compose-web。
  2. 编辑 VM,把网络标记设为 compose-web,保存,用 http://外部 IP 测试。

只放通端口,勿开 Docker 的 2375 管理端口。

详细步骤二:安装 Docker 与 Compose 插件

在 Google Cloud VM 的 SSH 中,以 Ubuntu 为例安装 Docker 和 Compose 插件;新命令是 docker compose。

sudo apt update && sudo apt install -y docker.io docker-compose-plugin
sudo systemctl enable --now docker
sudo usermod -aG docker $USER

重连 SSH 后再验证 docker -v、docker compose version。显示版本即可用 docker compose up -d 开始 deploy docker compose gcp。

详细步骤三:上传配置并 deploy

详细步骤三:上传配置并 deploy

在 Cloud Shell 选好 Google Cloud 项目,新手先确认 Compute Engine VM 已装 Docker Compose,并建好 ~/app。执行 gcloud compute scp docker-compose.yml .env VM:~/app/ –zone=ZONE 上传配置和 .env;密钥别进仓库。

再执行 gcloud compute ssh VM –zone=ZONE,进入 ~/app 运行 docker compose up -d。用 docker compose ps 看到 running,就完成 deploy docker compose gcp;访问失败先查防火墙、端口和日志。

验证结果

验证结果

部署后,在 GCP VM 的 SSH 窗口执行 docker compose ps 和 curl -I http://EXTERNAL_IP(把 EXTERNAL_IP 换成外部 IP),确认 Docker Compose 已启动。正常时,ps 显示各服务 STATE 为 Up、80 端口已映射;curl -I 返回 HTTP 200,浏览器访问外部 IP 能看到应用首页;docker compose logs –tail=20 无重启、连接拒绝或环境变量报错。若失败,检查防火墙放行 TCP 80、Compose 文件 ports 映射和日志,再运行 docker compose up -d。出现以上结果,即表示镜像已按 Compose 编排在 GCP 成功运行,新手也可确认部署完成。

常见坑与解决办法

常见坑与解决办法

  • Cloud Run 不直接读 docker-compose.yml;初学可用 Compute Engine 装 Docker 与 Compose 插件,或把服务拆开部署。
  • 页面打不开:检查 VPC 防火墙放行 80/443,并让容器监听 0.0.0.0。
  • 重启丢数据:Compose 本机卷不持久,数据库用 Cloud SQL,文件用 Cloud Storage 或持久盘。
  • 拉镜像失败:核对 Artifact Registry 区域、名称、权限,并运行 gcloud auth configure-docker命令;密钥放 Secret Manager,排错先看云日志。

常见问题(FAQ)

一定要用 Cloud Shell 吗,本地终端行不行?

行,装好 gcloud 并登录即可;Cloud Shell 只是免安装,对小白更省事。

docker compose 和 docker-compose 有什么区别?

新版是插件写法 docker compose(中间空格),带横杠的老命令已弃用,本文统一用新版。

跟着做会不会产生很多费用?

e2-micro 在免费额度内基本不花钱,用完记得停实例并开结算告警。

能不能不建虚拟机直接 deploy 到 gcp?

可以,但得改 Cloud Run 单容器或 GKE,compose 原样搬过去不生效,建议先跑通本文。

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

查看代维服务 →

发表评论