Share via

Tutorial: Menggunakan templat yang diekspor dari portal Azure

  • Artikel

Dalam seri tutorial ini, Anda telah membuat templat untuk menyebarkan akun penyimpanan Azure. Dalam dua tutorial berikutnya, Anda menambahkan paket App Service dan situs web. Daripada membuat templat dari awal, Anda akan mempelajari cara mengekspor templat dari portal Azure serta cara menggunakan templat sampel dari Templat Mulai Cepat Azure. Anda mengkustomisasi templat tersebut untuk Anda gunakan. Tutorial ini berfokus pada cara mengekspor templat dan cara melakukan kustomisasi hasil templat Anda. Instruksi ini membutuhkan waktu selama 14 menit.

Prasyarat

Kami menyarankan agar Anda menyelesaikan tutorial tentang output, tetapi tidak diperlukan.

Anda harus sudah memasang Visual Studio Code dengan ekstensi Alat Resource Manager, dan Azure PowerShell atau Azure Command-Line Interface (CLI). Untuk informasi selengkapnya, lihat alat templat.

Meninjau templat

Di akhir tutorial sebelumnya, templat Anda memiliki file JSON berikut:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "type": "string",
      "minLength": 3,
      "maxLength": 11
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-09-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ],
  "outputs": {
    "storageEndpoint": {
      "type": "object",
      "value": "[reference(variables('uniqueStorageName')).primaryEndpoints]"
    }
  }
}

Template ini berfungsi dengan baik untuk menyebarkan akun penyimpanan, tetapi Anda mungkin ingin menambahkan lebih banyak sumber daya ke dalamnya. Anda dapat mengekspor templat dari sumber daya yang ada untuk mendapatkan JSON dengan cepat untuk sumber daya tersebut.

Membuat paket App Service

  1. Masuk ke portal Microsoft Azure.

  2. Pilih Buat sumber daya.

  3. Di Layanan Pencarian di Marketplace, masukkan Paket App Service, lalu pilih Paket App Service.

  4. Pilih Buat.

  5. Di halaman Buat Paket App Service, masukkan informasi berikut:

    • Langganan - Pilih langganan Azure Anda dari menu drop-down.
    • Grup Sumber Daya: Pilih Buat baru lalu tentukan nama. Beri nama grup sumber daya dengan nama yang berbeda dari yang telah Anda gunakan dalam seri tutorial ini.
    • Nama: masukkan nama untuk Paket App Service.
    • Sistem operasi: Pilih Linux.
    • Wilayah: Pilih lokasi Azure dari menu drop-down, seperti US Tengah.
    • Tingkat Harga: Untuk menghemat biaya, pilih Ubah ukuran untuk mengubah SKU dan ukuran menjadi Dasar pertama (B1), di bagian Dev / Test untuk beban kerja yang tidak terlalu berat.

    Cuplikan layar halaman Buat Paket App Service di portal Azure.

  6. Pilih Tinjau dan buat.

  7. Pilih Buat. Dibutuhkan beberapa saat untuk membuat sumber daya.

Ekspor templat

  1. Pilih Buka sumber daya.

    Cuplikan layar tombol Buka sumber daya di portal Azure.

  2. Dari menu sebelah kiri, di bagian Automasi, pilih Ekspor templat.

    Cuplikan layar opsi Ekspor templat di portal Azure.

    Fitur templat ekspor mengambil status sumber daya saat ini dan menghasilkan templat untuk menyebarkannya. Mengekspor templat bisa menjadi cara yang bermanfaat untuk dengan cepat mendapatkan JSON yang Anda perlukan untuk menyebarkan sumber daya.

  3. Lihat definisi Microsoft.Web/serverfarms dan definisi parameter dalam templat yang diekspor. Anda tidak perlu menyalin bagian ini. Anda bisa menggunakan templat yang diekspor ini sebagai contoh bagaimana Anda ingin menambahkan sumber daya ini ke templat Anda.

    Cuplikan layar kode JSON templat yang diekspor di portal Azure.

Penting

