OpenShift에 AMQ Broker 배포

절차

1. 웹 브라우저에서 AMQ Broker 7.11.8 릴리스 의 소프트웨어 다운로드 페이지로 이동합니다.
2. 버전 드롭다운 목록의 값이 7.11.8 로 설정되고 릴리스 탭이 선택되어 있는지 확인합니다.

3. 최신 AMQ Broker 7.11.8 Operator 설치 및 예제 파일 옆에 있는 Download 를 클릭합니다.

   amq-broker-operator-7.11.8-ocp-install-examples.zip 압축 아카이브의 다운로드가 자동으로 시작됩니다.

4. 아카이브를 선택한 디렉터리로 이동합니다. 다음 예제에서는 아카이브를 ~/broker/operator 라는 디렉터리로 이동합니다.

   $ mkdir ~/broker/operator
   $ mv amq-broker-operator-7.11.8-ocp-install-examples.zip ~/broker/operator

   Copy to Clipboard Toggle word wrap

5. 선택한 디렉터리에서 아카이브의 콘텐츠를 추출합니다. 예를 들면 다음과 같습니다.

   $ cd ~/broker/operator
   $ unzip amq-broker-operator-7.11.8-ocp-install-examples.zip

   Copy to Clipboard Toggle word wrap

6. 아카이브를 추출했을 때 생성된 디렉터리로 전환합니다. 예를 들면 다음과 같습니다.

   $ cd amq-broker-operator-7.11.8-ocp-install-examples

   Copy to Clipboard Toggle word wrap

7. OpenShift Container Platform에 클러스터 관리자로 로그인합니다. 예를 들면 다음과 같습니다.

   $ oc login -u system:admin

   Copy to Clipboard Toggle word wrap

8. Operator를 설치할 프로젝트를 지정합니다. 새 프로젝트를 생성하거나 기존 프로젝트로 전환할 수 있습니다.

   1. 새 프로젝트를 생성합니다.

      $ oc new-project <project_name>

      Copy to Clipboard Toggle word wrap

   2. 또는 기존 프로젝트로 전환합니다.

      $ oc project <project_name>

      Copy to Clipboard Toggle word wrap

9. Operator와 함께 사용할 서비스 계정을 지정합니다.

   1. 추출한 Operator 아카이브의 배포 디렉터리에서 service_account.yaml 파일을 엽니다.
   2. kind 요소가 ServiceAccount 로 설정되어 있는지 확인합니다.
   3. 기본 서비스 계정 이름을 변경하려면 metadata 섹션에서 amq-broker-controller-manager 를 사용자 지정 이름으로 교체합니다.

   4. 프로젝트에서 서비스 계정을 생성합니다.

      $ oc create -f deploy/service_account.yaml

      Copy to Clipboard Toggle word wrap

10. Operator의 역할 이름을 지정합니다.

    1. role.yaml 파일을 엽니다. 이 파일은 Operator에서 사용하고 수정할 수 있는 리소스를 지정합니다.
    2. kind 요소가 Role 으로 설정되어 있는지 확인합니다.
    3. 기본 역할 이름을 변경하려면 metadata 섹션에서 amq-broker-operator-role 을 사용자 지정 이름으로 교체합니다.

    4. 프로젝트에 역할을 생성합니다.

       $ oc create -f deploy/role.yaml

       Copy to Clipboard Toggle word wrap

11. Operator의 역할 바인딩을 지정합니다. 역할 바인딩은 지정한 이름을 기반으로 이전에 생성한 서비스 계정을 Operator 역할에 바인딩합니다.

    1. role_binding.yaml 파일을 엽니다.

    2. ServiceAccount 및 Role 의 name 값이 service_account.yaml 및 role.yaml 파일에 지정된 이름과 일치하는지 확인합니다. 예를 들면 다음과 같습니다.

       metadata:
           name: amq-broker-operator-rolebinding
       subjects:
           kind: ServiceAccount
           name: amq-broker-controller-manager
       roleRef:
           kind: Role
           name: amq-broker-operator-role

       Copy to Clipboard Toggle word wrap

    3. 프로젝트에 역할 바인딩을 생성합니다.

       $ oc create -f deploy/role_binding.yaml

       Copy to Clipboard Toggle word wrap

12. Operator의 리더 선택 역할 바인딩을 지정합니다. 역할 바인딩은 지정한 이름에 따라 이전에 생성한 서비스 계정을 리더 선택 역할에 바인딩합니다.

    1. Operator에 대한 리더 선택 역할을 생성합니다.

       $ oc create -f deploy/election_role.yaml

       Copy to Clipboard Toggle word wrap

    2. 프로젝트에서 리더 선택 역할 바인딩을 생성합니다.

       $ oc create -f deploy/election_role_binding.yaml

       Copy to Clipboard Toggle word wrap

