(r4) GitSetup < Main

Tags: view all tags
---+ Creating a Git Repo

Git repositories allow for many types of workflows, centralized or decentralized. Before creating your repo, decide which steps to follow:<br /><br /> <img width="382" alt="Git_Flowchart.png" src="%ATTACHURLPATH%/Git_Flowchart.png" height="421" />
---++ Create A Local Repository

If you will be working primarily on a local machine, you may simply create a git repo by using =cd= to change to the directory you wish to place under version control, then typing:
<verbatim>git init</verbatim>

To initialize a git repo in that directory. From then on, you can run git commands in that directory.
---++ Create A Remote Repository

If you will be working with your code primarily on patas, you will likely want to create your initial repository there.
   1 =ssh= to patas.ling.washington.edu
   1 <span class="WYSIWYG_TT">cd </span>to the directory you wish to place under version control
   1 type "<span class="WYSIWYG_TT">git init</span>" in this directory.
---+++ Cloning the Remote Repository

If you wish to maintain a local copy of your code, you can clone the repository from patas by doing the following:
   1 create and cd into the directory you want to store the copy of the repository in
   1 <p>type:</p> <verbatim>git clone ssh://<YOUR_USERNAME>@patas.ling.washington.edu/<PATH_TO_FILE> <DESTINATION_DIR></verbatim> <br />for instance, if your username is "clmastudent" and the repo on patas is at ~/mycode, and you are already in the desired directory to store the copy ("."), you would type:<br /><br /> <p> </p> <verbatim>git clone ssh://clmastudent@patas.ling.washington.edu/~mycode .</verbatim>
   1 After entering your ssh password, you should have a copy of the entire repo in whichever directory you chose to clone it to.
---++ Create a Shared Repository on Patas

If you will be working with a group, using Patas as a centrally-located server to coordinate your checkins is a good idea, but takes some setting up.
   1 You will need to send a request to [[mailto:linghelp@uw.edu][linghelp@uw.edu]] requesting that a group be created for the patas account names in your group. This will allow your group members read/write access to your files, without making them readable to everyone. 
      1 You may also wish to request a directory be made for your group in the =/workspace= directory on the server. This space is intended specifically for shared projects.
   1 Once inside the desired directory, you will need to type:<br /> <verbatim>git init --shared=group</verbatim> this will create a git repo in which all group members are able to check in code ("Push" to, in Git terms)
---+++ Dealing with File Permissions

_*NOTE:* Since the December 2012 file server upgrade, using a script to fix permissions after pushes shouldn't be necessary any longer. It won't hurt anything either, though, so if you have an existing repository with a permission-fix script, there's no need to disable it._

Due to a peculiarity in the way file permissions behave between patas and other clients, you will also need to set up a script to run chown and chmod commands when files are checked in, otherwise they might only be readable by the group member that checked them in. To do this:
   1 Inside your git repo (it may be inside a subdirectory titled "<span class="WYSIWYG_TT">.git/</span>"), there is a subdirectory entitled "<span class="WYSIWYG_TT">hooks/</span>"
   1 You will want to create a file inside the hooks directory called "post-receive".
   1 This file will be a script file that will be executed whenever someone successfully pushes to the repository. It may be any type of script, but the following script will make certain the permissions for the files in your repository allow access to all of your group members:<br /> <verbatim>#!/bin/bash

# Make sure all files are set to be owned by the group.
chown -R --from=`whoami` :<GROUP_NAME> <SHARED_DIRECTORY>

# Set all directories to 770 (Read/Write/List for owner and group members, noone else)
find <SHARED_DIRECTORY> -user `whoami` -type d -exec chmod 770 {} \;

# Add read/write permissions for owner and group (preserve executable permission) and remove permissions for others.:
find <SHARED_DIRECTORY> -user `whoami` -type f -exec chmod ug+rw {} \; -exec chmod o-rwx {} \;</verbatim> Where &lt;GROUP_NAME&gt; and &lt;SHARED_DIRECTORY&gt; are replaced with the group name you should have received from linghelp, and the root directory of your repository, respectively.
   1 After this file is created, be sure to perform:<br /> <pre><verbatim>chgrp <GROUP_NAME> hooks/post-receive
chmod g+rx hooks/post-receive</verbatim> </pre> to ensure that the script is executable by each group member when performing the PUSH.
   1 Set the initial group membership by running "chgrp -R &lt;GROUP_NAME&gt;" on the repository directory.