가상 게이트웨이

를 사용하여 가상 게이트웨이를 생성하려면 AWS Management Console

1. 에서 App Mesh 콘솔을 엽니다https://console.aws.amazon.com/appmesh/.

2. 가상 게이트웨이를 생성하려는 메시를 선택합니다. 소유하고 있는 모든 메시와 공유된 모든 메시가 나열됩니다.

3. 왼쪽 탐색 창에서 가상 게이트웨이를 선택합니다.

4. 가상 게이트웨이 생성을 선택합니다.

5. 가상 게이트웨이 이름에 가상 게이트웨이의 이름을 입력합니다.

6. (선택 사항이지만 권장됨) 클라이언트 정책 기본값을 구성합니다.

   1. (선택 사항) 게이트웨이가 전송 계층 보안()을 사용하여 가상 서비스와만 통신하도록 하려면 적용을 TLS 선택합니다TLS.

   2. (선택 사항) 포트 에서 가상 서비스와의 TLS 통신을 적용할 포트를 하나 이상 지정합니다.

   3. 검증 방법에서 다음 옵션 중 하나를 선택합니다. 지정하는 인증서는 이미 존재하고 특정 요구 사항을 충족해야 합니다. 자세한 내용은 인증서 요구 사항 단원을 참조하십시오.

      • AWS Private Certificate Authority 호스팅 - 기존 인증서를 하나 이상 선택합니다.

      • Envoy Secret Discovery Service(SDS) 호스팅 - Secret Discovery Service를 사용하여 Envoy가 가져오는 보안 암호의 이름을 입력합니다.

      • 로컬 파일 호스팅 - Envoy가 배포되는 파일 시스템의 인증서 체인 파일 경로를 지정합니다.

   4. (선택 사항) 주체 대체 이름을 입력합니다. 를 추가하려면 추가를 SAN SANs선택합니다. SANs FQDN 또는 URI 형식이어야 합니다.

   5. (선택 사항) 클라이언트 인증서 제공을 선택하고 서버가 클라이언트 인증서를 요청할 때 클라이언트 인증서를 제공하고 상호 TLS 인증을 활성화하려면 아래 옵션 중 하나를 선택합니다. 상호 에 대한 자세한 내용은 App Mesh 상호 TLS 인증 문서를 TLS참조하세요.

      • Envoy Secret Discovery Service(SDS) 호스팅 - Secret Discovery Service를 사용하여 Envoy가 가져오는 보안 암호의 이름을 입력합니다.

      • 로컬 파일 호스팅 - Envoy가 배포되는 파일 시스템의 프라이빗 키 뿐만 아니라 인증서 체인 파일의 경로를 지정합니다. 로컬 파일을 사용한 암호화를 사용하여 샘플 애플리케이션으로 메시를 배포하는 end-to-end 방법에 대한 자세한 내용은 의 파일 제공 TLS 인증서 TLS 구성을 참조하세요 GitHub.

7. (선택 사항) 로깅을 구성하려면 로깅을 선택합니다. Envoy에서 사용할 HTTP 액세스 로그 경로를 입력합니다. Docker 로그 드라이버를 사용하여 Envoy 로그를 Amazon CloudWatch Logs와 같은 서비스로 내보낼 수 있도록 /dev/stdout 경로를 사용하는 것이 좋습니다.

   참고

   로그는 계속 애플리케이션의 에이전트에 의해 수집되어 대상으로 전송되어야 합니다. 이 파일 경로는 로그를 보낼 위치만 Envoy에 지시합니다.

   더보기간략히 보기

