Azure Pipelines-Aufgabenreferenz

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

In den Artikeln in diesem Abschnitt werden die integrierten Aufgaben für Azure-Pipelines beschrieben und die Semantik für Attribute angegeben, die für jeden Vorgang eine besondere Bedeutung enthalten.

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

Anleitungen und Lernprogramme zum Erstellen von Pipelines mithilfe von Aufgaben, einschließlich erstellen benutzerdefinierter Aufgaben, benutzerdefinierter Erweiterungen und Suchen von Aufgaben auf dem Visual Studio Marketplace, finden Sie unter Aufgabenkonzepte und Dokumentation zu Azure Pipelines.

Quelloffen

Diese Aufgaben sind Open Source-auf 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-Editoreingeführt, der eine IntelliSense-Typfunktionalität bereitstellt.

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 Referenzdokumentation zu Azure Pipelines-Aufgaben wurde an den aktuellen Speicherort verschoben, um die folgenden Verbesserungen zu unterstützen.

• Aufgabenartikel werden mithilfe des Aufgabenquellcodes aus dem Azure Pipelines-Aufgaben open Source Repositorygeneriert.
• 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.