Azure DevOps を使用して Cloud Services を発行する方法 (延長サポート)

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

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

背景

Azure Cloud Services (延長サポート) は、 Azure Cloud Services 用の新しい ARM ベースのデプロイモデルです。 Cloud Services (延長サポート) には、Azure Service Manager を使用してデプロイされた Azure Cloud Services との機能パリティと共に、リージョンの回復性を提供するという主な利点があります。また、ロールベースのアクセスと制御 (RBAC)、タグ、ポリシー、デプロイテンプレートのサポートなど、一部の ARM 機能も提供します。

従来の Cloud Services の場合、Azure DevOps 組み込みパイプラインタスク AzureCloudPowerShellDeployment@1 は、CI/CD の進行状況を簡単に管理するのに役立ちます。ただし、Cloud Services (延長サポート) のタスクはまだ準備ができていません。

Cloud Services を発行するための主なポイント (延長サポート)

ARM テンプレートのデプロイに備えるために、ストレージアカウントの変数をいくつか定義します。
VSBuild@1 - Visual Studio ビルド v1 タスクを使用してクラウドサービスプロジェクトをビルドし、クラウドサービスパッケージファイルまたは構成ファイルを出力します。
組み込みの AzureFileCopy@5 - Azure ファイルコピー v5 タスクを使用して、ビルドディレクトリを BLOB ストレージにアップロードします。
アクセスキーを含むストレージ参照を使用して、 AzurePowerShell@5 - Azure PowerShell v5 タスクによって SAS トークンを生成し、次のタスクで使用される変数にトークンを出力します。
前のタスクの出力と、 AzureResourceManagerTemplateDeployment@3 - ARM テンプレートデプロイ v3 タスクの値を使用。

最近実行されたパイプラインのスクリーンショット。

Cloud Services を発行する手順 (延長サポート)

スターターパイプラインを作成し、ストレージアカウントにアップロードする準備をします。これらの変数は、次の操作に役立ちます。
- stg_account <ストレージアカウントの名前>
- stg_key <ストレージアカウントのアクセスキー>
- stg_container <ストレージアカウントのコンテナー名>
- stg_prefix $[format('{0:yyyMMddHHmm}', pipeline.startTime)]
- stg_url https://$(stg_account).blob.core.windows.net/$(stg_container)
- cscfg_name <構成ファイルの名前>
- cspkg_name <パッケージファイルの名前>
- url_cscfg $(stg_url)/$(stg_prefix)/$(cscfg_name)
- url_cspkg $(stg_url)/$(stg_prefix)/$(cspkg_name)

Visual Studio ビルドタスクを使用して、クラウドサービスプロジェクトソリューションファイルに基づいてタスクをビルドし、エージェントのローカルパスに出力します。詳細については、「MSBuild」を参照してください。

クラウドサービスプロジェクトソリューションファイルの例のスクリーンショット。

プロジェクトをビルドするための YAML ファイルを次に示します。

# Build your project under your repository.
# 1. Restore the NuGet dependency.

- task: NuGetCommand@2
  inputs:
    command: 'restore'
    restoreSolution: '**/*.sln'
    feedsToUse: 'select'
    vstsFeed: xxx

# 2. Use MS build to output the cloud service project configuration and package to the temporary location of the local agent.

- task: VSBuild@1
  inputs:
    solution: '**\*.sln'
    msbuildArgs: '/t:Publish /p:DeployOnBuild=true /p:AutomatedBuild=True /p:configuration=release /p:TargetProfile=Cloud /p:PublishDir=%SYSTEM_DEFAULTWORKINGDIRECTORY%/Debug/publish'

# 3. Copy the configuration and package files to the local path on the agent where any artifacts locate.

- task: CopyFiles@2
  inputs:
    SourceFolder: 'Debug/publish'
    Contents: '**'
    TargetFolder: '$(Build.ArtifactStagingDirectory)'

# 4. Copy the definition file to the local path on the agent where any artifacts locate.

- task: CopyFiles@2
  inputs:
    SourceFolder: 'Project'
    Contents: '*.csdef'
    TargetFolder: '$(Build.ArtifactStagingDirectory)'

パイプラインタスク AzureFileCopy@4 - Azure ファイルコピー v4 タスクを使用して、クラウドサービスの構成、定義、パッケージファイルをアップロードします。このタスクは、Microsoft Entra ID に基づく認証をサポートします。認証は、サービスプリンシパルとマネージド ID を使用して行うことができます。アクセス許可共同作成者とストレージ BLOB データ共同作成者を割り当てて、サービス接続のアクセスを許可することができます。

プロジェクト設定でサービスプリンシパルを見つけます。

ファイルコピーの YAML バージョン:
```
# Upload the cloud service via Azure File Copy
- task: AzureFileCopy@5
  inputs:
    SourcePath: '$(Build.ArtifactsStagingDirectory) /*'        # you can set $(Build.ArtifactsStagingDirectory) as Build part for output of the MSBuild.
    azureSubscription: xxx                                     # the name of service connector
    Destination: 'AzureBlob'
    storage: $(stg_account)                                    # variable stg_account
    ContainerName: $(stg_container)                            # variable stg_container
    BlobPrefix: $(stg_prefix)                                  # variable stg prefix is $[format('{0:yyyyMMddHHmm}', pipeline.startTime)]
    AdditionalArgumentsForBlobCopy: '--recursive'              # recursively copy the files in this directory
```
ファイルをコピーすると、コピーしたクラウドサービスパッケージがストレージに表示されます。

Azure PowerShell パイプラインタスクを使用して、一時的な SAS トークンを 5 分間生成します。

# Generate temp SAS token for 5 mins
- task: AzurePowerShell@5                                                     # please make sure the Azure PowerShell contains the module of Az and AzureRm.
  name: GenerateSasToken
  inputs:
    azureSubscription: xxx                                                    # the name of service connector
    ScriptType: 'InlineScript'
    Inline: |
      $account_name = ${env:STG_ACCOUNT}
      $account_key = ${env:STG_KEY}
      $context = New-AzStorageContext -StorageAccountName $account_name -StorageAccountKey $account_key
      $sas = New-AzStorageAccountSASToken -Service Blob -ResourceType Service,Container,Object -Permission "rl" -ExpiryTime (Get-Date).AddMinutes(5) -Context $context
      $cspkg = ${env:URL_CSPKG} + $sas
      $cscfg = ${env:URL_CSCFG} + $sas
      Write-Host ("##vso[task.setvariable variable=cspkg]$cspkg")             # output $cspkg in PowerShell to global variable cspkg
      Write-Host ("##vso[task.setvariable variable=cscfg]$cscfg")             # output $cscfg in PowerShell to global variable cscfg
    azurePowerShellVersion: 'LatestVersion'

ARM テンプレートパイプラインタスクを使用して、Cloud Services (延長サポート) デプロイをデプロイします。サンプルテンプレートを取得するには、 101-cses-multirole-rdp を参照してください。

#Azure Resource Manager template deployment
- task: AzureResourceManagerTemplateDeployment@3                               
  inputs:
    deploymentScope: 'Resource Group'                                           # resource group level deployment
    azureResourceManagerConnection: xxx                                         # the name of service connector
    subscriptionId: xxx                                                         # subscription id of the service connector
    action: 'Create Or Update Resource Group'
    resourceGroupName: 'rg-002'                                                                               
    location: 'Australia Central'
    templateLocation: 'Linked artifact'
    csmFile: 'Template/CSES.template.json'
    csmParametersFile: 'Template/CSES.parameter.json'
    overrideParameters: '-packageSasUri $(cspkg) -configurationSasUri $(cscfg) -cloudServiceName cses4test002 -deploymentLabel deploy$(stg_prefix)' # overwrite some parameters of template.
    deploymentMode: 'Incremental'

デプロイが完了すると、次のタスクの結果と、タグ付きのクラウドサービスが表示されます。コードと構成を変更して、現在のデプロイを更新できます。

Azure portal では、デプロイの結果をクラウドサービスリソースグループで確認できます。

デプロイラベルは、定義したタイムスタンプと同じである必要があります。

お問い合わせはこちらから

質問がある場合やヘルプが必要な場合は、サポート要求を作成するか、Azure コミュニティサポートにお問い合わせください。 Azure フィードバックコミュニティに製品フィードバックを送信することもできます。

次の方法で共有

Azure DevOps を使用して Cloud Services を発行する方法 (延長サポート)

背景

Cloud Services を発行するための主なポイント (延長サポート)

Cloud Services を発行する手順 (延長サポート)

お問い合わせはこちらから

フィードバック

その他のリソース