8. 리스너를 구성합니다.

   1. 프로토콜을 선택하고 Envoy가 트래픽을 수신하는 포트를 지정합니다. http 리스너는 웹 소켓으로의 연결 전환을 허용합니다. 리스너 추가를 클릭하여 리스너를 여러 개 추가할 수 있습니다. 제거 버튼을 누르면 해당 리스너가 제거됩니다.

   2. (선택 사항) 연결 풀 활성화

      연결 풀링은 가상 게이트웨이 Envoy가 동시에 설정할 수 있는 연결 수를 제한합니다. 이 작업은 Envoy 인스턴스의 연결 과부하를 방지하고 애플리케이션 요구 사항에 맞게 트래픽 셰이핑을 조정할 수 있도록 하기 위한 것입니다.

      가상 게이트웨이 리스너의 대상 측 연결 풀 설정을 구성할 수 있습니다. App Mesh는 기본적으로 클라이언트 측 연결 풀 설정을 무제한으로 설정하여 메시 구성을 단순화합니다.

      참고

      connectionPool 및 connectionPoolportMapping 프로토콜은 동일해야 합니다. 리스너 프로토콜이 grpc 또는 http2인 경우 maxRequests만 지정합니다. 리스너 프로토콜이 http인 경우 maxConnections 및 maxPendingRequests를 모두 지정할 수 있습니다.

      • 최대 연결 수에는 최대 아웃바운드 연결 수를 지정합니다.

      • 최대 요청 수에는 가상 게이트웨이 Envoy에 대해 설정할 수 있는 최대 병렬 요청 수를 지정합니다.

      • (선택 사항) 대기 중인 최대 요청 수에는 Envoy가 대기하는 최대 연결 수 이후에 오버플로되는 요청 수를 지정합니다. 기본값은 2147483647입니다.

      더보기간략히 보기

   3. (선택 사항) 리스너에 대한 상태 확인을 구성하려면 상태 확인 사용을 선택합니다.

      상태 확인 정책은 선택 사항이지만 상태 정책에 대한 값을 지정한 경우 정상 임계 값, 상태 확인 간격, 상태 확인 프로토콜, 제한 시간 및 비정상 임계값에 대해 값을 지정해야 합니다.

      • 상태 확인 프로토콜에 대해 프로토콜을 선택합니다. grpc 를 선택하면 서비스가 GRPC 상태 확인 프로토콜 을 준수해야 합니다.

      • Health check port(상태 확인 포트)에서 상태 확인을 실행해야 할 포트를 지정합니다.

      • Healthy threshold(정상 임계 값)에서 리스너를 정상으로 선언하기 전까지 발생해야 하는 연속적인 상태 확인 성공 횟수를 지정합니다.

      • Health check interval(상태 확인 간격)에서 각 상태 확인 실행 사이의 시간 간격을 밀리초 단위로 지정합니다.

      • Path(경로)에서 상태 확인 요청에 대한 대상 경로를 지정합니다. 이 값은 상태 확인 프로토콜이 http 또는 http2인 경우에만 사용됩니다. 다른 프로토콜에서는 이 값이 무시됩니다.

      • 제한 시간에서 상태 확인으로부터 응답을 받을 때까지 대기할 시간을 밀리초 단위로 지정합니다.

      • 비정상 임계값에서 리스너를 비정상으로 선언하기 전까지 발생해야 하는 연속적인 상태 확인 실패 횟수를 지정합니다.

      더보기간략히 보기

   4. (선택 사항) 클라이언트가 를 사용하여 이 가상 게이트웨이와 통신할지 여부를 지정하려면 TLS 종료 활성화를 TLS선택합니다.

      • 모드 에서 리스너에서 TLS에 대해 구성할 모드를 선택합니다.

      • 인증서 방법에서 다음 옵션 중 하나를 수행합니다. 인증서는 특정 요구 사항을 충족해야 합니다. 자세한 내용은 인증서 요구 사항 단원을 참조하십시오.

        • AWS Certificate Manager 호스팅 - 기존 인증서를 선택합니다.

        • Envoy Secret Discovery Service(SDS) 호스팅 - Secret Discovery Service를 사용하여 Envoy가 가져오는 보안 암호의 이름을 입력합니다.

        • 로컬 파일 호스팅 - Envoy가 배포된 파일 시스템의 인증서 체인 및 프라이빗 키 파일 경로를 지정합니다.

      • (선택 사항) 클라이언트가 인증서를 제공하는 경우 상호 인증을 활성화하려면 클라이언트 인증서 요구 및 아래 옵션 중 하나를 선택합니다. TLS 상호 에 대한 자세한 내용은 App Mesh 상호 TLS 인증 문서를 TLS참조하세요.

        • Envoy Secret Discovery Service(SDS) 호스팅 - Secret Discovery Service를 사용하여 Envoy가 가져오는 보안 암호의 이름을 입력합니다.

        • 로컬 파일 호스팅 - Envoy가 배포되는 파일 시스템의 인증서 체인 파일 경로를 지정합니다.

      • (선택 사항) 주체 대체 이름을 입력합니다. 를 추가하려면 추가를 SAN SANs선택합니다. SANs FQDN 또는 URI 형식이어야 합니다.

      더보기간략히 보기

