使用OLM部署Operator时触发bundle大小限制的原因及解决方法

在使用OLM部署Operator Bundle过程中可能遇到如下报错：

level=error msg="File with size ... exceeded 1048576 limit, aborting" file=/bundle/manifests/crd.yaml
Error: error loading manifests from directory: file crd.yaml bigger than total allowed limit
Usage:
  opm alpha bundle extract [flags]

报错里的1048576字节即1MiB，这个阈值是opm客户端工具内置的硬编码校验规则，触发点是opm alpha bundle extract命令加载bundle清单目录的环节。设计这个限制的初衷是防止单文件过大导致bundle镜像过度臃肿、OLM在集群侧解析资源时占用过多内存、甚至拖慢API Server响应，该限制仅在opm构建、提取bundle的本地流程生效，不是Kubernetes或集群侧运行的OLM组件本身的资源大小限制。

• 拆分合并的CRD文件
  绝大多数该报错都是因为将所有CRD定义全部合并写入同一个crd.yaml文件导致的，正常单个CRD定义基本不会超过1MiB。只需要把大文件内的每个CRD拆分为独立的YAML文件，保证单文件体积低于1MiB即可，OLM会自动递归读取manifests目录下的所有合法Kubernetes资源，拆分操作完全不影响正常部署逻辑。
• 手动调大限制阈值
  较新版本的opm在bundle构建、提取相关子命令中提供了--max-file-size启动参数，可以手动指定单文件大小上限，比如执行命令时追加--max-file-size=10485760即可将限制放宽到10MiB。注意使用该方式前要确认集群中部署的OLM版本对大尺寸manifest的解析兼容性，避免本地校验通过但集群侧加载失败。
• 精简CRD冗余内容
  如果确实存在单个CRD体积超过1MiB的场景，可以检查CRD内的非必要内容并删除：比如已经废弃的历史版本OpenAPI schema、无实际作用的长段注释、内嵌的冗余示例配置等，在不影响CRD功能的前提下将文件体积压缩到限制内，同时还能减小bundle整体体积，提升部署加载效率。

内容的提问来源于stack exchange，提问作者Galletti_Lance