package
3.0.4
Repository: https://github.com/openebs/api.git
Documentation: pkg.go.dev

# Functions

GetResizeCondition will return resize condtion related to cstorvolume condtions.
HasNodeName is predicate to filter out based on node name of CSPI instances.
IsCVRHealthy returns true if CVR phase is Healthy.
IsOnline is predicate to filter out based on online CSPI instances.
IsReplicaNonQuorum returns true if CVR phase is either NewReplicaDegraded or ReconstructingNewReplica.
IsScaleDownInProgress return true if length of status replica details is greater than length of spec replica details.
No description provided by the author
No description provided by the author
NewCStorPoolInstanceBlockDevice returns an empty instance of CStorPoolInstanceBlockDevice.
NewCStorVolume returns new instance of CStorVolume.
NewCStorVolumeConfig returns new instance of CStorVolumeConfig.
NewCStorVolumeObj returns a new instance of cstorvolume.
NewCStorVolumeReplica returns new instance of CStorVolumeReplica.
No description provided by the author
No description provided by the author
NewRaidGroup returns an empty instance of raid group.
Resource takes an unqualified resource and returns a Group qualified GroupResource.

# Constants

APIVersion holds the value of OpenEBS version.
BKPCStorStatusDone , backup is completed.
BKPCStorStatusEmpty represents backup resource is created and yet to be reconcile by backup controller.
BKPCStorStatusFailed , backup is failed.
BKPCStorStatusInit , backup is initialized.
BKPCStorStatusInProgress , backup is in progress.
BKPCStorStatusInvalid , backup operation is invalid.
BKPCStorStatusPending , backup is pending.
CloneEnableKEY is used to enable/disable cloning for a cstorvolumereplica.
ConditionInProgress states resize of underlying volumes are in progress.
ConditionSuccess states resizing underlying volumes are successfull.
CSPIDiskReplacement condition will be available when user triggers disk replacement by replacing the blockdevice.
CSPIDiskUnavailable condition will be available when one (or) more disks were unavailable.
CSPIPoolExpansion condition will be available when user triggers pool expansion by adding blockdevice/raidgroup (or) when underlying disk got expanded.
CSPIPoolLost condition will be available when unable to import the pool.
CStorNodeBase nodeBase for cstor volume.
CStorPoolStatusCreateFailed is state when pool creation failed.
CStorPoolStatusDegraded signifies that the pool is degraded.
CStorPoolStatusDeletionFailed ensures the resource deletion has failed.
CStorPoolStatusEmpty ensures the create operation is to be done, if import fails.
CStorPoolStatusError signifies that the pool status could not be fetched.
CStorPoolStatusErrorDuplicate ensures error due to duplicate resource.
CStorPoolStatusFaulted signifies that the pool is faulted.
CStorPoolStatusInit is initial state of CSP, before pool creation.
CStorPoolStatusInvalid ensures invalid resource.
CStorPoolStatusOffline signifies that the pool is offline.
CStorPoolStatusOnline signifies that the pool is online.
CStorPoolStatusPending ensures pending task for cstorpool.
CStorPoolStatusRemoved signifies that the pool is removed.
CStorPoolStatusUnavail signifies that the pool is not available.
CStorVolumeAttachmentStatusMounteid indicated that the volume has been successfulled mounted on the node.
CStorVolumeAttachmentStatusMountFailed indicates that login and mount process from the volume has bben started but failed kubernetes needs to retry sending nodepublish.
CStorVolumeAttachmentStatusMountUnderProgress indicates that the volume is busy and unavailable for use by other goroutines, an iSCSI login followed by mount is under progress on this volume.
CStorVolumeAttachmentStatusRaw indicates that the volume is being used in raw format by the application, therefore CSI has only performed iSCSI login operation on this volume and avoided filesystem creation and mount.
CStorVolumeAttachmentStatusRemountUnderProgress indicates that the volume is being remounted.
CStorVolumeAttachmentStatusResizeInProgress indicates that the volume is being resized.
CStorVolumeAttachmentStatusUninitialized indicates that no operation has been performed on the volume yet on this node.
CStorVolumeAttachmentStatusUnMounted indicated that the volume has been successfuly unmounted and logged out of the node.
CStorVolumeAttachmentStatusUnmountInProgress indicates that the volume is busy and unavailable for use by other goroutines, an unmount operation on volume is under progress.
CStorVolumeAttachmentStatusWaitingForCVCBound indicates that the volume components are still being created.
CStorVolumeAttachmentStatusWaitingForVolumeToBeReady indicates that the replicas are yet to connect to target.
CStorVolumeConfigPhaseBound indiacates that the cstorvolume has beenprovisioned and bound to the cstor volume config.
CStorVolumeConfigPhaseFailed indiacates that the cstorvolume provisioninghas failed.
CStorVolumeConfigPhasePending indicates that the cvc is still waiting forthe cstorvolume to be created and bound.
CStorVolumeConfigResizeFailed ...
CStorVolumeConfigResizePending ...
CStorVolumeConfigResizeSuccess ...
CStorVolumeConfigResizePending ...
CStorVolumeReplicaFinalizer is the name of finalizer on CStorVolumeConfig.
CStorVolumeResizing - a user trigger resize of pvc has been started.
CVRStatusDegraded describes volume replica is connected to the target and rebuilding from other replicas is not yet started but ready for serving IO's.
CVRStatusDeletionFailed describes volume replica deletion is failed.
CVRStatusEmpty describes CVR resource is created but not yet monitored by controller(i.e resource is just created).
CVRStatusError describes either volume replica is not exist in cstor pool.
CVRStatusInit describes CVR resource is newly created but it is not yet created zfs dataset.
CVRStatusInvalid ensures invalid resource(currently not honoring).
CVRStatusNewReplicaDegraded describes replica is recreated (due to pool recreation[underlying disk got changed]/volume replica scaleup cases) and just connected to the target.
CVRStatusOffline describes volume replica is created but not yet connected to the target.
CVRStatusOnline describes volume replica is Healthy and data existing on the healthy replica is up to date.
CVRStatusRebuilding describes volume replica has missing data and it started rebuilding missing data from other replicas.
CVRStatusReconstructingNewReplica describes volume replica is recreated and it started reconstructing entier data from other healthy replica.
CVRStatusRecreate describes the volume replica is recreated due to pool recreation/scaleup.
volume only satisfies consistency factor.
Error in retrieving volume details.
volume allows IOs and snapshot.
volume is getting initialized.
volume controller config generation failed due to invalid parameters.
Volume is offline.
PoolManagerAvailable means the PoolManagerAvailable deployment is available, ie.
PoolMirrored is the mirror raid group.
PoolRaidz is the raidz raid group.
PoolRaidz2 is the raidz2 raid group.
PoolStriped is the striped raid group.
ReconcileComplete is the state when desired and current version are equal.
ReconcileInProgress is the state when desired and current version are not same and the reconcile functions is retrying to make them same.
ReconcilePending is the state the reconciliation is still not started yet.
RSTCStorStatusDone , restore operation is completed.
RSTCStorStatusEmpty represents the restore resource is created and yet to be reconciled by restore controller.
RSTCStorStatusFailed , restore operation is failed.
RSTCStorStatusInit , restore operation is initialized.
RSTCStorStatusInProgress , restore operation is in progress.
RSTCStorStatusInvalid , restore operation is invalid.
RSTCStorStatusPending , restore operation is pending.
SnapshotNameKey stores the name of the snapshot being used to restore this replica.
SourceVolumeKey stores the name of source volume whose snapshot is used to create this cvr.
No description provided by the author
TargetPort is port for cstor volume.

