Rychlý start: Vytvoření připojeného registru pomocí Azure CLI (zastaralé)
V tomto rychlém startu použijete Azure CLI k vytvoření připojeného prostředku registru v Azure. Funkce připojeného registru služby Azure Container Registry umožňuje vzdáleně nebo místně nasadit registr a synchronizovat image a další artefakty s cloudovým registrem.
Tady vytvoříte dva připojené prostředky registru pro cloudový registr: jeden připojený registr umožňuje funkci čtení a zápisu (vyžádání 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 příruček k nasazení a použití v místní nebo vzdálené infrastruktuře.
Požadavky
Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Rychlý start pro Bash v Azure Cloud Shellu.
Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Dockeru.
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í najdete 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 kontejneru, vytvořte jednu úroveň (vyžaduje se úroveň Premium) v oblasti , která podporuje připojené registry.
Povolení vyhrazeného datového koncového bodu pro cloudový registr
Povolte vyhrazený datový koncový bod pro registr kontejneru Azure v cloudu pomocí příkazu az acr update . Tento krok je potřeba pro komunikaci připojeného registru 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 následující image kontejneru do svého cloudového registru. Pokud jste tyto image už naimportovali, tento krok přeskočte.
Připojená image registru
Aby bylo možné podporovat vnořené scénáře IoT Edge, musí být image kontejneru pro připojený modul runtime registru dostupná ve vašem privátním registru kontejneru Azure. Pomocí příkazu az acr import naimportujte image připojeného 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.8.0
Image proxy služby IoT Edge a rozhraní API
Pokud chcete podporovat připojený registr ve vnořeném IoT Edge, musíte nasadit moduly pro ioT Edge a proxy rozhraní API. Naimportujte tyto image do privátního registru.
Modul proxy rozhraní API služby IoT Edge umožňuje zařízení IoT Edge zpřístupnit 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 bude synchronizovat s připojeným registrem a vyžádá se připojenými klienty 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
Vytvořte připojený registr pomocí příkazu az acr connected-registry create . Název připojeného registru musí začínat písmenem a obsahovat pouze alfanumerické znaky. Musí mít délku 5 až 40 znaků a musí být jedinečná v hierarchii pro tento registr kontejnerů Azure.
# 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 cloudovým registrem, jehož název je hodnota $REGISTRY_NAME. V dalších rychlých příručkách se dozvíte o možnostech nasazení připojeného registru.
Zadaná úložiště se po nasazení synchronizují mezi cloudovým registrem a připojeným registrem.
Vzhledem k tomu, že pro připojený registr není zadána žádná
--modemožnost, vytvoří se ve výchozím režimu ReadWrite.Vzhledem k tomu, že pro tento připojený registr není definovaný žádný plán synchronizace, úložiště se budou synchronizovat mezi cloudovým registrem a připojeným registrem bez přerušení.
Důležité
Pokud chcete podporovat vnořené scénáře, kdy nižší vrstvy nemají přístup k internetu, musíte vždy povolit synchronizaci
acr/connected-registryúložiště. Toto úložiště obsahuje image pro modul runtime připojeného registru.
Vytvoření připojeného prostředku registru pro funkce jen pro čtení
K vytvoření připojeného registru s funkcí jen pro čtení můžete použít příkaz az acr connected-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 cloudovým registrem pojmenovaným hodnotou $REGISTRY_NAME.
- Zadaná úložiště budou synchronizována mezi nadřazeným registrem s hodnotou $CONNECTED_REGISTRY_RW a připojeným registrem po nasazení.
- Tento prostředek se vytvoří v režimu Jen pro čtení, který umožňuje po nasazení funkci jen pro čtení (vyžádání artefaktu).
- Vzhledem k tomu, že pro tento připojený registr není definován žádný plán synchronizace, úložiště se budou synchronizovat mezi nadřazeným registrem a připojeným registrem bez přerušení.
Ověřte, že se prostředky vytvořily.
K ověření vytvoření prostředků můžete použít příkaz az acr connected-registry list .
az acr connected-registry list \
--registry $REGISTRY_NAME \
--output table
Odpověď by se měla zobrazit následujícím způsobem. Vzhledem k tomu, že připojené registry ještě nejsou nasazené, stav připojení Offline znamená, že jsou aktuálně odpojené 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 vaším cloudovým registrem a umožňují synchronizaci artefaktů s cloudovým registrem.
Pokračujte v průvodcích nasazením připojeného registru a zjistěte, jak nasadit a používat připojený registr ve vaší infrastruktuře IoT Edge.