1.7. 将目标受管集群导入到 hub 集群

如果要将其添加到现有集群集 中，请指定 Cluster set，则指定具有 cluster-admin 权限的现有集群集。如果在创建集群时没有 cluster-admin 权限，则必须选择一个具有 clusterset-admin 权限的集群集。如果您在指定的集群集中没有正确的权限，集群创建会失败。如果没有要选择的集群设置选项，请联系集群管理员，为集群集提供 clusterset-admin 权限。

每个受管集群都必须与受管集群集关联。如果您没有将受管集群分配给 ManagedClusterSet，则会自动添加到 default 受管集群集中。

可选： 添加任何 附加标签。

注： 如果您导入 Red Hat OpenShift Dedicated 集群，且没有添加 vendor=OpenShiftDedicated 标签指定一个厂商，或者添加了 vendor=auto-detect 标签，则 managed-by=platform 标签会自动添加到集群中。您可以使用此添加标签将集群标识为一个 Red Hat OpenShift Dedicated 集群，并作为一个组来获取 Red Hat OpenShift Dedicated 集群。

选择您要用来标识从以下选项导入的集群的导入模式 ：

可选： 在集群详情页中配置 Cluster API address，它为运行 oc get managedcluster 命令时在表中显示的 URL。

运行以下命令登录到您的 hub 集群 ：

oc login

在 hub 集群中运行以下命令以创建项目和命名空间： 请注意： CLUSTER_NAME 中定义的集群名称也用作 YAML 文件和命令中的集群命名空间：

oc new-project ${CLUSTER_NAME}

重要： cluster.open-cluster-management.io/managedCluster 标签会自动添加到受管集群命名空间中并从中删除。不要手动将其添加到受管集群或从受管集群中删除。

使用以下示例内容，创建一个名为 managed-cluster.yaml 的文件：

apiVersion: cluster.open-cluster-management.io/v1
kind: ManagedCluster
metadata:
  name: ${CLUSTER_NAME}
  labels:
    cloud: auto-detect
    vendor: auto-detect
spec:
  hubAcceptsClient: true

当 cloud 和 vendor 的值被设置为 auto-detect 时，Red Hat Advanced Cluster Management 会检测您要导入的集群的云和厂商类型。您可以选择将 auto-detect 的值替换为集群的 cloud 和 vendor 值。请参见以下示例：

cloud: Amazon
vendor: OpenShift

输入以下命令将 YAML 文件应用到 ManagedCluster 资源：

oc apply -f managed-cluster.yaml

在 ${CLUSTER_NAME} 命名空间中创建 auto-import-secret.yaml 文件。

oc -n <cluster_name> annotate secrets auto-import-secret managedcluster-import-controller.open-cluster-management.io/keeping-auto-import-secret=""

验证您的导入集群的 JOINED 和 AVAILABLE 状态。在 hub 集群中运行以下命令：

oc get managedcluster ${CLUSTER_NAME}

在受管集群中运行以下命令来登录到受管集群：

oc login

运行以下命令，以验证您要导入的集群中的 pod 状态：

oc get pod -n open-cluster-management-agent

运行以下命令，获取由导入控制器在 hub 集群上生成的 klusterlet-crd.yaml 文件：

oc get secret ${CLUSTER_NAME}-import -n ${CLUSTER_NAME} -o jsonpath={.data.crds\\.yaml} | base64 --decode > klusterlet-crd.yaml

运行以下命令，获取导入控制器在 hub 集群上生成的 import.yaml 文件：

oc get secret ${CLUSTER_NAME}-import -n ${CLUSTER_NAME} -o jsonpath={.data.import\\.yaml} | base64 --decode > import.yaml

在要导入的集群中执行以下步骤：

输入以下命令登录到您导入的受管集群：

oc login

运行以下命令应用您在第 1 步中生成的 klusterlet-crd.yaml ：

oc apply -f klusterlet-crd.yaml

运行以下命令应用您之前生成的 import.yaml 文件：

oc apply -f import.yaml

验证您要导入的集群的 JOINED 和 AVAILABLE 状态。在 hub 集群中运行以下命令：

oc get managedcluster ${CLUSTER_NAME}

创建一个类似以下示例的 YAML 文件：

apiVersion: agent.open-cluster-management.io/v1
kind: KlusterletAddonConfig
metadata:
  name: <cluster_name>
  namespace: <cluster_name>
spec:
  applicationManager:
    enabled: true
  certPolicyController:
    enabled: true
  iamPolicyController:
    enabled: true
  policyController:
    enabled: true
  searchCollector:
    enabled: true

运行以下命令来应用 YAML：

oc apply -f klusterlet-addon-config.yaml

ManagedCluster-Import-Controller 将生成一个名为 ${CLUSTER_NAME}-import 的 secret。${CLUSTER_NAME}-import secret 包括 import.yaml，用户会把它应用到一个受管集群来安装 klusterlet.

附加组件安装在您导入的集群后为 AVAILABLE。

运行以下命令，验证您要导入的集群上附加组件的 pod 状态：

oc get pod -n open-cluster-management-agent-addon

在您要导入集群的命名空间中创建 pull secret。对于这些步骤，是 myNamespace。

$ kubectl create secret docker-registry myPullSecret \
  --docker-server=<your-registry-server> \
  --docker-username=<my-name> \
  --docker-password=<my-password>

在您创建的命名空间中创建一个放置。

apiVersion: cluster.open-cluster-management.io/v1beta1
kind: Placement
metadata:
  name: myPlacement
  namespace: myNamespace
spec:
  clusterSets:
  - myClusterSet
  tolerations:
  - key: "cluster.open-cluster-management.io/unreachable"
    operator: Exists

注： 需要 unreachable 容限才能使配置来选择集群。

创建一个 ManagedClusterSet 资源，并将其绑定到命名空间。

apiVersion: cluster.open-cluster-management.io/v1beta1
kind: ManagedClusterSet
metadata:
  name: myClusterSet

---
apiVersion: cluster.open-cluster-management.io/v1beta1
kind: ManagedClusterSetBinding
metadata:
  name: myClusterSet
  namespace: myNamespace
spec:
  clusterSet: myClusterSet

在命名空间中创建 ManagedClusterImageRegistry CRD。

apiVersion: imageregistry.open-cluster-management.io/v1alpha1
kind: ManagedClusterImageRegistry
metadata:
  name: myImageRegistry
  namespace: myNamespace
spec:
  placementRef:
    group: cluster.open-cluster-management.io
    resource: placements
    name: myPlacement
  pullSecret:
    name: myPullSecret
  registry: myRegistryAddress

输入以下命令以编辑资源：

kubectl edit klusterletaddonconfigs.agent.open-cluster-management.io <cluster-name> -n <cluster-name>