Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
As cargas de trabalho de computação de alto desempenho geralmente envolvem imagens grandes, o que pode causar longos tempos de carregamento de imagens e retardar a distribuição das cargas de trabalho. O Streaming de Artefatos no AKS permite transmitir imagens de contêiner do ACR (Registro de Contêiner do Azure) para o AKS. O AKS apenas efetua pull das camadas necessárias para a inicialização inicial do pod, o que reduz o tempo necessário para efetuar pull de imagens e implantar as cargas de trabalho.
O Streaming de Artefatos pode reduzir o tempo de preparação para o pod em mais de 15%, dependendo do tamanho da imagem, e funciona melhor em imagens de <30 GB. Com base em nossos testes, vimos reduções nos tempos de inicialização do pod para imagens de <10 GB de minutos a segundos. Se você tiver um pod que precise de acesso a um arquivo grande (>30 GB), deverá montá-lo como um volume em vez de configurá-lo como uma camada. Isso ocorre porque, se o pod exigir que esse arquivo seja iniciado, ele congestionará o nó. O Streaming de Artefatos não é ideal para ler imagens pesadas do sistema de arquivos, se você precisar disso na inicialização. Com o Streaming de Artefatos, a inicialização do pod torna-se simultânea; sem ele, os pods são iniciados em série.
Este artigo descreve como habilitar o recurso de Streaming de Artefatos em seus pools de nós do AKS para transmitir artefatos do ACR.
Importante
As versões prévias de recursos do AKS estão disponíveis em uma base de autoatendimento e aceitação. As versões prévias são fornecidas "como estão" e "conforme disponíveis" e são excluídas dos contratos de nível de serviço e da garantia limitada. As versões prévias do AKS são parcialmente cobertas pelo suporte ao cliente em uma base de melhor esforço. Dessa forma, esses recursos não são destinados ao uso em produção. Para obter mais informações, consulte os seguintes artigos:
Importante
A partir de 30 de novembro de 2025, o AKS (Serviço de Kubernetes do Azure) não dá mais suporte ou fornece atualizações de segurança para o Azure Linux 2.0. A imagem do nó do Azure no Linux 2.0 está congelada na versão 202512.06.0. A partir de 31 de março de 2026, as imagens de nó serão removidas e não será possível escalar os grupos de nós. Migre para uma versão do Azure Linux com suporte atualizando os pools de nós para uma versão do Kubernetes com suporte ou migrando para o osSku AzureLinux3. Para obter mais informações, consulte [Desativação] Pools de nós do Azure Linux 2.0 no AKS.
Importante
O Streaming de Artefatos (versão prévia) é uma alternativa sugerida para clientes que anteriormente usavam o Teleport.
Teleport (versão prévia) no AKS será desativado em 15 de julho de 2025. Migre para o Streaming de Artefatos (versão prévia) no AKS ou atualize os pools de nós para definir --aks-custom-headers EnableACRTeleport=false.
O Registro de Contêiner do Azure removeu a API do Teleport, o que significa que todos os nós com Teleport habilitado efetuarão pull de imagens do Registro de Contêiner do Azure como qualquer outro nó do AKS sem Teleport.
Após 15 de julho de 2025, os pools de nós do AKS com Teleport habilitado podem apresentar falhas de interrupção e provisionamento de nós. Para obter mais informações, consulte aka.ms/aks/teleport-retirement.
Limitações
- O Artifact Steaming não tem suporte para as seguintes opções de sistema operacional: versões do Windows Server, Flatcar Container Linux para AKS e Azure Linux com o OS Guard para AKS.
Pré-requisitos
- Você precisa de um cluster do AKS existente integrado ao ACR. Se você não o tiver, poderá criá-lo usando Autenticar com o ACR do AKS.
- Habilitar Streaming de Artefatos no ACR.
- Esse recurso requer o Kubernetes versão 1.25 ou posterior. Para verificar a versão do cluster do AKS, consulte Verificar se há atualizações de cluster do AKS disponíveis.
Observação
O Streaming de Artefatos só tem suporte nos pools de nós Ubuntu 22.04, Ubuntu 20.04 e Azure Linux. Não há suporte a pools de nós Windows.
Instalar a extensão da CLI aks-preview
Instale a extensão da CLI
aks-previewusando o comandoaz extension add.az extension add --name aks-previewAtualize a extensão para garantir que você tenha a versão mais recente usando o comando
az extension update.az extension update --name aks-preview
Registrar o sinalizador de recurso ArtifactStreamingPreview na assinatura
Registre o sinalizador de recurso
ArtifactStreamingPreviewna assinatura usando o comandoaz feature register.az feature register --namespace Microsoft.ContainerService --name ArtifactStreamingPreview
Habilitar Streaming de Artefatos no ACR
A habilitação no ACR é um pré-requisito para o Streaming de Artefatos no AKS. Para obter mais informações, consulte Streaming de Artefatos no ACR.
Crie um grupo de recursos do Azure para conter sua instância do ACR usando o comando
az group create.az group create --name myStreamingTest --location westusCrie um Registro de Contêiner do Azure de SKU premium usando o comando
az acr createcom o sinalizador--sku Premium.az acr create --resource-group myStreamingTest --name mystreamingtest --sku PremiumConfigure a instância padrão do ACR para sua assinatura usando o comando
az configure.az configure --defaults acr="mystreamingtest"Importe ou efetue push de uma imagem para o Registro usando o comando
az acr import.az acr import --source docker.io/jupyter/all-spark-notebook:latest --repository jupyter/all-spark-notebook:latestCrie um artefato de streaming da imagem usando o comando
az acr artifact-streaming create.az acr artifact-streaming create --image jupyter/all-spark-notebook:latestVerifique o Streaming de Artefatos gerado usando o comando
az acr manifest list-referrers.az acr manifest list-referrers --name jupyter/all-spark-notebook:latest
Habilitar Streaming de Artefatos no AKS
Habilitar o Streaming de Artefatos em um novo pool de nós
Crie um novo pool de nós com o Streaming de Artefatos habilitado usando o comando
az aks nodepool addcom o--enable-artifact-streaming.az aks nodepool add \ --resource-group myResourceGroup \ --cluster-name myAKSCluster \ --name myNodePool \ --enable-artifact-streaming
Ativar o Streaming de Artefatos em um pool de nós existente
Atualize um pool de nós existente para habilitar o Streaming de Artefatos usando o comando
az aks nodepool updatecom--enable-artifact-streaming.az aks nodepool update \ --resource-group myResourceGroup \ --cluster-name myAKSCluster \ --name myNodePool \ --enable-artifact-streaming
Verificar se o Streaming de Artefatos está habilitado
Agora que você habilitou o Streaming de Artefatos em um ACR premium e o conectou a um pool de nós do AKS com o Streaming de Artefatos habilitado, as eventuais novas implantações de pod nesse cluster com um pull de imagem do ACR com o Streaming de Artefatos habilitado terão tempos de pull de imagem reduzidos.
Verifique se o seu pool de nós tem a Transmissão de Artefatos habilitada usando o comando
az aks nodepool show.az aks nodepool show --resource-group myResourceGroup --cluster-name myAKSCluster --name myNodePool --query artifactStreamingProfileNa saída, verifique se o campo
Enabledestá definido comotrue.
Próximas etapas
Este artigo descreveu como habilitar o Streaming de Artefatos em seus pools de nós do AKS para transmitir artefatos do ACR e reduzir o tempo de pull da imagem. Para saber mais sobre como trabalhar com imagens de contêiner no AKS, consulte Melhores práticas para gerenciamento e segurança de imagens de contêiner no AKS.