演習 - リンクされた、および入れ子になった ARM テンプレートをデプロイする

10 分

Note

初めてサンドボックスをアクティブ化して利用規約に同意すると、Microsoft アカウントが Microsoft Learn サンドボックスという名前の新しい Azure ディレクトリに関連付けられます。あなたはコンシェルジェサブスクリプションという名前の特殊なサブスクリプションに追加されます。

ここでは、指定されたサンドボックス環境に、2 つのリンクされたテンプレートを含むテンプレートをデプロイします。

この演習では、Visual Studio Code 用 Azure Resource Manager ツールを使用します。この拡張機能を必ず Visual Studio Code にインストールしてください。

指定された Azure サンドボックスサブスクリプションを使用してテスト環境を設定する

このユニットで各デプロイを実行するには、Visual Studio Code ターミナルから Azure アカウントにサインインする必要があります。

サンドボックスをアクティブ化したのと同じアカウントにサインインしていることを確認してください。

Visual Studio Code のターミナルから次のコマンドを実行して、Azure にサインインします。このコマンドを実行すると、ブラウザーが開き、アカウントにサインインできます。
```
Connect-AzAccount
```
サインインすると、このアカウントに関連付けられているサブスクリプションの一覧がターミナルに表示されます。サンドボックスをアクティブにしている場合、このリストにコンシェルジェサブスクリプションが含まれています。
サブスクリプション ID を取得します。次のコマンドを実行すると、ご利用のサブスクリプションとその ID が、読みやすい表形式で一覧表示されます。サブスクリプション ID は 2 番目の列です。 Concierge Subscription を探し、2 番目の列をコピーします。これは、aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e のように表示されます。
```
Get-AzSubscription
```
アクティブなサブスクリプションをコンシェルジェサブスクリプションに変更します。必ず、{Your subscription ID} を、前のコマンドで取得したコンシェルジェサブスクリプションの ID に置き換えてください。
```
$context = Get-AzSubscription -SubscriptionId {Your subscription ID}
Set-AzContext $context
```

既定のリソースグループを設定する

次に、サンドボックスで自分用に作成したリソースグループを、既定のリソースグループとして設定する必要があります。この操作を実行するには、最初に、次のコマンドを使用してリソースグループを取得する必要があります。

Get-AzResourceGroup

このコマンドでは、前のコマンドから取得したリソースの名前を使用しますこれは、learn-a73131a1-b618-48b8-af70-21af7ca420c4 のように表示されます。このコマンドを使用すると、この演習の残りの Azure PowerShell コマンドでそのパラメーターを省略できます。

Note

通常、PowerShell または Azure CLI コマンドを使用してテンプレートをデプロイする場合、ターゲットのリソースグループ名を指定する必要があります。このモジュールの演習では、デプロイのコンテキストを設定すると、この要件をバイパスしています。次の手順では、PowerShell コマンド Set-AzDefault を使用してサンドボックスのリソースグループ名を指定しています。

Set-AzDefault -ResourceGroupName {Resource Group Name}

リンクされたテンプレートをデプロイする

この演習では、2 つのリンクされたテンプレートを含むテンプレートを確認してデプロイします。

リンクされたテンプレートを ARM テンプレートに追加するには、Microsoft.Resources/deployments リソースと、テンプレートの場所で構成された templateLink プロパティを追加します。

次のサンプルテンプレートでは、2 つの変数によって、GitHub リポジトリ内にあるリモートまたは外部テンプレートが定義されていることに注目してください。

テンプレートを確認し、リンクされたテンプレートのデプロイ先とデプロイ方法を定義する "type": "Microsoft.Resources/deployments" セクションに注意してください。

1 つ目のリンクされたテンプレートでは、ストレージアカウントをデプロイします。これは、親パラメーターを使用して、ストレージテンプレートをデプロイします。

2 つ目のリンクされたテンプレートは、ストレージのデプロイに依存し、仮想ネットワークテンプレートをデプロイするように構成されています。

{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
    "name": {
        "type": "string",
        "defaultValue": "linkeddemo001"
    }
},
"variables": {
    "linked-template": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json",
    "linked-template-2": "https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/what-if/what-if-before.json"
},
"resources": [
    {
        "name": "storage",
        "type": "Microsoft.Resources/deployments",
        "apiVersion": "2019-10-01",
        "properties": {
            "mode": "Incremental",
            "templateLink": {
                "uri": "[variables('linked-template')]",
                "contentVersion": "1.0.0.0"
            },
            "parameters": {
                "location": { "value": "[resourceGroup().location]" }
            }
        }
    },
    {
        "name": "identity",
        "type": "Microsoft.Resources/deployments",
        "apiVersion": "2019-10-01",
        "dependsOn": [
            "[resourceId('Microsoft.Resources/deployments','storage')]"
        ],
        "properties": {
            "mode": "Incremental",
            "templateLink": {
                "uri": "[variables('linked-template-2')]",
                "contentVersion": "1.0.0.0"
            }
        }
    }
],
"outputs": {}
}