13. (선택 사항) Operator에서 여러 네임스페이스를 조사하려면 다음 단계를 완료합니다.

    참고

    OpenShift Container Platform 클러스터에 AMQ Broker용 Operator가 이미 설치된 경우 새 Operator에서 기존 Operator와 동일한 네임스페이스를 확인하지 않아야 합니다. 기존 Operator에서 조사하는 네임스페이스를 식별하는 방법에 대한 자세한 내용은 기존 Operator 에서 조사하는 네임스페이스 식별을 참조하십시오.

    1. 다운로드 및 추출한 Operator 아카이브의 배포 디렉터리에서 operator_yaml 파일을 엽니다.

    2. Operator에서 WATCH_NAMESPACE 섹션에서 클러스터의 모든 네임스페이스를 조사하려면 value 특성을 추가하고 값을 별표로 설정합니다. WATCH_NAMESPACE 섹션에서 기존 속성을 주석 처리하십시오. 예를 들면 다음과 같습니다.

       - name: WATCH_NAMESPACE
         value: "*"
       # valueFrom:
       #   fieldRef:
       #     fieldPath: metadata.namespace

       Copy to Clipboard Toggle word wrap
       참고

       충돌을 방지하려면 여러 Operator에서 동일한 네임스페이스를 조사하지 않도록 합니다. 예를 들어 Operator를 배포하여 클러스터의 모든 네임스페이스를 조사하는 경우 다른 Operator를 배포하여 개별 네임스페이스를 조사할 수 없습니다. Operator가 클러스터에 이미 배포된 경우 다음 단계에 설명된 대로 새 Operator에서 감시하는 네임스페이스 목록을 지정할 수 있습니다.

    3. Operator에서 클러스터의 모든 네임스페이스를 WATCH_NAMESPACE 섹션에서 여러 개의 네임스페이스를 조사하려면 네임스페이스 목록을 지정합니다. 기존 Operator에서 조사하는 네임스페이스를 제외해야 합니다. 예를 들면 다음과 같습니다.

       - name: WATCH_NAMESPACE
         value: "namespace1, namespace2"`.

       Copy to Clipboard Toggle word wrap
    4. 다운로드 및 추출한 Operator 아카이브의 배포 디렉터리에서 cluster_role_binding.yaml 파일을 엽니다.

    5. 주체 섹션에서 Operator를 배포하는 OpenShift Container Platform 프로젝트에 해당하는 네임스페이스를 지정합니다. 예를 들면 다음과 같습니다.

       Subjects:
       - kind: ServiceAccount
         name: amq-broker-controller-manager
         namespace: operator-project

       Copy to Clipboard Toggle word wrap
       참고

       이전 버전의 Operator를 사용하여 브로커를 이전에 배포하고 Operator를 배포하여 여러 네임스페이스를 조사 하려면 업그레이드하기 전에 참조하십시오.

    6. 프로젝트에 클러스터 역할을 생성합니다.

       $ oc create -f deploy/cluster_role.yaml

       Copy to Clipboard Toggle word wrap

    7. 프로젝트에 클러스터 역할 바인딩을 생성합니다.

       $ oc create -f deploy/cluster_role_binding.yaml

       Copy to Clipboard Toggle word wrap

절차

1. OpenShift CLI(명령줄 인터페이스)에서 클러스터 관리자로 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.

   $ oc login -u system:admin

   Copy to Clipboard Toggle word wrap

2. 이전에 Operator 배포에 준비한 프로젝트로 전환합니다. 예를 들면 다음과 같습니다.

   $ oc project <project_name>

   Copy to Clipboard Toggle word wrap

3. 이전에 Operator 설치 아카이브를 추출했을 때 생성된 디렉터리로 전환합니다. 예를 들면 다음과 같습니다.

   $ cd ~/broker/operator/amq-broker-operator-7.11.8-ocp-install-examples

   Copy to Clipboard Toggle word wrap

4. Operator에 포함된 CRD를 배포합니다. Operator를 배포하고 시작하기 전에 OpenShift 클러스터에 CRD를 설치해야 합니다.

   1. 주요 브로커 CRD를 배포합니다.

      $ oc create -f deploy/crds/broker_activemqartemis_crd.yaml

      Copy to Clipboard Toggle word wrap

   2. 주소 CRD를 배포합니다.

      $ oc create -f deploy/crds/broker_activemqartemisaddress_crd.yaml

      Copy to Clipboard Toggle word wrap

   3. 스케일다운 컨트롤러 CRD를 배포합니다.

      $ oc create -f deploy/crds/broker_activemqartemisscaledown_crd.yaml

      Copy to Clipboard Toggle word wrap

   4. 보안 CRD를 배포합니다.

      $ oc create -f deploy/crds/broker_activemqartemissecurity_crd.yaml

      Copy to Clipboard Toggle word wrap

5. Red Hat Ecosystem Catalog의 인증에 사용되는 계정과 연결된 풀 시크릿을 OpenShift 프로젝트의 기본,배포자 및 빌더 서비스 계정과 연결합니다.

   $ oc secrets link --for=pull default <secret_name>
   $ oc secrets link --for=pull deployer <secret_name>
   $ oc secrets link --for=pull builder <secret_name>

   Copy to Clipboard Toggle word wrap

6. 다운로드 및 추출한 Operator 아카이브의 배포 디렉터리에서 operator.yaml 파일을 엽니다. 다음과 같이 spec.containers.image 속성 값이 Operator의 7.11.8-opr-1 버전에 해당하는지 확인합니다.

   spec:
       template:
           spec:
               containers:
                   #image: registry.redhat.io/amq7/amq-broker-rhel8-operator:7.10
                   image: registry.redhat.io/amq7/amq-broker-rhel8-operator@sha256:d2ae3defac36f00112c6b773e13626336ba15d6f50f905ad1c33f122bfe1a6a9

   Copy to Clipboard Toggle word wrap
   참고

   operator.yaml 파일에서 Operator는SHA( Secure Hash Algorithm ) 값으로 표시되는 이미지를 사용합니다. 숫자 기호(#) 기호로 시작하는 주석 행은 SHA 값이 특정 컨테이너 이미지 태그에 해당함을 나타냅니다.

7. Operator를 배포합니다.

   $ oc create -f deploy/operator.yaml

   Copy to Clipboard Toggle word wrap

   OpenShift 프로젝트에서 Operator는 새 포드에서 시작됩니다.

   OpenShift Container Platform 웹 콘솔에서 Operator Pod의 Events 탭에 대한 정보는 OpenShift에서 지정한 Operator 이미지를 배포하고, OpenShift 클러스터의 노드에 새 컨테이너를 할당했으며 새 컨테이너를 시작했음을 확인합니다.

   또한 Pod 내의 Logs 탭을 클릭하면 출력에는 다음과 유사한 행이 포함되어야 합니다.

   ...
   {"level":"info","ts":1553619035.8302743,"logger":"kubebuilder.controller","msg":"Starting Controller","controller":"activemqartemisaddress-controller"}
   {"level":"info","ts":1553619035.830541,"logger":"kubebuilder.controller","msg":"Starting Controller","controller":"activemqartemis-controller"}
   {"level":"info","ts":1553619035.9306898,"logger":"kubebuilder.controller","msg":"Starting workers","controller":"activemqartemisaddress-controller","worker count":1}
   {"level":"info","ts":1553619035.9311671,"logger":"kubebuilder.controller","msg":"Starting workers","controller":"activemqartemis-controller","worker count":1}

   Copy to Clipboard Toggle word wrap

   이전 출력에서는 새로 배포된 Operator가 Kubernetes와 통신하고, 브로커 및 주소 지정에 대한 컨트롤러가 실행 중이며 이러한 컨트롤러에서 일부 작업자를 시작했는지 확인합니다.

절차

1. OpenShift Container Platform 웹 콘솔에 클러스터 관리자로 로그인합니다.
2. 왼쪽 탐색 메뉴에서 Operators → OperatorHub 를 클릭합니다.
3. OperatorHub 페이지 상단에 있는 프로젝트 드롭다운 메뉴에서 Operator를 배포할 프로젝트를 선택합니다.

4. OperatorHub 페이지에서 Filter by keyword…​ 상자를 사용하여 Red Hat Integration - AMQ Broker for RHEL 8(Multiarch) Operator를 찾습니다.

   참고

   OperatorHub에서는 해당 이름에 AMQ Broker 를 포함하는 것보다 두 개 이상의 Operator를 찾을 수 있습니다. Red Hat Integration - AMQ Broker for RHEL 8 (Multiarch) Operator를 클릭합니다. 이 Operator를 클릭하면 열리는 정보 창을 확인합니다. AMQ Broker 7.11의 경우 이 Operator의 최신 마이너 버전 태그는 7.11.8-opr-1 입니다.

5. Red Hat Integration - AMQ Broker for RHEL 8 (Multiarch) Operator를 클릭합니다. 표시되는 대화 상자에서 설치를 클릭합니다.

6. Operator 설치 페이지에서 다음을 수행합니다.

   1. Update Channel 에서 7.11.x 채널을 선택하여 버전 7.11에 대한 업데이트만 수신합니다. 7.11.x 채널은LTS(Long Term Support) 채널입니다.

      OpenShift Container Platform 클러스터가 설치된 시기에 따라 이전 버전의 AMQ Broker에 대한 채널도 표시될 수 있습니다. 다른 지원되는 유일한 채널은 7.10.x 이며 LTS 채널이기도 합니다.

   2. 설치 모드에서 Operator가 감시하는 네임스페이스를 선택합니다.

      • 클러스터의 특정 네임스페이스 - Operator가 해당 네임스페이스에 설치되고 CR 변경 사항만 모니터링합니다.
      • 모든 네임스페이스 - Operator는 모든 네임스페이스를 모니터링하여 CR 변경 사항을 모니터링합니다.
      참고

      이전 버전의 Operator를 사용하여 브로커를 이전에 배포하고 Operator를 배포하여 많은 네임스페이스를 조사 하려면 업그레이드하기 전에 참조하십시오.

7. 설치된 네임스페이스 드롭다운 메뉴에서 Operator를 설치할 프로젝트를 선택합니다.
8. 승인 전략에서 자동으로 권한이 있는 라디오 버튼이 선택되어 있는지 확인합니다. 이 옵션은 설치를 위해 Operator에 대한 업데이트를 수동으로 승인할 필요가 없도록 지정합니다.
9. 설치를 클릭합니다.

1. 브로커 배포용 CR(사용자 정의 리소스) 인스턴스 구성을 시작합니다.

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

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

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

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

   2. OpenShift Container Platform 웹 콘솔 사용:

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

      5. Create ActiveMQArtemis 를 클릭합니다.

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

   기본 브로커 배포의 경우 구성은 다음과 같이 표시될 수 있습니다.

   apiVersion: broker.amq.io/v1beta1
   kind: ActiveMQArtemis
   metadata:
     name: ex-aao
   spec:
     deploymentPlan:
       size: 1
       image: placeholder
       requireLogin: false
       persistenceEnabled: true
       journalType: nio
       messageMigration: true

   Copy to Clipboard Toggle word wrap

   broker_activemqartemis_cr.yaml 샘플 CR 파일에서 image 속성이 자리 표시자 의 기본값으로 설정되어 있는지 확인합니다. 이 값은 기본적으로 image 속성이 배포에 사용할 브로커 컨테이너 이미지를 지정하지 않음을 나타냅니다. Operator에서 사용할 적절한 브로커 컨테이너 이미지를 결정하는 방법을 알아보려면 2.6절. “Operator에서 컨테이너 이미지를 선택하는 방법” 를 참조하십시오.

   참고

   broker_activemqartemis_cr.yaml 샘플 CR은 ex-aao 의 이름 지정 규칙을 사용합니다. 이 이름 지정 규칙은 CR이 AMQ Broker Operator 의 예제 리소스임을 나타냅니다. AMQ Broker는 ActiveMQ Artemis 프로젝트를 기반으로 합니다. 이 샘플 CR을 배포하면 결과 StatefulSet에서 ex-aao-ss 이름을 사용합니다. 또한 배포의 브로커 Pod는 StatefulSet 이름 (예: ex-aao-ss-0,ex-aao-sss-1 등)을 기반으로 합니다. CR의 애플리케이션 이름은 배포에 StatefulSet의 레이블로 표시됩니다. 예를 들어 Pod 선택기에서 이 라벨을 사용할 수 있습니다.

2. size 속성은 배포할 브로커 수를 지정합니다. 값 2 이상은 클러스터형 브로커 배포를 지정합니다. 그러나 단일 브로커 인스턴스를 배포하려면 값이 1 로 설정되어 있는지 확인합니다.

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

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

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

      2. 브로커 배포를 생성하는 프로젝트로 전환합니다.

         $ oc project <project_name>

         Copy to Clipboard Toggle word wrap

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

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

         Copy to Clipboard Toggle word wrap

   2. OpenShift 웹 콘솔 사용:

      1. CR 구성을 마쳤으면 생성을 클릭합니다.

4. OpenShift Container Platform 웹 콘솔에서 Workloads → StatefulSets 를 클릭합니다. ex-aao-ss 라는 새로운 StatefulSet이 표시됩니다.

   1. ex-aao-ss StatefulSet을 클릭합니다. CR에 정의된 단일 브로커에 해당하는 하나의 Pod가 있음을 확인할 수 있습니다.
   2. StatefulSet에서 Pod 탭을 클릭합니다. ex-aao-ss Pod를 클릭합니다. 실행 중인 Pod의 이벤트 탭에서 브로커 컨테이너가 시작된 것을 확인할 수 있습니다. Logs (로그) 탭에 브로커 자체가 실행 중임을 보여줍니다.

5. 브로커가 정상적으로 실행되고 있는지 테스트하려면 브로커 Pod의 쉘에 액세스하여 일부 테스트 메시지를 보냅니다.

   1. OpenShift Container Platform 웹 콘솔 사용:

      1. 워크로드 → 포드 를 클릭합니다.
      2. ex-aao-ss Pod를 클릭합니다.
      3. 터미널 탭을 클릭합니다.

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

      1. 프로젝트의 Pod 이름 및 내부 IP 주소를 가져옵니다.

         $ oc get pods -o wide
         
         NAME                          STATUS   IP
         amq-broker-operator-54d996c   Running  10.129.2.14
         ex-aao-ss-0                   Running  10.129.2.15

         Copy to Clipboard Toggle word wrap

      2. 브로커 Pod 쉘에 액세스합니다.

         $ oc rsh ex-aao-ss-0

         Copy to Clipboard Toggle word wrap

6. 쉘에서 artemis 명령을 사용하여 일부 테스트 메시지를 보냅니다. URL에서 브로커 Pod의 내부 IP 주소를 지정합니다. 예를 들면 다음과 같습니다.

   sh-4.2$ ./amq-broker/bin/artemis producer --url tcp://10.129.2.15:61616 --destination queue://demoQueue

   Copy to Clipboard Toggle word wrap

   위 명령은 브로커에서 demoQueue 라는 큐를 자동으로 생성하고 기본 1000개의 메시지 수량을 큐에 보냅니다.

   다음과 유사한 출력이 표시되어야 합니다.

   Connection brokerURL = tcp://10.129.2.15:61616
   Producer ActiveMQQueue[demoQueue], thread=0 Started to calculate elapsed time ...
   
   Producer ActiveMQQueue[demoQueue], thread=0 Produced: 1000 messages
   Producer ActiveMQQueue[demoQueue], thread=0 Elapsed time in second : 3 s
   Producer ActiveMQQueue[demoQueue], thread=0 Elapsed time in milli second : 3492 milli seconds

   Copy to Clipboard Toggle word wrap

절차

1. 기본 브로커 배포에 사용한 CR 파일을 엽니다.

2. 클러스터된 배포의 경우 deploymentPlan.size 값이 2 이상인지 확인합니다. 예를 들면 다음과 같습니다.

   apiVersion: broker.amq.io/v1beta1
   kind: ActiveMQArtemis
   metadata:
     name: ex-aao
   spec:
     deploymentPlan:
       size: 4
       image: placeholder
       ...

   Copy to Clipboard Toggle word wrap
   참고

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

3. 수정된 CR 파일을 저장합니다.

4. 이전에 기본 브로커 배포를 생성한 프로젝트에 CR을 배포할 수 있는 권한이 있는 사용자로 OpenShift에 로그인합니다.

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

   Copy to Clipboard Toggle word wrap

5. 이전에 기본 브로커 배포를 생성한 프로젝트로 전환합니다.

   $ oc project <project_name>

   Copy to Clipboard Toggle word wrap

6. 명령줄에서 변경 사항을 적용합니다.

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

   Copy to Clipboard Toggle word wrap

   OpenShift Container Platform 웹 콘솔에서 CR에 지정된 수에 따라 추가 브로커 Pod가 프로젝트에서 시작됩니다. 기본적으로 프로젝트에서 실행되는 브로커는 클러스터됩니다.

7. 각 Pod의 로그 탭을 엽니다. 로그에 OpenShift가 각 브로커에 클러스터 연결 브리지를 설정했음을 보여줍니다. 특히 로그 출력에는 다음과 같은 행이 포함됩니다.

   targetConnector=ServerLocatorImpl (identity=(Cluster-connection-bridge::ClusterConnectionBridge@6f13fb88

   Copy to Clipboard Toggle word wrap

1. Operator는 브로커 애플리케이션 컨테이너보다 먼저 Init Container를 실행합니다. Init Container는 기본 주소 설정 구성을 생성합니다. 기본 주소 설정 구성은 다음과 같습니다.

   <address-settings>
       <!--
       if you define auto-create on certain queues, management has to be auto-create
       -->
       <address-setting match="activemq.management#">
           <dead-letter-address>DLQ</dead-letter-address>
           <expiry-address>ExpiryQueue</expiry-address>
           <redelivery-delay>0</redelivery-delay>
           <!--
           with -1 only the global-max-size is in use for limiting
           -->
           <max-size-bytes>-1</max-size-bytes>
           <message-counter-history-day-limit>10</message-counter-history-day-limit>
           <address-full-policy>PAGE</address-full-policy>
           <auto-create-queues>true</auto-create-queues>
           <auto-create-addresses>true</auto-create-addresses>
           <auto-create-jms-queues>true</auto-create-jms-queues>
           <auto-create-jms-topics>true</auto-create-jms-topics>
       </address-setting>
   
       <!-- default for catch all -->
       <address-setting match="#">
           <dead-letter-address>DLQ</dead-letter-address>
           <expiry-address>ExpiryQueue</expiry-address>
           <redelivery-delay>0</redelivery-delay>
           <!--
           with -1 only the global-max-size is in use for limiting
           -->
           <max-size-bytes>-1</max-size-bytes>
           <message-counter-history-day-limit>10</message-counter-history-day-limit>
           <address-full-policy>PAGE</address-full-policy>
           <auto-create-queues>true</auto-create-queues>
           <auto-create-addresses>true</auto-create-addresses>
           <auto-create-jms-queues>true</auto-create-jms-queues>
           <auto-create-jms-topics>true</auto-create-jms-topics>
       </address-setting>
   <address-settings>

   Copy to Clipboard Toggle word wrap
2. 사용자 정의 리소스(CR) 인스턴스에서 주소 설정 구성을 지정한 경우 Init Container는 해당 구성을 처리하고 XML로 변환합니다.
3. CR의 applyRule 속성 값에 따라 Init Container는 위에 표시된 기본 주소 설정 구성을 CR에 지정한 구성으로 병합 하거나 대체합니다. 이 병합 또는 교체의 결과는 브로커가 사용할 최종 주소 설정 구성입니다.
4. Init Container가 브로커 구성 생성(address 설정 포함)을 완료하면 브로커 애플리케이션 컨테이너가 시작됩니다. 브로커를 시작하면 브로커 컨테이너는 이전에 Init Container에서 사용한 설치 디렉터리에서 해당 구성을 복사합니다. broker.xml 구성 파일에서 주소 설정 구성을 검사할 수 있습니다. 실행 중인 브로커의 경우 이 파일은 /home/jboss/amq-broker/etc 디렉터리에 있습니다.

절차

1. 사용자 정의 리소스(CR) 인스턴스 구성을 시작하여 브로커 배포의 주소 및 대기열을 정의합니다.

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

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

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

         Copy to Clipboard Toggle word wrap
      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
       ...

   Copy to Clipboard Toggle word wrap

   앞의 구성은 myQueue0 이라는 큐와 anycast 라우팅 유형을 사용하여 myAddress0 이라는 주소를 정의합니다.

   참고

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

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

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

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

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

         $ oc project <project_name>

         Copy to Clipboard Toggle word wrap

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

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

         Copy to Clipboard Toggle word wrap

   2. OpenShift 웹 콘솔 사용:

      1. CR 구성을 마쳤으면 생성을 클릭합니다.

절차

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

절차

1. 배포의 각 브로커에 대해 전달되지 않은 메시지를 수신하도록 배달 못 한 주소 및 큐를 추가하도록 주소 CR 인스턴스 구성을 시작합니다.

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

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

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

         Copy to Clipboard Toggle word wrap
      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 섹션에서 dead letter address 및 큐를 지정하여 전달되지 않은 메시지를 수신할 행을 추가합니다. 예를 들면 다음과 같습니다.

   apiVersion: broker.amq.io/v1beta1
   kind: ActiveMQArtemisAddress
   metadata:
     name: ex-aaoaddress
   spec:
     ...
     addressName: myDeadLetterAddress
     queueName: myDeadLetterQueue
     routingType: anycast
     ...

   Copy to Clipboard Toggle word wrap

   앞의 구성은 myDeadLetterQueue 라는 dead letter 큐와 anycast 라우팅 유형을 사용하여 myDeadLetterAddress 라는 dead letter 주소를 정의합니다.

   참고

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

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

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

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

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

         $ oc project <project_name>

         Copy to Clipboard Toggle word wrap

      3. 주소 CR을 생성합니다.

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

         Copy to Clipboard Toggle word wrap

   2. OpenShift 웹 콘솔 사용:

      1. CR 구성을 마쳤으면 생성을 클릭합니다.

4. 브로커 배포의 주요 브로커 CR 인스턴스를 편집합니다.

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

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

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

         Copy to Clipboard Toggle word wrap

      2. CR을 편집합니다.

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

         Copy to Clipboard Toggle word wrap

   2. OpenShift Container Platform 웹 콘솔 사용:

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

      6. YAML 탭을 클릭합니다.

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

         참고

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

5. CR의 spec 섹션에서 다음과 같이 단일 addressSetting 섹션이 포함된 새 address >-< 섹션을 추가합니다.

   spec:
     deploymentPlan:
       size: 1
       image: placeholder
       requireLogin: false
       persistenceEnabled: true
       journalType: nio
       messageMigration: true
     addressSettings:
       addressSetting:

   Copy to Clipboard Toggle word wrap

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

   spec:
     deploymentPlan:
       size: 1
       image: placeholder
       requireLogin: false
       persistenceEnabled: true
       journalType: nio
       messageMigration: true
     addressSettings:
       addressSetting:
       - match: myAddress

   Copy to Clipboard Toggle word wrap

   match

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

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

   spec:
     deploymentPlan:
       size: 1
       image: placeholder
       requireLogin: false
       persistenceEnabled: true
       journalType: nio
       messageMigration: true
     addressSettings:
       addressSetting:
       - match: myAddress
         deadLetterAddress: myDeadLetterAddress
         maxDeliveryAttempts: 5

   Copy to Clipboard Toggle word wrap

   deadLetterAddress

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

   maxDeliveryAttempts

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

   위 예에서 브로커가 5번의 실패한 시도를 하는 경우 myAddress 로 시작하는 주소로 메시지를 전달하려고 하면 브로커는 메시지를 지정된 dead letter 주소 myDeadLetterAddress 로 이동합니다.

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

   spec:
     deploymentPlan:
       size: 1
       image: placeholder
       requireLogin: false
       persistenceEnabled: true
       journalType: nio
       messageMigration: true
     addressSettings:
       addressSetting:
       - match: myAddress
         deadLetterAddress: myDeadLetterAddress
         maxDeliveryAttempts: 5
       - match: 'myOtherAddresses#'
         deadLetterAddress: myDeadLetterAddress
         maxDeliveryAttempts: 3

   Copy to Clipboard Toggle word wrap

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

   참고

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

9. address>-&lt; 섹션의 시작 부분에 applyRule 속성을 추가하고 값을 지정합니다. 예를 들면 다음과 같습니다.

   spec:
     deploymentPlan:
       size: 1
       image: placeholder
       requireLogin: false
       persistenceEnabled: true
       journalType: nio
       messageMigration: true
     addressSettings:
       applyRule: merge_all
       addressSetting:
       - match: myAddress
         deadLetterAddress: myDeadLetterAddress
         maxDeliveryAttempts: 5
       - match: 'myOtherAddresses#'
         deadLetterAddress: myDeadLetterAddress
         maxDeliveryAttempts: 3

   Copy to Clipboard Toggle word wrap

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

   merge_all

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

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

   merge_replace

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

   replace_all

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

   참고

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

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

절차

1. 새 10.0.0.1 로그인 모듈 구성으로 텍스트 파일을 생성하고 파일을 login.config 로 저장합니다. 파일을 login.config 로 저장하면 텍스트 파일에서 생성한 시크릿에 올바른 키가 삽입됩니다. 다음은 로그인 모듈 구성의 예입니다.

   activemq {
      org.apache.activemq.artemis.spi.core.security.jaas.PropertiesLoginModule sufficient
         reload=true
         org.apache.activemq.jaas.properties.user="new-users.properties"
         org.apache.activemq.jaas.properties.role="new-roles.properties";
   
      org.apache.activemq.artemis.spi.core.security.jaas.PropertiesLoginModule sufficient
         reload=false
         org.apache.activemq.jaas.properties.user="artemis-users.properties"
         org.apache.activemq.jaas.properties.role="artemis-roles.properties"
         baseDir="/home/jboss/amq-broker/etc";
   };

   Copy to Clipboard Toggle word wrap

   시크릿에서 CloudEvent 로그인 모듈을 구성하고 CR의 보안에 대한 참조를 추가한 후 기본 로그인 모듈이 더 이상 AMQ Broker에서 사용되지 않습니다. 그러나 기본 로그인 모듈에서 참조되는 artemis-users.properties 파일의 사용자는 Operator에서 브로커를 인증하는 데 필요합니다. 새 CloudEvent 로그인 모듈을 구성한 후 Operator가 브로커로 인증할 수 있도록 하려면 다음 중 하나를 수행해야 합니다.

   • 위 예제와 같이 새 로그인 모듈 구성에 기본 properties login 모듈을 포함합니다. 이 예제에서 기본 속성 로그인 모듈은 artemis-users.properties 및 artemis-roles.properties 파일을 사용합니다. 새 로그인 모듈 구성에 기본 로그인 모듈을 포함하는 경우 baseDir 을 각 브로커 Pod의 기본 속성 파일이 포함된 /home/jboss/amq-broker/etc 디렉터리로 설정해야 합니다.

   • Operator에서 브로커로 인증하는 데 필요한 사용자 및 역할 정보를 새 로그인 모듈 구성에서 참조하는 속성 파일에 추가합니다. 브로커 Pod의 /home/jboss/amq-broker/etc 디렉터리에 있는 기본 artemis-users.properties 및 artemis- roles.properties 파일에서 이 정보를 복사할 수 있습니다.

     참고

     로그인 모듈에서 참조된 속성 파일은 브로커가 로그인 모듈을 처음 호출할 때만 로드됩니다. 브로커는 사용자를 인증할 로그인 모듈을 찾을 때까지 login.config 파일에 나열된 순서대로 로그인 모듈을 호출합니다. login.config 파일 끝에 Operator에서 사용하는 인증 정보가 포함된 login 모듈을 배치하면 브로커가 Operator를 인증할 때 이전의 모든 로그인 모듈이 호출됩니다. 결과적으로 속성 파일이 브로커에 표시되지 않음을 나타내는 상태 메시지가 지워집니다.

2. 생성한 login.config 파일에 properties 로그인 모듈이 포함된 경우 모듈에 지정된 사용자 및 역할 파일에 사용자 및 역할 정보가 포함되어 있는지 확인합니다. 예를 들면 다음과 같습니다.

   new-users.properties

   ruben=ruben01!
   anne=anne01!
   rick=rick01!
   bob=bob01!

   Copy to Clipboard Toggle word wrap

   new-roles.properties

   admin=ruben, rick
   group1=bob
   group2=anne

   Copy to Clipboard Toggle word wrap

3. oc create secret 명령을 사용하여 새 로그인 모듈 구성으로 생성한 텍스트 파일에서 시크릿을 생성합니다. 로그인 모듈 구성에 properties 로그인 모듈이 포함된 경우 연결된 사용자 및 역할 파일도 시크릿에 포함합니다. 예를 들면 다음과 같습니다.

   oc create secret generic custom-jaas-config --from-file=login.config --from-file=new-users.properties --from-file=new-roles.properties

   Copy to Clipboard Toggle word wrap
   참고

   Operator가 로그인 모듈 구성이 포함되어 있음을 인식하고 각 브로커 Pod에 업데이트를 전파할 수 있도록 시크릿 이름에 -jaas-config 접미사가 있어야 합니다.

   보안을 생성하는 방법에 대한 자세한 내용은 Kubernetes 문서 의 보안을 참조하십시오.

4. 브로커 배포를 위해 생성한 시크릿을 CR(사용자 정의 리소스) 인스턴스에 추가합니다.

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

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

      2. 배포의 CR을 편집합니다.

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

         Copy to Clipboard Toggle word wrap

   2. OpenShift Container Platform 웹 콘솔 사용:

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

      6. YAML 탭을 클릭합니다.

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

5. extraMounts 요소와 secrets 요소를 생성하고 시크릿 이름을 추가합니다. 다음 예제에서는 CR에 custom-jaas-config 라는 보안을 추가합니다.

   deploymentPlan:
     ...
     extraMounts:
       secrets:
       - "custom-jaas-config"
     ...

   Copy to Clipboard Toggle word wrap

6. CR에서 브로커에 구성된 역할에 권한을 부여합니다.

   1. CR의 spec 섹션에서 brokerProperties 요소를 추가하고 권한을 추가합니다. 단일 주소에 역할 권한을 부여할 수 있습니다. 또는 # 기호를 사용하여 모든 주소에 역할 권한을 부여하여 와일드카드 일치를 지정할 수 있습니다. 예를 들면 다음과 같습니다.

      spec:
        ...
        brokerProperties:
        - securityRoles.#.group2.send=true
        - securityRoles.#.group1.consume=true
        - securityRoles.#.group1.createAddress=true
        - securityRoles.#.group1.createNonDurableQueue=true
        - securityRoles.#.group1.browse=true
        ...

      Copy to Clipboard Toggle word wrap

      이 예에서 group2 역할에는 모든 주소에 대한 전송 권한이 할당되고 group1 역할에는 consume,createAddress,createNonDurableQueue 및 모든 주소에 대한 권한을 검색합니다.

7. CR을 저장합니다.

   Operator는 각 Pod의 /amq/extra/secrets/시크릿 이름 디렉터리에 있는 시크릿에 login.config 파일을 마운트하고 기본 login.config 파일 대신 마운트된 login.config 파일을 읽도록 브로커 JVM을 구성합니다. login.config 파일에 properties 로그인 모듈이 포함된 경우 참조된 사용자 및 역할 속성 파일도 각 포드에 마운트됩니다.

8. CR의 상태 정보를 보고 배포의 브로커가 인증을 위해 시크릿의 10.0.0.1 로그인 모듈을 사용하고 있는지 확인합니다.

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

      1. 브로커의 CR에서 상태 조건을 가져옵니다.

         $ oc get activemqartemis -o yaml

         Copy to Clipboard Toggle word wrap

   2. OpenShift 웹 콘솔 사용:

      1. CR에서 status 섹션으로 이동합니다.

   3. 상태 정보에서 브로커가 시크릿에 구성된 10.0.0.1 로그인 모듈을 사용하고 있음을 나타내는 JaasPropertiesApplied 유형이 있는지 확인합니다. 예를 들면 다음과 같습니다.

      - lastTransitionTime: "2023-02-06T20:50:01Z"
        message: ""
        reason: Applied
        status: "True"
        type: JaasPropertiesApplied

      Copy to Clipboard Toggle word wrap

      시크릿의 파일을 업데이트할 때 reason 필드의 값은 OpenShift Container Platform이 각 브로커 포드에 시크릿 의 최신 파일을 전달할 때까지Sync 가 노출됩니다. 예를 들어 새 사용자를 new-users-properties 파일에 추가하고 보안을 업데이트하면 업데이트된 파일이 각 Pod에 전파될 때까지 다음 상태 정보가 표시됩니다.

      - lastTransitionTime: "2023-02-06T20:55:20Z"
        message: 'new-users.properties status out of sync, expected: 287641156, current: 2177044732'
        reason: OutOfSync
        status: "False"
        type: JaasPropertiesApplied

      Copy to Clipboard Toggle word wrap

9. 시크릿에서 참조되는 속성 파일에서 사용자 또는 역할 정보를 업데이트할 때 oc set data 명령을 사용하여 시크릿을 업데이트합니다. login.config 파일을 포함하여 모든 파일을 시크릿에 다시 읽혀야 합니다. 예를 들어 이 절차의 앞부분에서 생성한 new-users.properties 파일에 새 사용자를 추가하는 경우 다음 명령을 사용하여 custom-jaas-config 시크릿을 업데이트합니다.

   oc set data secret/custom-jaas-config --from-file=login.config=login.config --from-file=new-users.properties=new-users.properties --from-file=new-roles.properties=new-roles.properties

   Copy to Clipboard Toggle word wrap

절차

1. 브로커 배포용 CR(사용자 정의 리소스) 인스턴스 구성을 시작합니다.

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

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

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

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

   2. OpenShift Container Platform 웹 콘솔 사용:

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

      5. Create ActiveMQArtemis 를 클릭합니다.

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

   기본 브로커 배포의 경우 구성은 다음과 같이 표시될 수 있습니다.

   apiVersion: broker.amq.io/v1beta1
   kind: ActiveMQArtemis
   metadata:
     name: ex-aao
   spec:
     deploymentPlan:
       size: 1
       image: placeholder
       requireLogin: false
       persistenceEnabled: true
       journalType: nio
       messageMigration: true

   Copy to Clipboard Toggle word wrap

   broker_activemqartemis_cr.yaml 샘플 CR 파일에서 image 속성이 자리 표시자 의 기본값으로 설정되어 있는지 확인합니다. 이 값은 기본적으로 image 속성이 배포에 사용할 브로커 컨테이너 이미지를 지정하지 않음을 나타냅니다. Operator에서 사용할 적절한 브로커 컨테이너 이미지를 결정하는 방법을 알아보려면 2.6절. “Operator에서 컨테이너 이미지를 선택하는 방법” 를 참조하십시오.

2. 브로커 스토리지 크기를 지정하려면 CR의 deploymentPlan 섹션에서 storage 섹션을 추가합니다. size 속성을 추가하고 값을 지정합니다. 예를 들면 다음과 같습니다.

   spec:
     deploymentPlan:
       size: 1
       image: placeholder
       requireLogin: false
       persistenceEnabled: true
       journalType: nio
       messageMigration: true
       storage:
         size: 4Gi

   Copy to Clipboard Toggle word wrap

   storage.size

   각 브로커 Pod에 영구 스토리지에 필요한 PVC(영구 볼륨 클레임)의 크기(바이트)입니다. 이 속성은 persistenceEnabled 가 true 로 설정된 경우에만 적용됩니다. 지정한 값은 바이트 표기법(예: K, M, G) 또는 바이너리 동등한 단위(Ki, Mi, Gi)를 사용하는 단위를 포함해야 합니다.

3. 각 브로커 Pod에서 영구 스토리지에 필요한 스토리지 클래스를 지정하려면 스토리지 섹션에서 storageClassName 속성을 추가하고 값을 지정합니다. 예를 들면 다음과 같습니다.

   spec:
     deploymentPlan:
       size: 1
       image: placeholder
       requireLogin: false
       persistenceEnabled: true
       journalType: nio
       messageMigration: true
       storage:
         size: 4Gi
         storageClassName: gp3

   Copy to Clipboard Toggle word wrap

   storage.storageClassName

   PVC(영구 볼륨 클레임)에서 요청할 스토리지 클래스의 이름입니다. 스토리지 클래스는 관리자가 사용 가능한 스토리지를 설명하고 분류하는 방법을 제공합니다. 예를 들어, 다른 스토리지 클래스는 특정 서비스 품질 수준, 백업 정책 등에 매핑될 수 있습니다.

   스토리지 클래스를 지정하지 않으면 클러스터에 대해 구성된 기본 스토리지 클래스가 있는 영구 볼륨이 PVC에서 요청합니다.

   참고

   스토리지 클래스를 지정하면 볼륨의 스토리지 클래스가 지정된 스토리지 클래스와 일치하는 경우에만 PVC에서 영구 볼륨을 클레임합니다.

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

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

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

      2. 브로커 배포를 생성하는 프로젝트로 전환합니다.

         $ oc project <project_name>

         Copy to Clipboard Toggle word wrap

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

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

         Copy to Clipboard Toggle word wrap

   2. OpenShift 웹 콘솔 사용:

      1. CR 구성을 마쳤으면 생성을 클릭합니다.

절차

1. 브로커 배포용 CR(사용자 정의 리소스) 인스턴스 구성을 시작합니다.

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

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

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

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

   2. OpenShift Container Platform 웹 콘솔 사용:

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

      5. Create ActiveMQArtemis 를 클릭합니다.

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

   기본 브로커 배포의 경우 구성은 다음과 같이 표시될 수 있습니다.

   apiVersion: broker.amq.io/v1beta1
   kind: ActiveMQArtemis
   metadata:
     name: ex-aao
   spec:
     deploymentPlan:
       size: 1
       image: placeholder
       requireLogin: false
       persistenceEnabled: true
       journalType: nio
       messageMigration: true

   Copy to Clipboard Toggle word wrap

   broker_activemqartemis_cr.yaml 샘플 CR 파일에서 image 속성이 자리 표시자 의 기본값으로 설정되어 있는지 확인합니다. 이 값은 기본적으로 image 속성이 배포에 사용할 브로커 컨테이너 이미지를 지정하지 않음을 나타냅니다. Operator에서 사용할 적절한 브로커 컨테이너 이미지를 결정하는 방법을 알아보려면 2.6절. “Operator에서 컨테이너 이미지를 선택하는 방법” 를 참조하십시오.

2. CR의 deploymentPlan 섹션에서 resources 섹션을 추가합니다. 제한 및 요청 섹션을 추가합니다. 각 하위 섹션에서 cpu 및 memory 속성을 추가하고 값을 지정합니다. 예를 들면 다음과 같습니다.

   spec:
     deploymentPlan:
       size: 1
       image: placeholder
       requireLogin: false
       persistenceEnabled: true
       journalType: nio
       messageMigration: true
       resources:
         limits:
           cpu: "500m"
           memory: "1024M"
         requests:
           cpu: "250m"
           memory: "512M"

   Copy to Clipboard Toggle word wrap

   limits.cpu

   배포의 Pod에서 실행 중인 각 브로커 컨테이너는 이 양의 host-node CPU 사용량을 초과할 수 없습니다.

   limits.memory

   배포의 Pod에서 실행 중인 각 브로커 컨테이너는 이 양의 host-node 메모리 사용량을 초과할 수 없습니다.

   requests.cpu

   배포의 Pod에서 실행 중인 각 브로커는 이 양의 host-node CPU를 요청합니다. 이 값은 브로커 컨테이너를 실행하는 데 필요한 최소 CPU 양입니다.

   requests.memory

   배포의 Pod에서 실행 중인 각 브로커에서는 이 양의 host-node 메모리를 요청합니다. 이 값은 브로커 컨테이너를 실행하는 데 필요한 최소 메모리 양입니다.

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

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

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

      2. 브로커 배포를 생성하는 프로젝트로 전환합니다.

         $ oc project <project_name>

         Copy to Clipboard Toggle word wrap

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

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

         Copy to Clipboard Toggle word wrap

   2. OpenShift 웹 콘솔 사용:

      1. CR 구성을 마쳤으면 생성을 클릭합니다.

절차

1. 초기 설치 중에 다운로드하여 추출한 Operator 아카이브의 deploy/crs 디렉터리에서 broker_activemqartemis_cr.yaml CR(사용자 정의 리소스) 파일을 엽니다.

2. acceptors 요소에서 named acceptor를 추가합니다. protocols 및 port 매개 변수를 추가합니다. acceptor 및 각 브로커 Pod의 포트를 해당 프로토콜에 노출할 메시징 프로토콜을 지정하려면 값을 설정합니다. 예를 들면 다음과 같습니다.

   spec:
   ...
     acceptors:
     - name: my-acceptor
       protocols: amqp
       port: 5672
   ...

   Copy to Clipboard Toggle word wrap

   구성된 acceptor는 포트 5672를 AMQP 클라이언트에 노출합니다. protocols 매개변수에 지정할 수 있는 전체 값 세트는 표에 표시됩니다.

   Expand

   프로토콜	현재의
   코어 프로토콜	코어
   AMQP	amqp
   OpenWire	Open>-<re
   MQTT	mqtt
   STOMP	stomp
   지원되는 모든 프로토콜	all

   Show more
   참고
   • 배포의 각 브로커 Pod에 대해 Operator는 포트 61616을 사용하는 기본 어셉터도 생성합니다. 이 기본 어셉터는 브로커 클러스터링에 필요하며 코어 프로토콜이 활성화되어 있습니다.
   • 기본적으로 AMQ Broker 관리 콘솔은 브로커 Pod에서 포트 8161을 사용합니다. 배포의 각 브로커 Pod에는 콘솔에 대한 액세스를 제공하는 전용 서비스가 있습니다. 자세한 내용은 5장. Operator 기반 브로커 배포를 위해 AMQ 관리 콘솔에 연결의 내용을 참조하십시오.

3. 동일한 어셉터에서 다른 프로토콜을 사용하려면 protocols 매개변수를 수정합니다. 쉼표로 구분된 프로토콜 목록을 지정합니다. 예를 들면 다음과 같습니다.

   spec:
   ...
     acceptors:
     - name: my-acceptor
       protocols: amqp,openwire
       port: 5672
   ...

   Copy to Clipboard Toggle word wrap

   이제 구성된 acceptor가 AMQP 및 OpenForwardedre 클라이언트에 포트 5672를 노출합니다.

4. 수락자가 허용하는 동시 클라이언트 연결 수를 지정하려면 connectionsAllowed 매개변수를 추가하고 값을 설정합니다. 예를 들면 다음과 같습니다.

   spec:
   ...
     acceptors:
     - name: my-acceptor
       protocols: amqp,openwire
       port: 5672
       connectionsAllowed: 5
   ...

   Copy to Clipboard Toggle word wrap

5. 기본적으로 어셉터는 브로커 배포와 동일한 OpenShift 클러스터의 클라이언트에만 노출됩니다. OpenShift 외부의 클라이언트에 acceptor도 노출하려면 expose 매개변수를 추가하고 값을 true 로 설정합니다.

   spec:
   ...
     acceptors:
     - name: my-acceptor
       protocols: amqp,openwire
       port: 5672
       connectionsAllowed: 5
       expose: true
       ...
   ...

   Copy to Clipboard Toggle word wrap

   OpenShift 외부의 클라이언트에 어셉터를 노출하면 Operator는 배포의 각 브로커 포드에 대해 전용 서비스 및 경로를 자동으로 생성합니다.

6. OpenShift 외부의 클라이언트에서 어셉터에 대한 보안 연결을 활성화하려면 sslEnabled 매개변수를 추가하고 값을 true 로 설정합니다.

   spec:
   ...
     acceptors:
     - name: my-acceptor
       protocols: amqp,openwire
       port: 5672
       connectionsAllowed: 5
       expose: true
       sslEnabled: true
       ...
   ...

   Copy to Clipboard Toggle word wrap

   수락자(또는 커넥터)에서 SSL(즉, Secure Sockets Layer) 보안을 활성화하면 다음과 같은 관련 구성을 추가할 수 있습니다.

   • OpenShift 클러스터에 인증 자격 증명을 저장하는 데 사용되는 시크릿 이름입니다. 수락자에서 SSL을 활성화하면 시크릿이 필요합니다. 이 시크릿 생성에 대한 자세한 내용은 4.10.2절. “broker-client 연결 보안” 을 참조하십시오.
   • 보안 네트워크 통신에 사용할 TLS(Transport Layer Security) 프로토콜입니다. TLS는 보다 안전한 SSL 버전입니다. enabledProtocols 매개변수에 TLS 프로토콜을 지정합니다.
   • 어셉터가 2방향 TLS를 사용하는지 여부 (중간 인증 이라고도 함) 브로커와 클라이언트 사이입니다. needClientAuth 매개변수의 값을 true 로 설정하여 지정합니다.