11.2. 로그 스토리지 설치

절차

1. OpenShift Dedicated 웹 콘솔 관리자 화면에서 Operator OperatorHub 로 이동합니다.

2. 키워드로 필터링 필드에 Loki Operator를 입력합니다. 사용 가능한 Operator 목록에서 Loki Operator 를 클릭한 다음 설치를 클릭합니다.

   중요

   Community Loki Operator는 Red Hat에서 지원하지 않습니다.

3. 업데이트 채널로 stable 또는 stable-x.y 를 선택합니다.

   참고

   stable 채널은 최신 로깅 릴리스에 대한 업데이트만 제공합니다. 이전 릴리스에 대한 업데이트를 계속 받으려면 서브스크립션 채널을 stable-x.y 로 변경해야 합니다. 여기서 x.y 는 설치한 로깅 및 마이너 버전을 나타냅니다. 예를 들면 stable-5.7 입니다.

   Loki Operator는 글로벌 Operator 그룹 네임스페이스 openshift-operators-redhat 에 배포되어야 하므로 설치 모드 및 설치된 네임스페이스 가 이미 선택되어 있습니다. 이 네임스페이스가 아직 없는 경우 이를 위해 생성됩니다.

4. 이 네임스페이스에서 operator-recommended 클러스터 모니터링 사용을 선택합니다.

   이 옵션은 Namespace 오브젝트에서 openshift.io/cluster-monitoring: "true" 라벨을 설정합니다. 클러스터 모니터링이 openshift-operators-redhat 네임스페이스를 스크랩하도록 하려면 이 옵션을 선택해야 합니다.

5. 업데이트 승인 의 경우 자동 을 선택한 다음 설치를 클릭합니다.

   서브스크립션의 승인 전략이 자동으로 설정된 경우 선택한 채널에서 새 Operator 버전을 사용할 수 있는 즉시 업데이트 프로세스가 시작됩니다. 승인 전략이 Manual 로 설정된 경우 보류 중인 업데이트를 수동으로 승인해야 합니다.

검증

1. Operator 설치된 Operator 로 이동합니다.
2. openshift-logging 프로젝트가 선택되어 있는지 확인합니다.
3. 상태 열에서 InstallSucceeded 가 포함된 녹색 확인 표시와 최대 날짜 텍스트가 표시되는지 확인합니다.

절차

1. OpenShift Dedicated 웹 콘솔의 관리자 관점에서 워크로드 시크릿 으로 이동합니다.
2. 생성 드롭다운 목록에서 YAML 에서 선택합니다.

3. access_key_id 및 access_key_secret 필드를 사용하여 인증 정보 및 버킷 이름,끝점, 지역 필드를 지정하여 오브젝트 스토리지 위치를 정의하는 시크릿을 생성합니다. AWS는 다음 예제에서 사용됩니다.

   Secret 오브젝트의 예

   apiVersion: v1
   kind: Secret
   metadata:
     name: logging-loki-s3
     namespace: openshift-logging
   stringData:
     access_key_id: AKIAIOSFODNN7EXAMPLE
     access_key_secret: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
     bucketnames: s3-bucket-name
     endpoint: https://s3.eu-central-1.amazonaws.com
     region: eu-central-1

절차

1. Operator 설치된 Operator 페이지로 이동합니다. 모든 인스턴스 탭을 클릭합니다.
2. Create new 드롭다운 목록에서 LokiStack 을 선택합니다.

3. YAML 보기를 선택한 다음 다음 템플릿을 사용하여 LokiStack CR을 생성합니다.

   apiVersion: loki.grafana.com/v1
   kind: LokiStack
   metadata:
     name: logging-loki 1
     namespace: openshift-logging
   spec:
     size: 1x.small 2
     storage:
       schemas:
         - effectiveDate: '2023-10-15'
           version: v13
       secret:
         name: logging-loki-s3 3
         type: s3 4
         credentialMode: 5
     storageClassName: <storage_class_name> 6
     tenants:
       mode: openshift-logging

   1

   logging-loki 라는 이름을 사용합니다.

   2

   배포 크기를 지정합니다. 로깅 5.8 이상 버전에서 Loki의 프로덕션 인스턴스에 지원되는 크기 옵션은 1x.extra- #159 ,1x. windows 또는 1x.medium 입니다.

   3

   로그 스토리지에 사용되는 시크릿을 지정합니다.

   4

   해당 스토리지 유형을 지정합니다.

   5

   선택적 필드, 로깅 5.9 이상 지원되는 사용자 구성 값은 다음과 같습니다. static 은 Secret에 저장된 인증 정보를 사용하여 지원되는 모든 오브젝트 스토리지 유형에 사용할 수 있는 기본 인증 모드입니다. 인증 정보 소스에서 검색된 단기 토큰에 대한 토큰입니다. 이 모드에서 정적 구성에는 오브젝트 스토리지에 필요한 인증 정보가 포함되어 있지 않습니다. 대신 서비스를 사용하여 런타임 중에 생성되므로 더 짧은 자격 증명과 훨씬 더 세분화된 제어가 가능합니다. 이 인증 모드는 모든 오브젝트 스토리지 유형에서 지원되지 않습니다. token-cco 는 Loki가 관리 STS 모드에서 실행되고 STS/WIF 클러스터에서 CCO를 사용할 때 기본값입니다.

   6

   임시 스토리지의 스토리지 클래스 이름을 입력합니다. 최상의 성능을 위해서는 블록 스토리지를 할당하는 스토리지 클래스를 지정합니다. oc get storageclasses 명령을 사용하여 클러스터에 사용 가능한 스토리지 클래스를 나열할 수 있습니다.

