Hızlı başlangıç: Visual Studio Code ARM şablonları oluşturma
Visual Studio Code için Azure Resource Manager araçları dil desteği, kaynak parçacıkları ve kaynak otomatik tamamlama sağlar. Bu araçlar Azure Resource Manager şablonları (ARM şablonları) oluşturma ve doğrulamaya yardımcı olur. Bu hızlı başlangıçta, uzantıyı sıfırdan bir ARM şablonu oluşturmak için kullanırsınız. Bunu yaparken ARM şablon parçacıkları, doğrulama, tamamlama ve parametre dosyası desteği gibi uzantı özelliklerine sahip olursunuz.
bu hızlı başlangıcı tamamlayabilmeniz için, Azure Resource Manager araçları uzantısı yüklüyken Visual Studio Codegerekir. ayrıca, Azure clı veya Azure PowerShell modülünün yüklü ve kimliği doğrulanmış olması gerekir.
Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
ARM şablonunu oluşturma
azuredeploy. json adlı yeni bir dosya Visual Studio Code oluşturun ve açın. armARM şablonuna yönelik yapı iskelesi için Azure Resource Manager parçacıkları başlatan kod düzenleyicisine girin.
arm!Azure Kaynak grubu dağıtımı için kapsamı belirlenmiş bir şablon oluşturmayı seçin.
Bu kod parçacığı bir ARM şablonu için temel yapı taşlarını oluşturur.
Visual Studio Code dil modunun JSON olarak Azure Resource Manager şablonuna değiştiği hakkında dikkat edin. Uzantı, ARM şablonlarına özgü, ARM şablonuna özgü doğrulama, tamamlama ve diğer dil hizmetleri sağlayan bir dil sunucusu içerir.
Azure kaynağı ekleme
Uzantı birçok Azure kaynağı için kod parçacıkları içerir. Bu kod parçacıkları, şablon dağıtımınıza kolayca kaynak eklemek için kullanılabilir.
İmleci şablon kaynakları bloğuna yerleştirin, yazın storage ve ARM depolama kod parçacığını seçin.
Bu eylem, şablona bir depolama kaynağı ekler.
Sekme tuşu, depolama hesabındaki yapılandırılabilir özellikler arasında sekme almak için kullanılabilir.
Tamamlama ve doğrulama
Uzantının en güçlü özelliklerinden biri, Azure şemalarıyla tümleştirmedir. Azure şemaları, bir uzantıyı doğrulama ve kaynak kullanan tamamlama özellikleri sağlar. Doğrulama ve tamamlama eylemini görmek için depolama hesabını değiştirelim.
İlk olarak, depolama hesabı türünü gibi geçersiz bir değere güncelleştirin megaStorage . Bu eylemin geçerli bir değer olmadığını belirten bir uyarı ürettiğine dikkat edin megaStorage .
Tamamlanma yeteneklerini kullanmak için, megaStorage imleci çift tırnak işareti içine yerleştirin ve tuşuna basın ctrl + space . Bu eylem geçerli değerlerin tamamlanma listesini gösterir.
Şablon parametreleri Ekle
Şimdi depolama hesabı adını belirtmek için bir parametre oluşturun ve kullanın.
İmlecinizi parametreler bloğuna yerleştirin, bir satır başı ekleyin, yazın " ve sonra new-parameter kod parçacığını seçin. Bu eylem, şablona bir genel parametre ekler.
Parametresinin adını storageAccountName ve açıklamasını güncelleştirin Storage Account Name .
Azure depolama hesabı adlarında en az 3 karakter uzunluğunda ve en fazla 24 tane vardır. minLength maxLength Parametresini ve parametresine ekleyin ve uygun değerleri sağlayın.
Şimdi, depolama kaynağında, parametresini kullanmak için Name özelliğini güncelleştirin. Bunu yapmak için geçerli adı kaldırın. Bir çift tırnak ve bir sol köşeli ayraç girerek [ ARM şablon işlevlerinin bir listesini oluşturur. Listeden Parametreler ' i seçin.
'Yuvarlak köşeli ayracın içinde tek bir tırnak işareti girilmesi şablonda tanımlanan tüm parametrelerin bir listesini oluşturur, bu durumda storageAccountName. Parametresini seçin.
Parametre dosyası oluşturma
ARM şablon parametre dosyası, ortama özgü parametre değerlerini depolamanıza ve bu değerleri dağıtım zamanında bir grup olarak geçirmenize olanak sağlar. Örneğin, bir test ortamına özgü değerler içeren bir parametre dosyasına ve bir üretim ortamı için başka bir parametreye sahip olabilirsiniz.
Uzantı, mevcut şablonlarınızla bir parametre dosyası oluşturmayı kolaylaştırır. Bunu yapmak için, kod düzenleyicisinde şablona sağ tıklayın ve öğesini seçin Select/Create Parameter File .
New > All Parameters Parametre dosyası için bir ad ve konum seçin > seçin.
Bu eylem yeni bir parametre dosyası oluşturur ve onu oluşturulduğu şablonla eşler. şablon seçiliyken Visual Studio Code durum çubuğunda geçerli şablon/parametre dosya eşlemesini görebilir ve değiştirebilirsiniz.
Artık parametre dosyası şablonla eşlendiğine göre, uzantı hem şablonu hem de parametre dosyasını birlikte doğrular. Bu doğrulamayı uygulamada görmek için, parametre dosyasındaki parametresine iki karakterli bir değer ekleyin storageAccountName ve dosyayı kaydedin.
ARM şablonuna geri gidin ve değerin parametre ölçütlerini karşılamadığını belirten bir hata yapıldığını unutmayın.
Değeri uygun bir şekilde güncelleştirin, dosyayı kaydedin ve şablona geri gidin. Parametresindeki hatanın çözümlendiğine dikkat edin.
Şablonu dağıtma
anahtar birleşimini kullanarak tümleşik Visual Studio Code terminalini açın ctrl + ` ve şablonu dağıtmak için Azure clı ya da Azure PowerShell modülünü kullanın.
az group create --name arm-vscode --location eastus
az deployment group create --resource-group arm-vscode --template-file azuredeploy.json --parameters azuredeploy.parameters.json
Kaynakları temizleme
azure kaynaklarına artık ihtiyaç duyulmadığında hızlı başlangıç kaynak grubunu silmek için azure clı veya Azure PowerShell modülünü kullanın.
az group delete --name arm-vscode