OpenSearch UI 애플리케이션을 위한 친숙한 URL 설정(셀프 서비스)

OpenSearch UI 애플리케이션에 대한 친숙한 URL을 설정하려면

1. 표시 이름을 애플리케이션 URLs에 매핑하는 JSON 파일을 생성합니다. 각 키는 하위 도메인이 됩니다(예: 키는이 prod됨https://prod.example.com).

   {
     "data": [
       {"key": "prod", "value": "https://application-prod-abc123.us-west-2.opensearch.amazonaws.com"},
       {"key": "staging", "value": "https://application-staging-def456.us-east-1.opensearch.amazonaws.com"},
       {"key": "analytics", "value": "https://application-analytics-ghi789.eu-west-1.opensearch.amazonaws.com"}
     ]
   }

   이 파일을 opensearch-ui-friendly-url-app-mappings-v1.json로 저장합니다. v1 접미사는 이를 매핑의 첫 번째 버전으로 식별합니다. 매핑을 업데이트할 때이 버전이 증가합니다.

2. 계정의 Amazon S3 버킷에 매핑 파일을 업로드합니다.

   aws s3 cp opensearch-ui-friendly-url-app-mappings-v1.json \
     s3://your-bucket-name/opensearch-ui-friendly-url-app-mappings-v1.json

3. 버킷 정책을 추가하여 매핑 파일을 읽을 수 있는 권한을 CloudFront에 부여합니다. your-bucket-name 및 your-account-id를 값으로 바꿉니다.

   aws s3api put-bucket-policy \
     --bucket your-bucket-name \
     --policy '{
       "Version": "2012-10-17",
       "Statement": [{
         "Sid": "AllowCloudFrontKVSImport",
         "Effect": "Allow",
         "Principal": {"Service": "cloudfront.amazonaws.com"},
         "Action": "s3:GetObject",
         "Resource": "arn:aws:s3:::your-bucket-name/*",
         "Condition": {"StringEquals": {"aws:SourceAccount": "your-account-id"}}
       }]
     }'

   참고

   이 버킷 정책은 CloudFront가 KeyValueStore 생성 중에 매핑 파일을 읽을 수 있도록 허용합니다. 그렇지 않으면 "SourceARN에 액세스할 수 없음" 오류와 함께 스택 배포가 실패합니다.

4. 다음 옵션 중 하나를 사용하여 CloudFormation 스택을 배포합니다.

   옵션 1: 스택 시작(권장)

   다음 URL을 복사하여 브라우저에 붙여 넣어 템플릿이 미리 로드된 AWS CloudFormation 빠른 생성 페이지를 엽니다. 파라미터를 입력하고 스택 생성을 선택합니다.

   https://us-east-1.console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/quickcreate?templateURL=https://opensearch-ui-quickstart-sample-cfn-templates.s3.us-west-2.amazonaws.com/opensearch-ui-friendly-url/main.yaml&stackName=opensearch-ui-friendly-url&param_MappingsVersion=v1

   옵션 2: AWS CLI

   자리 표시자 값을 자신의 값으로 바꿉니다.

   aws cloudformation create-stack \
     --stack-name opensearch-ui-friendly-url \
     --template-url https://opensearch-ui-quickstart-sample-cfn-templates.s3.us-west-2.amazonaws.com/opensearch-ui-friendly-url/main.yaml \
     --parameters \
       ParameterKey=DomainName,ParameterValue=your-domain.com \
       ParameterKey=HostedZoneId,ParameterValue=Z0123456789ABCDEFG \
       ParameterKey=MappingsBucket,ParameterValue=your-bucket-name \
       ParameterKey=MappingsKey,ParameterValue=opensearch-ui-friendly-url-app-mappings-v1.json \
       ParameterKey=MappingsVersion,ParameterValue=v1 \
     --region us-east-1

