Как установить и настроить GitLab на CentOS 7

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

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

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

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

Подготовка

В этом руководстве предполагается, что у вас свежая установка CentOS 7.

Согласно странице требований GitLab , рекомендуется использовать сервер с:

• не менее 4 ГБ оперативной памяти .
• 2 ядра процессора.
• не менее 2 ГБ пространства подкачки .
• (необязательно) Домен или субдомен, указывающий на IP-адрес сервера.

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

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

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

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

sudo yum install curl policycoreutils-python openssh-server

Чтобы GitLab мог отправлять электронные письма с уведомлениями, вы можете либо установить и использовать Postfix, либо использовать какую-либо службу транзакционной почты, такую как SendGrid, MailChimp, MailGun или SES, и в этом случае вы можете пропустить этот следующий шаг и настроить [параметры SMTP GitLab] ( https://docs.gitlab.com/omnibus/settings/smtp.html ) после завершения установки.

Выполните следующие команды, чтобы установить Postfix на ваш сервер CentOS:

sudo yum install postfix

Во время установки вам будет предложено выбрать тип конфигурации почтового сервера. Параметр по умолчанию — Internet Site . Это рекомендуемый вариант, просто нажмите TAB , затем ENTER .

Затем вам будет предложено ввести имя System mail name которое должно совпадать с именем хоста вашего сервера.

После завершения установки запустите и включите службу postfix, выполнив следующие команды:

sudo systemctl start postfixsudo systemctl enable postfix

Установка GitLab

Установка GitLab — довольно простой процесс. Мы установим пакет GitLab CE с помощью менеджера пакетов yum .

Начните с добавления репозитория GitLab в список системных источников, используя следующую команду curl :

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

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

sudo yum install gitlab-ce

Вам будет предложено принять ключи GPG репозитория GitLab. Введите y и нажмите Enter .

Процесс установки может занять некоторое время, и после успешной установки вы увидите следующий результат:

Thank you for installing GitLab!
...
Complete!

Настройка правил брандмауэра

Ссылка на руководство по настройке базового брандмауэра находится в разделе предварительных требований. Чтобы получить доступ к интерфейсу GitLab, вам необходимо открыть порты 80 и 443 . Для этого выполните следующие команды:

sudo firewall-cmd --permanent --zone=public --add-service=httpsudo firewall-cmd --permanent --zone=public --add-service=httpssudo firewall-cmd --reload

Установите URL-адрес GitLab

Перед доступом к веб-интерфейсу GitLab нам нужно установить URL-адрес, по которому GitLab будет доступен. Откройте файл конфигурации Gitlab и внесите следующие изменения:

sudo vim /etc/gitlab/gitlab.rb

В верхней части файла конфигурации вы увидите строку, начинающуюся с external_url . Измените значение, чтобы оно соответствовало вашему домену / субдомену или IP-адресу. Если у вас есть домен, используйте https и если вы хотите получить доступ к интерфейсу GitLab через IP-адрес вашего сервера, используйте http .

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.

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 на CentOS 7. Вы также узнали, как редактировать настройки своего профиля, как изменить имя пользователя и добавить SSH-ключ. Теперь вы можете создать свой первый проект и начать использовать GitLab.

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