КАК ПОЛЬЗОВАТЬСЯ GITLAB

GIT

GitLab — это онлайн сервис для работы с git репозиториями, у которого есть Open Source версия, которую можно установить и развернуть на своем сервере. Разработчики позиционируют свой сервис как альтернативу GitHub и с этой задачей он полностью справляется. Здесь есть все то же самое, что и на GitHub, плюс бесплатные неограниченные частные репозитории, создание команд, редактирование кода прямо в браузере и многое другое.

В этой статье мы поговорим о том, как пользоваться GitLab для разработки своих проектов. Как создавать репозитории и взаимодействовать с ними.

СОЗДАНИЕ АККАУНТА

Зарегистрироваться на GitLab очень просто. Откройте главную страницу GitLab найдите в правой части экрана форму входа и перейдите на вкладку Register. Здесь вам нужно ввести ваше имя, логин, адрес электронной почты, согласится с условиями использования и нажать кнопку Register:

КАК ПОЛЬЗОВАТЬСЯ GITLAB

После этого вам на почту придет сообщение со ссылкой для подтверждения аккаунта, перейдите по ней:

КАК ПОЛЬЗОВАТЬСЯ GITLAB

Теперь ваш аккаунт подтвержден и вы можете в нём авторизоваться:

КАК ПОЛЬЗОВАТЬСЯ GITLAB

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

КАК ПОЛЬЗОВАТЬСЯ GITLAB

СОЗДАНИЕ РЕПОЗИТОРИЯ

Чтобы добавить проект GitLab кликните по значку + по центру верхней панели и выберите New Project:

КАК ПОЛЬЗОВАТЬСЯ GITLAB

Здесь вам нужно ввести имя репозитория, его описание, а также выбрать уровень доступа:

  • Private — доступен только вам;
  • Internal — доступен всем зарегистрированным пользователям;
  • Public — доступен абсолютно всем.

Ещё вы можете установить галочку напротив Инициализировать репозиторий файлом README, но если вы хотите залить сюда файлы из уже существующего репозитория, делать этого не следует:

КАК ПОЛЬЗОВАТЬСЯ GITLAB

После нажатия на кнопку Create repo вы попадаете на страницу репозитория. Здесь GitLab уже предлагает первоначальный набор действий, чтобы проиниализировать ваш репозиторий. Например, вы можете создать здесь файлы или загрузить сюда файлы из вашего компьютера.

КАК ПОЛЬЗОВАТЬСЯ GITLAB

ЗАГРУЗКА ФАЙЛОВ ПРОЕКТА

Давайте создадим новый локальный репозиторий на компьютере и загрузим его содержимое на GitLab. Для этого создайте папку репозитория, например, test-repo и инициализируйте в ней новый репозиторий командой git:

mkdir test-repo && cd test-repo
git init

Затем давайте создадим файл test.txt:

vi test.txt

This is test losst repo

И зафиксируем изменения:

git add test.txt
git commit -m "Inital commit"
КАК ПОЛЬЗОВАТЬСЯ GITLAB

Дальше нам нужно добавить наш удаленный репозиторий с GitLab к нашему локальному. Для этого выполните:

git remote add origin https://gitlab.com/losst/test-repo.git

Затем отправляем изменения в удаленный репозиторий:

git push origin master
КАК ПОЛЬЗОВАТЬСЯ GITLAB

Для отправки данных нужно ввести ваш логин и пароль на GitHub. Теперь, если вы обновите страницу репозитория на GitHub, то увидите там наш файл:

КАК ПОЛЬЗОВАТЬСЯ GITLAB

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

SSH КЛЮЧИ

Во время загрузки данных репозитория на GitLab нам нужно было ввести логин и пароль на сервере. Чтобы этого избежать можно использовать SSH ключи для авторизации. Сначала вам нужно создать такой ключ. Для этого откройте терминал и выполните:

ssh-keygen
КАК ПОЛЬЗОВАТЬСЯ GITLAB

Введите путь к файлу, куда нужно сохранить ключ, а пароль оставьте пустым. Будут созданы два файла — открытый ключ с расширением .pub и закрытый. Вам нужен открытый. Откройте его в текстовом редакторе и скопируйте его содержимое в буфер обмена:

vi /home/sergiy/.ssh/id-gitlab
КАК ПОЛЬЗОВАТЬСЯ GITLAB

Далее возвращайтесь к интерфейсу GitLab кликните по иконке профиля и выберите Settings:

КАК ПОЛЬЗОВАТЬСЯ GITLAB

Здесь на левой панели найдите пункт SSH Keys. В этом окне найдите поле Key и вставьте туда скопированный ключ. Далее сохраните изменения. Теперь ваш ключ добавлен:

