将 spec: pathname 更改为访问已分叉的仓库的 GitHub 名称，而不是 open-cluster-management，由此来更新 ./subscription/channel.yaml 文件。此步骤指定 hub 集群在哪里检索发行镜像。您更新的内容应类似以下示例：

spec:
  type: GitHub
  pathname: https://github.com/<forked_content>/acm-hive-openshift-releases.git

将 forked_content 替换为已分叉仓库的路径。

在克隆了 acm-hive-openshift-releases 仓库后，使用以下命令来更新 stable 镜像以同步 stable 发行镜像列表：

make subscribe-stable

备注：您只能在使用 Linux 或者 MacOS 操作系统时运行这个 make 命令。如果使用 Windows 操作系统，输入以下命令：

oc apply -k subscription/
oc delete -f subscription/subscription-fast.yaml
oc apply -f subscription/subscription-stable.yaml

运行此命令后，可用稳定镜像列表会在约一分钟内更新为当前可用镜像。

默认情况下，仅会列出稳定镜像。要同步并显示快速发行镜像，请输入以下命令：

make subscribe-fast

备注：您只能在使用 Linux 或者 MacOS 操作系统时运行这个 make 命令。如果使用 Windows 操作系统，输入以下命令：

oc apply -k subscription/
oc apply -f subscription/subscription-fast.yaml

运行此命令后，可用快速镜像列表会在约 1 分钟内更新为当前可用镜像。

默认情况下，Red Hat Advanced Cluster Management 会预加载几个 ClusterImageSets。使用以下命令列出可用内容并删除默认值（如果需要）。

oc get clusterImageSets
oc delete clusterImageSet <clusterImageSet_NAME>

创建 clusterImageSets 命令：

oc create -f <clusterImageSet_FILE>

在为您要添加的每个资源运行此命令后，可用发行镜像列表将变为可用。

在 Clusters 页面上，选择 Provider connections 选项卡。

此时会显示现有供应商连接。

从列表中为您的供应商连接选择一个命名空间。

提示：为方便起见，同时为了提高安全性，创建一个命名空间，专门用于托管您的供应商连接。

在 Clusters 页面上，选择 Provider connections 选项卡。

此时会显示现有供应商连接。

从列表中为您的供应商连接选择一个命名空间。

提示：为方便起见，同时为了提高安全性，您可以创建一个命名空间，专门用于托管您的供应商连接。

添加您的客户端 ID。当您使用以下命令创建服务主体时，这个值作为 appId 属性被生成：

az ad sp create-for-rbac --role Contributor --name <service_principal>

将 service_principal 替换为您的服务主体名。

添加您的 客户端 Secret。当您使用以下命令创建服务主体时，这个值作为 password 属性被生成：

az ad sp create-for-rbac --role Contributor --name <service_principal>

将 service_principal 替换为您的服务主体名。

添加您的 订阅 ID。这个值是以下命令输出中的 id 属性：

az account show

添加您的租户 ID。这个值是以下命令输出中的 tenantId 属性：

az account show

在 Clusters 页面上，选择 Provider connections 选项卡。

此时会显示现有供应商连接。

从列表中为您的供应商连接选择一个命名空间。

提示：为方便和安全起见，创建一个命名空间，专门用于托管您的供应商连接。

添加 Google Cloud Platform 服务帐户 JSON 密钥。完成以下步骤创建带有正确权限的服务帐户：

在 Clusters 页面上，选择 Provider connections 选项卡。

此时会显示现有供应商连接。

从列表中为您的供应商连接选择一个命名空间。

提示：为方便起见，同时为了提高安全性，创建一个命名空间，专门用于托管您的供应商连接。

添加 VMware vCenter root CA 证书。

在 Clusters 页面上，选择 Provider connections 选项卡。

此时会显示现有供应商连接。

从列表中为您的供应商连接选择一个命名空间。

