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

Amazon OpenSearch Service 이름 변경 - 변경 사항 요약

2021년 9월 8일에 검색 및 분석 제품군의 이름이 Amazon OpenSearch Service로 변경되었습니다. OpenSearch Service는 OpenSearch 및 레거시 Elasticsearch OSS를 지원합니다. 다음 섹션에서는 이름 변경과 함께 변경된 서비스의 여러 부분과 도메인이 계속 제대로 작동하도록 하기 위해 수행해야 하는 작업에 대해 설명합니다.

이러한 변경 사항 중 일부는 도메인을 Elasticsearch에서 OpenSearch로 업그레이드할 때만 적용됩니다. Billing and Cost Management 콘솔과 같은 다른 경우에는 환경이 즉시 변경됩니다.

단, 이 목록이 전부는 아닙니다. 제품의 다른 부분도 변경되었지만 이러한 업데이트가 가장 적합합니다.

새로운 API 버전

새로운 버전의 OpenSearch Service 구성 API(2021년 1월 1일)는 기존 Elasticsearch OSS뿐만 아니라 OpenSearch와 함께 작동합니다. 21개의 API 작업이 보다 간결하고 엔진에 구애받지 않는 이름으로 대체되었지만(예:CreateElasticsearchDomain이 CreateDomain으로 변경 됨) OpenSearch Service는 두 가지 API 버전을 계속 지원합니다.

앞으로 새 API 작업을 사용하여 도메인을 생성하고 관리하는 것이 좋습니다. 새 API 작업을 사용하여 도메인을 생성할 때 EngineVersion 파라미터를 단순한 버전 번호가 아닌 Elasticsearch_X.Y 또는 OpenSearch_X.Y의 형식으로 지정해야 합니다. 버전을 지정하지 않을 경우 기본값은 최신 버전의 OpenSearch로 설정됩니다.

aws opensearch ...를 사용하여 도메인을 생성하고 관리하려면 AWS CLI를 버전 1.20.40 이상으로 업그레이드하세요. 새로운 CLI 형식은 OpenSearch CLI 참조를 참조하세요.

인스턴스 유형의 이름 변경

이제 Amazon OpenSearch Service 인스턴스 유형의 형식은 <type>.<size>.search입니다(예: m6g.large.elasticsearch가 아닌 m6g.large.search). 별도의 조치를 할 필요는 없습니다. 기존 도메인은 API 및 Billing and Cost Management 콘솔에서 새 인스턴스 유형을 자동으로 참조하기 시작합니다.

예약 인스턴스(RI)가 있는 경우 계약은 변경의 영향을 받지 않습니다. 이전 구성 API 버전은 이전 명명 형식과 계속 호환되지만 새 API 버전을 사용하려면 새 형식을 사용해야 합니다.

액세스 정책 변경 사항

다음 섹션에서는 액세스 정책을 업데이트하기 위해 수행해야 하는 작업에 대해 설명합니다.

IAM 정책

이름이 바뀐 API 작업을 사용하려면 IAM 정책을 업데이트하는 것이 좋습니다. 그러나 OpenSearch Service는 이전 API 권한을 내부적으로 복제하여 기존 정책을 계속 준수합니다. 예를 들어, 현재 CreateElasticsearchDomain 작업을 수행할 수 있는 권한이 있는 경우 이제 CreateElasticsearchDomain(이전 API 작업) 및 CreateDomain(새 API 작업)을 모두 호출할 수 있습니다. 명시적 거부에도 동일하게 적용됩니다. 업데이트된 API 작업 목록은 정책 요소 참조를 참조하세요.

SCP 정책

서비스 제어 정책(SCP)은 표준 IAM에 비해 복잡성을 다시 한번 가중합니다. SCP 정책이 중단되는 것을 방지하려면 이전 및 새로운 API 작업을 모두 각 SCP 정책에 추가해야 합니다. 예를 들어, 사용자가 현재 CreateElasticsearchDomain에 대한 허용 권한이 있는 경우, CreateDomain에 대한 허용 권한도 부여하여 이들이 계속 도메인을 생성할 수 있도록 해야 합니다. 명시적 거부에도 동일하게 적용됩니다.

예제:

"Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "es:CreateElasticsearchDomain",
        "es:CreateDomain"
         ...
      ],
    },
      "Effect": "Deny",
      "Action:" [
        "es:DeleteElasticsearchDomain",
        "es:DeleteDomain"
         ...

새로운 리소스 유형

OpenSearch Service는 다음과 같은 새로운 리소스 유형을 도입합니다.

Kibana의 이름이 OpenSearch Dashboards로 변경

AWS 대신 사용되는 OpenSearch Dashboards는 OpenSearch와 함께 작동하도록 제작된 오픈 소스 시각화 도구입니다. Elasticsearch에서 OpenSearch로 도메인을 업그레이드하면 /_plugin/kibana 엔드포인트가 /_dashboards로 변경됩니다. OpenSearch Service는 모든 요청을 새 엔드포인트로 리디렉션하지만 IAM 정책에서 Kibana 엔드포인트를 사용하는 경우 새로운 /_dashboards 엔드포인트도 포함하도록 해당 정책을 업데이트합니다.

SAML OpenSearch 대시보드 인증을 사용하는 경우 도메인을 OpenSearch로 업그레이드하기 전에 자격 증명 공급자(IdP)에 구성된 모든 Kibana URL을 /_plugin/kibana에서 /_dashboards로 변경해야 합니다. 가장 일반적인 URL은 Assertion Consumer Service(ACS) 및 수신자 URL입니다.

OpenSearch Dashboards의 기본 kibana_read_only 역할이 opensearch_dashboards_read_only(으)로 이름이 변경되었으며 kibana_user 역할이 opensearch_dashboards_user(으)로 이름이 변경되었습니다. 변경 사항은 모든 서비스 소프트웨어 R20211203 이상이 설치된 새로 생성된 OpenSearch 1.x도메인에 적용됩니다. 기존 도메인을 서비스 소프트웨어 R20211203으로 업그레이드하 경우 역할 이름은 동일하게 유지됩니다.

CloudWatch 지표의 이름 변경

OpenSearch를 실행하는 도메인에 대한 CloudWatch 지표가 몇 가지 변경되었습니다. 도메인을 OpenSearch로 업그레이드하면 지표가 자동으로 변경되고 현재 CloudWatch 경보가 중단됩니다. 클러스터를 Elasticsearch 버전에서 OpenSearch 버전으로 업그레이드하기 전에 새 지표를 사용하도록 CloudWatch 경보를 업데이트해야 합니다.

다음 지표가 변경되었습니다.

OpenSearch Services가 Amazon CloudWatch로 전송하는 지표의 전체 목록은 Amazon을 통한 OpenSearch 클러스터 지표 모니터링 CloudWatch를 참조하세요.

Billing and Cost Management 콘솔 변경 사항

결제 및 비용 관리 콘솔 및 비용 및 사용 보고서의 기록 데이터는 이전 서비스 이름을 계속 사용하므로 데이터를 검색할 때 Amazon OpenSearch Service와 레거시 Elasticsearch 이름 모두에 대한 필터를 사용해야 합니다. 기존의 저장된 보고서가 있는 경우 필터를 업데이트하여 OpenSearch Service도 포함하도록 합니다. Elasticsearch의 사용량이 감소하고 OpenSearch의 사용량이 증가하면 처음에 알림이 표시될 수 있지만 며칠 이내에 사라집니다.

서비스 이름 외에도 다음 필드는 모든 보고서, 청구서, 가격 목록 API 작업에서 변경됩니다.

새로운 이벤트 형식

OpenSearch Service가 Amazon EventBridge와 Amazon CloudWatch에 전송하는 이벤트 형식이 변경되었습니다. 특히 detail-type 필드가 변경되었습니다. 소스 필드(aws.es)는 동일하게 유지됩니다. 각 이벤트 유형에 대한 전체 형식은 Amazon을 통한 OpenSearch 서비스 이벤트 모니터링 EventBridge 섹션을 참조하세요. 이전 형식에 따라 달라지는 기존 이벤트 규칙이 있는 경우 새 형식에 맞게 업데이트해야 합니다.

변경되지 않는 것은 무엇입니까?

나열되지 않은 기능 중 다음 기능은 동일하게 유지됩니다.

시작하기: 도메인을 OpenSearch 1.x로 업그레이드

OpenSearch 1.x는 Elasticsearch 버전 6.8 및 7.x에서의 업그레이드를 지원합니다. 도메인을 업그레이드하는 방법에 대한 지침은 업그레이드 시작(콘솔) 섹션을 참조하세요. AWS CLI 또는 구성 API를 사용하여 도메인을 업그레이드하려면 TargetVersion을 OpenSearch_1.x으로 지정해야 합니다.

OpenSearch 1.x에 호환성 모드 사용 설정이라는 추가 도메인 설정이 도입되었습니다. 특정 Elasticsearch OSS 클라이언트 및 플러그인은 연결하기 전에 클러스터 버전을 확인하기 때문에 호환성 모드에서는 OpenSearch가 해당 버전을 7.10으로 보고하도록 설정하여 이러한 클라이언트가 계속 작동하도록 합니다.

OpenSearch 도메인을 처음 생성하거나 Elasticsearch 버전에서 OpenSearch로 업그레이드할 때 호환성 모드를 활성화할 수 있습니다. 설정되지 않은 경우 파라미터의 기본값은 도메인을 생성할 때 false, true도메인을 업그레이드할 때입니다.

구성 API를 사용하여 호환성 모드를 활성화하려면, override_main_response_version을 true로 설정합니다.

POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/upgradeDomain
{
  "DomainName": "domain-name",
  "TargetVersion": "OpenSearch_1.0",
  "AdvancedOptions": {
    "override_main_response_version": "true"
   }
}

기존 OpenSearch 도메인에서 호환성 모드를 활성화 또는 비활성화하려면 OpenSearch _cluster/settings API 작업을 사용해야 합니다.

PUT /_cluster/settings
{
  "persistent" : {
    "compatibility.override_main_response_version" : true
  }
}