v16.0.0-Preview.8 (Preview)

Azure DevOps Migration Tools v16.0.0-Preview.8

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

Release Summary for Azure DevOps Migration Tools

Overview

This release of the Azure DevOps Migration Tools introduces significant enhancements, new features, and various improvements aimed at optimising performance and usability. The updates focus on refining configuration management, enhancing logging capabilities, and improving the overall user experience.

Detailed Changes

New Features ✨

• MigrationConfigCommand: A new command is added to handle configuration file creation and editing, enhancing user interaction with the tool. #2325
• Field Mapping Classes: New field mapping classes for Azure DevOps are introduced, allowing for more flexible data handling. #2319
• TelemetryLoggerFake: A new fake logger is added for testing purposes, improving the testing framework. #2313

Enhancements 💡

• Configuration Management: The configuration structure is updated for better clarity and usability, including the addition of new field mappings and improved logging settings. #2314
• Logging Improvements: Enhanced logging capabilities are introduced, including the integration of Serilog for better log management. #2316
• Processor Configuration: The processor loading mechanism is refactored to use lazy initialization, improving performance and resource management. #2315

Bug Fixes 🐛

• Error Handling: Various fixes are implemented to improve error messages and logging clarity, particularly in the WorkItemMigrationContext. #2318
• Configuration Loading: Resolved issues with configuration loading logic for processors and enrichers, ensuring smoother operation. #2317

Performance Improvements ⚡️

• Optimised Processor Management: The refactoring of processor management leads to improved performance and reduced resource consumption during migrations. #2312

Refactoring ♻️

• Code Structure: Significant refactoring is done across various components to improve code readability and maintainability, including renaming classes and restructuring configuration files. #2311
• Configuration Handling: The configuration handling logic is updated to support multiple sources and targets, enhancing flexibility. #2310

Documentation Updates 📝

• Updated Documentation: Comprehensive updates to the documentation are made to reflect the latest changes, including new command descriptions and configuration options. #2309
• Improved Examples: Additional examples and clearer descriptions are provided in the documentation to assist users in understanding new features. #2308

Dependency Updates 📌

• Updated Dependencies: The project dependencies are updated to ensure compatibility with the latest libraries and tools, including an upgrade to Ruby version 3.2 in the GitHub Actions workflow. #2307

Other 🧱

• Miscellaneous Updates: Various minor updates and fixes are made throughout the codebase, including improvements to the GitHub Actions workflows and project structure. #2306

Conclusion

The changes in this release significantly enhance the Azure DevOps Migration Tools, making them more robust, user-friendly, and efficient. The focus on improved configuration management and logging will facilitate better user experiences and streamline migration processes. These updates align with our ongoing commitment to providing high-quality tools that meet the evolving needs of our users.

Get the tools

• Download the MigrationTools-16.0.0-Preview.8.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.0-Preview.8 . 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-preview0008. 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

• Ensure loading of AppSettings for defaults. by @MrHinsh in #2325

Full Changelog: v16.0.0-Preview.7...v16.0.0-Preview.8

v16.0.0-Preview.10 (Preview)

Azure DevOps Migration Tools v16.0.0-Preview.10

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

Release Summary for Azure DevOps Migration Tools

Overview

The latest release of the Azure DevOps Migration Tools introduces significant enhancements, new features, and various improvements aimed at optimising performance and user experience. This update focuses on refining configuration management, enhancing logging capabilities, and improving documentation to support users effectively.

Detailed Changes

New Features ✨

• Configuration Builder: A new configuration builder is introduced to streamline the process of managing configurations. This feature allows users to create and edit configuration files more intuitively. PR #2327
• Field Mapping Enhancements: New field mapping configurations for FieldMergeMap and FieldLiteralMap are added, improving the flexibility of data migration. PR #2321

Enhancements 💡

• Improved Logging: The integration of Serilog enhances logging capabilities, providing better insights into the migration process. This includes structured logging for easier debugging and monitoring. PR #2320
• Configuration Updates: The configuration structure is updated for clarity and consistency, including renaming and restructuring various configuration options. This change aims to simplify the user experience when setting up migration tools. PR #2319

Bug Fixes 🐛

• Telemetry Issues: A fix is implemented for a minor issue related to the --disableTelemetry option, ensuring that the feature works as intended. PR #2328
• Processor Configuration: Resolved issues with processor configurations that were causing errors during migration tasks. This fix enhances the reliability of the migration process. PR #2318