提示：为方便起见，同时为了提高安全性，创建一个命名空间，专门用于托管您的供应商连接。

只适用于断开连接的安装：使用所需信息，为断开连接的安装完成配置 部分中的字段：

选择 Create a cluster。

备注：此过程用于创建集群。如果您有一个要导入的现有集群，请参阅将目标受管集群导入到 hub 集群以了解这些步骤。

为集群输入一个名称。此名称用于集群的主机名。

提示：要在您在控制台中输入信息时查看 yaml 内容更新，可将 YAML 开关设置为 ON。

为集群配置节点池。

节点池定义用于集群的节点的位置和大小。

区域指定节点所处的地理位置。距离更近的区域可能会提供更快的性能，但距离更远的区域可能更为分散。

点 Create。在创建和导入过程完成后，您可以查看您的集群详情。

备注：您不必运行 kubectl 命令，它为导入集群提供集群的详情。当创建集群时，它由 Red Hat Advanced Cluster Management for Kubernetes 管理自动配置。

为您要访问的集群选择 Actions > Launch to cluster。

提示：如果知道登录凭证，可以通过为您要访问的集群选择 Actions > Launch to cluster 来访问集群。

选择 Create a cluster。

备注：此过程用于创建集群。如果您有一个要导入的现有集群，请参阅将目标受管集群导入到 hub 集群以了解这些步骤。

为集群输入一个名称。此名称用于集群的主机名。

提示：要在您在控制台中输入信息时查看 yaml 内容更新，可将 YAML 开关设置为 ON。

为集群配置节点池。

节点池定义用于集群的节点的位置和大小。

区域指定节点所处的地理位置。距离更近的区域可能会提供更快的性能，但距离更远的区域可能更为分散。

点 Create。在创建和导入过程完成后，您可以查看您的集群详情。

备注：您不必运行 kubectl 命令，它为导入集群提供集群的详情。当创建集群时，它由 Red Hat Advanced Cluster Management for Kubernetes 管理自动配置。

为您要访问的集群选择 Actions > Launch to cluster。

提示：如果知道登录凭证，可以通过为您要访问的集群选择 Actions > Launch to cluster 来访问集群。

选择 Create a cluster。

备注：此过程用于创建集群。如果您有一个要导入的现有集群，请参阅将目标受管集群导入到 hub 集群以了解这些步骤。

为集群输入一个名称。在命名 GCP 集群时有一些限制。这些限制包括，名称不要以 goog 开始；名称的任何部分都不要包含与 google 类似的内容。如需了解完整的限制列表，请参阅 Bucket 命名指南。

此名称用于集群的主机名。

提示：要在您在控制台中输入信息时查看 yaml 内容更新，可将 YAML 开关设置为 ON。

为集群配置节点池。

节点池定义用于集群的节点的位置和大小。

区域指定节点所处的地理位置。距离更近的区域可能会提供更快的性能，但距离更远的区域可能更为分散。

为您要访问的集群选择 Actions > Launch to cluster。

提示：如果知道登录凭证，可以通过为您要访问的集群选择 Actions > Launch to cluster 来访问集群。

选择 Create a cluster。

备注：此过程用于创建集群。如果您有一个要导入的现有集群，请参阅将目标受管集群导入到 hub 集群以了解这些步骤。

为集群输入一个名称。此名称用于集群的主机名。

备注：这个值必须与创建供应商连接先决条件中列出的 DNS 记录的名称匹配。

提示：要在您在控制台中输入信息时查看 yaml 内容更新，可将 YAML 开关设置为 ON。

为集群配置节点池。

节点池定义用于集群的节点的位置和大小。

您可以在 worker 池中创建一个或多个 worker 节点，以运行集群的容器工作负载。它们可以位于单个 worker 池中，也可以分布在多个 worker 池中。

配置集群网络选项，如下所示：

点 Create。在创建和导入过程完成后，您可以查看您的集群详情。

