开始前你需要准备
先准备可结算的 GCP(Google Cloud)账号:能打开控制台首页,点“新建项目”并绑定结算。结算没生效,Cloud Run 会拒绝部署。本地装好 Docker 与 gcloud(Google Cloud CLI),Windows/macOS 用安装包,Linux 用包管理器;装完重开终端并启动 Docker 服务,否则常报“找不到命令”。下面命令用于登录、选择项目并验证工具可用;能打印邮箱和项目 ID,就算 gcloud 通了,看不到项目就回到初始化步骤重选。
gcloud auth login
gcloud init
gcloud config get-value account
gcloud config get-value project
docker --version
gcloud --version
把 claw 源码放进单独文件夹,或记下现成镜像名;镜像要推到可存放镜像的 Artifact Registry 仓库,它像“镜像网盘”。这一步打开 Cloud Run、Cloud Build、Artifact Registry 三个开关,并建仓库:
gcloud services enable run.googleapis.com cloudbuild.googleapis.com artifactregistry.googleapis.com
gcloud artifacts repositories create claw-docker --repository-format=docker --location=asia-east1 --description="claw images"
API 不开会报 service disabled;区域尽量和部署区域一致,提示 ALREADY_EXISTS 说明仓库已有,别慌。再到 IAM 给当前账号加 Cloud Run Admin、Cloud Build Editor、Artifact Registry Admin、Service Account User;项目创建者通常是 Owner,可跳过,公司项目遇到 permission denied 别硬试,先补权限。
最后,为后面的 claw Cloud Run 部署 Docker 先准备一个简单端口示例,确认服务会监听 0.0.0.0 和 8080。别只监听 127.0.0.1,也别写死 3000;Cloud Run 只把流量送到容器内的 PORT,默认 8080。浏览器打开 http://localhost:8080 看到 ok 再继续:
docker run --rm -p 8080:8080 hashicorp/http-echo -listen=0.0.0.0:8080 -text=ok
整体思路
把「claw cloud run 部署 docker」想成流水线:先把 claw 当普通容器应用,在根目录写 Dockerfile,说清依赖、启动命令和监听端口。先初始化 GCP、开通服务;示例按 Node 写,已有 Dockerfile 先备份,会覆盖。
gcloud init
gcloud services enable run.googleapis.com artifactregistry.googleapis.com
cat > Dockerfile <<'EOF'
FROM node:20-slim
WORKDIR /app
COPY package*.json ./
RUN npm install --omit=dev
COPY . .
ENV PORT=8080
EXPOSE 8080
CMD ["npm", "start"]
EOF
这样能固定环境,避免“本机可以、线上不行”。坑:EXPOSE 只是备注,程序要监听 0.0.0.0 和 PORT;写死 localhost、3000 或启动命令不存在会失败。不是 Node 就换镜像、依赖和启动行。
同一终端顺序复制:docker 构建镜像,推到 GCP 的 Artifact Registry,由 Cloud Run 按镜像地址拉取运行。项目选错、API 没开或认证没配,常报 denied;变量丢了找不到镜像。部署只关注四件事:
export REGION="asia-east1"
export PROJECT_ID="$(gcloud config get-value project)"
export REPO="claw"
export SERVICE="claw"
export IMAGE_URI="$REGION-docker.pkg.dev/$PROJECT_ID/$REPO/claw:v1"
gcloud artifacts repositories create "$REPO" --repository-format=docker --location="$REGION" 2>/dev/null || true
gcloud auth configure-docker "$REGION-docker.pkg.dev" --quiet
docker build -t "$IMAGE_URI" .
docker push "$IMAGE_URI"
gcloud run deploy "$SERVICE" --image "$IMAGE_URI" --region "$REGION" --platform managed --port 8080 --set-env-vars "NODE_ENV=production" --allow-unauthenticated
- 镜像地址:Cloud Run 只认完整地址,不读本地文件。
- 端口:统一 8080,监听和参数一致。
- 环境变量:密钥、数据库地址放这里,别写死。
- 是否允许公开访问:网站公开;内部服务不公开,避免被随便调用。
上线后别只看“部署成功”。用服务网址、日志和简单请求确认容器真的启动成功:网址能开、请求有响应、日志无启动超时,才算稳。
SERVICE_URL="$(gcloud run services describe "$SERVICE" --region "$REGION" --format='value(status.url)')"
echo "$SERVICE_URL"
curl -i "$SERVICE_URL"
gcloud run services logs read "$SERVICE" --region "$REGION" --limit=50
详细步骤一:准备 GCP 项目和 Dockerfile
打开 GCP 控制台,点“选择项目 → 新建项目”,记下“项目 ID”。坑:ID 不是项目名,而是全局唯一小写串;在 Cloud Shell 执行下面命令,首次会登录,并设为默认项目和区域,区域选离国内较近的 asia-east1。
gcloud auth login
read -p "项目 ID:" PROJECT_ID
gcloud config set project "$PROJECT_ID"
gcloud config set run/region asia-east1
在 claw 根目录复制下面整段,生成 Dockerfile 和忽略文件;以常见 Node.js 版 claw 为例,其他语言换基础镜像和安装命令。
printf '%sn' 'FROM node:20-slim' 'WORKDIR /app' 'COPY . .' 'RUN npm install --omit=dev' 'EXPOSE 8080' 'CMD ["npm", "start"]' > Dockerfile
printf '%sn' 'node_modules' '.git' '.env' '*.log' > .dockerignore
每条指令为什么这样写:
FROM node:20-slim:选轻量官方 Node 镜像,少踩环境坑。WORKDIR /app:固定工作目录,路径不乱。COPY . .:复制 claw 代码,容器才有内容可跑。RUN npm install --omit=dev:只装运行依赖,镜像更小。EXPOSE 8080:声明 8080 端口,方便 Cloud Run 对接。CMD ["npm", "start"]:指定启动命令,容器知道跑什么。
.dockerignore 排除 node_modules、.git、.env 和日志,避免镜像变大或泄露配置。坑:别忽略 Dockerfile、package.json;EXPOSE 不自动监听,claw 要监听 0.0.0.0:8080 或 PORT,package.json 要有 start 脚本。
详细步骤二:构建并推送 docker 镜像
先切到 claw 项目目录再构建。这里千万别偷懒直接写 docker build -t claw .:默认的 latest 标签会让 Cloud Run 搞不清该不该拉新镜像,出了故障也没法回滚,所以必须给一个看得懂的版本号。还有个特别隐蔽的坑:如果你用的是 M 系列芯片的 Mac,本机是 ARM 架构,默认打出来的是 arm64 镜像,但 Cloud Run 只跑 linux/amd64。不加平台参数时,你在本地怎么测都正常,一上线却直接报「容器启动失败」,新手常卡在这儿。下面命令自动读取当前项目,复制即可:
cd claw
export PROJECT_ID=$(gcloud config get-value project)
export REGION="asia-east1"
export REPO="claw-repo"
export TAG="v1.0.0"
docker build --platform linux/amd64 -t claw:${TAG} .
镜像虽然好了,Docker 却还不知道该往哪送,得先登录 GCP 的 Artifact Registry,再按「仓库地址/镜像名:版本」重新打一次标签。少了登录会报权限错误,没改成完整地址则会提示仓库找不到,这两步一步都省不得。若上一节是按默认建的,直接复制跑就行;改过区域或仓库名,把上面两行换成自己的即可:
gcloud auth configure-docker ${REGION}-docker.pkg.dev
docker tag claw:${TAG} ${REGION}-docker.pkg.dev/${PROJECT_ID}/${REPO}/claw:${TAG}
docker push ${REGION}-docker.pkg.dev/${PROJECT_ID}/${REPO}/claw:${TAG}
推完先别急着关窗口。打开 控制台 → Artifact Registry → 对应仓库,亲眼确认 claw:v1.0.0 已经躺进去,网络抖动时可能没报错却没传完。接着点进详情复制完整镜像地址(也可以直接跑下面的命令打印),下一步部署 Cloud Run 要原样粘贴,少个点或多个斜杠都会拉取失败。以后改了代码记得把版本升成 v1.0.1,别覆盖旧标签。
echo ${REGION}-docker.pkg.dev/${PROJECT_ID}/${REPO}/claw:${TAG}
详细步骤三:部署到 Cloud Run 并配置访问
这一步完成 claw cloud run 部署 docker:进入 Cloud Run 点“创建服务”,选“部署现有容器镜像”,服务名填 claw-docker,粘贴上一步镜像地址;区域选离用户近的 asia-east1 等亚洲区域,延迟低,换区常要重部署。用 gcloud 就在 Cloud Shell 复制执行,按提示填镜像和区域:
read -p "镜像:" I; read -p "区域:" R; gcloud run deploy claw-docker --image "$I" --region "$R" --platform managed --port 8080 --min-instances 0 --timeout 300 --allow-unauthenticated
配置页把容器端口设为 8080,因为 Cloud Run 把流量送到这里;应用只听 3000 不改,常见坑就是启动失败或 502。环境变量、密钥、最小实例数、超时时间按需填:密码用 Secret Manager,别放明文;0 实例省钱但有冷启动,常访问可改 1,普通站点 300 秒够。
公开网站要开“允许未认证访问”,否则访客会 403;内部服务别开,去 IAM 给账号加 Cloud Run Invoker,用 IAM 控制谁能调用。成功后复制系统生成的 https://…run.app 服务网址并保存,验证、绑定域名、分享都用它;别把镜像地址或控制台详情页当网址。
验证结果
先到 Cloud Run 的 claw 服务页复制「网址」,用浏览器打开。正常应看到 claw 首页、表单或接口 JSON,而不是 404、502、空白;这一步是为了确认「部署成功」真的能访问。在 Cloud Shell 里把下面整段一次复制执行,按提示粘贴即可:
read -p "服务网址:" U
curl -i "$U" | head
read -p "功能接口URL:" A
curl -i "$A"
read -p "区域(如 asia-east1):" R
gcloud run services describe claw --platform=managed --region "$R" --format='value(status.latestReadyRevisionName,spec.template.spec.containers[0].image,status.url)'
gcloud logging read 'resource.labels.service_name="claw"' --limit=20 --format='table(timestamp,httpRequest.requestUrl,httpRequest.status,textPayload)'
接着在「日志」页选最近 10 分钟、最新修订版本,看启动日志没有端口、依赖、权限、环境变量报错;命令输出只是辅助,页面也要扫一遍。
再做一次真实操作:提交测试表单、读取页面或调用简单接口,确认新增记录、列表变化或预期 JSON。只测页面时,A 再粘同一个网址。别只看 200,200 也可能返回空内容。
最后核对修订版本、镜像地址和请求记录:把命令里的 image 与刚推送的 Docker 镜像地址、最好连 @sha256:… 对照;日志里应出现刚才请求。这样才证明当前运行的正是刚部署的 Docker 镜像。
- 坑:网址别带空格,接口要粘完整 https 地址。
- 坑:容器要监听 Cloud Run 给的 PORT,环境变量要填在服务配置里。
- 坑:latest 可能被覆盖;请求若落在旧修订版本,检查流量分配。
常见坑与解决办法
做 claw cloud run 部署 docker 时,别急着重装,按顺序查,命令可整段复制。
- 容器启动即失败:Cloud Run 从外部探活,多半是只监听 127.0.0.1 或端口不是 8080。改成监听 0.0.0.0 和 Cloud Run 指定端口(默认 8080,代码读 PORT)。坑:EXPOSE 不改监听地址。
grep -R "127.0.0.1|localhost|PORT|8080" -n . --exclude-dir=.git gcloud run services update claw-cloud-run --region asia-east1 --port 8080 - 镜像推送失败:检查 gcloud 登录状态、项目 ID、仓库地址、API 是否开启和账号权限。地址形如 asia-east1-docker.pkg.dev/项目/claw/镜像;小白常登录 A 账号却推到 B 项目。
gcloud auth login gcloud auth list gcloud config get-value project gcloud services enable artifactregistry.googleapis.com run.googleapis.com cloudbuild.googleapis.com gcloud auth configure-docker asia-east1-docker.pkg.dev gcloud artifacts repositories list --location=asia-east1 gcloud projects add-iam-policy-binding "$(gcloud config get-value project)" --member="user:$(gcloud config get-value account)" --role="roles/artifactregistry.writer" - 访问返回 403:不是页面坏,是 IAM 没开门。检查是否允许未认证访问,以及 IAM 是否给对应账号运行权限(roles/run.invoker);组织禁用 allUsers 时别硬开。
gcloud run services get-iam-policy claw-cloud-run --region asia-east1 gcloud run services add-iam-policy-binding claw-cloud-run --region asia-east1 --member="allUsers" --role="roles/run.invoker" gcloud run services add-iam-policy-binding claw-cloud-run --region asia-east1 --member="user:$(gcloud config get-value account)" --role="roles/run.invoker" - 页面能开但功能异常:检查环境变量、密钥、数据库白名单、内存限制和冷启动超时。密钥别写进镜像;Cloud Run 出口 IP 不固定,别只放行本机 IP;内存小会被杀,冷启动慢要加 timeout。
gcloud run services describe claw-cloud-run --region asia-east1 --format=json gcloud run services logs read claw-cloud-run --region asia-east1 --limit=50 gcloud services enable secretmanager.googleapis.com gcloud secrets list gcloud run services update claw-cloud-run --region asia-east1 --set-env-vars="NODE_ENV=production" --memory=512Mi --timeout=60s - 费用超预期:测试服务别长期留。删服务会清掉闲置修订版本,删仓库会清掉镜像;到控制台「结算 > 预算和提醒」设置预算提醒。坑:旧镜像收存储费,旧版本易误切流量。
gcloud run revisions list --service claw-cloud-run --region asia-east1 gcloud run services delete claw-cloud-run --region asia-east1 --quiet gcloud artifacts repositories delete claw --location=asia-east1 --quiet gcloud billing accounts list
常见问题(FAQ)
没有域名也能部署 claw 吗?
可以,Cloud Run 会提供服务网址,先用它验证,再绑定自定义域名。
一定要会写 Dockerfile 吗?
不一定,有现成镜像可跳过;自己打包时掌握端口和启动命令即可。
cloud run 和 VM 有什么区别?
Cloud Run 按请求运行容器,少管服务器;VM 需要自己维护系统和进程。
docker 镜像太大怎么办?
换更小基础镜像,清理缓存,并用忽略文件排除无关内容。
部署后为什么第一次打开很慢?
多半是冷启动,可设置最小实例数或减小镜像体积。
不想自己折腾 GCP?我们提供云平台代维护、上云迁移与账单代付服务,一对一技术支持。
