10.4. 메시징 끝점에 대한 연결 및 리소스 제한 설정

절차

1. vhost 섹션을 추가하고 메시징 끝점에 대한 연결 및 메시지 크기 제한을 정의합니다.

   연결 제한은 vhost에 연결된 모든 사용자에게 적용됩니다. 이러한 제한은 vhost에 동시에 연결할 수 있는 사용자 수를 제어합니다.

   vhost {
       hostname: "example.com"
       aliases: "example.org, example.net"
       maxConnections: 10000
       maxMessageSize: 500000
       maxConnectionsPerUser: 100
       maxConnectionsPerHost: 100
       allowUnknownUser: true
       ...
   }

   hostname

   vhost( messaging 끝점)의 리터럴 호스트 이름 또는 vhost 호스트 이름과 일치하는 패턴입니다. 이 vhost 정책은 사용자가 지정하는 호스트 이름으로 전달되는 모든 클라이언트 연결에 적용됩니다. 이 이름은 고유해야 합니다. 호스트 이름당 하나의 vhost 정책만 사용할 수 있습니다.

   enableVhostNamePatterns 가 true 로 설정된 경우 와일드카드를 사용하여 호스트 이름의 범위와 일치하는 패턴을 지정할 수 있습니다. 자세한 내용은 10.4.6절. “vhost 정책 호스트 이름 패턴 일치 규칙”의 내용을 참조하십시오.

   별칭

   라우터에서 이 vhost의 설정을 사용하도록 지시하는 대체 리터럴 호스트 이름 또는 패턴입니다. 들어오는 연결과 일치하는 별칭 호스트 이름은 vhost 섹션에 정의된 설정을 사용합니다. 다중 테넌트 구성에서 vhost 별칭에 대한 연결은 테넌트 네임스페이스의 기본 vhost 호스트 이름을 사용합니다. 이 예에서 연결이 vhost example.org 로 이동되면 기본 vhost 호스트 이름 example.com 의 설정이 적용되고 example.com 은 테넌트 네임스페이스가 됩니다. 모든 vhosts의 vhost 호스트 이름 및 별칭 설정은 고유해야 합니다.

   enableVhostNamePatterns 가 true 로 설정된 경우 와일드카드를 사용하여 호스트 이름 별칭 범위와 일치하는 패턴을 지정할 수 있습니다. 자세한 내용은 10.4.6절. “vhost 정책 호스트 이름 패턴 일치 규칙”의 내용을 참조하십시오.

   maxConnections

   이 vhost에 허용되는 최대 동시 클라이언트 연결의 최대 수입니다. 기본값은 65535입니다.

   maxMessageSize

   이 vhost에 연결할 수 있는 AMQP 메시지 전송의 최대 크기(바이트)입니다. 이 제한은 정책 maxMessageSize 값을 재정의하고 vhost 사용자 그룹 설정으로 덮어쓸 수 있습니다. 값이 0 이면 이 제한이 비활성화됩니다.

   maxConnectionsPerUser

   모든 사용자에 대해 허용되는 최대 동시 클라이언트 연결 수입니다. 기본값은 65535입니다.

   maxConnectionsPerHost

   모든 원격 호스트(클라이언트가 연결되는 호스트)에 대해 허용되는 최대 동시 클라이언트 연결 수입니다. 기본값은 65535입니다.

   allowUnknownUser

   알 수 없는 사용자(정의된 사용자 그룹의 멤버가 아닌 사용자)가 vhost에 연결할 수 있는지 여부입니다. 알 수 없는 사용자는 $default 사용자 그룹에 할당되며 $default 설정을 받습니다. 기본값은 false 입니다. 즉, 알 수 없는 사용자가 허용되지 않습니다.

2. 추가한 연결 설정 아래에 있는 vhost 섹션에서 groups 엔터티를 추가하여 리소스 제한을 정의합니다.

   사용자 그룹별로 리소스 제한을 정의합니다. 사용자 그룹은 그룹 멤버가 액세스할 수 있는 메시징 리소스를 지정합니다.

   이 예제에서는 admin, developers, $default의 세 가지 사용자 그룹을 보여줍니다.

   vhost {
       ...
       groups: {
           admin: {
               users: "admin1, admin2"
               remoteHosts: "127.0.0.1, ::1"
               sources: "*"
               targets: "*"
           }
           developers: {
               users: "dev1, dev2, dev3"
               remoteHosts: "*"
               sources: "myqueue1, myqueue2"
               targets: "myqueue1, myqueue2"
           }
           $default: {
               remoteHosts: "*"
               allowDynamicSource: true,
               allowAdminStatusUpdate: true,
               sources: "myqueue1, myqueue2"
               targets: "myqueue1, myqueue2"
           }
       }
   }

   참고

   따옴표를 사용하여 문자열 값을 정의합니다.

   사용자

   이 사용자 그룹에 대해 인증된 사용자 목록입니다. 여러 사용자를 분리하려면 쉼표를 사용합니다. 사용자는 하나의 가상호스트 사용자 그룹에만 속할 수 있습니다.

   remoteHosts

   사용자가 연결할 수 있는 원격 호스트 목록입니다. 호스트는 호스트 이름, IP 주소 또는 IP 주소 범위일 수 있습니다. 쉼표를 사용하여 여러 호스트를 구분합니다. 모든 원격 호스트에서 액세스를 허용하려면 와일드카드 * 를 지정합니다. 모든 원격 호스트에서 액세스를 거부하려면 이 속성을 비워 둡니다.

   maxConnectionsPerUser

   이 사용자 그룹의 사용자가 생성할 수 있는 최대 연결 수입니다. 이 값을 지정하면 vhost maxConnectionsPerUser 값을 덮어씁니다.

   maxConnectionsPerHost

   허용된 원격 호스트에서 이 사용자 그룹의 사용자가 생성할 수 있는 최대 동시 연결 수입니다. 이 값을 지정하면 vhost maxConnectionsPerUser 값을 덮어씁니다.

   maxMessageSize

   이 그룹의 사용자가 생성한 연결에 허용되는 AMQP 메시지 전송의 최대 크기(바이트)입니다. 이 제한은 policy 및 vhost maxMessageSize 값을 덮어씁니다. 값이 0 이면 이 제한이 비활성화됩니다.

   allowDynamicSource

   true 인 경우 이 그룹의 사용자 연결은 수신자를 동적 소스에 연결할 수 있습니다. 이를 통해 임시 주소 또는 임시 큐에 리스너를 생성할 수 있습니다. false 인 경우 동적 소스를 사용할 수 없습니다.

   allowAdminStatusUpdate

   true 인 경우 이 그룹의 사용자 연결은 연결의 adminStatus 를 수정할 수 있습니다. 이는 발신자 또는 수신자 연결의 종료를 허용합니다. false 인 경우 이 그룹의 사용자는 연결을 종료하지 못하도록 합니다. 라우터 간 연결은 사용자가 종료할 수 없습니다. 정책이 구성되지 않은 경우에도 기본값은 true 입니다.

   allowWaypointLinks

   true 인 경우 이 그룹의 사용자의 연결은 waypoint 기능을 사용하여 링크를 연결할 수 있습니다. 이를 통해 끝점은 자동 링크를 구성할 필요 없이 끝점(즉, 브로커)으로 작동할 수 있습니다. false 인 경우 waypoint 기능을 사용할 수 없습니다.

   allowDynamicLinkRoutes

   true 인 경우 이 그룹의 사용자의 연결은 연결 범위 링크 경로 대상을 동적으로 생성할 수 있습니다. 이를 통해 끝점이 링크 경로를 구성할 필요 없이 링크 경로 대상(즉, 브로커)으로 작동할 수 있습니다. false 인 경우 동적 링크 경로 대상 생성이 허용되지 않습니다.

   allowFallbackLinks

   true 인 경우 이 그룹의 사용자의 연결은 폴백 링크 기능을 사용하여 링크를 연결할 수 있습니다. 이를 통해 폴백이 활성화된 주소에 대한 엔드포인트가 대체 대상(및 소스)으로 작동할 수 있습니다. false 인 경우 대체 링크 기능을 사용할 수 없습니다.

   sources | sourcePattern

   이 그룹의 사용자가 메시지를 수신할 수 있는 AMQP 소스 주소 목록입니다.

   소스를 사용하여 하나 이상의 리터럴 주소를 지정합니다. 여러 주소를 지정하려면 쉼표로 구분된 목록을 사용합니다. 이 그룹의 사용자가 모든 주소에서 메시지를 수신하지 못하도록 하려면 이 속성을 비워 둡니다. 특정 사용자와 관련된 주소에 대한 액세스를 허용하려면 ${user} 토큰을 지정합니다. 자세한 내용은 10.4.5절. “vhost 정책 소스 및 대상 주소를 지정하는 방법”의 내용을 참조하십시오.

   또는 sourcePattern 을 사용하여 패턴에 해당하는 하나 이상의 주소를 일치시킬 수 있습니다. 패턴은 . 또는 / 문자로 구분된 일련의 단어입니다. 와일드카드 문자를 사용하여 단어를 나타낼 수 있습니다. * 문자는 정확히 하나의 단어와 일치하며 # 문자는 0개 이상의 단어와 일치합니다.

   여러 주소 범위를 지정하려면 쉼표로 구분된 주소 패턴 목록을 사용합니다. 자세한 내용은 ]을 참조하십시오. 특정 사용자와 관련된 주소 범위에 대한 액세스를 허용하려면 ${user} 토큰을 지정합니다. 자세한 내용은 xref:methods-specifying-vhost-policy-source-target-addresses-router-rhel[ 를 참조하십시오.

   targets | targetPattern

   이 그룹의 사용자가 메시지를 보낼 수 있는 AMQP 대상 주소 목록입니다. 여러 AMQP 주소를 지정하고 소스 주소와 동일한 방식으로 사용자 이름 대체 및 주소 패턴을 사용할 수 있습니다.

3. 필요한 경우 고급 사용자 그룹 설정을 vhost 사용자 그룹에 추가합니다.

   고급 사용자 그룹 설정을 사용하면 연결의 열린 AMQP 연결, 세션 시작 및 링크 연결 단계에 따라 리소스 제한을 정의할 수 있습니다. 자세한 내용은 qdrouterd.conf 매뉴얼 페이지의 vhost 를 참조하십시오.

절차

1. /etc/qpid-dispatch/qdrouterd.conf 구성 파일에서 vhost 정책 정의 JSON 파일을 저장할 디렉터리를 지정합니다.

   policy {
       ...
       policyDir: /etc/qpid-dispatch-policies
   }

   policyDir

   JSON 형식의 vhost 정책 정의 파일이 있는 디렉터리의 절대 경로입니다. 라우터는 이 디렉터리에 있는 각 JSON 파일에서 모든 vhost 정책을 처리합니다.

2. vhost 정책 정의 디렉터리에서 각 vhost 정책에 대해 JSON 파일을 생성합니다.

   예 10.1. vhost 정책 정의 JSON 파일

   [
       ["vhost", {
           "hostname": "example.com",
           "maxConnections": 10000,
           "maxConnectionsPerUser": 100,
           "maxConnectionsPerHost": 100,
           "allowUnknownUser": true,
           "groups": {
               "admin": {
                   "users": ["admin1", "admin2"],
                   "remoteHosts": ["127.0.0.1", "::1"],
                   "sources": "*",
                   "targets": "*"
               },
               "developers": {
                   "users": ["dev1", "dev2", "dev3"],
                   "remoteHosts": "*",
                   "sources": ["myqueue1", "myqueue2"],
                   "targets": ["myqueue1", "myqueue2"]
               },
               "$default": {
                   "remoteHosts": "*",
                   "allowDynamicSource": true,
                   "sources": ["myqueue1", "myqueue2"],
                   "targets": ["myqueue1", "myqueue2"]
               }
           }
       }]
   ]

   이러한 속성에 대한 자세한 내용은 10.4.2절. “가상 호스트 정책 생성” 을 참조하십시오.

절차

1. /etc/qpid-dispatch/qdrouterd.conf 구성 파일에서 $connector 사용자 그룹이 있는 vhost 섹션을 추가합니다.

   vhost {
       hostname: "my-connector-policy"
       groups: {
           $connector: {
               sources: "*"
               targets: "*"
               maxSenders: 5
               maxReceivers: 10
               allowAnonymousSender: true
               allowWaypointLinks: true
           }
       }
   }

   hostname

   커넥터 vhost 정책을 식별하는 고유한 이름입니다. 이 이름은 실제 호스트 이름을 나타내지 않으므로 실제 vhost 호스트 이름과 충돌하지 않는 이름을 선택합니다.

   $Connector

   이 vhost 정책을 커넥터 vhost 정책으로 식별합니다. 적용할 수 있는 리소스 제한에 대한 자세한 내용은 10.4.2절. “가상 호스트 정책 생성” 을 참조하십시오.

2. 외부 AMQP 컨테이너에 대한 연결을 설정하는 커넥터에 커넥터 vhost 정책을 적용합니다.

   다음 예제에서는 이전 단계에서 구성한 커넥터 vhost 정책을 적용합니다.

   connector {
       host: 192.0.2.10
       port: 5672
       role: normal
       policyVhost: my-connector-policy
   }