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 이름 의 경우 이 연결 라우팅 구성에 대해 식별 문자열을 지정합니다. 일관된 해시 필터를 적용하려면 이 이름을 각 브로커 수락자에 추가해야 합니다.

   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 값은 NULL(클라이언트 ID)이 없는 연결과 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|CL1</local-target-filter>
               </connection-route>
       </connection-routers>
           ...
       </core>
   </configuration>

   connection-route

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

   key

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

   key-filter

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

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

   local-target-filter

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

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

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

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

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

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