절차

1. Subscription 오브젝트를 생성합니다.

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: loki-operator
     namespace: openshift-operators-redhat 1
   spec:
     channel: stable 2
     name: loki-operator
     source: redhat-operators 3
     sourceNamespace: openshift-marketplace

   1

   openshift-operators-redhat 네임스페이스를 지정해야 합니다.

   2

   stable 또는 stable -5.<y&gt;를 채널로 지정합니다.

   3

   redhat-operators를 지정합니다. OpenShift Dedicated 클러스터가 제한된 네트워크(연결이 끊긴 클러스터)에 설치된 경우 OLM(Operator Lifecycle Manager)을 구성할 때 생성된 CatalogSource 오브젝트의 이름을 지정합니다.

2. Subscription 오브젝트를 적용합니다.

   $ oc apply -f <filename>.yaml

절차

1. LokiStack CR을 생성합니다.

   LokiStack CR의 예

   apiVersion: loki.grafana.com/v1
   kind: LokiStack
   metadata:
     name: logging-loki 1
     namespace: openshift-logging
   spec:
     size: 1x.small 2
     storage:
       schemas:
         - effectiveDate: '2023-10-15'
           version: v13
       secret:
         name: logging-loki-s3 3
         type: s3 4
         credentialMode: 5
     storageClassName: <storage_class_name> 6
     tenants:
       mode: openshift-logging

   1

   logging-loki 라는 이름을 사용합니다.

   2

   배포 크기를 지정합니다. 로깅 5.8 이상 버전에서 Loki의 프로덕션 인스턴스에 지원되는 크기 옵션은 1x.extra- #159 ,1x. windows 또는 1x.medium 입니다.

   3

   로그 스토리지에 사용되는 시크릿을 지정합니다.

   4

   해당 스토리지 유형을 지정합니다.

   5

   선택적 필드, 로깅 5.9 이상 지원되는 사용자 구성 값은 다음과 같습니다. static 은 Secret에 저장된 인증 정보를 사용하여 지원되는 모든 오브젝트 스토리지 유형에 사용할 수 있는 기본 인증 모드입니다. 인증 정보 소스에서 검색된 단기 토큰에 대한 토큰입니다. 이 모드에서 정적 구성에는 오브젝트 스토리지에 필요한 인증 정보가 포함되어 있지 않습니다. 대신 서비스를 사용하여 런타임 중에 생성되므로 더 짧은 자격 증명과 훨씬 더 세분화된 제어가 가능합니다. 이 인증 모드는 모든 오브젝트 스토리지 유형에서 지원되지 않습니다. token-cco 는 Loki가 관리 STS 모드에서 실행되고 STS/WIF 클러스터에서 CCO를 사용할 때 기본값입니다.

   6

   임시 스토리지의 스토리지 클래스 이름을 입력합니다. 최상의 성능을 위해서는 블록 스토리지를 할당하는 스토리지 클래스를 지정합니다. oc get storageclasses 명령을 사용하여 클러스터에 사용 가능한 스토리지 클래스를 나열할 수 있습니다.

2. 다음 명령을 실행하여 LokiStack CR을 적용합니다.

절차

1. GCP에서 수신한 서비스 계정 인증 정보를 key.json 이라는 파일에 복사합니다.

2. 다음 명령을 실행하여 이름 logging-loki-gcs 를 사용하여 오브젝트 스토리지 시크릿을 생성합니다.

   $ oc create secret generic logging-loki-gcs \
     --from-literal=bucketname="<bucket_name>" \
     --from-file=key.json="<path/to/key.json>"

절차

