Azure PowerShell を使用してクラウドサービス (延長サポート) をデプロイする

[アーティクル]
06/01/2023

この記事では、複数のロール (Web ロールおよび worker ロール) を備えた Cloud Services (延長サポート) を、Az.CloudService PowerShell モジュールを使って Azure にデプロイする方法を説明します。

前提条件

クラウドサービス (延長サポート) のデプロイの前提条件を確認し、関連するリソースを作成します。
Az.CloudService PowerShell モジュールをインストールします。
```
Install-Module -Name Az.CloudService 
```
新しいリソースグループを作成する。既存のリソースグループを使用する場合は、この手順は省略可能です。
```
New-AzResourceGroup -ResourceGroupName “ContosOrg” -Location “East US” 
```
クラウドサービスパッケージ (.cspkg) ファイルとサービス構成 (.cscfg) ファイルの格納に使用するストレージアカウントとコンテナーを作成します。ストレージアカウント名には、一意の名前を指定する必要があります。既存のストレージアカウントを使用する場合は、この手順は省略可能です。
```
$storageAccount = New-AzStorageAccount -ResourceGroupName “ContosOrg” -Name “contosostorageaccount” -Location “East US” -SkuName “Standard_RAGRS” -Kind “StorageV2” 
$container = New-AzStorageContainer -Name “contosocontainer” -Context $storageAccount.Context -Permission Blob 
```

クラウドサービス (延長サポート) をデプロイする

次のいずれかの PowerShell コマンドレットを使用して、Cloud Services (延長サポート) をデプロイします。

ストレージアカウントを使用したクラウドサービスの簡易作成
- このパラメーターセットは、入力としてストレージアカウントとともに .cscfg、.cspkg、.csdef ファイルを入力します。
- クラウドサービスロールプロファイル、ネットワークプロファイル、OS プロファイルがコマンドレットによって作成され、ユーザーからの入力は最小限に抑えられます。
- 証明書の入力の場合は、keyvault 名が指定されます。 keyvault 内の証明書の拇印が、.cscfg ファイルに指定されているものに対して検証されます。
SAS URI を使用したクラウドサービスの簡易作成
- このパラメーターセットは、.csdef および .cscfg ファイルのローカルパスとともに、.cspkg の SAS URI を入力します。ストレージアカウントの入力は必要ありません。
- クラウドサービスロールプロファイル、ネットワークプロファイル、OS プロファイルがコマンドレットによって作成され、ユーザーからの入力は最小限に抑えられます。
- 証明書の入力の場合は、keyvault 名が指定されます。 keyvault 内の証明書の拇印が、.cscfg ファイルに指定されているものに対して検証されます。
ロール、OS、ネットワーク、拡張機能プロファイル、SAS URI を使用してクラウドサービスを作成する
- このパラメーターセットは、.cscfg および .cspkg ファイルの SAS URI を入力します。
- ロール、ネットワーク、OS、拡張機能プロファイルは、ユーザーが指定する必要があり、.cscfg と .csdef の値と一致する必要があります。

ストレージアカウントを使用したクラウドサービスの簡易作成

.cscfg、.csdef、.cspkg ファイルを使用してクラウドサービスデプロイを作成します。

$cspkgFilePath = "<Path to cspkg file>"
$cscfgFilePath = "<Path to cscfg file>"
$csdefFilePath = "<Path to csdef file>"
      
# Create Cloud Service       
New-AzCloudService
-Name "ContosoCS" `
-ResourceGroupName "ContosOrg" `
-Location "EastUS" `
-ConfigurationFile $cscfgFilePath `
-DefinitionFile $csdefFilePath `
-PackageFile $cspkgFilePath `
-StorageAccount $storageAccount `
[-KeyVaultName <string>]

SAS URI を使用したクラウドサービスの簡易作成

ストレージアカウントにクラウドサービスパッケージ (cspkg) をアップロードします。

$tokenStartTime = Get-Date 
$tokenEndTime = $tokenStartTime.AddYears(1) 
$cspkgBlob = Set-AzStorageBlobContent -File “./ContosoApp/ContosoApp.cspkg” -Container “contosocontainer” -Blob “ContosoApp.cspkg” -Context $storageAccount.Context 
$cspkgToken = New-AzStorageBlobSASToken -Container “contosocontainer” -Blob $cspkgBlob.Name -Permission rwd -StartTime $tokenStartTime -ExpiryTime $tokenEndTime -Context $storageAccount.Context 
$cspkgUrl = $cspkgBlob.ICloudBlob.Uri.AbsoluteUri + $cspkgToken 
$cscfgFilePath = "<Path to cscfg file>"
$csdefFilePath = "<Path to csdef file>"

.cscfg、.csdef、.cspkg SAS URI を使用してクラウドサービスデプロイを作成します。

New-AzCloudService
    -Name "ContosoCS" `
    -ResourceGroupName "ContosOrg" `
    -Location "EastUS" `
    -ConfigurationFile $cspkgFilePath `
    -DefinitionFile $csdefFilePath `
    -PackageURL $cspkgUrl `
    [-KeyVaultName <string>]

プロファイルオブジェクトと SAS URI を使用してクラウドサービスを作成する

ストレージアカウントにクラウドサービス構成 (cscfg) をアップロードします。

$cscfgBlob = Set-AzStorageBlobContent -File “./ContosoApp/ContosoApp.cscfg” -Container contosocontainer -Blob “ContosoApp.cscfg” -Context $storageAccount.Context 
$cscfgToken = New-AzStorageBlobSASToken -Container “contosocontainer” -Blob $cscfgBlob.Name -Permission rwd -StartTime $tokenStartTime -ExpiryTime $tokenEndTime -Context $storageAccount.Context 
$cscfgUrl = $cscfgBlob.ICloudBlob.Uri.AbsoluteUri + $cscfgToken

ストレージアカウントにクラウドサービスパッケージ (cspkg) をアップロードします。

$tokenStartTime = Get-Date 
$tokenEndTime = $tokenStartTime.AddYears(1) 
$cspkgBlob = Set-AzStorageBlobContent -File “./ContosoApp/ContosoApp.cspkg” -Container “contosocontainer” -Blob “ContosoApp.cspkg” -Context $storageAccount.Context 
$cspkgToken = New-AzStorageBlobSASToken -Container “contosocontainer” -Blob $cspkgBlob.Name -Permission rwd -StartTime $tokenStartTime -ExpiryTime $tokenEndTime -Context $storageAccount.Context 
$cspkgUrl = $cspkgBlob.ICloudBlob.Uri.AbsoluteUri + $cspkgToken

仮想ネットワークとサブネットを作成します。既存のネットワークとサブネットを使用する場合は、この手順は省略可能です。この例では、Web ロールと worker ロールのどちらのクラウドサービスロールにも、単一の仮想ネットワークとサブネットを使用します。
```
$subnet = New-AzVirtualNetworkSubnetConfig -Name "ContosoWebTier1" -AddressPrefix "10.0.0.0/24" -WarningAction SilentlyContinue 
$virtualNetwork = New-AzVirtualNetwork -Name “ContosoVNet” -Location “East US” -ResourceGroupName “ContosOrg” -AddressPrefix "10.0.0.0/24" -Subnet $subnet 
```
パブリック IP アドレスを作成し、そのパブリック IP アドレスの DNS ラベルプロパティを設定します。 Cloud Services (延長サポート) では、Basic SKU のパブリック IP アドレスのみをサポートしています。 Standard SKU のパブリック IP は、Cloud Services では機能しません。静的 IP を使用する場合は、サービス構成 (.cscfg) ファイルで予約済み IP として参照する必要があります。
```
$publicIp = New-AzPublicIpAddress -Name “ContosIp” -ResourceGroupName “ContosOrg” -Location “East US” -AllocationMethod Dynamic -IpAddressVersion IPv4 -DomainNameLabel “contosoappdns” -Sku Basic 
```
ネットワークプロファイルオブジェクトを作成し、ロードバランサーのフロントエンドにパブリック IP アドレスを関連付けます。 Azure プラットフォームにより、クラウドサービスリソースと同じサブスクリプションに "クラシック" SKU ロードバランサーリソースが自動的に作成されます。ロードバランサーリソースは、Azure Resource Manager の読み取り専用リソースです。リソースに対する更新は、クラウドサービスデプロイファイル (.cscfg および .csdef) を介してのみサポートされます。
```
$publicIP = Get-AzPublicIpAddress -ResourceGroupName ContosOrg -Name ContosIp  
$feIpConfig = New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject -Name 'ContosoFe' -PublicIPAddressId $publicIP.Id 
$loadBalancerConfig = New-AzCloudServiceLoadBalancerConfigurationObject -Name 'ContosoLB' -FrontendIPConfiguration $feIpConfig 
$networkProfile = @{loadBalancerConfiguration = $loadBalancerConfig} 
```
キーコンテナーを作成するこのキーコンテナーは、クラウドサービス (延長サポート) の各種ロールに関連付けられている証明書を格納するために使用します。このキーコンテナーは、一意の名前を使用したうえで、クラウドサービスと同じリージョンおよびサブスクリプションに配置する必要があります。詳細については、「Azure Cloud Services (延長サポート) で証明書を使用する」を参照してください。
```
New-AzKeyVault -Name "ContosKeyVault” -ResourceGroupName “ContosOrg” -Location “East US” 
```

キーコンテナーのアクセスポリシーを更新し、自分のユーザーアカウントに証明書に関するアクセス許可を付与します。

Set-AzKeyVaultAccessPolicy -VaultName 'ContosKeyVault' -ResourceGroupName 'ContosOrg' -EnabledForDeployment
Set-AzKeyVaultAccessPolicy -VaultName 'ContosKeyVault' -ResourceGroupName 'ContosOrg' -UserPrincipalName 'user@domain.com' -PermissionsToCertificates create,get,list,delete

または、ObjectId (Get-AzADUser を実行すると取得できます) を使ってアクセスポリシーを設定します。

Set-AzKeyVaultAccessPolicy -VaultName 'ContosKeyVault' -ResourceGroupName 'ContosOrg' -ObjectId 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' -PermissionsToCertificates create,get,list,delete

この例では、キーコンテナーに自己署名証明書を追加します。クラウドサービスのロールにデプロイするためには、クラウドサービス構成 (.cscfg) ファイルに証明書の拇印を追加する必要があります。

$Policy = New-AzKeyVaultCertificatePolicy -SecretContentType "application/x-pkcs12" -SubjectName "CN=contoso.com" -IssuerName "Self" -ValidityInMonths 6 -ReuseKeyOnRenewal 
Add-AzKeyVaultCertificate -VaultName "ContosKeyVault" -Name "ContosCert" -CertificatePolicy $Policy

OS プロファイルのメモリ内オブジェクトを作成します。 OS プロファイルは、クラウドサービスのロールに関連付ける証明書を指定するものです。これは、前の手順で作成したのと同じ証明書になります。

$keyVault = Get-AzKeyVault -ResourceGroupName ContosOrg -VaultName ContosKeyVault 
$certificate = Get-AzKeyVaultCertificate -VaultName ContosKeyVault -Name ContosCert 
$secretGroup = New-AzCloudServiceVaultSecretGroupObject -Id $keyVault.ResourceId -CertificateUrl $certificate.SecretId 
$osProfile = @{secret = @($secretGroup)}

ロールプロファイルのメモリ内オブジェクトを作成します。ロールプロファイルは、名前、容量、階層など、ロール SKU 固有のプロパティを定義するものです。この例では、frontendRole と backendRole の 2 つのロールを定義しています。ロールプロファイルの情報は、構成 (cscfg) ファイルとサービス定義 (csdef) ファイルの中で定義されているロール構成と一致している必要があります。
```
$frontendRole = New-AzCloudServiceRoleProfilePropertiesObject -Name 'ContosoFrontend' -SkuName 'Standard_D1_v2' -SkuTier 'Standard' -SkuCapacity 2 
$backendRole = New-AzCloudServiceRoleProfilePropertiesObject -Name 'ContosoBackend' -SkuName 'Standard_D1_v2' -SkuTier 'Standard' -SkuCapacity 2 
$roleProfile = @{role = @($frontendRole, $backendRole)} 
```

(省略可能) クラウドサービスに追加する拡張機能プロファイルのメモリ内オブジェクトを作成します。この例では、RDP 拡張機能を追加します。

$credential = Get-Credential 
$expiration = (Get-Date).AddYears(1) 
$rdpExtension = New-AzCloudServiceRemoteDesktopExtensionObject -Name 'RDPExtension' -Credential $credential -Expiration $expiration -TypeHandlerVersion '1.2.1' 

$storageAccountKey = Get-AzStorageAccountKey -ResourceGroupName "ContosOrg" -Name "contosostorageaccount"
$configFile = "<WAD public configuration file path>"
$wadExtension = New-AzCloudServiceDiagnosticsExtension -Name "WADExtension" -ResourceGroupName "ContosOrg" -CloudServiceName "ContosCS" -StorageAccountName "contosostorageaccount" -StorageAccountKey $storageAccountKey[0].Value -DiagnosticsConfigurationPath $configFile -TypeHandlerVersion "1.5" -AutoUpgradeMinorVersion $true 
$extensionProfile = @{extension = @($rdpExtension, $wadExtension)}

次のように、ConfigFile には PublicConfig タグのみが含まれていること、また名前空間が含まれていることが必要です。

<?xml version="1.0" encoding="utf-8"?>
<PublicConfig xmlns="http://schemas.microsoft.com/ServiceHosting/2010/10/DiagnosticsConfiguration">
    ...............
</PublicConfig>

(省略可能) クラウドサービスに追加するタグを PowerShell ハッシュテーブルとして定義します。
```
$tag=@{"Owner" = "Contoso"} 
```

プロファイルオブジェクトと SAS URL を使用してクラウドサービスのデプロイを作成します。

$cloudService = New-AzCloudService ` 
    -Name “ContosoCS” ` 
    -ResourceGroupName “ContosOrg” ` 
    -Location “East US” ` 
    -PackageUrl $cspkgUrl ` 
    -ConfigurationUrl $cscfgUrl ` 
    -UpgradeMode 'Auto' ` 
    -RoleProfile $roleProfile ` 
    -NetworkProfile $networkProfile  ` 
    -ExtensionProfile $extensionProfile ` 
    -OSProfile $osProfile `
    -Tag $tag

次のステップ

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

Azure PowerShell を使用してクラウド サービス (延長サポート) をデプロイする

前提条件

クラウド サービス (延長サポート) をデプロイする

ストレージ アカウントを使用したクラウド サービスの簡易作成

SAS URI を使用したクラウド サービスの簡易作成

プロファイル オブジェクトと SAS URI を使用してクラウド サービスを作成する