Szybki start: tworzenie połączonego rejestru przy użyciu witryny Azure Portal (aby zostać wycofane)
W tym przewodniku Szybki start utworzysz zasób połączonego rejestru na platformie Azure przy użyciu witryny Azure Portal. Funkcja połączonego rejestru usługi Azure Container Registry umożliwia zdalne wdrażanie rejestru lub lokalnie oraz synchronizowanie obrazów i innych artefaktów z rejestrem w chmurze.
W tym miejscu utworzysz dwa połączone zasoby rejestru dla rejestru w chmurze: jeden połączony rejestr zezwala na funkcje odczytu i zapisu (ściąganie artefaktu i wypychanie), a jeden umożliwia korzystanie z funkcji tylko do odczytu.
Po utworzeniu połączonego rejestru możesz postępować zgodnie z innymi przewodnikami dotyczącymi wdrażania i używania go w infrastrukturze lokalnej lub zdalnej.
Wymagania wstępne
- Azure Container Registry — jeśli jeszcze nie masz rejestru kontenerów, utwórz jedną (wymaganą warstwę Premium) w regionie obsługującym połączone rejestry.
Aby zaimportować obrazy do rejestru kontenerów, użyj interfejsu wiersza polecenia platformy Azure:
Użyj środowiska powłoki Bash w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Szybki start dotyczący powłoki Bash w usłudze Azure Cloud Shell.
Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie interfejsu wiersza polecenia platformy Azure w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić interfejs wiersza polecenia platformy Azure w kontenerze platformy Docker.
Jeśli korzystasz z instalacji lokalnej, zaloguj się do interfejsu wiersza polecenia platformy Azure za pomocą polecenia az login. Aby ukończyć proces uwierzytelniania, wykonaj kroki wyświetlane w terminalu. Aby uzyskać inne opcje logowania, zobacz Logowanie się przy użyciu interfejsu wiersza polecenia platformy Azure.
Po wyświetleniu monitu zainstaluj rozszerzenie interfejsu wiersza polecenia platformy Azure podczas pierwszego użycia. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Korzystanie z rozszerzeń w interfejsie wiersza polecenia platformy Azure.
Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.
Włączanie dedykowanego punktu końcowego danych dla rejestru w chmurze
Włącz dedykowany punkt końcowy danych dla rejestru kontenerów platformy Azure w chmurze. Ten krok jest wymagany, aby połączony rejestr komunikował się z rejestrem w chmurze.
- W witrynie Azure Portal przejdź do rejestru kontenerów.
- Wybierz pozycję Dostęp publiczny do sieci>. Zaznacz pole wyboru Włącz dedykowany punkt końcowy danych.
- Wybierz pozycję Zapisz.
Importowanie obrazów do rejestru w chmurze
Zaimportuj następujące obrazy kontenerów do rejestru w chmurze przy użyciu polecenia az acr import . Pomiń ten krok, jeśli te obrazy zostały już zaimportowane.
Obraz połączonego rejestru
Aby obsługiwać zagnieżdżone scenariusze usługi IoT Edge, obraz kontenera dla połączonego środowiska uruchomieniowego rejestru musi być dostępny w prywatnym rejestrze kontenerów platformy Azure. Za pomocą polecenia az acr import zaimportuj połączony obraz rejestru do rejestru prywatnego.
# Use the REGISTRY_NAME variable in the following Azure CLI commands to identify the registry
REGISTRY_NAME=<container-registry-name>
az acr import \
--name $REGISTRY_NAME \
--source mcr.microsoft.com/acr/connected-registry:0.8.0
Obrazy serwera proxy usługi IoT Edge i interfejsu API
Aby obsługiwać połączony rejestr w zagnieżdżonym usłudze IoT Edge, należy wdrożyć moduły dla serwera proxy usługi IoT Edge i interfejsu API. Zaimportuj te obrazy do rejestru prywatnego.
Moduł serwera proxy interfejsu API usługi IoT Edge umożliwia urządzeniu usługi IoT Edge uwidocznienie wielu usług przy użyciu protokołu HTTPS na tym samym porcie, takim jak 443.
az acr import \
--name $REGISTRY_NAME \
--source mcr.microsoft.com/azureiotedge-agent:1.2.4
az acr import \
--name $REGISTRY_NAME \
--source mcr.microsoft.com/azureiotedge-hub:1.2.4
az acr import \
--name $REGISTRY_NAME \
--source mcr.microsoft.com/azureiotedge-api-proxy:1.1.2
az acr import \
--name $REGISTRY_NAME \
--source mcr.microsoft.com/azureiotedge-diagnostics:1.2.4
Obraz hello-world
Aby przetestować połączony rejestr, zaimportuj hello-world obraz. To repozytorium zostanie zsynchronizowane z połączonym rejestrem i pobrane przez połączonych klientów rejestru.
az acr import \
--name $REGISTRY_NAME \
--source mcr.microsoft.com/hello-world:1.1.2
Tworzenie połączonego zasobu rejestru na potrzeby funkcji odczytu i zapisu
Poniższe kroki umożliwiają utworzenie połączonego rejestru w trybie ReadWrite połączonym z rejestrem w chmurze.
- W witrynie Azure Portal przejdź do rejestru kontenerów.
- Wybierz pozycję Połączone rejestry (wersja zapoznawcza) > + Utwórz.
- Wprowadź lub wybierz wartości w poniższej tabeli, a następnie wybierz pozycję Zapisz.
| Produkt | opis |
|---|---|
| Parent | Wybierz pozycję Brak elementu nadrzędnego dla połączonego rejestru połączonego z rejestrem w chmurze. |
| Tryb | Wybierz pozycję ReadWrite. |
| Nazwisko | Połączona nazwa rejestru musi zaczynać się literą i zawierać tylko znaki alfanumeryczne. Musi zawierać od 5 do 40 znaków i być unikatowy w hierarchii dla tego rejestru kontenerów platformy Azure. |
| Właściwości rejestrowania | Zaakceptuj ustawienia domyślne. |
| Właściwości synchronizacji | Zaakceptuj ustawienia domyślne. Ponieważ domyślnie nie zdefiniowano harmonogramu synchronizacji, repozytoria zostaną zsynchronizowane między rejestrem w chmurze a połączonym rejestrem bez przerw. |
| Repozytoria | Wybierz lub wprowadź nazwy repozytoriów zaimportowanych w poprzednim kroku. Określone repozytoria zostaną zsynchronizowane między rejestrem chmury a połączonym rejestrem po jego wdrożeniu. |
Ważne
Aby obsługiwać zagnieżdżone scenariusze, w których niższe warstwy nie mają dostępu do Internetu, zawsze należy zezwolić na synchronizację acr/connected-registry repozytorium. To repozytorium zawiera obraz środowiska uruchomieniowego połączonego rejestru.
Tworzenie połączonego zasobu rejestru na potrzeby funkcji tylko do odczytu
Poniższe kroki umożliwiają utworzenie połączonego rejestru w trybie ReadOnly, którego element nadrzędny jest połączonym rejestrem utworzonym w poprzedniej sekcji. Ten połączony rejestr umożliwia wdrażanie funkcji tylko do odczytu (ściąganie artefaktów).
- W witrynie Azure Portal przejdź do rejestru kontenerów.
- Wybierz pozycję Połączone rejestry (wersja zapoznawcza) > + Utwórz.
- Wprowadź lub wybierz wartości w poniższej tabeli, a następnie wybierz pozycję Zapisz.
| Produkt | opis |
|---|---|
| Parent | Wybierz utworzony wcześniej rejestr połączony. |
| Tryb | Wybierz pozycję ReadOnly. |
| Nazwisko | Połączona nazwa rejestru musi zaczynać się literą i zawierać tylko znaki alfanumeryczne. Musi zawierać od 5 do 40 znaków i być unikatowy w hierarchii dla tego rejestru kontenerów platformy Azure. |
| Właściwości rejestrowania | Zaakceptuj ustawienia domyślne. |
| Właściwości synchronizacji | Zaakceptuj ustawienia domyślne. Ponieważ domyślnie nie zdefiniowano harmonogramu synchronizacji, repozytoria zostaną zsynchronizowane między rejestrem w chmurze a połączonym rejestrem bez przerw. |
| Repozytoria | Wybierz lub wprowadź nazwy repozytoriów zaimportowanych w poprzednim kroku. Określone repozytoria zostaną zsynchronizowane między rejestrem nadrzędnym a połączonym rejestrem po jego wdrożeniu. |
Wyświetlanie właściwości połączonego rejestru
Wybierz połączony rejestr w portalu, aby wyświetlić jego właściwości, takie jak jego stan połączenia (offline, online lub w złej kondycji) i czy został aktywowany (wdrożony lokalnie). W poniższym przykładzie połączony rejestr nie jest wdrożony. Jego stan połączenia "Offline" wskazuje, że jest obecnie odłączony od chmury.
W tym widoku można również wygenerować parametry połączenia i opcjonalnie wygenerować hasła dla tokenu synchronizacji. Parametry połączenia zawiera ustawienia konfiguracji używane do wdrażania połączonego rejestru i synchronizowania zawartości z rejestrem nadrzędnym.
Następne kroki
W tym przewodniku Szybki start użyto witryny Azure Portal do utworzenia dwóch połączonych zasobów rejestru na platformie Azure. Te nowe połączone zasoby rejestru są powiązane z rejestrem chmury i umożliwiają synchronizację artefaktów z rejestrem w chmurze.
Przejdź do przewodników wdrażania połączonego rejestru, aby dowiedzieć się, jak wdrożyć i używać połączonego rejestru w infrastrukturze usługi IoT Edge.