Snabbstart: Skapa ett anslutet register med hjälp av Azure Portal (för att bli inaktuell)
I den här snabbstarten använder du Azure Portal 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
- 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.
Om du vill importera avbildningar till containerregistret använder du Azure CLI:
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.
Aktivera den dedikerade dataslutpunkten för molnregistret
Aktivera den dedikerade dataslutpunkten för Azure-containerregistret i molnet. Det här steget krävs för att ett anslutet register ska kunna kommunicera med molnregistret.
- I Azure Portal går du till containerregistret.
- Välj Offentlig åtkomst för >nätverk. Markera kryssrutan Aktivera dedikerad dataslutpunkt .
- Välj Spara.
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
Följande steg skapar ett anslutet register i ReadWrite-läge som är länkat till molnregistret.
- I Azure Portal går du till containerregistret.
- Välj Anslutna register (förhandsversion) > + Skapa.
- Ange eller välj värdena i följande tabell och välj Spara.
| Objekt | beskrivning |
|---|---|
| Parent | Välj Ingen överordnad för ett anslutet register som är länkat till molnregistret. |
| Läge | Välj Skriv upp. |
| Name | 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. |
| Loggningsegenskaper | Acceptera standardinställningarna. |
| Synkroniseringsegenskaper | Acceptera standardinställningarna. Eftersom inget synkroniseringsschema har definierats som standard synkroniseras lagringsplatserna mellan molnregistret och det anslutna registret utan avbrott. |
| Centrallager | Välj eller ange namnen på de lagringsplatser som du importerade i föregående steg. De angivna lagringsplatserna synkroniseras mellan molnregistret och det anslutna registret när det har distribuerats. |
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
Följande steg skapar ett anslutet register i ReadOnly-läge vars överordnade är det anslutna registret som du skapade i föregående avsnitt. Det här anslutna registret aktiverar skrivskyddade funktioner (artefakthämtning) när det har distribuerats.
- I Azure Portal går du till containerregistret.
- Välj Anslutna register (förhandsversion) > + Skapa.
- Ange eller välj värdena i följande tabell och välj Spara.
| Objekt | beskrivning |
|---|---|
| Parent | Välj det anslutna registret som du skapade tidigare. |
| Läge | Välj ReadOnly. |
| Name | 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. |
| Loggningsegenskaper | Acceptera standardinställningarna. |
| Synkroniseringsegenskaper | Acceptera standardinställningarna. Eftersom inget synkroniseringsschema har definierats som standard synkroniseras lagringsplatserna mellan molnregistret och det anslutna registret utan avbrott. |
| Centrallager | Välj eller ange namnen på de lagringsplatser som du importerade i föregående steg. De angivna lagringsplatserna synkroniseras mellan det överordnade registret och det anslutna registret när det har distribuerats. |
Visa egenskaper för anslutna register
Välj ett anslutet register i portalen för att visa dess egenskaper, till exempel dess anslutningsstatus (Offline, Online eller Inte felfri) och om det har aktiverats (distribuerats lokalt). I följande exempel distribueras inte det anslutna registret. Dess anslutningstillstånd "Offline" anger att det för närvarande är frånkopplat från molnet.
Från den här vyn kan du också generera en anslutningssträng och eventuellt generera lösenord för synkroniseringstoken. En anslutningssträng innehåller konfigurationsinställningar som används för att distribuera ett anslutet register och synkronisera innehåll med ett överordnat register.
Nästa steg
I den här snabbstarten använde du Azure Portal 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.