How to restrict access to the master branch in Git

Question

I have a single repository in which I have two user groups:

• Administrators
• HTML/UI Developers

I do not wish to give read/write access of my master branch to my HTML developers as they do not need to work on it and should not be misusing the core code.

Though they need to work on their own branch ui-developers. How do I do this on Git?

P.S.: I am using Bitbucket

---

I had posted this question when I was extremely new to coding and Git. After two years of experience, I now know that Git doesn't allow to restrict READ access for any particular branch. But services like Bitbucket, GitLab, and GitHub allow you to put write and merge restrictions to branches.

Also, I shifted to GitLab six months back :)

Answer 1

Git itself does not have such feature, but many hosting providers do. This is generally known as branch protection. There is no way to prevent read access as far as I know.

Using Bitbucket

Bitbucket allows a lot of customization for the actions to prevent by branch protection. To protect a branch:

1. Go to a repository in a project.

2. Choose Settings → Branch permissions.

3. Click Add permission.

4. In the Branches field, select either Branch name, Branch pattern, or Branching model.

• Branch name - select an existing branch by name.

• Branch pattern - specify a branch using branch pattern syntax for matching branch names.

• Branching model - select the branch type to restrict access to.

5. Select the type of actions you want to prevent.

• Branch deletion - prevents branch and tag deletion.

• Rewriting history - prevents history rewrites on the specified branch(es) - for example by a force push or rebase.

• Changes without a pull request - prevents pushing changes directly to the specified branch(es); changes are allowed only with a pull request.

• All modifications - prevents pushes to the specified branch(es) and restricts creating new branches matching the specified branch(es) or pattern.

6. Optional: Add exemptions for any of the selected restrictions. Adding a user or group as an exemption means that it will not apply to them. This is not required; not adding any exemptions means the restriction will apply to everyone.

7. Click Create to finish.

Source

Using GitHub

A repository can have multiple protected branch rules that affect the same branches.

Protected branches are available only in public repositories with GitHub Free.

Protected branch in GitHub can be configured to require:

• pushes to be made via pull requests and reviewed before being merged,

• other branches to pass status check before being merged,

• commits to be signed,

• history to be linear,

• that the above rules are enforced even for administrators,

• that pushes come from specific people, teams or applications,

Force pushes and deletions can be allowed independently.

To protect a branch:

1. On GitHub, navigate to the main page of the repository.

2. Under your repository name, click Settings.

3. In the left menu, click Branches.

4. Next to "Branch protection rules", click Add rule.

5. Under "Branch name pattern", type the branch name or pattern you want to protect (Impacted branches are listed and counted).

6. Configure specific branch rule settings if needed.

7. Click Create or Save changes.

Source

Using GitLab

In GitLab, protecting a branch does the following:

• it prevents its creation, if not already created, from everybody except users with Master permission
• it prevents pushes from everybody except users with Master permission
• it prevents anyone from force pushing to the branch
• it prevents anyone from deleting the branch

To protect the branch:

1. Navigate to the main page of the project.

2. In the upper right corner, click the settings wheel and select Protected branches.

3. From the Branch dropdown menu, select the branch you want to protect and click Protect.

4. Once done, the protected branch will appear in the "Already protected" list.

You can then allow some access to users with developer rights by checking "Developers can merge" or "Developers can push"

Source

Answer 2

In Git itself you can use the "pre-receive" hook in the server to protect for writing in a branch to some user.

Using this hook you can apply your restriction policies for each file in the push.

Here you can find an example.