v1alpha2

package
v0.0.0-...-8127870 Latest Latest
Warning

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

Go to latest
Published: Sep 1, 2026 License: Apache-2.0 Imports: 3 Imported by: 9

Documentation

Overview

+groupName=config.openshift.io Package v1alpha2 is the v1alpha2 version of the API.

Index

Constants

This section is empty.

Variables

View Source
var (
	GroupName    = "config.openshift.io"
	GroupVersion = schema.GroupVersion{Group: GroupName, Version: "v1alpha2"}

	// Install is a function which adds this version to a scheme
	Install = schemeBuilder.AddToScheme

	// SchemeGroupVersion generated code relies on this name
	// Deprecated
	SchemeGroupVersion = GroupVersion
	// AddToScheme exists solely to keep the old generators creating valid code
	// DEPRECATED
	AddToScheme = schemeBuilder.AddToScheme
)

Functions

func Resource

func Resource(resource string) schema.GroupResource

Resource generated code relies on this being here, but it logically belongs to the group DEPRECATED

Types

type Custom

type Custom struct {
	// configs is a required list of gatherers configurations that can be used to enable or disable specific gatherers.
	// It may not exceed 100 items and each gatherer can be present only once.
	// It is possible to disable an entire set of gatherers while allowing a specific function within that set.
	// The particular gatherers IDs can be found at https://github.com/openshift/insights-operator/blob/master/docs/gathered-data.md.
	// Run the following command to get the names of last active gatherers:
	// "oc get insightsoperators.operator.openshift.io cluster -o json | jq '.status.gatherStatus.gatherers[].name'"
	// +kubebuilder:validation:MaxItems=100
	// +listType=map
	// +listMapKey=name
	// +required
	Configs []GathererConfig `json:"configs"`
}

custom provides the custom configuration of gatherers

func (*Custom) DeepCopy

func (in *Custom) DeepCopy() *Custom

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Custom.

func (*Custom) DeepCopyInto

func (in *Custom) DeepCopyInto(out *Custom)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (Custom) OpenAPIModelName

func (in Custom) OpenAPIModelName() string

OpenAPIModelName returns the OpenAPI model name for this type.

func (Custom) SwaggerDoc

func (Custom) SwaggerDoc() map[string]string

type DataPolicyOption

type DataPolicyOption string

dataPolicyOption declares valid data policy options +kubebuilder:validation:Enum=ObfuscateNetworking;WorkloadNames

const (
	// IP addresses and cluster domain name are obfuscated
	DataPolicyOptionObfuscateNetworking DataPolicyOption = "ObfuscateNetworking"
	// Data from Deployment Validation Operator are obfuscated
	DataPolicyOptionObfuscateWorkloadNames DataPolicyOption = "WorkloadNames"
)

type GatherConfig

type GatherConfig struct {
	// dataPolicy is an optional list of DataPolicyOptions that allows user to enable additional obfuscation of the Insights archive data.
	// It may not exceed 2 items and must not contain duplicates.
	// Valid values are ObfuscateNetworking and WorkloadNames.
	// When set to ObfuscateNetworking the IP addresses and the cluster domain name are obfuscated.
	// When set to WorkloadNames, the gathered data about cluster resources will not contain the workload names for your deployments. Resources UIDs will be used instead.
	// When omitted no obfuscation is applied.
	// +kubebuilder:validation:MaxItems=2
	// +kubebuilder:validation:XValidation:rule="self.all(x, self.exists_one(y, x == y))",message="dataPolicy items must be unique"
	// +listType=atomic
	// +optional
	DataPolicy []DataPolicyOption `json:"dataPolicy"`
	// gatherers is a required field that specifies the configuration of the gatherers.
	// +required
	Gatherers Gatherers `json:"gatherers"`
	// storage is an optional field that allows user to define persistent storage for gathering jobs to store the Insights data archive.
	// If omitted, the gathering job will use ephemeral storage.
	// +optional
	Storage *Storage `json:"storage,omitempty"`
}

gatherConfig provides data gathering configuration options.

func (*GatherConfig) DeepCopy

func (in *GatherConfig) DeepCopy() *GatherConfig

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new GatherConfig.

func (*GatherConfig) DeepCopyInto

func (in *GatherConfig) DeepCopyInto(out *GatherConfig)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (GatherConfig) OpenAPIModelName

func (in GatherConfig) OpenAPIModelName() string

OpenAPIModelName returns the OpenAPI model name for this type.

func (GatherConfig) SwaggerDoc

func (GatherConfig) SwaggerDoc() map[string]string

type GathererConfig

type GathererConfig struct {
	// name is the required name of a specific gatherer
	// It may not exceed 256 characters.
	// The format for a gatherer name is: {gatherer}/{function} where the function is optional.
	// Gatherer consists of a lowercase letters only that may include underscores (_).
	// Function consists of a lowercase letters only that may include underscores (_) and is separated from the gatherer by a forward slash (/).
	// The particular gatherers can be found at https://github.com/openshift/insights-operator/blob/master/docs/gathered-data.md.
	// Run the following command to get the names of last active gatherers:
	// "oc get insightsoperators.operator.openshift.io cluster -o json | jq '.status.gatherStatus.gatherers[].name'"
	// +kubebuilder:validation:MaxLength=256
	// +kubebuilder:validation:XValidation:rule=`self.matches("^[a-z]+[_a-z]*[a-z]([/a-z][_a-z]*)?[a-z]$")`,message=`gatherer name must be in the format of {gatherer}/{function} where the gatherer and function are lowercase letters only that may include underscores (_) and are separated by a forward slash (/) if the function is provided`
	// +required
	Name string `json:"name"`
	// state is a required field that allows you to configure specific gatherer. Valid values are "Enabled" and "Disabled".
	// When set to Enabled the gatherer will run.
	// When set to Disabled the gatherer will not run.
	// +required
	State GathererState `json:"state"`
}

gathererConfig allows to configure specific gatherers

func (*GathererConfig) DeepCopy

func (in *GathererConfig) DeepCopy() *GathererConfig

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new GathererConfig.

func (*GathererConfig) DeepCopyInto

func (in *GathererConfig) DeepCopyInto(out *GathererConfig)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (GathererConfig) OpenAPIModelName

func (in GathererConfig) OpenAPIModelName() string

OpenAPIModelName returns the OpenAPI model name for this type.

func (GathererConfig) SwaggerDoc

func (GathererConfig) SwaggerDoc() map[string]string

type GathererState

type GathererState string

state declares valid gatherer state types. +kubebuilder:validation:Enum=Enabled;Disabled

const (
	// GathererStateEnabled gatherer state, which means that the gatherer will run.
	GathererStateEnabled GathererState = "Enabled"
	// GathererStateDisabled gatherer state, which means that the gatherer will not run.
	GathererStateDisabled GathererState = "Disabled"
)

type Gatherers

type Gatherers struct {
	// mode is a required field that specifies the mode for gatherers. Allowed values are All, None, and Custom.
	// When set to All, all gatherers wil run and gather data.
	// When set to None, all gatherers will be disabled and no data will be gathered.
	// When set to Custom, the custom configuration from the custom field will be applied.
	// +required
	Mode GatheringMode `json:"mode"`
	// custom provides gathering configuration.
	// It is required when mode is Custom, and forbidden otherwise.
	// Custom configuration allows user to disable only a subset of gatherers.
	// Gatherers that are not explicitly disabled in custom configuration will run.
	// +optional
	Custom *Custom `json:"custom,omitempty"`
}

+kubebuilder:validation:XValidation:rule="has(self.mode) && self.mode == 'Custom' ? has(self.custom) : !has(self.custom)",message="custom is required when mode is Custom, and forbidden otherwise"

func (*Gatherers) DeepCopy

func (in *Gatherers) DeepCopy() *Gatherers

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Gatherers.

func (*Gatherers) DeepCopyInto

func (in *Gatherers) DeepCopyInto(out *Gatherers)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (Gatherers) OpenAPIModelName

func (in Gatherers) OpenAPIModelName() string

OpenAPIModelName returns the OpenAPI model name for this type.

func (Gatherers) SwaggerDoc

func (Gatherers) SwaggerDoc() map[string]string

type GatheringMode

type GatheringMode string

gatheringMode defines the valid gathering modes. +kubebuilder:validation:Enum=All;None;Custom

const (
	// Enabled enables all gatherers
	GatheringModeAll GatheringMode = "All"
	// Disabled disables all gatherers
	GatheringModeNone GatheringMode = "None"
	// Custom applies the configuration from GatheringConfig.
	GatheringModeCustom GatheringMode = "Custom"
)

type InsightsDataGather

