¶ How to customise Blueprints in Azure DevOps
Customising a blueprint within the DevBricks generation platform for Azure DevOps allows users to tailor their code generation process according to their specific requirements. By following a few simple steps, users can create and modify blueprints to ensure that their project aligns with their business needs and preferences.
¶ Step 1: Ensure that DevBricks has been enabled in your Azure DevOps project.
Find the onboarding process, here.
¶
Step 2: Access project settings.
Head to your project's homepage and access “Project Settings”. Scroll down the left-hand navigation bar until you find "Extensions," then select "DevBricks Settings."
¶
Step 3: Create the Blueprint.
To create a fresh blueprint, select "Create Blueprint."
¶
Step 4: Choose a Brick Pack or Build a Blueprint from Scratch
After choosing to create a blueprint you will be taken to a secondary page to choose how you would like your blueprint to be made.
Select whichever option suits your requirements before selecting “Create” at the bottom of the page.
Choosing a Brick Pack:
By choosing to create a blueprint from a Brick Pack, DevBricks will supply a pre-built blueprint. This blueprint will contain all technologies from the chosen brick pack.
Note: We recommend starting with these templates while learning DevBricks to provide a solid starting point for your code generation.
Building a Brick Pack from Scratch:
By choosing to create a blueprint from scratch, DevBricks will supply an empty blueprint for you to build off.
¶ Step 5: Customise your Blueprint
Once a blueprint has been created and assigned to a team, these settings will be used across all user stories within your project. Therefore, it is important to set up your blueprint to meet all your business requirements.
Adding additional foundations:
To add a new foundation area to your blueprint, select the existing "foundation" section you wish to add to and choose "Add foundation." This will create a "New Foundation" area containing a "new brick."
Select the new foundation and click on the floppy disk symbol next to its name when the pop-up menu appears on the right. Open the editing bar and replace "New foundation" with the label you wish to work with (e.g., performance testing).
Adding a new brick:
To add a new DevBrick into a foundation area, simply select the section you wish to add it to and choose "Add Brick." This will create a blank brick titled "New Brick."
Select the new brick and click on the save symbol next to its name when the pop-up menu appears on the right. Open the editing bar and replace "New Brick" with your desired title (e.g., .NET 7).
Customising Bricks:
To change the properties and rules of any brick, simply double-click on the chosen brick to bring up its customisation menu. From this menu, you can choose from your choice of brick packs from the marketplace or configure them manually. Once you have finalised customisation, simply select “Save”.
Editing foundations and bricks:
To edit any chosen area of your blueprint, simply select it to bring up its menu. From this menu, you can toggle between enabling and disabling it, viewing its details, or removing it altogether.
Adding teams to a blueprint:
To assign your blueprint to a chosen team, simply click on the "+" under the team section.
¶ Step 6: Save Blueprint
After chosen Blueprint has been selected hit the “Save” button in the top right corner of the screen.
Note: if the save button is not selected before exiting the window all blueprint creations and customisations will be discarded.