11.3. 使用 oc-mirror 插件创建自定义 Operator 目录

流程

1. 运行以下命令，获取红帽提供的 Operator 目录列表以过滤：

   $ oc mirror list operators --version 4.20 --catalogs

   Copy to Clipboard Toggle word wrap

2. 运行以下命令，获取 Red Hat Operator 目录中的 Operator 列表：

   $ oc mirror list operators <--catalog=<catalog_source>> 

   1

   Copy to Clipboard Toggle word wrap

   1

   指定目录源，如 registry.redhat.io/redhat/redhat-operator-index:v4.20 或 quay.io/operatorhubio/catalog:latest。

3. 选择一个 Operator。本例使用 amq-broker-rhel9 Operator。

4. 可选： 要检查您要过滤的 Operator 的频道和版本，请输入以下命令：

   1. 运行以下命令获取频道列表：

      $ oc mirror list operators --catalog=registry.redhat.io/redhat/redhat-operator-index:v4.20 --package=amq-broker-rhel9

      Copy to Clipboard Toggle word wrap

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

      $ oc mirror list operators --catalog=registry.redhat.io/redhat/redhat-operator-index:v4.20 --package=amq-broker-rhel9 --channel=7.13.x

      Copy to Clipboard Toggle word wrap

流程

1. 使用以下示例作为指南，为 MicroShift 创建和编辑 ImageSetConfiguration YAML：

   编辑的 MicroShift 镜像设置配置文件示例

   kind: ImageSetConfiguration
   apiVersion: mirror.openshift.io/v2alpha1
   mirror:
     operators:
     - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.20 

   1

   
       packages:
       - name: amq-broker-rhel9 

   2

   
         channels:
         - name: 7.13.x 

   3

   
     additionalImages: 

   4

   
      - name: quay.io/rh_ee_aguidi/multi-platform-container:latest
      - name: quay.io/rh_ee_aguidi/empty-image:latest

   Copy to Clipboard Toggle word wrap

   1

   将 Operator 目录设置为从中检索镜像。

   2

   指定要包含在镜像集中的 Operator 软件包。删除此字段以检索目录中的所有软件包。

   3

   仅指定要包含在镜像集中的 Operator 软件包的某些频道。即使您没有使用该频道中的捆绑包，还必须始终包含 Operator 软件包的默认频道。您可以运行以下命令来找到默认频道：oc mirror list operators --catalog=<catalog_name> --package=<package_name>。

   4

   指定要在镜像集中包含的任何其他镜像。如果您不需要指定其他镜像，请删除此字段。

   重要

   MicroShift 不支持 platform 字段、相关字段和 Helm。

2. 将更新的文件保存为 ImageSetConfiguration.yaml。

验证

1. 运行以下命令，列出 cluster-resources 子目录的内容：

   $ ls <v2_workspace>/working-dir/cluster-resources/ 

   1

   Copy to Clipboard Toggle word wrap

   1

   将 <v2_workspace > 替换为您要为镜像进程存储自定义资源的目录。

流程

1. 运行以下命令，确认 ImageDigestMirrorSet YAML 文件的内容：

   $ cat <v2_workspace>/working-dir/cluster-resources/imagedigestmirrorset.yaml 

   1

   Copy to Clipboard Toggle word wrap

   1

   将 <v2_workspace > 替换为您在生成镜像资源时使用的目录名称。

   输出示例

   apiVersion: config.openshift.io/v1
   kind: ImageDigestMirrorSet
   metadata:
     labels:
       operators.openshift.org/catalog: "true"
     name: operator-0
   spec:
     imageDigestMirrors:
     - mirrors:
       - registry.example.com/amq7
       source: registry.redhat.io/amq7

   Copy to Clipboard Toggle word wrap

