Hızlı başlangıç: Azure CLı kullanarak bağlı kayıt defteri oluşturma

  • Makale
  • Okumak için 4 dakika

Bu hızlı başlangıçta, Azure 'da bağlı bir kayıt defteri kaynağı oluşturmak IÇIN Azure CLI 'yi kullanırsınız. Azure Container Registry bağlı kayıt defteri özelliği, bir kayıt defterini uzaktan veya şirket içinde dağıtmanıza ve görüntü ve diğer yapıtları bulut kayıt defteriyle eşitlemenize olanak tanır.

Burada, bir bulut kayıt defteri için iki bağlı kayıt defteri kaynağı oluşturursunuz: bir bağlı kayıt defteri okuma ve yazma (yapıt çekme ve gönderme) işlevselliğine ve biri salt okunurdur işlevlere izin verir.

Bağlı bir kayıt defteri oluşturduktan sonra, şirket içi veya uzak altyapınızda dağıtmak ve kullanmak için diğer kılavuzlardan yararlanabilirsiniz.

Önkoşullar

  • Azure Cloud Shell'Da Bash ortamını kullanın.

    Cloud Shell’i yeni bir pencerede başlatma

  • Dilerseniz CLI başvuru komutlarını çalıştırmak için Azure CLI’yi yükleyebilirsiniz.

    • Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Ek oturum açma seçenekleri için bkz. Azure CLI ile oturum açma.

    • İstendiğinde, ilk kullanımda Azure CLI uzantılarını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.

    • Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

  • Azure container registry-zaten bir kapsayıcı kayıt defteriniz yoksa, bağlı kayıt defterlerini destekleyen bir bölgede bir (Premium katmanı gerekir) oluşturun .

Bulut kayıt defteri için adanmış veri uç noktasını etkinleştirme

Az ACR Update komutunu kullanarak buluttaki Azure Container Registry için adanmış veri uç noktasını etkinleştirin. Bu adım, bağlı bir kayıt defterinin, bulut kayıt defteriyle iletişim kurması için gereklidir.

# Set the REGISTRY_NAME environment variable to identify the existing cloud registry
REGISTRY_NAME=<container-registry-name>

az acr update --name $REGISTRY_NAME \
  --data-endpoint-enabled

Görüntüleri bulut kayıt defterinize aktarma

az acr import komutunu kullanarak aşağıdaki kapsayıcı görüntülerini bulut kayıt defterinize aktarın. Bu görüntüleri zaten içe aktardıysanız bu adımı atlayabilirsiniz.

Bağlı kayıt defteri görüntüsü

İç içe geçmiş IoT Edge senaryolarını desteklemek için, bağlı kayıt defteri çalışma zamanının kapsayıcı görüntüsünün özel Azure kapsayıcı kayıt defterinize uygun olması gerekir. Bağlı kayıt defteri görüntüsünü özel kayıt defterinize içeri aktarın.

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

IoT Edge ve API ara sunucusu görüntüleri

İç içe geçmiş sanal ağlarda bağlı kayıt IoT Edge için, api proxy'si ve IoT Edge modüllerini dağıtmanız gerekir. Bu görüntüleri özel kayıt defterinize aktarın.

Api IoT Edge modülü, bir IoT Edge cihazın 443 gibi aynı bağlantı noktası üzerinde HTTPS protokolünü kullanarak birden çok hizmeti açığa çıkartır.

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

Merhaba dünya resmi

Bağlı kayıt defterini test etmek için görüntüyü içeri hello-world aktarın. Bu depo, bağlı kayıt defteriyle eşitlenir ve bağlı kayıt defteri istemcileri tarafından çekilir.

az acr import \
  --name $REGISTRY_NAME \
  --source mcr.microsoft.com/hello-world:1.1.2

Okuma ve yazma işlevselliği için bağlı bir kayıt defteri kaynağı oluşturma

Az ACR Connected-Registry Create komutunu kullanarak bağlı bir kayıt defteri oluşturun. Bağlı kayıt defteri adı bir harfle başlamalı ve yalnızca alfasayısal karakterler içermelidir. Bu Azure Container Registry için hiyerarşide 5 ile 40 karakter uzunluğunda ve benzersiz olmalıdır.

# Set the CONNECTED_REGISTRY_RW environment variable to provide a name for the connected registry with read/write functionality
CONNECTED_REGISTRY_RW=<connnected-registry-name>

