Azure Functions en Kubernetes

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.

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!