チュートリアル:ARM テンプレートにリソースを追加する

[アーティクル]
06/20/2024

前のチュートリアルでは、空の Azure Resource Manager テンプレート (ARM テンプレート) を初めて作成してデプロイする方法について説明しました。これで、そのテンプレートに実際にリソースをデプロイすることができます。この場合は、Azure ストレージアカウントです。このチュートリアルを完了するには 9 分かかります。

前提条件

必須ではありませんが、テンプレートに関する入門チュートリアルを済ませておくことをお勧めします。

Visual Studio Code をインストールし、Azure Resource Manager ツールの拡張機能、Azure PowerShell または Azure コマンドラインインターフェイス (CLI) のいずれかを使用する必要があります。詳細については、テンプレートのツールに関する記事を参照してください。

リソースの追加

既存のテンプレートに Azure ストレージアカウントの定義を追加するには、次の例で強調表示されている JSON ファイルをご覧ください。テンプレートの一部をコピーするのではなく、ファイル全体をコピーして、既存のテンプレートの内容を置き換えてください。

{provide-unique-name} と中かっこ {} を一意のストレージアカウント名に置き換えます。

重要

ストレージアカウント名は Azure 内で一意である必要があります。小文字または数字のみで、24 文字の制限があります。 store1 のような名前をプレフィックスとして使用してから、自分のイニシャルと今日の日付を追加できます。たとえば、store1abc06132022 のような名前にすることができます。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-09-01",
      "name": "{provide-unique-name}",
      "location": "eastus",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

ストレージアカウントの一意の名前を考えるのは容易ではなく、大規模なデプロイの自動化ではうまくいきません。このチュートリアルシリーズで後ほど、一意の名前の作成を容易にするテンプレート機能を使用します。

リソースのプロパティ

リソースの種類ごとに使用するプロパティをどうやって見つければよいのか、悩む方もいるかもしれません。デプロイするリソースの種類を見つけるには、ARM テンプレートリファレンスをご利用ください。

デプロイするすべてのリソースには、少なくとも次の 3 つのプロパティがあります。

type: リソースの種類。この値は、リソースプロバイダーの名前空間とリソースの種類を組み合わせたものです (例: Microsoft.Storage/storageAccounts)。
apiVersion: リソースの作成に使用する REST API バージョン。リソースプロバイダーからは、それぞれ独自の API バージョンが公開されているため、これはその種類に固有の値となります。
name:リソースの名前。

ほとんどのリソースには、リソースのデプロイ先リージョンを設定する location プロパティもあります。

その他のプロパティは、リソースの種類と API バージョンにより異なります。 API バージョンと利用可能なプロパティの関係を理解することが大切ですので、もう少し踏み込んでみましょう。

このチュートリアルでは、テンプレートにストレージアカウントを追加します。ストレージアカウントの API バージョンは、storageAccounts 2021-09-01 で確認できます。すべてのプロパティをテンプレートに追加したわけではないことに注目してください。プロパティの多くは省略可能です。 Microsoft.Storage リソースプロバイダーから新しい API バージョンがリリースされる可能性もありますが、デプロイするバージョンを変更する必要はありません。そのバージョンを使い続けることができ、またデプロイの結果に一貫性を確保できます。

以前の API バージョンを表示した場合、利用できるプロパティが少ないことがわかります。

リソースの API バージョンを変更することにした場合は、そのバージョンのプロパティを評価したうえで、適宜テンプレートを調整してください。

テンプレートのデプロイ

テンプレートをデプロイしてストレージアカウントを作成できます。履歴内で見つけやすいよう、実際のデプロイには別の名前を付けてください。

まだリソースグループを作成していない場合は、「リソースグループの作成」を参照してください。この例では、templateFile 変数にテンプレートファイルのパスが設定済みであることを想定しています (1 つ目のチュートリアルを参照)。

PowerShell
Azure CLI

New-AzResourceGroupDeployment `
  -Name addstorage `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

このデプロイコマンドを実行するには、最新バージョンの Azure CLI が必要です。

az deployment group create \
  --name addstorage \
  --resource-group myResourceGroup \
  --template-file $templateFile

Note

デプロイに失敗した場合は、verbose スイッチを使用して、作成しているリソースに関する情報を取得します。デバッグの詳細については、debug スイッチを使用してください。

これらのエラーは、発生する可能性のある 2 つのデプロイエラーです。

Error: Code=AccountNameInvalid; Message={provide-unique-name} は、有効なストレージアカウント名ではありません。ストレージアカウント名の長さは 3 - 24 文字で、使用できるのは数字と小文字のみです。

テンプレート内の {provide-unique-name} は、一意のストレージアカウント名に置き換えてください。「リソースの追加」を参照してください。
Error: Code=StorageAccountAlreadyTaken; Message=The storage account named store1abc09092019 は既に使用されています。

テンプレート内で、別のストレージアカウント名を試してみてください。

ストレージアカウントを作成しているため、このデプロイには空のテンプレートのデプロイよりも時間がかかります。完了までに約 1 分かかります。

デプロイの確認

Azure portal からリソースグループを探すことでデプロイを確認できます。

Azure portal にサインインします。
左側のメニューから [リソースグループ] を選択します。
myResourceGroup の左側にあるチェックボックスをオンにし、[myResourceGroup] を選びます
デプロイ先のリソースグループを選択します。
ストレージアカウントがデプロイされていることがわかります。
デプロイラベルに "Deployments: 2 Succeeded (デプロイ: 2 件成功) " と表示されていることに注目してください。

リソースをクリーンアップする

次のチュートリアルに移動する場合は、リソースグループを削除する必要はありません。

ここで終了する場合は、リソースグループを削除して、デプロイ済みのリソースをクリーンアップしましょう。

Azure portal で、左側のメニューから [リソースグループ] を選択します。
[任意のフィールドのフィルター] ボックスにリソースグループ名を入力します。
myResourceGroup の横にあるチェックボックスをオンにし、[myResourceGroup] または選んだリソースグループ名を選びます。
トップメニューから [リソースグループの削除] を選択します。

次のステップ

Azure ストレージアカウントをデプロイする簡単なテンプレートを作成しました。後続のチュートリアルでは、パラメーター、変数、リソース、出力をテンプレートに追加する方法について説明します。それらの機能は、はるかに複雑なテンプレートの構成要素となります。

パラメーターを追加する

次の方法で共有