ARM テンプレートを使用してCloud Services (延長サポート) をデプロイする

[アーティクル]
07/29/2024

この記事では、Azure Resource Manager テンプレート (ARM テンプレート) を使用して、Azure Cloud Services (延長サポート) のデプロイを作成する方法について説明します。

前提条件

ARM テンプレートを使用してデプロイを作成するための前提条件として、次の手順を完了します。

Cloud Services (延長サポート) のデプロイの前提条件を確認し、必要なリソースを作成します。
Azure portal または Azure PowerShell を使用して、新しいリソースグループを作成します。既存のリソースグループを使用する場合は、この手順は省略可能です。
Azure portal または Azure PowerShell を使用して、新しいストレージアカウントを作成します。既存のストレージアカウントを使用する場合は、この手順は省略可能です。
パッケージ (.cspkg または .zip) ファイルと構成 (.cxcfg) ファイルを、Azure portal または Azure PowerShell を使用してストレージアカウントにアップロードします。後のステップで ARM テンプレートに追加するために、両方のファイルの Shared Access Signature (SAS) を保存します。
(省略可能) キーコンテナーを作成し、証明書をアップロードします。
- サービスとの間で安全な通信を行うために、デプロイに証明書をアタッチできます。証明書を使用する場合は、証明書の拇印を構成 (.cscfg) ファイルで指定し、キーコンテナーにアップロードする必要があります。 Azure portal または Azure PowerShell を使用してキーコンテナーを作成できます。
- 関連付けられているキーコンテナーは、Cloud Services (延長サポート) のデプロイと同じリージョンとサブスクリプションに配置する必要があります。
- Cloud Services (延長サポート) リソースがキーコンテナーから証明書を取得できるようにするには、関連するキーコンテナーに適切なアクセス許可が必要です。詳細については、「Cloud Services (延長サポート) で証明書を使用する」を参照してください。
- 後の手順で示すように、キーコンテナーは ARM テンプレートの osProfile セクションで参照する必要があります。

Cloud Services (延長サポート) をデプロイする

テンプレートを使用して Cloud Services (延長サポート) をデプロイする方法を次に示します。

Note

ARM テンプレートとパラメーターファイルを簡単かつ迅速に生成するには、Azure ポータルを使用します。 portal で生成された ARM テンプレートをダウンロードすると、Azure PowerShell を使用して Cloud Services (延長サポート) を作成できます。

仮想ネットワークを作成します。仮想ネットワークの名前は、サービス構成 (.cscfg) ファイル内の仮想ネットワーク参照と一致している必要があります。既存の仮想ネットワークを使用する場合は、ARM テンプレートからこのセクションを削除してください。

"resources": [ 
    { 
      "apiVersion": "2019-08-01", 
      "type": "Microsoft.Network/virtualNetworks", 
      "name": "[parameters('vnetName')]", 
      "location": "[parameters('location')]", 
      "properties": { 
        "addressSpace": { 
          "addressPrefixes": [ 
            "10.0.0.0/16" 
          ] 
        }, 
        "subnets": [ 
          { 
            "name": "WebTier", 
            "properties": { 
              "addressPrefix": "10.0.0.0/24" 
            } 
          } 
        ] 
      } 
    } 
]

新しい仮想ネットワークを作成する場合は、次の行を dependsOn セクションに追加して、プラットフォームが Cloud Services (延長サポート) インスタンスを作成する前に、仮想ネットワークを作成するようにします。

"dependsOn": [ 
        "[concat('Microsoft.Network/virtualNetworks/', parameters('vnetName'))]" 
 ]

パブリック IP アドレスを作成し、(必要に応じて) そのパブリック IP アドレスの DNS ラベルプロパティを設定します。静的 IP アドレスを使用する場合は、構成ファイル (.cscfg) で予約済み IP アドレスとして参照する必要があります。既存の IP アドレスを使用する場合は、この手順をスキップし、ARM テンプレートのロードバランサーの構成設定に IP アドレスの情報を直接追加します。
```
"resources": [ 
    { 
      "apiVersion": "2019-08-01", 
      "type": "Microsoft.Network/publicIPAddresses", 
      "name": "[parameters('publicIPName')]", 
      "location": "[parameters('location')]", 
      "properties": { 
        "publicIPAllocationMethod": "Dynamic", 
        "idleTimeoutInMinutes": 10, 
        "publicIPAddressVersion": "IPv4", 
        "dnsSettings": { 
          "domainNameLabel": "[variables('dnsName')]" 
        } 
      }, 
      "sku": { 
        "name": "Basic" 
      } 
    } 
] 
```
新しい IP アドレスを作成する場合は、次の行を dependsOn セクションに追加して、プラットフォームが Cloud Services (延長サポート) インスタンスを作成する前にその IP アドレスを作成するようにします。
```
"dependsOn": [ 
        "[concat('Microsoft.Network/publicIPAddresses/', parameters('publicIPName'))]" 
      ] 
```

