Freigeben über

AzureResourceGroupDeployment@2: Azure-Ressourcengruppenbereitstellung v2-Aufgabe

  • Artikel

Stellen Sie eine Azure Resource Manager(ARM)-Vorlage für eine Ressourcengruppe bereit, und verwalten Sie virtuelle Computer.

Stellen Sie eine Arm-Vorlage (Azure Resource Manager) für eine Ressourcengruppe bereit. Sie können auch alle Virtual Machines (VM) in einer Ressourcengruppe starten, beenden, löschen und verwalten.

Syntax

# Azure resource group deployment v2
# Deploy an Azure Resource Manager (ARM) template to a resource group and manage virtual machines.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. VM details for WinRM. 
  # Advanced
    #deploymentName: # string. Optional. Use when action = Create Or Update Resource Group. Deployment name. 
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs. 
    #addSpnToEnvironment: false # boolean. Optional. Use when action = Create Or Update Resource Group. Access service principal details in override parameters. Default: false.
    #useWithoutJSON: false # boolean. Optional. Use when action = Create Or Update Resource Group. Use individual output values without JSON.Stringify applied. Default: false.

# Azure resource group deployment v2
# Deploy an Azure Resource Manager (ARM) template to a resource group and manage virtual machines.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. VM details for WinRM. 
  # Advanced
    #deploymentName: # string. Optional. Use when action = Create Or Update Resource Group. Deployment name. 
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs. 
    #addSpnToEnvironment: false # boolean. Optional. Use when action = Create Or Update Resource Group. Access service principal details in override parameters. Default: false.

# Azure Resource Group Deployment v2
# Deploy an Azure resource manager (ARM) template to a resource group. You can also start, stop, delete, deallocate all Virtual Machines (VM) in a resource group.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines/TFS service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. VM details for WinRM. 
  # Outputs
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs.

Eingaben

azureSubscription - Azure-Abonnement
Eingabealias: ConnectedServiceName. string. Erforderlich.

Wählt die Dienstverbindung aus, die ein Azure-Abonnement für die Bereitstellung enthält.


action - Aktion
string. Erforderlich. Zulässige Werte: Create Or Update Resource Group, Select Resource Group (Konfigurieren der Bereitstellungsoptionen für virtuelle Computer), Start (Virtuelle Computer starten), Stop (Virtuelle Computer beenden), StopWithDeallocate (Beenden und Zuordnung virtueller Computer), Restart (Virtuelle Computer neu starten), (Virtuelle Computer löschen), DeleteDeleteRG (Ressourcengruppe löschen). Standardwert. Create Or Update Resource Group.

Die Aktion, die für die Azure-Ressourcen oder -Ressourcengruppe ausgeführt werden soll.


resourceGroupName - Ressourcengruppe
string. Erforderlich.

Gibt den Namen der Ressourcengruppe an.


location - Lage
string. Erforderlich, wenn action = Create Or Update Resource Group.

Der Speicherort, an dem die Ressourcengruppe bereitgestellt werden soll. Wenn die Ressourcengruppe bereits im Abonnement vorhanden ist, wird dieser Wert ignoriert.


templateLocation - Speicherort der Vorlage
string. Erforderlich, wenn action = Create Or Update Resource Group. Zulässige Werte: Linked artifact, URL of the file. Standardwert. Linked artifact.

Wählen Sie entweder Verknüpftes Artefakt oder die URL der Datei aus.


csmFileLink - Vorlagenlink
string. Erforderlich, wenn templateLocation = URL of the file && action = Create Or Update Resource Group.

Gibt die URL der Vorlagendatei an. Eine Beispiel-URL: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.json

Um eine in einem privaten Speicherkonto gespeicherte Vorlage bereitzustellen, rufen Sie das SAS-Token (Shared Access Signature) ab, und fügen Sie es in die URL der Vorlage ein. Beispiel: <blob_storage_url>/template.json?<SAStoken>

