Azure CLI を使用して DevTest Labs で仮想マシンを作成して管理する

[アーティクル]
06/01/2023

このクイックスタートでは、ラボで開発用コンピューターを作成、起動、接続、更新、およびクリーンアップする方法について説明します。

作業を開始する前に、次のことを行います。

ラボが作成されていない場合は、こちらで方法をご覧ください。
Azure CLI のインストールを実行します。開始するには、az login を実行して、Azure との接続を作成します。

仮想マシンを作成して確認する

DevTest Labs 関連のコマンドを実行する前に、az account set コマンドを使用して適切な Azure コンテキストを設定します。

az account set --subscription 11111111-1111-1111-1111-111111111111

仮想マシンを作成するコマンドは az lab vm create です。ラボのリソースグループ、ラボの名前、および仮想マシンの名前はすべて必須です。残りの引数は、仮想マシンの種類によって変化します。

次のコマンドでは、Azure Marketplace から Windows ベースのイメージが作成されます。イメージの名前は、Azure portal を使って仮想マシンを作成するときに表示されるものと同じです。

az lab vm create --resource-group DtlResourceGroup --lab-name MyLab --name 'MyTestVm' --image "Visual Studio Community 2017 on Windows Server 2016 (x64)" --image-type gallery --size 'Standard_D2s_v3' --admin-username 'AdminUser' --admin-password 'Password1!'

次のコマンドでは、ラボで使用可能なカスタムイメージに基づいて仮想マシンが作成されます。

az lab vm create --resource-group DtlResourceGroup --lab-name MyLab --name 'MyTestVm' --image "My Custom Image" --image-type custom --size 'Standard_D2s_v3' --admin-username 'AdminUser' --admin-password 'Password1!'

image-type 引数が、gallery から custom に変更されています。イメージの名前は、Azure portal で仮想マシンを作成する場合に表示されるものと一致します。

次のコマンドでは、SSH 認証を使って Marketplace イメージから VM が作成されます。

az lab vm create --lab-name sampleLabName --resource-group sampleLabResourceGroup --name sampleVMName --image "Ubuntu Server 16.04 LTS" --image-type gallery --size Standard_DS1_v2 --authentication-type  ssh --generate-ssh-keys --ip-configuration public

image-type パラメーターを formula に設定することで、数式に基づいて仮想マシンを作成することもできます。仮想マシンに特定の仮想ネットワークを選択する必要がある場合は、vnet-name パラメーターと subnet パラメーターを使用します。詳しくは、「az lab vm create」をご覧ください。

VM が使用可能であることを確認します。

VM を起動して接続する前に、VM が利用可能であることを確認するには、az lab vm show コマンドを使用します。

az lab vm show --lab-name sampleLabName --name sampleVMName --resource-group sampleResourceGroup --expand 'properties($expand=ComputeVm,NetworkInterface)' --query '{status: computeVm.statuses[0].displayStatus, fqdn: fqdn, ipAddress: networkInterface.publicIpAddress}'

{
  "fqdn": "lisalabvm.southcentralus.cloudapp.azure.com",
  "ipAddress": "13.85.228.112",
  "status": "Provisioning succeeded"
}

仮想マシンを起動して接続する

次のコマンドの例では、VM が起動されます。

az lab vm start --lab-name sampleLabName --name sampleVMName --resource-group sampleLabResourceGroup

SSH またはリモートデスクトップを使って VM に接続します。

ssh userName@ipAddressOrfqdn

仮想マシンを更新する

次のサンプルコマンドでは、VM に成果物が適用されます。

az lab vm apply-artifacts --lab-name  sampleLabName --name sampleVMName  --resource-group sampleResourceGroup  --artifacts @/artifacts.json

[
  {
    "artifactId": "/artifactSources/public repo/artifacts/linux-java",
    "parameters": []
  },
  {
    "artifactId": "/artifactSources/public repo/artifacts/linux-install-nodejs",
    "parameters": []
  },
  {
    "artifactId": "/artifactSources/public repo/artifacts/linux-apt-package",
    "parameters": [
      {
        "name": "packages",
        "value": "abcd"
      },
      {
        "name": "update",
        "value": "true"
      },
      {
        "name": "options",
        "value": ""
      }
    ]
  } 
]

ラボで使用できるアーティファクトの一覧を表示する

ラボ内の VM で使用可能な成果物の一覧を表示するには、次のコマンドを実行します。

Cloud Shell - PowerShell: $expand で $ の前にバッククォート (`) が使用されていることに注意してください (つまり `$expand)。

az lab vm show --resource-group <resourcegroupname> --lab-name <labname> --name <vmname> --expand "properties(`$expand=artifacts)" --query "artifacts[].{artifactId: artifactId, status: status}"

Cloud Shell - Bash: コマンドで $ の前にスラッシュ (\) 文字が使用されていることに注意してください。

az lab vm show --resource-group <resourcegroupname> --lab-name <labname> --name <vmname> --expand "properties(\$expand=artifacts)" --query "artifacts[].{artifactId: artifactId, status: status}"

サンプル出力:

[
  {
    "artifactId": "/subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.DevTestLab/labs/<lab name>/artifactSources/public repo/artifacts/windows-7zip",
    "status": "Succeeded"
  }
]

仮想マシンを停止して削除する

次のサンプルコマンドでは、VM が停止されます。

az lab vm stop --lab-name sampleLabName --name sampleVMName --resource-group sampleResourceGroup

VM を削除します。

az lab vm delete --lab-name sampleLabName --name sampleVMName --resource-group sampleResourceGroup

次のステップ

次のコンテンツを参照してください: Azure DevTest Labs の Azure CLI ドキュメント。