多集群全局 hub

multicluster global hub operator 包含 multicluster global hub 的组件。Operator 为全局多集群管理部署所有所需的组件。组件包括 multicluster-global-hub-manager、multicluster-global-hub-grafana、在 multicluster global hub 集群中提供 Kafka 和 PostgreSQL 版本，以及受管 hub 集群中的 multicluster-global-hub-agent。

Operator 还利用 manifestwork 自定义资源在受管集群中部署 Red Hat Advanced Cluster Management for Kubernetes Operator。在受管集群中部署了 Red Hat Advanced Cluster Management Operator 后，受管集群将变为标准 Red Hat Advanced Cluster Management 集群。这个 hub 集群现在是一个受管 hub 集群。

multicluster global hub Manager 用于将数据保存到 postgreSQL 数据库中。数据来自 Kafka 传输。管理器还会将数据发布到 Kafka 传输，以便它可以与受管 hub 集群上的数据同步。

multicluster global hub 代理在受管 hub 集群上运行。它同步多集群全局 hub 集群和受管 hub 集群之间的数据。例如，代理将受管集群的信息从受管集群同步到 multicluster global hub 集群，并将策略或应用程序从 multicluster global hub 集群同步到受管 hub 集群。

Grafana 在 multicluster global hub 集群上运行，作为多集群全局 hub 视觉化的主要服务。Global Hub Manager 收集的 PostgreSQL 数据是其默认 DataSource。通过使用名为 multicluster-global-hub-grafana 的路由公开服务，您可以通过访问控制台来访问多集群全局 hub Grafana 仪表板。

请参阅以下网络要求：

请参阅以下支持的组件：

您必须在断开连接的环境中安装多集群全局 hub 前满足以下要求：

在断开连接的环境中安装多集群全局 hub 涉及使用本地镜像 registry。此时，假设您已在 OpenShift Container Platform 集群安装过程中设置了镜像 registry。

完成以下步骤，为多集群全局 hub 置备镜像 registry：

要让集群从本地镜像 registry 获取 multicluster global hub Operator 的容器镜像，而不是从互联网托管的 registry 中配置 ImageContentSourcePolicy 资源，以便在断开连接的环境中配置 ImageContentSourcePolicy 资源，将镜像引用重定向到您的镜像 registry。ImageContentSourcePolicy 仅支持带有 镜像摘要 的镜像镜像。

如果使用 oc adm catalog mirror 命令镜像目录，所需镜像内容源策略配置位于由该命令创建的 manifests- 目录中的 imageContentSourcePolicy.yaml 文件中。

如果您使用 oc-mirror 插件替代您的目录，则 imageContentSourcePolicy.yaml 文件位于 oc-mirror-workspace/results- 目录中。

在这两种情况下，您可以使用 oc apply 或 oc replace 命令将策略应用到断开连接的命令中，如 oc replace -f ./<path>/imageContentSourcePolicy.yaml

所需的镜像内容源策略语句会根据您创建镜像 registry 的方式而有所不同，但与以下示例类似：

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

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 为不同的受管 hub 配置不同的镜像 registry。请参阅 导入具有 ManagedClusterImageRegistry API 的集群，以使用 ManagedClusterImageRegistry API 替换代理镜像。

通过完成上一步，标签和注解会添加到所选的 ManagedCluster 中。这意味着集群中的代理镜像被镜像镜像替代。

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

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

如果您有自己的 Kafka 实例，您可以使用它作为多集群全局 hub 的传输。Kafka 3.3 是经过测试的版本。完成以下步骤以集成 Kafka 实例：

如果您有自己的 PostgreSQL 关系数据库，您可以使用它作为多集群全局 hub 的存储。PostgreSQL 13 是经过测试的版本。

要求的最小存储大小为 20GB。这个数量可以存储 3 个受管集群，每个受管 hub 有 250 个受管集群和 50 个策略(18 个月)。您需要在 multicluster-global-hub 命名空间中创建一个名为 multicluster-global-hub-storage 的 secret。secret 必须包含以下字段：

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>

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>

主机必须可从多集群全局 hub 集群访问。如果您的 PostgreSQL 数据库位于 Kubernetes 集群中，您可以考虑使用带有 nodePort 或 LoadBalancer 的服务类型来公开数据库。如需更多信息，请参阅 访问置备的 postgres 数据库以进行故障排除。

如果您依赖您自己的 Grafana 从多个源（如 Prometheus）从不同的集群获取指标，并使用现有 Grafana 实例使用多集群全局 hub。要将多集群全局 hub 数据纳入您自己的 Grafana 中，您需要配置数据源并导入仪表板。

如需有关如何从 secret 中提取 ca.crt 证书的更多信息，请参阅 STRIMZI 文档中的 用户身份验证。

有关从 secret 中提取 user.crt 证书的步骤，请参阅 STRIMZI 文档中的 用户身份验证。

访问全局 hub Grafana 数据后，您可以监控通过管理的 hub 集群环境配置的策略。

在多集群全局 hub 仪表板中，您可以通过所选时间范围识别系统的策略的合规性状态。策略合规状态会每日更新，因此仪表板不会在后续日前显示当前日期的状态。

要浏览 multicluster global hub 仪表板，您可以通过根据策略或集群进行分组来观察和过滤 策略 数据。

如果要使用策略分组检查策略数据，请从 和名为 Global Hub - Policy Group Compliancy Overview 的仪表板开始。

此仪表板允许您根据 标准、类别 和 控制 过滤策略数据。在图中选择了一个特定的时间后，您会被定向到 Global Hub - Offending Policies 仪表板。Global Hub - Offending Policies 仪表板列出不合规或未知策略。选择目标策略后，您可以通过访问 Global Hub - 什么是 Changed / Policies 仪表板来查看相关的事件并查看已更改的事件。

同样，如果要通过 集群 分组检查策略数据，请从 Global Hub - Cluster Group Compliancy Overview 仪表板开始。导航流 与策略 分组流相同，但您可以选择与集群相关的过滤器，如受管集群 标签和 值。在到达 Global Hub - 什么是 Changed / Clusters 仪表板后，而不是查看所有集群的策略事件，您可以查看与单个集群相关的策略事件。

要了解 Kafka 部署和 Postgres 数据库的健康状态和性能，请收集其指标。在检查指标时，您可以在问题变得关键前识别问题，并对资源分配和容量规划做出明智的决策。如果没有收集并检查指标，您可能对 Kafka 部署的行为有有限的可见性，从而进行故障排除。

您可以在 multicluster global hub Grafana 中检查仪表板及其指标。在 Strimzi 文件夹中，您可以查看以下仪表板：

要了解 Postgres 配置的健康状态和性能，请在 Grafana 仪表板中收集并检查 Postgres 指标。在 Postgres 文件夹中，您可以查看以下仪表板：

要过滤受管集群并查看其详情和事件，请使用 Grafana 仪表板。使用 Grafana 仪表板，您可以根据以下 hub、标签和 名称过滤 受管集群。另外，您还可以根据以下方法查看受管集群的分布： hub、状态、云 和版本。

在 Cluster 文件夹中，您可以查看以下仪表板：

如果默认 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

    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

multicluster global hub 支持创建自定义 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 

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 

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

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

如果需要恢复多集群全局 hub 集群，请参阅准备 新的 hub 集群。安装 multicluster global hub operator，但不创建 multicluster global hub 自定义资源(CR)，因为 CR 会自动恢复。

要启用全局搜索，请运行以下命令在 search-v2-operator 资源中添加 global-search-preview=true 注解：

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

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

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