DevTest Labs VM'lerine yapıt ekleme

Bu makalede, Azure portalı veya Azure PowerShell kullanılarak Azure DevTest Labs sanal makinelerine (VM) yapıtların nasıl ekleneceği açıklanmaktadır. Artefaktlar, laboratuvar sanal makinelerine ekleyebileceğiniz araçlar, eylemler veya yazılımlardır. Örneğin yapıtlar Windows PowerShell betiklerini veya Bash komutlarını çalıştırabilir, araçları veya uygulamaları yükleyebilir veya etki alanına katılma gibi başka eylemler gerçekleştirebilir.

DevTest Labs yapıtları genel DevTest Labs Git deposundan veya özel Git depolarından gelebilir. Laboratuvar kullanıcıları kendi özel yapıtlarını oluşturabilir ve bunları bir depoda depolayabilir ve mevcut yapıtları kendi ihtiyaçlarına göre özelleştirmek için parametreleri kullanabilir.

Laboratuvar yöneticisi, tüm laboratuvar kullanıcılarının bunlara erişebilmesi için bir laboratuvara yapıt depoları ekleyebilir . Laboratuvar yöneticileri, oluşturma sırasında tüm laboratuvar VM'lerine yüklenecek zorunlu yapıtları da belirtebilir . Laboratuvar kullanıcıları VM oluşturma zamanında zorunlu yapıtları değiştiremez veya kaldıramaz, ancak VM oluşturma zamanında veya sonrasında diğer kullanılabilir yapıtları ekleyip yapılandırabilir.

Önkoşullar

Azure portalı

• DevTest Labs'deki bir laboratuvara kullanıcı erişimi.

Azure PowerShell

• DevTest Labs'deki bir laboratuvara kullanıcı erişimi.
• Azure PowerShell. Aşağıdakilerden birini yapabilirsiniz:
  • Azure Cloud Shell’i kullanma. PowerShell ortamını seçtiğinizden emin olun.
  • Fiziksel veya sanal makinede kullanmak için Azure PowerShell'i yükleyin. Gerekirse, yüklemenizi güncelleştirmek için komutunu çalıştırın Update-Module -Name Az .

VM'lere yapıt ekleme

Azure portalı

Vm oluşturma sırasında yapıt eklemek veya mevcut bir laboratuvar VM'sine yapıt eklemek için Azure portalını kullanabilirsiniz.

VM oluşturma sırasında varlık ekleme

1. Laboratuvarın giriş sayfasında Ekle'yi seçin.

2. Temel seçin sayfasında, istediğiniz VM türünü seçin.

3. Laboratuvar kaynağı oluştur ekranında, Azure DevTest Labs'de laboratuvar VM'leri oluşturma başlığı altındaki yönergelere göre Temel Ayarlar sekmesini doldurun.

4. Temel Ayarlar sekmesinin en altında Yapıt Ekle veya Kaldır'ı seçin.

5. Eserleri ekle sayfasında, VM'ye eklemek istediğiniz herhangi bir eserin yanındaki oku seçin.

6. Her Yapıt ekle bölmesinde gerekli ve isteğe bağlı parametre değerlerini girin ve tamam'ı seçin. Yapıt, Yapıt ekle sayfasındaki Seçili yapıtlar'ın altında ve yapılandırılmış yapıt güncelleştirmelerinin sayısı altında görünür.

   

7. Varsayılan olarak, yapıtlar bunları eklediğiniz sırayla yüklenir. Sırayı yeniden düzenlemek için Seçili yapıtlar listesindeki yapıtın yanındaki üç nokta simgesini ... seçip, ardından Yukarı taşı, Aşağı taşı, Üste taşı veya En alta taşı seçeneklerinden birini seçin.

   • Bir yapıtın parametrelerini ekledikten sonra düzenlemek için kalem simgesini seçin veya yapıtın yanındaki ... öğesini seçin ve yapıt bölmesini yeniden açmak için Düzenle'yi seçin.

   • Seçili yapıtlar listesinden bir yapıtı silmek için ... öğesini ve ardından Sil'i seçin.

8. Yapıtları eklemeyi, düzenlemeyi ve yapılandırmayı bitirdiğinizde Yapıt ekle sayfasında Tamam'ı seçin.

9. Laboratuvar kaynağı oluştur ekranının Yapıtlar bölümünde eklenen yapıtların sayısı gösterilir. VM'yi oluşturmadan önce yapıtları eklemek, düzenlemek, yeniden düzenlemek veya silmek için Yapıt Ekle veya Kaldır'ı yeniden seçin.

10. İsteğe bağlı olarak tüm Gelişmiş Ayarları veya Etiketleri yapılandırın ve ardından ek yapıtlarla VM oluşturmak için ekranın alt kısmındaki Oluştur ve Oluştur'u yeniden seçin.

VM'yi oluşturduktan sonra, yüklü yapıtlar VM'nin Yapıtlar sayfasında görünür. Her yapıtın yüklemesinin ayrıntılarını görmek için yapıt adını seçin.

Var olan bir VM'ye yapıt ekleme

1. Laboratuvarın giriş sayfasında Sanal makinelerim listesinden VM'yi seçin.

