はじめに

現在は、Azure Virtual Desktop (AVD) で、ホストプールと仮想マシンを作成する際に、どれだけシンプルな画面からデプロイさせられるか？を研究しています。
その際には、いくつかのハードルがあったのですが、そこで得られたノウハウを記事にしていこうと思っています。
AVDに関する記事は、以下のリンク先でシリーズ化していますので併せて参照ください。

今回は、AVD を ARMテンプレートからデプロイできるようにして、さらにボタン１発でデプロイ画面を表示する機能 [Deploy to Azure] までを紹介したいと思います。

加えて AVD を展開する上での課題対応にも取り組み、これらを組み合わせて動作させるまでを検証した結果をお伝えしていきます。

目標

以下のようなシンプルな手順で、AVD をデプロイできるようにしたい。

AVD のデプロイ画面を表示させ、必要な値はあらかじめ入力されている
必要な可変項目だけを修正（既定値のままでも可）
パスワードなどのセキュリティ情報は漏洩させない（作業者が知る事も無い）
ボタン１発でデプロイを実行

おさらい：通常の AVD をデプロイする際の流れ

通常 AVD をデプロイする際には、以下のような入力項目をミスなく入力していく必要があります。

一度、AVD のデプロイに成功していれば、その時の値をテキストで用意しておいて、コピペでも良いっちゃ良いです。

でも、スマートではありませんね。

上記の カスタム構成スクリプトの URL 欄には、以下の記事で紹介している 全自動日本語化 のスクリプトを割り当てています。
https://qiita.com/carol0226/items/f7770369947aaf4962f7

この仕組みと組み合わせることで、テンプレートからデプロイする際に、イメージの日本語化までを実施してくれるようになります。

AVD のデプロイが終わったら、以下の記事を参考にアプリケーショングループにユーザーを割り当てる必要があります。

ARM テンプレートの入手方法

Azure には、ARM テンプレートと言って、繰り返し運用する場合などに予め用意されたテンプレートからデプロイを行う機能があります。目標達成のために、この機能を使っていきたいと思います。

AVD 用の ARM テンプレートは AVD のデプロイを行う直前に、以下の赤枠部分 (Automation のテンプレートをダウンロードする) を押すことで、ダウンロードすることができます。

そのあと、以下のボタンからダウンロードできます。

既定の ARM テンプレートを使う場合の課題と解決策

課題１

ARM テンプレートからデプロイする際は、複数ステップのオペレーションが必要であり、実はスマートではありません。

テンプレートの一般的なデプロイ手順

下図の ①～③ の順に カスタムテンプレートのデプロイ を開き、エディターで独自のテンプレートを作成する を選択します。

　
下図の ①：ファイルの読み込み を押した後、template.json を指定して、②：保存 を押します。

　
template.json の選択画面

　
下図で パラメーターの編集（赤枠）を押します。

　
下図の ①：ファイルの読み込み を押したあと、parmaters.json を指定して、②：保存 を押します。

　
parameters.json の選択画面

　
パスワード欄は、parameters.json では読み込めないため、手入力が必須となります。
確認と作成 を押して、デプロイを実行します。

この方法でも良いや・・・と思われた場合は、これを採用頂いても構いません。

課題
template.json の読み込みと、parameters.json を別々に読み込ませる必要がありますし、その後でパスワードを手入力する必要があります。
もう少し、スマートにできないかな・・と思いますよね。

かなり調査をしたり、サポートに問い合わせもしてみたのですが、GUI で、template.json と parameters.json を一度に読み込ませる方法は存在しませんでした。（なお、コマンドだと存在します）

ですが、私がやりたいのはボタン１発で ARM テンプレートを GUI 表示させて、可変項目だけを修正（または修正せずにそのまま）、デプロイを実施できるような方法です。

課題１の解決策

結論として、[Azure にデプロイ] ボタン を使う事にしました。
これで、いちいち Azure Portal を開いて、カスタムテンプレートのデプロイの画面を呼び出して、テンプレートファイルを読み込ませる・・・という手順を省略できます。

注意点
[Azure にデプロイ] ボタン でかなり手順を省略できますが、template.json を読み込ませることしかできず、parameters.json は読み込みできません。

追加のアイデア💡
parameters.json に書かれている内容も、template.json に記載して、マージして１本化してしまおう・・・いう戦略でそれを回避する事にしました。

完成したマージ済みのソースは公開してあります。最終章のリンクから入手いただき、内容を確認いただけます。

以下が公開情報で説明されている [Azure にデプロイ] ボタン を使う方法です。

公開情報：[Azure にデプロイ] ボタン

上記の内容のうち、私の場合は Azure ストレージアカウントに格納されているテンプレート の章に書かれている方法を使う事にしました。

書式
https://{storage-account-name}.blob.core.windows.net/{container-name}/{template-file-name}

以下のようにストレージアカウントに template.json を配置しておきます。

コンテナのアクセスレベルは、以下のように匿名アクセスを許可しておきます。

用意したストレージアカウント上の JSON のパスを踏まえて、以下のように Markdown を記載します。

コロン":" が "%3A"、スラッシュ"/" が "%2F" に置き換わっている点に注意してください。

