CSCF Git Repository

This page is to document CSCF use of the https://git.uwaterloo.ca/cscf/ group of the git.uwaterloo.ca server, which has an easy-to-use Gitlab web front-end with associated back-end hooks. This is Daniel Allen's recommended location to put CSCF code which might be shared with the rest of campus. CSCF Infrastructure group runs a repository at https://git.cs.uwaterloo.ca/ with a "Cgit" front-end; that is a different service.

Special Features

We've put up a GitlabSTWebHook - available to projects if they set it up - so that check-in messages containing 'ST# nnnnnn' will automatically email the check-in to the associated ST item. (see previous wiki link for details).

Access

Access is available to anyone with a watiam ID; upon initial login using watiam password, their git.uwaterloo.ca account is activated and they may be added to existing projects. The administrator for the server (as of July 2015) is Giles Malet, gdmalet.

Access to CSCF Group

https://git.uwaterloo.ca/cscf/ is a shortcut location for the CSCF group, a suitable location for CSCF-wide code. Write access to add repositories under the group may be granted by anyone with 'owner' rights in the group, which include drallen and fhgunn as well as part-time staff. Owner rights will be added for any additional CSCF staff requesting them.

• AT THE END OF TERM be sure to remove co-op access from systems. For example, if they have pushed code to gitlab using any production role accounts, have them log in as themselves, and remove any ssh keys which correspond to the application accounts, because the key fingerprint cannot be re-used for another user. (https://git.uwaterloo.ca/profile/keys )

Introduction to Git and Further Reading

• A good starting point to GIt is https://www.atlassian.com/git/tutorials/setting-up-a-repository
• A highly ranked open-source Git book is available here: https://git-scm.com/book/ (currently the 2014 second edition). The CSCF library has the hard copy of the 2009 first edition, "Pro Git", by Scott Chacon.
• Git Best Practices: http://sethrobertson.github.io/GitBestPractices/
  • Excellent advice on git commit messages: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
• A video course via Lynda.com: http://www.lynda.com/Git-tutorials/Git-Essential-Training/100222-2.html
• An eBook in the CSCF library with best practice for teams https://cs.uwaterloo.ca/cscf/internal/edocs/eBooks/Git_for_Teams.pdf

See Also

-- DanielAllen - 2015-07-29