ARM テンプレートを使用してCloud Services (延長サポート) をデプロイする
この記事では、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 virtual 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 (延長サポート) のサンプル リポジトリを確認します。