9장. OpenShift Container Platform에 Jboss EAP 애플리케이션 배포

프로세스

1. OpenShift Container Platform 웹 콘솔에서 Operator→ OperatorHub 로 이동합니다.
2. 아래로 스크롤하거나 키워드로 필터링 상자에 EAP 를 입력하여 EAP Operator를 찾습니다.
3. JBoss EAP Operator를 선택하고 설치를 클릭합니다.

4. Create Operator Subscription 페이지에서 다음을 수행합니다.

   1. 다음 명령 중 하나를 선택합니다.

      • 클러스터의 모든 네임스페이스(기본값) 는 기본 openshift-operators 네임스페이스에 Operator를 설치하여 클러스터의 모든 네임스페이스를 감시하고 사용할 수 있게 합니다. 이 옵션을 항상 사용할 수있는 것은 아닙니다.
      • 클러스터의 특정 네임스페이스 는 선택한 특정 단일 네임스페이스에 Operator를 설치합니다. Operator는 이 단일 네임스페이스에서만 사용할 수 있습니다.
   2. Update Channel을 선택합니다.
   3. 앞에서 설명한 대로 자동 또는 수동 승인 전략을 선택합니다.

5. 서브스크립션을 클릭하여 이 OpenShift Container Platform 클러스터에서 선택한 네임스페이스에서 EAP Operator를 사용할 수 있도록 합니다.

   1. 수동 승인 전략을 선택한 경우 설치 계획을 검토하고 승인할 때까지 서브스크립션의 업그레이드 상태가 Upgrading 으로 유지됩니다. 설치 계획 페이지에서 설치 계획을 승인한 후 서브스크립션 업그레이드 상태가 Up to date 로 이동합니다.
   2. 자동 승인 전략을 선택한 경우 업그레이드 상태가 개입 없이 최신 상태로 이동합니다.

6. 서브스크립션의 업그레이드 상태가 최신 버전이면 Operator 설치된 Operator를 선택하여 CSV(EAP ClusterServiceVersion)가 표시되고 해당 상태가 관련 네임스페이스에 InstallSucceeded 로 변경되었는지 확인합니다.

   참고

   All namespaces…​ 설치 모드의 경우 openshift-operators 네임스페이스에 표시되는 상태가 InstallSucceeded 입니다. 다른 네임스페이스에서 상태가 Copied 입니다. . . Status 필드가 InstallSucceeded 로 변경되지 않는 경우 문제를 보고하는 워크로드 Pod 페이지에서 openshift-operators 프로젝트(또는 특정 네임스페이스…​ 설치 모드가 선택된 경우 기타 관련 네임스페이스)의 모든 Pod 의 로그를 확인합니다.

프로세스

1. OperatorHub에서 클러스터에서 사용할 수 있는 Operator 목록을 확인합니다.

   $ oc get packagemanifests -n openshift-marketplace | grep eap
   NAME        CATALOG               AGE
   ...
   eap         Red Hat Operators     43d
   ...

   Copy to Clipboard Toggle word wrap

2. 서브스크립션 오브젝트 YAML 파일(예: Cryostat -operator-sub.yaml)을 생성하여 네임스페이스를 EAP Operator에 서브스크립션합니다. 다음은 Subscription 오브젝트 YAML 파일의 예입니다.

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: eap
     namespace: openshift-operators
   spec:
     channel: stable
     installPlanApproval: Automatic
     name: eap 

   1

   
     source:  redhat-operators 

   2

   
     sourceNamespace: openshift-marketplace

   Copy to Clipboard Toggle word wrap

   1

   등록할 Operator의 이름입니다.

   2

   EAP Operator는 redhat-operators CatalogSource에서 제공합니다.

   채널 및 승인 전략에 대한 자세한 내용은 이 절차의 웹 콘솔 버전을 참조하십시오.

3. YAML 파일에서 Subscription 오브젝트를 생성합니다.

   $ oc apply -f eap-operator-sub.yaml
   $ oc get csv -n openshift-operators
   NAME                  DISPLAY     VERSION   REPLACES   PHASE
   eap-operator.v1.0.0   JBoss EAP   1.0.0                Succeeded

   Copy to Clipboard Toggle word wrap

   EAP Operator가 성공적으로 설치되었습니다. 이 시점에서 OLM은 EAP Operator를 알고 있습니다. Operator의 ClusterServiceVersion (CSV)이 대상 네임스페이스에 표시되고 EAP Operator에서 제공하는 API를 생성할 수 있습니다.

프로세스

1. 웹 브라우저를 열고 OperatorHub에 로그인합니다.
2. Java 애플리케이션에 사용할 프로젝트 또는 네임스페이스를 선택합니다.
3. Installed Operator 로 이동하여 JBoss EAP operator 를 선택합니다.
4. 개요 탭에서 인스턴스 생성 링크를 클릭합니다.

5. 애플리케이션 이미지 세부 정보를 지정합니다.

   애플리케이션 이미지는 Java 애플리케이션이 포함된 Docker 이미지를 지정합니다. 이미지는 JBoss EAP for OpenShift S2I(Source-to-Image) 빌드 이미지를 사용하여 빌드해야 합니다. applicationImage 필드가 imagestreamtag에 해당하는 경우 이미지에 대한 모든 변경으로 애플리케이션의 자동 업그레이드가 트리거됩니다.

   다음 참조 중 하나로 OpenShift 애플리케이션 이미지에 대한 JBoss EAP를 제공할 수 있습니다.

   • 이미지 이름: mycomp/myapp
   • 태그: mycomp/myapp:1.0
   • A digest: mycomp/myapp:@sha256:0af38bc38be93116b6a1d86a9c78bd14cd527121970899d719baf78e5dc7bfd2
   • imagestreamtag: my-app:latest

6. 애플리케이션 크기를 지정합니다. 예를 들면 다음과 같습니다.

   spec:
     replicas:2

   Copy to Clipboard Toggle word wrap

7. env 사양 을 사용하여 애플리케이션 환경을 구성합니다. 환경 변수는 POSTGRESQL_SERVICE_HOST 또는 POSTGRESQL_USER와 같은 Secret 오브젝트에서 직접 가져올 수 있습니다. 예를 들면 다음과 같습니다.

   spec:
     env:
     - name: POSTGRESQL_SERVICE_HOST
       value: postgresql
     - name: POSTGRESQL_SERVICE_PORT
       value: '5432'
     - name: POSTGRESQL_DATABASE
       valueFrom:
         secretKeyRef:
           key: database-name
           name: postgresql
     - name: POSTGRESQL_USER
       valueFrom:
         secretKeyRef:
           key: database-user
           name: postgresql
     - name: POSTGRESQL_PASSWORD
       valueFrom:
         secretKeyRef:
           key: database-password
           name: postgresql

   Copy to Clipboard Toggle word wrap

8. 애플리케이션 배포와 관련된 다음 선택적 구성을 완료합니다.

   • 서버 데이터 디렉터리에 대한 스토리지 요구 사항을 지정합니다. 자세한 내용은 애플리케이션용 영구 스토리지 구성을 참조하십시오.

   • WildFlyServerSpec 에서 생성한 시크릿 이름을 지정하여 애플리케이션을 실행하는 Pod의 볼륨으로 마운트합니다. 예를 들면 다음과 같습니다.

     spec:
       secrets:
         - my-secret

     Copy to Clipboard Toggle word wrap

     Secret 은 /etc/secrets/<secret name >에 마운트되며 각 키/값은 파일로 저장됩니다. 파일 이름은 키이고 콘텐츠는 값입니다. 시크릿 은 Pod 내부에 볼륨으로 마운트됩니다. 다음 예제에서는 키 값을 찾는 데 사용할 수 있는 명령을 보여줍니다.

     $ ls /etc/secrets/my-secret/
     my-key  my-password
     $ cat /etc/secrets/my-secret/my-key
     devuser
     $ cat /etc/secrets/my-secret/my-password
     my-very-secure-pasword

     Copy to Clipboard Toggle word wrap
     참고

     Secret 오브젝트를 수정하면 프로젝트 불일치가 발생할 수 있습니다. 기존 Secret 오브젝트를 수정하는 대신 Red Hat은 이전 오브젝트와 동일한 콘텐츠를 사용하여 새 오브젝트를 생성하는 것이 좋습니다. 그런 다음 필요에 따라 콘텐츠를 업데이트하고 operator CR(사용자 정의 리소스)의 참조를 old에서 new로 변경할 수 있습니다. 이는 새 CR 업데이트로 간주되며 Pod가 다시 로드됩니다.

   • WildFlyServerSpec 에서 생성한 ConfigMap 의 이름을 지정하여 애플리케이션을 실행하는 Pod의 볼륨으로 마운트합니다. 예를 들면 다음과 같습니다.

     spec:
       configMaps:
       - my-config

     Copy to Clipboard Toggle word wrap

     ConfigMap 은 /etc/configmaps/<configmap name >에 마운트되며 각 키/값은 파일로 저장됩니다. 파일 이름은 키이고 콘텐츠는 값입니다. ConfigMap 은 Pod 내부에 볼륨으로 마운트됩니다. 키 값을 찾으려면 다음을 수행합니다.

     $ ls /etc/configmaps/my-config/
     key1 key2
     $ cat /etc/configmaps/my-config/key1
     value1
     $ cat /etc/configmaps/my-config/key2
     value2

     Copy to Clipboard Toggle word wrap
     참고

     ConfigMap 을 수정하면 프로젝트 불일치가 발생할 수 있습니다. 기존 ConfigMap 을 수정하는 대신 Red Hat은 이전 ConfigMap 과 동일한 콘텐츠를 사용하여 새 ConfigMap을 생성하는 것이 좋습니다. 그런 다음 필요에 따라 콘텐츠를 업데이트하고 operator CR(사용자 정의 리소스)의 참조를 old에서 new로 변경할 수 있습니다. 이는 새 CR 업데이트로 간주되며 Pod가 다시 로드됩니다.

   • 고유한 독립 실행형 ConfigMap 을 사용하도록 선택하는 경우 ConfigMap 의 이름과 standalone.xml 파일의 키를 제공합니다.

       standaloneConfigMap:
         name: clusterbench-config-map
         key: standalone.xml

     Copy to Clipboard Toggle word wrap
     참고

     JBoss EAP 8.0에서는 standalone.xml 파일에서 ConfigMap 을 생성할 수 없습니다.

   • OpenShift에서 기본 HTTP 경로 생성을 비활성화하려면 disableHTTPRoute 를 true 로 설정합니다.

     spec:
       disableHTTPRoute: true

     Copy to Clipboard Toggle word wrap

프로세스

1. OpenShift Container Platform 웹 콘솔에서 모니터링→ 메트릭 으로 이동합니다.
2. 메트릭 화면에서 텍스트 상자에 애플리케이션 이름을 입력하여 애플리케이션을 선택합니다. 애플리케이션의 메트릭이 화면에 표시됩니다.

프로세스

1. Operator→ 설치된 Operator 페이지에서 JBoss EAP 를 선택합니다.
2. Operator 상세 정보 페이지 오른쪽에 있는 작업 드롭다운 메뉴에서 Operator 제거를 선택합니다.
3. Operator 서브스크립션 제거 창에서 프롬프트가 표시되면 설치와 관련된 모든 구성 요소를 제거하려는 경우 선택적으로 선택한 네임스페이스 Operator 완전히 제거 확인란을 선택합니다. 이렇게 하면 CSV가 제거되어 Operator와 연결된 Pod, 배포, CRD(사용자 정의 리소스 정의) 및 CR(사용자 정의 리소스)이 제거됩니다.
4. 제거를 클릭합니다. EAP Operator는 실행을 중지하고 더 이상 업데이트를 수신하지 않습니다.

프로세스

1. currentCSV 필드에서 EAP Operator 서브스크립션의 현재 버전을 확인합니다.

   $ oc get subscription eap-operator -n openshift-operators -o yaml | grep currentCSV
     currentCSV: eap-operator.v1.0.0

   Copy to Clipboard Toggle word wrap

2. EAP Operator의 서브스크립션을 삭제합니다.

   $ oc delete subscription eap-operator -n openshift-operators
   subscription.operators.coreos.com "eap-operator" deleted

   Copy to Clipboard Toggle word wrap

3. 이전 단계의 currentCSV 값을 사용하여 대상 네임스페이스에서 EAP Operator의 CSV를 삭제합니다.

   $ oc delete clusterserviceversion eap-operator.v1.0.0 -n openshift-operators
   clusterserviceversion.operators.coreos.com "eap-operator.v1.0.0" deleted

   Copy to Clipboard Toggle word wrap

프로세스

1. 리소스를 구성합니다.

   apiVersion: wildfly.org/v1alpha1
   kind: WildFlyServer
   metadata:
     name: eap-helloworld
   spec:
     applicationImage: 'eap-helloworld:latest'
     replicas: 1
     resources:
       limits:
         cpu: 500m
         memory: 2Gi
       requests:
         cpu: 100m
         memory: 1Gi

   Copy to Clipboard Toggle word wrap
   중요

   자동 스케일링이 예상대로 작동하려면 Pod에서 컨테이너의 리소스 제한 및 요청을 지정해야 합니다.

2. Horizontal Pod 자동 스케일러를 생성합니다.

   oc autoscale wildflyserver/eap-helloworld --cpu-percent=50 --min=1 --max=10

   Copy to Clipboard Toggle word wrap