Bicep dosyalarında dağıtım betikleri için geliştirme ortamını yapılandırma
Dağıtım betiği görüntüsüyle dağıtım betikleri geliştirmek ve test etmek için bir geliştirme ortamı oluşturmayı öğrenin. Azure kapsayıcı örneği oluşturabilir veya Docker kullanabilirsiniz. Her iki seçenek de bu makalede ele alınmıştır.
Önkoşullar
Azure PowerShell kapsayıcısı
Azure PowerShell dağıtım betiğiniz yoksa, aşağıdaki içeriği kullanarak bir hello.ps1 dosyası oluşturabilirsiniz:
param([string] $name)
$output = 'Hello {0}' -f $name
Write-Output $output
$DeploymentScriptOutputs = @{}
$DeploymentScriptOutputs['text'] = $output
param([string] $name, [string] $subscription)
$output = 'Hello {0}' -f $name
#Write-Output $output
Connect-AzAccount -UseDeviceAuthentication
Set-AzContext -subscription $subscription
$kv = Get-AzKeyVault
#Write-Output $kv
$DeploymentScriptOutputs = @{}
$DeploymentScriptOutputs['greeting'] = $output
$DeploymentScriptOutputs['kv'] = $kv.resourceId
Write-Output $DeploymentScriptOutputs
Azure PowerShell dağıtım betiğinde $DeploymentScriptOutputs , değişken çıkış değerlerini depolamak için kullanılır. Azure PowerShell çıkışlarıyla çalışma hakkında daha fazla bilgi için bkz . Çıkışlarla çalışma.
Azure CLI kapsayıcısı
Azure CLI kapsayıcı görüntüsü için aşağıdaki içeriği kullanarak bir hello.sh dosyası oluşturabilirsiniz:
FIRSTNAME=$1
LASTNAME=$2
OUTPUT="{\"name\":{\"displayName\":\"$FIRSTNAME $LASTNAME\",\"firstName\":\"$FIRSTNAME\",\"lastName\":\"$LASTNAME\"}}"
echo -n "Hello "
echo $OUTPUT | jq -r '.name.displayName'
Azure CLI dağıtım betiğinde, adlı AZ_SCRIPTS_OUTPUT_PATH bir ortam değişkeni betik çıktı dosyasının konumunu depolar. Ortam değişkeni geliştirme ortamı kapsayıcısında kullanılamaz. Azure CLI çıkışlarıyla çalışma hakkında daha fazla bilgi için bkz . CLI betiklerinden gelen çıkışlarla çalışma.
Azure PowerShell kapsayıcı örneğini kullanma
Bilgisayarınızda Azure PowerShell betikleri yazmak için bir depolama hesabı oluşturmanız ve depolama hesabını kapsayıcı örneğine bağlamanız gerekir. Böylece betiğinizi depolama hesabına yükleyebilir ve kapsayıcı örneğinde çalıştırabilirsiniz. Betiğinizi test etmek için oluşturduğunuz depolama hesabı, dağıtım betiği hizmetinin betiği yürütmek için kullandığı depolama hesabıyla aynı değildir. Dağıtım betiği hizmeti, her yürütmede dosya paylaşımı olarak benzersiz bir ad oluşturur.
Azure PowerShell kapsayıcı örneği oluşturma
Aşağıdaki Bicep dosyası bir kapsayıcı örneği ve dosya paylaşımı oluşturur ve ardından dosya paylaşımını kapsayıcı görüntüsüne bağlar.
@description('Specify a project name that is used for generating resource names.')
param projectName string
@description('Specify the resource location.')
param location string = resourceGroup().location
@description('Specify the container image.')
param containerImage string = 'mcr.microsoft.com/azuredeploymentscripts-powershell:az9.7'
@description('Specify the mount path.')
param mountPath string = '/mnt/azscripts/azscriptinput'
var storageAccountName = toLower('${projectName}store')
var fileShareName = '${projectName}share'
var containerGroupName = '${projectName}cg'
var containerName = '${projectName}container'
resource storageAccount 'Microsoft.Storage/storageAccounts@2023-01-01' = {
name: storageAccountName
location: location
sku: {
name: 'Standard_LRS'
}
kind: 'StorageV2'
properties: {
accessTier: 'Hot'
}
}
resource fileShare 'Microsoft.Storage/storageAccounts/fileServices/shares@2023-01-01' = {
name: '${storageAccountName}/default/${fileShareName}'
dependsOn: [
storageAccount
]
}
resource containerGroup 'Microsoft.ContainerInstance/containerGroups@2023-05-01' = {
name: containerGroupName
location: location
properties: {
containers: [
{
name: containerName
properties: {
image: containerImage
resources: {
requests: {
cpu: 1
memoryInGB: json('1.5')
}
}
ports: [
{
protocol: 'TCP'
port: 80
}
]
volumeMounts: [
{
name: 'filesharevolume'
mountPath: mountPath
}
]
command: [
'/bin/sh'
'-c'
'pwsh -c \'Start-Sleep -Seconds 1800\''
]
}
}
]
osType: 'Linux'
volumes: [
{
name: 'filesharevolume'
azureFile: {
readOnly: false
shareName: fileShareName
storageAccountName: storageAccountName
storageAccountKey: storageAccount.listKeys().keys[0].value
}
}
]
}
}
Bağlama yolunun varsayılan değeridir /mnt/azscripts/azscriptinput. Bu, kapsayıcı örneğinde dosya paylaşımına bağlandığı yoldur.
Bicep dosyasında belirtilen varsayılan kapsayıcı görüntüsü mcr.microsoft.com/azuredeploymentscripts-powershell:az9.7. Desteklenen tüm Azure PowerShell sürümlerinin listesine bakın.
Bicep dosyası 1.800 saniye sonra kapsayıcı örneğini askıya alır. Kapsayıcı örneğinin sonlandırılan duruma geçmesi ve oturumun sona ermesi için 30 dakikanız vardır.
Bicep dosyasını dağıtmak için aşağıdaki betiği kullanın:
$projectName = Read-Host -Prompt "Enter a project name that is used to generate resource names"
$location = Read-Host -Prompt "Enter the location (i.e. centralus)"
$templateFile = Read-Host -Prompt "Enter the Bicep file path and file name"
$resourceGroupName = "${projectName}rg"
New-AzResourceGroup -Location $location -name $resourceGroupName
New-AzResourceGroupDeployment -resourceGroupName $resourceGroupName -TemplateFile $templatefile -projectName $projectName
Dağıtım betiğini karşıya yükleme
Dağıtım betiğinizi depolama hesabına yükleyin. PowerShell betiği örneği aşağıda verilmiştir:
$projectName = Read-Host -Prompt "Enter the same project name that you used earlier"
$fileName = Read-Host -Prompt "Enter the deployment script file name with the path"
$resourceGroupName = "${projectName}rg"
$storageAccountName = "${projectName}store"
$fileShareName = "${projectName}share"
$context = (Get-AzStorageAccount -ResourceGroupName $resourceGroupName -Name $storageAccountName).Context
Set-AzStorageFileContent -Context $context -ShareName $fileShareName -Source $fileName -Force
Azure portalını veya Azure CLI'yi kullanarak da dosyayı karşıya yükleyebilirsiniz.
Dağıtım betiğini test edin
Azure portalında kapsayıcı örneğini ve depolama hesabını dağıttığınız kaynak grubunu açın.
Kapsayıcı grubunu açın. Varsayılan kapsayıcı grubu adı, cg ile eklenen proje adıdır. Kapsayıcı örneği Çalışıyor durumundadır.
Kaynak menüsünde Kapsayıcılar'ı seçin. Kapsayıcı örneği adı, kapsayıcıyla birlikte eklenen proje adıdır.
Bağlan'ı ve ardından Bağlan'ı seçin. Kapsayıcı örneğine bağlanamıyorsanız kapsayıcı grubunu yeniden başlatın ve yeniden deneyin.
Konsol bölmesinde aşağıdaki komutları çalıştırın:
cd /mnt/azscripts/azscriptinput ls pwsh ./hello.ps1 "John Dole"Çıkış Hello John Dole'dır.
Azure CLI kapsayıcı örneği kullanma
Bilgisayarınızda Azure CLI betikleri yazmak için bir depolama hesabı oluşturun ve depolama hesabını kapsayıcı örneğine bağlayın. Ardından betiğinizi depolama hesabına yükleyebilir ve betiği kapsayıcı örneğinde çalıştırabilirsiniz. Betiğinizi test etmek için oluşturduğunuz depolama hesabı, dağıtım betiği hizmetinin betiği yürütmek için kullandığı depolama hesabıyla aynı değildir. Dağıtım betiği hizmeti, her yürütmede dosya paylaşımı olarak benzersiz bir ad oluşturur.
Azure CLI kapsayıcı örneği oluşturma
Aşağıdaki Bicep dosyası bir kapsayıcı örneği ve dosya paylaşımı oluşturur ve ardından dosya paylaşımını kapsayıcı görüntüsüne bağlar:
@description('Specify a project name that is used for generating resource names.')
param projectName string
@description('Specify the resource location.')
param location string = resourceGroup().location
@description('Specify the container image.')
param containerImage string = 'mcr.microsoft.com/azure-cli:2.9.1'
@description('Specify the mount path.')
param mountPath string = '/mnt/azscripts/azscriptinput'
var storageAccountName = toLower('${projectName}store')
var fileShareName = '${projectName}share'
var containerGroupName = '${projectName}cg'
var containerName = '${projectName}container'
resource storageAccount 'Microsoft.Storage/storageAccounts@2023-04-01' = {
name: storageAccountName
location: location
sku: {
name: 'Standard_LRS'
}
kind: 'StorageV2'
properties: {
accessTier: 'Hot'
}
}
resource fileshare 'Microsoft.Storage/storageAccounts/fileServices/shares@2023-04-01' = {
name: '${storageAccountName}/default/${fileShareName}'
dependsOn: [
storageAccount
]
}
resource containerGroup 'Microsoft.ContainerInstance/containerGroups@2023-05-01' = {
name: containerGroupName
location: location
properties: {
containers: [
{
name: containerName
properties: {
image: containerImage
resources: {
requests: {
cpu: 1
memoryInGB: json('1.5')
}
}
ports: [
{
protocol: 'TCP'
port: 80
}
]
volumeMounts: [
{
name: 'filesharevolume'
mountPath: mountPath
}
]
command: [
'/bin/bash'
'-c'
'echo hello; sleep 1800'
]
}
}
]
osType: 'Linux'
volumes: [
{
name: 'filesharevolume'
azureFile: {
readOnly: false
shareName: fileShareName
storageAccountName: storageAccountName
storageAccountKey: storageAccount.listKeys().keys[0].value
}
}
]
}
}
Bağlama yolunun varsayılan değeridir /mnt/azscripts/azscriptinput. Bu, kapsayıcı örneğinde dosya paylaşımına bağlandığı yoldur.
Bicep dosyasında belirtilen varsayılan kapsayıcı görüntüsü mcr.microsoft.com/azure-cli:2.9.1. Desteklenen Azure CLI sürümlerinin listesine bakın. Dağıtım betiği, Microsoft Container Registry'den (MCR) kullanılabilir CLI görüntülerini kullanır. Bir dağıtım betiği için CLI görüntüsünün onaylanması yaklaşık bir ay sürer. 30 gün içinde yayımlanan CLI sürümlerini kullanmayın. Görüntülerin yayın tarihlerini bulmak için bkz . Azure CLI sürüm notları. Desteklenmeyen bir sürüm kullanıyorsanız, hata iletisi desteklenen sürümleri listeler.
Bicep dosyası 1.800 saniye sonra kapsayıcı örneğini askıya alır. Kapsayıcı örneğinin terminal durumuna geçmesi ve oturumun bitmesi için 30 dakikanız vardır.
Bicep dosyasını dağıtmak için:
$projectName = Read-Host -Prompt "Enter a project name that is used to generate resource names"
$location = Read-Host -Prompt "Enter the location (i.e. centralus)"
$templateFile = Read-Host -Prompt "Enter the Bicep file path and file name"
$resourceGroupName = "${projectName}rg"
New-AzResourceGroup -Location $location -name $resourceGroupName
New-AzResourceGroupDeployment -resourceGroupName $resourceGroupName -TemplateFile $templatefile -projectName $projectName
Dağıtım betiğini karşıya yükleme
Dağıtım betiğinizi depolama hesabına yükleyin. Aşağıda bir PowerShell örneği verilmiştir:
$projectName = Read-Host -Prompt "Enter the same project name that you used earlier"
$fileName = Read-Host -Prompt "Enter the deployment script file name with the path"
$resourceGroupName = "${projectName}rg"
$storageAccountName = "${projectName}store"
$fileShareName = "${projectName}share"
$context = (Get-AzStorageAccount -ResourceGroupName $resourceGroupName -Name $storageAccountName).Context
Set-AzStorageFileContent -Context $context -ShareName $fileShareName -Source $fileName -Force
Azure portalını veya Azure CLI'yi kullanarak da dosyayı karşıya yükleyebilirsiniz.
Dağıtım betiğini test edin
Azure portalında kapsayıcı örneğini ve depolama hesabını dağıttığınız kaynak grubunu açın.
Kapsayıcı grubunu açın. Varsayılan kapsayıcı grubu adı, cg ile eklenen proje adıdır. Kapsayıcı örneği Çalışıyor durumunda gösterilir.
Kaynak menüsünde Kapsayıcılar'ı seçin. Kapsayıcı örneği adı, kapsayıcıyla birlikte eklenen proje adıdır.
Bağlan'ı ve ardından Bağlan'ı seçin. Kapsayıcı örneğine bağlanamıyorsanız kapsayıcı grubunu yeniden başlatın ve yeniden deneyin.
Konsol bölmesinde aşağıdaki komutları çalıştırın:
cd /mnt/azscripts/azscriptinput ls ./hello.sh John DoleÇıkış Hello John Dole'dır.
Docker kullanma
Dağıtım betiği geliştirme ortamınız olarak önceden yapılandırılmış bir Docker kapsayıcı görüntüsü kullanabilirsiniz. Docker'ı yüklemek için bkz . Docker'ı alma. Ayrıca, docker kapsayıcısına dağıtım betiklerini içeren dizini bağlamak için dosya paylaşımını yapılandırmanız gerekir.
Dağıtım betiği kapsayıcı görüntüsünü yerel bilgisayara çekin:
docker pull mcr.microsoft.com/azuredeploymentscripts-powershell:az10.0Örnek PowerShell 4.3.0 sürümünü kullanır.
BIR MCR'den CLI görüntüsü çekmek için:
docker pull mcr.microsoft.com/azure-cli:2.52.0Bu örnekte CLI 2.52.0 sürümü kullanılmaktadır. Dağıtım betiği varsayılan CLI kapsayıcısı görüntülerini kullanır.
Docker görüntüsünü yerel olarak çalıştırın.
docker run -v <host drive letter>:/<host directory name>:/data -it mcr.microsoft.com/azuredeploymentscripts-powershell:az10.0Konak sürücü harfini> ve <ana bilgisayar dizini adını> paylaşılan sürücüde var olan bir klasörle değiştirin.< Klasörü kapsayıcıdaki /data klasörüne eşler. Örneğin, D:\docker'ı eşlemek için:
docker run -v d:/docker:/data -it mcr.microsoft.com/azuredeploymentscripts-powershell:az10.0-bu, kapsayıcı görüntüsünü canlı tutmak anlamına gelir.
CLI örneği:
docker run -v d:/docker:/data -it mcr.microsoft.com/azure-cli:2.52.0Aşağıdaki ekran görüntüsünde, paylaşılan sürücüde helloworld.ps1 dosyanız olduğu göz önünde bulundurulduğunda PowerShell betiğinin nasıl çalıştırıldığını gösterilmektedir.
Betik başarıyla test edildikten sonra, Bunu Bicep dosyalarınızda dağıtım betiği olarak kullanabilirsiniz.
Sonraki adımlar
Bu makalede betik geliştirme ortamları oluşturmayı öğrendiniz. Daha fazlasını öğrenin:
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin