开始前你需要准备
先准备一个能登录控制台的 GCP 项目,确认已开通结算,并记下「项目编号」和「区域」。Cloud Run 有免费额度,但仍要绑结算,否则 cloud run 部署 会失败。别只记项目名,编号才唯一;区域建议选 asia-east1,后面都用同一个,换区域会以为服务丢了。
再安装 Google Cloud SDK(里面带 gcloud),官网按系统下载、默认安装,装完重开终端。它是和 GCP 对话的遥控器;下面几行用来登录、初始化并看当前配置。浏览器弹出时选项目对应账号,别用错个人邮箱。
gcloud --version
gcloud auth login
gcloud init
gcloud config list
初始化后执行下面几行:列表看 PROJECT_NUMBER,结算看到 billingEnabled: true 才通过,区域从输出里挑一个记下;提前启用服务,免得部署时弹「API 未启用」。
gcloud projects list
gcloud beta billing projects describe $(gcloud config get-value project)
gcloud services enable run.googleapis.com cloudbuild.googleapis.com artifactregistry.googleapis.com logging.googleapis.com
gcloud projects get-iam-policy $(gcloud config get-value project) --flatten="bindings[].members" --format="table(bindings.role,bindings.members)"
gcloud run regions list
权限别漏:当前账号至少要有 Cloud Run Admin 和 Logs Viewer;公司项目请管理员加,自己项目通常是 Owner。只给浏览权限,会报 permission denied,或日志页空白。
最后二选一:准备最简单的网页示例代码,或已有可运行容器镜像。代码要启动 HTTP 服务并监听 PORT,普通 index.html 不能直接跑。新手建议先用官方示例镜像 us-docker.pkg.dev/cloudrun/container/hello,记下完整地址,先跑通再换自己的,少踩 Dockerfile 的坑。
整体思路
先记住一句话:cloud run 部署不是租服务器,也不是上传压缩包,而是把打包好的容器镜像交给 GCP 托管。镜像里放代码、运行环境和启动命令;平台负责拉起容器、自动生成可访问的 HTTPS 服务地址,并按访问量扩缩容,所以最后会拿到一个能直接打开的网址。
- 准备代码和 Dockerfile;
- 构建镜像、推送镜像到仓库;
- 创建服务,设置端口和访问权限;
- 打开地址验证页面或接口。
下面命令在 Cloud Shell 里整块复制即可:先登录选项目、开启 API,再由 Cloud Build 构建并推送,最后交给 Cloud Run 部署并打印地址,打印地址就是验证入口。$P 会自动取当前项目,少手填、少填错。
gcloud init
gcloud services enable run.googleapis.com cloudbuild.googleapis.com
P=$(gcloud config get-value project); gcloud builds submit --tag gcr.io/$P/app
gcloud run deploy app --image gcr.io/$P/app --region asia-east1 --port 8080 --allow-unauthenticated --format='value(status.url)'
为什么要这么做?因为不用自己维护 VM、打系统补丁、配负载均衡,也不用手动配置 SSH,平台都包了,特别适合小白快速上线轻量网站或接口。小白常见坑:当前目录必须有 Dockerfile;服务名 app 前后要一致;程序要监听 0.0.0.0:8080,别只听 127.0.0.1;--allow-unauthenticated 表示公开访问,后台接口别乱开;新项目要启用结算,命令别拆到不同终端,否则 $P 可能为空;把输出网址粘到浏览器,看到页面或接口返回才算验证完成。
详细步骤一:准备项目与代码
登录 GCP 控制台,先去「API 和服务」把 Cloud Run、Artifact Registry(镜像仓库)和 Cloud Build(构建服务)启用。为啥?默认全关着,不开后面直接报没权限。顺便选个离用户近的区域,比如 asia-east1,访问快还省钱。
接着打开终端,用 gcloud 把项目和区域「锁死」,直接复制(记得换成真实项目 ID):
gcloud config set project 你的项目ID
gcloud config set run/region asia-east1
这步最关键!不提前设好,命令很容易偷偷把资源建到默认美国区,不仅慢,回头想删都找不着,新手最常踩这坑。
最后看一眼代码。Cloud Run 启动时会塞个叫 PORT 的环境变量,程序必须监听它(如 process.env.PORT);懒得改就先按 8080 配。千万别写死 3000 或 80,否则平台敲门没人应,容器会一直报「启动失败」并疯狂重启。
详细步骤二:构建镜像并部署
先确认根目录有 Dockerfile(首字母大写、无后缀)。下面命令在同一个终端窗口复制执行,别关窗口:export 的变量只在当前窗口有效;若 echo 出的项目号为空,说明还没选好项目,回上一步设置项目 ID 再回来,不然后面 push 会报 denied。
export PROJECT_ID=$(gcloud config get-value project)
export REGION=asia-east1
export SERVICE=hello-web
export TAG=v1
export IMAGE=gcr.io/$PROJECT_ID/hello-web:$TAG
echo "项目号=$PROJECT_ID"
gcloud auth configure-docker --quiet
docker build -f Dockerfile -t $IMAGE .
docker push $IMAGE
docker build 照 Dockerfile 把代码打成镜像,-t 给它起名。名字简单点:hello-web:v1,v1 就是版本号;别用 latest,出事才知道回滚到哪版。末尾「空格 + 句点」指当前目录,最常漏。docker push 传到 gcr.io 仓库,因为 Cloud Run 在云上拉镜像,只认 gcr.io/项目号/... 这种完整路径,写短名会找不到。
echo "服务名=$SERVICE 区域=$REGION 镜像=$IMAGE"
gcloud run deploy $SERVICE --region $REGION --image $IMAGE
首次只带服务名、区域、镜像三项,先跑通再加内存、环境变量。回车前看 echo 那行:服务名会进网址,区域别照抄、选离用户近的(换区域通常得删了重建),镜像必须和刚 push 的一致。中途问启用 API、允许未登录访问,都输 y 即可。
- 别写成
dockerfile.txt,也别在子目录 build。 - 代码要监听环境变量
PORT,写死端口会启动失败。
详细步骤三:配置访问与环境变量
这一步给这次 cloud run 部署补运行参数。小白最稳的是:环境变量、内存上限、并发数、最大实例数先保留默认值;页面能开、日志没报错,再按访问量慢慢调。参数不是越大越好:内存太小会启动失败,并发太高会压垮数据库,实例上限放开可能带来账单惊吓。
gcloud run deploy cloud-run-demo
--source .
--region asia-east1
--allow-unauthenticated
--revision-suffix=env-access-001
--description="对外网站:允许未登录访问,资源参数保留默认"
对外网站复制上面命令,–allow-unauthenticated 等于控制台勾选「允许未登录访问」,访客不用登录。内部服务别这样开,二选一复制下面命令:先关闭公开入口,再把调用权限给当前登录账号,之后按公司要求换服务账号。
gcloud run deploy cloud-run-demo
--source .
--region asia-east1
--no-allow-unauthenticated
--revision-suffix=internal-001
--description="内部服务:关闭未登录访问,仅授权账号可调用"
ACCOUNT="$(gcloud config get-value account)"
case "$ACCOUNT" in
*gserviceaccount.com) MEMBER="serviceAccount:${ACCOUNT}" ;;
*) MEMBER="user:${ACCOUNT}" ;;
esac
gcloud run services add-iam-policy-binding cloud-run-demo --region asia-east1 --member="${MEMBER}" --role="roles/run.invoker"
以后确实要按需调这四个值,再复制这段;不要把密码写进环境变量,密钥放 Secret Manager。每次部署都换修订后缀,description 写清日期、改动和是否可用,并把控制台生成的修订版本名与说明存进部署记录,出问题时按说明选上一个可用版本,点「管理流量」切到 100%。
gcloud run services update cloud-run-demo
--region asia-east1
--set-env-vars "APP_ENV=prod,LOG_LEVEL=info"
--memory 512Mi
--concurrency 80
--max-instances 3
--revision-suffix=env-tune-002
--description="2026-06-24 调整环境变量、内存、并发和最大实例数,验证可用"
- 常见坑:两段访问命令别都执行;对外网站误关未登录访问会显示 403,内部接口误开公开访问可能被陌生人扫到,重复修订后缀也会部署失败。
- 回滚坑:别把刚出问题的版本当目标;先确认旧修订说明里写着「可用」,再切流量。
验证结果
完成 cloud run 部署后,别急着收工。在 Cloud Shell 或 bash 复制下面整段:粘贴部署完成后输出的访问地址、测关键路径、打印环境变量和端口。标准是“有内容正常返回”,不是命令没报错。
read -r -p "粘贴部署完成后输出的访问地址:" URL
curl -i "$URL"
read -r -p "输入关键路径(以 / 开头,如 /health 或 /api/orders):" P
case "$P" in /*) ;; *) P="/$P" ;; esac
read -r -p "请求体 JSON(GET 可直接回车):" D
if [ -z "$D" ]; then
curl -i "${URL%/}$P"
else
curl -i -H "Content-Type: application/json" -d "$D" "${URL%/}$P"
fi
read -r -p "输入服务名:" S
read -r -p "输入区域(例如 asia-east1):" R
gcloud run services describe "$S" --platform managed --region "$R" --format='yaml(spec.template.spec.containers[0].env,spec.template.spec.containers[0].ports)'
-
看入口。第一条请求有 2xx(常见 200)和页面文字/接口 JSON,就说明地址能打开。坑:地址别带空格、引号;根路径 404 多半是路由写错,不是部署失败。浏览器会缓存或跳转,命令结果更直白。
-
看控制台。到 GCP 控制台的 Cloud Run → 服务 → 你的服务,看状态 Ready/绿色、请求量上升、错误率接近 0、日志无连续 5xx 或 Exception,确认没有持续报错。一次成功不代表稳定;冷启动和指标会延迟,刷新并选最新 Revision。
-
看关键路径和配置。关键路径填真会用的查询、详情或健康检查;提交接口可粘 JSON 请求体,返回业务数据才算链路通。env 要有刚设的变量名、值或密钥引用;ports 有值看 containerPort,空则按默认 8080,代码监听注入的 PORT。坑:写死 3000、没部署新 Revision、服务名或区域填错会查到旧结果;密钥别外发。
常见坑与解决办法
别急着重部署。整段复制到装好 gcloud 的终端,按提示填项目 ID、服务名、区域;会查角色、看日志、列地址,设公开访问和实例上限。
gcloud auth login
gcloud projects list
read -p "项目 ID:" PROJECT_ID
gcloud config set project "$PROJECT_ID"
gcloud projects get-iam-policy "$PROJECT_ID" --flatten="bindings[].members" --filter="bindings.members:$(gcloud config get-value account)" --format="table(bindings.role)"
read -p "服务名:" SERVICE
read -p "区域(如 asia-east1):" REGION
gcloud logging read "resource.type="cloud_run_revision" AND resource.labels.service_name="$SERVICE" AND severity>=ERROR" --limit=50 --format='table(timestamp,severity,textPayload,jsonPayload.message)'
gcloud run services list --format='table(metadata.name,metadata.labels.cloud.googleapis.com/location,status.url)'
gcloud run services add-iam-policy-binding "$SERVICE" --region "$REGION" --member="allUsers" --role="roles/run.invoker"
gcloud run services update "$SERVICE" --region "$REGION" --max-instances 2
- 权限不足:先看输出有没有 Cloud Run Admin/Developer、Artifact Registry Writer、Logs Viewer,分别管部署服务、写入镜像仓库、查看日志;没有就让管理员加。部署会推镜像、建版本、写日志,缺一环就 403。坑:只开 Cloud Run、登录错邮箱;连查也 403 就把账号发管理员。
- 启动失败:多半是监听端口不对或镜像启动命令写错。先看日志再改配置:Cloud Run 注入 PORT,要监听 0.0.0.0:$PORT,别写死 localhost:3000;CMD 要常驻 Web 服务,别跑完测试就退出。本地能跑不等于云上能跑。
- 成功却打不开:默认要登录,查是否允许未登录访问、服务是否选错区域、访问地址是否带错路径。上面绑定给 allUsers 调用权,不是给你部署权;组织禁止就问管理员;区域要和创建时一致;复制 status.url,别拼控制台路径,只有 /health 时根路径 404 正常。
- 怕出账单:测试前先在控制台搜“预算和提醒”建提醒,再用上面命令设最大实例数 2。提醒只通知、不停机;实例上限才给并发封顶。坑:压测脚本忘关、以为没人访问就零费用,避免测试流量带来意外费用。
常见问题(FAQ)
cloud run 部署一定要懂服务器命令吗?
不需要,按教程操作即可;会看日志和端口会更顺手。
没有容器镜像可以部署吗?
可以,用示例代码配合构建服务生成镜像,再发布到 cloud run。
cloud run 部署后网站为什么打不开?
先查端口、日志和访问权限,最常见是未开放未登录访问。
会不会产生很高费用?
轻量测试通常很低,建议设预算提醒和最大实例数。
可以绑定自己的域名吗?
可以,在 GCP 控制台添加域名映射并按提示配置解析。
不想自己折腾 GCP?我们提供云平台代维护、上云迁移与账单代付服务,一对一技术支持。
