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
📝 (docs): update 404 and index pages to improve user guidance
The 404 page is simplified to provide a clearer message to users
that the page they are looking for may have been moved or deleted.
The index page now contains detailed information about the Azure
DevOps Migration Tools, including features, compatibility, and
support options. This reorganization improves user experience by
making essential information more accessible and ensuring users
can find the documentation and support they need more easily.
The Azure DevOps Migration Tools allow you to bulk edit and migrate data between Team Projects on both Microsoft Team Foundation Server (TFS) and Azure DevOps Services. Take a look at the [documentation](https://nkdagility.com/learn/azure-devops-migration-tools/) to find out how. This project is published as [code on GitHub](https://github.com/nkdAgility/azure-devops-migration-tools/) as well as a Winget package a `nkdAgility.AzureDevOpsMigrationTools`.
12
11
13
-
**[Ask Questions on Github](https://github.com/nkdAgility/azure-devops-migration-tools/discussions)**
14
-
15
-
## Compatability
16
-
17
-
These tools run on Windows and support connecting to Team Foundation Server 2013+, Azure DevOps Server, & Azure DevOps Services. They support both hosted and on-premise instances and can move data between any two.
18
-
19
-
- Supports all versions of TFS 2013+ and all versions of Azure DevOps.
20
-
- You can migrate from any TFS/Azure DevOps source to any TFS/Azure DevOps target.
21
-
22
-
## What do you get?
23
-
24
-
-*Move* Work Items, Test Plans & Suits, and Pipelines between projects, collections, and even organizations.
25
-
-*Merge* multiple projects into a single project even from different organizations.
26
-
-*Split* one project into several projects even between projects, collections, and even organizations.
27
-
-*Change* Process process from Agile to Scrum or any other template.
28
-
-*Bulk edit* Work Items.
29
-
30
-
## What does this tool do?
31
-
32
-
For the most part we support moving data between `((Azure DevOps Server | Team Foundation Server | Azure DevOps Services) <=> (Azure DevOps Server | Team Foundation Server | Azure DevOps Services))` for any version greater than 2013.
33
-
34
-
-`Work Items` (including links and attachments) with custom mappings for fields and types
35
-
- Copy Work Items between locations with history
36
-
- Bulk Edit in place of Work Items (Great for cleaning up data, process template changes)
37
-
- Optionaly includes `Teams`, `Shared Queries`
38
-
-`Test Plans & Suites`
39
-
- Copy Test Plans & Suites between locations
40
-
- Includes `Configurations`, `Shared Steps`, `Shared Parameters`
41
-
-`Pipelines`
42
-
- Copy Pipelines between locations
43
-
- excludes XAML & Classic Builds & Release
44
-
-`Processes`
45
-
- Copy Processes between locations
46
-
47
-
**Note**: 'Locations' includes `Projects`, `Collections`, `Organizations`
48
-
49
-
**Important:** This tool is intended for experienced users familiar with TFS/Azure DevOps object models and debugging in Visual Studio. It was developed by 100+ contributors from the Azure DevOps community to handle various scenarios and edge cases. _Not all cases are supported_.
50
-
51
-
**Support Options:** Community support is available on [GitHub](https://github.com/nkdAgility/azure-devops-migration-tools/discussions). For paid support, consider our [Azure DevOps Migration Services](https://nkdagility.com/capabilities/azure-devops-migration-services/).
The documentation for the preview is on [Preview](https://preview.nkdagility.com/docs/azure-devops-migration-tools/)]
65
-
66
-
#### External Walkthroughs and Reviews
67
-
68
-
*[TFS 2017 Migration To Azure DevOps with Azure DevOps Sync Migrator from Mohamed Radwan](http://mohamedradwan.com/2017/09/15/tfs-2017-migration-to-vsts-with-vsts-sync-migrator/)
69
-
*[Options migrating TFS to Azure DevOps from Richard Fennell](https://blogs.blackmarble.co.uk/blogs/rfennell/post/2017/05/10/Options-migrating-TFS-to-VSTS)
70
-
*[Migrating Test artifacts and all other work item types using the Azure DevOps from Gordon Beeming](https://youtu.be/jU6E0k0eXXw)
71
-
72
-
73
-
## Metrics (v16+ experimental)
74
-
75
-
These metrics come directly from Custo Metrics in Application Insights and are updated every 10 minutes. They are experimental and may not be accurate yet... once I get more data Ill tweek both the collection and rendering.
| WorkItemMetrics | Work Items | Count ||| This counts the number of work items processed |
80
-
| WorkItemMetrics | Work Items | Ave ||| the average amount of time a work item takes to process |
81
-
| WorkItemMetrics | Revisions | Count ||| the total number of revisions processed |
82
-
| WorkItemMetrics | Revisions | Ave ||| the average number of revisions per work item |
83
-
84
-
85
-
86
-
87
-
This tool uses OpenTelemetery to collect metrics and logs, and Application Insights to store and analyse them. Exceptions are also sent to [Elmah.io](https://elmah.io) for analysis and improvement.
88
-
89
-
### Some Data from the last 30 days (v15- as of 06/04/2023)
90
-
91
-
| Catagory | Metric | Notes |
92
-
| ------------- | ------------- | ------------- |
93
-
| Work Item Revisions |**14m**| A single Work Item may have many revisions that we need to migrate |
94
-
| Average Work item Migration Time |**35s**| Work Item (inlcudes all revisions, links, and attachements for the work item) |
95
-
| RelatedLinkCount |**5m**| Each work item may have many links or none. |
96
-
| Git Commit Links |**480k**||
97
-
| Attachments |**252.37k**| Total number of attachments migrated |
98
-
| Test Suits | 52k | total suits migrated |
99
-
| Test Cases Mapped |**800k**| Total test cases mapped into Suits |
100
-
| Migration Run Ave |**14 minutes**| Includes dry-runs as well. |
101
-
| Migration Run Total |**19bn Seconds**| Thats **316m hours** or **13m days** of run time in the last 30 days. |
102
-
103
-
104
-
## Processors
105
-
106
-
{% include content-collection-table.html collection = "reference" typeName = "Processors" %}
107
-
108
-
## Field Maps
109
-
110
-
By default, when you are moving from source to target the system will map all of the fields that exist in source to the same field in the target. This is the behavior if the **FieldMaps** section is not present in the configuration file.
111
-
112
-
However sometimes you want to move data to another field, or use a regex to parse out just the bits that you want. To help we have built a number of mapping tools that should give you the versatility you need.
113
-
114
-
{% include content-collection-table.html collection = "reference" typeName = "FieldMaps" %}
115
-
116
-
117
-
## Why does this exist
118
-
The main migration tool for TFS has always been the TFS Integration Tools which is sadly no longer supported. Indeed it only loosely supported versions of TFS after 2010 and had a lot of bugs. It was very difficult to configure and run. This tool hopes to solve some of that by providing support for TFS 2015 and Visual Studio Team Services (VSTS).
119
-
120
-
It solves:
121
-
122
-
* Supports all currently supported version of TFS
123
-
* Supports Azure DevOps Services
124
-
* Migrates work items from one instance of TFS or Azure DevOps to another
125
-
* Bulk edits fields in place for both TFS and Azure DevOps Services
126
-
* Being able to migrate Test Plans an Suits from one Team Project to another
127
-
* Being able to migrate Teams from one Team Project to another
128
-
129
-
## Contributing
130
-
131
-
If you wish to contribute then feel free to fork this repository and submit a pull request. If you would like to join the team please contact.
132
-
133
-
This project is primarily managed and maintained on Visual Studio Team Services and code checked into MASTER is automatically synched between VAzure DevOps and GitHub. There is no hidden published code, but not all branches are published.
134
-
135
-
If you want to sync your GitHub repository then check out [Open-source with Azure DevOps or TFS and Github for better DevOps
***Martin Hinshelwood, naked Agility Ltd** - [@MrHinsh](https://github.com/MrHinsh) is the founder of the Azure DevOps Migration Tools is available worldwide to help organisations plan and enact their migration efforts. You can contact him through [naked Agility Ltd.](https://nkdagility.com).
142
-
***Wes MacDonald, LIKE 10 INC.** - [@wesmacdonald](https://github.com/wesmacdonald) is a DevOps Consultant located in Toronto, Canada. You can reach out to him via [LIKE 10 INC.](http://www.like10.com).
143
-
***Ove Bastiansen** - [@ovebastiansen](https://github.com/ovebastiansen) is a DevOps consultant living in Oslo, Norway, but working worldwide in todays remote friendly world. You can reach him via his GitHub profile [https://github.com/ovebastiansen](https://github.com/ovebastiansen).
144
-
***Gordon Beeming** - [@DevStarOps](https://github.com/DevStarOps) is a DevOps Specialist in Durban, South Africa working at [Derivco](https://derivco.com). You can reach him via his [profile page](https://devstarops.com/) that links to all social media.
145
-
***Richard Hundhausen** - [@rhundhausen](https://github.com/rhundhausen) is an Azure DevOps consultant living in the United States and working at [Accentient](https://accentient.com)
146
-
147
-
## Terms
148
-
149
-
naked Agility Limited & our contributors creates and maintains the "Azure DevOps Migration Tools" project under its [terms of business](https://nkdagility.com/terms/) and allows full access to the source code for customers and the general public.
12
+
The page you are looking for may have been moved or deleted! Try to find what you want in the left navigation.
0 commit comments