扩展

1. 为目录维护一个配置文件，其中包含目录中每个 Operator 的镜像引用：

   目录配置文件示例

   name: community-operators
   repo: quay.io/community-operators/catalog
   tag: latest
   references:
   - name: etcd-operator
     image: quay.io/etcd-operator/index@sha256:5891b5b522d5df086d0ff0b110fbd9d21bb4fc7163af34d08286a2e846f6be03
   - name: prometheus-operator
     image: quay.io/prometheus-operator/index@sha256:e258d248fda94c63753607f7c4494ee0fcbe92f1a76bfdac795c9d84101eb317

2. 运行一个脚本，该脚本将解析配置文件并从其引用中创建新目录：

   脚本示例

   name=$(yq eval '.name' catalog.yaml)
   mkdir "$name"
   yq eval '.name + "/" + .references[].name' catalog.yaml | xargs mkdir
   for l in $(yq e '.name as $catalog | .references[] | .image + "|" + $catalog + "/" + .name + "/index.yaml"' catalog.yaml); do
     image=$(echo $l | cut -d'|' -f1)
     file=$(echo $l | cut -d'|' -f2)
     opm render "$image" > "$file"
   done
   opm generate dockerfile "$name"
   indexImage=$(yq eval '.repo + ":" + .tag' catalog.yaml)
   docker build -t "$indexImage" -f "$name.Dockerfile" .
   docker push "$indexImage"

流程

1. 创建目录自定义资源(CR)，如下例所示：

   redhat-operators.yaml 示例

   apiVersion: catalogd.operatorframework.io/v1alpha1
   kind: ClusterCatalog
   metadata:
     name: redhat-operators
   spec:
     source:
       type: image
       image:
         ref: registry.redhat.io/redhat/redhat-operator-index:v4.17 1
         pullSecret: <pull_secret_name> 2
         pollInterval: <poll_interval_duration> 3

   1

   在 spec.source.image 字段中指定目录的镜像。

   2

   如果您的目录托管在安全 registry 上，如 registry.redhat.io，您必须创建一个范围到 openshift-catalog 命名空间的 pull secret。

   3

   指定轮询远程 registry 以获取较新的镜像摘要的时间间隔。默认值为 24h。有效单位包括秒 (s)、分钟 (m) 和小时 (h)。要禁用轮询，请设置零值，如 0s。

2. 运行以下命令在集群中添加目录：

   $ oc apply -f redhat-operators.yaml

   输出示例

   catalog.catalogd.operatorframework.io/redhat-operators created

流程

1. 初始化目录：

   1. 运行以下命令，为目录创建一个目录：

      $ mkdir <catalog_dir>

   2. 运行 opm generate dockerfile 命令生成可构建目录镜像的 Dockerfile：

      $ opm generate dockerfile <catalog_dir> \
          -i registry.redhat.io/openshift4/ose-operator-registry-rhel9:v4.17 1

      1

      使用 -i 标志指定官方红帽基础镜像，否则 Dockerfile 使用默认的上游镜像。

      Dockerfile 必须与您在上一步中创建的目录目录位于相同的父目录中：

      目录结构示例

      . 1
      ├── <catalog_dir> 2
      └── <catalog_dir>.Dockerfile 3

      1

      父目录

      2

      Catalog 目录

      3

      opm generate dockerfile 命令生成的 Dockerfile

   3. 运行 opm init 命令，使用 Operator 的软件包定义填充目录：

      $ opm init <operator_name> \ 1
          --default-channel=preview \ 2
          --description=./README.md \ 3
          --icon=./operator-icon.svg \ 4
          --output yaml \ 5
          > <catalog_dir>/index.yaml 6

      1

      operator 或 package, name

      2

      在未指定时该订阅默认到的频道

      3

      Operator 的 README.md 或者其它文档的路径

      4

      到 Operator 图标的路径

      5

      输出格式：JSON 或 YAML

      6

      创建目录配置文件的路径

      此命令在指定的目录配置文件中生成 olm.package 声明性配置 blob。

