Le but : piloter le kit avec une seule commande, sans retenir les commandes gcloud ni Terraform. Chaque brique
s'active ou se désactive dans le fichier config/*.env, puis ./ragkit deploy applique seulement la différence.
ragkit n'a besoin que de Python 3 (bibliothèque standard). Il s'appuie sur scripts/config.sh, Terraform et les
scripts existants : rien n'est caché, chaque commande lance ce que décrivent les docs 03-x.
Testé en vrai le 14/10/2026 :
status,briques,activer/desactiver/set(sur une copie de la configuration),deploy --plan(désactiverplanif+push→0 to add, 2 to change, 3 to destroy: la planification, le servicerag-kit-hooket son droit public),deploy,sync,logs job,test(TOUT EST OK).
1. Les commandes
| Commande | Effet |
|---|---|
./ragkit status | Configuration, briques actives, URL déployée, corpus, adresse push, dernière synchro et ses alertes |
./ragkit briques | Les briques activables et leur état |
./ragkit activer <brique> / desactiver <brique> | Modifie la variable dans le .env (garde le commentaire) |
./ragkit set VAR valeur | Change n'importe quelle valeur du .env (MODEL, SYNC_SCHEDULE, USERS…) |
./ragkit deploy [--plan] [--shell] | Terraform apply (ou plan), ou le script gcloud |
./ragkit ouvrir | Ouvre l'interface sur http://localhost:8080 |
./ragkit sync | Lance une synchro, attend la fin, affiche le rapport |
./ragkit logs [job|web|hook] | Derniers journaux (pour le job : rapports de passe et erreurs seulement) |
./ragkit google <client.json> | Configure la connexion Google (04-bis) |
./ragkit test [URL] [question attendu] | Test de bout en bout (interface ouverte) |
./ragkit detruire [--shell] | Supprime tout (Terraform demande yes, le script oui) |
Autre configuration : ./ragkit -c config/prod.env status (ou export RAGKIT_CONFIG=config/prod.env).
2. Les briques
| Brique | Variable | Activée | Désactivée |
|---|---|---|---|
push | PUSH | Service public rag-kit-hook + canaux Drive : synchro en secondes | Plus de service public ; synchro planifiée et bouton seulement |
layout | LAYOUT_PARSER | Document AI lit tableaux et titres des PDF (payant) | Parsing simple, gratuit ; tout est réindexé à la passe suivante |
planif | SYNC_SCHEDULE | Passe toutes les 5 min (filet de sécurité) | Push et bouton seulement |
Exemple, un kit sans service public et synchro toutes les 2 min :
./ragkit desactiver push
./ragkit set SYNC_SCHEDULE "*/2 * * * *"
./ragkit deploy --plan # lire le plan
./ragkit deployAjouter une brique (pour un mainteneur) : une ligne dans le dictionnaire BRIQUES de ragkit, la variable dans
config/*.env, scripts/config.sh (TF_VAR_…), terraform/variables.tf (+ count sur les ressources concernées)
et scripts/deployer_shell.sh.