/images/avatar.png

Generate PlantUML in you CI/CD Pipeline

This is part of a series creating around PlantUML and Diagrams as Code. Authoring Plant UML files in Visual Studio Code Creating Image file from PlantUML using command line Creating Pipeline to build and check-in Diagrams as Code (This Post) Optimise the Pipeline In the previous posts in the series we have looked how to author as well as how to build the PlantUML files using command line tools. In this post will we build the PlantUML diagrams on check-in.

Generate PlantUML using Command Line

This is part of a series creating around PlantUML and Diagrams as Code. Authoring Plant UML files in Visual Studio Code Creating Image file from PlantUML using command line (This Post) Creating Pipeline to build and check-in Diagrams as Code Optimise the Pipeline You may have read my previous post about using Visual Studio Code Extension to create a PlantUML files. https://www.azuredevops.tips/build-diagramsplantuml/. In this post I will cover how to bulk generate image files.

Create First Project

In a Azure DevOps Organisation you can have multiple projects. It is best to think about these project around a Product or a actual Project with a fixed delivery. You Project Tasks, Test Scripts, Source Code Repository, Build and Release scripts will live in this Project. What is the difference with Public vs Private Projects. Private means you can keep the whole project under lock and key so no-one else can get to it unless you grant them permission.

Build Diagrams with PlantUML

This is part of a series creating around PlantUML and Diagrams as Code. Authoring Plant UML files in Visual Studio Code (This Post) Creating Image file from PlantUML using command line Creating Pipeline to build and check-in Diagrams as Code Optimise the Pipeline Build Diagrams – PlantUML So in the previous post we looked at Mermaid diagrams which are built into Azure DevOps Wiki. This is a great low friction way to include diagrams if you haven’t read the tip head over to https://azuredevops.

Wiki Mermaid Diagrams

Have you ever wanted to create some diagrams to explain the flow or sequence along with you documentation. You can use some tool like Microsoft Visio, export or screen grab the picture then paste it into the wiki. Then when it comes to updating it you have to try and find that Visio file make the change and repeat the export. In the series of Diagrams in Azure DevOps Wiki I will be showing you how you can put diagrams along side you Wiki documentation.

Repo – Allow Build Agent to Commit Code

Being able to commit code and other aspects into git source code is something you may find odd. After all the source code is is your companies intellectual property, so why would you want to let you build agent make changes to your code? If you keep your documentation next to your source code for example a wiki, you may want to automatically generate your release notes and check them in.