2. 运行 opm render 命令向目录添加捆绑包：

   $ opm render <registry>/<namespace>/<bundle_image_name>:<tag> \ 1
       --output=yaml \
       >> <catalog_dir>/index.yaml 2

   1

   拉取捆绑包镜像的 spec

   2

   目录配置文件的路径

   注意

   频道必须至少包含一个捆绑包。

3. 为捆绑包添加频道条目。例如，根据您的规格修改以下示例，并将其添加到 <catalog_dir>/index.yaml 文件中：

   频道条目示例

   ---
   schema: olm.channel
   package: <operator_name>
   name: preview
   entries:
     - name: <operator_name>.v0.1.0 1

   1

   确定在 <operator_name> 之后、版本 v 中包含句点 (.)。否则，条目无法传递 opm validate 命令。

4. 验证基于文件的目录：

   1. 针对目录目录运行 opm validate 命令：

      $ opm validate <catalog_dir>

   2. 检查错误代码是否为 0:

      $ echo $?

      输出示例

      0

5. 运行 podman build 命令构建目录镜像：

   $ podman build . \
       -f <catalog_dir>.Dockerfile \
       -t <registry>/<namespace>/<catalog_image_name>:<tag>

6. 将目录镜像推送到 registry：

   1. 如果需要，运行 podman login 命令与目标 registry 进行身份验证：

      $ podman login <registry>

   2. 运行 podman push 命令来推送目录镜像：

      $ podman push <registry>/<namespace>/<catalog_image_name>:<tag>

流程

1. 以 YAML 格式将目录镜像的内容提取到 catalog 目录中的 index.yaml 文件中：

   $ opm render <registry>/<namespace>/<catalog_image_name>:<tag> \
       -o yaml > <catalog_dir>/index.yaml

   注意

   或者，您可以使用 -o json 标志以 JSON 格式输出。

2. 将生成的 index.yaml 文件的内容修改为您的规格：

   重要

   在目录中发布捆绑包后，假设您安装了其中一个用户。确保之前发布目录中的所有捆绑包都具有到当前或更新频道头的更新路径，以避免安装该版本的用户。

   • 要添加 Operator，请按照"创建基于文件的目录镜像"过程中创建软件包、捆绑包和频道条目的步骤进行操作。

   • 要删除 Operator，请删除与软件包相关的 olm.package、olm.channel 和 olm.bundle blob 的集合。以下示例显示了一个需要删除的集合，才能从目录中删除 example-operator 软件包：

     例 4.12. 删除条目示例

     ---
     defaultChannel: release-2.7
     icon:
       base64data: <base64_string>
       mediatype: image/svg+xml
     name: example-operator
     schema: olm.package
     ---
     entries:
     - name: example-operator.v2.7.0
       skipRange: '>=2.6.0 <2.7.0'
     - name: example-operator.v2.7.1
       replaces: example-operator.v2.7.0
       skipRange: '>=2.6.0 <2.7.1'
     - name: example-operator.v2.7.2
       replaces: example-operator.v2.7.1
       skipRange: '>=2.6.0 <2.7.2'
     - name: example-operator.v2.7.3
       replaces: example-operator.v2.7.2
       skipRange: '>=2.6.0 <2.7.3'
     - name: example-operator.v2.7.4
       replaces: example-operator.v2.7.3
       skipRange: '>=2.6.0 <2.7.4'
     name: release-2.7
     package: example-operator
     schema: olm.channel
     ---
     image: example.com/example-inc/example-operator-bundle@sha256:<digest>
     name: example-operator.v2.7.0
     package: example-operator
     properties:
     - type: olm.gvk
       value:
         group: example-group.example.io
         kind: MyObject
         version: v1alpha1
     - type: olm.gvk
       value:
         group: example-group.example.io
         kind: MyOtherObject
         version: v1beta1
     - type: olm.package
       value:
         packageName: example-operator
         version: 2.7.0
     - type: olm.bundle.object
       value:
         data: <base64_string>
     - type: olm.bundle.object
       value:
         data: <base64_string>
     relatedImages:
     - image: example.com/example-inc/example-related-image@sha256:<digest>
       name: example-related-image
     schema: olm.bundle
     ---

   • 要为 Operator 添加或更新弃用信息，请确保在与软件包的 index.yaml 文件相同的目录中有一个 deprecations.yaml 文件。有关 deprecations.yaml 文件格式的详情，请参考 "olm.deprecations schema"。
3. 保存您的更改。

4. 验证目录：

   $ opm validate <catalog_dir>

5. 重建目录：

   $ podman build . \
       -f <catalog_dir>.Dockerfile \
       -t <registry>/<namespace>/<catalog_image_name>:<tag>

6. 将更新的目录镜像推送到 registry：

   $ podman push <registry>/<namespace>/<catalog_image_name>:<tag>

验证

1. 在 Web 控制台中，进入 Administration → Cluster Settings → Configuration 页面中的 OperatorHub 配置资源。

2. 添加目录源或更新现有目录源，以便将 pull spec 用于更新的目录镜像。

   如需更多信息，请参阅本节的"添加资源"中的"在集群中添加目录源"。

3. 在目录源处于 READY 状态后，进入 Operators → OperatorHub 页面，检查您所做的更改是否反映在 Operator 列表中。

流程

1. 运行以下命令，在 openshift-catalogd 命名空间中转发目录服务器服务：

   $ oc -n openshift-catalogd port-forward svc/catalogd-catalogserver 8080:443

2. 在新的终端窗口中或标签页中，运行以下命令来在本地下载目录的 JSON 文件：

   $ curl -L -k https://localhost:8080/catalogs/<catalog_name>/all.json \
     -C - -o /<path>/<catalog_name>.json

   例 5.1. 示例命令

   $ curl -L -k https://localhost:8080/catalogs/redhat-operators/all.json \
     -C - -o /home/username/catalogs/rhoc.json

3. 运行以下命令之一返回目录中的 Operator 和扩展列表。

   重要

   目前，Operator Lifecycle Manager (OLM) v1 支持安装满足以下所有条件的集群扩展：

   • 扩展必须使用现有 OLM 中引入的 registry+v1 捆绑包格式。
   • 扩展必须通过 AllNamespaces 安装模式支持安装。
   • 扩展不能使用 Webhook。

   • 扩展不能使用以下基于文件的目录属性声明依赖项：

     • olm.gvk.required
     • olm.package.required
     • olm.constraint

   OLM v1 检查您要安装的扩展是否满足这些限制。如果要安装的扩展不符合这些限制，会在集群扩展条件中输出错误消息。

   • 运行以下命令，从本地目录文件获取 Operator 和扩展列表：

     $ jq -s '.[] | select(.schema == "olm.package") | .name' \
       /<path>/<filename>.json

     例 5.2. 示例命令

     $ jq -s '.[] | select(.schema == "olm.package") | .name' \
       /home/username/catalogs/rhoc.json

     例 5.3. 输出示例

     NAME                                                        AGE
     "3scale-operator"
     "advanced-cluster-management"
     "amq-broker-rhel8"
     "amq-online"
     "amq-streams"
     "amq7-interconnect-operator"
     "ansible-automation-platform-operator"
     "ansible-cloud-addons-operator"
     "apicast-operator"
     "aws-efs-csi-driver-operator"
     "aws-load-balancer-operator"
     "bamoe-businessautomation-operator"
     "bamoe-kogito-operator"
     "bare-metal-event-relay"
     "businessautomation-operator"
     ...

   • 运行以下命令，获取支持 AllNamespaces 安装模式的软件包列表，且不从本地目录文件中使用 webhook：

     $ jq -c 'select(.schema == "olm.bundle") | \
       {"package":.package, "version":.properties[] | \
       select(.type == "olm.bundle.object").value.data | @base64d | fromjson | \
       select(.kind == "ClusterServiceVersion" and (.spec.installModes[] | \
       select(.type == "AllNamespaces" and .supported == true) != null) \
       and .spec.webhookdefinitions == null).spec.version}' \
       /<path>/<catalog_name>.json

     例 5.4. 输出示例

     {"package":"3scale-operator","version":"0.10.0-mas"}
     {"package":"3scale-operator","version":"0.10.5"}
     {"package":"3scale-operator","version":"0.11.0-mas"}
     {"package":"3scale-operator","version":"0.11.1-mas"}
     {"package":"3scale-operator","version":"0.11.2-mas"}
     {"package":"3scale-operator","version":"0.11.3-mas"}
     {"package":"3scale-operator","version":"0.11.5-mas"}
     {"package":"3scale-operator","version":"0.11.6-mas"}
     {"package":"3scale-operator","version":"0.11.7-mas"}
     {"package":"3scale-operator","version":"0.11.8-mas"}
     {"package":"amq-broker-rhel8","version":"7.10.0-opr-1"}
     {"package":"amq-broker-rhel8","version":"7.10.0-opr-2"}
     {"package":"amq-broker-rhel8","version":"7.10.0-opr-3"}
     {"package":"amq-broker-rhel8","version":"7.10.0-opr-4"}
     {"package":"amq-broker-rhel8","version":"7.10.1-opr-1"}
     {"package":"amq-broker-rhel8","version":"7.10.1-opr-2"}
     {"package":"amq-broker-rhel8","version":"7.10.2-opr-1"}
     {"package":"amq-broker-rhel8","version":"7.10.2-opr-2"}
     ...

