1
0
Fork 0
mirror of https://github.com/arangodb/kube-arangodb.git synced 2024-12-14 11:57:37 +00:00
kube-arangodb/docs/api/ArangoMLStorage.V1Alpha1.md

321 lines
11 KiB
Markdown
Raw Normal View History

---
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
2024-05-22 11:40:27 +00:00
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/ml/v1alpha1/storage_spec_backend_s3.go#L40)</sup>
2023-11-28 07:05:53 +00:00
AllowInsecure if set to true, the Endpoint certificates won't be checked
2023-11-28 07:05:53 +00:00
Default Value: `false`
***
2024-04-05 12:53:05 +00:00
### .spec.backend.s3.caSecret.checksum
2024-05-22 11:40:27 +00:00
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/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
2024-05-22 11:40:27 +00:00
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/shared/v1/object.go#L52)</sup>
2023-11-28 07:05:53 +00:00
Name of the object
***
2023-11-28 07:05:53 +00:00
### .spec.backend.s3.caSecret.namespace
2024-05-22 11:40:27 +00:00
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/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
***
### .spec.backend.s3.caSecret.uid
2024-05-22 11:40:27 +00:00
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/shared/v1/object.go#L58)</sup>
UID keeps the information about object UID
***
2024-04-05 12:53:05 +00:00
### .spec.backend.s3.credentialsSecret.checksum
2024-05-22 11:40:27 +00:00
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/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
2024-05-22 11:40:27 +00:00
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/shared/v1/object.go#L52)</sup>
2023-11-28 07:05:53 +00:00
Name of the object
2023-11-28 07:05:53 +00:00
***
### .spec.backend.s3.credentialsSecret.namespace
2024-05-22 11:40:27 +00:00
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/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
***
### .spec.backend.s3.credentialsSecret.uid
2024-05-22 11:40:27 +00:00
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/shared/v1/object.go#L58)</sup>
UID keeps the information about object UID
***
2023-11-28 07:05:53 +00:00
### .spec.backend.s3.endpoint
2024-05-22 11:40:27 +00:00
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/ml/v1alpha1/storage_spec_backend_s3.go#L34)</sup>
Endpoint specifies the S3 API-compatible endpoint which implements storage
Required
***
2023-11-28 07:05:53 +00:00
### .spec.backend.s3.region
2024-05-22 11:40:27 +00:00
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/ml/v1alpha1/storage_spec_backend_s3.go#L49)</sup>
2023-11-28 07:05:53 +00:00
Region defines the availability zone name.
Default Value: `""`
2023-11-28 07:05:53 +00:00
***
### .spec.bucketName
2024-05-22 11:40:27 +00:00
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/ml/v1alpha1/storage_spec.go#L30)</sup>
BucketName specifies the name of the bucket
Required
***
### .spec.bucketPath
2024-05-22 11:40:27 +00:00
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/ml/v1alpha1/storage_spec.go#L34)</sup>
BucketPath specifies the path within the bucket
Default Value: `/`
***
### .spec.mode.sidecar.args
2024-05-22 11:40:27 +00:00
Type: `array` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/scheduler/v1alpha1/container/resources/core.go#L50)</sup>
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-05-22 11:40:27 +00:00
Type: `array` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/scheduler/v1alpha1/container/resources/core.go#L40)</sup>
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)
***
### .spec.mode.sidecar.controllerListenPort
2024-05-22 11:40:27 +00:00
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/ml/v1alpha1/storage_spec_mode_sidecar.go#L36)</sup>
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-05-22 11:40:27 +00:00
Type: `core.EnvVar` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/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:
* [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-05-22 11:40:27 +00:00
Type: `core.EnvFromSource` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/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:
* [Kubernetes Docs](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.29/#envfromsource-v1-core)
2023-12-22 12:21:44 +00:00
***
### .spec.mode.sidecar.image
2024-05-22 11:40:27 +00:00
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/scheduler/v1alpha1/container/resources/image.go#L35)</sup>
Image define image details
***
### .spec.mode.sidecar.imagePullPolicy
2023-11-28 07:05:53 +00:00
2024-05-22 11:40:27 +00:00
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/scheduler/v1alpha1/container/resources/image.go#L39)</sup>
2023-11-28 07:05:53 +00:00
ImagePullPolicy define Image pull policy
2023-11-28 07:05:53 +00:00
Default Value: `IfNotPresent`
2023-11-28 07:05:53 +00:00
***
### .spec.mode.sidecar.lifecycle
2024-05-22 11:40:27 +00:00
Type: `core.Lifecycle` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/scheduler/v1alpha1/container/resources/lifecycle.go#L35)</sup>
Lifecycle keeps actions that the management system should take in response to container lifecycle events.
***
### .spec.mode.sidecar.listenPort
2024-05-22 11:40:27 +00:00
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/ml/v1alpha1/storage_spec_mode_sidecar.go#L32)</sup>
ListenPort defines on which port the sidecar container will be listening for connections
Default Value: `9201`
***
### .spec.mode.sidecar.livenessProbe
2024-05-22 11:40:27 +00:00
Type: `core.Probe` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/scheduler/v1alpha1/container/resources/probes.go#L37)</sup>
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-05-22 11:40:27 +00:00
Type: `[]core.ContainerPort` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/scheduler/v1alpha1/container/resources/networking.go#L39)</sup>
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-05-22 11:40:27 +00:00
Type: `core.Probe` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/scheduler/v1alpha1/container/resources/probes.go#L42)</sup>
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-05-22 11:40:27 +00:00
Type: `core.ResourceRequirements` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/scheduler/v1alpha1/container/resources/resources.go#L37)</sup>
2023-11-28 07:05:53 +00:00
Resources holds resource requests & limits for container
2023-11-28 07:05:53 +00:00
Links:
* [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
***
### .spec.mode.sidecar.securityContext
2024-05-22 11:40:27 +00:00
Type: `core.SecurityContext` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/scheduler/v1alpha1/container/resources/security.go#L35)</sup>
SecurityContext holds container-level security attributes and common container settings.
Links:
* [Kubernetes docs](https://kubernetes.io/docs/tasks/configure-pod-container/security-context/)
***
### .spec.mode.sidecar.startupProbe
2024-05-22 11:40:27 +00:00
Type: `core.Probe` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/scheduler/v1alpha1/container/resources/probes.go#L50)</sup>
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-05-22 11:40:27 +00:00
Type: `[]core.VolumeMount` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/scheduler/v1alpha1/container/resources/volume_mounts.go#L35)</sup>
VolumeMounts keeps list of pod volumes to mount into the container's filesystem.
***
### .spec.mode.sidecar.workingDir
2024-05-22 11:40:27 +00:00
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/scheduler/v1alpha1/container/resources/core.go#L55)</sup>
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
### .status.conditions
2024-05-22 11:40:27 +00:00
Type: `api.Conditions` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.41/pkg/apis/ml/v1alpha1/storage_status.go#L28)</sup>
Conditions specific to the entire storage