2024-01-08 11:28:31 +00:00
|
|
|
---
|
|
|
|
layout: page
|
|
|
|
parent: CRD reference
|
|
|
|
title: ArangoMLStorage V1Alpha1
|
|
|
|
---
|
|
|
|
|
2023-11-08 15:36:20 +00:00
|
|
|
# API Reference for ArangoMLStorage V1Alpha1
|
|
|
|
|
|
|
|
## Spec
|
|
|
|
|
2023-11-28 07:05:53 +00:00
|
|
|
### .spec.backend.s3.allowInsecure
|
2023-11-23 15:16:02 +00:00
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/ml/v1alpha1/storage_spec_backend_s3.go#L40)</sup>
|
2023-11-23 15:16:02 +00:00
|
|
|
|
2023-11-28 07:05:53 +00:00
|
|
|
AllowInsecure if set to true, the Endpoint certificates won't be checked
|
2023-11-23 15:16:02 +00:00
|
|
|
|
2023-11-28 07:05:53 +00:00
|
|
|
Default Value: `false`
|
2023-11-23 15:16:02 +00:00
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-04-05 12:53:05 +00:00
|
|
|
### .spec.backend.s3.caSecret.checksum
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/shared/v1/object.go#L61)</sup>
|
2024-04-05 12:53:05 +00:00
|
|
|
|
|
|
|
UID keeps the information about object Checksum
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2023-11-28 07:05:53 +00:00
|
|
|
### .spec.backend.s3.caSecret.name
|
2023-11-23 15:16:02 +00:00
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/shared/v1/object.go#L52)</sup>
|
2023-11-23 15:16:02 +00:00
|
|
|
|
2023-11-28 07:05:53 +00:00
|
|
|
Name of the object
|
2023-11-23 15:16:02 +00:00
|
|
|
|
|
|
|
***
|
|
|
|
|
2023-11-28 07:05:53 +00:00
|
|
|
### .spec.backend.s3.caSecret.namespace
|
2023-11-23 15:16:02 +00:00
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/shared/v1/object.go#L55)</sup>
|
2023-11-23 15:16:02 +00:00
|
|
|
|
2023-11-28 07:05:53 +00:00
|
|
|
Namespace of the object. Should default to the namespace of the parent object
|
2023-11-23 15:16:02 +00:00
|
|
|
|
|
|
|
***
|
|
|
|
|
2023-11-28 11:29:03 +00:00
|
|
|
### .spec.backend.s3.caSecret.uid
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/shared/v1/object.go#L58)</sup>
|
2023-11-28 11:29:03 +00:00
|
|
|
|
|
|
|
UID keeps the information about object UID
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-04-05 12:53:05 +00:00
|
|
|
### .spec.backend.s3.credentialsSecret.checksum
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/shared/v1/object.go#L61)</sup>
|
2024-04-05 12:53:05 +00:00
|
|
|
|
|
|
|
UID keeps the information about object Checksum
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2023-11-28 07:05:53 +00:00
|
|
|
### .spec.backend.s3.credentialsSecret.name
|
2023-11-23 15:16:02 +00:00
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/shared/v1/object.go#L52)</sup>
|
2023-11-23 15:16:02 +00:00
|
|
|
|
2023-11-28 07:05:53 +00:00
|
|
|
Name of the object
|
2023-11-23 15:16:02 +00:00
|
|
|
|
2023-11-28 07:05:53 +00:00
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.backend.s3.credentialsSecret.namespace
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/shared/v1/object.go#L55)</sup>
|
2023-11-28 07:05:53 +00:00
|
|
|
|
|
|
|
Namespace of the object. Should default to the namespace of the parent object
|
2023-11-23 15:16:02 +00:00
|
|
|
|
|
|
|
***
|
|
|
|
|
2023-11-28 11:29:03 +00:00
|
|
|
### .spec.backend.s3.credentialsSecret.uid
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/shared/v1/object.go#L58)</sup>
|
2023-11-28 11:29:03 +00:00
|
|
|
|
|
|
|
UID keeps the information about object UID
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2023-11-28 07:05:53 +00:00
|
|
|
### .spec.backend.s3.endpoint
|
2023-11-23 15:16:02 +00:00
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/ml/v1alpha1/storage_spec_backend_s3.go#L34)</sup>
|
2023-11-23 15:16:02 +00:00
|
|
|
|
|
|
|
Endpoint specifies the S3 API-compatible endpoint which implements storage
|
|
|
|
Required
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2023-11-28 07:05:53 +00:00
|
|
|
### .spec.backend.s3.region
|
2023-11-23 15:16:02 +00:00
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/ml/v1alpha1/storage_spec_backend_s3.go#L49)</sup>
|
2023-11-23 15:16:02 +00:00
|
|
|
|
2023-11-28 07:05:53 +00:00
|
|
|
Region defines the availability zone name.
|
2023-11-23 15:16:02 +00:00
|
|
|
|
|
|
|
Default Value: `""`
|
|
|
|
|
2023-11-28 07:05:53 +00:00
|
|
|
***
|
|
|
|
|
2023-12-05 08:47:40 +00:00
|
|
|
### .spec.bucketName
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/ml/v1alpha1/storage_spec.go#L30)</sup>
|
2023-12-05 08:47:40 +00:00
|
|
|
|
|
|
|
BucketName specifies the name of the bucket
|
|
|
|
Required
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.bucketPath
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/ml/v1alpha1/storage_spec.go#L34)</sup>
|
2023-12-05 08:47:40 +00:00
|
|
|
|
|
|
|
BucketPath specifies the path within the bucket
|
|
|
|
|
|
|
|
Default Value: `/`
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-03-12 09:56:58 +00:00
|
|
|
### .spec.mode.sidecar.args
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `array` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/scheduler/v1alpha1/container/resources/core.go#L50)</sup>
|
2024-03-12 09:56:58 +00:00
|
|
|
|
|
|
|
Arguments to the entrypoint.
|
|
|
|
The container image's CMD is used if this is not provided.
|
|
|
|
Variable references $(VAR_NAME) are expanded using the container's environment. If a variable
|
|
|
|
cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced
|
|
|
|
to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will
|
|
|
|
produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless
|
|
|
|
of whether the variable exists or not. Cannot be updated.
|
|
|
|
|
|
|
|
Links:
|
|
|
|
* [Kubernetes Docs](https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell)
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.mode.sidecar.command
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `array` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/scheduler/v1alpha1/container/resources/core.go#L40)</sup>
|
2024-03-12 09:56:58 +00:00
|
|
|
|
|
|
|
Entrypoint array. Not executed within a shell.
|
|
|
|
The container image's ENTRYPOINT is used if this is not provided.
|
|
|
|
Variable references $(VAR_NAME) are expanded using the container's environment. If a variable
|
|
|
|
cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced
|
|
|
|
to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. "$$(VAR_NAME)" will
|
|
|
|
produce the string literal "$(VAR_NAME)". Escaped references will never be expanded, regardless
|
|
|
|
of whether the variable exists or not. Cannot be updated.
|
|
|
|
|
|
|
|
Links:
|
|
|
|
* [Kubernetes Docs](https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell)
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-01-18 15:15:30 +00:00
|
|
|
### .spec.mode.sidecar.controllerListenPort
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/ml/v1alpha1/storage_spec_mode_sidecar.go#L36)</sup>
|
2024-01-18 15:15:30 +00:00
|
|
|
|
|
|
|
ControllerListenPort defines on which port the sidecar container will be listening for controller requests
|
|
|
|
|
|
|
|
Default Value: `9202`
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2023-12-22 12:21:44 +00:00
|
|
|
### .spec.mode.sidecar.env
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `core.EnvVar` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/scheduler/v1alpha1/container/resources/environments.go#L36)</sup>
|
2023-12-22 12:21:44 +00:00
|
|
|
|
|
|
|
Env keeps the information about environment variables provided to the container
|
|
|
|
|
|
|
|
Links:
|
2024-03-08 22:27:25 +00:00
|
|
|
* [Kubernetes Docs](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.29/#envvar-v1-core)
|
2023-12-22 12:21:44 +00:00
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.mode.sidecar.envFrom
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `core.EnvFromSource` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/scheduler/v1alpha1/container/resources/environments.go#L41)</sup>
|
2023-12-22 12:21:44 +00:00
|
|
|
|
|
|
|
EnvFrom keeps the information about environment variable sources provided to the container
|
|
|
|
|
|
|
|
Links:
|
2024-03-08 22:27:25 +00:00
|
|
|
* [Kubernetes Docs](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.29/#envfromsource-v1-core)
|
2023-12-22 12:21:44 +00:00
|
|
|
|
|
|
|
***
|
|
|
|
|
2023-12-05 08:47:40 +00:00
|
|
|
### .spec.mode.sidecar.image
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/scheduler/v1alpha1/container/resources/image.go#L35)</sup>
|
2023-12-05 08:47:40 +00:00
|
|
|
|
|
|
|
Image define image details
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-02-23 08:21:00 +00:00
|
|
|
### .spec.mode.sidecar.imagePullPolicy
|
2023-11-28 07:05:53 +00:00
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/scheduler/v1alpha1/container/resources/image.go#L39)</sup>
|
2023-11-28 07:05:53 +00:00
|
|
|
|
2024-02-23 08:21:00 +00:00
|
|
|
ImagePullPolicy define Image pull policy
|
2023-11-28 07:05:53 +00:00
|
|
|
|
2024-02-23 08:21:00 +00:00
|
|
|
Default Value: `IfNotPresent`
|
2023-11-28 07:05:53 +00:00
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-03-04 12:59:13 +00:00
|
|
|
### .spec.mode.sidecar.lifecycle
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `core.Lifecycle` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/scheduler/v1alpha1/container/resources/lifecycle.go#L35)</sup>
|
2024-03-04 12:59:13 +00:00
|
|
|
|
|
|
|
Lifecycle keeps actions that the management system should take in response to container lifecycle events.
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-02-23 08:21:00 +00:00
|
|
|
### .spec.mode.sidecar.listenPort
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/ml/v1alpha1/storage_spec_mode_sidecar.go#L32)</sup>
|
2023-12-05 08:47:40 +00:00
|
|
|
|
2024-02-23 08:21:00 +00:00
|
|
|
ListenPort defines on which port the sidecar container will be listening for connections
|
2023-12-05 08:47:40 +00:00
|
|
|
|
2024-02-23 08:21:00 +00:00
|
|
|
Default Value: `9201`
|
2023-12-05 08:47:40 +00:00
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-03-04 12:59:13 +00:00
|
|
|
### .spec.mode.sidecar.livenessProbe
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `core.Probe` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/scheduler/v1alpha1/container/resources/probes.go#L37)</sup>
|
2024-03-04 12:59:13 +00:00
|
|
|
|
|
|
|
LivenessProbe keeps configuration of periodic probe of container liveness.
|
|
|
|
Container will be restarted if the probe fails.
|
|
|
|
|
|
|
|
Links:
|
|
|
|
* [Kubernetes docs](https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes)
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.mode.sidecar.ports
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `[]core.ContainerPort` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/scheduler/v1alpha1/container/resources/networking.go#L39)</sup>
|
2024-03-04 12:59:13 +00:00
|
|
|
|
|
|
|
Ports contains list of ports to expose from the container. Not specifying a port here
|
|
|
|
DOES NOT prevent that port from being exposed. Any port which is
|
|
|
|
listening on the default "0.0.0.0" address inside a container will be
|
|
|
|
accessible from the network.
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.mode.sidecar.readinessProbe
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `core.Probe` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/scheduler/v1alpha1/container/resources/probes.go#L42)</sup>
|
2024-03-04 12:59:13 +00:00
|
|
|
|
|
|
|
ReadinessProbe keeps configuration of periodic probe of container service readiness.
|
|
|
|
Container will be removed from service endpoints if the probe fails.
|
|
|
|
|
|
|
|
Links:
|
|
|
|
* [Kubernetes docs](https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes)
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2023-11-28 07:05:53 +00:00
|
|
|
### .spec.mode.sidecar.resources
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `core.ResourceRequirements` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/scheduler/v1alpha1/container/resources/resources.go#L37)</sup>
|
2023-11-28 07:05:53 +00:00
|
|
|
|
2023-12-05 08:47:40 +00:00
|
|
|
Resources holds resource requests & limits for container
|
2023-11-28 07:05:53 +00:00
|
|
|
|
|
|
|
Links:
|
2024-03-08 22:27:25 +00:00
|
|
|
* [Documentation of core.ResourceRequirements](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.29/#resourcerequirements-v1-core)
|
2023-11-28 07:05:53 +00:00
|
|
|
|
2023-12-08 09:39:19 +00:00
|
|
|
***
|
|
|
|
|
2023-12-08 15:13:12 +00:00
|
|
|
### .spec.mode.sidecar.securityContext
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `core.SecurityContext` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/scheduler/v1alpha1/container/resources/security.go#L35)</sup>
|
2023-12-08 15:13:12 +00:00
|
|
|
|
2024-03-01 15:03:05 +00:00
|
|
|
SecurityContext holds container-level security attributes and common container settings.
|
2023-12-08 15:13:12 +00:00
|
|
|
|
|
|
|
Links:
|
|
|
|
* [Kubernetes docs](https://kubernetes.io/docs/tasks/configure-pod-container/security-context/)
|
|
|
|
|
2024-03-04 12:59:13 +00:00
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.mode.sidecar.startupProbe
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `core.Probe` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/scheduler/v1alpha1/container/resources/probes.go#L50)</sup>
|
2024-03-04 12:59:13 +00:00
|
|
|
|
|
|
|
StartupProbe indicates that the Pod has successfully initialized.
|
|
|
|
If specified, no other probes are executed until this completes successfully.
|
|
|
|
If this probe fails, the Pod will be restarted, just as if the livenessProbe failed.
|
|
|
|
This can be used to provide different probe parameters at the beginning of a Pod's lifecycle,
|
|
|
|
when it might take a long time to load data or warm a cache, than during steady-state operation.
|
|
|
|
|
|
|
|
Links:
|
|
|
|
* [Kubernetes docs](https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes)
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.mode.sidecar.volumeMounts
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `[]core.VolumeMount` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/scheduler/v1alpha1/container/resources/volume_mounts.go#L35)</sup>
|
2024-03-04 12:59:13 +00:00
|
|
|
|
|
|
|
VolumeMounts keeps list of pod volumes to mount into the container's filesystem.
|
|
|
|
|
2024-03-12 09:56:58 +00:00
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.mode.sidecar.workingDir
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/scheduler/v1alpha1/container/resources/core.go#L55)</sup>
|
2024-03-12 09:56:58 +00:00
|
|
|
|
|
|
|
Container's working directory.
|
|
|
|
If not specified, the container runtime's default will be used, which
|
|
|
|
might be configured in the container image.
|
|
|
|
|
2023-11-08 15:36:20 +00:00
|
|
|
## Status
|
|
|
|
|
2023-11-24 08:18:21 +00:00
|
|
|
### .status.conditions
|
|
|
|
|
2024-07-19 15:03:35 +00:00
|
|
|
Type: `api.Conditions` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.42/pkg/apis/ml/v1alpha1/storage_status.go#L28)</sup>
|
2023-11-24 08:18:21 +00:00
|
|
|
|
|
|
|
Conditions specific to the entire storage
|
|
|
|
|