controller

package
v0.16.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Feb 23, 2026 License: Apache-2.0 Imports: 20 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	AnnotationKeyDisplayName = "openchoreo.dev/display-name"
	AnnotationKeyDescription = "openchoreo.dev/description"
)
View Source 
const (
	TypeAccepted    = "Accepted"
	TypeProgressing = "Progressing"
	TypeAvailable   = "Available"
	TypeCreated     = "Created"
	TypeReady       = "Ready"
	TypeTerminating = "Terminating"
)

States for conditions

View Source 
const (
	// IndexKeyReleaseBindingOwnerComponentName indexes ReleaseBinding by owner component name.
	IndexKeyReleaseBindingOwnerComponentName = "releasebinding.spec.owner.componentName"

	// IndexKeyComponentOwnerProjectName indexes Component by owner project name.
	IndexKeyComponentOwnerProjectName = "component.spec.owner.projectName"

	// IndexKeyProjectDeploymentPipelineRef indexes Project by deploymentPipelineRef.
	IndexKeyProjectDeploymentPipelineRef = "project.spec.deploymentPipelineRef"
)

Shared field index keys for use across controllers. These constants ensure consistency when multiple controllers need to use the same field index.

View Source 
const (
	// DefaultPlaneName is the default name for plane resources when no explicit reference is provided
	DefaultPlaneName = "default"
)
View Source 
const (
	// StatusUpdateInterval is the interval at which controllers should refresh status fields
	// This is used for periodic status updates like agent connection status
	StatusUpdateInterval = 1 * time.Minute
)

Status update intervals

Variables

This section is empty.

Functions

func FindProjectByName added in v0.16.0 

func FindProjectByName(ctx context.Context, c client.Client, namespace, projectName string) (*openchoreov1alpha1.Project, error)

FindProjectByName looks up a Project by name in the given namespace using label matching. This is useful for objects (like ComponentWorkflowRun) that don't have hierarchy labels but know their project name from spec.owner.projectName.

func GetBuildName added in v0.2.0 

func GetBuildName(obj client.Object) string

GetBuildName returns the build name that the object belongs to.

func GetClusterObservabilityPlaneOfClusterBuildPlane added in v0.15.0 

func GetClusterObservabilityPlaneOfClusterBuildPlane(ctx context.Context, c client.Client, clusterBuildPlane *openchoreov1alpha1.ClusterBuildPlane) (*openchoreov1alpha1.ClusterObservabilityPlane, error)

GetClusterObservabilityPlaneOfClusterBuildPlane retrieves the ClusterObservabilityPlane for a ClusterBuildPlane. If ObservabilityPlaneRef is not specified, it defaults to a ClusterObservabilityPlane named "default".

func GetClusterObservabilityPlaneOfClusterDataPlane added in v0.15.0 

func GetClusterObservabilityPlaneOfClusterDataPlane(ctx context.Context, c client.Client, clusterDataPlane *openchoreov1alpha1.ClusterDataPlane) (*openchoreov1alpha1.ClusterObservabilityPlane, error)

GetClusterObservabilityPlaneOfClusterDataPlane retrieves the ClusterObservabilityPlane for a ClusterDataPlane. If ObservabilityPlaneRef is not specified, it defaults to a ClusterObservabilityPlane named "default".

func GetComponent 

func GetComponent(ctx context.Context, c client.Client, obj client.Object) (*openchoreov1alpha1.Component, error)

func GetComponentName 

func GetComponentName(obj client.Object) string

GetComponentName returns the component name that the object belongs to.

func GetDataPlane added in v0.2.0 

func GetDataPlane(ctx context.Context, c client.Client, obj client.Object) (*openchoreov1alpha1.DataPlane, error)

func GetDataPlaneByEnvironment added in v0.2.0 

func GetDataPlaneByEnvironment(ctx context.Context, c client.Client, env *openchoreov1alpha1.Environment) (*openchoreov1alpha1.DataPlane, error)

GetDataPlaneByEnvironment retrieves the DataPlane object for the given Environment. It uses the DataPlaneRef field in the Environment to find the DataPlane object. Note: This function only returns DataPlane, not ClusterDataPlane. For environments referencing ClusterDataPlane, use GetDataPlaneOrClusterDataPlaneOfEnv from reference.go.

func GetDataPlaneName added in v0.2.0 

func GetDataPlaneName(obj client.Object) string

GetDataPlaneName returns the data plane name that the object belongs to.

func GetDataplaneOfEnv added in v0.2.0 

