Поиск по сайту:

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


GitLab — это платформа с открытым исходным кодом, которая позволяет вам управлять репозиториями исходного кода и сотрудничать с членами вашей команды. С помощью GitLab вы можете размещать свои репозитории Git, управлять проверками кода, автоматизировать конвейеры CI/CD и многое другое. В этой статье мы проведем вас через процесс установки и настройки GitLab на CentOS 8/7.

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

Предварительные условия

  • Сервер CentOS 8/7 с минимум 4 ГБ ОЗУ и двумя ядрами ЦП.

  • Доменное имя, указывающее на IP-адрес сервера.

  • Действительный сертификат SSL для доменного имени.

  • Учетная запись пользователя root или sudo.

Шаг 1: Обновите систему

Первым шагом является обновление системных пакетов до последней версии. Вы можете сделать это, выполнив следующую команду –

sudo yum update

Шаг 2. Установите и настройте зависимости

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

sudo yum install -y curl policycoreutils-python openssh-server openssh-clients

После завершения установки нам необходимо настроить брандмауэр, чтобы разрешить трафик SSH и HTTP. Для этого выполните следующие команды —

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld

Шаг 3. Установите GitLab

Теперь мы готовы установить GitLab. Для установки GitLab мы будем использовать официальный пакет GitLab Omnibus. Запустите следующую команду, чтобы загрузить и установить GitLab —

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash
sudo EXTERNAL_URL="https://your-domain-name.com" yum install -y gitlab-ee

Замените «your-domain-name.com» на свое фактическое доменное имя.

Процесс установки может занять некоторое время, в зависимости от скорости вашего сервера и вашего интернет-соединения. После завершения установки вы увидите сообщение «GitLab установлен».

Шаг 4. Настройте GitLab

Теперь, когда GitLab установлен, нам нужно настроить его для правильной работы. Откройте файл конфигурации GitLab с помощью вашего любимого текстового редактора –

sudo nano /etc/gitlab/gitlab.rb

В этом файле вы можете настроить различные параметры, такие как SMTP-сервер, место резервного копирования и многое другое. На данный момент мы настроим только внешний URL-адрес и сертификат SSL.

Найдите следующие строки в файле —

# external_url 'http://gitlab.example.com'
# nginx['redirect_http_to_https'] = true
# nginx['redirect_http_to_https_port'] = 80

Раскомментируйте первую строку и замените «http://gitlab.example.com» своим фактическим именем домена. Раскомментируйте вторую и третью строки, чтобы включить перенаправление HTTP на HTTPS. Ваша конфигурация должна выглядеть так:

external_url 'https://your-domain-name.com'
nginx['redirect_http_to_https'] = true
nginx['redirect_http_to_https_port'] = 80

Сохраните и закройте файл.

Шаг 5. Установите SSL-сертификат

Для правильной работы GitLab требуется действительный сертификат SSL. Если у вас нет сертификата SSL, вы можете получить его бесплатно от Let's Encrypt.

Сначала установите клиент Certbot, выполнив следующую команду:

sudo yum install -y certbot python3-certbot-nginx

Затем выполните следующую команду, чтобы получить сертификат SSL –

sudo certbot --nginx -d your-domain-name.com

Следуйте инструкциям, чтобы получить сертификат SSL. После установки сертификата перезагрузите конфигурацию nginx, выполнив следующую команду:

sudo gitlab-ctl reconfigure

Шаг 6. Доступ к GitLab

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

Учетные данные для входа в GitLab по умолчанию:

Username: root
Password: 5iveL!fe

Мы рекомендуем изменить пароль по умолчанию сразу после входа в GitLab.

Шаг 7. Настройте GitLab Runner

GitLab Runner — это приложение, которое запускает задания в ответ на конвейеры GitLab CI/CD. По умолчанию GitLab Runner не установлен на вашем сервере. Вы можете установить его, следуя официальной документации.

После установки GitLab Runner вам необходимо зарегистрировать его в GitLab. Откройте терминал на вашем сервере и выполните следующую команду —

sudo gitlab-runner register

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

Вот несколько дополнительных шагов, которые вы можете предпринять для дальнейшей настройки и настройки вашей установки GitLab:

Настройка резервного копирования GitLab

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

sudo nano /etc/gitlab/gitlab.rb

Найдите следующую строку в файле —

# gitlab_rails['backup_path'] = "/var/opt/gitlab/backups"

Раскомментируйте строку и укажите каталог резервной копии. Сохраните и закройте файл.

Затем выполните следующую команду для настройки резервного копирования —

sudo gitlab-ctl reconfigure

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

sudo gitlab-rake gitlab:backup:create

Настройка SMTP GitLab

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

sudo nano /etc/gitlab/gitlab.rb

