在使用者介面中升級

1. 建立新的 Databases for Elasticsearch 來測試升級程序。
   從版本相同的現有部署 還原備份，建立部署。

2. 將暫存應用程式指向測試部署。
   更新您的暫存應用程式，以指向測試部署。 確認您的測試應用程式可以成功連線至暫存部署，且應用程式的運作符合預期。 對暫存環境執行任何所需的效能與作業測試。

3. 按一下「總覽」頁面上的「升級主要版本」按鈕，升級測試部署的主要版本。
   這將使您的資料庫在升級過程完成時進入「僅讀」模式。 請注意升級完成所需的時間，以便您可以使用升級到期設定，將升級包含在維護視窗內。

4. 確認您的暫存應用程式可以使用新的資料庫版本。
   如果您的應用程式正常運作，此步驟將確認您可以安全地升級生產資料庫。

5. 將生產資料庫部署升級至新版本。
   當您確認應用程式使用新版本的資料庫後，就可以返回管理主控台，開始升級生產部署的程序。 在總覽頁面的部署詳細資訊部分，按一下升級主要版本按鈕，然後按步驟進行。

   就地升級程序一旦啟動，就無法停止或回退。 因此，萬一發生錯誤時，您的資料庫部署可能會變得無法復原。 因此，請建立一個備份，然後用於還原到新的部署。 如果選擇「使用備份就地升級主要版本」，建立的備份可用於在新部署中還原。

expiration for starting upgrade 允許您設定「超時」期限，升級工作必須在此期限內啟動，否則會自動取消。 此外，請先在暫存階段測試升級，以確保升級能在您所需的時間視窗內完成。 例如，如果您希望在 1 小時內完成升級，而您測試升級後知道升級需要 30 分鐘，那麼您的升級工作必須在您確認要升級後的 30 分鐘內開始。 因此，請將到期時間設定為 30 分鐘，如此一來，如果在這段時間內沒有啟動，就不會超過您的視窗。

透過 API 升級

使用下列指令就地升級：

curl -X PATCH https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/version -H 'Authorization: Bearer <>' -H 'Content-Type: application/json' -d '{"version": "8.0"}'

expiration for starting upgrade 允許您設定「超時」期限，升級工作必須在此期限內啟動，否則會自動取消。 此外，請先在暫存階段測試升級，以確保升級能在您所需的時間視窗內完成。 例如，如果您希望在 1 小時內完成升級，而您測試升級後知道升級需要 30 分鐘，那麼您的升級工作必須在您確認要升級後的 30 分鐘內開始。 因此，請將到期時間設定為 30 分鐘後的時間戳，如此一來，如果它沒有在這段時間內開始，就不會超過您的視窗。 到期時間必須在 5 分鐘（預設）到 24 小時之間。 如需詳細資訊，請參閱 Cloud Databases API。

透過 CLI 升級

可用於 CDB 外掛程式版本 >= 0.20.0

若要檢視部署允許的升級和還原轉換清單，請參閱「升級和還原轉換」：

ibmcloud cdb deployment-capability-show <NAME|CRN> versions

要使用所需參數升級指令：

ibmcloud cdb deployment-version-upgrade <NAME|CRN> <TARGET_VERSION>

若要檢視指令參數的完整詳細資訊：

ibmcloud cdb deployment-version-upgrade --help

expiration for starting upgrade 允許您設定「超時」期限，升級工作必須在此期限內啟動，否則會自動取消。 此外，請先在暫存階段測試升級，以確保升級能在您所需的時間視窗內完成。 例如，如果您希望在 1 小時內完成升級，而您測試升級後知道升級需要 30 分鐘，那麼您的升級工作必須在您確認要升級後的 30 分鐘內開始。 因此，請將到期時間設定為 30 分鐘，如此一來，如果在這段時間內沒有啟動，就不會超過您的視窗。 到期時間必須在 5 分鐘（預設）到 24 小時之間。 有兩種方法可以使用 CLI --expire-in 或 --expire-at 設定到期時間。 如需更多資訊，請參閱該指令的說明。

透過 Terraform 升級

適用於 Terraform 提供者版本 >= 1.79.2

若要升級，只需在您的組態中新增或變更 version 值即可。 還有一個可選的 bool 標誌，version_upgrade_skip_backup，可以設定為跳過備份。

不建議跳過備份。 在版本升級前跳過備份是危險的，可能會導致資料遺失。 如果升級在任何階段失敗，將無法立即從備份還原。

在升級過程中，資料庫將進入「唯讀」模式。 強烈建議在升級前先進行測試。

升級可能需要比預設超時更長的時間。 可以使用 timeouts 屬性設定較長的逾時值。

Terraform 有超時而非到期時間戳記。 因此，請增加您的逾時時間，因為您的逾時更新值會被用作過期。 例如，如果您設定逾時為 20 分鐘，過期時間就會設定為 20 分鐘，如果在該時間內沒有開始升級，過期時間就會過期，升級也不會開始。 請注意，最長的過期時間為 24 小時 - 因此即使您設定 36 小時的逾時時間，如果在前 24 小時內尚未開始升級，升級也會過期。

如果正在進行升級，請注意某些任務可能已排成佇列，在版本升級完成之前不會繼續進行。

在使用者介面中升級

對於新的託管模式 (獨立運算和共用運算)，可透過 CLI 和 API 升級至新的主要版本。

您可以從 IBM Cloud 主控台上部署的 Backups and restore 頁面 還原備份，升級到新版本。 點擊備份上的 「恢復備份」 將在新分頁中開啟一個頁面，您可以在其中更改新部署的一些選項。 其中之一是資料庫版本，它會自動填入可供您升級的版本。 選擇版本，然後按一下還原備份，以啟動配置和還原程序。

透過 CLI 升級

當您透過 IBM Cloud CLI 從備份升級和還原時，請使用資源控制器上的佈建指令。

ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_ID> <SERVICE_PLAN_ID> <REGION>

參數 instance_name, service_id, service_plan_id，和 region 都是必需的。 您也可以在 JSON 物件中為 -p 提供版本和備份 ID 參數。 新部署的大小會自動與備份時的來源部署相同。

ibmcloud resource service-instance-create example-upgrade databases-for-elasticsearch enterprise us-south \
-p \ '{
  "backup_id": "crn:v1:bluemix:public:databases-for-elasticsearch:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "version":"8.0"
}'

透過 API 升級

與透過 API 進行佈建類似，您必須先完成 使用資源控制器 API 的必要步驟，才能使用它從備份升級。 然後向 API 傳送 POST 請求。 參數 name, target, resource_group，和 resource_plan_id 都是必需的。 同時提供版本和備份 ID。 新部署的記憶體和磁碟分配與備份時的來源部署相同。

curl -X POST   https://resource-controller.cloud.ibm.com/v2/resource_instances   -H 'Authorization: Bearer <>'   -H 'Content-Type: application/json'     -d '{
    "name": "my-instance",
    "target": "us-south",
    "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
    "resource_plan_id": "databases-for-elasticsearch-enterprise",
    "backup_id": "crn:v1:bluemix:public:databases-for-elasticsearch:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
    "version":"8.0"
  }'

透過 Terraform 升級

使用 Terraform 將備份從舊版本還原到新版本。

1. 設定您的 backup_id。 如需相關資訊，請參閱 backup_id。
2. 在版本屬性中設定您的 version。 如需相關資訊，請參閱 version。

程式碼如下：

resource "ibm_database" "<your-instance>" {
  name                                 = "<your_database_name>"
  service                              = "databases-for-elasticsearch"
  plan                                 = "enterprise"
  location                             = "<region>"
  version                              = "<version>"
  backup_id                            = "<backup_id>"
}

如需詳細資訊，請參閱 Cloud Databases Terraform Registry。 另外，您也可以使用 Terraform IBM Modules(TIM) 從備份實體建立新的資料庫實體。 如需詳細資訊，請參閱 從備份還原範例。