n3wt0n/azdo2ghrepomigrator repository overview

⁠Azure DevOps To GitHub Repository Migrator

Utility to migrate a Git Repo from Azure DevOps to GitHub.

It will migrate ALL you have in your repository, including all the branches, all the tags and the complete history of commits.

Official GitHub repo: https://github.com/n3wt0n/AzureDevOpsToGitHubRepoMigrator⁠

⁠Usage

To launch the container, you can use the following command:

docker run -it -e "AZDOPAT=xxx" -e "AZDOORG=xxx" -e "AZDOPRJ=xxx" -e "AZDOREPO=xxx" -e "GHPAT=xxx" -e "GHUSER=xxx" -e "GHREPO=xxx" n3wt0n/azdo2ghrepomigrator

⁠Required Environment Variables

The container needs the following environment variables (and values) to run.

• AZDOPAT: PAT (Personal Access Token) in Azure DevOps with the Code > Read permissions granted
• AZDOORG: name of the Azure DevOps Organization where your source repository resides (the XXX in dev.azure.com/XXX or XXX.visualstudio.com)
• AZDOPRJ: name of the Azure DevOps Team Project where the source repository resides
• AZDOREPO: name of the Azure DevOps Source Repository to migrate
• GHPAT: PAT (Personal Access Token) in GitHub with the repo (Full control) permmissions granted
• GHUSER: GitHub Username with which you have created the destinatio repository
• GHREPO: name of the GitHub Destination Repository

For instruction on how to generate a PAT in Azure DevOps, take a look at the official documentation here⁠

For instruction on how to generate a PAT in GitHub, take a look at the official documentation here⁠

Please note that the Destination Repo must be empty and not be initialized.