4. 运行以下命令，检查 Operator 或扩展的元数据的内容：

   $ jq -s '.[] | select( .schema == "olm.package") | \
     select( .name == "<package_name>")' /<path>/<catalog_name>.json

   例 5.5. 示例命令

   $ jq -s '.[] | select( .schema == "olm.package") | \
     select( .name == "openshift-pipelines-operator-rh")' \
     /home/username/rhoc.json

   例 5.6. 输出示例

   {
     "defaultChannel": "stable",
     "icon": {
       "base64data": "PHN2ZyB4bWxu..."
       "mediatype": "image/png"
     },
     "name": "openshift-pipelines-operator-rh",
     "schema": "olm.package"
   }

流程

1. 创建服务帐户，类似以下示例：

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: <extension>-installer
     namespace: <namespace>

   例 5.7. extension-service-account.yaml 文件示例

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: pipelines-installer
     namespace: pipelines

2. 运行以下命令来应用服务帐户：

   $ oc apply -f extension-service-account.yaml

3. 创建集群角色并分配 RBAC，如下例所示：

   警告

   以下集群角色没有遵循最小特权的原则。此集群角色仅用于测试目的。不要在生产环境集群中使用它。

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: <extension>-installer-clusterrole
   rules:
   - apiGroups: ["*"]
     resources: ["*"]
     verbs: ["*"]

   例 5.8. pipelines-cluster-role.yaml 文件示例

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: pipelines-installer-clusterrole
   rules:
   - apiGroups: ["*"]
     resources: ["*"]
     verbs: ["*"]

4. 运行以下命令在集群中添加集群角色：

   $ oc apply -f pipelines-role.yaml

5. 通过创建集群角色绑定将集群角色授予的权限绑定到服务帐户，如下例所示：

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRoleBinding
   metadata:
     name: <extension>-installer-binding
   roleRef:
     apiGroup: rbac.authorization.k8s.io
     kind: ClusterRole
     name: <extension>-installer-clusterrole
   subjects:
   - kind: ServiceAccount
     name: <extension>-installer
     namespace: <namespace>

   例 5.9. pipelines-cluster-role-binding.yaml 文件示例

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRoleBinding
   metadata:
     name: pipelines-installer-binding
   roleRef:
     apiGroup: rbac.authorization.k8s.io
     kind: ClusterRole
     name: pipelines-installer-clusterrole
   subjects:
   - kind: ServiceAccount
     name: pipelines-installer
     namespace: pipelines

6. 运行以下命令来应用集群角色绑定：

   $ oc apply -f pipelines-cluster-role-binding.yaml

流程

