开始前你需要准备
准备一个可用的 GCP 账号:有权限用浏览器登录控制台,并进入已启用结算功能的项目。Cloud Run 有免费额度,但没启用结算通常不能部署;坑是账号不是项目成员,或误选旧项目。
装好 gcloud 后复制执行。初始化命令会让你登录并选项目,别一路回车;区域设为 asia-east1,最后确认输出里的当前项目和区域,资源才不会建错位置。
gcloud init
gcloud config set run/region asia-east1
gcloud config list
再准备能本地运行的最小网页项目:首页返回“你好,云端运行”;放 Dockerfile,或保留支持自动构建的代码。先本地跑通,少踩云端起不来的坑。
记住:容器镜像是打包盒,服务是盒子跑起来后的应用,访问网址是部署后给的 HTTPS 地址;不用先懂服务器或 SSH。
整体思路
先忘掉买服务器、装系统、配 Nginx。google cloud run 部署 不用自己维护 Linux 服务器,只记四步:代码、镜像、服务配置、验证。
把应用代码打包成容器镜像,交给 GCP 托管运行。为什么?本机跑得通,换台机器常因缺依赖崩掉;镜像把代码和环境一起封好,到哪都一样。在根目录直接复制:
export PROJECT_ID=$(gcloud config get-value project)
gcloud builds submit --tag gcr.io/$PROJECT_ID/hello-run
坑:先跑过 gcloud init,目录里也要有 Dockerfile,否则取不到项目 ID 或构建失败。
再用 gcloud 或控制台创建 google cloud run 部署,平台会自动生成可访问网址:
gcloud run deploy hello-run
--image gcr.io/$PROJECT_ID/hello-run
--region asia-east1
--port 8080
--set-env-vars NODE_ENV=production
--allow-unauthenticated
用环境变量放配置(别把密码写进代码)、端口对齐代码监听值、权限决定谁能进;按访问量自动扩缩容,没人用就缩到 0,不白花钱。坑:代码听 3000 却填 8080 会一直启动失败;漏了公开权限,打开网址就是 403。
最后验证,取网址贴进浏览器,看到页面就通了:
gcloud run services describe hello-run --region asia-east1 --format='value(status.url)'
以后改代码,重跑前两条命令即可。
详细步骤一:准备项目与代码
先建一个最小项目,照着复制就行;后面所有 google cloud run 部署都围绕它。入口文件放项目根目录,监听 Cloud Run 注入的 PORT 环境变量,本地没有它才用 8080,并绑定 0.0.0.0。原因是容器外要访问服务;写死 3000 或只听 127.0.0.1,常会“部署成功但访问超时”。
mkdir cloudrun-demo; cd cloudrun-demo
echo '{"scripts":{"start":"node server.js"}}' > package.json
echo "const port = process.env.PORT || 8080; require('http').createServer((req,res)=>res.end('Hello Cloud Run')).listen(port,'0.0.0.0');" > server.js
printf '%sn' 'FROM node:20-slim' 'WORKDIR /app' 'COPY package*.json ./' 'RUN npm install --omit=dev' 'COPY . .' 'CMD ["npm","start"]' > Dockerfile
npm install
npm start
Dockerfile 已把依赖安装和启动命令写清楚,打包规则不靠猜;以后加依赖要写进 package.json。没有 Dockerfile 时,后面可在控制台用源码自动构建,但正式项目建议保留它。上面最后会启动本地服务:浏览器打开 http://localhost:8080,看到 Hello Cloud Run 再按 Ctrl+C。先确认首页,能避免把代码问题误判成部署问题。
最后开好云端开关。第一条命令会引导登录并选项目,务必看清项目名;随后启用 Artifact Registry(镜像仓库)、Cloud Build(构建服务)和 Cloud Run 接口,并给当前账号绑定必要角色。
gcloud init
gcloud services enable artifactregistry.googleapis.com cloudbuild.googleapis.com run.googleapis.com
PROJECT_ID="$(gcloud config get-value project)"
ACCOUNT="$(gcloud config get-value account)"
case "$ACCOUNT" in
*gserviceaccount.com) MEMBER="serviceAccount:$ACCOUNT" ;;
*) MEMBER="user:$ACCOUNT" ;;
esac
for ROLE in roles/serviceusage.serviceUsageAdmin roles/run.admin roles/artifactregistry.admin roles/cloudbuild.builds.editor roles/iam.serviceAccountUser; do
gcloud projects add-iam-policy-binding "$PROJECT_ID" --member="$MEMBER" --role="$ROLE"
done
常见坑:首次项目接口没开会报 service not found;账号权限不足会报 permission denied。若开通或绑定失败,把这段交给项目所有者执行,别反复点部署。
详细步骤二:构建镜像并部署
先在项目根目录打开 Cloud Shell,确认有源码或 Dockerfile;新手常见失败是停在空目录、没开结算或权限不够,或初始化时选错项目。下面整段复制执行,按提示登录并选择刚创建的项目即可。初始化会写入默认项目,后面不会跑到别的账号或项目里。
gcloud init
gcloud config set run/region asia-east1
gcloud services enable run.googleapis.com cloudbuild.googleapis.com artifactregistry.googleapis.com
gcloud run deploy hello-run --source . --region asia-east1 --platform managed --allow-unauthenticated --max-instances 2
这里用 gcloud 设置项目和区域。asia-east1 离多数中文用户较近,能减少访问延迟;用户在欧美可换成更近区域。hello-run 是服务名称,区域也写成 asia-east1。CPU 和内存首次部署保持默认值,别急着调大,配置项越少越不容易出错。
这条 google cloud run 部署命令会让 GCP 从源码自动构建镜像、推送到镜像仓库并发布。发布时命令里选托管版,最大实例数先限为 2,流量变大再按需调高,避免配置过高或异常访问产生额外费用。注意:换区域通常要重新部署;公开访问方便测试,内部系统记得关闭。
详细步骤三:配置访问与环境变量
这一步只改“配置”,不用重新打包代码。先把常用值放进终端变量;如果上一节的服务名或区域不是 hello-run、asia-east1,只改这两行,其余照抄。
export PROJECT_ID="$(gcloud config get-value project)"
export REGION="asia-east1"
export SERVICE="hello-run"
export SA="run-app@${PROJECT_ID}.iam.gserviceaccount.com"
export USER_EMAIL="$(gcloud config get-value account)"
验证结果
下面沿用前文服务名 hello-run、区域 asia-east1 和页面文件 index.html,照抄即可;改过其中任意一个却忘了同步,是找不到服务或改不到页面的常见原因。先回到项目目录。
-
部署完成后,复制控制台给出的网址,用浏览器打开;看到 Hello Cloud Run 或预期页面即成功。别复制项目 ID、日志链接;出现 403,多半是没允许未登录访问。
-
再用 gcloud 看服务状态、最新修订版本和日志,因为页面能开不代表后台没重启。重点确认没有启动失败:Ready 为 True、latestReadyRevisionName 有值,日志里没有 Container failed to start 或 ERROR。
gcloud run services describe hello-run --region asia-east1 gcloud logging read 'resource.type="cloud_run_revision" AND resource.labels.service_name="hello-run"' --limit 30 --freshness=10m -
把网址刷新几次,用下面命令观察请求日志和实例扩缩容。刷新是为了产生真实请求:看到 200、不同 instanceId,说明实例被拉起;控制台实例数曲线空闲后会回落。这就是按请求计费的基本效果:有请求才处理,空闲通常不占实例。最小实例设成 1、日志延迟几十秒都正常,按请求计费也不等于全免。别一直狂刷,几条就够。
gcloud logging read 'resource.type="cloud_run_revision" AND resource.labels.service_name="hello-run" AND logName:"requests"' --limit 20 --freshness=10m -
最后修改一行文字并重新部署。打开同一个网址看到 Hello Cloud Run v2,且 describe 里 traffic 的 percent 为 100、revisionName 是新修订,就说明新版本能接管访问流量。若仍是旧字,先用无痕窗口排缓存,再查是否加过 –no-traffic 或手动分流。macOS 本地 sed 写法不同,建议用 Cloud Shell。
sed -i 's/Hello Cloud Run/Hello Cloud Run v2/' index.html gcloud run deploy hello-run --source . --region asia-east1 --allow-unauthenticated gcloud run services describe hello-run --region asia-east1
常见坑与解决办法
做 google cloud run 部署,先别重装,也先确认右上角项目选对;命令作用在当前项目,这是小白常忽略的坑。下面按示例 gcpok-demo、asia-east1 写,照示例命名可直接复制;名字不同只改这两处。
- 页面打不开先查端口。服务必须监听环境变量 PORT,常见为 8080;Cloud Run 只往这个端口转发请求。代码要读它并绑 0.0.0.0;写死 3000 或只听 127.0.0.1,就会本机好、线上超时。只改控制台端口没用,应用没监听照样失败。
- 镜像构建失败先看日志。本地能跑不代表 Docker 路径一样,依赖文件路径、启动命令、Dockerfile 的 COPY/CMD 写错最常错;按第一条红字修,别从末尾猜。最近一条构建也可能不是这次,先对时间。
- 403 或 401 查身份验证和 IAM。公开访问没开、账号没 Invoker 都会被拦;401 多是令牌错,403 是没权限,别乱给 Owner。接口若要登录,别强行公开,应给调用账号授权。
- 费用异常先限流再清理。看最大实例数、区域、请求量、日志保留;爬虫和实例上限大会拉高账单,区域远、日志留久也花钱。测试完及时删测试服务,别只删镜像。
- 控制台显示成功但页面旧。先无痕或强刷排浏览器缓存,再检查流量分配;成功只代表新修订版本就绪,旧修订版本仍可能分流。把 100% 流量切到最新再复测。
gcloud builds list --limit=5
gcloud builds log "$(gcloud builds list --limit=1 --format='value(id)')"
gcloud run services add-iam-policy-binding gcpok-demo --region=asia-east1 --member="allUsers" --role="roles/run.invoker"
gcloud run services update gcpok-demo --region=asia-east1 --max-instances=1
gcloud run services delete gcpok-demo --region=asia-east1 --quiet
gcloud run services describe gcpok-demo --region=asia-east1 --format="value(spec.traffic)"
gcloud run services update-traffic gcpok-demo --region=asia-east1 --to-latest
删除不可撤销;确认是测试服务再单独执行,最好最后跑。
常见问题(FAQ)
不会 Linux 也能完成 google cloud run 部署吗?
可以。按向导或 gcloud 操作即可,不用自己维护 VM 和 SSH。
一定要写 Dockerfile 吗?
不一定。可用控制台从源码自动构建,复杂项目建议自己写。
部署后为什么提示权限不足?
检查是否允许公开访问,以及账号是否具备 Cloud Run 和 IAM 权限。
测试完怎样避免继续扣费?
删除测试服务、镜像和日志资源,并确认结算账单无异常。
可以用自己的域名访问吗?
可以。验证默认网址成功后,再绑定域名并等待证书生效。
不想自己折腾 GCP?我们提供云平台代维护、上云迁移与账单代付服务,一对一技术支持。
