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

How To Install and Configure GitLab on Ubuntu 18.04

15 Августа 2020 | Ubuntu

Есть несколько способов установить GitLab в зависимости от необходимого варианта использования. В этом руководстве описаны шаги, необходимые для установки и настройки GitLab (CE) в системе Ubuntu 18.04 с использованием пакетов Omnibus.

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

GitLab - это веб- менеджер репозитория Git с открытым исходным кодом, написанный на Ruby, включая вики, управление проблемами, анализ кода, мониторинг, а также непрерывную интеграцию и развертывание. Это позволяет разработчикам создавать, просматривать и развертывать свои проекты.

Доступны три разных редакции GitLab: Community Edition (CE), Enterprise Edition (EE) и версия, размещенная на GitLab.

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

Введение

В этом руководстве предполагается, что у вас установлена ​​свежая версия Ubuntu 18.04. Согласно странице требований GitLab , рекомендуется использовать сервер с:

Для дополнительного уровня безопасности рекомендуется установить базовый брандмауэр. Вы можете выполнить действия, описанные в нашем руководстве « Как настроить брандмауэр с UFW в Ubuntu 18.04» .

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

Установка необходимых зависимостей 

Обновите локальный индекс пакета и установите зависимости с помощью следующих команд:

sudo apt update sudo 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 OpenSSH sudo ufw allow http sudo 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», раскомментируйте строку, начинающуюся с, 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
 

При первом доступе к веб-интерфейсу вам будет предложено установить пароль для учетной записи администратора.


Введите надежный пароль и нажмите Change your password кнопку, когда закончите.

Вы будете перенаправлены на страницу входа:




Имя пользователя учетной записи администратора по умолчанию - root . Позже в этом руководстве мы покажем вам, как изменить имя пользователя.

  • Имя пользователя: root
  • Пароль: [пароль, который вы установили]


   После того, как вы введете учетные данные для входа и Sign in нажмете кнопку, вы попадете на страницу приветствия GitLab.




Первое, что вам нужно сделать, это отредактировать свой профиль пользователя. Щелкните аватар пользователя (верхний правый угол) и в раскрывающемся меню выберите 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@linuxize.com
 


   Если приведенная выше команда печатает, 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.


    Комментарии

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

Загрузка комментариев...