03-1. Déployer avec le **script shell** (gcloud)

Le but : tout créer avec gcloud seul, sans Terraform, en une commande relançable.

Les autres méthodes, même résultat : 03-2 Terraform · 03-3 Console.

Ne mélangez pas les méthodes sur un même PREFIX : Terraform ne connaît pas ce que crée le script, et inversement. Pour essayer les deux dans un projet, utilisez deux préfixes (config/test.env : rag-kit, config/test-shell.env : rag-sh).

Testé en vrai le 14/10/2026 sur main-project-511608 avec config/test-shell.env (préfixe rag-sh, LAYOUT_PARSER=false) : déploiement depuis zéro (5 min 09), relance (1 min 50, image réutilisée), test_e2e.py (TOUT EST OK), supprimer_shell.sh. Sorties réelles ci-dessous.

1. Ce que fait le script, étape par étape

scripts/deployer_shell.sh — 12 étapes, chacune vérifie ce qui existe avant d'agir :

Étape	Commande principale	Si ça existe déjà
1. API	`gcloud services enable …` (16 API, dont `cloudresourcemanager`)	Sans effet
2. Comptes	`gcloud iam service-accounts create` ×3	Ignoré
3. Droits projet	`gcloud projects add-iam-policy-binding`	Sans effet
4. Bucket	`gcloud storage buckets create` + `config.json` (dossiers de `DRIVE_FOLDERS`)	`config.json` existant gardé
5. Corpus	API REST `ragCorpora` (pas de commande gcloud pour RAG Engine)	Retrouvé par son nom
6. Agent RAG	droits sur le bucket	Sans effet
7. Layout parser	API REST Document AI (`eu`)	Retrouvé par son nom
8. Image	`gcloud builds submit` (étiquette = hachage du code)	Pas reconstruite si le code n'a pas changé
9. Job	`gcloud run jobs deploy` + droits	Mis à jour
10. Planification	`gcloud scheduler jobs create/update http`	Mise à jour
11. Service	`gcloud run deploy --no-allow-unauthenticated --max-instances=1`	Nouvelle révision
12. Accès	`gcloud run services add-iam-policy-binding` pour chaque `USERS`	Sans effet

2. Pas à pas

cd gcp_rag/01-rag-engine-sync
source scripts/config.sh config/test-shell.env
bash scripts/deployer_shell.sh

Fin obtenue :

== 1/12 API
== 2/12 Comptes de service
== 3/12 Droits sur le projet
   rag-sh-sa@main-project-511608.iam.gserviceaccount.com et rag-sh-build-sa@main-project-511608.iam.gserviceaccount.com : rôles en place
== 4/12 Bucket gs://main-project-511608-rag-sh
== 5/12 Corpus RAG « rag-sh »
   projects/main-project-511608/locations/europe-west4/ragCorpora/2882303761517117440
== 6/12 Agent de service RAG sur le bucket
   service-100000000005@gcp-sa-vertex-rag.iam.gserviceaccount.com : lecture + écriture des rapports
== 7/12 Layout parser (Document AI, eu)
   (désactivé)
== 8/12 Image (Cloud Build)
   nouvel essai dans 40 s
== 9/12 Job de synchro « rag-sh-sync »
== 10/12 Planification « */10 * * * * »
   OK
== 11/12 Service « rag-sh » (privé)
== 12/12 Accès à l'interface
   user:noreply.syctra@gmail.com

== Terminé.
   Partagez chaque dossier Drive (Lecteur) avec :
     rag-sh-sa@main-project-511608.iam.gserviceaccount.com
     service-100000000005@gcp-sa-vertex-rag.iam.gserviceaccount.com
   Ouvrir l'interface :
     gcloud run services proxy rag-sh --region=europe-west4 --project=main-project-511608 --port=8080   puis http://localhost:8080

Durée : 5 min 09 depuis zéro (« nouvel essai dans 40 s » à l'étape 8 = le compte de construction tout neuf n'avait pas encore ses droits : normal, le script réessaie). Relance sans changement : 1 min 50, image réutilisée (« …/rag-sh/app:73a849db53c4 existe déjà (code inchangé) »).

Puis, comme pour Terraform : partager le dossier Drive avec les 2 adresses affichées (04), bash scripts/ouvrir_interface.sh, Synchroniser maintenant.

3. Tester

PORT=8081 bash scripts/ouvrir_interface.sh &          # proxy en arrière-plan
python3 scripts/test_e2e.py http://localhost:8081 "Quelle est l'indemnité mensuelle de télétravail ?" "47"

[1] l'API répond
    OK  corpus projects/main-project-511608/locations/europe-west4/ragCorpora/2882303761517117440
[2] dépôt de e2e-gicq-7459.txt (code GICQ-7459) puis synchro
    OK  déposé : ['e2e-gicq-7459.txt'] (synchro lancee)
    OK  synchro ok en 25.7 s
    OK  e2e-gicq-7459.txt indexé (origine dépôt)
    OK  l'agent répond GICQ-7459  (réponse : "Le code d'accès du local à vélos du bâtiment Héron est GICQ-7459.\n\nSources :\n* [e2e-gicq-7459.txt](https://storage.c…")
    OK  et cite le fichier
[3] modification : nouveau code GFWM-9036
    OK  réindexé ({'source': 'Fichiers déposés', 'importes': 1, 'inchanges': 0, 'echecs': 0})
    OK  l'agent répond GFWM-9036 (plus GICQ-7459)  (réponse : "Le code d'accès du local à vélos du bâtiment Héron est GFWM-9036.\n\nSources :\n[e2e-gicq-7459.txt](ht…")
[4] suppression
    OK  1 fichier(s) retiré(s) de l'index
    OK  e2e-gicq-7459.txt absent de l'index
    OK  l'agent ne connaît plus le code
[5] Drive : « Quelle est l'indemnité mensuelle de télétravail ? »
    OK  réponse contient « 47 »  ("L'indemnité mensuelle de télétravail est de 47 euros [politique-teletravail](https://docs.google.com/document/d/1iSBUTTFqDhKCNFC0H…")
    OK  avec un lien Drive

TOUT EST OK

4. Modifier

Modifiez le .env ou le code, source scripts/config.sh …, relancez bash scripts/deployer_shell.sh. Seul ce qui a changé change (nouvelle image seulement si le code a changé).

5. Supprimer

bash scripts/supprimer_shell.sh      # tapez « oui »

Puis 10-tout-supprimer, parties 3 et 4.