가상 노드

를 사용하여 가상 노드를 생성하려면 AWS Management Console

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

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

3. 왼쪽 탐색 창에서 가상 노드를 선택합니다.

4. 가상 노드 생성을 선택한 다음, 가상 노드에 대한 설정을 지정합니다.

5. 가상 노드 이름에서 가상 노드의 이름을 입력합니다.

6. 서비스 검색 방법에서 다음 옵션 중 하나를 선택합니다.

   • DNS - 가상 노드가 나타내는 실제 서비스의 DNS 호스트 이름을 지정합니다. Envoy 프록시는 Amazon 에 배포됩니다VPC. 프록시는 에 대해 구성된 DNS 서버로 이름 확인 요청을 보냅니다VPC. 호스트 이름이 확인되면 DNS 서버는 하나 이상의 IP 주소를 반환합니다. VPC DNS 설정에 대한 자세한 내용은 DNS에서 사용을 참조하세요VPC. DNS 응답 유형(선택 사항)에서 DNS 해석기가 반환하는 엔드포인트 유형을 지정합니다. Load Balancer DNS 해석기가 로드 밸런싱된 엔드포인트 세트를 반환한다는 의미입니다. 엔드포인트는 DNS 해석기가 모든 엔드포인트를 반환하고 있음을 의미합니다. 기본적으로 응답 유형은 로드 밸런서로 간주됩니다.

     참고

     Route53을 사용하는 경우 로드 밸런서를 사용해야 합니다.

   • AWS Cloud Map - 기존 서비스 이름 및 HTTP 네임스페이스 를 지정합니다. 선택적으로 행 추가를 선택하고 키 및 값 을 지정 AWS Cloud Map 하여 App Mesh가 쿼리할 수 있는 속성을 지정할 수도 있습니다. 지정된 모든 키/값 페어와 일치하는 인스턴스만 반환됩니다. 를 사용하려면 AWS Cloud Map계정에 AWSServiceRoleForAppMesh 서비스 연결 역할이 있어야 합니다. 에 대한 자세한 내용은 AWS Cloud Map 개발자 안내서를 AWS Cloud Map참조하세요.

   • 없음 – 가상 노드에서 수신 트래픽을 예상하지 않을 경우에 선택합니다.

7. IP 버전 기본 설정

   기본 IP 버전 동작 재정의를 켜서 메시 내 트래픽에 사용해야 하는 IP 버전을 제어할 수 있습니다. 기본적으로 App Mesh는 다양한 IP 버전을 사용합니다.

   참고

   가상 노드에서 IP 기본 설정을 지정하면 이 특정 노드의 메시에 대해 설정된 IP 기본 설정만 재정의됩니다.

   • 기본값

     • Envoy의 DNS 해석기는 를 선호IPv6하고 로 돌아갑니다IPv4.

     • 가능한 AWS Cloud Map 경우 에서 반환한 IPv4 주소를 사용하며 IPv6 주소 사용으로 돌아갑니다.

     • 로컬 앱용으로 생성된 엔드포인트는 IPv4 주소를 사용합니다.

     • Envoy 리스너는 모든 IPv4 주소에 바인딩됩니다.

     더보기간략히 보기

   • IPv6 선호

     • Envoy의 DNS 해석기는 를 선호IPv6하고 로 돌아갑니다IPv4.

     • 에서 반환한 IPv6 주소 AWS Cloud Map 는 사용 가능한 경우 사용되며 IPv4 주소 사용으로 돌아갑니다.

     • 로컬 앱용으로 생성된 엔드포인트는 IPv6 주소를 사용합니다.

     • Envoy 리스너는 모든 IPv4 및 IPv6 주소에 바인딩됩니다.

     더보기간략히 보기

   • IPv4 선호

     • Envoy의 DNS 해석기는 를 선호IPv4하고 로 돌아갑니다IPv6.

     • 가능한 AWS Cloud Map 경우 에서 반환한 IPv4 주소를 사용하며 IPv6 주소 사용으로 돌아갑니다.

     • 로컬 앱용으로 생성된 엔드포인트는 IPv4 주소를 사용합니다.

     • Envoy 리스너는 모든 IPv4 및 IPv6 주소에 바인딩됩니다.

     더보기간략히 보기

   • IPv6 만

     • Envoy의 DNS 해석기는 만 사용합니다IPv6.

     • 에서 반환한 IPv6 주소만 AWS Cloud Map 사용됩니다. AWS Cloud Map 가 IPv4주소를 반환하는 경우 IP 주소는 사용되지 않으며 빈 결과가 Envoy에 반환됩니다.

     • 로컬 앱용으로 생성된 엔드포인트는 IPv6 주소를 사용합니다.

     • Envoy 리스너는 모든 IPv4 및 IPv6 주소에 바인딩됩니다.

     더보기간략히 보기

   • IPv4 만

     • Envoy의 DNS 해석기는 만 사용합니다IPv4.

     • 에서 반환한 IPv4 주소만 AWS Cloud Map 사용됩니다. AWS Cloud Map 가 IPv6주소를 반환하는 경우 IP 주소는 사용되지 않으며 빈 결과가 Envoy에 반환됩니다.

     • 로컬 앱용으로 생성된 엔드포인트는 IPv4 주소를 사용합니다.

     • Envoy 리스너는 모든 IPv4 및 IPv6 주소에 바인딩됩니다.

     더보기간략히 보기