上記のテンプレートの内容をコピーして、ローカルディレクトリ内のファイルに貼り付けます。たとえば、C:\JSON\linkedtemplate.json を使用します。
そのファイルをローカルに保存した後、次の PowerShell コマンドを使用して、前のユニットで説明したリソースグループレベルでそれをデプロイできます。つまり、New-AzResourceGroupDeployment を使用します。
```
    $templateFile="C:\JSON\linkedtemplate.json"
    $today=Get-Date -Format "MM-dd-yyyy"
    $DeploymentName="DeployLinkedTemplate-"+"$today"

    New-AzResourceGroupDeployment `
    -Name $DeploymentName `
    -TemplateFile $templateFile
```
完了すると、結果は次の例のようになります。
結果を検証します。
1. Azure portal にアクセスして、サンドボックスサブスクリプション内にいることを確認します。それには、ページの右上隅にある自分のアバターを選択します。 [ディレクトリの切り替え] を選択します。リストで、[Microsoft Learn サンドボックス] ディレクトリを選択します。
2. 左側のパネルで、[リソースグループ] を選択します。
3. [サンドボックスリソースグループ名] を選択します。
4. [概要] 領域に、デプロイが成功したことが表示されます。 [3 Succeeded] (3 件の成功) を選択して、デプロイの詳細を確認します (前のユニットの演習を実行したかどうかによって、完了したデプロイ数が多くなる場合があります)。
デプロイしたテンプレートは 1 つですが、portal の [デプロイ] ウィンドウには 3 つが一覧表示されていることに注目してください。これらの 3 つのデプロイは、メインテンプレートと 2 つのリンクされたテンプレートに対応します。

Visual Studio Code のターミナルから次のコマンドを実行して、Azure にサインインします。このコマンドを実行すると、ブラウザーが開き、アカウントにサインインできます。
```
az login
```
サインインすると、このアカウントに関連付けられているサブスクリプションの JSON リストがターミナルに表示されます。サンドボックスをアクティブにしている場合、このリストにコンシェルジェサブスクリプションが含まれています。
サブスクリプション ID を取得します。次のコマンドを実行すると、ご使用のサブスクリプションとその ID が一覧表示されます。サブスクリプション ID は 3 番目の列です。 Concierge Subscription を探し、3 番目の列をコピーします。これは、aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e のように表示されます。
```
az account list -o table
```
アクティブなサブスクリプションをコンシェルジェサブスクリプションに変更します。必ず、{Your subscription ID} を、前のコマンドで取得したコンシェルジェサブスクリプションの ID に置き換えてください。
```
az account set -s {Your subscription ID}
```

既定のリソースグループを設定する

az group list -o table

このコマンドでは、前のコマンドから取得したリソースグループの名前を使用します (これは、learn-a73131a1-b618-48b8-af70-21af7ca420c4 のように表示されます)。この既定値を設定すると、この演習の残りの Azure CLI コマンドからそのパラメータを省略できます。

Note

通常、Azure CLI コマンドを使用してテンプレートをデプロイするときは、ターゲットの "リソースグループ" 名を指定する必要があります。このモジュールの演習では、デプロイのコンテキストを設定すると、この要件をバイパスしています。次の手順では、Azure CLI コマンド az configure を使用してサンドボックスのリソースグループ名を指定しています。

az configure --defaults group={Resource Group Name}

リンクされたテンプレートをデプロイする

この演習では、2 つのリンクされたテンプレートを含むテンプレートを確認してデプロイします。

リンクされたテンプレートを ARM テンプレートに追加するには、Microsoft.Resources/deployments リソースと、テンプレートの場所で構成された templateLink プロパティを追加します。

2 つ目のリンクされたテンプレートは、ストレージのデプロイに依存し、仮想ネットワークテンプレートをデプロイするように構成されています。

{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
    "name": {
        "type": "string",
        "defaultValue": "linkeddemo001"
    }
},
"variables": {
    "linked-template": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json",
    "linked-template-2": "https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/what-if/what-if-before.json"
},
"resources": [
  {
      "name": "storage",
      "type": "Microsoft.Resources/deployments",
      "apiVersion": "2019-10-01",
      "properties": {
          "mode": "Incremental",
          "templateLink": {
              "uri": "[variables('linked-template')]",
              "contentVersion": "1.0.0.0"
          },
          "parameters": {
              "location": { "value": "[resourceGroup().location]" }
          }
      }
  },
  {
      "name": "identity",
      "type": "Microsoft.Resources/deployments",
      "apiVersion": "2019-10-01",
      "dependsOn": [
          "[resourceId('Microsoft.Resources/deployments','storage')]"
      ],
      "properties": {
          "mode": "Incremental",
          "templateLink": {
              "uri": "[variables('linked-template-2')]",
              "contentVersion": "1.0.0.0"
          }
      }
  }
],
"outputs": {}
}

