HelloWorld

HelloWorld 与 GCP 使用指南

作者：

user

在

要在 GCP 上把一个 Hello World 程序从本地跑到线上，关键步骤很明确：建立项目并开通结算、安装并初始化 gcloud、选择合适的托管产品（App Engine、Cloud Run、Cloud Functions、GKE 或 Compute Engine）、部署代码并查看日志与权限设置。本文以浅显的方式一步步演示不同路径的实操流程、常见坑与优化建议，帮你把第一个“你好，世界”真正变成稳定可观测的线上服务。

HelloWorld 与 GCP 使用指南

先说一遍为什么要这么做（用费曼法解释）

想象你在厨房做一道简单菜：Hello World 是菜谱，代码是材料和步骤，GCP 是不同风格的灶具——微波炉、燃气灶、电磁炉、烤箱。你要选适合的灶具、准备好燃气或电源（结算与配额）、确保厨房门锁好（权限与网络），然后掌握火候（伸缩与性能），最后记下味道（日志与监控）。如果把每一步都拆开讲清楚，哪怕是新手也能跟着做出完整的一道菜。

准备工作（先把基础打牢）

  • 注册与项目：登录 Google Cloud Console，创建一个项目（Project）。每个项目是资源的边界。
  • 启用结算：没有结算，很多 API 无法启用。可以先绑定试用信用或启用免费额度。
  • 安装 gcloud SDK：在本地安装 Google Cloud SDK，运行 gcloud init 来登录和选择项目。
  • 启用必要 API：例如 Cloud Run 需要 Cloud Run API，App Engine 需要 App Engine Admin API，GKE 需要 Kubernetes Engine API。
  • 设置权限：给账户分配合适角色（Owner、Editor、或更细粒度的角色如 Cloud Run Admin、Storage Admin），遵循最小权限原则。

本地 Hello World 示例（三种常见语言）

先从最简单的开始：一个 HTTP 返回“Hello World”的小服务。

Node.js（Express）

const express = require('express');
const app = express();
app.get('/', (req, res) => res.send('Hello World'));
const port = process.env.PORT || 8080;
app.listen(port, () => console.log(`Listening on ${port}`));

Python（Flask）

from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello():
    return 'Hello World'
if __name__ == '__main__':
    app.run(host='0.0.0.0', port=int(os.environ.get('PORT', 8080)))

Go（net/http）

package main
import (
  "fmt"
  "net/http"
)
func handler(w http.ResponseWriter, r *http.Request) {
  fmt.Fprint(w, "Hello World")
}
func main() {
  http.HandleFunc("/", handler)
  http.ListenAndServe(":8080", nil)
}

在 GCP 上部署：选哪条路？（优缺点一览）

不同“灶具”适合不同场景，下面用一个表格把它们比较清楚。

服务 适合场景 运维复杂度 启动速度
App Engine (Standard) 快速部署网页和 API，自动扩缩 低 快
Cloud Run 容器化应用，按请求计费，适合微服务 中 中-快
Cloud Functions 事件驱动、函数即服务，适合轻量任务 低 快（但冷启动可能）
GKE 需要完整 Kubernetes 平台时，复杂微服务集群 高 取决于配置
Compute Engine 传统 VM，完全控制操作系统 高 慢（需手动伸缩）

逐条部署示例与要点

1) App Engine（标准环境）

  • 创建 app：gcloud app create –region=asia-east1
  • 添加 app.yaml（示例 Node.js）： 
    runtime: nodejs18
handlers:
- url: /.*
  script: auto
  • 部署：gcloud app deploy
  • 访问：gcloud app browse
  • 注意：标准环境对运行时有约束（文件系统只读等），但自动调度与免费配额对小应用友好。

2) Cloud Run（托管容器）

  • 写 Dockerfile，或者使用 Cloud Build 的构建器直接从源码构建容器。
  • 示例 Dockerfile（Node）： 
    FROM node:18
WORKDIR /app
COPY package*.json ./
RUN npm install --production
COPY . .
CMD ["node","index.js"]
  • 构建并部署： 
    gcloud builds submit --tag gcr.io/PROJECT_ID/helloworld
gcloud run deploy helloworld --image gcr.io/PROJECT_ID/helloworld --platform managed --region us-central1 --allow-unauthenticated
  • 要点：Cloud Run 支持自动伸缩到零、按请求计费，适合短时突发流量。

