建立及暫存藍綠部署作業

本文說明如何建立及測試 Cloud SQL 藍綠部署作業,以便執行主要版本升級或設定變更。

事前準備

如要建立及測試藍綠部署,請確認您具備必要角色,且來源執行個體符合部署作業必要條件。

必要角色和權限

如要取得建立及測試藍綠部署所需的權限,請要求管理員授予您專案的下列 IAM 角色:

  • Cloud SQL 編輯者 (roles/cloudsql.editor)
  • Cloud SQL 管理員 (roles/cloudsql.admin)

如要使用自訂角色,請確認您具備下列權限:

  • cloudsql.blueGreenDeployments.create
  • cloudsql.blueGreenDeployments.get
  • cloudsql.instances.get
  • cloudsql.instances.create
  • cloudsql.instances.update
  • cloudsql.operations.get

如要進一步瞭解 Cloud SQL 的 IAM 角色和權限,請參閱「角色和權限」。

執行個體必要條件

建立藍綠部署作業前,請確認正式環境 (藍色) 執行個體符合下列規定:

  1. 資料庫引擎、版本和版本:執行個體必須在 Cloud SQL Enterprise 版或 Cloud SQL Enterprise Plus 版上,執行 MySQL 適用的 Cloud SQL 5.7、8.0 或 8.4 版。不支援 8.0.18 版。如果是主要版本升級,可以從 8.0 版升級至 8.4 版。
  2. 二進位記錄和自動備份:您必須在藍色執行個體上啟用二進位記錄和自動備份,才能建立持續邏輯複製到綠色環境。
  3. 執行個體狀態:藍色執行個體必須處於 RUNNING 狀態,且沒有進行中的作業或衝突的維護期間。
  4. 不支援的功能:確認執行個體未使用任何藍綠部署不支援的功能,包括:

  5. 最新維護版本:執行個體必須執行最新維護版本,才能建立藍綠部署。詳情請參閱「自助式維護」。

  6. 網路架構:執行個體必須使用新網路架構。不支援使用舊版網路架構的執行個體。

觸發部署作業建立作業時,Cloud SQL 會自動執行一系列自動預先檢查,驗證複製相容性和旗標。如果是主要版本升級,Cloud SQL 也會在來源執行個體上執行主要版本升級預檢 API,驗證升級準備情況,然後再繼續執行工作流程。如果預先檢查失敗,系統會停止建立部署作業,並在作業狀態中傳回錯誤。

建立藍綠部署

您可以建立藍綠部署作業,執行主要版本升級 (指定目標資料庫版本),或在目前的資料庫版本中,測試硬體或設定變更。

控制台

  1. 前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 如要開啟執行個體的「Overview」(總覽) 頁面,請按一下執行個體名稱。
  3. 在「Configuration」(設定) 區段中,按一下「Create blue green deployment」(建立藍綠部署)。
  4. 在「Create Blue Green Deployment」(建立藍綠部署) 頁面的「Deployment information」(部署資訊) 區段中,在「Deployment name」(部署名稱) 欄位輸入部署名稱。名稱在專案和區域內不得重複。如果該區域已有名稱相同的部署作業,則無法建立部署作業。
  5. 在「Deployment use case」(部署用途) 清單中,選取下列其中一個選項:
    • 選項 A (主要版本升級):如要在切換前,於綠色執行個體上暫存及測試主要版本升級,請選取「Major version upgrade」(主要版本升級)。在「Target database version」(目標資料庫版本) 清單中,選取綠色目標執行個體的目標資料庫版本 (MySQL 8.4)。主要版本升級僅支援從 MySQL 8.0 (不含 8.0.18) 升級至 MySQL 8.4。

      建立主要版本升級部署作業時,Cloud SQL 會在建立綠色執行個體前,自動執行主要版本升級預檢。或者,您也可以在建立部署作業前,執行主要版本升級預檢,找出任何升級阻礙。

    • 選項 B (預設):如要建立與來源執行個體資料庫版本相同的綠色測試環境,以便測試設定或硬體變更,請選取「Default」(預設)。
  6. 點選「建立」。

gcloud

如要使用 gcloud CLI 建立藍綠部署,請執行 gcloud sql blue-green-deployments create 指令。

方法 A:升級主要版本

如要建立主要版本升級的部署作業,請指定 --target-database-version 旗標。指定目標資料庫版本後,Cloud SQL 會在建立綠色執行個體前,自動執行主要版本升級預檢。或者,您也可以在建立部署作業前,對藍色執行個體執行主要版本升級預檢,找出任何升級阻礙:

gcloud sql blue-green-deployments create DEPLOYMENT_NAME \
  --source-instance=SOURCE_INSTANCE_ID \
  --target-database-version=TARGET_DATABASE_VERSION \
  --region=REGION \
  --async

