Especifique um grupo de recursos para máquinas virtuais do laboratório no Azure DevTest Labs

Artigo
04/13/2023

Por padrão, o Azure DevTest Labs cria um novo grupo de recursos sempre que uma nova máquina virtual é criada. Como um proprietário de laboratório, você pode configurar suas máquinas virtuais do laboratório a serem criadas em um grupo de recursos específico. Esse recurso o ajuda nos seguintes cenários:

Tem menos grupos de recursos criados por laboratórios na sua assinatura.
Seus laboratórios devem operar dentro de um conjunto fixo de grupos de recursos configurados por você.
Contornar as restrições e aprovações necessárias para a criação de grupos de recursos na sua assinatura do Azure.
Combine todos os seus recursos de laboratório dentro de um único grupo de recursos para simplificar o acompanhamento desses recursos e aplicar políticas para gerenciar recursos no nível do grupo de recursos.

Com essa funcionalidade, você pode usar um script para especificar um grupo de recursos novo ou existente em sua assinatura do Azure para todas as VMs do laboratório. Atualmente, o Azure DevTest Labs dá suporte a esse recurso por meio de uma API.

Observação

Todos os limites de assinatura se aplicam ao criar laboratórios no DevTest Labs. Imagine um laboratório como qualquer outro recurso em sua assinatura. No caso de grupos de recursos, o limite é de 980 grupos de recursos por assinatura.

Usar o portal do Azure

Siga estas etapas para especificar um grupo de recursos para todas as VMs criadas no laboratório.

Entre no portal do Azure.
Selecione Todos os serviços no menu de navegação à esquerda.
Selecione DevTest Labs na lista.
Na lista de laboratórios, selecione seu laboratório.
Selecione Configuração e políticas na seção Configurações do menu à esquerda.
Selecione Configurações de laboratório no menu à esquerda.
Selecione Todas as máquinas virtuais em um grupo de recursos.
Selecione um grupo de recursos existente na lista suspensa ou selecione Criar novo, digite um nome para o grupo de recursos e selecione OK.

Usar o PowerShell

O exemplo a seguir mostra como usar um script do PowerShell para criar todas as máquinas virtuais do laboratório em um novo grupo de recursos.

[CmdletBinding()]
Param(
    $subId,
    $labRg,
    $labName,
    $vmRg
)

az login | out-null

az account set --subscription $subId | out-null

$rgId = "/subscriptions/"+$subId+"/resourceGroups/"+$vmRg

"Updating lab '$labName' with vm rg '$rgId'..."

az resource update -g $labRg -n $labName --resource-type "Microsoft.DevTestLab/labs" --api-version 2018-10-15-preview --set properties.vmCreationResourceGroupId=$rgId

"Done. New virtual machines will now be created in the resource group '$vmRg'."

Invoque o script usando o comando a seguir. ResourceGroup.ps1 é o arquivo que contém o script anterior:

.\ResourceGroup.ps1 -subId <subscriptionID> -labRg <labRGNAme> -labName <LanName> -vmRg <RGName>

Usar um modelo do Azure Resource Manager

Se você estiver usando o modelo do Azure Resource Manager para criar um laboratório, use a propriedade vmCreationResourceGroupId na seção de propriedades do laboratório do seu modelo, conforme mostrado no seguinte exemplo:

{
    "type": "microsoft.devtestlab/labs",
    "name": "[parameters('lab_name')]",
    "apiVersion": "2018-10-15-preview",
    "location": "eastus",
    "tags": {},
    "scale": null,
    "properties": {
        "vmCreationResourceGroupId": "/subscriptions/<SubscriptionID>/resourcegroups/<ResourceGroupName>",
        "labStorageType": "Premium",
        "premiumDataDisks": "Disabled",
        "provisioningState": "Succeeded",
        "uniqueIdentifier": "000000000f-0000-0000-0000-00000000000000"
    },
    "dependsOn": []
},

API para configurar um grupo de recursos para as VMs do laboratório

Você tem as seguintes opções como um proprietário de laboratório ao usar esta API:

Escolher o grupo de recursos do laboratório para todas as máquinas virtuais.
Escolher um grupo de recursos existente que não seja o grupo de recursos do laboratório para todas as máquinas virtuais.
Inserir um nome do novo grupo de recursos para todas as máquinas virtuais.
Continuar usando o comportamento existente, em que um grupo de recursos é criado para cada VM no laboratório.

Essa configuração se aplica a novas máquinas virtuais criadas no laboratório. As VMs mais antigas em seu laboratório que foram criadas em seus próprios grupos de recursos continuam não sendo afetadas. Ambientes que são criados em seu laboratório continuam em seus próprios grupos de recursos.

Como usar essa API:

Use a versão da API 2018-10-15-preview.
Se você especificar um novo grupo de recursos, verifique se você tem permissões de gravação em grupos de recursos dentro de sua assinatura. Se você não tem permissões de gravação, criar novas máquinas virtuais no grupo de recursos especificado resultará em falha.
Ao usar a API, passe a ID completa do grupo de recursos. Por exemplo: /subscriptions/<SubscriptionID>/resourceGroups/<ResourceGroupName>. Verifique se o grupo de recursos está na mesma assinatura que o laboratório.

Próximas etapas

Confira o seguinte artigo:

Definir políticas para um laboratório