Set up local dev environment (Azure Functions)

Install Azure Functions Core Tool

Para Visual Studio Code instalar la Azure Functions extension. Esta depende de Azure Functions Core Tools, la cual permite ejecutar una versión local del runtime de las Azure Functions. Tiene el mismo trigger y binding logic que corre en Azure, por lo que funciona de manera consistente entre local y cloud envs.

Gracias a ellas también puedes crear nuevas Functions desde tu local. Esto crea la function y te permite ejecutarla con func start y expone http://localhost:7071 por defecto.

Understand local project structure

El programming model Python v2 usa un single entry point file function_app.py, donde defines tus functions y sus triggers usando decorators. Este approach consolida las function definitions en un solo lugar.

Un único function_app.py funciona bien para projectos con una miriada de funciones como HTTP trigger para inferencias y queue trigger para batch processing.

A medida que el número de functions crece, se puede partir sus definiciones en files separados usando blueprints. Los blueprints permiten definir funciones en modules individuales y registrarlos en el main entry point function_app.py.

El fichero host.json contiene global runtime configs que aplican a todas las funciones de la app. Esto incluye settings como timeout durations, log levels o concurrency limits.

El fichero local.settings.json contiene app settings y conn strings para desarrollo local. El runtime lee valores del Values object en este fichero y los expone como environment vars en código.
Este fichero se excluye de git por defecto. NUNCA. COMMITEES. `local.settings.json`. N.U.N.C.A

El folder .vscode contiene config files generadas por la Azure Functions extension. El launch.json file configura el debugger, tasks.json define el build y host start.

El fichero requirements.txt (python) o package.json (Node.js) contienen las dependencias del proyecto para funcionar. El runtime instala estas dependencias durante deployment.

El fichero .funcignore especifica files y folders a exlcuir de los deployment packages, manteniendo tus artefactos con poco tamaño, omitiendo ficheros de testing, documentación, etc.

Use Azurite for Functions runtime storage dependency

Azurite provee de implementaciones locales de Azure Blob Storage, Queue Storage y Table Storage, que se comportan como si fuera un cloud service. Así, Azurite elimina la necesidad de crear un Storage account para desarrollo local

El runtime de las Azure Functions requiere una connection a un storage account (configurado a través de AzureWebJobsStorage) para coordinaciones internas. Esta dependencia existe aunque tu app use Azure Storage directamente.

Para desarrollo local puedes enrutas esta dependencia al Azurite emulator poniendo AzureWebJobsStorage como UseDevelopmentStorage=true en local.settings.json.

La manera más simple de usar Azurite es instalar su extension, la cual enciende el emulador cuando haces start del programa local.

{
    "IsEncrypted": false,
    "Values": {
        "AzureWebJobsStorage": "UseDevelopmentStorage=true",
        "FUNCTIONS_WORKER_RUNTIME": "python"
    }
}

El valor UseDevelopmentStorage=true solo tiene efecto en local. Al lanzar la Function, Azure crea o requiere de un storage account automáticamente

Use emulators and local services for connected resources

Para servicios como BBDD, caches y otros data-level ops podemos usar emuladores y alternativas locales para poder testear y mantener los costes bajos.

Azure Cosmos DB emulator se ejecuta en local en Windows, Linux y macOS (a través de Docker). Soporta la NoSQL API y provee de un local endpoint que se comporta como el cloud service.

Azure Database for PostgreSQL no tiene un emulador, pero PostgreSQL es open source por lo que puedes instalar una instancia local.

Azure Managed Redis tampoco tiene emulador, pero Redis es open source.

Simplemente cambiamos los valores con local.settings.json.

Synchronize settings between local and Azure

La Azure Functions extension y Core Tools ofrecen maneras de sincronizar settings entre local y Azure.

En Visual Studio Code puedes hacer click derecho en la function app y seleccionar Download Remote Settings para bajarte los settings a tu local.settings.json.
También puedes Upload Local Settings para hacer push de local values a Azure.

Puedes encriptar tus local settings file con func settings encrypt para proteger secretos en tu maquina de desarrollo.