Snabbstart: Skapa ett anslutet register med hjälp av Azure Portal
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 du distribuera ett register via fjärrlagring 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 (artefakt pull och push) och en 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.
- Om du vill kan du i stället installera Azure CLI för att köra CLI-referenskommandon.- 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. Fler inloggningsalternativ finns i Logga in med Azure CLI.- När du uppmanas till det installerar du Azure CLI-tillägg vid första användning. 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 Portaldu till containerregistret.
- Välj Nätverksåtkomst > Offentlig åtkomst. 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 dessa avbildningar.
Ansluten registeravbildning
För att stöda 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 registeravbildningen 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.5.0
IoT Edge- och API-proxyavbildningar
För att stödja det anslutna registret på kapslade IoT Edge måste du distribuera moduler för IoT Edge och API-proxy. Importera dessa avbildningar till ditt privata register.
Med IoT Edge-API-proxymodulen kan IoT Edge en enhet 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 för att testa det anslutna hello-world registret. Den här lagringsplatsen synkroniseras till 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 Läget ReadWrite som är länkat till molnregistret.
- I Azure Portaldu 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 |
|---|---|
| Överordnad | Välj Ingen överordnad för ett anslutet register som är länkat till molnregistret. |
| Läge | Välj ReadWrite. |
| Name | Det anslutna registernamnet måste börja med en bokstav och får bara innehålla alfanumeriska tecken. Det måste vara mellan 5 och 40 tecken långt och unikt i hierarkin för det här Azure-containerregistret. |
| Loggningsegenskaper | Acceptera standardinställningarna. |
| Synkroniseringsegenskaper | Acceptera standardinställningarna. Eftersom inget synkroniseringsschema definieras som standard synkroniseras lagringsplatsen mellan molnregistret och det anslutna registret utan avbrott. |
| Centrallager | Välj eller ange namnen på lagringsplatsen som du importerade i föregående steg. De angivna lagringsplatsen 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 acr/connected-registry lagringsplatsen. 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 (artefakt-pull) när de har distribuerats.
- I Azure Portaldu 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 |
|---|---|
| Överordnad | 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 får bara innehålla alfanumeriska tecken. Det måste vara mellan 5 och 40 tecken långt och unikt i hierarkin för det här Azure-containerregistret. |
| Loggningsegenskaper | Acceptera standardinställningarna. |
| Synkroniseringsegenskaper | Acceptera standardinställningarna. Eftersom inget synkroniseringsschema definieras som standard synkroniseras lagringsplatsen mellan molnregistret och det anslutna registret utan avbrott. |
| Centrallager | Välj eller ange namnen på lagringsplatsen som du importerade i föregående steg. De angivna lagringsplatsen 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 anslutningsstatus (Offline, Online eller Ej felande) och om det har aktiverats (distribuerat lokalt). I följande exempel distribueras inte det anslutna registret. Anslutningstillståndet "Offline" anger att den för närvarande är frånkopplad 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 guiderna för ansluten registerdistribution för att lära dig hur du distribuerar och använder ett anslutet register IoT Edge infrastrukturen.