AWS CloudFormation 를 사용하여 Streams 소비자 애플리케이션으로 복제 설정 Neptune-to-Neptune

AWS CloudFormation 템플릿을 사용하여 복제를 지원 Neptune-to-Neptune하도록 Neptune 스트림 소비자 애플리케이션을 설정할 수 있습니다.

리전의 AWS CloudFormation 템플릿 선택

AWS CloudFormation 콘솔에서 적절한 AWS CloudFormation 스택을 시작하려면 사용하려는 리전에 따라 AWS 다음 테이블에서 스택 시작 버튼 중 하나를 선택합니다.

리전	보기	Designer에서 보기	시작
미국 동부(버지니아 북부)	보기	Designer에서 보기
미국 동부(오하이오)	보기	Designer에서 보기
미국 서부(캘리포니아 북부)	보기	Designer에서 보기
미국 서부(오레곤)	보기	Designer에서 보기
캐나다(중부)	보기	Designer에서 보기
남아메리카(상파울루)	보기	Designer에서 보기
유럽(스톡홀름)	보기	Designer에서 보기
유럽(아일랜드)	보기	Designer에서 보기
유럽(런던)	보기	Designer에서 보기
유럽(파리)	보기	Designer에서 보기
유럽(프랑크푸르트)	보기	Designer에서 보기
중동(바레인)	보기	Designer에서 보기
중동(UAE)	보기	Designer에서 보기
이스라엘(텔아비브)	보기	Designer에서 보기
아프리카(케이프타운)	보기	Designer에서 보기
아시아 태평양(도쿄)	보기	Designer에서 보기
아시아 태평양(홍콩)	보기	Designer에서 보기
아시아 태평양(서울)	보기	Designer에서 보기
아시아 태평양(싱가포르)	보기	Designer에서 보기
아시아 태평양(시드니)	보기	Designer에서 보기
아시아 태평양(뭄바이)	보기	Designer에서 보기
중국(베이징)	보기	Designer에서 보기
중국(닝샤)	보기	Designer에서 보기
AWS GovCloud (미국 서부)	보기	Designer에서 보기
AWS GovCloud (미국 동부)	보기	Designer에서 보기

스택 생성 페이지에서 다음을 선택합니다.

생성 중인 Neptune 스트림 소비자 스택에 대한 세부 정보 추가

스택 세부 정보 지정 페이지에서는 애플리케이션 설정을 제어하는 데 사용할 수 있는 속성 및 파라미터를 제공합니다.

스택 이름 - 생성하는 새 AWS CloudFormation 스택의 이름입니다. 대개 기본값(NeptuneStreamPoller)을 사용합니다.

파라미터에서 다음을 제공합니다.

스트림 소비자가 실행되는 VPC 위치에 대한 네트워크 구성

• VPC – 폴링 Lambda 함수VPC가 실행되는 의 이름을 입력합니다.

• SubnetIDs   –   네트워크 인터페이스가 설정된 서브넷입니다. Neptune 클러스터에 해당하는 서브넷을 추가합니다.

• SecurityGroupIds – 소스 Neptune DB 클러스터IDs에 대한 쓰기 인바운드 액세스 권한을 부여하는 보안 그룹의 를 제공합니다.

• RouteTableIds - Neptune에 Amazon DynamoDB 엔드포인트가 아직 없는 경우 VPC이를 생성하는 데 필요합니다. 서브넷과 IDs 연결된 라우팅 테이블의 쉼표로 구분된 목록을 제공해야 합니다.

• CreateDDBVPCEndPoint - Dynamo DB VPC 엔드포인트를 생성해야 하는지 여부를 true나타내는 부울 값입니다. 에서 DynamoDB 엔드포인트를 이미 생성한 false 경우에만 로 변경해야 합니다VPC.

• CreateMonitoringEndPoint - 모니터링 VPC 엔드포인트를 생성해야 하는지 여부를 true나타내는 부울 값입니다. 에서 모니터링 엔드포인트를 이미 생성한 false 경우에만 로 변경해야 합니다VPC.

스트림 폴러

• ApplicationName   –   이 설정은 대개 기본값(NeptuneStream)으로 둡니다. 다른 이름을 사용하는 경우 고유한 이름이어야 합니다.

• LambdaMemorySize   –  Lambda 폴러 함수에 사용 가능한 메모리 크기를 설정하는 데 사용됩니다. 기본값은 2,048MB입니다.

• LambdaRuntime   –   Neptune 스트림에서 항목을 검색하는 Lambda 함수에서 사용되는 언어입니다. python3.9 또는 java8로 설정할 수 있습니다.