Найдите следующие строки в файле —

# gitlab_rails['smtp_enable'] = true
# gitlab_rails['smtp_address'] = "smtp.gmail.com"
# gitlab_rails['smtp_port'] = 587
# gitlab_rails['smtp_user_name'] = "user@gmail.com"
# gitlab_rails['smtp_password'] = "password"
# gitlab_rails['smtp_domain'] = "smtp.gmail.com"
# gitlab_rails['smtp_authentication'] = "login"
# gitlab_rails['smtp_enable_starttls_auto'] = true
# gitlab_rails['smtp_tls'] = false

Раскомментируйте строки и замените настройки SMTP своими собственными настройками. Сохраните и закройте файл.

Затем выполните следующую команду, чтобы настроить GitLab с новыми настройками SMTP:

sudo gitlab-ctl reconfigure

Настройте GitLab LDAP

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

sudo nano /etc/gitlab/gitlab.rb

Найдите следующие строки в файле —

# gitlab_rails['ldap_enabled'] = false
# gitlab_rails['ldap_servers'] = YAML.load <<-'EOS'
#   main:
#      label: 'LDAP'
#      host: '_your_ldap_server'
#      port: 389
#      uid: 'sAMAccountName'
#      bind_dn: '_the_full_dn_of_the_user_you_will_bind_with'
#      password: '_the_password_of_the_bind_user'
#      encryption: 'plain' # "start_tls" or "simple_tls" or "plain"
#      verify_certificates: true
#      smartcard_auth: false
#      active_directory: true
#      allow_username_or_email_login: false
#      lowercase_usernames: false
#      block_auto_created_users: false
#      base: '_the_full_dn_of_the_search_base'
#      user_filter: ''
# EOS

Раскомментируйте строки и замените настройки LDAP своими собственными настройками. Сохраните и закройте файл.

Затем выполните следующую команду, чтобы настроить GitLab с новыми настройками LDAP:

sudo gitlab-ctl reconfigure

Установите плагины GitLab

GitLab позволяет устанавливать плагины для расширения его функциональности. Вы можете просмотреть и установить плагины GitLab с торговой площадки GitLab. Чтобы установить плагин, войдите в свой экземпляр GitLab и перейдите в область администратора. Оттуда нажмите «Плагины», а затем нажмите «Торговая площадка».

Вы можете просмотреть доступные плагины и нажать «Установить», чтобы установить плагин. После установки плагина вам может потребоваться настроить его, нажав «Настройки» и следуя инструкциям, предоставленным плагином.

Настройте внешний вид GitLab

GitLab позволяет настроить его внешний вид, добавив логотип и изменив цветовую схему. Чтобы добавить логотип, войдите в свой экземпляр GitLab и перейдите в область администратора. Оттуда нажмите «Внешний вид», а затем нажмите «Пользовательские логотипы».

Вы можете загрузить логотип и настроить его размер и положение. Чтобы изменить цветовую схему, нажмите «Цвета» и выберите цветовую тему. Вы также можете настроить CSS, нажав «Пользовательский CSS» и добавив свой собственный CSS.

Настройка параметров GitLab Omnibus

GitLab Omnibus предоставляет богатый набор параметров конфигурации, которые можно использовать для настройки вашей установки GitLab. Вы можете настроить различные параметры, связанные с GitLab, Nginx, PostgreSQL, Redis и другими. Чтобы просмотреть список доступных параметров конфигурации, выполните следующую команду —

sudo gitlab-ctl show-config

Это отобразит полную конфигурацию вашей установки GitLab.

Чтобы настроить параметры GitLab Omnibus, откройте файл конфигурации GitLab с помощью вашего любимого текстового редактора –

sudo nano /etc/gitlab/gitlab.rb

Здесь вы можете раскомментировать и изменить любые доступные настройки, чтобы настроить установку GitLab.

Настройка реестра контейнеров GitLab

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

sudo nano /etc/gitlab/gitlab.rb

Найдите следующую строку в файле —

# gitlab_rails['registry_enabled'] = false

Раскомментируйте строку, чтобы включить реестр контейнеров GitLab. Сохраните и закройте файл.

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

sudo gitlab-ctl reconfigure

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

Заключение

Поздравляем! Вы успешно установили и настроили GitLab на CentOS 8/7. GitLab — это мощный инструмент, который поможет вам управлять репозиториями исходного кода и оптимизировать процесс разработки. С GitLab вы можете сотрудничать с членами вашей команды, автоматизировать конвейеры CI/CD и многое другое.

Мы надеемся, что эта статья помогла вам в процессе установки и настройки. Если у вас возникнут какие-либо проблемы или вопросы, не стесняйтесь обращаться за поддержкой к сообществу GitLab.

Статьи по данной тематике: