다중 클러스터 글로벌 허브

다중 클러스터 글로벌 허브 Operator에는 다중 클러스터 글로벌 허브의 구성 요소가 포함되어 있습니다. Operator는 글로벌 다중 클러스터 관리에 필요한 모든 구성 요소를 배포합니다. 구성 요소에는 multicluster-global-hub-manager,multicluster-global-hub-grafana 가 포함되며 관리 허브 클러스터의 다중 클러스터 글로벌 허브 클러스터 및 multicluster-global-hub-agent 에 Kafka 및 PostgreSQL 이 제공됩니다.

또한 Operator는 매니페스트 작업 사용자 정의 리소스를 활용하여 관리형 클러스터에 Red Hat Advanced Cluster Management for Kubernetes Operator를 배포합니다. Red Hat Advanced Cluster Management Operator를 관리 클러스터에 배포한 후 관리 클러스터는 표준 Red Hat Advanced Cluster Management 클러스터가 됩니다. 이 hub 클러스터는 이제 관리 허브 클러스터입니다.

다중 클러스터 글로벌 허브 관리자는 데이터를 postgreSQL 데이터베이스에 저장하는 데 사용됩니다. 데이터는 Kafka 전송에서 가져온 것입니다. 관리자는 또한 데이터를 Kafka 전송에 게시하므로 관리 허브 클러스터의 데이터와 동기화할 수 있습니다.

다중 클러스터 글로벌 허브 에이전트는 관리 허브 클러스터에서 실행됩니다. 다중 클러스터 글로벌 허브 클러스터와 관리 허브 클러스터 간의 데이터를 동기화합니다. 예를 들어 에이전트는 관리 허브 클러스터의 관리 클러스터 정보를 다중 클러스터 글로벌 허브 클러스터로 동기화하고 다중 클러스터 글로벌 허브 클러스터에서 관리 허브 클러스터로 정책 또는 애플리케이션을 동기화합니다.

Grafana는 다중 클러스터 글로벌 허브 시각화의 기본 서비스로 다중 클러스터 글로벌 허브 클러스터에서 실행됩니다. Global Hub Manager에서 수집한 PostgreSQL 데이터는 기본 DataSource입니다. multicluster-global-hub-grafana 라는 경로를 사용하여 서비스를 노출하면 콘솔에 액세스하여 다중 클러스터 글로벌 허브 Grafana 대시보드에 액세스할 수 있습니다.

글로벌 허브를 설치하려면 다음 요구 사항이 필요합니다.

필수 액세스: 클러스터 관리자

OpenShift Container Platform Dedicated 환경에 필요한 액세스 권한: cluster-admin 권한이 있어야 합니다. 기본적으로 dedicated-admin 역할에는 OpenShift Container Platform Dedicated 환경에서 네임스페이스를 생성하는 데 필요한 권한이 없습니다.

다음 네트워킹 요구 사항을 참조하십시오.

지원되는 플랫폼 및 구성 요소에 대해 알아보십시오.

연결이 끊긴 환경에 다중 클러스터 글로벌 허브를 설치하기 전에 다음 요구 사항을 충족해야 합니다.

연결이 끊긴 환경에서 다중 클러스터 글로벌 허브를 설치하려면 로컬 미러 이미지 레지스트리를 사용해야 합니다. 이 시점에서 OpenShift Container Platform 클러스터 설치 중에 미러 레지스트리를 설정했다고 가정합니다.

다중 클러스터 글로벌 허브의 미러 레지스트리를 프로비저닝하려면 다음 절차를 완료합니다.

클러스터가 인터넷 호스팅 레지스트리가 아닌 로컬 미러 레지스트리에서 다중 클러스터 글로벌 허브 Operator의 컨테이너 이미지를 가져오려면 미러 레지스트리로 이미지 참조를 리디렉션하도록 연결이 끊긴 클러스터에 ImageContentSourcePolicy 리소스를 구성해야 합니다. ImageContentSourcePolicy 는 이미지 다이제스트 가 있는 이미지 미러만 지원합니다.

