本文档介绍了如何删除 Cloud SQL 蓝绿部署,并详细说明了切换前后的删除行为差异。
准备工作
如需删除或取消蓝绿部署,请验证您是否拥有所需的角色和权限。
所需的角色和权限
如需获得删除蓝绿部署所需的权限,请让管理员向您授予项目的以下 IAM 角色:
- Cloud SQL Admin (
roles/cloudsql.admin)
对于自定义角色,请确保您拥有以下权限:
cloudsql.blueGreenDeployments.deletecloudsql.blueGreenDeployments.getcloudsql.instances.deletecloudsql.operations.get
如需详细了解 Cloud SQL 中的 IAM 角色和权限,请参阅角色和权限。
删除行为
delete 操作的行为会有所不同,具体取决于是否发生了切换:
| 部署阶段 | 默认行为 | 实例影响 |
|---|---|---|
| 切换前 (取消) |
删除部署元数据,并自动删除绿色的预演实例。 | 您的蓝色生产实例仍会继续运行,并且完全不受影响。 |
| 切换后 (删除) |
删除部署元数据,但默认情况下会保留两个实例作为独立实例。 | 绿色实例继续作为活跃的读写数据库实例处理生产流量。蓝色实例会保留为独立实例,除非您选择删除旧源实例选项、传递可选的 --delete-old-source 标志、在移除 blue_green_deployment 代码块之前在 Terraform 中设置 delete_old_source_on_destroy = true,或将 deleteOldSource 参数设置为 true 以将其删除。 |
情况 1:在切换之前取消部署
如果您在验证期间检测到问题或决定不继续升级,请在触发切换之前删除部署。
控制台
-
在 Google Cloud 控制台中,前往 Cloud SQL 实例页面。
- 如需打开实例的概览页面,请点击实例名称。
- 在蓝绿部署状态卡片中,点击详细信息以打开部署概览页面。
- 点击删除部署。
- 在要删除部署吗?对话框中,在部署 ID 字段中输入部署 ID 以进行确认。
- 点击删除。
gcloud
如需使用 gcloud CLI 取消和删除蓝绿部署,请运行 gcloud
sql blue-green-deployments delete 命令:
gcloud sql blue-green-deployments delete DEPLOYMENT_NAME \ --region=REGION
替换以下内容:
- DEPLOYMENT_NAME:蓝绿部署的名称。
- REGION:在其中创建部署的 Google Cloud 区域。
Terraform
如需在切换之前使用 Terraform 取消并删除蓝绿部署(当 active_environment 字段设置为 "SOURCE" 时),请从 google_sql_database_instance 资源中移除 blue_green_deployment 代码块,同时将 database_version 字段设置为蓝色源版本:
resource "google_sql_database_instance" "primary" { name = "SOURCE_INSTANCE_ID" region = "REGION" database_version = "SOURCE_DATABASE_VERSION" settings { tier = "MACHINE_TIER" edition = "EDITION" availability_type = "REGIONAL" backup_configuration { enabled = true binary_log_enabled = true } } }
替换以下内容:
- SOURCE_INSTANCE_ID:蓝色源实例的名称。
- REGION:在其中创建部署的 Google Cloud 区域。
- SOURCE_DATABASE_VERSION:蓝色源实例的数据库版本(例如
MYSQL_8_0)。 - MACHINE_TIER:实例的机器类型(例如
db-custom-2-7680)。 - EDITION:实例的 Cloud SQL 版本(
ENTERPRISE或ENTERPRISE_PLUS)。
如果您在切换之前移除 blue_green_deployment 代码块,Terraform 会取消部署并删除绿色预演实例,无论 delete_old_source_on_destroy 设置如何。
如需在 Google Cloud 项目中应用 Terraform 配置,请完成以下部分中的步骤。
准备 Cloud Shell
- 启动 Cloud Shell。
-
设置要应用 Terraform 配置的默认 Google Cloud 项目。
您只需为每个项目运行一次以下命令,即可在任何目录中运行它。
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
如果您在 Terraform 配置文件中设置显式值,则环境变量会被替换。
准备目录
每个 Terraform 配置文件都必须有自己的目录(也称为“根模块”)。
-
在 Cloud Shell 中,创建一个目录,并在该目录中创建一个新文件。文件名必须具有
.tf扩展名,例如main.tf。在本教程中,该文件称为main.tf。mkdir DIRECTORY && cd DIRECTORY && touch main.tf
-
如果您按照教程进行操作,可以在每个部分或步骤中复制示例代码。
将示例代码复制到新创建的
main.tf中。(可选)从 GitHub 中复制代码。如果端到端解决方案包含 Terraform 代码段,则建议这样做。
- 查看和修改要应用到您的环境的示例参数。
- 保存更改。
-
初始化 Terraform。您只需为每个目录执行一次此操作。
terraform init
(可选)如需使用最新的 Google 提供程序版本,请添加
-upgrade选项:terraform init -upgrade
应用更改
-
查看配置并验证 Terraform 将创建或更新的资源是否符合您的预期:
terraform plan
根据需要更正配置。
-
通过运行以下命令并在提示符处输入
yes来应用 Terraform 配置:terraform apply
等待 Terraform 显示“应用完成!”消息。
- 打开您的 Google Cloud 项目以查看结果。在 Google Cloud 控制台的界面中找到资源,以确保 Terraform 已创建或更新它们。
REST v1
如需使用 Cloud SQL Admin API 取消并删除蓝绿部署,请向 blueGreenDeployments.delete 方法发送 DELETE 请求:
DELETE https://sqladmin.googleapis.com/v1/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME
替换以下内容:
- PROJECT_ID:您的 Google Cloud 项目的 ID。
- REGION:在其中创建部署的 Google Cloud 区域。
- DEPLOYMENT_NAME:蓝绿部署的名称。
REST v1beta4
如需使用 Cloud SQL Admin API 取消并删除蓝绿部署,请向 blueGreenDeployments.delete 方法发送 DELETE 请求:
DELETE https://sqladmin.googleapis.com/sql/v1beta4/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME
替换以下内容:
- PROJECT_ID:您的 Google Cloud 项目的 ID。
- REGION:在其中创建部署的 Google Cloud 区域。
- DEPLOYMENT_NAME:蓝绿部署的名称。
这会移除绿色预演实例,并将环境恢复到其原始单实例状态,而不会造成停机。
情况 2:切换后删除
在成功切换和验证后,您可以删除部署以及之前的蓝色实例,以停止对两个实例产生费用。
控制台
-
在 Google Cloud 控制台中,前往 Cloud SQL 实例页面。
- 如需打开实例的概览页面,请点击实例名称。
- 在蓝绿部署状态卡片中,点击详细信息以打开部署概览页面。
- 点击删除部署。
- 在要删除部署吗?对话框中,在部署 ID 字段中输入部署 ID 以进行确认。
- 选择是删除还是保留旧的蓝色实例:
- 选项 A(删除部署和旧的蓝色实例):选中删除旧源实例复选框。
- 选项 B(仅删除部署元数据):不选中删除旧源实例复选框,以将旧的蓝色实例保留为独立实例。
- 点击删除。
如果您保留旧的蓝色实例,则两个实例在项目中都保持活跃状态,并且您需要继续为这两个实例付费。如需在将保留的实例用作备份或用于历史查询时防止对其进行写入,请将其 read_only 数据库标志设置为 on。如需了解详情,请参阅配置数据库标志。
gcloud
如需使用 gcloud CLI 删除蓝绿部署,请运行 gcloud
sql blue-green-deployments delete 命令。
选项 A:删除部署和旧的蓝色实例
如需删除部署元数据并自动删除旧的蓝色实例,请传递可选的 --delete-old-source 标志:
gcloud sql blue-green-deployments delete DEPLOYMENT_NAME \ --region=REGION \ --delete-old-source
替换以下内容:
- DEPLOYMENT_NAME:蓝绿部署的名称。
- REGION:在其中创建部署的 Google Cloud 区域。
出现提示时,确认您要永久删除旧的蓝色实例。
方法 B:仅删除部署元数据(保留旧的蓝色实例)
如需让之前的蓝色实例作为独立实例继续运行(例如,作为备份或用于历史分析查询),请省略可选的 --delete-old-source 标志:
gcloud sql blue-green-deployments delete DEPLOYMENT_NAME \ --region=REGION
替换以下内容:
- DEPLOYMENT_NAME:蓝绿部署的名称。
- REGION:在其中创建部署的 Google Cloud 区域。
此命令只会删除蓝绿部署元数据,并将两个实例保留为独立实例,直到您手动删除之前的蓝色实例。为防止在将保留的实例用作备份或用于历史查询时向其写入数据,请将其 read_only 数据库标志设置为 on。如需了解详情,请参阅配置数据库标志。两个实例在您的项目中都保持活跃状态,并且您需要继续为这两个实例付费。
Terraform
如需在使用 Terraform 切换后清理蓝绿部署(当 active_environment 字段设置为 "TARGET" 时),请从 google_sql_database_instance 资源中移除 blue_green_deployment 代码块,然后运行 terraform apply 命令。Terraform 是否也会删除旧的蓝色实例,取决于在您移除代码块之前,Terraform 状态中记录的 delete_old_source_on_destroy 字段的值。
选项 A:删除部署和旧的蓝色实例
- 如果
blue_green_deployment代码块中的delete_old_source_on_destroy字段尚未在 Terraform 状态中设置为true,请在blue_green_deployment代码块中设置delete_old_source_on_destroy = true,然后先运行terraform apply命令,以便 Terraform 在状态中记录该设置。 - 从
google_sql_database_instance资源中移除blue_green_deployment代码块(将database_version字段设置为新的正式版),然后运行terraform apply命令:
resource "google_sql_database_instance" "primary" { name = "SOURCE_INSTANCE_ID" region = "REGION" database_version = "TARGET_DATABASE_VERSION" settings { tier = "MACHINE_TIER" edition = "EDITION" availability_type = "REGIONAL" backup_configuration { enabled = true binary_log_enabled = true } } }
替换以下内容:
- SOURCE_INSTANCE_ID:主实例的名称。
- REGION:在其中创建部署的 Google Cloud 区域。
- TARGET_DATABASE_VERSION:生产实例的数据库版本(例如
MYSQL_8_4)。 - MACHINE_TIER:实例的机器类型(例如
db-custom-2-7680)。 - EDITION:实例的 Cloud SQL 版本(
ENTERPRISE或ENTERPRISE_PLUS)。
方法 B:仅删除部署元数据(保留旧的蓝色实例)
如果 Terraform 状态中的 delete_old_source_on_destroy 字段设置为 false(默认值),请从 google_sql_database_instance 资源中移除 blue_green_deployment 代码块,然后运行 terraform apply 命令。Terraform 仅删除蓝绿部署元数据,并将之前的蓝色实例保留为独立实例。
如果您保留旧的蓝色实例,则两个实例在项目中都保持活跃状态,并且您需要继续为这两个实例付费。如需在将保留的实例用作备份或用于历史查询时防止对其进行写入,请将其 read_only 数据库标志设置为 on。如需了解详情,请参阅配置数据库标志。您稍后可以使用以下任一方法管理或删除保留的实例:
- 使用
old_source_instance_name输出值运行以下命令,手动删除实例:gcloud sql instances delete OLD_SOURCE_INSTANCE_NAME
- 声明一个新的
google_sql_database_instance资源代码块,并将保留的实例导入 Terraform 状态:terraform import google_sql_database_instance.old_source \ projects/PROJECT_ID/instances/OLD_SOURCE_INSTANCE_NAME
替换以下内容:
- OLD_SOURCE_INSTANCE_NAME:保留的前一个蓝色实例的名称(在移除代码块之前在
old_source_instance_name属性中导出)。 - PROJECT_ID:您的 Google Cloud 项目的 ID。
如需在 Google Cloud 项目中应用 Terraform 配置,请完成以下部分中的步骤。
准备 Cloud Shell
- 启动 Cloud Shell。
-
设置要应用 Terraform 配置的默认 Google Cloud 项目。
您只需为每个项目运行一次以下命令,即可在任何目录中运行它。
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
如果您在 Terraform 配置文件中设置显式值,则环境变量会被替换。
准备目录
每个 Terraform 配置文件都必须有自己的目录(也称为“根模块”)。
-
在 Cloud Shell 中,创建一个目录,并在该目录中创建一个新文件。文件名必须具有
.tf扩展名,例如main.tf。在本教程中,该文件称为main.tf。mkdir DIRECTORY && cd DIRECTORY && touch main.tf
-
如果您按照教程进行操作,可以在每个部分或步骤中复制示例代码。
将示例代码复制到新创建的
main.tf中。(可选)从 GitHub 中复制代码。如果端到端解决方案包含 Terraform 代码段,则建议这样做。
- 查看和修改要应用到您的环境的示例参数。
- 保存更改。
-
初始化 Terraform。您只需为每个目录执行一次此操作。
terraform init
(可选)如需使用最新的 Google 提供程序版本,请添加
-upgrade选项:terraform init -upgrade
应用更改
-
查看配置并验证 Terraform 将创建或更新的资源是否符合您的预期:
terraform plan
根据需要更正配置。
-
通过运行以下命令并在提示符处输入
yes来应用 Terraform 配置:terraform apply
等待 Terraform 显示“应用完成!”消息。
- 打开您的 Google Cloud 项目以查看结果。在 Google Cloud 控制台的界面中找到资源,以确保 Terraform 已创建或更新它们。
REST v1
如需使用 Cloud SQL Admin API 删除蓝绿部署,请向 blueGreenDeployments.delete 方法发送 DELETE 请求。
选项 A:删除部署和旧的蓝色实例
如需删除部署元数据并自动删除旧的蓝色实例,请将 deleteOldSource 查询参数设置为 true:
DELETE https://sqladmin.googleapis.com/v1/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME?deleteOldSource=true
替换以下内容:
- PROJECT_ID:您的 Google Cloud 项目的 ID。
- REGION:在其中创建部署的 Google Cloud 区域。
- DEPLOYMENT_NAME:蓝绿部署的名称。
方法 B:仅删除部署元数据(保留旧的蓝色实例)
如需让之前的蓝色实例作为独立实例继续运行(例如,作为备份或用于历史分析查询),请省略 deleteOldSource 查询参数:
DELETE https://sqladmin.googleapis.com/v1/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME
替换以下内容:
- PROJECT_ID:您的 Google Cloud 项目的 ID。
- REGION:在其中创建部署的 Google Cloud 区域。
- DEPLOYMENT_NAME:蓝绿部署的名称。
此请求只会删除蓝绿部署元数据,而将两个实例保留为独立实例,直到您手动删除之前的蓝色实例。为防止在将保留的实例用作备份或用于历史查询时向其写入数据,请将其 read_only 数据库标志设置为 on。如需了解详情,请参阅配置数据库标志。两个实例在您的项目中都保持活跃状态,并且您需要继续为这两个实例付费。
REST v1beta4
如需使用 Cloud SQL Admin API 删除蓝绿部署,请向 blueGreenDeployments.delete 方法发送 DELETE 请求。
选项 A:删除部署和旧的蓝色实例
如需删除部署元数据并自动删除旧的蓝色实例,请将 deleteOldSource 查询参数设置为 true:
DELETE https://sqladmin.googleapis.com/sql/v1beta4/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME?deleteOldSource=true
替换以下内容:
- PROJECT_ID:您的 Google Cloud 项目的 ID。
- REGION:在其中创建部署的 Google Cloud 区域。
- DEPLOYMENT_NAME:蓝绿部署的名称。
方法 B:仅删除部署元数据(保留旧的蓝色实例)
如需让之前的蓝色实例作为独立实例继续运行(例如,作为备份或用于历史分析查询),请省略 deleteOldSource 查询参数:
DELETE https://sqladmin.googleapis.com/sql/v1beta4/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME
替换以下内容:
- PROJECT_ID:您的 Google Cloud 项目的 ID。
- REGION:在其中创建部署的 Google Cloud 区域。
- DEPLOYMENT_NAME:蓝绿部署的名称。
此请求只会删除蓝绿部署元数据,而将两个实例保留为独立实例,直到您手动删除之前的蓝色实例。为防止在将保留的实例用作备份或用于历史查询时向其写入数据,请将其 read_only 数据库标志设置为 on。如需了解详情,请参阅配置数据库标志。两个实例在您的项目中都保持活跃状态,并且您需要继续为这两个实例付费。