Um eine Vorlagendatei (oder eine verknüpfte Vorlage) in ein Speicherkonto hochzuladen und ein SAS-Token zu generieren, verwenden Sie den Azure-Dateikopiertask , oder führen Sie die Schritte mithilfe von PowerShell oder der Azure CLI aus.

Um die Vorlagenparameter in einem Raster anzuzeigen, klicken Sie neben ... dem Textfeld Vorlagenparameter außer Kraft setzen auf. Diese Funktion erfordert, dass CORS-Regeln in der Quelle aktiviert sind. Wenn sich die Vorlagen in einem Azure-Speicherblob befinden, lesen Sie Grundlegendes zu CORS-Anforderungen zum Aktivieren von CORS.


csmParametersFileLink - Link zu Vorlagenparametern
string. Optional. Verwenden Sie , wenn templateLocation = URL of the file && action = Create Or Update Resource Group.

Gibt die URL der Parameterdatei an. Beispiel: https://raw.githubusercontent.com/Azure/...

Um eine in einem privaten Speicherkonto gespeicherte Datei zu verwenden, rufen Sie das SAS-Token (Shared Access Signature) ab und fügen es in die URL der Vorlage ein. Beispiel: <blob_storage_url>/template.json?<SAStoken> Um eine Parameterdatei in ein Speicherkonto hochzuladen und ein SAS-Token zu generieren, können Sie den Azure-Dateikopiertask verwenden oder die Schritte mithilfe von PowerShell oder der Azure CLI ausführen.

Um die Vorlagenparameter in einem Raster anzuzeigen, klicken Sie neben ... dem Textfeld Vorlagenparameter außer Kraft setzen auf. Diese Funktion erfordert, dass CORS-Regeln in der Quelle aktiviert sind. Wenn sich die Vorlagen in einem Azure-Speicherblob befinden, lesen Sie Grundlegendes zu CORS-Anforderungen zum Aktivieren von CORS.


csmFile - Vorlage
string. Erforderlich, wenn templateLocation = Linked artifact && action = Create Or Update Resource Group.

Gibt den Pfad oder ein Muster an, das auf die Azure Resource Manager-Vorlage verweist. Erfahren Sie mehr über Azure Resource Manager-Vorlagen. Verwenden Sie diese Beispielvorlage, um sofort loszulegen.


csmParametersFile - Vorlagenparameter
string. Optional. Verwenden Sie , wenn templateLocation = Linked artifact && action = Create Or Update Resource Group.

Gibt die URL der Parameterdatei an. Eine Beispiel-URL: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

Um eine in einem privaten Speicherkonto gespeicherte Datei zu verwenden, rufen Sie das SAS-Token (Shared Access Signature) ab und fügen es in die URL der Vorlage ein. Beispiel: <blob_storage_url>/template.json?<SAStoken> Um eine Parameterdatei in ein Speicherkonto hochzuladen und ein SAS-Token zu generieren, verwenden Sie den Azure-Dateikopiertask , oder führen Sie die Schritte mithilfe von PowerShell oder der Azure CLI aus.

Um die Vorlagenparameter in einem Raster anzuzeigen, klicken Sie neben ... dem Textfeld Vorlagenparameter außer Kraft setzen auf. Diese Funktion erfordert, dass CORS-Regeln in der Quelle aktiviert sind. Wenn sich die Vorlagen in einem Azure-Speicherblob befinden, lesen Sie Grundlegendes zu CORS-Anforderungen zum Aktivieren von CORS.


overrideParameters - Überschreiben von Vorlagenparametern
string. Optional. Verwenden Sie , wenn action = Create Or Update Resource Group.

Gibt die zu überschreibenden Vorlagenparameter an.

Um die Vorlagenparameter in einem Raster anzuzeigen, klicken Sie neben ... dem Textfeld Parameter außer Kraft setzen auf. Diese Funktion erfordert, dass CORS-Regeln in der Quelle aktiviert sind. Wenn sich die Vorlagen im Azure Storage-Blob befinden, verweisen Sie auf diese Zeichenfolge, um CORS zu aktivieren, oder geben Sie die Vorlagenparameter ein, die in das Textfeld überschrieben werden sollen.

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

Wenn der Parameterwert mehrere Wörter enthält, schließen Sie die Wörter in Anführungszeichen ein, auch wenn Sie den Wert mithilfe von Variablen übergeben. Beispiel: -name "parameter value" -name2 "$(var)". Verwenden Sie zum Überschreiben von Objekttypparametern zeichenfolgenifizierte JSON-Objekte. Beispiel: -options ["option1"] -map {"key1": "value1" }.


deploymentMode - Bereitstellungsmodus
string. Erforderlich, wenn action = Create Or Update Resource Group. Zulässige Werte: Incremental, Complete, Validation (nur Validierung). Standardwert. Incremental.

Der Incremental Modus verarbeitet Bereitstellungen als inkrementelle Updates für die Ressourcengruppe. Ressourcen, die in der Ressourcengruppe vorhanden, aber nicht in der Vorlage angegeben sind, bleiben unverändert.

Der Complete-Modus löscht Ressourcen, die sich nicht in Ihrer Vorlage befinden. Der vollständige Modus benötigt relativ mehr Zeit als der inkrementelle Modus. Wenn für die Aufgabe ein Timeout auftritt, sollten Sie das Timeout erhöhen oder in den Incremental Modus wechseln.

Warnung

Im Vollständigen Modus werden alle vorhandenen Ressourcen in der Ressourcengruppe gelöscht, die nicht in der Vorlage angegeben sind. Überprüfen Sie, ob die Ressourcengruppe, für die Sie bereitstellen, keine erforderlichen Ressourcen enthält, die in der Vorlage nicht angegeben sind.

Validate im Modus können Sie Probleme mit der Vorlage finden, bevor Sie tatsächliche Ressourcen erstellen.

Hinweis

Der Validate Modus erstellt immer eine Ressourcengruppe, auch wenn keine Ressourcen bereitgestellt werden.

Erfahren Sie mehr über Bereitstellungsmodi.


enableDeploymentPrerequisites - Voraussetzungen aktivieren
string. Optional. Verwenden Sie , wenn action = Create Or Update Resource Group || action = Select Resource Group. Zulässige Werte: None, ConfigureVMwithWinRM (Konfigurieren mit WinRM-Agent), ConfigureVMWithDGAgent (Konfigurieren mit Bereitstellungsgruppen-Agent). Standardwert. None.

Gilt nur, wenn die Ressourcengruppe virtuelle Computer enthält.

Wenn Sie die Option Bereitstellungsgruppe auswählen, wird der Bereitstellungsgruppen-Agent auf jedem der virtuellen Computer konfiguriert.

Wenn Sie die WinRM-Option auswählen, wird der Windows-Remoteverwaltungslistener (WinRM) über HTTPS-Protokoll an Port 5986 mithilfe eines selbstsignierten Zertifikats konfiguriert. Diese Konfiguration ist für die Ausführung von Bereitstellungsvorgängen auf Azure-Computern erforderlich. Wenn die virtuellen Zielcomputer von einem Lastenausgleich unterstützt werden, stellen Sie sicher, dass die NAT-Regeln für eingehenden Datenverkehr für den Zielport (5986) konfiguriert sind.


teamServicesConnection - Azure Pipelines-Dienstverbindung
Eingabealias: deploymentGroupEndpoint. string. Erforderlich, wenn enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Gibt die Dienstverbindung an, mit der eine Verbindung mit einer Azure DevOps-organization oder -Sammlung für die Agentregistrierung hergestellt werden soll.

Sie können eine Dienstverbindung mit +New erstellen und dann auswählen Token-based authentication. Sie benötigen ein persönliches Zugriffstoken (Personal Access Token, PAT), um eine Dienstverbindung einzurichten. Klicken Sie hier Manage , um die Dienstverbindungsdetails zu aktualisieren.


teamServicesConnection - Azure Pipelines/TFS-Dienstverbindung
Eingabealias: deploymentGroupEndpoint. string. Erforderlich, wenn enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Gibt die Dienstverbindung an, mit der eine Verbindung mit einer Azure DevOps-organization oder -Sammlung für die Agentregistrierung hergestellt werden soll.

Sie können eine Dienstverbindung mit +New erstellen und dann auswählen Token-based authentication. Sie benötigen ein persönliches Zugriffstoken (Personal Access Token, PAT), um eine Dienstverbindung einzurichten. Klicken Sie hier Manage , um die Dienstverbindungsdetails zu aktualisieren.


teamProject - Teamprojekt
Eingabealias: project. string. Erforderlich, wenn enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Gibt das Teamprojekt an, das die Bereitstellungsgruppe definiert.


deploymentGroupName - Bereitstellungsgruppe
string. Erforderlich, wenn enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Gibt die Bereitstellungsgruppe an, für die die Agents registriert werden. Erfahren Sie mehr über Bereitstellungsgruppen.


copyAzureVMTags - Kopieren von Azure-VM-Tags in Agents
boolean. Optional. Verwenden Sie , wenn enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Standardwert. true.

Gibt an, ob die konfigurierten Tags auf der Azure-VM in den entsprechenden Bereitstellungsgruppen-Agent kopiert werden müssen.

Standardmäßig werden alle Azure-Tags im folgenden Format kopiert: Key: Value. Beispiel: Ein Role : Web Azure-Tag wird unverändert auf den Agent-Computer kopiert.

Erfahren Sie mehr über die Verwendung von Tags für Azure-Ressourcen.


runAgentServiceAsUser - Ausführen des Agent-Diensts als Benutzer
boolean. Optional. Verwenden Sie , wenn enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Standardwert. false.

Führt den Agent-Dienst als anderen Benutzer als den Standardbenutzer aus, wenn der Wert auf truefestgelegt ist.

Der Standardbenutzer befindet sich NT AUTHORITY\\SYSTEM unter Windows und root unter Linux.


userName - Benutzername
string. Erforderlich, wenn enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

Der Benutzername zum Ausführen des Agent-Diensts auf den virtuellen Computern.

Geben Sie für Domänenbenutzer Werte als domain\username oder username@domain.coman. Geben Sie für lokale Benutzer an username.

Es wird davon ausgegangen, dass derselbe Domänenbenutzer bzw. ein lokaler Benutzer mit demselben Namen auf allen virtuellen Computern in der Ressourcengruppe vorhanden ist.


password - Passwort
string. Optional. Verwenden Sie , wenn enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

Das Kennwort für den Benutzer zum Ausführen des Agent-Diensts auf den Windows-VMs.

Es wird davon ausgegangen, dass das Kennwort für den angegebenen Benutzer auf allen VMs identisch ist.

Sie kann Variablen akzeptieren, die in Build- oder Releasepipelines als $(passwordVariable)definiert sind. Sie können die Variable als secret sichern markieren.

Für Linux-VMs ist kein Kennwort erforderlich und wird ignoriert.


outputVariable - VM-Details für WinRM
string. Optional. Verwenden Sie , wenn enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group.

Erforderlich, wenn eine vorhandene Ressourcengruppe ausgewählt wird. Stellt einen Namen für die Ressourcengruppenvariable bereit. Die Variable kann als $(variableName) verwendet werden, um auf die Ressourcengruppe in nachfolgenden Aufgaben zu verweisen, z. B. im Task PowerShell auf Zielcomputern zum Bereitstellen von Anwendungen.

Nur gültig, wenn die ausgewählte Aktion , Updateoder SelectistCreate.


deploymentName - Bereitstellungsname
string. Optional. Verwenden Sie , wenn action = Create Or Update Resource Group.

Gibt den Namen der zu erstellenden Ressourcengruppenbereitstellung an.


deploymentOutputs - Bereitstellungsausgaben
string. Optional. Verwenden Sie , wenn action = Create Or Update Resource Group.

Stellt einen Namen für die Ausgabevariable bereit, die den Ausgabeabschnitt des aktuellen Bereitstellungsobjekts im Zeichenfolgenformat enthält. Verwenden Sie das ConvertFrom-Json PowerShell-Cmdlet, um das JSON-Objekt zu analysieren und auf die einzelnen Ausgabewerte zuzugreifen.


addSpnToEnvironment - Zugriff auf Dienstprinzipaldetails in Außerkraftsetzungsparametern
boolean. Optional. Verwenden Sie , wenn action = Create Or Update Resource Group. Standardwert. false.

Fügt die Dienstprinzipal-ID und den Schlüssel des Azure-Endpunkts hinzu, der als Ausführungsumgebung des Skripts ausgewählt wurde. Die Variablen $servicePrincipalId und $servicePrincipalKey können in Außerkraftsetzungsparametern enthalten sein, z. B -key $servicePrincipalKey. .


useWithoutJSON - Verwenden Sie einzelne Ausgabewerte ohne JSON. Stringify angewendet
boolean. Optional. Verwenden Sie , wenn action = Create Or Update Resource Group. Standardwert. false.

Einzelne Ausgabewerte werden über JSON konvertiert. Standardmäßig stringify. Wenn Sie die Ausgabewerte so verwenden möchten, wie sie sind, ohne sie per JSON zu konvertieren. Stringify aktivieren Sie diese Option. Weitere Informationen finden Sie hier.


Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Eine neue Version dieser Aufgabe ist unter AzureResourceManagerTemplateDeployment@3 verfügbar: ARM-Vorlagenbereitstellung v3.

Neuerungen in Taskversion 2

  • Funktioniert mit plattformübergreifenden Agents (Linux, macOS oder Windows)
  • Unterstützt Vorlagen-JSONs, die sich an allen öffentlich zugänglichen HTTP/HTTPS-URLs befinden.
  • Erweiterte Benutzeroberfläche für Außerkraftsetzungsparameter, die jetzt in einem Raster angezeigt/bearbeitet werden können.
  • NAT-Regelzuordnung für VMs, die von einem Lastenausgleich unterstützt werden.
  • Das Feld "Ressourcengruppe" wird jetzt in "VM-Details für WinRM" umbenannt und ist im Abschnitt "Erweiterte Bereitstellungsoptionen für virtuelle Computer" enthalten.
  • Einschränkungen:
    • Keine Unterstützung für klassische Abonnements. Es werden nur ARM-Abonnements unterstützt.
    • PowerShell-Syntax wird nicht unterstützt, da die Aufgabe jetzt node.js basiert. Stellen Sie sicher, dass die Groß-/Kleinschreibung der Parameternamen übereinstimmt, wenn Sie die Vorlagenparameter überschreiben. Entfernen Sie außerdem die PowerShell-Cmdlets wie "ConvertTo-SecureString", wenn Sie von Version 1.0 zu Version 2.0 migrieren.

Problembehandlung

Fehler: Interner Serverfehler

Diese Probleme sind zumeist vorübergehend. Dieses Problem kann aus verschiedenen Gründen auftreten:

  • Einer der Azure-Dienste, die Sie bereitstellen möchten, wird in der Region gewartet, in der Sie die Bereitstellung durchführen möchten. Achten Sie darauf https://status.azure.com/ , die Ausfallzeiten von Azure Services zu überprüfen.
  • Der Azure Pipelines-Dienst selbst wird gewartet. Achten Sie auf den https://status.dev.azure.com/ bei Downtimes.

Wir haben jedoch einige Fälle gesehen, in denen dies auf einen Fehler in der ARM-Vorlage zurückzuführen ist, z. B. wenn der Azure-Dienst, den Sie bereitstellen möchten, die Region nicht unterstützt, die Sie für die Ressource ausgewählt haben.

Fehler: Timeout

Timeoutprobleme können aus zwei Quellen stammen:

  • Azure Pipelines-Agent
  • Bereitstellung über das Portal

Sie können feststellen, ob das Timeout aus dem Portal stammt, indem Sie nach dem Link zur Bereitstellung im Portal suchen, der sich in den Taskprotokollen befindet. Wenn kein Link vorhanden ist, ist dies wahrscheinlich auf den Azure Pipelines-Agent zurückzuführen. Wenn ein Link vorhanden ist, folgen Sie ihm, um festzustellen, ob in der Portalbereitstellung ein Timeout aufgetreten ist.

Fehler: CORS-Regeln müssen beim Überschreiben von Parametern aktiviert werden

Wenn auf die Vorlagendatei aus einem BLOB verwiesen wird, während Parameter in der Pipeline überschrieben werden, wird möglicherweise die folgende Warnmeldung angezeigt:

Warning: Failed to download the file from template path.

Diese Funktion erfordert, dass CORS-Regeln in der Quelle aktiviert sind. Wenn sich Vorlagen in einem Azure-Speicherblob befinden, finden Sie weitere Informationen zum Aktivieren von CORS-Regeln unter Unterstützung von ursprungsübergreifender Ressourcenfreigabe.

Neben der Aktivierung von CORS müssen Sie sicherstellen, dass das im Link der Vorlage angegebene SAS-Token "srt-sco" lautet. Dieses Token ist erforderlich, damit Sie die Datei herunterladen und den Vorgang fortsetzen können.

Azure Pipelines-Agent

Wenn das Problem vom Azure Pipelines-Agenten ausgeht, können Sie den Timeout erhöhen, indem Sie timeoutInMinutes als Schlüssel in der YAML auf 0 setzen. Weitere Informationen finden Sie unter Angeben von Aufträgen in Ihrer Pipeline.

Bereitstellung über das Portal

In diesem Dokument erfahren Sie, wie Sie ermitteln, ob der Fehler vom Azure-Portal: Anzeigen des Bereitstellungsverlaufs mit Azure Resource Manager stammt.

Versuchen Sie im Falle einer Portalbereitstellung, "timeoutInMinutes" in der ARM-Vorlage auf "0" zu setzen. Wenn keine Angabe erfolgt, beträgt der angenommene Wert 60 Minuten. 0 stellt sicher, dass die Bereitstellung so lange wie möglich ausgeführt wird, um erfolgreich zu sein.

Dies kann auch aufgrund vorübergehender Probleme im System auftreten. Achten Sie darauf https://status.dev.azure.com/, ob es zu Ausfallzeiten im Azure Pipelines-Dienst kommt.

Fehler: Fehler bei der Überprüfung der ARM-Vorlage (Azure Resource Manager)

Dieses Problem tritt hauptsächlich aufgrund eines ungültigen Parameters in der ARM-Vorlage auf, z. B. aufgrund einer nicht unterstützten SKU oder Region. Wenn die Überprüfung fehlschlägt, überprüfen Sie die Fehlermeldung. Sie sollte auf die Ressource und den Parameter verweisen, die ungültig sind.

Dieses Problem kann auch aufgrund von mehrzeiligen Zeichenfolgen auftreten. Derzeit unterstützt der Bereitstellungstask für Azure-Ressourcengruppen keine mehrzeiligen Zeichenfolgen in einer ARM-Vorlage oder einer JSON-Parameterdatei.

Lesen Sie außerdem diesen Artikel zur Struktur und Syntax von ARM-Vorlagen: Grundlegendes zur Struktur und Syntax von ARM-Vorlagen.

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf Agent, DeploymentGroup
Forderungen Keine
Capabilities Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen Any
Setzbare Variablen Any
Agent-Version 2.119.1 oder höher
Aufgabenkategorie Bereitstellen