Menggunakan tombol penyebaran untuk menyebarkan templat jarak jauh

Artikel ini menjelaskan cara menggunakan tombol Sebarkan ke Azure untuk menyebarkan templat ARM JSON dari repositori GitHub atau akun penyimpanan Azure. Anda dapat menambahkan tombol langsung ke file README.md di repositori GitHub Anda. Atau, Anda dapat menambahkan tombol ke halaman web yang mereferensikan repositori. Metode ini tidak mendukung penyebaran File Bicep jarak jauh.

Cakupan penyebaran ditentukan oleh skema templat. Untuk informasi selengkapnya, lihat:

• grup sumber daya
• langganan
• grup manajemen
• penyewa

Izin yang diperlukan

Untuk menyebarkan file Bicep atau templat ARM, Anda memerlukan akses tulis pada sumber daya yang Anda sebarkan dan mengakses ke semua operasi di Microsoft.Resources/deployments resource type. Misalnya, untuk menyebarkan mesin virtual, Anda memerlukan izin Microsoft.Compute/virtualMachines/write dan Microsoft.Resources/deployments/*. Operasi bagaimana-jika memiliki persyaratan izin yang sama.

Untuk daftar peran dan izin, lihat Peran bawaan Azure.

Gunakan gambar umum

Untuk menambahkan tombol ke halaman web atau repositori Anda, gunakan gambar berikut:

markdown

![Deploy to Azure](https://aka.ms/deploytoazurebutton)

HTML

<img src="https://aka.ms/deploytoazurebutton"/>

Gambar muncul sebagai:

Membuat URL untuk menyebarkan templat

Bagian ini menunjukkan cara mendapatkan URL untuk templat yang disimpan di akun penyimpanan GitHub dan Azure, dan cara memformat URL.

Templat yang disimpan di GitHub

Guna membuat URL untuk templat Anda, mulai dengan URL mentah ke templat di repositori GitHub Anda. Untuk melihat URL mentah, pilih Mentah.

Format URL adalah:

HTML

https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json

Catatan

Untuk menyebarkan templat atau mereferensikan templat tertaut yang disimpan di repositori GitHub privat, lihat solusi kustom yang didokumentasikan dalam Membuat Penawaran Portal Microsoft Azure Kustom yang Aman. Anda dapat membuat Fungsi Azure yang menarik token GitHub keluar dari Azure Key Vault.

Jika Anda menggunakan Git dengan Repositori Azure sebagai ganti dari repositori GitHub, Anda masih bisa menggunakan tombol Sebarkan ke Azure. Pastikan repositori Anda publik. Gunakan Operasi item untuk mendapatkan templat. Permintaan Anda harus dalam format berikut:

HTTP

https://dev.azure.com/{organization-name}/{project-name}/_apis/git/repositories/{repository-name}/items?scopePath={url-encoded-path}&api-version=6.0

Templat disimpan di akun penyimpanan Azure

Format URL untuk templat yang disimpan dalam kontainer publik adalah:

HTML

https://{storage-account-name}.blob.core.windows.net/{container-name}/{template-file-name}

Contohnya:

HTML

https://demostorage0215.blob.core.windows.net/democontainer/azuredeploy.json

Anda dapat mengamankan templat dengan token SAS. Untuk informasi selengkapnya, lihat Cara menyebarkan templat ARM privat dengan token SAS. Url berikut adalah contoh dengan token SAS:

HTML

https://demostorage0215.blob.core.windows.net/privatecontainer/azuredeploy.json?sv=2019-07-07&sr=b&sig=rnI8%2FvKoCHmvmP7XvfspfyzdHjtN4GPsSqB8qMI9FAo%3D&se=2022-02-16T17%3A47%3A46Z&sp=r

Memformat URL

Setelah Anda memiliki URL, Anda perlu mengonversi URL ke nilai yang dikodekan URL. Anda dapat menggunakan penyandi online atau menjalankan perintah. Contoh PowerShell berikut ini menunjukkan cara mengkodekan URL nilai.

PowerShell

$url = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json"
[uri]::EscapeDataString($url)

URL contoh memiliki nilai berikut saat URL dikodekan.

HTML

https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json

Setiap tautan dimulai dengan URL dasar yang sama:

HTML

https://portal.azure.com/#create/Microsoft.Template/uri/

Tambahkan tautan templat berkode URL Anda ke akhir URL dasar.

HTML

https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json

Anda memiliki URL lengkap untuk tautan tersebut.

Buat tombol sebarkan ke Azure

Akhirnya, satukan tautan dan gambar.

Untuk menambahkan tombol dengan Markdown di file README.md di repositori GitHub atau halaman web Anda, gunakan:

markdown

[![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json)

Untuk HTML, gunakan:

HTML

<a href="https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json" target="_blank">
  <img src="https://aka.ms/deploytoazurebutton"/>
</a>

Untuk Git dengan repositori Azure, tombol berada dalam format:

markdown

[![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fdev.azure.com%2Forgname%2Fprojectname%2F_apis%2Fgit%2Frepositories%2Freponame%2Fitems%3FscopePath%3D%2freponame%2fazuredeploy.json%26api-version%3D6.0)

Menyebarkan templat

Untuk menguji solusi lengkap, pilih tombol berikut:

Portal menampilkan panel yang memungkinkan Anda memberikan nilai parameter dengan mudah. Parameter telah diisi sebelumnya dengan nilai default dari template. Nama parameter camel-case, storageAccountType, yang ditentukan dalam templat diubah menjadi string yang dipisahkan spasi ketika ditampilkan di portal.

Langkah berikutnya

• Untuk mempelajari pembuatan templat, lihat Memahami struktur dan sintaks templat ARM.