Managing Git Repositories with GitLab

GitLab is one of the most powerful Git repository management platforms, providing a wide range of features including version control, CI/CD pipelines, collaboration tools, and security integrations. Whether you’re an individual developer or part of a large team, GitLab offers an efficient way to manage repositories, track changes, and automate workflows.

This guide will walk you through the essential GitLab repository management tasks, from creating repositories and branches to cloning, renaming, and accessing repositories via Git Bash.

Table of Contents

1. Introduction to GitLab
2. How to Access GitLab?
3. Uploading Code to a GitLab Repository
4. Creating and Managing Branches in GitLab
5. Cloning a Git Repository from GitLab
6. Renaming a Git Repository in GitLab
7. How to Give Access to a Git Repository in GitLab
8. Reinitializing an Existing Git Repository
9. Using GitLab Runner to Fetch Source Code
10. Best Practices for Managing GitLab Repositories
11. Conclusion

🔗 Official Documentation:

• GitLab Docs
• GitLab Repository Management

1. Introduction to GitLab

GitLab is a web-based Git repository manager that provides version control, collaboration tools, and DevOps capabilities. It enables teams to:

✔ Store and manage source code.
✔ Collaborate using merge requests and reviews.
✔ Automate software development with CI/CD pipelines.
✔ Enhance security with built-in code scanning.

Managing Git Repositories with GitLab
2. How to Access GitLab?

Before managing repositories, you need GitLab access.

Step 1: Sign in to GitLab

• Visit GitLab Sign-In.
• Sign in using Google, GitHub, Bitbucket, or Salesforce.

Step 2: Create a New Group and Project

• Click New Project → Create from Template or Import from GitHub.
• Name the project and select repository visibility (Public, Private, Internal).

3. Uploading Code to a GitLab Repository

A repository is where your source code is stored.

Step 1: Navigate to Your Repository

• Go to GitLab Dashboard → Your Project → Repository.

Step 2: Upload Files via GitLab Web UI

• Click “+” → Upload File.
• Choose the file and click Upload.

Step 3: Upload Files via Git CLI

If you prefer Git CLI, follow these steps:

git clone https://gitlab.com/your-username/your-repo.git
cd your-repo
echo "My first GitLab commit" > README.md
git add .
git commit -m "Initial commit"
git push origin main

4. Creating and Managing Branches in GitLab

Branches allow developers to work on different features without affecting the main branch.

Step 1: View Existing Branches

• Go to Repository → Branches.

Step 2: Create a New Branch

• Click New Branch.
• Enter a branch name (e.g., feature-login).
• Select the main branch as the base.

Step 3: Switch to the New Branch Locally

git checkout -b feature-login

Step 4: Merge a Branch

Once work is complete, merge it into main.

git checkout main
git merge feature-login
git push origin main

5. Cloning a Git Repository from GitLab

You can clone a repository to work locally.

Step 1: Copy the Repository URL

• Open your project in GitLab.
• Click Clone → Copy HTTPS or SSH URL.

Step 2: Clone the Repository

git clone https://gitlab.com/your-username/your-repo.git
cd your-repo

6. Renaming a Git Repository in GitLab

To rename a repository:

• Navigate to Settings → General.
• Under Advanced Settings, rename the project.
• Click Save Changes.

7. How to Give Access to a Git Repository in GitLab

Step 1: Navigate to Members Section

• Open Project → Members.
• Click Invite Members.

Step 2: Assign Access Levels

• Choose roles: Guest, Reporter, Developer, Maintainer, Owner.

# Grant push/pull access via CLI
git remote set-url origin [email protected]:your-group/your-repo.git

8. Reinitializing an Existing Git Repository

If a repository is corrupt, you can reinitialize it.

rm -rf .git
git init
git remote add origin https://gitlab.com/your-username/your-repo.git
git pull origin main

9. Using GitLab Runner to Fetch Source Code

GitLab Runners execute CI/CD jobs.

Step 1: Install GitLab Runner

sudo apt-get install gitlab-runner

Step 2: Register GitLab Runner

gitlab-runner register

This enables GitLab CI/CD to fetch source code automatically.

10. Best Practices for Managing GitLab Repositories

✔ Use meaningful commit messages (git commit -m "Fix login bug").
✔ Keep branches short-lived (feature/authentication).
✔ Protect the main branch (Settings → Repository → Protected Branches).
✔ Use CI/CD pipelines for automatic testing.

11. Conclusion

GitLab makes repository management easy, offering powerful tools like branches, access control, CI/CD, and GitLab Runners. With this guide, you can:

✅ Create, clone, and rename repositories.
✅ Manage branches and user access.
✅ Integrate GitLab Runner for automation.

Next Steps:

• Explore GitLab CI/CD.
• Secure repositories with SSH keys.
• Automate workflows using GitLab webhooks.
• how to create branch in git and push code​