• LambdaS3Bucket   –   Lambda 코드 아티팩트가 포함된 Amazon S3 버킷입니다. 다른 Amazon S3 버킷에서 로드하는 사용자 지정 Lambda 폴링 함수를 사용하지 않는 경우 비워둡니다.

• LambdaS3Key   –   Lambda 코드 아티팩트에 해당하는 Amazon S3 키입니다. 사용자 지정 Lambda 폴링 함수를 사용하지 않는 경우 비워둡니다.

• LambdaLoggingLevel   –   이 설정은 대개 기본값(INFO)으로 둡니다.

• ManagedPolicies   –   Lambda 함수 실행에 사용할 관리형 정책을 나열합니다. 일반적으로 사용자 지정 Lambda 폴링 함수를 사용하지 않는 경우 비워둡니다.

• StreamRecordsHandler   –   일반적으로 Neptune 스트림의 레코드에 사용자 지정 핸들러를 사용하지 않는 경우 비워둡니다.

• StreamRecordsBatchSize   –   스트림에서 가져올 최대 레코드 수입니다. 이 파라미터를 사용하여 성능을 조정할 수 있습니다. 기본값(5000)으로 시작하는 것이 좋습니다. 허용되는 최대값은 10,000입니다. 숫자가 높을수록 스트림에서 레코드를 읽는 데 필요한 네트워크 호출은 감소하지만 레코드를 처리하는 데 더 많은 메모리가 필요합니다. 이 파라미터의 값이 낮을수록 처리량이 낮아집니다.

• MaxPollingWaitTime   –   두 폴링 사이의 최대 대기 시간(초)입니다. Neptune 스트림을 폴링하기 위해 Lambda 폴러가 호출되는 빈도를 결정합니다. 지속적으로 폴링하는 경우 이 값을 0으로 설정합니다. 최대값은 3,600초(1시간)입니다. 기본값(60초)으로 시작하는 것이 좋습니다(그래프 데이터의 변경 속도에 따라 달라짐).

• MaxPollingInterval   –   최대 연속 폴링 기간(초)입니다. Lambda 폴링 함수에 대한 제한 시간을 설정하는 데 사용됩니다. 값은 5초에서 900초 사이여야 합니다. 기본값(600초)으로 시작하는 것이 좋습니다.

• StepFunctionFallbackPeriod - 폴러를 기다리는 step-function-fallback-period의 단위 수로, 이후 Amazon CloudWatch Events를 통해 단계 함수를 호출하여 실패에서 복구합니다. 기본값(5분)으로 시작하는 것이 좋습니다.

• StepFunctionFallbackPeriodUnit   –   이전 StepFunctionFallbackPeriodUnit(minutes, hours 또는 days)을 측정하는 데 사용되는 시간 단위입니다. 대개 기본값(minutes)이면 충분합니다.

Neptune 스트림

• NeptuneStreamEndpoint   –   (필수) Neptune 소스 스트림의 엔드포인트입니다. 2가지 형식 중 하나를 취합니다.

  • https://your DB cluster:port/propertygraph/stream(또는 별칭 https://your DB cluster:port/pg/stream).

  • https://your DB cluster:port/sparql/stream.

• Neptune Query Engine - Gremlin, 또는 openCypher를 선택합니다SPARQL.

• IAMAuthEnabledOnSourceStream – Neptune DB 클러스터가 IAM 인증을 사용하는 경우 이 파라미터를 로 설정합니다true.

• StreamDBClusterResourceId – Neptune DB 클러스터가 IAM 인증을 사용하는 경우 이 파라미터를 클러스터 리소스 ID로 설정합니다. 리소스 ID가 클러스터 ID와 동일하지 않습니다. 그 대신, cluster- 뒤에 28개의 영숫자 문자가 오는 형식을 사용합니다. Neptune 콘솔의 클러스터 세부 정보에서 찾을 수 있습니다.

대상 Neptune DB 클러스터

• TargetNeptuneClusterEndpoint   –   대상 백업 클러스터의 클러스터 엔드포인트(호스트 이름만 해당)입니다.

  TargetNeptuneClusterEndpoint를 지정할 경우 TargetSPARQLUpdateEndpoint를 지정할 수 없습니다.

• TargetNeptuneClusterPort   –   대상 클러스터의 포트 번호입니다.

  TargetSPARQLUpdateEndpoint를 지정하는 경우 TargetNeptuneClusterPort의 설정은 무시됩니다.

• IAMAuthEnabledOnTargetCluster - 대상 클러스터에서 IAM 인증을 활성화하려면 true로 설정합니다.

