AzureResourceGroupDeployment@1 – úloha Nasazení skupiny prostředků Azure v1

Článek
08/19/2024

Pomocí této úlohy můžete nasadit, spustit, zastavit a odstranit skupiny prostředků Azure.

Tato úloha je zastaralá; AzureResourceGroupDeployment@2.

Syntax

# 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.

Vstupy

ConnectedServiceNameSelector - Typ připojení Azure
string. Povolené hodnoty: ConnectedServiceName (Azure Resource Manager) ConnectedServiceNameClassic (Azure Classic). Výchozí hodnota: ConnectedServiceName.

Povinná hodnota. Vybere připojení služby, které obsahuje předplatné Azure pro nasazení.

ConnectedServiceName - Předplatné Azure
string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceName.

Povinná hodnota. Vybere připojení služby, které obsahuje předplatné Azure pro nasazení.

ConnectedServiceNameClassic - Předplatné Azure Classic
string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Vybere předplatné Azure Classic pro nasazení.

action - Akce
string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceName. Povolené hodnoty: Create Or Update Resource Group, Select Resource Group, Start (Spustit Virtual Machines), Stop (Zastavit Virtual Machines), Restart (Restartovat Virtual Machines), Delete (Odstranit Virtual Machines), DeleteRG (Odstranit skupinu prostředků). Výchozí hodnota: Create Or Update Resource Group.

Akce, která se má provést s prostředky Nebo skupinou prostředků Azure.

actionClassic - Akce
string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceNameClassic. Povolené hodnoty: Select Resource Group (Vyberte Cloudová služba). Výchozí hodnota: Select Resource Group.

Akce, která se má provést s prostředky Azure nebo cloudovou službou.

resourceGroupName - Skupina prostředků
string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceName.

Poskytuje název skupiny prostředků.

cloudService - Cloudová služba
string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Obsahuje název cloudové služby.

location - Umístění
string. Vyžaduje se, když action = Create Or Update Resource Group. Povolené hodnoty: Australia East, Australia Southeast, Brazil South, Canada CentralCanada East, Central India, Central US, East Asia, , East US, East US 2 , Japan East, Japan WestSouth IndiaNorth Central USSouth Central USNorth EuropeSoutheast Asia, UK South, UK West, West Central US, West Europe, , West India, , West US, . West US 2 Výchozí hodnota: East US.

Umístění pro nasazení skupiny prostředků. Pokud skupina prostředků již v předplatném existuje, bude tato hodnota ignorována.

csmFile - Šablony
string. Vyžaduje se, když action = Create Or Update Resource Group.

Určuje cestu nebo vzor odkazující na šablonu Azure Resource Manager. Přečtěte si další informace o šablonách Azure Resource Manager. Pokud chcete začít okamžitě, použijte tuto ukázkovou šablonu.

csmParametersFile - Parametry šablony
string. Nepovinný parametr. Použijte, když action = Create Or Update Resource Group.

Určuje adresu URL souboru parametrů. Příklad adresy URL: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

Pokud chcete použít soubor uložený v účtu privátního úložiště, načtěte token sdíleného přístupového podpisu (SAS) a zahrňte ho do adresy URL šablony. Příklad: <blob_storage_url>/template.json?<SAStoken> Pokud chcete nahrát soubor parametrů do účtu úložiště a vygenerovat token SAS, použijte úlohu kopírování souborů Azure nebo postupujte podle pokynů pomocí PowerShellu nebo Azure CLI.

Pokud chcete zobrazit parametry šablony v mřížce, klikněte na … vedle textového pole přepsat parametry šablony. Tato funkce vyžaduje, aby na zdroji byla povolená pravidla CORS. Pokud jsou šablony v objektu blob úložiště Azure, projděte si téma Sdílení prostředků mezi zdroji a povolte CORS.

overrideParameters - Přepsání parametrů šablony
string. Nepovinný parametr. Použijte, když action = Create Or Update Resource Group.

Určuje parametry šablony, které se mají přepsat.

