Informazioni di riferimento sulle attività di Azure Pipelines

Un'attività esegue un'azione in una pipeline. Ad esempio, un'attività può compilare 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 le attività predefinite per Azure Pipelines e specificano la semantica per gli attributi che contengono un significato speciale per ogni attività.

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

Per procedure ed esercitazioni sulla creazione di pipeline tramite attività, tra cui la creazione di attività personalizzate, le estensioni personalizzate e la ricerca di attività in Visual Studio Marketplace, vedere concetti relativi alle attività e documentazione di Azure Pipelines.

Open source

Queste attività sono open source in 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 da Azure DevOps Server 2019.1, l'editor della pipeline YAML è stato introdotto, che fornisce una funzionalità del 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 è stata spostata nella posizione corrente per supportare i miglioramenti seguenti.

• Gli articoli sulle attività vengono generati usando il codice sorgente dell'attività dal repository open source attività di Azure Pipelines.
• 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 la copertura delle attività per tutte le versioni di Azure DevOps supportate.
• 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 .