Menambahkan artefak ke VM DevTest Labs

Artikel ini menjelaskan cara menambahkan artefak ke komputer virtual (VM) Azure DevTest Labs dengan menggunakan portal Microsoft Azure atau Azure PowerShell. Artefak adalah alat, tindakan, atau perangkat lunak yang dapat Anda tambahkan ke VM laboratorium. Misalnya, artefak dapat menjalankan skrip Windows PowerShell atau perintah Bash, menginstal alat atau aplikasi, atau mengambil tindakan lain seperti bergabung dengan domain.

Artefak DevTest Labs dapat berasal dari repositori DevTest Labs Git publik atau dari repositori Git privat. Pengguna lab dapat membuat artefak kustom mereka sendiri dan menyimpannya di repositori, dan menggunakan parameter untuk menyesuaikan artefak yang ada untuk kebutuhan mereka sendiri.

Administrator lab dapat menambahkan repositori artefak ke lab sehingga semua pengguna lab dapat mengaksesnya. Administrator lab juga dapat menentukan artefak wajib yang akan diinstal pada semua VM lab saat pembuatan. Pengguna lab tidak dapat mengubah atau menghapus artefak wajib pada waktu pembuatan VM, tetapi mereka dapat menambahkan dan mengonfigurasi artefak lain yang tersedia pada atau setelah waktu pembuatan VM.

Prasyarat

Azure portal

• Akses pengguna ke lab di DevTest Labs.

Azure PowerShell

• Akses pengguna ke lab di DevTest Labs.
• Azure PowerShell. Anda dapat:
  • Menggunakan Azure Cloud Shell. Pastikan untuk memilih lingkungan PowerShell .
  • Instal Azure PowerShell untuk digunakan pada komputer fisik atau virtual. Jika perlu, jalankan Update-Module -Name Az untuk memperbarui penginstalan Anda.

Menambahkan artefak ke VM

Azure portal

Anda dapat menggunakan portal Microsoft Azure untuk menambahkan artefak selama pembuatan VM atau menambahkan artefak ke VM lab yang ada.

Menambahkan artefak selama pembuatan VM

1. Pada beranda lab, pilih Tambahkan.

2. Pada halaman Pilih basis, pilih jenis VM yang Anda inginkan.

3. Pada layar Buat sumber daya lab , isi tab Pengaturan Dasar sesuai dengan instruksi di Membuat VM lab di Azure DevTest Labs.

4. Di bagian bawah tab Pengaturan Dasar , pilih Tambahkan atau Hapus Artefak.

5. Pada halaman Tambahkan artefak, pilih panah di samping setiap artefak yang ingin Anda tambahkan ke Mesin Virtual.

6. Pada setiap panel Tambahkan artefak, masukkan nilai parameter wajib dan opsional, lalu pilih OK. Artefak muncul di bawah Artefak yang dipilih pada halaman Tambahkan artefak , dan jumlah pembaruan artefak yang dikonfigurasi.

   

7. Secara default, artefak diinstal dalam urutan Anda menambahkannya. Untuk menyusun ulang urutan, pilih elipsis ... di samping artefak di daftar Artefak yang dipilih , dan pilih Pindah ke atas, Pindah ke bawah, Pindahkan ke atas, atau Pindah ke bawah.

   • Untuk mengedit parameter artefak setelah Anda menambahkannya, pilih ikon pensil atau pilih ... di samping artefak dan pilih Edit untuk membuka kembali panel artefak.

   • Untuk menghapus artefak dari daftar Artefak yang dipilih , pilih ... lalu pilih Hapus.

8. Setelah selesai menambahkan, mengatur, dan mengonfigurasi artefak, pilih OK di halaman Tambahkan artefak .

9. Bagian Artefak dari layar Buat sumber daya lab menunjukkan jumlah artefak yang ditambahkan. Untuk menambahkan, mengedit, menyusun ulang, atau menghapus artefak sebelum Anda membuat VM, pilih Tambahkan atau Hapus Artefak lagi.

10. Konfigurasikan secara opsional Pengaturan Tingkat Lanjut atau Tag, lalu pilih Buat dan Buat lagi di bagian bawah layar untuk membuat VM dengan artefak yang ditambahkan.

Setelah Anda membuat VM, artefak yang diinstal muncul di halaman Artefak VM. Untuk melihat detail tentang setiap penginstalan artefak, pilih nama artefak.

Menambahkan artefak ke VM yang ada

1. Dari halaman beranda lab, pilih VM dari daftar Komputer virtual saya .

2. Pada halaman VM, pilih Artefak di bilah menu atas atau di bawah Operasi di navigasi kiri.

3. Pada halaman Artefak , pilih Terapkan artefak.

   

4. Pada halaman Tambahkan artefak , pilih dan konfigurasikan artefak dengan cara yang sama seperti untuk VM baru.

5. Setelah selesai menambahkan artefak, pilih Instal. Artefak langsung diinstal pada VM.

Azure PowerShell

Jika perlu, masuk ke akun Azure Anda dengan menggunakan cmdlet Connect-AzAccount . Jika Anda memiliki beberapa langganan Azure, gunakan Set-AzContext -SubscriptionId "<SubscriptionId>" dan berikan ID langganan yang ingin Anda gunakan.

Jalankan skrip PowerShell berikut untuk menerapkan artefak ke VM dengan menggunakan cmdlet Invoke-AzResourceAction . Berikan informasi yang diminta oleh skrip saat diminta.

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

Konten terkait

• Tentukan artefak wajib
• Membuat artefak kustom
• Menambahkan repositori artefak ke lab
• Diagnosis kegagalan artefak