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>

Definir roles y puertos

Cada contenedor necesita un nombre único, una imagen y un puerto (si necesita recibir network conns).

El main process debe escuchar en 80 u 8080 ya que App Service solo soporta esos puertos para tráfico HTTP externo

Obviamente, cada proceso necesita su puerto único e independiente

# creación de un main container
az webapp sitecontainers create \
	--name <app-name> \
	--resource-group <resource-group> \
	--container-name main-api \
	--image <registry-name>.azurecr.io/support-api:<tag> \
	--target-port 8080 \
	--is-main

si omitimos --is-main se pone a false automáticamente

# el puerto es opcional. Si el sidecar no acepta network connections se puede omitir
az webapp sitecontainers create \
	--name <app-name> \
	--resource-group <resource-group> \
	--container-name model-server \
	--image <registry-name>.azurecr.io/model-server:<tag> \
	--target-port 11434

Configuración compartida y específica por contenedor

Los App settings se comparten para todos los contenedores de la app. Las variables que pertenezcan a un contenedor deben incluirse dentro de la definición de ese contenedor.

en un primer paso definimos y creamos las settings

az webapp config appsettings set \
	--name <app-name> \
	--resource-group <resource-group> \
	--settings \
		MODEL_ENDPOINT_VALUE=... \
		MODEL_NAME_VALUE=support-model

creamos un json con las specs que queremos por contenedor

[
  {
    "name": "main-api",
    "properties": {
      "image": "<registry-name>.azurecr.io/support-api:<tag>",
      "targetPort": "8080",
      "isMain": true,
      "environmentVariables": [
        {
          "name": "MODEL_ENDPOINT",
          "value": "MODEL_ENDPOINT_VALUE"
        }
      ]
    }
  },
  {
    "name": "model-server",
    "properties": {
      "image": "<registry-name>.azurecr.io/model-server:<tag>",
      "targetPort": "11434",
      "isMain": false,
      "environmentVariables": [
        {
          "name": "MODEL_NAME",
          "value": "MODEL_NAME_VALUE"
        }
      ]
    }
  }
]

aplicamos el json

az webapp sitecontainers create \
	--name <app-name> \
	--resource-group <resource-group> \
	--sitecontainers-spec-file ./sitecontainers-spec.json

Autenticar pulls de container images privadas

ACR puede almacenar las imagenes main y los sidecars. Se puede conectar App Service mediante Managed identity para autenticarse al registro sin tener que poner pwd en la app config.

Se pueden usar system-assigned o user-assigned managed identities. User-assigned es útil cuando varias apps comparten una identidad o la identidad tiene que existir de manera independiente al webapp.

(los mats entran en más detalle pero es un cristo de auth que me supera ahora mismo)

Verificar deployed definitions

listar contenedores definidos en el webapp

az webapp sitecontainers list \
	--name <app-name> \
	--resource-group <resource-group> \
	--output table

inspeccionar uno en detalle

az webapp sitecontainers show \
	--name <app-name> \
	--resource-group <resource-group> \
	--container-name model.-server

Additional resources

Configure sidecars - Azure App Service