# Variables

AddToScheme is a global function that registers this API group & version to a scheme.
SchemeBuilder is the scheme builder with scheme init functions to run for this API package.
SchemeGroupVersion is group version used to register these objects.

# Structs

CStorBackup describes a cstor backup resource created as a custom resource +kubebuilder:object:root=true +kubebuilder:resource:scope=Namespaced,shortName=cbackup +kubebuilder:printcolumn:name="Volume",type=string,JSONPath=`.spec.volumeName`,description="Name of the volume for which this backup is destined" +kubebuilder:printcolumn:name="Backup/Schedule",type=string,JSONPath=`.spec.backupName`,description="Name of the backup or scheduled backup" +kubebuilder:printcolumn:name="Status",type=string,JSONPath=`.status`,description="Identifies the phase of the backup".
CStorBackupList is a list of CStorBackup resources.
CStorBackupSpec is the spec for a CStorBackup resource.
CStorCompletedBackup describes a cstor completed-backup resource created as custom resource +kubebuilder:object:root=true +kubebuilder:resource:scope=Namespaced,shortName=ccompletedbackup +kubebuilder:printcolumn:name="Volume",type=string,JSONPath=`.spec.volumeName`,description="Volume name on which backup is performed" +kubebuilder:printcolumn:name="Backup/Schedule",type=string,JSONPath=`.spec.backupName`,description="Name of the backup or scheduled backup" +kubebuilder:printcolumn:name="LastSnap",type=string,JSONPath=`.spec.lastSnapName`,description="Last successfully backup snapshot".
CStorCompletedBackupList is a list of cstorcompletedbackup resources.
CStorCompletedBackupSpec is the spec for a CStorBackup resource.
CStorPoolCluster describes a CStorPoolCluster custom resource.
CStorPoolClusterCondition describes the state of a CSPC at a certain point.
CStorPoolClusterList is a list of CStorPoolCluster resources.
CStorPoolClusterSpec is the spec for a CStorPoolClusterSpec resource.
CStorPoolClusterStatus represents the latest available observations of a CSPC's current state.
CStorPoolInstance describes a cstor pool instance resource.
CStorPoolInstanceBlockDevice contains the details of block devices that constitutes a raid group.
CStorPoolInstanceCapacity stores the pool capacity related attributes.
CSPIConditionType describes the state of a CSPI at a certain point.
CStorPoolInstanceList is a list of CStorPoolInstance resources.
CStorPoolInstanceSpec is the spec listing fields for a CStorPoolInstance resource.
CStorPoolInstanceStatus is for handling status of pool.
CStorRestore describes a cstor restore resource created as a custom resource +kubebuilder:object:root=true +kubebuilder:resource:scope=Namespaced,shortName=crestore +kubebuilder:printcolumn:name="Backup",type=string,JSONPath=`.spec.restoreName`,description="Name of the snapshot which is restored" +kubebuilder:printcolumn:name="Volume",type=string,JSONPath=`.spec.volumeName`,description="Volume on which restore is performed" +kubebuilder:printcolumn:name="Status",type=string,JSONPath=`.status`,description="Identifies the state of the restore".
CStorRestoreList is a list of CStorRestore resources.
CStorRestoreSpec is the spec for a CStorRestore resource.
CStorSnapshotInfo represents the snapshot information related to particular snapshot.
CStorVolume describes a cstor volume resource created as custom resource +kubebuilder:object:root=true +kubebuilder:resource:scope=Namespaced,shortName=cv +kubebuilder:printcolumn:name="Capacity",type=string,JSONPath=`.status.capacity`,description="Current volume capacity" +kubebuilder:printcolumn:name="Status",type=string,JSONPath=`.status.phase`,description="Identifies the current health of the volume" +kubebuilder:printcolumn:name="Age",type=date,JSONPath=`.metadata.creationTimestamp`,description="Age of CStorVolume".
CStorVolumeAttachment represents a CSI based volume +kubebuilder:object:root=true +kubebuilder:resource:scope=Namespaced,shortName=cva.
CStorVolumeAttachmentList is a list of CStorVolumeAttachment resources.
CStorVolumeAttachmentSpec is the spec for a CStorVolume resource.
CStorVolumeCondition contains details about state of cstorvolume.
CStorVolumeConfig describes a cstor volume config resource created as custom resource.
CStorVolumeConfigCondition contains details about state of cstor volume.
CStorVolumeConfigList is a list of CStorVolumeConfig resources.
CStorVolumeConfigPublish contains info related to attachment of a volume to a node.
CStorVolumeConfigSpec is the spec for a CStorVolumeConfig resource.
CStorVolumeConfigStatus is for handling status of CstorVolume Claim.
CStorVolumeList is a list of CStorVolume resources.
CStorVolumePolicy describes a configuration required for cstor volume resources +kubebuilder:object:root=true +kubebuilder:resource:scope=Namespaced,shortName=cvp.
CStorVolumePolicyList is a list of CStorVolumePolicy resources.
CStorVolumePolicySpec ...
CStorVolumePolicyStatus is for handling status of CstorVolumePolicy.
CStorVolumeReplica describes a cstor volume resource created as custom resource +kubebuilder:object:root=true +kubebuilder:resource:scope=Namespaced,shortName=cvr +kubebuilder:printcolumn:name="Allocated",type=string,JSONPath=`.status.capacity.total`,description="The amount of disk space consumed by a dataset and all its descendents" +kubebuilder:printcolumn:name="Used",type=string,JSONPath=`.status.capacity.used`,description="The amount of space that is logically consumed by this dataset" +kubebuilder:printcolumn:name="Status",type=string,JSONPath=`.status.phase`,description="Identifies the current state of the replicas" +kubebuilder:printcolumn:name="Age",type=date,JSONPath=`.metadata.creationTimestamp`,description="Age of CStorVolumeReplica".
CStorVolumeReplicaCapacityDetails represents capacity information releated to volume replica.
CStorVolumeReplicaDetails contains trusty replica inform which will be updated by target.
CStorVolumeReplicaList is a list of CStorVolumeReplica resources.
CStorVolumeReplicaSpec is the spec for a CStorVolumeReplica resource.
CStorVolumeReplicaStatus is for handling status of cvr.
CStorVolumeSpec is the spec for a CStorVolume resource.
CStorVolumeStatus is for handling status of cvr.
CVStatus stores the status of a CstorVolume obtained from response.
CVStatusResponse stores the reponse of istgt replica command output It may contain several volumes.
ISCSIInfo has ISCSI protocol specific info, this can be used only if the volume type exposed by the vendor is iSCSI.
PoolConfig is the default pool config that applies to the pool on node.
PoolSpec is the spec for pool on node where it should be created.
Provision represents different provisioning policy for cstor volumes.
RaidGroup contains the details of a raid group for the pool.
ReplicaPoolInfo represents the pool information of volume replica.
ReplicaSpec represents configuration related to replicas resources.
ReplicaStatus stores the status of replicas.
TargetSpec represents configuration related to cstor target and its resources.
VersionDetails provides the details for upgrade.
VersionStatus is the status of the reconciliation of versions.
VolumeInfo contains the volume related info for all types of volumes in CStorVolumeAttachmentSpec.
No description provided by the author
ZFSCapacityAttributes stores the advanced information about pool capacity related attributes.

# Type aliases

Conditions enables building CRUD operations on cstorvolume conditions.
ConditionStatus states in which state condition is present.
No description provided by the author
Predicate defines an abstraction to determine conditional checks against the provided CStorPoolInstance.
CStorBackupStatus is a string type that represents the status of the backup.
No description provided by the author
CStorPoolInstancePhase is the phase for CStorPoolInstance resource.
CStorRestoreStatus is a string type that represents the status of the restore.
CStorVolumeAttachmentStatus status represents the current mount status of the volume.
CStorVolumeConditionType is a valid value of CStorVolumeCondition.Type.
CStorVolumeConfigConditionType is a valid value of CstorVolumeConfigCondition.Type.
CStorVolumeConfigPhase represents the current phase of CStorVolumeConfig.
CStorVolumePhase is to hold result of action.
CStorVolumeReplicaPhase is to hold result of action.
CVRKey represents the properties of a cstorvolumereplica.
CVRPredicate defines an abstraction to determine conditional checks against the provided CVolumeReplicas.
CVRPredicateList holds the list of Predicates.
PoolType is a label for the pool type of a cStor pool.
ReplicaID is to hold replicaID information.
VersionState is the state of reconciliation.