Distribuzione su Azure

Panoramica

Questa guida ti accompagna attraverso la distribuzione di CaseBender su Azure utilizzando immagini Docker precostruite con Azure Container Apps e servizi gestiti.

Prerequisiti

Account Azure
Azure CLI installato
Docker installato

Passo 1: Configurazione Iniziale

Installa e Configura Azure CLI

# Usando Homebrew
brew install azure-cli

# Accedi ad Azure
az login

# Configura Docker per ACR
az acr login --name casebenderacr

# Installa Azure CLI
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

# Accedi ad Azure
az login

# Configura Docker per ACR
az acr login --name casebenderacr

# Usando winget
winget install -e --id Microsoft.AzureCLI

# Accedi ad Azure
az login

# Configura Docker per ACR
az acr login --name casebenderacr

Inizializza Progetto

# Imposta variabili
RESOURCE_GROUP="casebender-rg"
LOCATION="eastus"

# Crea gruppo di risorse
az group create --name $RESOURCE_GROUP --location $LOCATION

# Abilita servizi richiesti
az provider register --namespace Microsoft.ContainerRegistry
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.Storage

Passo 2: Configura l’Infrastruttura Azure

Connetti archiviazione Blob esistente

CaseBender usa contenitori Blob privati di proprietà del cliente. Non crea, configura, svuota né elimina account o contenitori. Provisiona contenitori distinti quarantine, records ed ephemeral prima di questa distribuzione. Il codice Azure Blob è implementato con l’ID provider canonico azure. Non è attualmente dichiarato supportato in scripts/storage/certification-matrix.json. Completa la qualificazione live prima di dichiarare il supporto di produzione. Usa un’identità gestita assegnata dal sistema o dall’utente tramite DefaultAzureCredential. Assegna Storage Blob Data Contributor solo all’ambito del contenitore richiesto. Non elencare le chiavi dell’account né concedere l’amministrazione dell’account di archiviazione.

az storage account show \
  --name casebenderstorage \
  --resource-group $RESOURCE_GROUP

az storage container show \
  --name casebender \
  --account-name casebenderstorage \
  --auth-mode login

az identity create \
  --name casebender-storage-identity \
  --resource-group $RESOURCE_GROUP

IDENTITY_ID=$(az identity show \
  --name casebender-storage-identity \
  --resource-group $RESOURCE_GROUP \
  --query id -o tsv)

STORAGE_ACCOUNT_ID="$(az storage account show \
  --name casebenderstorage \
  --resource-group $RESOURCE_GROUP \
  --query id -o tsv)"

az role assignment create \
  --assignee-object-id $(az identity show --name casebender-storage-identity --resource-group $RESOURCE_GROUP --query principalId -o tsv) \
  --assignee-principal-type ServicePrincipal \
  --role "Storage Blob Data Contributor" \
  --scope "${STORAGE_ACCOUNT_ID}/blobServices/default/containers/casebender"

Le variabili canoniche sono STORAGE_PROVIDER=azure, AZURE_STORAGE_ACCOUNT e AZURE_CONTAINER. azure-blob e AZURE_STORAGE_CONTAINER non sono nomi di runtime validi. Vedi Panoramica dello storage e Baseline di sicurezza dello storage.

Configura Azure Database per PostgreSQL

# Crea server PostgreSQL
az postgres flexible-server create \
  --resource-group $RESOURCE_GROUP \
  --name casebender-db \
  --admin-user superadmin \
  --admin-password <your-secure-password> \
  --sku-name Standard_B2s \
  --storage-size 32 \
  --version 14

# Crea database
az postgres flexible-server db create \
  --resource-group $RESOURCE_GROUP \
  --server-name casebender-db \
  --database-name casebender

Configura Azure Cache per Redis

# Crea cache Redis
az redis create \
  --resource-group $RESOURCE_GROUP \
  --name casebender-redis \
  --sku Basic \
  --vm-size c0 \
  --location $LOCATION

Passo 3: Crea e Configura Container Registry

# Crea Azure Container Registry
az acr create \
  --resource-group $RESOURCE_GROUP \
  --name casebenderacr \
  --sku Standard \
  --admin-enabled true

# Ottieni credenziali registry
ACR_USERNAME=$(az acr credential show --name casebenderacr --query username -o tsv)
ACR_PASSWORD=$(az acr credential show --name casebenderacr --query "passwords[0].value" -o tsv)

# Scarica immagini CaseBender
docker pull casebender/casebender:latest
docker pull casebender/workflow-processor:latest
docker pull casebender/misp-processor:latest

# Tagga immagini per ACR
docker tag casebender/casebender:latest casebenderacr.azurecr.io/casebender/app:latest
docker tag casebender/workflow-processor:latest casebenderacr.azurecr.io/casebender/workflow-processor:latest
docker tag casebender/misp-processor:latest casebenderacr.azurecr.io/casebender/misp-processor:latest

