Bereitstellungsbezeichnungen in Azure Container-Apps

Bereitstellungsbezeichnungen helfen Ihnen bei der Zuweisung aussagekräftiger Namen, z. B. Entwickler-, Staging- oder Prod-Versionen, zu bestimmten Containerrevisionen. Wenn Sie diese Namen anwenden, optimieren Sie die Behandlung komplexer Bereitstellungsszenarien und der Umgebungsverwaltung.

Mithilfe von Bereitstellungsbezeichnungen können Sie:

• Weisen Sie überarbeitungen klare, beschreibende Bezeichnungen zu.
• Automatisches Zuweisen neuer Überarbeitungen zu Labels für Routing und Datenverkehrs-Management.
• Weiterleiten von Datenverkehr basierend auf Bezeichnungen, anstatt Überarbeitungsnamen zu ändern
• Fördern oder herabstufen von Überarbeitungen durch Neuzuordnung von Labels.
• Führen Sie ein Rollback zu früheren Überarbeitungen mithilfe des Bezeichnungsverlaufs durch.

Von Bedeutung

Bevor Sie Bereitstellungsbezeichnungen verwenden können, müssen Sie die Schritte ausführen, um zuerst Bereitstellungsbezeichnungen im Portal für Ihre Container-App zu aktivieren .

Wichtigste Funktionen

Mithilfe von Bereitstellungsbezeichnungen können Sie komplexe Bereitstellungsstrategien erstellen und gleichzeitig die Kontrolle über Ihren Anwendungslebenszyklus behalten, indem Sie die folgenden Features verwenden:

• Bezeichnungszuweisung: Erstellen und Zuweisen aussagekräftiger Bezeichnungen zu Containerrevisionen, wodurch die Verwaltung von Umgebungen wie Dev, Staging und Prod erleichtert wird.

• Traffic-Splitting & A/B-Tests: Unterstützung für Traffic-Splitting, Blind-Rollback und A/B-Tests ermöglicht schrittweise Rollouts und Tests neuer Features.

• Stagingversionen & automatisches Austauschen: Mit der automatischen Revisionsaktivierung können Sie nahtlos neue Überarbeitungen erstellen und neuen oder vorhandenen Labels zuweisen, um Traffic aktiv zu empfangen. Alle Überarbeitungen, auf die nicht mehr durch ein Label verwiesen wird, werden automatisch heruntergefahren.

Bereitstellungsbezeichnungen verwenden

Standardmäßig sind Bereitstellungslabels in Ihrer Container-App nicht verfügbar. Führen Sie die folgenden Schritte im Azure-Portal aus, um Bereitstellungsbezeichnungen zu aktivieren:

1. Öffnen Sie Ihre Container-App im Azure-Portal.

2. Wählen Sie im Menü unter dem Abschnitt "Anwendung " die Option "Überarbeitungen" und "Replikate" aus.

3. Wählen Sie den Bereitstellungsmodus aus.

4. Wählen Sie die Spalte "Bereitstellungsbezeichnungen" aus .

5. Wählen Sie Anwenden.

Erstellen einer neuen Bezeichnung

Erstellen Sie neue Bezeichnungen im Portal basierend auf vorhandenen Bezeichnungen. Container-Apps erstellen standardmäßig Ihre erste Bezeichnung mit dem Namen "label-1". Wenn Sie Bezeichnungen über die CLI oder Bicep erstellen, können Sie sie jeder vorhandenen Revision oder einer neuen Revision zuordnen.

1. Öffnen Sie Ihre Container-App im Azure-Portal.

2. Wählen Sie im Menü unter dem Abschnitt Anwendung die Option Bezeichnungen aus.

3. Wählen Sie "Neue Bezeichnung" aus.

4. Wählen Sie die vorhandene Bezeichnung aus, auf der Sie Ihre neue Bezeichnung basieren möchten.

5. Geben Sie den neuen Bezeichnungsnamen in das Textfeld ein.

6. Wählen Sie Duplizieren aus.

Bezeichnungsverlauf und Rollbacks

Sie können den vollständigen Verlauf einer Bezeichnung anzeigen, indem Sie die folgenden Schritte ausführen:

1. Öffnen Sie Ihre Container-App im Azure-Portal.

2. Wählen Sie im Menü unter Anwendung die Option Bezeichnungen aus.

3. Wählen Sie " Verlauf anzeigen " für die Bezeichnung aus, an der Sie interessiert sind.

Verwenden Sie die Option " Verlauf anzeigen " für eine beliebige Bezeichnung:

• Überprüfen Sie den Überarbeitungsverlauf der Bezeichnung.
• Führen Sie ein Rollback auf eine vorherige Überarbeitung durch, indem Sie das Label auf eine andere Containerrevision setzen.

Bereitstellungsbezeichnungen verwenden

