Inferensys

Glossary

Operator Lifecycle Manager (OLM)

A Kubernetes operator that manages the installation, upgrade, and lifecycle of other operators, with a dedicated catalog mechanism for mirroring operator content to disconnected environments.
Stylish WeWork-like workspace with hot desks and document wall, professional searching through enterprise knowledge base on a mounted ultrawide display, warm industrial pendants overhead.
KUBERNETES OPERATOR GOVERNANCE

What is Operator Lifecycle Manager (OLM)?

A framework for managing the full lifecycle of Kubernetes operators in disconnected environments.

The Operator Lifecycle Manager (OLM) is a Kubernetes-native framework that automates the installation, upgrade, and role-based access control of cluster operators and their dependencies. It extends the Kubernetes API with ClusterServiceVersion, Subscription, and CatalogSource resources to declaratively manage operator lifecycles, ensuring consistent, repeatable deployments across any environment.

For disconnected Kubernetes clusters, OLM provides a critical catalog mirroring mechanism. Administrators can use oc adm catalog mirror to copy an entire operator catalog's container images and manifests to a private registry inside an air gap, enabling the discovery and installation of operators like the GPU Operator or Prometheus without any external network connectivity.

Operator Lifecycle Manager

Key Features of OLM

Operator Lifecycle Manager (OLM) extends Kubernetes with a declarative framework to manage the full lifecycle of operators and their dependencies, from installation and upgrade to resource consumption and access control.

01

Declarative Dependency Resolution

OLM models operator dependencies as a constraint satisfaction problem. It uses a resolver to automatically find a set of operators and API versions that satisfy all requirements without conflicts. This prevents the manual troubleshooting of incompatible Custom Resource Definition (CRD) versions.

  • Constraint Model: Defines required and provided APIs.
  • Automatic Resolution: Installs dependent operators automatically.
  • Conflict Prevention: Blocks installations that would break existing APIs.
02

Catalog-Based Content Delivery

OLM uses a CatalogSource—a custom resource representing a registry of operator metadata—to discover installable operators. Catalogs are built from File-Based Catalogs (FBC), a declarative format that replaces the legacy SQLite registry images. This structure is critical for disconnected environments, as the entire catalog can be mirrored to a Private Registry using oc-mirror.

  • CatalogSource CRD: Defines the endpoint for a catalog.
  • File-Based Catalog: A directory of YAML files representing operator bundles.
  • Mirroring: Enables full offline operator lifecycle management.
03

Subscription and Update Management

A Subscription resource links a namespace to an operator from a specific catalog channel. OLM manages the update path, automatically upgrading the operator when a new version is available in the subscribed channel. Manual approval strategies allow administrators to gate updates before they are applied.

  • Channels: Semantic update streams (e.g., stable, fast).
  • Approval Strategies: Automatic or Manual to control rollout timing.
  • Replacement Graphs: Defines valid upgrade edges between operator versions.
04

Operator Bundle Format

An Operator Bundle is the fundamental packaging unit for OLM. It is a container image containing a single ClusterServiceVersion (CSV) manifest and all associated CRDs. The CSV declares the operator's metadata, installation requirements, owned APIs, and deployment strategy.

  • ClusterServiceVersion (CSV): The declarative manifest for an operator instance.
  • Owned APIs: CRDs the operator manages.
  • Install Modes: Defines supported scopes (OwnNamespace, AllNamespaces).
05

API Lifecycle and Deprecation

OLM enforces strict API lifecycle rules to prevent disruption. When an operator upgrades, OLM ensures that no other operator in the cluster depends on a deprecated API version before allowing the upgrade to proceed. This prevents orphaned CRD instances and broken integrations.

  • API Service: A mechanism for operators to expose non-CRD APIs.
  • Deprecation Warnings: Alerts administrators to upcoming API removals.
  • Garbage Collection: Automatically cleans up resources when an operator is uninstalled.
06

OperatorGroups and Multitenancy

An OperatorGroup is an OLM resource that defines the set of target namespaces for a group of operators. It enables fine-grained multitenancy by controlling which namespaces an operator can watch and operate within, preventing privilege escalation and resource contention.

  • Target Namespace Selection: Static or dynamic label-based selection.
  • ServiceAccount Management: Associates operators with specific RBAC permissions.
  • Copied CSVs: OLM copies the operator's service accounts and roles into target namespaces.
OPERATOR LIFECYCLE MANAGEMENT

Frequently Asked Questions

Clear, technical answers to the most common questions about deploying and managing the Operator Lifecycle Manager in disconnected and air-gapped Kubernetes environments for AI infrastructure.

The Operator Lifecycle Manager (OLM) is a Kubernetes operator that extends the platform's control loop to manage the full lifecycle of other operators, including their installation, upgrade, and dependency resolution. It operates by defining two primary extension resources: a ClusterServiceVersion (CSV), which contains the metadata, installation strategy, and permissions for a specific operator version, and a CatalogSource, which acts as a curated repository of available operators. When an administrator creates a Subscription to an operator, the OLM controller continuously reconciles the desired state by querying the catalog, resolving dependency graphs, and automatically applying the required CSVs and RBAC rules. This mechanism replaces manual, error-prone kubectl apply workflows with a declarative, automated system that can perform zero-downtime rolling updates and safely manage Custom Resource Definition (CRD) lifecycle conflicts. In disconnected environments, the OLM's catalog is mirrored to a private registry, ensuring the same automated lifecycle management operates without any external network dependency.

Prasad Kumkar

About the author

Prasad Kumkar

CEO & MD, Inference Systems

Prasad Kumkar is the CEO & MD of Inference Systems and writes about AI systems architecture, LLM infrastructure, model serving, evaluation, and production deployment. Over 5+ years, he has worked across computer vision models, L5 autonomous vehicle systems, and LLM research, with a focus on taking complex AI ideas into real-world engineering systems.

His work and writing cover AI systems, large language models, AI agents, multimodal systems, autonomous systems, inference optimization, RAG, evaluation, and production AI engineering.