Le pipeline YAML, come abbiamo avuto modo di capire dagli script e dagli articoli che abbiamo pubblicato su questo canale, ci offrono grandi vantaggi, sia in termini di riuso dei template per costruire pipeline più complesse mantenendo una certa organizzazione, sia in termini di versionamento e così via. Chi vuole iniziare ad approcciare YAML per le prime volte, troverà grande difficoltà in due aree principali: la prima è la complessità del dover scrivere la pipeline stessa, la seconda nel dover fare continui commit sul repository per poter verificare se effettivamente il codice YAML scritto è corretto.
Sebbene per risolvere il "problema dello schermo vuoto" nella costruzione della prima pipeline non ci siano soluzioni, se non quella di studiare la documentazione, analizzare i sample e fare un uso intensivo dell'assistant, per il secondo problema possiamo sfruttare una nuova API pubblicata da Microsoft per verificare localmente se lo YAML prodotto è valido. Per verificarlo, basterà inviare una chiamata così formattata:
POST https://dev.azure.com/{org}/{project}/_apis/pipelines/{pipelineId}/runs?api-version=5.1-preview { "PreviewRun": true, "YamlOverride": "# your new YAML here, optionally" }
Nel body della request dovremo andare a specificare, in maniera opzionale, il nuovo YAML rappresentante la pipeline nella proprietà YamlOverride e indicare in PreviewRun se vogliamo che venga espanso il template per verificare anche la sostituzione delle variabili. Se non specificato il nuovo codice YAML, verrà testata la pipeline esistente: sebbene questo scenario possa sembrare inutile, può diventare comodo per testare la validità di una pipeline durante la submission di una PR.
Il codice da sottomettere come YamlOverride, però, ha la limitazione di essere un singolo file. Qualora, infatti, la pipeline che andiamo a modificare faccia riferimento ad altri template, ad esempio residenti su altri repository, la validazione non andrà a buon fine.
Mandare la richiesta via curl potrebbe essere un po' complesso, in quanto bisognerebbe assicurarsi che venga fatto correttamente l'escape dello YAML prima di inviare la request, perciò possiamo pensare di utilizzare una estensione di VSTeam, un modulo di PowerShell utile a comunicare con Azure DevOps. Supponendo di avere la pipeline in un file pipeline.yml, possiamo invocare la richiesta di controllo della validità tramite:
PS C:\> $FilePath = ".\pipeline.yml" PS C:\> $yamlOverride = [string](Get-Content -raw $FilePath) PS C:\> Test-VSTeamYamlPipeline -Project {project} -PipelineId {pipelineId} -YamlOverride $yamlOverride
Commenti
Per inserire un commento, devi avere un account.
Fai il login e torna a questa pagina, oppure registrati alla nostra community.
Approfondimenti
Eseguire attività pianificate con Azure Container Jobs
Creare alias per tipi generici e tuple in C#
Configurare il nome della run di un workflow di GitHub in base al contesto di esecuzione
Eseguire query per recuperare il padre di un record che sfrutta il tipo HierarchyID in Entity Framework
Garantire la provenienza e l'integrità degli artefatti prodotti su GitHub
Code scanning e advanced security con Azure DevOps
Cambiare la chiave di partizionamento di Azure Cosmos DB
Eseguire una GroupBy per entity in Entity Framework
Definire stili a livello di libreria in Angular
Visualizzare le change sul plan di Terraform tramite le GitHub Actions
Usare le navigation property in QuickGrid di Blazor
Evitare (o ridurre) il repo-jacking sulle GitHub Actions