8.4. 将基于 OLM 的 Operator 添加到断开连接的集群中

流程

1. 使用 --dry-run 标志运行 oc mirror 命令来执行空运行：

   $ oc mirror --config=./imageset-config.yaml \

   1

   
     docker://registry.example:5000            \

   2

   
     --dry-run                                  

   3

   Copy to Clipboard Toggle word wrap

   1

   传递创建的镜像设置配置文件。此流程假设它名为 imageset-config.yaml。

   2

   指定镜像 registry。在使用 --dry-run 标志时，不会镜像这个 registry。

   3

   使用 --dry-run 标志来生成空运行工件，而不是实际的镜像设置文件。

   输出示例

   Checking push permissions for registry.example:5000
   Creating directory: oc-mirror-workspace/src/publish
   Creating directory: oc-mirror-workspace/src/v2
   Creating directory: oc-mirror-workspace/src/charts
   Creating directory: oc-mirror-workspace/src/release-signatures
   No metadata detected, creating new workspace
   wrote mirroring manifests to oc-mirror-workspace/operators.1658342351/manifests-redhat-operator-index
   
   ...
   
   info: Planning completed in 31.48s
   info: Dry run complete
   Writing image mapping to oc-mirror-workspace/mapping.txt

   Copy to Clipboard Toggle word wrap

2. 进入生成的工作区目录：

   $ cd oc-mirror-workspace/

   Copy to Clipboard Toggle word wrap

3. 查看生成的 mapping.txt 文件。

   此文件包含将要镜像的所有镜像的列表。

4. 查看生成的 prune-plan.json 文件。

   此文件包含在发布镜像集时从镜像 registry 中修剪的所有镜像的列表。

   注意

   只有在 oc-mirror 命令指向您的镜像 registry 且需要修剪的镜像时，才会生成 prune-plan.json 文件。

流程

1. 解析目录 index.json 文件，以获取 Image Builder 蓝图中包含的镜像引用。您可以使用未过滤的目录，也可以过滤掉无法镜像的镜像：

   1. 运行以下命令，解析未过滤的目录 index.json 文件以获取镜像引用：

      jq -r --slurp '.[] | select(.relatedImages != null) | "[[containers]]\nsource = \"" + .relatedImages[].image + "\"\n"'   ./oc-mirror-workspace/src/catalogs/registry.redhat.io/redhat/redhat-operator-index/v4.17/index/index.json

      Copy to Clipboard Toggle word wrap

   2. 如果要过滤无法镜像的镜像，请运行以下命令来过滤并解析目录 index.json 文件：

      $ jq -r --slurp '.[] | select(.relatedImages != null) | .relatedImages[] | select(.name |  contains("ppc") or contains("s390x") | not) | "[[containers]]\\nsource = \\"" + .image + "\\"\\n"' ./oc-mirror-workspace/src/catalogs/registry.redhat.io/redhat/redhat-operator-index/v4.17/index/index.json

      Copy to Clipboard Toggle word wrap
      注意

      此步骤使用 AMQ Broker Operator 作为示例。您可以在 jq 命令中添加其他条件，以便根据您的用例的要求进行进一步过滤。

      image-reference 输出示例

      [[containers]]
      source = "registry.redhat.io/amq7/amq-broker-init-rhel8@sha256:0b2126cfb6054fdf428c1f43b69e36e93a09a49ce15350e9273c98cc08c6598b"
      
      [[containers]]
      source = "registry.redhat.io/amq7/amq-broker-init-rhel8@sha256:0dde839c2dce7cb684094bf26523c8e16677de03149a0fff468b8c3f106e1f4f"
      ...
      ...
      
      [[containers]]
      source = "registry.redhat.io/amq7/amq-broker-rhel8@sha256:e8fa2a00e576ecb95561ffbdbf87b1c82d479c8791ab2c6ce741dd0d0b496d15"
      
      [[containers]]
      source = "registry.redhat.io/amq7/amq-broker-rhel8@sha256:ff6fefad518a6c997d4c5a6e475ba89640260167f0bc27715daf3cc30116fad1"
      …
      EOF

      Copy to Clipboard Toggle word wrap

      重要

      对于镜像和断开连接的用例，请确保从目录 index.json 文件过滤的所有源都是摘要。如果有任何源使用标签而不是摘要，Operator 安装会失败。标签需要互联网连接。

