GitLab — это веб-менеджер Git- репозиториев с открытым исходным кодом, написанный на Ruby , включающий в себя вики, управление задачами, проверку кода, мониторинг, а также функции непрерывной интеграции и развертывания. Он позволяет разработчикам создавать, проверять и развертывать свои проекты.
Доступны три различные версии GitLab: Community Edition (CE), Enterprise Edition (EE) и версия, размещенная на GitLab.
GitLab — лучший выбор, если вы хотите отказаться от GitHub . Он позволяет импортировать проекты и задачи из разных источников, включая GitHub, что упрощает процесс миграции. Интерфейс GitLab хорошо продуман, понятен, интуитивно понятен и близок к GitHub по удобству использования и функциональности.
Существует несколько способов установки GitLab в зависимости от желаемого варианта использования. В этом руководстве рассматриваются шаги, необходимые для установки и настройки GitLab (CE) в системе Ubuntu 18.04 с использованием пакетов Omnibus.
Предпосылки
В этом руководстве предполагается, что у вас установлена новая версия Ubuntu 18.04. Согласно требованиям GitLab , рекомендуется использовать сервер со следующими характеристиками:
- не менее 4 ГБ оперативной памяти .
- 2 ядра процессора.
- не менее 2 ГБ пространства для подкачки .
- (необязательно) Домен или поддомен, указывающий на IP-адрес сервера.
Для дополнительного уровня безопасности рекомендуется настроить базовый брандмауэр. Инструкции см. в нашем руководстве «Как настроить брандмауэр с помощью UFW в Ubuntu 18.04» .
Перед началом работы с руководством убедитесь, что вы вошли в систему как пользователь с привилегиями sudo .
Установка необходимых зависимостей
Обновите локальный индекс пакетов и установите зависимости с помощью следующих команд:
sudo apt updatesudo apt install curl openssh-server ca-certificates
Чтобы GitLab мог отправлять уведомления по электронной почте, вы можете либо установить и использовать Postfix, либо использовать какой-либо транзакционный почтовый сервис, такой как SendGrid, MailChimp, MailGun или SES; в этом случае вы можете пропустить следующий шаг и настроить [параметры SMTP GitLab] ( https://docs.gitlab.com/omnibus/settings/smtp.html ) после завершения установки.
Выполните следующие команды для установки Postfix на ваш сервер Ubuntu:
debconf-set-selections <<< "postfix postfix/mailname string $(hostname -f)"debconf-set-selections <<< "postfix postfix/main_mailer_type string 'Internet Site'"sudo apt install postfix
Более подробную информацию о настройке собственного почтового сервера можно найти в этой серии статей.
Установка GitLab
Установка GitLab — довольно простой процесс. Мы установим пакет GitLab CE с помощью менеджера пакетов apt .
Начните с добавления репозитория GitLab в список источников вашей системы с помощью следующей команды curl :
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
После включения репозитория установите пакет GitLab, выполнив следующую команду.
sudo apt install gitlab-ce
Процесс установки может занять некоторое время. После успешной установки вы увидите следующий результат:
Thank you for installing GitLab!
Настройка правил брандмауэра
Руководство по настройке базового брандмауэра доступно в разделе «Предварительные требования». Для доступа к интерфейсу GitLab необходимо открыть порты 80 и 443 :
sudo ufw allow OpenSSHsudo ufw allow httpsudo ufw allow https
Чтобы убедиться, что необходимые порты открыты, вы можете проверить состояние брандмауэра с помощью:
sudo ufw status
Status: active To Action From -- ------ ---- 80/tcp ALLOW Anywhere 443/tcp ALLOW Anywhere OpenSSH ALLOW Anywhere 80/tcp (v6) ALLOW Anywhere (v6) 443/tcp (v6) ALLOW Anywhere (v6) OpenSSH (v6) ALLOW Anywhere (v6)
Установите URL-адрес GitLab
Перед доступом к веб-интерфейсу GitLab необходимо указать URL-адрес, по которому будет доступен GitLab. Откройте файл конфигурации GitLab и внесите следующие изменения:
sudo nano /etc/gitlab/gitlab.rb
В верхней части файла конфигурации вы увидите строку, начинающуюся с external_url . Измените значение в соответствии с вашим доменом/поддоменом или IP-адресом. Если у вас есть домен, используйте https , а если вы хотите получить доступ к интерфейсу GitLab через IP-адрес вашего сервера, используйте http .
/etc/gitlab/gitlab.rb
external_url 'https://gitlab.example.com'
Затем найдите «Let's Encrypt integration», раскомментируйте строку, начинающуюся с letsencrypt['enable'] , и установите значение true. Если вы хотите получать электронные письма от Let's Encrypt, касающиеся вашего домена, раскомментируйте строку, начинающуюся с letsencrypt['contact_emails'] , и добавьте свой адрес электронной почты.
Если вы задаете external_url для IP-адреса, то не включайте интеграцию Let's Encrypt.
/etc/gitlab/gitlab.rb
letsencrypt [ 'enable' ] = true letsencrypt [ 'contact_emails' ] = [ 'admin@example.com' ] # This should be an array of email addresses to add as contacts
Наконец, сохраните и закройте файл и выполните следующую команду для перенастройки Gitlab:
sudo gitlab-ctl reconfigure
Команда перенастроит ваши параметры GitLab и сгенерирует бесплатный SSL-сертификат Let's Encrypt.
Настройка GitLab через веб-интерфейс
Теперь, когда вы настроили URL-адрес GitLab, вы можете приступить к первоначальной настройке через веб-интерфейс GitLab.
Запустите веб-браузер и перейдите по адресу:
https://your_gitlab_domain_or_server_IP.com
1. Установка пароля учетной записи администратора
При первом доступе к веб-интерфейсу вам будет предложено установить пароль для учетной записи администратора.
Введите надежный пароль и нажмите кнопку Change your password по завершении.
Вы будете перенаправлены на страницу входа:
Имя пользователя административной учётной записи по умолчанию — root . Далее в этом руководстве мы покажем вам, как изменить имя пользователя.
- Имя пользователя: root
- Пароль: [установленный вами пароль]
После ввода учетных данных и нажатия кнопки Sign in вы попадете на страницу приветствия GitLab.
2. Редактирование профиля пользователя
Первое, что вам нужно сделать, — это отредактировать свой профиль. Нажмите на аватар пользователя (в правом верхнем углу) и в раскрывающемся меню выберите Settings :
Здесь вы можете изменить своё имя, адрес электронной почты и другие данные и настройки профиля. Вносите изменения по своему усмотрению.
После этого нажмите кнопку Update Profile settings , и вскоре на указанный вами адрес электронной почты придёт письмо с подтверждением. Чтобы подтвердить учётную запись, следуйте инструкциям в письме.
3. Изменение имени пользователя
Чтобы открыть страницу профиля, нажмите ссылку Account в левом вертикальном навигационном меню.
Как вы уже знаете, имя пользователя по умолчанию для первой административной учётной записи — root . Чтобы изменить его, просто введите новое имя пользователя и нажмите кнопку Update username .
На этом экране вы также можете включить двухфакторную аутентификацию.
При следующем входе в панель управления GitLab вам потребуется ввести новое имя пользователя.
4. Добавление ключа SSH
Чтобы иметь возможность отправлять локальные изменения git на сервер GitLab, вам необходимо добавить открытый ключ SSH к вашей учетной записи GitLab.
Если у вас уже есть пара ключей SSH, созданная в локальной системе, вы можете отобразить открытый ключ, введя:
cat ~/.ssh/id_rsa.pub
Вывод должен выглядеть примерно так:
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQDd/mnMzHwjUzK8g3ldfsfRpJuC16mhWamaXRk8ySQrD/dzpbRLfDnZsLxCzRoq+ZzFHGwcQlJergtergdHGRrO8FE5jl3IWRRp+mP12qYw== admin@linuxgazette.ru
Если команда выше выводит сообщение No such file or directory это означает, что на вашем компьютере не сгенерирована пара ключей SSH.
Для генерации новой пары ключей SSH используйте следующую команду:
ssh-keygen -t rsa -b 4096 -C "your_email@domain.com"
Скопируйте вывод команды cat и вернитесь в веб-интерфейс GitLab. Нажмите SSH Keys в левом вертикальном меню навигации, чтобы открыть страницу настройки ключей SSH.
В текстовую область Key вставьте открытый ключ, который вы ранее скопировали с локального компьютера, задайте описательное название и нажмите кнопку Add key :
Теперь вы сможете отправлять и извлекать изменения в своем проекте с локального компьютера без необходимости предоставления учетных данных GitLab.
Заключение
В этом руководстве вы познакомились с установкой и настройкой GitLab в Ubuntu 18.04. Вы также узнали, как изменить настройки профиля, имя пользователя и добавить SSH-ключ. Теперь вы можете создать свой первый проект и начать использовать GitLab.
Если у вас есть вопросы, не стесняйтесь оставлять комментарии ниже.
ubuntu git gitlab Не используете Ubuntu 18.04?
Выберите другую ОС: центос 7
Связанные руководства