Rychlý Start: vytvoření připojeného registru pomocí Azure CLI

  • Článek
  • 4 min ke čtení

V tomto rychlém startu použijete rozhraní příkazového řádku Azure CLI k vytvoření připojeného prostředku registru v Azure. Funkce připojená do registru Azure Container Registry umožňuje vzdáleně nasadit registr do místního počítače nebo do svého místního prostředí a synchronizovat image a jiné artefakty pomocí cloudového registru.

Tady vytvoříte dva připojené prostředky registru pro cloudový registr: jeden připojený registr povoluje funkci čtení a zápisu (vyžádání obsahu a nabízení artefaktů) a jedna umožňuje funkci jen pro čtení.

Po vytvoření připojeného registru můžete postupovat podle dalších pokynů k jeho nasazení a použití na místní nebo vzdálené infrastruktuře.

Požadavky

  • V nástroji použijte prostředí Bash Azure Cloud Shell.

    Spuštění služby Cloud Shell v novém okně

  • Pokud tomu dáváte přednost, můžete nainstalovat Azure CLI a spouštět referenční příkazy CLI.

    • Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení jsou popsané v tématu Přihlášení pomocí Azure CLI.

    • Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Využití rozšíření v Azure CLI.

    • Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

  • Azure Container registry – pokud ještě nemáte registr kontejnerů, vytvořte ho (Premium úroveň je potřeba) v oblasti , která podporuje připojené registry.

Povolení koncového bodu vyhrazených dat pro cloudový registr

Pomocí příkazu AZ ACR Update povolte vyhrazený koncový bod dat pro službu Azure Container Registry v cloudu. Tento krok je nutný, aby mohl připojený registr komunikovat s cloudovým registrem.

# 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

Import imagí do cloudového registru

Pomocí příkazu az acr import naimportujte do cloudového registru následující image kontejneru. Pokud jste už tyto image naimportoval, tento krok přeskočte.

Image připojeného registru

Pro podporu vnořených IoT Edge scénářů musí být image kontejneru pro modul runtime připojeného registru dostupná ve vašem privátním registru kontejnerů Azure. Pomocí příkazu az acr import naimportujte připojenou image registru do privátního registru.

# 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 a proxy image rozhraní API

Pokud chcete podporovat připojený registr ve vnořených IoT Edge, musíte nasadit moduly pro IoT Edge a proxy rozhraní API. Importujte tyto image do privátního registru.

Modul proxy IoT Edge API umožňuje IoT Edge zařízení zveřejnit více služeb pomocí protokolu HTTPS na stejném portu, jako je například 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

Obrázek Hello World

Pro testování připojeného registru naimportujte hello-world image. Toto úložiště se synchronizuje s připojeným registrem a vytahují ho připojení klienti registru.

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

Vytvoření připojeného prostředku registru pro funkci čtení a zápisu

Pomocí příkazu AZ ACR Connect-Registry Create vytvořte připojený registr. Název připojeného registru musí začínat písmenem a obsahovat jenom alfanumerické znaky. V hierarchii pro tento registr kontejnerů Azure musí být 5 až 40 znaků dlouhá a jedinečná.

# 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"

Tento příkaz vytvoří připojený prostředek registru, jehož název je hodnota $CONNECTED _REGISTRY_RW a propojí ho s registrem v cloudu, jehož název je hodnota $Registry _name. V pozdějších průvodcích rychlým startem se dozvíte o možnostech nasazení připojeného registru.

  • Zadaná úložiště se budou synchronizovat mezi cloudovým registrem a připojeným registrem po jeho nasazení.

  • Vzhledem k tomu, že se --mode v připojeném registru nezadá žádná možnost, vytvoří se ve výchozím režimu.

  • Vzhledem k tomu, že pro tento připojený registr není definován žádný plán synchronizace, budou synchronizována úložiště mezi cloudovým registrem a připojeným registrem bez přerušení.

    Důležité

    Pro podporu vnořených scénářů, kde nižší vrstvy neobsahují přístup k Internetu, je nutné vždy, když povolíte synchronizaci acr/connected-registry úložiště. Toto úložiště obsahuje bitovou kopii připojeného modulu runtime registru.

Vytvoření připojeného prostředku registru pro funkci jen pro čtení

K vytvoření připojeného registru s funkcí jen pro čtení můžete použít taky příkaz AZ ACR Connect-Registry Create .

# 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

Tento příkaz vytvoří připojený prostředek registru, jehož název je hodnota $CONNECTED _REGISTRY_RO a propojí ho s registrem v cloudu s názvem s hodnotou $Registry _name.

  • Zadaná úložiště budou synchronizovaná mezi nadřazeným registrem s názvem a hodnotou $CONNECTED _REGISTRY_RW a připojeným registrem po jeho nasazení.
  • Tento prostředek se vytvoří v režimu jenpro čtení, který umožňuje po nasazení nasadit funkci jen pro čtení (pull artefaktů).
  • Vzhledem k tomu, že pro tento připojený registr není definován žádný plán synchronizace, budou synchronizována úložiště mezi nadřazeným registrem a připojeným registrem bez přerušení.

Ověření vytvoření prostředků

K ověření, že se prostředky vytvářejí, můžete použít příkaz připojit k registru AZ ACR Connect-Registry list .

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

Měla by se zobrazit následující odpověď. Vzhledem k tomu, že připojené Registry ještě nejsou nasazené, stav připojení "offline" označuje, že jsou aktuálně odpojeny od cloudu.

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

Další kroky

V tomto rychlém startu jste pomocí Azure CLI vytvořili dva připojené prostředky registru v Azure. Tyto nové připojené prostředky registru jsou svázané s registrem v cloudu a umožňují synchronizaci artefaktů s registrem v cloudu.

V Průvodci nasazením připojeného registru se dozvíte, jak nasadit a používat připojený registr v infrastruktuře IoT Edge.

Rychlý Start: nasazení připojeného registru v IoT Edge