Version Control

Шаг 1: GitLab & SSH Keys

На этом этапе вы создадите свой аккаунт на GitLab сервера и нужные SSH ключи. С помощью данных ключей вас сможет опознать система во время коммуникации с сервером git со своей домашней рабочей среды разработки.

Генерация ключей осуществляется с помощью ssh-keygen. После запуска не задавайте дополнительные параметры! (нажимайте только Enter.) Более конкретно, утилита будет предлагать вам сохранить ключи в нестандартной локации и возможность добавить секретную фразу. Вывод программы может быть в таком виде, при этом те данные, которые вводил пользователь, выделены жирным шрифтом, а рядок, начинающийся $, представляет командную строку:

$ ssh-keygen
Generating public/private rsa key pair.
Enter file in which to save the key (/home/john/.ssh/id_rsa):
Created directory '/home/john/.ssh'.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/john/.ssh/id_rsa.
Your public key has been saved in /home/john/.ssh/id_rsa.pub.
The key fingerprint is:
eb:80:f3:1f:36:02:38:7c:7a:9d:64:e8:8c:6b:5a:eb john@machine
The key's randomart image is:
+---[RSA 2048]----+
|oo++ o=  .       |
|o++ oo=+o        |
|+oo..oo*..       |
|.  + .oo=.E      |
|  . . .oS+o.     |
|   . ... =o      |
|  . oo. . o      |
| o . .o+  ..     |
|..o.. ..o...     |
+----[SHA256]-----+

По умолчанию сгенерированные ключи будут сохранены в директорию .ssh/ вашего домашнего каталога (т.е. ~/.ssh/). Создадутся два файла:

• id_rsa.pub публичный ключ
• id_rsa приватный ключ

Для этого сначала выведите его на экран:

cat ~/.ssh/id_rsa.pub

Скопируйте содержимое файла с публичным ключом в буфер обмена (shortcut: Ctrl+Shift+C). Список ваших ключей находится на странице Edit Profile (вверху слева) > SSH Keys или же (если вы авторизованы на сайте) перейдите сразу по ссылке git.kpi.fei.tuke.sk/-/user_settings/ssh_keys.

Шаг 2: New Project

1. Перейдите по ссылке на GitLab чтобы авторизовать приложение ZAP GitLab Classroom, созданное для вас Менеджером.
2. Авторизовав приложение, вы будете перенаправлены на страницу создания проекта ZAP 2024, где вам будет нужно выбрать учебную группу, которую вы посещаете, в соответствии с вашим расписанием. Группы перечислены в виде <group> - <day> <time>.
3. Нажав на кнопку для создания проекта покажет вам ссылку на ваш новосозданный проект. Вы можете найти свой проект среди ваших проектов в GitLab.

Последовательность команд, нужная для выполнения задачи, находится прямо на странице, на которую вы перейдёте после создания проекта. Скопируйте данные команды и запустите в терминале.

Процесс коммуникации с сервером может быть примерно в таком виде (ввод пользователя выделен жирным шрифтом, а $ представляет командную строку):

$ git config --global user.name "Your Name" (CHANGE YOUR NAME)
$ git config --global user.email "your.email@student.tuke.sk" (CHANGE YOUR EMAIL)
$ git clone git@git.kpi.fei.tuke.sk:zap-problemsets/2024/x0-day-time/zap-2024-id.git (CHANGE YOUR ID NUMBER)
Cloning into 'zap-2024-id'...
warning: You appear to have cloned an empty repository.
Checking connectivity... done.
$ cd zap-2024-id (CHANGE YOUR ID NUMBER)
$ git switch -c main
$ touch README
$ git add README
$ git commit -m "add README"
[main (root-commit) 2859d11] add README
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 README
$ git push -u origin main
 __  ___ .______    __
|  |/  / |   _  \  |  | Katedra pocitacov a informatiky
|  '  /  |  |_)  | |  | Fakulta elektrotechniky a informatiky
|    <   |   ___/  |  | Technicka Univerzita v Kosiciach
|  .  \  |  |      |  |
|__|\__\ | _|      |__| Internal git repository

UNAUTHORIZED ACCESS TO THIS NETWORK DEVICE IS PROHIBITED.
You must have explicit permission to access or configure this
device. All activities performed on this device are logged and
violations of this policy will be prosecuted under all applicable
statutes plus all applicable civil rules for damages.
Counting objects: 3, done.
Writing objects: 100% (3/3), 230 bytes | 230.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0)
To git.kpi.fei.tuke.sk:zap-problemsets/2024/x0-day-time/zap-2024-id.git
 * [new branch]      main -> main
Branch 'main' set up to track remote branch 'main' from 'origin'.

