本文說明如何建立及測試 Cloud SQL 藍綠部署作業,以便執行主要版本升級或設定變更。
事前準備
如要建立及測試藍綠部署,請確認您具備必要角色,且來源執行個體符合部署作業必要條件。
必要角色和權限
如要取得建立及測試藍綠部署所需的權限,請要求管理員授予您專案的下列 IAM 角色:
- Cloud SQL 編輯者 (
roles/cloudsql.editor) - Cloud SQL 管理員 (
roles/cloudsql.admin)
如要使用自訂角色,請確認您具備下列權限:
cloudsql.blueGreenDeployments.createcloudsql.blueGreenDeployments.getcloudsql.instances.getcloudsql.instances.createcloudsql.instances.updatecloudsql.operations.get
如要進一步瞭解 Cloud SQL 的 IAM 角色和權限,請參閱「角色和權限」。
執行個體必要條件
建立藍綠部署作業前,請確認正式環境 (藍色) 執行個體符合下列規定:
- 資料庫引擎、版本和版本:執行個體必須在 Cloud SQL Enterprise 版或 Cloud SQL Enterprise Plus 版上,執行 MySQL 適用的 Cloud SQL 5.7、8.0 或 8.4 版。不支援 8.0.18 版。如果是主要版本升級,可以從 8.0 版升級至 8.4 版。
- 二進位記錄和自動備份:您必須在藍色執行個體上啟用二進位記錄和自動備份,才能建立持續邏輯複製到綠色環境。
- 執行個體狀態:藍色執行個體必須處於
RUNNING狀態,且沒有進行中的作業或衝突的維護期間。 不支援的功能:確認執行個體未使用任何藍綠部署不支援的功能,包括:
最新維護版本:執行個體必須執行最新維護版本,才能建立藍綠部署。詳情請參閱「自助式維護」。
網路架構:執行個體必須使用新網路架構。不支援使用舊版網路架構的執行個體。
觸發部署作業建立作業時,Cloud SQL 會自動執行一系列自動預先檢查,驗證複製相容性和旗標。如果是主要版本升級,Cloud SQL 也會在來源執行個體上執行主要版本升級預檢 API,驗證升級準備情況,然後再繼續執行工作流程。如果預先檢查失敗,系統會停止建立部署作業,並在作業狀態中傳回錯誤。
建立藍綠部署
您可以建立藍綠部署作業,執行主要版本升級 (指定目標資料庫版本),或在目前的資料庫版本中,測試硬體或設定變更。
控制台
-
前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。
- 如要開啟執行個體的「Overview」(總覽) 頁面,請按一下執行個體名稱。
- 在「Configuration」(設定) 區段中,按一下「Create blue green deployment」(建立藍綠部署)。
- 在「Create Blue Green Deployment」(建立藍綠部署) 頁面的「Deployment information」(部署資訊) 區段中,在「Deployment name」(部署名稱) 欄位輸入部署名稱。名稱在專案和區域內不得重複。如果該區域已有名稱相同的部署作業,則無法建立部署作業。
- 在「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」(預設)。
- 選項 A (主要版本升級):如要在切換前,於綠色執行個體上暫存及測試主要版本升級,請選取「Major version upgrade」(主要版本升級)。在「Target database version」(目標資料庫版本) 清單中,選取綠色目標執行個體的目標資料庫版本 (MySQL 8.4)。主要版本升級僅支援從 MySQL 8.0 (不含 8.0.18) 升級至 MySQL 8.4。
- 點選「建立」。
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
- 啟動 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 顯示「Apply complete!」訊息。
- 開啟 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 會佈建綠色執行個體、升級執行個體 (如果要求升級主要版本),並開始持續邏輯複製。
查看藍綠部署的進度和狀態:
控制台
-
前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。
- 如要開啟執行個體的「Overview」(總覽) 頁面,請按一下執行個體名稱。
- 找到「Blue Green Deployment Status」(藍綠部署作業狀態) 資訊卡,查看部署作業狀態。
- 如要查看詳細的佈建工作和進度,請按一下「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,再繼續說明部署作業、驗證應用程式工作負載,或啟動切換作業。
後續步驟
- 說明及列出藍綠部署作業,以檢查部署狀態並擷取連線詳細資料。
- 切換藍綠部署作業,將綠色執行個體轉換為使用中的正式版讀寫執行個體。
- 刪除藍綠部署作業,取消測試並移除綠色環境。