Concepts

Understand the fundamental principles and architecture of the Open Component Model.

Understand how OCM works through clear explanations of its core concepts, architecture, and design principles. This section provides the theoretical foundation you need to make informed decisions when working with OCM.

What Are Concepts?

Concepts are explanation-oriented articles that help you understand why OCM works the way it does. These pages explain the thinking behind OCM’s design, clarify relationships between different parts of the system, and provide context for the choices you’ll make when using OCM.

Each concept article:

  • Explains the “why” behind OCM features and design
  • Clarifies terminology and relationships
  • Provides architectural context
  • Connects theory to practice

Prerequisites

To get the most from these explanations, you should:

  • Have basic familiarity with software delivery concepts
  • Understand fundamental concepts like artifacts, versions, and registries
  • Ideally have tried OCM through the Getting Started guides

No hands-on experience is required - these are theoretical explanations.

Learning Path

These concepts follow the explanation-oriented approach from the Diataxis framework. They deepen your understanding of OCM’s architecture and design principles.

If you’re new to OCM, we recommend trying the Getting Started guides first to see OCM in action.

For task-specific guidance, check the How-to Guides section. For hands-on learning experiences, explore the Tutorials section.

Component Identity
How OCM identifies components, versions, and artifacts — from naming to descriptors.
Transfer and Transport
Understand how OCM moves component versions between repositories while preserving identity, integrity, and signatures.
Signing and Verification
Understanding how OCM ensures component integrity and authenticity through cryptographic signatures.
Credential System
Why OCM manages credentials centrally and how its resolution model works.
Resolvers
Learn how OCM resolvers map component name patterns to repositories for recursive resolution.
Resource Repositories
Why OCM separates resource storage from component version storage and how resource repositories work.
Canonical Component Repositories
What canonical repositories are, why component references are location-free, and how this design enables portable software delivery.
Kubernetes Controllers
Learn about the OCM controllers and their capabilities.
Kubernetes Component Discovery
How the Discovery controller resolves a Component's transitive reference graph, filters it with CEL selectors, and projects it into status.
Kubernetes Deployer
Understand how the OCM Deployer reconciles OCM resources into a Kubernetes cluster using ApplySet semantics.
Plugin System
Learn about the Plugin System and how it can help you extend OCM's capabilities.
Ownership
How OCM traces a resource back to the component version that owns it, without modifying the resource.
Software Bills of Materials
What is an SBOM and its relevance to the OCM ecosystem.