v16.0.0-Preview - Preview [new config]

[MrHinsh]

Azure DevOps Migration Tools v16.0.0-Preview.

Version: 16.0.0-Preview.1
Ring: (Preview)

Release Summary for Azure DevOps Migration Tools

Overview

This is a complete rewrite of the configuration management system and means that all of the config has changed. This brings a bunch of new features, and we will update the docs...

Detailed Changes

New Features ✨

• Streamlined Config - the new config is much clearer and concise, as well as enabling future extensions. It should be easier to read, and we have added a config upgrade, and config builder.
• Override config data from:
  • Environment Variables - You can set an environment variable to override elements of the config. for example you can set an environment variable of MigrationTools__Endpoints__Source__Authentication__AccessToken to pass the PAT token into the system.
  • Command Line - You can override any element in the config from the command line. or example devopsmigration.exe exec -c myconfig.json MigrationTools:Endpoints:Source:Authentication:NetworkCredentials:Password=NewValue
• Config Upgrader - I have added an upgrader that works as both upgrade for old configs, and should work going forward to streamline after any future changes. It currently supports:
  • Upgrade Old Config - This takes either a v1 ("Source", "Target") or v1.5 ("Endpoints:TfsWhateverEndpoints") schema upgrades, best effort, as much of it as possible. The result should be a v16 schema config with the same data. This is not 100% fidelity, but is good enough. If you encounter a "type missing" when running it, this might be because we have renamed the class, so it can't find it. Let us know and we will add it to our class name changelog and then it will map.
  • Refresh any config - When the system warns you that the version of the config might not match, you can run an upgrade to pull the old changes into the new format.
  • Better init - The init now can create a much more robust set of samples as its generated rather than coded. We will add additional future options in there, along with maybe some other default templates. (many things are now possible).

Refactoring ♻️

This is also a significant restructure of the code to enable all this with a move to the IOptions pattern, and everything in the config inherits from from our IOptions interface. There are many, many braking changes.

Under the Covers

I have moved and streamlined the entire telemetry system. Its now using OpenTelemetry and still backed by AI. I lost a bunch of functionality, and gained others...

Get the tools

• Download the MigrationTools-16.0.0-Preview.1.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.0-Preview.1 . There is a delay for aprovals on the winget store, so you may need to wait a few days before this is available.
• Install with Chocolatey with choco install vsts-sync-migrator --version 16.0.0-preview0001. There is a delay for aprovals on the chocolatey store, so you may need to wait a few hours before this is available.

What's Changed

🏕 Features

• Modern Configuration Builder (v16.x) Part 1 by @MrHinsh in Modern Configuration Builder (v16.x) Part 1 #2241

Full Changelog: v15.2.1...v16.0.0-Preview.1

---

This discussion was created from the release v16.0.0-Preview.1 (Preview).

[MrHinsh]

Hey @jjolidon, I wanted to let you know that the PR that you submitted back in 2022 that enabled the PAT token to be loaded from an Environment variable has now been broadened to allow an override of ANY configuration element.... I finally modernised the and moved to the IOptions pattern that's out-of-the-box.

Thanks so much for your contribution as this was a catalyst for me looking into fixing it perminatly.

[jjolidon]

Thank you for the acknowledgement and for the excellent work !

[MrHinsh]

Hey @joshjohanning I saw your blog post! Awesome! Would you consider writing a post around the new version? Happy for feedback as well. I have done a lot to make it more friendly with a config upgrader and generator...

[joshjohanning]

I would be happy to @MrHinsh! 🙇

[MrHinsh]

There are still a few bugs I'm working through in preview... mostly small potatoes...

[MrHinsh]

Preview docs are on https://nkdagility.com/learn/azure-devops-migration-tools/preview/