Documentation ¶
Overview ¶
package v1beta1 contains API Schema definitions for the hco v1beta1 API group +k8s:deepcopy-gen=package,register +k8s:defaulter-gen=TypeMeta +groupName=hco.kubevirt.io
package v1beta1 contains API Schema definitions for the hco vbeta1 API group +k8s:deepcopy-gen=package,register +k8s:defaulter-gen=TypeMeta +groupName=hco.kubevirt.io
Index ¶
- Constants
- Variables
- func GetOpenAPIDefinitions(ref common.ReferenceCallback) map[string]common.OpenAPIDefinition
- func RegisterDefaults(scheme *runtime.Scheme) error
- func SetObjectDefaults_HyperConverged(in *HyperConverged)
- func SetObjectDefaults_HyperConvergedList(in *HyperConvergedList)
- type CertRotateConfigCA
- type CertRotateConfigServer
- type DataImportCronStatus
- type DataImportCronTemplate
- type DataImportCronTemplateStatus
- type HyperConverged
- type HyperConvergedCertConfig
- type HyperConvergedConfig
- type HyperConvergedFeatureGates
- type HyperConvergedList
- type HyperConvergedObsoleteCPUs
- type HyperConvergedSpec
- type HyperConvergedStatus
- type HyperConvergedTuningPolicy
- type HyperConvergedUninstallStrategy
- type HyperConvergedWorkloadUpdateStrategy
- type LiveMigrationConfigurations
- type LogVerbosityConfiguration
- type MediatedDevicesConfiguration
- type MediatedHostDevice
- type NodeMediatedDeviceTypesConfig
- type OperandResourceRequirements
- type PciHostDevice
- type PermittedHostDevices
- type StorageImportConfig
- type Version
- type VirtualMachineOptions
Constants ¶
const ( ConditionAvailable = "Available" // ConditionProgressing indicates that the operator is actively making changes to the resources maintained by the // operator ConditionProgressing = "Progressing" // ConditionDegraded indicates that the resources maintained by the operator are not functioning completely. // An example of a degraded state would be if not all pods in a deployment were running. // It may still be available, but it is degraded ConditionDegraded = "Degraded" // ConditionUpgradeable indicates whether the resources maintained by the operator are in a state that is safe to upgrade. // When `False`, the resources maintained by the operator should not be upgraded and the // message field should contain a human-readable description of what the administrator should do to // allow the operator to successfully update the resources maintained by the operator. ConditionUpgradeable = "Upgradeable" // ConditionReconcileComplete communicates the status of the HyperConverged resource's // reconcile functionality. Basically, is the Reconcile function running to completion. ConditionReconcileComplete = "ReconcileComplete" // ConditionTaintedConfiguration indicates that a hidden/debug configuration // has been applied to the HyperConverged resource via a specialized annotation. // This condition is exposed only when its value is True, and is otherwise hidden. ConditionTaintedConfiguration = "TaintedConfiguration" )
const HyperConvergedName = "kubevirt-hyperconverged"
HyperConvergedName is the name of the HyperConverged resource that will be reconciled
Variables ¶
var ( // SchemeGroupVersion is group version used to register these objects SchemeGroupVersion = schema.GroupVersion{Group: hcoutils.APIVersionGroup, Version: hcoutils.APIVersionBeta} // SchemeBuilder is used to add go types to the GroupVersionKind scheme SchemeBuilder = &scheme.Builder{GroupVersion: SchemeGroupVersion} // AddToScheme tbd AddToScheme = SchemeBuilder.AddToScheme )
Functions ¶
func GetOpenAPIDefinitions ¶
func GetOpenAPIDefinitions(ref common.ReferenceCallback) map[string]common.OpenAPIDefinition
func RegisterDefaults ¶
RegisterDefaults adds defaulters functions to the given scheme. Public to allow building arbitrary schemes. All generated defaulters are covering - they call all nested defaulters.
func SetObjectDefaults_HyperConverged ¶ added in v1.9.0
func SetObjectDefaults_HyperConverged(in *HyperConverged)
func SetObjectDefaults_HyperConvergedList ¶ added in v1.9.0
func SetObjectDefaults_HyperConvergedList(in *HyperConvergedList)
Types ¶
type CertRotateConfigCA ¶
type CertRotateConfigCA struct { // The requested 'duration' (i.e. lifetime) of the Certificate. // This should comply with golang's ParseDuration format (https://golang.org/pkg/time/#ParseDuration) // +kubebuilder:default="48h0m0s" // +default="48h0m0s" // +optional Duration *metav1.Duration `json:"duration,omitempty"` // The amount of time before the currently issued certificate's `notAfter` // time that we will begin to attempt to renew the certificate. // This should comply with golang's ParseDuration format (https://golang.org/pkg/time/#ParseDuration) // +kubebuilder:default="24h0m0s" // +default="24h0m0s" // +optional RenewBefore *metav1.Duration `json:"renewBefore,omitempty"` }
CertRotateConfigCA contains the tunables for TLS certificates. +k8s:openapi-gen=true
func (*CertRotateConfigCA) DeepCopy ¶
func (in *CertRotateConfigCA) DeepCopy() *CertRotateConfigCA
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new CertRotateConfigCA.
func (*CertRotateConfigCA) DeepCopyInto ¶
func (in *CertRotateConfigCA) DeepCopyInto(out *CertRotateConfigCA)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type CertRotateConfigServer ¶
type CertRotateConfigServer struct { // The requested 'duration' (i.e. lifetime) of the Certificate. // This should comply with golang's ParseDuration format (https://golang.org/pkg/time/#ParseDuration) // +kubebuilder:default="24h0m0s" // +default="24h0m0s" // +optional Duration *metav1.Duration `json:"duration,omitempty"` // The amount of time before the currently issued certificate's `notAfter` // time that we will begin to attempt to renew the certificate. // This should comply with golang's ParseDuration format (https://golang.org/pkg/time/#ParseDuration) // +kubebuilder:default="12h0m0s" // +default="12h0m0s" // +optional RenewBefore *metav1.Duration `json:"renewBefore,omitempty"` }
CertRotateConfigServer contains the tunables for TLS certificates. +k8s:openapi-gen=true
func (*CertRotateConfigServer) DeepCopy ¶
func (in *CertRotateConfigServer) DeepCopy() *CertRotateConfigServer
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new CertRotateConfigServer.
func (*CertRotateConfigServer) DeepCopyInto ¶
func (in *CertRotateConfigServer) DeepCopyInto(out *CertRotateConfigServer)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type DataImportCronStatus ¶
type DataImportCronStatus struct { // CommonTemplate indicates whether this is a common template (true), or a custom one (false) CommonTemplate bool `json:"commonTemplate,omitempty"` // Modified indicates if a common template was customized. Always false for custom templates. Modified bool `json:"modified,omitempty"` }
DataImportCronStatus is the status field of the DIC template
func (*DataImportCronStatus) DeepCopy ¶
func (in *DataImportCronStatus) DeepCopy() *DataImportCronStatus
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new DataImportCronStatus.
func (*DataImportCronStatus) DeepCopyInto ¶
func (in *DataImportCronStatus) DeepCopyInto(out *DataImportCronStatus)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type DataImportCronTemplate ¶
type DataImportCronTemplate struct { metav1.ObjectMeta `json:"metadata,omitempty"` Spec *cdiv1beta1.DataImportCronSpec `json:"spec,omitempty"` }
DataImportCronTemplate defines the template type for DataImportCrons. It requires metadata.name to be specified while leaving namespace as optional.
func (*DataImportCronTemplate) DeepCopy ¶
func (in *DataImportCronTemplate) DeepCopy() *DataImportCronTemplate
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new DataImportCronTemplate.
func (*DataImportCronTemplate) DeepCopyInto ¶
func (in *DataImportCronTemplate) DeepCopyInto(out *DataImportCronTemplate)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type DataImportCronTemplateStatus ¶
type DataImportCronTemplateStatus struct { DataImportCronTemplate `json:",inline"` Status DataImportCronStatus `json:"status,omitempty"` }
DataImportCronTemplateStatus is a copy of a dataImportCronTemplate as defined in the spec, or in the HCO image.
func (*DataImportCronTemplateStatus) DeepCopy ¶
func (in *DataImportCronTemplateStatus) DeepCopy() *DataImportCronTemplateStatus
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new DataImportCronTemplateStatus.
func (*DataImportCronTemplateStatus) DeepCopyInto ¶
func (in *DataImportCronTemplateStatus) DeepCopyInto(out *DataImportCronTemplateStatus)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type HyperConverged ¶
type HyperConverged struct { metav1.TypeMeta `json:",inline"` metav1.ObjectMeta `json:"metadata,omitempty"` // +kubebuilder:default={"certConfig": {"ca": {"duration": "48h0m0s", "renewBefore": "24h0m0s"}, "server": {"duration": "24h0m0s", "renewBefore": "12h0m0s"}}, "virtualMachineOptions": {"disableFreePageReporting": true}, "featureGates": {"withHostPassthroughCPU": false, "enableCommonBootImageImport": true, "deployTektonTaskResources": false, "deployKubeSecondaryDNS": false, "nonRoot": true}, "liveMigrationConfig": {"completionTimeoutPerGiB": 800, "parallelMigrationsPerCluster": 5, "parallelOutboundMigrationsPerNode": 2, "progressTimeout": 150, "allowAutoConverge": false, "allowPostCopy": false}, "resourceRequirements": {"vmiCPUAllocationRatio": 10}, "uninstallStrategy": "BlockUninstallIfWorkloadsExist"} // +optional Spec HyperConvergedSpec `json:"spec,omitempty"` Status HyperConvergedStatus `json:"status,omitempty"` }
HyperConverged is the Schema for the hyperconvergeds API +k8s:openapi-gen=true +kubebuilder:storageversion +kubebuilder:printcolumn:name="Age",type=date,JSONPath=`.metadata.creationTimestamp` +kubebuilder:resource:scope=Namespaced,categories={all},shortName={hco,hcos} +kubebuilder:subresource:status
func (*HyperConverged) DeepCopy ¶
func (in *HyperConverged) DeepCopy() *HyperConverged
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new HyperConverged.
func (*HyperConverged) DeepCopyInto ¶
func (in *HyperConverged) DeepCopyInto(out *HyperConverged)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*HyperConverged) DeepCopyObject ¶
func (in *HyperConverged) DeepCopyObject() runtime.Object
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type HyperConvergedCertConfig ¶
type HyperConvergedCertConfig struct { // CA configuration - // CA certs are kept in the CA bundle as long as they are valid // +kubebuilder:default={"duration": "48h0m0s", "renewBefore": "24h0m0s"} // +optional CA CertRotateConfigCA `json:"ca,omitempty"` // Server configuration - // Certs are rotated and discarded // +kubebuilder:default={"duration": "24h0m0s", "renewBefore": "12h0m0s"} // +optional Server CertRotateConfigServer `json:"server,omitempty"` }
HyperConvergedCertConfig holds the CertConfig entries for the HCO operands +k8s:openapi-gen=true
func (*HyperConvergedCertConfig) DeepCopy ¶
func (in *HyperConvergedCertConfig) DeepCopy() *HyperConvergedCertConfig
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new HyperConvergedCertConfig.
func (*HyperConvergedCertConfig) DeepCopyInto ¶
func (in *HyperConvergedCertConfig) DeepCopyInto(out *HyperConvergedCertConfig)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type HyperConvergedConfig ¶
type HyperConvergedConfig struct { // NodePlacement describes node scheduling configuration. // +optional NodePlacement *sdkapi.NodePlacement `json:"nodePlacement,omitempty"` }
HyperConvergedConfig defines a set of configurations to pass to components
func (*HyperConvergedConfig) DeepCopy ¶
func (in *HyperConvergedConfig) DeepCopy() *HyperConvergedConfig
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new HyperConvergedConfig.
func (*HyperConvergedConfig) DeepCopyInto ¶
func (in *HyperConvergedConfig) DeepCopyInto(out *HyperConvergedConfig)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type HyperConvergedFeatureGates ¶
type HyperConvergedFeatureGates struct { // Allow migrating a virtual machine with CPU host-passthrough mode. This should be // enabled only when the Cluster is homogeneous from CPU HW perspective doc here // +optional // +kubebuilder:default=false // +default=false WithHostPassthroughCPU *bool `json:"withHostPassthroughCPU,omitempty"` // Opt-in to automatic delivery/updates of the common data import cron templates. // There are two sources for the data import cron templates: hard coded list of common templates, and custom // templates that can be added to the dataImportCronTemplates field. This feature gates only control the common // templates. It is possible to use custom templates by adding them to the dataImportCronTemplates field. // +optional // +kubebuilder:default=true // +default=true EnableCommonBootImageImport *bool `json:"enableCommonBootImageImport,omitempty"` // deploy resources (kubevirt tekton tasks and example pipelines) in SSP operator // +optional // +kubebuilder:default=false // +default=false DeployTektonTaskResources *bool `json:"deployTektonTaskResources,omitempty"` // deploy VM console proxy resources in SSP operator // +optional // +kubebuilder:default=false // +default=false DeployVMConsoleProxy *bool `json:"deployVmConsoleProxy,omitempty"` // Deploy KubeSecondaryDNS by CNAO // +optional // +kubebuilder:default=false // +default=false DeployKubeSecondaryDNS *bool `json:"deployKubeSecondaryDNS,omitempty"` // Enables rootless virt-launcher. // // Deprecated: please use the root FG. // +optional // +kubebuilder:default=true // +default=true NonRoot *bool `json:"nonRoot,omitempty"` // Disable mediated devices handling on KubeVirt // +optional // +kubebuilder:default=false // +default=false DisableMDevConfiguration *bool `json:"disableMDevConfiguration,omitempty"` // Enable persistent reservation of a LUN through the SCSI Persistent Reserve commands on Kubevirt. // In order to issue privileged SCSI ioctls, the VM requires activation of the persistent reservation flag. // Once this feature gate is enabled, then the additional container with the qemu-pr-helper is deployed inside the virt-handler pod. // Enabling (or removing) the feature gate causes the redeployment of the virt-handler pod. // +optional // +kubebuilder:default=false // +default=false PersistentReservation *bool `json:"persistentReservation,omitempty"` // Enable the Managed Tenant Quota operator (MTQ) on the cluster. // MTQ streamlines the VirtualMachines migration process in namespaces where resource quotas are applied. // Note: this feature is in Developer Preview. // +optional // +kubebuilder:default=false // +default=false EnableManagedTenantQuota *bool `json:"enableManagedTenantQuota,omitempty"` }
HyperConvergedFeatureGates is a set of optional feature gates to enable or disable new features that are not enabled by default yet. +k8s:openapi-gen=true
func (*HyperConvergedFeatureGates) DeepCopy ¶
func (in *HyperConvergedFeatureGates) DeepCopy() *HyperConvergedFeatureGates
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new HyperConvergedFeatureGates.
func (*HyperConvergedFeatureGates) DeepCopyInto ¶
func (in *HyperConvergedFeatureGates) DeepCopyInto(out *HyperConvergedFeatureGates)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type HyperConvergedList ¶
type HyperConvergedList struct { metav1.TypeMeta `json:",inline"` metav1.ListMeta `json:"metadata,omitempty"` Items []HyperConverged `json:"items"` }
HyperConvergedList contains a list of HyperConverged
func (*HyperConvergedList) DeepCopy ¶
func (in *HyperConvergedList) DeepCopy() *HyperConvergedList
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new HyperConvergedList.
func (*HyperConvergedList) DeepCopyInto ¶
func (in *HyperConvergedList) DeepCopyInto(out *HyperConvergedList)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*HyperConvergedList) DeepCopyObject ¶
func (in *HyperConvergedList) DeepCopyObject() runtime.Object
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type HyperConvergedObsoleteCPUs ¶
type HyperConvergedObsoleteCPUs struct { // MinCPUModel is the Minimum CPU model that is used for basic CPU features; e.g. Penryn or Haswell. // The default value for this field is nil, but in KubeVirt, the default value is "Penryn", if nothing else is set. // Use this field to override KubeVirt default value. // +optional MinCPUModel string `json:"minCPUModel,omitempty"` // CPUModels is a list of obsolete CPU models. When the node-labeller obtains the list of obsolete CPU models, it // eliminates those CPU models and creates labels for valid CPU models. // The default values for this field is nil, however, HCO uses opinionated values, and adding values to this list // will add them to the opinionated values. // +listType=set // +optional CPUModels []string `json:"cpuModels,omitempty"` }
HyperConvergedObsoleteCPUs allows avoiding scheduling of VMs for obsolete CPU models +k8s:openapi-gen=true
func (*HyperConvergedObsoleteCPUs) DeepCopy ¶
func (in *HyperConvergedObsoleteCPUs) DeepCopy() *HyperConvergedObsoleteCPUs
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new HyperConvergedObsoleteCPUs.
func (*HyperConvergedObsoleteCPUs) DeepCopyInto ¶
func (in *HyperConvergedObsoleteCPUs) DeepCopyInto(out *HyperConvergedObsoleteCPUs)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type HyperConvergedSpec ¶
type HyperConvergedSpec struct { // Deprecated: LocalStorageClassName the name of the local storage class. LocalStorageClassName string `json:"localStorageClassName,omitempty"` // TuningPolicy allows to configure the mode in which the RateLimits of kubevirt are set. // If TuningPolicy is not present the default kubevirt values are used. // It can be set to `annotation` for fine-tuning the kubevirt queryPerSeconds (qps) and burst values. // Qps and burst values are taken from the annotation hco.kubevirt.io/tuningPolicy // +kubebuilder:validation:Enum=annotation;highBurst // +optional TuningPolicy HyperConvergedTuningPolicy `json:"tuningPolicy,omitempty"` // infra HyperConvergedConfig influences the pod configuration (currently only placement) // for all the infra components needed on the virtualization enabled cluster // but not necessarily directly on each node running VMs/VMIs. // +optional Infra HyperConvergedConfig `json:"infra,omitempty"` // workloads HyperConvergedConfig influences the pod configuration (currently only placement) of components // which need to be running on a node where virtualization workloads should be able to run. // Changes to Workloads HyperConvergedConfig can be applied only without existing workload. // +optional Workloads HyperConvergedConfig `json:"workloads,omitempty"` // featureGates is a map of feature gate flags. Setting a flag to `true` will enable // the feature. Setting `false` or removing the feature gate, disables the feature. // +kubebuilder:default={"withHostPassthroughCPU": false, "enableCommonBootImageImport": true, "deployTektonTaskResources": false, "deployKubeSecondaryDNS": false, "nonRoot": true} // +optional FeatureGates HyperConvergedFeatureGates `json:"featureGates,omitempty"` // Live migration limits and timeouts are applied so that migration processes do not // overwhelm the cluster. // +kubebuilder:default={"completionTimeoutPerGiB": 800, "parallelMigrationsPerCluster": 5, "parallelOutboundMigrationsPerNode": 2, "progressTimeout": 150, "allowAutoConverge": false, "allowPostCopy": false} // +optional LiveMigrationConfig LiveMigrationConfigurations `json:"liveMigrationConfig,omitempty"` // PermittedHostDevices holds information about devices allowed for passthrough // +optional PermittedHostDevices *PermittedHostDevices `json:"permittedHostDevices,omitempty"` // MediatedDevicesConfiguration holds information about MDEV types to be defined on nodes, if available // +optional MediatedDevicesConfiguration *MediatedDevicesConfiguration `json:"mediatedDevicesConfiguration,omitempty"` // certConfig holds the rotation policy for internal, self-signed certificates // +kubebuilder:default={"ca": {"duration": "48h0m0s", "renewBefore": "24h0m0s"}, "server": {"duration": "24h0m0s", "renewBefore": "12h0m0s"}} // +optional CertConfig HyperConvergedCertConfig `json:"certConfig,omitempty"` // ResourceRequirements describes the resource requirements for the operand workloads. // +kubebuilder:default={"vmiCPUAllocationRatio": 10} // +kubebuilder:validation:XValidation:rule="!has(self.vmiCPUAllocationRatio) || self.vmiCPUAllocationRatio != 1",message="Automatic CPU limits are incompatible with a VMI CPU allocation ratio of 1" // +optional ResourceRequirements *OperandResourceRequirements `json:"resourceRequirements,omitempty"` // Override the storage class used for scratch space during transfer operations. The scratch space storage class // is determined in the following order: // value of scratchSpaceStorageClass, if that doesn't exist, use the default storage class, if there is no default // storage class, use the storage class of the DataVolume, if no storage class specified, use no storage class for // scratch space // +optional ScratchSpaceStorageClass *string `json:"scratchSpaceStorageClass,omitempty"` // VDDK Init Image eventually used to import VMs from external providers // +optional VddkInitImage *string `json:"vddkInitImage,omitempty"` // DefaultCPUModel defines a cluster default for CPU model: default CPU model is set when VMI doesn't have any CPU model. // When VMI has CPU model set, then VMI's CPU model is preferred. // When default CPU model is not set and VMI's CPU model is not set too, host-model will be set. // Default CPU model can be changed when kubevirt is running. // +optional DefaultCPUModel *string `json:"defaultCPUModel,omitempty"` // DefaultRuntimeClass defines a cluster default for the RuntimeClass to be used for VMIs pods if not set there. // Default RuntimeClass can be changed when kubevirt is running, existing VMIs are not impacted till // the next restart/live-migration when they are eventually going to consume the new default RuntimeClass. // +optional DefaultRuntimeClass *string `json:"defaultRuntimeClass,omitempty"` // ObsoleteCPUs allows avoiding scheduling of VMs for obsolete CPU models // +optional ObsoleteCPUs *HyperConvergedObsoleteCPUs `json:"obsoleteCPUs,omitempty"` // CommonTemplatesNamespace defines namespace in which common templates will // be deployed. It overrides the default openshift namespace. // +optional CommonTemplatesNamespace *string `json:"commonTemplatesNamespace,omitempty"` // StorageImport contains configuration for importing containerized data // +optional StorageImport *StorageImportConfig `json:"storageImport,omitempty"` // WorkloadUpdateStrategy defines at the cluster level how to handle automated workload updates // +kubebuilder:default={"workloadUpdateMethods": {"LiveMigrate"}, "batchEvictionSize": 10, "batchEvictionInterval": "1m0s"} WorkloadUpdateStrategy HyperConvergedWorkloadUpdateStrategy `json:"workloadUpdateStrategy,omitempty"` // DataImportCronTemplates holds list of data import cron templates (golden images) // +optional // +listType=atomic DataImportCronTemplates []DataImportCronTemplate `json:"dataImportCronTemplates,omitempty"` // FilesystemOverhead describes the space reserved for overhead when using Filesystem volumes. // A value is between 0 and 1, if not defined it is 0.055 (5.5 percent overhead) // +optional FilesystemOverhead *cdiv1beta1.FilesystemOverhead `json:"filesystemOverhead,omitempty"` // UninstallStrategy defines how to proceed on uninstall when workloads (VirtualMachines, DataVolumes) still exist. // BlockUninstallIfWorkloadsExist will prevent the CR from being removed when workloads still exist. // BlockUninstallIfWorkloadsExist is the safest choice to protect your workloads from accidental data loss, so it's strongly advised. // RemoveWorkloads will cause all the workloads to be cascading deleted on uninstallation. // WARNING: please notice that RemoveWorkloads will cause your workloads to be deleted as soon as this CR will be, even accidentally, deleted. // Please correctly consider the implications of this option before setting it. // BlockUninstallIfWorkloadsExist is the default behaviour. // +kubebuilder:default=BlockUninstallIfWorkloadsExist // +default="BlockUninstallIfWorkloadsExist" // +kubebuilder:validation:Enum=RemoveWorkloads;BlockUninstallIfWorkloadsExist // +optional UninstallStrategy HyperConvergedUninstallStrategy `json:"uninstallStrategy,omitempty"` // LogVerbosityConfig configures the verbosity level of Kubevirt's different components. The higher // the value - the higher the log verbosity. // +optional LogVerbosityConfig *LogVerbosityConfiguration `json:"logVerbosityConfig,omitempty"` // TLSSecurityProfile specifies the settings for TLS connections to be propagated to all kubevirt-hyperconverged components. // If unset, the hyperconverged cluster operator will consume the value set on the APIServer CR on OCP/OKD or Intermediate if on vanilla k8s. // Note that only Old, Intermediate and Custom profiles are currently supported, and the maximum available // MinTLSVersions is VersionTLS12. // +optional TLSSecurityProfile *openshiftconfigv1.TLSSecurityProfile `json:"tlsSecurityProfile,omitempty"` // TektonPipelinesNamespace defines namespace in which example pipelines will be deployed. // If unset, then the default value is the operator namespace. // +optional TektonPipelinesNamespace *string `json:"tektonPipelinesNamespace,omitempty"` // TektonTasksNamespace defines namespace in which tekton tasks will be deployed. // If unset, then the default value is the operator namespace. // +optional TektonTasksNamespace *string `json:"tektonTasksNamespace,omitempty"` // KubeSecondaryDNSNameServerIP defines name server IP used by KubeSecondaryDNS // +optional KubeSecondaryDNSNameServerIP *string `json:"kubeSecondaryDNSNameServerIP,omitempty"` // EvictionStrategy defines at the cluster level if the VirtualMachineInstance should be // migrated instead of shut-off in case of a node drain. If the VirtualMachineInstance specific // field is set it overrides the cluster level one. // Allowed values: // - `None` no eviction strategy at cluster level. // - `LiveMigrate` migrate the VM on eviction; a not live migratable VM with no specific strategy will block the drain of the node util manually evicted. // - `LiveMigrateIfPossible` migrate the VM on eviction if live migration is possible, otherwise directly evict. // - `External` block the drain, track eviction and notify an external controller. // Defaults to LiveMigrate with multiple worker nodes, None on single worker clusters. // +kubebuilder:validation:Enum=None;LiveMigrate;LiveMigrateIfPossible;External // +optional EvictionStrategy *v1.EvictionStrategy `json:"evictionStrategy,omitempty"` // VMStateStorageClass is the name of the storage class to use for the PVCs created to preserve VM state, like TPM. // The storage class must support RWX in filesystem mode. // +optional VMStateStorageClass *string `json:"vmStateStorageClass,omitempty"` // VirtualMachineOptions holds the cluster level information regarding the virtual machine. // +kubebuilder:default={"disableFreePageReporting": true} // +default={"disableFreePageReporting": true} // +optional VirtualMachineOptions *VirtualMachineOptions `json:"virtualMachineOptions,omitempty"` }
HyperConvergedSpec defines the desired state of HyperConverged +k8s:openapi-gen=true
func (*HyperConvergedSpec) DeepCopy ¶
func (in *HyperConvergedSpec) DeepCopy() *HyperConvergedSpec
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new HyperConvergedSpec.
func (*HyperConvergedSpec) DeepCopyInto ¶
func (in *HyperConvergedSpec) DeepCopyInto(out *HyperConvergedSpec)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type HyperConvergedStatus ¶
type HyperConvergedStatus struct { // Conditions describes the state of the HyperConverged resource. // +listType=atomic // +patchMergeKey=type // +patchStrategy=merge // +optional Conditions []metav1.Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"` // RelatedObjects is a list of objects created and maintained by this // operator. Object references will be added to this list after they have // been created AND found in the cluster. // +listType=atomic // +optional RelatedObjects []corev1.ObjectReference `json:"relatedObjects,omitempty"` // Versions is a list of HCO component versions, as name/version pairs. The version with a name of "operator" // is the HCO version itself, as described here: // https://github.com/openshift/cluster-version-operator/blob/master/docs/dev/clusteroperator.md#version // +listType=atomic // +optional Versions []Version `json:"versions,omitempty"` // ObservedGeneration reflects the HyperConverged resource generation. If the ObservedGeneration is less than the // resource generation in metadata, the status is out of date // +optional ObservedGeneration int64 `json:"observedGeneration,omitempty"` // DataImportSchedule is the cron expression that is used in for the hard-coded data import cron templates. HCO // generates the value of this field once and stored in the status field, so will survive restart. // +optional DataImportSchedule string `json:"dataImportSchedule,omitempty"` // DataImportCronTemplates is a list of the actual DataImportCronTemplates as HCO update in the SSP CR. The list // contains both the common and the custom templates, including any modification done by HCO. DataImportCronTemplates []DataImportCronTemplateStatus `json:"dataImportCronTemplates,omitempty"` // SystemHealthStatus reflects the health of HCO and its secondary resources, based on the aggregated conditions. // +optional SystemHealthStatus string `json:"systemHealthStatus,omitempty"` }
HyperConvergedStatus defines the observed state of HyperConverged +k8s:openapi-gen=true
func (*HyperConvergedStatus) DeepCopy ¶
func (in *HyperConvergedStatus) DeepCopy() *HyperConvergedStatus
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new HyperConvergedStatus.
func (*HyperConvergedStatus) DeepCopyInto ¶
func (in *HyperConvergedStatus) DeepCopyInto(out *HyperConvergedStatus)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type HyperConvergedTuningPolicy ¶ added in v1.9.0
type HyperConvergedTuningPolicy string
const ( HyperConvergedAnnotationTuningPolicy HyperConvergedTuningPolicy = "annotation" HyperConvergedHighBurstProfile HyperConvergedTuningPolicy = "highBurst" )
HyperConvergedAnnotationTuningPolicy defines a static configuration of the kubevirt query per seconds (qps) and burst values through annotation values.
type HyperConvergedUninstallStrategy ¶
type HyperConvergedUninstallStrategy string
const ( HyperConvergedUninstallStrategyRemoveWorkloads HyperConvergedUninstallStrategy = "RemoveWorkloads" HyperConvergedUninstallStrategyBlockUninstallIfWorkloadsExist HyperConvergedUninstallStrategy = "BlockUninstallIfWorkloadsExist" )
type HyperConvergedWorkloadUpdateStrategy ¶
type HyperConvergedWorkloadUpdateStrategy struct { // WorkloadUpdateMethods defines the methods that can be used to disrupt workloads // during automated workload updates. // When multiple methods are present, the least disruptive method takes // precedence over more disruptive methods. For example if both LiveMigrate and Evict // methods are listed, only VMs which are not live migratable will be restarted/shutdown. // An empty list defaults to no automated workload updating. // // +listType=atomic // +kubebuilder:default={"LiveMigrate"} // +default=["LiveMigrate"] WorkloadUpdateMethods []string `json:"workloadUpdateMethods"` // BatchEvictionSize Represents the number of VMIs that can be forced updated per // the BatchShutdownInterval interval // // +kubebuilder:default=10 // +default=10 // +optional BatchEvictionSize *int `json:"batchEvictionSize,omitempty"` // BatchEvictionInterval Represents the interval to wait before issuing the next // batch of shutdowns // // +kubebuilder:default="1m0s" // +default="1m0s" // +optional BatchEvictionInterval *metav1.Duration `json:"batchEvictionInterval,omitempty"` }
HyperConvergedWorkloadUpdateStrategy defines options related to updating a KubeVirt install
+k8s:openapi-gen=true
func (*HyperConvergedWorkloadUpdateStrategy) DeepCopy ¶
func (in *HyperConvergedWorkloadUpdateStrategy) DeepCopy() *HyperConvergedWorkloadUpdateStrategy
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new HyperConvergedWorkloadUpdateStrategy.
func (*HyperConvergedWorkloadUpdateStrategy) DeepCopyInto ¶
func (in *HyperConvergedWorkloadUpdateStrategy) DeepCopyInto(out *HyperConvergedWorkloadUpdateStrategy)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type LiveMigrationConfigurations ¶
type LiveMigrationConfigurations struct { // Number of migrations running in parallel in the cluster. // +optional // +kubebuilder:default=5 // +default=5 ParallelMigrationsPerCluster *uint32 `json:"parallelMigrationsPerCluster,omitempty"` // Maximum number of outbound migrations per node. // +optional // +kubebuilder:default=2 // +default=2 ParallelOutboundMigrationsPerNode *uint32 `json:"parallelOutboundMigrationsPerNode,omitempty"` // Bandwidth limit of each migration, in MiB/s. // +optional // +kubebuilder:validation:Pattern=^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$ BandwidthPerMigration *string `json:"bandwidthPerMigration,omitempty"` // The migration will be canceled if it has not completed in this time, in seconds per GiB // of memory. For example, a virtual machine instance with 6GiB memory will timeout if it has not completed // migration in 4800 seconds. If the Migration Method is BlockMigration, the size of the migrating disks is included // in the calculation. // +kubebuilder:default=800 // +default=800 // +optional CompletionTimeoutPerGiB *int64 `json:"completionTimeoutPerGiB,omitempty"` // The migration will be canceled if memory copy fails to make progress in this time, in seconds. // +kubebuilder:default=150 // +default=150 // +optional ProgressTimeout *int64 `json:"progressTimeout,omitempty"` // The migrations will be performed over a dedicated multus network to minimize disruption to tenant workloads due to network saturation when VM live migrations are triggered. // +optional Network *string `json:"network,omitempty"` // AllowAutoConverge allows the platform to compromise performance/availability of VMIs to // guarantee successful VMI live migrations. Defaults to false // +optional // +kubebuilder:default=false // +default=false AllowAutoConverge *bool `json:"allowAutoConverge,omitempty"` // AllowPostCopy enables post-copy live migrations. Such migrations allow even the busiest VMIs // to successfully live-migrate. However, events like a network failure can cause a VMI crash. // If set to true, migrations will still start in pre-copy, but switch to post-copy when // CompletionTimeoutPerGiB triggers. Defaults to false // +optional // +kubebuilder:default=false // +default=false AllowPostCopy *bool `json:"allowPostCopy,omitempty"` }
LiveMigrationConfigurations - Live migration limits and timeouts are applied so that migration processes do not overwhelm the cluster. +k8s:openapi-gen=true
func (*LiveMigrationConfigurations) DeepCopy ¶
func (in *LiveMigrationConfigurations) DeepCopy() *LiveMigrationConfigurations
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new LiveMigrationConfigurations.
func (*LiveMigrationConfigurations) DeepCopyInto ¶
func (in *LiveMigrationConfigurations) DeepCopyInto(out *LiveMigrationConfigurations)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type LogVerbosityConfiguration ¶
type LogVerbosityConfiguration struct { // +optional Kubevirt *v1.LogVerbosity `json:"kubevirt,omitempty"` }
LogVerbosityConfiguration configures log verbosity for different components +k8s:openapi-gen=true
func (*LogVerbosityConfiguration) DeepCopy ¶
func (in *LogVerbosityConfiguration) DeepCopy() *LogVerbosityConfiguration
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new LogVerbosityConfiguration.
func (*LogVerbosityConfiguration) DeepCopyInto ¶
func (in *LogVerbosityConfiguration) DeepCopyInto(out *LogVerbosityConfiguration)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type MediatedDevicesConfiguration ¶
type MediatedDevicesConfiguration struct { // +optional // +listType=atomic MediatedDeviceTypes []string `json:"mediatedDeviceTypes"` // Deprecated: please use mediatedDeviceTypes instead. // +optional // +listType=atomic MediatedDevicesTypes []string `json:"mediatedDevicesTypes,omitempty"` // +optional // +listType=atomic NodeMediatedDeviceTypes []NodeMediatedDeviceTypesConfig `json:"nodeMediatedDeviceTypes,omitempty"` }
MediatedDevicesConfiguration holds information about MDEV types to be defined, if available +k8s:openapi-gen=true +kubebuilder:validation:XValidation:rule="(has(self.mediatedDeviceTypes) && size(self.mediatedDeviceTypes)>0) || (has(self.mediatedDevicesTypes) && size(self.mediatedDevicesTypes)>0)",message="for mediatedDevicesConfiguration a non-empty mediatedDeviceTypes or mediatedDevicesTypes(deprecated) is required"
func (*MediatedDevicesConfiguration) DeepCopy ¶
func (in *MediatedDevicesConfiguration) DeepCopy() *MediatedDevicesConfiguration
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new MediatedDevicesConfiguration.
func (*MediatedDevicesConfiguration) DeepCopyInto ¶
func (in *MediatedDevicesConfiguration) DeepCopyInto(out *MediatedDevicesConfiguration)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type MediatedHostDevice ¶
type MediatedHostDevice struct { // name of a mediated device type required to identify a mediated device on a host MDEVNameSelector string `json:"mdevNameSelector"` // name by which a device is advertised and being requested ResourceName string `json:"resourceName"` // indicates that this resource is being provided by an external device plugin // +optional ExternalResourceProvider bool `json:"externalResourceProvider,omitempty"` // HCO enforces the existence of several MediatedHostDevice objects. Set disabled field to true instead of remove // these objects. // +optional Disabled bool `json:"disabled,omitempty"` }
MediatedHostDevice represents a host mediated device allowed for passthrough +k8s:openapi-gen=true
func (*MediatedHostDevice) DeepCopy ¶
func (in *MediatedHostDevice) DeepCopy() *MediatedHostDevice
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new MediatedHostDevice.
func (*MediatedHostDevice) DeepCopyInto ¶
func (in *MediatedHostDevice) DeepCopyInto(out *MediatedHostDevice)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type NodeMediatedDeviceTypesConfig ¶
type NodeMediatedDeviceTypesConfig struct { // NodeSelector is a selector which must be true for the vmi to fit on a node. // Selector which must match a node's labels for the vmi to be scheduled on that node. // More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/ NodeSelector map[string]string `json:"nodeSelector"` // +listType=atomic // +optional MediatedDeviceTypes []string `json:"mediatedDeviceTypes"` // Deprecated: please use mediatedDeviceTypes instead. // +listType=atomic // +optional MediatedDevicesTypes []string `json:"mediatedDevicesTypes"` }
NodeMediatedDeviceTypesConfig holds information about MDEV types to be defined in a specific node that matches the NodeSelector field. +k8s:openapi-gen=true +kubebuilder:validation:XValidation:rule="(has(self.mediatedDeviceTypes) && size(self.mediatedDeviceTypes)>0) || (has(self.mediatedDevicesTypes) && size(self.mediatedDevicesTypes)>0)",message="for nodeMediatedDeviceTypes a non-empty mediatedDeviceTypes or mediatedDevicesTypes(deprecated) is required"
func (*NodeMediatedDeviceTypesConfig) DeepCopy ¶
func (in *NodeMediatedDeviceTypesConfig) DeepCopy() *NodeMediatedDeviceTypesConfig
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new NodeMediatedDeviceTypesConfig.
func (*NodeMediatedDeviceTypesConfig) DeepCopyInto ¶
func (in *NodeMediatedDeviceTypesConfig) DeepCopyInto(out *NodeMediatedDeviceTypesConfig)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type OperandResourceRequirements ¶
type OperandResourceRequirements struct { // StorageWorkloads defines the resources requirements for storage workloads. It will propagate to the CDI custom // resource // +optional StorageWorkloads *corev1.ResourceRequirements `json:"storageWorkloads,omitempty"` // VmiCPUAllocationRatio defines, for each requested virtual CPU, // how much physical CPU to request per VMI from the // hosting node. The value is in fraction of a CPU thread (or // core on non-hyperthreaded nodes). // VMI POD CPU request = number of vCPUs * 1/vmiCPUAllocationRatio // For example, a value of 1 means 1 physical CPU thread per VMI CPU thread. // A value of 100 would be 1% of a physical thread allocated for each // requested VMI thread. // This option has no effect on VMIs that request dedicated CPUs. // Defaults to 10 // +kubebuilder:default=10 // +kubebuilder:validation:Minimum=1 // +default=10 // +optional VmiCPUAllocationRatio *int `json:"vmiCPUAllocationRatio,omitempty"` // When set, AutoCPULimitNamespaceLabelSelector will set a CPU limit on virt-launcher for VMIs running inside // namespaces that match the label selector. // The CPU limit will equal the number of requested vCPUs. // This setting does not apply to VMIs with dedicated CPUs. // +optional AutoCPULimitNamespaceLabelSelector *metav1.LabelSelector `json:"autoCPULimitNamespaceLabelSelector,omitempty"` }
OperandResourceRequirements is a list of resource requirements for the operand workloads pods +k8s:openapi-gen=true
func (*OperandResourceRequirements) DeepCopy ¶
func (in *OperandResourceRequirements) DeepCopy() *OperandResourceRequirements
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new OperandResourceRequirements.
func (*OperandResourceRequirements) DeepCopyInto ¶
func (in *OperandResourceRequirements) DeepCopyInto(out *OperandResourceRequirements)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type PciHostDevice ¶
type PciHostDevice struct { // a combination of a vendor_id:product_id required to identify a PCI device on a host. PCIDeviceSelector string `json:"pciDeviceSelector"` // name by which a device is advertised and being requested ResourceName string `json:"resourceName"` // indicates that this resource is being provided by an external device plugin // +optional ExternalResourceProvider bool `json:"externalResourceProvider,omitempty"` // HCO enforces the existence of several PciHostDevice objects. Set disabled field to true instead of remove // these objects. // +optional Disabled bool `json:"disabled,omitempty"` }
PciHostDevice represents a host PCI device allowed for passthrough +k8s:openapi-gen=true
func (*PciHostDevice) DeepCopy ¶
func (in *PciHostDevice) DeepCopy() *PciHostDevice
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new PciHostDevice.
func (*PciHostDevice) DeepCopyInto ¶
func (in *PciHostDevice) DeepCopyInto(out *PciHostDevice)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type PermittedHostDevices ¶
type PermittedHostDevices struct { // +listType=map // +listMapKey=pciDeviceSelector PciHostDevices []PciHostDevice `json:"pciHostDevices,omitempty"` // +listType=map // +listMapKey=mdevNameSelector MediatedDevices []MediatedHostDevice `json:"mediatedDevices,omitempty"` }
PermittedHostDevices holds information about devices allowed for passthrough +k8s:openapi-gen=true
func (*PermittedHostDevices) DeepCopy ¶
func (in *PermittedHostDevices) DeepCopy() *PermittedHostDevices
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new PermittedHostDevices.
func (*PermittedHostDevices) DeepCopyInto ¶
func (in *PermittedHostDevices) DeepCopyInto(out *PermittedHostDevices)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type StorageImportConfig ¶
type StorageImportConfig struct { // InsecureRegistries is a list of image registries URLs that are not secured. Setting an insecure registry URL // in this list allows pulling images from this registry. // +listType=set // +optional InsecureRegistries []string `json:"insecureRegistries,omitempty"` }
StorageImportConfig contains configuration for importing containerized data +k8s:openapi-gen=true
func (*StorageImportConfig) DeepCopy ¶
func (in *StorageImportConfig) DeepCopy() *StorageImportConfig
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new StorageImportConfig.
func (*StorageImportConfig) DeepCopyInto ¶
func (in *StorageImportConfig) DeepCopyInto(out *StorageImportConfig)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type Version ¶
type Version struct { Name string `json:"name,omitempty"` Version string `json:"version,omitempty"` }
func (*Version) DeepCopy ¶
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Version.
func (*Version) DeepCopyInto ¶
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
type VirtualMachineOptions ¶ added in v1.10.0
type VirtualMachineOptions struct { // DisableFreePageReporting disable the free page reporting of // memory balloon device https://libvirt.org/formatdomain.html#memory-balloon-device. // This will have effect only if AutoattachMemBalloon is not false and the vmi is not // requesting any high performance feature (dedicatedCPU/realtime/hugePages), in which free page reporting is always disabled. // +optional // +kubebuilder:default=true // +default=true DisableFreePageReporting bool `json:"disableFreePageReporting,omitempty"` }
VirtualMachineOptions holds the cluster level information regarding the virtual machine.
func (*VirtualMachineOptions) DeepCopy ¶ added in v1.10.0
func (in *VirtualMachineOptions) DeepCopy() *VirtualMachineOptions
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new VirtualMachineOptions.
func (*VirtualMachineOptions) DeepCopyInto ¶ added in v1.10.0
func (in *VirtualMachineOptions) DeepCopyInto(out *VirtualMachineOptions)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.