Artefaktströmning i Azure Container Registry (förhandsversion)

Artefaktströmning är en funktion i Azure Container Registry som gör att du kan lagra containeravbildningar i ett enda register, hantera och strömma containeravbildningarna till AKS-kluster (Azure Kubernetes Service) i flera regioner. Den här funktionen är utformad för att påskynda containerbaserade arbetsbelastningar för Azure-kunder med hjälp av AKS. Med artefaktströmning kan du enkelt skala arbetsbelastningar utan att behöva vänta på långsamma pull-tider för noden.

Användningsfall

Här följer några scenarier för att använda artefaktströmning:

Distribuera containerbaserade program till flera regioner: Med artefaktströmning kan du lagra containeravbildningar i ett enda register och hantera och strömma containeravbildningar till AKS-kluster i flera regioner. Artefaktströmning distribuerar containerprogram till flera regioner utan att förbruka tid och resurser.

Minska svarstiden för bildhämtning: Artefaktströmning kan minska tiden till poddberedskap med över 15 %, beroende på bildens storlek, och det fungerar bäst för bilder < 30 GB. Den här funktionen minskar svarstiden för avbildningshämtning och snabb start av containrar, vilket är fördelaktigt för programutvecklare och systemarkitekter.

Effektiv skalning av containerbaserade program: Artefaktströmning ger möjlighet att utforma, skapa och distribuera containerbaserade program i hög skala.

Strömningsaspekter för artefakter

Här följer några korta aspekter av artefaktströmning:

• Kunder med nya och befintliga register kan starta artefaktströmning för specifika lagringsplatser eller taggar.

• Kunder kan lagra både den ursprungliga och den strömmande artefakten i ACR genom att starta artefaktströmning.

• Kunder har åtkomst till originalet och den strömmande artefakten även efter att ha inaktiverat artefaktströmning för lagringsplatser eller artefakter.

• Kunder med artefaktströmning och mjuk borttagning aktiverat, tar bort en lagringsplats eller artefakt och sedan tas både de ursprungliga och artefaktuppspelningsversionerna bort. Men endast den ursprungliga versionen är tillgänglig på portalen för mjuk borttagning.

Tillgänglighets- och prisinformation

Artefaktströmning är endast tillgängligt på Premium-tjänstnivåerna (kallas även SKU:er). Artefaktströmning kan öka den totala registerlagringsförbrukningen. Kunder utsätts för fler lagringsavgifter enligt beskrivningen i vår prissättning om förbrukningen överskrider det inkluderade tröskelvärdet på 500 GiB Premium SKU.

Begränsningar i förhandsversionen

Artefaktströmning är för närvarande i förhandsversion. Följande begränsningar gäller:

• Endast avbildningar med Linux AMD64-arkitektur stöds i förhandsversionen.
• Förhandsversionen stöder inte Windows-baserade containeravbildningar och ARM64-avbildningar.
• Förhandsversionen stöder delvis avbildningar med flera arkitekturer, endast AMD64-arkitekturen stöds.
• Om du vill skapa en Ubuntu-baserad nodpool i AKS väljer du Ubuntu version 20.04 eller senare.
• För Kubernetes använder du Kubernetes version 1.26 eller senare eller Kubernetes version > 1.25.
• Endast Premium SKU-register stöder generering av strömmande artefakter i förhandsversionen. Nonpremium SKU-register erbjuder inte den här funktionen under förhandsversionen.
• CMK-register (kundhanterade nycklar) stöds INTE i förhandsversionen.
• Kubernetes regcred stöds för närvarande inte.

Förutsättningar

• Du kan använda Azure Cloud Shell eller en lokal installation av Azure CLI för att köra kommandoexemplen i den här artikeln. Om du vill använda den lokalt krävs version 2.54.0 eller senare. Kör az --version för att hitta versionen. Om du behöver installera eller uppgradera kan du läsa Installera Azure CLI.

• Logga in på Azure-portalen.

Starta artefaktströmning

Starta artefaktströmning med en serie med Azure CLI-kommandon och Azure-portalen för push-överföring, import och generering av strömmande artefakter för containeravbildningar i ett Azure Container Registry (ACR). De här anvisningarna beskriver processen för att skapa en PremiumSKU ACR, importera en bild, generera en strömmande artefakt och hantera artefaktströmningsåtgärden. Ersätt platshållarna med dina faktiska värden om det behövs.

Skicka/importera avbildningen och generera den strömmande artefakten – Azure CLI

Artefaktströmning är tillgängligt på tjänstnivån för Premium-containerregistret . Om du vill starta artefaktströmning uppdaterar du ett register med hjälp av Azure CLI (version 2.54.0 eller senare). Information om hur du installerar eller uppgraderar finns i Installera Azure CLI.

Starta artefaktströmning genom att följa dessa allmänna steg:

Kommentar

Om du redan har ett Premium-containerregister kan du hoppa över det här steget. Om användaren finns på Basic of Standard SKU:er misslyckas följande kommandon. Koden är skriven i Azure CLI och kan köras i ett interaktivt läge. Observera att platshållarna bör ersättas med faktiska värden innan kommandot körs.

1. Skapa ett nytt Azure Container Registry (ACR) med premium-SKU:n via:

   Kör till exempel kommandot az group create för att skapa en Azure-resursgrupp med namnet my-streaming-test i regionen USA, västra och kör sedan kommandot az acr create för att skapa ett Premium Azure Container Registry med namnet mystreamingtest i resursgruppen.

   az group create -n my-streaming-test -l westus
   az acr create -n mystreamingtest -g my-streaming-test -l westus --sku premium
   