Biasanya, templat yang diekspor lebih verbose daripada yang Anda inginkan saat membuat templat. Sebagai contoh, objek SKU dalam templat yang diekspor memiliki lima properti. Templat ini berfungsi, tetapi Anda bisa menggunakan properti name. Anda dapat memulai dengan templat yang diekspor, lalu modifikasi sesuai dengan keinginan serta kebutuhan Anda.

Merevisi templat yang sudah ada

Templat yang diekspor memberi Anda sebagian besar JSON yang Anda butuhkan, tetapi Anda perlu menyesuaikannya untuk templat Anda. Perhatikan perbedaan parameter dan variabel antara templat Anda dan templat yang diekspor. Jelas, proses ekspor tidak mengetahui parameter dan variabel yang telah Anda tentukan dalam templat Anda.

Contoh berikut menyoroti penambahan templat Anda. Ini berisi kode yang diekspor ditambah beberapa perubahan. Pertama, mengubah nama parameter agar sesuai dengan konvensi penamaan Anda. Kedua, menggunakan parameter lokasi Anda untuk lokasi paket layanan aplikasi. Ketiga, menghapus beberapa properti di mana nilai default baik-baik saja.

Salin seluruh file dan ganti templat Anda dengan kontennya.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "type": "string",
      "minLength": 3,
      "maxLength": 11
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    },
    "appServicePlanName": {
      "type": "string",
      "defaultValue": "exampleplan"
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-09-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    },
    {
      "type": "Microsoft.Web/serverfarms",
      "apiVersion": "2021-03-01",
      "name": "[parameters('appServicePlanName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "B1",
        "tier": "Basic",
        "size": "B1",
        "family": "B",
        "capacity": 1
      },
      "kind": "linux",
      "properties": {
        "perSiteScaling": false,
        "reserved": true,
        "targetWorkerCount": 0,
        "targetWorkerSizeId": 0
      }
    }
  ],
  "outputs": {
    "storageEndpoint": {
      "type": "object",
      "value": "[reference(variables('uniqueStorageName')).primaryEndpoints]"
    }
  }
}

Menyebarkan templat

Gunakan Azure CLI atau Azure PowerShell untuk menyebarkan templat.

Jika Anda belum membuat grup sumber daya, lihat Membuat grup sumber daya. Contoh itu mengasumsikan bahwa Anda telah mengatur variabel templateFile ke jalur ke file templat, seperti ditunjukkan dalam tutorial pertama.

New-AzResourceGroupDeployment `
  -Name addappserviceplan `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile `
  -storagePrefix "store" `
  -storageSKU Standard_LRS

Catatan

Jika penyebaran gagal, gunakan tombol verbose untuk mendapatkan informasi tentang sumber daya yang Anda buat. Gunakan tombol debug untuk mendapatkan informasi lebih lanjut tentang penelusuran kesalahan.

Verifikasi penyebaran

Anda dapat memverifikasi penyebaran dengan menjelajahi grup sumber daya dari portal Azure.

  1. Masuk ke portal Azure.
  2. Dari menu sebelah kiri, pilih Grup sumber daya.
  3. Pilih grup sumber daya tempat Anda menerapkan.
  4. Grup sumber daya berisi akun penyimpanan dan Paket App Service.

Membersihkan sumber daya

Jika Anda beralih ke tutorial berikutnya, Anda tidak perlu menghapus grup sumber daya.

Jika Anda berhenti sekarang, Anda mungkin ingin menghapus grup sumber daya.

  1. Dari portal Microsoft Azure, pilih Grup sumber daya dari menu sebelah kiri.
  2. Ketik nama grup sumber daya di bidang teks Filter untuk setiap bidang....
  3. Centang kotak di samping myResourceGroup dan pilih myResourceGroup atau nama grup sumber daya Anda.
  4. Pilih Hapus grup sumber daya dari menu atas.

Langkah berikutnya

Anda sudah mempelajari cara mengekspor templat dari portal Azure serta cara menggunakan templat yang diekspor untuk pengembangan templat Anda. Anda juga dapat menggunakan Templat Mulai Cepat Azure untuk menyederhanakan pengembangan templat.

Menggunakan Templat Mulai Cepat Azure