Cloud Services (延長サポート) オブジェクトを作成します。テンプレートに仮想ネットワークまたはパブリック IP アドレスをデプロイする場合は、適切な dependsOn 参照を追加します。

{
  "apiVersion": "2021-03-01",
  "type": "Microsoft.Compute/cloudServices",
  "name": "[variables('cloudServiceName')]",
  "location": "[parameters('location')]",
  "tags": {
    "DeploymentLabel": "[parameters('deploymentLabel')]",
    "DeployFromVisualStudio": "true"
  },
  "dependsOn": [
    "[concat('Microsoft.Network/virtualNetworks/', parameters('vnetName'))]",
    "[concat('Microsoft.Network/publicIPAddresses/', parameters('publicIPName'))]"
  ],
  "properties": {
    "packageUrl": "[parameters('packageSasUri')]",
    "configurationUrl": "[parameters('configurationSasUri')]",
    "upgradeMode": "[parameters('upgradeMode')]"
  }
}

デプロイにネットワークプロファイルオブジェクトを作成し、パブリック IP アドレスをロードバランサーのフロントエンドに関連付けます。 Azure プラットフォームでは、ロードバランサーが自動的に作成されます。

"networkProfile": { 
    "loadBalancerConfigurations": [ 
      { 
        "id": "[concat(variables('resourcePrefix'), 'Microsoft.Network/loadBalancers/', variables('lbName'))]", 
        "name": "[variables('lbName')]", 
        "properties": { 
          "frontendIPConfigurations": [ 
            { 
              "name": "[variables('lbFEName')]", 
              "properties": { 
                "publicIPAddress": { 
                  "id": "[concat(variables('resourcePrefix'), 'Microsoft.Network/publicIPAddresses/', parameters('publicIPName'))]" 
                } 
              } 
            } 
          ] 
        } 
      } 
    ] 
  }

ARM テンプレートの osProfile セクションに、キーコンテナーの参照を追加します。キーコンテナーには、Cloud Services (延長サポート) に関連付けられている証明書が格納されます。証明書をキーコンテナーに追加してから、サービス構成 (.cscfg) ファイルで証明書の拇印を参照します。また、Azure portal で デプロイ用 Azure 仮想マシンのキーコンテナーアクセスポリシーを、Cloud Services (延長サポート) リソースがキーコンテナー内のシークレットとして保管されている証明書を取得できるように設定します。このキーコンテナーは、Cloud Services (延長サポート) と同じリージョンおよびサブスクリプションに配置し、一意の名前を持っている必要があります。詳細については、「Cloud Services (延長サポート) で証明書を使用する」を参照してください。
```
"osProfile": { 
      "secrets": [ 
        { 
          "sourceVault": { 
            "id": "/subscriptions/{subscription-id}/resourceGroups/{resource-group}/providers/Microsoft.KeyVault/vaults/{keyvault-name}" 
          }, 
          "vaultCertificates": [ 
            { 
              "certificateUrl": "https://{keyvault-name}.vault.azure.net:443/secrets/ContosoCertificate/{secret-id}" 
            } 
          ] 
        } 
      ] 
    } 
```
Note

 ARM テンプレートの sourceVault は、キーコンテナーのリソース ID の値です。この情報を取得するには、キーコンテナーの [プロパティ] セクションで リソース ID を確認します。
- certificateUrl の値を取得するには、Secret Identifier というラベルが付いたキーコンテナー内の証明書に移動します。 
- certificateUrl の形式は https://{keyvault-endpoint}/secrets/{secret-name}/{secret-id} である必要があります。

ロールプロファイルを作成します。ロールの数、各ロール内のインスタンス数、ロールの名前、ロールのサイズが、構成 (.cscfg) ファイル、定義 (.csdef) ファイル、ARM テンプレートの roleProfile セクションですべて同じであることを確認します。

"roleProfile": {
  "roles": {
    "value": [
      {
        "name": "WebRole1",
        "sku": {
          "name": "Standard_D1_v2",
          "capacity": "1"
        }
      },
      {
        "name": "WorkerRole1",
        "sku": {
          "name": "Standard_D1_v2",
          "capacity": "1"
        } 
      } 
    ]
  }
}

(省略可能) 拡張機能プロファイルを作成して、Cloud Services (延長サポート) デプロイに追加します。次の例では、リモートデスクトッププロトコル (RDP) 拡張機能と Azure Diagnostics 拡張機能を追加します。

