OpenShift에서 Data Grid 실행

프로세스

1. OpenShift 웹 콘솔에 로그인합니다.
2. OperatorHub 로 이동합니다.
3. Data Grid Operator를 찾아 선택합니다.
4. 설치를 선택하고 Operator 서브스크립션 생성 을 계속합니다.

5. 서브스크립션 옵션을 지정합니다.

   설치 모드

   Data Grid Operator를 특정 네임스페이스 또는 모든 네임스페이스에 설치할 수 있습니다.

   업데이트 채널

   Data Grid Operator 8.1.x에 대한 업데이트를 가져옵니다.

   승인 전략

   8.1.x 채널에서 자동으로 업데이트를 설치하거나 설치 전에 승인이 필요합니다.

6. 서브스크립션을 선택하여 Data Grid Operator를 설치합니다.
7. Installed Operators 로 이동하여 Data Grid Operator 설치를 확인합니다.

프로세스

1. 프로젝트를 설정합니다.

   1. Data Grid Operator에 대한 프로젝트를 생성합니다.

   2. Data Grid Operator에서 특정 Data Grid 클러스터만 제어하려면 해당 클러스터에 대한 프로젝트를 생성합니다.

      $ oc new-project ${INSTALL_NAMESPACE} 

      1

      
      $ oc new-project ${WATCH_NAMESPACE} 

      2

      Copy to Clipboard Toggle word wrap

      1

      Data Grid Operator를 설치하는 프로젝트를 생성합니다.

      2

      Data Grid Operator가 모든 프로젝트를 조사하지 않으려면 선택적으로 특정 Data Grid 클러스터에 대한 프로젝트를 생성합니다.

2. OperatorGroup 리소스를 생성합니다.

   모든 데이터 그리드 클러스터 제어

   $ oc apply -f - << EOF
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
    name: datagrid
    namespace: ${INSTALL_NAMESPACE}
   EOF

   Copy to Clipboard Toggle word wrap

   특정 Data Grid 클러스터 제어

   $ oc apply -f - << EOF
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
    name: datagrid
    namespace: ${INSTALL_NAMESPACE}
   spec:
    targetNamespaces:
    - ${WATCH_NAMESPACE}
   EOF

   Copy to Clipboard Toggle word wrap

3. Data Grid Operator에 대한 서브스크립션을 생성합니다.

   $ oc apply -f - << EOF
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
    name: datagrid-operator
    namespace: ${INSTALL_NAMESPACE}
   spec:
    channel: 8.1.x
    installPlanApproval: Automatic 

   1

   
    name: datagrid
    source: redhat-operators
    sourceNamespace: openshift-marketplace
   EOF

   Copy to Clipboard Toggle word wrap

   1

   8.1.x 채널에서 업데이트를 수동으로 승인하려면 Manual 을 지정합니다.

4. 설치를 확인합니다.

   $ oc get pods -n ${INSTALL_NAMESPACE}
   NAME                                   READY   STATUS
   infinispan-operator-<id>               1/1     Running

   Copy to Clipboard Toggle word wrap

프로세스

1. Infinispan CR에 spec.replicas 를 사용하여 클러스터에서 Data Grid 노드 수를 지정합니다.

   예를 들어 다음과 같이 cr_minimal.yaml 파일을 생성합니다.

   $ cat > cr_minimal.yaml<<EOF
   apiVersion: infinispan.org/v1
   kind: Infinispan
   metadata:
     name: example-infinispan
   spec:
     replicas: 2
   EOF

   Copy to Clipboard Toggle word wrap

2. Infinispan CR을 적용합니다.

   $ oc apply -f cr_minimal.yaml

   Copy to Clipboard Toggle word wrap

3. Data Grid Operator에서 Data Grid 노드를 생성합니다.

   $ oc get pods -w
   
   NAME                        READY  STATUS              RESTARTS   AGE
   example-infinispan-1        0/1    ContainerCreating   0          4s
   example-infinispan-2        0/1    ContainerCreating   0          4s
   example-infinispan-3        0/1    ContainerCreating   0          5s
   infinispan-operator-0       1/1    Running             0          3m
   example-infinispan-3        1/1    Running             0          8s
   example-infinispan-2        1/1    Running             0          8s
   example-infinispan-1        1/1    Running             0          8s

   Copy to Clipboard Toggle word wrap

프로세스

1. Infinispan CR을 생성합니다.

   apiVersion: infinispan.org/v1
   kind: Infinispan
   metadata:
     name: example-infinispan
   spec:
     replicas: 2
     service:
       type: Cache 

   1

   Copy to Clipboard Toggle word wrap

   1

   노드 캐시 서비스 노드를 생성합니다. 이는 Infinispan CR의 기본값입니다.

2. Infinispan CR을 적용하여 클러스터를 생성합니다.

프로세스

1. Infinispan CR의 spec.service.type 값으로 Data Cryostat를 지정합니다.

   apiVersion: infinispan.org/v1
   kind: Infinispan
   metadata:
     name: example-infinispan
   spec:
     replicas: 2
     service:
       type: DataGrid

   Copy to Clipboard Toggle word wrap
   참고

   노드를 생성한 후에는 spec.service.type 필드를 변경할 수 없습니다. 서비스 유형을 변경하려면 기존 노드를 삭제하고 새 노드를 생성해야 합니다.

2. 다른 Data Grid 서비스 리소스를 사용하여 노드를 구성합니다.
3. Infinispan CR을 적용하여 클러스터를 생성합니다.

프로세스

1. 편집을 위해 Infinispan CR을 엽니다.
2. Data Grid Operator가 metadata.annotations 를 사용하여 리소스에 연결할 레이블을 추가합니다.

3. metadata.labels 를 사용하여 라벨 값을 추가합니다.

   apiVersion: infinispan.org/v1
   kind: Infinispan
   metadata:
     annotations:
       # Add labels that you want to attach to services.
       infinispan.org/targetLabels: svc-label1, svc-label2
       # Add labels that you want to attach to pods.
       infinispan.org/podTargetLabels: pod-label1, pod-label2
     labels:
       # Add values for your labels.
       svc-label1: svc-value1
       svc-label2: svc-value2
       pod-label1: pod-value1
       pod-label2: pod-value2
       # The operator does not attach these labels to resources.
       my-label: my-value
       environment: development

   Copy to Clipboard Toggle word wrap
4. Infinispan CR을 적용합니다.

프로세스

1. Infinispan CR에 spec.expose 를 포함합니다.

2. spec.expose.type 을 사용하여 LoadBalancer 를 서비스 유형으로 지정합니다.

   spec:
     ...
     expose:
       type: LoadBalancer 

   1

   
       nodePort: 30000 

   2

   Copy to Clipboard Toggle word wrap

   1

   포트 11222 의 로드 밸런서 서비스를 통해 네트워크에 데이터 그리드를 노출합니다.

   2

   선택적으로 로드 밸런서 서비스가 트래픽을 전달하는 노드 포트를 정의합니다.

3. 변경 사항을 적용합니다.

4. -external 서비스를 사용할 수 있는지 확인합니다.

   $ oc get services | grep external
   
   NAME                         TYPE            CLUSTER-IP    EXTERNAL-IP   PORT(S)
   example-infinispan-external  LoadBalancer    192.0.2.24    hostname.com  11222/TCP

   Copy to Clipboard Toggle word wrap

프로세스

1. Infinispan CR에 spec.expose 를 포함합니다.

2. spec.expose.type 을 사용하여 서비스 유형으로 NodePort 를 지정합니다.

   spec:
     ...
     expose:
       type: NodePort 

   1

   
       nodePort: 30000 

   2

   Copy to Clipboard Toggle word wrap

   1

   노드 포트 서비스를 통해 네트워크에 데이터 그리드를 노출합니다.

   2

   Data Grid가 노출되는 포트를 정의합니다. 포트를 정의하지 않으면 플랫폼에서 포트를 선택합니다.

3. 변경 사항을 적용합니다.

4. -external 서비스를 사용할 수 있는지 확인합니다.

   $ oc get services | grep external
   
   NAME                         TYPE            CLUSTER-IP       EXTERNAL-IP   PORT(S)
   example-infinispan-external  NodePort        192.0.2.24       <none>        11222:30000/TCP

   Copy to Clipboard Toggle word wrap

프로세스

1. Infinispan CR에 spec.expose 를 포함합니다.
2. spec.expose.type 을 사용하여 Route 를 서비스 유형으로 지정합니다.

3. 선택적으로 spec.expose.host 를 사용하여 호스트 이름을 추가합니다.

   spec:
     ...
     expose:
       type: Route 

   1

   
       host: www.example.org 

   2

   Copy to Clipboard Toggle word wrap

   1

   OpenShift 경로를 통해 네트워크에 데이터 그리드를 노출합니다.

   2

   선택적으로 Data Grid가 노출되는 호스트 이름을 지정합니다.

4. 변경 사항을 적용합니다.

