Intro to Git
Week 1 | Lesson 1.2
LEARNING OBJECTIVES
After this lesson, you will be able to:
- Use/explain git commands like init, add, commit, push, pull, and clone
- Distinguish between local and remote repositories
- Create, copy, and delete repositories locally, or on Github
- Clone remote repositories
STUDENT PRE-WORK
Before this lesson, you should already be able to:
- Have completed Code Academy: Learn Git
- Install Homebrew
- Install git (after installing Homebrew, type "brew install git")
- Setup a GitHub account
- Setup SSH key
LESSON GUIDE
TIMING | TYPE | TOPIC |
---|---|---|
20 min | Introduction | Git vs GitHub and version control |
15 min | Demo | Let's use Git |
15 min | Demo | Making and cloning repositories |
10 min | Demo | Create a pull request on GitHub |
25 min | Independent Practice | |
5 min | Conclusion |
Git vs GitHub and version control - Intro (20 mins)
First things first - Git is not Github. This is a common mistake that people make!
What is Git?
Git is:
- A program you run from the command line
- A distributed version control system
Programmers use Git so that they can keep the history of all the changes to their code. This means that they can rollback changes (or switch to older versions) as far back int time as they started using Git on their project.
A codebase in Git is referred to as a repository, or repo, for short.
Git was created by Linus Torvalds, the principal developer of Linux.
What is Github?
Github is:
- A hosting service for Git repositories
- A web interface to explore Git repositories
- A social network of programmers
- We all have individual accounts and put our codebases on our Github account
- You can follow users and star your favorite projects
- Developers can access codebases on other public accounts
- GitHub uses Git
Can you use git without Github?
Think about this quote: “Git is software. GitHub is a company that happens to use Git software.” So yes, you can certainly use Git without GitHub!
Your local repository consists of three "trees" maintained by Git.
- Working Directory: which holds the actual files.
- Index: which acts as a staging area
- HEAD: which points to the last commit you've made.
So many commands?!
There are a lot of commands you can use in git. You can take a look at a list of the available commands by running:
$ git help -a
Even though there are lots of commands, on the course we will really only need about 10.
Let's use Git - Demo (15 mins)
First, create and navigate into a new directory on your Home directory:
$ cd ~
$ mkdir DSI-projects
$ cd DSI-projects
You can place this directory under Git revision control using the command:
$ git init
Git will reply:
Initialized empty Git repository in <location>
You've now initialized the working directory.
The .git folder
If we look at the contents of this empty folder using:
ls -A
Check: What do you see?
We should see that there is now a hidden folder called .git
this is where all of the information about your repository is stored. There is no need for you to make any changes to this folder. You can control all the git flow using git
commands.
Add a file
Let's create a new file:
$ touch a.txt
If we run git status
we should get:
On branch master
Initial commit
Untracked files:
(use "git add <file>..." to include in what will be committed)
a.txt
nothing added to commit but untracked files present (use "git add" to track)
This means that there is a new untracked file. Next, tell Git to take a snapshot of the contents of all files under the current directory (note the .)
$ git add .
After this, git status
returns:
On branch master
Initial commit
Changes to be committed:
(use "git rm --cached <file>..." to unstage)
new file: a.txt
This snapshot is now stored in a temporary staging area which Git calls the "index".
Commit
To permanently store the contents of the index in the repository, (commit these changes to the HEAD), you need to run:
$ git commit -m "Add a.txt"
Commit
is the command; the -m
flag lets you add a "commit message" documenting your change, which you should always do. (If you don't use the -m
flag, git will open a text editor and prompt you for a message.)
You should now get:
[master (root-commit) b4faebd] Add a.txt
1 file changed, 0 insertions(+), 0 deletions(-)
create mode 100644 a.txt
Checking the log
If we want to view the commit history, we can run:
git log
You should see something similar to:
commit ec1b1ebad5927e74d498ee588190686c51cab446
Author: <author>
Date: <date>
Add a.txt
Making and cloning repositories - Demo (10 mins)
Let's do this together:
- Go to your Github account, and click through to the "Repositories" tab on your profile
- In the right hand side, hit the green + button for
New repository
- Name your repository
DSI-projects
- Check "Initialize this repository with a README"
- Click the big green Create Repository button
We now need to connect our local Git repo with our remote repository on GitHub. We have to add a "remote" repository, an address where we can send our local files to be stored. Type the following in to the command line, replacing 'github-name' with your account name:
git remote add origin [email protected]:github-name/DSI-projects.git
You've now initialized a local repo in which to share your projects, and connected it with a remote repo on GitHub which you own.
Check: can you draw a diagram with the repos we're using so far? Add to this diagram the rest of the lesson.
Pushing to Github
In order to send files from our local machine to our remote repository on Github, we use the command git push
. You also need to specify the name of the remote repo -- we called it origin
-- and the name of the branch, in this case master
.
git push origin master
Check: What do you see?
This should fail due to new files on the remote repo. This is a common part of a collaborative project workflow: someone makes changes to the remote while you are working on the local version, so you need to bring your version up to date by fetching and merging the additions. After that you can push your own changes.
Pulling from Github
As we added the README.md in our remote repo, we need to first pull
that file to our local repository to check that we haven't got a 'conflict'.
git pull origin master
git status
git add .
git commit -m "README.md"
Once we have done this, you should see the README file on your computer.
ls
Open it up and type some kind of modification/addition, then stage and commit it again. (This time we're committing the specific file rather than everything in the directory; in this case either works.)
git add README.md
git commit -m "Edit README.md"
Now you can push your changes:
git push origin master
Refresh your GitHub webpage, and the files should be there!
Forking and cloning
Now that everyone has their first repository on GitHub, let's fork and clone a repository.
Forking gives you a copy of an existing repository -- you can make any changes you want without affecting the original. (You can also propose that the maintainer of the original merge your changes!).
Cloning gives you a local copy of a remote repository.
Let's fork and then clone our DSI course repo, which includes all the specifications for your projects.
Fork the repo!
While logged into GitHub, go to
To retrieve the contents of the repo, all you need to do is navigate back to Home and clone
:
cd ~
$ git clone [email protected]:github-name/<your-course>.git
(You can also copy that git@... string from GitHub by clicking the green button saying "Clone or download".)
Git should reply:
Cloning into '<your-course>'...
remote: Counting objects: 3, done.
remote: Total 3 (delta 0), reused 3 (delta 0), pack-reused 0
Receiving objects: 100% (3/3), done.
Checking connectivity... done.
You now have cloned your first repository!
Syncing the repo
We also need a way to keep your new copy of
git remote add upstream [email protected]:ga-students/<your-course>.git
(Look closely: where exactly is the "upstream" repo?)
Now, you can update your local repo each morning with:
git pull upstream master
Create a pull request on GitHub - Demo (5 mins)
Before you can open a pull request, you must create a branch in your local repository, commit to it, and push the branch to a repository or fork on GitHub.
- Visit the repository you pushed to
- Click the "Compare, review, create a pull request" button in the repository
- You'll land right onto the compare page - you can click Edit at the top to pick a new branch to merge in, using the Head Branch dropdown.
- Select the target branch your branch should be merged to, using the Base Branch dropdown
- Review your proposed change
- Click "Click to create a pull request" for this comparison
- Enter a title and description for your pull request
- Click 'Send pull request'
Assess - Independent Practice (10 mins)
- Show a partner how to use to: init, add, commit, push, pull, and clone
Conclusion (5 mins)
Feel comfortable with Git and GitHub? Since we'll be using it a lot of coursework, let's get comfortable!
Bonus Challenges
These challenges are optional!
Once you've mastered the basics, try furthering your understanding of Git by: