Przesyłanie strumieniowe artefaktów w usłudze Azure Container Registry (wersja zapoznawcza)
Przesyłanie strumieniowe artefaktów to funkcja w usłudze Azure Container Registry, która umożliwia przechowywanie obrazów kontenerów w jednym rejestrze, zarządzanie obrazami kontenerów i przesyłanie ich strumieniowo do klastrów usługi Azure Kubernetes Service (AKS) w wielu regionach. Ta funkcja została zaprojektowana w celu przyspieszenia konteneryzowanych obciążeń dla klientów platformy Azure przy użyciu usługi AKS. Przesyłanie strumieniowe artefaktów umożliwia łatwe skalowanie obciążeń bez konieczności oczekiwania na wolne czasy ściągania węzła.
Przypadki użycia
Poniżej przedstawiono kilka scenariuszy przesyłania strumieniowego artefaktów:
Wdrażanie konteneryzowanych aplikacji w wielu regionach: za pomocą przesyłania strumieniowego artefaktów można przechowywać obrazy kontenerów w jednym rejestrze oraz zarządzać obrazami kontenerów i przesyłać je strumieniowo do klastrów usługi AKS w wielu regionach. Przesyłanie strumieniowe artefaktów wdraża aplikacje kontenerów w wielu regionach bez czasochłonnego i czasochłonnego korzystania z zasobów.
Zmniejszenie opóźnienia ściągania obrazu: przesyłanie strumieniowe artefaktów może skrócić czas na gotowość zasobnika o ponad 15%, w zależności od rozmiaru obrazu i działa najlepiej w przypadku obrazów < 30 GB. Ta funkcja zmniejsza opóźnienie ściągania obrazu i szybkie uruchamianie kontenerów, co jest korzystne dla deweloperów oprogramowania i architektów systemów.
Efektywne skalowanie aplikacji konteneryzowanych: Przesyłanie strumieniowe artefaktów umożliwia projektowanie, kompilowanie i wdrażanie konteneryzowanych aplikacji na dużą skalę.
Aspekty przesyłania strumieniowego artefaktów
Oto kilka krótkich aspektów przesyłania strumieniowego artefaktów:
Klienci z nowymi i istniejącymi rejestrami mogą uruchamiać przesyłanie strumieniowe artefaktów dla określonych repozytoriów lub tagów.
Klienci mogą przechowywać zarówno oryginalny, jak i artefakt przesyłania strumieniowego w usłudze ACR, uruchamiając przesyłanie strumieniowe artefaktów.
Klienci mają dostęp do oryginalnego i artefaktu przesyłania strumieniowego nawet po wyłączeniu przesyłania strumieniowego artefaktów dla repozytoriów lub artefaktów.
Klienci z włączonym przesyłaniem strumieniowym artefaktów i usuwaniem nietrwałym, usuwają repozytorium lub artefakt, a następnie usuwane są zarówno oryginalne, jak i wersje przesyłania strumieniowego artefaktów. Jednak tylko oryginalna wersja jest dostępna w portalu usuwania nietrwałego.
Informacje o dostępności i cenach
Przesyłanie strumieniowe artefaktów jest dostępne tylko w warstwach usługi Premium (nazywanych również jednostkami SKU). Przesyłanie strumieniowe artefaktów może zwiększyć ogólne użycie magazynu rejestru. Klienci podlegają większym opłatom za magazyn zgodnie z opisem w cenniku, jeśli użycie przekroczy uwzględniony próg jednostki SKU GiB Premium 500.
Ograniczenia wersji zapoznawczej
Przesyłanie strumieniowe artefaktów jest obecnie dostępne w wersji zapoznawczej. Obowiązują następujące ograniczenia:
- Tylko obrazy z architekturą AMD64 dla systemu Linux są obsługiwane w wersji zapoznawczej.
- Wersja zapoznawcza nie obsługuje obrazów kontenerów opartych na systemie Windows i obrazów ARM64.
- Wersja zapoznawcza częściowo obsługuje obrazy z wieloma architekturami tylko architekturą AMD64.
- Aby utworzyć pulę węzłów opartą na systemie Ubuntu w usłudze AKS, wybierz pozycję Ubuntu w wersji 20.04 lub nowszej.
- W przypadku platformy Kubernetes użyj rozwiązania Kubernetes w wersji 1.26 lub nowszej lub Kubernetes w wersji > 1.25.
- Tylko rejestry jednostek SKU w warstwie Premium obsługują generowanie artefaktów przesyłania strumieniowego w wersji zapoznawczej. Rejestry jednostek SKU innych niżpremium nie oferują tej funkcji w wersji zapoznawczej.
- Rejestry kluczy zarządzanych przez klienta nie są obsługiwane w wersji zapoznawczej.
- Rejestr platformy Kubernetes nie jest obecnie obsługiwany.
Wymagania wstępne
Aby uruchomić przykłady poleceń w tym artykule, możesz użyć usługi Azure Cloud Shell lub lokalnej instalacji interfejsu wiersza polecenia platformy Azure. Jeśli chcesz używać go lokalnie, wymagana jest wersja 2.54.0 lub nowsza. Uruchom polecenie
az --version, aby znaleźć wersję. Jeśli konieczna będzie instalacja lub uaktualnienie, zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.Zaloguj się w witrynie Azure Portal.
Uruchamianie przesyłania strumieniowego artefaktu
Rozpocznij przesyłanie strumieniowe artefaktów za pomocą serii poleceń interfejsu wiersza polecenia platformy Azure i witryny Azure Portal do wypychania, importowania i generowania artefaktów przesyłania strumieniowego dla obrazów kontenerów w usłudze Azure Container Registry (ACR). Te instrukcje przedstawiają proces tworzenia rekordu ACR jednostki SKU w warstwie Premium, importowania obrazu, generowania artefaktu przesyłania strumieniowego i zarządzania operacją przesyłania strumieniowego artefaktu. Pamiętaj, aby w razie potrzeby zastąpić symbole zastępcze rzeczywistymi wartościami.
Wypychanie/importowanie obrazu i generowanie artefaktu przesyłania strumieniowego — interfejs wiersza polecenia platformy Azure
Przesyłanie strumieniowe artefaktów jest dostępne w warstwie usługi rejestru kontenerów Premium . Aby rozpocząć przesyłanie strumieniowe artefaktów, zaktualizuj rejestr przy użyciu interfejsu wiersza polecenia platformy Azure (wersja 2.54.0 lub nowsza). Aby zainstalować lub uaktualnić, zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.
Uruchom przesyłanie strumieniowe artefaktów, wykonując następujące ogólne kroki:
Uwaga
Jeśli masz już rejestr kontenerów w warstwie Premium, możesz pominąć ten krok. Jeśli użytkownik korzysta z podstawowych jednostek SKU w warstwie Standardowa, następujące polecenia kończą się niepowodzeniem. Kod jest napisany w interfejsie wiersza polecenia platformy Azure i można go wykonać w trybie interaktywnym. Przed wykonaniem polecenia należy zastąpić symbole zastępcze rzeczywistymi wartościami.
Utwórz nową usługę Azure Container Registry (ACR) przy użyciu jednostki SKU w warstwie Premium za pośrednictwem:
Na przykład uruchom polecenie az group create , aby utworzyć grupę zasobów platformy Azure o nazwie
my-streaming-testw regionie Zachodnie stany USA, a następnie uruchomić polecenie az acr create , aby utworzyć usługę Azure Container Registry w warstwie Premium o nazwiemystreamingtestw tej grupie zasobów.az group create -n my-streaming-test -l westus az acr create -n mystreamingtest -g my-streaming-test -l westus --sku premiumWypychanie lub importowanie obrazu do rejestru za pośrednictwem:
Na przykład uruchom polecenie [az configure], aby skonfigurować domyślne polecenie ACR i az acr import w celu zaimportowania obrazu notesu Jupyter Notebook z usługi Docker Hub do usługi
mystreamingtestACR.az configure --defaults acr="mystreamingtest" az acr import --source docker.io/jupyter/all-spark-notebook:latest -t jupyter/all-spark-notebook:latestTworzenie przesyłania strumieniowego artefaktu na podstawie obrazu
Inicjuje tworzenie artefaktu przesyłania strumieniowego z określonego obrazu.
Na przykład uruchom polecenia az acr artifact-streaming create , aby utworzyć artefakt przesyłania strumieniowego
jupyter/all-spark-notebook:latestna podstawie obrazu w usłudzemystreamingtestACR.az acr artifact-streaming create --image jupyter/all-spark-notebook:latest
Uwaga
Identyfikator operacji jest generowany podczas procesu dla przyszłego odwołania w celu zweryfikowania stanu operacji.
Sprawdź wygenerowane przesyłanie strumieniowe artefaktów w interfejsie wiersza polecenia platformy Azure.
Na przykład uruchom polecenie az acr manifest list-referers , aby wyświetlić listę artefaktów przesyłania strumieniowego
jupyter/all-spark-notebook:latestdla obrazu w usłudzemystreamingtestACR.az acr manifest list-referrers -n jupyter/all-spark-notebook:latestAnulowanie tworzenia przesyłania strumieniowego artefaktu (w razie potrzeby)
Anuluj tworzenie artefaktu przesyłania strumieniowego, jeśli konwersja nie została jeszcze zakończona. Zatrzymuje operację.
Na przykład uruchom polecenie az acr artifact-streaming operation cancel , aby anulować operację konwersji obrazu
jupyter/all-spark-notebook:latestwmystreamingtestusłudze ACR.az acr artifact-streaming operation cancel --repository jupyter/all-spark-notebook --id c015067a-7463-4a5a-9168-3b17dbe42ca3Uruchamianie autokonwersji w repozytorium
Uruchom autokonwersję w repozytorium dla nowo wypchniętych lub zaimportowanych obrazów. Po uruchomieniu nowe obrazy wypchnięte do tego repozytorium wyzwalają generowanie artefaktów przesyłania strumieniowego.
Uwaga
Automatyczna konwersja nie ma zastosowania do istniejących obrazów. Istniejące obrazy można przekonwertować ręcznie.
Na przykład uruchom polecenie az acr artifact-streaming update , aby uruchomić autokonwersję
jupyter/all-spark-notebookdla repozytorium w usłudzemystreamingtestACR.az acr artifact-streaming update --repository jupyter/all-spark-notebook --enable-streaming trueSprawdź postęp konwersji przesyłania strumieniowego po wypchnięciu nowego obrazu
jupyter/all-spark-notebook:newtagdo powyższego repozytorium.Na przykład uruchom polecenie az acr artifact-streaming operation show , aby sprawdzić stan operacji
jupyter/all-spark-notebook:newtagkonwersji obrazu w usłudzemystreamingtestACR.az acr artifact-streaming operation show --image jupyter/all-spark-notebook:newtagPo zweryfikowaniu stanu konwersji możesz teraz nawiązać połączenie z usługą AKS. Zapoznaj się z dokumentacją usługi AKS.
Wyłącz artefakt przesyłania strumieniowego z repozytorium.
Na przykład uruchom polecenie az acr artifact-streaming update , aby usunąć artefakt przesyłania strumieniowego
jupyter/all-spark-notebook:latestdla obrazu w usłudzemystreamingtestACR.az acr artifact-streaming update --repository jupyter/all-spark-notebook --enable-streaming false
Uwaga
Przesyłanie strumieniowe artefaktów może działać w różnych regionach, niezależnie od tego, czy replikacja geograficzna jest uruchamiana, czy nie. Przesyłanie strumieniowe artefaktów może działać za pośrednictwem prywatnego punktu końcowego i dołączyć do niego.
Wypychanie/importowanie obrazu i generowanie artefaktu przesyłania strumieniowego — Witryna Azure Portal
Przesyłanie strumieniowe artefaktów jest dostępne w usłudze Azure Container Registry w warstwie Premium. Aby rozpocząć przesyłanie strumieniowe artefaktów, zaktualizuj rejestr przy użyciu witryny Azure Portal.
Wykonaj kroki tworzenia przesyłania strumieniowego artefaktów w witrynie Azure Portal.
Przejdź do usługi Azure Container Registry.
W menu bocznym w obszarze Usługi wybierz pozycję Repozytoria.
Wybierz najnowszy zaimportowany obraz.
Przekonwertuj obraz i utwórz przesyłanie strumieniowe artefaktów w witrynie Azure Portal.
Sprawdź artefakt przesyłania strumieniowego wygenerowany na podstawie obrazu na karcie Odwołania.
Możesz również usunąć przesyłanie strumieniowe artefaktów z repozytorium.
Możesz również włączyć autokonwersję, korzystając z repozytorium w portalu. Aktywne oznacza, że autokonwersja jest włączona w repozytorium. Nieaktywne oznacza, że autokonwersja jest wyłączona w repozytorium.
Uwaga
Stan przesyłania strumieniowego artefaktów w repozytorium (nieaktywne lub aktywne) określa, czy nowo wypchnięte zgodne obrazy zostaną automatycznie przekonwertowane. Domyślnie wszystkie repozytoria są w stanie nieaktywnym dla przesyłania strumieniowego artefaktów. Oznacza to, że po wypchnięciu nowych zgodnych obrazów do repozytorium przesyłanie strumieniowe artefaktów nie zostanie wyzwolone, a obrazy nie zostaną automatycznie przekonwertowane. Jeśli chcesz rozpocząć automatyczną konwersję nowo wypychanych obrazów, musisz ustawić przesyłanie strumieniowe artefaktów repozytorium do stanu aktywnego. Gdy repozytorium jest w stanie aktywnym, wszystkie nowe zgodne obrazy kontenerów wypychane do repozytorium będą wyzwalać przesyłanie strumieniowe artefaktów. Spowoduje to rozpoczęcie automatycznej konwersji tych obrazów.