Note

RDP のパスワードは 8 から 123 文字であり、次のパスワードの複雑さの要件のうち、3 件以上を満たす必要があります。

大文字を含む。
小文字を含む。
数字を含む。
特殊文字が含まれている
コントロール文字を含めることはできません。

    "extensionProfile": {
      "extensions": [
        {
          "name": "RDPExtension",
          "properties": {
            "autoUpgradeMinorVersion": true,
            "publisher": "Microsoft.Windows.Azure.Extensions",
            "type": "RDP",
            "typeHandlerVersion": "1.2.1",
            "settings": "<PublicConfig>\r\n <UserName>[Insert Username]</UserName>\r\n <Expiration>1/21/2022 12:00:00 AM</Expiration>\r\n</PublicConfig>",
            "protectedSettings": "<PrivateConfig>\r\n <Password>[Insert Password]</Password>\r\n</PrivateConfig>"
          }
        },
        {
          "name": "Microsoft.Insights.VMDiagnosticsSettings_WebRole1",
          "properties": {
            "autoUpgradeMinorVersion": true,
            "publisher": "Microsoft.Azure.Diagnostics",
            "type": "PaaSDiagnostics",
            "typeHandlerVersion": "1.5",
            "settings": "[parameters('wadPublicConfig_WebRole1')]",
            "protectedSettings": "[parameters('wadPrivateConfig_WebRole1')]",
            "rolesAppliedTo": [
              "WebRole1"
            ]
          }
        }
      ]
    }

