Hinzufügen von Artefakten zu VMs von DevTest Labs

In diesem Artikel wird beschrieben, wie Sie Mithilfe des Azure-Portals oder Azure PowerShell Artefakte zu virtuellen Azure DevTest Labs-Computern (VMs) hinzufügen. Artefakte sind Tools, Aktionen oder Software, die Sie virtuellen Labcomputern hinzufügen können. Beispielsweise können Artefakte Windows PowerShell-Skripts oder Bash-Befehle ausführen, Tools oder Anwendungen installieren oder andere Aktionen wie das Beitreten zu einer Domäne ausführen.

DevTest Labs Artefakte können aus dem öffentlichen DevTest Labs Git-Repository oder aus privaten Git-Repositorys stammen. Lab-Benutzer können eigene benutzerdefinierte Artefakte erstellen und in einem Repository speichern und Parameter verwenden, um vorhandene Artefakte für ihre eigenen Anforderungen anzupassen.

Ein Lab-Administrator kann Artefakt-Repositories zu einem Lab hinzufügen, sodass alle Lab-Benutzer darauf zugreifen können. Lab-Administratoren können auch obligatorische Artefakte angeben, die bei der Erstellung auf allen Lab-VMs installiert werden sollen. Lab-Benutzer können obligatorische Artefakte zur Erstellungszeit der VM nicht ändern oder entfernen, aber sie können andere verfügbare Artefakte zu oder nach der Erstellungszeit des virtuellen Computers hinzufügen und konfigurieren.

Voraussetzungen

Azure-Portal

• Benutzerzugriff auf ein Labor in DevTest Labs.

Azure PowerShell

• Benutzerzugriff auf ein Labor in DevTest Labs.
• Azure PowerShell. Sie haben die folgenden Möglichkeiten:
  • Azure Cloud Shellverwenden. Achten Sie darauf, die PowerShell-Umgebung auszuwählen.
  • Installieren Sie Azure PowerShell für die Verwendung auf einem physischen oder virtuellen Computer. Führen Sie bei Bedarf Update-Module -Name Az aus, um Ihre Installation zu aktualisieren.

Hinzufügen von Artefakten zu virtuellen Computern

Azure-Portal

Sie können das Azure-Portal verwenden, um Während der VM-Erstellung Artefakte hinzuzufügen oder Artefakte zu einer vorhandenen Lab-VM hinzuzufügen.

Hinzufügen von Artefakten während der VM-Erstellung

1. Wählen Sie auf der Startseite des Labors Hinzufügen aus.

2. Wählen Sie auf der Seite Basis auswählen den VM-Typ aus, den Sie verwenden möchten.

3. Füllen Sie auf dem Bildschirm " Übungsressourcen erstellen" die Registerkarte " Standardeinstellungen " gemäß den Anweisungen unter Create lab VMs in Azure DevTest Labs aus.

4. Wählen Sie unten auf der Registerkarte " Standardeinstellungen " die Option " Artefakte hinzufügen" oder "Artefakte entfernen" aus.

5. Wählen Sie auf der Seite Artefakte hinzufügen den Pfeil neben jedem Artefakt aus, das Sie der VM hinzufügen möchten.

6. Geben Sie in jedem Bereich Artefakt hinzufügen alle erforderlichen und optionalen Parameterwerte ein, und klicken Sie dann auf OK. Das Artefakt wird auf der Seite "Artefakte hinzufügen" unter "Ausgewählte Artefakte" angezeigt, und die Anzahl der konfigurierten Artefakte wird aktualisiert.

   

7. Standardmäßig werden Artefakte in der Reihenfolge installiert, in der Sie sie hinzufügen. Um die Reihenfolge neu anzuordnen, wählen Sie die Auslassungspunkte ... neben dem Artefakt in der Liste "Ausgewählte Artefakte" aus, und wählen Sie Nach oben, Nach unten, Nach ganz oben oder Nach ganz unten aus.

   • Um die Parameter eines Artefakts nach dem Hinzufügen zu bearbeiten, wählen Sie das Bleistiftsymbol aus, oder wählen Sie ... neben dem Artefakt aus, und wählen Sie "Bearbeiten" aus, um den Artefaktbereich erneut zu öffnen.

   • Um ein Artefakt aus der Liste der ausgewählten Artefakte zu löschen, wählen Sie ... und dann "Löschen" aus.

8. Wenn Sie mit dem Hinzufügen, Anordnen und Konfigurieren von Artefakten fertig sind, wählen Sie auf der Seite "Artefakte hinzufügen" "OK" aus.

9. Im Abschnitt " Artefakte" des Bildschirms " Übungsressourcen erstellen " wird die Anzahl der hinzugefügten Artefakte angezeigt. Wenn Sie die Artefakte hinzufügen, bearbeiten, neu anordnen oder löschen möchten, bevor Sie den virtuellen Computer erstellen, wählen Sie erneut Artefakte hinzufügen oder entfernen .

10. Konfigurieren Sie optional die erweiterten Einstellungen oder Tags, und wählen Sie dann unten auf dem Bildschirm Erstellen und erneut Erstellen aus, um die VM mit den hinzugefügten Artefakten zu erstellen.

Nachdem Sie den virtuellen Computer erstellt haben, werden die installierten Artefakte auf der Seite "Artefakte" des virtuellen Computers angezeigt. Um Details zur Installation der einzelnen Artefakte anzuzeigen, wählen Sie den Artefaktnamen aus.

Hinzufügen von Artefakten zu einer vorhandenen VM

1. Wählen Sie auf der Startseite des Labors die VM aus der Liste Meine virtuellen Computer aus.

2. Wählen Sie auf der VM-Seite Artefakte in der oberen Menüleiste oder unter Vorgänge in der linken Navigation aus.

3. Wählen Sie auf der Seite " Artefakte " die Option " Artefakte anwenden" aus.

   

4. Wählen Sie auf der Seite "Artefakte hinzufügen " Artefakte auf die gleiche Weise wie für einen neuen virtuellen Computer aus, und konfigurieren Sie sie.

5. Wenn Sie mit dem Hinzufügen von Artefakten fertig sind, wählen Sie "Installieren" aus. Die Artefakte werden sofort auf dem virtuellen Computer installiert.

Azure PowerShell

Melden Sie sich bei Bedarf mit dem Cmdlet Connect-AzAccount bei Ihrem Azure-Konto an. Wenn Sie über mehrere Azure-Abonnements verfügen, verwenden Set-AzContext -SubscriptionId "<SubscriptionId>" Und geben Sie die Abonnement-ID an, die Sie verwenden möchten.

Führen Sie das folgende PowerShell-Skript aus, um ein Artefakt auf einen virtuellen Computer mithilfe des Cmdlets Invoke-AzResourceAction anzuwenden. Geben Sie die Informationen an, die das Skript aufruft, wenn Sie dazu aufgefordert werden.

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

Verwandte Inhalte

• Angeben obligatorischer Artefakte
• Erstellen von benutzerdefinierten Artefakten
• Fügen Sie ein Artefaktspeicher zu einem Labor hinzu
• Diagnostizieren von Artefaktfehlern