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

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 , рекомендуется использовать сервер с:

Для дополнительного уровня безопасности рекомендуется установить базовый брандмауэр. Вы можете выполнить действия, описанные в нашем руководстве « Как настроить брандмауэр с 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'

Затем letsencrypt['enable'] поиск по запросу «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'] = ['[email protected]'] # 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== [email protected]

Если приведенная выше команда печатает No such file or directory это означает, что на вашем компьютере не сгенерирована пара ключей SSH.

Чтобы сгенерировать новую пару ключей SSH, используйте следующую команду:

ssh-keygen -t rsa -b 4096 -C "[email protected]"

Скопируйте вывод команды cat и вернитесь в веб-интерфейс GitLab. Щелкните SSH Keys в левом вертикальном меню навигации, чтобы перейти на страницу конфигурации ключей SSH.

В текстовое поле Key вставьте открытый ключ, который вы ранее скопировали с локального компьютера, установите описательный заголовок и нажмите кнопку Add key :

Теперь у вас должна быть возможность отправлять и получать изменения проекта с локального компьютера без необходимости предоставления учетных данных GitLab.

Выводы

В этом руководстве вы познакомились с установкой и настройкой GitLab в Ubuntu 18.04. Вы также узнали, как изменить настройки своего профиля, как изменить имя пользователя и добавить SSH-ключ. Теперь вы можете создать свой первый проект и начать использовать GitLab.

Если у вас есть вопросы, не стесняйтесь оставлять комментарии ниже.

Оставьте комментарий