Gestire le revisioni in App contenitore di Azure

App Contenitore di Azure consente all'app contenitore di supportare più revisioni. Con questa funzionalità, è possibile attivare e disattivare le revisioni e controllare la quantità di traffico inviato a ogni revisione. Per altre informazioni sulle revisioni, vedere Revisioni in App Azure Container.

Una revisione viene creata quando si distribuisce per la prima volta l'applicazione. Le nuove revisioni vengono create quando si aggiorna l'applicazione con modifiche all'ambito di revisione. Puoi anche aggiornare la tua app contenitore in base a una revisione specifica.

Questo articolo descrive i comandi per gestire le revisioni dell'app contenitore. Per altre informazioni sui comandi di App contenitore, vedere az containerapp. Per altre informazioni sui comandi per gestire le revisioni, vedere az containerapp revision.

Aggiornamento dell'app contenitore

Per aggiornare un'app contenitore, usare il az containerapp update comando . Con questo comando è possibile modificare variabili di ambiente, risorse di calcolo, parametri di scalabilità e distribuire un'immagine diversa. Se il tuo aggiornamento dell'app contenitore include modifiche all'ambito di revisione, viene generata una nuova revisione.

az containerapp update \
  --name <APPLICATION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --image <IMAGE_NAME>

$ImageParams = @{
    Name = '<ContainerName>'
    Image = 'mcr.microsoft.com/k8se/quickstart'
}
$TemplateObj = New-AzContainerAppTemplateObject @ImageParams

$UpdateArgs = @{
  Name = '<ApplicationName>'
  ResourceGroupName = '<ResourceGroupName>'
  Location = '<Location>'
}
Update-AzContainerApp @UpdateArgs

È anche possibile aggiornare l'app contenitore con il comando Revisione copia .

Elenco revisioni

Elencare tutte le revisioni associate all'app contenitore con az containerapp revision list. Per altre informazioni su questo comando, vedere az containerapp revision list

az containerapp revision list \
  --name <APPLICATION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  -o table

$CmdArgs = @{
  ContainerAppName = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
}

Get-AzContainerAppRevision @CmdArgs

Visualizzazione revisione

Visualizzare i dettagli relativi a una revisione specifica usando il az containerapp revision show comando .

az containerapp revision show \
  --name <APPLICATION_NAME> \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME>

$CmdArgs = @{
  ContainerAppName = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
  RevisionName = '<REVISION_NAME>'
}

$RevisionObject = (Get-AzContainerAppRevision @CmdArgs) | Select-Object -Property *
echo $RevisionObject

Copia revisione

Per creare una nuova revisione basata su una revisione esistente, usare .az containerapp revision copy App contenitore usa la configurazione della revisione esistente, che è quindi possibile modificare.

Con questo comando è possibile modificare variabili di ambiente, risorse di calcolo, parametri di scalabilità e distribuire un'immagine diversa. È anche possibile usare un file YAML per definire queste e altre opzioni e parametri di configurazione. Per altre informazioni su questo comando, vedere az containerapp revision copy.

In questo esempio viene copiata la revisione più recente e vengono impostati i parametri delle risorse di calcolo. (Sostituisci il <SEGNAPOSTO> con i valori.

az containerapp revision copy \
  --name <APPLICATION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --cpu 0.75 \
  --memory 1.5Gi

az containerapp revision copy `
  --name <APPLICATION_NAME> `
  --resource-group <RESOURCE_GROUP_NAME> `
  --cpu 0.75 `
  --memory 1.5Gi

Attivazione revisione

Attivare una revisione usando il az containerapp revision activate comando .

az containerapp revision activate \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME>

$CmdArgs = @{
  ContainerAppName = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
  RevisionName = '<REVISION_NAME>'
}

Enable-AzContainerAppRevision @CmdArgs

Disattivazione revisione

Disattivare le revisioni che non sono più in uso con il az containerapp revision deactivate comando . La disattivazione arresta tutte le repliche in esecuzione di una revisione.

az containerapp revision deactivate \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME>

$CmdArgs = @{
  ContainerAppName = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
  RevisionName = '<REVISION_NAME>'
}

Disable-AzContainerAppRevision @CmdArgs

Riavvio revisione

Il az containerapp revision restart comando riavvia una revisione.

Quando si modificano i segreti nell'app contenitore, è necessario riavviare le revisioni attive in modo che possano accedere ai segreti.

az containerapp revision restart \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME>

$CmdArgs = @{
  ContainerAppName = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
  RevisionName = '<REVISION_NAME>'
}

Restart-AzContainerAppRevision @CmdArgs

Modalità set di revisioni

La modalità revisione controlla se solo una singola revisione o più revisioni dell'app contenitore possono essere attive contemporaneamente. Per impostare l'app contenitore per supportare la modalità revisione singola o più modalità revisione, usare il az containerapp revision set-mode comando .

L'impostazione predefinita è la modalità di revisione singola. Per altre informazioni su questo comando, vedere az containerapp revision set-mode.

I valori della modalità sono single o multiple. La modifica della modalità di revisione non crea una nuova revisione.

Esempio: sostituire i <SEGNAPOSTO> con i valori.

az containerapp revision set-mode \
  --name <APPLICATION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --mode <REVISION_MODE>

$CmdArgs = @{
  Name = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
  Location = '<LOCATION>'
  ConfigurationActiveRevisionMode = '<REVISION_MODE>'
}

Update-AzContainerApp @CmdArgs

Etichette di revisione

Le etichette forniscono un URL univoco che è possibile usare per indirizzare il traffico a una revisione. È possibile spostare un'etichetta tra le revisioni per reindirizzare il traffico indirizzato all'URL dell'etichetta a una revisione diversa. Per altre informazioni sulle etichette di revisione, vedere Etichette di revisione.

È possibile aggiungere e rimuovere un'etichetta da una revisione. Per altre informazioni sui comandi delle etichette, vedere az containerapp revision label

Aggiunta di un'etichetta di revisione

Per aggiungere un'etichetta a una revisione, usare il az containerapp revision label add comando .

È possibile assegnare un'etichetta solo a una revisione alla volta e una revisione può essere assegnata solo a un'etichetta. Se la revisione specificata ha un'etichetta, il comando add sostituisce l'etichetta esistente.

In questo esempio viene aggiunta un'etichetta a una revisione: (sostituire i <SEGNAPOSTO> con i valori specificati).

az containerapp revision label add \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --label <LABEL_NAME>

az containerapp revision label add `
  --revision <REVISION_NAME> `
  --resource-group <RESOURCE_GROUP_NAME> `
  --label <LABEL_NAME>

Rimozione dell'etichetta di revisione

Per rimuovere un'etichetta da una revisione, usare il az containerapp revision label remove comando .

In questo esempio viene rimossa un'etichetta in una revisione: (sostituire i <SEGNAPOSTO> con i valori specificati).

az containerapp revision label remove \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --label <LABEL_NAME>

az containerapp revision label remove `
  --revision <REVISION_NAME> `
  --resource-group <RESOURCE_GROUP_NAME> `
  --label <LABEL_NAME>

Suddivisione del traffico

Applicato assegnando valori percentuali, è possibile decidere come bilanciare il traffico tra revisioni diverse. Le regole di suddivisione del traffico vengono assegnate impostando pesi a revisioni diverse in base al nome o all'etichetta. Per altre informazioni, vedere Suddivisione del traffico.

Passaggi successivi

• Revisioni nelle app Azure Container
• Gestione del ciclo di vita delle applicazioni in App Azure Container