Package v1alpha1 is the v1alpha1 version of the API.
Resource Types:- AlluxioRuntime
- DataLoad
- DataMigrate
- DataProcess
- Dataset
- EFCRuntime
- GooseFSRuntime
- JindoRuntime
- JuiceFSRuntime
- ThinRuntime
- VineyardRuntime
AlluxioRuntime is the Schema for the alluxioruntimes API
| Field | Description | ||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersionstring |
data.fluid.io/v1alpha1
|
||||||||||||||||||||||||||||||||||||||||
kindstring |
AlluxioRuntime |
||||||||||||||||||||||||||||||||||||||||
metadataKubernetes meta/v1.ObjectMeta |
Refer to the Kubernetes API documentation for the fields of the
metadata field.
|
||||||||||||||||||||||||||||||||||||||||
specAlluxioRuntimeSpec |
|
||||||||||||||||||||||||||||||||||||||||
statusRuntimeStatus |
DataLoad is the Schema for the dataloads API
| Field | Description | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersionstring |
data.fluid.io/v1alpha1
|
||||||||||||||||||||||||||||
kindstring |
DataLoad |
||||||||||||||||||||||||||||
metadataKubernetes meta/v1.ObjectMeta |
Refer to the Kubernetes API documentation for the fields of the
metadata field.
|
||||||||||||||||||||||||||||
specDataLoadSpec |
|
||||||||||||||||||||||||||||
statusOperationStatus |
DataMigrate is the Schema for the datamigrates API
| Field | Description | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersionstring |
data.fluid.io/v1alpha1
|
||||||||||||||||||||||||||||||||||||
kindstring |
DataMigrate |
||||||||||||||||||||||||||||||||||||
metadataKubernetes meta/v1.ObjectMeta |
Refer to the Kubernetes API documentation for the fields of the
metadata field.
|
||||||||||||||||||||||||||||||||||||
specDataMigrateSpec |
|
||||||||||||||||||||||||||||||||||||
statusOperationStatus |
DataProcess is the Schema for the dataprocesses API
| Field | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|
apiVersionstring |
data.fluid.io/v1alpha1
|
||||||||
kindstring |
DataProcess |
||||||||
metadataKubernetes meta/v1.ObjectMeta |
Refer to the Kubernetes API documentation for the fields of the
metadata field.
|
||||||||
specDataProcessSpec |
|
||||||||
statusOperationStatus |
Dataset is the Schema for the datasets API
| Field | Description | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersionstring |
data.fluid.io/v1alpha1
|
||||||||||||||||||||
kindstring |
Dataset |
||||||||||||||||||||
metadataKubernetes meta/v1.ObjectMeta |
Refer to the Kubernetes API documentation for the fields of the
metadata field.
|
||||||||||||||||||||
specDatasetSpec |
|
||||||||||||||||||||
statusDatasetStatus |
EFCRuntime is the Schema for the efcruntimes API
| Field | Description | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersionstring |
data.fluid.io/v1alpha1
|
||||||||||||||||||
kindstring |
EFCRuntime |
||||||||||||||||||
metadataKubernetes meta/v1.ObjectMeta |
Refer to the Kubernetes API documentation for the fields of the
metadata field.
|
||||||||||||||||||
specEFCRuntimeSpec |
|
||||||||||||||||||
statusRuntimeStatus |
GooseFSRuntime is the Schema for the goosefsruntimes API
| Field | Description | ||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersionstring |
data.fluid.io/v1alpha1
|
||||||||||||||||||||||||||||||||||
kindstring |
GooseFSRuntime |
||||||||||||||||||||||||||||||||||
metadataKubernetes meta/v1.ObjectMeta |
Refer to the Kubernetes API documentation for the fields of the
metadata field.
|
||||||||||||||||||||||||||||||||||
specGooseFSRuntimeSpec |
|
||||||||||||||||||||||||||||||||||
statusRuntimeStatus |
JindoRuntime is the Schema for the jindoruntimes API
| Field | Description | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersionstring |
data.fluid.io/v1alpha1
|
||||||||||||||||||||||||||||||||||||
kindstring |
JindoRuntime |
||||||||||||||||||||||||||||||||||||
metadataKubernetes meta/v1.ObjectMeta |
Refer to the Kubernetes API documentation for the fields of the
metadata field.
|
||||||||||||||||||||||||||||||||||||
specJindoRuntimeSpec |
|
||||||||||||||||||||||||||||||||||||
statusRuntimeStatus |
JuiceFSRuntime is the Schema for the juicefsruntimes API
| Field | Description | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersionstring |
data.fluid.io/v1alpha1
|
||||||||||||||||||||||||||||
kindstring |
JuiceFSRuntime |
||||||||||||||||||||||||||||
metadataKubernetes meta/v1.ObjectMeta |
Refer to the Kubernetes API documentation for the fields of the
metadata field.
|
||||||||||||||||||||||||||||
specJuiceFSRuntimeSpec |
|
||||||||||||||||||||||||||||
statusRuntimeStatus |
ThinRuntime is the Schema for the thinruntimes API
| Field | Description | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersionstring |
data.fluid.io/v1alpha1
|
||||||||||||||||||||
kindstring |
ThinRuntime |
||||||||||||||||||||
metadataKubernetes meta/v1.ObjectMeta |
Refer to the Kubernetes API documentation for the fields of the
metadata field.
|
||||||||||||||||||||
specThinRuntimeSpec |
|
||||||||||||||||||||
statusRuntimeStatus |
VineyardRuntime is the Schema for the VineyardRuntimes API
| Field | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersionstring |
data.fluid.io/v1alpha1
|
||||||||||||||||
kindstring |
VineyardRuntime |
||||||||||||||||
metadataKubernetes meta/v1.ObjectMeta |
Refer to the Kubernetes API documentation for the fields of the
metadata field.
|
||||||||||||||||
specVineyardRuntimeSpec |
|
||||||||||||||||
statusRuntimeStatus |
(Appears on: RuntimeStatus)
API Gateway
| Field | Description |
|---|---|
endpointstring |
Endpoint for accessing |
(Appears on: AffinityStrategy)
AffinityPolicy the strategy for the affinity between Data Operation Pods.
(Appears on: OperationRef)
| Field | Description |
|---|---|
dependOnObjectRef |
(Optional)
Specifies the dependent preceding operation in a workflow. If not set, use the operation referred to by RunAfter. |
policyAffinityPolicy |
(Optional)
Policy one of: “”, “Require”, “Prefer” |
prefers[]Prefer |
|
requires[]Require |
(Appears on: AlluxioRuntimeSpec)
AlluxioCompTemplateSpec is a description of the Alluxio commponents
| Field | Description |
|---|---|
replicasint32 |
(Optional)
Replicas is the desired number of replicas of the given template. If unspecified, defaults to 1. replicas is the min replicas of dataset in the cluster |
jvmOptions[]string |
Options for JVM |
propertiesmap[string]string |
(Optional)
Configurable properties for the Alluxio component. |
portsmap[string]int |
(Optional)
Ports used by Alluxio(e.g. rpc: 19998 for master) |
resourcesKubernetes core/v1.ResourceRequirements |
(Optional)
Resources that will be requested by the Alluxio component. |
envmap[string]string |
Environment variables that will be used by Alluxio component. |
enabledbool |
(Optional)
Enabled or Disabled for the components. For now, only API Gateway is enabled or disabled. |
nodeSelectormap[string]string |
(Optional)
NodeSelector is a selector which must be true for the master to fit on a node |
networkModeNetworkMode |
(Optional)
Whether to use hostnetwork or not |
volumeMounts[]Kubernetes core/v1.VolumeMount |
(Optional)
VolumeMounts specifies the volumes listed in “.spec.volumes” to mount into the alluxio runtime component’s filesystem. |
podMetadataPodMetadata |
(Optional)
PodMetadata defines labels and annotations that will be propagated to Alluxio’s pods |
imagePullSecrets[]Kubernetes core/v1.LocalObjectReference |
ImagePullSecrets that will be used to pull images |
(Appears on: AlluxioRuntimeSpec)
AlluxioFuseSpec is a description of the Alluxio Fuse
| Field | Description |
|---|---|
imagestring |
Image for Alluxio Fuse(e.g. alluxio/alluxio-fuse) |
imageTagstring |
Image Tag for Alluxio Fuse(e.g. 2.3.0-SNAPSHOT) |
imagePullPolicystring |
One of the three policies: |
imagePullSecrets[]Kubernetes core/v1.LocalObjectReference |
ImagePullSecrets that will be used to pull images |
jvmOptions[]string |
Options for JVM |
propertiesmap[string]string |
Configurable properties for Alluxio System. |
envmap[string]string |
Environment variables that will be used by Alluxio Fuse |
resourcesKubernetes core/v1.ResourceRequirements |
(Optional)
Resources that will be requested by Alluxio Fuse. |
args[]string |
Arguments that will be passed to Alluxio Fuse |
nodeSelectormap[string]string |
(Optional)
NodeSelector is a selector which must be true for the fuse client to fit on a node, this option only effect when global is enabled |
cleanPolicyFuseCleanPolicy |
(Optional)
CleanPolicy decides when to clean Alluxio Fuse pods. Currently Fluid supports two policies: OnDemand and OnRuntimeDeleted OnDemand cleans fuse pod once the fuse pod on some node is not needed OnRuntimeDeleted cleans fuse pod only when the cache runtime is deleted Defaults to OnRuntimeDeleted |
networkModeNetworkMode |
(Optional)
Whether to use hostnetwork or not |
volumeMounts[]Kubernetes core/v1.VolumeMount |
(Optional)
VolumeMounts specifies the volumes listed in “.spec.volumes” to mount into the alluxio runtime component’s filesystem. |
podMetadataPodMetadata |
(Optional)
PodMetadata defines labels and annotations that will be propagated to Alluxio’s fuse pods |
(Appears on: AlluxioRuntime)
AlluxioRuntimeSpec defines the desired state of AlluxioRuntime
| Field | Description |
|---|---|
alluxioVersionVersionSpec |
The version information that instructs fluid to orchestrate a particular version of Alluxio. |
masterAlluxioCompTemplateSpec |
The component spec of Alluxio master |
jobMasterAlluxioCompTemplateSpec |
The component spec of Alluxio job master |
workerAlluxioCompTemplateSpec |
The component spec of Alluxio worker |
jobWorkerAlluxioCompTemplateSpec |
The component spec of Alluxio job Worker |
apiGatewayAlluxioCompTemplateSpec |
The component spec of Alluxio API Gateway |
initUsersInitUsersSpec |
The spec of init users |
fuseAlluxioFuseSpec |
The component spec of Alluxio Fuse |
propertiesmap[string]string |
Configurable properties for Alluxio system. |
jvmOptions[]string |
Options for JVM |
tieredstoreTieredStore |
Tiered storage used by Alluxio |
dataData |
Management strategies for the dataset to which the runtime is bound |
replicasint32 |
The replicas of the worker, need to be specified |
runAsUser |
Manage the user to run Alluxio Runtime |
disablePrometheusbool |
(Optional)
Disable monitoring for Alluxio Runtime Prometheus is enabled by default |
hadoopConfigstring |
(Optional)
Name of the configMap used to support HDFS configurations when using HDFS as Alluxio’s UFS. The configMap must be in the same namespace with the AlluxioRuntime. The configMap should contain user-specific HDFS conf files in it. For now, only “hdfs-site.xml” and “core-site.xml” are supported. It must take the filename of the conf file as the key and content of the file as the value. |
volumes[]Kubernetes core/v1.Volume |
(Optional)
Volumes is the list of Kubernetes volumes that can be mounted by the alluxio runtime components and/or fuses. |
podMetadataPodMetadata |
(Optional)
PodMetadata defines labels and annotations that will be propagated to Alluxio’s pods |
managementRuntimeManagement |
(Optional)
RuntimeManagement defines policies when managing the runtime |
imagePullSecrets[]Kubernetes core/v1.LocalObjectReference |
(Optional)
ImagePullSecrets that will be used to pull images |
(Appears on: DatasetSpec)
CacheableNodeAffinity defines constraints that limit what nodes this dataset can be cached to.
| Field | Description |
|---|---|
requiredKubernetes core/v1.NodeSelector |
Required specifies hard node constraints that must be met. |
(Appears on: EFCRuntimeSpec, GooseFSRuntimeSpec, JindoRuntimeSpec, RuntimeManagement)
CleanCachePolicy defines policies when cleaning cache
| Field | Description |
|---|---|
gracePeriodSecondsint32 |
(Optional)
Optional duration in seconds the cache needs to clean gracefully. May be decreased in delete runtime request. Value must be non-negative integer. The value zero indicates clean immediately via the timeout command (no opportunity to shut down). If this value is nil, the default grace period will be used instead. The grace period is the duration in seconds after the processes running in the pod are sent a termination signal and the time when the processes are forcibly halted with timeout command. Set this value longer than the expected cleanup time for your process. |
maxRetryAttemptsint32 |
(Optional)
Optional max retry Attempts when cleanCache function returns an error after execution, runtime attempts to run it three more times by default. With Maximum Retry Attempts, you can customize the maximum number of retries. This gives you the option to continue processing retries. |
(Appears on: JindoFuseSpec)
| Field | Description |
|---|---|
enabledbool |
Enabled decides whether to expose client metrics. |
scrapeTargetstring |
ScrapeTarget decides which fuse component will be scraped by Prometheus. It is a list separated by comma where supported items are [MountPod, Sidecar, All (indicates MountPod and Sidecar), None]. Defaults to None when it is not explicitly set. |
(Appears on: OperationStatus)
Condition explains the transitions on phase
| Field | Description |
|---|---|
typecommon.ConditionType |
Type of condition, either |
statusKubernetes core/v1.ConditionStatus |
Status of the condition, one of |
reasonstring |
Reason for the condition’s last transition |
messagestring |
Message is a human-readable message indicating details about the transition |
lastProbeTimeKubernetes meta/v1.Time |
LastProbeTime describes last time this condition was updated. |
lastTransitionTimeKubernetes meta/v1.Time |
LastTransitionTime describes last time the condition transitioned from one status to another. |
(Appears on: AlluxioRuntimeSpec, GooseFSRuntimeSpec)
Data management strategies
| Field | Description |
|---|---|
replicasint32 |
(Optional)
The copies of the dataset |
pinbool |
(Optional)
Pin the dataset or not. Refer to Alluxio User-CLI pin |
DataBackup is the Schema for the backup API
| Field | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
metadataKubernetes meta/v1.ObjectMeta |
Refer to the Kubernetes API documentation for the fields of the
metadata field.
|
||||||||||
specDataBackupSpec |
|
||||||||||
statusOperationStatus |
(Appears on: DataBackup)
DataBackupSpec defines the desired state of DataBackup
| Field | Description |
|---|---|
datasetstring |
Dataset defines the target dataset of the DataBackup |
backupPathstring |
BackupPath defines the target path to save data of the DataBackup |
runAsUser |
Manage the user to run Alluxio DataBackup |
runAfterOperationRef |
(Optional)
Specifies that the preceding operation in a workflow |
ttlSecondsAfterFinishedint32 |
(Optional)
TTLSecondsAfterFinished is the time second to clean up data operations after finished or failed |
(Appears on: DataLoad)
DataLoadSpec defines the desired state of DataLoad
| Field | Description |
|---|---|
datasetTargetDataset |
Dataset defines the target dataset of the DataLoad |
loadMetadatabool |
LoadMetadata specifies if the dataload job should load metadata |
target[]TargetPath |
Target defines target paths that needs to be loaded |
optionsmap[string]string |
Options specifies the extra dataload properties for runtime |
podMetadataPodMetadata |
PodMetadata defines labels and annotations that will be propagated to DataLoad pods |
affinityKubernetes core/v1.Affinity |
(Optional)
Affinity defines affinity for DataLoad pod |
tolerations[]Kubernetes core/v1.Toleration |
(Optional)
Tolerations defines tolerations for DataLoad pod |
nodeSelectormap[string]string |
(Optional)
NodeSelector defiens node selector for DataLoad pod |
schedulerNamestring |
(Optional)
SchedulerName sets the scheduler to be used for DataLoad pod |
policyPolicy |
(Optional)
including Once, Cron, OnEvent |
schedulestring |
(Optional)
The schedule in Cron format, only set when policy is cron, see https://en.wikipedia.org/wiki/Cron. |
runAfterOperationRef |
(Optional)
Specifies that the preceding operation in a workflow |
ttlSecondsAfterFinishedint32 |
(Optional)
TTLSecondsAfterFinished is the time second to clean up data operations after finished or failed |
resourcesKubernetes core/v1.ResourceRequirements |
(Optional)
Resources that will be requested by the DataLoad job. |
(Appears on: DataMigrate)
DataMigrateSpec defines the desired state of DataMigrate
| Field | Description |
|---|---|
VersionSpecVersionSpec |
(Members of The version information that instructs fluid to orchestrate a particular version for data migrate. |
fromDataToMigrate |
data to migrate source, including dataset and external storage |
toDataToMigrate |
data to migrate destination, including dataset and external storage |
blockbool |
(Optional)
if dataMigrate blocked dataset usage, default is false |
runtimeTypestring |
(Optional)
using which runtime to migrate data; if none, take dataset runtime as default |
optionsmap[string]string |
(Optional)
options for migrate, different for each runtime |
policyPolicy |
(Optional)
policy for migrate, including Once, Cron, OnEvent |
schedulestring |
(Optional)
The schedule in Cron format, only set when policy is cron, see https://en.wikipedia.org/wiki/Cron. |
podMetadataPodMetadata |
PodMetadata defines labels and annotations that will be propagated to DataMigrate pods |
affinityKubernetes core/v1.Affinity |
(Optional)
Affinity defines affinity for DataMigrate pod |
tolerations[]Kubernetes core/v1.Toleration |
(Optional)
Tolerations defines tolerations for DataMigrate pod |
nodeSelectormap[string]string |
(Optional)
NodeSelector defiens node selector for DataMigrate pod |
schedulerNamestring |
(Optional)
SchedulerName sets the scheduler to be used for DataMigrate pod |
runAfterOperationRef |
(Optional)
Specifies that the preceding operation in a workflow |
ttlSecondsAfterFinishedint32 |
(Optional)
TTLSecondsAfterFinished is the time second to clean up data operations after finished or failed |
resourcesKubernetes core/v1.ResourceRequirements |
(Optional)
Resources that will be requested by the DataMigrate job. |
parallelismint32 |
(Optional)
Parallelism defines the parallelism tasks numbers for DataMigrate. If the value is greater than 1, the job acts as a launcher, and users should define the WorkerSpec. |
parallelOptionsmap[string]string |
(Optional)
ParallelOptions defines options like ssh port and ssh secret name when parallelism is greater than 1. |
(Appears on: DataProcess)
DataProcessSpec defines the desired state of DataProcess
| Field | Description |
|---|---|
datasetTargetDatasetWithMountPath |
Dataset specifies the target dataset and its mount path. |
processorProcessor |
Processor specify how to process data. |
runAfterOperationRef |
(Optional)
Specifies that the preceding operation in a workflow |
ttlSecondsAfterFinishedint32 |
(Optional)
TTLSecondsAfterFinished is the time second to clean up data operations after finished or failed |
(Appears on: DatasetSpec)
DataRestoreLocation describes the spec restore location of Dataset
| Field | Description |
|---|---|
pathstring |
(Optional)
Path describes the path of restore, in the form of local://subpath or pvc:///subpath |
nodeNamestring |
(Optional)
NodeName describes the nodeName of restore if Path is in the form of local://subpath |
(Appears on: DataMigrateSpec)
| Field | Description |
|---|---|
datasetDatasetToMigrate |
dataset to migrate |
externalStorageExternalStorage |
external storage for data migrate |
(Appears on: DatasetStatus)
Condition describes the state of the cache at a certain point.
| Field | Description |
|---|---|
typeDatasetConditionType |
Type of cache condition. |
statusKubernetes core/v1.ConditionStatus |
Status of the condition, one of True, False, Unknown. |
reasonstring |
The reason for the condition’s last transition. |
messagestring |
A human readable message indicating details about the transition. |
lastUpdateTimeKubernetes meta/v1.Time |
The last time this condition was updated. |
lastTransitionTimeKubernetes meta/v1.Time |
Last time the condition transitioned from one status to another. |
(Appears on: Dataset)
DatasetSpec defines the desired state of Dataset
| Field | Description |
|---|---|
mounts[]Mount |
(Optional)
Mount Points to be mounted on cache runtime. |
ownerUser |
(Optional)
The owner of the dataset |
nodeAffinityCacheableNodeAffinity |
(Optional)
NodeAffinity defines constraints that limit what nodes this dataset can be cached to. This field influences the scheduling of pods that use the cached dataset. |
tolerations[]Kubernetes core/v1.Toleration |
(Optional)
If specified, the pod’s tolerations. |
accessModes[]Kubernetes core/v1.PersistentVolumeAccessMode |
(Optional)
AccessModes contains all ways the volume backing the PVC can be mounted |
runtimes[]Runtime |
Runtimes for supporting dataset (e.g. AlluxioRuntime) |
placementPlacementMode |
(Optional)
Manage switch for opening Multiple datasets single node deployment or not TODO(xieydd) In future, evaluate node resources and runtime resources to decide whether to turn them on |
dataRestoreLocationDataRestoreLocation |
(Optional)
DataRestoreLocation is the location to load data of dataset been backuped |
sharedOptionsmap[string]string |
(Optional)
SharedOptions is the options to all mount |
sharedEncryptOptions[]EncryptOption |
(Optional)
SharedEncryptOptions is the encryptOption to all mount |
(Appears on: Dataset)
DatasetStatus defines the observed state of Dataset
| Field | Description |
|---|---|
mounts[]Mount |
the info of mount points have been mounted |
ufsTotalstring |
Total in GB of dataset in the cluster |
phaseDatasetPhase |
Dataset Phase. One of the four phases: |
runtimes[]Runtime |
Runtimes for supporting dataset |
conditions[]DatasetCondition |
Conditions is an array of current observed conditions. |
cacheStatescommon.CacheStateList |
CacheStatus represents the total resources of the dataset. |
hcfsHCFSStatus |
HCFSStatus represents hcfs info |
fileNumstring |
FileNum represents the file numbers of the dataset |
dataLoadRefstring |
DataLoadRef specifies the running DataLoad job that targets this Dataset. This is mainly used as a lock to prevent concurrent DataLoad jobs. Deprecated, use OperationRef instead |
dataBackupRefstring |
DataBackupRef specifies the running Backup job that targets this Dataset. This is mainly used as a lock to prevent concurrent DataBackup jobs. Deprecated, use OperationRef instead |
operationRefmap[string]string |
OperationRef specifies the Operation that targets this Dataset. This is mainly used as a lock to prevent concurrent same Operation jobs. |
datasetRef[]string |
DatasetRef specifies the datasets namespaced name mounting this Dataset. |
(Appears on: DataToMigrate)
| Field | Description |
|---|---|
namestring |
name of dataset |
namespacestring |
namespace of dataset |
pathstring |
path to migrate |
(Appears on: EFCRuntimeSpec)
EFCCompTemplateSpec is a description of the EFC components
| Field | Description |
|---|---|
replicasint32 |
(Optional)
Replicas is the desired number of replicas of the given template. If unspecified, defaults to 1. replicas is the min replicas of dataset in the cluster |
versionVersionSpec |
The version information that instructs fluid to orchestrate a particular version of EFC Comp |
propertiesmap[string]string |
(Optional)
Configurable properties for the EFC component. |
portsmap[string]int |
(Optional)
Ports used by EFC(e.g. rpc: 19998 for master). |
resourcesKubernetes core/v1.ResourceRequirements |
(Optional)
Resources that will be requested by the EFC component. |
disabledbool |
(Optional)
Enabled or Disabled for the components. Default enable. |
nodeSelectormap[string]string |
(Optional)
NodeSelector is a selector which must be true for the component to fit on a node. |
networkModeNetworkMode |
(Optional)
Whether to use host network or not. |
podMetadataPodMetadata |
(Optional)
PodMetadata defines labels and annotations that will be propagated to EFC’s master and worker pods |
(Appears on: EFCRuntimeSpec)
EFCFuseSpec is a description of the EFC Fuse
| Field | Description |
|---|---|
versionVersionSpec |
The version information that instructs fluid to orchestrate a particular version of EFC Fuse |
propertiesmap[string]string |
(Optional)
Configurable properties for EFC fuse |
resourcesKubernetes core/v1.ResourceRequirements |
(Optional)
Resources that will be requested by EFC Fuse. |
nodeSelectormap[string]string |
(Optional)
NodeSelector is a selector which must be true for the fuse client to fit on a node, this option only effect when global is enabled |
cleanPolicyFuseCleanPolicy |
(Optional)
CleanPolicy decides when to clean EFC Fuse pods. Currently Fluid supports two policies: OnDemand and OnRuntimeDeleted OnDemand cleans fuse pod once th fuse pod on some node is not needed OnRuntimeDeleted cleans fuse pod only when the cache runtime is deleted Defaults to OnRuntimeDeleted |
networkModeNetworkMode |
(Optional)
Whether to use hostnetwork or not |
podMetadataPodMetadata |
(Optional)
PodMetadata defines labels and annotations that will be propagated to EFC’s fuse pods |
(Appears on: EFCRuntime)
EFCRuntimeSpec defines the desired state of EFCRuntime
| Field | Description |
|---|---|
masterEFCCompTemplateSpec |
The component spec of EFC master |
workerEFCCompTemplateSpec |
The component spec of EFC worker |
initFuseInitFuseSpec |
The spec of init alifuse |
fuseEFCFuseSpec |
The component spec of EFC Fuse |
tieredstoreTieredStore |
Tiered storage used by EFC worker |
replicasint32 |
The replicas of the worker, need to be specified |
osAdviseOSAdvise |
Operating system optimization for EFC |
cleanCachePolicyCleanCachePolicy |
(Optional)
CleanCachePolicy defines cleanCache Policy |
podMetadataPodMetadata |
(Optional)
PodMetadata defines labels and annotations that will be propagated to all EFC’s pods |
(Appears on: DatasetSpec, ExternalEndpointSpec, ExternalStorage, Mount)
| Field | Description |
|---|---|
namestring |
The name of encryptOption |
valueFromEncryptOptionSource |
(Optional)
The valueFrom of encryptOption |
(Appears on: EncryptOption)
| Field | Description |
|---|---|
secretKeyRefSecretKeySelector |
(Optional)
The encryptInfo obtained from secret |
(Appears on: MasterSpec)
ExternalEndpointSpec defines the configurations for external etcd cluster
| Field | Description |
|---|---|
uristring |
(Optional)
URI specifies the endpoint of external Etcd cluster E,g. “etcd-svc.etcd-namespace.svc.cluster.local:2379” Default is not set and use http protocol to connect to external etcd cluster |
encryptOptions[]EncryptOption |
(Optional)
encrypt info for accessing the external etcd cluster |
optionsmap[string]string |
(Optional)
Configurable options for External Etcd cluster. |
(Appears on: DataToMigrate)
| Field | Description |
|---|---|
uristring |
type of external storage, including s3, oss, gcs, ceph, nfs, pvc, etc. (related to runtime) |
encryptOptions[]EncryptOption |
(Optional)
encrypt info for external storage |
(Appears on: AlluxioFuseSpec, EFCFuseSpec, GooseFSFuseSpec, JindoFuseSpec, JuiceFSFuseSpec, ThinFuseSpec, VineyardClientSocketSpec)
(Appears on: GooseFSRuntimeSpec)
GooseFSCompTemplateSpec is a description of the GooseFS commponents
| Field | Description |
|---|---|
replicasint32 |
(Optional)
Replicas is the desired number of replicas of the given template. If unspecified, defaults to 1. replicas is the min replicas of dataset in the cluster |
jvmOptions[]string |
Options for JVM |
propertiesmap[string]string |
(Optional)
Configurable properties for the GOOSEFS component. |
portsmap[string]int |
(Optional)
Ports used by GooseFS(e.g. rpc: 19998 for master) |
resourcesKubernetes core/v1.ResourceRequirements |
(Optional)
Resources that will be requested by the GooseFS component. |
envmap[string]string |
Environment variables that will be used by GooseFS component. |
enabledbool |
(Optional)
Enabled or Disabled for the components. For now, only API Gateway is enabled or disabled. |
nodeSelectormap[string]string |
(Optional)
NodeSelector is a selector which must be true for the master to fit on a node |
annotationsmap[string]string |
(Optional)
Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations |
(Appears on: GooseFSRuntimeSpec)
GooseFSFuseSpec is a description of the GooseFS Fuse
| Field | Description |
|---|---|
imagestring |
Image for GooseFS Fuse(e.g. goosefs/goosefs-fuse) |
imageTagstring |
Image Tag for GooseFS Fuse(e.g. v1.0.1) |
imagePullPolicystring |
One of the three policies: |
jvmOptions[]string |
Options for JVM |
propertiesmap[string]string |
Configurable properties for the GOOSEFS component. |
envmap[string]string |
Environment variables that will be used by GooseFS Fuse |
resourcesKubernetes core/v1.ResourceRequirements |
(Optional)
Resources that will be requested by GooseFS Fuse. |
args[]string |
Arguments that will be passed to GooseFS Fuse |
nodeSelectormap[string]string |
(Optional)
NodeSelector is a selector which must be true for the fuse client to fit on a node, this option only effect when global is enabled |
cleanPolicyFuseCleanPolicy |
(Optional)
CleanPolicy decides when to clean GooseFS Fuse pods. Currently Fluid supports two policies: OnDemand and OnRuntimeDeleted OnDemand cleans fuse pod once th fuse pod on some node is not needed OnRuntimeDeleted cleans fuse pod only when the cache runtime is deleted Defaults to OnRuntimeDeleted |
annotationsmap[string]string |
(Optional)
Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations |
(Appears on: GooseFSRuntime)
GooseFSRuntimeSpec defines the desired state of GooseFSRuntime
| Field | Description |
|---|---|
goosefsVersionVersionSpec |
The version information that instructs fluid to orchestrate a particular version of GooseFS. |
masterGooseFSCompTemplateSpec |
The component spec of GooseFS master |
jobMasterGooseFSCompTemplateSpec |
The component spec of GooseFS job master |
workerGooseFSCompTemplateSpec |
The component spec of GooseFS worker |
jobWorkerGooseFSCompTemplateSpec |
The component spec of GooseFS job Worker |
apiGatewayGooseFSCompTemplateSpec |
The component spec of GooseFS API Gateway |
initUsersInitUsersSpec |
The spec of init users |
fuseGooseFSFuseSpec |
The component spec of GooseFS Fuse |
propertiesmap[string]string |
Configurable properties for the GOOSEFS component. |
jvmOptions[]string |
Options for JVM |
tieredstoreTieredStore |
Tiered storage used by GooseFS |
dataData |
Management strategies for the dataset to which the runtime is bound |
replicasint32 |
The replicas of the worker, need to be specified |
runAsUser |
Manage the user to run GooseFS Runtime GooseFS support POSIX-ACL and Apache Ranger to manager authorization TODO(chrisydxie@tencent.com) Support Apache Ranger. |
disablePrometheusbool |
(Optional)
Disable monitoring for GooseFS Runtime Prometheus is enabled by default |
hadoopConfigstring |
(Optional)
Name of the configMap used to support HDFS configurations when using HDFS as GooseFS’s UFS. The configMap must be in the same namespace with the GooseFSRuntime. The configMap should contain user-specific HDFS conf files in it. For now, only “hdfs-site.xml” and “core-site.xml” are supported. It must take the filename of the conf file as the key and content of the file as the value. |
cleanCachePolicyCleanCachePolicy |
(Optional)
CleanCachePolicy defines cleanCache Policy |
(Appears on: DatasetStatus)
HCFS Endpoint info
| Field | Description |
|---|---|
endpointstring |
Endpoint for accessing |
underlayerFileSystemVersionstring |
Underlayer HCFS Compatible Version |
(Appears on: EFCRuntimeSpec)
InitFuseSpec is a description of initialize the fuse kernel module for runtime
| Field | Description |
|---|---|
versionVersionSpec |
The version information that instructs fluid to orchestrate a particular version of Alifuse |
(Appears on: AlluxioRuntimeSpec, GooseFSRuntimeSpec, JuiceFSRuntimeSpec)
InitUsersSpec is a description of the initialize the users for runtime
| Field | Description |
|---|---|
imagestring |
Image for initialize the users for runtime(e.g. alluxio/alluxio-User init) |
imageTagstring |
Image Tag for initialize the users for runtime(e.g. 2.3.0-SNAPSHOT) |
imagePullPolicystring |
One of the three policies: |
envmap[string]string |
Environment variables that will be used by initialize the users for runtime |
resourcesKubernetes core/v1.ResourceRequirements |
(Optional)
Resources that will be requested by initialize the users for runtime. |
(Appears on: JindoRuntimeSpec)
JindoCompTemplateSpec is a description of the Jindo commponents
| Field | Description |
|---|---|
replicasint32 |
(Optional)
Replicas is the desired number of replicas of the given template. If unspecified, defaults to 1. replicas is the min replicas of dataset in the cluster |
propertiesmap[string]string |
(Optional)
Configurable properties for the Jindo component. |
portsmap[string]int |
(Optional) |
resourcesKubernetes core/v1.ResourceRequirements |
(Optional)
Resources that will be requested by the Jindo component. |
envmap[string]string |
Environment variables that will be used by Jindo component. |
nodeSelectormap[string]string |
(Optional)
NodeSelector is a selector which must be true for the master to fit on a node |
tolerations[]Kubernetes core/v1.Toleration |
(Optional)
If specified, the pod’s tolerations. |
labelsmap[string]string |
(Optional)
Labels will be added on JindoFS Master or Worker pods. DEPRECATED: This is a deprecated field. Please use PodMetadata instead. Note: this field is set to be exclusive with PodMetadata.Labels |
podMetadataPodMetadata |
(Optional)
PodMetadata defines labels and annotations that will be propagated to Jindo’s pods |
disabledbool |
(Optional)
If disable JindoFS master or worker |
volumeMounts[]Kubernetes core/v1.VolumeMount |
(Optional)
VolumeMounts specifies the volumes listed in “.spec.volumes” to mount into the jindo runtime component’s filesystem. |
imagePullSecrets[]Kubernetes core/v1.LocalObjectReference |
ImagePullSecrets that will be used to pull images |
(Appears on: JindoRuntimeSpec)
JindoFuseSpec is a description of the Jindo Fuse
| Field | Description |
|---|---|
imagestring |
Image for Jindo Fuse(e.g. jindo/jindo-fuse) |
imageTagstring |
Image Tag for Jindo Fuse(e.g. 2.3.0-SNAPSHOT) |
imagePullPolicystring |
One of the three policies: |
imagePullSecrets[]Kubernetes core/v1.LocalObjectReference |
ImagePullSecrets that will be used to pull images |
propertiesmap[string]string |
Configurable properties for Jindo System. |
envmap[string]string |
Environment variables that will be used by Jindo Fuse |
resourcesKubernetes core/v1.ResourceRequirements |
(Optional)
Resources that will be requested by Jindo Fuse. |
args[]string |
Arguments that will be passed to Jindo Fuse |
nodeSelectormap[string]string |
(Optional)
NodeSelector is a selector which must be true for the fuse client to fit on a node, this option only effect when global is enabled |
tolerations[]Kubernetes core/v1.Toleration |
(Optional)
If specified, the pod’s tolerations. |
labelsmap[string]string |
(Optional)
Labels will be added on all the JindoFS pods. DEPRECATED: this is a deprecated field. Please use PodMetadata.Labels instead. Note: this field is set to be exclusive with PodMetadata.Labels |
podMetadataPodMetadata |
(Optional)
PodMetadata defines labels and annotations that will be propagated to Jindo’s fuse pods |
cleanPolicyFuseCleanPolicy |
(Optional)
CleanPolicy decides when to clean JindoFS Fuse pods. Currently Fluid supports two policies: OnDemand and OnRuntimeDeleted OnDemand cleans fuse pod once th fuse pod on some node is not needed OnRuntimeDeleted cleans fuse pod only when the cache runtime is deleted Defaults to OnRuntimeDeleted |
disabledbool |
(Optional)
If disable JindoFS fuse |
logConfigmap[string]string |
(Optional) |
metricsClientMetrics |
(Optional)
Define whether fuse metrics will be enabled. |
(Appears on: JindoRuntime)
JindoRuntimeSpec defines the desired state of JindoRuntime
| Field | Description |
|---|---|
jindoVersionVersionSpec |
The version information that instructs fluid to orchestrate a particular version of Jindo. |
masterJindoCompTemplateSpec |
The component spec of Jindo master |
workerJindoCompTemplateSpec |
The component spec of Jindo worker |
fuseJindoFuseSpec |
The component spec of Jindo Fuse |
propertiesmap[string]string |
Configurable properties for Jindo system. |
tieredstoreTieredStore |
Tiered storage used by Jindo |
replicasint32 |
The replicas of the worker, need to be specified |
runAsUser |
Manage the user to run Jindo Runtime |
userstring |
|
hadoopConfigstring |
(Optional)
Name of the configMap used to support HDFS configurations when using HDFS as Jindo’s UFS. The configMap must be in the same namespace with the JindoRuntime. The configMap should contain user-specific HDFS conf files in it. For now, only “hdfs-site.xml” and “core-site.xml” are supported. It must take the filename of the conf file as the key and content of the file as the value. |
secretstring |
|
labelsmap[string]string |
(Optional)
Labels will be added on all the JindoFS pods. DEPRECATED: this is a deprecated field. Please use PodMetadata.Labels instead. Note: this field is set to be exclusive with PodMetadata.Labels |
podMetadataPodMetadata |
(Optional)
PodMetadata defines labels and annotations that will be propagated to all Jindo’s fuse pods |
logConfigmap[string]string |
(Optional) |
networkmodeNetworkMode |
(Optional)
Whether to use hostnetwork or not |
cleanCachePolicyCleanCachePolicy |
(Optional)
CleanCachePolicy defines cleanCache Policy |
volumes[]Kubernetes core/v1.Volume |
(Optional)
Volumes is the list of Kubernetes volumes that can be mounted by the jindo runtime components and/or fuses. |
imagePullSecrets[]Kubernetes core/v1.LocalObjectReference |
(Optional)
ImagePullSecrets that will be used to pull images |
(Appears on: Processor)
| Field | Description |
|---|---|
podSpecKubernetes core/v1.PodSpec |
(Optional)
PodSpec defines Pod specification of the DataProcess job. |
(Appears on: JuiceFSRuntimeSpec)
JuiceFSCompTemplateSpec is a description of the JuiceFS components
| Field | Description |
|---|---|
replicasint32 |
(Optional)
Replicas is the desired number of replicas of the given template. If unspecified, defaults to 1. replicas is the min replicas of dataset in the cluster |
ports[]Kubernetes core/v1.ContainerPort |
(Optional)
Ports used by JuiceFS |
resourcesKubernetes core/v1.ResourceRequirements |
(Optional)
Resources that will be requested by the JuiceFS component. |
optionsmap[string]string |
Options |
env[]Kubernetes core/v1.EnvVar |
Environment variables that will be used by JuiceFS component. |
enabledbool |
(Optional)
Enabled or Disabled for the components. |
nodeSelectormap[string]string |
(Optional)
NodeSelector is a selector |
volumeMounts[]Kubernetes core/v1.VolumeMount |
(Optional)
VolumeMounts specifies the volumes listed in “.spec.volumes” to mount into runtime component’s filesystem. |
podMetadataPodMetadata |
(Optional)
PodMetadata defines labels and annotations that will be propagated to JuiceFs’s pods. |
networkModeNetworkMode |
(Optional)
Whether to use hostnetwork or not |
(Appears on: JuiceFSRuntimeSpec)
| Field | Description |
|---|---|
imagestring |
Image for JuiceFS fuse |
imageTagstring |
Image for JuiceFS fuse |
imagePullPolicystring |
One of the three policies: |
env[]Kubernetes core/v1.EnvVar |
Environment variables that will be used by JuiceFS Fuse |
resourcesKubernetes core/v1.ResourceRequirements |
Resources that will be requested by JuiceFS Fuse. |
optionsmap[string]string |
(Optional)
Options mount options that fuse pod will use |
nodeSelectormap[string]string |
(Optional)
NodeSelector is a selector which must be true for the fuse client to fit on a node, this option only effect when global is enabled |
volumeMounts[]Kubernetes core/v1.VolumeMount |
(Optional)
VolumeMounts specifies the volumes listed in “.spec.volumes” to mount into runtime component’s filesystem. |
cleanPolicyFuseCleanPolicy |
(Optional)
CleanPolicy decides when to clean Juicefs Fuse pods. Currently Fluid supports three policies: OnDemand, OnRuntimeDeleted and OnFuseChangedCleanPolicy OnDemand cleans fuse pod once the fuse pod on some node is not needed OnRuntimeDeleted cleans fuse pod only when the cache runtime is deleted OnFuseChangedCleanPolicy cleans fuse pod once the fuse pod on some node is not needed and the fuse in runtime is updated Defaults to OnRuntimeDeleted |
podMetadataPodMetadata |
(Optional)
PodMetadata defines labels and annotations that will be propagated to JuiceFs’s pods. |
networkModeNetworkMode |
(Optional)
Whether to use hostnetwork or not |
(Appears on: JuiceFSRuntime)
JuiceFSRuntimeSpec defines the desired state of JuiceFSRuntime
| Field | Description |
|---|---|
juicefsVersionVersionSpec |
The version information that instructs fluid to orchestrate a particular version of JuiceFS. |
initUsersInitUsersSpec |
The spec of init users |
masterJuiceFSCompTemplateSpec |
The component spec of JuiceFS master |
workerJuiceFSCompTemplateSpec |
The component spec of JuiceFS worker |
jobWorkerJuiceFSCompTemplateSpec |
The component spec of JuiceFS job Worker |
fuseJuiceFSFuseSpec |
Desired state for JuiceFS Fuse |
tieredstoreTieredStore |
Tiered storage used by JuiceFS |
configs[]string |
Configs of JuiceFS |
replicasint32 |
The replicas of the worker, need to be specified |
runAsUser |
Manage the user to run Juicefs Runtime |
disablePrometheusbool |
(Optional)
Disable monitoring for JuiceFS Runtime Prometheus is enabled by default |
volumes[]Kubernetes core/v1.Volume |
(Optional)
Volumes is the list of Kubernetes volumes that can be mounted by the alluxio runtime components and/or fuses. |
podMetadataPodMetadata |
(Optional)
PodMetadata defines labels and annotations that will be propagated to JuiceFs’s pods. |
managementRuntimeManagement |
(Optional)
RuntimeManagement defines policies when managing the runtime |
(Appears on: TieredStore)
Level describes configurations a tier needs.
Refer to Configuring Tiered Storage for more info
| Field | Description |
|---|---|
mediumtypecommon.MediumType |
Medium Type of the tier. One of the three types: |
volumeTypecommon.VolumeType |
(Optional)
VolumeType is the volume type of the tier. Should be one of the three types: |
volumeSourceVolumeSource |
VolumeSource is the volume source of the tier. It follows the form of corev1.VolumeSource. For now, users should only specify VolumeSource when VolumeType is set to emptyDir. |
pathstring |
(Optional)
File paths to be used for the tier. Multiple paths are supported. Multiple paths should be separated with comma. For example: “/mnt/cache1,/mnt/cache2”. |
quotaKubernetes resource.Quantity |
(Optional)
Quota for the whole tier. (e.g. 100Gi) Please note that if there’re multiple paths used for this tierstore, the quota will be equally divided into these paths. If you’d like to set quota for each, path, see QuotaList for more information. |
quotaListstring |
(Optional)
QuotaList are quotas used to set quota on multiple paths. Quotas should be separated with comma. Quotas in this list will be set to paths with the same order in Path. For example, with Path defined with “/mnt/cache1,/mnt/cache2” and QuotaList set to “100Gi, 50Gi”, then we get 100GiB cache storage under “/mnt/cache1” and 50GiB under “/mnt/cache2”. Also note that num of quotas must be consistent with the num of paths defined in Path. |
highstring |
Ratio of high watermark of the tier (e.g. 0.9) |
lowstring |
Ratio of low watermark of the tier (e.g. 0.7) |
(Appears on: VineyardRuntimeSpec)
MasterSpec defines the configurations for Vineyard Master component which is also regarded as the Etcd component in Vineyard. For more info about Vineyard, refer to Vineyard
| Field | Description |
|---|---|
VineyardCompTemplateSpecVineyardCompTemplateSpec |
(Members of The component configurations for Vineyard Master |
endpointExternalEndpointSpec |
(Optional)
ExternalEndpoint defines the configurations for external etcd cluster Default is not set If set, the Vineyard Master component will not be deployed, which means the Vineyard Worker component will use an external Etcd cluster. E,g. endpoint: uri: “etcd-svc.etcd-namespace.svc.cluster.local:2379” encryptOptions: - name: access-key valueFrom: secretKeyRef: name: etcd-secret key: accesskey |
Metadata defines subgroup properties of metav1.ObjectMeta
| Field | Description |
|---|---|
PodMetadataPodMetadata |
(Members of |
selectorKubernetes meta/v1.GroupKind |
(Appears on: RuntimeManagement)
MetadataSyncPolicy defines policies when syncing metadata
| Field | Description |
|---|---|
autoSyncbool |
(Optional)
AutoSync enables automatic metadata sync when setting up a runtime. If not set, it defaults to true. |
(Appears on: DatasetSpec, DatasetStatus, RuntimeStatus)
Mount describes a mounting.
Refer to Alluxio Storage Integrations for more info
| Field | Description |
|---|---|
mountPointstring |
MountPoint is the mount point of source. |
optionsmap[string]string |
(Optional)
The Mount Options. |
namestring |
(Optional)
The name of mount |
pathstring |
(Optional)
The path of mount, if not set will be /{Name} |
readOnlybool |
(Optional)
Optional: Defaults to false (read-write). |
sharedbool |
(Optional)
Optional: Defaults to false (shared). |
encryptOptions[]EncryptOption |
(Optional)
The secret information |
(Appears on: AlluxioCompTemplateSpec, AlluxioFuseSpec, EFCCompTemplateSpec, EFCFuseSpec, JindoRuntimeSpec, JuiceFSCompTemplateSpec, JuiceFSFuseSpec, ThinCompTemplateSpec, ThinFuseSpec, VineyardClientSocketSpec, VineyardCompTemplateSpec)
(Appears on: ThinRuntimeProfileSpec)
(Appears on: EFCRuntimeSpec)
OSAdvise is a description of choices to have optimization on specific operating system
| Field | Description |
|---|---|
osVersionstring |
(Optional)
Specific operating system version that can have optimization. |
enabledbool |
(Optional)
Enable operating system optimization not enabled by default. |
(Appears on: AffinityStrategy, OperationRef)
| Field | Description |
|---|---|
apiVersionstring |
(Optional)
API version of the referent operation |
kindstring |
Kind specifies the type of the referent operation |
namestring |
Name specifies the name of the referent operation |
namespacestring |
(Optional)
Namespace specifies the namespace of the referent operation. |
(Appears on: DataBackupSpec, DataLoadSpec, DataMigrateSpec, DataProcessSpec)
| Field | Description |
|---|---|
ObjectRefObjectRef |
(Members of |
affinityStrategyAffinityStrategy |
(Optional)
AffinityStrategy specifies the pod affinity strategy with the referent operation. |
(Appears on: DataLoad, DataMigrate, DataProcess, DataBackup)
OperationStatus defines the observed state of operation
| Field | Description |
|---|---|
phasecommon.Phase |
Phase describes current phase of operation |
durationstring |
Duration tell user how much time was spent to operation |
conditions[]Condition |
Conditions consists of transition information on operation’s Phase |
infosmap[string]string |
Infos operation customized name-value |
lastScheduleTimeKubernetes meta/v1.Time |
LastScheduleTime is the last time the cron operation was scheduled |
lastSuccessfulTimeKubernetes meta/v1.Time |
LastSuccessfulTime is the last time the cron operation successfully completed |
waitingForWaitingStatus |
WaitingStatus stores information about waiting operation. |
nodeAffinityKubernetes core/v1.NodeAffinity |
NodeAffinity records the node affinity for operation pods |
(Appears on: DatasetSpec)
(Appears on: AlluxioCompTemplateSpec, AlluxioFuseSpec, AlluxioRuntimeSpec, DataLoadSpec, DataMigrateSpec, EFCCompTemplateSpec, EFCFuseSpec, EFCRuntimeSpec, JindoCompTemplateSpec, JindoFuseSpec, JindoRuntimeSpec, JuiceFSCompTemplateSpec, JuiceFSFuseSpec, JuiceFSRuntimeSpec, Metadata, Processor, ThinFuseSpec, VineyardClientSocketSpec, VineyardCompTemplateSpec, VineyardRuntimeSpec)
PodMetadata defines subgroup properties of metav1.ObjectMeta
| Field | Description |
|---|---|
labelsmap[string]string |
Labels are labels of pod specification |
annotationsmap[string]string |
Annotations are annotations of pod specification |
(Appears on: DataLoadSpec, DataMigrateSpec)
(Appears on: AffinityStrategy)
Prefer defines the label key and weight for generating a PreferredSchedulingTerm.
| Field | Description |
|---|---|
namestring |
|
weightint32 |
(Appears on: DataProcessSpec)
Processor defines the actual processor for DataProcess. Processor can be either of a Job or a Shell script.
| Field | Description |
|---|---|
serviceAccountNamestring |
(Optional)
ServiceAccountName defiens the serviceAccountName of the container |
podMetadataPodMetadata |
(Optional)
PodMetadata defines labels and annotations on the processor pod. |
jobJobProcessor |
(Optional)
Job represents a processor which runs DataProcess as a job. |
scriptScriptProcessor |
Shell represents a processor which executes shell script |
(Appears on: AffinityStrategy)
Require defines the label key for generating a NodeSelectorTerm.
| Field | Description |
|---|---|
namestring |
(Appears on: DatasetSpec, DatasetStatus)
Runtime describes a runtime to be used to support dataset
| Field | Description |
|---|---|
namestring |
Name of the runtime object |
namespacestring |
Namespace of the runtime object |
categorycommon.Category |
Category the runtime object belongs to (e.g. Accelerate) |
typestring |
Runtime object’s type (e.g. Alluxio) |
masterReplicasint32 |
Runtime master replicas |
(Appears on: RuntimeStatus)
Condition describes the state of the cache at a certain point.
| Field | Description |
|---|---|
typeRuntimeConditionType |
Type of cache condition. |
statusKubernetes core/v1.ConditionStatus |
Status of the condition, one of True, False, Unknown. |
reasonstring |
The reason for the condition’s last transition. |
messagestring |
A human readable message indicating details about the transition. |
lastProbeTimeKubernetes meta/v1.Time |
The last time this condition was updated. |
lastTransitionTimeKubernetes meta/v1.Time |
Last time the condition transitioned from one status to another. |
(Appears on: AlluxioRuntimeSpec, JuiceFSRuntimeSpec, ThinRuntimeSpec)
RuntimeManagement defines suggestions for runtime controllers to manage the runtime
| Field | Description |
|---|---|
cleanCachePolicyCleanCachePolicy |
(Optional)
CleanCachePolicy defines the policy of cleaning cache when shutting down the runtime |
metadataSyncPolicyMetadataSyncPolicy |
(Optional)
MetadataSyncPolicy defines the policy of syncing metadata when setting up the runtime. If not set, |
(Appears on: AlluxioRuntime, EFCRuntime, GooseFSRuntime, JindoRuntime, JuiceFSRuntime, ThinRuntime, VineyardRuntime)
RuntimeStatus defines the observed state of Runtime
| Field | Description |
|---|---|
valueFilestring |
config map used to set configurations |
masterPhaseRuntimePhase |
MasterPhase is the master running phase |
masterReasonstring |
Reason for Master’s condition transition |
workerPhaseRuntimePhase |
WorkerPhase is the worker running phase |
workerReasonstring |
Reason for Worker’s condition transition |
desiredWorkerNumberScheduledint32 |
The total number of nodes that should be running the runtime worker pod (including nodes correctly running the runtime worker pod). |
currentWorkerNumberScheduledint32 |
The total number of nodes that can be running the runtime worker pod (including nodes correctly running the runtime worker pod). |
workerNumberReadyint32 |
The number of nodes that should be running the runtime worker pod and have one or more of the runtime worker pod running and ready. |
workerNumberAvailableint32 |
(Optional)
The number of nodes that should be running the runtime worker pod and have one or more of the runtime worker pod running and available (ready for at least spec.minReadySeconds) |
workerNumberUnavailableint32 |
(Optional)
The number of nodes that should be running the runtime worker pod and have none of the runtime worker pod running and available (ready for at least spec.minReadySeconds) |
desiredMasterNumberScheduledint32 |
The total number of nodes that should be running the runtime pod (including nodes correctly running the runtime master pod). |
currentMasterNumberScheduledint32 |
The total number of nodes that should be running the runtime pod (including nodes correctly running the runtime master pod). |
masterNumberReadyint32 |
The number of nodes that should be running the runtime worker pod and have zero or more of the runtime master pod running and ready. |
fusePhaseRuntimePhase |
FusePhase is the Fuse running phase |
fuseReasonstring |
Reason for the condition’s last transition. |
currentFuseNumberScheduledint32 |
The total number of nodes that can be running the runtime Fuse pod (including nodes correctly running the runtime Fuse pod). |
desiredFuseNumberScheduledint32 |
The total number of nodes that should be running the runtime Fuse pod (including nodes correctly running the runtime Fuse pod). |
fuseNumberReadyint32 |
The number of nodes that should be running the runtime Fuse pod and have one or more of the runtime Fuse pod running and ready. |
fuseNumberUnavailableint32 |
(Optional)
The number of nodes that should be running the runtime fuse pod and have none of the runtime fuse pod running and available (ready for at least spec.minReadySeconds) |
fuseNumberAvailableint32 |
(Optional)
The number of nodes that should be running the runtime Fuse pod and have one or more of the runtime Fuse pod running and available (ready for at least spec.minReadySeconds) |
setupDurationstring |
Duration tell user how much time was spent to setup the runtime |
conditions[]RuntimeCondition |
Represents the latest available observations of a ddc runtime’s current state. |
cacheStatescommon.CacheStateList |
CacheStatus represents the total resources of the dataset. |
selectorstring |
Selector is used for auto-scaling |
apiGatewayAPIGatewayStatus |
APIGatewayStatus represents rest api gateway status |
mountTimeKubernetes meta/v1.Time |
MountTime represents time last mount happened if Mounttime is earlier than master starting time, remount will be required |
mounts[]Mount |
MountPoints represents the mount points specified in the bounded dataset |
cacheAffinityKubernetes core/v1.NodeAffinity |
CacheAffinity represents the runtime worker pods node affinity including node selector |
(Appears on: Processor)
| Field | Description |
|---|---|
VersionSpecVersionSpec |
(Members of VersionSpec specifies the container’s image info. |
restartPolicyKubernetes core/v1.RestartPolicy |
(Optional)
RestartPolicy specifies the processor job’s restart policy. Only “Never”, “OnFailure” is allowed. |
command[]string |
(Optional)
Entrypoint command for ScriptProcessor. |
sourcestring |
Script source for ScriptProcessor |
env[]Kubernetes core/v1.EnvVar |
(Optional)
List of environment variables to set in the container. |
volumeMounts[]Kubernetes core/v1.VolumeMount |
(Optional)
Pod volumes to mount into the container’s filesystem. |
volumes[]Kubernetes core/v1.Volume |
(Optional)
List of volumes that can be mounted by containers belonging to the pod. |
resourcesKubernetes core/v1.ResourceRequirements |
(Optional)
Resources that will be requested by the DataProcess job. |
(Appears on: EncryptOptionSource)
| Field | Description |
|---|---|
namestring |
The name of required secret |
keystring |
(Optional)
The required key in the secret |
(Appears on: DataLoadSpec, TargetDatasetWithMountPath)
TargetDataset defines the target dataset of the DataLoad
| Field | Description |
|---|---|
namestring |
Name defines name of the target dataset |
namespacestring |
Namespace defines namespace of the target dataset |
(Appears on: DataProcessSpec)
TargetDataset defines which dataset will be processed by DataProcess. Under the hood, the dataset’s pvc will be mounted to the given mountPath of the DataProcess’s containers.
| Field | Description |
|---|---|
TargetDatasetTargetDataset |
(Members of |
mountPathstring |
MountPath defines where the Dataset should be mounted in DataProcess’s containers. |
subPathstring |
(Optional)
SubPath defines subpath of the target dataset to mount. |
(Appears on: DataLoadSpec)
TargetPath defines the target path of the DataLoad
| Field | Description |
|---|---|
pathstring |
Path defines path to be load |
replicasint32 |
Replicas defines how many replicas will be loaded |
(Appears on: ThinRuntimeProfileSpec, ThinRuntimeSpec)
ThinCompTemplateSpec is a description of the thinRuntime components
| Field | Description |
|---|---|
imagestring |
Image for thinRuntime fuse |
imageTagstring |
Image for thinRuntime fuse |
imagePullPolicystring |
One of the three policies: |
imagePullSecrets[]Kubernetes core/v1.LocalObjectReference |
(Optional)
ImagePullSecrets that will be used to pull images |
replicasint32 |
(Optional)
Replicas is the desired number of replicas of the given template. If unspecified, defaults to 1. replicas is the min replicas of dataset in the cluster |
ports[]Kubernetes core/v1.ContainerPort |
(Optional)
Ports used thinRuntime |
resourcesKubernetes core/v1.ResourceRequirements |
(Optional)
Resources that will be requested by thinRuntime component. |
env[]Kubernetes core/v1.EnvVar |
Environment variables that will be used by thinRuntime component. |
enabledbool |
(Optional)
Enabled or Disabled for the components. |
nodeSelectormap[string]string |
(Optional)
NodeSelector is a selector |
volumeMounts[]Kubernetes core/v1.VolumeMount |
(Optional)
VolumeMounts specifies the volumes listed in “.spec.volumes” to mount into runtime component’s filesystem. |
livenessProbeKubernetes core/v1.Probe |
(Optional)
livenessProbe of thin fuse pod |
readinessProbeKubernetes core/v1.Probe |
(Optional)
readinessProbe of thin fuse pod |
networkModeNetworkMode |
(Optional)
Whether to use hostnetwork or not |
(Appears on: ThinRuntimeProfileSpec, ThinRuntimeSpec)
| Field | Description |
|---|---|
imagestring |
Image for thinRuntime fuse |
imageTagstring |
Image for thinRuntime fuse |
imagePullPolicystring |
One of the three policies: |
imagePullSecrets[]Kubernetes core/v1.LocalObjectReference |
(Optional)
ImagePullSecrets that will be used to pull images |
ports[]Kubernetes core/v1.ContainerPort |
(Optional)
Ports used thinRuntime |
env[]Kubernetes core/v1.EnvVar |
Environment variables that will be used by thinRuntime Fuse |
command[]string |
Command that will be passed to thinRuntime Fuse |
args[]string |
Arguments that will be passed to thinRuntime Fuse |
optionsmap[string]string |
Options configurable options of FUSE client, performance parameters usually. will be merged with Dataset.spec.mounts.options into fuse pod. |
resourcesKubernetes core/v1.ResourceRequirements |
Resources that will be requested by thinRuntime Fuse. |
nodeSelectormap[string]string |
(Optional)
NodeSelector is a selector which must be true for the fuse client to fit on a node, this option only effect when global is enabled |
cleanPolicyFuseCleanPolicy |
(Optional)
CleanPolicy decides when to clean thinRuntime Fuse pods. Currently Fluid supports two policies: OnDemand and OnRuntimeDeleted OnDemand cleans fuse pod once the fuse pod on some node is not needed OnRuntimeDeleted cleans fuse pod only when the cache runtime is deleted Defaults to OnDemand |
networkModeNetworkMode |
(Optional)
Whether to use hostnetwork or not |
livenessProbeKubernetes core/v1.Probe |
(Optional)
livenessProbe of thin fuse pod |
readinessProbeKubernetes core/v1.Probe |
(Optional)
readinessProbe of thin fuse pod |
volumeMounts[]Kubernetes core/v1.VolumeMount |
(Optional)
VolumeMounts specifies the volumes listed in “.spec.volumes” to mount into the thinruntime component’s filesystem. |
lifecycleKubernetes core/v1.Lifecycle |
Lifecycle describes actions that the management system should take in response to container lifecycle events. |
podMetadataPodMetadata |
(Optional)
PodMetadata defines labels and annotations that will be propagated to ThinRuntime’s FUSE pods. |
ThinRuntimeProfile is the Schema for the ThinRuntimeProfiles API
| Field | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
metadataKubernetes meta/v1.ObjectMeta |
Refer to the Kubernetes API documentation for the fields of the
metadata field.
|
||||||||||||
specThinRuntimeProfileSpec |
|
||||||||||||
statusThinRuntimeProfileStatus |
(Appears on: ThinRuntimeProfile)
ThinRuntimeProfileSpec defines the desired state of ThinRuntimeProfile
| Field | Description |
|---|---|
fileSystemTypestring |
file system of thinRuntime |
imagePullSecrets[]Kubernetes core/v1.LocalObjectReference |
(Optional)
ImagePullSecrets that will be used to pull images |
workerThinCompTemplateSpec |
The component spec of worker |
fuseThinFuseSpec |
The component spec of thinRuntime |
volumes[]Kubernetes core/v1.Volume |
(Optional)
Volumes is the list of Kubernetes volumes that can be mounted by runtime components and/or fuses. |
nodePublishSecretPolicyNodePublishSecretPolicy |
NodePublishSecretPolicy describes the policy to decide which to do with node publish secret when mounting an existing persistent volume. |
(Appears on: ThinRuntimeProfile)
ThinRuntimeProfileStatus defines the observed state of ThinRuntimeProfile
(Appears on: ThinRuntime)
ThinRuntimeSpec defines the desired state of ThinRuntime
| Field | Description |
|---|---|
profileNamestring |
The specific runtime profile name, empty value is used for handling datasets which mount another dataset |
workerThinCompTemplateSpec |
The component spec of worker |
fuseThinFuseSpec |
The component spec of thinRuntime |
tieredstoreTieredStore |
Tiered storage |
replicasint32 |
The replicas of the worker, need to be specified |
runAsUser |
Manage the user to run Runtime |
disablePrometheusbool |
(Optional)
Disable monitoring for Runtime Prometheus is enabled by default |
volumes[]Kubernetes core/v1.Volume |
(Optional)
Volumes is the list of Kubernetes volumes that can be mounted by runtime components and/or fuses. |
managementRuntimeManagement |
(Optional)
RuntimeManagement defines policies when managing the runtime |
imagePullSecrets[]Kubernetes core/v1.LocalObjectReference |
(Optional)
ImagePullSecrets that will be used to pull images |
(Appears on: AlluxioRuntimeSpec, EFCRuntimeSpec, GooseFSRuntimeSpec, JindoRuntimeSpec, JuiceFSRuntimeSpec, ThinRuntimeSpec, VineyardRuntimeSpec)
TieredStore is a description of the tiered store
| Field | Description |
|---|---|
levels[]Level |
configurations for multiple tiers |
(Appears on: AlluxioRuntimeSpec, DataBackupSpec, DatasetSpec, GooseFSRuntimeSpec, JindoRuntimeSpec, JuiceFSRuntimeSpec, ThinRuntimeSpec)
User explains the user and group to run a Container
| Field | Description |
|---|---|
uidint64 |
The uid to run the alluxio runtime |
gidint64 |
The gid to run the alluxio runtime |
userstring |
The user name to run the alluxio runtime |
groupstring |
The group name to run the alluxio runtime |
(Appears on: AlluxioRuntimeSpec, DataMigrateSpec, EFCCompTemplateSpec, EFCFuseSpec, GooseFSRuntimeSpec, InitFuseSpec, JindoRuntimeSpec, JuiceFSRuntimeSpec, ScriptProcessor)
VersionSpec represents the settings for the version that fluid is orchestrating.
| Field | Description |
|---|---|
imagestring |
Image (e.g. alluxio/alluxio) |
imageTagstring |
Image tag (e.g. 2.3.0-SNAPSHOT) |
imagePullPolicystring |
One of the three policies: |
(Appears on: VineyardRuntimeSpec)
VineyardClientSocketSpec holds the configurations for vineyard client socket
| Field | Description |
|---|---|
imagestring |
(Optional)
Image for Vineyard Fuse
Default is |
imageTagstring |
(Optional)
Image Tag for Vineyard Fuse
Default is |
imagePullPolicystring |
(Optional)
Image pull policy for Vineyard Fuse
Default is |
envmap[string]string |
(Optional)
Environment variables that will be used by Vineyard Fuse. Default is not set. |
cleanPolicyFuseCleanPolicy |
(Optional)
CleanPolicy decides when to clean Vineyard Fuse pods. Currently Fluid supports two policies: OnDemand and OnRuntimeDeleted OnDemand cleans fuse pod once th fuse pod on some node is not needed OnRuntimeDeleted cleans fuse pod only when the cache runtime is deleted Defaults to OnRuntimeDeleted |
resourcesKubernetes core/v1.ResourceRequirements |
(Optional)
Resources contains the resource requirements and limits for the Vineyard Fuse. Default is not set. |
networkModeNetworkMode |
(Optional)
Whether to use hostnetwork or not Default is HostNetwork |
podMetadataPodMetadata |
(Optional)
PodMetadata defines labels and annotations that will be propagated to Vineyard’s pods. |
optionsmap[string]string |
(Optional)
Options for configuring vineyardd parameters. Supported options are as follows. reserve_memory: (Bool) Whether to reserving enough physical memory pages for vineyardd. Default is true. allocator: (String) The allocator used by vineyardd, could be “dlmalloc” or “mimalloc”. Default is “dlmalloc”. compression: (Bool) Compress before migration or spilling. Default is true. coredump: (Bool) Enable coredump core dump when been aborted. Default is false. meta_timeout: (Int) Timeout period before waiting the metadata service to be ready, in seconds Default is 60. etcd_endpoint: (String) The endpoint of etcd. Default is same as the etcd endpoint of vineyard worker. etcd_prefix: (String) Metadata path prefix in etcd. Default is “/vineyard”. size: (String) shared memory size for vineyardd. 1024M, 1024000, 1G, or 1Gi. Default is “0”, which means no cache. When the size is not set to “0”, it should be greater than the 2048 bytes(2K). spill_path: (String) Path to spill temporary files, if not set, spilling will be disabled. Default is “”. spill_lower_rate: (Double) The lower rate of memory usage to trigger spilling. Default is 0.3. spill_upper_rate: (Double) The upper rate of memory usage to stop spilling. Default is 0.8. Default is as follows. fuse: options: size: “0” etcd_endpoint: “http://{{Name}}-master-0.{{Name}}-master.{{Namespace}}:{{EtcdClientPort}}” etcd_prefix: “/vineyard” |
(Appears on: MasterSpec, VineyardRuntimeSpec)
VineyardCompTemplateSpec is the common configurations for vineyard components including Master and Worker.
| Field | Description |
|---|---|
replicasint32 |
(Optional)
The replicas of Vineyard component. If not specified, defaults to 1. For worker, the replicas should not be greater than the number of nodes in the cluster |
imagestring |
(Optional)
The image of Vineyard component.
For Master, the default image is |
imageTagstring |
(Optional)
The image tag of Vineyard component.
For Master, the default image tag is |
imagePullPolicystring |
(Optional)
The image pull policy of Vineyard component.
Default is |
nodeSelectormap[string]string |
(Optional)
NodeSelector is a selector to choose which nodes to launch the Vineyard component. E,g. {“disktype”: “ssd”} |
portsmap[string]int |
(Optional)
Ports used by Vineyard component. For Master, the default client port is 2379 and peer port is 2380. For Worker, the default rpc port is 9600 and the default exporter port is 9144. |
envmap[string]string |
(Optional)
Environment variables that will be used by Vineyard component. For Master, refer to Etcd Configuration for more info Default is not set. |
optionsmap[string]string |
(Optional)
Configurable options for Vineyard component. For Master, there is no configurable options. For Worker, support the following options. vineyardd.reserve.memory: (Bool) where to reserve memory for vineyardd If set to true, the memory quota will be counted to the vineyardd rather than the application. etcd.prefix: (String) the prefix of etcd key for vineyard objects wait.etcd.timeout: (String) the timeout period before waiting the etcd to be ready, in seconds Default value is as follows. |
resourcesKubernetes core/v1.ResourceRequirements |
(Optional)
Resources contains the resource requirements and limits for the Vineyard component. Default is not set. For Worker, when the options contains vineyardd.reserve.memory=true, the resources.request.memory for worker should be greater than tieredstore.levels[0].quota(aka vineyardd shared memory) |
volumeMounts[]Kubernetes core/v1.VolumeMount |
(Optional)
VolumeMounts specifies the volumes listed in “.spec.volumes” to mount into the vineyard runtime component’s filesystem. It is useful for specifying a persistent storage. Default is not set. |
podMetadataPodMetadata |
(Optional)
PodMetadata defines labels and annotations that will be propagated to Vineyard’s pods including Master and Worker. Default is not set. |
networkModeNetworkMode |
(Optional)
Whether to use hostnetwork or not Default is HostNetwork |
(Appears on: VineyardRuntime)
VineyardRuntimeSpec defines the desired state of VineyardRuntime
| Field | Description |
|---|---|
masterMasterSpec |
(Optional)
Master holds the configurations for Vineyard Master component Represents the Etcd component in Vineyard |
workerVineyardCompTemplateSpec |
(Optional)
Worker holds the configurations for Vineyard Worker component Represents the Vineyardd component in Vineyard |
replicasint32 |
The replicas of the worker, need to be specified If worker.replicas and the field are both specified, the field will be respected |
fuseVineyardClientSocketSpec |
(Optional)
Fuse holds the configurations for Vineyard client socket. Note that the “Fuse” here is kept just for API consistency, VineyardRuntime mount a socket file instead of a FUSE filesystem to make data cache available. Applications can connect to the vineyard runtime components through IPC or RPC. IPC is the default way to connect to vineyard runtime components, which is more efficient than RPC. If the socket file is not mounted, the connection will fall back to RPC. |
tieredstoreTieredStore |
(Optional)
Tiered storage used by vineyardd
The MediumType can only be Choose hostpath as the external storage of vineyardd. tieredstore: levels: - level: 0 mediumtype: MEM quota: 4Gi high: “0.8” low: “0.3” - level: 1 mediumtype: SSD quota: 10Gi volumeType: Hostpath path: /var/spill-path |
disablePrometheusbool |
(Optional)
Disable monitoring metrics for Vineyard Runtime Default is false |
podMetadataPodMetadata |
(Optional)
PodMetadata defines labels and annotations that will be propagated to Vineyard’s pods. |
volumes[]Kubernetes core/v1.Volume |
(Optional)
Volumes is the list of Kubernetes volumes that can be mounted by the vineyard components (Master and Worker). Default is null. |
(Appears on: Level)
VolumeSource defines volume source and volume claim template.
| Field | Description |
|---|---|
VolumeSourceKubernetes core/v1.VolumeSource |
(Members of |
(Appears on: OperationStatus)
| Field | Description |
|---|---|
operationCompletebool |
OperationComplete indicates if the preceding operation is complete |
Generated with gen-crd-api-reference-docs
on git commit 9c50ed52c.