VM アプリケーションの作成とデプロイ

$inputFile = <the file you want to pad>

$fileInfo = Get-Item -Path $inputFile

$remainder = $fileInfo.Length % 512

if ($remainder -ne 0){

    $difference = 512 - $remainder

    $bytesToPad = [System.Byte[]]::CreateInstance([System.Byte], $difference)

    Add-Content -Path $inputFile -Value $bytesToPad -Encoding Byte
    }

inputFile="<the file you want to pad>"

# Get the file size
fileSize=$(stat -c %s "$inputFile")

# Calculate the remainder when divided by 512
remainder=$((fileSize % 512))

if [ "$remainder" -ne 0 ]; then
    # Calculate how many bytes to pad
    difference=$((512 - remainder))
    
    # Create padding (empty bytes)
    dd if=/dev/zero bs=1 count=$difference >> "$inputFile"
fi

1. Azure portal に移動し、Azure Compute Gallery を検索して選択します。
2. 一覧から使うギャラリーを選びます。
3. ギャラリーのページで、ページの上部にある [追加] を選択し、ドロップダウンから [VM アプリケーション定義] を選択します。 [VM アプリケーション定義の作成] ページが開きます。
4. [基本] タブで、アプリケーションの名前を入力し、Linux または Windows を実行している VM 用のアプリケーションであるかどうかを選択します。
5. VM アプリケーション定義に次のオプション設定のいずれかを指定する場合は、[ 発行オプション ] タブを選択します。
   • VM アプリケーション定義の説明。
   • 有効期限の終了日
   • エンド ユーザー使用許諾契約書 (EULA) へのリンク
   • プライバシーに関する声明の URI
   • リリース ノートの URI
6. 完了したら、 [確認および作成] を選択します。
7. 確認が完了したら、 [作成] を選択して定義をデプロイします。
8. デプロイが完了したら、[リソースに移動] を選択します。
9. アプリケーションのページで、[VM アプリケーション バージョンの作成] を選択します。 [VM アプリケーション バージョンの作成] ページが開きます。
10. 1.0.0 などのバージョン番号を入力します。
11. アプリケーション パッケージがアップロードされるリージョンを選択します。
12. [ソース アプリケーション パッケージ] の [参照] を選択します。 ストレージ アカウントを選択し、パッケージが格納されているコンテナーを選択します。 一覧からパッケージを選択し、完了したら [選択] を選択します。 または、必要に応じて、このフィールドに SAS URI を貼り付けることができます。
13. "スクリプトのインストール" を指定します。 また、"アンインストール スクリプト" と "更新スクリプト" を指定することもできます。 スクリプトの作成方法については、概要を参照してください。
14. 既定の構成ファイルがストレージ アカウントにアップロードされている場合は、[既定の構成] で選択できます。
15. VM の作成時にこのバージョンを最新バージョンとして表示しない場合は、[最新バージョンから除外する] を選択します。
16. [終了日] では、このバージョンを廃止する日付を追跡するために、将来の日付を選択します。 自動的に削除または除外されるのではなく、独自の追跡のみを行います。
17. このバージョンを他のリージョンにレプリケートするには、[ レプリケーション ] タブを選択し、リージョンを追加して、リージョンあたりのレプリカ数を変更します。 バージョンが作成された元のリージョンは一覧に含む必要があり、削除することはできません。
18. 変更が終了したら、ページの下部にある [確認と作成] を選択します。
19. 検証に成功と表示された場合は、[作成] を選択して VM アプリケーションのバージョンをデプロイします。

New-AzGalleryApplicationを使用して VM アプリケーション定義を作成します。 この例では、myGallery Azure コンピューティング ギャラリーと myGallery リソース グループに myApp という名前の Linux アプリを作成しています。 必要に応じて変数の値を置き換えます。

$galleryName = "myGallery"
$rgName = "myResourceGroup"
$applicationName = "myApp"
$description = "Backend Linux application for finance."
New-AzGalleryApplication `
  -ResourceGroupName $rgName `
  -GalleryName $galleryName `
  -Location "East US" `
  -Name $applicationName `
  -SupportedOSType Linux `
  -Description $description