Pokud chcete zobrazit parametry šablony v mřížce, klikněte na ... vedle textového pole Přepsat parametry. Tato funkce vyžaduje, aby na zdroji byla povolená pravidla CORS. Pokud jsou šablony v objektu blob úložiště Azure, odkazujte na tento řetězec a povolte CORS nebo do textového pole zadejte parametry šablony, které se mají přepsat.

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

Pokud má hodnota parametru více slov, uzavřete je do uvozovek, a to i v případě, že hodnotu předáváte pomocí proměnných. Například, -name "parameter value" -name2 "$(var)". Pokud chcete přepsat parametry typu objektu, použijte objekty JSON s řetězci. Například, -options ["option1"] -map {"key1": "value1" }.

deploymentMode - Režim nasazení
string. Vyžaduje se, když action = Create Or Update Resource Group. Povolené hodnoty: Validation (Pouze ověření), Incremental, Complete. Výchozí hodnota: Incremental.

Režim Incremental zpracovává nasazení jako přírůstkové aktualizace skupiny prostředků. Ponechá nezměněné prostředky, které existují ve skupině prostředků, ale nejsou zadané v šabloně.

Complete režim odstraní prostředky, které nejsou v šabloně. Režim dokončení trvá relativně déle než přírůstkový režim. Pokud časový limit úkolu vyprší, zvažte zvýšení časového limitu nebo změnu režimu Incremental .

Upozornění

Režim dokončení odstraní všechny existující prostředky ve skupině prostředků, které nejsou v šabloně zadané. Zkontrolujte, jestli skupina prostředků, do které nasazujete, neobsahuje žádné potřebné prostředky, které nejsou v šabloně zadané.

Validate režim umožňuje najít problémy se šablonou před vytvořením skutečných prostředků.

Poznámka

Režim Validate vždy vytvoří skupinu prostředků, i když nejsou nasazené žádné prostředky.

Přečtěte si další informace o režimech nasazení.

enableDeploymentPrerequisitesForCreate - Povolení požadavků na nasazení
boolean. Nepovinný parametr. Použijte, když action = Create Or Update Resource Group. Výchozí hodnota: false.

Platí jenom v případě, že skupina prostředků obsahuje virtuální počítače.

Výběrem možnosti Skupina nasazení nakonfigurujete agenta skupiny nasazení na všech virtuálních počítačích.

Výběrem možnosti WinRM nakonfigurujete naslouchací proces Vzdálené správy Systému Windows (WinRM) přes protokol HTTPS na portu 5986 pomocí certifikátu podepsaného svým držitelem. Tato konfigurace se vyžaduje pro provádění operace nasazení na počítačích Azure. Pokud jsou cílové virtuální počítače zajištěné nástrojem pro vyrovnávání zatížení, ujistěte se, že jsou pro cílový port nakonfigurovaná příchozí pravidla NAT (5986).

enableDeploymentPrerequisitesForSelect - Povolení požadavků na nasazení
boolean. Nepovinný parametr. Použijte, když action = Select Resource Group. Výchozí hodnota: false.

Platí jenom v případě, že skupina prostředků obsahuje virtuální počítače.

Výběrem možnosti Skupina nasazení nakonfigurujete agenta skupiny nasazení na všech virtuálních počítačích.

outputVariable - Skupina prostředků
string.

Vyžaduje se, pokud je vybraná existující skupina prostředků. Poskytuje název proměnné skupiny prostředků. Proměnnou je možné použít $(variableName) k odkazování na skupinu prostředků v následných úlohách, například v úloze PowerShellu na cílových počítačích pro nasazení aplikací.

Platí pouze v případě, že vybraná akce je Create, Updatenebo Select.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Požadavky

Požadavek	Popis
Typy kanálů	YAML, classic build, verze Classic
Spustí se	Agent, DeploymentGroup
Požadavky	Agenti v místním prostředí musí mít funkce , které odpovídají následujícím požadavkům na spouštění úloh, které používají tuto úlohu: azureps
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	1.103.0 nebo vyšší
Kategorie úloh	Nasazení

Sdílet prostřednictvím