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 konfigurerar ett geo-replikerat register som automatiskt synkroniserar registerinnehåll i mer än en Azure-region. Geo-replikering möjliggör nätverksnära åtkomst till avbildningar från regionala distributioner, samtidigt som det ger en enda hanteringsupplevelse. Det är en funktion i Premium-registertjänstnivån .
En Azure Resource Manager-mall är en JSON-fil (JavaScript Object Notation) som definierar infrastrukturen och konfigurationen för projektet. Mallen använder deklarativ syntax. Du beskriver den avsedda distributionen utan att skriva sekvensen med programmeringskommandon för att skapa distributionen.
Registret med replikering stöder inte distributioner av ARM/Bicep-mallen Fullständigt läge.
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.
Förutsättningar
Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.
Granska mallen
Mallen som används i den här snabbstarten kommer från Azure-snabbstartsmallar. Mallen konfigurerar 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.5.6.12127",
"templateHash": "12610175857982700190"
}
},
"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."
}
}
},
"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-mallexempel 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: acceptera det genererade namnet för registret eller ange ett namn. Den måste vara globalt unik.
Acr Admin-användare aktiverad: acceptera standardvärdet.
Plats: acceptera den genererade platsen för registrets startreplik eller ange en plats, till exempel USA, centrala.
Acr Sku: acceptera standardvärdet.
Plats för Acr-replik: Ange en plats för registerrepliken med regionens korta namn. Det måste skilja sig från hemregisterplatsen. 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 Azure-portalen 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-portalen eller ett verktyg som Azure CLI för att granska egenskaperna för containerregistret.
I portalen söker du efter Container Registries och väljer det containerregister som du skapade.
På sidan Översikt noterar du inloggningsservernför registret. Använd den här URI:n när du använder Docker för att tagga och skicka avbildningar till registret. Mer information finns i Push-överföra din första avbildning med Hjälp av Docker CLI.
På sidan Replikering bekräftar du platserna för startrepliken 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å till Azure-portalen, 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 ett 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 att skapa en mall finns i: