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 delle esecuzioni della tua pipeline classica rimane nella pipeline classica.

Nota

È possibile esportare un file YAML solo da una pipeline classica esistente creata con il classico designer di build. Se non viene visualizzata l'opzione per l'esportazione in JSON o YAML, la pipeline non supporta l'esportazione. La pipeline di rilascio classica non ha l'opzione per esportare in YAML. È possibile esportare una pipeline di versione classica esportando ciascuna attività singolarmente.

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 come percorso per il codice sorgente GitHub oppure 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.

    Esamini la pagina in cui 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 e viene eseguito il commit nel repository. Attendere il completamento dell'esecuzione.

    Inserire un messaggio di commit per eseguire il commit nel ramo principale e quindi selezionare il pulsante Salva e avvia.

Esportare la pipeline classica

  1. Accedere all'organizzazione di Azure DevOps e quindi passare al progetto.

  2. Selezionare Pipeline>Pipeline.

  3. Selezionare la definizione della pipeline Classica, selezionare l'icona con i tre punti e quindi selezionare Esporta in YAML. Assicurati di essere nella vista di definizione della pipeline, non in un'esecuzione specifica della pipeline, per visualizzare l'opzione Esporta in YAML.

    Screenshot del menu di scelta rapida per esportare la tua 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, il fuso orario è quello dell'organizzazione. Per altre informazioni, vedere Configurare le pianificazioni per le pipeline.

  7. Usare l'Assistente attività per apportare eventuali altre modifiche al file YAML. L'Assistente di Attività è un riquadro sul lato destro dello schermo che ti aiuta a creare e modificare correttamente i passaggi YAML.

    Configura l'attività della pipeline con l'Assistente di 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 tutti i build e gli artefatti associati.

  1. Cliccare sui puntini (...) 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'impostazione Crea elemento di lavoro in caso di errore come 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