备注：当您创建集群时，它由 Red Hat Advanced Cluster Management 管理自动配置。您不必运行 kubectl 命令，它为导入集群提供集群的详情。

如果您不知道登录凭证

为您要访问的集群选择 Actions > Launch to cluster。

提示：如果知道登录凭证，可以通过为您要访问的集群选择 Actions > Launch to cluster 来访问集群。

选择 Create a cluster。

备注：此过程用于创建集群。如果您有一个要导入的现有集群，请参阅将目标受管集群导入到 hub 集群以了解这些步骤。

为集群输入一个名称。对于裸机集群，此名称不能是一个任意名称。它与集群 URL 相关联。确保使用的集群名称与您的 DNS 和网络设置一致。

提示：要在您在控制台中输入信息时查看 yaml 内容更新，可将 YAML 开关设置为 ON。

配置集群网络选项。

点 Create。在创建和导入过程完成后，您可以查看您的集群详情。

备注：您不必运行 kubectl 命令，它为导入集群提供集群的详情。当创建集群时，它由 Red Hat Advanced Cluster Management for Kubernetes 管理自动配置。

为您要访问的集群选择 Actions > Launch to cluster。

提示：如果知道登录凭证，可以通过为您要访问的集群选择 Actions > Launch to cluster 来访问集群。

可选：点击以展开 Edit cluster import YAML 文件，并修改端点配置。

请参阅 表 1.YAML 文件参数和描述，了解有关每个参数的详情。

可选 ：配置 MANAGED CLUSTER URLS。通过配置 MANAGED CLUSTER URLS，运行 oc get managedcluster 命令时显示的 URL 会在表中显示。

在终端中，向受管集群进行身份验证。为目标受管集群配置 kubectl。

请参阅支持的云了解如何配置 kubectl。

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

oc login

在 hub 集群上运行以下命令来创建命名空间。备注：<cluster_name> 中定义的集群名称也用作 .yaml 文件和命令中的集群命名空间：

oc new-project ${CLUSTER_NAME}
oc label namespace ${CLUSTER_NAME} cluster.open-cluster-management.io/managedCluster=${CLUSTER_NAME}

使用以下 YAML 示例编辑示例 ManagedCluster 集群：

apiVersion: cluster.open-cluster-management.io/v1
kind: ManagedCluster
metadata:
  name: <cluster_name>
spec:
  hubAcceptsClient: true

使用以下命令应用 YAML 文件：

oc apply -f managed-cluster.yaml

创建 klusterlet 插件配置文件。输入以下示例 YAML：

apiVersion: agent.open-cluster-management.io/v1
kind: KlusterletAddonConfig
metadata:
  name: <cluster_name>
  namespace: <cluster_name>
spec:
  clusterName: <cluster_name>
  clusterNamespace: <cluster_name>
  applicationManager:
    enabled: true
  certPolicyController:
    enabled: true
  clusterLabels:
    cloud: auto-detect
    vendor: auto-detect
  iamPolicyController:
    enabled: true
  policyController:
    enabled: true
  searchCollector:
    enabled: true
  version: 2.1.0

应用 YAML。运行以下命令：

oc apply -f klusterlet-addon-config.yaml

获取由受管集群导入控制器生成的 klusterlet-crd.yaml。

运行以下命令：

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

获取由受管集群控制器生成的 import.yaml。运行以下命令：

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

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

kubectl apply -f klusterlet-crd.yaml

应用在第 2 步中生成的 import.yaml 文件。运行以下命令：

kubectl apply -f import.yaml

验证目标受管集群上的 Pod 状态。运行以下命令：

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

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

kubectl get managedcluster ${CLUSTER_NAME}

在受管集群的状态为 AVAILABLE 后，会安装附加组件。验证目标受管集群上的附件组件的 Pod 状态。运行以下命令：

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

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

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

创建一个包含类似以下示例内容的脚本文件：

