Git HOWTO for MidCOM 3 developers

I had quite much of trouble in hacking my way through the jungle to be able to commit changes into GIT. Here is a small walkthrough, if you aren't afraid of spoilers.

There is no interface for changing the public key, username, email address or anything else afterwards, so do the steps carefully. It's only a small inconvenience to create a new user and SSH key pair after each failure, but I had to repeat this three times myself.

  1. Create a user account for your development machine or use an existing one.
    • unfortunately there is no way to check beforehand if the user account name is already used in MidCOM GIT repository.
  2. Create an SSH key to use for authenticating yourself with $ ssh-keygen -t dsa
  3. Copy the public SSH key and paste it on the new user creation page
    • do not use less or any other program that would add line breaks, using e.g. $ cat /home/example/.ssh/id_dsa.pub will help through this step
  4. Paste the whole key
    • starts from ssh-dss and ends up in example@example.com
    • wish that the username hasn't yet been reserved
  5. Ask for the project manager (in this case Bergie) to join you to the project
  6. Set the user configuration
    • with my Debian installation it was $ git-repo-config --global user.name "Firstname Lastname" and $ git-repo-config --global user.email "firstname.lastname@example.com"
    • GIT manual tells to use $ git config --global ..., but that didn't work at all with me
  7. Get the latest checkout with $ git pull
  8. Now you should be able to make commits. Syntax for doing so is $ git push git+ssh://example@repo.or.cz/srv/git/midcom.git

Back