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
Connection strings
Forma especializada de app settings diseñada para database connectivity. Añade un type ID para indicar el tipo de BBDD.
az webapp config connection-string set \
--resource-group myResourceGroup \
--name myDocumentProcessor \
--connection-string-type SQLAzure \
--settings DefaultConnection="Server=...;Database=...;"
This will be called as SQLAZURECONNSTR_DefaultConnection
Bulk editing
podemos exportar las current settings, editar el JSON y volver a subir
Slot settings
Deployment slots te permite ejecutar diferentes versiones de tu aplicación side-by-side en el mismo service plan. Cada slot tiene su hostname y config propios, pero comparten recursos. Puedes cambiar unos slots por otros para promocionar cambios de INT a PROD.
Las settings que se tengan que quedar en el entorno hay que marcarlas como slot-settings
az webapp config appsettings set \
--resource-group myResourceGroup \
--name myDocumentProcessor \
--slot staging \
--slot-settings \
ENVIRONMENT=integracion \
API_ENDPOINT=https://whatever-int.com/
Key Vault references
(!) IMPORTANTE (!)
Para secretos que necesitan estar centralizados, ser auditados o rotados automáticamente, podemos añadir referencias a valores guardados en el Key Vault.
Esto usa una sintaxis especial
az webapp config appsettings set \
--resource-group myResourceGroup \
--name myDocumentProcessor \
--settings \
API_KEY="@Microsoft.KeyVault(SecretUri=https://myvault.vault.azure.net/secrets/api-key)"
La aplicación lee directamente API_KEY sin saber que viene de un key vault.
Las key vault references requieren de:
- Tener managed identity activado en el webapp
- La managed identity tiene que tener acceso a leer secretos del key vault
Las referencias sin una versión específica se resuelven a la última versión del secreto. Cuando este se rota, App Service la refresca automáticamente pasadas 24 horas o cuando hay un restart.
Verify config
Se puede ver las variables en
https://<app-name>.scm.azurewebsites.net/Env
Additional resources
Configure an App Service App - Azure App Service
Use Key Vault References as App Settings - Azure App Service
Set Up Staging Environments - Azure App Service