2. VM sayfasında, üst menü çubuğunda veya sol gezinti bölmesindeki İşlemler'in altında Yapıtlar'ı seçin.

3. Yapıtlar sayfasında Yapıtları uygula'yı seçin.

   

4. Yapıt ekle sayfasında yapıtları yeni bir VM'de olduğu gibi seçin ve yapılandırın.

5. Yapıt eklemeyi bitirdiğinizde Yükle'yi seçin. Öğeler VM'ye hemen yüklenir ve kurulur.

Azure PowerShell

Gerekirse Connect-AzAccount cmdlet'ini kullanarak Azure hesabınızda oturum açın. Birden çok Azure aboneliğiniz varsa kullanmak istediğiniz abonelik kimliğini kullanın Set-AzContext -SubscriptionId "<SubscriptionId>" ve belirtin.

Invoke-AzResourceAction cmdlet'ini kullanarak vm'ye yapıt uygulamak için aşağıdaki PowerShell betiğini çalıştırın. Betik sizden bilgi istediğinde gerekli bilgileri sağlayın.

param (
[Parameter(Mandatory=$true, HelpMessage="The ID of the subscription that contains the lab")]
   [string] $SubscriptionId,
[Parameter(Mandatory=$true, HelpMessage="The name of the lab that has the VM")]
   [string] $DevTestLabName,
[Parameter(Mandatory=$true, HelpMessage="The name of the VM")]
   [string] $VirtualMachineName,
[Parameter(Mandatory=$true, HelpMessage="The repository where the artifact is stored")]
   [string] $RepositoryName,
[Parameter(Mandatory=$true, HelpMessage="The artifact to apply to the VM")]
   [string] $ArtifactName,
[Parameter(ValueFromRemainingArguments=$true)]
   $Params
)

# Set the appropriate subscription
Set-AzContext -SubscriptionId $SubscriptionId | Out-Null
 
# Get the lab resource group name
$resourceGroupName = (Get-AzResource -ResourceType 'Microsoft.DevTestLab/labs' | Where-Object { $_.Name -eq $DevTestLabName}).ResourceGroupName
if ($resourceGroupName -eq $null) { throw "Unable to find lab $DevTestLabName in subscription $SubscriptionId." }

# Get the internal repository name
$repository = Get-AzResource -ResourceGroupName $resourceGroupName `
                    -ResourceType 'Microsoft.DevTestLab/labs/artifactsources' `
                    -ResourceName $DevTestLabName `
                    -ApiVersion 2016-05-15 `
                    | Where-Object { $RepositoryName -in ($_.Name, $_.Properties.displayName) } `
                    | Select-Object -First 1

if ($repository -eq $null) { "Unable to find repository $RepositoryName in lab $DevTestLabName." }

# Get the internal artifact name
$template = Get-AzResource -ResourceGroupName $resourceGroupName `
                -ResourceType "Microsoft.DevTestLab/labs/artifactSources/artifacts" `
                -ResourceName "$DevTestLabName/$($repository.Name)" `
                -ApiVersion 2016-05-15 `
                | Where-Object { $ArtifactName -in ($_.Name, $_.Properties.title) } `
                | Select-Object -First 1

if ($template -eq $null) { throw "Unable to find template $ArtifactName in lab $DevTestLabName." }

# Find the VM in Azure
$FullVMId = "/subscriptions/$SubscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DevTestLab/labs/$DevTestLabName/virtualmachines/$virtualMachineName"

$virtualMachine = Get-AzResource -ResourceId $FullVMId

# Generate the artifact id
$FullArtifactId = "/subscriptions/$SubscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DevTestLab/labs/$DevTestLabName/artifactSources/$($repository.Name)/artifacts/$($template.Name)"

# Handle the input parameters to pass through
$artifactParameters = @()

# Fill the artifact parameter with the additional -param_ data and strip off the -param_
$Params | ForEach-Object {
   if ($_ -match '^-param_(.*)') {
      $name = $_ -replace '^-param_'
   } elseif ( $name ) {
      $artifactParameters += @{ "name" = "$name"; "value" = "$_" }
      $name = $null #reset name variable
   }
}

# Create a structure to pass the artifact data to the action

$prop = @{
artifacts = @(
    @{
        artifactId = $FullArtifactId
        parameters = $artifactParameters
    }
    )
}

# Apply the artifact
if ($virtualMachine -ne $null) {
   # Apply the artifact by name to the virtual machine
   $status = Invoke-AzResourceAction -Parameters $prop -ResourceId $virtualMachine.ResourceId -Action "applyArtifacts" -ApiVersion 2016-05-15 -Force
   if ($status.Status -eq 'Succeeded') {
      Write-Output "##[section] Successfully applied artifact: $ArtifactName to $VirtualMachineName"
   } else {
      Write-Error "##[error]Failed to apply artifact: $ArtifactName to $VirtualMachineName"
   }
} else {
   Write-Error "##[error]$VirtualMachine was not found in the DevTest Lab, unable to apply the artifact"
}

İlgili içerik

• Zorunlu belgeleri belirt
• Özel yapıtlar oluşturma
• Laboratuvara yapıt deposu ekleme
• Yapıt hatalarını tanılama