Part 1: Installing Git Client

Git is a command-line client program that runs on your computer and communicates to the Git server.

Part 2: Setting up Virtual Private Network (VPN)

Part 3: Setting up Account on Git Server

Part 4: Option I: Full Git Tutorial

For the instructions steps that are labeled as “Exercise: PG: Section_Name”, you need to perform the details in the ProGit ("PG") book section named "Section_Name" and save your work to local files.

1. Exercise:  This tutorial and all later projects in the course, assume you have created a 'course' directory that will contain further sub-directories, one subdirectory per tutorial or project.   You should create the course directory now.   Name the course directory using your course number, such as "ITCS_".   In this and later assignments the bash code examples will use the name ITCS_ in order keep the instruction text generic. If your course number differs, you should substitute the appropriate course number after the ITCS_.
   

   ▽	ada@turing42~/ mkdir ITCS_ ada@turing42~/ cd ITCS_ ada@turing42~/ITCS_

2. Exercise:  Create a sub-directory for this tutorial called 'git-tutorial' and cd into that directory.  Do all the exercises in the ProGit book inside that directory.
   

   ▽	ada@turing42~/ITCS_ mkdir git-tutorial ada@turing42~/ITCS_ cd git-tutorial ada@turing42~/ITCS_/git-tutorial

3. ProGit - Chapter 1:
   1. Read ProGit sections 1.1 – 1.4
   2. Skip ProGit 1.5 (this was covered in this tutorial’s Installing_Git).
   3. Read ProGit 1.6.  Also for the chapter subsections named below, perform the steps described in that name subsection using git.
      
      1. Exercise:  PG:“Your Identity ” - perform all described steps
      2. Exercise:  PG:“ Your Editor ” - perform all described steps
         Note: use whatever simple editor you prefer (notepad.exe perhaps)
      3. Exercise:  PG:“Checking Your Settings ” - perform all described steps
4. ProGit - Chapter 2:
   1. Read ProGit 2.1:
      1. Exercise:  Sub-section "Initializing a Repository in an Existing Directory" assumes you have created a set of files in a directory called 'my-project'.   To create and get these files, in your browser click the following link to download these files:   my-project.tar.gz .   After downloading, copy the file to your git-tutorial directory.  Then uncompress the tar.gz file as follows:
         

         ▽	ada@turing42 ~/ITCS_/git-tutorial tar -xf my-project.tar.gz ada@turing42 ~/ITCS_/git-tutorial ls -R .: my-project my-project.tar.gz ./my-project: main.c LICENSE ada@turing42 ~/ITCS_/git-tutorial cd my-project

         
         
      2. Exercise: PG: Initializing a Repository in an Existing Directory
         
         Perform the instructions in the above section of the book, inside the my-project directory you just created.
         
         
      3. Exercise:  Push the pre-existing local repo to a remote repo.
         1. Create a remote repository on the git server called my-project.  
            Follow the instructions in Appendix II "How to Create New Remote Repository" 
         2. To connect your local repo to the remote repo do as shown below, where URL of my-project is the full URL of the remote repo.
            

            ▽

            ada@turing42 ~/ITCS_/git-tutorial/my-project git remote add origin URL of my-project ada@turing42 ~/ITCS_/git-tutorial/my-project git push origin main t [ the credential manager that you install will now prompt you for your user id and PAT] Enumerating objects: 3, done. Counting objects: 100% (3/3), done. Writing objects: 100% (3/3), 211 bytes | 211.00 KiB/s, done. Total 3 (delta 0), reused 0 (delta 0), pack-reused 0 To https://cci-git.charlotte.edu/zwartell/my-project.git  * [new branch]      main -> main

      4. Exercise: PG: “Cloning an Existing Repository ”
         Return to your git-tutorial directory:
         
         Perform the book’s exercises.  This will create various clones of a remote repo mentioned in the book in your git-tutorial directory.
   2. Read ProGit 2.2:
      1. Download the required practice files, 'ProGit_Chapter_2_2.tar.gz'. 
         In your browser click the following link:   ProGit_Chapter_2_2.tar.gz.   After downloading, copy the file to your git-tutorial directory.  Then uncompress the tar.gz file as follows:
         

         ▽	ada@turing42 ~/ITCS_/git-tutorial tar -xf ProGit_Chapter_2_2.tar.gz ada@turing42 ~/ITCS_/git-tutorial cd ProGit_Chapter_2_2

         
         Perform the exercises below in the above directory.
         
      2. Exercise: PG: “Checking the Status of Your Files ” - perform all steps
         
         Note: Use whatever text file editor you are familiar with instead of vim for the “$vim README“ and similar examples in this ProGit chapter.
         
         
      3. Exercise: PG: Tracking New Files   - perform all steps
      4. Exercise:  Push the pre-existing local repo to a remote repo:
         1. Create a remote repository on the git server called progit-chapter-2-2.   Follow the instructions in Appendix II "How to Create New Remote Repository" 
         2. To connect your local repo to the remote repo do as shown below, where is the full URL of the remote repo.
            

            ▽	ada@turing42 ~/ITCS_/git-tutorial/ProGit_Chapter_2_2 git remote add origin URL of my-project ada@turing42 ~/ITCS_/git-tutorial/ProGit_Chapter_2_2 git push origin main [ the credential manager that you install will now prompt you for your username and PAT]

      5. Exercise: PG: Staging Modified Files - perform all steps
         
         Note:  When the book discusses making changes to various files, just make any small change to each file.
         
      6. Exercise: PG: Short Status - perform all steps
      7. Exercise: PG: Ignoring Files - perform all steps
      8. Exercise: PG: Viewing Your Staged and Unstaged Changes   - perform all steps
         
         Note:   When the book discusses making changes to various files, just make any small change to each file.
         
      9. Exercise: PG: Committing Your Change - perform all steps
      10. Exercise: PG: Skipping the Staging Area - perform all steps
      11. Exercise: PG: Removing Files - perform all steps
      12. Exercise: PG: Moving Files - perform all steps
      13. Exercise:  Push the updates to remote remote repo:

          ▽	ada@turing42 ~/ITCS_/git-tutorial/ProGit_Chapter_2_2 git push origin main

   3. Read ProGit 2.3
      1. Exercise: PG: Viewing the Commit History
         
         Do the first two exercises, cloning simplegit-progit into:
         
         git-tutorial\simplegit-progit
         Stop at the chapter's instruction “$ git log -p -2“.
      2. Exercise: Forking simplegit-progit
         Forking is a more advanced concept used to contribute to a project developed by someone else. Forking is used when the original developer has made the project available on a remote repo from which you may git clone, but to which you do not have permission to push. In many fork workflows, your forked copy would reside on the same git server hosting the developer's remote repo. However, in this exercise you will use an alternate fork workflow where your forked copy resides on the git server used in this course while the developer's repo resides on GitHub. To fork simplegit-progit do as follows:
         1. Create a remote repository on this course's git server called simplegit-progit. Follow the instructions in Appendix II "How to Create New Remote Repository" 
         2. Next do as follows:

            ▽

            ada@turing42 ~/ITCS_/git-tutorial/simplegit-progit git remote rename origin upstream [This renames the source repo to 'upstream', a common convention] ada@turing42 ~/ITCS_/git-tutorial/simplegit-progit git remote add origin URL of your repo created above [This associates the origin ref with your remote repo] ada@turing42 ~/ITCS_/git-tutorial/simplegit-progit git push origin --all [This pushes all tags to your remote repo]