Performance Improvements ⚡️

• Optimised Configuration Loading: The loading logic for configurations is refactored to improve performance, particularly when dealing with large configuration files. This change reduces the time taken to initialise migration tools. PR #2317

Refactoring ♻️

• Code Structure Enhancements: Various classes and methods are refactored for better readability and maintainability. This includes renaming classes for clarity and removing obsolete methods. PR #2315
• Configuration Management: The configuration management system is restructured to support multiple sources and targets, enhancing the flexibility of the migration tools. PR #2314

Documentation Updates 📝

• Comprehensive Documentation: The documentation is updated to reflect the latest changes, including new features and configuration options. This ensures that users have access to accurate and up-to-date information. PR #2313
• Improved Getting Started Guide: The "Getting Started" documentation is enhanced to provide clearer instructions for new users, facilitating a smoother onboarding process. PR #2312

Dependency Updates 📌

• Updated Dependencies: The project dependencies are updated to the latest versions, ensuring compatibility and security. This includes upgrades to critical libraries used within the migration tools. PR #2311

Other 🧱

• Miscellaneous Updates: Various minor updates and fixes are made throughout the codebase, including improvements to the build process and adjustments to the CI/CD pipeline configurations. PR #2310

Conclusion

This release significantly enhances the Azure DevOps Migration Tools, providing users with improved functionality, better performance, and comprehensive documentation. The changes are expected to streamline the migration process, reduce errors, and enhance user satisfaction, aligning with our business goals of delivering high-quality, reliable migration solutions. The team continues to focus on user feedback and iterative improvements to ensure the tools meet the evolving needs of our users.

Get the tools

• Download the MigrationTools-16.0.0-Preview.10.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.0-Preview.10 . 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-preview0010. 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

• Configration Builder by @MrHinsh in #2327

Full Changelog: v16.0.0-Preview.9...v16.0.0-Preview.10

v16.0.0-Preview.7 (Preview)

Azure DevOps Migration Tools v16.0.0-Preview.7

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

Release Summary for Azure DevOps Migration Tools

Overview

This release of the Azure DevOps Migration Tools introduces significant enhancements, new features, and various improvements aimed at optimising performance and usability. The updates focus on refining the configuration management, enhancing logging capabilities, and improving the overall structure of the codebase. These changes are essential for maintaining the tool's effectiveness and ensuring a seamless user experience.

Detailed Changes

New Features ✨

• OpenTelemetry Integration: The application replaces Application Insights with OpenTelemetry for improved telemetry and monitoring capabilities. This change enhances the ability to track application performance and user interactions. PR #2322
• Field Mapping Enhancements: New field mapping configurations are added to support Azure DevOps, allowing for more flexible data migration options. This feature is crucial for users needing to customise their migration processes. PR #b4cddf638b10220f1ee88ef6ac0354cb8ab9642c

Enhancements 💡

• Configuration Management: The configuration files are updated to improve clarity and usability, including the addition of new settings for better mapping and logging. This enhancement simplifies the setup process for users. PR #a2c9d7fa7603215200ee80ebfd9e33508ff0ddb8
• Logging Improvements: The integration of Serilog enhances logging capabilities, providing better insights into application behaviour and errors. This improvement is vital for troubleshooting and monitoring. PR #67be4b2e4dedf8585c865a973bc577d28886bbcd

Bug Fixes 🐛

• Error Handling: Various fixes are implemented to improve error messages and logging clarity, ensuring users receive more informative feedback during migrations. This change enhances the user experience by reducing confusion during error scenarios. PR #1ea30d041f31108265b6bf2f91ce5fc252b1d352

Performance Improvements ⚡️

• Processor Optimisation: The migration processors are updated for better performance, ensuring faster execution times during data migrations. This improvement is crucial for users handling large datasets. PR #3b5ef6e414575b34a86afdfb199fd7e8fc8876ab

Refactoring ♻️

• Code Structure: Significant refactoring is performed to improve code readability and maintainability. This includes renaming classes and reorganising files for better clarity. Such changes are essential for future development and collaboration among team members. PR #6d72b4cd59dbdee2f381c83006f6601b2d00b431

Documentation Updates 📝

• Documentation Enhancements: The documentation is updated to reflect the latest changes, including new features and configuration options. This ensures that users have access to the most current information, facilitating easier adoption of the tool. PR #6d72b4cd59dbdee2f381c83006f6601b2d00b431

Dependency Updates 📌

