Verwalten von Revisionen in Azure Container Apps

Mit Azure Container-Apps kann Ihre Container-App mehrere Überarbeitungen unterstützen. Mit diesem Feature können Sie Überarbeitungen aktivieren und deaktivieren und die Menge an Datenverkehr steuern, die an jede Überarbeitung gesendet wird. Weitere Informationen zu Überarbeitungen finden Sie unter Überarbeitungen in Azure Container Apps.

Beim ersten Bereitstellen der Anwendung wird eine Überarbeitung erstellt. Neue Überarbeitungen werden erstellt, wenn Sie Ihre Anwendung mit Änderungen auf Überarbeitungsebene aktualisieren. Sie können Ihre Container-App auch anhand einer bestimmten Überarbeitung aktualisieren.

In diesem Artikel werden die Befehle zum Verwalten der Überarbeitungen Ihrer Container-App beschrieben. Weitere Informationen zu Container Apps finden Sie unter az containerapp. Weitere Informationen zu Befehlen zum Verwalten von Überarbeitungen finden Sie unter az containerapp revision.

Aktualisieren der Container-App

Verwenden Sie den Befehl az containerapp update, um eine Container-App zu aktualisieren. Mit diesem Befehl können Sie Umgebungsvariablen, Computeressourcen und Skalierungsparameter bearbeiten und ein anderes Image bereitstellen. Wenn das Update Ihrer Container-App Änderungen auf Revisionsebene enthält, wird eine neue Revision generiert.

Bash

In diesem Beispiel wird das Containerimage aktualisiert. Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.

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

PowerShell

Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.

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

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

Sie können Ihre Container-App auch mit dem Befehl Revision copy aktualisieren.

Revision list

Listen Sie mit az containerapp revision list alle Revisionen auf, die Ihrer Container-App zugeordnet sind. Weitere Informationen zu diesem Befehl finden Sie unter az containerapp revision list.

Bash

Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.

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

PowerShell

Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.

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

Get-AzContainerAppRevision @CmdArgs

Revision show

Zeigen Sie Details zu einer bestimmten Überarbeitung mithilfe des Befehls az containerapp revision show an.

Bash

Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.

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

PowerShell

Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.

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

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

Revision copy

Wenn Sie eine neue Überarbeitung auf Basis einer bereits vorhandenen Überarbeitung erstellen möchten, verwenden Sie den Befehl az containerapp revision copy. Container Apps nutzt die Konfiguration der vorhandenen Überarbeitung, die Sie dann ändern können.

Mit diesem Befehl können Sie Umgebungsvariablen, Computeressourcen und Skalierungsparameter bearbeiten und ein anderes Image bereitstellen. Sie können auch eine YAML-Datei verwenden, um diese und andere Konfigurationsoptionen und -parameter zu definieren. Weitere Informationen zu diesem Befehl finden Sie unter az containerapp revision copy.

In diesem Beispiel werden die neuesten Überarbeitungen kopiert und die Computeressourcenparameter festgelegt. (Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.)

Bash

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

PowerShell

Im folgenden Beispiel wird demonstriert, wie eine Container-App-Revision mithilfe des Azure CLI-Befehls kopiert wird. Es gibt keinen entsprechenden PowerShell-Befehl.

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

Revision activate

Aktivieren Sie eine Überarbeitung mithilfe des Befehls az containerapp revision activate.

Bash

Beispiel: (Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.)

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

PowerShell

Beispiel: (Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.)

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

Enable-AzContainerAppRevision @CmdArgs

Revision deactivate

Deaktivieren Sie Überarbeitungen, die nicht mehr verwendet werden, mithilfe des Befehls az containerapp revision deactivate. Die Deaktivierung beendet alle ausgeführten Replikate einer Revision.

Bash

Beispiel: (Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.)

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

PowerShell

Beispiel: (Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.)

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

Disable-AzContainerAppRevision @CmdArgs

Revision restart

Der Befehl az containerapp revision restart startet eine Überarbeitung neu.

Wenn Sie Geheimnisse in Ihrer Container-App ändern, müssen Sie die aktiven Überarbeitungen neu starten, damit sie auf die Geheimnisse zugreifen können.

Bash

Beispiel: (Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.)

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

PowerShell

Beispiel: (Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.)

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

Restart-AzContainerAppRevision @CmdArgs

Revision set mode

Der Revisionsmodus steuert, ob nur eine einzelne oder mehrere Revisionen Ihrer Container-App gleichzeitig aktiv sein können. Verwenden Sie den Befehl az containerapp revision set-mode, um Ihre Container-App so einzurichten, dass der einfache Überarbeitungsmodus oder der mehrfache Überarbeitungsmodus unterstützt wird.

Die Standardeinstellung ist der einfache Überarbeitungsmodus. Weitere Informationen über diesen Befehl finden Sie unter az containerapp revision set-mode.

Die Moduswerte sind single oder multiple. Durch das Ändern des Überarbeitungsmodus wird keine neue Überarbeitung erstellt.

Beispiel: (Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.)

Bash

Beispiel: (Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.)

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

PowerShell

Beispiel: (Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.)

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

Update-AzContainerApp @CmdArgs

Überarbeitungsbezeichnungen

Bezeichnungen stellen eine eindeutige URL bereit, die Sie verwenden können, um den Datenverkehr an eine Überarbeitung zu leiten. Sie können eine Bezeichnung zwischen Überarbeitungen verschieben, um Datenverkehr an die URL der Bezeichnung an eine andere Überarbeitung weiterzuleiten. Weitere Information zu Überarbeitungsbezeichnungen finden Sie unter Überarbeitungsbezeichnungen.

Sie können eine Bezeichnung zu einer Überarbeitung hinzufügen oder entfernen. Weitere Informationen zu den Bezeichnungsbefehlen finden Sie unter az containerapp revision label.

Revision label add

Verwenden Sie den Befehl az containerapp revision label add, um eine Bezeichnung zu einer Überarbeitung hinzuzufügen.

Sie können einer Überarbeitung jeweils nur eine Bezeichnung zuweisen, und eine Überarbeitung kann nur einer Bezeichnung zugewiesen werden. Wenn die angegebene Überarbeitung über eine Bezeichnung verfügt, ersetzt der add-Befehl die vorhandene Bezeichnung.

In diesem Beispiel wird einer Revision eine Bezeichnung hinzugefügt: (Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.)

Bash

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

PowerShell

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

Revision label remove

Verwenden Sie den Befehl az containerapp revision label remove, um eine Bezeichnung aus einer Überarbeitung zu entfernen.

In diesem Beispiel wird eine Bezeichnung von einer Revision entfernt: (Ersetzen Sie die <PLATZHALTER> durch Ihre Werte.)

Bash

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

PowerShell

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

Trennung von Datenverkehr

Wenn Sie Prozentwerte zuweisen, können Sie entscheiden, wie der Datenverkehr zwischen verschiedenen Revisionen ausgeglichen wird. Regeln für die Trennung von Datenverkehr werden zugewiesen, indem Gewichtungen auf verschiedene Überarbeitungen anhand ihres Namens oder ihrer Bezeichnung festgelegt werden. Weitere Informationen finden Sie unter Trennung von Datenverkehr.

Nächste Schritte

• Überarbeitungen in Azure Container Apps
• Verwaltung des Anwendungslebenszyklus in Azure Container Apps