14.7. 클라이언트 연결 파티셔닝

절차

1. 첫 번째 브로커에 대해 <broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. connection-routers 요소를 생성하고 일관된 해시 알고리즘을 사용하여 클라이언트 ID를 필터링할 connection-route 를 생성합니다. 예를 들면 다음과 같습니다.

   <configuration>
      <core>
         ...
         <connection-routers>
            <connection-route name=”consistent-hash-routing”>
               <key>CLIENT_ID</target-key>
               <local-target-filter>NULL|0</local-target-filter>
               <policy name="CONSISTENT_HASH_MODULO">
                  <property key="modulo" value="<number_of_brokers_in_cluster>">
                  </property>
               </policy>
            </connection-route>
         </connection-routers>
         ...
      </core>
   </configuration>

   connection-route

   connection-route name 에게 이 연결 라우팅 구성에 대해 식별 문자열을 지정합니다. 일관된 해시 필터를 적용하려면 각 브로커 어셉터에 이 이름을 추가해야 합니다.

   key

   필터를 적용할 키 유형입니다. 클라이언트 ID를 필터링하려면 키 필드에 CLIENT_ID 를 지정합니다.

   local-target-filter

   브로커가 modulo 작업에서 반환된 정수 값과 비교하여 일치 항목이 있고 브로커가 연결을 수락할 수 있는지 여부를 결정합니다. 이 예제의 NULL|0 값은 클라이언트 ID (NULL)가 없는 연결과 modulo 작업에서 반환한 숫자가 0 인 연결에 대한 일치를 제공합니다.

   policy

   대상 브로커를 식별하기 위해 해시된 클라이언트 ID에서 modulo 작업을 수행하는 modulo 속성 키를 수락합니다. modulo 속성 키의 값은 클러스터의 브로커 수와 같아야 합니다.

   중요

   정책 이름은 CONSISTENT_HASH_MODULO 이어야 합니다.

3. 두 번째 브로커의 <broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

4. connection-routers 요소를 생성하고 일관된 해시 알고리즘을 사용하여 클라이언트 ID를 필터링하는 연결 경로 를 생성합니다.

   다음 예제에서 NULL|1 의 local-target-filter 값은 클라이언트 ID(NULL)가 없는 연결과 modulo 작업에서 반환한 값이 1 인 연결에 대한 일치를 제공합니다.

   <configuration>
      <core>
         ...
         <connection-routers>
            <connection-route name=”consistent-hash-routing”>
               <key>CLIENT_ID</target-key>
               <local-target-filter>NULL|1</local-target-filter>
               <policy name="CONSISTENT_HASH_MODULO">
                  <property key="modulo" value="<number_of_brokers_in_cluster>">
                  </property>
               </policy>
            </connection-route>
         </connection-routers>
         ...
      </core>
   </configuration>

5. 클러스터의 각 추가 브로커에 대해 일관된 해시 필터를 생성하려면 이 절차를 반복합니다.

절차

1. 첫 번째 브로커에 대해 <broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. connection-routers 요소를 생성하고 클라이언트 ID의 일부를 필터링할 connection-route 를 생성합니다. 예를 들면 다음과 같습니다.

   <configuration>
       <core>
           ...
           <connection-routers>
               <connection-route name=”regex-routing”>
                   <key>CLIENT_ID</target-key>
                   <key-filter>^.{3}</key-filter>
                   <local-target-filter>NULL|FOO</local-target-filter>
               </connection-route>
       </connection-routers>
           ...
       </core>
   </configuration>

   connection-route

   connection-route name 에게 이 라우팅 구성에 대한 식별 문자열을 지정합니다. 정규식 필터를 적용하려면 각 브로커 어셉터에 이 이름을 추가해야 합니다.

   key

   필터를 적용할 키입니다. 클라이언트 ID를 필터링하려면 키 필드에 CLIENT_ID 를 지정합니다.

   key-filter

   키 값을 추출하기 위해 정규식이 적용되는 클라이언트 ID 문자열의 일부입니다. 위의 첫 번째 브로커 예제에서 브로커는 클라이언트 ID의 처음 3자인 키 값을 추출합니다. 예를 들어 클라이언트 ID 문자열이 FOO100.consumer 인 경우 브로커는 FOO 의 키 값을 추출합니다. 브로커가 키 값을 추출한 후 이를 local-target-filter 의 값과 비교합니다.

   들어오는 연결에 클라이언트 ID가 없거나 브로커가 키 -필터 에 지정된 정규식을 사용하여 키 값을 추출할 수 없는 경우 키 값은 NULL로 설정됩니다.

   local-target-filter

   브로커가 키 값과 비교하여 일치 항목이 있고 브로커에서 연결을 수락할 수 있는지 확인하는 값입니다. 위의 첫 번째 브로커의 예에 표시된 대로 NULL|FOO 값은 클라이언트 ID(NULL)가 없거나 클라이언트 ID에 FOO 의 3자 접두사가 없는 연결과 일치합니다.

3. 두 번째 브로커의 <broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

4. connection-routers 요소를 만들고 클라이언트 ID의 일부를 기반으로 연결을 필터링할 연결 경로 를 만듭니다.

   다음 필터 예제에서 브로커는 정규식을 사용하여 클라이언트 ID의 처음 3자인 키 값을 추출합니다. 브로커는 NULL 과 BAR 의 값을 키 값과 비교하여 일치 항목이 있고 브로커가 연결을 수락할 수 있는지 확인합니다.

   <configuration>
       <core>
           ...
           <connection-routers>
               <connection-route name=”regex-routing”>
                   <key>CLIENT_ID</target-key>
                   <key-filter>^.{3}</key-filter>
                   <local-target-filter>NULL|BAR</local-target-filter>
               </connection-route>
           </connection-routers>
           ...
       </core>
   </configuration>

5. 이 절차를 반복하고 클러스터의 각 추가 브로커에 대해 적절한 연결 라우팅 필터를 생성합니다.