5. AWS CLI(옵션 2)를 사용한 경우 us-east-1 리전에 스택을 배포합니다. CloudFront에서는 ACM 인증서가에 있어야 합니다us-east-1. OpenSearch UI 애플리케이션은 OpenSearch UI에 대해 지원되는 모든 리전 및 할당량에 있을 수 있습니다.

6. 스택이 완료될 때까지 기다립니다(약 15분). 진행 상황을 모니터링할 수 있습니다.

   aws cloudformation wait stack-create-complete \
     --stack-name opensearch-ui-friendly-url \
     --region us-east-1

7. 리디렉션을 테스트합니다. 브라우저를 열고 로 이동합니다https://prod.your-domain.com. OpenSearch UI 애플리케이션으로 리디렉션되어야 합니다.

   를 사용하여 확인할 수도 있습니다curl.

   curl -I https://prod.your-domain.com
   # Expected: HTTP/2 302
   # location: https://application-prod-abc123.us-west-2.opensearch.amazonaws.com

1. 매핑 파일을 편집하여 항목을 추가하거나 제거합니다. 증분 버전 접미사(예: )와 함께 저장합니다opensearch-ui-friendly-url-app-mappings-v2.json.

2. 새 버전을 S3에 업로드합니다.

   aws s3 cp opensearch-ui-friendly-url-app-mappings-v2.json \
     s3://your-bucket-name/opensearch-ui-friendly-url-app-mappings-v2.json

3. 새 MappingsKey 및 로 스택을 업데이트합니다MappingsVersion.

   콘솔 사용: CloudFormation 콘솔을 열고 스택을 선택한 다음 업데이트를 선택하고 현재 템플릿 사용을 선택한 다음 MappingsKey 및 MappingsVersion 파라미터를 새 값으로 업데이트합니다.

   AWS CLI 사용:

   aws cloudformation update-stack \
     --stack-name opensearch-ui-friendly-url \
     --use-previous-template \
     --parameters \
       ParameterKey=DomainName,UsePreviousValue=true \
       ParameterKey=HostedZoneId,UsePreviousValue=true \
       ParameterKey=MappingsBucket,UsePreviousValue=true \
       ParameterKey=MappingsKey,ParameterValue=opensearch-ui-friendly-url-app-mappings-v2.json \
       ParameterKey=MappingsVersion,ParameterValue=v2 \
     --region us-east-1

Route 53 없이 친숙한 URL 리디렉션을 설정하려면

1. ACM에서 인증서 요청

   1. us-east-1 리전의 https://console.aws.amazon.com/acm/ ACM 콘솔을 엽니다.

   2. 인증서 요청을 선택합니다.

   3. 도메인 이름에 *.your-domain.com (와일드카드 인증서)를 입력합니다.

   4. 검증 방법에서 DNS 검증을 선택합니다.

   5. 요청을 선택합니다.

   6. 인증서 세부 정보 페이지의 도메인 검증 아래에 CNAME 레코드 이름과 값을 기록해 둡니다. DNS 공급자에서이 CNAME 레코드를 생성하여 도메인 소유권을 검증합니다.

   7. 인증서 상태가 발급됨으로 변경될 때까지 기다립니다(일반적으로 DNS 레코드 생성 후 5~30분).

2. CloudFront KeyValueStore 생성

   1. https://console.aws.amazon.com/cloudfront/에서 CloudFront 콘솔을 엽니다.

   2. 탐색 창에서 함수를 선택합니다. 그런 다음 KeyValueStores 탭을 선택합니다.

   3. KeyValueStore 생성 버튼을 선택합니다.

   4. 이름(예: opensearch-ui-friendly-url-app-mappings-store)을 입력합니다.

   5. 생성(Create)을 선택합니다.

   6. 생성 후 편집을 선택하여 키-값 페어를 추가합니다. 각 애플리케이션에 대해 키(와 같은 하위 도메인 이름prod)와 값(전체 OpenSearch UI 애플리케이션 URL)을 추가합니다.

