Azure Functions en Kubernetes

Si estás trabajando con Azure Functions y también con Kubernetes es posible que, en algunos escenarios, te interese valorar el despliegue de tus funciones en tu clúster. En este artículo te cuento cómo crear y desplegar una Azure Function dentro de Kubernetes.

Crear una Azure Function de ejemplo

Existen diferentes formas de crear una Azure Function. Lo más sencillo es haciendo uso de las extensión de Visual Studio Code, o a través de los asistentes de Visual Studio 2019 o Visual Studio for Mac. Sin embargo para este artículo voy a hacerlo a través de la línea de comandos con las Azure Functions Core Tools.

Parar crear el proyecto que almacenará tus funciones debes utilizar func init:

func init hello-k8s && cd hello-k8s

Durante el asistente he elegido node y javascript para este ejemplo.

Giselas-iMac:Azure-Functions-On-k8s gis$ func init hello-k8s && cd hello-k8s
Select a number for worker runtime:
1. dotnet
2. node
3. python
4. powershell
Choose option: 2
node
Select a number for language:
1. javascript
2. typescript
Choose option: 1
javascript
Writing package.json
Writing .gitignore
Writing host.json
Writing local.settings.json
Writing /Users/gis/Desktop/Azure-Functions-On-k8s/hello-k8s/.vscode/extensions.json

Esto crea el proyecto, pero ahora necesito crear una función que desplegar:

func new --name HttpHello --template "Http trigger" --language javascript

Antes de preparar nuestra función para poder ser desplegada en un contendor, puedes comprobar que funciona correctamente ejecutándola en local a través del siguiente comando:

func start

Si todo es correcto, en el resultado debería de devolverte la URL para acceder a tu función.

func start

Ahora que ya tienes todo listo, antes de continuar, para esta prueba modifica el nivel de autorización de tu Azure Functions en function.json a anonymous.

{
  "bindings": [
    {
      "authLevel": "anonymous",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": [
        "get",
        "post"
      ]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "res"
    }
  ]
}

Dockerizar tu función para Kubernetes

Como te puedes imaginar, para que tu función pueda correr en Kubernetes esta debe estar dockerizada. La forma más sencilla de conseguirlo es a través del siguiente comando:

func init --docker-only

Esto generará dos archivos: un Dockerfile, con este contenido:

# To enable ssh & remote debugging on app service change the base image to the one below
# FROM mcr.microsoft.com/azure-functions/node:3.0-appservice
FROM mcr.microsoft.com/azure-functions/node:3.0

ENV AzureWebJobsScriptRoot=/home/site/wwwroot \
    AzureFunctionsJobHost__Logging__Console__IsEnabled=true

COPY . /home/site/wwwroot

RUN cd /home/site/wwwroot && \
    npm install

y un .dockerignore para omitir el archivo local.settings.json de la imagen que se va a generar.

Desplegar tu Azure Function

El último paso es llevar a cabo el despliegue:

#Deploy it on AKS
docker login
func kubernetes deploy --name hello-k8s --registry 0gis0

Cuando lanzas este comando, lo primero que ocurre es la creación de la imagen y, en este ejemplo, la sube a la cuenta de docker con la que has iniciado sesión. Una vez que esta disponible genera tres recursos: un secreto, un servicio y un deployment en el Kubernetes que tienes en el contexto:

Giselas-iMac:hello-k8s gis$ func kubernetes deploy --name hello-k8s --registry 0gis0
Running 'docker build -t 0gis0/hello-k8s /Users/gis/Desktop/Azure-Functions-On-k8s/hello-k8s'..done
Running 'docker push 0gis0/hello-k8s'.............done
secret/hello-k8s created
service/hello-k8s-http created
deployment.apps/hello-k8s-http created

Si consultas tus pods verás que tu función ya está up and running 🙂

Giselas-iMac:hello-k8s gis$ kubectl get po
NAME                              READY   STATUS    RESTARTS   AGE
hello-k8s-http-86795b976c-kqssg   1/1     Running   0          112s

Para poder acceder a ella, necesitas consultar los servicios disponibles:

NAME             TYPE           CLUSTER-IP   EXTERNAL-IP    PORT(S)        AGE
hello-k8s-http   LoadBalancer   10.0.59.84   20.40.132.31   80:32079/TCP   2m10s
kubernetes       ClusterIP      10.0.0.1     <none>         443/TCP        7m18s

y a través de la IP que te haya asignado para el servicio hello-k8s-http, en este caso AKS, debes utilizar la siguiente URL para acceder a tu función: http://20.40.132.31/api/HttpHello?name=gis

¡Saludos!