2. Skicka eller importera en avbildning till registret via:

   Kör till exempel kommandot [az configure] för att konfigurera standardkommandot ACR och az acr import för att importera en Jupyter Notebook-avbildning från Docker Hub till mystreamingtest ACR.

   az configure --defaults acr="mystreamingtest"
   az acr import -source docker.io/jupyter/all-spark-notebook:latest -t jupyter/all-spark-notebook:latest
   

3. Skapa en artefaktuppspelning från bilden

   Initierar skapandet av en strömmande artefakt från den angivna avbildningen.

   Kör till exempel kommandona az acr artifact-streaming create för att skapa en strömmande artefakt från avbildningen jupyter/all-spark-notebook:latestmystreamingtest i ACR.

   az acr artifact-streaming create --image jupyter/all-spark-notebook:latest
   

Kommentar

Ett åtgärds-ID genereras under processen för framtida referens för att verifiera åtgärdens status.

4. Verifiera den genererade artefaktströmningen i Azure CLI.

   Kör till exempel kommandot az acr manifest list-referrers för att visa en lista över strömmande artefakter för avbildningen mystreamingtestjupyter/all-spark-notebook:latest i ACR.

   az acr manifest list-referrers -n jupyter/all-spark-notebook:latest
   

5. Avbryt skapandet av artefaktströmning (om det behövs)

   Avbryt skapandet av den strömmande artefakten om konverteringen inte är klar än. Åtgärden stoppas.

   Kör till exempel kommandot az acr artifact-streaming cancel för att avbryta konverteringsåtgärden för avbildningen jupyter/all-spark-notebook:latestmystreamingtest i ACR.

   az acr artifact-streaming operation cancel --repository jupyter/all-spark-notebook --id c015067a-7463-4a5a-9168-3b17dbe42ca3
   

6. Starta autokonvertering på lagringsplatsen

   Starta autokonvertering på lagringsplatsen för nyligen pushade eller importerade avbildningar. När de startas utlöser nya avbildningar som skickas till lagringsplatsen genereringen av strömmande artefakter.

   Kommentar

   Automatisk konvertering gäller inte för befintliga bilder. Befintliga avbildningar kan konverteras manuellt.

   Kör till exempel kommandot az acr artifact-streaming update för att starta autokonversion för jupyter/all-spark-notebook lagringsplatsen i mystreamingtest ACR.

   az acr artifact-streaming update --repository jupyter/all-spark-notebook --enable-streaming true
   

7. Kontrollera förloppet för konvertering av direktuppspelning när du har push-överfört en ny avbildning jupyter/all-spark-notebook:newtag till lagringsplatsen ovan.

   Kör till exempel kommandot az acr artifact-streaming show för att kontrollera statusen för konverteringsåtgärden för avbildningen jupyter/all-spark-notebook:newtagmystreamingtest i ACR.

   az acr artifact-streaming operation show --image jupyter/all-spark-notebook:newtag
   

8. När du har verifierat konverteringsstatusen kan du nu ansluta till AKS. Se AKS-dokumentationen.

9. Inaktivera den strömmande artefakten från lagringsplatsen.

   Kör till exempel kommandot az acr artifact-streaming update för att ta bort den strömmande artefakten för avbildningen jupyter/all-spark-notebook:latestmystreamingtest i ACR.

   az acr artifact-streaming update --repository jupyter/all-spark-notebook --enable-streaming false
   

Kommentar

Artefaktströmning kan fungera mellan regioner, oavsett om geo-replikering startas eller inte. Artefaktströmning kan fungera via en privat slutpunkt och kopplas till den.

Skicka/importera avbildningen och generera den strömmande artefakten – Azure-portalen

Artefaktströmning är tillgängligt i PremiumSKU Azure Container Registry. Om du vill starta artefaktströmning uppdaterar du ett register med hjälp av Azure-portalen.

Följ stegen för att skapa artefaktströmning i Azure-portalen.

1. Gå till Azure Container Registry.

2. Välj Lagringsplatser under Tjänsterna på sidomenyn.

3. Välj den senaste importerade avbildningen.

4. Konvertera avbildningen och skapa artefaktströmning i Azure-portalen.

   

5. Kontrollera den strömmande artefakten som genererats från bilden på fliken Refererare.

   

6. Du kan också ta bort artefaktströmningen från lagringsplatsen.

   

7. Du kan också aktivera automatisk konvertering genom att komma åt lagringsplatsen på portalen. Aktiv innebär att autokonvertering är aktiverat på lagringsplatsen. Inaktiv innebär att autokonvertering är inaktiverat på lagringsplatsen.

   

Kommentar

Tillståndet för artefaktströmning på en lagringsplats (inaktiv eller aktiv) avgör om nyligen pushade kompatibla bilder konverteras automatiskt. Som standard är alla lagringsplatser i ett inaktivt tillstånd för artefaktströmning. Det innebär att när nya kompatibla bilder skickas till lagringsplatsen utlöses inte artefaktströmning och bilderna konverteras inte automatiskt. Om du vill starta automatisk konvertering av nyligen push-överförda bilder måste du ange lagringsplatsens artefaktströmning till aktivt tillstånd. När lagringsplatsen är i aktivt tillstånd utlöser alla nya kompatibla containeravbildningar som skickas till lagringsplatsen artefaktströmning. Detta startar den automatiska konverteringen av dessa bilder.

Nästa steg

Felsöka artefaktströmning