К основному содержанию
скилл CX Codex

qdrant-hybrid-cloud-setup — скилл для Claude Code: настройка

Скилл qdrant-hybrid-cloud-setup для Claude Code помогает развернуть Qdrant Hybrid Cloud в собственном Kubernetes-кластере. Подключается при настройке агента и оператора, хранилища, резервных копий или доступа к кластеру.

Apache-2.0 121 установок ★ 271 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add qdrant/skills --skill qdrant-hybrid-cloud-setup -a claude-code
Открыть на GitHub

Что делает qdrant-hybrid-cloud-setup

Скилл разбирает настройку Qdrant Hybrid Cloud на собственном Kubernetes: от подготовки окружения и установки агента с оператором до создания кластера, его защиты и ротации секретов. Он помогает диагностировать сбои хранилища и связи агента с Qdrant Cloud.

Для данных нужен CSI-драйвер блочного хранилища: NFS и S3 не поддерживаются. StorageClass с allowVolumeExpansion: true и VolumeSnapshotClass нужно создать заранее; для установки также нужны права cluster-admin, настроенные kubectl и helm. Агенту требуется исходящее соединение с grpc.cloud.qdrant.io и api.cloud.qdrant.io по порту 443.

Скилл объясняет выбор классов хранения и снимков, настройку доступа через LoadBalancer, NodePort или Ingress и требования к API-ключу при внешнем доступе. Порт 6335 для внутреннего gRPC нельзя открывать публично. Для кластеров на Linode или Vultr резервное копирование зависит от поддержки CSI-снимков платформой.

Какие задачи решает

  • подготовить Kubernetes-хранилище для Qdrant
  • установить агент и оператор Hybrid Cloud
  • разобраться, почему агент не подключается к Qdrant Cloud
  • настроить внешний доступ и API-ключ к кластеру
  • проверить поддержку CSI-снимков для резервных копий

Примеры запросов агенту

  • Помоги развернуть Qdrant Hybrid Cloud в моём Kubernetes-кластере.
  • Агент Hybrid Cloud зависает при установке — проверь хранилище и сетевое подключение.
  • Как открыть доступ к кластеру Qdrant через Ingress и настроить API-ключ?

Как установить qdrant-hybrid-cloud-setup

1Через Skills CLI (Vercel)

npx skills add qdrant/skills --skill qdrant-hybrid-cloud-setup -a claude-code

2Вручную: положить файлы

~/.claude/skills/qdrant-hybrid-cloud-setup/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/qdrant-hybrid-cloud-setup/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о qdrant-hybrid-cloud-setup

Как установить qdrant-hybrid-cloud-setup в Claude Code?

Выполни npx skills add qdrant/skills --skill qdrant-hybrid-cloud-setup -a claude-code. Файл скилла: ~/.claude/skills/qdrant-hybrid-cloud-setup/SKILL.md.

Что делает qdrant-hybrid-cloud-setup?

Скилл сопровождает установку Qdrant Hybrid Cloud в собственном Kubernetes-кластере: помогает настроить хранилище, агент и оператор, создать кластер и организовать внешний доступ.

Что нужно для работы qdrant-hybrid-cloud-setup?

Нужен Kubernetes-кластер с CSI-драйвером блочного хранилища, права cluster-admin, настроенные kubectl и helm. Агенту нужен исходящий доступ к grpc.cloud.qdrant.io и api.cloud.qdrant.io по порту 443.

Исходный текст

SKILL.md · Apache-2.0
---
name: qdrant-hybrid-cloud-setup
description: "Setting up and running Qdrant Hybrid Cloud on your own Kubernetes cluster (managed, on-prem, or edge): prerequisites, storage/CSI and backups, installing the Qdrant Cloud agent and operator, creating/exposing/securing clusters, registry mirroring, and secret rotation. Use when someone wants to set up, install, deploy, or configure Hybrid Cloud on their own infrastructure; is running Qdrant on their own EKS, GKE, AKS, OpenShift, or other Kubernetes; asks about the agent or operator, a storage class or volume snapshots for Hybrid Cloud, exposing a cluster, mirroring Qdrant images, or rotating secrets; or when a Hybrid Cloud install is failing on storage or connectivity."
---

# Setting Up Qdrant Hybrid Cloud

You've already chosen Hybrid Cloud (managed control plane on your own infra). If you're still deciding, that's the `qdrant-deployment-options` skill. Most setup failures trace to one of two things: **storage** (the CSI driver can't do what Qdrant needs) or **connectivity** (the agent can't reach Qdrant Cloud). Diagnose which before touching anything else.

## Preparing the Kubernetes cluster (do this first)

Use when: about to create the environment, or the install/cluster provisioning failed on storage.

- Qdrant needs a block-storage CSI driver. Network storage (NFS) and object storage (S3) are unsupported: a cluster wired to those will fail, not degrade [Prerequisites](https://skills.qdrant.tech/md/documentation/hybrid-cloud/hybrid-cloud-setup/).
- Create the `StorageClass` (with `allowVolumeExpansion: true`) and the `VolumeSnapshotClass` *beforehand*, not after. Without volume expansion you can't grow disk later; without a `VolumeSnapshotClass` and the CSI snapshot controller you can't take backups.
- Any standards-compliant Kubernetes works; check the [Deployment Platforms](https://skills.qdrant.tech/md/documentation/hybrid-cloud/platform-deployment-options/) page for your managed provider's setup guidance.
- Platform matters for what storage supports: some (e.g. Linode/LKE, Vultr) don't support CSI volume snapshots at all, so backups are unavailable there. Check your provider's snapshot page and prefer its recommended instance and disk types (e.g. gp3 on EKS, Premium SSD v2 on AKS) before committing.
- Confirm outbound connectivity: the agent opens connections to `grpc.cloud.qdrant.io` and `api.cloud.qdrant.io` on 443. Firewalls/egress proxies block this silently: a "stuck installing" agent is usually this.
- You need `cluster-admin` plus `kubectl` and `helm` configured against the target cluster.

## Creating the environment

Use when: running the install wizard in the Cloud Console.

- The **Kubernetes namespace is permanent**: it's the one choice you can't change later. Everything else (node selectors, tolerations, registry URLs, proxy) is editable after creation, so don't over-think them now.
- The wizard's install command is for the initial install only; update the agent and operator from the Console afterward [Generate installation command](https://skills.qdrant.tech/md/documentation/hybrid-cloud/hybrid-cloud-setup/?s=generate-installation-command).
- Advanced operator behavior (pod scheduling, security context, ingress, networking, and snapshot management) is tuned in the operator configuration at the environment level, and can be changed after install [Operator configuration](https://skills.qdrant.tech/md/documentation/hybrid-cloud/operator-configuration/).
- Air-gapped or registry-restricted? Mirror the `/qdrant/` images and `/qdrant-charts/` charts into your own registry and set the container + chart URLs in the environment's advanced section. Sync *all* architectures (or the right one) or ARM/x86 nodes will fail to pull.

## Creating a cluster in the environment

Use when: the environment exists and you're provisioning a database.

- Pick the Database Storage Class and Volume Snapshot Class here. Setting Volume Snapshot Class to `None` disables backups; `emptyDir` for the snapshot volume makes it ephemeral (lost on pod restart): deliberate choices, not defaults to accept blindly [Cluster creation](https://skills.qdrant.tech/md/documentation/hybrid-cloud/hybrid-cloud-cluster-creation/).
- By default Qdrant Cloud reserves ~20% CPU/memory per pod for the OS and system components. Small nodes may need more reserved; large nodes less. Aim for one database pod per node.
- Use node selectors / tolerations / topology spread constraints to keep databases on dedicated nodes and spread across zones.

## Exposing and securing a cluster

Use when: apps outside the Kubernetes cluster need to reach Qdrant, or asked about API keys/TLS.

- Default is a `ClusterIP` service: internal-only, **no API key**. The moment you expose it (LoadBalancer, NodePort, or Ingress) you MUST configure an API key, supplied as a Kubernetes secret referenced in the cluster config [Authentication](https://skills.qdrant.tech/md/documentation/hybrid-cloud/hybrid-cloud-cluster-creation/?s=authentication-to-your-qdrant-clusters).
- Internal node-to-node gRPC uses port 6335 and is never protected by API key or TLS. It must never be publicly reachable; Hybrid Cloud ships a NetworkPolicy restricting it, so don't loosen that.
- TLS: offload at the ingress/LB, or terminate in Qdrant via a TLS secret. Don't do both by accident.

## Logging

Use when: setting log levels or wiring cluster logs into your stack. (For metrics/Prometheus/Grafana, use the `qdrant-monitoring` skill instead.)

- Log levels are set in two different places: per-database in the Cluster detail page, but for the **Agent and Operator** in the Hybrid Cloud Environment config, not per-cluster [Networking, Logging & Monitoring](https://skills.qdrant.tech/md/documentation/hybrid-cloud/networking-logging-monitoring/).
- Logs are plain pod logs with no Qdrant-specific format. Point any Kubernetes-aware log collector at all pods in the Qdrant namespace; nothing Qdrant-specific to configure.

## What NOT to Do

- Provision on NFS, S3, or any non-block storage: it's unsupported and will fail outright, not just run slowly.
- Create the `StorageClass`/`VolumeSnapshotClass` (or enable `allowVolumeExpansion`) after the fact, then discover you can't scale disk or take backups. They must exist beforehand.
- Assume backups "just work" on Linode or Vultr: verify CSI snapshot support for your platform first.
- Expose a cluster via LoadBalancer/Ingress without setting an API key, or leave port 6335 publicly reachable.
- Regenerate the install command (or rotate secrets) and forget to reapply it: the agent-to-Cloud link breaks silently until you do.
- Delete a Hybrid Cloud environment before deleting its clusters: tear down clusters first, then the environment, then run the cleanup script, or you'll strand resources in the cluster.

© qdrant · Apache-2.0 · qdrant/skills

Похожие скиллы

Все скиллы по теме «Облака: AWS, Azure, GCP» →
google-cloud-solution-hybrid-search-alloydb официальный google Скилл google-cloud-solution-hybrid-search-alloydb помогает спроектировать и проверить гибридный поиск на AlloyDB: семантический поиск сочетается с ключевыми словами и SQL-фильтрами. CX Codex +1 3 300установок hybrid-cloud-architect sickn33 Скилл hybrid-cloud-architect для Claude Code проектирует гибридную инфраструктуру с AWS, Azure, GCP и частными облаками. Разбирает сети, миграции, Kubernetes и аварийное восстановление. CX Codex +1 1установок google-cloud-solution-rag-enterprise-search-gke-sqldb официальный google Скилл google-cloud-solution-rag-enterprise-search-gke-sqldb для Claude Code проектирует RAG-поиск по корпоративным данным в Google Cloud. CX Codex +1 5 000установок domain-cloud-native actionbook Скилл domain-cloud-native задаёт правила разработки облачных микросервисов на Rust: от сигналов завершения работы до проверок готовности в Kubernetes. CX Codex +1 3 200установок sap-btp-cloud-platform secondsky Скилл sap-btp-cloud-platform для Claude Code — справочник по SAP BTP: аккаунты, Cloud Foundry, Kyma, ABAP Environment, MTA и подключения к локальным системам. CX Codex +1 825установок huawei-cloud-cce-cluster-management huaweicloud Скилл huawei-cloud-cce-cluster-management для Claude Code управляет кластерами Huawei Cloud CCE, узлами, пулами и аддонами. Выполняет повседневные операции с инфраструктурой Kubernetes. CX Codex +1 293установок

Из того же набора12

Весь набор →
qdrant-version-upgrade Скилл qdrant-version-upgrade для Claude Code помогает спланировать обновление Qdrant и SDK с учётом совместимости версий. Он разбирает переходы между версиями, порядок действий и изменения после обновления. CX Codex +1 1 400установок qdrant-performance-optimization Скилл qdrant-performance-optimization для Claude Code сопоставляет симптомы при настройке Qdrant с под-скиллами по скорости поиска, индексации и памяти. CX Codex +1 1 700установок qdrant-advisor Скилл qdrant-advisor подтягивает официальные инструкции из skills.qdrant.tech для решения сбоев кластера, утечек памяти и замедления индексов Qdrant. CX Codex +1 782установок qdrant-edge Помогает разрабатывать приложения на Qdrant Edge. Разбирает синхронизацию локального шарда, поиск BM25 и обслуживание индексов. CX Codex +1 328установок qdrant-multitenancy Скилл qdrant-multitenancy для Claude Code, Codex и Cursor. Направляет выбор архитектуры изоляции данных нескольких клиентов в векторной базе Qdrant. CX Codex +1 298установок qdrant-sizing Скилл qdrant-sizing рассчитывает оперативную память, диск, процессоры и число узлов кластера Qdrant под заданный объём векторов и требования к задержкам. CX Codex +1 222установок qdrant-migration-tool Скилл qdrant-migration-tool для Claude Code переносит векторные данные и метаданные в Qdrant из других баз данных. Инструмент управляет процессом миграции, включая возобновление прерванных операций. CX Codex +1 137установок qdrant-skills Набор скиллов помогает агенту принимать решения по векторному поиску Qdrant: от масштабирования и качества выдачи до миграции моделей. ★ 271звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой