Azure Verified Modulesで進めるインフラ標準化②:同じVMとVPNを2方式で作って比べる

連載:Azure Verified Modulesで進めるインフラ標準化・第2回 | 連載のまとめ

AzureでCIを始めると、なぜBicepを書き、Azure Verified Modulesを使うのかの「別のチームにも同じ環境を渡せるか」を確かめるため、2026年11月6日に、Linux仮想マシン(以下、VM)とVPNをBicepの直接定義とAzure Verified Modules(以下、AVM)の2方式で作りました。main.bicepは237行から128行になり、両方式でVPN経由のSSH接続に成功しました。ここでは、どの記述が減り、展開後にどんな違いが残ったかを追います。Bicepの入門は参考資料[1]です。[1]

先に「同じ構成」の条件を決める

仮想マシンにパブリックIPを付けず、Windows Subsystem for Linux 2(以下、WSL2)からPoint-to-Site VPNを通ってVMのプライベートIPへSSHします。Azure Virtual Network(以下、VNet)にGateway用とVM用のサブネットを置き、Network Security Group(以下、NSG)にVPNクライアントの範囲からTCP 22を許可するルールを追加しました。既定のVNet内許可も残しているため、図は今回の接続経路を示します。[2]

WSL2からP2S VPNでGatewayへ接続しVM用サブネットのプライベートIPへSSHする経路
図1:WSL2からの接続経路。NSGの既定ルールと、図以外の通信経路は省略しています。クリックすると拡大できます。
条件 今回の設定
リージョン・VM 東日本、Ubuntu 24.04 LTS、Standard_B2s、ゾーン指定なし
Gateway VpnGw1AZ、Active-Passive、BGPなし
11月6日の接続 strongSwan 6.0.4でIKEv2、VMへSSH公開鍵認証
実行ツール Azure CLI 2.91.0、Bicep CLI 0.48.1
AVMの参照 VNet 0.10.2、NSG 0.5.4、Gateway 0.12.0、VM 0.22.3

直接定義側のAPIバージョンと設定は、AVM版の出力に合わせました。行数はこの条件で必要だった記述量で、作業時間や工数の削減率を測った値ではありません。後に払い出し用のタグを追加した版の行数とも区別しています。

Gatewayのどの記述を任せられたか

Bicepの直接定義版

直接定義版では、パブリックIPを作り、そのIDとサブネットのIDをGatewayの設定で結びます。次は、その参照部分の抜粋です。周辺のリソース宣言は省いています。

ipConfigurations: [
  {
    name: 'vNetGatewayConfig1'
    properties: {
      privateIPAllocationMethod: 'Dynamic'
      subnet: {
        id: vnet::gatewaySubnet.id
      }
      publicIPAddress: {
        id: vpnGatewayPip.id
      }
    }
  }
]

AVM版

比較検証で使ったavm/main.bicepから、Gatewayモジュールの呼び出しを抜粋します。VNetや変数の宣言は省いています。

module vpnGateway 'br/public:avm/res/network/virtual-network-gateway:0.12.0' = {
  params: {
    name: 'vpng-${workloadName}'
    location: location
    gatewayType: 'Vpn'
    skuName: 'VpnGw1AZ'
    clusterSettings: {
      clusterMode: 'activePassiveNoBgp'
    }
    virtualNetworkResourceId: vnet.outputs.resourceId
    vpnClientAddressPoolPrefix: vpnClientAddressPoolPrefix
    clientRootCertData: vpnRootCertData
  }
}

AVM版ではvirtualNetworkResourceIdにVNetのIDを渡すと、モジュールがGateway用のサブネットを参照し、パブリックIPを作成してGatewayに関連付けます。SKUやVPNクライアントのアドレス範囲、認証に使うルート証明書の公開部分は、呼び出し側から渡します。

VMでも、ネットワークインターフェイスの定義がモジュールの内側へ移りました。NSGに書く通信ルールは利用側で決めるため、記述量はほとんど変わりませんでした。

直接定義237行とAVM128行を対比しPublic IPやNICの定義がモジュール内部へ移ることを示す
図2:比較時点の記述量と任せた実装。直接定義版はAVMの出力へ合わせています。クリックすると拡大できます。
main.bicepの比較 直接定義版 AVM版
全行 237行 128行
空行とコメントを除く 218行 115行
ビルド後のARMテンプレート 約6KB 約455KB
デプロイ履歴 1件 14件(ルート1、入れ子9、テレメトリ4)
デプロイ時間(各1回) 22分33秒 22分13秒

呼び出し元の記述は減りましたが、展開される定義と履歴は増えました。障害調査では入れ子のどこで止まったかを追います。テレメトリはenableTelemetryで無効化でき、今回は有効でした。時間の大半はGatewayの作成で、各1回の記録から方式ごとの速度差は判断できません。[4]

短くなったコードで、見えにくくなった設定を調べる

VMのゾーンはavailabilityZone: -1、高速ネットワークはenableAcceleratedNetworking: falseと指定しました。前者はゾーンを指定しないという入力で、後者は利用する小規模VMに合わせた上書きです。高速ネットワークを有効のまま展開して失敗させる試験はしていません。

Gateway 0.12.0で証明書認証を使う今回の構成では、P2Sプロトコルを入力で明示できませんでした。展開後の状態にはIkeV2とOpenVPNの両方があり、11月6日はIKEv2、11月8日はAVM構成でOpenVPN 2.7.0からSSHまでを確認しました。設定にプロトコルが現れたことと、それで実際に接続できたことを分けて記録しました。

展開予測、実際の状態、接続を順に照合する

スナップショットから実リソース比較を経てVPNとSSHの実操作へ進む検証順序
図3:展開予測、実状態、利用動作の順に確認。比較の除外条件と残した差を区別します。クリックすると拡大できます。
確認段階 確認したこと
展開前 az bicep snapshotで予測を保存。名前・サブネットの表現などを揃えると8リソースに差分なし。既定値と同等と見込む15項目、未解決の式1項目は別に記録
展開後 実行ごとに変わるIP、GUID、作成日時などを除き、取得した8ファイルを比較。3ファイルに計5項目の差が残った
利用時 両方式でIKEv2トンネルを確立し、VMへSSH。パスワード認証が無効であることも確認

残った差は、NSGのflushConnectionとルールのdescription、VMのhibernationEnabledとultraSSDEnabled、GatewayのenableDnsForwardingです。直接定義版にはプロパティがなく、AVM版にはfalseまたは空文字が入りました。接続要件は両方式で満たしましたが、保存状態は完全には一致していません。展開予測の調査にはBicep MCP Serverも利用し、比較用のスナップショットはBicep CLIで保存しました。[3]

これで、構成を組む側が毎回書いていたGatewayとVMの関連定義を任せても、今回の接続要件を満たせると分かりました。次に、このAVM構成を利用者へ渡す処理の中から呼び出しました。

参考資料

外部資料の確認日:2026年11月9日。比較検証は2026年11月6日、OpenVPNの追加確認は11月8日です。本文の数値とコードは筆者の検証記録に基づきます。

  1. Bicepとは(Microsoft Learn):言語の概要と入門。
  2. Network security groups(Microsoft Learn):ルールの優先度と既定動作。
  3. Bicep MCP server(Microsoft Learn):展開予測などのツール。
  4. Telemetry(Azure Verified Modules公式):目的と無効化の設定。