Udostępnij za pośrednictwem

Przesyłanie strumieniowe artefaktów w usłudze Azure Container Registry (wersja zapoznawcza)

  • Artykuł

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

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.

  1. 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-test w regionie Zachodnie stany USA, a następnie uruchomić polecenie az acr create , aby utworzyć usługę Azure Container Registry w warstwie Premium o nazwie mystreamingtest w 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 premium

  2. Wypychanie 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 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. Tworzenie 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:latest na podstawie obrazu w usłudze mystreamingtest ACR.

    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.

  1. 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:latest dla obrazu w usłudze mystreamingtest ACR.

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

  2. Anulowanie 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:latest w mystreamingtest usłudze ACR.

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

  3. Uruchamianie 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-notebook dla repozytorium w usłudze mystreamingtest ACR.

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

  4. Sprawdź postęp konwersji przesyłania strumieniowego po wypchnięciu nowego obrazu jupyter/all-spark-notebook:newtag do powyższego repozytorium.

    Na przykład uruchom polecenie az acr artifact-streaming operation show , aby sprawdzić stan operacji jupyter/all-spark-notebook:newtag konwersji obrazu w usłudze mystreamingtest ACR.

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

  5. Po zweryfikowaniu stanu konwersji możesz teraz nawiązać połączenie z usługą AKS. Zapoznaj się z dokumentacją usługi AKS.

  6. 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:latest dla obrazu w usłudze mystreamingtest ACR.

    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.

  1. Przejdź do usługi Azure Container Registry.

  2. W menu bocznym w obszarze Usługi wybierz pozycję Repozytoria.

  3. Wybierz najnowszy zaimportowany obraz.

  4. Przekonwertuj obraz i utwórz przesyłanie strumieniowe artefaktów w witrynie Azure Portal.

    Zrzut ekranu witryny Azure Portal z wyróżnionym przyciskiem create streaming artifact (Tworzenie artefaktu przesyłania strumieniowego).

  5. Sprawdź artefakt przesyłania strumieniowego wygenerowany na podstawie obrazu na karcie Odwołania.

    Zrzut ekranu witryny Azure Portal z wyróżnionym artefaktem przesyłania strumieniowego.

  6. Możesz również usunąć przesyłanie strumieniowe artefaktów z repozytorium.

    Zrzut ekranu witryny Azure Portal z wyróżnionym przyciskiem usuwania artefaktu przesyłania strumieniowego.

  7. 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.

    Zrzut ekranu witryny Azure Portal z wyróżnionym przyciskiem uruchamiania przesyłania strumieniowego artefaktów.

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.

Następne kroki

Rozwiązywanie problemów z przesyłaniem strumieniowym artefaktów