4.2. Operator 기반 브로커 배포를 위한 주소 및 대기열 구성

프로세스

1. 브로커 배포에 사용할 ActiveMQArtemis CR 인스턴스를 편집합니다.

2. CR의 spec 섹션에서 CR에 아직 없는 경우 brokerProperties 속성을 추가합니다.

   spec:
     ...
     brokerProperties:
     ...

3. 형식으로 주소를 구성합니다.

   - addressConfigurations.<주소 이름>.routingTypes=<라우팅 유형>

   예를 들면 다음과 같습니다.

   spec:
     ...
     brokerProperties:
     - addressConfigurations.usa-news-address.routingTypes=MULTICAST
     ...

4. 형식으로 생성한 주소에 대한 큐를 구성합니다.

   - addressConfigurations.<주소 이름>.queueConfigs.<큐 이름>.address<address>

   중요

   .address 설정의 <address> 값은 생성한 각 큐에 대해 <주소 이름>과 일치해야 합니다. 이러한 값이 다른 경우 각각에 대해 별도의 주소가 생성됩니다. 다음 예에서 주소 이름과 .address 설정의 모두 usa-news-address 의 값과 동일합니다.

   spec:
     ...
     brokerProperties:
     - addressConfigurations.usa-news-address.queueConfigs.usa-news-queue.address=usa-news-address
     ...

5. 형식으로 큐에 대해 구성할 각 설정에 대해 별도의 행을 추가합니다.

   • addressConfigurations.<주소 이름>.queueConfigs.<큐 이름>.<큐 설정>

   예를 들면 다음과 같습니다.

   spec:
     ...
     brokerProperties:
     - addressConfigurations.usa-news-address.queueConfigs.usa-news-queue.routingType=ANYCAST
     - addressConfigurations.usa-news-address.queueConfigs.usa-news-queue.purgeOnNoConsumers=true
     - addressConfigurations.usa-news-address.queueConfigs.usa-news-queue.maxConsumers=20
     ...

6. CR을 저장합니다.
7. ActiveMQArtemis CR의 status 섹션을 검토하여 brokerProperties 구성에서 오류가 감지되지 않았는지 확인합니다. 자세한 내용은 2.4절. “CRD(사용자 정의 리소스 정의)에 노출되지 않은 항목 구성”의 내용을 참조하십시오.

프로세스

1. 브로커 배포에 대한 주소 및 큐를 정의하도록 CR(사용자 정의 리소스) 인스턴스 구성을 시작합니다.

   1. OpenShift 명령줄 인터페이스 사용:

      1. 브로커 배포를 위해 프로젝트에 CR을 배포할 수 있는 권한이 있는 사용자로 OpenShift에 로그인합니다.

         oc login -u <user> -p <password> --server=<host:port>

      2. 다운로드 및 추출한 Operator 설치 아카이브의 deploy/crs 디렉터리에 포함된 broker_activemqartemisaddress_cr.yaml 이라는 샘플 CR 파일을 엽니다.

   2. OpenShift Container Platform 웹 콘솔 사용:

      1. 브로커 배포를 위해 프로젝트에 CR을 배포할 권한이 있는 사용자로 콘솔에 로그인합니다.
      2. 주소 CRD를 기반으로 새 CR 인스턴스를 시작합니다. 왼쪽 창에서 Administration Custom Resource Definitions 를 클릭합니다.
      3. ActiveMQArtemisAddresss CRD를 클릭합니다.
      4. Instances 탭을 클릭합니다.

      5. Create ActiveMQArtemisAddress 를 클릭합니다.

         콘솔에서 YAML 편집기가 열리고 CR 인스턴스를 구성할 수 있습니다.

2. CR의 spec 섹션에서 주소, 큐 및 라우팅 유형을 정의하는 행을 추가합니다. 예를 들면 다음과 같습니다.

   apiVersion: broker.amq.io/v1beta1
   kind: ActiveMQArtemisAddress
   metadata:
       name: myAddressDeployment0
       namespace: myProject
   spec:
       ...
       addressName: myAddress0
       queueName: myQueue0
       routingType: anycast
       ...

   이전 구성은 myQueue0 큐와 anycast 라우팅 유형으로 myAddress0 이라는 주소를 정의합니다.

   참고

   metadata 섹션에는 namespace 속성을 포함하고 OpenShift Container Platform 웹 콘솔을 사용하여 CR 인스턴스를 생성하는 경우에만 값을 지정해야 합니다. 지정해야 하는 값은 브로커 배포를 위한 OpenShift 프로젝트의 이름입니다.

