Azure Marketplace

Si votre organisation utilise Azure Kubernetes Service (AKS), vous pouvez déployer Scrydon directement depuis Azure Marketplace. L'offre installe Scrydon comme extension de cluster AKS. Vous n'avez besoin ni du CLI Helm ni d'identifiants de registre.

Prérequis

• Un cluster AKS exécutant Kubernetes 1.28 ou ultérieur.
• cert-manager, pour les certificats TLS automatiques, avec sa prise en charge de la Gateway API activée (config.enableGatewayAPI: true). Consultez les prérequis TLS.
• Un accès à votre zone DNS, pour créer un enregistrement A ou CNAME.

Vous n'avez besoin ni de l'add-on AGIC ni d'aucun autre contrôleur d'ingress. La périphérie de Scrydon repose sur la Gateway API de Kubernetes, et l'offre installe son propre contrôleur : Traefik, avec les CRD de la Gateway API et la GatewayClass traefik. Le Service LoadBalancer de Traefik fournit l'IP publique.

Étape 1 : déployer depuis le portail Azure

1. Trouvez Scrydon dans Azure Marketplace et choisissez Deploy.

2. Renseignez l'assistant :

   Champ	Ce qu'il faut saisir
   AKS cluster	Le cluster cible.
   Domain	Le nom d'hôte unique qui sert Scrydon, par exemple scrydon.example.com. Chaque application est un chemin sous ce nom.
   Enable TLS	Laissez activé pour obtenir des certificats HTTPS automatiques de cert-manager.
   Enable analytics	Active le module analytics.
   Database password	Pour l'instance PostgreSQL intégrée.
   Auth secret	Signe les sessions utilisateur. Utilisez une valeur aléatoire d'au moins 32 caractères, par exemple openssl rand -hex 32.

3. Choisissez Create.

L'extension crée tous les services Scrydon dans le namespace scrydon-platform. Elle installe aussi l'extension de cluster Dapr dont Scrydon dépend. Toutes les images sont fournies avec l'extension : AKS les tire sans votre jeton de registre.

Plan de données sur Azure. En mode Azure, le chart désactive StarRocks et SeaweedFS intégrés, car leurs images tierces ne sont pas incluses dans le package Marketplace. À la place :

• Stockage objet. Après la configuration, pointez la plateforme vers Azure Blob via son API compatible S3, sur https://<domain>/platform/settings/platform/storage.
• Tables gérées. Désactivez Tables (apiTable.enabled: false) ou pointez apiTable.starrocks.host vers un StarRocks que vous exploitez vous-même, par exemple avec l'opérateur StarRocks. Ce sont deux valeurs Helm que l'assistant n'affiche pas ; consultez Toutes les options.

Étape 2 : pointer le DNS vers le cluster

Un seul enregistrement couvre toute la plateforme. Chaque application est un chemin sous votre domaine :

Les chemins qu'il sert sont /platform, /agentic, /cortex, /analytics, /horizon, /api/auth, /api/ontology, /api/table et les autres listés dans les prérequis DNS.

Pour trouver l'IP :

kubectl get svc -n traefik scrydon-traefik \
  -o jsonpath='{.status.loadBalancer.ingress[0].ip}'

Étape 3 : terminer la configuration

Une fois tous les pods démarrés et l'enregistrement résolu, ouvrez :

https://<domain>/platform/setup

La première étape de l'assistant demande votre fichier de licence. Il crée ensuite le premier administrateur et votre organisation, puis configure éventuellement le stockage et l'e-mail. Licences détaille chaque étape.

Toutes les options

L'assistant couvre les réglages courants. En dessous, c'est le même chart Helm que pour toute autre installation : toutes les valeurs de la référence Helm existent, qu'il s'agisse d'une base de données externe, de l'ordonnancement, du routage par sous-domaine ou du reste. L'assistant Marketplace ne peut pas les définir. Si vous en avez besoin, déployez plutôt avec Helm sur AKS, où vous maîtrisez tout le fichier de valeurs.

Mises à niveau

L'extension est installée avec les mises à niveau mineures automatiques. Les nouvelles versions majeures sont publiées comme nouvelles versions Marketplace, et le portail Azure vous signale leur disponibilité.

Dépannage

Pods bloqués en ImagePullBackOff

L'extension fournit toutes les images ; un échec de téléchargement vient donc généralement de l'extension elle-même ou du réseau :

• Vérifiez que l'extension est installée : az k8s-extension show --name scrydon --cluster-name <aks> --resource-group <rg> --cluster-type managedClusters.
• Recherchez des network policies ou des règles de pare-feu qui bloquent le registre.

Certificats TLS non émis

• Vérifiez que cert-manager tourne : kubectl get pods -n cert-manager.
• Vérifiez que sa prise en charge de la Gateway API est activée. Sans config.enableGatewayAPI: true, il ne crée jamais de Certificate à partir de la Gateway.
• Vérifiez le certificat : kubectl get certificates -n scrydon-platform.

Page de configuration inaccessible

• Vérifiez que l'enregistrement pointe vers l'IP de Traefik : nslookup <domain>.
• Vérifiez les pods : kubectl get pods -n scrydon-platform.
• Vérifiez que la GatewayClass est acceptée : kubectl get gatewayclass traefik.
• Vérifiez que la Gateway est programmée : kubectl get gateway -n scrydon-platform, puis kubectl get httproute -A. Un listener bloqué sur Accepted=False avec la raison PortUnavailable signifie que gateway.listenerPorts ne correspond pas aux points d'entrée de Traefik, qui écoutent sur 8000 et 8443, et non sur 80 et 443.