3) Cloud Functions（事件/HTTP 函数）

  • 编写函数并部署（Node 示例）： 
    gcloud functions deploy helloHttp --runtime nodejs18 --trigger-http --allow-unauthenticated --region=us-central1
  • 优点：无需管理容器或服务器；缺点：长期连接或大文件处理不适合。

4) Compute Engine（虚拟机）

  • 创建 VM，安装运行时，手动配置防火墙与负载均衡。
  • 适用于需要底层控制或特殊二进制依赖的场景。

5) GKE（Kubernetes）

  • 当你需要微服务编排、复杂网络策略、服务网格时选择 GKE。
  • 部署流程更复杂：创建集群、kubectl 连接、写 Deployment/Service YAML。

部署后必做的几件事：日志、监控与权限

  • 查看日志：Stackdriver（Cloud Logging）会自动收集大多数服务的日志。命令行：gcloud logging read “resource.type=cloud_run_revision” 类似。
  • 监控：使用 Cloud Monitoring 建立指标（响应时间、错误率、实例数）和告警。
  • 权限检查：如果访问 Cloud Storage、Secret Manager 等资源，确保服务账户拥有对应角色。
  • 健康检查与就绪探针：对于 GKE 或 Compute Engine，配置探针保证负载均衡只把流量投给健康实例。

常见问题与排查思路

  • 部署后 404/500：检查应用端口、启动命令、环境变量，确认容器在预期端口监听（通常是 $PORT）。
  • 权限错误（403）：查看调用服务使用的服务账号，确认它是否具有需要的 IAM 角色。
  • 长时间冷启动或超时：考虑减少容器镜像体积、增加并发或使用保留实例（对于 Cloud Run 可启用最小实例数）。
  • 无法访问日志：检查日志筛选条件与时间窗口，确认日志被正确写入 stdout/stderr。

成本与优化策略

成本优化其实就是理解计费单位，然后把浪费降下来。

  • 理解计费模型：Cloud Run 按 CPU/内存/请求时间计费，App Engine 按实例小时计费，Compute Engine 按 VM 运行时间计费。
  • 利用免费额度：新账号有免费试用额度，以及部分产品的免费层（App Engine、Cloud Functions 等有免费调用或小时数）。
  • 缩小镜像体积：使用多阶段构建、瘦基础镜像，可以显著缩短冷启动并节省网络传输时间。
  • 设置并发与最小实例：根据请求模式调整 Cloud Run 的并发数和最小实例数，避免频繁冷启动或持续占用高成本实例。

安全注意事项（不只是加个锁）

  • 使用 最小权限原则：不要把 Owner 权限给服务账号，尽量用最小可行角色。
  • 把敏感信息放到 Secret Manager，不要把密钥写到源代码或容器镜像里。
  • 启用 VPC、私有服务访问和防火墙规则来限制对内部资源的访问。
  • 使用 Cloud Armor 或负载均衡器的安全策略来防护 DDoS 或恶意请求。

实战清单（Checklist，部署前快速自检）

  • 项目已创建并启用结算
  • gcloud 已登录并选定项目（gcloud config set project PROJECT_ID）
  • 必要 API 已启用（Cloud Run、Cloud Build、GKE 等）
  • 服务账号与 IAM 权限已配置
  • 日志与监控指标已配置，告警阈值设置
  • 镜像体积与冷启动策略已优化
  • 敏感信息已迁移到 Secret Manager

一些小技巧（那些上线后才发现的）

  • 在本地用 cloud-run-local 或 Docker 模拟运行环境，先排除环境差异问题。
  • 把健康检查端点做成轻量、稳定的响应，避免探针误判。
  • 给每次部署打版本标签（tag），方便回滚与审计。
  • 利用 Cloud Build 的触发器连接 Git 仓库实现 CI/CD 自动部署。

写着写着总觉得还没说清楚每个小问题的细节，但核心流程其实不复杂：准备账号与项目、选择托管方式、写好能在 $PORT 上监听的应用、用 gcloud 构建并部署、然后打开日志与监控看运行状况。做久了你会发现，调试云端服务的许多技巧和调试本地程序思路类似，只不过工具换成了 Cloud Console、gcloud、Cloud Logging 与 Monitoring。接下来可以根据你最常用的语言和框架，把上述步骤具体化形成团队内的标准运行手册，避免重复踩坑。

更多文章