Posts Tagged - app-service

Sidecar pattern (App Service)

Un sidecar es un contenedor auxiliar que corre en el mismo entorno que el contenedor principal. Los sidecars añaden capacidades como IA, telemetría o caching sin tener que añadir esas capacidades a la imagen principal.

Este entorno compartido crea sinergias entre los contenedores, pero el patrón no sustituye el caso para múltiples servicios independientes.

Sidecar execution model

Una Service App que use el patrón sidecar tiene un solo contenedor principal y hasta 9 contenedores sidecar.

App Service gestiona a todos los contenedores como si fueran una única aplicación y solo el contenedor principal recibe tráfico HTTP externo. Los sidecars se mantienen alcanzables a través de la red compartida.

Cada contenedor tiene su propia imagen, comando de startup y configuración propia.

Ciclo de vida

  • App Service hace start y stop de todos los contenedores como una única app
  • Cuando se escala cada instancia tiene su set formado por el contenedor principal y sus sidecars - al quitar escalado y remover una instancia, se quita todo su set (contenedor principal + sidecars)
  • Un config deployment puede actualizar una imagen de sidecar de manera independiente de la imagen principal, pero la nueva configuración pertenece a la misma App

Read More

Connect containers and share files (App Service)

Los sidecars se comunican a través de un shared network namespace por lo que la main app puede llamar procesos sin necesitar un endpoint de servicio aparte. Los contenedores también comparten el volumen /home para file exchange.

Conectar a través del shared network namespace

Todos los contenedores se conectan a través de localhost:<port>

ejemplo que crea un HTTP client para el local model endpoint que está en un sidecar

import asyncio

import httpx

MODEL_ENDPOINT = "http://localhost:11434/v1/chat/completions"

async def request_completion(messages: list[dict[str, str]]) -> dict:
    timeout = httpx.Timeout(10.0, connect=2.0)
    async with httpx.AsyncClient(timeout=timeout) as client:
        async with asyncio.timeout(30.0):
            response = await client.post(
                MODEL_ENDPOINT,
                json={"model": "support-model", "messages": messages},
            )
        response.raise_for_status()
        return response.json()

Read More

Configure main and sidecar containers (App Service)

Create a sidecar-enabled app

Crear una app en un plan de Linux existente. --sitecontainers-app reemplaza el viejo DOCKER|<image>.

az webapp create \
	--name <app-name> \
	--resource-group <resource-group> \
	--plan <app-service-plan>
	--sitecontainers-app

También se puede modificar una app que ya exista

az webapp sitecontainers convert \
	--mode sitecontainers \
	--name <app-name> \
	--resource-group <resource-group>

Read More

Troubleshoot containerized apps (App Service)

Container logs

App Service captura el output de los contenedores a stdout y stderr. Se puede activar container logging para persistir estos logs y hacerlos accesibles a través del portal y CLI.

Si los activamos mediante filesystem los podemos acceder en /home/LogFiles

Log stream

Log Stream nos da acceso en tiempo real al output del contenedor. Muestra el output de todas las instancias que haya e incluye IDs para diferenciarlas.

Diagnostic console (Kudu)

Kudu (SCM site) es una consola avanzada de diagnóstico para App Service. Da acceso a app configs, log files en storages y endpoints de diagnóstico

Se accede mediante un site separado de la app y requiere autenticación para hacer management de la web

https://<app-name>.scm.azurewebsites.net

Read More

Configure container runtime (App Service)

El container runtime controla como el App Service ejecuta el container. Estas settings afectan a:

  • container startup
  • network config
  • file system behavior
  • health monitoring

Startup commands

App Service corre containers usando el entrypoint y los comandos definidos en el Dockerfile. Se puede hacer un override de estos defaults con un custom startup command

Escenarios donde esto puede ser necesario:

  • Pasar args que sean específicos por entorno
  • Run database migrations antes de ejecutar la aplicación
  • Start múltiples procesos dentro del contenedor
  • Override default framework configs

Este startup command reemplaza las instrucciones CMD del Dockerfile.

az webapp config set \
	--resource-group myResourceGroup \
	--name myDocumentProcessor \
	--startup-file "gunicorn --bind=0.0.0.0:8000 --workers=4 app:application"
	
	# opción para shell
	--startup-file "/bin/bash -c 'python migrate.py && gunicorn app:application'"

Read More

Configure app settings (App Service)

App settings

Settings clave-valor que se inyectan como variables de entorno. Se encriptan todos los valores y solo se desencriptan al inyectarlos en el contenedor.

declaración

az webapp config appsettings set \
	--resource-group myResourceGroup \
	--name myDocumentProcessor \
	--settings \
		STORAGE_ACCOUNT_NAME=mystorageacc \
		LOG_LEVEL=INFO \
		MAX_DOCUMENT_SIZE_MB=50

uso en Python, incluyendo default values

import os

storage_account = os.environ.get('STORAGE_ACCOUNT_NAME')
log_level = os.environ.get('LOG_LEVEL', 'WARNING')
max_size = int(os.environ.get('MAX_DOCUMENT_SIZE_MB', 10))

App settings que contengan : se convierten en __. Por ejemplo ConnectionStrings:DefaultConnection pasa a ser ConnectionStrings__DefaultConnection

Read More

Azure App Service CLI

Deploy to App Service

From ACR

Crear el webapp y asignar la container image usando ACR como registry.

az webapp create \
	--resource-group myResourceGroup \
	--plan myAppServicePlan \
	--name myDocumentProcessor \
	--container-image-name myregistry.azurecr.io/docprocessor:v1

From other container registries

public image containers from Docker Hub. (para repos privados se añade user & pwd).

az webapp create \
	--resource-group myResourceGroup \
	--plan myAppServicePlan \
	--name myWebApp \
	--container-image-name nginx \
	--docker-registry-server-url https://index.docker.io/v1/

Read More

Azure App Service

Azure App Services es una fully managed platform para ejecutar contenedores sin tener que encargarse de la infraestructura.

Permite ejecutar custom Linux containers como webapps (web applications).
Seleccionas una container image del registry y App Service se encarga de la provisión, load balancing y escalado.

Container image sources

Cuando creas una webapp, puedes seleccionar de donde se hace el pull de la container imagen.

  • Azure Container Registry (ACR): es el recomendado para PROD. Se integra con Entra ID para autenticación. Cuando seleccionas ACR, especificas el registro, como te autenticas, el nombre y la tag de la imagen
  • Otro container registry: cualquiera público como Docker Hub, GitHub Container Registry o self-hosted

Read More