10.2. 로그 스토리지 설치

프로세스

1. OpenShift Container Platform 웹 콘솔 관리자 화면에서 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 버전을 사용할 수 있는 즉시 업데이트 프로세스가 시작됩니다. 승인 전략이 수동으로 설정된 경우 보류 중인 업데이트를 수동으로 승인해야 합니다.

검증

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

프로세스

1. OpenShift Container Platform 웹 콘솔의 관리자 관점에서 워크로드 시크릿 으로 이동합니다.
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:
       - version: v12
         effectiveDate: '2022-06-01'
       secret:
         name: logging-loki-s3 

   3

   
         type: s3 

   4

   
     storageClassName: <storage_class_name> 

   5

   
     tenants:
       mode: openshift-logging 

   6

   1

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

   2

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

   중요

   배포 크기에 대해 숫자 1x 를 변경할 수 없습니다.

   3

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

   4

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

   5

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

   6

   LokiStack은 기본적으로 다중 테넌트 모드에서 실행되며 수정할 수 없습니다. 각 로그 유형( audit, infrastructure, application logs)에 대해 하나의 테넌트가 제공됩니다. 이를 통해 개별 사용자 및 사용자 그룹에 대한 액세스 제어를 다른 로그 스트림에 사용할 수 있습니다.

4. 생성을 클릭합니다.

절차

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 Container Platform 클러스터가 제한된 네트워크(연결이 끊긴 클러스터)에 설치된 경우 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
     namespace: openshift-logging
   spec:
     size: 1x.small 

   1

   
     storage:
       schemas:
       - version: v12
         effectiveDate: "2022-06-01"
       secret:
         name: logging-loki-s3 

   2

   
         type: s3 

   3

   
     storageClassName: <storage_class_name> 

   4

   
     tenants:
       mode: openshift-logging 

   5

   1

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

   중요

   배포 크기에 대해 숫자 1x 를 변경할 수 없습니다.

   2

   로그 저장소 시크릿의 이름을 지정합니다.

   3

   로그 저장소 시크릿 유형을 지정합니다.

   4

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

   5

   LokiStack은 기본적으로 다중 테넌트 모드에서 실행되며 수정할 수 없습니다. 각 로그 유형( audit, infrastructure, application logs)에 대해 하나의 테넌트가 제공됩니다. 이를 통해 개별 사용자 및 사용자 그룹에 대한 액세스 제어를 다른 로그 스트림에 사용할 수 있습니다.

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

   $ oc apply -f <filename>.yaml