You now have been assigned an issue to work on and yuu have created a fork of the upstream GitKit FarmData2 repository into your GitHub space.
To work on your issue you will need to setup your development environment. Your development environment is where you will create your clone of the repository, where you will edit files, and where you will use `git` commands to add your changes to to your clone and push those changes to your origin.
Many FOSS contributors will setup the development environment on their personal machines. Because student machines vary greatly the GitKit provides a browser based development environment, called a KitClient. This development environment runs in the cloud and you will access it using your web browser. This development environment includes standard development tools but also has a few features designed specifically to help you stay on track when completing the GitKit’s hands-on exercises.
Subsection2.7.1Starting the Development Environment
In this section you will learn how to start, configure, stop, and restart your development environment.
Exercises
1.
Your development environment will run in the cloud using a service called GitPod. Visit gitpod.io/login and login using the “Continue with GitHub” button and providing your GitHub username and password.
2.
The following tasks will guide you through the process of starting and configuring your development environment.
Choose "Terminal" as the "Editor - Browser" and "Standard" as the machine "Class" as shown here:
(c)
Click the "Continue" button and wait for a few minutes until output that is similar to that shown here to appear:
*********************************************************************************
*********************************************************************************
Connect to the KitClient with your browser at:
https://6901-hfossedu-kitclientlinux-kkguybiovbj.ws-us115.gitpod.io
*********************************************************************************
*********************************************************************************
(d)
Click the link in your output that is similar to the one that is shown above.
(e)
Click the "Connect" button that appears in your browser.
After clicking the "Connect" button your development environment should open in the browser. It will appear similar to the window shown in Figure 2.7.1.
Figure2.7.1.The development environment.
3.
There are a few additional things that you can to to make working in your development environment more convenient.
(a)
Use the following steps to make the development environment fill and resize with your browser window.
Open the "noVNC Menu" by clicking the little tab at the left edge of the development environment window. Figure 2.7.1 shows the "noVNC Menu" opened.
Click "Gear Icon" to open the "noVNC Settings". Figure 2.7.1 shows the "noVNC Settings" open.
Set the "Scaling Mode" to "Remote Resizing".
(b)
To simplify pasting answers into this text, it is recommended that you open the text using the Firefox browser within the local development environment.
Copy and paste within the development environment can be done via an application’s "Edit" menu, the "right click" menu, or keyboard shortcuts. This tutorial on Copy and Paste on Linux 2
www.xda-developers.com/how-copy-paste-linux/
may be helpful if you are not a Linux user.
Copy and paste between your host machine and the development environment can be done, but it requires that you paste the content into the "Clipboard" on the "noVNC Menu".
Subsection2.7.2Configuring the Git Client
Your development environment includes a Git client. The Git client is the tool that you will use to interact with Git repositories, such as the GitKit FarmData2 repository.
There are lots of different Git clients. Some are graphical and some use a text interface. These exercises, introduce you to Git using its text-based command line interface (CLI). This is the most general way to interact with Git and will provide a conceptual foundation for using any other Git client that you might encounter.
Exercises
1.
You will interact with Git using its command line interface via a Terminal. Use the following steps to open a Terminal.
(a)
Click the "Terminal" icon at the bottom of the development environment window to open a new Terminal.
(b)
Enter your name at the prompt and press enter. This will customize the Terminal prompt for you.
2.
git
(a)
Enter the command git into the Terminal.
(b)
Give a git command that will cause ,git to display its version.
Hint.
Use the output from Task 2.7.2.2.a to determine what flag to pass to git.
(c)
What version of the git command line client is installed in your development environment?
Hint.
Use the command that you identified in Task 2.7.2.2.b to determine the git version.
3.
Recall from class that Git repositories maintain a complete history of all changes, including who made each change. To do this, Git needs to know a little bit of information about you.
Git identifies the author of each change using two pieces of information: A name and an e-mail. For name, you might decide to your full name, or a nickname, or your GitHub username. Just keep in mind that whatever name you use will be associated with all of the changes you make. For e-mail, you can again use any valid e-mail associated with you.
The tasks in this exercise will guide you through the process of configuring the Git client in your development environment.
(a)
Use the following command to set the name that Git will associate with your changes:
git config --global user.name "<name>"
Replace "<name>" with the name you wish to use and be sure not to include the < and >.
(b)
Use the following command to set the e-mail that Git will associate with your changes:
git config --global user.email "<e-mail>"
Replace "<e-mail>" with the name you wish to use and be sure not to include the < and >.
(c)
Use the following command to display Git’s global configuration including the two new settings you just added:
git config --global --list
Give the output of this command as your answer for this task.
Subsection2.7.3Adjusting some GitPod Settings
There are a few GitPod settings that you can change that will make working with your development environment more convenient.
Exercises
1.
Use the following steps to adjust your GitPod settings.
Choose "Rename" from the "⋮" (three vertical dots) menu to the right of the KitClient workspace and rename the workspace to be "GitKit Dev Env" or something else that you will remember easily.
(c)
Click the "Pushpin" icon, or choose "Pin" from the "⋮" (three vertical dots) menu to the right of the "GitKit Dev Env" workspace.
This will Pin your GitKit workspace making it easier to find, and will also prevent it from becoming inactive or being deleted if you don’t use it for a few days.
Set your “Timeout” to 10 minutes. This will stop your development environment if you are away from it for more than 5 minutes. This will help to ensure that your free GitPod credits are not accidentally used up if you forget to stop your development environment.
If your development environment times out and stops you can restart it using the steps in Subsection 2.7.5.
Subsection2.7.4Stopping your Development Environment
At some point you will complete this assignment or want to take a break and do other things. When you do so, you should stop your development environment.
Exercises
1.
You can stop your development environment using the following steps.