2. 运行以下命令，查看 imageset-config.yaml 以获取 CatalogSource 自定义资源(CR)的目录镜像引用：

   $ cat imageset-config.yaml

   Copy to Clipboard Toggle word wrap

   输出示例

   kind: ImageSetConfiguration
   apiVersion: mirror.openshift.io/v1alpha2
   storageConfig:
     registry:
       imageURL: registry.example.com/microshift-mirror
   mirror:
     operators:
     - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.17 

   1

   
       packages:
       - name: amq-broker-rhel8
         channels:
         - name: 7.11.x

   Copy to Clipboard Toggle word wrap

   1

   使用 mirror.catalog 目录镜像引用中的值对 follwing jq 命令获取镜像摘要。在本例中，< registry.redhat.io/redhat/redhat-operator-index:v4.17 >。

3. 运行以下命令，获取目录索引镜像的 SHA：

   $ skopeo inspect docker://<registry.redhat.io/redhat/redhat-operator-index:v4.17> | jq `.Digest` 

   1

   Copy to Clipboard Toggle word wrap

   1

   使用 jq 命令的 mirror.catalog 目录镜像引用中的值来获取镜像摘要。在本例中，< registry.redhat.io/redhat/redhat-operator-index:v4.17 >。

   输出示例

   "sha256:7a76c0880a839035eb6e896d54ebd63668bb37b82040692141ba39ab4c539bc6"

   Copy to Clipboard Toggle word wrap

4. 要准备好将镜像引用添加到 Image Builder 蓝图文件中，请使用以下示例格式化目录镜像引用：

   [[containers]]
   source = "registry.redhat.io/redhat/redhat-operator-index@sha256:7a76c0880a839035eb6e896d54ebd63668bb37b82040692141ba39ab4c539bc6"

   Copy to Clipboard Toggle word wrap

5. 将之前所有步骤中的镜像引用添加到镜像构建器蓝图中。

   生成的镜像构建器蓝图示例片断

   name = "microshift_blueprint"
   description = "MicroShift 4.17.1 on x86_64 platform"
   version = "0.0.1"
   modules = []
   groups = []
   
   [[packages]] 

   1

   
   name = "microshift"
   version = "4.17.1"
   ...
   ...
   
   [customizations.services] 

   2

   
   enabled = ["microshift"]
   
   [customizations.firewall]
   ports = ["22:tcp", "80:tcp", "443:tcp", "5353:udp", "6443:tcp", "30000-32767:tcp", "30000-32767:udp"]
   ...
   ...
   
   [[containers]] 

   3

   
   source = "quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:f41e79c17e8b41f1b0a5a32c3e2dd7cd15b8274554d3f1ba12b2598a347475f4"
   
   [[containers]]
   source = "quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:dbc65f1fba7d92b36cf7514cd130fe83a9bd211005ddb23a8dc479e0eea645fd"
   ...
   ...
   
   [[containers]] 

   4

   
   source = "registry.redhat.io/redhat/redhat-operator-index@sha256:7a76c0880a839035eb6e896d54ebd63668bb37b82040692141ba39ab4c539bc6"
   ...
   ...
   
   [[containers]]
   source = "registry.redhat.io/amq7/amq-broker-init-rhel8@sha256:0dde839c2dce7cb684094bf26523c8e16677de03149a0fff468b8c3f106e1f4f"
   ...
   ...
   
   [[containers]]
   source = "registry.redhat.io/amq7/amq-broker-rhel8@sha256:e8fa2a00e576ecb95561ffbdbf87b1c82d479c8791ab2c6ce741dd0d0b496d15"
   
   [[containers]]
   source = "registry.redhat.io/amq7/amq-broker-rhel8@sha256:ff6fefad518a6c997d4c5a6e475ba89640260167f0bc27715daf3cc30116fad1"
   …
   EOF

   Copy to Clipboard Toggle word wrap

   1

   使用与 microshift-release-info RPM 兼容的同一版本，所有非可选 MicroShift RPM 软件包的引用。

   2

   有关在系统引导时自动启用 MicroShift 并应用默认网络设置的引用。

   3

   对断开连接的部署所需的所有非可选 MicroShift 容器镜像的引用。

   4

   目录索引的引用。