New-AzGalleryApplicationVersionを使用して VM アプリケーションのバージョンを作成します。 バージョンで許可されている文字は、数字とピリオドです。 数字は、32 ビット整数の範囲内になっている必要があります。 形式:MajorVersion.MinorVersion.Patch。

この例では、バージョン番号 1.0.0 を作成しています。 必要に応じて、変数の値を置き換えます。

$galleryName = "myGallery"
$rgName = "myResourceGroup"
$applicationName = "myApp"
$version = "1.0.0"
New-AzGalleryApplicationVersion `
   -ResourceGroupName $rgName `
   -GalleryName $galleryName `
   -GalleryApplicationName $applicationName `
   -Name $version `
   -PackageFileLink "https://<storage account name>.blob.core.windows.net/<container name>/<filename>" `
   -DefaultConfigFileLink "https://<storage account name>.blob.core.windows.net/<container name>/<filename>" `
   -Location "East US" `
   -Install "mv myApp .\myApp\myApp" `
   -Remove "rm .\myApp\myApp" `

VM アプリケーションには Azure CLI バージョン 2.30.0 以降が必要です。

'az sig gallery-application create' を使用して VM アプリケーション定義を作成します。 この例では、Linux ベースの VM 用に myApp という名前の VM アプリケーション定義を作成します。

az sig gallery-application create \
    --application-name myApp \
    --gallery-name myGallery \
    --resource-group myResourceGroup \
    --os-type Linux \
    --___location "East US"

'az sig gallery-application version create' を使用して VM アプリケーションバージョンを作成します。 バージョンで許可されている文字は、数字とピリオドです。 数字は、32 ビット整数の範囲内になっている必要があります。 形式:MajorVersion.MinorVersion.Patch。

パラメーターの値を独自の値に置き換えます。

az sig gallery-application version create \
   --version-name 1.0.0 \
   --application-name myApp \
   --gallery-name myGallery \
   --___location "East US" \
   --resource-group myResourceGroup \
   --package-file-link "https://<storage account name>.blob.core.windows.net/<container name>/<filename>" \
   --install-command "mv myApp .\myApp\myApp" \
   --remove-command "rm .\myApp\myApp" \
   --update-command  "mv myApp .\myApp\myApp" \
   --default-configuration-file-link "https://<storage account name>.blob.core.windows.net/<container name>/<filename>"\

"ギャラリー アプリケーション API の作成" を使用して VM アプリケーション定義を作成する

PUT
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/applications/{applicationName}?api-version=2024-03-03

{
    "___location": "West US",
    "name": "myApp",
    "properties": {
        "supportedOSType": "Windows | Linux",
        "endOfLifeDate": "2020-01-01",
	"description": "Description of the App",
	"eula": "Link to End-User License Agreement (EULA)",
	"privacyStatementUri": "Link to privacy statement for the application",
	"releaseNoteUri": "Link to release notes for the application"
    }
}

"ギャラリー アプリケーション バージョンの作成 API" を使用して、VM アプリケーションのバージョンを作成します。

PUT
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/applications/{applicationName}/versions/{versionName}?api-version=2024-03-03