Führen Sie die folgenden Schritte in der Azure CLI aus, um Bereitstellungsbezeichnungen zu aktivieren:

1. Öffnen Sie Ihr Terminal.

2. Erstellen Sie die folgenden Umgebungsvariablen.

    CONTAINER_APP_NAME="my-container-app"
    CONTAINER_APP_IMAGE="mcr.microsoft.com/k8se/quickstart:latest"
    LOCATION="centralus"
    RESOURCE_GROUP="my-container-apps-rg"
    ENVIRONMENT_NAME="my-container-apps-env"
    TARGET_LABEL="stage"
   

3. Verwenden Sie den folgenden Befehl, um eine neue App und eine Revision mit Bezeichnung zu erstellen:

   az containerapp create \
   --name $CONTAINER_APP_NAME \
   --resource-group $RESOURCE_GROUP \
   --image $CONTAINER_APP_IMAGE \
   --environment $ENVIRONMENT_NAME \
   --location $LOCATION \
   --ingress external \
   --target-port 0 \
   --revisions-mode labels \
   --target-label $TARGET_LABEL
   

4. Verwenden Sie den folgenden Befehl, um eine neue Überarbeitung mit einer neuen oder vorhandenen Bezeichnung zu erstellen:

   az containerapp update \
   --name $CONTAINER_APP_NAME \
   --resource-group $RESOURCE_GROUP \
   --image $CONTAINER_APP_IMAGE \
   --target-label $TARGET_LABEL
   

5. Verwenden Sie den folgenden Befehl, um den Bezeichnungsverlauf anzuzeigen:

   az containerapp label-history show \
   --name $CONTAINER_APP_NAME \
   --resource-group $RESOURCE_GROUP \
   --label $TARGET_LABEL
   

6. Verwenden Sie den folgenden Befehl, um den Datenverkehr der App-Kennzeichnung anzuzeigen:

   az containerapp ingress traffic show \
   --name $CONTAINER_APP_NAME \
   --resource-group $RESOURCE_GROUP \
   

7. Verwenden Sie die folgenden Befehle, um einer Überarbeitung eine Bezeichnung hinzuzufügen:

   az containerapp revision label add \
   --name $CONTAINER_APP_NAME \
   --resource-group $RESOURCE_GROUP \
   --revision $REVISION_NAME \
   --label $TARGET_LABEL
   

8. Verwenden Sie die folgenden Befehle, um eine Bezeichnung aus einer Überarbeitung zu entfernen:

   az containerapp revision label remove \
   --name $CONTAINER_APP_NAME \
   --resource-group $RESOURCE_GROUP \
   --label $TARGET_LABEL
   

Unterstützte Szenarien

• Blue-Green Deployments: Verwalten Sie Blue-Green Deployments auf einfache Weise, indem Sie die Überarbeitungen bezeichnen und zwischen ihnen wechseln. Dieser Ansatz bietet eine einfache Möglichkeit, mit vollständigen Umgebungswechseln umzugehen.

• A/B-Tests: Leiten Sie einen Prozentsatz des Traffics an verschiedene Versionen zur Feature-Erprobung. In dieser Übung können Sie neue Funktionen mit einer Teilmenge von Benutzern vor der vollständigen Bereitstellung überprüfen.

• Mehrstufige Rollouts: Erhöhen Sie den Traffic schrittweise auf eine neue Version, indem Sie die Traffic-Prozentsätze anpassen.

• Umgebungsisolation: Verwenden Sie Bezeichnungen, um separate Entwicklungs-, Staging- und Prod-Umgebungen zu verwalten. Jede Umgebung kann unabhängig aktualisiert werden, während ein klarer Promotion Pfad beibehalten wird.

Workflowbeispiel

Hier ist ein typischer Workflow mit Bereitstellungsetiketten:

1. Erstellen Sie anfängliche Bezeichnungen: Erstellen Sie Bezeichnungen wie "Phase" und "Produktion", die auf die gleiche Überarbeitung verweisen.

2. Aktualisieren einer Bezeichnung: Wählen Sie eine Bezeichnung (z. B. "Phase") aus, um sie mit neuen Containern, Skalierungs- oder Volumeeinstellungen zu aktualisieren.

3. Testen Sie die Änderungen: Wenn die neue Revision bereitgestellt wurde, leiten Sie einen Teil des Datenverkehrs an die aktualisierte Bezeichnung weiter.

4. Änderungen umsetzen: Wenn Sie der Produktionsrevision vertrauen, aktualisieren Sie die Produktionsbezeichnung, sodass sie auf dieselbe Revision verweist.

5. Überwachen und bei Bedarf zurücksetzen: Wenn Probleme auftreten, verwenden Sie den Label-Verlauf, um auf eine frühere Version zurückzusetzen.

Verwandte Inhalte

Überarbeitungsbezeichnungen