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

[アーティクル]
04/13/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を発行する手順 (延長サポート)

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

フィードバック

その他のリソース