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

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