1. 通过完成以下步骤，检查目录文件本地副本中的频道和版本信息：

   1. 运行以下命令，从所选软件包中获取频道列表：

      $ jq -s '.[] | select( .schema == "olm.channel" ) | \
        select( .package == "<package_name>") | \
        .name' /<path>/<catalog_name>.json

      例 5.10. 示例命令

      $ jq -s '.[] | select( .schema == "olm.channel" ) | \
        select( .package == "openshift-pipelines-operator-rh") | \
        .name' /home/username/rhoc.json

      例 5.11. 输出示例

      "latest"
      "pipelines-1.11"
      "pipelines-1.12"
      "pipelines-1.13"
      "pipelines-1.14"

   2. 运行以下命令，获取频道中发布的版本列表：

      $ jq -s '.[] | select( .package == "<package_name>" ) | \
        select( .schema == "olm.channel" ) | \
        select( .name == "<channel_name>" ) | .entries | \
        .[] | .name' /<path>/<catalog_name>.json

      例 5.12. 示例命令

      $ jq -s '.[] | select( .package == "openshift-pipelines-operator-rh" ) | \
      select( .schema == "olm.channel" ) | select( .name == "latest" ) | \
      .entries | .[] | .name' /home/username/rhoc.json

      例 5.13. 输出示例

      "openshift-pipelines-operator-rh.v1.12.0"
      "openshift-pipelines-operator-rh.v1.12.1"
      "openshift-pipelines-operator-rh.v1.12.2"
      "openshift-pipelines-operator-rh.v1.13.0"
      "openshift-pipelines-operator-rh.v1.13.1"
      "openshift-pipelines-operator-rh.v1.11.1"
      "openshift-pipelines-operator-rh.v1.12.0"
      "openshift-pipelines-operator-rh.v1.12.1"
      "openshift-pipelines-operator-rh.v1.12.2"
      "openshift-pipelines-operator-rh.v1.13.0"
      "openshift-pipelines-operator-rh.v1.14.1"
      "openshift-pipelines-operator-rh.v1.14.2"
      "openshift-pipelines-operator-rh.v1.14.3"
      "openshift-pipelines-operator-rh.v1.14.4"

2. 如果要将扩展安装到新命名空间中，请运行以下命令：

   $ oc adm new-project <new_namespace>

3. 创建一个类似以下示例的 CR：

   pipelines-operator.yaml CR 示例

   apiVersion: olm.operatorframework.io/v1alpha1
   kind: ClusterExtension
   metadata:
     name: pipelines-operator
   spec:
     packageName: openshift-pipelines-operator-rh
     installNamespace: <namespace>
     serviceAccount:
       name: <service_account>
     channel: <channel>
     version: "<version>"

   其中：

   <namespace>

   指定您要安装捆绑包的命名空间，如 pipelines 或 my-extension。扩展仍然是集群范围的，可能包含在不同命名空间中安装的资源。

   <service_account>

   指定您为安装、更新和管理扩展创建的服务帐户的名称。

   <channel>

   可选：为您要安装或更新的软件包指定频道，如 pipelines-1.11 或 latest。

   <version>

   可选：指定您要安装或更新的软件包的版本或版本范围，如 1.11.1、1.12.x 或 >=1.12.1。如需更多信息，请参阅"示例自定义资源(CR)指定目标版本"和"支持版本范围"。

   重要

   如果您尝试安装没有唯一名称的 Operator 或扩展，则安装可能会失败，或者导致无法预计的结果。这是因为以下原因：

   • 如果在集群中安装 mulitple 目录，Operator Lifecycle Manager (OLM) v1 不包含在安装 Operator 或扩展时指定目录的机制。
   • OLM v1 要求在集群中安装的所有 Operator 和扩展都使用其捆绑包和软件包的唯一名称。

4. 运行以下命令，将 CR 应用到集群：

   $ oc apply -f pipeline-operator.yaml

   输出示例

   clusterextension.olm.operatorframework.io/pipelines-operator created

验证

