Amazon OpenSearch Service 中的服務軟體更新

Amazon OpenSearch Service 會定期發行服務軟體更新以新增功能或強化您的網域。主控台中的 Notifications (通知) 面板是查看更新是否可用或檢查更新狀態的最簡單方法。每個通知都包含有關服務軟體更新的詳細資訊。所有服務軟體更新都使用藍/綠部署，將停機時間降至最低。

服務軟體更新與 OpenSearch Service 版本升級不同。如需有關升級至較新版本的 OpenSearch Service 的資訊，請參閱 升級 Amazon OpenSearch Service 網域。

OpenSearch Service 會要求您在所需的服務軟體更新可供使用的 30 天內套用。這些更新對於維護安全合規至關重要。

如果您未在 30 天內套用必要的更新，您將在 30 天內每 15 天收到提醒通知。在這段期間不合規的情況下，您的網域將會隔離，並產生下列效果：

在隔離期間，您將繼續每 15 天收到提醒通知，為期 60 天。如果您在此期間未套用必要的更新，您的 OpenSearch Service 網域和所有相關資料都會永久刪除。如需詳細資訊，請參閱疑難排解驗證錯誤。

選用與必要的更新

OpenSearch Service 有兩種廣泛的服務軟體更新類別：

選用更新

選用的服務軟體更新通常包括增強功能和對新功能或功能的支援。您的網域不會強制執行選用更新，也沒有安裝它們的硬性截止日期。更新可用性會透過電子郵件和主控台通知進行通訊。您可以選擇立即套用更新，或將其重新排程為更適當的日期和時間。您也可以在網域的離峰時段進行排程。大多數軟體更新都是選用的。

無論您是否排程更新，如果您在網域上進行造成藍/綠部署的變更，OpenSearch Service 都會為您自動更新服務軟體。

您可以將網域設定為在離峰時間自動套用選用更新。開啟此選項時，OpenSearch Service 會在選用更新可用後等待至少 13 天，然後在七天後排程更新。排定更新時，您會收到主控台通知，您可以選擇在稍後日期重新排定更新。

若要開啟自動軟體更新，請選取建立或更新網域時啟用自動軟體更新。若要使用 設定相同的設定 AWS CLI，請在建立或更新網域true時將 --software-update-options設定為 。

必要的更新

必要的服務軟體更新通常包括重要的安全性修正或其他強制性更新，以確保網域的持續完整性和功能。所需更新的範例包括 Log4j 常見漏洞與暴露 (CVEs) 和執行個體中繼資料服務第 2 版 (IMDSv2) 的強制執行。一年中的強制性更新數量通常少於三個。

OpenSearch Service 會自動排程這些更新，並在排定的更新七天前透過電子郵件和主控台通知通知您。您可以選擇立即套用更新，或在允許的時間範圍內重新排程更適當的日期和時間。您也可以在網域的下一個離峰時段進行排程。如果您未對必要的更新採取任何動作，且未進行任何導致藍/綠部署的網域變更，OpenSearch Service 可以在網域的離峰時段內超過指定截止日期 （通常為自可用性起 14 天） 的任何時間啟動更新。

無論何時排定更新，如果您變更網域而導致藍/綠部署，OpenSearch Service 會自動為您更新網域。

修補程式更新

以 "-P" 和數字結尾的服務軟體版本，例如 R20211203-P4，是修補程式版本。修補程式可能包括效能改進、小錯誤修復、安全修復或狀態改善。修補程式版本不包含新功能或重大變更，而且通常不會對使用者造成直接或明顯的影響。服務軟體通知會告訴您修補程式版本是選用還是強制性。

考量事項

在決定是否要更新網域時，請考慮下列各項：

啟動服務軟體更新

您可以透過 OpenSearch Service 主控台、 AWS CLI或其中一個 SDKs 請求服務軟體更新。

aws opensearch start-service-software-update \
  --domain-name my-domain \
  --schedule-at "NOW"

{
    "ServiceSoftwareOptions": {
        "CurrentVersion": "R20220928-P1",
        "NewVersion": "R20220928-P2",
        "UpdateAvailable": true,
        "Cancellable": true,
        "UpdateStatus": "PENDING_UPDATE",
        "Description": "",
        "AutomatedUpdateDate": "1969-12-31T16:00:00-08:00",
        "OptionalDeployment": true
    }
}

import boto3
from botocore.config import Config
import time

# Build the client using the default credential configuration.
# You can use the CLI and run 'aws configure' to set access key, secret
# key, and default region.

my_config = Config(
    # Optionally lets you specify a Region other than your default.
    region_name='us-east-1'
)

domain_name = ''  # The name of the domain to check and update

client = boto3.client('opensearch', config=my_config)


