它是什么:把容器变成可访问服务
使用 GCP Cloud Run 时,可以先把容器想成打包好的程序:代码、环境、依赖都在一起。Cloud Run 是 GCP 的托管运行服务:上传容器镜像后,即可获得一个可访问的 https 网址。浏览器、前端、小程序访问这个网址,就是访问你的服务。
它属于「无服务器」思路:不是没有服务器,而是服务器由 Google 管。你不用自己创建 VM、安装系统、配置网页服务器,也不用经常通过 SSH 登录维护。访问多时自动多开实例,没人访问时可缩到 0,所以适合网站接口、轻量应用和需要自动扩缩容的服务。
零基础体验不用写 Dockerfile,也不用本地装 Docker。打开 GCP 控制台右上角 Cloud Shell,确认顶部已选中项目并开通结算;下面命令可直接复制执行,用 Google 官方示例镜像:
REGION=asia-east1
gcloud config set run/region "$REGION"
gcloud services enable run.googleapis.com artifactregistry.googleapis.com cloudbuild.googleapis.com
gcloud run deploy hello-run --image us-docker.pkg.dev/cloudrun/container/hello --platform managed --region "$REGION" --allow-unauthenticated --quiet
gcloud run services describe hello-run --platform managed --region "$REGION" --format='value(status.url)'
为什么这么做:新项目常没开相关 API;–allow-unauthenticated 让浏览器能直接打开;最后一条只打印网址。看到 https://…run.app 能打开,就说明容器变成服务。以后换成自己的程序,把镜像推到 Artifact Registry,再替换 --image 后的地址即可。
- 坑:Cloud Shell 没显示项目名时,先在左上角选项目,否则 gcloud 不知道部署到哪里。
- 坑:自己的容器要监听环境变量
PORT,别写死 80 或只听 127.0.0.1;线上 502 多半是这里。 - 坑:容器内文件是临时的,上传图片、数据、密钥别只放本地,用 Cloud Storage、数据库或 Secret Manager。
- 坑:–allow-unauthenticated 会公开访问,演示方便,但别放后台管理或未鉴权写接口。
解决什么问题:少管服务器,专注代码
对小白来说,使用 GCP Cloud Run 最直观的价值,就是少管服务器、专注代码:不用先买机器、装系统、打补丁、配端口,也不用半夜手动做扩容。你准备好容器镜像或代码,平台负责运行它的机器、系统更新、入口转发和实例调度;所以不必先学 SSH、Nginx、防火墙,也不用为了一个访问量不大的小网站长期养着一台虚拟机。
第一次跟着做,先在 Google Cloud 控制台创建项目、开通结算,再点右上角 Cloud Shell;它已经登录并带好当前项目,下面命令不用改项目 ID。坑在于:别在普通终端直接复制,没选到已开通结算的项目时,启用 API 或部署会报权限、账单错误。
gcloud config set project "$GOOGLE_CLOUD_PROJECT"
gcloud services enable run.googleapis.com logging.googleapis.com monitoring.googleapis.com
export REGION="asia-east1"
gcloud run deploy hello-run --image=gcr.io/cloudrun/hello --region="$REGION" --platform=managed --allow-unauthenticated --min-instances=0 --max-instances=10 --quiet
gcloud run services describe hello-run --region="$REGION" --format='value(status.url)'
复制最后输出的网址到浏览器打开。这里用官方 hello 镜像,是为了先跑通全托管流程;–allow-unauthenticated 表示公开访问,练习方便,生产别随便开。自己写容器时常见坑是只监听 80 或写死本地端口:Cloud Run 会把请求转给容器里的 PORT,程序要监听这个端口,官方镜像已经处理好了。
命令里的 –min-instances=0 表示没人访问时通常缩到零,减少闲置资源;–max-instances=10 表示流量高时由平台自动扩容,减少临时加机器的应急操作。缩到零后第一次访问可能有冷启动,稍微慢一点不是宕机;常驻后台进程也不适合直接照搬。
上线后排障也不用登录服务器翻文件。先访问几次网址,再复制下面整段:它会看日志,用时间戳制造一个新版本,再回滚到上一版。Cloud Run 页面还能看请求数、错误率、延迟和实例数,不用自己装监控代理。
gcloud config set project "$GOOGLE_CLOUD_PROJECT"
export REGION="asia-east1"
gcloud run services logs read hello-run --region="$REGION" --limit=20
export TAG="$(date +%s)"
gcloud run deploy hello-run --image=gcr.io/cloudrun/hello --region="$REGION" --platform=managed --allow-unauthenticated --set-env-vars="VERSION=$TAG" --min-instances=0 --max-instances=10 --quiet
export REVISION="$(gcloud run revisions list --service hello-run --region="$REGION" --sort-by='~metadata.creationTimestamp' --format='value(metadata.name)' | sed -n '2p')"
gcloud run services update-traffic hello-run --region="$REGION" --to-revisions="$REVISION=100" --quiet
为什么这么做:日志、指标和版本都在平台侧,定位时先看“哪次版本、哪类错误、实例有没有被拉起”,再决定回滚,比登录服务器猜配置快得多。容易踩的坑是只有一个修订版本时没有“上一版”可回;回滚只切流量,不会删除坏版本,方便继续对比排查。
怎么上手:从本地代码到线上网址
使用 GCP Cloud Run,先准备一个“有人访问就返回内容”的程序。平台用 PORT 告诉容器该听哪个端口,所以代码要监听 0.0.0.0 和 process.env.PORT。下面用源码;已有容器镜像也行,控制台选“容器镜像 URL”即可。小坑:只听 127.0.0.1、把 8080 写死、不返回响应,线上会超时。
mkdir -p hello-cloud-run && cd hello-cloud-run
cat > package.json <<'EOF'
{"scripts":{"start":"node server.js"}}
EOF
cat > server.js <<'EOF'
const http = require('http');
const port = process.env.PORT || 8080;
http.createServer((req, res) => {
res.writeHead(200, {'Content-Type': 'text/plain; charset=utf-8'});
res.end('你好,Cloud Run!n');
}).listen(port, '0.0.0.0', () => console.log(`Listening on ${port}`));
EOF
本机装了 Node.js 可先跑,浏览器打开 http://localhost:8080 看到欢迎语后按 Ctrl+C;没装也不影响,云端会按 package.json 启动。
npm start
接着到官网按系统安装 gcloud CLI,macOS 也可用 Homebrew。下面都在同一个终端执行:检查版本、浏览器登录、选默认项目,再启用 Cloud Run、Cloud Build、Artifact Registry。项目要先在控制台新建并开通结算,否则启用服务会失败;小坑:选错项目会部署到别处,区域选
与替代方案对比:别一上来就买 VM
新手一听说「上线」,常先去开一台 Compute Engine(VM):装系统、配 Nginx、打补丁、盯磁盘。先停一下。使用 GCP Cloud Run 时你只交一个容器镜像,机器、扩缩容、系统补丁都由平台管,没流量还能缩到 0,不用半夜重启服务。所以别急着买 VM,先点控制台右上角的 Cloud Shell(它已经替你登录并选好项目),粘贴这两行:
gcloud services enable run.googleapis.com
gcloud run deploy hello --image us-docker.pkg.dev/cloudrun/container/hello --region asia-east1 --allow-unauthenticated
为什么这么做:第一行只是首次启用 API,第二行拉官方示例镜像直接跑,终端最后会打印一个 https 网址,点开看到页面就算部署成功,全程没建虚拟机。小白常踩的坑:带 –allow-unauthenticated 等于把服务公开到公网,练完务必删掉,别让它一直挂着:
gcloud run services delete hello --region asia-east1 --quiet
- 和 VM 比:省运维最明显;但它不适合长期后台进程(常驻爬虫、systemd 守护)、固定内核参数(sysctl)、装内核模块或要 root 特权的场景。实例是「来请求才干活」,请求跑完可能被回收,别把数据只存内存或本地磁盘,要写 Cloud Storage 或数据库。
- 和 GKE 比:不用先学节点池、YAML、Ingress,几分钟就能上手;代价是集群网络、自定义调度、服务网格这类复杂微服务治理能力少。也别为了「以后也许用得上」先建 GKE:空集群照样计费、照样要升级。
- 和 Cloud Functions 比:使用 GCP Cloud Run 更适合完整容器和自定义运行环境:自带系统库、指定运行时版本、一个服务挂多个接口都行;函数服务更偏「收到一条消息就跑几行」的短小事件触发逻辑。只有几行 webhook 还硬写 Dockerfile,是给自己加活。
- 和传统虚拟主机比:弹性强,流量涨了自动加实例,不用提前买配置;但三件事要重新理解:排障不 SSH 进机器,而是去 Cloud Logging 看日志;计费按请求加 CPU/内存占用时间,不是包月一台机;部署每次生成新 Revision,传的是镜像,不是 FTP 传文件。
所以找不到「那台服务器的 IP」是正常的,不是坏了。先把项目当成请求型 Web 服务试一轮,确认真的需要常驻进程或改内核,再回头买 VM 也不迟。
最佳实践:新手也能少踩坑
先收好密钥和权限。使用 GCP Cloud Run 时,密码、API Key 不要写进代码、Dockerfile 或镜像;.env 也不保险,Git 历史、镜像层、构建日志会留痕。把密钥放进密钥管理服务 Secret Manager,再建最小权限的服务账号,只授权读这一个密钥,别给 Owner 或 Editor,权限大了泄露面也大。先在 Cloud Shell 选好项目,复制执行:
PROJECT_ID="$(gcloud config get-value project)"
REGION="asia-east1"
SERVICE="hello-run"
SA_NAME="run-minimal-sa"
SECRET_NAME="db-password"
IMAGE="us-docker.pkg.dev/cloudrun/container/hello"
SA_EMAIL="$SA_NAME@$PROJECT_ID.iam.gserviceaccount.com"
gcloud services enable run.googleapis.com secretmanager.googleapis.com iam.googleapis.com logging.googleapis.com monitoring.googleapis.com
gcloud iam service-accounts describe "$SA_EMAIL" >/dev/null 2>/dev/null || gcloud iam service-accounts create "$SA_NAME" --display-name="Cloud Run minimal SA"
gcloud secrets describe "$SECRET_NAME" >/dev/null 2>/dev/null || gcloud secrets create "$SECRET_NAME" --replication-policy="automatic"
openssl rand -base64 24 | tr -d 'n' | gcloud secrets versions add "$SECRET_NAME" --data-file=-
gcloud secrets add-iam-policy-binding "$SECRET_NAME" --member="serviceAccount:$SA_EMAIL" --role="roles/secretmanager.secretAccessor"
gcloud run deploy "$SERVICE" --image="$IMAGE" --region="$REGION" --service-account="$SA_EMAIL" --set-secrets="DB_PASSWORD=$SECRET_NAME:latest" --set-env-vars="APP_ENV=prod" --concurrency=80 --timeout=60s --memory=512Mi --min-instances=0 --revision-suffix="v$(date +%Y%m%d%H%M%S)-$RANDOM" --no-traffic
gcloud run services update-traffic "$SERVICE" --region="$REGION" --to-latest
容量够用就好。命令里设置了合理的并发、超时、内存和最小实例:80 并发、60 秒超时、512Mi 内存、0 个最小实例,兼顾冷启动、稳定性与费用。并发太高抢 CPU,内存太大只多花钱,最小实例设 1 少冷启动但一直计费。小白常犯的错是“全拉满”,账单先爆。
测试和生产别混。用环境变量区分测试与生产:APP_ENV 设 test 或 prod,代码按变量选数据库。Cloud Run 每次部署会生成 revision,revision-suffix 留版本名,no-traffic 先不接客再切到 latest,等于发布前保留版本。线上报错别边改边刷新,记住出问题先回滚再排查。下面命令列出版本、回滚并看错误日志:
REGION="asia-east1"
SERVICE="hello-run"
gcloud run revisions list --service "$SERVICE" --region "$REGION" --sort-by='~metadata.creationTimestamp' --format='table(metadata.name, metadata.creationTimestamp)'
PREVIOUS_REVISION="$(gcloud run revisions list --service "$SERVICE" --region "$REGION" --sort-by='~metadata.creationTimestamp' --format='value(metadata.name)' | sed -n '2p')"
if [ -n "$PREVIOUS_REVISION" ]; then gcloud run services update-traffic "$SERVICE" --region "$REGION" --to-revisions "$PREVIOUS_REVISION=100"; fi
gcloud logging read 'resource.type="cloud_run_revision" AND severity>=ERROR' --limit=20 --freshness=1d
最后开启日志、监控和预算提醒。命令已启用日志和监控 API;Cloud Run 默认记录 stdout/stderr、请求数、错误率和延迟。再到控制台「结算 > 预算和提醒」设 50%、80%、100% 邮件提醒。每周定期查看请求错误、延迟和账单变化,重点看 5xx、P95 延迟和账单趋势;能打开不等于没问题,最小实例和忘记关的测试服务都会让账单变化。
常见问题(FAQ)
不会写容器构建文件能用 Cloud Run 吗?
可以,先从源码部署开始,平台会自动完成构建,之后再学镜像。
Cloud Run 必须绑定自己的域名吗?
不是,默认会提供访问网址,正式站点再绑定自定义域名。
空闲时会不会一直收费?
按请求和资源配置计费,缩到零时通常不持续收取计算费用。
适合直接放数据库吗?
不建议,数据库应搭配托管服务,Cloud Run 更适合无状态应用。
不想自己折腾 GCP?我们提供云平台代维护、上云迁移与账单代付服务,一对一技术支持。
