Snabbstart: Skapa ett anslutet register med hjälp av Azure CLI (för att bli inaktuell)

Artikel
10/16/2024

I den här snabbstarten använder du Azure CLI för att skapa en ansluten registerresurs i Azure. Med den anslutna registerfunktionen i Azure Container Registry kan du fjärrdistribuera ett register eller lokalt och synkronisera avbildningar och andra artefakter med molnregistret.

Här skapar du två anslutna registerresurser för ett molnregister: ett anslutet register tillåter läs- och skrivfunktioner (artefakthämtning och push) och ett tillåter skrivskyddade funktioner.

När du har skapat ett anslutet register kan du följa andra guider för att distribuera och använda det i din lokala eller fjärranslutna infrastruktur.

Förutsättningar

Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Snabbstart för Bash i Azure Cloud Shell.
Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör i Windows eller macOS kan du köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.
- Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Andra inloggningsalternativ finns i Logga in med Azure CLI.
- När du uppmanas att installera Azure CLI-tillägget vid första användningen. Mer information om tillägg finns i Använda tillägg med Azure CLI.
- Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

Azure Container Registry – Om du inte redan har ett containerregister skapar du ett (Premium-nivå krävs) i en region som stöder anslutna register.

Aktivera den dedikerade dataslutpunkten för molnregistret

Aktivera den dedikerade dataslutpunkten för Azure-containerregistret i molnet med hjälp av kommandot az acr update . Det här steget krävs för att ett anslutet register ska kunna kommunicera med molnregistret.

# 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

Importera avbildningar till ditt molnregister

Importera följande containeravbildningar till ditt molnregister med kommandot az acr import . Hoppa över det här steget om du redan har importerat bilderna.

Avbildning av anslutet register

För att stödja kapslade IoT Edge-scenarier måste containeravbildningen för den anslutna registerkörningen vara tillgänglig i ditt privata Azure-containerregister. Använd kommandot az acr import för att importera den anslutna registerbilden till ditt privata register.

# 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

Proxybilder för IoT Edge och API

För att stödja det anslutna registret på kapslade IoT Edge måste du distribuera moduler för IoT Edge- och API-proxyn. Importera dessa avbildningar till ditt privata register.

IoT Edge API-proxymodulen gör att en IoT Edge-enhet kan exponera flera tjänster med hjälp av HTTPS-protokollet på samma port, till exempel 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

Hello-world-avbildning

Importera avbildningen hello-world för att testa det anslutna registret. Den här lagringsplatsen synkroniseras med det anslutna registret och hämtas av de anslutna registerklienterna.

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

Skapa en ansluten registerresurs för läs- och skrivfunktioner

Skapa ett anslutet register med kommandot az acr connected-registry create . Det anslutna registernamnet måste börja med en bokstav och endast innehålla alfanumeriska tecken. Den måste vara mellan 5 och 40 tecken lång och unik i hierarkin för det här Azure-containerregistret.

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

Det här kommandot skapar en ansluten registerresurs vars namn är värdet för $CONNECTED_REGISTRY_RW och länkar den till molnregistret vars namn är värdet för $REGISTRY_NAME. I senare snabbstartsguider lär du dig mer om alternativ för att distribuera det anslutna registret.

De angivna lagringsplatserna synkroniseras mellan molnregistret och det anslutna registret när det har distribuerats.
Eftersom inget --mode alternativ har angetts för det anslutna registret skapas det i standardläget ReadWrite.
Eftersom inget synkroniseringsschema har definierats för det här anslutna registret synkroniseras lagringsplatserna mellan molnregistret och det anslutna registret utan avbrott.

Viktigt!

För att stödja kapslade scenarier där lägre lager inte har någon Internetåtkomst måste du alltid tillåta synkronisering av lagringsplatsen acr/connected-registry . Den här lagringsplatsen innehåller avbildningen för den anslutna registerkörningen.

Skapa en ansluten registerresurs för skrivskyddade funktioner

Du kan också använda kommandot az acr connected-registry create för att skapa ett anslutet register med skrivskyddade funktioner.

# 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

Det här kommandot skapar en ansluten registerresurs vars namn är värdet för $CONNECTED_REGISTRY_RO och länkar den till molnregistret med namnet med värdet $REGISTRY_NAME.

De angivna lagringsplatserna synkroniseras mellan det överordnade registret med namnet med värdet $CONNECTED_REGISTRY_RW och det anslutna registret när det har distribuerats.
Den här resursen skapas i ReadOnly-läget, vilket möjliggör skrivskyddade funktioner (artefakthämtning) när den har distribuerats.
Eftersom inget synkroniseringsschema har definierats för det här anslutna registret synkroniseras lagringsplatserna mellan det överordnade registret och det anslutna registret utan avbrott.

Kontrollera att resurserna har skapats

Du kan använda det anslutna registret az acr connected-registry list för att verifiera att resurserna har skapats.

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

Du bör se ett svar på följande sätt. Eftersom de anslutna registren ännu inte har distribuerats anger anslutningstillståndet "Offline" att de för närvarande är frånkopplade från molnet.

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

Nästa steg

I den här snabbstarten använde du Azure CLI för att skapa två anslutna registerresurser i Azure. De nya anslutna registerresurserna är knutna till ditt molnregister och tillåter synkronisering av artefakter med molnregistret.

Fortsätt till distributionsguiderna för anslutna register för att lära dig hur du distribuerar och använder ett anslutet register i din IoT Edge-infrastruktur.

Snabbstart: Distribuera anslutet register på IoT Edge

Dela via