更改下列內容:

  • DEPLOYMENT_NAME:部署作業名稱 (4 到 63 個小寫英文字母、數字和連字號,開頭須為小寫英文字母,結尾不得為連字號)。名稱在專案和區域內不得重複。如果該區域已有名稱相同的部署作業,則無法建立部署作業。
  • SOURCE_INSTANCE_ID:藍色來源執行個體的名稱。
  • TARGET_DATABASE_VERSION:綠色目標執行個體 (MYSQL_8_4) 的目標資料庫版本。主要版本升級僅支援從 MySQL 8.0 (不含 8.0.18) 升級至 MySQL 8.4,且建立部署作業後,即無法變更目標資料庫版本。
  • REGION:藍色執行個體的 Google Cloud 區域。

方法 B:硬體或設定變更

如要佈建與藍色執行個體相同資料庫版本的綠色環境,以測試硬體或設定變更,請省略 --target-database-version 旗標:

gcloud sql blue-green-deployments create DEPLOYMENT_NAME \
  --source-instance=SOURCE_INSTANCE_ID \
  --region=REGION \
  --async

建立藍綠部署作業需要幾分鐘才能完成,尤其是執行主要版本升級時。您可能會看到一則訊息,指出作業時間超出預期。您可以忽略這則訊息,或執行 gcloud sql operations wait 指令關閉訊息,並等待作業完成:

gcloud sql operations wait OPERATION_ID

將 OPERATION_ID 替換成指令傳回或訊息中顯示的作業 ID。

Terraform

如要使用 Terraform 建立藍綠部署,請將 blue_green_deployment 程式碼區塊新增至主要 google_sql_database_instance 資源,並將 active_environment 欄位設為 "SOURCE"。

方法 A:升級主要版本

如要建立主要版本升級的部署作業,請將頂層 database_version 欄位設為目前的藍色執行個體版本,並將 blue_green_deployment 程式碼區塊中的 target_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
    }
  }

  blue_green_deployment {
    deployment_name         = "DEPLOYMENT_NAME"
    target_database_version = "TARGET_DATABASE_VERSION"
    active_environment      = "SOURCE"
  }
}

更改下列內容:

  • SOURCE_INSTANCE_ID:藍色來源執行個體的名稱。
  • REGION:藍色執行個體的 Google Cloud 區域。
  • SOURCE_DATABASE_VERSION:藍色執行個體目前的資料庫版本 (例如 MYSQL_8_0)。如要升級主要版本,藍色執行個體必須執行 MySQL 8.0 (不含 8.0.18)。
  • MACHINE_TIER:執行個體的機器類型 (例如 db-custom-2-7680)。
  • EDITION:執行個體的 Cloud SQL 版本 (ENTERPRISE 或 ENTERPRISE_PLUS)。
  • DEPLOYMENT_NAME:部署作業名稱 (4 到 63 個小寫英文字母、數字和連字號,開頭須為小寫英文字母,結尾不得為連字號)。名稱在專案和區域內不得重複。如果該區域已有名稱相同的部署作業,則無法建立部署作業。
  • TARGET_DATABASE_VERSION:綠色目標執行個體 (MYSQL_8_4) 的目標資料庫版本。主要版本升級僅支援從 MySQL 8.0 (不含 8.0.18) 升級至 MySQL 8.4,且建立部署作業後,即無法變更目標資料庫版本。

方法 B:硬體或設定變更

如要佈建與藍色執行個體相同資料庫版本的綠色環境,以便測試硬體或設定變更,請省略 blue_green_deployment 程式碼區塊中的 target_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
    }
  }

  blue_green_deployment {
    deployment_name    = "DEPLOYMENT_NAME"
    active_environment = "SOURCE"
  }
}

如要在 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 顯示「Apply complete!」訊息。

  3. 開啟 Google Cloud 專案即可查看結果。在 Google Cloud 控制台的 UI 中前往資源,確認 Terraform 已建立或更新資源。

REST v1

如要使用 Cloud SQL Admin API 建立藍綠部署,請傳送 POST 要求至 blueGreenDeployments.create 方法。

方法 A:升級主要版本

如要建立主要版本升級的部署作業,請在 requestedConfig 物件中指定 databaseVersion 欄位。指定目標資料庫版本後,Cloud SQL 會在建立綠色執行個體前,自動執行主要版本升級預檢,做為作業的一部分。或者,您也可以在建立部署作業前,對藍色執行個體執行主要版本升級預檢,找出任何升級阻礙:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments?blueGreenDeploymentId=DEPLOYMENT_NAME
{
  "sourceInstance": "SOURCE_INSTANCE_ID",
  "requestedConfig": {
    "databaseVersion": "TARGET_DATABASE_VERSION"
  }
}

更改下列內容:

  • PROJECT_ID: Google Cloud 專案的 ID。
  • REGION:藍色執行個體的 Google Cloud 區域。
  • DEPLOYMENT_NAME:部署作業名稱 (4 到 63 個小寫英文字母、數字和連字號,開頭須為小寫英文字母,結尾不得為連字號)。名稱在專案和區域內不得重複。如果該區域已有名稱相同的部署作業,則無法建立部署作業。
  • SOURCE_INSTANCE_ID:藍色來源執行個體的名稱。
  • TARGET_DATABASE_VERSION:綠色目標執行個體 (MYSQL_8_4) 的目標資料庫版本。主要版本升級僅支援從 MySQL 8.0 (不含 8.0.18) 升級至 MySQL 8.4,且建立部署作業後,即無法變更目標資料庫版本。

