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

docker compose example 上云实战

TL;DR:用 docker compose example 串起本地多容器、镜像推送与 Google Cloud 部署路径,帮新手理解边界、上手步骤和运维避坑。

它是什么

在 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 和计费即可。

准备与运行

  1. 打开 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
  2. 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
  3. 用 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
  4. 在文件所在目录执行 docker compose up -d,再用 docker compose ps 查看两个服务是否为 Up。虚拟机内可用 curl http://localhost:8080 自测;本机浏览器打开 http://外部IP:8080,看到欢迎文字就说明这个 docker compose example 已经跑通。

  5. 练习结束先执行 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?我们提供云平台代维护、上云迁移与账单代付服务,一对一技术支持。

查看代维服务 →

发表评论