Если вы делали все верно, после загрузки страницы проекта на GitLab-e и перехода во вкладку Files вы должны увидеть файлы (в нашем случае, пока только файл README), находящиеся в проекте.

git clone git@git.kpi.fei.tuke.sk:zap-problemsets/2024/x0-day-time/zap-2024-id.git

в котором git@git.kpi.fei.tuke.sk:zap-problemsets/2024/x0-day-time/zap-2024-id.git представляет собой адрес проекта на сервере GitLab.

git pull

git commit -am "сообщение"

git push

Шаг 3: Ориентированный забег

На этом этапе вы будете заниматься решением первой задачи в рамках задания PS1, которое вам предстоит сдать. Прочитать задание полностью.

mkdir ps1
cd ps1

touch task_1.c

Шаг 4: Project Testing

Если сделайте в проекте изменение, его можно отследить с помощью:

git status

После завершения написания кода task_1.c вывод данной команды может выглядеть следующим образом, при этом ввод пользователя выделен жирным шрифтом, а $ представляет командную строку:

$ git status
On branch main
Your branch is up-to-date with 'origin/main'.

Untracked files:
  (use "git add ..." to include in what will be committed)

  ps1/task_1.c

nothing added to commit but untracked files present (use "git add" to track)

Если вы хотите добавить файл task_1.c в проект, воспользуйтесь командой:

git add ps1/task_1.c

Согласно требованиям задания PS1, вас нужно изменить файл README следующим образом:

GROUP : C1

Согласно требованиям задания PS1, также нужно создать файлы ps1/task_2.c ... ps1/task_7.c. Для создания пустых файлов используйте:

touch ps1/task_2.c

Ak si overíte Vaše zmeny, вывод команды может быть в следующем виде, при этом ввод пользователя выделен жирным шрифтом, а $ представляет командную строку:

$ git status
On branch main
Your branch is up to date with 'origin/main'.

Changes to be committed:
  (use "git reset HEAD ..." to unstage)

	new file:   ps1/task_1.c

Changes not staged for commit:
  (use "git add ..." to update what will be committed)
  (use "git checkout -- ..." to discard changes in working directory)

	modified:   README

Untracked files:
  (use "git add ..." to include in what will be committed)

	ps1/task_2.c
	ps1/task_3.c
	ps1/task_4.c
	ps1/task_5.c
	ps1/task_6.c
	ps1/task_7.c

Загрузка не сервер проходит в 2 фазах:

• Сперва командой git commit -am "message" сохраните изменения в локальном репозитории. После, процесс commit' a представляется параметром -am "message", при чём все изменения будут закреплены за сообщением message.
• После командой git push отправьте все локальные коммит(-ы) на удалённый сервер.

git log

Примером упомянутой коммуникации с сервером с помощью команд git commit и git push может служить следующий вывод:

$ git add ps1/task_2.c ps1/task_3.c ps1/task_4.c ps1/task_5.c ps1/task_6.c ps1/task_7.c
$ git commit -am "inicializacia projektu"
[main 4d97a92] inicializacia projektu
 4 files changed, 2 insertions(+)
 create mode 100644 ps1/README
 create mode 100644 ps1/task_1.c
 create mode 100644 ps1/task_2.c
$ git push
 __  ___ .______    __
|  |/  / |   _  \  |  |   Katedra pocitacov a informatiky
|  '  /  |  |_)  | |  |   Fakulta elektrotechniky a informatiky
|    <   |   ___/  |  |   Technicka Univerzita v Kosiciach
|  .  \  |  |      |  |
|__|\__\ | _|      |__|   Internal git repository

UNAUTHORIZED ACCESS TO THIS NETWORK DEVICE IS PROHIBITED.
You must have explicit permission to access or configure this
device. All activities performed on this device are logged and
violations of this policy will be prosecuted under all applicable
statutes plus all applicable civil rules for damages.

Counting objects: 5, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (5/5), 414 bytes | 414.00 KiB/s, done.
Total 5 (delta 0), reused 0 (delta 0)
To git.kpi.fei.tuke.sk:zap-problemsets/2024/x0-den-cas/zap-2024-id.git
   2859d11..4d97a92  main -> main

После отправки локальных изменений на удалённый сервер, проверьте их на GitLab.

• Команду git commit можно использовать много раз. Изменения сохраняются только в локальный репозиторий, именно поэтому это считается удобной опцией при работе, например, без подключения к Интернету.
• Обязательным параметром к каждому коммиту является сообщение, отображающееся после при соответствующем коммите на GitLab, или же в выводе команды git log.
• После запуска тестов, на ваш университетский электронный адрес придёт письмо со ссылкой, по которой вы можете перейти на страницу с результами тестирования. Результаты всех последующих тестов будут находится на этой же странице.