Mettre la démo en production
- Leçon 18
- 90 min
- Module 6 : Déployer et exploiter
Où nous en sommes
Dans la leçon précédente, nous avons construit une image testée. Maintenant, nous la démarrons comme démo privée. Mais les secrets doivent rester hors de l'image, les parties doivent démarrer dans le bon ordre, et nous devons savoir quand elle est vraiment prête. Dans cette leçon, nous mettons la démo en production et nous prouvons le parcours principal avec un test de fumée, comme une boulangère qui ouvre sa boutique le matin.
Leçon 18 sur 22 · Projet intégrateur : créer, évaluer et livrer un produit d'IAMettre la démo en production
1. Choisir et délimiter le projet
2. Préparer les données et l'architecture
3. Créer un parcours utilisateur complet
4. Ajouter la fiabilité et le contrôle d'accès
5. Évaluer et améliorer
6. Déployer et exploiter
7. Préparer la présentation du portfolio
Ce que vous saurez faire
Démarrez l’image testée comme démo privée sur votre ordinateur. Ses secrets restent hors de l’image. Elle démarre dans le bon ordre et indique quand elle est prête. Ses journaux sont utiles sans montrer les questions des gens. Un test de fumée vérifie le parcours principal en quelques secondes.
Avant de commencerCe qu’il faut savoir et avoir sous la main
Ce que vous devez savoir
- Les paramètres et les secrets viennent de l’environnement, pas de l’image. Voir Configuration à l’exécution dans L’essentiel de Docker et du nuage pour les développeurs en IA.
- Les ports publiés et les personnes qui peuvent s’y connecter. Voir Ports et accès au service : choisir qui peut se connecter dans le cours sur Docker.
- La vitalité et l’état de préparation. Voir Configuration opérationnelle : trois sondes, deux points de terminaison dans le cours sur Docker, et Charger et initialiser : prêt, ou rien du tout dans Déployer des modèles d’IA pour de vrais utilisateurs.
- Les vérifications de fumée. Voir Vérifier et supprimer dans le cours sur Docker.
- Les identifiants de requête dans les journaux et les corps d’erreur. Voir Configuration et journalisation dans Créer et déployer votre première API.
- Les migrations avant le démarrage de la nouvelle version. Voir Migrations sûres dans CI/CD, tests et mises en production sûres.
- Dans ce cours : le fournisseur d’identité de pratique et
python -m idp token, dans Appliquer les autorisations; le pipeline de construction et l’image, dans Pipeline de construction.
Ce qu’il vous faut sur votre ordinateur
- La copie propre
~/projects/doc-assistant-cide Pipeline de construction : exercice guidé, avec son environnement virtuel,.env,.idp/et l’imagedoc-assistant:1.0.0. Si vous ne l’avez pas, faites d’abord les étapes 1, 2 et 9 de cet exercice. - Docker Desktop en marche, avec au moins 2 Go de mémoire libre pour les conteneurs.
- Les ports 8000, 8400 et 5432 libres sur votre ordinateur, ou d’autres ports dans
.env(API_PORT,IDP_PORT,DB_PORT).
Testé sur macOS (Apple silicon) avec Docker Engine 29.6.1. L’équipe du cours a rédigé les commandes Windows et Linux, sans les tester. Elle a aussi rédigé les étapes dans le nuage à la fin, sans les exécuter.
Ouvrir une boutique le matin
Section intitulée « Ouvrir une boutique le matin »Imaginez une boulangère qui ouvre sa boutique à sept heures. Elle déverrouille la porte avec la clé dans sa poche. Elle ne colle jamais la clé sur la porte. Elle allume le four et la caisse, puis attend que le four soit chaud. Elle se vend le premier pain pour vérifier que la caisse imprime un reçu. Ensuite seulement, elle passe l’affiche sur la porte de « Fermé » à « Ouvert ».
Des lumières allumées ne signifient pas que la boutique peut vendre. Si la caisse est brisée, l’affiche reste sur « Fermé ». Les clients attendent dehors au lieu de faire la file à l’intérieur pour rien.
Le problème : démarré ne veut pas dire fonctionnel
Section intitulée « Le problème : démarré ne veut pas dire fonctionnel »L’image de Sam a réussi toutes les vérifications. Elle doit maintenant fonctionner comme démo, avec sa base de données et son fournisseur d’identité. Trois problèmes peuvent survenir, dont deux sans signal évident.
D’abord, les secrets. L’API a besoin du mot de passe de la base de données, du secret de session et du secret client. S’ils manquent, Compose refuse de démarrer quoi que ce soit, avant même le lancement d’un seul conteneur :
docker compose --profile app config -qerror while interpolating services.api.environment.SESSION_SECRET: required variable SESSION_SECRET is missing a value: Run python -m idp init firstCet échec est visible et survient tôt, ce qui est bien. Le message indique aussi quoi faire.
Ensuite, l’ordre. L’API ne doit pas démarrer avant que la base de données accepte les connexions et que les migrations soient exécutées. Sinon, elle échoue à sa première requête ou utilise un ancien schéma.
Enfin, un problème silencieux : un processus qui tourne, mais ne peut pas fonctionner. Pendant l’exécution de Sam, on a arrêté volontairement le conteneur de base de données, tandis que l’API continuait de tourner. Le processus de l’API était encore actif :
curl http://127.0.0.1:8000/health{"status":"ok","version":"1.0.0"}Le processus dit « ok », et c’est vrai : il tourne. Mais il ne peut répondre à aucune question. Une vérification qui demande seulement « le processus tourne-t-il? » enverrait Grace vers un assistant qui échoue à chaque clic.
L’idée : une mise en production qui attend d’être prête
Section intitulée « L’idée : une mise en production qui attend d’être prête »D’abord, deux termes. Un déploiement place une version du produit là où ses utilisateurs peuvent y accéder, puis la démarre. Une mise en production est le déploiement d’une nouvelle version munie d’une étiquette. Dans ce cours, le déploiement est une démo privée sur votre propre ordinateur.
Les habitudes de la boulangère deviennent cinq règles de mise en production :
- Les secrets viennent de l’extérieur. Un secret est une valeur qui donne accès : mot de passe, clé de signature ou secret de session. Il reste dans
.envou dans le magasin de secrets de la plateforme, jamais dans l’image ni dans Git. - Démarrez dans l’ordre, les migrations d’abord. La base de données doit être en santé avant l’exécution des migrations. Les migrations doivent se terminer avant le démarrage de l’API.
- Deux questions de santé. La vitalité demande « le processus tourne-t-il? » (
/health). L’état de préparation demande « peut-il faire son travail maintenant? » (/ready: la base de données répond et toutes les migrations sont appliquées). Une plateforme redémarre un processus qui n’est plus actif. Elle n’envoie aucun utilisateur vers un processus qui n’est pas prêt. - Un test de fumée après chaque démarrage. Un test de fumée vérifie brièvement le parcours principal depuis l’extérieur, en quelques secondes. Le nom vient de l’électronique : allumez le nouvel appareil et regardez s’il dégage de la fumée. C’est le premier pain de la boulangère.
- Privée par défaut. Une démo s’adresse aux personnes à qui vous la montrez, sur votre écran.
Un petit exemple : l’ordre de démarrage
Section intitulée « Un petit exemple : l’ordre de démarrage »Le fichier compose.yaml de Sam contient quatre services. db est PostgreSQL avec pgvector. idp est le fournisseur d’identité de pratique. migrate exécute les migrations, puis s’arrête. api est l’assistant. Les trois derniers utilisent la même image. Les conditions depends_on et les vérifications de santé les placent dans l’ordre :
migrate: profiles: ["app"] image: doc-assistant:${APP_VERSION:-1.0.0} command: ["python", "-m", "doc_assistant.migrate"] depends_on: db: condition: service_healthy
api: profiles: ["app"] image: doc-assistant:${APP_VERSION:-1.0.0} environment: SESSION_SECRET: ${SESSION_SECRET:?Run python -m idp init first} # ... the other settings ports: - "127.0.0.1:${API_PORT:-8000}:8000" healthcheck: test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8000/ready')"] interval: 5s start_period: 20s depends_on: migrate: condition: service_completed_successfully idp: condition: service_startedLe profil app exclut les trois services de docker compose up -d db, que vous utilisiez pendant le développement. ${SESSION_SECRET:?…} transforme le secret manquant en erreur accompagnée d’un message, comme vous l’avez vu plus haut. La vérification de santé de api appelle /ready, pas /health. Ainsi, « en santé » signifie « prêt à servir ».
Description textuelle du diagramme
La commande démarre d’abord la base de données et le fournisseur de pratique. Les migrations s’exécutent seulement quand la base de données est en santé, c’est-à-dire quand pg_isready réussit. L’API démarre seulement quand les migrations se terminent avec le code de sortie 0 et que le fournisseur a démarré. L’API charge le modèle de plongement (embedding) et ouvre son pool de connexions (pool) à la base de données. Sa vérification de santé appelle /ready toutes les 5 secondes. Avec --wait, la commande rend la main seulement quand cette vérification réussit. Un script exécuté ensuite peut donc compter sur la pile de services.
Sans --wait, docker compose up -d rend la main dès que les conteneurs existent, avant le chargement des modèles. Un test de fumée exécuté juste après peut échouer sans véritable raison. Avec --wait, il échoue seulement si la pile de services n’est jamais prête.
Les secrets restent hors de l’image
Section intitulée « Les secrets restent hors de l’image »python -m idp init crée la clé de signature du fournisseur de pratique dans .idp/. Il écrit aussi deux nouveaux secrets dans .env : OIDC_CLIENT_SECRET et SESSION_SECRET. Compose lit .env et donne à chaque conteneur seulement les valeurs nommées dans son environment. L’image n’en contient aucune. Sam le vérifie directement dans l’image, sans démarrer la pile de services :
docker run --rm --entrypoint sh doc-assistant:1.0.0 -c 'whoami; ls -a /app'app...datadoc_assistantevaluationidpmigrationsrecordingsrequirements-run.txtrequirements.txtscriptstracesL’utilisateur est app, et /app ne contient ni .env ni .idp, car .dockerignore les a exclus de la construction. Le fournisseur de pratique reçoit son dossier de clés par un montage en lecture seule. La clé reste donc aussi hors de l’image.
Description textuelle du diagramme
L’image contient le code, les deux modèles et l’ensemble de données. Elle ne contient ni .env ni .idp/. Sur votre ordinateur, .env contient les trois secrets. Compose les transmet comme variables d’environnement à l’API et à la base de données lors de leur démarrage. Le dossier .idp/ contient la clé de signature du fournisseur. Il est monté en lecture seule dans le conteneur du fournisseur. Le navigateur de votre ordinateur accède à l’API à l’adresse 127.0.0.1:8000. Un autre ordinateur du même réseau ne peut pas se connecter, car chaque port écoute seulement sur 127.0.0.1. L’équipe du cours n’a pas testé cela depuis un deuxième ordinateur. Ce comportement découle de la façon dont Docker publie un port, comme dans le cours sur Docker.
La clé d’un modèle en service, LLM_API_KEY, suivrait le même chemin : dans .env, puis dans l’environnement de l’API. La classe de paramètres l’exclut de tous les journaux et de toutes les erreurs (repr=False).
Des journaux utiles, sans le contenu
Section intitulée « Des journaux utiles, sans le contenu »L’API écrit une ligne JSON par requête. Voici quatre lignes du test de fumée exécuté par Sam :
{"request_id": "fe1d2399e78449ce", "method": "GET", "path": "/v1/tenants/larkfield/documents", "status": 401, "ms": 0.8, "tenant": null, "user": null}{"request_id": "2cf6f95f2e004f76", "method": "GET", "path": "/v1/tenants/larkfield/documents", "status": 200, "ms": 73.7, "tenant": "larkfield", "user": "usr-sam"}{"request_id": "0b296ceba2b04e6b", "method": "POST", "path": "/v1/tenants/larkfield/answers", "status": 200, "ms": 76.5, "tenant": "larkfield", "user": "usr-sam"}{"request_id": "78cfd1d6542341c5", "method": "GET", "path": "/v1/tenants/bramble/documents", "status": 404, "ms": 0.9, "tenant": null, "user": null}Chaque ligne contient l’identifiant de requête, la méthode, le chemin, le statut, la durée en millisecondes, la boutique et l’utilisateur. Elle ne contient jamais la question, la réponse ni un jeton. Les questions peuvent contenir le nom ou la commande d’un client. Les journaux sont lus par plus de personnes que le personnel de la boutique. Un test, test_the_request_log_has_ids_but_no_content, envoie la question « A secret question? » (une question secrète?). Il échoue si le mot « secret » ou un jeton porteur se retrouve dans le journal.
Chaque corps d’erreur contient le même request_id. Quand Grace envoie une capture d’écran d’une erreur, Sam cherche donc cet identifiant dans les journaux. La ligne indique la requête, sa boutique, son utilisateur et sa durée. La question elle-même reste dans la base de données, protégée par les règles d’accès de la boutique, pas dans le journal.
La mémoire nécessaire à la démo
Section intitulée « La mémoire nécessaire à la démo »Pendant l’exécution de la démo, Sam a mesuré la mémoire de chaque conteneur avec docker stats --no-stream :
Description textuelle du graphique
Un graphique à colonnes avec trois colonnes. Le conteneur api utilise 858 Mio, le conteneur idp 42 Mio et le conteneur db 36 Mio. La colonne api est environ vingt fois plus haute que chacune des autres.
L’API est la partie lourde, car elle garde torch et le modèle de plongement en mémoire. Dans les modes de reclassement, l’encodeur croisé en ajoute encore. Toute la démo nécessite environ 1 Go. Un ordinateur de 8 Go peut donc l’exécuter avec un navigateur et un appel vidéo. Un forfait infonuagique nécessite au moins 2 Gio pour l’API, la valeur indiquée dans docs/deployment.md.
Exercice guidé : démarrer la démo et exécuter le test de fumée
Section intitulée « Exercice guidé : démarrer la démo et exécuter le test de fumée »-
Dans
~/projects/doc-assistant-ci, avec l’environnement virtuel actif, arrêtez la base de données de la dernière leçon. Toute la pile de services repartira ainsi à neuf :docker compose down. -
Vérifiez les paramètres.
docker compose --profile app config -qn’affiche rien quand tous les secrets requis sont définis. Si la commande afficherequired variable … is missing a value(une variable requise n’a pas de valeur), exécutezpython -m idp init. -
Démarrez toute la démo et attendez qu’elle soit prête :
Fenêtre de terminal APP_VERSION=1.0.0 docker compose --profile app up -d --waitFenêtre de terminal $env:APP_VERSION = "1.0.0"docker compose --profile app up -d --waitLes dernières lignes indiquent que
dbetapisontHealthy(en santé). Si l’image n’existe pas encore, ajoutez--build. -
Consultez l’état des services :
docker compose --profile app ps. Vous voyez :SERVICE STATUS PORTSapi Up 5 seconds (healthy) 127.0.0.1:8000->8000/tcpdb Up 8 seconds (healthy) 127.0.0.1:5432->5432/tcpidp Up 8 seconds 127.0.0.1:8400->8400/tcpmigraten’est pas dans la liste : il s’est exécuté, s’est terminé avec le code 0, puis s’est arrêté. Les ports commencent par127.0.0.1. -
Chargez l’ensemble de données dans un conteneur ponctuel de la même image :
Fenêtre de terminal docker compose --profile app run --rm api python -m scripts.load_packLa fin de la sortie :
Indexed 31 documents in 8.5 s (failed 0).bramble: 15 documents, 60 passages, 0 failedlarkfield: 36 documents, 185 passages, 0 failed« 31 documents » n’est pas une erreur. Le fil d’exécution de l’API en cours a indexé les 20 autres en même temps. Les deux dernières lignes comptent tous les documents de chaque boutique : 51 au total et 0 échec.
-
Posez les deux questions de santé :
Fenêtre de terminal curl http://127.0.0.1:8000/healthcurl http://127.0.0.1:8000/ready{"status":"ok","version":"1.0.0"}{"status":"ready","version":"1.0.0","answer_provider":"recorded","retrieval_mode":"hybrid","auth_mode":"oidc"}Sur Windows, utilisez
curl.exeau lieu decurl. -
Exécutez le test de fumée avec un jeton de pratique pour Sam :
Fenêtre de terminal SMOKE_TOKEN=$(python -m idp token usr-sam) python scripts/smoke.py http://127.0.0.1:8000Fenêtre de terminal $env:SMOKE_TOKEN = python -m idp token usr-sampython scripts/smoke.py http://127.0.0.1:8000PASS health (version 1.0.0)PASS ready: database and migrations (recorded)PASS the page is servedPASS no sign-in -> 401PASS documents are indexed (36 indexed)PASS a question gets a cited answer (recorded: We refund the extra charge within 3 business days after confirming the double ch)PASS another shop -> 4047 of 7 checks passed. -
Ouvrez http://127.0.0.1:8000, choisissez Sign in (se connecter), sélectionnez Ines, puis posez la question « How long is a gift card valid? » (combien de temps une carte-cadeau est-elle valide?). Vous obtenez une réponse avec citation tirée des documents de Bramble Books. L’équipe du cours n’a pas effectué cette connexion dans le navigateur; elle a vérifié les mêmes routes avec curl.
-
Lisez les dernières lignes du journal :
docker compose --profile app logs api --tail 5. Trouvez la ligne de votre question :POST, le chemin contenantbramble, le statut200et l’utilisateurusr-ines.
Gardez la démo en marche pour la prochaine leçon, ou arrêtez-la avec docker compose --profile app down. Cette commande conserve les données.
Les sept vérifications couvrent le parcours principal depuis l’extérieur : le processus tourne, il est prêt et la page est servie. Une requête sans connexion reçoit 401, et la boutique possède des documents indexés. Une question reçoit une réponse avec citation, et le chemin d’une autre boutique reçoit 404. Le test de fumée utilise seulement la bibliothèque standard. Il fonctionne donc sur un exécuteur CI ou un nouvel ordinateur sans aucune installation. Il ne remplace pas l’évaluation : il pose une question, pas 41.
À vous de jouer : le test de fumée sans jeton
Section intitulée « À vous de jouer : le test de fumée sans jeton »Changez une condition. Relancez le test de fumée, mais sans SMOKE_TOKEN (sur Windows, exécutez d’abord Remove-Item Env:SMOKE_TOKEN). Faites une prédiction : combien de vérifications s’exécutent, et lesquelles sont omises?
Afficher la réponse
PASS health (version 1.0.0)PASS ready: database and migrations (recorded)PASS the page is servedPASS no sign-in -> 4014 of 4 checks passed.Quatre vérifications s’exécutent : celles qui ne nécessitent aucune connexion. Les trois vérifications qui nécessitent un membre de Larkfield sont omises : les documents indexés, la réponse avec citation et le 404 pour une autre boutique. Une exécution sans jeton est utile sur un ordinateur sans .idp/, mais elle ne prouve pas le parcours principal. C’est pourquoi le flux de travail CI crée d’abord un jeton.
Erreur courante
En santé pour la plateforme, inutile pour l'utilisateur
Symptôme : pendant l’exécution de Sam, on a arrêté le conteneur de base de données avec docker compose stop db. Le conteneur de l’API a continué de tourner. /health indiquait encore ok (fonctionnel), comme vous l’avez vu au début de cette leçon. Mais /ready donnait :
HTTP/1.1 503 Service Unavailable...{"code":"not_ready","message":"the database does not answer","request_id":"1e6a14469ba74296"}Cause : le processus était actif, mais pas la base de données. /health n’appelle pas la base de données, volontairement. /ready le fait.
Diagnostic : comparez les deux points de terminaison. Un processus actif, mais pas prêt, signifie qu’une dépendance manque. Le message la nomme : la base de données ne répond pas. docker compose --profile app ps montre que db ne tourne pas.
Reprise : redémarrez la base de données : docker compose up -d --wait db. Ensuite, /ready donne :
{"status":"ready","version":"1.0.0","answer_provider":"recorded","retrieval_mode":"hybrid","auth_mode":"oidc"}L’API s’est reconnectée toute seule, sans redémarrage.
Conséquence pour le travail en IA : certaines équipes dirigent la vérification de vitalité vers /ready. Une panne de base de données pousse alors la plateforme à redémarrer l’API sans arrêt. Chaque redémarrage charge les modèles pendant plusieurs secondes, et un redémarrage ne peut pas réparer une base de données. Gardez la vitalité sur /health et l’état de préparation sur /ready, comme dans le cours sur Docker.
Privée par défaut
Section intitulée « Privée par défaut »La démo de Sam est privée de quatre façons. Chaque choix est consigné dans docs/deployment.md :
- Les ports écoutent sur 127.0.0.1. Seul cet ordinateur peut ouvrir la démo. Pour la montrer, partagez votre écran ou enregistrez une vidéo.
- Le fournisseur d’identité d’exercice ne demande aucun mot de passe. Quiconque peut y accéder peut se connecter comme Grace. Ne le publiez jamais.
SESSION_COOKIE_SECURE=falsepermet au témoin (cookie) de fonctionner en http sur votre propre ordinateur. Ailleurs, utilisez https et gardez la valeurtrue.- Des documents synthétiques seulement. La démo montre les commerces fictifs du cours. Ne chargez jamais les documents d’une vraie entreprise dans une démo visible par d’autres, même « juste pour la réunion ». Une citation montre le passage à quiconque le demande.
Omar demande : « Est-ce qu’on peut la mettre en ligne pour le client? » Sam répond : la démo privée sur son écran constitue la mise en production de ce cours. Une démo publique exige un vrai fournisseur d’identité, https, une base de données gérée et un budget. Il faut aussi quelqu’un pour la supprimer ensuite.
Facultatif : le nuage (étapes écrites, non exécutées)
Section intitulée « Facultatif : le nuage (étapes écrites, non exécutées) »Si vous avez un compte Azure et voulez une adresse publique, docs/deployment.md donne les étapes pour Azure Container Apps. L’équipe du cours les a rédigées à partir des étapes exécutées dans Registre et déploiement et Vérifier et supprimer. Elle ne les a pas exécutées pour ce projet et n’a créé aucune ressource infonuagique. En bref :
- Un serveur flexible PostgreSQL qui autorise l’extension
vector, accessible seulement depuis l’application. - L’image dans un registre, référencée par son empreinte, comme dans le cours CI/CD, tests et mises en production sûres.
- Une application conteneurisée : 1 vCPU et 2 Gio, au moins 1 réplique (un démarrage à froid chargerait les modèles), vérification de vivacité sur
/health, vérification de l’état prêt sur/ready. - Les secrets stockés comme secrets de la plateforme, et non comme paramètres en clair.
- Un vrai fournisseur d’identité à la place de celui d’exercice, et
SESSION_COOKIE_SECURE=true. - Le même test de fumée à l’adresse de l’application. Supprimez ensuite le groupe de ressources le jour même.
Les prix changent. Consultez donc les pages de tarifs actuels avant de commencer. Le cours Conception de systèmes d’IA et maîtrise des coûts estimait une conception semblable à environ 50 $ US par mois, dans Modèle de coûts. Une démo d’une journée coûte quelques dollars, si vous la supprimez. La prochaine leçon montre comment la supprimer.
Votre projet
Section intitulée « Votre projet »- Ajoutez les services à votre
compose.yaml: les migrations dans un service distinct, l’API avec une vérification de santé sur son point de terminaison d’état prêt, et tous les ports sur 127.0.0.1. - Donnez à votre API les deux points de terminaison :
/healthsans dépendances, et/readyqui vérifie la base de données, les migrations et toute autre dépendance indispensable à son fonctionnement. - Faites en sorte que chaque secret obligatoire manquant provoque une erreur avec un message (
${NAME:?message}). Vérifiez que votre image ne contient aucun secret. - Écrivez votre test de fumée : le parcours principal de votre produit en dix vérifications au plus, avec la bibliothèque standard seulement, et un code de sortie de 0 ou 1.
- Démarrez la démo à partir d’une copie propre, chargez vos données et exécutez le test de fumée. Enregistrez la sortie.
- Rédigez votre
docs/deployment.md: les étapes, ce qui est privé et pourquoi, et ce que vous n’avez pas fait.
Preuves à conserver : la sortie de up --wait, de ps, des deux points de terminaison de santé et du test de fumée depuis une copie propre; deux lignes de journal avec des identifiants de requête; docs/deployment.md.
Liste de vérification
-
docker compose … config -qéchoue avec un message clair quand un secret manque. - L’image ne contient ni
.envni clés, et s’exécute sous un utilisateur autre que root. - L’API démarre après les migrations, et
--waitattend qu’elle soit prête. -
/healthet/readyrépondent à des questions différentes, et vous pouvez expliquer la différence. - Le test de fumée réussit depuis une copie propre, avec une connexion.
- Les journaux contiennent des identifiants de requête, mais aucun texte de question, aucune réponse ni aucun jeton.
- La démo est privée et utilise seulement des documents synthétiques ou autorisés.
Vérification des connaissances
Section intitulée « Vérification des connaissances »Vérifiez votre compréhension
À la boulangerie, la propriétaire s'achète le premier pain avant de tourner l'affiche sur « Ouvert ». À quelle partie de la mise en production de Sam cela correspond-il? Et quelle partie correspond à « attendre que le four soit chaud »?
Afficher la réponse
Le premier pain correspond au test de fumée : une courte vérification du parcours principal depuis l’extérieur, après le démarrage. Il comprend sept vérifications, avec une vraie question et sa citation. Attendre que le four soit chaud correspond à l’état prêt. docker compose … up --wait se termine seulement quand la vérification de santé de l’API sur /ready réussit. Cela signifie que la base de données répond et que toutes les migrations sont en place.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Vérifiez votre compréhension
Prédisez : la base de données s'arrête pendant que la démo fonctionne. Que renvoient /health et /ready? Que devrait faire une plateforme avec le conteneur de l'API, et pourquoi?
Afficher la réponse
/health renvoie 200 avec "status":"ok" (« état : correct »), car le processus fonctionne et le point de terminaison n’appelle pas la base de données. /ready renvoie 503 not_ready (non prêt) avec « la base de données ne répond pas ». La plateforme ne devrait envoyer aucun utilisateur vers l’API tant qu’elle n’est pas prête, mais elle ne devrait pas la redémarrer. Un redémarrage ne peut pas réparer la base de données, et il recharge les modèles chaque fois. Quand la base de données revient, /ready renvoie 200 sans redémarrage.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Vérifiez votre compréhension
Omar veut charger les vrais contrats fournisseurs de Larkfield pour une démo à un client, « juste cette fois ». Que lui dites-vous, et que montrez-vous à la place?
Afficher la réponse
Non. Une démo montre des passages à quiconque les demande. Sa base de données, ses journaux et ses captures d’écran en conservent des copies. Les vrais contrats exigent l’autorisation du propriétaire, un véritable contrôle d’accès et un plan pour les supprimer. Montrez plutôt l’ensemble synthétique : il présente les mêmes difficultés (deux versions d’une politique, une contradiction, une réponse uniquement dans un tableau, des documents réservés au personnel, une instruction cachée). Si le client a besoin de ses propres documents, c’est un projet pilote avec son autorisation, pas une démo.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Récapitulatif
- Un secret donne accès. Il provient de
.envou du stockage de secrets de la plateforme au démarrage. Il ne se trouve jamais dans l’image ni dans Git. Compose refuse de démarrer quand un secret obligatoire manque. - Compose démarre les services dans l’ordre : la base de données en bon état, les migrations terminées, puis l’API.
--waitse termine seulement quand l’API est prête. - La vivacité (
/health) demande « le processus fonctionne-t-il? ». L’état prêt (/ready) demande « peut-il fonctionner maintenant? ». Quand la base de données est arrêtée, la première répond oui et le second répond non. - Un test de fumée vérifie le parcours principal depuis l’extérieur en quelques secondes : 7 sur 7 pour la démo de Sam.
- Les journaux contiennent un identifiant de requête, le commerce et l’utilisateur, jamais la question, la réponse ni un jeton.
- La démo est privée : ports sur 127.0.0.1, fournisseur d’exercice, documents synthétiques. Les étapes infonuagiques sont facultatives et écrites, mais non exécutées.
Ensuite, vous ferez échouer une mise en production volontairement et reviendrez à la version précédente. Vous limiterez les dépenses de la démo et supprimerez tout.
Leçon suivante : Reprise et maîtrise des coûts