3. CR 인스턴스를 배포합니다.

   1. OpenShift 명령줄 인터페이스 사용:

      1. CR 파일을 저장합니다.

      2. 브로커 배포를 위해 프로젝트로 전환합니다.

         $ oc project <project_name>

      3. CR 인스턴스를 생성합니다.

         $ oc create -f <path/to/address_custom_resource_instance>.yaml

   2. OpenShift 웹 콘솔 사용:

      1. CR 구성을 완료하면 생성 을 클릭합니다.

1. 브로커 배포에 사용할 ActiveMQArtemis CR 인스턴스를 편집합니다.

2. 배달되지 않은 메시지를 수신하기 위해 dead letter address 및 queue를 만듭니다. 예를 들면 다음과 같습니다.

   spec:
     ...
     brokerProperties:
     ...
     - addressConfigurations.usDeadLetter.routingTypes=MULTICAST
     - addressConfigurations.usDeadLetter.queueConfigs.usDeadLetter-queue.address=usDeadLetter

   brokerProperties 를 사용하여 주소 및 큐 생성에 대한 자세한 내용은 4.2.1절. “주소 및 큐 구성” 을 참조하십시오.

3. addressSettings.< 주소이름>.< 주소 설정 > 의 brokerProperties 속성 아래에 별도의 행을 추가합니다.

   • 생성된 dead letter address를 dead letter address로 설정합니다.

   • 배달 시도 횟수를 지정한 후 일치하는 주소로 전달할 수 없는 메시지를 dead letter 주소로 보냅니다.

     예를 들면 다음과 같습니다.

     spec:
       ...
       brokerProperties:
       ...
       - addressSettings.usa-news.deadLetterAddress=usDeadLetter
       - addressSettings.usa-news.maxDeliveryAttempts=5
       ...

     별표(*) 또는 숫자 기호(#) 문자를 와일드카드로 사용하여 주소 패턴을 만들 수 있습니다. 패턴의 일치는 마침표(.)로 표시되는 각 구분 기호 경계에서 수행됩니다. 숫자 기호 문자는 0개 이상의 단어와 일치하며 주소 문자열 끝에 사용할 수 있습니다. 별표 문자는 단일 단어와 일치하며 address 문자열 내의 모든 위치에서 사용할 수 있습니다. 예를 들면 다음과 같습니다.

     spec:
       ...
       brokerProperties:
       ...
       - addressSettings."usa-news.*".deadLetterAddress=usDeadLetter
       - addressSettings."europe-news.#".deadLetterAddress=euDeadLetter
       ...

     이전 예에서 다음 주소가 일치합니다.

   • usa-news.* 주소 패턴은 usa-news.domestic 및 usa-news. intl 과 같이 usa-news.politics 문자열과 일치하지만 usa-news.domestic.politics.

   • europe-news.# 주소 패턴은 europe-news , europe-news.politics 및 europe-news.politics. fr과 같이 europe-news 로 시작하는 모든 주소와 일치합니다.

     참고

     brokerProperties 항목에서 마침표(.)는 예약된 문자입니다. 마침표가 포함된 주소 패턴을 만들려면 주소를 따옴표로 묶어야 합니다. 예: "usa-news.*"

4. CR을 저장합니다.
5. ActiveMQArtemis CR의 status 섹션을 검토하여 brokerProperties 구성에서 오류가 감지되지 않았는지 확인합니다. 자세한 내용은 2.4절. “CRD(사용자 정의 리소스 정의)에 노출되지 않은 항목 구성”의 내용을 참조하십시오.

프로세스

1. 브로커 배포에 사용할 ActiveMQArtemis CR 인스턴스를 편집합니다.

    oc edit ActiveMQArtemis <CR instance name> -n <namespace>

   1. OpenShift Container Platform 웹 콘솔 사용:
2. 브로커 배포를 위해 프로젝트에 CR을 배포할 권한이 있는 사용자로 콘솔에 로그인합니다.
3. 왼쪽 창에서 Operators Installed Operator 를 클릭합니다.
4. Red Hat Integration - AMQ Broker for RHEL 8 (Multiarch) Operator를 클릭합니다.
5. AMQ Broker 탭을 클릭합니다.
6. ActiveMQArtemis 인스턴스 이름의 이름을 클릭합니다.

7. YAML 탭을 클릭합니다.

   콘솔에서 YAML 편집기가 열리고 CR 인스턴스를 편집할 수 있습니다.

   참고

   metadata 섹션에는 namespace 속성을 포함하고 OpenShift Container Platform 웹 콘솔을 사용하여 CR 인스턴스를 생성하는 경우에만 값을 지정해야 합니다. 지정해야 하는 값은 브로커 배포를 위한 OpenShift 프로젝트의 이름입니다.

   1. CR의 spec 섹션에서 다음과 같이 단일 addressSetting 섹션이 포함된 새 addressSettings 섹션을 추가합니다.

      spec:
        ...
        addressSettings:
          addressSetting:

   2. addressSetting 블록에 match 속성의 단일 인스턴스를 추가합니다. 주소 일치 표현식을 지정합니다. 예를 들면 다음과 같습니다.

      spec:
        ...
        addressSettings:
          addressSetting:
          - match: myAddress

      match

      브로커가 다음 구성을 적용하는 주소 또는 주소를 지정합니다. 이 예제에서 match 속성의 값은 myAddress 라는 단일 주소에 해당합니다.

   3. 전달되지 않은 메시지와 관련된 속성을 추가하고 값을 지정합니다. 예를 들면 다음과 같습니다.

      spec:
        ...
        addressSettings:
          addressSetting:
          - match: myAddress
            deadLetterAddress: myDeadLetterAddress
            maxDeliveryAttempts: 5

      deadLetterAddress

      브로커가 전달되지 않은 메시지를 보내는 주소입니다.

      maxDeliveryAttempts

      구성된 dead letter 주소로 메시지를 이동하기 전에 브로커가 수행하는 최대 전달 시도 수입니다.

      이전 예에서 브로커가 myAddress 로 시작하는 주소로 5번 메시지를 전달하려고 하면 브로커는 지정된 dead letter address인 myDeadLetterAddress 로 메시지를 이동합니다.

   4. (선택 사항) 다른 주소 또는 주소 집합에 유사한 구성을 적용합니다. 예를 들면 다음과 같습니다.

      spec:
        ...
        addressSettings:
          addressSetting:
          - match: myAddress
            deadLetterAddress: myDeadLetterAddress
            maxDeliveryAttempts: 5
          - match: 'myOtherAddresses#'
            deadLetterAddress: myDeadLetterAddress
            maxDeliveryAttempts: 3

      이 예제에서 두 번째 match 속성 값에는 해시 와일드카드 문자가 포함됩니다. 와일드카드 문자는 이전 구성이 myOtherAddresses 문자열로 시작하는 모든 주소에 적용됨을 의미합니다.

      참고

      와일드카드 표현식을 match 속성의 값으로 사용하는 경우, 값을 작은따옴표로 묶어야 합니다(예: 'myOtherAddresses#' ).

   5. addressSettings 섹션의 시작 부분에 applyRule 속성을 추가하고 값을 지정합니다. 예를 들면 다음과 같습니다.

      spec:
        ...
          applyRule: merge_all
          addressSetting:
          - match: myAddress
            deadLetterAddress: myDeadLetterAddress
            maxDeliveryAttempts: 5
          - match: 'myOtherAddresses#'
            deadLetterAddress: myDeadLetterAddress
            maxDeliveryAttempts: 3

      applyRule 속성은 Operator가 일치하는 주소 또는 주소 집합에 대해 CR에 추가하는 구성을 적용하는 방법을 지정합니다. 지정할 수 있는 값은 다음과 같습니다.

      merge_all

      • CR 및 기본 구성에 모두 지정된 주소 설정의 경우 동일한 주소 또는 주소 집합과 일치하는 기본 구성입니다.

        • 기본 구성에 지정된 속성 값을 CR에 지정된 속성 값으로 바꿉니다.
        • CR 또는 기본 구성에 고유하게 지정된 속성 값을 유지합니다. 각 항목을 최종 병합된 구성에 포함합니다.
      • CR 또는 특정 주소 또는 주소 집합과 일치하는 기본 구성에 지정된 주소 설정의 경우 이를 최종 병합된 구성에 포함합니다.

      merge_replace

      • CR 및 동일한 주소 또는 주소 집합과 일치하는 기본 구성에 지정된 주소 설정의 경우 CR 에 지정된 설정을 최종 병합된 구성에 포함합니다. CR에 지정되지 않은 경우에도 기본 구성에 지정된 속성은 포함하지 마십시오.
      • CR 또는 특정 주소 또는 주소 집합과 일치하는 기본 구성에 지정된 주소 설정의 경우 이를 최종 병합된 구성에 포함합니다.

      replace_all

      기본 구성에 지정된 모든 주소 설정을 CR에 지정된 주소로 바꿉니다. 최종 병합 구성은 CR에 지정된 것과 정확히 일치합니다.

      참고

      CR에 applyRule 속성을 명시적으로 포함하지 않으면 Operator는 기본값 merge_all 을 사용합니다.

   6. CR 인스턴스를 저장합니다.

프로세스

1. 브로커 배포에 사용할 ActiveMQArtemis CR 인스턴스를 편집합니다.

2. 다음 brokerProperties 항목을 추가하여 브로커가 숫자 기호(#) 및 CR에서 더 이상 찾을 수 없는 연결된 큐로 표시되는 주소를 삭제할 수 있습니다.

   spec:
     ...
     brokerProperties:
     - addressSettings.#.configDeleteAddresses=FORCE
     - addressSettings.#.configDeleteQueues=FORCE
     ...

3. brokerProperties 속성에서 제거할 주소와 큐를 참조하는 모든 행을 삭제합니다. 예를 들어 usa-news 주소를 참조하는 모든 행을 삭제하여 이 주소와 큐를 제거합니다.

   spec:
     ...
     brokerProperties:
     - addressConfigurations.usa-news.queueConfigs.usa-news-queue.routingType=MULTICAST
     - addressConfigurations.usa-news.queueConfigs.usa-news-queue.purgeOnNoConsumers=true
     - addressConfigurations.usa-news.queueConfigs.usa-news-queue.maxConsumers=20
     ...

4. CR을 저장합니다.

   브로커가 업데이트된 구성을 적용하면 CR에서 제거한 주소와 큐를 삭제합니다.

프로세스

1. 삭제할 주소 및 큐의 이름,addressName 및 queueName 과 같은 세부 정보가 있는 주소 CR 파일이 있는지 확인합니다. 예를 들면 다음과 같습니다.

   apiVersion: broker.amq.io/v1beta1
   kind: ActiveMQArtemisAddress
   metadata:
       name: myAddressDeployment0
       namespace: myProject
   spec:
       ...
       addressName: myAddress0
       queueName: myQueue0
       routingType: anycast
       ...

2. address CR의 spec 섹션에서 removeFromBrokerOnDelete 속성을 추가하고 true 값으로 설정합니다.

   ..
   spec:
      addressName: myAddress1
      queueName: myQueue1
      routingType: anycast
      removeFromBrokerOnDelete: true

   removeFromBrokerOnDelete 속성을 true 로 설정하면 주소 CR을 삭제할 때 Operator에서 배포의 모든 브로커에 대한 주소 및 관련 메시지가 제거됩니다.

3. 업데이트된 주소 CR을 적용하여 삭제하려는 주소에 대한 removeFromBrokerOnDelete 속성을 설정합니다.

   $ oc apply -f <path/to/address_custom_resource_instance>.yaml

4. 주소 CR을 삭제하여 배포의 브로커에서 주소를 삭제합니다.

   $ oc delete -f <path/to/address_custom_resource_instance>.yaml