Tutorials

Deep-dive tutorials that build understanding through practical exploration.

Expand your OCM knowledge through comprehensive tutorials that explore advanced topics and real-world scenarios. These tutorials guide you through complex workflows, helping you understand how different OCM features work together.

What Are Tutorials?

Tutorials are understanding-oriented lessons that build comprehensive knowledge through hands-on exploration. Unlike getting-started guides that focus on basic workflows, these tutorials dive deeper into specific topics, showing you how to work with OCM in more complex scenarios.

Each tutorial provides:

  • Detailed explanations of concepts and their relationships
  • Step-by-step guidance through complete workflows
  • Real-world examples and use cases
  • Best practices and patterns

Prerequisites

Before exploring these tutorials, you should have:

  • Completed the Getting Started guides to understand OCM fundamentals
  • Basic familiarity with Kubernetes and container workflows
  • A test environment where you can experiment safely

Learning Path

These tutorials follow the understanding-oriented approach from the Diataxis framework. They help you gain deeper knowledge by exploring topics in detail, beyond basic usage. If you’re just starting out, complete the Getting Started guides first to learn essential OCM workflows.

For task-specific guidance, check the How-to Guides section. To understand OCM’s architectural principles, visit the Concepts section.

Configure a Versioning Scheme
Teach OCM to accept and order calendar-versioned (CalVer) component versions using a versioning configuration.
Create a Multi-Component Product
Learn to compose a multi-level product from independently versioned components using the component constructor.
Signing and Verification
Tutorials covering cryptographic signing and verification of OCM component versions, from basic key-pair signing to keyless approaches using Sigstore.
Understand Credential Resolution
Learn how OCM resolves credentials by building a config and observing which credentials get picked for different requests.
Deploy an Application from a Helm Chart with OCM and kro
Bootstrap a Helm chart deployment with OCM and kro, delivered through a GitOps deployer (Flux or Argo CD), for repeatable installs.
Deploy an Application from Chained RGDs with OCM and kro
Package an OCM component with two chained kro ResourceGraphDefinitions and deploy it as plain manifests, no Helm chart or GitOps deployer needed.
Working with HTTP Resources
Understand the Wget input and access types in depth: the input/access model, credentials, media types, digest pinning, download tuning, and migrating from OCM v1.
Configure Custom Uploads During Transfer
Learn how to route resources to a custom HTTP upload target during transfer using an uploader configuration, instead of embedding them as local blobs.
Working with SBOMs
Link an SBOM to a resource and discover one was attached in another way.
Working with Git Repositories
Add a Git repository to a component version as a resource, as a source, and as an embedded snapshot, then download it back.
Working with OCI
Embed OCI image layouts in component versions and access them natively from OCI registries after transfer.
Working with Resolvers
Configure resolvers to recursively resolve component references from a shared repository.