Tovább a tartalomhoz

Kubernetes

Mire való. A Kubernetes a harmadik telepítési út: Helm chart valódi clusterre. PVC-s data/, Ingress, probe-ok, Secret objektumok. A deploy/k8s/ tetején lévő nyers YAML legacy starter — élesben a Helm deploy/k8s/helm/eyas/.

Lásd deploy/k8s/README.md és a chart.

  • Több replica vagy megosztott cluster (két író soha egy SQLite fájlon — több példány).
  • Van Ingress + StorageClass.
  • A titkok Kubernetes Secretből vagy External Secrets Operatorból jönnek.
  1. Kubernetes 1.28+, Helm 3.12+, elérhető image, Ingress controller, StorageClass.
  2. kubectl create namespace eyas. Master key Secret (eyas-master-key / master-key) a helm install előtt.
  3. Pull-secret privát registryhez. image.pullSecrets a valuesben.
  4. helm install a charttal (image, EYAS_PORT, PVC, Ingress).
  5. Probe: /api/v1/health (vagy /web/health). Ingress host.

Tipikus values: image, EYAS_PORT, PVC, secret, Ingress, probe /api/v1/health vagy /web/health. A felhő-szolgáltató StorageClass-neve és load-balancer annotációi a saját values fájlba tartoznak. A master key jelszókezelőben maradjon — elvesztése a secrets vaultot viszi.

Adatkönyvtár a volume-on. A chart alapértelmezett csatolásával (/app/data) semmit nem kell beállítani: az adatbázis és a memória-vault a perzisztens volume-on van. Ha az EYAS_DATA_DIR-t egy másik csatolásra irányítod, a vault is odaköltözik — mindig <data dir>/vault —, az adatbázissal együtt. Lásd Konfiguráció — Adatkönyvtár és vault.

Kernel fájl-sandbox. Az EYAS image nem tartalmazza a bubblewrapot (LGPL licencű; a telepítése az üzemeltető döntése). A CLI providerek kernel fájl-sandboxához a konténerben kell a bubblewrap (bwrap), a Claude Code-hoz a socat, valamint nem privilegizált user namespace-ek — ezeket sok klaszter és konténer-runtime kikapcsolja. Nélkülük az EYAS továbbra is elutasít minden kérést, amelyet lát, és a sandboxot Ezen a szerveren nem érhető el állapotban mutatja; security.cliSandbox: required mellett a tooloket használó CLI-körök elutasításra kerülnek. Az eyas doctor a CLI sandbox sorában jelenti. Lásd Providerek — Kernel fájl-sandbox.

Memória-tartalék nagy importhoz. A chart alap limitje 1Gi, ami elég egy data-port importhoz: egy konténerfájl a memóriában marad, amíg a benne lévő összes egység renderelődik, és hogy ez mennyibe kerül, az a fájltól függ — a fordulónként egy soros átiratnál a méretének nagyjából háromszorosa, az egyben elemzett chat exportnál hétszerese vagy több. Egy 90 MB-os chat export csúcsa 900 MiB rezidens memória közelében van: még belefér az 1Gi-be, de nem sokkal; a deploy/k8s/ tetején lévő régi starter YAML 512Mi-t állít, és ezt nem bírja el. A csúcsot a legnagyobb egyedi fájlod adja, nem a scan mérete, ezért ennél nagyobb előtt emeld meg a limitet. Lásd: Adatimport és -export.