テンプレート全体を確認します。

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "cloudServiceName": {
      "type": "string",
      "metadata": {
        "description": "Name of the cloud service"
      }
    },
    "location": {
      "type": "string",
      "metadata": {
        "description": "Location of the cloud service"
      }
    },
    "deploymentLabel": {
      "type": "string",
      "metadata": {
        "description": "Label of the deployment"
      }
    },
    "packageSasUri": {
      "type": "securestring",
      "metadata": {
        "description": "SAS URI of the package (.cspkg) file to deploy"
      }
    },
    "configurationSasUri": {
      "type": "securestring",
      "metadata": {
        "description": "SAS URI of the configuration (.cscfg) file"
      }
    },
    "roles": {
      "type": "array",
      "metadata": {
        "description": "Roles created in the cloud service application"
      }
    },
    "wadPublicConfig_WebRole1": {
      "type": "string",
      "metadata": {
         "description": "Public configuration of the Azure Diagnostics extension"
      }
    },
    "wadPrivateConfig_WebRole1": {
      "type": "securestring",
      "metadata": {
        "description": "Private configuration of the Azure Diagnostics extension"
      }
    },
    "vnetName": {
      "type": "string",
      "defaultValue": "[concat(parameters('cloudServiceName'), 'VNet')]",
      "metadata": {
        "description": "Name of vitual network"
      }
    },
    "publicIPName": {
      "type": "string",
      "defaultValue": "contosocsIP",
      "metadata": {
        "description": "Name of public IP address"
      }
    },
    "upgradeMode": {
      "type": "string",
      "defaultValue": "Auto",
      "metadata": {
        "UpgradeMode": "UpgradeMode of the CloudService"
      }
    }
  },
  "variables": {
    "cloudServiceName": "[parameters('cloudServiceName')]",
    "subscriptionID": "[subscription().subscriptionId]",
    "dnsName": "[variables('cloudServiceName')]",
    "lbName": "[concat(variables('cloudServiceName'), 'LB')]",
    "lbFEName": "[concat(variables('cloudServiceName'), 'LBFE')]",
    "resourcePrefix": "[concat('/subscriptions/', variables('subscriptionID'), '/resourceGroups/', resourceGroup().name, '/providers/')]"
  },
  "resources": [
    {
      "apiVersion": "2019-08-01",
      "type": "Microsoft.Network/virtualNetworks",
      "name": "[parameters('vnetName')]",
      "location": "[parameters('location')]",
      "properties": {
        "addressSpace": {
          "addressPrefixes": [
            "10.0.0.0/16"
          ]
        },
        "subnets": [
          {
            "name": "WebTier",
            "properties": {
              "addressPrefix": "10.0.0.0/24"
            }
          }
        ]
      }
    },
    {
      "apiVersion": "2019-08-01",
      "type": "Microsoft.Network/publicIPAddresses",
      "name": "[parameters('publicIPName')]",
      "location": "[parameters('location')]",
      "properties": {
        "publicIPAllocationMethod": "Dynamic",
        "idleTimeoutInMinutes": 10,
        "publicIPAddressVersion": "IPv4",
        "dnsSettings": {
          "domainNameLabel": "[variables('dnsName')]"
        }
      },
      "sku": {
        "name": "Basic"
      }
    },
    {
      "apiVersion": "2021-03-01",
      "type": "Microsoft.Compute/cloudServices",
      "name": "[variables('cloudServiceName')]",
      "location": "[parameters('location')]",
      "tags": {
        "DeploymentLabel": "[parameters('deploymentLabel')]",
        "DeployFromVisualStudio": "true"
      },
      "dependsOn": [
        "[concat('Microsoft.Network/virtualNetworks/', parameters('vnetName'))]",
        "[concat('Microsoft.Network/publicIPAddresses/', parameters('publicIPName'))]"
      ],
      "properties": {
        "packageUrl": "[parameters('packageSasUri')]",
        "configurationUrl": "[parameters('configurationSasUri')]",
        "upgradeMode": "[parameters('upgradeMode')]",
        "roleProfile": {
          "roles": [
            {
              "name": "WebRole1",
              "sku": {
                "name": "Standard_D1_v2",
                "capacity": "1"
              }
            },
            {
              "name": "WorkerRole1",
              "sku": {
                "name": "Standard_D1_v2",
                "capacity": "1"
              }
            }
          ]
        },
        "networkProfile": {
          "loadBalancerConfigurations": [
            {
              "id": "[concat(variables('resourcePrefix'), 'Microsoft.Network/loadBalancers/', variables('lbName'))]",
              "name": "[variables('lbName')]",
              "properties": {
                "frontendIPConfigurations": [
                  {
                    "name": "[variables('lbFEName')]",
                    "properties": {
                      "publicIPAddress": {
                        "id": "[concat(variables('resourcePrefix'), 'Microsoft.Network/publicIPAddresses/', parameters('publicIPName'))]"
                      }
                    }
                  }
                ]
              }
            }
          ]
        },
        "osProfile": {
          "secrets": [
            {
              "sourceVault": {
                "id": "/subscriptions/{subscription-id}/resourceGroups/{resource-group}/providers/Microsoft.KeyVault/vaults/{keyvault-name}"
              },
              "vaultCertificates": [
                {
                  "certificateUrl": "https://{keyvault-name}.vault.azure.net:443/secrets/ContosoCertificate/{secret-id}"
                }
              ]
            }
          ]
        },
        "extensionProfile": {
          "extensions": [
            {
              "name": "RDPExtension",
              "properties": {
                "autoUpgradeMinorVersion": true,
                "publisher": "Microsoft.Windows.Azure.Extensions",
                "type": "RDP",
                "typeHandlerVersion": "1.2.1",
                "settings": "<PublicConfig>\r\n <UserName>[Insert Username]</UserName>\r\n <Expiration>1/21/2022 12:00:00 AM</Expiration>\r\n</PublicConfig>",
                "protectedSettings": "<PrivateConfig>\r\n <Password>[Insert Password]</Password>\r\n</PrivateConfig>"
              }
            },
            {
              "name": "Microsoft.Insights.VMDiagnosticsSettings_WebRole1",
              "properties": {
                "autoUpgradeMinorVersion": true,
                "publisher": "Microsoft.Azure.Diagnostics",
                "type": "PaaSDiagnostics",
                "typeHandlerVersion": "1.5",
                "settings": "[parameters('wadPublicConfig_WebRole1')]",
                "protectedSettings": "[parameters('wadPrivateConfig_WebRole1')]",
                "rolesAppliedTo": [
                  "WebRole1"
              ]
            }
          }
        ]
      }
    }
   }
  ]
}

Cloud Services (延長サポート) デプロイを作成するには、テンプレートおよびパラメーターファイル (テンプレートファイルのパラメーターを定義するためのもの) をデプロイします。これらのサンプルテンプレートを使用できます。
```
New-AzResourceGroupDeployment -ResourceGroupName "ContosOrg" -TemplateFile "file path to your template file" -TemplateParameterFile "file path to your parameter file"
```

Cloud Services (延長サポート) に関してよく寄せられる質問を確認します。
Azure portal、Azure PowerShell または Visual Studio を使用して Cloud Services (延長サポート) をデプロイします。
Cloud Services (延長サポート) のサンプルリポジトリを確認します。

次の方法で共有

ARM テンプレートを使用してCloud Services (延長サポート) をデプロイする

前提条件

Cloud Services (延長サポート) をデプロイする

フィードバック

その他のリソース

次の方法で共有

ARM テンプレートを使用してCloud Services (延長サポート) をデプロイする

前提条件

Cloud Services (延長サポート) をデプロイする

関連するコンテンツ

フィードバック

その他のリソース