上記のテンプレートの内容をコピーして、ローカルディレクトリ内のファイルに貼り付けます。たとえば、C:\JSON\linkedtemplate.json or /mnt/c/Users/you/json/linkedtemplate.json を使用します。

そのファイルをローカルに保存したら、次の Azure CLI コマンドを使用してリソースグループレベルでそのファイルをデプロイします。つまり、az deployment group create を使用します。

templateFile=/mnt/c/Users/<UserName>/json/linkedtemplate.json
today=$(date +"%Y-%m-%d")
deploymentname="DeployLocalTemplate-3-"$today

az deployment group create \
--name $deploymentname \
--template-file $templateFile

完了したら、結果は次の例のようになります。デプロイが成功したことを確実にするには、"provisioningState" の値を確認します。

{- Finished ..
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/learn-bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f/providers/Microsoft.Resources/deployments/DeployLocalTemplate-3-2020-08-19",
  "location": null,
  "name": "DeployLocalTemplate-3-2020-08-19",
  "properties": {
    "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
    "debugSetting": null,
    "dependencies": [
      {
        "dependsOn": [
          {
            "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/learn-bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f/providers/Microsoft.Resources/deployments/storage",
            "resourceGroup": "learn-bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
            "resourceName": "storage",
            "resourceType": "Microsoft.Resources/deployments"
          }
        ],
        "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/learn-bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f/providers/Microsoft.Resources/deployments/identity",
        "resourceGroup": "learn-bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "resourceName": "identity",
        "resourceType": "Microsoft.Resources/deployments"
      }
    ],
    "duration": "PT16.4639167S",
    "error": null,
    "mode": "Incremental",
    "onErrorDeployment": null,
    "outputResources": [
      {
        "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/learn-bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f/providers/Microsoft.Network/virtualNetworks/vnet-001",
        "resourceGroup": "learn-bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f"
      },
      {
        "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/learn-bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f/providers/Microsoft.Storage/storageAccounts/store7zk7eyqew54l4",
        "resourceGroup": "learn-bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f"
      }
    ],
    "outputs": {},
    "parameters": {
      "name": {
        "type": "String",
        "value": "linkeddemo001"
      }
    },
    "parametersLink": null,
    "providers": [
      {
        "id": null,
        "namespace": "Microsoft.Resources",
        "registrationPolicy": null,
        "registrationState": null,
        "resourceTypes": [
          {
            "aliases": null,
            "apiVersions": null,
            "capabilities": null,
            "locations": [
              null
            ],
            "properties": null,
            "resourceType": "deployments"
          }
        ]
      }
    ],
    "provisioningState": "Succeeded",
    "templateHash": "12700491000282730217",
    "templateLink": null,
    "timestamp": "2020-08-19T21:07:18.729310+00:00",
    "validatedResources": null
  },
  "resourceGroup": "learn-bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
  "tags": null,
  "type": "Microsoft.Resources/deployments"
}

結果を検証します。
1. Azure portal にアクセスして、サンドボックスサブスクリプション内にいることを確認します。それには、ページの右上隅にある自分のアバターを選択します。 [ディレクトリの切り替え] を選択します。リストで、[Microsoft Learn サンドボックス] ディレクトリを選択します。
2. 左側のパネルで、[リソースグループ] を選択します。
3. [サンドボックスリソースグループ名] を選択します。
4. [概要] 領域に、デプロイが成功したことが表示されます。 [3 Succeeded] (3 件の成功) を選択して、デプロイの詳細を確認します (前のユニットの演習を実行したかどうかによって、完了したデプロイ数が多くなる場合があります)。
デプロイしたテンプレートは 1 つですが、portal の [デプロイ] ウィンドウには 3 つが一覧表示されていることに注目してください。これらの 3 つのデプロイは、メインテンプレートと 2 つのリンクされたテンプレートに対応します。

演習 - リンクされた、および入れ子になった ARM テンプレートをデプロイする

指定された Azure サンドボックス サブスクリプションを使用してテスト環境を設定する

Azure にサインインする

既定のリソース グループを設定する

リンクされたテンプレートをデプロイする

Azure へのサインイン

既定のリソース グループを設定する

リンクされたテンプレートをデプロイする

フィードバック

指定された Azure サンドボックスサブスクリプションを使用してテスト環境を設定する

既定のリソースグループを設定する

既定のリソースグループを設定する