{
  "___location": "$___location",
  "properties": {
    "publishingProfile": {
      "source": {
        "mediaLink": "$mediaLink",
        "defaultConfigurationLink": "$configLink"
      },
      "manageActions": {
        "install": "echo installed",
        "remove": "echo removed",
        "update": "echo update"
      },
      "targetRegions": [
        {
          "name": "West US",
          "regionalReplicaCount": 1
        },
	{
	  "name": "East US"
	}
      ]
      "endofLifeDate": "datetime",
      "replicaCount": 1,
      "excludeFromLatest": false,
      "storageAccountType": "PremiumV2_LRS | Premium_LRS | Standard_LRS | Standard_ZRS"
      "safetyProfile": {
	"allowDeletionOfReplicatedLocations": false
      }
      "settings": {
	"scriptBehaviorAfterReboot": "None | Rerun",
	"configFileName": "$appConfigFileName",
	"packageFileName": "$appPackageFileName"
      }
   }
}

これで、VM を作成して、ポータルを使用して VM アプリケーションをデプロイできるようになりました。 通常どおりに VM を作成し、 [詳細設定] タブで [Select a VM application to install](インストールする VM アプリケーションの選択) を選択します。

一覧から VM アプリケーションを選択し、ページの下部にある [保存 ] を選択します。

複数の VM アプリケーションがインストールされている場合は、[詳細設定] タブで各 VM アプリケーションのインストール順序を設定し直すことができます。

VM アプリケーションを現在実行中の VM にデプロイすることもできます。 ポータルで VM の詳細を表示するときに、左側のメニューの [設定] で [拡張機能とアプリケーション] オプションを選択します。

[VM アプリケーション] を選択し、[アプリケーションの追加] を選択して VM アプリケーションを追加します。

一覧から VM アプリケーションを選択し、ページの下部にある [保存 ] を選択します。

"az vm application set" を使用して VM アプリケーションを既存の VM に設定し、パラメーターの値を独自の値に置き換えます。

az vm application set \
	--resource-group myResourceGroup \
	--name myVM \
  	--app-version-ids /subscriptions/{subID}/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/galleries/myGallery/applications/myApp/versions/1.0.0 \
  	--treat-deployment-as-failure true

VM で複数のアプリケーションを設定する場合:

az vm application set \
	--resource-group myResourceGroup \
	--name myVM \
	--app-version-ids /subscriptions/{subId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/applications/myApp/versions/1.0.0 /subscriptions/{subId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/applications/myApp2/versions/1.0.1 \
	--treat-deployment-as-failure true true

仮想マシン スケール セットにアプリケーションを追加するには、 "az vmss application set" を使用します。

az vmss application set \
	--resource-group myResourceGroup \
	--name myVmss \
	--app-version-ids /subscriptions/{subId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/applications/myApp/versions/1.0.0 \
	--treat-deployment-as-failure true

仮想マシン スケール セットに複数のアプリケーションを追加するには:

az vmss application set \
	--resource-group myResourceGroup \
	--name myVmss
	--app-version-ids /subscriptions/{subId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/applications/myApp/versions/1.0.0 /subscriptions/{subId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/applications/myApp2/versions/1.0.0 \
	--treat-deployment-as-failure true

既存の VM にアプリケーションを追加するには、アプリケーションのバージョンを取得し、それを使用して VM アプリケーションのバージョン ID を取得します。 ID を使用して、アプリケーションを VM 構成に追加します。

$galleryName = "myGallery"
$rgName = "myResourceGroup"
$applicationName = "myApp"
$version = "1.0.0"
$vmName = "myVM"
$vm = Get-AzVM -ResourceGroupName $rgname -Name $vmName
$appVersion = Get-AzGalleryApplicationVersion `
   -GalleryApplicationName $applicationName `
   -GalleryName $galleryName `
   -Name $version `
   -ResourceGroupName $rgName
$packageId = $appVersion.Id
$app = New-AzVmGalleryApplication -PackageReferenceId $packageId
Add-AzVmGalleryApplication -VM $vm -GalleryApplication $app -TreatFailureAsDeploymentFailure true
Update-AzVM -ResourceGroupName $rgName -VM $vm

仮想マシン スケール セットにアプリケーションを追加するには:

$vmss = Get-AzVmss -ResourceGroupName $rgname -Name $vmssName
$appVersion = Get-AzGalleryApplicationVersion `
   -GalleryApplicationName $applicationName `
   -GalleryName $galleryName `
   -Name $version `
   -ResourceGroupName $rgName
$packageId = $appVersion.Id
$app = New-AzVmssGalleryApplication -PackageReferenceId $packageId
Add-AzVmssGalleryApplication -VirtualMachineScaleSetVM $vmss.VirtualMachineProfile -GalleryApplication $app
Update-AzVmss -ResourceGroupName $rgName -VirtualMachineScaleSet $vmss -VMScaleSetName $vmssName

VM アプリケーションのバージョンを VM に追加するには、VM で PUT を実行します。

PUT
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{VMName}?api-version=2024-03-03

{
  "properties": {
    "applicationProfile": {
      "galleryApplications": [
        {
          "order": 1,
          "packageReferenceId": "/subscriptions/{subscriptionId}/resourceGroups/<resource group>/providers/Microsoft.Compute/galleries/{gallery name}/applications/{application name}/versions/{version | latest}",
          "configurationReference": "{path to configuration storage blob}",
          "treatFailureAsDeploymentFailure": false
        }
      ]
    }
  },
  "name": "{vm name}",
  "id": "/subscriptions/{subscriptionId}/resourceGroups/{resource group}/providers/Microsoft.Compute/virtualMachines/{vm name}",
  "___location": "{vm ___location}"
}

VM アプリケーションを均一スケール セットに適用するには、次の手順を実行します。

PUT
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{VMSSName}?api-version=2024-03-03

{
  "properties": {
    "virtualMachineProfile": {
      "applicationProfile": {
        "galleryApplications": [
          {
            "order": 1,
            "packageReferenceId": "/subscriptions/{subscriptionId}/resourceGroups/<resource group>/providers/Microsoft.Compute/galleries/{gallery name}/applications/{application name}/versions/{version | latest}",
            "configurationReference": "{path to configuration storage blob}",
            "treatFailureAsDeploymentFailure": false
          }
        ]
      }
    }
  },
  "name": "{vm name}",
  "id": "/subscriptions/{subscriptionId}/resourceGroups/{resource group}/providers/Microsoft.Compute/virtualMachines/{vm name}",
  "___location": "{vm ___location}"
}

順序フィールドを使用して、アプリケーション間の依存関係を指定できます。 順序の規則は次のとおりです。

応答には、完全な VM モデルが含まれます。 関連する部分を次に示します。

{
  "name": "{vm name}",
  "id": "{vm id}",
  "type": "Microsoft.Compute/virtualMachines",
  "___location": "{vm ___location}",
  "properties": {
    "applicationProfile": {
      "galleryApplications": ""
    },
    "provisioningState": "Updating"
  },
  "resources": [
    {
      "name": "VMAppExtension",
      "id": "{extension id}",
      "type": "Microsoft.Compute/virtualMachines/extensions",
      "___location": "centraluseuap",
      "properties": "@{autoUpgradeMinorVersion=True; forceUpdateTag=7c4223fc-f4ea-4179-ada8-c8a85a1399f5; provisioningState=Creating; publisher=Microsoft.CPlat.Core; type=VMApplicationManagerLinux; typeHandlerVersion=1.0; settings=}"
    }
  ]
}

VM アプリケーションのステータスを表示するには、[拡張機能 + アプリケーション] タブ/設定に移動し、VMAppExtension のステータスを確認します。

スケール セットの VM アプリケーションの状態を表示するには、Azure portal の [仮想マシン スケール セット] ページに移動し、[インスタンス] セクションで一覧表示されているスケール セットのいずれかを選択し、 VMAppExtension に移動します。

VM 上のアプリケーションのデプロイ状態を確認するには、 'az vm get-instance-view' を使用します。

az vm get-instance-view -g myResourceGroup -n myVM --query "instanceView.extensions[?name == 'VMAppExtension']"

仮想マシン スケール セットでアプリケーションのデプロイ状態を確認するには、 'az vmss get-instance-view' を使用します。

az vmss get-instance-view --ids (az vmss list-instances -g myResourceGroup -n myVmss --query "[*].id" -o tsv) --query "[*].extensions[?name == 'VMAppExtension']"

$ids = az vmss list-instances -g myResourceGroup -n myVmss --query "[*].{id: id, instanceId: instanceId}" | ConvertFrom-Json
$ids | Foreach-Object {
    $iid = $_.instanceId
    Write-Output "instanceId: $iid" 
    az vmss get-instance-view --ids $_.id --query "extensions[?name == 'VMAppExtension']" 
}

アプリケーションが成功したことを確認してください。

$rgName = "myResourceGroup"
$vmName = "myVM"
$result = Get-AzVM -ResourceGroupName $rgName -VMName $vmName -Status
$result.Extensions | Where-Object {$_.Name -eq "VMAppExtension"} | ConvertTo-Json

仮想マシン スケール セットで確認するには:

$rgName = "myResourceGroup"
$vmssName = "myVMss"
$result = Get-AzVmssVM -ResourceGroupName $rgName -VMScaleSetName $vmssName -InstanceView
$resultSummary  = New-Object System.Collections.ArrayList
$result | ForEach-Object {
    $res = @{ instanceId = $_.InstanceId; vmappStatus = $_.InstanceView.Extensions | Where-Object {$_.Name -eq "VMAppExtension"}}
    $resultSummary.Add($res) | Out-Null
}
$resultSummary | ConvertTo-Json -Depth 5

VM アプリケーションが VM にインストールされていない場合、値は空です。

VM インスタンス ビューの結果を取得するには:

GET
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{VMName}/instanceView?api-version=2024-03-03

結果は次のようになります。

{
    ...
    "extensions"  [
    ...
        {
            "name":  "VMAppExtension",
            "type":  "Microsoft.CPlat.Core.VMApplicationManagerLinux",
            "typeHandlerVersion":  "1.0.9",
            "statuses":  [
                            {
                                "code":  "ProvisioningState/succeeded",
                                "level":  "Info",
                                "displayStatus":  "Provisioning succeeded",
                                "message":  "Enable succeeded: {\n \"CurrentState\": [\n  {\n   \"applicationName\": \"doNothingLinux\",\n   \"version\": \"1.0.0\",\n   \"result\": \"Install SUCCESS\"\n  },\n  {
        \n   \"applicationName\": \"badapplinux\",\n   \"version\": \"1.0.0\",\n   \"result\": \"Install FAILED Error executing command \u0027exit 1\u0027: command terminated with exit status=1\"\n  }\n ],\n \"ActionsPerformed\": []\n}
        "
                            }
                        ]
        }
    ...
    ]
}

VM アプリの状態は、インスタンス ビューの VM アプリ拡張機能の結果のステータス メッセージにあります。

仮想マシン スケール セット上のアプリケーションの状態を取得するには:

GET
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/ virtualMachineScaleSets/{VMSSName}/virtualMachines/{instanceId}/instanceView?api-version=2019-03-01

出力は、前の VM の例のようになります。

VM アプリケーションのバージョンを削除します。

Remove-AzGalleryApplicationVersion -ResourceGroupName $rgNmae -GalleryName $galleryName -GalleryApplicationName $galleryApplicationName -Name $name

すべてのバージョンが削除された後、VM アプリケーションを削除します。

Remove-AzGalleryApplication -ResourceGroupName $rgNmae -GalleryName $galleryName -Name $name

VM アプリケーションのバージョンを削除します。

az sig gallery-application version delete --resource-group $rg-name --gallery-name $gallery-name --application-name $app-name --version-name $version-name

すべてのバージョンが削除された後、VM アプリケーションを削除します。

az sig gallery-application delete --resource-group $rg-name --gallery-name $gallery-name --application-name $app-name

VM アプリケーションのバージョンを削除します。

DELETE
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/applications/{galleryApplicationName}/versions/{galleryApplicationVersionName}?api-version=2024-03-03

すべてのバージョンが削除された後、VM アプリケーションを削除します。

DELETE
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/applications/{galleryApplicationName}?api-version=2024-03-03

次のステップ

Azure VM アプリケーションの詳細を確認します。