UPSTREAM_REGISTRY=quay.io
PRODUCT_REPO=openshift-release-dev
RELEASE_NAME=ocp-release
OCP_RELEASE=4.5.2-x86_64
LOCAL_REGISTRY=$(hostname):5000
LOCAL_SECRET_JSON=/path/to/pull/secret

oc adm -a ${LOCAL_SECRET_JSON} release mirror \
--from=${UPSTREAM_REGISTRY}/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE} \
--to=${LOCAL_REGISTRY}/ocp4 \
--to-release-image=${LOCAL_REGISTRY}/ocp4/release:${OCP_RELEASE}

将 /path/to/pull/secret 替换为 OpenShift Container Platform pull secret 的路径。

等待 Operator 的安装完成。

提示：您可以通过在 OpenShift Container Platform 命令行中输入 oc get pods 命令来检查安装的状态。验证 Operator 是否处于 running 状态。

输入以下命令克隆 graph data Git 存储库：

git clone https://github.com/openshift/cincinnati-graph-data

创建一个包含您的图形数据 init 信息的文件。您可以在 cincinnati-operator GitHub 仓库中找到此 Dockerfile 示例。该文件的内容在以下示例中显示：

FROM registry.access.redhat.com/ubi8/ubi:8.1

RUN curl -L -o cincinnati-graph-data.tar.gz https://github.com/openshift/cincinnati-graph-data/archive/master.tar.gz

RUN mkdir -p /var/lib/cincinnati/graph-data/

CMD exec /bin/bash -c "tar xvzf cincinnati-graph-data.tar.gz -C /var/lib/
cincinnati/graph-data/ --strip-components=1"

在本例中：

运行以下命令来构建 图形数据 init 容器:

podman build -f <path_to_Dockerfile> -t ${DISCONNECTED_REGISTRY}/cincinnati/cincinnati-graph-data-container:latest
podman push ${DISCONNECTED_REGISTRY}/cincinnati/cincinnati-graph-data-container:latest --authfile=/path/to/pull_secret.json

将 path_to_Dockerfile 替换为您在上一步中创建文件的路径。

将 ${DISCONNECTED_REGISTRY}/cincinnati/cincinnati-graph-data-container 替换为 graph data init 容器的路径。

将 /path/to/pull_secret 替换为 pull secret 文件的路径。

备注：如果没有安装 podman，您也可以将命令中的 podman 替换为 docker。

查找位于 image.config.openshift.io 的 OpenShift Container Platform 外部 registry API。这是存储外部 registry CA 证书的位置。

如需更多信息，请参阅 OpenShift Container Platform 文档中的 在 OpenShift Container Platform 中使用 Image Registry Operator。

在密钥 cincinnati-registry 中添加您的 CA 证书。OpenShift Update Service 使用此设置来定位您的证书：

apiVersion: v1
kind: ConfigMap
metadata:
  name: trusted-ca
data:
  cincinnati-registry: |
    -----BEGIN CERTIFICATE-----
    ...
    -----END CERTIFICATE-----

编辑 image.config.openshift.io API 中的 cluster 资源，将 additionalTrustedCA 字段设置为您创建的 ConfigMap 的名称。

oc patch image.config.openshift.io cluster -p '{"spec":{"additionalTrustedCA":{"name":"trusted-ca"}}}' --type merge

将 trusted-ca 替换为新 ConfigMap 的路径。

如果您不想使用 Operator 的默认命名空间（openshift-cincinnati）， 为 OpenShift Update Service 实例创建一个命名空间：

粘贴 OpenShift Update Service 实例中的内容。您的 YAML 实例可能类似以下清单：

apiVersion: cincinnati.openshift.io/v1beta1
kind: Cincinnati
metadata:
  name: openshift-update-service-instance
  namespace: openshift-cincinnati
