Delen via

AzureResourceGroupDeployment@1 - Implementatie van Azure-resourcegroep v1-taak

  • Artikel

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

Deze taak is afgeschaft. gebruik 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.

Invoerwaarden

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

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


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

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


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

Selecteert een klassiek Azure-abonnement voor de implementatie.


action - Actie
string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceName. Toegestane waarden: , , (Virtual Machines starten), Stop (Virtual Machines stoppen), Restart (Virtual Machines opnieuw starten), Delete (Virtual Machines verwijderen) DeleteRG (Resourcegroep verwijderen). StartSelect Resource GroupCreate Or Update Resource Group 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 (Selecteer Cloudservice). Standaardwaarde: Select Resource Group.

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


resourceGroupName - Resourcegroep
string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceName.

Geeft 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, , Canada CentralBrazil South, Canada East, Central India, Central US, East Asia, East US 2 Japan WestEast USSouth Central USNorth Central USNorth EuropeJapan East, South India, Southeast Asia, , . West US 2UK SouthUK WestWest Central USWest EuropeWest IndiaWest US Standaardwaarde: East US.

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


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

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


csmParametersFile - Sjabloonparameters
string. Optioneel. Gebruik 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 en neemt u dit op in de URL van de sjabloon. Voorbeeld: <blob_storage_url>/template.json?<SAStoken> als u een parameterbestand wilt uploaden naar een opslagaccount en een SAS-token wilt genereren, gebruikt u de Azure-taak voor het kopiëren van bestanden of volgt u de stappen met PowerShell of Azure CLI.

Als u de sjabloonparameters in een raster wilt weergeven, klikt u op … naast het tekstvak parameters voor onderdrukkingssjablonen. 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.


overrideParameters - Sjabloonparameters overschrijven
string. Optioneel. Gebruik 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.

Bijvoorbeeld: -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 objecttypeparameters wilt overschrijven, gebruikt u tekenreeks-JSON-objecten. 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 over die aanwezig zijn in de resourcegroep, maar die niet zijn opgegeven in de sjabloon.

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

Waarschuwing

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

Validate met de 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. Optioneel. Gebruik wanneer action = Create Or Update Resource Group. Standaardwaarde: false.

Alleen van toepassing wanneer de resourcegroep virtuele machines bevat.

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

Als u de optie WinRM selecteert, configureert u de WinRM-listener (Windows Remote Management) via het HTTPS-protocol op poort 5986 met behulp van een zelfondertekend certificaat. Deze configuratie is vereist voor het uitvoeren van implementatiebewerkingen op Azure-machines. Als de virtuele doelmachines worden ondersteund door een load balancer, moet u ervoor zorgen dat de inkomende NAT-regels zijn geconfigureerd voor de doelpoort (5986).


enableDeploymentPrerequisitesForSelect - Implementatievereisten inschakelen
boolean. Optioneel. Gebruik wanneer action = Select Resource Group. Standaardwaarde: false.

Alleen van toepassing wanneer de resourcegroep virtuele machines bevat.

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

Als u de optie WinRM selecteert, configureert u de WinRM-listener (Windows Remote Management) via het HTTPS-protocol op poort 5986 met behulp van een zelfondertekend certificaat. Deze configuratie is vereist voor het uitvoeren van implementatiebewerkingen op Azure-machines. Als de virtuele doelmachines worden ondersteund door een load balancer, moet u ervoor zorgen dat de inkomende NAT-regels zijn geconfigureerd voor de doelpoort (5986).


outputVariable - Resourcegroep
string.

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

Alleen geldig als de geselecteerde actie , Updateof SelectisCreate.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Vereisten

Vereiste Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
Eisen Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten om taken uit te voeren die deze taak gebruiken: azureps
Functies Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Alle
Instelbare variabelen Alle
Agentversie 1.103.0 of hoger
Taakcategorie Implementeren