AzureのARMテンプレートをPowerShellからデプロイする手順をご紹介

＜目次＞

(１) AzureのARMテンプレートをPowerShellからデプロイする手順をご紹介
　(１-１) Azure Resouce Managerとは？
　(１-２) ARMテンプレートとは？
　(１-３) ARMテンプレートをデプロイするためのツール準備（Azure PowerShell）
　(１-４) ARMテンプレートをデプロイする手順
　(１-５) ARMテンプレートの作成を補助するツール等

(１) AzureのARMテンプレートをPowerShellからデプロイする手順をご紹介

Azureではリソースを作成する際に「ARMテンプレート」を使う事で、画面からオペレーションする事なく、素早く大量にリソースを作成する事が可能になります。

(１-１) Azure Resouce Managerとは？

「Azure Resouce Manager」（以降「ARM」と記述）はAzureのリソースを集中管理するためのサービスです。

(１-２) ARMテンプレートとは？

冒頭でも少し触れましたが「ARMテンプレート」はリソースを作成する際に事前に用意した「テンプレート」を使う事で、画面操作をする事なく、素早く大量にリソースを作成できる機能になります。

「ARMテンプレート」はJSON形式で表現されており、以下のような構成のイメージです。

（例）

{
  "$schema":"https://schema.management.azure.com/schemas/YYYY-MM-DD/deploymentTemplate.json#",
  "contentVersion":"1.0.0.0",
  "parameters":{},
  "variables":{},
  "resouces":[
    {
      /* リソース1の定義（例：仮想マシン）  */
    },
    {
      /* リソース2の定義（例：ストレージ） */    
    },
    {
      /* リソース3の定義（例：AppService */    
    },
    /* ～中略～ */
    {
      /* リソースNの定義 */
    }    
  ],
  "outputs":{},
  "functions":[]
}

以下はVisual Studioで作成した空のARMテンプレートの例です。

（図１２１）空のテンプレートの例

●テンプレートの各項目について

テンプレートに記載する内容（項目）は作りたいリソースの種類（仮想マシン、ストレージ、仮想ネットワークなど）によって当然異なってきますが、いくつかの必須項目もあり、どのテンプレートにも共通する項目としては次のようなものがあります。

（表）

＞目次にもどる

(１-３) ARMテンプレートをデプロイするためのツール準備（Azure PowerShell）

今回のデプロイはご自身のクライアント端末に入っているPowerShellから行いますが、そのためにはAzure用のモジュール（Azure PowerShellの「Az」モジュール）を予めインストールしておく必要があります。

(１-４) ARMテンプレートをデプロイする手順

Power Shellの準備が出来たら、いよいよ実際のテンプレートを作って、それをデプロイする手順に入ります。

●STEP1：ARMテンプレートを準備

ARMテンプレートは上記でご紹介した基本の雛形に追記をしていきます。今回の例では「ストレージアカウント」を作成しますので、以下の内容を追記します。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {},
  "variables": {},
  "resources": [
    {
      "name":"rainbowstorageaccount1"
      "type":"Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-01-01",
      "location":"[resouceGroup().location]",
      "sku": {
        "name": "Standard_RAGRS",
        "tier": "Standard"
      },
      "kind":"StorageV2"
      "properties":{
        "accessTier":"Hot"
      }
    }
  ],
  "outputs":{},
  "functions":[]
}

●STEP2：デプロイを実行するPowerShellコマンドレットの準備

# リージョンの変数を定義
$location = 'japaneast'
# リソースグループの変数を定義
$rgName = 'RainbowResourceGroup2'
# リソースグループを作成（引数にリージョンとリソースを付与）
New-AzResouceGroup -Name $rgName -Location $location

# リソースのデプロイ
New-AzResouceGroupDeployment `
 -Name ‘create-new-storage’ `
 -ResouceGroupName $rgName `
 -TemplateFile C:\Temp\Azure\Storage\StorageBasic\template.json `
 -TemplateParameterFile C:\Temp\Azure\Storage\StorageBasic\parameters.json `

●STEP3：Azure PowerShellを開いてログイン

・検索窓から「PowerShell」を検索して開きます。

（図１３３）

・Azureにログイン

 

「Connect-AzAccount」コマンドレットを実行するとAzureの認証（ログイン）用のウィンドウが開くので、ログインをします。

（コマンド）

> Connect-AzAccount

（図１３４）①

（図１３４）②：認証成功

●STEP4：準備したPowerShellの実行

いよいよ、先ほど準備したPowerShellを実行します。

（図１３５）

環境にもよりますが、リソースグループは一瞬で作成が完了し、ストレージは私の環境では30秒程度でしたでしょうか？

実際の操作動画をご紹介します。

 

（操作動画）

●STEP5：結果確認

最後にAzure Portalにて実際に作成されたリソース（ストレージアカウント）を確認します。

（図１３６）PowerShellから作成したリソースが正常に作成されている

＞目次にもどる

(１-５) ARMテンプレートの作成を補助するツール等

ここまで読んで頂いた方は、「ARMテンプレートに書く内容ってどうやったら分かるの？」とか「素早くテンプレートを作成する方法はあるか？」といった様々な疑問を持たれたかも知れません。 以下、Tipsを２つほどご紹介します。

●①テンプレートの記載内容の確認方法

・リソースの左メニューから「テンプレートのエクスポート」ブレードを選択
（図１５１）

・上段メニューから「ダウンロード」や「デプロイ」といった操作が可能です。
（図１５２）

●②テンプレートを素早く作成する方法

Visual Studio CodeのAzure Resouce Manager(ARM) Toolsを使うと、テンプレートを素早く作成する事ができます。

https://marketplace.visualstudio.com/items?itemName=msazurermtools.azurerm-vscode-tools

（図１５３）

＞目次にもどる