このタスクを使用して、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 サブスクリプションを含むサービス接続を選択します。
Azure サブスクリプションの ConnectedServiceName -
string.
ConnectedServiceNameSelector = ConnectedServiceNameする場合に必要です。
必須。 デプロイ用の Azure サブスクリプションを含むサービス接続を選択します。
Azure クラシック サブスクリプションの ConnectedServiceNameClassic -
string.
ConnectedServiceNameSelector = ConnectedServiceNameClassicする場合に必要です。
デプロイ用の Azure クラシック サブスクリプションを選択します。
action
-
アクションの
string.
ConnectedServiceNameSelector = ConnectedServiceNameする場合に必要です。 使用できる値: Create Or Update Resource Group、Select Resource Group、Start (仮想マシンの起動)、Stop (仮想マシンの停止)、Restart (仮想マシンの再起動)、Delete (仮想マシンの削除)、DeleteRG (リソース グループの削除)。 既定値: 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、Australia Southeast、Brazil South、Canada Central、Canada East、Central India、Central US、East Asia、East US、East US 2 、Japan East、Japan WestNorth 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. 既定値: 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
プライベート ストレージ アカウントに格納されているファイルを使用するには、テンプレートの URL に Shared Access Signature (SAS) トークンを取得して含めます。 例: <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 Storage 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されている場合にのみ有効です。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。