mirror of
https://github.com/qdrant/landing_page.git
synced 2026-10-05 19:08:32 +02:00
Private cloud 1.9.3
This commit is contained in:
Bastian Hofmann
@@ -6,9 +6,58 @@ weight: 5
|
||||
# API Reference
|
||||
|
||||
## Packages
|
||||
- [auth.qdrant.io/v1alpha1](#authqdrantiov1alpha1)
|
||||
- [qdrant.io/v1](#qdrantiov1)
|
||||
|
||||
|
||||
## auth.qdrant.io/v1alpha1
|
||||
|
||||
Package v1alpha1 contains API Schema definitions for the qdrant.io v1alpha1 API group
|
||||
|
||||
### Resource Types
|
||||
- [APIAuthentication](#apiauthentication)
|
||||
|
||||
|
||||
|
||||
#### APIAuthentication
|
||||
|
||||
|
||||
|
||||
APIAuthentication is a configuration for authenticating against Qdrant clusters.
|
||||
|
||||
|
||||
|
||||
_Appears in:_
|
||||
- [APIAuthenticationList](#apiauthenticationlist)
|
||||
|
||||
| Field | Description | Default | Validation |
|
||||
| --- | --- | --- | --- |
|
||||
| `apiVersion` _string_ | `auth.qdrant.io/v1alpha1` | | |
|
||||
| `kind` _string_ | `APIAuthentication` | | |
|
||||
| `metadata` _[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#objectmeta-v1-meta)_ | Refer to Kubernetes API documentation for fields of `metadata`. | | |
|
||||
| `spec` _[APIAuthenticationSpec](#apiauthenticationspec)_ | | | |
|
||||
|
||||
|
||||
|
||||
|
||||
#### APIAuthenticationSpec
|
||||
|
||||
|
||||
|
||||
APIAuthenticationSpec describes the configuration for authenticating against Qdrant clusters.
|
||||
|
||||
|
||||
|
||||
_Appears in:_
|
||||
- [APIAuthentication](#apiauthentication)
|
||||
|
||||
| Field | Description | Default | Validation |
|
||||
| --- | --- | --- | --- |
|
||||
| `sha512` _string_ | SHA512 hash of an API key. | | MaxLength: 128 <br />MinLength: 128 <br /> |
|
||||
| `clusterIDs` _string array_ | List of cluster IDs for which the API key is valid | | |
|
||||
|
||||
|
||||
|
||||
## qdrant.io/v1
|
||||
|
||||
Package v1 contains API Schema definitions for the qdrant.io v1 API group
|
||||
@@ -33,6 +82,25 @@ Package v1 contains API Schema definitions for the qdrant.io v1 API group
|
||||
|
||||
|
||||
|
||||
#### ClusterManagerReponse
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
_Appears in:_
|
||||
- [QdrantClusterStatus](#qdrantclusterstatus)
|
||||
|
||||
| Field | Description | Default | Validation |
|
||||
| --- | --- | --- | --- |
|
||||
| `lastResponseTime` _[Time](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#time-v1-meta)_ | The last time the cluster-manager responded in UTC | | |
|
||||
| `executed_actions` _[RawMessage](#rawmessage)_ | ExecutedActions are the actions that have been executed by the cluster-manager | | |
|
||||
| `required_actions` _[RawMessage](#rawmessage)_ | RequiredActions are the actions that are required to be executed by the operator as instructed by cluster-manager | | |
|
||||
| `suggested_actions` _[RawMessage](#rawmessage)_ | SuggestedActions are suggested but not required actions to be executed by the operator as instructed by cluster-manager | | |
|
||||
|
||||
|
||||
#### ClusterPhase
|
||||
|
||||
_Underlying type:_ _string_
|
||||
@@ -303,6 +371,28 @@ _Appears in:_
|
||||
| `k3s` | |
|
||||
|
||||
|
||||
#### KubernetesEventInfo
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
_Appears in:_
|
||||
- [NodePVCStatus](#nodepvcstatus)
|
||||
- [NodeStatus](#nodestatus)
|
||||
- [VolumeSnapshotInfo](#volumesnapshotinfo)
|
||||
|
||||
| Field | Description | Default | Validation |
|
||||
| --- | --- | --- | --- |
|
||||
| `message` _string_ | Event message | | |
|
||||
| `reason` _string_ | Event reason | | |
|
||||
| `count` _integer_ | How many times the event has occurred | | |
|
||||
| `firstTimestamp` _[Time](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#time-v1-meta)_ | The first time the event was seen | | |
|
||||
| `lastTimestamp` _[Time](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#time-v1-meta)_ | The last time the event was seen | | |
|
||||
|
||||
|
||||
#### KubernetesPod
|
||||
|
||||
|
||||
@@ -428,6 +518,28 @@ _Appears in:_
|
||||
| `allocatable` _[NodeResourceInfo](#noderesourceinfo)_ | Allocatable specifies the allocatable resources of the node | | |
|
||||
|
||||
|
||||
#### NodePVCStatus
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
_Appears in:_
|
||||
- [NodeStatus](#nodestatus)
|
||||
|
||||
| Field | Description | Default | Validation |
|
||||
| --- | --- | --- | --- |
|
||||
| `storageClassName` _string_ | Name of the StorageClass used by the PVC | | |
|
||||
| `phase` _[PersistentVolumeClaimPhase](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#persistentvolumeclaimphase-v1-core)_ | Status phase of the PVC | | |
|
||||
| `conditions` _[PersistentVolumeClaimCondition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#persistentvolumeclaimcondition-v1-core) array_ | Conditions of the PVC | | |
|
||||
| `events` _[KubernetesEventInfo](#kuberneteseventinfo) array_ | Recent Kubernetes Events related to the PVC<br />Events that happened in the last 30 minutes are stored. | | |
|
||||
| `capacity` _[ResourceList](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#resourcelist-v1-core)_ | capacity represents the actual resources of the underlying volume. | | |
|
||||
| `currentVolumeAttributesClassName` _string_ | currentVolumeAttributesClassName is the current name of the VolumeAttributesClass the PVC is using.<br />When unset, there is no VolumeAttributeClass applied to this PersistentVolumeClaim | | |
|
||||
| `modifyVolumeStatus` _[ModifyVolumeStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#modifyvolumestatus-v1-core)_ | ModifyVolumeStatus represents the status object of ControllerModifyVolume operation.<br />When this is unset, there is no ModifyVolume operation being attempted. | | |
|
||||
|
||||
|
||||
#### NodeResourceInfo
|
||||
|
||||
|
||||
@@ -464,6 +576,16 @@ _Appears in:_
|
||||
| `started_at` _string_ | StartedAt specifies the time when the node started (in RFC3339 format) | | |
|
||||
| `state` _object (keys:[PodConditionType](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#podconditiontype-v1-core), values:[ConditionStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#conditionstatus-v1-core))_ | States specifies the condition states of the node | | |
|
||||
| `version` _string_ | Version specifies the version of Qdrant running on the node | | |
|
||||
| `liveness` _boolean_ | Reports if qdrant node responded to liveness request (before readiness).<br />This is needed to beter report recovery process to the user. | | |
|
||||
| `podPhase` _[PodPhase](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#podphase-v1-core)_ | Status phase of the Pod of the node | | |
|
||||
| `podConditions` _[PodCondition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#podcondition-v1-core) array_ | Conditions of the Pod of the node | | |
|
||||
| `podMessage` _string_ | Status message of the Pod of the node | | |
|
||||
| `podReason` _string_ | Status reason of the Pod of the node | | |
|
||||
| `containerStatuses` _[ContainerStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#containerstatus-v1-core) array_ | Details container statuses of the Pod of the node | | |
|
||||
| `events` _[KubernetesEventInfo](#kuberneteseventinfo) array_ | Recent Kubernetes Events related to the Pod of the node<br />Events that happened in the last 30 minutes are stored. | | |
|
||||
| `restartCount` _integer_ | The number of times the main qdrant container has been restarted. | | |
|
||||
| `databasePVCStatus` _[NodePVCStatus](#nodepvcstatus)_ | Status of the database storage PVC | | |
|
||||
| `snapshotsPVCStatus` _[NodePVCStatus](#nodepvcstatus)_ | Status of the snapshots storage PVC | | |
|
||||
|
||||
|
||||
#### Pause
|
||||
@@ -801,7 +923,7 @@ _Appears in:_
|
||||
| `gpu` _[GPU](#gpu)_ | GPU specifies GPU configuration for the cluster. If this field is not set, no GPU will be used. | | |
|
||||
| `statefulSet` _[KubernetesStatefulSet](#kubernetesstatefulset)_ | StatefulSet specifies the configuration of the Qdrant Kubernetes StatefulSet. | | |
|
||||
| `storageClassNames` _[StorageClassNames](#storageclassnames)_ | StorageClassNames specifies the storage class names for db and snapshots. | | |
|
||||
| `storageTier` _[StorageTier](#storagetier)_ | StorageTier specifies the performance tier to use for the disk | | Enum: [budget balanced performance] <br /> |
|
||||
| `storage` _[Storage](#storage)_ | Storage specifies the storage specification for the PVCs of the cluster. If the field is not set, no configuration will be applied. | | |
|
||||
| `topologySpreadConstraints` _[TopologySpreadConstraint](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#topologyspreadconstraint-v1-core)_ | TopologySpreadConstraints specifies the topology spread constraints for the cluster. | | |
|
||||
| `podDisruptionBudget` _[PodDisruptionBudgetSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#poddisruptionbudgetspec-v1-policy)_ | PodDisruptionBudget specifies the pod disruption budget for the cluster. | | |
|
||||
| `restartAllPodsConcurrently` _boolean_ | RestartAllPodsConcurrently specifies whether to restart all pods concurrently (also called one-shot-restart).<br />If enabled, all the pods in the cluster will be restarted concurrently in situations where multiple pods<br />need to be restarted, like when RestartedAtAnnotationKey is added/updated or the Qdrant version needs to be upgraded.<br />This helps sharded but not replicated clusters to reduce downtime to a possible minimum during restart.<br />If unset, the operator is going to restart nodes concurrently if none of the collections if replicated. | | |
|
||||
@@ -1295,6 +1417,24 @@ _Appears in:_
|
||||
| `Disabled` | |
|
||||
|
||||
|
||||
#### Storage
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
_Appears in:_
|
||||
- [QdrantClusterSpec](#qdrantclusterspec)
|
||||
|
||||
| Field | Description | Default | Validation |
|
||||
| --- | --- | --- | --- |
|
||||
| `volumeAttributesClassName` _string_ | VolumeAttributesClassName specifies VolumeAttributeClass name to use for the storage PVCs | | |
|
||||
| `iops` _integer_ | IOPS defines the IOPS number to configure for the storage PVCs | | |
|
||||
| `throughput` _integer_ | Throughput defines the throughput number in MB/s for the storage PVCs | | |
|
||||
|
||||
|
||||
#### StorageClass
|
||||
|
||||
|
||||
@@ -1367,25 +1507,6 @@ _Appears in:_
|
||||
| `async_scorer` _boolean_ | AsyncScorer enables io_uring when rescoring | | |
|
||||
|
||||
|
||||
#### StorageTier
|
||||
|
||||
_Underlying type:_ _string_
|
||||
|
||||
StorageTier specifies the performance profile for the disk to use.
|
||||
|
||||
_Validation:_
|
||||
- Enum: [budget balanced performance]
|
||||
|
||||
_Appears in:_
|
||||
- [QdrantClusterSpec](#qdrantclusterspec)
|
||||
|
||||
| Field | Description |
|
||||
| --- | --- |
|
||||
| `budget` | |
|
||||
| `balanced` | |
|
||||
| `performance` | |
|
||||
|
||||
|
||||
#### TraefikConfig
|
||||
|
||||
|
||||
@@ -1437,6 +1558,8 @@ _Appears in:_
|
||||
| `volumeName` _string_ | VolumeName is the name of the volume that was backed up | | |
|
||||
| `readyToUse` _boolean_ | ReadyToUse indicates if the volume snapshot is ready to use | | |
|
||||
| `snapshotHandle` _string_ | SnapshotHandle is the identifier of the volume snapshot in the respective cloud provider | | |
|
||||
| `error` _[VolumeSnapshotError](#volumesnapshoterror)_ | Error contains the error details if the snapshot creation failed | | |
|
||||
| `events` _[KubernetesEventInfo](#kuberneteseventinfo) array_ | Recent Kubernetes Events related to the VolumeSnapshot<br />Events that happened in the last 30 minutes are stored. | | |
|
||||
|
||||
|
||||
#### WriteCluster
|
||||
|
||||
@@ -5,6 +5,21 @@ weight: 5
|
||||
|
||||
# Changelog
|
||||
|
||||
## 1.9.2 (2025-12-22)
|
||||
|
||||
| Component | Version |
|
||||
|-------------------------|---------|
|
||||
| qdrant-kubernetes-api | v1.22.1 |
|
||||
| operator | 2.9.1 |
|
||||
| qdrant-cluster-manager | v0.3.13 |
|
||||
| qdrant-cluster-exporter | 1.7.6 |
|
||||
|
||||
Latest validated Qdrant version: 1.16.3
|
||||
|
||||
* Performance and stability improvements
|
||||
* Qdrant 1.16 improvements
|
||||
* Configurable volumeAttributesClassName for storage volumes
|
||||
|
||||
## 1.9.2 (2025-11-18)
|
||||
|
||||
| Component | Version |
|
||||
|
||||
@@ -20,7 +20,6 @@ operator:
|
||||
# Overrides the image tag whose default is the chart appVersion.
|
||||
tag: ""
|
||||
|
||||
# Optional image pull secrets
|
||||
imagePullSecrets:
|
||||
- name: qdrant-registry-creds
|
||||
|
||||
@@ -32,6 +31,9 @@ operator:
|
||||
create: true
|
||||
annotations: {}
|
||||
|
||||
## Additional labels to add to all resources
|
||||
customLabels: {}
|
||||
|
||||
# Additional pod annotations
|
||||
podAnnotations: {}
|
||||
|
||||
@@ -127,6 +129,16 @@ operator:
|
||||
# The StorageClass used to make snapshot PVCs.
|
||||
# Default is nil, meaning the default storage class of Kubernetes.
|
||||
#snapshot:
|
||||
#volumeAttributesClass:
|
||||
# driverName: ebs.csi.aws.com
|
||||
# default:
|
||||
# name: balanced
|
||||
# parameters:
|
||||
# iops: 3000
|
||||
# throughput: 125
|
||||
# template:
|
||||
# prefix: qdrant-vac
|
||||
# parameters: {}
|
||||
# Qdrant config contains settings specific for the database
|
||||
qdrant:
|
||||
# The config where to find the image for qdrant
|
||||
@@ -188,6 +200,12 @@ operator:
|
||||
- ports:
|
||||
- protocol: UDP
|
||||
port: 53
|
||||
# the settings for cloud inference proxy
|
||||
inference:
|
||||
# inference proxy endpoint
|
||||
# when set, the value is passed to Qdrant cluster config as `inference.address` config param
|
||||
# if QdrantCluster instance has `.spec.config.inference.enabled` field set
|
||||
address: ~
|
||||
# Scheduling config contains the settings specific for scheduling
|
||||
scheduling:
|
||||
# Default topology spread constraints (list from type corev1.TopologySpreadConstraint)
|
||||
@@ -207,9 +225,15 @@ operator:
|
||||
# InvocationInterval is the interval between calls (started after the previous call is retured)
|
||||
# Default is 10 seconds
|
||||
invocationInterval: 10s
|
||||
# SyncClustersInterval is the interval between sync-clusters calls (started after the previous call is retured)
|
||||
# Default is 10 seconds
|
||||
syncClustersInterval: 10s
|
||||
# Timeout is the duration a single call to the cluster manager is allowed to take.
|
||||
# Default is 30 seconds
|
||||
timeout: 30s
|
||||
# syncClustersTimeout is the duration a single call to the cluster manager to sync clusters is allowed to take.
|
||||
# Default is 10 seconds
|
||||
syncClustersTimeout: 10s
|
||||
# Specifies overrides for the manage rules
|
||||
manageRulesOverrides:
|
||||
#dry_run:
|
||||
@@ -217,6 +241,11 @@ operator:
|
||||
#max_transfers_per_collection:
|
||||
#rebalance:
|
||||
#replicate:
|
||||
# Specifies overrides for the manage rules
|
||||
syncClustersRulesOverrides:
|
||||
#dry_run:
|
||||
#max_downtime_sec:
|
||||
#sync_interval_sec:
|
||||
# Ingress config contains the settings specific for ingress
|
||||
ingress:
|
||||
# Whether or not the Ingress feature is enabled.
|
||||
@@ -242,6 +271,9 @@ operator:
|
||||
# Enable body validator plugin and matching ingressroute rules
|
||||
# Default is false
|
||||
enableBodyValidatorPlugin: false
|
||||
# EntryPoints is the list of traefik entry points to use for the ingress route
|
||||
# Default is ["web"] or ["websecure"] depending on the TLS setting
|
||||
entryPoints: []
|
||||
# The specific settings when the Provider is KubernetesIngress
|
||||
kubernetesIngress:
|
||||
# Name of the ingress class
|
||||
@@ -385,6 +417,9 @@ qdrant-cluster-exporter:
|
||||
rbac:
|
||||
create: true
|
||||
|
||||
## Additional labels to add to all resources
|
||||
customLabels: {}
|
||||
|
||||
podAnnotations: {}
|
||||
|
||||
podSecurityContext:
|
||||
@@ -429,18 +464,18 @@ qdrant-cluster-exporter:
|
||||
affinity: {}
|
||||
|
||||
serviceMonitor:
|
||||
enabled: true
|
||||
enabled: false
|
||||
honorLabels: true
|
||||
scrapeInterval: 60s
|
||||
scrapeTimeout: 55s
|
||||
|
||||
# Limit RBAC to the release namespace
|
||||
limitRBAC: false
|
||||
limitRBAC: true
|
||||
|
||||
# Watched Namespaces Configuration
|
||||
watch:
|
||||
# If true, only the namespace where the exporter is deployed is watched, otherwise it watches the namespaces defined in watch.namespaces
|
||||
onlyReleaseNamespace: false
|
||||
onlyReleaseNamespace: true
|
||||
# an empty list watches all namespaces
|
||||
namespaces: []
|
||||
|
||||
|
||||
@@ -67,13 +67,13 @@ helm registry login 'registry.cloud.qdrant.io' --username 'your-username' --pass
|
||||
4. Install the Qdrant Kubernetes Operator Custom Resource Definitions (CRDs):
|
||||
|
||||
```bash
|
||||
helm upgrade --install qdrant-private-cloud-crds oci://registry.cloud.qdrant.io/qdrant-charts/qdrant-kubernetes-api --namespace qdrant-private-cloud --version v1.20.0 --wait
|
||||
helm upgrade --install qdrant-private-cloud-crds oci://registry.cloud.qdrant.io/qdrant-charts/qdrant-kubernetes-api --namespace qdrant-private-cloud --version v1.22.1 --wait
|
||||
```
|
||||
|
||||
5. Install Qdrant Private Cloud:
|
||||
|
||||
```bash
|
||||
helm upgrade --install qdrant-private-cloud oci://registry.cloud.qdrant.io/qdrant-charts/qdrant-private-cloud --namespace qdrant-private-cloud --version 1.9.2
|
||||
helm upgrade --install qdrant-private-cloud oci://registry.cloud.qdrant.io/qdrant-charts/qdrant-private-cloud --namespace qdrant-private-cloud --version 1.9.3
|
||||
```
|
||||
|
||||
Ensure that the `qdrant-kubernetes-api` version is compatible with the `qdrant-private-cloud` version you are installing.
|
||||
@@ -82,8 +82,8 @@ For a list of available versions consult the [Private Cloud Changelog](/document
|
||||
|
||||
Current default versions are:
|
||||
|
||||
* qdrant-kubernetes-api v1.20.0
|
||||
* qdrant-private-cloud 1.9.2
|
||||
* qdrant-kubernetes-api v1.22.1
|
||||
* qdrant-private-cloud 1.9.3
|
||||
|
||||
For more information also see the [Helm Install Documentation](https://helm.sh/docs/helm/helm_install/).
|
||||
|
||||
@@ -111,7 +111,7 @@ operator:
|
||||
You can configure Qdrant Private Cloud like this:
|
||||
|
||||
```bash
|
||||
helm upgrade --install qdrant-private-cloud oci://registry.cloud.qdrant.io/qdrant-charts/qdrant-private-cloud --namespace qdrant-private-cloud --version 1.9.2 -f values.yaml
|
||||
helm upgrade --install qdrant-private-cloud oci://registry.cloud.qdrant.io/qdrant-charts/qdrant-private-cloud --namespace qdrant-private-cloud --version 1.9.3 -f values.yaml
|
||||
```
|
||||
|
||||
## Upgrades
|
||||
@@ -119,13 +119,13 @@ helm upgrade --install qdrant-private-cloud oci://registry.cloud.qdrant.io/qdran
|
||||
To upgrade Qdrant Private Cloud to a new version, first upgrade the Qdrant Kubernetes Operator Custom Resource Definitions (CRDs):
|
||||
|
||||
```bash
|
||||
helm upgrade --install qdrant-private-cloud-crds oci://registry.cloud.qdrant.io/qdrant-charts/qdrant-kubernetes-api --namespace qdrant-private-cloud --version v1.20.0 --wait
|
||||
helm upgrade --install qdrant-private-cloud-crds oci://registry.cloud.qdrant.io/qdrant-charts/qdrant-kubernetes-api --namespace qdrant-private-cloud --version v1.22.1 --wait
|
||||
```
|
||||
|
||||
Then upgrade the Qdrant Private Cloud Helm chart using the same configuration values, e.g.:
|
||||
|
||||
```bash
|
||||
helm upgrade --install qdrant-private-cloud oci://registry.cloud.qdrant.io/qdrant-charts/qdrant-private-cloud --namespace qdrant-private-cloud --version 1.9.2 -f values.yaml
|
||||
helm upgrade --install qdrant-private-cloud oci://registry.cloud.qdrant.io/qdrant-charts/qdrant-private-cloud --namespace qdrant-private-cloud --version 1.9.3 -f values.yaml
|
||||
```
|
||||
|
||||
Note, that the image tag values are automatically derived from the chart's appVersions and should not be overridden in the `values.yaml`.
|
||||
|
||||
Reference in New Issue
Block a user