Ściąganie obrazów z połączonego rejestru na urządzeniu IoT Edge

  • 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 hasła.

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

Przestroga

W przypadku skonfigurowania połączonego rejestru jako niezabezpieczonego rejestru zaktualizuj listę niezabezpieczonych rejestrów w konfiguracji demona platformy Docker, aby uwzględnić adres IP (lub nazwę FQDN) i port połączonego rejestru na urządzeniu 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 IoT Edge należy uwzględnić port używany do dotarcia do połączonego rejestru 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