oc adm catalog mirror 명령을 사용하여 카탈로그를 미러링한 경우 필요한 이미지 콘텐츠 소스 정책 구성은 해당 명령으로 생성된 manifests- 디렉터리 내부의 imageContentSourcePolicy.yaml 파일에 있습니다.

oc-mirror 플러그인을 사용하여 카탈로그를 미러링한 경우 imageContentSourcePolicy.yaml 파일은 oc-mirror-workspace/results- 디렉터리에서 oc-mirror -workspace/results- 디렉터리에 있습니다.

두 경우 모두 oc apply 또는 oc replace 명령을 사용하여 연결이 끊긴 명령에 정책을 적용할 수 있습니다(예: oc replace -f ./<path>/imageContentSourcePolicy.yaml).

필요한 이미지 콘텐츠 소스 정책 설명은 미러 레지스트리를 생성한 방법에 따라 다를 수 있지만 다음 예와 유사합니다.

apiVersion: operator.openshift.io/v1alpha1
kind: ImageContentSourcePolicy
metadata:
  labels:
    operators.openshift.org/catalog: "true"
  name: global-hub-operator-icsp
spec:
  repositoryDigestMirrors:
  - mirrors:
    - myregistry.example.com:5000/multicluster-globalhub
    source: registry.redhat.io/multicluster-globalhub
  - mirrors:
    - myregistry.example.com:5000/openshift4
    source: registry.redhat.io/openshift4
  - mirrors:
    - myregistry.example.com:5000/redhat
    source: registry.redhat.io/redhat

ManagedClusterImageRegistry 를 사용하여 다양한 관리 허브에 대해 다양한 이미지 레지스트리를 구성할 수 있습니다. ManagedClusterImageRegistry API를 사용하여 에이전트 이미지를 교체하려면 ManagedClusterImageRegistry 가 있는 클러스터 가져오기 를 참조하십시오.

이전 단계를 완료하면 레이블과 주석이 선택한 ManagedCluster 에 추가됩니다. 즉 클러스터의 에이전트 이미지가 미러 이미지로 교체됩니다.

oc get pods -n multicluster-global-hub
NAME                                                READY   STATUS    RESTARTS   AGE
multicluster-global-hub-operator-687584cb7c-fnftj   1/1     Running   0          2m12s

고유한 Kafka 인스턴스가 있는 경우 다중 클러스터 글로벌 허브의 전송으로 사용할 수 있습니다. Kafka 3.3은 테스트된 버전입니다. Kafka 인스턴스를 통합하려면 다음 단계를 완료합니다.

PostgreSQL 관계형 데이터베이스가 있는 경우 이를 다중 클러스터 글로벌 허브의 스토리지로 사용할 수 있습니다. PostgreSQL 13은 테스트된 버전입니다.

필요한 최소 스토리지 크기는 20GB입니다. 이 용량은 18개월 동안 250개의 관리 클러스터와 관리 허브당 50개의 정책이 포함된 3개의 관리 허브를 저장할 수 있습니다. multicluster-global-hub 네임스페이스에 multicluster-global-hub-storage 라는 시크릿을 생성해야 합니다. 보안에는 다음 필드가 포함되어야 합니다.

oc create secret generic multicluster-global-hub-storage -n multicluster-global-hub \
    --from-literal=database_uri=<postgresql-uri> \
    --from-literal=database_uri_with_readonlyuser=<postgresql-uri-with-readonlyuser> \
    --from-file=ca.crt=<CA-for-postgres-server>

호스트는 multicluster 글로벌 허브 클러스터에서 액세스할 수 있어야 합니다. PostgreSQL 데이터베이스가 Kubernetes 클러스터에 있는 경우 nodePort 또는 LoadBalancer 와 함께 서비스 유형을 사용하여 데이터베이스를 노출하는 것이 좋습니다. 자세한 내용은 문제 해결을 위해 프로비저닝된 postgres 데이터베이스 액세스를 참조하십시오.

기존 Grafana 인스턴스를 사용하면 자체 Grafana에 의존하는 경우 다양한 클러스터에서 Prometheus와 같은 여러 소스의 지표를 가져오고 메트릭을 직접 집계하는 경우 다중 클러스터 글로벌 허브에서 작동할 수 있습니다. 다중 클러스터 글로벌 허브 데이터를 자체 Grafana로 가져오려면 데이터 소스를 구성하고 대시보드를 가져와야 합니다.