[![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fnogujapanese.blob.core.windows.net%2Favd-template%2Ftemplate.json)

上記の内容は、Markdown の書式になっているので Qiita にそのまま貼ると、以下のようなボタンが表示されます。

（表示されるボタン）

（注意）
上記のボタンは、単なる画像なので、押せません。
実際に押せるボタンは　最終章 に用意してあります。

このボタンを押すと、１発で AVD のデプロイ用のページが表示されるようになります。

課題２

課題１で終わらせても良いのですが、その場合管理者パスワードを手入力する必要があったり、可変させたい項目の変更がテキストでの手入力になります（リストボックスから選ぶことはできない）
（可変させたい主な項目）
・デプロイする VM 数
・VMサイズ
・VM 名（既存VMと被らない名称にする必要があり固定化できない）
・イメージの種類（Win10/11 , Office365有無）
・プール or 固定
・トークンの有効期限（テンプレート内にベタ書きされているので、未来日に修正が必要）

そのため、以下のようなカスタマイズを行いたいです。
・可変させたい項目は選択肢の一覧から選択させて、固定の値はあらかじめ埋め込む。
・VM名やトークンの有効期限などは、ルールを決めておいて自動発番させたい。
・パスワードなどのセキュリティ項目は、Azure KeyVault から動的に読み込むような仕掛けを用意する。

課題２の解決策

1. パスワードの受け渡しの課題
　→　パスワードを Azure KeyVault から読み込ませます
2. パラメータ "tokenExpirationTime" の課題
　→　トークン有効期限をデプロイ時の２時間後に自動設定します
3. パラメータ "vmNamePrefix" の課題
　→　日時をもとに VM 名の自動採番を行います

上記 1.～3. の課題解決策は、以下の記事に纏めてあります。

4. VM イメージや VM サイズを選択式にする
本当は Azure 内に用意されているイメージから自動取得した内容を表示させられるとカッコ良かったのですが、そこまでには至れませんでした。

代替策として、固定値となりますが、選択可能な値の一覧をテンプレートに埋め込んでおき、デプロイ時に選択できるようにしました。

VM イメージ選択の例

        "vmGalleryImageSKU": {
            "type": "string",
            "allowedValues": [
                "win10-21h2-avd",
                "win10-21h2-avd-g2",
                "win10-21h2-avd-m365",
                "win10-21h2-avd-m365-g2",
                "win10-22h2-avd",
                "win10-22h2-avd-g2",
                "win10-22h2-avd-m365",
                "win10-22h2-avd-m365-g2",
                "win11-21h2-avd",
                "win11-21h2-avd-m365",
                "win11-22h2-avd",
                "win11-22h2-avd-m365"
            ],
            "metadata": {
                "description": "VMイメージ"
            },
            "defaultValue": "win10-22h2-avd-m365-g2"
        },

VM サイズ選択の例

        "vmSize": {
            "type": "string",
            "allowedValues": [
                "Standard_D2s_v3",
                "Standard_D4s_v3",
                "Standard_D8s_v3",
                "Standard_D8s_v4",
                "Standard_D16s_v4",
                "Standard_D32s_v4",
                "Standard_D48s_v4",
                "Standard_D64s_v4"
            ],
            "metadata": {
                "description": "仮想マシンのサイズ"
            },
            "defaultValue": "Standard_D4s_v3"
        },

VM ディスク種類の選択の例

        "vmDiskType": {
            "type": "string",
            "allowedValues": [
                "Premium_LRS",
                "StandardSSD_LRS",
                "Standard_LRS"
            ],
            "metadata": {
                "description": "OSディスクの種類"
            },
            "defaultValue": "Premium_LRS"
        },

ゴール（完成版のボタン）

課題１と２の解決策をすべて含んだ、完成版の ARM テンプレートを公開しておきます。

Template.json のソース
https://nogujapanese.blob.core.windows.net/avd-template/template.json

なお、項目の表示順も使いやすいように入れ替えています。

完成版のデプロイボタン（押せます）

上記のボタンを押すと、１発でデプロイの画面に遷移することを確認いただけます。
認証画面が出ますので、お手持ちのサブスクリプションのアカウントで認証してください。

値が設定済みのため、そのままデプロイしても良いですし、可変させたい箇所を変更してから、デプロイすることもできます。

注意
残念ながら、そのまま実行すると、デプロイに失敗してしまいます。

このテンプレートは、あらかじめオンプレミスのドメインコントローラーへドメイン参加する仕組みになっています。
そのため、事前にドメイン環境の構築が必要です。
　
リソースグループ名、ドメイン名、仮想ネットワーク名は、オンコーディングされているため、環境に合わせてテンプレートを書き換えてください。
　
パスワードを同一サブスクリプション内の KeyVault から読み込むようになっています。

KeyVault を課題２で パスワード受け渡しの課題 で示された通りに事前作成していただくと、連動して動くようになります。
https://qiita.com/carol0226/items/36573dbc55d3e6559886

AVD のデプロイが終わったら、以下の記事を参考にアプリケーショングループにユーザーを割り当てる必要があります。割り当てられたユーザーを使って、AVD にリモートアクセスできるようになります。