View a markdown version of this page

升級 Amazon OpenSearch Service 網域 - Amazon OpenSearch Service

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

升級 Amazon OpenSearch Service 網域

注意

OpenSearch 和 Elasticsearch 版本升級與服務軟體更新有所不同。如需為您的 OpenSearch Service 網域更新服務軟體的相關資訊,請參閱Amazon OpenSearch Service 中的服務軟體更新。

Amazon OpenSearch Service 提供兩種升級網域的方式:就地升級和複製式升級。如果您使用 Amazon Data Firehose 或 Amazon CloudWatch Logs 等服務將資料串流至 OpenSearch Service,請在遷移之前檢查這些服務是否支援較新版本的 OpenSearch。

升級方法和條款

就地升級會將您網域的現有叢集升級至新版本。它以藍/綠部署的形式執行。您無法暫停、取消或復原就地升級。它適用於執行 OpenSearch 1.0 或更新版本的網域,或 Elasticsearch 5.1 或更新版本。

複製型升級會在目標版本上建立網域的複製叢集,並在網域繼續從主要叢集提供流量時,讓它與資料保持同步。這是一個藍/綠部署,其中複製的叢集是綠色環境,保持隔離,以便在切換之前對其進行驗證。您可以驗證複製的叢集,然後在準備好時切換到它。您可以在切換之前取消,並在之後轉返。在提供 Amazon OpenSearch Service 的所有商業區域中,執行 Elasticsearch 7.10 或 OpenSearch 1.1 或更新版本的網域都可以使用複製型升級,但亞太區域 (紐西蘭)、亞太區域 (台北)、亞太區域 (泰國) 和墨西哥 (中部) 除外。 AWS OpenSearch 如需區域的完整清單,請參閱AWS 區域表。

下列術語說明以複製為基礎的升級。

主要叢集

升級開始時,您的網域在舊版上執行的叢集。它會持續提供流量,直到您切換。切換後,OpenSearch Service 只會將其保留在您設定的保留期間內,以便您可以復原。

複製的叢集

OpenSearch Service 在目標版本上建立的新叢集。它會接收您的資料副本,並與主要叢集保持同步。

驗證

在切換之前,使用您自己的讀取請求測試複製的叢集。您只能驗證讀取。

切換

將網域流量從主要叢集移至複製叢集的步驟。切換期間會封鎖寫入。

取消

在切換之前停止升級。OpenSearch Service 會刪除複製的叢集,而您的網域會保持原狀。

復原

在保留期間切換後返回主要叢集。

保留期間

OpenSearch Service 會在切換後保留主要叢集多久,以便您可以復原。此期間會在切換完成時開始。如果您未設定保留期間,OpenSearch Service 會在切換後立即刪除主要叢集。

選擇升級方法

下表比較兩種類型的升級。

就地升級 複製型升級
運作方式 升級現有的叢集。它以藍/綠部署的形式執行。 複製叢集為綠色環境的藍/綠部署。它在目標版本上建立,與您的資料保持同步,並保持隔離,以便您可以對其進行驗證。您決定何時切換。
適用於 OpenSearch 1.0 或更新版本,或 Elasticsearch 5.1 或更新版本。 Elasticsearch 7.10 或 OpenSearch 1.1 或更新版本。
在升級版本生效之前嘗試升級版本 否。升級前檢查會執行,但升級後的叢集會在升級完成後立即接管。 是。在網域繼續提供流量時,使用您自己的請求來嘗試複製的叢集。
取消升級 否. 是。您可以在切換前隨時取消。
復原 否。若要返回舊版,請在新網域上還原快照。 是。切換後,您可以在設定的保留期間轉返。
升級期間寫入 升級期間,寫入效能可能會降低。 升級執行時,不會影響主要叢集的寫入。寫入會遭到封鎖,直到切換完成為止。

如需費用的相關資訊,請參閱 升級費用。

升級前:

開始任一種升級之前:

  1. 建立您網域的手動快照。如果您想要返回使用之前的 OpenSearch 版本,此快照可作為備份,您可以在新的網域上還原。

  2. 檢查支援的升級路徑您目前和目標版本。複製型升級僅適用於執行 Elasticsearch 7.10 或 OpenSearch 1.1 或更新版本的網域。

  3. 執行升級前檢查,尋找可能封鎖升級的問題。這兩種類型的升級都會執行相同的檢查。如需詳細資訊,請參閱對驗證失敗進行故障排除。

  4. 如果您的網域使用受管災難復原,請先升級次要網域,最後升級主要網域。在以複製為基礎的升級之前,請移除複寫關係。如需詳細資訊,請參閱使用 DR 的升級網域。

支援的升級路徑

​OpenSearch Service 目前支援以下升級路徑:

下表中的每個路徑都可用於就地升級。

原始版本 目標版本
OpenSearch 1.3、2.x 或 3.x

OpenSearch 3.x

如果您正在執行 OpenSearch 1.3 或 2.x,您必須先升級至 OpenSearch 2.19,才能升級至 OpenSearch 3.x。

從 OpenSearch 2.19 升級到 OpenSearch 3.x 時,您可能需要解決下列不相容的索引設定。這些已在 2.x 中提早棄用,若未移除,將導致升級檢查驗證失敗。

  • index.knn.algo_param.ef_construction

  • index.knn.algo_param.m

  • index.knn.space_type

  • index.store.hybrid.mmap.extensions

如需已棄用索引設定和修復它們步驟的詳細資訊,請參閱索引設定。如需 OpenSearch 3.x 重大變更的完整清單,請參閱 3.0.0。

如果您的網域包含 OpenSearch 1.3、Elasticsearch 7.10 或舊版中建立的索引,您必須先重新建立索引,才能升級至 OpenSearch 3.x。OpenSearch 3.x 不支援這些較舊的索引,無論它們是在熱儲存、UltraWarm 儲存還是冷儲存中。若要重新索引不相容的 UltraWarm 或冷索引:

  1. 將索引遷移至熱儲存。

  2. 重新索引資料。

  3. 將索引遷移回暖儲存或冷儲存。

或者,如果您不再需要索引,請刪除索引。

在 OpenSearch 1.x 和 Elasticsearch 7.10 及更舊版本上拍攝的快照與 OpenSearch 3.x 不相容。

對於手動快照儲存庫,請先刪除這些不相容的快照,再升級至 OpenSearch 3.x。

OpenSearch 1.3 或 2.x

OpenSearch 2.x

如果網域滿足下列條件,則 OpenSearch 2.17 預設會使用自動模式啟用並行區段搜尋:

  • 不會明確設定先前的並行搜尋設定。

  • 所有資料執行個體 (熱和暖) 的執行個體類型為 .2xl 或更高。

  • 資料執行個體 (熱和暖) 上超過 1 週的平均 p90 cpu 使用率低於 45%。

    如需此處並行客群搜尋設定的詳細資訊,請參閱並行客群搜尋。

2.3 版具有以下突破性變更:

  • 在 2.0 版中,type 參數已從所有 OpenSearch API 端點移除。如需詳細資訊,請參閱 Breaking changes (突破性變更)。

  • 如果您的網域包含原先在 Elasticsearch 6.8 中建立的任何索引 (熱索引、UltraWarm 索引或冷索引),這些索引並不相容於 OpenSearch 2.3。

    升級至 2.3 版之前,您必須對不相容的索引重新編製索引。對於不相容的 UltraWarm 索引或冷索引,請將這些索引遷移至熱儲存、對資料重新編製索引,然後將它們遷移回暖儲存或冷儲存。或者,您也可以在不再需要時刪除索引。

    如果您意外將網域升級至 2.3 版,而未先執行這些步驟,則無法從目前的儲存層遷移出不相容的索引。您的唯一選項是刪除它們。

OpenSearch 1.x OpenSearch 1.x
Elasticsearch 7.x

Elasticsearch 7.x 或 OpenSearch 1.x

重要

OpenSearch 1.x 推出了許多突破性變更。如需詳細資訊,請參閱Amazon OpenSearch Service 重新命名:變更摘要。

Elasticsearch 6.8

Elasticsearch 7.x 或 OpenSearch 1.x

重要

Elasticsearch 7.0 和 OpenSearch 1.0 包括許多突破性的變更。在開始就地升級之前,我們建議應先針對 6.x 網域取得手動快照、在測試 7.x 或 OpenSearch 1.x 網域上還原,並使用該測試網域來識別潛在的升級問題。如需 OpenSearch 1.0 中的突破性變更,請參閱Amazon OpenSearch Service 重新命名:變更摘要。

如同 Elasticsearch 6.x,索引只能包含一個映射類型,但該類型現在必須名為 _doc。因此,特定 API 不再要求在請求內文中有映射類型 (例如 _bulk API)。

對於新的索引,自我託管的 Elasticsearch 7.x 和 OpenSearch 1.x 的預設碎片計數為 1。Elasticsearch 7.x 和更新版本中的 OpenSearch Service 網域保留之前的預設值 5。

