Azure Pipelines Task Reference

Eine Aufgabe führt eine Aktion in einer Pipeline aus. Zum Beispiel kann eine Aufgabe eine App bauen, mit Azure-Ressourcen interagieren, ein Tool installieren oder einen Test durchführen. Aufgaben sind die Bausteine zum Definieren der Automatisierung in einer Pipeline.

Die Artikel in diesem Abschnitt beschreiben die integrierten Aufgaben für Azure Pipelines und legen die Semantik für Attribute fest, die für jede Aufgabe eine besondere Bedeutung haben.

Weitere Informationen zu den allgemeinen Attributen, die von Aufgaben unterstützt werden, finden Sie in der YAML-Referenz für steps.task.

Für Anleitungen und Tutorials zum Erstellen von Pipelines mit Aufgaben, einschließlich des Erstellen benutzerdefinierter Aufgaben, benutzerdefinierter Erweiterungen und des Findens von Aufgaben im Visual Studio Marketplace, siehe Aufgaben-Konzepte und Azure Pipelines Dokumentation.

Quelloffen

Diese Aufgaben sind Open Source on GitHub. Feedback und Beiträge sind willkommen. Eine Liste der Vorgangsänderungen, einschließlich eines historischen Datensatzes von Vorgangsaktualisierungen, finden Sie unter Änderungsprotokoll für Pipelineaufgaben.

Häufig gestellte Fragen

Was sind Aufgabeneingabealiasen?

Eingaben für einen Vorgang werden durch eine label, nameund können eine oder mehrere optionale aliasesenthalten. Das folgende Beispiel ist ein Auszug aus dem Quellcode für den Eintrag für bekannte Hosts Eingabe der InstallSSHKey@0 Aufgabe.

{
    "name": "hostName",
    "aliases": [
        "knownHostsEntry"
    ],
    "label": "Known Hosts Entry"
    ...
}

Bevor YAML-Pipelines 2019 eingeführt wurden, wurden Pipelines mit einem UI-basierten Pipeline-Editor erstellt und bearbeitet, und nur die label wurde von Pipelineautoren verwendet, um auf eine Aufgabeneingabe zu verweisen.

Als YAML-Pipelines 2019 eingeführt wurden, begannen Pipelineautoren, die YAML verwenden, die Aufgabeneingabe zu verwenden, name, um auf eine Aufgabeneingabe zu verweisen. In einigen Fällen waren die Eingabenamen der Aufgabe nicht beschreibend, daher wurden aliases hinzugefügt, um zusätzliche beschreibende Namen für Aufgabeneingaben bereitzustellen.

Beispielsweise verfügt die aufgabe InstallSSHKey@0 über einen Eintrag für bekannte Hosts Eingabe mit dem Namen hostName, der einen Eintrag aus einer known_hosts Datei erwartet. Der Eintrag für bekannte Hosts Bezeichnung im klassischen Pipeline-Designer macht dies deutlich, ist aber bei Verwendung des hostName Namens in einer YAML-Pipeline nicht so klar. Aufgabeneingabealiasen wurden eingeführt, damit Aufgabenautoren dekriptive Namen für ihre zuvor erstellten Aufgaben bereitstellen können, und für die InstallSSHKey@0 Aufgabe wurde ein knownHostsEntryAliashinzugefügt, während der ursprüngliche hostName Name zur Kompatibilität mit vorhandenen Pipelines mit diesem Namen beibehalten wurde.

Alle Elemente in der aliases einer Vorgangseingabe sind austauschbar mit dem name in einer YAML-Pipeline. Die folgenden beiden YAML-Codeausschnitte sind funktional identisch, wobei das erste Beispiel den knownHostsEntry Alias und das zweite Beispiel mit hostNameverwendet.

- task: InstallSSHKey@0
  inputs:
    # Using knownHostsEntry alias
    knownHostsEntry: 'sample known hosts entry line'
    # Remainder of task inputs omitted

- task: InstallSSHKey@0
  inputs:
    # Using hostName name
    hostName: 'sample known hosts entry line'
    # Remainder of task inputs omitted

Ab Azure DevOps Server 2019.1 wurde der YAML-Pipeline-Editor eingeführt, der eine Intellisense-ähnliche Funktionalität bietet.

Der YAML-Pipeline-Editor verwendet die Yamlschema - Abrufen REST-API, um das Schema abzurufen, das für die Überprüfung im Editor verwendet wird. Wenn eine Aufgabeneingabe über einen Alias verfügt, wird der Alias vom Schema zum primären YAML-Namen für die Aufgabeneingabe hergeleitet, und der Alias wird vom IntelliSense vorgeschlagen.

Das folgende Beispiel ist die Eingabe bekannter Hosts Vorgangseingabe für die aufgabe InstallSSHKey@0 aus dem YAML-Schema, wobei knownHostsEntry in der Namensposition und hostName in der aliases-Auflistung aufgeführt sind.

"properties": {
    "knownHostsEntry": {
      "type": "string",
      "description": "Known Hosts Entry",
      "ignoreCase": "key",
      "aliases": [
        "hostName"
      ]
    },

Da der IntelliSense im YAML-Pipeline-Editor knownHostsEntryanzeigt und das vom Aufgaben-Assistenten generierte YAMLknownHostsEntry im generierten YAML verwendet, zeigt der Aufgabenverweis die alias aus dem Aufgabenquellcode als YAML-Namen für eine Aufgabeneingabe an. Wenn eine Aufgabe mehrere Aliase enthält (es gibt ein paar Aliase, die zwei Aliase aufweisen), wird der erste Alias als Name verwendet.

Warum hat sich die Vorgangsreferenz geändert?

Die Azure Pipelines-Aufgaben referenzieren auf die Dokumentation wurden an ihren aktuellen Standort verschoben, um die folgenden Verbesserungen zu unterstützen.

• Aufgabenartikel werden mit dem Task-Quellcode aus dem Azure Pipelines tasks Open Source Repository generiert.
• Aufgabeneingabenamen und Aliase werden aus der Aufgabenquelle generiert, sodass sie immer auf dem neuesten Stand sind.
• YAML-Syntaxblöcke werden aus der Aufgabenquelle generiert, sodass sie auf dem neuesten Stand sind.
• Unterstützt Communitybeiträge mit integrierten Benutzerinhalten wie erweiterte Aufgabeneingabebeschreibungen, Anmerkungen und Beispiele.
• Bietet Aufgabenabdeckung für alle unterstützten Azure DevOps-Versionen.
• Jeder Sprint wurde aktualisiert, um die neuesten Updates abzudecken.

Informationen zum Beitragen finden Sie unter Beitragen zu den Aufgabeninhalten.

Wo kann ich schrittweise erfahren, wie ich meine App erstellen kann?

Erstellen Ihrer App-

Kann ich meine eigenen Buildaufgaben hinzufügen?

Ja: Hinzufügen einer Buildaufgabe

Was sind Installationsaufgaben?

Weitere Informationen zu Toolinstallationsaufgaben finden Sie unter Tool installers.

Vorherige Versionen

• Azure DevOps Server 2020.1 Aufgabenreferenz
• Azure DevOps Server 2020 Aufgabenreferenz
• Azure DevOps Server 2019.1 Aufgabenreferenz
• Azure DevOps Server 2019 Task Reference
• TFS 2018 Aufgabenreferenz