Verbeter de ophaaltijd van afbeeldingen met Artifact Streaming in Azure Kubernetes Services (AKS) (Preview)

2025-04-17

Rekenworkloads met hoge prestaties omvatten vaak grote afbeeldingen, wat kan leiden tot lange laadtijden voor afbeeldingen en uw implementaties van workloads kan vertragen. Met artefactstreaming op AKS kunt u containerinstallatiekopieën streamen van Azure Container Registry (ACR) naar AKS. AKS haalt alleen de benodigde lagen op voor de initiële pod opstart, waardoor het minder tijd kost om de images op te halen en je workloads te implementeren.

Artefactstreaming kan de tijd tot pod-gereedheid met meer dan 15% verkorten, afhankelijk van de grootte van de installatiekopieën en het werkt het beste voor installatiekopieën <van 30 GB. Op basis van onze tests zagen we dat de opstarttijden voor pods van beelden <10 GB werden verkort van minuten tot seconden. Als u een pod hebt die toegang nodig heeft tot een groot bestand (>30 GB), moet u deze koppelen als een volume in plaats van deze als laag te bouwen. Dit komt omdat als uw pod dat bestand nodig heeft om te starten, het het knooppunt vertraagt. Artifact Streaming is niet ideaal voor leesintensieve afbeeldingen van uw bestandssysteem bij het opstarten. Met artifact streaming wordt het opstarten van pods gelijktijdig, terwijl zonder dit pods serieel worden gestart.

In dit artikel wordt beschreven hoe u de functie Artefactstreaming op uw AKS-knooppuntgroepen inschakelt om artefacten uit ACR te streamen.

Belangrijk

AKS preview-functies zijn beschikbaar op selfservice, opt-in basis. Previews worden geleverd 'zoals het is' en 'voor zover beschikbaar' en zijn uitgesloten van de serviceovereenkomsten en beperkte garantie. AKS-previews worden gedeeltelijk gedekt door klantondersteuning op basis van best effort. Daarom zijn deze functies niet bedoeld voor productiegebruik. Zie de volgende ondersteuningsartikelen voor meer informatie:

Notitie

Artefactstreaming (preview) is een voorgesteld alternatief voor klanten die eerder Teleport (preview) gebruiken.

Teleport (preview) op AKS wordt op 15 juli 2025 buiten gebruik gesteld. Migreer naar Artefactstreaming (preview) op AKS of werk uw knooppuntgroepen bij om deze in te stellen --aks-custom-headers EnableACRTeleport=false. Azure Container Registry heeft de Teleport-API verwijderd, wat betekent dat knooppunten waarvoor Teleport is ingeschakeld, afbeeldingen uit Azure Container Registry ophalen net als elk ander AKS-knooppunt zonder Teleport. Na 15 juli 2025 kunnen AKS-knooppuntgroepen waarvoor Teleport (preview) is ingeschakeld, onderbrekingen en knooppuntinrichtingsfouten ondervinden. Zie aka.ms/aks/teleport-retirement voor meer informatie.

Vereisten

U hebt een bestaand AKS-cluster met ACR-integratie nodig. Als u er nog geen hebt, kunt u er een maken met behulp van Verificatie met ACR vanuit AKS.
Artefactstreaming inschakelen op ACR.
Voor deze functie is Kubernetes versie 1.25 of hoger vereist. Zie Controleren op beschikbare AKS-clusterupgrades om de versie van uw AKS-cluster te controleren.

Notitie

Artefactstreaming wordt alleen ondersteund in Ubuntu 22.04-, Ubuntu 20.04- en Azure Linux-knooppuntgroepen. Windows-knooppuntgroepen worden niet ondersteund.

`aks-preview` De CLI-extensie installeren

Installeer de aks-preview CLI-extensie met behulp van de az extension add opdracht.
```
az extension add --name aks-preview
```
Werk de extensie bij om ervoor te zorgen dat u de nieuwste versie hebt geïnstalleerd met behulp van de az extension update opdracht.
```
az extension update --name aks-preview
```

`ArtifactStreamingPreview` De functievlag registreren in uw abonnement

Registreer de ArtifactStreamingPreview functievlag in uw abonnement met behulp van de az feature register opdracht.
```
az feature register --namespace Microsoft.ContainerService --name ArtifactStreamingPreview
```

Artefactstreaming inschakelen op ACR

Inschakelen op ACR is een vereiste voor artefactstreaming op AKS. Zie Artefactstreaming op ACR voor meer informatie.

Maak een Azure-resourcegroep om uw ACR-exemplaar op te slaan met behulp van de az group create opdracht.
```
az group create --name myStreamingTest --location westus
```
Maak een nieuwe Premium SKU Azure Container Registry met behulp van de az acr create opdracht met de --sku Premium vlag.
```
az acr create --resource-group myStreamingTest --name mystreamingtest --sku Premium
```
Configureer het standaard ACR-exemplaar voor uw abonnement met behulp van de az configure opdracht.
```
az configure --defaults acr="mystreamingtest"
```

Push ofwel importeer een image in het register met behulp van de az acr import opdracht.

az acr import --source docker.io/jupyter/all-spark-notebook:latest --repository jupyter/all-spark-notebook:latest

Maak een streaming-artefact van de afbeelding met behulp van de az acr artifact-streaming create-opdracht.
```
az acr artifact-streaming create --image jupyter/all-spark-notebook:latest
```
Controleer de gegenereerde artifactstreaming door de az acr manifest list-referrers opdracht.
```
az acr manifest list-referrers --name jupyter/all-spark-notebook:latest
```

Artefactstreaming inschakelen op AKS

Artefactstreaming inschakelen voor een nieuwe knooppuntgroep

Maak een nieuwe knooppuntgroep waarvoor Artefactstreaming is ingeschakeld met behulp van de az aks nodepool add opdracht .--enable-artifact-streaming

az aks nodepool add \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --name myNodePool \
    --enable-artifact-streaming

Artefactstreaming inschakelen voor een bestaande knooppuntgroep

Werk een bestaande knooppool bij om Artefactstreaming in te schakelen met behulp van de az aks nodepool update opdracht--enable-artifact-streaming.

az aks nodepool update \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --name myNodePool \
    --enable-artifact-streaming

Controleren of artefactstreaming is ingeschakeld

Nu u Artefactstreaming hebt ingeschakeld op een premium ACR en dat hebt verbonden met een AKS-knooppuntgroep, waarvoor Artefactstreaming is ingeschakeld, zullen nieuw geïmplementeerde pods op dit cluster met een afbeelding uit de ACR waarvoor Artefactstreaming is ingeschakeld, verminderingen in pull-tijden ervaren.

Controleer of artefactstreaming is ingeschakeld voor uw knooppuntgroep met behulp van de az aks nodepool show opdracht.
```
az aks nodepool show --resource-group myResourceGroup --cluster-name myAKSCluster --name myNodePool --query artifactStreamingProfile
```
Controleer in de uitvoer of het Enabled veld is ingesteld op true.

Volgende stappen

In dit artikel wordt beschreven hoe u Artifact Streaming op uw AKS-knooppuntgroepen inschakelt om artefacten vanuit ACR sneller te streamen en zo de tijd voor het ophalen van images te verminderen. Voor meer informatie over het werken met containerimages in AKS, zie Best practices voor het beheren en beveiligen van containerimages in AKS.

Delen via