def getUpdateStatus(client):
    """Determines whether the domain is eligible for an update"""
    response = client.describe_domain(
        DomainName=domain_name
    )
    sso = response['DomainStatus']['ServiceSoftwareOptions']
    if sso['UpdateStatus'] == 'ELIGIBLE':
        print('Domain [' + domain_name + '] is eligible for a service software update from version ' +
              sso['CurrentVersion'] + ' to version ' + sso['NewVersion'])
        updateDomain(client)
    else:
        print('Domain is not eligible for an update at this time.')


def updateDomain(client):
    """Starts a service software update for the eligible domain"""
    response = client.start_service_software_update(
        DomainName=domain_name
    )
    print('Updating domain [' + domain_name + '] to version ' +
          response['ServiceSoftwareOptions']['NewVersion'] + '...')
    waitForUpdate(client)


def waitForUpdate(client):
    """Waits for the domain to finish updating"""
    response = client.describe_domain(
        DomainName=domain_name
    )
    status = response['DomainStatus']['ServiceSoftwareOptions']['UpdateStatus']
    if status == 'PENDING_UPDATE' or status == 'IN_PROGRESS':
        time.sleep(30)
        waitForUpdate(client)
    elif status == 'COMPLETED':
        print('Domain [' + domain_name +
              '] successfully updated to the latest software version')
    else:
        print('Domain is not currently being updated.')

def main():
    getUpdateStatus(client)

在離峰時段期間排程軟體更新

在 2023 年 2 月 16 日之後建立的每個 OpenSearch Service 網域，其每日 10 小時時段介於當地時間下午 10：00 到上午 8：00 之間，我們認為是離峰時段。OpenSearch Service 使用此時段來排程網域的服務軟體更新。離峰更新有助於在較高的流量期間，將叢集專用主節點上的壓力降至最低。未經您的同意，OpenSearch Service 無法在此 10 小時時段之外啟動更新。

對於每個網域，您可以選擇以自訂時間覆寫預設的下午 10：00 開始時間。如需說明，請參閱設定自訂離峰時段。

aws opensearch start-service-software-update \
  --domain-name my-domain \
  --schedule-at "OFF_PEAK_WINDOW"

監控服務軟體更新

OpenSearch Service 會在服務軟體更新可用、必要、已啟動、已完成或失敗時傳送通知。您可以在 OpenSearch Service 主控台的通知面板中檢視通知。如果更新為可選，則通知嚴重性為 Informational；如果必須更新，則為 High。

OpenSearch Service 也會將服務軟體事件傳送至 Amazon EventBridge。您可以使用 EventBridge 設定傳送電子郵件的規則，或在接收事件時執行特定動作。如需逐步解說範例，請參閱 教學課程：可用軟體更新的 Amazon SNS 提醒。

若要查看傳送至 Amazon EventBridge 的每個服務軟體事件的格式，請參閱 服務軟體更新事件。

網域不符合更新條件時，

如果您的網域處於以下任何一種狀態，則不符合服務軟體更新的資格：

復原服務軟體更新

Amazon OpenSearch Service 支援轉返服務軟體更新。您可以使用 OpenSearch Service 主控台、 AWS CLI或其中一個 AWS SDKs 來啟動轉返。軟體更新會使用藍/綠部署轉返。

轉返資格和考量事項

您的網域必須符合下列所有條件，才能使用轉返：

回復時段

復原視窗取決於套用的軟體更新類型。

回復時段過期後，自助式回復不再可用。支援 如果您在視窗關閉後遇到重大問題，請聯絡 。

如何請求轉返

您可以使用 RollbackServiceSoftwareUpdate API 請求轉返。

請求

POST /2021-01-01/opensearch/serviceSoftwareUpdate/rollback

請求內文：

{
    "DomainName": "your-domain-name"
}

回應

API 會在所有非錯誤情況下傳回 HTTP 200 回應。回應內文中的 RollbackAvailable 欄位指出是否啟動轉返。

{
    "RollbackServiceSoftwareOptions": {
        "CurrentVersion": "string",
        "NewVersion": "string",
        "RollbackAvailable": boolean,
        "Description": "string"
    }
}

回應欄位：

錯誤回應

回應訊息

下表說明 RollbackServiceSoftwareUpdate API 傳回的可能回應訊息。

回應範例：

{
    "RollbackServiceSoftwareOptions": {
        "CurrentVersion": "OpenSearch_2_11_R20240115",
        "NewVersion": "OpenSearch_2_11_R20231023",
        "RollbackAvailable": true,
        "Description": "Rollback initiated successfully. The domain will be rolled back from OpenSearch_2_11_R20240115 to OpenSearch_2_11_R20231023."
    }
}

當無法使用轉返時， 會RollbackAvailable傳回 ，false而 Description 欄位包含上表中的原因。