Uzak şablonları dağıtmak için dağıtım düğmesi kullanma

  • Makale

Bu makalede , GitHub deposundan veya Azure depolama hesabından uzak ARM JSON şablonları dağıtmak için Azure'a Dağıt düğmesinin nasıl kullanılacağı açıklanmaktadır. Düğmeyi doğrudan GitHub deponuzdaki README.md dosyasına ekleyebilirsiniz. Alternatif olarak, depoya başvuran bir web sayfasına düğme ekleyebilirsiniz. Bu yöntem uzak Bicep dosyalarını dağıtmayı desteklemez.

Dağıtım kapsamı şablon şeması tarafından belirlenir. Daha fazla bilgi için bkz.

Gerekli izinler

Bicep dosyasını veya ARM şablonunu dağıtmak için dağıttığınız kaynaklara yazma erişimine ve Microsoft.Resources/deployments kaynak türündeki tüm işlemler için erişime sahip olmanız gerekir. Örneğin, bir sanal makine dağıtmak için ve Microsoft.Resources/deployments/* izinlerine ihtiyacınız vardırMicrosoft.Compute/virtualMachines/write. What-if işlemi aynı izin gereksinimlerine sahiptir.

Rol ve izinlerin listesi için bkz. Azure yerleşik rolleri.

Ortak görüntüyü kullanma

Düğmeyi web sayfanıza veya deponuza eklemek için aşağıdaki görüntüyü kullanın:

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

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

Resim şu şekilde görünür:

Azure'a Dağıt düğmesinin ekran görüntüsü.

Şablonu dağıtmak için URL oluşturma

Bu bölümde GitHub ve Azure depolama hesabında depolanan şablonların URL'lerini alma ve URL'leri biçimlendirme adımları gösterilmektedir.

GitHub'da depolanan şablon

Şablonunuzun URL'sini oluşturmak için GitHub deponuzda şablonun ham URL'siyle başlayın. Ham URL'yi görmek için Ham'ı seçin.

GitHub'da Ham'ı seçmeyi gösteren ekran görüntüsü.

URL'nin biçimi:

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

Not

Özel GitHub deposunda depolanan bir şablonu dağıtmak veya bağlantılı bir şablona başvurmak için Özel ve Güvenli Azure Portal Teklifi Oluşturma bölümünde belgelenen özel bir çözüme bakın. GitHub belirtecini Azure Key Vault'den çeken bir Azure işlevi oluşturabilirsiniz.

GitHub deposu yerine Azure Repos ile Git kullanıyorsanız Azure'a Dağıt düğmesini kullanmaya devam edebilirsiniz. Deponuzun genel olduğundan emin olun. Şablonu almak için Items işlemini kullanın. İsteğiniz aşağıdaki biçimde olmalıdır:

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

Azure depolama hesabında depolanan şablon

Genel kapsayıcıda depolanan şablonların URL'lerinin biçimi:

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

Örnek:

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

SAS belirteci ile şablonun güvenliğini sağlayabilirsiniz. Daha fazla bilgi için bkz. SAS belirteci ile özel ARM şablonu dağıtma. Sas belirteciyle ilgili bir örnek aşağıdaki URL'dir:

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

URL'yi biçimlendirme

URL'yi aldıktan sonra URL'yi URL ile kodlanmış bir değere dönüştürmeniz gerekir. Çevrimiçi kodlayıcı kullanabilir veya komut çalıştırabilirsiniz. Aşağıdaki PowerShell örneği, URL'nin bir değeri kodlamasını gösterir.

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

Url kodlandığında örnek URL aşağıdaki değere sahiptir.

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

Her bağlantı aynı temel URL ile başlar:

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

URL ile kodlanmış şablon bağlantınızı temel URL'nin sonuna ekleyin.

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

Bağlantı için tam URL'niz var.

Azure'a Dağıt düğmesi oluştur

Son olarak, bağlantıyı ve görüntüyü bir araya getirin.

GitHub deponuzdaki veya web sayfanızdaki README.md dosyasında Markdown bulunan düğmeyi eklemek için şunu kullanın:

[![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)

HTML için şunu kullanın:

<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>

Azure deposu ile Git'te düğme şu biçimdedir:

[![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)

Şablonu dağıtma

Çözümün tamamını test etmek için aşağıdaki düğmeyi seçin:

Bağlantı içeren Azure'a Dağıt düğmesinin ekran görüntüsü.

Portalda parametre değerlerini kolayca sağlamanıza olanak tanıyan bir bölme görüntülenir. Parametreler şablondaki varsayılan değerlerle önceden doldurulur. Şablonda tanımlanan camel cased parametre adı storageAccountType, portalda görüntülendiğinde boşlukla ayrılmış bir dizeye dönüştürülür.

Parametre değerleri sağlamak için bölmeyi görüntüleyen Azure portal ekran görüntüsü.

Sonraki adımlar