func GetDataplaneOfEnv(ctx context.Context, c client.Client, env *openchoreov1alpha1.Environment) (*openchoreov1alpha1.DataPlane, error)

GetDataplaneOfEnv retrieves the DataPlane for the given Environment. If DataPlaneRef is not specified, it defaults to a DataPlane named "default" in the same namespace. If DataPlaneRef specifies ClusterDataPlane kind, it looks up a cluster-scoped ClusterDataPlane.

func GetDeploymentPipeline 

func GetDeploymentPipeline(ctx context.Context, c client.Client, obj client.Object, dpName string) (*openchoreov1alpha1.DeploymentPipeline, error)

func GetDeploymentTrack 

func GetDeploymentTrack(ctx context.Context, c client.Client, obj client.Object) (*openchoreov1alpha1.DeploymentTrack, error)

func GetDeploymentTrackName 

func GetDeploymentTrackName(obj client.Object) string

GetDeploymentTrackName returns the deployment track name that the object belongs to.

func GetDescription 

func GetDescription(obj client.Object) string

GetDescription returns the description of the object.

func GetDisplayName 

func GetDisplayName(obj client.Object) string

GetDisplayName returns the display name of the object.

func GetEnvironment 

func GetEnvironment(ctx context.Context, c client.Client, obj client.Object) (*openchoreov1alpha1.Environment, error)

func GetEnvironmentByName 

func GetEnvironmentByName(ctx context.Context, c client.Client, obj client.Object, envName string) (*openchoreov1alpha1.Environment, error)

func GetEnvironmentName 

func GetEnvironmentName(obj client.Object) string

GetEnvironmentName returns the environment name that the object belongs to.

func GetName 

func GetName(obj client.Object) string

GetName returns the name of the object. This is specific to the Choreo, and it is not the Kubernetes object name.

func GetNamespaceName added in v0.13.0 

func GetNamespaceName(obj client.Object) string

GetNamespaceName returns the namespace name that the object belongs to.

func GetObservabilityPlaneOfBuildPlane added in v0.14.0 

func GetObservabilityPlaneOfBuildPlane(ctx context.Context, c client.Client, buildPlane *openchoreov1alpha1.BuildPlane) (*openchoreov1alpha1.ObservabilityPlane, error)

GetObservabilityPlaneOfBuildPlane retrieves the ObservabilityPlane for the given BuildPlane. If ObservabilityPlaneRef is not specified, it defaults to an ObservabilityPlane named "default" in the same namespace. This function returns only the ObservabilityPlane; use GetObservabilityPlaneOrClusterObservabilityPlaneOfBuildPlane if the ref may point to a ClusterObservabilityPlane.

func GetObservabilityPlaneOfDataPlane added in v0.14.0 

func GetObservabilityPlaneOfDataPlane(ctx context.Context, c client.Client, dataPlane *openchoreov1alpha1.DataPlane) (*openchoreov1alpha1.ObservabilityPlane, error)

GetObservabilityPlaneOfDataPlane retrieves the ObservabilityPlane for the given DataPlane. If ObservabilityPlaneRef is not specified, it defaults to an ObservabilityPlane named "default" in the same namespace. This function returns only the ObservabilityPlane; use GetObservabilityPlaneOrClusterObservabilityPlaneOfDataPlane if the ref may point to a ClusterObservabilityPlane.

func GetProject 

func GetProject(ctx context.Context, c client.Client, obj client.Object) (*openchoreov1alpha1.Project, error)

func GetProjectName 

func GetProjectName(obj client.Object) string

GetProjectName returns the project name that the object belongs to.

func HasPatchChanges added in v0.3.0 

func HasPatchChanges(original, desired client.Object) (bool, []byte, error)

HasPatchChanges determines if two Kubernetes objects have differences by comparing their patch data.

func HierarchyWatchHandler 

func HierarchyWatchHandler[From client.Object, To client.Object](
	c client.Client,
	hierarchyFunc HierarchyFunc[To],
) func(ctx context.Context, obj client.Object) []reconcile.Request

HierarchyWatchHandler is a function that creates a watch handler for a specific hierarchy. It can be used to watch from parent object for child object updates. The hierarchyFunc should return the target object that is being watched given the source object.

func IgnoreHierarchyNotFoundError 

func IgnoreHierarchyNotFoundError(err error) error

IgnoreHierarchyNotFoundError returns nil if the given error is a HierarchyNotFoundError. This is useful during the reconciliation process to ignore the error if the parent object is not found and avoid retrying.

