Adición de artefactos a máquinas virtuales de DevTest Labs

En este artículo se describe cómo agregar artefactos a máquinas virtuales (VM) de Azure DevTest Labs mediante Azure Portal o Azure PowerShell. Los artefactos son herramientas, acciones o software que puede agregar a las máquinas virtuales de laboratorio. Por ejemplo, los artefactos pueden ejecutar scripts de Windows PowerShell o comandos de Bash, instalar herramientas o aplicaciones, o realizar otras acciones como unir un dominio.

Los artefactos de DevTest Labs pueden provenir del repositorio git público de DevTest Labs o de repositorios git privados. Los usuarios del laboratorio pueden crear sus propios artefactos personalizados y almacenarlos en un repositorio y usar parámetros para personalizar los artefactos existentes para sus propias necesidades.

Un administrador de laboratorio puede agregar repositorios de artefactos a un laboratorio para que todos los usuarios del laboratorio puedan acceder a ellos. Los administradores de laboratorio también pueden especificar artefactos obligatorios que se instalarán en todas las máquinas virtuales de laboratorio en la creación. Los usuarios del laboratorio no pueden cambiar ni quitar artefactos obligatorios en el momento de la creación de la máquina virtual, pero pueden agregar y configurar otros artefactos disponibles en o después de la hora de creación de la máquina virtual.

Prerrequisitos

Azure Portal

• Acceso de usuario a un laboratorio en DevTest Labs.

Azure PowerShell

• Acceso de usuario a un laboratorio en DevTest Labs.
• Azure PowerShell. Puede hacer lo siguiente:
  • Use Azure Cloud Shell. Asegúrese de seleccionar el entorno de PowerShell .
  • Instale Azure PowerShell para usarlo en una máquina virtual o física. Si es necesario, ejecute Update-Module -Name Az para actualizar la instalación.

Adición de artefactos a máquinas virtuales

Azure Portal

Puede usar Azure Portal para agregar artefactos durante la creación de máquinas virtuales o para agregar artefactos a una máquina virtual de laboratorio existente.

Adición de artefactos durante la creación de máquinas virtuales

1. En la página principal del laboratorio, seleccione Agregar.

2. En la página Elegir una base, seleccione el tipo de máquina virtual que prefiera.

3. En la pantalla Crear recurso de laboratorio , rellene la pestaña Configuración básica según las instrucciones de Creación de máquinas virtuales de laboratorio en Azure DevTest Labs.

4. En la parte inferior de la pestaña Configuración básica , seleccione Agregar o quitar artefactos.

5. En la página Agregar artefactos, seleccione la flecha situada junto a cada artefacto que quiera agregar a la máquina virtual.

6. En cada panel Agregar artefacto, escriba los valores de parámetro obligatorios y opcionales y, luego, seleccione Aceptar. El artefacto aparece en Artefactos seleccionados en la página Agregar artefactos y el número de actualizaciones de artefactos configurados.

   

7. De forma predeterminada, los artefactos se instalan en el orden en que los agrega. Para reorganizar el orden, seleccione los puntos suspensivos ... junto al artefacto de la lista Artefactos seleccionados y seleccione Subir, Bajar, Mover a la parte superior o Mover a la parte inferior.

   • Para editar los parámetros de un artefacto después de agregarlo, seleccione el icono de lápiz o seleccione ... junto al artefacto y seleccione Editar para volver a abrir el panel de artefactos.

   • Para eliminar un artefacto de la lista Artefactos seleccionados , seleccione ... y, a continuación, seleccione Eliminar.

8. Cuando haya terminado de agregar, organizar y configurar artefactos, seleccione Aceptar en la página Agregar artefactos .

9. La sección Artefactos de la pantalla Crear recurso de laboratorio muestra el número de artefactos agregados. Para agregar, editar, reorganizar o eliminar los artefactos antes de crear la máquina virtual, seleccione Agregar o quitar artefactos de nuevo.

10. Opcionalmente, configure cualquier configuración avanzada o etiquetas y, a continuación, seleccione Crear y crear de nuevo en la parte inferior de la pantalla para crear la máquina virtual con artefactos agregados.

Después de crear la máquina virtual, los artefactos instalados aparecen en la página Artefactos de la máquina virtual. Para ver detalles sobre la instalación de cada artefacto, seleccione el nombre del artefacto.

Adición de artefactos a una máquina virtual existente

1. En la página principal del laboratorio, seleccione la máquina virtual en la lista Mis máquinas virtuales .

2. En la página máquina virtual, seleccione Artefactos en la barra de menús superior o en Operaciones en el panel de navegación izquierdo.

3. En la página Artefactos , seleccione Aplicar artefactos.

   

4. En la página Agregar artefactos , seleccione y configure artefactos de la misma manera que para una nueva máquina virtual.

5. Cuando haya terminado de agregar artefactos, seleccione Instalar. Los artefactos se instalan en la máquina virtual inmediatamente.

Azure PowerShell

Si es necesario, inicie sesión en su cuenta de Azure mediante el cmdlet Connect-AzAccount . Si tiene varias suscripciones de Azure, use Set-AzContext -SubscriptionId "<SubscriptionId>" y proporcione el identificador de suscripción que desea usar.

Ejecute el siguiente script de PowerShell para aplicar un artefacto a una máquina virtual mediante el cmdlet Invoke-AzResourceAction . Proporcione la información a la que llama el script cuando se le solicite.

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

Contenido relacionado

• Especificación de artefactos obligatorios
• Creación de artefactos personalizados
• Adición de un repositorio de artefactos a un laboratorio
• Diagnóstico de errores de artefactos