Functions

Esta guía te muestra cómo trabajar con Azure Functions usando Python y Azure Functions Core Tools. Este lab demuestra cómo desarrollar, ejecutar, depurar, testear y validar una función con trigger HTTP localmente.

Prerrequisitos

• Docker instalado y en ejecución.
• Dev Containers extension instalada (opcional).

Cómo ejecutar

1. Configurar el entorno:

   Dev Container (recomendado)

   Abre VS Code en la carpeta del proyecto y ejecuta este comando en la Paleta de Comandos:

   > Dev Containers: Reopen in Container

   Manual
   1. Ejecuta el script de configuración para instalar herramientas y dependencias.

      scripts/setup.sh

   2. Iniciar la infraestructura: Lanza los contenedores necesarios.

      docker compose up -d

2. Iniciar el host de funciones:

   Terminal

   func start

   Run and Debug
   • Abre: Abre la pestaña Run and Debug en VS Code.
   • Ejecuta: Selecciona Attach to Python Functions y pulsa F5. El emulador se inicia y el depurador se conecta automáticamente.
   Azure Functions Extension
   • Abre: Abre la barra lateral de Azure y navega a Workspace → Local Project → Functions.
   • Ejecuta: Haz clic en el botón Start debugging para iniciar la aplicación de funciones.

3. Ejecutar el ejemplo:

   Python

   python main.py

   cURL
   • Admin (éxito):

     curl "http://localhost:7071/api/get_secret?username=admin"

   • Otro usuario (prohibido):

     curl "http://localhost:7071/api/get_secret?username=guest"

   REST Client
   • Instala: REST Client desde el Marketplace de VS Code.
   • Abre: Abre http/get_secret.http en VS Code.
   • Ejecuta: Haz clic en Send Request encima de cualquier bloque de petición.

Cómo depurar

1. function_app.py:

   • Abre: Abre function_app.py.
   • Breakpoints: Añade breakpoints dentro de get_secret.
   • Ejecuta: Desde la pestaña Run and Debug, selecciona Attach to Python Functions y pulsa F5.

2. main.py:

   • Abre: Abre main.py.
   • Breakpoints: Añade breakpoints en la función main.
   • Ejecuta: Pulsa F5 para iniciar la depuración.

3. Tests:

   • Abre: Abre un archivo de test (p. ej., tests/test_functions.py).
   • Breakpoints: Añade breakpoints en el código de test.
   • Ejecuta: Usa la pestaña Testing de VS Code y haz clic en el icono Debug Test junto al test que quieras depurar.

Cómo testear

• Individualmente: Ejecuta tests individualmente desde la pestaña Testing de VS Code.
• Todos los tests: Ejecuta el script automatizado:

  scripts/run_tests.sh

Validar resultados

Terminal

• Ejecuta: Ejecuta el script principal y revisa su salida:

  python main.py

• Verifica: El usuario definido en ADMIN_USERNAME (.env) debería recibir una respuesta 200 con el valor del secreto. Cualquier otro usuario debería recibir 403.

Logs

• Abre: Revisa el terminal donde se está ejecutando func start.
• Verifica: Cada petición registra una línea como Python HTTP trigger function processed a request.

Limpieza

docker compose down -v

Siguientes pasos

• Construye sobre este MVE con el proyecto Storage Writer.
• Construye sobre este MVE con el proyecto SQL Writer.
• Consulta el Lab equivalente en AWS.