• Library Upgrades: The project dependencies are updated to the latest versions, ensuring compatibility and security. This is crucial for maintaining the integrity and performance of the application. PR #5d98e7ab5e89740e2dffdcbabd10f37e11fd1d1e

Conclusion

The changes introduced in this release significantly enhance the Azure DevOps Migration Tools, making it more robust and user-friendly. The integration of OpenTelemetry, improvements in logging, and refined configuration management are expected to provide users with a more efficient and effective migration experience. These updates align with our commitment to continuous improvement and user satisfaction, positioning the tool for future success in data migration projects.

Get the tools

• Download the MigrationTools-16.0.0-Preview.7.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.0-Preview.7 . 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-preview0007. 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

• Replace Application Insights with OpenTelemitery by @MrHinsh in #2322

Full Changelog: v16.0.0-Preview.6...v16.0.0-Preview.7

v16.0.0-Preview.6 (Preview)

Azure DevOps Migration Tools v16.0.0-Preview.6

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

Release Summary for Azure DevOps Migration Tools

Overview

The latest release of the Azure DevOps Migration Tools introduces significant enhancements, new features, and various improvements aimed at optimising performance and usability. This update focuses on refining the configuration management, enhancing documentation, and improving the overall user experience.

Detailed Changes

New Features ✨

• OpenTelemetry Integration: The addition of OpenTelemetry allows for better observability and monitoring of the migration processes. This feature enhances the ability to trace and debug issues effectively. PR #2321
• Field Mapping Enhancements: New field mapping classes for Azure DevOps are introduced, providing more flexibility in how data is migrated. This is crucial for users needing tailored migration solutions. PR #bd02e4eaa5f1ba0bbaae2f5c0fa85a2956e7ca8f

Enhancements 💡

• Configuration Improvements: The configuration files have been updated to include new field mappings and improved logging capabilities, ensuring that users have a more streamlined experience when setting up their migration tools. PR #a2c9d7fa7603215200ee80ebfd9e33508ff0ddb8
• Documentation Revamp: The documentation has been significantly improved, including updates to the MigrationTools.xml to reflect new features and configurations. This ensures that users have access to the latest information and guidance. PR #2319

Bug Fixes 🐛

• Error Message Improvements: Enhanced error messages provide clearer guidance when issues arise, making it easier for users to troubleshoot problems. This improvement is vital for maintaining user confidence in the tool's reliability. PR #b045a9a577fddc6ec28e9c141b7220f724b1160e
• Fix for Invalid Processors: The update resolves issues related to invalid processors, ensuring that the migration process runs smoothly without interruptions. PR #973c86d5d2f59bd9b5b29d06d65082557e9ef807

Performance Improvements ⚡️

• Optimised Configuration Handling: Refactoring of the configuration handling logic improves performance and reduces the overhead during migration tasks. This is particularly beneficial for large-scale migrations. PR #fbe78524a22915d0d21840dd1dea17076ae24f40

Refactoring ♻️

• Code Structure Enhancements: Various refactoring efforts have been made to improve code readability and maintainability, including the renaming of classes and restructuring of configuration files. This makes it easier for developers to contribute to the project in the future. PR #6d72b4cd59dbdee2f381c83006f6601b2d00b431

Documentation Updates 📝

• Comprehensive Documentation Updates: The documentation has been thoroughly updated to reflect the latest changes, including new features and configuration options. This ensures that users have the most accurate and helpful information at their fingertips. PR #14280c00d15a8b49abaaaef76ad2c89434ded89f

Dependency Updates 📌

• Updated Dependencies: The project dependencies have been updated to ensure compatibility with the latest libraries and tools, enhancing the overall stability and performance of the migration tools. PR #480c9068a745c177e013c315050fd7d5463a3b65

Conclusion

This release of the Azure DevOps Migration Tools marks a significant step forward in enhancing the functionality, performance, and usability of the software. The introduction of new features, improvements in documentation, and the resolution of existing bugs contribute to a more robust and user-friendly experience. These changes are expected to facilitate smoother migrations and better support for users, aligning with our ongoing commitment to delivering high-quality tools for Azure DevOps.

Get the tools

• Download the MigrationTools-16.0.0-Preview.6.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.0-Preview.6 . 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-preview0006. 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

• Topic/update docs 2 by @MrHinsh in #2319

Full Changelog: v16.0.0-Preview.5...v16.0.0-Preview.6

v16.0.0-Preview.5 (Preview)

