cloud-run-release-manager 的安装和配置教程

1. 项目的基础介绍和主要的编程语言

cloud-run-release-manager 是一个开源项目，旨在为 Google Cloud Run 服务提供自动化的金丝雀部署（Canary Deployment）工具。这个项目允许用户逐渐增加新版本服务器的流量，同时监测其健康状况，并根据预设的策略自动决定是继续增加流量还是回滚到旧版本。项目主要使用 Go 语言开发。

2. 项目使用的关键技术和框架

该项目主要使用以下技术和框架：

• Google Cloud Run：用于部署和管理容器化应用程序。
• Google Cloud Scheduler：用于定时触发 Release Manager 的执行。
• Google Cloud Monitoring：用于监控服务的健康状况。
• Go：项目的开发语言，用于编写 Release Manager 的主要逻辑。

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

在开始安装之前，请确保您已经完成了以下准备工作：

• 拥有 Google Cloud Platform (GCP) 的账号。
• 安装并配置了 gcloud 命令行工具。
• 确保您的项目中启用了 Cloud Run、Cloud Scheduler 和 Cloud Monitoring API。

安装步骤

1. 设置项目 ID

   首先，设置您的 GCP 项目 ID：

   export PROJECT_ID=<your-project-id>
   

2. 创建服务账户

   创建一个新的服务账户用于 Release Manager：

   gcloud iam service-accounts create release-manager \
     --display-name "Cloud Run Release Manager"
   

3. 授权服务账户

   授予服务账户管理 Cloud Run 服务的权限，以及使用其他服务账户更新服务的权限：

   gcloud projects add-iam-policy-binding $PROJECT_ID \
     --member=serviceAccount:release-manager@$PROJECT_ID.iam.gserviceaccount.com \
     --role=roles/run.admin
   
   gcloud projects add-iam-policy-binding $PROJECT_ID \
     --member=serviceAccount:release-manager@$PROJECT_ID.iam.gserviceaccount.com \
     --role=roles/iam.serviceAccountUser
   
   gcloud projects add-iam-policy-binding $PROJECT_ID \
     --member=serviceAccount:release-manager@$PROJECT_ID.iam.gserviceaccount.com \
     --role=roles/monitoring.viewer
   

4. 构建和推送容器镜像

   克隆项目仓库，并构建容器镜像推送到 Google Container Registry：

   git clone https://github.com/GoogleCloudPlatform/cloud-run-release-manager.git
   cd cloud-run-release-manager
   gcloud builds submit . --tag gcr.io/$PROJECT_ID/cloud-run-release-manager
   

5. 部署 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
   

6. 获取服务 URL

   获取部署的 Release Manager 服务的 URL：

   export URL=$(gcloud run services describe release-manager \
     --platform=managed --region=us-central1 \
     --format='value(status.url)')
   

7. 设置 Cloud Scheduler

   最后，设置 Cloud Scheduler 来定期调用 Release Manager：

   gcloud services enable cloudscheduler.googleapis.com
   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="$URL/rollout"
   

完成以上步骤后，您就可以开始部署带有 rollout-strategy=gradual 标签的服务，并使用 --no-traffic 选项部署新版本，Release Manager 将自动为您处理金丝雀部署。