Aller au contenu principal

H-06 Plateforme Kubernetes

Brique H de la plateforme Enterprise AI. Technologie : Kubernetes (upstream, OpenShift, EKS, AKS, GKE, RKE2, K3s) avec un namespace par domaine, chart Helm deploy/helm/enterprise-ai. Version anglaise : ../../en/bricks/H-06-kubernetes.md.

Rôle et responsabilités​

  • Exécuter chaque composant avec namespaces (eai-system, eai-data, eai-security, eai-inference, eai-sandbox, observability), PDB, limites de ressources, sondes.

Position et interactions​

  • Chemin d'exécution : socle de déploiement.
  • Les sondes utilisent /healthz et /readyz ; les nœuds GPU sont labellisés et teintés pour l'inférence et les workers média.

Part open source et part développée​

  • Open source réutilisé : Kubernetes, Helm, NVIDIA GPU operator.
  • Développé dans la plateforme : Chart Helm, valeurs par profil (values-prod.yaml, values-onprem-gpu.yaml).

Modèle de données​

Pas de table dédiée : l'état vit dans les objets Kubernetes, Git et le stockage propre de l'outil ; les actions passant par l'API sont auditées dans eai.audit_events par le Control Plane.

Contrat : contracts/v1/model-manifest.schema.json (schema_version 1.0). L'usage est toujours remonté avec contracts/v1/usage-event.schema.json, l'audit avec contracts/v1/audit-event.schema.json.

Endpoints d'API​

MéthodeChemin
GET/readyz
GET/v1/meta
GET/v1/catalog/bricks/{id}

GET /readyz​

Réponse :

{
  "status": "ready",
  "checks": {
    "postgres": "ok",
    "redis": "ok",
    "clickhouse": "ok"
  }
}

GET /v1/meta​

Réponse :

{
  "version": "1.0.0",
  "features": [
    "finops",
    "multimodal"
  ],
  "locales": [
    "en",
    "fr"
  ]
}

GET /v1/catalog/bricks/{id}​

Réponse :

{
  "id": "H-06",
  "name": "Kubernetes",
  "status": "implemented"
}

Exemples SDK​

Python​

from enterprise_ai import EnterpriseAI

client = EnterpriseAI(base_url="<control-plane-url>", api_key="eai_live_xxx", tenant="acme", locale="fr")
client.system.readyz()
client.system.meta()
client.system.brick(brick_id="H-06")

TypeScript​

import { EnterpriseAI } from "@enterprise-ai/sdk";

const client = new EnterpriseAI({ baseUrl: "<control-plane-url>", apiKey: process.env.EAI_API_KEY, tenant: "acme", locale: "fr" });
await client.meta.ready();
await client.meta.get();
await client.catalog.getBrick({ brickId: "H-06" });

Java​

EnterpriseAIClient client = EnterpriseAIClient.builder()
    .baseUrl("<control-plane-url>")
    .apiKey(System.getenv("EAI_API_KEY"))
    .tenant("acme")
    .locale(Locale.FRENCH)
    .build();
client.meta().ready();
client.meta().get();
client.catalog().brick("H-06");

Go​

client, err := eai.NewClient(eai.WithBaseURL("<control-plane-url>"), eai.WithAPIKey(os.Getenv("EAI_API_KEY")), eai.WithTenant("acme"), eai.WithLocale("fr"))
if err != nil { log.Fatal(err) }
ctx := context.Background()
_, err = client.Meta.Ready(ctx, nil)
_, err = client.Meta.Get(ctx, nil)
_, err = client.Catalog.Brick(ctx, "H-06")

Configuration​

Variables d'environnement : EAI_ENV.

Clés de valeurs Helm (deploy/helm/enterprise-ai/values.yaml) : global.namespaces, controlPlane.pdb, controlPlane.resources, sandbox.runtimeClasses.

Sécurité​

  • Pod Security restricted, non root, système de fichiers racine en lecture seule, gVisor/Kata pour le sandbox.
  • Tenant déduit de l'identifiant d'accès, jamais du corps ; sécurité au niveau des lignes PostgreSQL sur chaque table de tenant.
  • Chaque mutation et décision de politique écrit un événement d'audit chaîné par hachage (G-11).
  • Les erreurs utilisent l'enveloppe standard avec message_i18n en et fr.

Observabilité​

  • kube-state-metrics, événements exportés vers OpenSearch.
  • traceparent W3C propagé, X-Request-Id renvoyé, les spans portent eai.tenant_id, eai.project, eai.agent_id, eai.run_id.

Unités FinOps​

  • Le namespace et les labels tenantLabel/owner pilotent l'imputation du coût d'infrastructure.

Modes de défaillance et résilience​

  • Perte de nœud -> PDB et anti-affinité gardent au moins un réplica par service.

Adoption autonome​

Chaque composant peut être installé seul en désactivant les autres dans les valeurs.

Tests d'acceptation​

  1. helm template avec chaque profil de valeurs se rend et passe kubeconform.
  2. Drainer un nœud garde /readyz au vert.

Feuille de route d'implémentation