8. (선택 사항) 클라이언트 정책 기본값 - 백엔드 가상 서비스와 통신할 때 기본 요구 사항을 구성합니다.

   참고

   • 기존 가상 노드에 대해 전송 계층 보안(TLS)을 활성화하려면 를 활성화할 기존 가상 노드와 동일한 서비스를 나타내는 새 가상 노드를 생성하는 것이 좋습니다TLS. 그런 다음, 가상 라우터와 경로를 사용하여 트래픽을 새 가상 노드로 점진적으로 이동합니다. 경로 생성 및 전환 가중치 조정에 대한 자세한 내용은 경로 섹션을 참조하세요. 기존 트래픽 서비스 가상 노드를 로 업데이트하면 업데이트된 가상 노드의 Envoy 프록시TLS가 인증서를 받기 전에 다운스트림 클라이언트 Envoy 프록시가 TLS 검증 컨텍스트를 수신할 가능성이 있습니다. 이로 인해 다운스트림 Envoy 프록시에서 TLS 협상 오류가 발생할 수 있습니다.

   • 백엔드 서비스의 가상 노드로 표시되는 애플리케이션과 함께 배포된 Envoy 프록시에 대해 프록시 인증을 활성화해야 합니다. 프록시 인증을 활성화할 때는 이 가상 노드가 통신하는 가상 노드로만 액세스를 제한하는 것이 좋습니다.

   • (선택 사항) 가상 노드가 전송 계층 보안()을 사용하여 모든 백엔드와 통신하도록 하려면 적용을 TLS 선택합니다TLS.

   • (선택 사항) TLS 하나 이상의 특정 포트에만 를 사용해야 하는 경우 포트 에 숫자를 입력합니다. 포트를 추가하려면 포트 추가를 선택합니다. 포트를 지정하지 않으면 TLS가 모든 포트에 적용됩니다.

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

     • AWS Private Certificate Authority 호스팅 - 기존 인증서를 하나 이상 선택합니다. ACM 인증서를 사용한 암호화를 사용하여 샘플 애플리케이션으로 메시를 배포하는 방법에 대한 자세한 end-to-end 내용은 의 AWS Certificate ManagerTLS로 구성을 참조하세요 GitHub.

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

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

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

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

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

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

   더보기간략히 보기

9. (선택 사항) 서비스 백엔드 - 가상 노드가 통신할 App Mesh 가상 서비스를 지정합니다.

   • 가상 노드와 통신하는 가상 서비스의 App Mesh 가상 서비스 이름 또는 전체 Amazon 리소스 이름(ARN)을 입력합니다.

   • (선택 사항) 백엔드에 고유한 TLS 설정을 지정하려면 TLS 설정을 선택한 다음 기본값 재정의 를 선택합니다.

     • (선택 사항) 가상 노드가 를 사용하여 모든 백엔드와 통신하도록 하려면 적용을 TLS 선택합니다TLS.

     • (선택 사항) TLS 하나 이상의 특정 포트에만 를 사용해야 하는 경우 포트 에 숫자를 입력합니다. 포트를 추가하려면 포트 추가를 선택합니다. 포트를 지정하지 않으면 TLS가 모든 포트에 적용됩니다.

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

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

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

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

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

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

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

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

   • 백엔드를 더 추가하려면 백엔드 추가를 선택합니다.

     더보기간략히 보기

   더보기간략히 보기

10. (선택 사항) 로깅

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

    참고

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

11. 리스너 구성

    리스너는HTTP, HTTP/2, GRPC 및 TCP 프로토콜을 지원합니다. HTTPS는 지원되지 않습니다.

    1. 가상 노드에서 인바운드 트래픽을 예상하는 경우 리스너에 대해 포트 및 프로토콜을 지정합니다. http 리스너는 웹 소켓으로의 연결 전환을 허용합니다. 리스너 추가를 클릭하여 리스너를 여러 개 추가할 수 있습니다. 제거 버튼을 누르면 해당 리스너가 제거됩니다.

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

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

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

       참고

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

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

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

       더보기간략히 보기

    3. (선택 사항) 이상치 탐지 활성화

       클라이언트 Envoy에 적용된 이상치 탐지를 통해 클라이언트는 알려진 오류가 관찰된 연결에 대해 거의 즉각적인 조치를 취할 수 있습니다. 업스트림 서비스에 있는 개별 호스트의 상태를 추적하는 회로 차단기 구현의 한 형태입니다.

       이상치 탐지는 업스트림 클러스터의 엔드포인트가 다른 엔드포인트와 다르게 작동하는지 여부를 동적으로 판단하여 정상 로드 밸런싱 세트에서 제거합니다.

       참고

       서버 Virtual Node에 대한 이상치 감지를 효과적으로 구성하려면 해당 Virtual Node의 서비스 검색 메서드를 AWS Cloud Map 또는 응답 유형 필드가 로 설정된 DNS 상태로 구성할 수 있습니다ENDPOINTS. 응답 유형이 인 DNS 서비스 검색 방법을 사용하는 경우 LOADBALANCEREnvoy 프록시는 업스트림 서비스로 라우팅하기 위한 단일 IP 주소만 선택합니다. 이렇게 하면 호스트 세트에서 비정상 호스트를 배출하는 이상치 탐지 동작이 무효화됩니다. 서비스 검색 유형과 관련된 Envoy 프록시의 동작에 대한 자세한 내용은 서비스 검색 방법 섹션을 참조하세요.

       • 서버 오류에서 배출에 필요한 연속된 5xx 오류 수를 지정합니다.

       • 이상치 탐지 간격에서 배출 스윕 분석 간의 시간 간격과 단위를 지정합니다.

       • 기본 배출 기간에서 호스트가 배출되는 기본 시간 및 단위를 지정합니다.

       • 배출 비율에 배출될 수 있는 로드 밸런싱 풀의 최대 호스트 비율을 지정합니다.

       더보기간략히 보기

    4. (선택 사항) 상태 확인 사용 - 상태 확인 정책에 대한 설정을 구성합니다.

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

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

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

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

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

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

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

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

       더보기간략히 보기

    5. (선택 사항) TLS 종료 활성화 - 를 사용하여 다른 가상 노드가 이 가상 노드와 통신하는 방법을 구성합니다TLS.

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

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

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

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

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

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

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

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

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

       더보기간략히 보기

    6. (선택 사항) 제한 시간

       참고

       제한 시간을 기본값보다 크게 지정하는 경우 기본값보다 큰 제한 시간으로 가상 라우터와 경로를 설정해야 합니다. 그러나 제한 시간을 기본값보다 낮은 값으로 줄이는 경우 경로에서 제한 시간을 업데이트할 수도 있습니다. 자세한 내용은 경로를 참조하세요.

       • 요청 제한 시간 - 리스너 프로토콜로 grpc, http 또는 http2를 선택한 경우 요청 제한 시간을 지정할 수 있습니다. 기본값은 15초입니다. 0 값은 제한 시간을 비활성화합니다.

       • 유휴 기간 - 모든 리스너 프로토콜의 유휴 기간을 지정할 수 있습니다. 기본값은 300초입니다.

       더보기간략히 보기

12. 가상 노드 생성을 선택하여 완료합니다.

1. aws appmesh create-virtual-node \
   --cli-input-json file://create-virtual-node-dns.json

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

   {
       "meshName": "meshName",
       "spec": {
           "listeners": [
               {
                   "portMapping": {
                       "port": 80,
                       "protocol": "http"
                   }
               }
           ],
           "serviceDiscovery": {
               "dns": {
                   "hostname": "serviceBv1.svc.cluster.local"
               }
           }
       },
       "virtualNodeName": "nodeName"
   }

3. 출력 예제:

   {
       "virtualNode": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:210987654321:mesh/meshName/virtualNode/nodeName",
               "createdAt": "2022-04-06T09:12:24.348000-05:00",
               "lastUpdatedAt": "2022-04-06T09:12:24.348000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "210987654321",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 1
           },
           "spec": {
               "listeners": [
                   {
                       "portMapping": {
                           "port": 80,
                           "protocol": "http"
                       }
                   }
               ],
               "serviceDiscovery": {
                   "dns": {
                       "hostname": "serviceBv1.svc.cluster.local"
                   }
               }
           },
           "status": {
               "status": "ACTIVE"
           },
           "virtualNodeName": "nodeName"
       }
   }
   

를 사용하여 가상 노드를 삭제하려면 AWS Management Console

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

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

3. 왼쪽 탐색 창에서 가상 노드를 선택합니다.

4. 가상 노드 테이블에서 삭제하려는 가상 노드를 선택하고 삭제를 선택합니다. 가상 노드를 삭제하려면 가상 노드의 메시 소유자 또는 리소스 소유자 열에 계정 ID가 나열되어야 합니다.

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

를 사용하여 가상 노드를 삭제하려면 AWS CLI

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

   aws appmesh delete-virtual-node \
        --mesh-name meshName \
        --virtual-node-name nodeName

2. 출력 예제:

   {
       "virtualNode": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:210987654321:mesh/meshName/virtualNode/nodeName",
               "createdAt": "2022-04-06T09:12:24.348000-05:00",
               "lastUpdatedAt": "2022-04-07T11:03:48.120000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "210987654321",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 2
           },
           "spec": {
               "backends": [],
               "listeners": [
                   {
                       "portMapping": {
                           "port": 80,
                           "protocol": "http"
                       }
                   }
               ],
               "serviceDiscovery": {
                   "dns": {
                       "hostname": "serviceBv1.svc.cluster.local"
                   }
               }
           },
           "status": {
               "status": "DELETED"
           },
           "virtualNodeName": "nodeName"
       }
   }