5. 경로를 사용할 수 있는지 확인합니다.

   $ oc get routes
   
   NAME                 CLASS    HOSTS   ADDRESS   PORTS   AGE
   example-infinispan   <none>   *                 443     73s

   Copy to Clipboard Toggle word wrap

프로세스

1. OpenShift 클러스터에 로그인합니다.

2. 서비스 계정을 생성합니다.

   예를 들어 LON 에서 서비스 계정을 생성합니다.

   $ oc create sa lon
   serviceaccount/lon created

   Copy to Clipboard Toggle word wrap

3. 다음 명령을 사용하여 서비스 계정에 view 역할을 추가합니다.

   $ oc policy add-role-to-user view system:serviceaccount:<namespace>:lon

   Copy to Clipboard Toggle word wrap
4. 다른 OpenShift 클러스터에서 이전 단계를 반복합니다.

프로세스

1. OpenShift 클러스터에 로그인합니다.

2. 다음 명령을 사용하여 백업 위치에 대한 서비스 계정 토큰을 추가합니다.

   $ oc create secret generic <token-name> --from-literal=token=<token>

   Copy to Clipboard Toggle word wrap

   예를 들어, CryostatC에서 OpenShift 클러스터에 로그인하고 다음과 같이 lon-token 시크릿을 생성합니다.

   $ oc create secret generic lon-token --from-literal=token=eyJhbGciOiJSUzI1NiIsImtpZCI6IiJ9...

   Copy to Clipboard Toggle word wrap
3. 다른 OpenShift 클러스터에서 이전 단계를 반복합니다.

프로세스

1. 각 Data Grid 클러스터에 대한 Infinispan CR을 생성합니다.
2. metadata.name 을 사용하여 각 Data Grid 클러스터에 일치하는 이름을 지정합니다.
3. spec.service.sites.local.name 을 사용하여 로컬 사이트의 이름을 지정합니다.
4. spec.service.sites.local.expose.type 을 사용하여 로컬 사이트의 expose 서비스 유형을 설정합니다.

5. spec.service.sites.locations 의 백업 위치 역할을 하는 각 Data Grid 클러스터에 대해 이름, URL, 시크릿을 제공합니다.

   다음은 LON 및 CryostatC에 대한 Infinispan CR 정의의 예입니다.

   • LON

     apiVersion: infinispan.org/v1
     kind: Infinispan
     metadata:
       name: example-infinispan
     spec:
       replicas: 3
       service:
         type: DataGrid
         sites:
           local:
             name: LON
             expose:
               type: LoadBalancer
           locations:
             - name: LON
               url: openshift://api.rhdg-lon.openshift-aws.myhost.com:6443
               secretName: lon-token
             - name: NYC
               url: openshift://api.rhdg-nyc.openshift-aws.myhost.com:6443
               secretName: nyc-token

     Copy to Clipboard Toggle word wrap

   • NYC

     apiVersion: infinispan.org/v1
     kind: Infinispan
     metadata:
       name: example-infinispan
     spec:
       replicas: 2
       service:
         type: DataGrid
         sites:
           local:
             name: NYC
             expose:
               type: LoadBalancer
           locations:
             - name: NYC
               url: openshift://api.rhdg-nyc.openshift-aws.myhost.com:6443
               secretName: nyc-token
             - name: LON
               url: openshift://api.rhdg-lon.openshift-aws.myhost.com:6443
               secretName: lon-token

     Copy to Clipboard Toggle word wrap

6. 다음과 같이 교차 사이트 복제의 로깅 수준을 조정합니다.

   ...
     logging:
       categories:
         org.jgroups.protocols.TCP: error
         org.jgroups.protocols.relay.RELAY2: fatal

   Copy to Clipboard Toggle word wrap

   이전 구성에서는 클러스터 백업 작업에 대한 과도한 메시지를 줄이기 위해 Cryostat TCP 및 RELAY2 프로토콜의 로깅을 줄임으로써 컨테이너 스토리지를 사용하는 많은 로그 파일이 발생할 수 있습니다.

7. 다른 Data Grid 서비스 리소스를 사용하여 노드를 구성합니다.
8. Infinispan CR을 적용합니다.

9. 노드 로그를 확인하여 Data Grid 클러스터가 교차 사이트 뷰를 형성하는지 확인합니다. 예를 들면 다음과 같습니다.

   $ oc logs example-infinispan-0 | grep x-site
   
   INFO  [org.infinispan.XSITE] (jgroups-5,example-infinispan-0-<id>) ISPN000439: Received new x-site view: [NYC]
   INFO  [org.infinispan.XSITE] (jgroups-7,example-infinispan-0-<id>) ISPN000439: Received new x-site view: [NYC, LON]

   Copy to Clipboard Toggle word wrap

