AzureResourceGroupDeployment@1 - Azure Resource Group Deployment v1-taak

Artikel
2025-03-24

Gebruik deze taak om Azure-resourcegroepen te implementeren, te starten, te stoppen en te verwijderen.

Deze taak is afgeschaft; AzureResourceGroupDeployment@2gebruiken.

Syntaxis

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

Invoer

ConnectedServiceNameSelector - Azure-verbindingstype
string. Toegestane waarden: ConnectedServiceName (Azure Resource Manager), ConnectedServiceNameClassic (klassiek Azure). Standaardwaarde: ConnectedServiceName.

Verplicht. Selecteert de serviceverbinding die een Azure-abonnement voor de implementatie bevat.

ConnectedServiceName - Azure-abonnement
string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceName.

Verplicht. Selecteert de serviceverbinding die een Azure-abonnement voor de implementatie bevat.

ConnectedServiceNameClassic - klassieke Azure-abonnement
string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Selecteert een klassiek Azure-abonnement voor de implementatie.

action - actie-
string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceName. Toegestane waarden: Create Or Update Resource Group, Select Resource Group, Start (virtuele machines starten), Stop (virtuele machines stoppen), Restart (virtuele machines opnieuw opstarten), Delete (virtuele machines verwijderen), DeleteRG (resourcegroep verwijderen). Standaardwaarde: Create Or Update Resource Group.

De actie die moet worden uitgevoerd op de Azure-resources of -resourcegroep.

actionClassic - actie-
string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceNameClassic. Toegestane waarden: Select Resource Group (Cloudservice selecteren). Standaardwaarde: Select Resource Group.

De actie die moet worden uitgevoerd op de Azure-resources of -cloudservice.

resourceGroupName - resourcegroep
string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceName.

Hiermee geeft u de naam van de resourcegroep op.

cloudService - cloudservice
string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Geeft de naam van de cloudservice op.

location - locatie
string. Vereist wanneer action = Create Or Update Resource Group. Toegestane waarden: 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. Standaardwaarde: East US.

De locatie voor het implementeren van de resourcegroep. Als de resourcegroep al bestaat in het abonnement, wordt deze waarde genegeerd.

csmFile - sjabloon
string. Vereist wanneer action = Create Or Update Resource Group.

Hiermee geeft u het pad of een patroon aan dat verwijst naar de Azure Resource Manager-sjabloon. Meer informatie over Azure Resource Manager-sjablonen. Gebruik deze voorbeeldsjabloonom direct aan de slag te gaan.

csmParametersFile - sjabloonparameters
string. Facultatief. Gebruiken wanneer action = Create Or Update Resource Group.

Hiermee geeft u de URL van het parameterbestand. Een voorbeeld-URL: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

Als u een bestand wilt gebruiken dat is opgeslagen in een privéopslagaccount, haalt u het SAS-token (Shared Access Signature) op in de URL van de sjabloon. Voorbeeld: <blob_storage_url>/template.json?<SAStoken> een parameterbestand uploaden naar een opslagaccount en een SAS-token genereren, gebruikt u de Azure-bestandskopie taak of volgt u de stappen met behulp van PowerShell- of Azure CLI-.

Als u de sjabloonparameters in een raster wilt weergeven, klikt u op … naast het tekstvak sjabloonparameters negeren. Voor deze functie moeten CORS-regels zijn ingeschakeld bij de bron. Als sjablonen zich in Azure Storage-blob bevinden, raadpleegt u Cross-Origin Resource Sharing- om CORS in te schakelen.

sjabloonparameters overrideParameters - overschrijven
string. Facultatief. Gebruiken wanneer action = Create Or Update Resource Group.

Hiermee geeft u de sjabloonparameters die moeten worden overschreven.

