13.3. 使用 OpenShift Update Service 在断开连接的环境中更新集群

流程

1. 在 Web 控制台中，点 Operators → OperatorHub。

   注意

   在 Filter by keyword…​ 字段中输入 Update Service，以更快地查找 Operator。

2. 从可用的 Operator 列表中选择 OpenShift Update Service，然后点 Install。

   1. 频道 v1 被选为 Update Channel，因为它是这个版本中唯一可用的频道。
   2. 在 Installation Mode 下选择 A specific namespace on the cluster。
   3. 为 Installed Namespace 选择一个命名空间，或接受推荐的命名空间 openshift-update-service。

   4. 选择一个 批准策略：

      • Automatic 策略允许 Operator Lifecycle Manager（OLM）在有新版本可用时自动更新 Operator。
      • Manual 策略要求集群管理员批准 Operator 更新。
   5. 点 Install。
3. 通过切换到 Operators → Installed Operators 页来验证 OpenShift Update Service Operator 是否已安装。
4. 确保 OpenShift Update Service 列在所选命名空间中，Status 为 Succeeded。

流程

1. 为 OpenShift Update Service Operator 创建命名空间：

   1. 为 OpenShift Update Service Operator 创建一个 Namespace 对象 YAML 文件，如 update-service-namespace.yaml：

      apiVersion: v1
      kind: Namespace
      metadata:
        name: openshift-update-service
        annotations:
          openshift.io/node-selector: ""
        labels:
          openshift.io/cluster-monitoring: "true" 1

      1

      将 openshift.io/cluster-monitoring 标签设置为在该命名空间中启用 Operator-recommended 集群监控。

   2. 创建命名空间：

      $ oc create -f <filename>.yaml

      例如：

      $ oc create -f update-service-namespace.yaml

2. 通过创建以下对象来安装 OpenShift Update Service Operator：

   1. 创建一个 OperatorGroup 对象 YAML 文件，如 update-service-operator-group.yaml：

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: update-service-operator-group
      spec:
        targetNamespaces:
        - openshift-update-service

   2. 创建一个 OperatorGroup 对象：

      $ oc -n openshift-update-service create -f <filename>.yaml

      例如：

      $ oc -n openshift-update-service create -f update-service-operator-group.yaml

   3. 创建一个 Subscription 对象 YAML 文件，如 update-service-subscription.yaml：

      订阅示例

      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: update-service-subscription
      spec:
        channel: v1
        installPlanApproval: "Automatic"
        source: "redhat-operators" 1
        sourceNamespace: "openshift-marketplace"
        name: "cincinnati-operator"

      1

      指定提供 Operator 的目录源的名称。对于不使用自定义 Operator Lifecycle Manager（OLM）的集群，指定 redhat-operators。如果 OpenShift Container Platform 集群安装在断开连接的环境中，请指定配置 Operator Lifecycle Manager (OLM) 时创建的 CatalogSource 对象的名称。

   4. 创建 Subscription 对象：

      $ oc create -f <filename>.yaml

      例如：

      $ oc -n openshift-update-service create -f update-service-subscription.yaml

      OpenShift Update Service Operator 被安装到 openshift-update-service 命名空间，并以 openshift-update-service 命名空间为目标。

3. 验证 Operator 安装：

   $ oc -n openshift-update-service get clusterserviceversions

   输出示例

   NAME                             DISPLAY                    VERSION   REPLACES   PHASE
   update-service-operator.v4.6.0   OpenShift Update Service   4.6.0                Succeeded
   ...

   如果列出了 OpenShift Update Service Operator，则会成功安装。版本号可能与所示不同。

流程

1. 在 Web 控制台中，点 Operators → Installed Operators。
2. 从安装的 Operator 列表中选择 OpenShift Update Service。
3. 点 Update Service 选项卡。
4. 点 Create UpdateService。
5. 在 Name 字段中输入名称，如 service。
6. 在 Graph Data Image 字段中输入本地 pullspec，指向在"创建 OpenShift Update Service 图形数据容器镜像"中创建的图形数据容器镜像，如 registry.example.com/openshift/graph-data:latest。
7. 在 Releases 字段中，输入创建的本地 registry 和存储库，以在"镜像 OpenShift Container Platform 镜像存储库"中包括发行镜像，例如 registry.example.com/ocp4/openshift4-release-images。
8. 在 Replicas 字段中输入 2。
9. 单击 Create 以创建 OpenShift Update Service 应用。

10. 验证 OpenShift Update Service 应用程序：

    • 从 Update Service 选项卡中的 UpdateServices 列表中，点刚才创建的 Update Service 应用程序。
    • 单击 Resources 选项卡。
    • 验证每个应用资源的状态是否为 Created。

流程

1. 配置 OpenShift Update Service 目标命名空间，如 openshift-update-service：

   $ NAMESPACE=openshift-update-service

   命名空间必须与 operator 组中的 targetNamespaces 值匹配。

2. 配置 OpenShift Update Service 应用程序的名称，如 service：

   $ NAME=service

3. 按照"镜像 OpenShift Container Platform 镜像存储库"中配置，为发行镜像配置本地 registry 和存储库，如 registry.example.com/ocp4/openshift4-release-images：

   $ RELEASE_IMAGES=registry.example.com/ocp4/openshift4-release-images

4. 将 graph-data 镜像的本地 pullspec 设置为在"创建 OpenShift Update Service 图形数据容器镜像"中创建的图形数据容器镜像，如 registry.example.com/openshift/graph-data:latest:

   $ GRAPH_DATA_IMAGE=registry.example.com/openshift/graph-data:latest

5. 创建 OpenShift Update Service 应用程序对象：

   $ oc -n "${NAMESPACE}" create -f - <<EOF
   apiVersion: updateservice.operator.openshift.io/v1
   kind: UpdateService
   metadata:
     name: ${NAME}
   spec:
     replicas: 2
     releases: ${RELEASE_IMAGES}
     graphDataImage: ${GRAPH_DATA_IMAGE}
   EOF

6. 验证 OpenShift Update Service 应用程序：

   1. 使用以下命令获取策略引擎路由：

      $ while sleep 1; do POLICY_ENGINE_GRAPH_URI="$(oc -n "${NAMESPACE}" get -o jsonpath='{.status.policyEngineURI}/api/upgrades_info/v1/graph{"\n"}' updateservice "${NAME}")"; SCHEME="${POLICY_ENGINE_GRAPH_URI%%:*}"; if test "${SCHEME}" = http -o "${SCHEME}" = https; then break; fi; done

      您可能需要轮询，直到命令成功为止。

   2. 从策略引擎检索图形。确保为 channel 指定一个有效版本。例如，如果在 OpenShift Container Platform 4.12 中运行，请使用 stable-4.12 ：

      $ while sleep 10; do HTTP_CODE="$(curl --header Accept:application/json --output /dev/stderr --write-out "%{http_code}" "${POLICY_ENGINE_GRAPH_URI}?channel=stable-4.6")"; if test "${HTTP_CODE}" -eq 200; then break; fi; echo "${HTTP_CODE}"; done

      这会轮询到图形请求成功为止，但生成的图形可能为空，具体取决于您已镜像的发行镜像。