v16.0.0 - Release - Major Configration Changes

[nkdagility-actions-bot[bot]]

Azure DevOps Migration Tools v16.0.0

Version: 16.0.0
Ring: (Release)

Funding for us doing work on this tool is generally through 1) customer funding, or 2) donated free time.

Sponcer a Feature | Hire us directly

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.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools --version 16.0.0 . 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. 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
• Revamp Documentation (1) for v16 by @MrHinsh in Revamp Documentation (1) for v16 #2313
• 🔧 (main.yml): remove trailing slash from docs_baseURL for consistency by @MrHinsh in 🔧 (main.yml): remove trailing slash from docs_baseURL for consistency #2314
• Rename Project Folders for Clarity (and sanity) by @MrHinsh in Rename Project Folders for Clarity (and sanity) #2315
• Update Exceptions for v16 by @MrHinsh in Update Exceptions for v16 #2316
• Added OpenTelemtery! by @MrHinsh in Added OpenTelemtery! #2321
• Topic/update docs 2 by @MrHinsh in Topic/update docs 2 #2319
• Replace Application Insights with OpenTelemitery by @MrHinsh in Replace Application Insights with OpenTelemitery #2322
• Ensure loading of AppSettings for defaults. by @MrHinsh in Ensure loading of AppSettings for defaults. #2325
• WITDataStore64 files missing! by @MrHinsh in WITDataStore64 files missing!  #2326
• Configration Builder by @MrHinsh in Configration Builder #2327
• Documentation Update (v16) part 2 by @MrHinsh in Documentation Update (v16) part 2 #2329
• Documenation Update v16 Part 3 by @MrHinsh in Documenation Update v16 Part 3 #2330

Full Changelog: v15.2.1...v16.0.0

---

This discussion was created from the release v16.0.0 (Release).