1. 运行以下命令，以 YAML 格式查看 Operator 或扩展 CR：

   $ oc get clusterextension pipelines-operator -o yaml

   例 5.14. 输出示例

   apiVersion: v1
   items:
   - apiVersion: olm.operatorframework.io/v1alpha1
     kind: ClusterExtension
     metadata:
       annotations:
         kubectl.kubernetes.io/last-applied-configuration: |
           {"apiVersion":"olm.operatorframework.io/v1alpha1","kind":"ClusterExtension","metadata":{"annotations":{},"name":"pipelines-operator"},"spec":{"channel":"latest","installNamespace":"pipelines","packageName":"openshift-pipelines-operator-rh","serviceAccount":{"name":"pipelines-installer"},"pollInterval":"30m"}}
       creationTimestamp: "2024-06-10T17:50:51Z"
       finalizers:
       - olm.operatorframework.io/cleanup-unpack-cache
       generation: 1
       name: pipelines-operator
       resourceVersion: "53324"
       uid: c54237be-cde4-46d4-9b31-d0ec6acc19bf
     spec:
       channel: latest
       installNamespace: pipelines
       packageName: openshift-pipelines-operator-rh
       serviceAccount:
         name: pipelines-installer
       upgradeConstraintPolicy: Enforce
     status:
       conditions:
       - lastTransitionTime: "2024-06-10T17:50:58Z"
         message: resolved to "registry.redhat.io/openshift-pipelines/pipelines-operator-bundle@sha256:dd3d18367da2be42539e5dde8e484dac3df33ba3ce1d5bcf896838954f3864ec"
         observedGeneration: 1
         reason: Success
         status: "True"
         type: Resolved
       - lastTransitionTime: "2024-06-10T17:51:11Z"
         message: installed from "registry.redhat.io/openshift-pipelines/pipelines-operator-bundle@sha256:dd3d18367da2be42539e5dde8e484dac3df33ba3ce1d5bcf896838954f3864ec"
         observedGeneration: 1
         reason: Success
         status: "True"
         type: Installed
       - lastTransitionTime: "2024-06-10T17:50:58Z"
         message: ""
         observedGeneration: 1
         reason: Deprecated
         status: "False"
         type: Deprecated
       - lastTransitionTime: "2024-06-10T17:50:58Z"
         message: ""
         observedGeneration: 1
         reason: Deprecated
         status: "False"
         type: PackageDeprecated
       - lastTransitionTime: "2024-06-10T17:50:58Z"
         message: ""
         observedGeneration: 1
         reason: Deprecated
         status: "False"
         type: ChannelDeprecated
       - lastTransitionTime: "2024-06-10T17:50:58Z"
         message: ""
         observedGeneration: 1
         reason: Deprecated
         status: "False"
         type: BundleDeprecated
       - lastTransitionTime: "2024-06-10T17:50:58Z"
         message: 'unpack successful:
         observedGeneration: 1
         reason: UnpackSuccess
         status: "True"
         type: Unpacked
       installedBundle:
         name: openshift-pipelines-operator-rh.v1.14.4
         version: 1.14.4
       resolvedBundle:
         name: openshift-pipelines-operator-rh.v1.14.4
         version: 1.14.4

   其中：

   spec.channel

   显示扩展 CR 中定义的频道。

   spec.version

   显示扩展 CR 中定义的版本或版本范围。

   status.conditions

   显示扩展状态和健康的信息。

   type: Deprecated

   显示以下一个或多个是否已弃用：

   type: PackageDeprecated

   显示解析的软件包是否已弃用。

   type: ChannelDeprecated

   显示解析的频道是否已弃用。

   type: BundleDeprecated

   显示解析捆绑包是否已弃用。

   status 字段中的 False 值表示 reason: Deprecated 条件已弃用。status 字段中的 True 值表示 reason: Deprecated 条件已被弃用。

   installedBundle.name

   显示安装的捆绑包的名称。

   installedBundle.version

   显示安装的捆绑包的版本。

   resolvedBundle.name

   显示解析捆绑包的名称。

   resolvedBundle.version

   显示解析捆绑包的版本。

流程