spec:
  registry: <registry_host_name>:<port>
  replicas: 1
  repository: ${LOCAL_REGISTRY}/ocp4/release
  graphDataImage: '<host_name>:<port>/cincinnati-graph-data-container'

将 spec.registry 值替换为镜像的本地断开连接 registry 的路径。

将 spec.graphDataImage 值替换为图形数据 init 容器的路径。提示：这与您运行 podman push 命令来推送 图形数据 init 容器时使用的值相同。

将以下 YAML 内容粘贴到窗口以创建自定义策略：

apiVersion: policy.open-cluster-management.io/v1
kind: Policy
metadata:
  name: policy-pod
  namespace: default
  annotations:
    policy.open-cluster-management.io/standards:
    policy.open-cluster-management.io/categories:
    policy.open-cluster-management.io/controls:
spec:
  disabled: false
  policy-templates:
    - objectDefinition:
        apiVersion: policy.open-cluster-management.io/v1
        kind: ConfigurationPolicy
        metadata:
          name: policy-pod-sample-nginx-pod
        spec:
          object-templates:
            - complianceType: musthave
              objectDefinition:
                apiVersion: v1
                kind: Pod
                metadata:
                  name: sample-nginx-pod
                  namespace: default
                status:
                  phase: Running
          remediationAction: inform
          severity: low
  remediationAction: enforce
---
apiVersion: policy.open-cluster-management.io/v1
kind: PlacementBinding
metadata:
  name: binding-policy-pod
  namespace: default
placementRef:
  name: placement-policy-pod
  kind: PlacementRule
  apiGroup: apps.open-cluster-management.io
subjects:
- name: policy-pod
  kind: Policy
  apiGroup: policy.open-cluster-management.io
---
apiVersion: apps.open-cluster-management.io/v1
kind: PlacementRule
metadata:
  name: placement-policy-pod
  namespace: default
spec:
  clusterConditions:
  - status: "True"
    type: ManagedClusterConditionAvailable
  clusterSelector:
    matchExpressions:
      []  # selects all clusters if not specified

将模板 objectDefinition 部分中的内容替换为类似以下内容的内容，以添加 ImageContentSourcePolicy 的设置：

apiVersion: operator.openshift.io/v1alpha1
kind: ImageContentSourcePolicy
metadata:
  name: ImageContentSourcePolicy
spec:
  repositoryDigestMirrors:
  - mirrors:
    - <path-to-local-mirror>
    source: registry.redhat.io

将以下 YAML 内容粘贴到窗口以创建自定义策略：

apiVersion: policy.open-cluster-management.io/v1
kind: Policy
metadata:
  name: policy-pod
  namespace: default
  annotations:
    policy.open-cluster-management.io/standards:
    policy.open-cluster-management.io/categories:
    policy.open-cluster-management.io/controls:
spec:
  disabled: false
  policy-templates:
    - objectDefinition:
        apiVersion: policy.open-cluster-management.io/v1
        kind: ConfigurationPolicy
        metadata:
          name: policy-pod-sample-nginx-pod
        spec:
          object-templates:
            - complianceType: musthave
              objectDefinition:
                apiVersion: v1
                kind: Pod
                metadata:
                  name: sample-nginx-pod
                  namespace: default
                status:
                  phase: Running
          remediationAction: inform
          severity: low
  remediationAction: enforce
---
apiVersion: policy.open-cluster-management.io/v1
kind: PlacementBinding
metadata:
  name: binding-policy-pod
  namespace: default
placementRef:
  name: placement-policy-pod
  kind: PlacementRule
  apiGroup: apps.open-cluster-management.io
subjects:
- name: policy-pod
  kind: Policy
  apiGroup: policy.open-cluster-management.io
---
apiVersion: apps.open-cluster-management.io/v1
kind: PlacementRule
metadata:
  name: placement-policy-pod
  namespace: default
spec:
  clusterConditions:
  - status: "True"
    type: ManagedClusterConditionAvailable
  clusterSelector:
    matchExpressions:
      []  # selects all clusters if not specified