• TargetAWSRegion – 와 같은 대상 백업 클러스터의 AWS 리전us-east-1). 크로스 리전 복제의 경우와 같이 대상 백업 클러스터의 AWS 리전이 Neptune 소스 클러스터의 리전과 다른 경우에만 이 파라미터를 제공해야 합니다. 소스 리전과 대상 리전이 동일한 경우 이 파라미터는 선택 사항입니다.

  TargetAWSRegion 값이 Neptune이 지원하는 유효한 AWS 리전이 아닌 경우 프로세스가 실패합니다.

• TargetNeptuneDBClusterResourceId - 선택 사항 : 대상 DB 클러스터에서 IAM 인증이 활성화된 경우에만 필요합니다. 대상 클러스터의 리소스 ID로 설정합니다.

• SPARQLTripleOnlyMode   –   트리플 전용 모드의 활성화 여부를 결정하는 부울 플래그입니다. 트리플 전용 모드에서는 이름이 지정된 그래프 복제가 불가능합니다. 기본값은 false입니다.

• TargetSPARQLUpdateEndpoint 와 같은 SPARQL 업데이트를 위한 대상 엔드포인트URL의 -https://abc.com/xyz. 이 엔드포인트는 쿼드 또는 트리플을 지원하는 모든 SPARQL 스토어일 수 있습니다.

  TargetSPARQLUpdateEndpoint를 지정하는 경우 TargetNeptuneClusterEndpoint를 지정할 수 없으며, TargetNeptuneClusterPort의 설정은 무시된다는 점에 유의하세요.

• BlockSparqlReplicationOnBlankNode – 로 설정하면 SPARQL (RDF) 데이터 BlankNode 에서 에 대한 복제를 true중지하는 부울 플래그입니다. 기본값은 false입니다.

경보

• Required to create Cloud watch Alarm - 새 스택에 대한 CloudWatch 경보를 생성true하려면 이 값을 로 설정합니다.

• SNS Topic ARN for Cloudwatch Alarm Notifications - CloudWatch 경보 알림을 보내야 ARN 하는 SNS 주제입니다(경보가 활성화된 경우에만 필요).

• Email for Alarm Notifications   –   경보 알림을 전송해야 하는 이메일 주소입니다(경보가 활성화된 경우에만 필요).

경보 알림의 대상의 경우 이메일SNS만, 이메일만 또는 SNS 및 이메일 둘 다를 추가할 수 있습니다.

AWS CloudFormation 템플릿 실행

이제 다음과 같이 Neptune 스트림 소비자 애플리케이션 인스턴스를 프로비저닝하는 프로세스를 완료할 수 있습니다.

1. AWS CloudFormation의 스택 세부 정보 지정 페이지에서 다음을 선택합니다.

2. 옵션 페이지에서 다음을 선택합니다.

3. 검토 페이지에서 첫 번째 확인란을 선택하여 가 IAM 리소스를 생성 AWS CloudFormation 함을 확인합니다. 두 번째 확인란을 선택하여 새 스택에 대해 CAPABILITY_AUTO_EXPAND를 승인합니다.

   참고

   CAPABILITY_AUTO_EXPAND는 사전 검토 없이 스택을 생성할 경우 매크로가 확장됨을 명시적으로 승인합니다. 사용자는 실제로 스택을 생성하기 전에 매크로를 통한 변경 사항을 검토할 수 있도록 처리된 템플릿에서 변경 세트를 생성하는 경우가 많습니다. 자세한 내용은 참조API의 AWS CloudFormation CreateStack 섹션을 참조하세요. AWS CloudFormation API

   그런 다음 생성을 선택합니다.

최신 Lambda 아티팩트로 스트림 폴러를 업데이트하려면

다음과 같이 최신 Lambda 코드 아티팩트로 스트림 폴러를 업데이트할 수 있습니다.

1. 에서 기본 상위 AWS CloudFormation 스택으로 AWS Management Console이동하여 AWS CloudFormation 선택합니다.

2. 스택의 업데이트 옵션을 선택합니다.

3. 현재 템플릿 교체를 선택합니다.

4. 템플릿 소스에서 Amazon S3URL를 선택하고 다음 S3 를 입력합니다URL.

   https://aws-neptune-customer-samples.s3.amazonaws.com/neptune-stream/neptune_to_neptune.json

5. AWS CloudFormation 파라미터를 변경하지 않고 다음을 선택합니다.

6. 스택 업데이트를 선택합니다.

스택이 이제 Lambda 아티팩트를 최신 아티팩트로 업데이트합니다.