func MarkFalseCondition added in v0.3.0 

func MarkFalseCondition(obj ConditionedObject, ct ConditionType, reason ConditionReason, message string) (changed bool)

func MarkTrueCondition added in v0.3.0 

func MarkTrueCondition(obj ConditionedObject, ct ConditionType, reason ConditionReason, message string) (changed bool)

func MarkUnknownCondition added in v0.3.0 

func MarkUnknownCondition(obj ConditionedObject, ct ConditionType, reason ConditionReason, message string) (changed bool)

func Merge added in v0.3.0 

func Merge[T any](base, overlay *T) (*T, error)

Merge applies a strategic merge patch to the base object using the overlay object. This function uses Kubernetes strategic merge patch semantics to combine two objects of the same type.

Parameters:

  • base: the original object to merge into
  • overlay: the object containing changes to apply

Returns:

  • *T: the merged result object, or nil if either input is nil
  • error: any error that occurred during marshaling, patching, or unmarshaling

Example usage: 

base := &v1.Pod{ObjectMeta: metav1.ObjectMeta{Name: "test"}}
overlay := &v1.Pod{Spec: v1.PodSpec{RestartPolicy: v1.RestartPolicyAlways}}
merged, err := controller.Merge(base, overlay)
if err != nil {
    return fmt.Errorf("failed to merge: %w", err)
}

func NeedConditionUpdate 

func NeedConditionUpdate(currentConditions, updatedConditions []metav1.Condition) bool

NeedConditionUpdate checks if the conditions need to be updated based on the current and updated conditions.

func NewCondition 

func NewCondition(conditionType ConditionType, status metav1.ConditionStatus, reason ConditionReason,
	message string, observedGeneration int64) metav1.Condition

NewCondition creates a new condition with the last transition time set to the current time.

func NewHierarchyNotFoundError 

func NewHierarchyNotFoundError(obj client.Object, parentObj client.Object, parentHierarchyObjs ...client.Object) error

NewHierarchyNotFoundError creates a new error with the given object and parent object details. The parentObj is the immediate parent of the obj The parentHierarchyObjs are the hierarchy of objects from the parentObj to the top level object starting from the top level object. Example: NewHierarchyNotFoundError(deployment, deploymentTrack, namespace, project, component)

func SetupSharedIndexes added in v0.9.0 

func SetupSharedIndexes(ctx context.Context, mgr ctrl.Manager) error

SetupSharedIndexes registers field indexes that are shared across multiple controllers. This must be called before any controllers are set up with the manager.

func UpdateCondition 

func UpdateCondition(
	ctx context.Context,
	c client.StatusWriter,
	resource client.Object,
	conditions *[]metav1.Condition,
	conditionType string,
	status metav1.ConditionStatus,
	reason, message string,
) error

UpdateCondition updates or adds a condition to any resource that has a Status with Conditions

func UpdateStatusConditions 

func UpdateStatusConditions[T ConditionedObject](
	ctx context.Context,
	c client.Client,
	current, updated T,
) error

UpdateStatusConditions will compare the current and updated conditions and update the status conditions if needed.

func UpdateStatusConditionsAndRequeue 

func UpdateStatusConditionsAndRequeue[T ConditionedObject](
	ctx context.Context, c client.Client, current, updated T,
) (ctrl.Result, error)

UpdateStatusConditionsAndRequeue updates status conditions and requests a requeue. This indicates that the controller should requeue the request for further processing. It returns an error if the status update fails.

func UpdateStatusConditionsAndRequeueAfter 

func UpdateStatusConditionsAndRequeueAfter[T ConditionedObject](
	ctx context.Context, c client.Client, current, updated T, duration time.Duration,
) (ctrl.Result, error)

UpdateStatusConditionsAndRequeueAfter updates status conditions and requeues after the specified duration. It returns an error if the status update fails.

func UpdateStatusConditionsAndReturn 

func UpdateStatusConditionsAndReturn[T ConditionedObject](
	ctx context.Context, c client.Client, current, updated T,
) (ctrl.Result, error)

UpdateStatusConditionsAndReturn updates status conditions without requeuing. It returns an error if the update fails.

func UpdateStatusConditionsAndReturnError 

func UpdateStatusConditionsAndReturnError[T ConditionedObject](
	ctx context.Context, c client.Client, current, updated T, err error,
) (ctrl.Result, error)

UpdateStatusConditionsAndReturnError updates status conditions and returns the given error. It returns an update error if the conditions update fails. It prioritizes the status update error over the provided error, if any.

func UpdateStatusConditionsWithPatch 

func UpdateStatusConditionsWithPatch[T ConditionedObject](
	ctx context.Context,
	c client.Client,
	current, updated T,
) error

UpdateStatusConditionsWithPatch updates status conditions using a patch operation with retry on conflicts. This is more robust for handling concurrent updates to the same resource.

Types

type BuildPlaneResult added in v0.15.0 

type BuildPlaneResult struct {
	BuildPlane        *openchoreov1alpha1.BuildPlane
	ClusterBuildPlane *openchoreov1alpha1.ClusterBuildPlane
}

BuildPlaneResult contains either a BuildPlane or ClusterBuildPlane

func GetBuildPlaneOrClusterBuildPlaneOfProject added in v0.15.0 

func GetBuildPlaneOrClusterBuildPlaneOfProject(ctx context.Context, c client.Client, project *openchoreov1alpha1.Project) (*BuildPlaneResult, error)

GetBuildPlaneOrClusterBuildPlaneOfProject retrieves the BuildPlane or ClusterBuildPlane for the given Project. Resolution order: 1. If Project.Spec.BuildPlaneRef is set, use that by Kind and Name 2. If not set, try BuildPlane named "default" in the same namespace 3. If "default" BuildPlane not found, try ClusterBuildPlane named "default" 4. If neither found, fall back to first available BuildPlane in namespace Returns nil without error if no BuildPlane exists (BuildPlane is optional for Projects)

func ResolveBuildPlane added in v0.16.0 

func ResolveBuildPlane(ctx context.Context, c client.Client, obj client.Object) (*BuildPlaneResult, error)

ResolveBuildPlane resolves the BuildPlane or ClusterBuildPlane for any object. It first tries to find the project via hierarchy labels (GetProject). If the project is found, it uses the project's buildPlaneRef for resolution. If the project is not found (e.g., object has no hierarchy labels), it falls back to the default resolution chain (default BuildPlane → default ClusterBuildPlane → first in namespace).

func (*BuildPlaneResult) GetK8sClient added in v0.16.0 

func (r *BuildPlaneResult) GetK8sClient(
	clientMgr *kubernetesClient.KubeMultiClientManager,
	gatewayURL string,
) (client.Client, error)

GetK8sClient returns a Kubernetes client for this build plane result. It dispatches to the correct client constructor based on whether this is a BuildPlane or ClusterBuildPlane.

func (*BuildPlaneResult) GetName added in v0.15.0 

func (r *BuildPlaneResult) GetName() string

GetName returns the name of the build plane (either BuildPlane or ClusterBuildPlane)

func (*BuildPlaneResult) GetNamespace added in v0.15.0 

func (r *BuildPlaneResult) GetNamespace() string

GetNamespace returns the namespace (empty for ClusterBuildPlane)

func (*BuildPlaneResult) GetObservabilityPlane added in v0.16.0 

func (r *BuildPlaneResult) GetObservabilityPlane(ctx context.Context, c client.Client) (*ObservabilityPlaneResult, error)

GetObservabilityPlane resolves the observability plane for this build plane result.

type ConditionReason 

type ConditionReason string

ConditionReason represents the machine-readable reason for a condition's status. Use CamelCase format (e.g., MinimumReplicasUnavailable, MinimumReplicasMet).

type ConditionType 

type ConditionType string

ConditionType represents the type of condition describing a specific state of the resource. Use CamelCase format (e.g., Ready, Available).

func (ConditionType) String 

func (c ConditionType) String() string

String returns the string representation of the condition type.

type ConditionedObject 

type ConditionedObject interface {
	client.Object

	GetConditions() []metav1.Condition
	SetConditions(conditions []metav1.Condition)
}

ConditionedObject describes a Kubernetes resource that has a mutable Conditions field in its Status

type DataPlaneResult added in v0.15.0 

type DataPlaneResult struct {
	DataPlane        *openchoreov1alpha1.DataPlane
	ClusterDataPlane *openchoreov1alpha1.ClusterDataPlane
}

DataPlaneResult contains either a DataPlane or ClusterDataPlane

func GetDataPlaneOrClusterDataPlaneOfEnv added in v0.15.0 

func GetDataPlaneOrClusterDataPlaneOfEnv(ctx context.Context, c client.Client, env *openchoreov1alpha1.Environment) (*DataPlaneResult, error)