type InsightsDataGather struct {
	metav1.TypeMeta `json:",inline"`
	// metadata is the standard object's metadata.
	// More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
	// +optional
	metav1.ObjectMeta `json:"metadata,omitempty"`
	// spec holds user settable values for configuration
	// +required
	Spec InsightsDataGatherSpec `json:"spec"`
	// status holds observed values from the cluster. They may not be overridden.
	// +optional
	Status InsightsDataGatherStatus `json:"status"`
}

+genclient +genclient:nonNamespaced +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object

InsightsDataGather provides data gather configuration options for the the Insights Operator.

Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support. +kubebuilder:object:root=true +kubebuilder:resource:path=insightsdatagathers,scope=Cluster +kubebuilder:subresource:status +openshift:api-approved.openshift.io=https://github.com/openshift/api/pull/2195 +openshift:file-pattern=cvoRunLevel=0000_10,operatorName=config-operator,operatorOrdering=01 +openshift:enable:FeatureGate=InsightsConfig +openshift:compatibility-gen:level=4 +openshift:capability=Insights

func (*InsightsDataGather) DeepCopy

func (in *InsightsDataGather) DeepCopy() *InsightsDataGather

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new InsightsDataGather.

func (*InsightsDataGather) DeepCopyInto

func (in *InsightsDataGather) DeepCopyInto(out *InsightsDataGather)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*InsightsDataGather) DeepCopyObject

func (in *InsightsDataGather) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

func (InsightsDataGather) OpenAPIModelName

func (in InsightsDataGather) OpenAPIModelName() string

OpenAPIModelName returns the OpenAPI model name for this type.

func (InsightsDataGather) SwaggerDoc

func (InsightsDataGather) SwaggerDoc() map[string]string

type InsightsDataGatherList

type InsightsDataGatherList struct {
	metav1.TypeMeta `json:",inline"`
	// metadata is the required standard list's metadata.
	// More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
	// +required
	metav1.ListMeta `json:"metadata"`
	// items is the required list of InsightsDataGather objects
	// it may not exceed 100 items
	// +kubebuilder:validation:MaxItems=100
	// +required
	Items []InsightsDataGather `json:"items"`
}

InsightsDataGatherList is a collection of items Compatibility level 4: No compatibility is provided, the API can change at any point for any reason. These capabilities should not be used by applications needing long term support. +openshift:compatibility-gen:level=4

func (*InsightsDataGatherList) DeepCopy

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new InsightsDataGatherList.

func (*InsightsDataGatherList) DeepCopyInto

func (in *InsightsDataGatherList) DeepCopyInto(out *InsightsDataGatherList)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*InsightsDataGatherList) DeepCopyObject

func (in *InsightsDataGatherList) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

func (InsightsDataGatherList) OpenAPIModelName

func (in InsightsDataGatherList) OpenAPIModelName() string

OpenAPIModelName returns the OpenAPI model name for this type.

func (InsightsDataGatherList) SwaggerDoc

func (InsightsDataGatherList) SwaggerDoc() map[string]string

type InsightsDataGatherSpec

type InsightsDataGatherSpec struct {
	// gatherConfig is an optional spec attribute that includes all the configuration options related to gathering of the Insights data and its uploading to the ingress.
	// +optional
	GatherConfig GatherConfig `json:"gatherConfig"`
}

func (*InsightsDataGatherSpec) DeepCopy

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new InsightsDataGatherSpec.

func (*InsightsDataGatherSpec) DeepCopyInto

func (in *InsightsDataGatherSpec) DeepCopyInto(out *InsightsDataGatherSpec)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (InsightsDataGatherSpec) OpenAPIModelName

func (in InsightsDataGatherSpec) OpenAPIModelName() string

OpenAPIModelName returns the OpenAPI model name for this type.

func (InsightsDataGatherSpec) SwaggerDoc

func (InsightsDataGatherSpec) SwaggerDoc() map[string]string

type InsightsDataGatherStatus

type InsightsDataGatherStatus struct{}

func (*InsightsDataGatherStatus) DeepCopy

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new InsightsDataGatherStatus.

func (*InsightsDataGatherStatus) DeepCopyInto

func (in *InsightsDataGatherStatus) DeepCopyInto(out *InsightsDataGatherStatus)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (InsightsDataGatherStatus) OpenAPIModelName

func (in InsightsDataGatherStatus) OpenAPIModelName() string

OpenAPIModelName returns the OpenAPI model name for this type.

type PersistentVolumeClaimReference

