https://github.com/zviryatko/github-to-azure-migration
Migrates issues, PRs and commit references from Github to Azure DevOps
https://github.com/zviryatko/github-to-azure-migration
Last synced: about 1 year ago
JSON representation
Migrates issues, PRs and commit references from Github to Azure DevOps
- Host: GitHub
- URL: https://github.com/zviryatko/github-to-azure-migration
- Owner: zviryatko
- Created: 2021-01-15T13:53:01.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-01-19T16:37:22.000Z (over 5 years ago)
- Last Synced: 2025-02-16T12:57:41.501Z (over 1 year ago)
- Language: PHP
- Size: 22.5 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Github to Azure DevOps migration
The main goal of this project is to migrate Issues and Commit references from Github to Azure DevOps.
Things that was out of scope, but it's still possible to implement:
- it will not sync issues between, so it's only one time migration
- it will not create users, all related users must be creat upfront
- it will not sync/upload attachments to Azure
- it will not update all internal links like "Some issue #123" to new Azure issue, it is done partly only when old ticket referenced in new one, but not vice versa
Every failed try requires wipe on Azure DevOps, see Wipe section.
## Requirements
* PHP7.4 or later
* Composer https://getcomposer.org/
## Usage
1. Clone repo
2. Setup
3. Copy target repository to Azure
3. `php ./bin/github2azure migrate -u usermap.csv`
If it fails, see Wipe section and restart again.
## Setup
Install dependencies:
```shell
composer install
```
```shell
cp .env.dist .env
```
Edit `.env` and fill Github organization/repo and Azure DevOps organization and repo.
Prepare users list to migrate (put only users that exists in Azure DevOps):
```shell
cp usermap.csv.dist usermap.csv
```
Edit `usermap.csv` and keep the original format: `github-username, Azure User Name `.
It is needed because migration of user accounts is out of scope of this migration tool.
Also Github API doesn't allow extracting real user emails, but only username.
### Permissions
The api use should have next permissions allowed:
- **General**: Suppress notifications for work item updates
- **Boards**: Bypass rules on work item updates
- **Boards**: Delete and restore work items
- **Boards**: Permanently delete work items
*last two needed for deleting wrongly imported issues.
### Project Process
This migration script uses three types of issue types: Epic, User Story and Bug.
So Github issues migrated to referenced type by next rules:
- Milestone > Epic
- Issue -> User Story
- Issue (with tag "bug") > Bug
Most likely you need to change Process to Agile, it can be done through Project settings > General > Overview > Process
## Copy target repository to Azure
```shell
git remote add azure git@ssh.dev.azure.com:v3/[ORGANIZATION]/[PROJECT]/[REPO]
git fetch origin +refs/heads/*:refs/heads/* --prune && git push azure --mirror --force
```
## Wipe
To wipe everything go to Azure DevOps Boards > Queries and create a simple query with all issue. Select all issue with CTRL+A and delete them via right click menu.
Then go to Boards > Work items > Recycle Bin and again select all and click to Permanently delete.
Go to Repos and at the top (breadcrumbs) click to repo name and select Manage repositories and re-create the needed repository (if it's single just rename it to some temp and create new repo with default name again and delete renamed).