DataImportCron
cdi.kubevirt.io / v1beta1
apiVersion: cdi.kubevirt.io/v1beta1
kind: DataImportCron
metadata:
name: example
apiVersion
string
APIVersion defines the versioned schema of this representation of an object.
Servers should convert recognized schemas to the latest internal value, and
may reject unrecognized values.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
kind
string
Kind is a string value representing the REST resource this object represents.
Servers may infer this from the endpoint the client submits requests to.
Cannot be updated.
In CamelCase.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
metadata
object
spec object required
DataImportCronSpec defines specification for DataImportCron
garbageCollect
string
GarbageCollect specifies whether old PVCs should be cleaned up after a new PVC is imported.
Options are currently "Outdated" and "Never", defaults to "Outdated".
importsToKeep
integer
Number of import PVCs to keep when garbage collecting. Default is 3.
format:
int32
managedDataSource
string required
ManagedDataSource specifies the name of the corresponding DataSource this cron will manage.
DataSource has to be in the same namespace.
retentionPolicy
string
RetentionPolicy specifies whether the created DataVolumes and DataSources are retained when their DataImportCron is deleted. Default is RatainAll.
schedule
string required
Schedule specifies in cron format when and how often to look for new imports
serviceAccountName
string
ServiceAccountName is the name of the ServiceAccount for creating DataVolumes.
minLength:
1template object required
Template specifies template for the DVs to be created
apiVersion
string
APIVersion defines the versioned schema of this representation of an object.
Servers should convert recognized schemas to the latest internal value, and
may reject unrecognized values.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
kind
string
Kind is a string value representing the REST resource this object represents.
Servers may infer this from the endpoint the client submits requests to.
Cannot be updated.
In CamelCase.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
metadata
object
spec object required
DataVolumeSpec defines the DataVolume type specification
checkpoints []object
Checkpoints is a list of DataVolumeCheckpoints, representing stages in a multistage import.
current
string required
Current is the identifier of the snapshot created for this checkpoint.
previous
string required
Previous is the identifier of the snapshot from the previous checkpoint.
contentType
string
DataVolumeContentType options: "kubevirt", "archive"
enum:
kubevirt, archive
finalCheckpoint
boolean
FinalCheckpoint indicates whether the current DataVolumeCheckpoint is the final checkpoint.
preallocation
boolean
Preallocation controls whether storage for DataVolumes should be allocated in advance.
priorityClassName
string
PriorityClassName for Importer, Cloner and Uploader pod
pvc object
PVC is the PVC specification
accessModes
[]string
accessModes contains the desired access modes the volume should have.
More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1
dataSource object
dataSource field can be used to specify either:
* An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot)
* An existing PVC (PersistentVolumeClaim)
If the provisioner or an external controller can support the specified data source,
it will create a new volume based on the contents of the specified data source.
When the AnyVolumeDataSource feature gate is enabled, dataSource contents will be copied to dataSourceRef,
and dataSourceRef contents will be copied to dataSource when dataSourceRef.namespace is not specified.
If the namespace is specified, then dataSourceRef will not be copied to dataSource.
apiGroup
string
APIGroup is the group for the resource being referenced.
If APIGroup is not specified, the specified Kind must be in the core API group.
For any other third-party types, APIGroup is required.
kind
string required
Kind is the type of resource being referenced
name
string required
Name is the name of resource being referenced
dataSourceRef object
dataSourceRef specifies the object from which to populate the volume with data, if a non-empty
volume is desired. This may be any object from a non-empty API group (non
core object) or a PersistentVolumeClaim object.
When this field is specified, volume binding will only succeed if the type of
the specified object matches some installed volume populator or dynamic
provisioner.
This field will replace the functionality of the dataSource field and as such
if both fields are non-empty, they must have the same value. For backwards
compatibility, when namespace isn't specified in dataSourceRef,
both fields (dataSource and dataSourceRef) will be set to the same
value automatically if one of them is empty and the other is non-empty.
When namespace is specified in dataSourceRef,
dataSource isn't set to the same value and must be empty.
There are three important differences between dataSource and dataSourceRef:
* While dataSource only allows two specific types of objects, dataSourceRef
allows any non-core object, as well as PersistentVolumeClaim objects.
* While dataSource ignores disallowed values (dropping them), dataSourceRef
preserves all values, and generates an error if a disallowed value is
specified.
* While dataSource only allows local objects, dataSourceRef allows objects
in any namespaces.
(Beta) Using this field requires the AnyVolumeDataSource feature gate to be enabled.
(Alpha) Using the namespace field of dataSourceRef requires the CrossNamespaceVolumeDataSource feature gate to be enabled.
apiGroup
string
APIGroup is the group for the resource being referenced.
If APIGroup is not specified, the specified Kind must be in the core API group.
For any other third-party types, APIGroup is required.
kind
string required
Kind is the type of resource being referenced
name
string required
Name is the name of resource being referenced
namespace
string
Namespace is the namespace of resource being referenced
Note that when a namespace is specified, a gateway.networking.k8s.io/ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details.
(Alpha) This field requires the CrossNamespaceVolumeDataSource feature gate to be enabled.
resources object
resources represents the minimum resources the volume should have.
If RecoverVolumeExpansionFailure feature is enabled users are allowed to specify resource requirements
that are lower than previous value but must still be higher than capacity recorded in the
status field of the claim.
More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
limits
object
Limits describes the maximum amount of compute resources allowed.
More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
requests
object
Requests describes the minimum amount of compute resources required.
If Requests is omitted for a container, it defaults to Limits if that is explicitly specified,
otherwise to an implementation-defined value. Requests cannot exceed Limits.
More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
selector object
selector is a label query over volumes to consider for binding.
matchExpressions []object
matchExpressions is a list of label selector requirements. The requirements are ANDed.
key
string required
key is the label key that the selector applies to.
operator
string required
operator represents a key's relationship to a set of values.
Valid operators are In, NotIn, Exists and DoesNotExist.
values
[]string
values is an array of string values. If the operator is In or NotIn,
the values array must be non-empty. If the operator is Exists or DoesNotExist,
the values array must be empty. This array is replaced during a strategic
merge patch.
matchLabels
object
matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions, whose key field is "key", the
operator is "In", and the values array contains only "value". The requirements are ANDed.
storageClassName
string
storageClassName is the name of the StorageClass required by the claim.
More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1
volumeAttributesClassName
string
volumeAttributesClassName may be used to set the VolumeAttributesClass used by this claim.
If specified, the CSI driver will create or update the volume with the attributes defined
in the corresponding VolumeAttributesClass. This has a different purpose than storageClassName,
it can be changed after the claim is created. An empty string value means that no VolumeAttributesClass
will be applied to the claim but it's not allowed to reset this field to empty string once it is set.
If unspecified and the PersistentVolumeClaim is unbound, the default VolumeAttributesClass
will be set by the persistentvolume controller if it exists.
If the resource referred to by volumeAttributesClass does not exist, this PersistentVolumeClaim will be
set to a Pending state, as reflected by the modifyVolumeStatus field, until such as a resource
exists.
More info: https://kubernetes.io/docs/concepts/storage/volume-attributes-classes/
(Beta) Using this field requires the VolumeAttributesClass feature gate to be enabled (off by default).
volumeMode
string
volumeMode defines what type of volume is required by the claim.
Value of Filesystem is implied when not included in claim spec.
volumeName
string
volumeName is the binding reference to the PersistentVolume backing this claim.
serviceAccountName
string
ServiceAccountName for Importer and Uploader pod
source object
Source is the src of the data for the requested DataVolume
blank
object
DataVolumeBlankImage provides the parameters to create a new raw blank image for the PVC
gcs object
DataVolumeSourceGCS provides the parameters to create a Data Volume from an GCS source
secretRef
string
SecretRef provides the secret reference needed to access the GCS source
url
string required
URL is the url of the GCS source
http object
DataVolumeSourceHTTP can be either an http or https endpoint, with an optional basic auth user name and password, and an optional configmap containing additional CAs
certConfigMap
string
CertConfigMap is a configmap reference, containing a Certificate Authority(CA) public key, and a base64 encoded pem certificate
checksum
string
Checksum is the expected checksum of the file. Format: "algorithm:hash", e.g., "sha256:1234abcd..." or "md5:5678efgh..."
Supported algorithms: md5, sha1, sha256, sha512
If specified, the importer will verify the downloaded content matches this checksum
extraHeaders
[]string
ExtraHeaders is a list of strings containing extra headers to include with HTTP transfer requests
secretExtraHeaders
[]string
SecretExtraHeaders is a list of Secret references, each containing an extra HTTP header that may include sensitive information
secretRef
string
SecretRef A Secret reference, the secret should contain accessKeyId (user name) base64 encoded, and secretKey (password) also base64 encoded
url
string required
URL is the URL of the http(s) endpoint
imageio object
DataVolumeSourceImageIO provides the parameters to create a Data Volume from an imageio source
certConfigMap
string
CertConfigMap provides a reference to the CA cert
diskId
string required
DiskID provides id of a disk to be imported
insecureSkipVerify
boolean
InsecureSkipVerify is a flag to skip certificate verification
secretRef
string
SecretRef provides the secret reference needed to access the ovirt-engine
url
string required
URL is the URL of the ovirt-engine
pvc object
DataVolumeSourcePVC provides the parameters to create a Data Volume from an existing PVC
name
string required
The name of the source PVC
namespace
string required
The namespace of the source PVC
registry object
DataVolumeSourceRegistry provides the parameters to create a Data Volume from an registry source
certConfigMap
string
CertConfigMap provides a reference to the Registry certs
imageStream
string
ImageStream is the name of image stream for import
platform object
Platform describes the minimum runtime requirements of the image
architecture
string
Architecture specifies the image target CPU architecture
pullMethod
string
PullMethod can be either "pod" (default import), or "node" (node docker cache based import)
secretRef
string
SecretRef provides the secret reference needed to access the Registry source
url
string
URL is the url of the registry source (starting with the scheme: docker, oci-archive)
s3 object
DataVolumeSourceS3 provides the parameters to create a Data Volume from an S3 source
certConfigMap
string
CertConfigMap is a configmap reference, containing a Certificate Authority(CA) public key, and a base64 encoded pem certificate
secretRef
string
SecretRef provides the secret reference needed to access the S3 source
url
string required
URL is the url of the S3 source
snapshot object
DataVolumeSourceSnapshot provides the parameters to create a Data Volume from an existing VolumeSnapshot
name
string required
The name of the source VolumeSnapshot
namespace
string required
The namespace of the source VolumeSnapshot
upload
object
DataVolumeSourceUpload provides the parameters to create a Data Volume by uploading the source
vddk object
DataVolumeSourceVDDK provides the parameters to create a Data Volume from a Vmware source
backingFile
string
BackingFile is the path to the virtual hard disk to migrate from vCenter/ESXi
extraArgs
string
ExtraArgs is a reference to a ConfigMap containing extra arguments to pass directly to the VDDK library
initImageURL
string
InitImageURL is an optional URL to an image containing an extracted VDDK library, overrides v2v-vmware config map
secretRef
string
SecretRef provides a reference to a secret containing the username and password needed to access the vCenter or ESXi host
thumbprint
string
Thumbprint is the certificate thumbprint of the vCenter or ESXi host
url
string
URL is the URL of the vCenter or ESXi host with the VM to migrate
uuid
string
UUID is the UUID of the virtual machine that the backing file is attached to in vCenter/ESXi
sourceRef object
SourceRef is an indirect reference to the source of data for the requested DataVolume
kind
string required
The kind of the source reference, currently only "DataSource" is supported
name
string required
The name of the source reference
namespace
string
The namespace of the source reference, defaults to the DataVolume namespace
storage object
Storage is the requested storage specification
accessModes
[]string
AccessModes contains the desired access modes the volume should have.
More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1
dataSource object
This field can be used to specify either: * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot) * An existing PVC (PersistentVolumeClaim) * An existing custom resource that implements data population (Alpha) In order to use custom resource types that implement data population, the AnyVolumeDataSource feature gate must be enabled. If the provisioner or an external controller can support the specified data source, it will create a new volume based on the contents of the specified data source.
If the AnyVolumeDataSource feature gate is enabled, this field will always have the same contents as the DataSourceRef field.
apiGroup
string
APIGroup is the group for the resource being referenced.
If APIGroup is not specified, the specified Kind must be in the core API group.
For any other third-party types, APIGroup is required.
kind
string required
Kind is the type of resource being referenced
name
string required
Name is the name of resource being referenced
dataSourceRef object
Specifies the object from which to populate the volume with data, if a non-empty volume is desired. This may be any local object from a non-empty API group (non core object) or a PersistentVolumeClaim object. When this field is specified, volume binding will only succeed if the type of the specified object matches some installed volume populator or dynamic provisioner.
This field will replace the functionality of the DataSource field and as such if both fields are non-empty, they must have the same value. For backwards compatibility, both fields (DataSource and DataSourceRef) will be set to the same value automatically if one of them is empty and the other is non-empty.
There are two important differences between DataSource and DataSourceRef:
* While DataSource only allows two specific types of objects, DataSourceRef allows any non-core object, as well as PersistentVolumeClaim objects.
* While DataSource ignores disallowed values (dropping them), DataSourceRef preserves all values, and generates an error if a disallowed value is specified.
(Beta) Using this field requires the AnyVolumeDataSource feature gate to be enabled.
apiGroup
string
APIGroup is the group for the resource being referenced.
If APIGroup is not specified, the specified Kind must be in the core API group.
For any other third-party types, APIGroup is required.
kind
string required
Kind is the type of resource being referenced
name
string required
Name is the name of resource being referenced
namespace
string
Namespace is the namespace of resource being referenced
Note that when a namespace is specified, a gateway.networking.k8s.io/ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details.
(Alpha) This field requires the CrossNamespaceVolumeDataSource feature gate to be enabled.
resources object
Resources represents the minimum resources the volume should have.
More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
limits
object
Limits describes the maximum amount of compute resources allowed.
More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
requests
object
Requests describes the minimum amount of compute resources required.
If Requests is omitted for a container, it defaults to Limits if that is explicitly specified,
otherwise to an implementation-defined value. Requests cannot exceed Limits.
More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
selector object
A label query over volumes to consider for binding.
matchExpressions []object
matchExpressions is a list of label selector requirements. The requirements are ANDed.
key
string required
key is the label key that the selector applies to.
operator
string required
operator represents a key's relationship to a set of values.
Valid operators are In, NotIn, Exists and DoesNotExist.
values
[]string
values is an array of string values. If the operator is In or NotIn,
the values array must be non-empty. If the operator is Exists or DoesNotExist,
the values array must be empty. This array is replaced during a strategic
merge patch.
matchLabels
object
matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions, whose key field is "key", the
operator is "In", and the values array contains only "value". The requirements are ANDed.
storageClassName
string
Name of the StorageClass required by the claim.
More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1
volumeMode
string
volumeMode defines what type of volume is required by the claim.
Value of Filesystem is implied when not included in claim spec.
volumeName
string
VolumeName is the binding reference to the PersistentVolume backing this claim.
status object
DataVolumeStatus contains the current status of the DataVolume
claimName
string
ClaimName is the name of the underlying PVC used by the DataVolume.
conditions []object
lastHeartbeatTime
string
format:
date-time
lastTransitionTime
string
format:
date-time
message
string
reason
string
status
string required
type
string required
DataVolumeConditionType is the string representation of known condition types
phase
string
Phase is the current phase of the data volume
progress
string
DataVolumeProgress is the current progress of the DataVolume transfer operation. Value between 0 and 100 inclusive, N/A if not available
restartCount
integer
RestartCount is the number of times the pod populating the DataVolume has restarted
format:
int32status object
DataImportCronStatus provides the most recently observed status of the DataImportCron
conditions []object
lastHeartbeatTime
string
format:
date-time
lastTransitionTime
string
format:
date-time
message
string
reason
string
status
string required
type
string required
DataImportCronConditionType is the string representation of known condition types
currentImports []object
CurrentImports are the imports in progress. Currently only a single import is supported.
DataVolumeName
string required
DataVolumeName is the currently in progress import DataVolume
Digest
string required
Digest of the currently imported image
lastExecutionTimestamp
string
LastExecutionTimestamp is the time of the last polling
format:
date-time
lastImportTimestamp
string
LastImportTimestamp is the time of the last import
format:
date-timelastImportedPVC object
LastImportedPVC is the last imported PVC
name
string required
The name of the source PVC
namespace
string required
The namespace of the source PVC
sourceFormat
string
SourceFormat defines the format of the DataImportCron-created disk image sources
No matches. Try .spec.garbageCollect for an exact path