КАК ПОЛЬЗОВАТЬСЯ GITLAB

Далее вернитесь в ваш репозиторий, найдите в правом верхнем углу кнопку Clone и кликните по ней. Нас интересует адрес Clone with SSH:

КАК ПОЛЬЗОВАТЬСЯ GITLAB

Возвращаемся к нашему локальному репозиторию, удаляем адрес https и добавляем ssh:

git remote remove origin
git remote add origin git@gitlab.com:losst/test-repo.git

Настройка ssh GitLab завершена. Теперь все действия будут выполняться по SSH и у вас не будет необходимости вводить логин и пароль.

ВЕТКИ РЕПОЗИТОРИЯ

Разберем использование gitlab для работы с ветками. По умолчанию у репозитория есть только одна ветка — это master. Но для реализации дополнительных функций разработку можно выносить в отдельные ветки. В интерфейсе GitLab ветки отображаются слева. Здесь можно выбрать нужную ветку:

КАК ПОЛЬЗОВАТЬСЯ GITLAB

Создать новую ветку можно кликнув по значку плюс и выбрав New branch. Но это не обязательно, так как если вы создадите ветку в git и зальете изменения в репозиторий, то ветка появится там автоматически.

КАК ПОЛЬЗОВАТЬСЯ GITLAB

Чтобы изменить ветку по умолчанию откройте Settings -> Repository, а потом просто выберите нужную ветку в разделе Default branch:

КАК ПОЛЬЗОВАТЬСЯ GITLAB

СЛИЯНИЕ ВЕТОК

Поскольку у нас есть ветки и в них разрабатывается функциональность может возникнуть необходимость перенести её из одной ветки в другую. Для этого используются запросы слияния (Merge request gitlab). Давайте добавим ветку new-feature, а в ней создадим файл new-feature с текстом:

git checkout -b new-feature
vi new-feature.txt
New feature with change
git add new-feature.txt
git commit -m "add feature"
git push --set-upstream origin new-feature
КАК ПОЛЬЗОВАТЬСЯ GITLAB

Теперь, когда мы перейдем в новую ветку через интерфейс GitLab появится кнопка Create merge request. Нажмите на неё:

КАК ПОЛЬЗОВАТЬСЯ GITLAB

Здесь нужно написать описание Merge Request, который вы создаете, выбрать ветку источник и ветку цель. Также можно выбрать пользователя, которому будет оправлено уведомление о созданном запросе:

КАК ПОЛЬЗОВАТЬСЯ GITLAB

Далее запрос на слияние нужно одобрить. Вы можете посмотреть изменения нажав кнопку Open IDE или через терминал:

КАК ПОЛЬЗОВАТЬСЯ GITLAB

Далее просто нажмите кнопку Merge, если хотите слить ветки. Файлы ветки источника заменят файлы в ветке преемника, поэтому будьте осторожны, чтобы не потерять важные данные.

КАК ПОЛЬЗОВАТЬСЯ GITLAB
КАК ПОЛЬЗОВАТЬСЯ GITLAB

ДОБАВЛЕНИЕ ПОЛЬЗОВАТЕЛЕЙ

Несмотря на то, что репозитории приватные, возможна работа с gitlab командой. Вы можете добавить к ним неограниченное количество разработчиков. Для этого откройте пункт Settings -> Members. Здесь в поле Select members to invite введите никнеймы или адреса электронной почты пользователей, которых надо пригласить, а в поле Choose a role permission выберите их уровень доступа:

КАК ПОЛЬЗОВАТЬСЯ GITLAB
КАК ПОЛЬЗОВАТЬСЯ GITLAB

Затем нажмите кнопку Add to project.

УДАЛЕНИЕ ПРОЕКТА

Чтобы удалить проект с Gitlab надо открыть Settings -> General -> Advanced и выбрать Remove Project в самом низу страницы:

КАК ПОЛЬЗОВАТЬСЯ GITLAB

После нажатия на кнопку вам нужно будет ввести имя проекта, после чего он будет удален:

КАК ПОЛЬЗОВАТЬСЯ GITLAB

ВЫВОДЫ

В этой статье мы кратко разобрали как пользоваться GitLab для разработки программного обеспечения. Это далеко не все возможности GitLab, которые заслуживают внимания, там ещё есть релизы, сообщения об ошибках, инструменты автоматизации и тестирования, удобный редактор кода и многое другое. В общем это полноценная альтернатива для GitHub если тот сервис больше вам не нравится. А что вы предпочитаете, GitHub или GitLab? Напишите в комментариях!

Оцените статью
Добавить комментарий