Amazon OpenSearch Ingestion 파이프라인 업데이트 - Amazon OpenSearch Service
고려 사항필요한 권한파이프라인 업데이트파이프라인 업데이트를 위한 블루/그린 배포

Amazon OpenSearch Ingestion 파이프라인 업데이트

AWS Management Console, AWS CLI 또는 OpenSearch Ingestion API를 사용하여 Amazon OpenSearch Ingestion 파이프라인을 업데이트할 수 있습니다. OpenSearch Ingestion은 파이프라인의 YAML 구성을 업데이트할 때 블루/그린 배포를 시작합니다. 자세한 내용은 파이프라인 업데이트를 위한 블루/그린 배포 단원을 참조하십시오.

고려 사항

파이프라인을 업데이트할 때 다음 사항을 고려하세요.

  • 파이프라인의 용량 제한, 로그 게시 옵션, YAML 구성을 편집할 수 있습니다. 이름 또는 네트워크 설정은 편집할 수 없습니다.

  • 파이프라인이 VPC 도메인 싱크에 쓰는 경우, 파이프라인이 생성된 후에는 되돌아가서 다른 VPC 도메인으로 싱크를 변경할 수 없습니다. 파이프라인을 삭제하고 새 싱크로 재생성해야 합니다. VPC 도메인에서 퍼블릭 도메인으로, 퍼블릭 도메인에서 VPC 도메인으로 또는 퍼블릭 도메인에서 다른 퍼블릭 도메인으로 싱크를 전환할 수 있습니다.

  • 퍼블릭 OpenSearch Service 도메인과 OpenSearch Serverless 컬렉션 간에 언제든지 파이프라인 싱크를 전환할 수 있습니다.

  • OpenSearch Ingestion은 파이프라인의 YAML 구성을 업데이트할 때 블루/그린 배포를 시작합니다. 자세한 내용은 파이프라인 업데이트를 위한 블루/그린 배포 단원을 참조하십시오.

  • 파이프라인의 YAML 구성을 업데이트하면 OpenSearch Ingestion은 파이프라인을 파이프라인 구성에 지정된 Data Prepper 메이저 버전에 대해 지원되는 최신 마이너 버전으로 자동 업그레이드합니다. 이 프로세스를 통해 최신 버그를 수정하고 성능을 개선하여 파이프라인을 최신 상태로 유지할 수 있습니다.

  • 파이프라인이 중지된 후에도 여전히 파이프라인을 업데이트할 수 있습니다.

필요한 권한

OpenSearch Ingestion은 다음 IAM 권한을 사용하여 파이프라인을 업데이트합니다.

  • osis:UpdatePipeline - 파이프라인을 업데이트합니다.

  • osis:ValidatePipeline— 파이프라인 구성이 유효한지 확인하세요.

  • iam:PassRole - OpenSearch Ingestion에 파이프라인 역할을 전달하여 도메인에 데이터를 쓸 수 있도록 합니다. 이 권한은 파이프라인 YAML 구성을 업데이트하는 경우에만 필요하며 로그 게시나 용량 제한과 같은 다른 설정을 수정하는 경우에는 필요하지 않습니다.

예를 들어 다음 정책에서 파이프라인을 업데이트할 권한을 부여합니다.

{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Effect":"Allow",
         "Resource":"*",
         "Action":[
            "osis:UpdatePipeline",
            "osis:ValidatePipeline"
         ]
      },
      {
         "Resource":[
            "arn:aws:iam::{your-account-id}:role/{pipeline-role}"
         ],
         "Effect":"Allow",
         "Action":[
            "iam:PassRole"
         ]
      }
   ]
}

파이프라인 업데이트

AWS Management Console, AWS CLI 또는 OpenSearch Ingestion API를 사용하여 Amazon OpenSearch Ingestion 파이프라인을 업데이트할 수 있습니다.

파이프라인을 업데이트하려면

  1. https://console.aws.amazon.com/aos/home에서 Amazon OpenSearch Service 콘솔에 로그인합니다.

  2. 왼쪽 탐색 창에서 파이프라인을 선택합니다.

  3. 파이프라인을 선택하여 해당 설정을 엽니다. 파이프라인의 용량 제한, 로그 게시 옵션, YAML 구성을 편집할 수 있습니다. 이름 또는 네트워크 설정은 편집할 수 없습니다.

  4. 변경 작업을 마치면 저장을 선택합니다.

AWS CLI을 사용하여 파이프라인을 업데이트하려면 파이프라인 업데이트 요청을 보내세요. 다음 샘플 요청은 새 구성 파일을 업로드하고 최소 및 최대 용량 값을 업데이트합니다.

aws osis update-pipeline \
  --pipeline-name "my-pipeline" \
  --pipline-configuration-body "file://new-pipeline-config.yaml" \
  --min-units 11 \
  --max-units 18

OpenSearch Ingestion API를 사용하여 OpenSearch Ingestion 파이프라인을 업데이트하려면 UpdatePipeline 작업을 호출하세요.

파이프라인 업데이트를 위한 블루/그린 배포

OpenSearch Ingestion은 파이프라인의 YAML 구성을 업데이트할 때 블루/그린 배포 프로세스를 시작합니다.

블루/그린은 파이프라인 업데이트용으로 새 환경을 만들고 업데이트가 완료되면 트래픽을 새 환경으로 라우팅하는 관행을 지칭합니다. 이렇게 하면 가동 중지가 최소화되고, 새로운 환경에 배포하는 데 실패하더라도 원래의 환경이 유지됩니다. 블루/그린 배포 자체는 성능에 영향을 주지 않지만, 파이프라인 구성이 성능을 변경하는 방식으로 변경되면 성능이 변경될 수 있습니다.

OpenSearch Ingestion은 블루/그린 배포 중에 Auto Scaling을 차단합니다. 새 파이프라인으로 리디렉션되기 전까지는 이전 파이프라인으로 향하는 트래픽에 대해서만 계속 요금이 부과됩니다. 트래픽이 리디렉션되면 새 파이프라인에 대한 비용만 청구됩니다. 두 파이프라인에 대해 동시에 요금이 청구되는 일은 없습니다.

파이프라인의 YAML 구성 파일을 업데이트하면 OpenSearch Ingestion은 파이프라인을 파이프라인 구성에 지정된 Data Prepper 메이저 버전의 지원되는 최신 마이너 버전으로 자동 업그레이드합니다. 예를 들어, 파이프라인 구성에 version: "2"이 있고 OpenSearch Ingestion이 처음에 파이프라인을 버전 2.1.0으로 프로비저닝했을 수 있습니다. 버전 2.1.1에 대한 지원이 추가되고 파이프라인 구성을 변경하면 OpenSearch Ingestion은 파이프라인을 버전 2.1.1로 업그레이드합니다.

이 프로세스를 통해 최신 버그를 수정하고 성능을 개선하여 파이프라인을 최신 상태로 유지할 수 있습니다. OpenSearch Ingestion은 파이프라인 구성 내에서 version 옵션을 수동으로 변경하지 않는 한 파이프라인의 메이저 버전을 업데이트할 수 없습니다.