Udostępnij przez

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 długie czasy pobierania z węzła.

Przypadki użycia

Poniżej przedstawiono kilka scenariuszy strumieniowego przesyłania artefaktów:

Wdrażanie konteneryzowanych aplikacji w wielu regionach: Dzięki przesyłaniu strumieniowemu artefaktów można przechowywać obrazy kontenerów w jednym rejestrze oraz zarządzać nimi i przesyłać je strumieniowo do klastrów AKS w różnych regionach. Przesyłanie strumieniowe artefaktów wdraża aplikacje kontenerowe w wielu regionach bez czasochłonnego wykorzystywania zasobów.

Zmniejszenie opóźnienia ściągania obrazu: przesyłanie strumieniowe artefaktów może skrócić czas na gotowość podu o ponad 15%, w zależności od rozmiaru obrazu, co najlepiej działa dla 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:

  • Użytkownicy z nowymi i już istniejącymi rejestrami mogą uruchamiać streaming artefaktów dla określonych repozytoriów lub tagów.

  • Klienci mogą przechowywać zarówno oryginalny artefakt, jak i ten do przesyłania strumieniowego w usłudze ACR, rozpoczynając przesyłanie strumieniowe artefaktów.

  • Użytkownicy mają dostęp do oryginalnego artefaktu oraz artefaktu przesyłanego strumieniowo nawet po wyłączeniu przesyłania strumieniowego 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 miękkiego usunięcia.

Informacje o dostępności i cenach

Przesyłanie strumieniowe artefaktów jest dostępne tylko w poziomach usługi Premium, znanych również jako SKU. Przesyłanie strumieniowe artefaktów może zwiększyć ogólne zużycie przestrzeni przechowywania rejestru. Klienci podlegają dodatkowym opłatom za magazyn zgodnie z opisem w cenniku, jeśli użycie przekroczy uwzględniony próg jednostki 500 GiB Premium SKU.

Ograniczenia wersji zapoznawczej

Przesyłanie strumieniowe artefaktów jest obecnie dostępne w wersji testowej. 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 wieloarchitektoniczne, przy czym obsługiwana jest tylko architektura AMD64.
  • Aby utworzyć pulę węzłów opartą na systemie Ubuntu w AKS, wybierz wersję Ubuntu 20.04 lub nowszą.
  • 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 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ń Azure CLI oraz portalu Azure, które służą do wypychania, importowania i generowania artefaktów przesyłania strumieniowego dla obrazów kontenerów w usłudze Azure Container Registry (ACR). Te instrukcje opisują proces tworzenia PremiumSKU ACR, 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

Strumieniowe przesyłanie artefaktów jest dostępne w warstwie usługi rejestru kontenerów Premium. Aby rozpocząć przesyłanie strumieniowe artefaktów, zaktualizuj rejestr za pomocą Azure CLI (wersja 2.54.0 lub nowsza). Aby zainstalować lub uaktualnić, zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.

Aby rozpocząć strumieniowanie artefaktów, wykonaj 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 jest na podstawowym lub standardowym SKU, następujące polecenia zakoń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 SKU Premium poprzez:

    Na przykład uruchom polecenie az group create, aby utworzyć grupę zasobów platformy Azure o nazwie my-streaming-test w regionie Zachodniego Wybrzeża USA, a następnie uruchom polecenie az acr create, aby utworzyć rejestr Azure Container 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. Prześlij lub zaimportuj obraz do rejestru przez:

    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 strumieniowego artefaktu z obrazu

    Inicjuje tworzenie artefaktu przesyłania strumieniowego z określonego obrazu.

    Na przykład uruchom polecenia az acr artifact-streaming create, aby utworzyć przesyłany strumieniowo artefakt z obrazu w jupyter/all-spark-notebook:latest ACR.

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

Uwaga

Identyfikator operacji zostaje wygenerowany w trakcie procesu do przyszłego użytku w celu zweryfikowania stanu operacji.

  1. Sprawdź strumieniowanie artefaktów wygenerowane w Azure CLI.

    Na przykład uruchom polecenie az acr manifest list-referrers, aby wyświetlić listę artefaktów przesyłania strumieniowego dla obrazu w usłudze jupyter/all-spark-notebook:latest ACR.

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

  2. Cofnij tworzenie streamingu artefaktów (w razie potrzeby)

    Anuluj proces tworzenia artefaktu przesyłania strumieniowego, jeśli konwersja nie została jeszcze zakończona. Zatrzymuje operację.

    Na przykład, aby anulować operację konwersji obrazu w usłudze ACR jupyter/all-spark-notebook:latest, uruchom polecenie mystreamingtest.

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

  3. Uruchamianie autokonwersji w repozytorium

    Rozpocznij autokonwersję w repozytorium dla nowo przesłanych lub zaimportowanych obrazów. Po uruchomieniu, wprowadzone do tego repozytorium nowe obrazy inicjują 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 streamingu po przesłaniu 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 konwersji obrazu jupyter/all-spark-notebook:newtag w usłudze ACR mystreamingtest.

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

Prześlij/Zaimportuj obraz i wygeneruj element przetwarzania strumieniowego — Azure Portal

Przesyłanie strumieniowe artefaktów jest dostępne w usłudze Azure Container Registry w warstwie PremiumSKU. Aby rozpocząć przesyłanie strumieniowe artefaktów, zaktualizuj rejestr przy użyciu portalu Azure.

Wykonaj kroki, aby utworzyć przesyłanie strumieniowe artefaktów w portalu Azure.

  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 strumieniowanie artefaktów w portalu Azure.

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

  5. Sprawdź artefakt transmisji strumieniowej wygenerowany na podstawie obrazu w zakładce Źródła.

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

W witrynie Azure Portal możesz zmienić stan autokonwersji repozytorium, klikając go prawym przyciskiem myszy w okienku Repozytoria . Wybierz pozycję Zatrzymaj przesyłanie strumieniowe artefaktów , aby zmienić stan przesyłania strumieniowego artefaktu na Nieaktywny lub Uruchom przesyłanie strumieniowe artefaktu , aby zmienić stan przesyłania strumieniowego artefaktu na Aktywny.

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 znajdują się w stanie nieaktywnym w celu przesyłania artefaktów strumieniowo. Oznacza to, że po przekazaniu nowych zgodnych obrazów do repozytorium, przesyłanie strumieniowe artefaktów nie zostanie uruchomione, a obrazy nie zostaną automatycznie przekonwertowane. Jeśli chcesz rozpocząć automatyczną konwersję nowo opublikowanych obrazów, musisz przełączyć strumieniowanie artefaktów w repozytorium w stan aktywny. Gdy repozytorium jest w stanie aktywnym, wszystkie nowe zgodne obrazy kontenerów wypychane do repozytorium będą uruchamiać strumieniowanie artefaktów. Spowoduje to rozpoczęcie automatycznej konwersji tych obrazów.

Następne kroki

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

  • Last updated on