Renaming the default branch in Azure Data Factory Git repositories from "master" to "main"

Mon, 21 Sep 2020 15:42:30 +0200

In Azure Data Factory, you can connect to a Git repository using either GitHub or Azure DevOps. When connecting, you have to specify which collaboration branch to use. In most cases, the default branch is used. Historically, the default branch name in git repositories has been “master”. This is problematic because it is not inclusive and is very offensive to many people.

The Git project, GitHub, and Azure DevOps are making changes to allow users to specify a different default branch name. GitHub and Azure DevOps will be changing their default branch names to “main” in 2020. I fully support this change and will be doing the same in my projects.

In this post, we will go through how to rename the default branch from “master” to “main” in Azure Data Factory Git repositories hosted in GitHub and Azure DevOps. Then we will reconnect Azure Data Factory and configure it to use the new “main” branch as the collaboration branch.

For these examples, I’m using my personal demo projects. I’m not taking into consideration any branch policies, other users, third-party tools, or external dependencies. As always, keep in mind that this is most likely a larger change, both technically and organizationally, in production and enterprise projects. 😊

The Short Version

Create a new “main” branch in your Git repository
Set the new “main” branch as the default branch in your Git repository
Delete the old “master” branch in your Git repository
Disconnect from your Git repository in Azure Data Factory
Reconnect to your Git repository in Azure Data Factory using the new “main” branch as the collaboration branch

Git on Cathrine Wilhelmsen

Renaming the default branch in Azure Data Factory Git repositories from "master" to "main"

The Short Version