3. CloudFront 함수 생성

   1. https://console.aws.amazon.com/cloudfront/에서 CloudFront 콘솔을 엽니다.

   2. 탐색 창에서 함수를 선택합니다.

   3. 함수 탭에서 함수 생성을 선택합니다.

   4. 함수의 이름을 입력합니다(예: opensearch-ui-friendly-url-redirect-function).

   5. 런타임에서 cloudfront-js-2.0을 선택합니다.

   6. 함수 코드를 다음으로 바꿉니다.

      import cf from 'cloudfront';
      
      const kvsHandle = cf.kvs("YOUR_KVS_ID");
      
      async function handler(event) {
        var request = event.request;
        var host = request.headers.host.value;
        var subdomain = host.split('.')[0];
      
        try {
          var targetUrl = await kvsHandle.get(subdomain);
          return {
            statusCode: 302,
            statusDescription: 'Found',
            headers: {
              'location': { value: targetUrl },
              'cache-control': { value: 'no-cache, no-store, must-revalidate' }
            }
          };
        } catch (e) {
          return {
            statusCode: 404,
            statusDescription: 'Not Found',
            headers: { 'content-type': { value: 'text/html' } },
            body: {
              encoding: 'text',
              data: '<html><body><h1>Application Not Found</h1><p>No OpenSearch application is mapped to the requested subdomain.</p></body></html>'
            }
          };
        }
      }

      YOUR_KVS_ID를 생성한 KeyValueStore의 ID로 바꿉니다(KeyValueStore 세부 정보 페이지에서 볼 수 있음).

   7. KeyValueStore 연결에서 생성한 KeyValueStore를 연결합니다.

   8. 변경 사항 저장을 선택한 다음 함수 게시를 선택합니다.

4. CloudFront 배포 생성

   1. CloudFront 콘솔에서 배포 생성을 선택합니다.

   2. 오리진 도메인에 유효한 도메인(예: example.com)을 입력합니다. 함수가 응답에 도달하기 전에 응답을 반환하기 때문에 오리진에 연결되지 않습니다.

   3. 기본 캐시 동작의 뷰어 프로토콜 정책에서 HTTP를 HTTPS로 리디렉션을 선택합니다.

   4. 캐시 정책에서 CachingDisabled 선택합니다.

   5. 함수 연결의 뷰어 요청에서 CloudFront 함수를 선택합니다.

   6. 설정에서 대체 도메인 이름(CNAMEs)에를 입력합니다*.your-domain.com.

   7. 사용자 지정 SSL 인증서에서 ACM에서 생성한 인증서를 선택합니다.

   8. 배포 생성을 선택합니다.

   9. 배포 도메인 이름(예: d1234abcdef8.cloudfront.net)을 기록해 둡니다.

5. 공급자에서 DNS 구성

   DNS 공급자에서 CloudFront 배포 도메인 이름(예: )*.your-domain.com을 가리키는 CNAME 레코드를 생성합니다d1234abcdef8.cloudfront.net.

   참고

   일부 DNS 공급자는 와일드카드 CNAME 레코드를 지원하지 않습니다. 이 경우 사용하려는 각 하위 도메인에 대해 개별 CNAME 레코드를 생성합니다(예: , prod.your-domain.comstaging.your-domain.com).

1. https://console.aws.amazon.com/cloudfront/에서 CloudFront 콘솔을 엽니다.

2. 탐색 창에서 함수를 선택합니다. 그런 다음 KeyValueStores 탭을 선택합니다.

3. KeyValueStore 이름(예: opensearch-ui-friendly-url-app-mappings-store)을 선택합니다.

4. 편집을 선택합니다.

5. 페어 추가를 선택합니다. 하위 도메인 이름을 키로 입력하고 전체 OpenSearch UI 애플리케이션 URL을 값으로 입력합니다.

6. 변경 사항 저장을 선택합니다.