Every student will create an individual GitLab project repository, to which they will be submitting all of their task solutions, portfolio reports, etc.
For this, you need to set up Git, join our institute's GitLab instance, and create a repository. This page will guide you through those tasks.
After completing the below steps you should end up with a project similar to this example: https://gitlab.cs.ut.ee/jaks/mciot-example-repo-2021/
1) Install git on your machine.
Git is a collaborative version-management tool designed for software projects. To learn about git, refer here (or your favorite online tutorial / YouTube video / etc of choice).
- Download & install Git on your computer if you don't already have it.
- Download link: https://git-scm.com/
- Once installed, you can verify it works:
- Try running the command
git --version
in a command-line terminal. You should get as result the installed version number, not a "command not found" error.
- Try running the command
2) Sign in to GitLab with your university accuont
Go to https://gitlab.cs.ut.ee/ , you should be able to log in using your UT account. If it doesn't work, contact the lecturers.
3) Set up SSH key for your GitLab account
To interact with GitLab git repositories, your account needs to have a SSH key associated with it. Your computer will use the key to securely communicate with GitLab. This guide will walk you through the process. (If you already have a key-pair, feel free to re-use it)
- As a result, you should have:
- A key pair ( 2 files: private key and public key)
- The public key added on the GitLab webpage.
4) Create a new GitLab project
Give it a name such as "John's LTAT.06.009 Portfolio 2021".
Create a "Blank" project, when asked about which type of project to create. Check "initialize repository with README". Visibility of project should be "Private".
https://gitlab.cs.ut.ee/help/gitlab-basics/create-project.md
5) Clone the project to your computer
If you need help Refer here.
6) Update the Readme and push changes to GitLab
- Inside the repository, create a subfolder called "lecture1task". Create another Readme.MD inside the lecture1task folder.
- Going forward, we will be creating a subfolder for each task or homework.
- Open the .MD file with your favorite text-editor, and write your answer to the 1st lectures task.
- Update the Readme.MD at the root of your project (parent folder of lecture1task), so that it includes a link to the newly created task subfolder.
- In Markdown, you can achieve this with:
[ Link name ](lecturetask1)
.- In this case (lecturetask1) denotes a relative path to the folder name. You can also directly link to files.
- Add, commit, and push the changes to the repository.
Check your project page on https://gitlab.cs.ut.ee/ Your project homepage should now act as a table of contents or welcome page to all of your tasks, based on the readme.md files and links contained in them.
7) Share the project with course instructors
On GitLab Project Webpage, choose "Members" from the left-hand sidebar.
- Add the usernames:
jaks
,ulino
,kelian
. Use "Reporter" or "Developer" role!
8) Submit link to your repo
Finally, please also submit a text file with the link to your repository here . (Also put the link in comment)
1. GitLab Repository linkIf you are completely new to git, it will take some time to learn and get used to the associated concepts. Please allocate time to learn it, e.g. based on this material or something you find yourself online!