5.7. 使用捆绑包镜像

您可以使用 Operator SDK 来使用捆绑格式（Bundle Format）来打包 Operator。

5.7.1. 构建捆绑包镜像

您可以使用 Operator SDK 来构建、推送并验证 Operator 捆绑包镜像。

先决条件

  • operator SDK 版本 0.19.4
  • podman 版本 1.9.3+
  • 使用 Operator SDK 生成一个 Operator 项目

  • 访问支持 Docker v2-2 的 registry

    重要

    OpenShift Container Platform 集群的内部 registry 不能用作目标 registry，因为它不支持没有标签的推送（在镜像过程中需要这个功能）。

流程

  1. 在 Operator 项目目录中运行以下 make 命令来构建和推送 Operator 镜像。在以下步骤中修改 IMG 参数来引用您可访问的库。您可以获取在存储库站点（如 Quay.io）存储容器的帐户。

    1. 构建镜像： 

      $ make docker-build IMG=<registry>/<user>/<operator_image_name>:<tag>
      注意

      由 SDK 为 Operator 生成的 Dockerfile 明确引用了 go 构建 的 GOARCH=amd64。对于非 AMD64 构架，这已被应用于 GOARCH=$TARGETARCH。Docker 会自动将 环境变量设置为 -platform 指定的值。使用 Buildah，-build-arg 需要用于目的。如需更多信息，请参阅 多个架构。

    2. 将镜像推送到存储库： 

      $ make docker-push IMG=<registry>/<user>/<operator_image_name>:<tag>

  2. 更新 Makefile，将 IMG URL 设置为您已推送的 Operator 镜像的名称和标签： 

    $ # Image URL to use all building/pushing image targets
IMG ?= <registry>/<user>/<operator_image_name>:<tag>

    这个值用于后续操作。

  3. 运行 make bundle 命令创建 Operator 捆绑包清单，该命令调用多个命令，其中包括 Operator SDK generate bundle 和 bundle validate 子命令： 

    $ make bundle

    Operator 的捆绑包清单描述了如何显示、创建和管理应用程序。make bundle 命令在 Operator 项目中创建以下文件和目录：

    • 包含 ClusterServiceVersion 对象的捆绑包清单目录，名为 bundle/manifests
    • 名为 bundle/metadata 的捆绑包元数据目录
    • config/crd 目录中的所有自定义资源定义（CRD）
    • 一个 Dockerfile bundle.Dockerfile

    然后，使用 operator-sdk bundle validate 自动验证这些文件，以确保磁盘上的捆绑包的格式是正确的。

  4. 运行以下命令来构建和推送捆绑包镜像。OLM 使用索引镜像来消耗 Operator 捆绑包，该镜像引用一个或多个捆绑包镜像。

    1. 构建捆绑包镜像。使用您要推送镜像的 registry、用户命名空间和镜像标签的详情，设置 BUNDLE_IMG： 

      $ make bundle-build BUNDLE_IMG=<registry>/<user>/<bundle_image_name>:<tag>

    2. 推送捆绑包镜像： 

      $ docker push <registry>/<user>/<bundle_image_name>:<tag>