Elasticsearch 6.x

Elasticsearch 6.x

Elasticsearch 5.6

Elasticsearch 6.x

重要

在 6.x 版建立的索引不再支援多個映射類型。在 5.x 版中建立的索引,在恢復為 6.x 叢集時仍支援多個​映射類型。請檢查您的用戶端程式碼是否每個索引只建立單一映射類型。

若要在從 Elasticsearch 5.6 升級到 6.x 期間將停機時間降到最低,OpenSearch Service​ 會將 .kibana​ 索引重新編製為 .kibana-6、刪除 .kibana、建立名為 .kibana​ 的別名以及將新的索引映射到新的別名。

Elasticsearch 5.x Elasticsearch 5.x

複製型升級適用於下列升級路徑:

  • Elasticsearch 7.10 到 OpenSearch 1.3

  • OpenSearch 1.1 到 1.3

  • OpenSearch 1.3 到 2.19

  • OpenSearch 2.x 到 2.19

  • OpenSearch 2.19 到 3.x

對於其他升級路徑,請使用就地升級。

就地升級的運作方式

就地升級包含三個步驟:

  1. 預先升級檢查​ – OpenSearch Service 會檢查是否有阻止升級的問題,且在這些檢查成功前都不會繼續下一個步驟。

  2. 快照​ ​-​ OpenSearch Service 會拍攝 OpenSearch 或 Elasticsearch 叢集的快照,且在快照成功拍攝前不會繼續至下一個步驟。如果升級失敗,OpenSearch Service​ 會使用此快照來將叢集恢復至其原始狀態。如需詳細資訊,請參閱 升級後無法降級。

  3. 升級 – OpenSearch Service 開始升級,這會需要 15 分鐘到數小時才能完成。OpenSearch Dashboards 在升級的部分或所有期間可能會無法使用。

複製型升級的運作方式

複製型升級包含下列步驟:

  1. 升級前檢查 – OpenSearch Service 執行與就地升級相同的檢查,除非成功,否則不會繼續。

  2. 快照 – OpenSearch Service 會擷取網域的快照,除非快照成功,否則不會繼續。

  3. 複製叢集建立 – OpenSearch Service 會在目標版本上建立網域的複製叢集,並將您的資料複製到其中。您的網域會繼續提供來自主要叢集的讀取和寫入,而複製的叢集會與您的資料保持同步。

  4. 驗證 – 當複製的叢集就緒時,升級會等待您完成。驗證複製的叢集,並選擇性地傳送讀取流量的份額給它。

  5. 切換 – 當您切換時,OpenSearch Service 會封鎖寫入,直到切換完成為止。在此期間,複製的叢集會追上進度,然後 OpenSearch Service 會將流量移至該叢集。您的網域端點不會變更。

  6. 保留期 (選用) – OpenSearch Service 會在您設定的保留期內保留主要叢集,讓您可以復原。此期間會在切換完成時開始。如果您未設定保留期間,OpenSearch Service 會在切換後立即刪除主要叢集。

您可以在切換之前隨時取消升級。OpenSearch Service 接著會刪除複製的叢集,而您的網域會保持原狀。如需有關驗證、轉換、取消和復原的資訊,請參閱 在以複製為基礎的升級期間驗證、轉換和復原。

複製型升級的限制

複製型升級有下列限制:

  • 您的網域必須執行 Elasticsearch 7.10 或 OpenSearch 1.1 或更新版本。如果您的網域執行較舊的版本,請先使用就地升級來達到支援的版本。

  • 不支援使用 OpenSearch Optimized 執行個體 (OR1 或 OR2) 的網域。

  • 不支援使用 UltraWarm 執行個體的網域。

  • 不支援使用跨叢集複寫的網域。

  • 如果您的網域使用受管災難復原,請在開始以複製為基礎的升級之前移除複寫關係,並在之後再次設定災難復原。如需詳細資訊,請參閱使用 DR 的升級網域。

  • 不支援具有關聯自訂或第三方外掛程式套件的網域。

  • 不支援針對 OpenSearch Dashboards 使用 SAML 身分驗證的網域。

  • 不支援針對 OpenSearch Dashboards 使用 Amazon Cognito 身分驗證的網域。

  • 您無法在升級期間變更網域的組態。

升級費用

就地升級不會產生額外費用。如果是以複製為基礎的升級,標準定價會套用至複製的執行個體和儲存體,就像您網域中的任何其他節點一樣。驗證複製時,會同時向您收取主要叢集和複製的費用。如果您保留主要叢集進行復原,則在保留期間結束之前,都會向您收取兩者的費用。

對驗證失敗進行故障排除

當您啟動 OpenSearch 或 Elasticsearch 版本升級時,OpenSearch Service 首先會執行一系列驗證檢查,以確保您的網域有資格進行升級。如果其中任何一項檢查失敗,您會收到通知,其中包含您必須在更新網域之前解決的特定問題。如需潛在問題的清單以及解決問題的步驟,請參閱 對驗證錯誤進行疑難排解。

升級疑難排解

升級需要運作狀態良好的網域。您的網域可能不符合升級的資格,或因各種原因而無法升級。下表顯示最常見的問題。

問題 描述
不支援選用外掛程式

當您使用選用外掛程式升級網域時,OpenSearch Service 也會自動升級外掛程式。因此,網域的目標版本也必須支援這些選用的外掛程式。如果網域已安裝不適用於目標版本的選用外掛程式,則升級請求會失敗。

每個節點有太多碎片 OpenSearch 以及 7.x 版本的 Elasticsearch 具有的預設設定為每個節點不超過 1,000 個碎片。如果您目前叢集中的節點超過此設定,則 OpenSearch Service 不允許您升級。如需疑難排解選項,請參閱超出最大碎片限制。
處理中的網域 組態變更中的網域 在操作完成後檢查升級資格。
紅色叢集狀態 叢集中一或多個索引是紅色的。如需疑難排解步驟,請參閱紅色叢集狀態。
高錯誤率 在嘗試處理請求時,叢集傳回大量的 5xx 錯誤。此問題通常是因為太多同時讀寫請求造成。請考慮降低叢集流量或擴展網域。
分割大腦 分割大腦表示叢集有不只一個主節點,且已分為兩個叢集,這兩個叢集將不會自行重新連結。您也可以使用建議數量的專用主節點來避免大腦分割。如需從大腦分割中恢復的協助,請聯絡 支援。
找不到主節點 OpenSearch Service​ 無法找到叢集的主節點。如果您的網域使用的是多個可用區,則可用區域故障可能會導致叢集遺失仲裁,且無法選擇新的主節點。如果問題無法自主解決,請聯絡支援。
待處理任務過多 主節點負載太重且待處理任務過多。請考慮降低叢集流量或擴展網域。
儲存磁碟區受損 一或多個節點的磁碟區無法正常運作。此問題通常與其他問題 (例如高錯誤率或待處理任務過多) 一起發生。如果此問題單獨發生且無法自主解決,請聯絡支援。
KMS 金鑰問題 用於加密網域的 KMS 金鑰無法存取或遺失。如需詳細資訊,請參閱監控靜態加密資料的網域。
快照處理中 網域正在拍攝快照。在快照完成後檢查升級資格。也確認您是否列出手動快照儲存庫、列出這些儲存庫中的快照與手動拍攝快照。如果 ​OpenSearch Service 無法確認快照是否在處理中,升級可能會生敗。
快照逾時或故障 預先升級快照耗時太久,無法完成或失敗。請檢查叢集的運作狀態並再試一次。如果問題仍存在,請聯絡 支援。
索引不相容 一或多個索引與目標版本不相容。如果您從舊版 OpenSearch 或 Elasticsearch 中遷移索引,就可能發生此問題。重新編製索引,然後重試。
高磁碟使用量 叢集的磁碟使用量超過 90%。篩除資料或擴展網域,然後重試。
高 JVM 用量 JVM 記憶體壓力超過 75%。​ 降低叢集的流量或擴展網域,然後重試。
OpenSearch Dashboards 別名問題 .dashboards 已設定為別名且映射到不相容的索引 (可能是舊版 OpenSearch Dashboards 的索引)。重新編製索引,然後再試一次。
紅色 Dashboards 狀態 Elasticsearch Dashboards 狀態為紅色。在升級完成時嘗試使用 Dashboards。如果紅色狀態仍持續,手動解決它,然後重試。
跨叢集相容性

只有在可維持升級後來源和目的地網域之間的跨叢集相容性的情況下,才能進行升級。在升級程序期間,系統會識別任何不相容的連線。若要繼續進行,請升級遠端網域或刪除不相容的連線。請注意,如果複寫在網域上處於啟用狀態,一旦刪除連線,就無法繼續複寫。

其他 OpenSearch Service 服務問題 OpenSearch Service ​本身的問題可能會使您的網域顯示為不符合升級資格。如果上述問題都不適用於您的網域,且問題持續超過一天,請聯絡支援。