프로세스

1. StringData 맵에서 Data Grid 서비스 클러스터에 액세스하기 위한 유효한 사용자 자격 증명을 제공하는 Secret 오브젝트 유형을 정의합니다.

   예를 들어 다음과 같이 developer 사용자에게 자격 증명을 제공하는 basic-auth.yaml 파일을 생성합니다.

   apiVersion: v1
   stringData:
     username: developer 

   1

   
     password: G8ZdJvSaY3lOOwfM 

   2

   
   kind: Secret
   metadata:
     name: basic-auth 

   3

   
   type: Opaque

   Copy to Clipboard Toggle word wrap

   1

   캐시를 생성할 수 있는 사용자의 이름을 지정합니다.

   2

   사용자에게 해당하는 암호를 지정합니다.

   3

   보안의 이름을 지정합니다.

2. 다음 예와 같이 파일에서 시크릿을 생성합니다.

   $ oc apply -f basic-auth.yaml

   Copy to Clipboard Toggle word wrap

프로세스

1. 만들 XML 캐시 정의가 포함된 캐시 CR을 만듭니다.

   apiVersion: infinispan.org/v2alpha1
   kind: Cache
   metadata:
     name: mycachedefinition 

   1

   
   spec:
     adminAuth: 

   2

   
       secretName: basic-auth
     clusterName: example-infinispan 

   3

   
     name: mycache 

   4

   
     template: <infinispan><cache-container><distributed-cache name="mycache" mode="SYNC"><persistence><file-store/></persistence></distributed-cache></cache-container></infinispan> 

   5

   Copy to Clipboard Toggle word wrap

   1

   Cache CR의 이름을 지정합니다.

   2

   사용자 이름 및 암호 키가 포함된 인증 정보 또는 사용자 정의 인증 정보 시크릿에 대한 재정의를 제공하는 보안을 지정합니다.

   3

   Data Grid Operator에서 캐시를 생성할 대상 Data Grid 클러스터의 이름을 지정합니다.

   4

   Data Grid 클러스터의 캐시 이름을 지정합니다.

   5

   캐시를 만들 XML 캐시 정의를 지정합니다. name 속성은 무시됩니다. 결과 캐시에는 spec.name 만 적용됩니다.

2. Cache CR을 적용합니다. 예를 들면 다음과 같습니다.

   $ oc apply -f mycache.yaml
   cache.infinispan.org/mycachedefinition created

   Copy to Clipboard Toggle word wrap

프로세스

1. 사용할 템플릿의 이름을 지정하는 Cache CR을 만듭니다.

   예를 들어 다음 CR은 org.infinispan.DIST_SYNC 캐시 구성 템플릿을 사용하는 "mycache"라는 캐시를 생성합니다.

   apiVersion: infinispan.org/v2alpha1
   kind: Cache
   metadata:
     name: mycachedefinition 

   1

   
   spec:
     adminAuth: 

   2

   
       secretName: basic-auth
     clusterName: example-infinispan 

   3

   
     name: mycache 

   4

   
     templateName: org.infinispan.DIST_SYNC 

   5

   Copy to Clipboard Toggle word wrap

   1

   Cache CR의 이름을 지정합니다.

   2

   사용자 이름 및 암호 키가 포함된 인증 정보 또는 사용자 정의 인증 정보 시크릿에 대한 재정의를 제공하는 보안을 지정합니다.

   3

   Data Grid Operator에서 캐시를 생성할 대상 Data Grid 클러스터의 이름을 지정합니다.

   4

   Data Grid 캐시 인스턴스의 이름을 지정합니다.

   5

   캐시를 생성할 infinispan.org 캐시 구성 템플릿을 지정합니다.

2. Cache CR을 적용합니다. 예를 들면 다음과 같습니다.

   $ oc apply -f mycache.yaml
   cache.infinispan.org/mycachedefinition created

   Copy to Clipboard Toggle word wrap

프로세스

1. 각 사이트에 대해 동일한 이름으로 캐시 구성을 만듭니다.

   각 사이트의 캐시 구성은 다른 캐시 모드 및 백업 전략을 사용할 수 있습니다. Data Grid는 캐시 이름을 기반으로 데이터를 복제합니다.

2. take-offline 요소를 사용하여 오프라인으로 전환하도록 백업 위치를 구성합니다.

   1. 백업 위치가 min-wait 특성으로 오프라인 상태가 되기 전에 시간(밀리초)을 설정합니다.
3. 기타 유효한 캐시 구성을 정의합니다.

4. 글로벌 클러스터의 모든 사이트의 이름이 지정된 캐시에 백업 위치를 추가합니다.

   예를 들어 LON 을 CryostatC의 백업으로 추가하는 경우 LON 의 백업으로 Cryo statC를 추가해야 합니다.

프로세스

1. $SERVICE_HOSTNAME:$PORT 에서 모든 브라우저에서 콘솔에 액세스합니다.

   $SERVICE_HOSTNAME:$PORT 를 네트워크에서 Data Grid를 사용할 수 있는 호스트 이름 및 포트로 바꿉니다.

2. 메시지가 표시되면 Data Grid 자격 증명을 입력합니다.

프로세스

1. Prometheus가 Data Grid 클러스터로 인증할 수 있도록 Data Grid 인증 정보가 포함된 인증 보안을 생성합니다.

   apiVersion: v1
   stringData:
     username: developer 

   1

   
     password: dIRs5cAAsHIeeRIL 

   2

   
   kind: Secret
   metadata:
     name: basic-auth
   type: Opaque

   Copy to Clipboard Toggle word wrap

   1

   애플리케이션 사용자를 지정합니다. Developer 는 기본값입니다.

   2

   해당 암호를 지정합니다.

2. Prometheus 네임스페이스에 인증 보안을 추가합니다.

   $ oc apply -f basic-auth.yaml

   Copy to Clipboard Toggle word wrap

3. Data Grid 클러스터를 모니터링하도록 Prometheus를 구성하는 서비스 모니터를 생성합니다.

   apiVersion: monitoring.coreos.com/v1
   kind: ServiceMonitor
   metadata:
     labels:
       k8s-app: prometheus
     name: datagrid-monitoring 

   1

   
     namespace: infinispan-monitoring 

   2

   
   spec:
     endpoints:
       - targetPort: 11222 

   3

   
         path: /metrics 

   4

   
         honorLabels: true
         basicAuth:
           username:
             key: username
             name: basic-auth 

   5

   
           password:
             key: password
             name: basic-auth
         interval: 30s
         scrapeTimeout: 10s
         scheme: https 

   6

   
         tlsConfig:
           insecureSkipVerify: true
           serverName: example-infinispan 

   7

   
     namespaceSelector:
       matchNames:
         - infinispan 

   8

   
     selector:
       matchLabels:
         app: infinispan-service
         clusterName: example-infinispan 

   9

   Copy to Clipboard Toggle word wrap

   1

   서비스 모니터 인스턴스의 이름을 지정합니다.

   2

   Prometheus 스택의 네임스페이스를 지정합니다.

   3

   Data Grid 메트릭 끝점에 대해 11222 포트를 설정합니다.

   4

   Data Grid가 메트릭을 표시하는 경로를 설정합니다.

   5

   Data Grid 자격 증명을 사용하여 인증 보안을 지정합니다.

   6

   데이터 그리드 클러스터에서 끝점 암호화를 사용하도록 지정합니다.

   7

   Data Grid 암호화를 위한 TLS 인증서의 CN(일반 이름)을 지정합니다. OpenShift 서비스 인증서를 사용하는 경우 CN은 Data Grid 클러스터의 metadata.name 리소스와 일치합니다.

   8

   Data Grid 클러스터의 네임스페이스를 지정합니다.

   9

   Data Grid 클러스터의 이름을 지정합니다.

4. Prometheus 네임스페이스에 서비스 모니터 인스턴스를 추가합니다.

   $ oc apply -f service-monitor.yaml

   Copy to Clipboard Toggle word wrap

프로세스

1. Infinispan CR에 spec.affinity 블록을 추가합니다.
2. 필요에 따라 유사성 방지 전략을 구성합니다.
3. Infinispan CR을 적용합니다.

프로세스

1. Infinispan CR에서 spec.logging 을 사용하여 로깅 구성을 지정한 다음 변경 사항을 적용합니다.

   spec:
     ...
     logging: 

   1

   
       categories: 

   2

   
         org.infinispan: debug 

   3

   
         org.jgroups: debug

   Copy to Clipboard Toggle word wrap

   1

   데이터 그리드 로깅을 구성합니다.

   2

   로깅 카테고리 추가.

   3

   로깅 카테고리 및 수준의 이름입니다.

   참고

   루트 로깅 카테고리는 org.infinispan 이며 기본적으로 INFO 입니다.

2. 필요에 따라 Data Grid 노드에서 로그를 검색합니다.

   $ oc logs -f $POD_NAME

   Copy to Clipboard Toggle word wrap