删除蓝绿部署

本文档介绍了如何删除 Cloud SQL 蓝绿部署,并详细说明了切换前后的删除行为差异。

准备工作

如需删除或取消蓝绿部署,请验证您是否拥有所需的角色和权限。

所需的角色和权限

如需获得删除蓝绿部署所需的权限,请让管理员向您授予项目的以下 IAM 角色:

  • Cloud SQL Admin (roles/cloudsql.admin)

对于自定义角色,请确保您拥有以下权限:

  • cloudsql.blueGreenDeployments.delete
  • cloudsql.blueGreenDeployments.get
  • cloudsql.instances.delete
  • cloudsql.operations.get

如需详细了解 Cloud SQL 中的 IAM 角色和权限,请参阅角色和权限。

删除行为

delete 操作的行为会有所不同,具体取决于是否发生了切换:

部署阶段 默认行为 实例影响
切换前
(取消)
删除部署元数据,并自动删除绿色的预演实例。 您的蓝色生产实例仍会继续运行,并且完全不受影响。
切换后
(删除)
删除部署元数据,但默认情况下会保留两个实例作为独立实例。 绿色实例继续作为活跃的读写数据库实例处理生产流量。蓝色实例会保留为独立实例,除非您选择删除旧源实例选项、传递可选的 --delete-old-source 标志、在移除 blue_green_deployment 代码块之前在 Terraform 中设置 delete_old_source_on_destroy = true,或将 deleteOldSource 参数设置为 true 以将其删除。

情况 1:在切换之前取消部署

如果您在验证期间检测到问题或决定不继续升级,请在触发切换之前删除部署。

控制台

  1. 在 Google Cloud 控制台中,前往 Cloud SQL 实例页面。

    转到“Cloud SQL 实例”

  2. 如需打开实例的概览页面,请点击实例名称。
  3. 在蓝绿部署状态卡片中,点击详细信息以打开部署概览页面。
  4. 点击删除部署。
  5. 在要删除部署吗?对话框中,在部署 ID 字段中输入部署 ID 以进行确认。
  6. 点击删除。

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

  1. 启动 Cloud Shell。
  2. 设置要应用 Terraform 配置的默认 Google Cloud 项目。

    您只需为每个项目运行一次以下命令,即可在任何目录中运行它。

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    如果您在 Terraform 配置文件中设置显式值,则环境变量会被替换。

准备目录

每个 Terraform 配置文件都必须有自己的目录(也称为“根模块”)。

  1. 在 Cloud Shell 中,创建一个目录,并在该目录中创建一个新文件。文件名必须具有 .tf 扩展名,例如 main.tf。在本教程中,该文件称为 main.tf。
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf
  2. 如果您按照教程进行操作,可以在每个部分或步骤中复制示例代码。

    将示例代码复制到新创建的 main.tf 中。

    (可选)从 GitHub 中复制代码。如果端到端解决方案包含 Terraform 代码段,则建议这样做。

  3. 查看和修改要应用到您的环境的示例参数。
  4. 保存更改。
  5. 初始化 Terraform。您只需为每个目录执行一次此操作。
    terraform init

    (可选)如需使用最新的 Google 提供程序版本,请添加 -upgrade 选项:

    terraform init -upgrade

应用更改

  1. 查看配置并验证 Terraform 将创建或更新的资源是否符合您的预期:
    terraform plan

    根据需要更正配置。

  2. 通过运行以下命令并在提示符处输入 yes 来应用 Terraform 配置:
    terraform apply

    等待 Terraform 显示“应用完成!”消息。

  3. 打开您的 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:切换后删除

在成功切换和验证后,您可以删除部署以及之前的蓝色实例,以停止对两个实例产生费用。

控制台

  1. 在 Google Cloud 控制台中,前往 Cloud SQL 实例页面。

    转到“Cloud SQL 实例”

  2. 如需打开实例的概览页面,请点击实例名称。
  3. 在蓝绿部署状态卡片中,点击详细信息以打开部署概览页面。
  4. 点击删除部署。
  5. 在要删除部署吗?对话框中,在部署 ID 字段中输入部署 ID 以进行确认。
  6. 选择是删除还是保留旧的蓝色实例:
    • 选项 A(删除部署和旧的蓝色实例):选中删除旧源实例复选框。
    • 选项 B(仅删除部署元数据):不选中删除旧源实例复选框,以将旧的蓝色实例保留为独立实例。
  7. 点击删除。

如果您保留旧的蓝色实例,则两个实例在项目中都保持活跃状态,并且您需要继续为这两个实例付费。如需在将保留的实例用作备份或用于历史查询时防止对其进行写入,请将其 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:删除部署和旧的蓝色实例

  1. 如果 blue_green_deployment 代码块中的 delete_old_source_on_destroy 字段尚未在 Terraform 状态中设置为 true,请在 blue_green_deployment 代码块中设置 delete_old_source_on_destroy = true,然后先运行 terraform apply 命令,以便 Terraform 在状态中记录该设置。
  2. 从 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

  1. 启动 Cloud Shell。
  2. 设置要应用 Terraform 配置的默认 Google Cloud 项目。

    您只需为每个项目运行一次以下命令,即可在任何目录中运行它。

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    如果您在 Terraform 配置文件中设置显式值,则环境变量会被替换。

准备目录

每个 Terraform 配置文件都必须有自己的目录(也称为“根模块”)。

  1. 在 Cloud Shell 中,创建一个目录,并在该目录中创建一个新文件。文件名必须具有 .tf 扩展名,例如 main.tf。在本教程中,该文件称为 main.tf。
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf
  2. 如果您按照教程进行操作,可以在每个部分或步骤中复制示例代码。

    将示例代码复制到新创建的 main.tf 中。

    (可选)从 GitHub 中复制代码。如果端到端解决方案包含 Terraform 代码段,则建议这样做。

  3. 查看和修改要应用到您的环境的示例参数。
  4. 保存更改。
  5. 初始化 Terraform。您只需为每个目录执行一次此操作。
    terraform init

    (可选)如需使用最新的 Google 提供程序版本,请添加 -upgrade 选项:

    terraform init -upgrade

应用更改

  1. 查看配置并验证 Terraform 将创建或更新的资源是否符合您的预期:
    terraform plan

    根据需要更正配置。

  2. 通过运行以下命令并在提示符处输入 yes 来应用 Terraform 配置:
    terraform apply

    等待 Terraform 显示“应用完成!”消息。

  3. 打开您的 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。如需了解详情,请参阅配置数据库标志。两个实例在您的项目中都保持活跃状态,并且您需要继续为这两个实例付费。

后续步骤