Code-Forges like GitLab#
A code forge is a place where teams can work on their projects together. It is usually a combination of a Code repository (Git), a way to view those files in a browser, a bugtracker/issue tracker and a wiki. Most code forges integrate further functionality that makes building and releasing software easier to some extent.
Gitlab#
Gitlab is one such example, and we're hosting our own server that you will be using for this course. You can reach it at https://code.fbi.h-da.de and as a student of Hochschule Darmstadt, you already have an account there.
On this screenshot you see a typical view of a project in your browser. The menu at the left offers some of the functions described earlier. We also see what the project is called, who modified it most recently, what files it contains and at the bottom edge you can see the beginning of its README file.
Cloning a Repository to Your Machine#
Step 1: Get the URL#
Once you have access to a project, it is pretty common to clone the repository to your own machine. For this you need the URL of the repository for your local Git software. In our setup, you would normally use the Code-Button and choose the HTTPS-URL. Just copy it to your clipboard.
If you know SSH, you can use that, of course!
We're not going into the difference between SSH and HTTPS in this course. If you already have a keypair and know how to use it with git, please feel free to use that instead.
Step 2: Put the URL into your git client#
Your git software will have some button to clone a new project to your computer. This will bring up a window that lets you enter a URL (in github desktop, this is the third "tab"). Paste the URL you just copied and choose where you want this repository to live on your computer.
Then, hit Clone.
In case of a password-prompt#
After completing these steps, you may be asked for a username and password. You should be able to use the short form of your student ID (st______) and your regular single-sign-on password.
Your project should now successfully clone to your computer in the location you chose earlier. Every subsequent action in that repository should just work. Worst case, it might ask you for a password again.
Start working#
These are now regular standard files on your hard drive. Git / Github Desktop / Gitlab or any of the other tools don't care about how you get your work done. They just provide and synchronize and back up those files. Take a look at the new files in your Windows Explorer or MacOS Finder. Open the files in any application you want, Processing, text editors, your favorite IDE - that's all up to you!
Assignment: Clone the Repository and go through configuration once
Please clone the "first steps together" repository to your machine. This repository contains a README.md file with further instructions.
If you have questions, don't hesitate to ask. This is an uncommon operation for most of you and we will need this later.