5. Exercise: Verify all your remote repositories on the course's git server following the instructions in Section Verify Your Remote Repository .

This completes the Full Git Tutorial.

Part 4: Option II: Micro Git Tutorial

The micro tutorial is a quick verification that you have full read/write access to your remote repository on the course's Git server. 

1. Exercise:  This tutorial and all later projects in the course, assume you have created a 'course' directory that will contain further sub-directories, one subdirectory per tutorial or project.   You should create the course directory now.   Name the course directory using your course number, such as "ITCS_".   In this and later assignments the bash code examples will use the name ITCS_ in order keep the instruction text generic. If your course number differs, you should substitute your course number after the ITCS_.
   

   ▽	ada@turing42~/ mkdir ITCS_ ada@turing42~/ cd ITCS_ ada@turing42~/ITCS_

2. Exercise:  Create a sub-directory for this tutorial called 'git-micro-tutorial' and cd into that directory.  Do all the exercises in the ProGit book inside that directory.
   

   ▽	ada@turing42~/ITCS_ mkdir git-micro-tutorial ada@turing42~/ITCS_ cd git-micro-tutorial ada@turing42~/ITCS_/git-micro-tutorial

3. Exercise:  Shell / Git Setup
   The first time git is used in bash (or in another equivalent shell), you need to perform some git configuration steps.   If you installed bash for the first time on your computer, or if you are using git for the first time within another shell that you chose, then you need to perform the following:
   
   1. Read ProGit 1.6.  This chapter subsection and do the subsection's described exercises in the shell:
      
      1. Exercise:  PG:“Your Identity ” - perform all steps
      2. Exercise:  PG:“ Your Editor ” - perform all steps
         Note: use whatever simple editor you prefer (notepad.exe perhaps)
      3. Exercise:  PG:“Checking Your Settings ” - perform all steps
   
   
4. Exercise:  Create and Setup Git Server Access.
   Create and setup your account on the Git server used in your class and setup the recommended git client access method as described in the Appendix I Git_Server_Access,   Then use the shell you opened when following that section’s instructions to perform the next steps.
5. Create a new remote repo:
   1. [YourServer=cci-git]
      Create new remote repo on cci-git called, git-micro-tutorial. using the procedures of Appendix I-3 Git_Server_Access.
       
      Do not forget to to share your repo with the TA and Professor (as discussed in the Appendix section Basic Git Operations).
6. Create local repo and link to the new remote repo:
   
   In the instructions below, for input URL of remote repo use the URL as listed on the server (see Appendix section Basic Git Operations). for details).
   1. [YourServer=cci-git]     
      
      

   ▽	ada@turing42~/ITCS_/git-micro-tutorial  git init Initialized empty Git repository in git-micro-tutorial/.git/ ada@turing42~/ITCS_/git-micro-tutorial  git remote add origin URL of remote repo

7. Create a new file:
   

   ▽	ada@turing42~/ITCS_/git-micro-tutorial  echo Hello > Test.txt

8. Add, commit and push to the Git server remote repo.

   ▽	ada@turing42~/ITCS_/git-micro-tutorial  git add . [..misc output...] ada@turing42~/ITCS_/git-micro-tutorial  git commit -a -m "-submitted git-micro-tutorial assignment" [..misc output...] ada@turing42~/ITCS_/git-micro-tutorial  git push -u origin main [..misc output...]

9. Verify your Git server’s remote repository.  (See Section 9.3 Verify Your Remote Repository ).

This completes the Micro Git Tutorial.