Déployer AKKO sur OVHcloud MKS¶

OVHcloud MKS est la cible supportée pour les déploiements production hébergés chez OVH. AKKO tourne aussi sur des VM OVH nues avec K3s — voir helm/examples/values-ovh.yaml dans ce cas.

Prérequis¶

Élément	Version
OVHcloud MKS	1.30+ (3 nœuds, flavor B2-15 minimum)
StorageClass	`csi-cinder-high-speed` (par défaut, RWO)
Ingress	nginx-ingress (add-on OVH) ou Traefik
Helm	≥ 3.14
DNS	domaine public pointant vers le LoadBalancer OVH

Installation en une commande¶

AKKO_DOMAIN=akko.client.example \
AKKO_VERSION=2026.04 \
AKKO_VALUES_EXTRA=helm/examples/values-ovhcloud.yaml \
  bash deploy-from-harbor.sh

values-ovhcloud.yaml positionne :

global.storageClass: csi-cinder-high-speed (RWO)
Type LoadBalancer pour ingress-nginx avec annotations service.beta.kubernetes.io/ovh-* spécifiques
PVC akko-docs → RWO avec init-container de copie
VictoriaMetrics + logs layer activés (stack Apache 2.0, ADR-020)
directory service désactivé (GPL v3)

Spécificités OVHcloud¶

Stockage¶

OVHcloud MKS livre csi-cinder-high-speed (RWO, SSD). Le RWX nécessite l'add-on optionnel ovh-managed-nfs — non requis par AKKO 2026.04 (tous les PVC sont RWO).

LoadBalancer¶

Les LoadBalancers OVH sont facturés à l'heure. Le premier provisioning prend 2 à 3 minutes. Annotations déjà intégrées dans l'overlay :

service.beta.kubernetes.io/ovh-loadbalancer-proxy-protocol: "v2"

Registry privée (optionnelle)¶

OVH propose un OVHcloud Container Registry managé compatible Docker Registry API. Pour miroir les images AKKO :

for img in cockpit postgres spark notebook trino ai-service mlflow \
           airflow dbt mcp-trino mcp-openmetadata docs aden \
           catalog-manager; do
  skopeo copy \
    docker://harbor.akko-ai.com/akko/akko-${img}:2026.04 \
    docker://<votre-ovhcloud-registry>/akko/akko-${img}:2026.04
done

Puis surchargez global.image.registry: <votre-ovhcloud-registry>.

Résidence des données UE¶

OVHcloud MKS tourne dans des régions sous juridiction française / UE (GRA, SBG, RBX, DE1). Combiné à la stack souveraine d'AKKO (aucune télémétrie hors cluster, LLMs locaux via Ollama, tous les composants AGPL remplacés par de l'Apache 2.0), cela livre une garantie de résidence adaptée aux industries régulées. AKKO n'appelle aucune API tierce à l'exécution.

Vérifier l'installation¶

kubectl -n akko get pods
kubectl -n akko get ingress
kubectl -n akko exec svc/akko-trino -c trino -- trino --execute "SHOW CATALOGS"

Dépannage¶

Symptôme	Cause	Correctif
LoadBalancer `<pending>`	Quota IP publique à zéro	Ouvrir un ticket support OVHcloud
PVC `Pending` avec erreur `ReadWriteMany`	Overlay non appliqué	Vérifier que `-f values-ovhcloud.yaml` est bien passé
Pods en CrashLoopBackOff sur nœuds ARM	OVHcloud propose des SKUs ARM ; les images AKKO sont majoritairement multi-arch, vérifier les manifests	`docker manifest inspect harbor.akko-ai.com/akko/akko-<svc>:2026.04`
TLS `x509: certificate signed by unknown authority`	cert-manager Let's Encrypt pas prêt	`kubectl describe certificate -n akko`