La CLI mistral-vespa gère le cycle de vie des applications Vespa — de la génération des migrations au déploiement et aux tests.
Exécutez uv run mistral-vespa --help pour la liste complète des commandes et options disponibles.
generate-migrationgenerate-migration
Crée un squelette de migration horodaté.
uv run mistral-vespa generate-migration <name> [--app-dir <path>]| Argument/Option | Valeur par défaut | Description |
|---|---|---|
name | requis | Nom de la migration, utilisé pour le nom de fichier et la classe |
--app-dir | ./vespa_app | Répertoire racine de l'application Vespa |
migratemigrate
Construit l'application à partir des migrations et la déploie. Prend en charge les déploiements en mode single-node (localhost) et Kubernetes.
uv run mistral-vespa migrate [--app-dir <path>] [options]| Option | Valeur par défaut | Description |
|---|---|---|
--app-dir | ./vespa_app | Répertoire racine de l'application Vespa |
--dry-run | false | Prévisualiser les modifications sans les appliquer |
--config-server | auto | URL du serveur de configuration (hôte). Par défaut : http://localhost:19071 pour local, ou URL du service in-cluster pour K8s |
--query-port | 8080 | Port de requête côté hôte à sonder après le déploiement |
Options Kubernetes :
| Option | Valeur par défaut | Description |
|---|---|---|
--k8s-namespace | — | Namespace Kubernetes (requis avec --k8s-instance) |
--k8s-instance | — | Instance Kubernetes (requis avec --k8s-namespace) |
--k8s-context | — | Context Kubernetes. Nécessite --k8s-namespace, --k8s-instance et --config-server |
Exemples :
# Docker local
uv run mistral-vespa migrate --config-server http://localhost:19071
# Kubernetes (in-cluster, par exemple CI)
uv run mistral-vespa migrate \
--k8s-namespace my-project \
--k8s-instance vespa
# Kubernetes (poste de travail, avec kubectl port-forward)
uv run mistral-vespa migrate \
--k8s-namespace my-project \
--k8s-instance vespa \
--k8s-context staging \
--config-server http://localhost:19071generategenerate
Écrit les fichiers du package applicatif sur le disque à partir des migrations (pour inspection ou validation CI). Non utilisé pour le déploiement.
uv run mistral-vespa generate --path <output-dir> [--app-dir <path>]| Option | Valeur par défaut | Description |
|---|---|---|
--path | requis | Répertoire où écrire les fichiers du package applicatif |
--app-dir | ./vespa_app | Répertoire racine de l'application Vespa |
Structure de sortie :
<output-dir>/
├── schemas/
│ └── <document_type>.sd
└── search/
└── query-profiles/
├── <query_profile_name>.xml
└── types/root.xmlbrunobruno
Génère des fichiers de test API Bruno à partir des migrations.
uv run mistral-vespa bruno --query-url <url> --document-url <url> [--app-dir <path>]| Option | Valeur par défaut | Description |
|---|---|---|
--query-url | requis | URL de l'endpoint de requête Vespa |
--document-url | requis | URL de l'endpoint document/feed Vespa |
--app-dir | ./vespa_app | Répertoire racine de l'application Vespa |
local uplocal up
Lance un conteneur Vespa local via Docker.
uv run mistral-vespa local up [--query-port <port>] [--config-port <port>] [--name <name>]| Option | Valeur par défaut | Description |
|---|---|---|
--query-port | 8080 | Port hôte mappé pour les requêtes Vespa |
--config-port | 19071 | Port hôte mappé pour le serveur de configuration Vespa |
--name | vespa | Nom du conteneur Docker |
local downlocal down
Arrête le conteneur Vespa local et supprime les volumes.
uv run mistral-vespa local down [--name <name>]local statuslocal status
Vérifie si le conteneur Vespa local est en cours d'exécution.
uv run mistral-vespa local status [--name <name>]