GetDataPlaneOrClusterDataPlaneOfEnv retrieves either a DataPlane or ClusterDataPlane for the given Environment. If DataPlaneRef is not specified, it defaults to a DataPlane named "default" in the same namespace.

func (*DataPlaneResult) GetName added in v0.15.0 

func (r *DataPlaneResult) GetName() string

GetName returns the name of the data plane (either DataPlane or ClusterDataPlane)

func (*DataPlaneResult) GetNamespace added in v0.15.0 

func (r *DataPlaneResult) GetNamespace() string

GetNamespace returns the namespace (empty for ClusterDataPlane)

func (*DataPlaneResult) GetObservabilityPlane added in v0.15.0 

func (r *DataPlaneResult) GetObservabilityPlane(ctx context.Context, c client.Client) (*ObservabilityPlaneResult, error)

GetObservabilityPlane resolves the observability plane for this data plane result.

func (*DataPlaneResult) ToDataPlane added in v0.15.0 

func (r *DataPlaneResult) ToDataPlane() *openchoreov1alpha1.DataPlane

ToDataPlane returns a *DataPlane - either the real one or a facade built from ClusterDataPlane. This allows downstream code (e.g. rendering pipeline) to remain unchanged.

type HierarchyFunc 

type HierarchyFunc[T any] func(ctx context.Context, c client.Client, obj client.Object) (T, error)

HierarchyFunc is a generic function type that takes a context, client, and object as input and returns an object of type T and an error. This is used for MakeHierarchyWatchHandler to define the function that will be called to get the target object.

type HierarchyNotFoundError 

type HierarchyNotFoundError struct {
	// contains filtered or unexported fields
}

HierarchyNotFoundError is an error type that is used to indicate that a parent object in the hierarchy is not found.

func (*HierarchyNotFoundError) Error 

func (e *HierarchyNotFoundError) Error() string

type ObservabilityPlaneResult added in v0.15.0 

type ObservabilityPlaneResult struct {
	ObservabilityPlane        *openchoreov1alpha1.ObservabilityPlane
	ClusterObservabilityPlane *openchoreov1alpha1.ClusterObservabilityPlane
}

ObservabilityPlaneResult contains either an ObservabilityPlane or ClusterObservabilityPlane

func GetObservabilityPlaneOrClusterObservabilityPlaneOfBuildPlane added in v0.15.0 

func GetObservabilityPlaneOrClusterObservabilityPlaneOfBuildPlane(ctx context.Context, c client.Client, buildPlane *openchoreov1alpha1.BuildPlane) (*ObservabilityPlaneResult, error)

GetObservabilityPlaneOrClusterObservabilityPlaneOfBuildPlane retrieves either an ObservabilityPlane or ClusterObservabilityPlane for the given BuildPlane. If ObservabilityPlaneRef is not specified, it defaults to an ObservabilityPlane named "default" in the same namespace.

func GetObservabilityPlaneOrClusterObservabilityPlaneOfDataPlane added in v0.15.0 

func GetObservabilityPlaneOrClusterObservabilityPlaneOfDataPlane(ctx context.Context, c client.Client, dataPlane *openchoreov1alpha1.DataPlane) (*ObservabilityPlaneResult, error)

GetObservabilityPlaneOrClusterObservabilityPlaneOfDataPlane retrieves either an ObservabilityPlane or ClusterObservabilityPlane for the given DataPlane. If ObservabilityPlaneRef is not specified, it defaults to an ObservabilityPlane named "default" in the same namespace.

func (*ObservabilityPlaneResult) GetName added in v0.15.0 

func (r *ObservabilityPlaneResult) GetName() string

GetName returns the name of the observability plane

func (*ObservabilityPlaneResult) GetNamespace added in v0.15.0 

func (r *ObservabilityPlaneResult) GetNamespace() string

GetNamespace returns the namespace (empty for ClusterObservabilityPlane)

func (*ObservabilityPlaneResult) GetObserverURL added in v0.15.0 

func (r *ObservabilityPlaneResult) GetObserverURL() string

GetObserverURL returns the observer URL from either ObservabilityPlane or ClusterObservabilityPlane

func (*ObservabilityPlaneResult) GetPlaneID added in v0.15.0 

func (r *ObservabilityPlaneResult) GetPlaneID() string

GetPlaneID returns the plane ID from either ObservabilityPlane or ClusterObservabilityPlane

Source Files

View all Source files

Directories

Path Synopsis
engines
engines/argo
names
integrations/kubernetes
integrations/kubernetes

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.