1.18. 发现服务简介

您可以发现 OpenShift Cluster Manager 可用的 OpenShift 4 集群。发现后，您可以导入集群进行管理。发现服务使用 Discover Operator 进行后端和控制台使用。

您必须具有 OpenShift Cluster Manager 凭据。如果需要创建凭证，请参阅为 Red Hat OpenShift Cluster Manager 创建凭证。

需要的访问权限：Administrator

1.18.1. 使用控制台配置发现

使用产品控制台启用发现。

需要的访问权限：访问创建凭证的命名空间。

1.18.1.1. 先决条件

您需要一个凭证。请参阅为 Red Hat OpenShift Cluster Manager 创建凭证以连接到 OpenShift Cluster Manager。

1.18.1.2. 配置发现

在控制台中配置 Discovery 以查找集群。您可以使用单独的凭证创建多个 DiscoveryConfig 资源。按照控制台中的说明操作。

1.18.1.3. 查看发现的集群

在设置凭证并发现集群以导入后，您可以在控制台中查看它们。

点 Clusters > Discovered cluster
使用以下信息查看填充的表：
- Name 是 OpenShift Cluster Manager 中指定的显示名称。如果集群没有显示名称，则会显示基于集群控制台 URL 生成的名称。如果 OpenShift Cluster Manager 缺少控制台URL，或手动修改了控制台 URL，则会显示集群外部 ID。
- Namespace 是您创建凭证和发现集群的命名空间。
- Type 是发现的集群 Red Hat OpenShift 类型。
- Distribution version 是发现的集群 Red Hat OpenShift 版本。
- 基础架构供应商是已发现集群的云供应商。
- 最后活跃是发现的集群最后一次活跃的时间。
- 当发现的集群被创建时为 Created 。
- 当发现的集群被发现时为 Discovered。
您还可以搜索表中的任何信息。例如，要只显示特定命名空间中的发现集群，请搜索该命名空间。
现在，您可以点 Import cluster 创建受管集群。请参阅导入发现的集群。

1.18.1.4. 导入发现的集群

发现集群后，您可以导入控制台的 Discovered clusters 选项卡中出现的集群。

1.18.1.5. 先决条件

您需要访问用于配置 Discovery 的命名空间。

1.18.1.6. 导入发现的集群

进入到现有 Clusters 页面并点 Discovered clusters 选项卡。
在发现的集群表中找到您要导入的集群。
在选项菜单中选择 Import cluster。
对于发现的集群，您可以使用文档手动导入，或者您可以自动选择导入集群。
要使用凭证或 Kubeconfig 文件自动导入，请复制并粘贴内容。
点 Import。

1.18.2. 使用 CLI 启用发现

使用 CLI 启用发现以查找 Red Hat OpenShift Cluster Manager 可用的集群。

需要的访问权限：Administrator

1.18.2.1. 先决条件

创建用于连接到 Red Hat OpenShift Cluster Manager 的凭证。

1.18.2.2. 发现设置和进程

注： DiscoveryConfig 必须命名为 discovery，且必须与所选凭证在同一命名空间中创建。请参见以下 DiscoveryConfig 示例：

apiVersion: discovery.open-cluster-management.io/v1
kind: DiscoveryConfig
metadata:
  name: discovery
  namespace: <NAMESPACE_NAME>
spec:
  credential: <SECRET_NAME>
  filters:
    lastActive: 7
    openshiftVersions:
    - "4.10"
    - "4.9"
    - "4.8"

将 SECRET_NAME 替换为之前设置的凭证。
将 NAMESPACE_NAME 替换为 SECRET_NAME 的命名空间。
输入集群最后一次活动（以天为单位）进行发现的最大时间。例如，带有 lastActive: 7 的集群，最后 7 天内活跃的集群会被发现。
输入要作为字符串列表发现的 Red Hat OpenShift 集群的版本。注： openshiftVersions 列表中的每个条目都指定了一个 OpenShift 主版本和次版本。例如，指定 "4.9" 将包括 OpenShift 版本 4.9 的所有补丁版本，如 4.9.1、4.9.2。

1.18.2.3. 查看发现的集群

通过运行 oc get discoveredclusters -n <namespace>（其中 namespace 是发现凭证存在的命名空间）来查看发现的集群。

1.18.2.3.1. DiscoveredClusters

对象由 Discovery 控制器创建。这些 DiscoveredClusters 使用在 DiscoveryConfig discoveredclusters.discovery.open-cluster-management.io API 中指定的过滤器和凭证来代表 OpenShift Cluster Manager 中找到的集群。name 的值是集群外部 ID：

apiVersion: discovery.open-cluster-management.io/v1
kind: DiscoveredCluster
metadata:
  name: fd51aafa-95a8-41f7-a992-6fb95eed3c8e
  namespace: <NAMESPACE_NAME>
spec:
  activity_timestamp: "2021-04-19T21:06:14Z"
  cloudProvider: vsphere
  console: https://console-openshift-console.apps.qe1-vmware-pkt.dev02.red-chesterfield.com
  creation_timestamp: "2021-04-19T16:29:53Z"
  credential:
    apiVersion: v1
    kind: Secret
    name: <SECRET_NAME>
    namespace: <NAMESPACE_NAME>
  display_name: qe1-vmware-pkt.dev02.red-chesterfield.com
  name: fd51aafa-95a8-41f7-a992-6fb95eed3c8e
  openshiftVersion: 4.10
  status: Stale