Azure Pipelines task reference

Un'attività esegue un'azione in una pipeline. Ad esempio, un compito può costruire un'app, interagire con le risorse di Azure, installare uno strumento o eseguire un test. Le attività sono i blocchi predefiniti per definire l'automazione in una pipeline.

Gli articoli di questa sezione descrivono i compiti integrati per Azure Pipelines e specificano la semantica degli attributi che hanno un significato speciale per ogni compito.

Per informazioni dettagliate sugli attributi generali supportati dalle attività, vedere le informazioni di riferimento YAML per steps.task.

Per tutorial e tutorial sulla creazione di pipeline utilizzando compiti, inclusa la creazione di attività personalizzate, estensioni personalizzate e ricerca di attività sul Visual Studio Marketplace, consulta Task e documentazione Azure Pipelines.

Sorgente aperto

Questi compiti sono open source on GitHub. I commenti e i contributi sono benvenuti. Per un elenco delle modifiche delle attività, incluso un record cronologico degli aggiornamenti delle attività, vedere log delle attività.

Domande frequenti

Che cosa sono gli alias di input dell'attività?

Gli input di un'attività sono identificati da un label, namee possono includere uno o più aliasesfacoltativi. L'esempio seguente è un estratto del codice sorgente per la voce host noti input dell'attività InstallSSHKey@0.

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

Prima dell'introduzione delle pipeline YAML nel 2019, le pipeline sono state create e modificate usando un editor di pipeline basato sull'interfaccia utente e solo la label è stata usata dagli autori della pipeline per fare riferimento a un input dell'attività.

Quando le pipeline YAML sono state introdotte nel 2019, gli autori di pipeline che usano YAML hanno iniziato a usare l'input dell'attività name per fare riferimento a un input dell'attività. In alcuni casi, i nomi di input dell'attività non erano descrittivi, quindi aliases sono stati aggiunti per fornire nomi descrittivi aggiuntivi per gli input dell'attività.

Ad esempio, l'attività InstallSSHKey@0 dispone di un input voce host noti denominato hostName che prevede una voce da un file di known_hosts. L'etichetta voce host noti nella finestra di progettazione della pipeline classica lo rende chiaro, ma non è chiaro quando si usa il nome in una pipeline YAML. Sono stati introdotti alias di input dell'attività per consentire agli autori di attività di fornire nomi decriptivi per le attività create in precedenza e per l'attività di InstallSSHKey@0, è stato aggiunto un alias knownHostsEntry, mantenendo il nome hostName originale per la compatibilità con le pipeline esistenti usando tale nome.

Tutti gli elementi del aliases dell'input di un'attività sono intercambiabili con il name in una pipeline YAML. I due frammenti YAML seguenti sono identici a livello funzionale, con il primo esempio che usa l'alias knownHostsEntry e il secondo esempio usando hostName.

- 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

A partire dal Azure DevOps Server 2019.1, è stato introdotto l'editor di pipeline YAML, che offre una funzionalità di tipo intellisense.

L'editor della pipeline YAML usa il Yamlschema - Get API REST per recuperare lo schema usato per la convalida nell'editor. Se un input di un'attività ha un alias, lo schema promuove l'alias al nome YAML primario per l'input dell'attività e l'alias viene suggerito da intelliSense.

L'esempio seguente è l'voce host noti input dell'attività per l'attività InstallSSHKey@0 dallo schema YAML, con knownHostsEntry elencati nella posizione del nome e hostName nell'insieme aliases.

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

Poiché intellisense nell'editor della pipeline YAML visualizza knownHostsEntrye il codice YAML generato dall'Assistente attività usa knownHostsEntry nel file YAML generato, il riferimento all'attività visualizza il alias dal codice sorgente dell'attività come nome YAML per un input dell'attività. Se un'attività ha più di un alias (esistono alcuni alias con due alias), il primo alias viene usato come nome.

Perché il riferimento all'attività è cambiato?

La documentazione di riferimento delle attività di Azure Pipelines si è spostata nella sua posizione attuale per supportare i seguenti miglioramenti.

• Gli articoli di task vengono generati utilizzando il codice sorgente del task Azure Pipelines repository open source task.
• I nomi e gli alias di input delle attività vengono generati dall'origine dell'attività in modo che siano sempre aggiornati.
• I blocchi di sintassi YAML vengono generati dall'origine dell'attività in modo che siano aggiornati.
• Supporta i contributi della community con contenuto utente integrato, ad esempio descrizioni di input delle attività avanzate, osservazioni ed esempi.
• Fornisce copertura dei task per tutte le versioni supportate di Azure DevOps.
• Aggiornato ogni sprint per coprire gli aggiornamenti più recenti.

Per contribuire, vedere Contribuire al contenuto delle attività.

Dove è possibile apprendere in modo dettagliato come compilare l'app?

Creare l'app

È possibile aggiungere attività di compilazione personalizzate?

Sì: Aggiungere un'attività di compilazione

Che cosa sono le attività del programma di installazione?

Per altre informazioni sulle attività del programma di installazione degli strumenti, vedere programmi di installazione degli strumenti .

Versioni precedenti

• Azure DevOps Server riferimento compito 2020.1
• Azure DevOps Server riferimento compito 2020
• Azure DevOps Server riferimento del compito 2019.1
• Azure DevOps Server riferimento al compito 2019
• Riferimento del compito TFS 2018