Установка Gitlab на Ubuntu

Что такое Gitlab

GitLab – это веб-платформа для управления репозиториями кода и совместной разработки программного обеспечения на основе системы контроля версий Git. 

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

GitLab представляет собой полноценную платформу для разработки программного обеспечения, которая объединяет функциональность Git-репозиториев с другими инструментами разработки и управления проектами.

Основные возможности и функции GitLab

  • Управление репозиториями Git. GitLab предоставляет возможность создавать и хранить Git-репозитории для вашего кода. Вы можете создавать новые репозитории, копировать существующие, управлять ветками и фиксировать изменения любых файлов.
  • Веб-интерфейс и командная строка. В GitLab есть удобный веб-интерфейс для просмотра и управления вашими репозиториями. Он также полностью поддерживает командную строку Git, что позволяет разработчикам использовать привычные команды для работы с репозиториями.
  • Управление запросами на вытягивание. GitLab позволяет разработчикам создавать запросы на вытягивание, которые предлагают изменения кода перед его вливанием в основную ветку проекта.
  • Контроль доступа. GitLab предоставляет гибкие настройки контроля доступа, позволяющие ограничить доступ к репозиториям, веткам, запросам на слияние и другим элементам проекта.
  • Управление ошибками и задачами. GitLab предоставляет систему отслеживания ошибок и задач, что даёт легко управлять задачами и багами проекта.
  • Wiki и документация. GitLab включает в себя встроенную систему вики и возможность добавлять документацию к вашим проектам.

Кроме того, GitLab доступен в двух основных версиях – GitLab Community Edition (CE) и GitLab Enterprise Edition (EE). 

GitLab CE – это бесплатная версия с открытым исходным кодом, которая содержит большинство функций, доступных для обычных разработчиков и небольших команд. 

GitLab EE – это коммерческая версия, которая включает дополнительные возможности и предназначена для крупных предприятий.

Какой сервер понадобится для установки GitLab в Ubuntu

Для установки GitLab в Ubuntu потребуется мощный сервер с достаточными ресурсами, чтобы обеспечить эффективное и стабильное функционирование платформы. Настройка сервера будет зависеть от размера вашего проекта и ожидаемой нагрузки.

Ниже приведены минимальные требования к серверу, на котором можно установить GitLab Community Edition с небольшой или средней активностью:

Процессор: От двух ядер и более. 

Оперативная память (ОЗУ): От 8 ГБ. 

Интернет-соединение: Быстрое и стабильное интернет-соединение необходимо для обеспечения доступности GitLab и для своевременного выполнения операций с удалёнными репозиториями.

Хостинг: Рекомендуется выбрать хостинговый провайдер или серверное оборудование с надёжной архитектурой и возможностью масштабирования, чтобы обеспечить гибкость и эффективность работы GitLab в будущем при увеличении объёма вашего проекта.

В этом вам может помочь услуга RU-CENTER – аренда выделенного сервера. Что она включает в себя? Выделенный сервер, полный контроль над ресурсами, высокую производительность и постоянную поддержку от опытных специалистов. 

Также вы можете остановить свой выбор на виртуальных серверах, ознакомившись с нашими тарифами VPS/VDS хостинга на Linux. Надёжная архитектура и выделенные ресурсы обеспечат максимальную производительность и стабильность всем вашим проектам.

Как установить GitLab в Ubuntu 20.04 

Установить GitLab можно с помощью его официального репозитория. 

В нашей инструкции мы будем устанавливать GitLab Community Edition на Ubuntu 20.04. 

Важно! Убедитесь, что выполняете все команды с правами администратора.

  1. Обновите пакеты:

sudo apt update

  1. Установите необходимые зависимости:

sudo apt install -y curl openssh-server ca-certificates tzdata perl

sudo apt install -y postfix

  1. Установите GitLab из официального репозитория:

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

sudo apt install gitlab-ce

Готово! Вы успешно установили GitLab.

Как настроить GitLab в Ubuntu 20.04

После установки GitLab в Ubuntu, следует выполнить некоторые дополнительные настройки для обеспечения безопасности и оптимального функционирования платформы. 

  1. Измените пароль администратора.

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

  1. Настройте внешний IP-адрес.

По умолчанию, GitLab использует внутренний адрес сервера. Если вы хотите использовать внешний домен для доступа к GitLab, откройте файл настройки GitLab:

sudo nano /etc/gitlab/gitlab.rb

Отредактируйте значение «external_url»:

external_url 'http://domain_or_ip'

Где вместо «domain_or_ip» укажите ваш внешний домен или IP-адрес.

Сохраните изменения и перезапустите GitLab:

sudo gitlab-ctl reconfigure

  1. Настройте почту.

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

Откройте файл настройки GitLab:

sudo nano /etc/gitlab/gitlab.rb

Отредактируйте параметры почтового сервера (SMTP) и замените их подходящими значениями:

gitlab_rails['smtp_enable'] = true

gitlab_rails['smtp_address'] = "smtp.example.ru"

gitlab_rails['smtp_port'] = 587

gitlab_rails['smtp_user_name'] = "user@example.ru"

gitlab_rails['smtp_password'] = "your_smtp_password"

gitlab_rails['smtp_domain'] = "example.ru"

gitlab_rails['smtp_authentication'] = "login"

gitlab_rails['smtp_enable_starttls_auto'] = true

Сохраните изменения и перезапустите GitLab:

sudo gitlab-ctl reconfigure

  1. Настройте брандмауэр.

Для начала проверьте текущее состояние брандмауэра:

sudo ufw status

Если вы хотите разрешить трафик по SSH, HTTP и HTTPS через брандмауэр UFW на Ubuntu, выполните следующие команды:

sudo ufw allow OpenSSH     

sudo ufw allow http        

sudo ufw allow https       

Теперь вы можете вновь проверить статус брандмауэра и убедиться, что все разрешения были успешно выданы.

  1. Проверьте, работает ли GitLab.

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

Это были основные шаги по настройке GitLab на Ubuntu. Более подробную информацию вы сможете найти в официальной документации GitLab.

GitLab: работа через веб-интерфейс

Работа через веб-интерфейс GitLab предоставляет удобный способ управления репозиториями, участием в проектах, отслеживания задач, запросов на слияние и другими функциями GitLab. 

Шаг 1. Подготовка

  1. Откройте веб-интерфейс приложения. Он доступен по адресу:

http://gitlab.example.ru

Где вместо «example.ru» пропишите своё доменное имя или IP-адрес. 

  1. При первом посещении этой страницы задайте новый пароль. Постарайтесь сделать его как можно более надёжным – сочетайте и строчные, и прописные буквы. Обязательно сохраните его!
  2. Щёлкните Change Your Password. 
  3. Далее вас перенаправят на страницу с формой аутентификации. Впишите:
  • в поле «username» – root;
  • в поле «password» – придуманный ранее пароль.
  1. Нажмите Sign In. 

Теперь вы можете полноценно работать с веб-интерфейсом. 

Шаг 2. Изменение настроек профиля

  1. Чтобы внести необходимые изменения в свой профиль, щёлкните по значку пользователя в правом верхнем углу экрана. 
  2. В появившемся меню выберите Settings.
  3. Измените графы Name (имя) и Email (адрес электронной почты) с «Administrator» и «admin@example.ru» на что-то более точное. 

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

  1. Когда закончите, нажмите кнопку Update Profile settings. 
  2. На указанный вами адрес электронной почты будет отправлено письмо с подтверждением. Следуйте инструкциям в письме, чтобы подтвердить свою учётную запись и привязать её к GitLab.

Шаг 3. Изменение имени учётной записи

  1. В левом меню выберите раздел Account. 
  2. Здесь вы можете найти свой частный API-токен или настроить двухфакторную аутентификацию. Однако для данного шага нам потребуется опция Change username.

По умолчанию первой учётной записи администратора присваивается имя «root». Поскольку это самое распространённое и известное имя, будет более безопасно изменить его на другое имя. 

Важно! Выполнив этот шаг, вы не потеряете права администратора, только измените имя. 

  1. Введя новое имя пользователя, нажмите на кнопку Update username, чтобы внести изменения:

Шаг 4. Добавление SSH-ключа к учётной записи

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

  1. Если на вашем локальном компьютере уже есть SSH-ключ, вы можете узнать его с помощью следующей команды:

cat ~/.ssh/id_rsa.pub

Вывод будет примерно следующим:

Output

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDMuyMtMl6aWwqBCvQx7YXvZd7bCFVDsyln3yh5/8Pu23LW88VXfJgsBvhZZ9W0rPBGYyzE/TDzwwITvVQcKrwQrvQlYxTVbqZQDlmsC41HnwDfGFXg+QouZemQ2YgMeHfBzy+w26/gg480nC2PPNd0OG79+e7gFVrTL79JA/MyePBugvYqOAbl30h7M1a7EHP3IV5DQUQg4YUq49v4d3AvM0aia4EUowJs0P/j83nsZt8yiE2JEYR03kDgT/qziPK7LnVFqpFDSPC3MR3b8B354E9Af4C/JHgvglv2tsxOyvKupyZonbyr68CqSorO2rAwY/jWFEiArIaVuDiR9YM5 nicru@mydesktop

  1. Скопируйте этот текст и вернитесь на страницу настроек профиля в веб-интерфейсе GitLab.
  2. Однако велика вероятность, что вместо этого вы получите сообщение, что у вас ещё не настроен SSH-ключ:

Output

cat: /home/nicru/.ssh/id_rsa.pub: No such file or directory 

В таком случае, чтобы создать его, пропишите:

ssh-keygen

  1. Примите значения по умолчанию и при необходимости укажите пароль для локальной защиты ключа. 
  2. Затем введите следующую команду:

cat ~/.ssh/id_rsa.pub

  1. Скопируйте полученный вывод и вернитесь в настройки своего профиля в веб-интерфейсе GitLab.
  2. В левом меню найдите раздел SSH Keys и откройте его.
  3. Перед вами будет поле для ввода текста с названием «Key». Вставьте в него скопированный ключ. 
  4. В форме «Title» придумайте и пропишите его название. 
  5.  Нажмите кнопку Add key.

Заключение

Установка GitLab на Ubuntu – это отличный способ создать собственный хостинг для управления репозиториями и совместной работы над проектами. 

С помощью нашего руководства вы узнали, как установить GitLab на свой сервер Ubuntu и начать использовать все его функциональные возможности для эффективной работы с кодом и командой разработчиков. 

Всё ещё остались вопросы?