percona/olm

OLM分支版镜像文档

镜像概述和主要用途

本镜像为OLM（Operator Lifecycle Manager）的分支版本，基于原生OLM功能进行定制或修改。OLM是Kubernetes生态系统中的核心工具，专门用于管理Operator的完整生命周期。该分支版本保留了原生OLM的核心能力，同时可能包含特定场景下的定制化功能，旨在简化Operator在Kubernetes集群中的安装、升级、配置、依赖管理及删除等操作，适用于需要对Operator生命周期进行精细化管控的Kubernetes环境。

核心功能和特性

1. Operator全生命周期管理

• 安装自动化：支持通过CatalogSource、Subscription等资源定义，自动化拉取和部署Operator
• 升级策略：支持手动/自动升级模式，可配置升级通道（如stable、beta）和版本选择
• 卸载清理：提供安全的Operator卸载流程，自动清理相关资源（Deployment、CRD等）

2. 依赖与兼容性管理

• 依赖解析：自动识别并处理Operator间的依赖关系，避免版本冲突
• 集群兼容性校验：内置Kubernetes版本兼容性检查，确保Operator与集群环境匹配

3. 版本与配置控制

• 多版本并存：支持同一Operator的多个版本在集群中并行部署（需命名空间隔离）
• 配置持久化：通过OperatorGroup、ConfigMap等资源实现Operator配置的持久化和动态更新

4. 可观测性与扩展

• 状态监控：暴露Prometheus指标接口，支持监控Operator部署状态和生命周期事件
• 扩展点：预留自定义钩子（Hook）接口，支持集成外部审批流程或通知系统

使用场景和适用范围

典型场景

• 企业级Kubernetes集群管理：统一管控多团队、多环境中的Operator部署
• 定制化OLM需求：原生OLM功能无法满足时（如特定升级策略、私有CatalogSource适配）
• Operator开发与测试：为Operator开发者提供带定制功能的生命周期管理工具

适用范围

• Kubernetes集群版本：v1.21+（需兼容CRD v1 API）
• 部署环境：私有/公有云Kubernetes集群、本地开发环境（如minikube、kind）
• 用户角色：Kubernetes集群管理员、平台工程师、Operator开发者

使用方法和配置说明

前置条件

• 已部署Kubernetes集群（v1.21+）
• 具备集群管理员权限（cluster-admin）
• kubectl工具已配置并连接目标集群

部署步骤

1. 安装CRD与基础资源

分支版OLM依赖特定CRD（CustomResourceDefinition），需先部署：

bash
# 拉取分支版OLM的CRD定义文件（示例URL需替换为实际地址）
kubectl apply -f https://example.com/olm-fork/crds.yaml

# 部署OLM核心组件（Deployment、ServiceAccount等）
kubectl apply -f https://example.com/olm-fork/olm.yaml

2. 验证部署状态

bash
# 检查OLM控制器Pod状态（默认部署在olm命名空间）
kubectl get pods -n olm
# 预期输出包含以下Pod（名称可能因分支版本略有差异）：
# olm-operator-xxx   1/1     Running
# catalog-operator-xxx   1/1     Running

核心配置说明

1. 环境变量配置（针对olm-operator容器）

2. 核心自定义资源（CR）说明

CatalogSource

定义Operator的元数据和镜像源，示例：

yaml
apiVersion: operators.coreos.com/v1alpha1
kind: CatalogSource
metadata:
  name: my-custom-catalog
  namespace: olm
spec:
  sourceType: grpc
  image: example.com/olm-fork/catalog:v1.0.0  # 分支版Catalog镜像
  displayName: "Custom Operator Catalog"
  publisher: "Internal Team"

Subscription

订阅Operator并配置安装策略，示例：

yaml
apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: my-operator-sub
  namespace: operators
spec:
  name: my-operator
  channel: stable  # 升级通道
  source: my-custom-catalog  # 关联上述CatalogSource名称
  sourceNamespace: olm
  installPlanApproval: Automatic  # 自动批准安装计划

常用操作示例

安装Operator

1. 创建CatalogSource（指向包含目标Operator的镜像仓库）
2. 创建Subscription（指定Operator名称、通道和CatalogSource）
3. 验证安装状态：

bash
# 查看安装计划（InstallPlan）
kubectl get installplan -n operators
# 查看部署的Operator Pod
kubectl get pods -n operators

升级Operator

修改Subscription的channel或startingCSV（CSV：ClusterServiceVersion）字段：

bash
kubectl patch subscription my-operator-sub -n operators \
  --type merge \
  -p '{"spec": {"channel": "beta", "startingCSV": "my-operator.v2.0.0"}}'

卸载Operator

删除Subscription和相关资源：

bash
kubectl delete subscription my-operator-sub -n operators
# （可选）清理残留CRD（需谨慎，可能影响其他资源）
kubectl delete crd <operator-specific-crd>

注意事项

• 分支版OLM可能与原生OLM存在兼容性冲突，不可同时部署
• 升级分支版前需备份CRD数据，避免配置丢失
• 私有CatalogSource需确保集群可访问镜像仓库（配置imagePullSecret）

如需更多定制配置或故障排查，可参考分支版OLM的官方文档（如有）或查看控制器日志：

bash
kubectl logs -n olm deployment/olm-operator -f