4.4. 创建目录

流程

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 列表中。