1. 通过完成以下步骤，检查目录文件本地副本中的频道和版本信息：

   1. 运行以下命令，从所选软件包中获取频道列表：

      $ jq -s '.[] | select( .schema == "olm.channel" ) | \
        select( .package == "<package_name>") | \
        .name' /<path>/<catalog_name>.json

      例 5.15. 示例命令

      $ jq -s '.[] | select( .schema == "olm.channel" ) | \
        select( .package == "openshift-pipelines-operator-rh") | \
        .name' /home/username/rhoc.json

      例 5.16. 输出示例

      "latest"
      "pipelines-1.11"
      "pipelines-1.12"
      "pipelines-1.13"
      "pipelines-1.14"

   2. 运行以下命令，获取频道中发布的版本列表：

      $ jq -s '.[] | select( .package == "<package_name>" ) | \
        select( .schema == "olm.channel" ) | \
        select( .name == "<channel_name>" ) | .entries | \
        .[] | .name' /<path>/<catalog_name>.json

      例 5.17. 示例命令

      $ jq -s '.[] | select( .package == "openshift-pipelines-operator-rh" ) | \
      select( .schema == "olm.channel" ) | select( .name == "latest" ) | \
      .entries | .[] | .name' /home/username/rhoc.json

      例 5.18. 输出示例

      "openshift-pipelines-operator-rh.v1.11.1"
      "openshift-pipelines-operator-rh.v1.12.0"
      "openshift-pipelines-operator-rh.v1.12.1"
      "openshift-pipelines-operator-rh.v1.12.2"
      "openshift-pipelines-operator-rh.v1.13.0"
      "openshift-pipelines-operator-rh.v1.14.1"
      "openshift-pipelines-operator-rh.v1.14.2"
      "openshift-pipelines-operator-rh.v1.14.3"
      "openshift-pipelines-operator-rh.v1.14.4"

2. 运行以下命令，查找在 Operator 或扩展 CR 中指定哪个版本或频道：

   $ oc get clusterextension <operator_name> -o yaml

   示例命令

   $ oc get clusterextension pipelines-operator -o yaml

   例 5.19. 输出示例

   apiVersion: olm.operatorframework.io/v1alpha1
   kind: ClusterExtension
   metadata:
     annotations:
       kubectl.kubernetes.io/last-applied-configuration: |
         {"apiVersion":"olm.operatorframework.io/v1alpha1","kind":"ClusterExtension","metadata":{"annotations":{},"name":"pipelines-operator"},"spec":{"channel":"latest","installNamespace":"openshift-operators","packageName":"openshift-pipelines-operator-rh","pollInterval":"30m","version":"\u003c1.12"}}
     creationTimestamp: "2024-06-11T15:55:37Z"
     generation: 1
     name: pipelines-operator
     resourceVersion: "69776"
     uid: 6a11dff3-bfa3-42b8-9e5f-d8babbd6486f
   spec:
     channel: latest
     installNamespace: openshift-operators
     packageName: openshift-pipelines-operator-rh
     upgradeConstraintPolicy: Enforce
     version: <1.12
   status:
     conditions:
     - lastTransitionTime: "2024-06-11T15:56:09Z"
       message: installed from "registry.redhat.io/openshift-pipelines/pipelines-operator-bundle@sha256:e09d37bb1e754db42324fd18c1cb3e7ce77e7b7fcbf4932d0535391579938280"
       observedGeneration: 1
       reason: Success
       status: "True"
       type: Installed
     - lastTransitionTime: "2024-06-11T15:55:50Z"
       message: resolved to "registry.redhat.io/openshift-pipelines/pipelines-operator-bundle@sha256:e09d37bb1e754db42324fd18c1cb3e7ce77e7b7fcbf4932d0535391579938280"
       observedGeneration: 1
       reason: Success
       status: "True"
       type: Resolved
     - lastTransitionTime: "2024-06-11T15:55:50Z"
       message: ""
       observedGeneration: 1
       reason: Deprecated
       status: "False"
       type: Deprecated
     - lastTransitionTime: "2024-06-11T15:55:50Z"
       message: ""
       observedGeneration: 1
       reason: Deprecated
       status: "False"
       type: PackageDeprecated
     - lastTransitionTime: "2024-06-11T15:55:50Z"
       message: ""
       observedGeneration: 1
       reason: Deprecated
       status: "False"
       type: ChannelDeprecated
     - lastTransitionTime: "2024-06-11T15:55:50Z"
       message: ""
       observedGeneration: 1
       reason: Deprecated
       status: "False"
       type: BundleDeprecated
     installedBundle:
       name: openshift-pipelines-operator-rh.v1.11.1
       version: 1.11.1
     resolvedBundle:
       name: openshift-pipelines-operator-rh.v1.11.1
       version: 1.11.1

