Содержание:

• Установка основных компонентов для начала работы
• Установка и настройка Git Extinsions
  • После установки Git Extinsions настроем свой профиль GitLab:
  • Создаем ключ SSH для пользователя GitLab
  • Загружаем ключ SSH в GitExtentions
  • Настройки клиента GitExtentions
  • При правильной настройке можно приступать к первому клонированию:
• При успешном прохождении всех шагов можно приступить к сборке Shop

---

Установка основных компонентов для начала работы

В этом списке указаны основные компоненты для работы, которые следует установить при начале работы

• Everything - Мгновенный поиск файлов и папок по их именам. Скачиваем с официального сайта
• Git - Гит это распределённая система управления версиями. Скачиваем с официального сайта
• Git Extensions — это автономный инструмент пользовательского интерфейса для управления репозиториями Git. Скачиваем с официального сайта
• Notepad++ - Свободный текстовый редактор с открытым исходным кодом. Скачиваем с официального сайта
• Araxis - Приложение для задач визуального сравнения файлов, объединения и синхронизации папок. Скачиваем с RuTracker.net
• CnWizards - это бесплатный набор подключаемых модулей для Delphi/CodeGear RAD Studio для повышения эффективности разработки. Скачиваем с сайта
• Embarcadero Delphi 11 Alexandria - IDE для разработки. RuTracker.net

Проект использует TeeChart. При установке Delphi добавьте в устанавливаемые компоненты TeeChart.

Все перечисленные компоненты устанавливаются без каких-либо специфичных настроек, однако стоит обратить внимание на Git Extinsions.

Установка и настройка Git Extinsions

В этом разделе указаны советы и некоторые установки, которые помогут Вашей комфортной и стабильной работе в GitLab

При установке Git Extinsions все предустановленные настройки Git, однако стоит обратить внимание на следующие параметры:

• Выбираем текстовый редактор для Git по умолчанию

• И выбираем для Git способ хранения окончания строк в текстовых файлах. Для Windows выбираем "Checkout as-is, commit as-is"

Для полного представления что такое GitLab, знакомства с его интерфейсом и возможностями можно ознакомится с документацией GitLab

После установки Git Extinsions настроем свой профиль GitLab:

При создании пользователя, пользователь задаёт свой логин и пароль. Эти данные назначаются всему что связанно с доменом. В частном случае GitLab

Если для Вас создавался пользователь непосредственно в GitLab, то Вам на почту придет письмо с формой создания пароля к учётной записи. Этот пароль следует использовать для работы с Git Extensions см. ниже.

После успешного логина следует провести некоторые настройки. На главной панели (сверху) нажимаем на иконку пользователя, где выбираем "Edit Profile":

• Указываем свои личные данные
• Выбираем соответствующий часовой пояс
• Добавляем Публичный ключ SSH для пользователя, выбрав соответствующий раздел в колонке слева
• При необходимости меняем другие настройки
• Сохраняем изменения, нажав внизу "Update profile settings"

Создаем ключ SSH для пользователя GitLab

1. Открываем окно cmd (нажмите сочетание клавиш "Win" + R, в открывшемся окне "Выполнить" введите cmd и нажмите клавишу Enter)

   В случае, если cmd не распознает следующие команды, рекомендую запустить окно GIT - например в GitExtention Ctrl + G , и выполнить эти действия там

2. Вводим в строку ssh-keygen
3. Выбираем директорию для ключей (Советую оставить как есть)
4. Вводим пароль пользователя 2 раза
5. В месте куда положили ключ (Если не меняли директорию, то это C:\Users\USERNAME\.ssh) открываем в редакторе файл id_rsa.pub и копируем всё содержимое
6. Открываем страницу GitLab (В нашем случае это https://git-data.ru/) и логинимся от пользователя, для которого создали SSH ключ
7. В настройках пользователя (В правом верхнем углу выпадающий список на иконке пользователя, "Edit profile") где находим "SSH keys"
8. В поле для ключа вставляем содержимое id_rsa.pub и добавляем его "Add key"

Загружаем ключ SSH в GitExtentions

1. На главной панели GitExtentions нажимаем на раздел "Инструменты"
2. Выбираем "Putty"
3. В выпадающем списке выбираем "Генерировать или импортировать ключ"
4. В появившемся окне выбираем "Conversions", где нажимаем на "Import key"
5. В директории загруженных ключей выбираем приватный ключ и загружаем его
6. Нажимаем "Save private key", задаём файлу *.ppk имя

Настройки клиента GitExtentions

Главные настройки клиента GitExtentions отображены на изображении ниже.

Если какое-либо поле выделено красным, то GitExtensions работать не будет. Нажав на поле откроется его настройка. Ниже представлены решения для каждого поля:

1. Увеличьте окно в ширину. Для "Команда для вызова Git" нажмите кнопку "Обзор", и определите директорию файла git.exe. Если Git устанавливали по умолчанию, то путь C:\Program Files\Git\bin\git.exe . Для Инструментов sh путь C:\Program Files\Git\usr\bin\ .
2. В этом разделе можно настроить сразу несколько разделов настройки
   • Для поля Имя - имя пользователя GitLab
   • Для поля Электронная почта - почта пользователя GitLab
   • Для поля Редактор - Удобный для пользователя текстовый редактор (рекомендую Notepad++)
   • Для поля Инструмент слияния - средство для виртуального сравнения (в нашем случае это Araxis)
   • Для поля Путь к инструменту слияния - указываем путь к исполнительному файлу (в нашем случае это C:/Program Files/Araxis/Araxis Merge/Compare.exe)
   • Поле Команда инструмента - заполняется автоматически при указании путей
   • Для поля Инструмент сравнения - аналогично как и с Инструментом слияния
   • В Поле Конец строки - выбираем "Переключиться как есть, фиксировать как есть"
3. Выбираем OpenSSH

При правильной настройке можно приступать к первому клонированию:

1. В главном меню выбираем Начало -> Клонировать репозиторий
2. В поле Внешний репозиторий вставляем ссылку Clone with SSH (Её можно взять с титульной страницы репозитория, нажав на кнопку Clone) git@git-data.ru:Stash/Work.git
3. Назначение - Путь к будущей коренной папке репозитория D:\View
4. Подкаталог создания - имя будущей коренной папки репозитория Work
5. Ветка - ветка репозитория которую следует клонировать Develop
6. В этом же окне есть внизу кнопка "Загрузить SSH ключ"

• Jпределите путь к файлу .ppk
• Введите пароль к файлу

После того как начнете клонирование появится окно Git, в котором следует указать путь к файлу с SSH ключом и свой пароль.

ВАЖНО! подтвердить что бы Git пароль запомнил, иначе в при дальнейшем использовании будет необходимо снова указывать путь и пароль.

---

При успешном прохождении всех шагов можно приступить к сборке Shop