TP : Une API sur le Functions Framework avec l'émulateur Firestore

Ce que vous allez apprendre dans ce TP

• Utiliser l'émulateur Firestore
• Écrire une fonction avec le Functions Framework
• Préparer le conteneur pour Cloud Run

Introduction #

Ce que vous allez apprendre dans cette section

• Utiliser l'émulateur Firestore
• Écrire une fonction avec le Functions Framework
• Préparer le conteneur pour Cloud Run

Contexte. Une équipe produit veut une API de profils utilisateurs serverless. Vous la développez entièrement en local avant tout déploiement.

Prérequis : Docker, Python 3 et le SDK Google Cloud (gcloud avec les composants d'émulateurs) ; aucun projet Google Cloud ni facturation nécessaires  ·  Durée estimée : 50 min

Une API qui crée, lit et liste des profils dans Firestore, exécutée localement et en conteneur.

Mise en place #

Étapes guidées, avec leur correction.

1. 1. Démarrer l'émulateur Firestore

   Pourquoi ? FIRESTORE_EMULATOR_HOST redirige le client Python.

   Démarrez l'émulateur et installez les bibliothèques.

2. 2. Écrire la fonction

   Pourquoi ? Le même code s'exécute sur Cloud Run functions sans modification.

   Créez main.py : POST crée un profil, GET avec ?id= le lit, GET sans paramètre liste les profils.

3. 3. Exécuter et tester

   Pourquoi ? functions-framework simule l'environnement d'exécution de Google.

   Lancez la fonction sur le port 8080, créez un profil, relisez-le et listez.

4. 4. Conteneuriser pour Cloud Run

   Pourquoi ? Cloud Run exécute n'importe quel conteneur qui écoute sur $PORT.

   Écrivez un Dockerfile, construisez l'image et lancez-la en la reliant à l'émulateur.

Niveau de difficulté : ●●●○○ (3/5)