Як встановити GitLab Community Edition (CE) 11.x на Ubuntu 18.04 LTS

Оскільки GitHub був придбаний Microsoft, чимало розробників планували перенести свої власні сховища коду з github.com на альтернативне рішення для самостійного розміщення. GitLab Community Edition (CE) є найпоширенішим вибором.

Як складне та гнучке рішення, GitLab CE можна розгорнути за допомогою різних методів, але тут буде розглянуто лише офіційно рекомендований метод, установка пакету Omnibus.

Передумови

• Свіжий екземпляр сервера Vultr Ubuntu 18.04 LTS x64 з принаймні 4 Гб пам’яті. Рекомендується 8 ГБ або більше для обслуговування до 100 користувачів. Скажімо, його адреса IPv4: 203.0.113.1.
• Користувач sudo .
• Домен, gitlab.example.comщо вказується на згаданий вище екземпляр.

Примітка: під час розгортання на власному екземплярі сервера обов’язково замініть усі прикладні значення на фактичні.

Крок 1: Виконайте основні завдання для розміщення GitLab CE

Запустіть термінал SSH і увійдіть у свій екземпляр с��рвера Ubuntu 18.04 LTS x64 як користувач sudo.

Додайте розділ підкачки та налаштуйте параметр підкачки

Під час розгортання GitLab CE 11.x на машині з 4 ГБ пам’яті потрібно налаштувати розділ підкачки 4 ГБ для безперебійної роботи:

sudo dd if=/dev/zero of=/swapfile count=4096 bs=1M
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile   none    swap    sw    0   0' | sudo tee -a /etc/fstab
free -m

Примітка. Якщо ви використовуєте інший розмір сервера, розмір розділу підкачки може відрізнятися.

Для цілей продуктивності системи рекомендується налаштувати параметр підкачки ядра на низьке значення, наприклад 10:

echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
cat /proc/sys/vm/swappiness

Результатом catкоманди буде 10.

Налаштуйте ім’я хоста комп’ютера та повне доменне ім’я (FQDN)

Використовуйте такі команди, щоб налаштувати ім’я хоста gitlab, і FQDN gitlab.example.com, для машини:

sudo hostnamectl set-hostname gitlab
sudo sed -i "1 i\203.0.113.1 gitlab.example.com gitlab" /etc/hosts

Ви можете підтвердити результати:

hostname
hostname -f

Змінити правила брандмауера

Дозволити вхідний трафік SSH, HTTP і HTTPS

sudo ufw allow OpenSSH
sudo ufw allow http
sudo ufw allow https
sudo ufw enable

Оновіть систему

sudo apt update
sudo apt upgrade -y && sudo shutdown -r now

Під час оновлення вас можуть повідомити про те, що поточну версію конфігураційного файлу grub було змінено локально. Оскільки ми фактично не несемо відповідальності за зміни, скористайтеся UPстрілкою, щоб виділити install the package maintainer's versionпараметр, а потім натисніть ENTER.

Коли система знову запрацює, увійдіть як той самий користувач sudo, щоб продовжити.

Крок 2: Встановіть необхідні залежності

Перед встановленням GitLab CE вам потрібно встановити необхідні залежності:

sudo apt install -y curl openssh-server ca-certificates

Крім того, якщо ви хочете використовувати Postfix для надсилання сповіщень, вам потрібно встановити Postfix:

sudo apt install -y postfix

Під час встановлення може з'явитися екран конфігурації:

1. Натисніть, TABщоб виділити <OK>кнопку на першому екрані, а потім натисніть ENTER.
2. Виберіть Internet Siteі натисніть ENTER.
3. Для цього mail nameполя введіть FQDN свого сервера gitlab.example.comта натисніть ENTER.
4. Якщо з’являться інші екрани, натисніть, ENTERщоб прийняти налаштування за замовчуванням.

Запустіть і ввімкніть службу Postfix:

sudo systemctl enable postfix.service
sudo systemctl start postfix.service

Змініть правила брандмауера для Postfix:

sudo ufw allow Postfix
sudo ufw allow 'Postfix SMTPS'
sudo ufw allow 'Postfix Submission'

Після встановлення Postfix вам необхідно налаштувати Postfix, відредагувавши його основний конфігураційний файл /etc/postfix/main.cfвідповідно до фактичних налаштувань сервера.

Примітка. На додаток до наведених вище інструкцій вам потрібно надіслати заявку в службу підтримки, щоб скасувати блокування Vultr за замовчуванням на порту SMTP 25.

Крім того, якщо ви хочете використовувати інше рішення для обміну повідомленнями, просто пропустіть встановлення Postfix і виберіть використання зовнішнього SMTP-сервера після встановлення GitLab CE.

Крок 3: Налаштуйте репозиторію GitLab APT, а потім встановіть GitLab CE

Налаштуйте репозиторій GitLab CE APT у вашій системі:

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

Далі встановіть GitLab CE 11.x:

sudo EXTERNAL_URL="http://gitlab.example.com" apt install -y gitlab-ce

Установка може зайняти деякий час.

Нарешті, наведіть свій улюблений веб-браузер на http://gitlab.example.com, а потім надішліть новий пароль, коли буде запропоновано завершити встановлення.

Відтепер використовуйте такі облікові дані для входу як адміністратор:

• Ім'я користувача: root
• Пароль: <your-new-password>

Крок 4. Увімкніть доступ HTTPS, інтегрувавши сертифікат Let's Encrypt SSL

На даний момент ви успішно встановили GitLab CE 11.x на вашому сервері, і користувачі вже можуть відвідувати сайт за допомогою протоколу HTTP. З міркувань безпеки рекомендується увімкнути доступ HTTPS до вашого сервера GitLab, інтегрувавши сертифікат Let's Encrypt SSL.

Використовуйте viредактор, щоб відкрити файл конфігурації GitLab CE:

sudo vi /etc/gitlab/gitlab.rb

Знайдіть такі два рядки:

external_url 'http://gitlab.example.com'
# letsencrypt['contact_emails'] = [] # This should be an array of email addresses to add as contacts

Замініть їх відповідно:

external_url 'https://gitlab.example.com'
letsencrypt['contact_emails'] = ['admin@example.com']

Збережіть і вийдіть:

:wq!

Переналаштуйте GitLab CE за допомогою оновлених параметрів:

sudo gitlab-ctl reconfigure

Повторна конфігурація може зайняти деякий час.

Після завершення реконфігурації всі користувачі будуть змушені використовувати протокол HTTPS під час доступу до сайту GitLab.

Примітка. Після переходу з HTTP на HTTPS застарілі файли cookie можуть викликати помилку GitLab 422. Очищення файлів cookie вирішує цю проблему.