方法 B:硬體或設定變更

如要佈建與藍色執行個體相同資料庫版本的綠色環境,以便測試硬體或設定變更,請省略 requestedConfig 欄位:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments?blueGreenDeploymentId=DEPLOYMENT_NAME
{
  "sourceInstance": "SOURCE_INSTANCE_ID"
}

REST v1beta4

如要使用 Cloud SQL Admin API 建立藍綠部署,請傳送 POST 要求至 blueGreenDeployments.create 方法。

方法 A:升級主要版本

如要建立主要版本升級的部署作業,請在 requestedConfig 物件中指定 databaseVersion 欄位。指定目標資料庫版本後,Cloud SQL 會在建立綠色執行個體前,自動執行主要版本升級預檢,做為作業的一部分。或者,您也可以在建立部署作業前,對藍色執行個體執行主要版本升級預檢,找出任何升級阻礙:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments?blueGreenDeploymentId=DEPLOYMENT_NAME
{
  "sourceInstance": "SOURCE_INSTANCE_ID",
  "requestedConfig": {
    "databaseVersion": "TARGET_DATABASE_VERSION"
  }
}

更改下列內容:

  • PROJECT_ID: Google Cloud 專案的 ID。
  • REGION:藍色執行個體的 Google Cloud 區域。
  • DEPLOYMENT_NAME:部署作業名稱 (4 到 63 個小寫英文字母、數字和連字號,開頭須為小寫英文字母,結尾不得為連字號)。名稱在專案和區域內不得重複。如果該區域已有名稱相同的部署作業,則無法建立部署作業。
  • SOURCE_INSTANCE_ID:藍色來源執行個體的名稱。
  • TARGET_DATABASE_VERSION:綠色目標執行個體 (MYSQL_8_4) 的目標資料庫版本。主要版本升級僅支援從 MySQL 8.0 (不含 8.0.18) 升級至 MySQL 8.4,且建立部署作業後,即無法變更目標資料庫版本。

方法 B:硬體或設定變更

如要佈建與藍色執行個體相同資料庫版本的綠色環境,以便測試硬體或設定變更,請省略 requestedConfig 欄位:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments?blueGreenDeploymentId=DEPLOYMENT_NAME
{
  "sourceInstance": "SOURCE_INSTANCE_ID"
}

監控部署狀態

建立作業屬於長時間執行的作業 (LRO)。在測試階段,Cloud SQL 會佈建綠色執行個體、升級執行個體 (如果要求升級主要版本),並開始持續邏輯複製。

查看藍綠部署的進度和狀態:

控制台

  1. 前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 如要開啟執行個體的「Overview」(總覽) 頁面,請按一下執行個體名稱。
  3. 找到「Blue Green Deployment Status」(藍綠部署作業狀態) 資訊卡,查看部署作業狀態。
  4. 如要查看詳細的佈建工作和進度,請按一下「Details」(詳細資料),開啟「Deployment overview」(部署作業總覽) 頁面。

gcloud

如要使用 gcloud CLI 查看藍綠部署的進度和狀態,請執行 gcloud sql blue-green-deployments describe 指令:

gcloud sql blue-green-deployments describe DEPLOYMENT_NAME \
  --region=REGION

更改下列內容:

  • DEPLOYMENT_NAME:藍綠部署作業的名稱。
  • REGION:建立部署作業的 Google Cloud 區域。

如要等待建立作業完成,請執行 gcloud sql operations wait 指令:

gcloud sql operations wait OPERATION_ID

將 OPERATION_ID 替換為建立作業的 ID。

REST v1

如要使用 Cloud SQL Admin API 查看藍綠部署作業的進度和狀態,請傳送 GET 要求至 blueGreenDeployments.get 方法:

GET 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 查看藍綠部署作業的進度和狀態,請傳送 GET 要求至 blueGreenDeployments.get 方法:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments/DEPLOYMENT_NAME

更改下列內容:

  • PROJECT_ID: Google Cloud 專案的 ID。
  • REGION:建立部署作業的 Google Cloud 區域。
  • DEPLOYMENT_NAME:藍綠部署作業的名稱。

在指令輸出或 Google Cloud 控制台中,監控 state 欄位,追蹤部署作業生命週期:

  • PROVISIONING:系統正在建立綠色執行個體、升級 (如有要求),並連線至連續邏輯複製。
  • SWITCHOVER_READY:初始複製作業已完成,且持續邏輯複製作業正在執行。部署作業已準備就緒,可以進行驗證、測試和切換。
  • SWITCHOVER_NOT_READY:已佈建 Deployment,但無法啟動切換作業 (例如複製作業中斷,或 errorDetail 欄位回報問題)。

如要進一步瞭解所有部署作業生命週期階段,請參閱「部署作業生命週期和狀態」。

請等到部署作業狀態變更為 SWITCHOVER_READY,再繼續說明部署作業、驗證應用程式工作負載,或啟動切換作業。

後續步驟