type PersistentVolumeClaimReference struct {
	// name is a string that follows the DNS1123 subdomain format.
	// It must be at most 253 characters in length, and must consist only of lower case alphanumeric characters, '-' and '.', and must start and end with an alphanumeric character.
	// +kubebuilder:validation:XValidation:rule="!format.dns1123Subdomain().validate(self).hasValue()",message="a lowercase RFC 1123 subdomain must consist of lower case alphanumeric characters, '-' or '.', and must start and end with an alphanumeric character."
	// +kubebuilder:validation:MaxLength:=253
	// +required
	Name string `json:"name"`
}

persistentVolumeClaimReference is a reference to a PersistentVolumeClaim.

func (*PersistentVolumeClaimReference) DeepCopy

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new PersistentVolumeClaimReference.

func (*PersistentVolumeClaimReference) DeepCopyInto

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (PersistentVolumeClaimReference) OpenAPIModelName

func (in PersistentVolumeClaimReference) OpenAPIModelName() string

OpenAPIModelName returns the OpenAPI model name for this type.

func (PersistentVolumeClaimReference) SwaggerDoc

func (PersistentVolumeClaimReference) SwaggerDoc() map[string]string

type PersistentVolumeConfig

type PersistentVolumeConfig struct {
	// claim is a required field that specifies the configuration of the PersistentVolumeClaim that will be used to store the Insights data archive.
	// The PersistentVolumeClaim must be created in the openshift-insights namespace.
	// +required
	Claim PersistentVolumeClaimReference `json:"claim"`
	// mountPath is an optional field specifying the directory where the PVC will be mounted inside the Insights data gathering Pod.
	// When omitted, this means no opinion and the platform is left to choose a reasonable default, which is subject to change over time.
	// The current default mount path is /var/lib/insights-operator
	// The path may not exceed 1024 characters and must not contain a colon.
	// +kubebuilder:validation:MaxLength=1024
	// +kubebuilder:validation:XValidation:rule="!self.contains(':')",message="mountPath must not contain a colon"
	// +optional
	MountPath string `json:"mountPath,omitempty"`
}

persistentVolumeConfig provides configuration options for PersistentVolume storage.

func (*PersistentVolumeConfig) DeepCopy

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new PersistentVolumeConfig.

func (*PersistentVolumeConfig) DeepCopyInto

func (in *PersistentVolumeConfig) DeepCopyInto(out *PersistentVolumeConfig)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (PersistentVolumeConfig) OpenAPIModelName

func (in PersistentVolumeConfig) OpenAPIModelName() string

OpenAPIModelName returns the OpenAPI model name for this type.

func (PersistentVolumeConfig) SwaggerDoc

func (PersistentVolumeConfig) SwaggerDoc() map[string]string

type Storage

type Storage struct {
	// type is a required field that specifies the type of storage that will be used to store the Insights data archive.
	// Valid values are "PersistentVolume" and "Ephemeral".
	// When set to Ephemeral, the Insights data archive is stored in the ephemeral storage of the gathering job.
	// When set to PersistentVolume, the Insights data archive is stored in the PersistentVolume that is defined by the persistentVolume field.
	// +required
	Type StorageType `json:"type"`
	// persistentVolume is an optional field that specifies the PersistentVolume that will be used to store the Insights data archive.
	// The PersistentVolume must be created in the openshift-insights namespace.
	// +optional
	PersistentVolume *PersistentVolumeConfig `json:"persistentVolume,omitempty"`
}

storage provides persistent storage configuration options for gathering jobs. If the type is set to PersistentVolume, then the PersistentVolume must be defined. If the type is set to Ephemeral, then the PersistentVolume must not be defined. +kubebuilder:validation:XValidation:rule="has(self.type) && self.type == 'PersistentVolume' ? has(self.persistentVolume) : !has(self.persistentVolume)",message="persistentVolume is required when type is PersistentVolume, and forbidden otherwise"

func (*Storage) DeepCopy

func (in *Storage) DeepCopy() *Storage

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Storage.

func (*Storage) DeepCopyInto

func (in *Storage) DeepCopyInto(out *Storage)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (Storage) OpenAPIModelName

func (in Storage) OpenAPIModelName() string

OpenAPIModelName returns the OpenAPI model name for this type.

func (Storage) SwaggerDoc

func (Storage) SwaggerDoc() map[string]string

type StorageType

type StorageType string

storageType declares valid storage types +kubebuilder:validation:Enum=PersistentVolume;Ephemeral

const (
	// StorageTypePersistentVolume storage type
	StorageTypePersistentVolume StorageType = "PersistentVolume"
	// StorageTypeEphemeral storage type
	StorageTypeEphemeral StorageType = "Ephemeral"
)

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL