Condividi tramite

Eseguire la migrazione della pipeline classica a YAML

  • Articolo

Servizi di Azure DevOps

Introduzione ad Azure Pipelines convertendo la pipeline classica esistente per l'uso di YAML. Con una pipeline basata su YAML, è possibile implementare la strategia CI/CD come codice e visualizzarne la cronologia, confrontare versioni, biasimare, annotare e così via.

Quando si converte la pipeline classica, il prodotto finale è costituito da due pipeline. Si avrà una nuova pipeline YAML e una pipeline classica che può essere ritirata. La cronologia di esecuzione della pipeline classica rimane nella pipeline classica.

Prerequisiti

Prima di iniziare, assicurarsi di disporre degli elementi seguenti.

  • Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
  • Un'organizzazione di Azure DevOps attiva. Iscriversi ad Azure Pipelines.
  • Pipeline di lavoro che usa l'editor dell'interfaccia utente classica.
  • Un file di pipeline YAML di esempio nel codice. Creare una pipeline YAML di esempio nella sezione seguente.

Creare una pipeline YAML di esempio

Seguire questa procedura per creare una pipeline YAML di esempio, che verrà aggiornata in un secondo momento con il codice esportato dall'editor dell'interfaccia utente classica.

  1. Accedere all'organizzazione (https://dev.azure.com/{yourorganization}) e selezionare il progetto.

  2. Selezionare Pipeline e quindi Nuova pipeline.

    Due pulsanti da selezionare per la creazione di una nuova pipeline.

  3. Selezionare il percorso per il codice sorgente come GitHub o Azure Repos Git.

    Elenco delle possibili selezioni per il codice sorgente.

  4. Selezionare un repository.

    Pagina in cui si seleziona un repository per la pipeline del codice sorgente.

  5. Nella pagina Configura la pipeline selezionare Pipeline di avvio.

    Elenco di modelli tra cui scegliere per la configurazione della nuova pipeline.

  6. Seleziona Salva ed Esegui.

    Esaminare la pagina in cui si seleziona Salva ed esegui.

  7. Immettere il messaggio di commit, selezionare Esegui commit direttamente nel ramo principale e quindi scegliere Salva ed esegui di nuovo. Viene avviata una nuova esecuzione ed è stato eseguito il commit nel repository. Attendere il completamento dell'esecuzione.

    Eseguire il commit del messaggio per eseguire il commit nel ramo principale e quindi selezionare il pulsante Salva ed esegui.

Esportare la pipeline classica

Seguire questa procedura per esportare la pipeline classica in un file YAML che è possibile usare nell'editor.

  1. Passare a Pipeline>Pipeline.

  2. Aprire la pipeline classica nella finestra di progettazione della compilazione classica.

  3. Selezionare i puntini di sospensione (...), quindi selezionare Esporta in YAML.

    Screenshot del menu di scelta rapida per esportare la pipeline in YAML.

  4. Aprire il file YAML scaricato nell'editor di codice.

  5. Se la pipeline YAML include variabili definite nell'interfaccia utente classica, definire di nuovo le variabili nell'interfaccia utente delle impostazioni della pipeline o nel file YAML. Per altre informazioni, vedere Definire le variabili.

  6. Esaminare eventuali cron pianificazioni nel file YAML. Per impostazione predefinita, cron le pianificazioni in YAML sono in formato UTC. Nelle pipeline classiche si trovano nel fuso orario dell'organizzazione. Per altre informazioni, vedere Configurare le pianificazioni per le pipeline.

  7. Usare Assistente attività per apportare altre modifiche al file YAML. L'Assistente attività è un riquadro sul lato destro dello schermo, che consente di creare e modificare correttamente i passaggi YAML.

    Configurare l'attività della pipeline con Assistente attività.

  8. Salvare ed eseguire la pipeline.

Pulire le risorse

Se non si userà più questa pipeline di esempio, eliminarla dal progetto. L'eliminazione è permanente e include tutte le compilazioni e gli artefatti associati.

  1. Selezionare i puntini di sospensione (...) e selezionare Elimina.

  2. Immettere il nome della pipeline per eliminarlo definitivamente e quindi selezionare Elimina.

Domande frequenti

È presente un'attività nelle pipeline YAML per creare elementi di lavoro quando si verifica un errore di compilazione?

Le pipeline YAML non hanno un elemento di lavoro Crea elemento di lavoro in caso di errore , ad esempio le pipeline di compilazione classiche. Sono disponibili due opzioni per la creazione di questa funzionalità manualmente.

  • È possibile usare uno script o un'attività di PowerShell e chiamare l'API REST.
  • È possibile usare l'interfaccia della riga di comando di Azure per chiamare az boards work-item create nella pipeline. Vedere un esempio di uso dell'interfaccia della riga di comando per creare un bug in caso di errore.

Passaggi successivi

Informazioni sulle differenze di funzionalità tra le pipeline YAML e classiche.

Usare Azure Pipelines