1. openshift-logging 네임스페이스에 ObjectBucketClaim 사용자 정의 리소스를 생성합니다.

   apiVersion: objectbucket.io/v1alpha1
   kind: ObjectBucketClaim
   metadata:
     name: loki-bucket-odf
     namespace: openshift-logging
   spec:
     generateBucketName: loki-bucket-odf
     storageClassName: openshift-storage.noobaa.io

2. 다음 명령을 실행하여 관련 ConfigMap 오브젝트에서 버킷 속성을 가져옵니다.

   BUCKET_HOST=$(oc get -n openshift-logging configmap loki-bucket-odf -o jsonpath='{.data.BUCKET_HOST}')
   BUCKET_NAME=$(oc get -n openshift-logging configmap loki-bucket-odf -o jsonpath='{.data.BUCKET_NAME}')
   BUCKET_PORT=$(oc get -n openshift-logging configmap loki-bucket-odf -o jsonpath='{.data.BUCKET_PORT}')

3. 다음 명령을 실행하여 관련 시크릿에서 버킷 액세스 키를 가져옵니다.

   ACCESS_KEY_ID=$(oc get -n openshift-logging secret loki-bucket-odf -o jsonpath='{.data.AWS_ACCESS_KEY_ID}' | base64 -d)
   SECRET_ACCESS_KEY=$(oc get -n openshift-logging secret loki-bucket-odf -o jsonpath='{.data.AWS_SECRET_ACCESS_KEY}' | base64 -d)

4. 다음 명령을 실행하여 logging-loki-odf 라는 이름으로 오브젝트 스토리지 시크릿을 생성합니다.

   $ oc create -n openshift-logging secret generic logging-loki-odf \
   --from-literal=access_key_id="<access_key_id>" \
   --from-literal=access_key_secret="<secret_access_key>" \
   --from-literal=bucketnames="<bucket_name>" \
   --from-literal=endpoint="https://<bucket_host>:<bucket_port>"

절차

1. OpenShift Dedicated 웹 콘솔에서 Operator OperatorHub 를 클릭합니다.
2. 사용 가능한 Operator 목록에서 OpenShift Elasticsearch Operator 를 클릭하고 설치를 클릭합니다.
3. 설치 모드에서 클러스터의 모든 네임스페이스 가 선택되어 있는지 확인합니다.

4. 설치된 네임스페이스에서 openshift-operators-redhat이 선택되어 있는지 확인합니다.

   openshift-operators-redhat 네임스페이스를 지정해야 합니다. openshift-operators 네임스페이스에 신뢰할 수 없는 Community Operator가 포함될 수 있으며, 이로 인해 OpenShift Dedicated 지표와 동일한 이름의 지표를 게시할 수 있으므로 충돌이 발생합니다.

5. 이 네임스페이스에서 Operator 권장 클러스터 모니터링 사용을 선택합니다.

   이 옵션은 Namespace 오브젝트에서 openshift.io/cluster-monitoring: "true" 라벨을 설정합니다. 클러스터 모니터링이 openshift-operators-redhat 네임스페이스를 스크랩하도록 하려면 이 옵션을 선택해야 합니다.

6. stable-5.x 를 업데이트 채널로 선택합니다.

7. 업데이트 승인 전략을 선택합니다.

   • 자동 전략을 사용하면 Operator 새 버전이 준비될 때 OLM(Operator Lifecycle Manager)이 자동으로 Operator를 업데이트할 수 있습니다.
   • 수동 전략을 사용하려면 적절한 자격 증명을 가진 사용자가 Operator 업데이트를 승인해야 합니다.
8. 설치를 클릭합니다.

검증

1. Operator 설치된 Operator 페이지로 전환하여 OpenShift Elasticsearch Operator가 설치되었는지 확인합니다.
2. 상태가 성공인 모든 프로젝트에 OpenShift Elasticsearch Operator가 나열되어 있는지 확인합니다.

절차

1. Namespace 오브젝트를 YAML 파일로 생성합니다.

   apiVersion: v1
   kind: Namespace
   metadata:
     name: openshift-operators-redhat 1
     annotations:
       openshift.io/node-selector: ""
     labels:
       openshift.io/cluster-monitoring: "true" 2

   1

   openshift-operators-redhat 네임스페이스를 지정해야 합니다. 지표와의 충돌을 방지하려면 openshift-operators 네임스페이스가 아닌 openshift-operators-redhat 네임스페이스에서 지표를 스크랩하도록 Prometheus 클러스터 모니터링 스택을 구성합니다. openshift-operators 네임스페이스에 신뢰할 수 없는 커뮤니티 Operator가 포함될 수 있으며, 이로 인해 OpenShift Dedicated 지표와 동일한 이름의 지표를 게시할 수 있으므로 충돌이 발생합니다.

   2

   문자열. 클러스터 모니터링이 openshift-operators-redhat 네임스페이스를 스크랩하도록 하려면 표시된 이 레이블을 지정해야 합니다.