2. 运行以下命令，将 imagedigestmirrorset.yaml 转换为可用于 CRI-O 配置的格式：

   yq '.spec.imageDigestMirrors[] as $item ireduce([]; . + [{"mirror": $item.mirrors[], "source": ($item | .source)}]) | .[] |
     "[[registry]]
         prefix = \"" + .source + "\"
         location = \"" + .mirror + "\"
         mirror-by-digest-only = true
         insecure = true
         "' ./mirror1/working-dir/cluster-resources/imagedigestmirrorset.yaml

   Copy to Clipboard Toggle word wrap

   输出示例

   [[registry]]
         prefix = "registry.redhat.io/amq7"
         location = "registry.example.com/amq7"
         mirror-by-digest-only = true
         insecure = true

   Copy to Clipboard Toggle word wrap

3. 将输出添加到 /etc/containers/registries.conf.d/ 目录中的 CRI-O 配置文件中：

   crio-config.yaml 镜像配置文件示例

   [[registry]]
         prefix = "registry.redhat.io/amq7"
         location = "registry.example.com/amq7"
         mirror-by-digest-only = true
         insecure = true
   
   [[registry]]
       prefix = ""
       location = "quay.io"
       mirror-by-digest-only = true
   [[registry.mirror]]
       location = "<registry_host>:<port>" 

   1

   
       insecure = false

   Copy to Clipboard Toggle word wrap

   1

   指定镜像 registry 服务器的主机名和端口，如 microshift-quay:8443。

4. 使用以下命令重启 MicroShift 来应用 CRI-O 配置更改：

   $ sudo systemctl restart crio

   Copy to Clipboard Toggle word wrap

流程

1. 运行以下命令，应用来自结果目录中的目录源配置文件来创建目录源对象：

   $ oc apply -f ./<v2_workspace>/working-dir/cluster-resources/catalogSource-cs-redhat-catalog.yaml 

   1

   Copy to Clipboard Toggle word wrap

   1

   将 <v2_workspace > 替换为您要为镜像进程存储自定义资源的目录。

   输出示例

   catalogsource.operators.coreos.com/cs-redhat-catalog created

   Copy to Clipboard Toggle word wrap

2. 请参考以下示例文件：

   目录源配置文件示例

   apiVersion: operators.coreos.com/v2alpha1
   kind: CatalogSource
   metadata:
     name: redhat-catalog
     namespace: openshift-marketplace 

   1

   
   spec:
     sourceType: grpc
     image: registry.example.com/redhat/redhat-catalog:v4.20
     updateStrategy:
       registryPoll:
         interval: 60m

   Copy to Clipboard Toggle word wrap

   1

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

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

   $ oc get catalogsource --all-namespaces

   Copy to Clipboard Toggle word wrap

   输出示例

   NAMESPACE               NAME                  DISPLAY               TYPE   PUBLISHER   AGE
   openshift-marketplace   certified-operators   Certified Operators   grpc   Red Hat     37m
   openshift-marketplace   community-operators   Community Operators   grpc   Red Hat     37m
   openshift-marketplace   redhat-marketplace    Red Hat Marketplace   grpc   Red Hat     37m
   openshift-marketplace   redhat-catalog        Red Hat Catalog     grpc   Red Hat     37m

   Copy to Clipboard Toggle word wrap

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

   $ oc get pods -n openshift-marketplace

   Copy to Clipboard Toggle word wrap

   输出示例

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

   Copy to Clipboard Toggle word wrap

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

   Subscription CR 示例

   apiVersion: operators.coreos.com/v2alpha1
   kind: Subscription
   metadata:
     name: amq-broker
     namespace: openshift-operators
   spec:
     channel: 7.13.x
     name: amq-broker-rhel9
     source: cs-redhat-catalog
     sourceNamespace: openshift-marketplace

   Copy to Clipboard Toggle word wrap

6. 运行以下命令来应用 Subscription CR 配置：

   $ oc apply -f ./<subscription_cr.yaml> 

   1

   Copy to Clipboard Toggle word wrap

   1

   在 < subscription_cr.yaml > 中指定您的订阅名称，如 amq-​broker-subscription-cr.yaml。

   输出示例

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

   Copy to Clipboard Toggle word wrap