Snabbstart: Skapa ett geo-replikerat containerregister med hjälp av en ARM-mall
Den här snabbstarten visar hur du skapar en Azure Container Registry-instans med hjälp av en Azure Resource Manager mall (ARM-mall). Mallen uppsättningar ett geo-replikerat register som automatiskt synkroniserar registerinnehåll i mer än en Azure-region. Geo-replikering ger nätverksåtkomst till avbildningar från regionala distributioner, samtidigt som du får en enda hanteringsupplevelse. Det är en funktion i Premium registertjänstnivå.
En ARM-mall är en JSON-fil (JavaScript Object Notation) som definierar infrastrukturen och konfigurationen för ditt projekt. Mallen använder deklarativ syntax. I deklarativ syntax beskriver du din avsedda distribution utan att skriva sekvensen med programmeringskommandon för att skapa den.
Om din miljö uppfyller förhandskraven och du är van att använda ARM-mallar väljer du knappen Distribuera till Azure. Mallen öppnas på Azure-portalen.
Krav
Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.
Granska mallen
Mallen som används i den här snabbstarten kommer från Azure-snabbstartsmallar. Mallen uppsättningar ett register och ytterligare en regional replik.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"metadata": {
"_generator": {
"name": "bicep",
"version": "0.4.1008.15138",
"templateHash": "4211689371383977719"
}
},
"parameters": {
"acrName": {
"type": "string",
"defaultValue": "[format('acr{0}', uniqueString(resourceGroup().id))]",
"maxLength": 50,
"minLength": 5,
"metadata": {
"description": "Globally unique name of your Azure Container Registry"
}
},
"acrAdminUserEnabled": {
"type": "bool",
"defaultValue": false,
"metadata": {
"description": "Enable admin user that has push / pull permission to the registry."
}
},
"location": {
"type": "string",
"defaultValue": "[resourceGroup().location]",
"metadata": {
"description": "Location for registry home replica."
}
},
"acrSku": {
"type": "string",
"defaultValue": "Premium",
"allowedValues": [
"Premium"
],
"metadata": {
"description": "Tier of your Azure Container Registry. Geo-replication requires Premium SKU."
}
},
"acrReplicaLocation": {
"type": "string",
"metadata": {
"description": "Short name for registry replica location."
}
}
},
"functions": [],
"resources": [
{
"type": "Microsoft.ContainerRegistry/registries",
"apiVersion": "2019-12-01-preview",
"name": "[parameters('acrName')]",
"location": "[parameters('location')]",
"sku": {
"name": "[parameters('acrSku')]"
},
"tags": {
"displayName": "Container Registry",
"container.registry": "[parameters('acrName')]"
},
"properties": {
"adminUserEnabled": "[parameters('acrAdminUserEnabled')]"
}
},
{
"type": "Microsoft.ContainerRegistry/registries/replications",
"apiVersion": "2019-12-01-preview",
"name": "[format('{0}/{1}', parameters('acrName'), parameters('acrReplicaLocation'))]",
"location": "[parameters('acrReplicaLocation')]",
"properties": {},
"dependsOn": [
"[resourceId('Microsoft.ContainerRegistry/registries', parameters('acrName'))]"
]
}
],
"outputs": {
"acrLoginServer": {
"type": "string",
"value": "[reference(resourceId('Microsoft.ContainerRegistry/registries', parameters('acrName'))).loginServer]"
}
}
}
Följande resurser definieras i mallen:
- Microsoft.ContainerRegistry/registries: skapa ett Azure-containerregister
- Microsoft.ContainerRegistry/registries/replications: skapa en containerregisterreplik
Fler Azure Container Registry finns i snabbstartsmallgalleriet.
Distribuera mallen
Välj följande bild för att logga in på Azure och öppna en mall.
Välj eller ange följande värden.
Prenumeration: välj en Azure-prenumeration.
Resursgrupp: välj Skapa ny, ange ett unikt namn för resursgruppen och välj sedan OK.
Region: Välj en plats för resursgruppen. Exempel: USA, centrala.
Acr Name( Acr-namn): acceptera det genererade namnet för registret eller ange ett namn. Det måste vara globalt unikt.
Acr Admin User Enabled (Acr Admin-användare aktiverad): acceptera standardvärdet.
Plats: acceptera den genererade platsen för registrets hemreplik eller ange en plats, till exempel USA, centrala.
Acr SKU: acceptera standardvärdet.
Acr Replica Location (Plats för Acr-replik): Ange en plats för registerrepliken med hjälp av regionens korta namn. Den måste vara annorlunda än hemregistrets plats. Exempel: westeurope.
Välj Granska + skapa och granska sedan villkoren. Om du godkänner väljer du Skapa.
När registret har skapats får du ett meddelande:
Azure-portalen används för att distribuera mallen. Förutom den här Azure Portal kan du använda Azure PowerShell, Azure CLI och REST API. Mer information om andra distributionsmetoder finns i Distribuera mallar.
Granska distribuerade resurser
Använd Azure Portal eller ett verktyg som Azure CLI för att granska egenskaperna för containerregistret.
I portalen söker du efter Containerregister och väljer det containerregister som du skapade.
På sidan Översikt noterar du registrets inloggningsserver. Använd den här URI:n när du använder Docker för att tagga och push-skicka avbildningar till registret. Mer information finns i Push your first image using the Docker CLI (Skicka din första avbildning med Docker CLI).
På sidan Replikeringar bekräftar du platserna för hemrepliken och repliken som lagts till via mallen. Om du vill kan du lägga till fler repliker på den här sidan.
Rensa resurser
När du inte längre behöver dem tar du bort resursgruppen, registret och registerrepliken. Det gör du genom att gå Azure Portal, välja den resursgrupp som innehåller registret och sedan välja Ta bort resursgrupp.
Nästa steg
I den här snabbstarten skapade du en Azure Container Registry med en ARM-mall och konfigurerade en registerreplik på en annan plats. Fortsätt till självstudien om Azure Container Registry om du vill titta närmare på ACR.
En stegvis självstudiekurs som vägleder dig genom processen med att skapa en mall finns i: