Teilen über


AzureResourceGroupDeployment@2 – Azure-Ressourcengruppenbereitstellung v2-Aufgabe

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

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 (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Team project. 
    #deploymentGroupName: # string. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. Password. 
    #outputVariable: # string. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None). 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 (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Team project. 
    #deploymentGroupName: # string. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. Password. 
    #outputVariable: # string. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None). 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.

Eingänge

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 (Bereitstellungsoptionen für virtuelle Computer konfigurieren), Start (virtuelle Computer starten), Stop (virtuelle Computer beenden), StopWithDeallocate (virtuelle Computer beenden und verwalten), Restart (virtuelle Computer neu starten), Delete (virtuelle Computer löschen), DeleteRG (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.

Stellt den Namen der Ressourcengruppe bereit.


location -
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 - Vorlagenspeicherort
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üpfte Artefakt oder URL der Dateiaus.


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

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

Rufen Sie zum Bereitstellen einer Vorlage, die in einem privaten Speicherkonto gespeichert ist, das SAS-Token (Shared Access Signature) 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 die Azure-Dateikopie Aufgabe, oder führen Sie die Schritte mit PowerShell- oder Azure CLIaus.

Wenn Sie die Vorlagenparameter in einem Raster anzeigen möchten, klicken Sie auf ... neben dem Textfeld "Vorlagenparameter außer Kraft setzen". Dieses Feature erfordert, dass CORS-Regeln an der Quelle aktiviert sind. Wenn sich die Vorlagen in einem Azure Storage-Blob befinden, lesen Sie Grundlegendes zu CORS-Anforderungen zum Aktivieren von CORS.


Link csmParametersFileLink - Vorlagenparameter
string. Wahlfrei. Wird verwendet, 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 datei zu verwenden, die in einem privaten Speicherkonto gespeichert ist, rufen Sie das SAS-Token (Shared Access Signature) in die URL der Vorlage ab, und fügen Sie es ein. Beispiel: <blob_storage_url>/template.json?<SAStoken> Um eine Parameterdatei in ein Speicherkonto hochzuladen und ein SAS-Token zu generieren, können Sie Azure-Dateikopie Aufgabe verwenden oder die Schritte mit PowerShell- oder Azure CLIausführen.

Wenn Sie die Vorlagenparameter in einem Raster anzeigen möchten, klicken Sie auf ... neben dem Textfeld "Vorlagenparameter außer Kraft setzen". Dieses Feature erfordert, dass CORS-Regeln an der Quelle aktiviert sind. Wenn sich die Vorlagen in einem Azure Storage-Blob 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. Um sofort zu beginnen, verwenden Sie dieser Beispielvorlage.


csmParametersFile - Vorlagenparameter
string. Wahlfrei. Wird verwendet, wenn templateLocation = Linked artifact && action = Create Or Update Resource Group.

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

Um eine datei zu verwenden, die in einem privaten Speicherkonto gespeichert ist, rufen Sie das SAS-Token (Shared Access Signature) in die URL der Vorlage ab, und fügen Sie es ein. Beispiel: <blob_storage_url>/template.json?<SAStoken> Um eine Parameterdatei in ein Speicherkonto hochzuladen und ein SAS-Token zu generieren, verwenden Sie die Azure-Dateikopie Aufgabe, oder führen Sie die Schritte mit PowerShell oder Azure CLIaus.

Wenn Sie die Vorlagenparameter in einem Raster anzeigen möchten, klicken Sie auf ... neben dem Textfeld "Vorlagenparameter außer Kraft setzen". Dieses Feature erfordert, dass CORS-Regeln an der Quelle aktiviert sind. Wenn sich die Vorlagen in einem Azure Storage-Blob befinden, lesen Sie Grundlegendes zu CORS-Anforderungen zum Aktivieren von CORS.


overrideParameters - Außerkraftsetzen von Vorlagenparametern
string. Wahlfrei. Wird verwendet, wenn action = Create Or Update Resource Group.

Gibt die zu überschreibenden Vorlagenparameter an.

Wenn Sie die Vorlagenparameter in einem Raster anzeigen möchten, klicken Sie auf ... neben dem Textfeld "Parameter außer Kraft setzen". Dieses Feature erfordert, dass CORS-Regeln an 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 im Textfeld außer Kraft gesetzt 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 zeichenfolgenbasierte 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 Gültigkeitsprüfung). Standardwert: Incremental.

Der Incremental Modus behandelt Bereitstellungen als inkrementelle Aktualisierungen der Ressourcengruppe. Sie belässt unveränderte Ressourcen, die in der Ressourcengruppe vorhanden sind, aber nicht in der Vorlage angegeben sind.

Complete Modus löscht Ressourcen, die sich nicht in Ihrer Vorlage befinden. Der vollständige Modus dauert relativ viel Zeit als der inkrementelle Modus. Wenn das Zeitlimit für den Vorgang zunimmt, sollten Sie das Timeout erhöhen oder in den Incremental Modus wechseln.

Warnung

Der vollständige Modus löscht alle vorhandenen Ressourcen in der Ressourcengruppe, die nicht in der Vorlage angegeben sind. Überprüfen Sie, ob die Von Ihnen bereitgestellte Ressourcengruppe keine erforderlichen Ressourcen enthält, die nicht in der Vorlage angegeben sind.

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

Anmerkung

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

Erfahren Sie mehr über Bereitstellungsmodi.


enableDeploymentPrerequisites - Voraussetzungen aktivieren
string. Wahlfrei. Wird verwendet, wenn action = Create Or Update Resource Group || action = Select Resource Group. Zulässige Werte: None, ConfigureVMwithWinRM (Mit WinRM-Agent konfigurieren), ConfigureVMWithDGAgent (Mit Bereitstellungsgruppen-Agent konfigurieren). Standardwert: None.

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

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

Wenn Sie die WinRM-Option auswählen, wird der Windows Remote Management (WinRM)-Listener über DAS HTTPS-Protokoll auf Port 5986 mithilfe eines selbstsignierten Zertifikats konfiguriert. Diese Konfiguration ist für die Durchführung des Bereitstellungsvorgangs auf Azure-Computern erforderlich. Wenn die virtuellen Zielcomputer von einem Lastenausgleich unterstützt werden, stellen Sie sicher, dass die NAT-Regeln für den Zielport konfiguriert sind (5986).


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

Gibt die Dienstverbindung an, die mit einer Azure DevOps-Organisation oder -Sammlung für die Agentregistrierung verbunden werden soll.

Sie können eine Dienstverbindung mit +New erstellen und dann Token-based authenticationauswählen. Sie benötigen ein persönliche Zugriffstoken(PAT)-, um eine Dienstverbindung einzurichten. Klicken Sie auf Manage, um die Dienstverbindungsdetails zu aktualisieren.


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

Gibt das Teamprojekt an, das die Bereitstellungsgruppe definiert.


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

Gibt die Bereitstellungsgruppe an, für die die Agent(en) registriert werden. Erfahren Sie mehr über Bereitstellungsgruppen.


copyAzureVMTags - Kopieren von Azure VM-Tags in Agents
boolean. Wahlfrei. Wird verwendet, wenn (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Standardwert: true.

Wählt aus, ob die konfigurierten Tags auf dem virtuellen Azure-Computer in den entsprechenden Bereitstellungsgruppen-Agent kopiert werden müssen.

Standardmäßig werden alle Azure-Tags nach dem Format kopiert: Key: Value. Beispiel: Ein Role : Web Azure-Tag würde as-is auf den Agentcomputer kopiert.

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


runAgentServiceAsUser - Agentdienst als Benutzer ausführen
boolean. Wahlfrei. Wird verwendet, wenn (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Standardwert: false.

Führt den Agentdienst als anderer Benutzer als den Standardbenutzer aus, wenn der Wert auf truefestgelegt ist.

Der Standardbenutzer ist in Windows NT AUTHORITY\\SYSTEM und root in Linux.


userName - Benutzername
string. Erforderlich, wenn enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true.

Der Benutzername zum Ausführen des Agentdiensts auf den virtuellen Computern.

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

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


password - Kennwort
string. Wahlfrei. Wird verwendet, wenn enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true.

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

Es wird angenommen, dass das Kennwort für den angegebenen Benutzer auf allen virtuellen Computern identisch ist.

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

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


outputVariable - VM-Details für WinRM-
string. Wahlfrei. Wird verwendet, wenn (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None).

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

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


deploymentName - Bereitstellungsname
string. Wahlfrei. Wird verwendet, wenn action = Create Or Update Resource Group.

Gibt den Namen der zu erstellenden Ressourcengruppenbereitstellung an.


deploymentOutputs - Bereitstellungsausgabe
string. Wahlfrei. Wird verwendet, 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 PowerShell-Cmdlet ConvertFrom-Json, um das JSON-Objekt zu analysieren und auf die einzelnen Ausgabewerte zuzugreifen.


addSpnToEnvironment - Details des Access-Dienstprinzipals in Außerkraftsetzungsparametern
boolean. Wahlfrei. Wird verwendet, 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 parameter außer Kraft setzen, z. B. -key $servicePrincipalKey.


useWithoutJSON - Einzelne Ausgabewerte ohne JSON verwenden. Stringify angewendete
boolean. Wahlfrei. Wird verwendet, wenn action = Create Or Update Resource Group. Standardwert: false.

Einzelne Ausgabewerte werden über JSON konvertiert. Standardmäßig Zeichenfolgen zeichenfolgen. Wenn Sie die Ausgabewerte wie sie verwenden möchten, ohne sie über JSON zu konvertieren. "Stringify" aktivieren Sie diese Option. Weitere Informationen finden Sie in diesem.


Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Nichts.

Bemerkungen

Es gibt eine neue Version dieser Aufgabe unter AzureResourceManagerTemplateDeployment@3 – ARM-Vorlagenbereitstellung v3 Task.

Neuerungen in Aufgabenversion 2

  • Arbeitet mit plattformübergreifenden Agents (Linux, macOS oder Windows)
  • Unterstützt Vorlagen-JSONs, die sich auf öffentlich zugänglichen HTTP/HTTPS-URLs befinden.
  • Erweiterte UX 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.
  • Begrenzungen:
    • Keine Unterstützung für klassische Abonnements. Nur ARM-Abonnements werden unterstützt.
    • Keine Unterstützung für die PowerShell-Syntax, da die Aufgabe jetzt node.js basiert. Stellen Sie sicher, dass die Groß-/Kleinschreibung der Parameternamen übereinstimmen, 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.

Fehlerbehebung

Fehler: Interner Serverfehler

Diese Probleme sind meist vorübergehend. Es gibt mehrere Gründe, warum es passieren könnte:

  • Einer der Azure-Dienste, die Sie bereitstellen möchten, wird in der Region gewartet, in der Sie bereitstellen möchten. Achten Sie auf https://status.azure.com/, um Ausfallzeiten von Azure Services zu überprüfen.
  • Der Azure Pipelines-Dienst selbst durchläuft wartung. Achten Sie auf https://status.dev.azure.com/ auf Ausfallzeiten.

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

Fehler: Timeout

Timeoutprobleme können an zwei Stellen auftreten:

  • Azure Pipelines Agent
  • Portalbereitstellung

Sie können ermitteln, ob das Timeout über das Portal erfolgt, indem Sie den Link zur Portalbereitstellung überprüfen, der sich in den Aufgabenprotokollen befindet. Wenn keine Verknüpfung vorhanden ist, liegt dies wahrscheinlich an Azure Pipelines-Agent. Wenn ein Link vorhanden ist, folgen Sie dem Link, um festzustellen, ob in der Portalbereitstellung ein Timeout aufgetreten ist.

Fehler: CORS-Regeln, die beim Überschreiben von Parametern aktiviert werden sollen

Wenn auf die Vorlagendatei von 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.

Dieses Feature erfordert, dass die CORS-Regeln an der Quelle aktiviert werden. Wenn sich Vorlagen im Azure Storage-Blob befinden, lesen Sie Unterstützung für die cross-origin-Ressourcenfreigabe, um CORS zu aktivieren.

Stellen Sie neben der Aktivierung von CORS sicher, dass das im Link der Vorlage angegebene SAS-Token "srt-sco" lautet. Dieses Token ist erforderlich, damit Sie die Datei herunterladen und fortfahren können.

Azure Pipelines Agent

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

Portalbereitstellung

In diesem Dokument erfahren Sie, wie Sie ermitteln können, ob der Fehler aus dem Azure-Portal stammt: Anzeigen des Bereitstellungsverlaufs mit Azure Resource Manager.

Versuchen Sie bei der Portalbereitstellung, "timeoutInMinutes" in der ARM-Vorlage auf "0" festzulegen. Wenn nicht angegeben, beträgt der angenommene Wert 60 Minuten. 0 stellt sicher, dass die Bereitstellung so lange ausgeführt wird, wie sie erfolgreich sein kann.

Dies kann auch aufgrund vorübergehender Probleme im System auftreten. Achten Sie auf https://status.dev.azure.com/, um zu überprüfen, ob es eine Ausfallzeit im Azure Pipelines-Dienst gibt.

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

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

Dieses Problem kann auch aufgrund von mehrzeilen Zeichenfolgen auftreten. Derzeit unterstützt die Azure-Ressourcengruppenbereitstellungsaufgabe keine mehrstufigen Zeichenfolgen in einer ARM-Vorlage oder Parameter-JSON-Datei.

Darüber hinaus finden Sie in diesem Artikel informationen zur Struktur und Syntax von ARM-Vorlagen: Grundlegendes zur Struktur und Syntax von ARM-Vorlagen.

Anforderungen

Anforderung Beschreibung
Pipelinetypen YAML, Classic Build, Classic Release
Läuft auf Agent, DeploymentGroup
Anforderungen Nichts
Funktionen Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen Jegliche
Settable-Variablen Jegliche
Agentversion 2.119.1 oder höher
Vorgangskategorie Aufstellen