Git is a free and open source distributed version control system, and our preferred method of sharing source code. LUG@UCLA hosts members' Git repositories at //linux.ucla.edu/git/. This page provides an overview of the steps necessary to get your project hosted.
If you don't already have an SSH key pair, you can follow these steps to generate one.
Give your public SSH key to a LUG admin so they can add your key to Gitolite. Also, provide the LUG admin with three bits of information:
- a repository name
- a short description of the repository (no more than ~7 words)
- your email address
Using the repository
First, verify your repository has been created by accessing //linux.ucla.edu/git/. If your repository name is "my-project", then your push/pull address will be:
firstname.lastname@example.org:my-project.git . Your repository will also have a public pull-only address at //linux.ucla.edu/git/my-project.git.
Start working with your repository by cloning it, committing some changes, then pushing those changes:
$ git clone email@example.com:my-project.git $ cd my-project $ echo "my super duper project!" >README.txt $ git add README.txt $ git commit -m "added a readme" $ git push origin master
If you already have a pre-existing local repository that you just want to push to your new LUG repository, just add a new remote and push all your branches to it:
$ cd path/to/existing/my-project $ git remote add lug firstname.lastname@example.org:my-project.git $ git push --all lug $ git push --tags lug
Remember, you can pull the repository from anywhere, but you can only push from your personal computer (or wherever you generated your keys).