Práctica: Una API con el Functions Framework y el emulador de Firestore

Lo que vas a aprender en este TP

• Usar el emulador de Firestore
• Escribir una función con el Functions Framework
• Preparar el contenedor para Cloud Run

Introducción #

Lo que vas a aprender en esta sección

• Usar el emulador de Firestore
• Escribir una función con el Functions Framework
• Preparar el contenedor para Cloud Run

Contexto. Un equipo de producto quiere una API serverless de perfiles de usuario. La desarrollas totalmente en local antes de cualquier despliegue.

Requisitos previos: Docker, Python 3 y el SDK de Google Cloud (gcloud con los componentes de emuladores); no se necesita proyecto de Google Cloud ni facturación  ·  Duración estimada: 50 min

Una API que crea, lee y lista perfiles en Firestore, ejecutada en local y en contenedor.

Puesta en práctica #

Pasos guiados, con su corrección.

1. 1. Iniciar el emulador de Firestore

   ¿Por qué? FIRESTORE_EMULATOR_HOST redirige el cliente Python.

   Inicia el emulador e instala las bibliotecas.

2. 2. Escribir la función

   ¿Por qué? El mismo código se ejecuta en Cloud Run functions sin cambios.

   Crea main.py: POST crea un perfil, GET con ?id= lo lee, GET sin parámetro lista los perfiles.

3. 3. Ejecutar y probar

   ¿Por qué? functions-framework simula el entorno de ejecución de Google.

   Ejecuta la función en el puerto 8080, crea un perfil, léelo y lista.

4. 4. Contenerizar para Cloud Run

   ¿Por qué? Cloud Run ejecuta cualquier contenedor que escuche en $PORT.

   Escribe un Dockerfile, construye la imagen y ejecútala conectada al emulador.

Nivel de dificultad : ●●●○○ (3/5)