This page contains a basic tutorial for working with git. There aren't any advanced concepts here, just the basics. In this tutorial we'll be working with a testing git repo and fake files.
Its always a good thing to remember that while working with Git is a decentralized VCS, even though you may choose to push changes all to one server, you don't have to. Each repo contains a full history and set of objects in the .git directory.
You will also only see a .git directory in the top level unlike svn where you have .svn in each sub directory as well as the top level.
Unlike svn, git uses hashes to identify commits instead of revision numbers.
These are just some basic tasks, the man pages can go into a lot more detail.
Initializing a Git Repo
Create a empty working directory:
mkdir git-tutorial cd git-tutorial
Initialize the local Git Repo:
Committing files to the Repo
Lets create a test file:
echo "Test Data" > testfile
Stage the file to be included into the next commit:
git add testfile
Finally commit the file to the repo:
git commit -m "Add a test file"
Viewing changes to files before committing them
First lets make a change to our test file:
echo "Different Test Data" > testfile
View the changes:
You could also execute the following or something similar:
git diff testfile
Listing files with changes
You can use the following command to list the status of all files not ignored by Git:
You can also use the command on a path, the same as git diff.
Revert a file back to a specified commit
In this case we want to revert to the current working ref, so we wont specify one:
git checkout testfile
Reverting the entire working tree
You can use the following command to revert the entire working tree to the last commit in the branch you're working with:
git reset --hard
Creating a new branch from the current ref
Using git checkout you can start a new branch:
git checkout -b testing
Lets change the test file in this branch so we can identify it in the future:
echo "Testing Branch" > testfile git add testfile git commit -m "Change the test file for the Testing Branch"
Switching between branches
Using git checkout you can switch between branches. Switch back to master and check the testfile:
git checkout master cat testfile
Switch back to testing and check the test file
git checkout testing cat testfile
The following will show you a list of branches:
Creating a tag from the current branch
Before we create a tag lets change the testfile:
echo "Testing Tag testing-1.0" > testfile git add testfile git commit -m "Change the test file before tagging."
Finally create a testing-1.0 tag:
git tag testing-1.0
Its good to know that when you create a Tag, you stay in the current branch. It doesn't switch its current working ref to the tag. Its also good to know that when you checkout a tag, you can't commit changes to the tag. If you want to make changes you should change the branch the tag was created from or create a new branch from the tag using git checkout -b.
The following will show you a list of tags: