7.4. 在 OLM 1.0 中管理普通捆绑包（技术预览）

流程

1. 在项目的根目录中，创建一个可构建捆绑包镜像的 Dockerfile：

   plainbundle.Dockerfile 示例

   FROM scratch 1
   ADD manifests /manifests

   1

   使用 FROM scratch 指令可以使镜像的大小更小。捆绑包镜像不需要其他文件或目录。

2. 使用您首选的构建工具构建开放容器项目(OCI)兼容镜像，如下例所示：

   $ podman build -f plainbundle.Dockerfile -t \
       quay.io/<organization_name>/<repository_name>:<image_tag> . 1

   1

   使用引用已推送访问权限的存储库的镜像标签。

3. 运行以下命令将镜像推送到远程 registry：

   $ podman push quay.io/<organization_name>/<repository_name>:<image_tag>

流程

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

   $ mkdir <catalog_dir>

2. 通过在与上一步中相同的目录级别运行 opm generate dockerfile 命令生成可构建目录镜像的 Dockerfile：

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

   1

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

   注意

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

   目录结构示例

   .
   ├── <catalog_dir>
   └── <catalog_dir>.Dockerfile

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

   $ opm init <extension_name> \
       --output json \
       > <catalog_dir>/index.json

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

流程

1. 验证目录的 index.json 或 index.yaml 文件是否类似以下示例：

   <catalog_dir>/index.json 文件示例

   {
       {
        "schema": "olm.package",
        "name": "<extension_name>",
        "defaultChannel": ""
       }
   }

2. 要创建 olm.bundle blob，请编辑 index.json 或 index.yaml 文件，如下例所示：

   带有 olm.bundle blob 的 <catalog_dir>/index.json 文件示例

   {
      "schema": "olm.bundle",
       "name": "<extension_name>.v<version>",
       "package": "<extension_name>",
       "image": "quay.io/<organization_name>/<repository_name>:<image_tag>",
       "properties": [
           {
               "type": "olm.package",
               "value": {
               "packageName": "<extension_name>",
               "version": "<bundle_version>"
               }
           },
           {
               "type": "olm.bundle.mediatype",
               "value": "plain+v0"
           }
     ]
   }

3. 要创建 olm.channel blob，请编辑 index.json 或 index.yaml 文件，如下例所示：

   带有 olm.channel blob 的 <catalog_dir>/index.json 文件示例

   {
       "schema": "olm.channel",
       "name": "<desired_channel_name>",
       "package": "<extension_name>",
       "entries": [
           {
               "name": "<extension_name>.v<version>"
           }
       ]
   }

验证

1. 打开 index.json 或 index.yaml 文件，并确保它类似以下示例：

   <catalog_dir>/index.json 文件示例

   {
       "schema": "olm.package",
       "name": "example-extension",
       "defaultChannel": "preview"
   }
   {
       "schema": "olm.bundle",
       "name": "example-extension.v0.0.1",
       "package": "example-extension",
       "image": "quay.io/example-org/example-extension-bundle:v0.0.1",
       "properties": [
           {
               "type": "olm.package",
               "value": {
               "packageName": "example-extension",
               "version": "0.0.1"
               }
           },
           {
               "type": "olm.bundle.mediatype",
               "value": "plain+v0"
           }
       ]
   }
   {
       "schema": "olm.channel",
       "name": "preview",
       "package": "example-extension",
       "entries": [
           {
               "name": "example-extension.v0.0.1"
           }
       ]
   }

2. 运行以下命令验证您的目录：

   $ opm validate <catalog_dir>

流程

1. 运行以下命令，将基于文件的目录构建为镜像：

   $ podman build -f <catalog_dir>.Dockerfile -t \
       quay.io/<organization_name>/<repository_name>:<image_tag> .

2. 运行以下命令来推送目录镜像：

   $ podman push quay.io/<organization_name>/<repository_name>:<image_tag>