流程

1. 创建 CatalogSource 自定义资源(CR)，类似以下示例：

   my-catalog-source-cr.yaml 文件示例

   apiVersion: operators.coreos.com/v1alpha1
   kind: CatalogSource
   metadata:
     name: cs-redhat-operator-index
     namespace: openshift-marketplace 

   1

   
   spec:
     image: registry.example.com/redhat/redhat-operator-index:v4.17
     sourceType: grpc
     displayName:
     publisher:
     updateStrategy:
       registryPoll:
         interval: 60m

   Copy to Clipboard Toggle word wrap

   1

   全局命名空间。将 metadata.namespace 设置为 openshift-marketplace 可让目录在所有命名空间中运行。任何命名空间中的订阅可以引用在 openshift-marketplace 命名空间中创建的目录。

   注意

   openshift-marketplace 的默认 pod 安全准入定义是 baseline，因此在该命名空间中创建的目录源自定义资源(CR)不需要设置 spec.grpcPodConfig.securityContextConfig 值。如果需要使用命名空间和 Operator，您可以设置 legacy 或 restricted 值。

2. 将目录索引提交的 SHA 添加到 Catalog Source (CR)中，如下例所示：

   命名空间 spec.image 配置示例

   apiVersion: operators.coreos.com/v1alpha1
   kind: CatalogSource
   metadata:
     name: cs-redhat-operator-index
     namespace: openshift-marketplace
   spec:
     image: registry.example.com/redhat/redhat-operator-index@sha256:7a76c0880a839035eb6e896d54ebd63668bb37b82040692141ba39ab4c539bc6 

   1

   
     sourceType: grpc
     displayName:
     publisher:
     updateStrategy:
       registryPoll:
         interval: 60m

   Copy to Clipboard Toggle word wrap

   1

   镜像提交的 SHA。使用添加到镜像构建器蓝图中的同一 SHA。

   重要

   您必须在目录 CR 中使用 SHA 而不是标签，否则 pod 无法启动。

3. 运行以下命令，将 oc-mirror 插件试运行结果目录中的 YAML 文件应用到集群：

   $ oc apply -f ./oc-mirror-workspace/results-1708508014/catalogSource-cs-redhat-operator-index.yaml

   Copy to Clipboard Toggle word wrap

   输出示例

   catalogsource.operators.coreos.com/cs-redhat-operator-index created

   Copy to Clipboard Toggle word wrap

4. 运行以下命令验证 CatalogSource 资源是否已成功安装：

   $ oc get catalogsource --all-namespaces

   Copy to Clipboard Toggle word wrap

5. 使用以下命令验证目录源是否正在运行：

   $ oc get pods -n openshift-marketplace

   Copy to Clipboard Toggle word wrap

   输出示例

   NAME                             READY   STATUS    RESTARTS   AGE
   cs-redhat-operator-index-4227b   2/2     Running   0          2m5s

   Copy to Clipboard Toggle word wrap

6. 创建一个 Subscription CR，类似以下示例：

   my-subscription-cr.yaml 文件示例

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: amq-broker
     namespace: openshift-operators
   spec:
     channel: 7.11.x
     name: amq-broker-rhel8
     source: cs-redhat-operator-index
     sourceNamespace: openshift-marketplace

   Copy to Clipboard Toggle word wrap

7. 运行以下命令来应用 Subscription CR：

   $ oc apply -f ./<my-subscription-cr.yaml> 

   1

   Copy to Clipboard Toggle word wrap

   1

   指定 Subscription CR 的名称，如 my-subscription-cr.yaml。

   输出示例

   subscription.operators.coreos.com/amq-broker created

   Copy to Clipboard Toggle word wrap