You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+17-17Lines changed: 17 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,10 +6,10 @@ The Azure DevOps Migration Tools allow you to bulk edit and migrate data between
6
6
7
7
## Some Data from the last 30 days (as of 06/04/2023)
8
8
9
-
|Catagory| Metric | Notes |
9
+
|Category| Metric | Notes |
10
10
| ------------- | ------------- | ------------- |
11
11
| Work Item Revisions |**14m**| A single Work Item may have many revisions that we need to migrate |
12
-
| Average Work item Migration Time |**35s**| Work Item (inlcudes all revisions, links, and attachements for the work item) |
12
+
| Average Work item Migration Time |**35s**| Work Item (includes all revisions, links, and attachments for the work item) |
13
13
| RelatedLinkCount |**5m**| Each work item may have many links or none. |
14
14
| Git Commit Links |**480k**||
15
15
| Attachments |**252.37k**| Total number of attachments migrated |
@@ -22,8 +22,8 @@ The Azure DevOps Migration Tools allow you to bulk edit and migrate data between
22
22
## What can you do with this tool?
23
23
24
24
- Migrate `Work Items`, `TestPlans & Suits`, `Teams`, `Shared Queries`, `Pipelines`, & `Processes` from one `Team Project` to another
25
-
- Migrate `Work Items`, `TestPlans & Suits`, `Teams`, `Shared Queries`, `Pipelines`, & `Processes` from one `Organisation` to another
26
-
- Bulk edit of `Work Items`accross an entire `Project`.
25
+
- Migrate `Work Items`, `TestPlans & Suits`, `Teams`, `Shared Queries`, `Pipelines`, & `Processes` from one `Organization` to another
26
+
- Bulk edit of `Work Items`across an entire `Project`.
27
27
28
28
**WARNING: This tool is not designed for a novice. This tool was developed to support the scenarios below, and the edge cases that have been encountered by the 30+ contributors from around the Azure DevOps community. You should be comfortable with the TFS/Azure DevOps object model, as well as debugging code in Visual Studio.**
29
29
**Community support is available through [GitHub](https://github.com/nkdAgility/azure-devops-migration-tools/discussions) ; Paid support is available through our [recommended consultants](https://nkdagility.com/docs/azure-devops-migration-tools/#support) as well as our contributors and many DevOps consultants around the world.**
@@ -54,7 +54,7 @@ The Azure DevOps Migration Tools allow you to bulk edit and migrate data between
-[Questions on Usage](https://github.com/nkdAgility/azure-devops-migration-tools/discussions)
56
56
57
-
## Installing an running the tools
57
+
## Installing and running the tools
58
58
59
59
We use [winget](https://learn.microsoft.com/en-us/windows/package-manager/winget/) to host the tools, and you can use the command `winget install nkdAgility.AzureDevOpsMigrationTools` to install them on Windows 10 and Windows 11. For other operating systems you can download the [latest release](https://github.com/nkdAgility/azure-devops-migration-tools/releases/latest) and unzip it to a folder of your choice.
60
60
@@ -64,37 +64,37 @@ For a more detailed getting started guide please see the [documentation](https:/
64
64
65
65
## Support
66
66
67
-
1.[Question & Discussion](https://github.com/nkdAgility/azure-devops-migration-tools/discussions) - The first place to look for unsage, configuration, and general help.
68
-
1.[Issues on Gitbub](https://github.com/nkdAgility/azure-devops-migration-tools/issues) - If you have identified a bug and have logs then please raise an issue.
67
+
1.[Question & Discussion](https://github.com/nkdAgility/azure-devops-migration-tools/discussions) - The first place to look for usage, configuration, and general help.
68
+
1.[Issues on GitHub](https://github.com/nkdAgility/azure-devops-migration-tools/issues) - If you have identified a bug and have logs then please raise an issue.
69
69
70
70
### Professional Support
71
71
72
-
You can get free support from the community above and on social media on a best effort basis if folks are available. If you are *looking for paid support*[naked Agility with Martin Hinshelwood & Co](https://nkdagility.com) has a number of experts, many of whom contribute to this project, that can help. Find out how [we can help you](https://nkdagility.com/technical-consulting-and-coaching/azure-devops-migration-tools-consulting/) with your migration and [book a free consultation](https://nkdagility.com/technical-consulting-and-coaching/azure-devops-migration-tools-consulting/) to discuss how we can make things easyer.
72
+
You can get free support from the community above and on social media on a best effort basis if folks are available. If you are *looking for paid support*[naked Agility with Martin Hinshelwood & Co](https://nkdagility.com) has a number of experts, many of whom contribute to this project, that can help. Find out how [we can help you](https://nkdagility.com/technical-consulting-and-coaching/azure-devops-migration-tools-consulting/) with your migration and [book a free consultation](https://nkdagility.com/technical-consulting-and-coaching/azure-devops-migration-tools-consulting/) to discuss how we can make things easier.
73
73
74
74
We use these tools with our customers, and for fun, to do real world migrations on a daily basis and we can:
75
75
76
-
- Consult with your internal folks who need help and guidance in runnign the tooling.
77
-
- Make changes to the tool to support your needs; all additions are commited to the main repo.
76
+
- Consult with your internal folks who need help and guidance in running the tooling.
77
+
- Make changes to the tool to support your needs; all additions are committed to the main repo.
78
78
- Run the migration for you:- you would need to pay for the hours that we would spend baby-sitting the running migrations
79
79
80
80
## Change Log
81
81
82
82
- 14.2 - Removed the `StopMigrationOnMissingAreaIterationNodes` flag. All missing nodes MUST be present or mapped using `AreaMaps` and `IterationMaps`. System will always stop on missing nodes.
83
-
- 14.1 - Enabled auto update on clinet devices, server stull ised choco
83
+
- 14.1 - Enabled auto update on client devices, server still used choco
84
84
- 14.0 - Move from Chocolaty to Winget as the base installer. We will continue to publish to Chocolaty, but we recommend using `winget install nkdAgility.AzureDevOpsMigrationTools` for future installs. Main executable renamed to "devopsmigration.exe" to prevent conflict with other applications with symbolic links.
85
85
- 13.2 - Added [ExportUsersForMapping](https://nkdagility.com/learn/azure-devops-migration-tools/Reference/v1/Processors/TeamMigrationContext/) to export a json file with a list of users ready for a field mapping.
86
-
- 13.1 - Update all NuGet packages to latest version.
87
-
- 13.0 - Update to .net 7.0 with all dependancies. Focus on documentation improvements to support future updates.
86
+
- 13.1 - Update all NuGet packages to the latest version.
87
+
- 13.0 - Update to .net 7.0 with all dependencies. Focus on documentation improvements to support future updates.
88
88
- 12.1 - Make embedded images regex lazy
89
-
- 12.1 - Added a stop when there are area or iteration nodes in the source history that are not in the target. This causes missing of data. System will now list the areas and iteration that are missing, and then stop. You can decide to add them manually, or add a field mapping.
90
-
- v11.11 - Refactored revision manager to have more tests and support limiting the number of revisions. CollapseRevisions has been replaced by setting MaxRevisions to 1 and setting AttachRevisionHistory to true; MaxRevisions sets the maximum number of revisions that will be migrated. "First + Last*N = Max". If this was set to 5 and there were 10 revisions you would get the first 1 (creation) and the latest 4 migrated. This is done after all of the existing revisions are created but before anything newer that target is removed.
91
-
- v11.10 - Added ability to limit the number of revisions migrated with `MaxRevisions` on `WorkItemMigration` processor. 0 = All, and any other number should migrate the first revision + the latest up to MAX.
89
+
- 12.1 - Added a stop when there are area or iteration nodes in the source history that are not in the target. This causes missing data. System will now list the areas and iteration that are missing, and then stop. You can decide to add them manually, or add a field mapping.
90
+
- v11.11 - Refactored revision manager to have more tests and support limiting the number of revisions. CollapseRevisions has been replaced by setting MaxRevisions to 1 and setting AttachRevisionHistory to true; MaxRevisions sets the maximum number of revisions that will be migrated. "First + Last*N = Max". If this was set to 5 and there were 10 revisions you would get the first 1 (creation) and the latest 4 migrated. This is done after all of the existing revisions are created but before anything newer than that target is removed.
91
+
- v11.10 - Added ability to limit the number of revisions migrated with `MaxRevisions` on the `WorkItemMigration` processor. 0 = All, and any other number should migrate the first revision + the latest up to MAX.
92
92
- v11.9 - Dark launch of `Process` migration by @akanieski
93
93
- v11.9 - Dark launch of `Pipelines` & `Builds` migration by @tomfrenzel
94
94
- v11.8 - As part of moving to the new architecture we moved to default newtonsoft type handling with `$type` properties instead of `ObjectType`___To Migrate rename "ObjectType" to "$type" in your configuration!___
95
95
- v11.5 - Added more useful logging levels. Replace `"TelemetryEnableTrace": false` with `"LogLevel": "Verbose"` in the config. Verbose will only be logged to the logfile.
96
96
- v11.2.1 - Removed NodeMigrationContext and converted it to an enricher for Work Items. Still needs work, so that it migrates individual nodes, but currently migrates all.
97
-
- v10.1 - Changed config design to have only the Name and not FullName of the class. Remove `MigrationTools.Core.Configuration.FieldMap.` and `MigrationTools.Core.Configuration.Processing.` from the config leaving only the Name of the class in ObjectType field.
97
+
- v10.1 - Changed config design to have only the Name and not FullName of the class. Remove `MigrationTools.Core.Configuration.FieldMap.` and `MigrationTools.Core.Configuration.Processing.` from the config leaving only the Name of the class in the ObjectType field.
98
98
- v10.0 - Start of the great refactor over to .NET Core and the REST API as the Object Model has been retired.
99
99
- v9.0 - Added support for migration between other language versions of Azure DevOps. Developed for German -> English
100
100
- v8.9 - Added 'Collapse Revisions' feature to collapse and attache revisions instead of replaying them
0 commit comments