9. 가상 게이트웨이 생성을 선택하여 완료합니다.

1. aws appmesh create-virtual-gateway \ 
   --mesh-name meshName \ 
   --virtual-gateway-name virtualGatewayName \ 
   --cli-input-json file://create-virtual-gateway.json

2. 예제 create-virtual-gateway.json의 내용:

   {
       "spec": {
         "listeners": [
           {
             "portMapping": {
               "port": 9080,
               "protocol": "http"
             }
           }
         ]
       }
   }

3. 출력 예제:

   {
       "virtualGateway": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:123456789012:mesh/meshName/virtualGateway/virtualGatewayName",
               "createdAt": "2022-04-06T10:42:42.015000-05:00",
               "lastUpdatedAt": "2022-04-06T10:42:42.015000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "123456789012",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 1
           },
           "spec": {
               "listeners": [
                   {
                       "portMapping": {
                           "port": 9080,
                           "protocol": "http"
                       }
                   }
               ]
           },
           "status": {
               "status": "ACTIVE"
           },
           "virtualGatewayName": "virtualGatewayName"
       }
   }
   

를 사용하여 가상 게이트웨이를 삭제하려면 AWS Management Console

1. 에서 App Mesh 콘솔을 엽니다https://console.aws.amazon.com/appmesh/.

2. 가상 게이트웨이를 삭제하려는 메시를 선택합니다. 소유하고 있는 모든 메시와 공유된 모든 메시가 나열됩니다.

3. 왼쪽 탐색 창에서 가상 게이트웨이를 선택합니다.

4. 삭제하려는 가상 게이트웨이를 선택하고 삭제를 선택합니다. 연결된 게이트웨이 경로가 있는 가상 게이트웨이는 삭제할 수 없습니다. 연결된 게이트웨이 경로를 먼저 삭제해야 합니다. 계정이 리소스 소유자로 나열된 경우에만 가상 게이트웨이를 삭제할 수 있습니다.

5. 확인 상자에 delete를 입력한 다음, 삭제를 선택합니다.

를 사용하여 가상 게이트웨이를 삭제하려면 AWS CLI

1. 다음 명령을 사용하여 가상 게이트웨이를 삭제합니다( red 자체 값이 있는 값):

   aws appmesh delete-virtual-gateway \
        --mesh-name meshName \
        --virtual-gateway-name virtualGatewayName

2. 출력 예제:

   {
       "virtualGateway": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:123456789012:mesh/meshName/virtualGateway/virtualGatewayName",
               "createdAt": "2022-04-06T10:42:42.015000-05:00",
               "lastUpdatedAt": "2022-04-07T10:57:22.638000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "123456789012",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 2
           },
           "spec": {
               "listeners": [
                   {
                       "portMapping": {
                           "port": 9080,
                           "protocol": "http"
                       }
                   }
               ]
           },
           "status": {
               "status": "DELETED"
           },
           "virtualGatewayName": "virtualGatewayName"
       }
   }