Nell'ultimo episodio di questa mini-serie su come ricavere le release note a partire delle Pull Request create all'interno di uno o più repository, abbiamo visto come completare lo script di PowerShell utile a recuperare tutte le informazioni necessarie e a produrre in output il file di markdown contenente, appunto, le note di rilascio.
In questa puntata, come promesso, vediamo come integrare lo stesso in una pipeline YAML. Per prima cosa, dobbiamo sfruttare i runtime parameters, ovvero dei parametri speciali che vengono usati nella pipeline stessa anzichè nel template. Questi parametri ci permettono di specificare, prima di eseguire la pipeline, quali sono i tag da fornire in input allo script:
name: '$(date:yyyy).$(date:MM).$(date:dd)$(Rev:.rr)' parameters: - name: ReleaseVersion displayName: Versione corrente type: string default: 'refs/tags/2.0.0' - name: PreviousReleaseVersion displayName: Versione precedente type: string default: 'refs/tags/1.0.0' trigger: none pool: vmImage: 'ubuntu-latest'
Impostati anche alcuni valori relativi a come invocare la pipeline (trigger) e su quale agent girare (ubuntu-latest), possiamo invocare lo script creato precedentemente semplicemente aggiungendo uno step alla pipeline:
steps: - task: PowerShell@2 displayName: Crea release notes env: TEAM_PROJECT: $(System.TeamProject) SYSTEM_ACCESSTOKEN: $(System.AccessToken) inputs: filePath: '$(Build.SourcesDirectory)/scripts/release-diff.ps1' arguments: '-previousReleaseVersion ${{ parameters.PreviousReleaseVersion }} -releaseVersion ${{ parameters.ReleaseVersion }}' pwsh: true
Lo script viene invocato in modalità PowerShell Core, così che sia effettivamente eseguibile sull'agent Linux-based che abbiamo scelto. Inoltre, abbiamo passato tra gli argomenti proprio i parametri (ovvero i tag di riferimento dalla quale partire per recuperare le Pull Request completate) necessari a calcolare le note di rilascio tra due istanti temporali.
A script completato verrà appunto generato un file di markdown che, al momento, non stiamo sfruttando in alcun modo. Vedremo nel prossimo ed ultimo script come fare in modo che il file di markdown venga pubblicato nella Wiki di Azure DevOps, per assicurarci che sia leggibile a tutti i membri del team.
Commenti
Per inserire un commento, devi avere un account.
Fai il login e torna a questa pagina, oppure registrati alla nostra community.
Approfondimenti
Gestire undefined e partial nelle reactive forms di Angular
Utilizzare un service principal per accedere a Azure Container Registry
Creare un'applicazione React e configurare Tailwind CSS
3 metodi JavaScript che ogni applicazione web dovrebbe contenere - Parte 2
Elencare le container images installate in un cluster di Kubernetes
Potenziare Azure AI Search con la ricerca vettoriale
Short-circuiting della Pipeline in ASP.NET Core
Evitare la script injection nelle GitHub Actions
Utilizzare Tailwind CSS all'interno di React: installazione
Effettuare il download di un file via FTP con la libreria FluentFTP di .NET
Miglioramenti agli screen reader e al contrasto in Angular
Reactive form tipizzati con modellazione del FormBuilder in Angular