GitLab source control

We use GitLab for all our projects. The majority of our projects tend to have two to three people working on them at any given point and it's quite often that we'll come back to a project and maintain it for a signification period of time. It is therefore important that we keep repositories clean and tidy.

  1. Repository naming conventions
  2. Commit naming
  3. Commit frequency
  4. Branches
  5. Useful Commands

Repository naming conventions

Please use kebab-cased only, the repository name should be a naked version of the actual domain:

Commit naming

We don't have a particular format for a commit message however it would be encouraged that these are more descriptive. Once a project goes live the team should always provide descriptive commit messages:

It is very important that commits are more regular, this helps the team to review recent changes for whatever reason. Furthermore, at the end of the day a commit should be made for projects that are in-progress. Some example commits might be:

Commit frequency

It is encouraged to push more frequently i.e. when a task or sub-task has been completed. You may, however, choose to push many updates which are interlinked. It is up to you to decide on how often to push changes. If unclear, check with other members of the team!

Branches

GitLab sets master as the default branch for a project (repository). You can create and choose another branch push to, alternatively to manually creating a new branch on GitLab, you can do so using command line too. An example of this would be:

Create a new Branch:

  1. $ git pull origin master # Pull latest changes before creating a new branch
  2. $ git branch -r # List all the current branches in the project
  3. $ git branch # List current branch
  4. $ git checkout -b <branch-name> # Create a new branch and check it out
  5. $ git branch # List new branch
  6. $ git add * # Add all local changes
  7. $ git commit -m "Testing branch" # Commit changes with title
  8. $ git push origin <branch-name> # Push changes to new branch

Grab all branches and change to new Branch:

  1. $ git pull # Grab all existing/new branches
  2. $ git branch -v - Check branch and which commit local build is current at
  3. $ git branch -r # List all the current branches in the project
  4. $ git checkout <branch-name> # Switch to the targeted branch
  5. $ git branch -v # Check you are in the new Branch

Deleting branch commits

Only on specific circumstances should commits be deleted, such as moving commits over to a new branch and deleting them from master.

  1. $ git reset -- hard <commit SHA> # Reset local build to commit
  2. If the branch is protected then relocate to settings/repository of the repo on GitLab and unprotect the branch you are wanting to change (i.e. master)
  3. $ git push origin <branch-name> -- force # Push files to the branch, removing all commits above the current one on local.
  4. Remember to protect the branch again if it was in the first place

Useful Commands

Clean and reset

$ git clean --force -d -x
$ git reset --hard

Clean

$ git clean --force -d -x

Reset

$ git reset --hard
$ git reset --hard 7af48493 - reset to a commit