# Carica immagini su ACR
docker push casebenderacr.azurecr.io/casebender/app:latest
docker push casebenderacr.azurecr.io/casebender/workflow-processor:latest
docker push casebenderacr.azurecr.io/casebender/misp-processor:latest

Passo 4: Distribuisci Servizi

Crea Ambiente Container Apps

# Crea ambiente Container Apps
az containerapp env create \
  --name casebender-env \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION

# Crea applicazione principale
az containerapp create \
  --name casebender-app \
  --resource-group $RESOURCE_GROUP \
  --environment casebender-env \
  --image casebenderacr.azurecr.io/casebender/app:latest \
  --target-port 3000 \
  --ingress external \
  --registry-server casebenderacr.azurecr.io \
  --registry-username $ACR_USERNAME \
  --registry-password $ACR_PASSWORD \
  --user-assigned-identity $IDENTITY_ID \
  --env-vars \
    AUTH_SECRET=<your-auth-secret> \
    AUTH_SALT=<your-auth-salt> \
    POSTGRES_PRISMA_URL="postgresql://superadmin:<password>@casebender-db.postgres.database.azure.com:5432/casebender" \
    REDIS_URL="redis://casebender-redis.redis.cache.windows.net:6380?ssl=true&password=<redis-key>" \
    STORAGE_PROVIDER="azure" \
    AZURE_STORAGE_ACCOUNT="casebenderstorage" \
    AZURE_CONTAINER="casebender"

# Crea processore workflow
az containerapp create \
  --name workflow-processor \
  --resource-group $RESOURCE_GROUP \
  --environment casebender-env \
  --image casebenderacr.azurecr.io/casebender/workflow-processor:latest \
  --registry-server casebenderacr.azurecr.io \
  --registry-username $ACR_USERNAME \
  --registry-password $ACR_PASSWORD \
  --min-replicas 1 \
  --max-replicas 1 \
  --env-vars \
    POSTGRES_PRISMA_URL="postgresql://superadmin:<password>@casebender-db.postgres.database.azure.com:5432/casebender" \
    REDIS_URL="redis://casebender-redis.redis.cache.windows.net:6380?ssl=true&password=<redis-key>"

# Crea processore MISP
az containerapp create \
  --name misp-processor \
  --resource-group $RESOURCE_GROUP \
  --environment casebender-env \
  --image casebenderacr.azurecr.io/casebender/misp-processor:latest \
  --registry-server casebenderacr.azurecr.io \
  --registry-username $ACR_USERNAME \
  --registry-password $ACR_PASSWORD \
  --min-replicas 1 \
  --max-replicas 1 \
  --env-vars \
    POSTGRES_PRISMA_URL="postgresql://superadmin:<password>@casebender-db.postgres.database.azure.com:5432/casebender" \
    REDIS_URL="redis://casebender-redis.redis.cache.windows.net:6380?ssl=true&password=<redis-key>"

Passo 5: Configura Azure Front Door

# Crea profilo Front Door
az afd profile create \
  --profile-name casebender-afd \
  --resource-group $RESOURCE_GROUP \
  --sku Standard_AzureFrontDoor

# Crea endpoint
az afd endpoint create \
  --endpoint-name casebender \
  --profile-name casebender-afd \
  --resource-group $RESOURCE_GROUP

# Crea gruppo di origine
az afd origin-group create \
  --origin-group-name casebender-origin-group \
  --profile-name casebender-afd \
  --resource-group $RESOURCE_GROUP \
  --probe-path "/" \
  --probe-protocol Http \
  --probe-request-type GET

# Aggiungi origine
az afd origin create \
  --origin-group-name casebender-origin-group \
  --origin-name casebender-origin \
  --profile-name casebender-afd \
  --resource-group $RESOURCE_GROUP \
  --host-name <your-container-app-url> \
  --origin-host-header <your-container-app-url> \
  --priority 1 \
  --weight 1000 \
  --enabled-state Enabled

Passo 6: Configura Dominio Personalizzato (Opzionale)

# Aggiungi dominio personalizzato a Front Door
az afd custom-domain create \
  --custom-domain-name casebender-domain \
  --host-name your-domain.com \
  --profile-name casebender-afd \
  --resource-group $RESOURCE_GROUP \
  --minimum-tls-version TLS12

# Abilita HTTPS
az afd custom-domain enable-https \
  --custom-domain-name casebender-domain \
  --profile-name casebender-afd \
  --resource-group $RESOURCE_GROUP

Monitoraggio e Manutenzione

Configura Application Insights

# Crea Application Insights
az monitor app-insights component create \
  --app casebender-insights \
  --location $LOCATION \
  --resource-group $RESOURCE_GROUP \
  --application-type web

# Ottieni chiave di strumentazione
az monitor app-insights component show \
  --app casebender-insights \
  --resource-group $RESOURCE_GROUP \
  --query instrumentationKey \
  --output tsv

