Distributionsetiketter i Azure Container Apps

Distributionsetiketter hjälper dig att tilldela meningsfulla namn, till exempel utveckling, mellanlagring eller prod, till specifika containerrevisioner. När du använder dessa namn effektiviserar du hanteringen av komplexa distributionsscenarier och miljöhantering.

Med hjälp av distributionsetiketter kan du:

  • Tilldela tydliga, beskrivande etiketter till revisioner.
  • Tilldela automatiskt nya revisioner till etiketter för routning och trafikhantering.
  • Dirigera trafik baserat på etiketter i stället för att ändra revisionsnamn.
  • Befordra eller nedgradera revisioner genom att omfördela etiketter.
  • Återställ till tidigare revisioner med hjälp av etiketthistorik.

Viktigt!

Innan du kan använda distributionsetiketter måste du följa stegen för att först aktivera distributionsetiketter i portalen för containerappen.

Viktiga funktioner

Med distributionsetiketter kan du skapa avancerade distributionsstrategier samtidigt som du behåller kontrollen över programmets livscykel med hjälp av följande funktioner:

  • Etiketttilldelning: Skapa och tilldela meningsfulla etiketter till containerrevisioner, vilket gör det enklare att hantera miljöer som dev, mellanlagring och prod.

  • Trafikdelning och A/B-testning: Stöd för trafikdelning, blindåterställning och A/B-testning möjliggör gradvisa distributioner och testning av nya funktioner.

  • Mellanlagringsversioner och automatisk växling: Med automatisk revisionsaktivering kan du sömlöst skapa nya revisioner och tilldela dem till nya eller befintliga etiketter för att ta emot trafik. Eventuella revisioner som inte längre refereras till av en etikett stängs av automatiskt.

Använda distributionsetiketter

Distributionsetiketter är som standard inte tillgängliga för din containerapp. Om du vill aktivera distributionsetiketter följer du dessa steg i Azure-portalen:

  1. Öppna containerappen i Azure Portal.

  2. På menyn går du till avsnittet Programoch väljer Revisioner och repliker.

  3. Välj Distributionsläge.

  4. Välj kolumnen Distributionsetiketter .

  5. Välj Använd.

Skapa en ny etikett

Skapa nya etiketter i portalen baserat på befintliga etiketter. Som standard skapar Container Apps din första etikett med namnet label-1. När du skapar etiketter via CLI eller Bicep kan du associera dem med en befintlig revision eller en ny revision.

  1. Öppna containerappen i Azure Portal.

  2. På menyn går du till avsnittet Program och väljer Etiketter.

  3. Välj Ny etikett.

  4. Välj den befintliga etikett som du vill basera den nya etiketten på.

  5. Ange det nya etikettnamnet i textrutan.

  6. Välj Duplicera.

Etiketthistorik och återgångar

Du kan visa hela historiken för en etikett med hjälp av följande steg:

  1. Öppna containerappen i Azure Portal.

  2. Välj Etiketter på menyn under Program.

  3. Välj Visa historik för den etikett som du är intresserad av.

Använd alternativet Visa historik för alla etiketter för att:

  • Granska etikettens revisionshistorik.
  • Återställ till en tidigare revision genom att peka etiketten på en annan containerrevision.

Använda distributionsetiketter

Följ dessa steg i Azure CLI för att aktivera distributionsetiketter:

  1. Öppna terminalen.

  2. Skapa följande miljövariabler.

     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. Använd följande kommando för att skapa en ny app och revision med etikett:

    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. Om du vill skapa en ny revision med en ny eller befintlig etikett använder du följande kommando:

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

  5. Om du vill visa etiketthistorik använder du följande kommando:

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

  6. Om du vill visa trafik för etikettappen använder du följande kommando:

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

  7. Om du vill lägga till en etikett i en revision använder du följande kommandon:

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

  8. Om du vill ta bort en etikett från en revision använder du följande kommandon:

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

Scenarier som stöds

  • Blågröna distributioner: Hantera enkelt blågröna distributioner genom att märka och växla mellan revisioner. Den här metoden är ett enkelt sätt att hantera fullständiga miljöväxlingar.

  • A/B-testning: Dirigera en procentandel trafik till olika revisioner för funktionstestning. Med den här metoden kan du verifiera nya funktioner med en delmängd användare innan den fullständiga distributionen.

  • Stegvisa distributioner: Öka trafiken gradvis till en ny revision genom att justera trafikprocenttalen.

  • Miljöisolering: Använd etiketter för att underhålla separata utvecklings-, mellanlagrings- och prod-miljöer. Varje miljö kan uppdateras oberoende samtidigt som en tydlig promotionsväg upprätthålls.

Arbetsflödesexempel

Här är ett vanligt arbetsflöde med hjälp av distributionsetiketter:

  1. Skapa inledande etiketter: Skapa etiketter som "stage" och "production" som pekar på samma revision från början.

  2. Uppdatera en etikett: Välj en etikett (till exempel "steg") för att uppdatera den med nya containrar, skalning eller volyminställningar.

  3. Testa ändringarna: När den nya revisionen har distribuerats dirigerar du en del av trafiken till den uppdaterade etiketten.

  4. Höj upp ändringar: När du är säker på produktionsrevisionen uppdaterar du produktionsetiketten så att den pekar på samma revision.

  5. Övervaka och återställ om det behövs: Om det uppstår problem kan du använda etiketthistoriken för att återställa till en tidigare version.

Relaterat innehåll

Revisionsetiketter

  • Uppdaterades senast