PowerShell script to migrate Azure DevOps work items to GitHub Issues
[TAG] = "migrate"
@
-gh_update_assigned_to
and -gh_assigned_to_user_suffix
options-$ado_production_run $true"
. The tag prevents duplicate copying.The recommendation is to use a GitHub App to run the migration - a GitHub app has higher rate limits than using a user PAT.
Contents:Read
Issues:Read and write
Members:Read
ADO_PAT
: Azure DevOps PAT with appropriate permissions to read work and write itemsPRIVATE_KEY
: The contents of the private key created and downloaded in step #2Using the GitHub app might be better so you don't reach a limit on your GitHub account on creating new issues 😀
./ado_workitems_to_github_issues.ps1 `
-ado_pat "abc" `
-ado_org "jjohanning0798" `
-ado_project "PartsUnlimited" `
-ado_area_path "PartsUnlimited\migrate" `
-ado_migrate_closed_workitems $false `
-ado_production_run $false `
-gh_pat "ghp_xxx" `
-gh_org "joshjohanning-org" `
-gh_repo "migrate-ado-workitems" `
-gh_update_assigned_to $true `
-gh_assigned_to_user_suffix "" `
-gh_add_ado_comments $true
Parameter | Required | Default | Description |
---|---|---|---|
-ado_pat |
Yes | Azure DevOps Personal Access Token (PAT) with appropriate permissions to read work items (and update, with -ado_production_run $true ) |
|
-ado_org |
Yes | Azure DevOps organization to migrate from | |
-ado_project |
Yes | Azure DevOps project to migrate from | |
-ado_area_path |
Yes | Azure DevOps area path to migrate from - uses the UNDER operator |
|
-ado_migrate_closed_workitems |
No | $false |
Switch to migrate closed/resoled/done/removed work items |
-ado_production_run |
No | $false |
Switch to add copied-to-github tag and comment on ADO work item |
-gh_pat |
Yes | GitHub Personal Access Token (PAT) with appropriate permissions to read/write issues | |
-gh_org |
Yes | GitHub organization to migrate work items to | |
-gh_repo |
Yes | GitHub repo to migrate work items to | |
-gh_update_assigned_to |
No | $false |
Switch to update the GitHub issue's assignee based on the username portion of an email address (before the @ sign) |
-gh_assigned_to_user_suffix |
No | "" |
Used in conjunction with -gh_update_assigned_to , used to suffix the username, e.g. if using GitHub Enterprise Managed User (EMU) instance |
-gh_add_ado_comments |
No | $false |
Switch to add ADO comments as a section with the migrated work item |
-gh_update_assigned_to $true
, you/your users will receive a lot of emails from GitHub when the user is assigned to the issue