它是什么
在 Google Cloud 入门文章里,docker compose example 指一份可运行的 Compose 示例:一个 docker-compose.yml 和几条命令。Compose 不是云服务,也不是虚拟机;它用 YAML 描述多个容器,让 Web、数据库等“服务”一起启动。
services列出服务;image选镜像;ports映射端口。environment传变量;volumes保存数据;depends_on只表示启动顺序。
services:
web:
image: nginx:alpine
ports: ["8080:80"]
db:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: example
保存后,在装有 Docker 的 Cloud Shell 或本机运行 docker compose up -d,访问 8080;用 docker compose down 停止。它适合本地开发和演示。到 Google Cloud 后,镜像可放 Artifact Registry,部署可选 Cloud Run、GKE 或 Compute Engine;Compose 是理解服务与端口的蓝图,不是生产配置。
解决什么问题
解决什么问题
初学者在 Google Cloud 上看 docker compose example,难点常不是做镜像,而是 Web、API、数据库、缓存要一起跑。逐条写 docker run 时,端口、环境变量、服务名、数据卷和启动顺序都靠手工维护,换电脑或交给同事就容易变成“在我机器上能跑”。Compose 用一份 compose.yaml 声明依赖,让本地环境更接近云端架构。
执行 docker compose up 后,它会创建默认网络、按服务名解析 db、集中显示日志,并用一条命令启动或停止整套应用。比如 web 通过 db:5432 连接数据库,不必记容器 IP。部署到 Cloud Run、GKE 或 Compute Engine 前,你可以先验证配置、接口和连接,减少把本地错误带到云端再排查。
- 解决重复命令:一次定义,多人复用,结果更一致。
- 解决环境漂移:依赖、端口和变量写进文件,不再靠记忆。
- 明确边界:Compose 适合本机开发和演示,不是 Kubernetes,也不负责生产级扩缩容和高可用。
因此,本节不是让你背参数,而是理解 Compose 为什么存在:它把零散容器命令变成可复现示例,为后续 Google Cloud 部署打基础。
怎么上手
第一次在 Google Cloud 上接触 docker compose example,可以先把 Compose 想成一份“用 YAML 描述多个容器”的清单:它负责拉镜像、建网络、挂目录和启动服务。新手不必一上来就做集群或 CI,只要在一台小型 Compute Engine 虚拟机上跑通 Nginx + Redis,就能理解服务名、端口映射和数据卷分别解决什么问题。建议按顺序做。
如果只想看结构,也可以先跳过云资源,把同一份 YAML 放在本地 Docker Desktop 运行;命令完全一致,差别只是浏览器地址换成 localhost。等熟悉后再回到 Google Cloud,关注防火墙、外部 IP 和计费即可。
准备与运行
-
打开 Cloud Shell,创建 Debian 虚拟机,并放行 8080 端口。区域、机型可以按免费额度或配额调整;防火墙规则用标签绑定,后面清理也更清楚。
gcloud compute instances create compose-demo --zone=asia-east1-b --machine-type=e2-micro --image-family=debian-12 --image-project=debian-cloud --tags=compose-8080 gcloud compute firewall-rules create allow-compose-8080 --allow=tcp:8080 --target-tags=compose-8080 -
SSH 登录后安装 Docker 和 Compose 插件,准备一个最简单的网页文件。第一次加入 docker 用户组后,重新连接或执行
newgrp docker,当前终端才会获得权限。gcloud compute ssh compose-demo --zone=asia-east1-b sudo apt-get update sudo apt-get install -y docker.io docker-compose-plugin sudo usermod -aG docker $USER newgrp docker mkdir -p ~/compose-demo/site printf 'Hello Docker Compose on Google Cloud' > ~/compose-demo/site/index.html cd ~/compose-demo -
用
nano docker-compose.yml新建文件并粘贴示例。web把容器 80 端口映射到虚拟机 8080,./site作为只读网页目录;cache只启动 Redis,用来演示同一 Compose 网络里的第二个服务。services: web: image: nginx:alpine ports: - "8080:80" volumes: - ./site:/usr/share/nginx/html:ro cache: image: redis:7-alpine -
在文件所在目录执行
docker compose up -d,再用docker compose ps查看两个服务是否为 Up。虚拟机内可用curl http://localhost:8080自测;本机浏览器打开http://外部IP:8080,看到欢迎文字就说明这个 docker compose example 已经跑通。 -
练习结束先执行
docker compose down,再删除防火墙规则和虚拟机,避免持续计费。下一步可以把web换成自己的应用镜像,逐步加入环境变量、健康检查,以及由 Cloud SQL 或 Secret Manager 管理的配置。
常见小问题
-
页面打不开时,依次检查实例外部 IP、防火墙规则、
docker compose logs web和端口是否写成 8080。 -
提示 permission denied 时,确认已重新 SSH 登录;仍失败可临时在命令前加
sudo。 -
别把密码、密钥写进 YAML 并提交仓库;本地实验可用
.env,上云后再换成更安全的配置方式。
与替代方案对比
与替代方案对比
对 Google Cloud 初学者来说,docker compose example 的价值是把 Web、数据库、缓存等服务的镜像、端口和变量写进 docker-compose.yml,再用 docker compose up 一次启动。它常跑在本地电脑或一台 Compute Engine 虚拟机上,适合教程、演示和单机验证。
docker run:启动单个容器很直接,但服务变多后命令冗长,网络和启动顺序容易出错;Compose 用一份文件描述多个服务,更好读。- Cloud Run:由 Google Cloud 托管,自动扩缩容、按请求计费,适合无状态 Web 应用;但它不直接执行完整 Compose 文件,数据库和 Redis 通常改用 Cloud SQL、Memorystore。
- GKE/Kubernetes:支持副本、滚动升级和复杂编排,能力更强,学习成本也更高。可先用 Compose 理解服务关系,再迁移到 Kubernetes 清单。
- 手动装软件:控制力强,却难复现环境;Compose 配置可放进版本库,换机器也能快速重建。
选择时先问规模:学习和小项目用 Compose;要公网访问又不想管服务器,选 Cloud Run;需要集群和弹性伸缩,再考虑 GKE。先跑通示例,再逐步迁移,通常最稳妥。
最佳实践
最佳实践
把 docker-compose.yml 当作应用说明:固定镜像标签,写清端口、依赖和版本,并随代码提交。初学者先用 docker compose up -d 跑通 docker compose example,再用 docker compose config 检查语法;部署到 Google Cloud 时,通过 Cloud Build 推送到 Artifact Registry,再部署到 Cloud Run 或 GKE,别在虚拟机里手工改配置。
services:
web:
image: REGION-docker.pkg.dev/PROJECT/REPO/web:1.0.0
env_file: .env
密钥不要写进 Compose 文件或镜像:本地用不提交的 .env,云端改用 Secret Manager,并用最小权限服务账号读取。状态数据交给 Cloud SQL、Cloud Storage 或命名卷,容器保持无状态、可重建。
- 设置
restart、healthcheck和 CPU、内存限制,避免单容器拖垮整机。 - 日志输出到标准输出,由 Cloud Logging 收集;统一镜像、环境和版本命名,方便回滚。
- 先在测试项目小流量验证,定期更新镜像并扫描漏洞;流量增长后迁移到托管服务,别把单机 Compose 当成生产编排。
常见问题(FAQ)
Cloud Run 能直接运行 docker compose example 吗?
不能直接运行;Cloud Run 通常按服务部署镜像,多容器需拆分或用 sidecar。
新手在 GCP 上最简单的落地方式是什么?
入门可用 Compute Engine 跑 Compose;生产再评估 Cloud Run 或 GKE。
数据库和密钥应该写进 compose.yaml 吗?
不要;用 Secret Manager 管密钥,用 Cloud SQL 或 Memorystore 托管数据。
docker compose example 适合生产环境吗?
适合原型和小型服务;生产需补监控、备份、扩缩容与高可用。
不想自己折腾 GCP?我们提供云平台代维护、上云迁移与账单代付服务,一对一技术支持。
