Přidat artefakty do VM DevTest Labs

Tento článek popisuje, jak přidat artefakty do virtuálních počítačů Azure DevTest Labs pomocí webu Azure Portal nebo Azure PowerShellu. Artefakty jsou nástroje, akce nebo software, které můžete přidat do testovacích virtuálních počítačů. Artefakty můžou například spouštět skripty Windows PowerShellu nebo příkazy Bash, instalovat nástroje nebo aplikace nebo provádět jiné akce, jako je připojení k doméně.

Artefakty DevTest Labs můžou pocházet z veřejného úložiště DevTest Labs Git nebo z privátních úložišť Git. Uživatelé testovacího prostředí můžou vytvářet vlastní artefakty a ukládat je do úložiště a používat parametry k přizpůsobení existujících artefaktů pro vlastní potřeby.

Správce testovacího prostředí může do testovacího prostředí přidat úložiště artefaktů , aby k nim všichni uživatelé testovacího prostředí mohli přistupovat. Správci testovacího prostředí můžou také určit povinné artefakty, které se mají nainstalovat na všechny virtuální počítače testovacího prostředí při vytváření. Uživatelé testovacího prostředí nemůžou měnit ani odebírat povinné artefakty v době vytváření virtuálního počítače, ale můžou přidávat a konfigurovat další dostupné artefakty v době vytvoření nebo po vytvoření virtuálního počítače.

Požadavky

Azure Portal

• Přístup uživatele k testovacímu prostředí v DevTest Labs

Azure PowerShell

• Přístup uživatele k testovacímu prostředí v DevTest Labs
• Azure PowerShell: Můžete provést jednu z těchto akcí:
  • Použijte Azure Cloud Shell. Nezapomeňte vybrat prostředí PowerShellu .
  • Nainstalujte Azure PowerShell pro použití na fyzickém nebo virtuálním počítači. V případě potřeby spusťte Update-Module -Name Az aktualizaci instalace.

Přidání artefaktů do virtuálních počítačů

Azure Portal

Pomocí webu Azure Portal můžete přidat artefakty během vytváření virtuálního počítače nebo přidat artefakty do existujícího testovacího virtuálního počítače.

Přidání artefaktů během vytváření virtuálního počítače

1. Na domovské stránce testovacího prostředí vyberte Přidat.

2. Na stránce Zvolit základní stránku vyberte požadovaný typ virtuálního počítače.

3. Na obrazovce Vytvořit prostředek testovacího prostředí vyplňte kartu Základní nastavení podle pokynů v tématu Vytvoření virtuálních počítačů testovacího prostředí v Azure DevTest Labs.

4. V dolní části karty Základní nastavení vyberte Přidat nebo odebrat artefakty.

5. Na stránce Přidat artefakty vyberte šipku vedle každého artefaktu, který chcete přidat do virtuálního počítače.

6. V každém podokně Přidat artefakt zadejte požadované a volitelné hodnoty parametrů a pak vyberte OK. Artefakt se zobrazí v části Vybrané artefakty na stránce Přidat artefakty a počet aktualizací nakonfigurovaných artefaktů.

   

7. Ve výchozím nastavení se artefakty instalují v pořadí, v jakém je přidáte. Chcete-li změnit pořadí, vyberte tři tečky ... vedle artefaktu v seznamu Vybrané artefakty a vyberte Přesunout nahoru, Přesunout dolů, Přesunout na začátek nebo Přesunout na konec.

   • Pokud chcete po přidání upravit parametry artefaktu, vyberte ikonu tužky nebo vyberte ... vedle artefaktu a výběrem možnosti Upravit znovu otevřete podokno artefaktů.

   • Pokud chcete odstranit artefakt ze seznamu Vybrané artefakty , vyberte ... a pak vyberte Odstranit.

8. Až budete hotovi s přidáváním, uspořádáním a konfigurací artefaktů, vyberte na stránce Přidat artefaktyOK.

9. V části Artefakty na obrazovce Vytvořit prostředek testovacího prostředí se zobrazuje počet přidaných artefaktů. Pokud chcete přidat, upravit, změnit uspořádání nebo odstranit artefakty před vytvořením virtuálního počítače, znovu vyberte Přidat nebo odebrat artefakty .

10. Volitelně můžete nakonfigurovat všechna rozšířená nastavení nebo značky, a poté vyberte Vytvořit a dole na obrazovce znovu vyberte Vytvořit pro vytvoření virtuálního počítače s přidanými artefakty.

Po vytvoření virtuálního počítače se nainstalované artefakty zobrazí na stránce Artefakty virtuálního počítače. Pokud chcete zobrazit podrobnosti o instalaci jednotlivých artefaktů, vyberte název artefaktu.

Přidání artefaktů do existujícího virtuálního počítače

1. Na domovské stránce testovacího prostředí vyberte virtuální počítač ze seznamu Moje virtuální počítače .

2. Na stránce virtuálního počítače vyberte Artefakty v horním řádku nabídek nebo v části Operace v levém navigačním panelu.

3. Na stránce Artefakty vyberte Použít artefakty.

   

4. Na stránce Přidat artefakty vyberte a nakonfigurujte artefakty stejným způsobem jako u nového virtuálního počítače.

5. Až budete hotovi s přidáváním artefaktů, vyberte Nainstalovat. Artefakty se na virtuální počítač nainstalují okamžitě.

Azure PowerShell

V případě potřeby se přihlaste ke svému účtu Azure pomocí rutiny Connect-AzAccount . Pokud máte více předplatných Azure, použijte Set-AzContext -SubscriptionId "<SubscriptionId>" a zadejte ID předplatného, které chcete použít.

K použití artefaktu na virtuální počítač spusťte následující skript PowerShell pomocí rutiny Invoke-AzResourceAction. Zadejte informace, ke které skript volá při zobrazení výzvy.

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

Související obsah

• Určení povinných artefaktů
• Vytváření vlastních artefaktů
• Přidání úložiště artefaktů do testovacího prostředí
• Diagnostika selhání artefaktů