AZDOPS / AzDM

AzDM - Azure DevOps Manager

This is the home of the Azure DevOps manager, or the Dungeon Master if you will.

For code, modules, and templates, pleas visit the AzDM template repo

Downloads and versions

To get the latest published release, go get the documentation and the related template. Version numbers here is released synchronously and contain the correct docs for this specific release.

If you feel brave you can run anything from the repos directly, and main should work, but updates here may be done at any time and the feature set may change from day to day. You can find which version you are running by looking in the module PSM1 file, first line. vNext implies this was created after the version stated, but before the next version number release. Consider vNext to be a "nightly" style build.

What is AzDM?

AzDM is an opinionated project to manage Azure DevOps as code. It is highly inspired by the AzOps project, and stems from the idea that everything in Azure DevOps is a resource, and can be viewed and managed as a folder or file configuration

This is not to be considered a "one click solution", but a base for you to build on. You may need to implement extra settings, or add your own configurations.

The core functionality comes from the AzDM module written in PowerShell, and the related pipelines

Getting started

For tutorials, please see the setup documentation, the functionality documentation, or check out the setup accelerator scripts.

Documentation and examples are currently being worked on and functionality will be updated and / or added in time. You can find some helper functions already in the helperFunction folder

Folder structure

The managed Azure DevOps organization is set up with folders representing Azure DevOps projects and tries to emulate the GUI layout of Azure DevOps - Overview, boards, repos, pipelines, test Plans, Artifacts - Although most of the functionality is still a work in progress.

📂\Root
    💿config.json
     └─ 📂\Discworld
         └─ 💿Discworld.json
            📂\pipelines
             └─ 💿Discworld.pipelines.json
            📂\repos
             └─ 💿Discworld.repos.json
        📂\MiddleEarth
         └─ 💿MiddleEarth.json
            📂\pipelines
             └─ 💿MiddleEarth.pipelines.json
            📂\repos
             └─ 💿MiddleEarth.repos.json
        📂\Westeros
         └─ 💿Westeros.json
            📂\pipelines
             └─ 💿Westeros.pipelines.json
                📂kingsLanding
                 └─ 💿kingsLanding.json
                📂\Meereen
                 └─ 💿Meereen.json
            📂\repos
             └─ 💿Westeros.repos.json
                📂\kingsLanding
                 └─ 💿\kingsLanding.json

Todo

Current plans for future functionality may be found in the todo list. Feel free to create an issue of you have any requests.

Contributing

This project happily accepts contributions of all kinds.

• Add functionality
• Add documentation
• Request functionality
• Report bugs

All help is good help.

However, we kindly do request you follow our code of conduct