Azure DevOps Migration Tools v16.0.0-Preview.5

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

Release Summary for Azure DevOps Migration Tools

Overview

The latest release of the Azure DevOps Migration Tools introduces significant enhancements, new features, and various improvements aimed at optimising performance and usability. This update focuses on refining the configuration management, enhancing logging capabilities, and improving the overall user experience.

Detailed Changes

New Features ✨

• OpenTelemetry Integration: The addition of OpenTelemetry allows for enhanced observability and monitoring of the migration processes. This feature is crucial for tracking performance and diagnosing issues in real-time. PR #2321
• Field Mapping Enhancements: New field mapping classes for Azure DevOps are introduced, providing users with more flexibility and control over data migration. This is essential for ensuring accurate data transfer between systems. PR #bd02e4eaa5f1ba0bbaae2f5c0fa85a2956e7ca8f

Enhancements 💡

• Configuration Management: The configuration files have been updated to improve clarity and usability, including the introduction of new settings for better mapping and logging. This enhancement streamlines the setup process for users. PR #a2c9d7fa7603215200ee80ebfd9e33508ff0ddb8
• Logging Improvements: The integration of Serilog enhances logging capabilities, allowing for better tracking of events and errors during migration processes. This is vital for troubleshooting and maintaining system integrity. PR #6777e3d7b0610e90fe329be05c06d5ca27e8f858

Bug Fixes 🐛

• Error Handling: Various improvements have been made to error messages and logging, particularly when processors are invalid. This ensures that users receive clear and actionable feedback when issues arise. PR #973c86d5d2f59bd9b5b29d06d65082557e9ef807

Performance Improvements ⚡️

• Optimised Configuration Loading: The configuration loading logic has been refactored for better performance, reducing the time taken to initialise settings during migration. This is expected to enhance the overall user experience by speeding up the setup process. PR #f3a5ff7a6b270f20b3fc6dfcb4c8dd1dcc482e35

Refactoring ♻️

• Code Structure Improvements: Several classes and methods have been refactored for better readability and maintainability. This includes renaming and reorganising files to improve clarity and reduce complexity. PR #6d72b4cd59dbdee2f381c83006f6601b2d00b431

Documentation Updates 📝

• Comprehensive Documentation Revamp: The documentation has been extensively updated to reflect the latest changes, including new features and configuration options. This ensures that users have access to accurate and up-to-date information. PR #8a58eae6957d367fa85019dd099b307b73b692f3

Dependency Updates 📌

• Updated Dependencies: The project dependencies have been updated to ensure compatibility with the latest libraries and tools, enhancing stability and performance. PR #7452c079700fea612ebbf8ec3646aa396c4b89df

Conclusion

This release significantly enhances the Azure DevOps Migration Tools, providing users with improved functionality, better performance, and a more intuitive experience. The integration of OpenTelemetry and enhanced logging capabilities are particularly noteworthy, as they will facilitate better monitoring and troubleshooting. Overall, these changes align with our commitment to delivering high-quality tools that meet the evolving needs of our users.

Get the tools

• Download the MigrationTools-16.0.0-Preview.5.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.0-Preview.5 . 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-preview0005. 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

• Added OpenTelemtery! by @MrHinsh in #2321

Full Changelog: v16.0.0-Preview.4...v16.0.0-Preview.5

v16.0.0-Preview.4 (Preview)

Azure DevOps Migration Tools v16.0.0-Preview.4

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

Release Summary for Azure DevOps Migration Tools

Overview

The latest release of the Azure DevOps Migration Tools introduces a series of enhancements, new features, and critical bug fixes aimed at improving the overall functionality and user experience. This update focuses on refining configuration management, enhancing logging capabilities, and improving documentation to support users in their migration tasks.

Detailed Changes

New Features ✨

• Enhanced Configuration Command: A new configuration command and interactive editor are added to streamline the management of configuration files. This feature simplifies the process for users, making it easier to create and edit configurations. PR #2316
• Field Mapping Enhancements: New field mapping classes for Azure DevOps are introduced, allowing for more flexible and powerful data migration capabilities. PR #2316

Enhancements 💡

• Improved Error Messaging: The error messages throughout the application are updated to provide clearer and more actionable feedback to users, enhancing the overall user experience. PR #2316
• Configuration Structure Updates: The configuration files are reorganised for better clarity and usability, ensuring that users can easily navigate and understand their settings. PR #2316

Bug Fixes 🐛

