Professional Git

Connected Lab 11

Working with Submodules

In this lab, you’ll get some experience working with submodules.

PREREQUISITES

This lab requires that you have Internet access and have completed at least the first two steps in Connected Lab 10, where you forked the various split projects of the original calc2 project into your area in GitHub and cloned the super_calc project down to your local system.

STEPS

1. Start out in the super_calc directory for the super_calc repository that you cloned from your GitHub fork in Connected Lab 10. You’re going to add another repository as a submodule to super_calc.
2. Add the sub_ui repository as a submodule to the super_calc project by running this command:

   $ git submodule add https://github.com/<your github userid>/sub_ui sub_ui

3. This adds sub_ui as a submodule to your super_calc repository. In the process, Git clones down the repository into the subdirectory and also creates and stages a .gitmodules file to map the connection with the super_calc project. Look at the directory listing to see the new subdirectory. Then look at the status to see the staged .gitmodules file. Finally, display the contents of the .gitmodules file to see what’s in there. Run the following commands from the super_calc subdirectory:

   $ ls
   $ git status
   $ git show :.gitmodules

4. Now you need to commit and push the staged submodule mapping and data to your local and remote repositories. Run the following commands:

   $ git commit -m "Add submodule sub_ui"
   $ git push

5. Now you can clone ...