Configura Avvisi

# Crea gruppo di azioni
az monitor action-group create \
  --name casebender-alerts \
  --resource-group $RESOURCE_GROUP \
  --action email admin email@yourdomain.com

# Crea regola di avviso
az monitor metrics alert create \
  --name "high-cpu-usage" \
  --resource-group $RESOURCE_GROUP \
  --scopes <container-app-resource-id> \
  --condition "avg CPU > 80" \
  --window-size 5m \
  --evaluation-frequency 1m \
  --action <action-group-id>

Visualizza Log

# Visualizza log container app
az containerapp logs show \
  --name casebender-app \
  --resource-group $RESOURCE_GROUP \
  --follow

Configurazione Scalabilità

# Configura regole di scalabilità
az containerapp update \
  --name casebender-app \
  --resource-group $RESOURCE_GROUP \
  --min-replicas 1 \
  --max-replicas 10 \
  --scale-rule-name http-rule \
  --scale-rule-type http \
  --scale-rule-http-concurrency 50

Backup e Disaster Recovery

Configura Backup Database

# Abilita backup automatici
az postgres flexible-server update \
  --resource-group $RESOURCE_GROUP \
  --name casebender-db \
  --backup-retention 7

Configura Geo-Replicazione

# Crea risorse regione secondaria
az postgres flexible-server replica create \
  --name casebender-db-secondary \
  --source-server casebender-db \
  --resource-group $RESOURCE_GROUP \
  --location westus

Migliori Pratiche di Sicurezza

Abilita Azure Defender per tutti i servizi
Implementa Azure Private Link
Usa Identità Gestite
Valutazioni di sicurezza regolari
Abilita logging diagnostico

Ottimizzazione dei Costi

Usa piano consumption per Container Apps
Implementa regole di auto-scaling
Scegli livelli di servizio appropriati
Monitora pattern di utilizzo
Usa Istanze Riservate Azure

Prossimi Passi

Configura CI/CD con Azure DevOps
Implementa monitoraggio completo
Configura disaster recovery
Rivedi conformità di sicurezza

Iniziare

Distribuzione

Gestione degli Avvisi

Gestione dei Casi

Gestione delle Attività

Analisi

Verifiche

Impostazioni

Distribuzione su Azure

Panoramica

Prerequisiti

Passo 1: Configurazione Iniziale

Installa e Configura Azure CLI

Inizializza Progetto

Passo 2: Configura l’Infrastruttura Azure

Connetti archiviazione Blob esistente

Configura Azure Database per PostgreSQL

Configura Azure Cache per Redis

Passo 3: Crea e Configura Container Registry

Passo 4: Distribuisci Servizi

Crea Ambiente Container Apps

Passo 5: Configura Azure Front Door

Passo 6: Configura Dominio Personalizzato (Opzionale)

Monitoraggio e Manutenzione

Configura Application Insights

Configura Avvisi

Visualizza Log

Configurazione Scalabilità

Backup e Disaster Recovery

Configura Backup Database

Configura Geo-Replicazione

Migliori Pratiche di Sicurezza

Ottimizzazione dei Costi

Prossimi Passi

​Panoramica

​Prerequisiti

​Passo 1: Configurazione Iniziale

​Installa e Configura Azure CLI

​Inizializza Progetto

​Passo 2: Configura l’Infrastruttura Azure

​Connetti archiviazione Blob esistente

​Configura Azure Database per PostgreSQL

​Configura Azure Cache per Redis

​Passo 3: Crea e Configura Container Registry

​Passo 4: Distribuisci Servizi

​Crea Ambiente Container Apps

​Passo 5: Configura Azure Front Door

​Passo 6: Configura Dominio Personalizzato (Opzionale)

​Monitoraggio e Manutenzione

​Configura Application Insights

​Configura Avvisi

​Visualizza Log

​Configurazione Scalabilità

​Backup e Disaster Recovery

​Configura Backup Database

​Configura Geo-Replicazione

​Migliori Pratiche di Sicurezza

​Ottimizzazione dei Costi

​Prossimi Passi

Panoramica

Prerequisiti

Passo 1: Configurazione Iniziale

Installa e Configura Azure CLI

Inizializza Progetto

Passo 2: Configura l’Infrastruttura Azure

Connetti archiviazione Blob esistente

Configura Azure Database per PostgreSQL

Configura Azure Cache per Redis

Passo 3: Crea e Configura Container Registry

Passo 4: Distribuisci Servizi

Crea Ambiente Container Apps

Passo 5: Configura Azure Front Door

Passo 6: Configura Dominio Personalizzato (Opzionale)

Monitoraggio e Manutenzione

Configura Application Insights

Configura Avvisi

Visualizza Log

Configurazione Scalabilità

Backup e Disaster Recovery

Configura Backup Database

Configura Geo-Replicazione

Migliori Pratiche di Sicurezza

Ottimizzazione dei Costi

Prossimi Passi