• Fixed Logging Issues: Several logging issues are resolved, including enhancements to the logging and query replacement logic, ensuring that users receive accurate and helpful log messages. PR #2316

Performance Improvements ⚡️

• Optimised Configuration Loading: The configuration loading logic is updated to improve performance, particularly when dealing with multiple processors and enrichers. This change is expected to reduce the time taken for configuration parsing and enhance the responsiveness of the application. PR #2316

Refactoring ♻️

• Code Structure Enhancements: Significant refactoring is performed across various components to improve code readability and maintainability. This includes renaming classes and methods for clarity and removing obsolete code. PR #2316

Security Updates 🔒️

• Configuration Security Enhancements: Updates to the configuration files include the addition of a Personal Access Token variable name for better security practices, ensuring sensitive information is handled appropriately. PR #2316

Documentation Updates 📝

• Comprehensive Documentation Revamp: The documentation is extensively updated to reflect the latest changes, including new features and configuration options. This ensures that users have access to accurate and up-to-date information. PR #2316

Dependency Updates 📌

• Updated Dependencies: The project dependencies are reviewed and updated to ensure compatibility with the latest libraries and tools, enhancing the stability and performance of the application. PR #2316

Conclusion

This release significantly enhances the Azure DevOps Migration Tools, providing users with improved functionality, clearer documentation, and a more robust configuration management system. The changes are expected to facilitate smoother migration processes and better user experiences, aligning with our commitment to continuous improvement and user satisfaction. As we move forward, we anticipate that these updates will contribute positively to our project goals and user engagement.

Get the tools

• Download the MigrationTools-16.0.0-Preview.4.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.0-Preview.4 . 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-preview0004. 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

• Update Exceptions for v16 by @MrHinsh in #2316

Full Changelog: v16.0.0-Preview.3...v16.0.0-Preview.4

v16.0.0-Preview.3 (Preview)

Azure DevOps Migration Tools v16.0.0-Preview.3

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

Release Summary for Azure DevOps Migration Tools

Overview

This release of the Azure DevOps Migration Tools introduces significant enhancements, including improved configuration management, new features for field mapping, and extensive documentation updates. The changes aim to streamline the migration process, enhance usability, and ensure better maintainability of the codebase.

Detailed Changes

New Features ✨

• New Configuration Command: The addition of the MigrationConfigCommand allows users to create and edit configuration files interactively, enhancing user experience. PR #2315
• Field Mapping Enhancements: New field mapping classes for Azure DevOps are introduced, providing more flexibility in how data is migrated. PR #2315

Enhancements 💡

• Improved Logging: The integration of Serilog for enhanced logging capabilities allows for better tracking and debugging of migration processes. PR #2315
• Configuration Updates: The configuration files have been updated to include new field mappings and improve clarity in naming conventions. PR #2315

Bug Fixes 🐛

• Test Setup Fixes: Corrections in test setups ensure that all tests pass consistently, improving the reliability of the testing framework. PR #2315

Performance Improvements ⚡️

• Refactored Configuration Handling: The configuration handling has been refactored for better performance and maintainability, ensuring that the application runs more efficiently. PR #2315

Refactoring ♻️

• Code Structure Improvements: Significant refactoring of the codebase has been undertaken to improve readability and maintainability, including the renaming of classes and restructuring of configuration files. PR #2315

Documentation Updates 📝

• Comprehensive Documentation Revamp: The documentation has been extensively updated to reflect the latest changes, including new features and configuration options. This ensures that users have access to accurate and helpful information. PR #2315

Dependency Updates 📌

• Updated Dependencies: The project dependencies have been updated to ensure compatibility with the latest libraries and tools, enhancing overall project stability. PR #2315

Conclusion

The changes in this release significantly enhance the Azure DevOps Migration Tools, making it more user-friendly and efficient. The introduction of new features, improvements in logging and configuration management, and comprehensive documentation updates are expected to streamline the migration process for users. These enhancements align with our business goals of providing a robust and reliable migration solution, ultimately leading to increased user satisfaction and adoption.

Get the tools

• Download the MigrationTools-16.0.0-Preview.3.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.0-Preview.3 . 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-preview0003. 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

• 🔧 (main.yml): remove trailing slash from docs_baseURL for consistency by @MrHinsh in #2314
• Rename Project Folders for Clarity (and sanity) by @MrHinsh in #2315

Full Changelog: v16.0.0-Preview.2...v16.0.0-Preview.3

