Udostępnij za pośrednictwem

Ściąganie obrazów z połączonego rejestru na urządzeniu usługi IoT Edge (aby zostać wycofane)

  • Artykuł

Aby ściągnąć obrazy z połączonego rejestru, skonfiguruj token klienta i przekaż poświadczenia tokenu w celu uzyskania dostępu do zawartości rejestru.

Wymagania wstępne

Tworzenie mapy zakresu

Użyj polecenia az acr scope-map create, aby utworzyć mapę zakresu na potrzeby dostępu do odczytu do hello-world repozytorium:

# Use the REGISTRY_NAME variable in the following Azure CLI commands to identify the registry
REGISTRY_NAME=<container-registry-name>

az acr scope-map create \
  --name hello-world-scopemap \
  --registry $REGISTRY_NAME \
  --repository hello-world content/read \
  --description "Scope map for the connected registry."

Tworzenie tokenu klienta

Użyj polecenia az acr token create, aby utworzyć token klienta i skojarzyć go z nowo utworzoną mapą zakresu:

az acr token create \
  --name myconnectedregistry-client-token \
  --registry $REGISTRY_NAME \
  --scope-map hello-world-scopemap

Polecenie zwróci szczegóły dotyczące nowo wygenerowanego tokenu, w tym haseł.

Ważne

Upewnij się, że zapisano wygenerowane hasła. Są to hasła jednorazowe i nie można ich pobrać. Nowe hasła można wygenerować przy użyciu polecenia az acr token credential generate .

Aktualizowanie połączonego rejestru przy użyciu tokenu klienta

Użyj polecenia az acr connected-registry update, aby zaktualizować połączony rejestr przy użyciu nowo utworzonego tokenu klienta.

az acr connected-registry update \
  --name $CONNECTED_REGISTRY_RW \
  --registry $REGISTRY_NAME \
  --add-client-token myconnectedregistry-client-token

Ściąganie obrazu z połączonego rejestru

Z komputera z dostępem do urządzenia usługi IoT Edge użyj następującego przykładowego polecenia, aby zalogować się do połączonego rejestru przy użyciu poświadczeń tokenu klienta. Aby uzyskać najlepsze rozwiązania dotyczące zarządzania poświadczeniami logowania, zobacz dokumentację poleceń logowania platformy Docker.

Uwaga

Jeśli skonfigurowano połączony rejestr jako niezabezpieczony rejestr, zaktualizuj niezabezpieczoną listę rejestrów w konfiguracji demona platformy Docker, aby uwzględnić adres IP (lub nazwę FQDN) i port połączonego rejestru na urządzeniu usługi IoT Edge. Ta konfiguracja powinna być używana tylko do celów testowych. Aby uzyskać więcej informacji, zobacz Testowanie niezabezpieczonego rejestru.

docker login --username myconnectedregistry-client-token \
  --password <token_password> <IP_address_or_FQDN_of_connected_registry>:<port>

W przypadku scenariuszy usługi IoT Edge należy uwzględnić port używany do nawiązania połączenia z połączonym rejestrem na urządzeniu. Przykład:

docker login --username myconnectedregistry-client-token \
  --password xxxxxxxxxxx 192.0.2.13:8000

Następnie użyj następującego polecenia, aby ściągnąć hello-world obraz:

docker pull <IP_address_or_FQDN_of_connected_registry>:<port>/hello-world

Następne kroki