Bagikan melalui

Putar kembali kesalahan ke penyebaran yang berhasil

Saat penyebaran gagal, Anda dapat secara otomatis menyebarkan ulang penyebaran yang sebelumnya dan berhasil dari riwayat penyebaran Anda. Fungsionalitas ini berguna jika Anda memiliki status baik yang diketahui untuk penyebaran infrastruktur Anda dan ingin kembali ke status ini. Anda dapat menentukan penyebaran tertentu sebelumnya atau penyebaran terakhir yang berhasil.

Penting

Fitur ini mengembalikan penyebaran yang gagal dengan menyebarkan ulang penyebaran sebelumnya. Hasil ini mungkin berbeda daripada yang Anda harapkan ketika membatalkan penyebaran yang gagal. Pastikan Anda memahami bagaimana penyebaran sebelumnya disebarkan ulang.

Pertimbangan untuk penempatan kembali

Sebelum menggunakan fitur ini, pertimbangkan detail ini tentang bagaimana penyebaran ulang ditangani:

  • Penyebaran sebelumnya dijalankan menggunakan mode lengkap, meskipun Anda telah menggunakan mode bertahap selama penyebaran sebelumnya. Penyebaran ulang dalam mode lengkap dapat menghasilkan hasil yang tidak terduga ketika penyebaran sebelumnya digunakan secara bertahap. Mode lengkap berarti bahwa sumber daya apa pun yang tidak disertakan dalam penyebaran sebelumnya dihapus. Tentukan penyebaran sebelumnya yang mewakili semua sumber daya dan statusnya yang Anda inginkan untuk ada di grup sumber daya. Untuk informasi selengkapnya, lihat mode penyebaran.
  • Penyebaran ulang dijalankan persis seperti yang dijalankan sebelumnya dengan parameter yang sama. Anda tidak dapat mengubah parameter.
  • Penyebaran ulang hanya memengaruhi sumber daya, perubahan data apa pun tidak terpengaruh.
  • Anda hanya dapat menggunakan fitur ini dengan penyebaran grup sumber daya. Ini tidak mendukung penyebaran tingkat langganan, grup manajemen, atau penyewa. Untuk informasi selengkapnya tentang penyebaran tingkat langganan, lihat Membuat grup sumber daya dan sumber daya di tingkat langganan.
  • Anda hanya dapat menggunakan opsi ini dengan penyebaran tingkat root. Penyebaran dari templat berlapis tidak tersedia untuk penyebaran ulang.

Untuk menggunakan opsi ini, penyebaran Anda harus memiliki nama unik dalam riwayat penyebaran. Hanya dengan nama unik, penyebaran tertentu dapat diidentifikasi. Jika Anda tidak memiliki nama unik, penyebaran yang gagal mungkin menimpa penyebaran yang berhasil di dalam riwayat.

Jika Anda menentukan penyebaran sebelumnya yang tidak ada dalam riwayat penyebaran, pengembalian menampilkan kesalahan.

PowerShell

Untuk menyebarkan ulang hasil penyebaran terakhir yang berhasil, tambahkan parameter -RollbackToLastDeployment sebagai penanda.

New-AzResourceGroupDeployment -Name ExampleDeployment02 `
  -ResourceGroupName $resourceGroupName `
  -TemplateFile c:\MyTemplates\azuredeploy.json `
  -RollbackToLastDeployment

Untuk menyebarkan ulang penyebaran tertentu, gunakan -RollBackDeploymentName parameter dan berikan nama penyebaran. Penyebaran yang ditentukan harus sudah berhasil.

New-AzResourceGroupDeployment -Name ExampleDeployment02 `
  -ResourceGroupName $resourceGroupName `
  -TemplateFile c:\MyTemplates\azuredeploy.json `
  -RollBackDeploymentName ExampleDeployment01

Azure CLI (antarmuka baris perintah Azure)

Untuk menyebarkan ulang hasil penyebaran terakhir yang berhasil, tambahkan parameter --rollback-on-error sebagai penanda.

az deployment group create \
  --name ExampleDeployment \
  --resource-group ExampleGroup \
  --template-file storage.json \
  --parameters storageAccountType=Standard_GRS \
  --rollback-on-error

Untuk menyebarkan ulang penyebaran tertentu, gunakan --rollback-on-error parameter dan berikan nama penyebaran. Penyebaran yang ditentukan harus sudah berhasil.

az deployment group create \
  --name ExampleDeployment02 \
  --resource-group ExampleGroup \
  --template-file storage.json \
  --parameters storageAccountType=Standard_GRS \
  --rollback-on-error ExampleDeployment01

REST API

Untuk menyebarkan ulang penyebaran terakhir yang berhasil jika penyebaran saat ini gagal, gunakan:

{
  "properties": {
    "templateLink": {
      "uri": "http://mystorageaccount.blob.core.windows.net/templates/template.json",
      "contentVersion": "1.0.0.0"
    },
    "mode": "Incremental",
    "parametersLink": {
      "uri": "http://mystorageaccount.blob.core.windows.net/templates/parameters.json",
      "contentVersion": "1.0.0.0"
    },
    "onErrorDeployment": {
      "type": "LastSuccessful",
    }
  }
}

Untuk menyebarkan ulang penyebaran tertentu jika penyebaran saat ini gagal, gunakan:

{
  "properties": {
    "templateLink": {
      "uri": "http://mystorageaccount.blob.core.windows.net/templates/template.json",
      "contentVersion": "1.0.0.0"
    },
    "mode": "Incremental",
    "parametersLink": {
      "uri": "http://mystorageaccount.blob.core.windows.net/templates/parameters.json",
      "contentVersion": "1.0.0.0"
    },
    "onErrorDeployment": {
      "type": "SpecificDeployment",
      "deploymentName": "<deploymentname>"
    }
  }
}

Penyebaran yang ditentukan harus sudah berhasil.

Langkah selanjutnya

  • Last updated on