AzureResourceGroupDeployment@1 - Azure Resource Group Deployment v1 タスク

  • [アーティクル]

このタスクを使用して、Azure リソース グループをデプロイ、開始、停止、削除します。

このタスクは非推奨です。AzureResourceGroupDeployment@2を使用 します。

構文

# Azure Resource Group Deployment v1
# Deploy, start, stop, delete Azure Resource Groups.
- task: AzureResourceGroupDeployment@1
  inputs:
    #ConnectedServiceNameSelector: 'ConnectedServiceName' # 'ConnectedServiceName' | 'ConnectedServiceNameClassic'. Azure Connection Type. Default: ConnectedServiceName.
    ConnectedServiceName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Subscription. 
    #ConnectedServiceNameClassic: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Azure Classic Subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'Restart' | 'Delete' | 'DeleteRG'. Required when ConnectedServiceNameSelector = ConnectedServiceName. Action. Default: Create Or Update Resource Group.
    #actionClassic: 'Select Resource Group' # 'Select Resource Group'. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Action. Default: Select Resource Group.
    resourceGroupName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Resource Group. 
    #cloudService: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Cloud Service. 
    #location: 'East US' # 'Australia East' | 'Australia Southeast' | 'Brazil South' | 'Canada Central' | 'Canada East' | 'Central India' | 'Central US' | 'East Asia' | 'East US' | 'East US 2 ' | 'Japan East' | 'Japan West' | 'North Central US' | 'North Europe' | 'South Central US' | 'South India' | 'Southeast Asia' | 'UK South' | 'UK West' | 'West Central US' | 'West Europe' | 'West India' | 'West US' | 'West US 2'. Required when action = Create Or Update Resource Group. Location. Default: East US.
    #csmFile: # string. Required when action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when action = Create Or Update Resource Group. Template Parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override Template Parameters. 
    #deploymentMode: 'Incremental' # 'Validation' | 'Incremental' | 'Complete'. Required when action = Create Or Update Resource Group. Deployment Mode. Default: Incremental.
    #enableDeploymentPrerequisitesForCreate: false # boolean. Optional. Use when action = Create Or Update Resource Group. Enable Deployment Prerequisites. Default: false.
    #enableDeploymentPrerequisitesForSelect: false # boolean. Optional. Use when action = Select Resource Group. Enable Deployment Prerequisites. Default: false.
  # Output
    #outputVariable: # string. Resource Group.

入力

ConnectedServiceNameSelector - Azure 接続の種類
string. 使用できる値: ConnectedServiceName (Azure Resource Manager)、 ConnectedServiceNameClassic (Azure クラシック)。 既定値: ConnectedServiceName。

必須。 デプロイ用の Azure サブスクリプションを含むサービス接続を選択します。


ConnectedServiceName - Azure サブスクリプション
string. ConnectedServiceNameSelector = ConnectedServiceName の場合に必要です。

必須。 デプロイ用の Azure サブスクリプションを含むサービス接続を選択します。


ConnectedServiceNameClassic - Azure クラシック サブスクリプション
string. ConnectedServiceNameSelector = ConnectedServiceNameClassic の場合に必要です。

デプロイ用の Azure クラシック サブスクリプションを選択します。


action - アクション
string. ConnectedServiceNameSelector = ConnectedServiceName の場合に必要です。 使用できる値: 、、(Start Virtual Machines)、 Stop (Stop Virtual Machines) Restart 、(Restart Virtual Machines) Delete 、(Delete Virtual Machines)、(リソース グループの DeleteRG 削除)。 StartSelect Resource GroupCreate Or Update Resource Group 既定値: Create Or Update Resource Group。

Azure リソースまたはリソース グループに対して実行されるアクション。


actionClassic - アクション
string. ConnectedServiceNameSelector = ConnectedServiceNameClassic の場合に必要です。 使用できる値: Select Resource Group ([クラウド サービス] を選択)。 既定値: Select Resource Group。

Azure リソースまたはクラウド サービスに対して実行されるアクション。


resourceGroupName - リソース グループ
string. ConnectedServiceNameSelector = ConnectedServiceName の場合に必要です。

リソース グループの名前を提供します。


cloudService - クラウド サービス
string. ConnectedServiceNameSelector = ConnectedServiceNameClassic の場合に必要です。

クラウド サービスの名前を提供します。


location - 場所
string. action = Create Or Update Resource Group の場合に必要です。 使用できる値: Australia East、、、Brazil South、Canada Central、、Canada East、、 East US 2 West EuropeNorth Central USJapan WestNorth EuropeSouth Central USUK SouthSoutheast AsiaUK WestSouth IndiaWest Central USJapan EastWest US 2Central USWest USEast AsiaWest IndiaEast USCentral IndiaAustralia Southeast 既定値: East US。

リソース グループをデプロイする場所。 この値は、サブスクリプションにリソース グループが既に存在する場合は無視されます。


csmFile - テンプレート
string. action = Create Or Update Resource Group の場合に必要です。

Azure Resource Manager テンプレートを指すパスまたはパターンを指定します。 Azure Resource Manager テンプレートの詳細については、こちらを参照してください。 すぐに開始するには、 このサンプル テンプレートを使用します。


csmParametersFile - テンプレート パラメーター
string. 省略可能。 の場合は action = Create Or Update Resource Groupを使用します。

パラメーター ファイルの URL を指定します。 URL の例: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

