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

流程

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

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

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

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

   1

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

3. 选择一个 Operator。在本例中，选择 amq-broker-rhel8。

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

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

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

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

      $ oc mirror list operators --catalog=registry.redhat.io/redhat/redhat-operator-index:v4.17 --package=amq-broker-rhel8 --channel=7.11.x

流程

1. 使用 oc mirror init 命令为镜像设置配置创建模板，并将其保存到名为 imageset-config.yaml 的文件中：

   $ oc mirror init <--registry <storage_backend> > imageset-config.yaml 1

   1

   指定存储后端的位置，如 example.com/mirror/oc-mirror-metadata。

   默认镜像设置配置文件示例

   kind: ImageSetConfiguration
   apiVersion: mirror.openshift.io/v1alpha2
   storageConfig:
     registry:
       imageURL: registry.example.com/oc-mirror
       skipTLS: false
   mirror:
     platform: 1
       channels:
       - name: stable-4.17
         type: ocp
     operators:
     - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.17
       packages:
       - name: serverless-operator
         channels:
         - name: stable
     additionalImages: 2
     - name: registry.redhat.io/ubi8/ubi:latest
     helm: {} 3

   1

   MicroShift 不支持 platform 字段和相关字段，必须被删除。

   2

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

   3

   MicroShift 不支持 Helm，必须被删除。

2. 编辑镜像设置配置文件的值，以满足 MicroShift 和您要镜像的 Operator 的要求，如下例所示：

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

   kind: ImageSetConfiguration
   apiVersion: mirror.openshift.io/v1alpha2
   storageConfig: 1
     registry:
       imageURL: <storage_backend> 2
       skipTLS: false
   mirror:
     operators:
     - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.17 3
       packages:
       - name: amq-broker-rhel8 4
         channels:
         - name: 7.11.x 5

   1

   设置保存镜像设置元数据的后端位置。此位置可以是 registry 或本地目录。必须指定 storageConfig 值。

   2

   设置存储后端的 registry URL，如 <example.com/mirror/oc-mirror-metadata。

   3

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

   4

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

   5

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

3. 保存更新的文件。

验证

1. 进入生成的 oc-mirror-workspace/ 目录。
2. 导航到结果目录，例如，results-1639608409/。
3. 验证 ImageContentSourcePolicy 和 CatalogSource 资源是否存在 YAML 文件。

流程

1. 运行以下命令确认 imageContentSourcePolicy.yaml 文件的内容：

   $ cat oc-mirror-workspace/<results-directory>/imageContentSourcePolicy.yaml 1

   1

   指定 结果 目录名称，如 < results-1707148826>。

   输出示例

   apiVersion: operator.openshift.io/v1alpha1
   kind: ImageContentSourcePolicy
   metadata:
     labels:
       operators.openshift.org/catalog: "true"
     name: operator-0
   spec:
     repositoryDigestMirrors:
     - mirrors:
       - registry.<example.com>/amq7
       source: registry.redhat.io/amq7

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

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

   输出示例

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

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

   1

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

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

   $ sudo systemctl restart crio

流程

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

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

   目录源配置文件示例

   apiVersion: operators.coreos.com/v1alpha1
   kind: CatalogSource
   metadata:
     name: redhat-catalog
     namespace: openshift-marketplace 1
   spec:
     sourceType: grpc
     image: registry.example.com/redhat/redhat-operator-index:v4.17
     updateStrategy:
       registryPoll:
         interval: 60m

   1

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

   输出示例

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

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

   $ oc get catalogsource --all-namespaces

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

   $ oc get pods -n openshift-marketplace

   输出示例

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

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

   Subscription CR 示例

   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

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

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

   1

   指定订阅的名称，如 my-subscription-cr.yaml。

   输出示例

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