시크릿에서 ca.crt 인증서를 추출하는 방법에 대한 자세한 내용은 STRIMZI 설명서의 사용자 인증을 참조하십시오.

시크릿에서 user.crt 인증서를 추출하는 단계는 STRIMZI 설명서의 사용자 인증을 참조하십시오.

local-cluster 가 활성화된 기존 관리 허브 클러스터를 가져오려면 호스팅 모드를 사용해야 합니다. 호스팅 모드에서는 kubeconfig 파일을 사용하는 가져온 관리 허브 클러스터만 지원합니다. Kubernetes용 Red Hat Advanced Cluster Management는 이 kubeconfig 파일을 사용하여 관리 허브 클러스터에 연결하는 auto-import-secret 을 생성합니다.

참고:

다음 단계를 완료합니다.

이 주석을 사용하면 다중 클러스터 글로벌 허브가 다음 작업을 수행합니다.

글로벌 허브 Grafana 데이터에 액세스한 후 관리하는 허브 클러스터 환경을 통해 구성된 정책을 모니터링할 수 있습니다.

다중 클러스터 글로벌 허브 대시보드에서 선택한 기간 동안 시스템 정책의 규정 준수 상태를 확인할 수 있습니다. 정책 규정 준수 상태는 매일 업데이트되므로 대시보드에 다음 날까지 현재 날짜의 상태가 표시되지 않습니다.

다중 클러스터 글로벌 허브 대시보드를 탐색하려면 정책 또는 클러스터 별로 정책 데이터를 그룹화하여 정책 데이터를 관찰하고 필터링할 수 있습니다.

정책 그룹화를 사용하여 정책 데이터를 검사하려면 와 Global Hub - 정책 그룹 호환 개요 라는 대시보드에서 시작합니다.

이 대시보드를 사용하면 표준,범주 및 제어에 따라 정책 데이터를 필터링할 수 있습니다. 그래프에서 특정 시점을 선택하면 Global Hub - Offending Policies 대시보드로 이동합니다. 글로벌 허브 - 정책 오프로드 대시보드에는 해당 시점에 호환되지 않거나 알 수 없는 정책이 나열됩니다. 대상 정책을 선택한 후 관련 이벤트를 보고 글로벌 허브 - What's Changed / Policies 대시보드에 액세스하여 변경된 사항을 확인할 수 있습니다.

마찬가지로 클러스터 그룹화로 정책 데이터를 검사하려면 Global Hub - Cluster Group Compliancy Overview 대시보드를 사용하여 시작합니다. 탐색 흐름은 정책 그룹화 흐름과 동일하지만 관리 클러스터 레이블 및 값 과 같이 클러스터와 관련된 필터를 선택합니다. 글로벌 허브 에 도달한 후 모든 클러스터에 대한 정책 이벤트를 보는 대신 개별 클러스터와 관련된 정책 이벤트를 볼 수 있습니다.

Kafka 배포 및 Postgres 데이터베이스의 상태 및 성능을 이해하려면 메트릭을 수집합니다. 메트릭을 확인할 때 중요한 문제가 되기 전에 문제를 식별하고 리소스 할당 및 용량 계획에 대해 정보에 입각한 결정을 내릴 수 있습니다. 메트릭을 수집하고 확인하지 않으면 Kafka 배포 동작에 대한 가시성이 제한되어 문제 해결을 더 어렵게 만들 수 있습니다.

다중 클러스터 글로벌 허브 Grafana에서 대시보드 및 해당 메트릭을 확인할 수 있습니다. Strimzi 폴더에서는 다음 대시보드를 볼 수 있습니다.

Postgres 구성의 상태 및 성능을 이해하려면 Grafana 대시보드에서 Postgres 메트릭을 수집하고 확인합니다. Postgres 폴더에서 다음 대시보드를 볼 수 있습니다.

관리 클러스터를 필터링하고 세부 정보 및 이벤트를 보려면 Grafana 대시보드를 사용합니다. Grafana 대시보드를 사용하면 hub,labels 및 name 을 기반으로 관리 클러스터를 필터링할 수 있습니다. 또한 hub,status,cloud, version 에 따라 관리형 클러스터의 배포를 볼 수 있습니다.

클러스터 폴더에서 다음 대시보드를 볼 수 있습니다.

기본 Grafana 경고 규칙이 유용한 정보를 제공하지 않으면 multicluster-global-hub-custom-alerting 구성 맵에 deleteRules 섹션을 포함하여 Grafana 경고 규칙을 삭제할 수 있습니다. multicluster-global-hub-custom- alerting 구성 맵에 대한 자세한 내용은 Grafana 경고 리소스 사용자 지정을 참조하십시오.

기본 경고를 모두 삭제하려면 deleteRules 구성 섹션은 다음 예와 유사해야 합니다.

    deleteRules:
      - orgId: 1
        uid: globalhub_suspicious_policy_change
      - orgId: 1
        uid: globalhub_cluster_compliance_status_change_frequently
      - orgId: 1
        uid: globalhub_high_number_of_policy_events
      - orgId: 1
        uid: globalhub_data_retention_job
      - orgId: 1
        uid: globalhub_local_compliance_job

다중 클러스터 글로벌 허브는 사용자 정의 Grafana 경고 생성을 지원합니다. Grafana 경고를 사용자 지정하려면 다음 단계를 완료합니다.

apiVersion: v1
kind: Secret
metadata:
  name: multicluster-global-hub-custom-grafana-config
  namespace: multicluster-global-hub
type: Opaque
stringData:
  grafana.ini: |
    [smtp]
    enabled = true
    host = smtp.google.com:465
    user = <example@google.com>
    password = <password>
    ;cert_file =
    ;key_file =
    skip_verify = true
    from_address = <example@google.com>
    from_name = Grafana
    ;ehlo_identity = dashboard.example.com 1

apiVersion: v1
data:
  alerting.yaml: |
    contactPoints:
      - orgId: 1
        name: globalhub_policy
        receivers:
          - uid: globalhub_policy_alert_email
            type: email
            settings:
              addresses: <example@redhat.com>
              singleEmail: false
          - uid: globalhub_policy_alert_slack
            type: slack
            settings:
              url: <Slack-webhook-URL>
              title: |
                {{ template "globalhub.policy.title" . }}
              text: |
                {{ template "globalhub.policy.message" . }}
    policies:
      - orgId: 1
        receiver: globalhub_policy
        group_by: ['grafana_folder', 'alertname']
        matchers:
          - grafana_folder = Policy
        repeat_interval: 1d
    deleteRules:
      - orgId: 1
        uid: [Alert Rule Uid]
    muteTimes:
      - orgId: 1
        name: mti_1
        time_intervals:
          - times:
              - start_time: '06:00'
                end_time: '23:59'
                location: 'UTC'
            weekdays: ['monday:wednesday', 'saturday', 'sunday']
            months: ['1:3', 'may:august', 'december']
            years: ['2020:2022', '2030']
            days_of_month: ['1:5', '-3:-1']
kind: ConfigMap
metadata:
  name: multicluster-global-hub-custom-alerting
  namespace: multicluster-global-hub

다중 클러스터 글로벌 허브 클러스터를 복원해야하는 경우 새 허브 클러스터 준비를 참조하십시오. 다중 클러스터 글로벌 허브 Operator를 설치하지만 CR이 자동으로 복원되므로 다중 클러스터 글로벌 허브 CR(사용자 정의 리소스)을 생성하지 않습니다.

다중 클러스터 글로벌 허브를 활성화해야 합니다.

글로벌 검색을 활성화하려면 다음 명령을 실행하여 global-search-preview=true 주석을 search-v2-operator 리소스에 추가합니다.

oc annotate search search-v2-operator -n open-cluster-management global-search-preview=true

검색 Operator는 다음 상태 조건으로 업데이트됩니다.

status:
  conditions:
    - lastTransitionTime: '2024-05-31T19:49:37Z'
      message: None
      reason: None
      status: 'True'
      type: GlobalSearchReady