az acr connected-registry create --registry $REGISTRY_NAME \
  --name $CONNECTED_REGISTRY_RW \
  --repository "hello-world" "acr/connected-registry" "azureiotedge-agent" "azureiotedge-hub" "azureiotedge-api-proxy"

Bu komut, adı $CONNECTED _REGISTRY_RW değeri olan bağlı bir kayıt defteri kaynağı oluşturur ve adı $REGISTRY _name değeri olan bulut kayıt defterine bağlar. Sonraki hızlı başlangıç kılavuzlarında, bağlı kayıt defterini dağıtma seçenekleri hakkında bilgi edineceksiniz.

  • Belirtilen depolar, bulut kayıt defteri ve bağlı kayıt defteri arasında dağıtıldıktan sonra eşitlenir.

  • --modeBağlı kayıt defteri için hiçbir seçenek belirtilmediği için, varsayılan ReadWrite modundaoluşturulur.

  • Bu bağlı kayıt defteri için tanımlı bir eşitleme zamanlaması olmadığından, depolar, bulut kayıt defteri ile bağlı kayıt defteri arasında kesintiler olmadan eşitlenir.

    Önemli

    Alt katmanların Internet erişimi olmadığı iç içe geçmiş senaryoları desteklemek için, deponun eşitlemesine her zaman izin vermeniz gerekir acr/connected-registry . Bu depo, bağlı kayıt defteri çalışma zamanının görüntüsünü içerir.

Salt okuma işlevselliği için bağlı bir kayıt defteri kaynağı oluşturma

Ayrıca, salt okunurdur bir bağlı kayıt defteri oluşturmak için az ACR Connected-Registry Create komutunu da kullanabilirsiniz.

# Set the CONNECTED_REGISTRY_READ environment variable to provide a name for the connected registry with read-only functionality
CONNECTED_REGISTRY_RO=<connnected-registry-name>
az acr connected-registry create --registry $REGISTRY_NAME \
  --parent $CONNECTED_REGISTRY_RW \
  --name $CONNECTED_REGISTRY_RO \
  --repository "hello-world" "acr/connected-registry" "azureiotedge-agent" "azureiotedge-hub" "azureiotedge-api-proxy" \
  --mode ReadOnly

Bu komut, adı $CONNECTED _REGISTRY_RO değeri olan bağlı bir kayıt defteri kaynağı oluşturur ve $REGISTRY _name değeriyle adlı bulut kayıt defterine bağlar.

  • Belirtilen depolar, $CONNECTED _REGISTRY_RW değeriyle adlı üst kayıt defteri ile dağıtıldıktan sonra bağlı kayıt defteri arasında eşitlenir.
  • Bu kaynak, dağıtıldıktan sonra salt okunur (yapıt çekme) işlevini sağlayan salt okunur moddaoluşturulur.
  • Bu bağlı kayıt defteri için tanımlı bir eşitleme zamanlaması olmadığından, depolar üst kayıt defteri ile bağlı kayıt defteri arasında kesintiler olmadan eşitlenir.

Kaynakların oluşturulduğunu doğrulama

Kaynakların oluşturulduğunu doğrulamak için, az ACR Connected kayıt defteri listesi komutunu bağlı kayıt defteri ' ni kullanabilirsiniz.

az acr connected-registry list \
  --registry $REGISTRY_NAME \
  --output table

Aşağıdaki gibi bir yanıt görmeniz gerekir. Bağlı kayıt defterleri henüz dağıtılmadığından, "çevrimdışı" bağlantı durumu, şu anda bulutla bağlantısının kesildiğini gösterir.

NAME                 MODE        CONNECTION STATE    PARENT               LOGIN SERVER    LAST SYNC (UTC)
-------------------  --------    ------------------  -------------------  --------------  -----------------
myconnectedregrw    ReadWrite    Offline
myconnectedregro    ReadOnly     Offline             myconnectedregrw

Sonraki adımlar

Bu hızlı başlangıçta, Azure 'da iki bağlı kayıt defteri kaynağı oluşturmak için Azure CLı 'yi kullandınız. Bu yeni bağlı kayıt defteri kaynakları, bulut Kayıt defterinize bağlanır ve yapıt kayıt defteriyle eşitlemeye izin verir.

IoT Edge altyapınızda bağlı bir kayıt defterini dağıtmayı ve kullanmayı öğrenmek için bağlı kayıt defteri dağıtım kılavuzlarına devam edin.

Hızlı başlangıç: IoT Edge bağlı kayıt defteri dağıtma