v16.0.0-Preview.2 (Preview)

Azure DevOps Migration Tools v16.0.0-Preview.2

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

Release Summary for Azure DevOps Migration Tools v16

Overview

The latest release of the Azure DevOps Migration Tools (v16) introduces significant enhancements, new features, and comprehensive documentation updates. This release focuses on improving the configuration management, enhancing logging capabilities, and refining the overall user experience. The changes aim to streamline the migration process and provide better support for users.

Detailed Changes

New Features ✨

• MigrationConfigCommand: A new command is added to handle configuration file creation and editing, enhancing user interaction with the tool. PR #2313
• Field Mapping Classes: New field mapping classes for Azure DevOps are introduced, allowing for more flexible data handling during migrations. PR #2313
• TelemetryLoggerFake: A new logger is added for testing purposes, improving the testing framework. PR #2313

Enhancements 💡

• Configuration Management: The configuration structure is updated for better clarity and usability, including the addition of new field mappings and improved logging settings. PR #2313
• Logging Improvements: Enhanced logging capabilities are implemented, including the integration of Serilog for better log management. PR #2313

Bug Fixes 🐛

• Test Setup Fixes: Corrections are made to the test setup for various processors, ensuring that all tests pass successfully. PR #2313
• Configuration Errors: Several typos and configuration errors are fixed in the YAML and JSON files, improving the overall stability of the tool. PR #2313

Performance Improvements ⚡️

• Processor Loading: The processor loading mechanism is refactored to use lazy initialization, which optimizes resource usage and improves performance during migrations. PR #2313

Refactoring ♻️

• Code Structure: Significant refactoring is performed across various components to improve code readability and maintainability. This includes renaming classes and reorganizing files for better clarity. PR #2313

Documentation Updates 📝

• Comprehensive Documentation: The documentation is extensively updated to reflect the new features, configuration options, and usage examples. This ensures that users have access to the latest information and guidance. PR #2313

Dependency Updates 📌

• Library Upgrades: Dependencies such as MSTest and Serilog are upgraded to their latest versions, ensuring compatibility and access to new features. PR #2313

Conclusion

The v16 release of the Azure DevOps Migration Tools represents a significant step forward in enhancing the migration experience for users. With new features, improved performance, and comprehensive documentation, this release aims to facilitate smoother migrations and better support for users. The ongoing commitment to refining the tool ensures that it remains a valuable resource for teams looking to migrate to Azure DevOps.

Get the tools

• Download the MigrationTools-16.0.0-Preview.2.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.0-Preview.2 . 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-preview0002. 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

• Revamp Documentation (1) for v16 by @MrHinsh in #2313

Full Changelog: v16.0.0-Preview.1...v16.0.0-Preview.2

v16.0.0-Preview.1 (Preview)

Azure DevOps Migration Tools v16.0.0-Preview.1

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.

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 #2241

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

---

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

v15.2.1 (Release)

Azure DevOps Migration Tools v15.2.1

Version: 15.2.1
Ring: (Release)

Overview

The latest software release for the Azure DevOps Migration Tools project includes a series of updates that enhance functionality, improve user experience, and maintain the robustness of the application. This release focuses primarily on new features and bug fixes, ensuring better performance and reliability for users migrating their DevOps environments.

Detailed Changes

New Features ✨

• Support for VssClientCredentials in Prompt Authentication Mode: The addition of support for VssClientCredentials in the prompt authentication mode (PR #2308) allows users to authenticate more flexibly. This feature is particularly beneficial for environments where dynamic credential handling is necessary, enhancing the tool's usability in diverse operational settings.

Bug Fixes 🐛

• Prompt for Credentials Fix: A crucial fix was implemented to address an issue where the tool did not correctly prompt for credentials when required. This fix (PR #2308) ensures that users are prompted appropriately, preventing authentication errors and streamlining the user experience during migrations.

Conclusion

This release of the Azure DevOps Migration Tools marks a significant step towards improving user interaction and reliability. The introduction of new features and critical bug fixes not only enhances the tool's functionality but also ensures a smoother, more secure user experience. These changes are expected to positively impact the efficiency of DevOps migrations, aligning with the broader business goals of enhancing productivity and operational flexibility.

Get the tools

• Download the MigrationTools-15.2.1.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools --version 15.2.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 15.2.1. 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

• [Fix] Prompt for Credentails by @MrHinsh in #2308

Full Changelog: v15.2.0...v15.2.1