プライベート ストレージ アカウントに格納されているファイルを使用するには、Shared Access Signature (SAS) トークンを取得してテンプレートの URL に含めます。 例: <blob_storage_url>/template.json?<SAStoken> パラメーター ファイルをストレージ アカウントにアップロードして SAS トークンを生成するには、 Azure ファイル コピー タスクを使用するか、 PowerShell または Azure CLI を使用して手順に従います。

グリッド内のテンプレート パラメーターを表示するには、[テンプレート パラメーターの … オーバーライド] テキスト ボックスの横にある をクリックします。 この機能を利用するには、ソースで CORS ルールが有効になっている必要があります。 テンプレートが Azure Storage BLOB 内にある場合は、「 クロスオリジン リソース共有 」を参照して CORS を有効にします。


overrideParameters - テンプレート パラメーターのオーバーライド
string. 省略可能。 の場合は action = Create Or Update Resource Groupを使用します。

オーバーライドするテンプレート パラメーターを指定します。

グリッド内のテンプレート パラメーターを表示するには、[パラメーターのオーバーライド] ボックスの ... 横にある をクリックします。 この機能を利用するには、ソースで CORS ルールが有効になっている必要があります。 テンプレートが Azure ストレージ BLOB 内にある場合は、この文字列を参照して CORS を有効にするか、テキスト ボックスにオーバーライドするテンプレート パラメーターを入力します。

例: -storageName fabrikam -adminUsername $(vmusername) -adminPassword (ConvertTo-SecureString -String '$(password)' -AsPlainText -Force) -azureKeyVaultName $(fabrikamFibre).

パラメーター値に複数の単語がある場合は、変数を使用して値を渡す場合でも、単語を引用符で囲みます。 たとえば、「 -name "parameter value" -name2 "$(var)" 」のように入力します。 オブジェクト型パラメーターをオーバーライドするには、文字列化された JSON オブジェクトを使用します。 たとえば、「 -options ["option1"] -map {"key1": "value1" } 」のように入力します。


deploymentMode - デプロイ モード
string. action = Create Or Update Resource Group の場合に必要です。 使用できる値: Validation (検証のみ)、Incremental、。 Complete 既定値: Incremental。

このモードでは Incremental 、リソース グループへの増分更新としてデプロイが処理されます。 これは、リソース グループ内に存在していてもテンプレートで指定されていないリソースを未変更のまま残します。

Complete モードでは、テンプレートに含まれていないリソースが削除されます。 完全モードは、増分モードよりも比較的時間がかかります。 タスクがタイムアウトした場合は、タイムアウトを増やすか、モードに Incremental 変更することを検討してください。

警告

完全モードでは、テンプレートで指定されていないリソース グループ内の既存のリソースがすべて削除されます。 デプロイするリソース グループに、テンプレートで指定されていない必要なリソースが含まれていないかどうかを確認します。

Validate モードを使用すると、実際のリソースを作成する前にテンプレートに関する問題を見つけることができます。

注意

このモードでは Validate 、リソースがデプロイされていない場合でも、常にリソース グループが作成されます。

デプロイ モードの詳細については、こちらを参照してください。


enableDeploymentPrerequisitesForCreate - 展開の前提条件を有効にする
boolean. 省略可能。 の場合は action = Create Or Update Resource Groupを使用します。 既定値: false。

リソース グループに仮想マシンが含まれている場合にのみ適用されます。

[デプロイ グループ] オプションを選択すると、各仮想マシンでデプロイ グループ エージェントが構成されます。

WinRM オプションを選択すると、自己署名証明書を使用して、ポート 5986 の HTTPS プロトコル経由で Windows リモート管理 (WinRM) リスナーが構成されます。 この構成は、Azure マシンでデプロイ操作を実行するために必要になります。 ターゲット仮想マシンがロード バランサーによってサポートされている場合は、ターゲット ポート (5986) に対して受信 NAT 規則が構成されていることを確認します。


enableDeploymentPrerequisitesForSelect - 展開の前提条件を有効にする
boolean. 省略可能。 の場合は action = Select Resource Groupを使用します。 既定値: false。

リソース グループに仮想マシンが含まれている場合にのみ適用されます。

[デプロイ グループ] オプションを選択すると、各仮想マシンでデプロイ グループ エージェントが構成されます。

WinRM オプションを選択すると、自己署名証明書を使用して、ポート 5986 の HTTPS プロトコル経由で Windows リモート管理 (WinRM) リスナーが構成されます。 この構成は、Azure マシンでデプロイ操作を実行するために必要になります。 ターゲット仮想マシンがロード バランサーによってサポートされている場合は、ターゲット ポート (5986) に対して受信 NAT 規則が構成されていることを確認します。


outputVariable - リソース グループ
string.

既存のリソース グループが選択されている場合は必須です。 リソース グループ変数の名前を提供します。 変数は、アプリケーションをデプロイするためのターゲット マシンの PowerShell タスクなど、後続のタスクでリソース グループを参照するために使用 $(variableName) できます。

選択したアクションが Create、、 Updateまたは Selectの場合にのみ有効です。


タスク制御オプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

必要条件

要件 説明
パイプラインの種類 YAML、クラシック ビルド、クラシック リリース
上で実行 エージェント、DeploymentGroup
確認要求 セルフホステッド エージェントには、このタスクを使用するジョブを実行するための次の要求に一致する機能が必要です。
Capabilities このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 Any
設定可能な変数 Any
エージェントのバージョン 1.103.0 以上
タスクのカテゴリ 配置