Condividi tramite

Eseguire la migrazione della pipeline classica a YAML

  • Articolo

Azure DevOps Services

Introduzione ad Azure Pipelines convertendo la pipeline classica esistente in modo da usare YAML. Con una pipeline basata su YAML, è possibile implementare la strategia CI/CD come codice e visualizzarne la cronologia, confrontare le versioni, la colpa, annotare e così via.

Quando si converte la pipeline classica, il prodotto finale è due pipeline. Si avrà una nuova pipeline YAML e una pipeline classica che può essere ritirata. La cronologia delle esecuzioni della pipeline classica rimarrà nella pipeline classica.

Prerequisiti

Assicurarsi di avere gli elementi seguenti prima di iniziare.

  • Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
  • Un'organizzazione Di Azure DevOps attiva. Iscriversi per Azure Pipelines.
  • Pipeline di lavoro che usa l'editor dell'interfaccia utente classica.
  • 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 seguito 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 pipeline selezionare Pipeline di avvio.

    Elenco di modelli da scegliere per la configurazione della nuova pipeline.

  6. Selezionare Salva ed esegui.

    Rivedere la pagina in cui si seleziona Salva ed esegui.

  7. Immettere il messaggio di commit, selezionare Commit direttamente nel ramo principale e quindi scegliere Salva ed eseguire di nuovo. Viene avviata una nuova esecuzione e viene eseguito il commit nel repository. Attendere che venga completata.

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

Esportare la pipeline classica

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

  1. Aprire la pipeline classica.

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

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

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

  4. 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.

  5. Esaminare le 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.

  6. Usare l'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 Task Assistant.

  7. 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 dispongono di un elemento di lavoro Crea elemento di lavoro per l'impostazione di errore come le pipeline di compilazione classiche. Sono disponibili due opzioni per la creazione di questa funzionalità.

  • È 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. Per creare un bug in caso di errore, vedere un esempio di uso dell'interfaccia della riga di comando.

Passaggi successivi

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

Usare Azure Pipelines