Amazon OpenSearch Service의 서비스 소프트웨어 업데이트

start-service-software-update AWS CLI 요청을 보내 서비스 소프트웨어 업데이트를 시작하세요. 이 예제에서는 업데이트를 대기열에 즉시 추가합니다.

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
    }
}

BaseException를 통한 요청이 실패하면 용량상의 이유로 지정한 시간을 사용할 수 없으므로 다른 시간을 지정해야 합니다. OpenSearch Service는 응답에서 사용 가능한 대체 시간대를 제안합니다.

이 샘플 Python 스크립트는 AWS SDK for Python (Boto3)에서 describe_domain 및 start_service_software_update 메소드를 사용해 도메인이 서비스 소프트웨어 업데이트에 적합한지 확인하고, 적합하다면 업데이트를 시작합니다. domain_name의 값을 제공해야 합니다.

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)

사용량이 적은 기간 탭에서 예약된 작업을 확인하고 언제든지 일정을 조정할 수 있습니다. 예약된 작업 보기 섹션을 참조하세요.

AWS CLI를 사용하여 다가오는 사용량이 적은 기간에 업데이트를 예약하려면 StartServiceSoftwareUpdate 요청을 보내고 --schedule-at 파라미터에 대해 OFF_PEAK_WINDOW을 지정합니다.

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