Als u de sjabloonparameters in een raster wilt weergeven, klikt u op ... naast het tekstvak Parameters overschrijven. Voor deze functie moeten CORS-regels zijn ingeschakeld bij de bron. Als de sjablonen zich in de Azure Storage-blob bevinden, raadpleegt u deze tekenreeks om CORS in te schakelen of typt u de sjabloonparameters die u wilt overschrijven in het tekstvak.

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

Als de parameterwaarde meerdere woorden bevat, plaatst u de woorden tussen aanhalingstekens, zelfs als u de waarde doorgeeft met behulp van variabelen. Bijvoorbeeld: -name "parameter value" -name2 "$(var)". Als u parameters voor objecttypen wilt overschrijven, gebruikt u tekenreeksen die JSON-objecten bevatten. Bijvoorbeeld: -options ["option1"] -map {"key1": "value1" }.

deploymentMode - implementatiemodus
string. Vereist wanneer action = Create Or Update Resource Group. Toegestane waarden: Validation (alleen validatie), Incremental, Complete. Standaardwaarde: Incremental.

De Incremental-modus verwerkt implementaties als incrementele updates voor de resourcegroep. Er blijven ongewijzigde resources in de resourcegroep aanwezig, maar worden niet opgegeven in de sjabloon.

Complete modus verwijdert resources die zich niet in uw sjabloon bevinden. De volledige modus kost relatief meer tijd dan incrementele modus. Als er een time-out optreedt voor de taak, kunt u overwegen om de time-out te verhogen of over te schakelen naar de modus Incremental.

Waarschuwing

In de volledige modus worden alle bestaande resources in de resourcegroep verwijderd die niet in de sjabloon zijn opgegeven. Controleer of de resourcegroep waarnaar u implementeert geen benodigde resources bevat die niet zijn opgegeven in de sjabloon.

Validate modus kunt u problemen met de sjabloon vinden voordat u werkelijke resources maakt.

Notitie

In de Validate modus wordt altijd een resourcegroep gemaakt, zelfs als er geen resources zijn geïmplementeerd.

Meer informatie over implementatiemodi.

enableDeploymentPrerequisitesForCreate - Implementatievereisten inschakelen
boolean. Facultatief. Gebruiken wanneer action = Create Or Update Resource Group. Standaardwaarde: false.

Alleen van toepassing wanneer de resourcegroep virtuele machines bevat.

Als u de optie Implementatiegroep kiest, wordt de implementatiegroepagent op elk van de virtuele machines geconfigureerd.

Als u de WinRM-optie selecteert, wordt de WinRM-listener (Windows Remote Management) via het HTTPS-protocol op poort 5986 geconfigureerd met behulp van een zelfondertekend certificaat. Deze configuratie is vereist voor het uitvoeren van implementatiebewerkingen op Azure-machines. Als de doel-VM's worden ondersteund door een load balancer, controleert u of de binnenkomende NAT-regels zijn geconfigureerd voor de doelpoort (5986).

enableDeploymentPrerequisitesForSelect - Implementatievereisten inschakelen
boolean. Facultatief. Gebruiken wanneer action = Select Resource Group. Standaardwaarde: false.

Alleen van toepassing wanneer de resourcegroep virtuele machines bevat.

Als u de optie Implementatiegroep kiest, wordt de implementatiegroepagent op elk van de virtuele machines geconfigureerd.

outputVariable - resourcegroep
string.

Vereist wanneer een bestaande resourcegroep is geselecteerd. Geeft een naam op voor de resourcegroepvariabele. De variabele kan worden gebruikt als $(variableName) om te verwijzen naar de resourcegroep in volgende taken, zoals in PowerShell op doelmachines voor het implementeren van toepassingen.

Alleen geldig wanneer de geselecteerde actie is Create, Updateof Select.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Zelf-hostende agents moeten mogelijkheden hebben die overeenkomen met de volgende eisen om taken uit te voeren die gebruikmaken van deze taak: azureps:
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	1.103.0 of hoger
Taakcategorie	Implementeren

Delen via