From 913ecbfbeb0d660c8522eb2e9cbc4e0b5b3c37c9 Mon Sep 17 00:00:00 2001 From: Lakhan Samani Date: Mon, 19 Oct 2026 23:52:41 +0530 Subject: [PATCH] CCL-2382: add io_uring to storage performance config Qdrant v1.19.0+ takes storage.performance.io_uring (auto|disabled), which overrides async_scorer. A named IOUringMode so consumers reuse the constants. Pass-through only; no default lives here. --- api/v1/qdrantcluster_types.go | 16 ++++++++++++++++ api/v1/zz_generated.deepcopy.go | 5 +++++ .../region-crds/qdrant.io_qdrantclusters.yaml | 8 ++++++++ crds/qdrant.io_qdrantclusters.yaml | 8 ++++++++ docs/api.md | 19 +++++++++++++++++++ 5 files changed, 56 insertions(+) diff --git a/api/v1/qdrantcluster_types.go b/api/v1/qdrantcluster_types.go index 7470492..f31818e 100644 --- a/api/v1/qdrantcluster_types.go +++ b/api/v1/qdrantcluster_types.go @@ -573,6 +573,18 @@ type StorageConfig struct { MaxCollections *uint `json:"maxCollections,omitempty"` } +// IOUringMode specifies the async I/O mode, supported from Qdrant v1.19.0. +// +kubebuilder:validation:Enum=auto;disabled +type IOUringMode string + +//goland:noinspection GoUnusedConst +const ( + // IOUringAuto uses io_uring for every structure in the cold memory tier. + IOUringAuto IOUringMode = "auto" + // IOUringDisabled turns io_uring off entirely. + IOUringDisabled IOUringMode = "disabled" +) + type StoragePerformanceConfig struct { // OptimizerCPUBudget defines the number of CPU allocation. // If 0 - auto selection, keep 1 or more CPUs unallocated depending on CPU size @@ -583,6 +595,10 @@ type StoragePerformanceConfig struct { // AsyncScorer enables io_uring when rescoring // +optional AsyncScorer *bool `json:"async_scorer,omitempty"` + // IOUring selects the async I/O mode, supported from Qdrant v1.19.0. + // When set it overrides AsyncScorer. + // +optional + IOUring *IOUringMode `json:"io_uring,omitempty"` } func (c *QdrantConfiguration) GetService() *QdrantConfigurationService { diff --git a/api/v1/zz_generated.deepcopy.go b/api/v1/zz_generated.deepcopy.go index aa959cc..7a2270f 100644 --- a/api/v1/zz_generated.deepcopy.go +++ b/api/v1/zz_generated.deepcopy.go @@ -2212,6 +2212,11 @@ func (in *StoragePerformanceConfig) DeepCopyInto(out *StoragePerformanceConfig) *out = new(bool) **out = **in } + if in.IOUring != nil { + in, out := &in.IOUring, &out.IOUring + *out = new(IOUringMode) + **out = **in + } } // DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new StoragePerformanceConfig. diff --git a/charts/qdrant-kubernetes-api/templates/region-crds/qdrant.io_qdrantclusters.yaml b/charts/qdrant-kubernetes-api/templates/region-crds/qdrant.io_qdrantclusters.yaml index eec7290..bbc84bb 100644 --- a/charts/qdrant-kubernetes-api/templates/region-crds/qdrant.io_qdrantclusters.yaml +++ b/charts/qdrant-kubernetes-api/templates/region-crds/qdrant.io_qdrantclusters.yaml @@ -254,6 +254,14 @@ spec: async_scorer: description: AsyncScorer enables io_uring when rescoring type: boolean + io_uring: + description: |- + IOUring selects the async I/O mode, supported from Qdrant v1.19.0. + When set it overrides AsyncScorer. + enum: + - auto + - disabled + type: string optimizer_cpu_budget: description: |- OptimizerCPUBudget defines the number of CPU allocation. diff --git a/crds/qdrant.io_qdrantclusters.yaml b/crds/qdrant.io_qdrantclusters.yaml index 3b39769..c3dff84 100644 --- a/crds/qdrant.io_qdrantclusters.yaml +++ b/crds/qdrant.io_qdrantclusters.yaml @@ -252,6 +252,14 @@ spec: async_scorer: description: AsyncScorer enables io_uring when rescoring type: boolean + io_uring: + description: |- + IOUring selects the async I/O mode, supported from Qdrant v1.19.0. + When set it overrides AsyncScorer. + enum: + - auto + - disabled + type: string optimizer_cpu_budget: description: |- OptimizerCPUBudget defines the number of CPU allocation. diff --git a/docs/api.md b/docs/api.md index 34087fe..d63fd47 100644 --- a/docs/api.md +++ b/docs/api.md @@ -378,6 +378,24 @@ _Appears in:_ | `object` _[HelmRepository](#helmrepository)_ | Object specifies the helm repository object | | EmbeddedResource: \{\}
| +#### IOUringMode + +_Underlying type:_ _string_ + +IOUringMode specifies the async I/O mode, supported from Qdrant v1.19.0. + +_Validation:_ +- Enum: [auto disabled] + +_Appears in:_ +- [StoragePerformanceConfig](#storageperformanceconfig) + +| Field | Description | +| --- | --- | +| `auto` | IOUringAuto uses io_uring for every structure in the cold memory tier.
| +| `disabled` | IOUringDisabled turns io_uring off entirely.
| + + #### InferenceConfig @@ -1802,6 +1820,7 @@ _Appears in:_ | --- | --- | --- | --- | | `optimizer_cpu_budget` _integer_ | OptimizerCPUBudget defines the number of CPU allocation.
If 0 - auto selection, keep 1 or more CPUs unallocated depending on CPU size
If negative - subtract this number of CPUs from the available CPUs.
If positive - use this exact number of CPUs. | | Optional: \{\}
| | `async_scorer` _boolean_ | AsyncScorer enables io_uring when rescoring | | Optional: \{\}
| +| `io_uring` _[IOUringMode](#iouringmode)_ | IOUring selects the async I/O mode, supported from Qdrant v1.19.0.
When set it overrides AsyncScorer. | | Enum: [auto disabled]
Optional: \{\}
| #### TemplateMetadata