TortoiseGit example configuration


Introduction

On demand, we provide a private and secured version control service for our customers during software development. For this we use git combined with a Continuous Integration build powered by GitLab CE. Advantages are:

At the moment (12/2017) we recommend using TortoiseGit as the graphical client for Git on Windows. Here we describe how it can be used together with the GitLab service running at https://www.git.heindl-solutions.com/. See a more generic overview on how git is used at heindl-solutions.com and a list of alternative Windows clients have a look at the page Usage of git.heindl-solutions.com first.  
  1. Download TortoiseGit from https://tortoisegit.org/ .
  2. During installation, choose options Use Git from Windows Command Prompt, Use (Tortoise)Plink, Use MinTTY.
  3. Now install the git.exe command line executables. Download and install from https://git-for-windows.github.io/ .
  4. Initial settings for Git (has to be done only once after installation) TortoiseGit settings: TortoiseGit Settings 1
  5. Set name and email in TortoiseGit:
    TortoiseGit Settings 2
  6. Clone a project from git.heindl-solutions.com. Log in at https://git.heindl-solutions.com/ with your git.heindl-solutions.com account. Click on a project to clone. Copy the URL by clicking on the copy button.
    TortoiseGit Clone 0 (https)
  7. Clone using TortoiseGit directly in Windows Explorer:
    TortoiseGit Clone 1
  8. Paste the URL from clipboard copied before: Clone from git.heindl-solutions.com: TortoiseGit Clone 2
  9. Enter your credentials from git.heindl-solutions.com in the Git credential manager for Windows:
    TortoiseGit Clone 3
You should get the repository cloned into a subdirectory of e.g. myprojects.  

Update your local clone to latest version

As soon as you expect some changes in the repository (probably by some developer from heindl-solutions.com), you can update your local cloned repository to this latest version:
  1. In Windows Explorer, right-click on the repository folder
  2. Select TortoiseGit / Pull...
  3. In the opening dialog window, the defaults should be OK. Click OK.
   

Command line

You can use the command line as an alternative:

Initial settings

Open command prompt. Enter:

git config --global user.email "you@example.com"
git config --global user.name "Your Name"

Checkout repository

Open command prompt. Enter:

cd C:\myprojects
git clone https://git.heindl-solutions.com/USERNAME/PROJECTNAME

Replace USERNAME and PROJECTNAME with the correct URL, e.g.:

git clone https://git.heindl-solutions.com/andreas/example.git
 

For advanced users

  1. Checkout is possible via SSH, too:
    TortoiseGit Clone 0 (SSH)