3. 使用以下方法之一编辑 CR：

   • 如果要将 Operator 或扩展固定到特定版本，如 1.12.1，请编辑类似以下示例的 CR：

     pipelines-operator.yaml CR 示例

     apiVersion: olm.operatorframework.io/v1alpha1
     kind: ClusterExtension
     metadata:
       name: pipelines-operator
     spec:
       packageName: openshift-pipelines-operator-rh
       installNamespace: <namespace>
       version: "1.12.1" 1

     1

     将版本从 1.11.1 更新至 1.12.1

   • 如果要定义可接受的更新版本范围，请编辑类似以下示例的 CR：

     指定了版本范围的 CR 示例

     apiVersion: olm.operatorframework.io/v1alpha1
     kind: ClusterExtension
     metadata:
       name: pipelines-operator
     spec:
       packageName: openshift-pipelines-operator-rh
       installNamespace: <namespace>
       version: ">1.11.1, <1.13" 1

     1

     指定所需的版本范围大于 1.11.1 版本，且小于 1.13。如需更多信息，请参阅"支持版本范围"和"Version 比较字符串"。

   • 如果要更新到可以从频道解析的最新版本，请编辑类似以下示例的 CR：

     带有指定频道的 CR 示例

     apiVersion: olm.operatorframework.io/v1alpha1
     kind: ClusterExtension
     metadata:
       name: pipelines-operator
     spec:
       packageName: openshift-pipelines-operator-rh
       installNamespace: <namespace>
       channel: pipelines-1.13 1

     1

     安装可从指定频道解析的最新版本。对频道的更新会自动安装。

   • 如果要指定频道和版本范围，请编辑类似以下示例的 CR：

     带有指定频道和版本范围的 CR 示例

     apiVersion: olm.operatorframework.io/v1alpha1
     kind: ClusterExtension
     metadata:
       name: pipelines-operator
     spec:
       packageName: openshift-pipelines-operator-rh
       installNamespace: <namespace>
       channel: latest
       version: "<1.13"

     如需更多信息，请参阅"指定目标版本的示例自定义资源(CR) "。

4. 运行以下命令，将更新应用到集群：

   $ oc apply -f pipelines-operator.yaml

   输出示例

   clusterextension.olm.operatorframework.io/pipelines-operator configured

   提示

   您可以运行以下命令来通过 CLI 对 CR 进行补丁并应用更改：

   $ oc patch clusterextension/pipelines-operator -p \
     '{"spec":{"version":"<1.13"}}' \
     --type=merge

   输出示例

   clusterextension.olm.operatorframework.io/pipelines-operator patched

流程

1. 编辑 Operator 或扩展的自定义资源 (CR)，如下例所示：

   CR 示例

   apiVersion: olm.operatorframework.io/v1alpha1
   kind: Operator
   metadata:
     name: <operator_name> 1
   spec:
     packageName: <package_name> 2
     installNamespace: <namespace_name>
     serviceAccount:
       name: <service_account>
     version: <version> 3
     upgradeConstraintPolicy: Ignore 4

   1

   指定 Operator 或扩展的名称，如 pipelines-operator

   2

   指定软件包名称，如 openshift-pipelines-operator-rh。

   3

   指定被阻断的更新或回滚版本。

   4

   可选：指定升级约束策略。要强制更新或回滚，请将字段设置为 Ignore。如果未指定，则默认设置为 Enforce。

2. 运行以下命令，对 Operator 或 extensions CR 应用更改：

   $ oc apply -f <extension_name>.yaml

流程

1. 编辑 CRD 的 ClusterExtension 对象：

   $ oc edit clusterextension <clusterextension_name>

2. 将 preflight.crdUpgradeSafety.disabled 字段设置为 true ：

   例 5.22. ClusterExtension 对象示例

   apiVersion: olm.operatorframework.io/v1alpha1
   kind: ClusterExtension
   metadata:
       name: clusterextension-sample
   spec:
       installNamespace: default
       packageName: argocd-operator
       version: 0.6.0
       preflight:
           crdUpgradeSafety:
               disabled: true 1

   1

   设置为 true。