

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 가상 라우터
<a name="virtual_routers"></a>

**중요**  
지원 종료 공지: 2026년 9월 30일에는에 대한 지원을 중단할 AWS 예정입니다 AWS App Mesh. 2026년 9월 30일 이후에는 AWS App Mesh 콘솔 또는 AWS App Mesh 리소스에 더 이상 액세스할 수 없습니다. 자세한 내용은이 블로그 게시물 [Migrating from to Amazon ECS Service Connect를 참조 AWS App Mesh 하세요](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect).

가상 라우터는 메시 내에 있는 하나 이상의 가상 서비스에 대한 트래픽을 처리합니다. 가상 라우터를 생성한 후에는 해당 가상 라우터에 대해 수신 요청을 다른 가상 노드로 보내는 라우팅을 만들어 연결할 수 있습니다.

![\[Virtual router diagram showing HTTP route with prefix and targets B and B' for different service versions.\]](http://docs.aws.amazon.com/ko_kr/app-mesh/latest/userguide/images/virtual_router.png)


가상 라우터가 수신할 인바운드 트래픽을 **리스너로 지정해야 합니다.

## 가상 라우터 생성
<a name="create-virtual-router"></a>

------
#### [ AWS Management Console ]

**를 사용하여 가상 라우터를 생성하려면 AWS Management Console**
**참고**  
가상 라우터를 생성할 때는 경로를 생성된 가상 라우터에 연결할 네임스페이스 목록을 식별할 수 있도록 레이블이 있는 네임스페이스 선택기를 추가해야 합니다.

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

1. 가상 라우터를 생성하려는 메시를 선택합니다. 소유하고 있는 모든 메시와 [공유된](sharing.md) 모든 메시가 나열됩니다.

1. 왼쪽 탐색 창에서 **Virtual routers(가상 라우터)**를 선택합니다.

1. **Create virtual router(가상 라우터 생성)**를 선택합니다.

1. **Virtual router name(가상 라우터 이름)**에서 가상 라우터의 이름을 지정합니다. 최대 255개의 문자, 숫자, 하이픈 및 밑줄이 허용됩니다.

1. (선택 사항) **리스너** 구성에서 가상 라우터에 대한 **포트** 및 **프로토콜**을 지정합니다. `http` 리스너는 웹 소켓으로의 연결 전환을 허용합니다. **리스너 추가**를 클릭하여 리스너를 여러 개 추가할 수 있습니다. **제거** 버튼을 누르면 해당 리스너가 제거됩니다.

1. **Create virtual router(가상 라우터 생성)**를 선택하여 완료합니다.

------
#### [ AWS CLI ]

** AWS CLI를 사용하여 가상 라우터를 생성하려면**

다음 명령을 사용하여 가상 라우터를 생성하고 JSON을 입력합니다(*빨간색* 값을 원하는 값으로 대체).

1. 

   ```
   aws appmesh create-virtual-router \
        --cli-input-json file://create-virtual-router.json
   ```

1. **예제** create-virtual-router.json의 내용은 다음과 같습니다.

1. 

   ```
   {
       "meshName": "meshName",
       "spec": {
           "listeners": [
               {
                   "portMapping": {
                       "port": 80,
                       "protocol": "http"
                   }
               }
           ]
       },
       "virtualRouterName": "routerName"
   }
   ```

1. 출력 예시:

   ```
   {
       "virtualRouter": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:210987654321:mesh/meshName/virtualRouter/routerName",
               "createdAt": "2022-04-06T11:49:47.216000-05:00",
               "lastUpdatedAt": "2022-04-06T11:49:47.216000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "210987654321",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 1
           },
           "spec": {
               "listeners": [
                   {
                       "portMapping": {
                           "port": 80,
                           "protocol": "http"
                       }
                   }
               ]
           },
           "status": {
               "status": "ACTIVE"
           },
           "virtualRouterName": "routerName"
       }
   }
   ```

App Mesh용를 사용하여 가상 라우터를 생성하는 AWS CLI 방법에 대한 자세한 내용은 AWS CLI 참조의 [create-virtual-router](https://docs.aws.amazon.com/cli/latest/reference/appmesh/create-virtual-router.html) 명령을 참조하세요.

------

## 가상 라우터 삭제
<a name="delete-virtual-router"></a>

**참고**  
[경로](routes.md)가 있거나 [가상 서비스](virtual_services.md)의 공급자로 지정된 가상 라우터는 삭제할 수 없습니다.

------
#### [ AWS Management Console ]

**를 사용하여 가상 라우터를 삭제하려면 AWS Management Console**

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

1. 가상 라우터를 삭제하려는 메시를 선택합니다. 소유하고 있는 모든 메시와 [공유된](sharing.md) 모든 메시가 나열됩니다.

1. 왼쪽 탐색 창에서 **Virtual routers(가상 라우터)**를 선택합니다.

1. **가상 라우터** 테이블에서 삭제하려는 가상 라우터를 선택하고 오른쪽 상단 구석에서 **삭제**를 선택합니다. 가상 라우터를 삭제하려면 가상 라우터의 **메시 소유자** 또는 **리소스 소유자** 열에 계정 ID가 나열되어야 합니다.

1. 확인 상자에 **delete**를 입력한 다음, **삭제**를 클릭합니다.

------
#### [ AWS CLI ]

**를 사용하여 가상 라우터를 삭제하려면 AWS CLI**

1. 다음 명령을 사용하여 가상 라우터를 삭제합니다(*빨간색* 값을 원하는 값으로 대체).

   ```
   aws appmesh delete-virtual-router \
        --mesh-name meshName \
        --virtual-router-name routerName
   ```

1. 출력 예시:

   ```
   {
       "virtualRouter": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:210987654321:mesh/meshName/virtualRouter/routerName",
               "createdAt": "2022-04-06T11:49:47.216000-05:00",
               "lastUpdatedAt": "2022-04-07T10:49:53.402000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "210987654321",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 2
           },
           "spec": {
               "listeners": [
                   {
                       "portMapping": {
                           "port": 80,
                           "protocol": "http"
                       }
                   }
               ]
           },
           "status": {
               "status": "DELETED"
           },
           "virtualRouterName": "routerName"
       }
   }
   ```

App Mesh용를 사용하여 가상 라우터를 삭제하는 방법에 AWS CLI 대한 자세한 내용은 AWS CLI 참조의 [delete-virtual-router](https://docs.aws.amazon.com/cli/latest/reference/appmesh/delete-virtual-router.html) 명령을 참조하세요.

------