Wiki

Source: Bryan Sullivan, AT&T

There are multiple ways to get git/gerrit working on Windows. Here are two:

1. Use Git for Windows
2. Run a linux under VirtualBox, and use the guides for Linux (TO BE DESCRIBED)

This procedure may be terse, but will be clarified as needed and will be re-tested to make sure nothing is missing (steps that I took to get this working may have been forgotten in fumbling toward a solution…).

• Install Putty (the ZIP file or installer package) from http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
• If you don't have a public/private key pair yet, run PuTTYgen and generate a pair
• Assuming you have already created a gerrit account for the project/org, add your public key to the account through the gerrit UI, e.g. https://gerrit.opnfv.org/gerrit/#/settings/ssh-keys
• Install Git for Windows from http://www.git-scm.com/downloads
• Run Git Bash. Further commands below are run in the git bash shell.
• Create/edit your .bashrc file using vi or your editor. .bashrc sets up your bash environment when you run Git Bash
  • vi ~/.bashrc

      #!/bin/bash
      PATH=$PATH:"/C/Program Files/Git/bin"
      eval `ssh-agent`
      # add my private key
      ssh-add (path to your private key, e.g. /c/files/my-key)
      # (optional) go to your git clone home dir
      cd (path to where you clone repos, e.g. /c/files/git) 

• Run your .bashrc file, and enter the password to your private key file when prompted

      source ~/.bashrc 

• Create/edit your .gitconfig file using vi or your editor.
  • vi ~/.gitconfig

      [filter "lfs"]
        clean = git-lfs clean %f
        smudge = git-lfs smudge %f
        required = true
      [user]
        name = (your ID on the gerrit server)
        email = *(your email)
      

• If you are behind a corporate or other proxy, set the proxy in the git config

    git config --global http.proxy =(your proxy, e.g. http://proxy.example.com:8080)
    

• If you want to turn off the proxy (e.g. to use git outside your corporate network), edit the .gitconfig file and comment out the proxy line
  • vi ~/.gitconfig

      [http]
      #       proxy = http://proxy.example.com:8080
      

• Create an ssh config file using vi or your editor.
  • vi ~/.ssh/config

      Host opnfv.org
      Hostname opnfv.org
      User (your ID known to the git server)
      IdentityFile (path to your private key, e.g. e.g. /c/files/my-key) 

• Install Python per https://www.mediawiki.org/wiki/Gerrit/git-review
• Clone your repo using the "clone with commit-msg hook" URL provided in the gerrit project settings page, e.g. https://gerrit.opnfv.org/gerrit/#/admin/projects/copper

    git clone https://gerrit.opnfv.org/gerrit/copper && scp -p -P 29418 blsaws@gerrit.opnfv.org:hooks/commit-msg copper/.git/hooks/