Tutorials on Component Operator

CRD Deletion Safeguarding

Mon, 01 Jan 0001 00:00:00 +0000

This tutorial installs cert-manager using component-operator. Along the way you will see how the HelmGenerator translates Helm hook annotations into component-operator lifecycle annotations, and observe how component-operator protects against premature deletion when foreign instances of managed CRDs still exist in the cluster.

Prerequisites

You need a Kubernetes cluster with Flux source-controller and component-operator installed. If you don’t have one yet, the Cluster Setup guide walks you through creating a local kind cluster with everything in place.

Apply, Delete and Purge Orders

Mon, 01 Jan 0001 00:00:00 +0000

This tutorial shows how component-operator’s ordering annotations let you sequence the creation, deletion, and one-shot execution of dependent objects within a single component. You will use a Blueprint as the manifest source so no external Git repository or Helm repository is needed.

Prerequisites

Deploying to a Remote Cluster

Mon, 01 Jan 0001 00:00:00 +0000

This tutorial deploys a resource to a second, remote Kubernetes cluster. It demonstrates spec.kubeConfig for targeting a remote cluster, and the mustLocalLookup template function, which reads objects from the local cluster even when the component is deploying to a remote one.

Prerequisites

You need two clusters.

Local cluster (kind) — hosts Flux source-controller and component-operator. If you don’t have one yet, the Cluster Setup guide walks you through creating it.

Remote cluster (kind-target) — the deployment target. No Flux or component-operator installation is needed here. Create it now:

Nesting Components

Mon, 01 Jan 0001 00:00:00 +0000

This tutorial demonstrates nested components referencing the same source: a pattern where one Component (the outer) creates and manages another Component (the inner) as one of its dependent objects. Combining this with source pinning ensures both components consistently reconcile against the same state of the referenced source.

Prerequisites

You need a Kubernetes cluster with Flux source-controller and component-operator installed. If you don’t have one yet, follow the Cluster Setup guide.

What you will build

A single Blueprint (nesting) contains two subdirectories: