Hızlı Başlangıç: ARM şablonu kullanarak coğrafi olarak çoğaltılmış kapsayıcı kayıt defteri oluşturma

Bu hızlı başlangıçta, Azure Resource Manager şablonu (ARM şablonu) kullanarak Azure Container Registry örneğinin nasıl oluşturulacağı gösterilmektedir. Şablon, birden fazla Azure bölgesinde kayıt defteri içeriğini otomatik olarak eşitleyen coğrafi olarak çoğaltılmış bir kayıt defteri ayarlar. Coğrafi çoğaltma, bölgesel dağıtımlardan görüntülere ağdan yakın erişim sağlarken tek bir yönetim deneyimi sağlar. Premium kayıt defteri hizmet katmanının bir özelliğidir.

Azure Resource Manager şablonu, projenizin altyapısını ve yapılandırmasını tanımlayan bir JavaScript Nesne Gösterimi (JSON) dosyasıdır. Bu şablonda, bildirim temelli sözdizimi kullanılır. Dağıtımı oluşturmak için programlama komutlarının sırasını yazmadan hedeflenen dağıtımınızı açıklarsınız.

Çoğaltmaları olan kayıt defteri ARM/Bicep şablonu Tamamlama modu dağıtımlarını desteklemez.

Ortamınız önkoşulları karşılıyorsa ve ARM şablonlarını kullanma hakkında bilginiz varsa, Azure’a dağıtma düğmesini seçin. Şablon Azure portalda açılır.

Button to deploy the Resource Manager template to Azure.

Önkoşullar

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Şablonu gözden geçirme

Bu hızlı başlangıçta kullanılan şablon Azure Hızlı Başlangıç Şablonlarından alınmıştır. Şablon bir kayıt defteri ve ek bir bölgesel çoğaltma ayarlar.

{
  "$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]"
    }
  }
}

Şablonda aşağıdaki kaynaklar tanımlanır:

Daha fazla Azure Container Registry şablon örneği, hızlı başlangıç şablonu galerisinde bulunabilir.

Şablonu dağıtma

  1. Aşağıdaki görüntüyü seçerek Azure'da oturum açıp bir şablon açın.

    Button to deploy the Resource Manager template to Azure.

  2. Aşağıdaki değerleri seçin veya girin.

    • Abonelik: Bir Azure aboneliği seçin.

    • Kaynak grubu: Yeni oluştur'u seçin, kaynak grubu için benzersiz bir ad girin ve tamam'ı seçin.

    • Bölge: Kaynak grubu için bir konum seçin. Örnek: Orta ABD.

    • Acr Name: Kayıt defteri için oluşturulan adı kabul edin veya bir ad girin. Genel olarak benzersiz olmalıdır.

    • Acr Yönetici Kullanıcı Etkin: varsayılan değeri kabul edin.

    • Konum: Kayıt defterinin giriş çoğaltması için oluşturulan konumu kabul edin veya Orta ABD gibi bir konum girin.

    • Acr Sku: varsayılan değeri kabul edin.

    • Acr Çoğaltma Konumu: Bölgenin kısa adını kullanarak kayıt defteri çoğaltması için bir konum girin. Giriş kayıt defteri konumundan farklı olmalıdır. Örnek: westeurope.

      Template properties

  3. Gözden Geçir + Oluştur'u seçin, ardından hüküm ve koşulları gözden geçirin. Kabul ediyorsanız Oluştur'u seçin.

  4. Kayıt defteri başarıyla oluşturulduktan sonra bir bildirim alırsınız:

    Portal notification

Şablonu dağıtmak için Azure portalı kullanılır. Azure portalına ek olarak Azure PowerShell, Azure CLI ve REST API'sini de kullanabilirsiniz. Diğer dağıtım yöntemlerini öğrenmek için bkz . Şablonları dağıtma.

Dağıtılan kaynakları gözden geçirme

Kapsayıcı kayıt defterinin özelliklerini gözden geçirmek için Azure portalını veya Azure CLI gibi bir aracı kullanın.

  1. Portalda Kapsayıcı Kayıt Defterleri'ni arayın ve oluşturduğunuz kapsayıcı kayıt defterini seçin.

  2. Genel Bakış sayfasında, kayıt defterinin Oturum açma sunucusuna dikkat edin. Görüntüleri etiketlemek ve kayıt defterinize göndermek için Docker kullanırken bu URI'yi kullanın. Bilgi için bkz . Docker CLI kullanarak ilk görüntünüzü gönderme.

    Registry overview

  3. Çoğaltmalar sayfasında, giriş çoğaltmasının ve şablon aracılığıyla eklenen çoğaltmanın konumlarını onaylayın. İsterseniz, bu sayfaya daha fazla çoğaltma ekleyin.

    Registry replications

Kaynakları temizleme

Bunlara artık ihtiyacınız kalmadığında kaynak grubunu, kayıt defterini ve kayıt defteri çoğaltmasını silin. Bunu yapmak için Azure portalına gidin, kayıt defterini içeren kaynak grubunu seçin ve ardından Kaynak grubunu sil'i seçin.

Delete resource group

Sonraki adımlar

Bu hızlı başlangıçta, ARM şablonuyla bir Azure Container Registry oluşturdunuz ve başka bir konumda bir kayıt defteri çoğaltması yapılandırmıştınız. ACR'ye daha ayrıntılı bir bakış için Azure Container Registry öğreticilerine geçin.

Şablon oluşturma işleminde size yol gösteren adım adım öğretici için bkz: