기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

아마존 OpenSearch 서비스 도메인 업그레이드

Amazon OpenSearch 서비스는 OpenSearch 1.0 이상 또는 Elasticsearch 5.1 이상을 실행하는 도메인에 대해 인플레이스 업그레이드를 제공합니다. Amazon Data Firehose 또는 Amazon CloudWatch Logs와 같은 서비스를 사용하여 OpenSearch 서비스로 데이터를 스트리밍하는 경우, 마이그레이션하기 전에 이러한 서비스가 최신 버전의 OpenSearch 를 지원하는지 확인하십시오.

지원되는 업그레이드 경로

현재 OpenSearch 서비스는 다음과 같은 업그레이드 경로를 지원합니다.

업그레이드 프로세스는 세 단계로 구성됩니다.

업그레이드 시작(콘솔)

업그레이드 프로세스는 되돌릴 수 없으며 일시 중지 또는 취소할 수 없습니다. 업그레이드 도중에는 도메인에서 구성을 변경할 수 없습니다. 업그레이드를 시작하기 전에 진행해도 좋은지 다시 한번 확인하세요. 동일한 단계를 사용해 실제로 업그레이드를 시작하지 않고 업그레이드 전 점검을 수행할 수 있습니다.

클러스터에 전용 마스터 노드가 있는 경우 다운타임 없이 OpenSearch 업그레이드가 완료됩니다. 그렇지 않으면 클러스터가 업그레이드 후 프라이머리 노드를 선택하는 몇 초 동안 응답하지 않을 수도 있습니다.

업그레이드 시작(CLI)

다음 작업을 사용하여 도메인의 올바른 버전 OpenSearch 또는 Elasticsearch를 식별하고, 전체 업그레이드를 시작하고, 업그레이드 전 검사를 수행하고, 진행 상황을 확인할 수 있습니다.

자세한 내용은 AWS CLI 명령 참조 및 Amazon OpenSearch 서비스 API 참조를 참조하십시오.

업그레이드 시작(SDK)

이 샘플은 의 OpenSearchService저수준 Python 클라이언트를 사용하여 도메인이 특정 버전으로 업그레이드할 수 있는지 확인하고, 업그레이드하고, 업그레이드 상태를 지속적으로 확인합니다. AWS SDK for Python (Boto)

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.

DOMAIN_NAME = ''  # The name of the domain to upgrade
TARGET_VERSION = ''  # The version you want to upgrade the domain to. For example, OpenSearch_1.1

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


def check_versions():
    """Determine whether domain is eligible for upgrade"""
    response = client.get_compatible_versions(
        DomainName=DOMAIN_NAME
    )
    compatible_versions = response['CompatibleVersions']
    for i in range(len(compatible_versions)):
        if TARGET_VERSION in compatible_versions[i]["TargetVersions"]:
            print('Domain is eligible for upgrade to ' + TARGET_VERSION)
            upgrade_domain()
            print(response)
        else:
            print('Domain not eligible for upgrade to ' + TARGET_VERSION)


def upgrade_domain():
    """Upgrades the domain"""
    response = client.upgrade_domain(
        DomainName=DOMAIN_NAME,
        TargetVersion=TARGET_VERSION
    )
    print('Upgrading domain to ' + TARGET_VERSION + '...' + response)
    time.sleep(5)
    wait_for_upgrade()


def wait_for_upgrade():
    """Get the status of the upgrade"""
    response = client.get_upgrade_status(
        DomainName=DOMAIN_NAME
    )
    if (response['UpgradeStep']) == 'UPGRADE' and (response['StepStatus']) == 'SUCCEEDED':
        print('Domain successfully upgraded to ' + TARGET_VERSION)
    elif (response['StepStatus']) == 'FAILED':
        print('Upgrade failed. Please try again.')
    elif (response['StepStatus']) == 'SUCCEEDED_WITH_ISSUES':
        print('Upgrade succeeded with issues')
    elif (response['StepStatus']) == 'IN_PROGRESS':
        time.sleep(30)
        wait_for_upgrade()


def main():
    check_versions()


if __name__ == "__main__":
    main()

검증 장애 문제 해결

Elasticsearch 버전 업그레이드를 시작하면 OpenSearch 서비스는 먼저 일련의 검증 검사를 수행하여 도메인이 업그레이드에 적합한지 확인합니다. OpenSearch 이러한 검사 중 하나라도 실패하면 도메인을 업그레이드하기 전에 수정해야 하는 특정 문제가 포함된 알림을 받게 됩니다. 잠재적 문제 목록 및 문제 해결 단계는 Troubleshooting validation errors(검증 오류 문제 해결 중)을 참조하세요.

업그레이드 문제 해결

인플레이스 업그레이드는 정상 상태 도메인이 필요합니다. 도메인은 업그레이드 자격이 없거나 매우 다양한 이유로 업그레이드가 실패할 수 있습니다. 다음 표에는 가장 일반적인 문제가 나와 있습니다.

스냅샷을 사용하여 데이터 마이그레이션

인플레이스 업그레이드는 도메인을 최신 버전 OpenSearch 또는 Elasticsearch 버전으로 업그레이드하는 더 쉽고 빠르며 안정적인 방법입니다. 스냅샷은 5.1 이전 버전의 Elasticsearch에서 마이그레이션하거나 완전히 새 클러스터로 마이그레이션하려는 경우 적합한 옵션입니다.

다음 표는 스냅샷을 사용하여 다른 OpenSearch 버전 또는 Elasticsearch 버전을 사용하는 도메인으로 데이터를 마이그레이션하는 방법을 보여줍니다. 스냅샷 생성 및 복원에 대한 자세한 내용은 Amazon OpenSearch 서비스에서 인덱스 스냅샷 생성 섹션을 참조하세요.