2. 다음 명령을 실행하여 Namespace 오브젝트를 적용합니다.

   $ oc apply -f <filename>.yaml

3. OperatorGroup 오브젝트를 YAML 파일로 생성합니다.

   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: openshift-operators-redhat
     namespace: openshift-operators-redhat 1
   spec: {}

   1

   openshift-operators-redhat 네임스페이스를 지정해야 합니다.

4. 다음 명령을 실행하여 OperatorGroup 오브젝트를 적용합니다.

   $ oc apply -f <filename>.yaml

5. OpenShift Elasticsearch Operator에 네임스페이스를 서브스크립션할 Subscription 오브젝트를 생성합니다.

   서브스크립션의 예

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: elasticsearch-operator
     namespace: openshift-operators-redhat 1
   spec:
     channel: stable-x.y 2
     installPlanApproval: Automatic 3
     source: redhat-operators 4
     sourceNamespace: openshift-marketplace
     name: elasticsearch-operator

   1

   openshift-operators-redhat 네임스페이스를 지정해야 합니다.

   2

   stable 또는 stable-x.y 를 채널로 지정합니다. 다음 참고 사항을 참조하십시오.

   3

   자동 을 사용하면 새 버전이 사용 가능할 때 OLM(Operator Lifecycle Manager)이 Operator를 자동으로 업데이트할 수 있습니다. 수동 을 사용하려면 적절한 인증 정보가 있는 사용자가 Operator 업데이트를 승인해야 합니다.

   4

   redhat-operators를 지정합니다. OpenShift Dedicated 클러스터가 제한된 네트워크(연결이 끊긴 클러스터)에 설치된 경우 OLM(Operator Lifecycle Manager)을 구성할 때 생성된 CatalogSource 오브젝트의 이름을 지정합니다.

   참고

   stable을 지정하면 안정적인 최신 릴리스의 현재 버전이 설치됩니다. installPlanApproval: "Automatic" 과 함께 stable 을 사용하면 Operator가 안정적인 최신 메이저 및 마이너 릴리스로 자동 업그레이드됩니다.

   stable-x.y 를 지정하면 특정 주요 릴리스의 현재 마이너 버전이 설치됩니다. installPlanApproval: "Automatic" 과 함께 stable-x.y 를 사용하면 Operator가 주요 릴리스 내에서 안정적인 최신 마이너 릴리스로 자동 업그레이드됩니다.

6. 다음 명령을 실행하여 서브스크립션을 적용합니다.

   $ oc apply -f <filename>.yaml

   OpenShift Elasticsearch Operator는 openshift-operators-redhat 네임스페이스에 설치되고 클러스터의 각 프로젝트에 복사됩니다.

검증

1. 다음 명령을 실행합니다.

   $ oc get csv -n --all-namespaces

2. 출력을 관찰하고 OpenShift Elasticsearch Operator의 Pod가 각 네임스페이스에 있는지 확인합니다.

   출력 예

   NAMESPACE                                          NAME                            DISPLAY                            VERSION          REPLACES                        PHASE
   default                                            elasticsearch-operator.v5.8.1   OpenShift Elasticsearch Operator   5.8.1            elasticsearch-operator.v5.8.0   Succeeded
   kube-node-lease                                    elasticsearch-operator.v5.8.1   OpenShift Elasticsearch Operator   5.8.1            elasticsearch-operator.v5.8.0   Succeeded
   kube-public                                        elasticsearch-operator.v5.8.1   OpenShift Elasticsearch Operator   5.8.1            elasticsearch-operator.v5.8.0   Succeeded
   kube-system                                        elasticsearch-operator.v5.8.1   OpenShift Elasticsearch Operator   5.8.1            elasticsearch-operator.v5.8.0   Succeeded
   non-destructive-test                               elasticsearch-operator.v5.8.1   OpenShift Elasticsearch Operator   5.8.1            elasticsearch-operator.v5.8.0   Succeeded
   openshift-apiserver-operator                       elasticsearch-operator.v5.8.1   OpenShift Elasticsearch Operator   5.8.1            elasticsearch-operator.v5.8.0   Succeeded
   openshift-apiserver                                elasticsearch-operator.v5.8.1   OpenShift Elasticsearch Operator   5.8.1            elasticsearch-operator.v5.8.0   Succeeded
   ...