Cloud Run Release Manager 开源项目最佳实践教程

1. 项目介绍

Cloud Run Release Manager 是由 GoogleCloudPlatform 开发的一个开源项目，它为 Cloud Run 服务提供了一种自动化的方式来逐渐推出新版本。通过使用指标，它能够自动决定逐渐增加新版本的流量，或者在出现问题时回滚到旧版本。本项目不是官方的 Google 产品，且目前处于 alpha 阶段，可能会在生产环境中遇到问题。

2. 项目快速启动

以下是在本地快速启动 Cloud Run Release Manager 的步骤：

首先，确保你已经安装了 Google Cloud SDK。

# 设置你的项目 ID
PROJECT_ID=<你的项目ID>

# 克隆项目仓库
git clone https://github.com/GoogleCloudPlatform/cloud-run-release-manager.git

# 切换到项目目录
cd cloud-run-release-manager

# 构建并推送容器镜像到 Google 容器仓库
gcloud builds submit ./ --tag gcr.io/${PROJECT_ID}/cloud-run-release-manager

# 部署 Release Manager 到 Cloud Run
gcloud run deploy release-manager --quiet \
  --platform=managed \
  --region=us-central1 \
  --image=gcr.io/${PROJECT_ID}/cloud-run-release-manager \
  --service-account=release-manager@${PROJECT_ID}.iam.gserviceaccount.com \
  --args=-verbosity=debug \
  --args=-healthcheck-offset=10m \
  --args=-min-requests=0 \
  --args=-max-error-rate=1 \
  --args=-min-wait=10m

# 获取 Cloud Run 服务的 URL
URL=$(gcloud run services describe release-manager \
  --platform=managed --region=us-central1 \
  --format='value(status.url)')

# 启用 Cloud Scheduler 服务
gcloud services enable cloudscheduler.googleapis.com

# 创建 Cloud Scheduler 任务调用 Release Manager
gcloud beta scheduler jobs create http cloud-run-release-manager --schedule "* * * * *" \
  --http-method=GET \
  --uri="${URL}/rollout" \
  --oidc-service-account-email=release-manager@${PROJECT_ID}.iam.gserviceaccount.com \
  --oidc-token-audience

确保你已经为 Release Manager 服务账户设置了必要的权限。

3. 应用案例和最佳实践

自动推出案例

1. 部署当前版本 v1 到 Cloud Run。
2. 部署新版本 v2 到 Cloud Run，并使用 --no-traffic 选项（获得 0% 的流量）。
3. 新版本自动检测并分配 5% 的流量。
4. 每分钟检查 v2 的指标，如果版本健康，逐渐增加流量。

自动回滚案例

1. 部署当前版本 v1 到 Cloud Run。
2. 部署新版本 v2 到 Cloud Run，并使用 --no-traffic 选项（获得 0% 的流量）。
3. 新版本自动检测并分配 5% 的流量。
4. 检查 v2 的指标，如果版本不健康，立即回滚到 v1。

最佳实践

• 为服务设置 rollout-strategy=gradual 标签以启用自动推出。
• 使用 Cloud Scheduler 定期调用 Release Manager。
• 根据实际情况调整流量增加的参数。

4. 典型生态项目

Cloud Run Release Manager 是 Cloud Run 生态系统中的一个重要组成部分，它与其他 Google Cloud 服务（如 Cloud Monitoring、Cloud Logging 和 Cloud Scheduler）紧密集成，为开发者提供了一个强大的自动化推出和回滚解决方案。通过这些服务，开发者可以更容易地管理和监控他们的 Cloud Run 服务，确保应用的稳定性和可靠性。