在策略中添加以下内容：

apiVersion: config.openshift.io/vi
kind: OperatorHub
metadata:
 name: cluster
spec:
 disableAllDefaultSources: true

添加以下内容：

apiVersion: operators.coreos.com/v1alpha1
kind: CatalogSource
metadata:
  name: my-operator-catalog
  namespace: openshift-marketplace
spec:
  sourceType: grpc
  image: <registry_host_name>:<port>/olm/redhat-operators:v1
  displayName: My Operator Catalog
  publisher: grpc

将 spec.image 值替换为本地受限目录源镜像的路径。

在受管集群中，输入以下命令确认 ClusterVersion upstream 参数目前是默认公共 OpenShift Update Service 操作对象：

oc get clusterversion -o yaml

返回的内容可能类似以下内容：

apiVersion: v1
items:
- apiVersion: config.openshift.io/v1
  kind: ClusterVersion
[..]
  spec:
    channel: stable-4.4
    upstream: https://api.openshift.com/api/upgrades_info/v1/graph

在 hub 集群中，输入以下命令来识别到 OpenShift Update Service 操作对象：oc get routes。

提示：请注意这个值供后续步骤使用。

将以下 YAML 内容粘贴到窗口以创建自定义策略：

apiVersion: policy.open-cluster-management.io/v1
kind: Policy
metadata:
  name: policy-pod
  namespace: default
  annotations:
    policy.open-cluster-management.io/standards:
    policy.open-cluster-management.io/categories:
    policy.open-cluster-management.io/controls:
spec:
  disabled: false
  policy-templates:
    - objectDefinition:
        apiVersion: policy.open-cluster-management.io/v1
        kind: ConfigurationPolicy
        metadata:
          name: policy-pod-sample-nginx-pod
        spec:
          object-templates:
            - complianceType: musthave
              objectDefinition:
                apiVersion: v1
                kind: Pod
                metadata:
                  name: sample-nginx-pod
                  namespace: default
                status:
                  phase: Running
          remediationAction: inform
          severity: low
  remediationAction: enforce
---
apiVersion: policy.open-cluster-management.io/v1
kind: PlacementBinding
metadata:
  name: binding-policy-pod
  namespace: default
placementRef:
  name: placement-policy-pod
  kind: PlacementRule
  apiGroup: apps.open-cluster-management.io
subjects:
- name: policy-pod
  kind: Policy
  apiGroup: policy.open-cluster-management.io
---
apiVersion: apps.open-cluster-management.io/v1
kind: PlacementRule
metadata:
  name: placement-policy-pod
  namespace: default
spec:
  clusterConditions:
  - status: "True"
    type: ManagedClusterConditionAvailable
  clusterSelector:
    matchExpressions:
      []  # selects all clusters if not specified

将以下内容添加到 policy 项中的 policy.spec 部分：

apiVersion: config.openshift.io/v1
  kind: ClusterVersion
  metadata:
    name: version
  spec:
    channel: stable-4.4
    upstream: https://example-cincinnati-policy-engine-uri/api/upgrades_info/v1/graph

将 spec.upstream 值替换为 hub 集群 OpenShift Update Service 操作对象的路径。

提示：您可以完成以下步骤以确定操作对象的路径：

在受管集群 CLI 中，使用以下命令确认 ClusterVersion 中的上游参数已使用本地 hub 集群 OpenShift Update Service URL 更新：

oc get clusterversion -o yaml

结果应该类似以下内容：

apiVersion: v1
items:
- apiVersion: config.openshift.io/v1
  kind: ClusterVersion
[..]
  spec:
    channel: stable-4.4
    upstream: https://<hub-cincinnati-uri>/api/upgrades_info/v1/graph

验证可选的升级路径是否可用。

备注：如果当前版本没有镜像到本地镜像存储库，则不会显示可用的升级版本。