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
80u8080ya 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