Як встановити GitBucket на Ubuntu 16.04

У цьому посібнику описано основне встановлення та налаштування GitBucket для екземпляра Vultr під керуванням Ubuntu 16.04 і передбачається, що ви виконуєте команди як non-rootкористувач.

Передумови

• Примірник сервера Vultr із принаймні 1 Гб оперативної пам’яті (менші екземпляри можуть працювати, хоча й повільно).
• openjdk-8-jre Обов’язково, старіші версії не працюватимуть.
• wget Використовується для завантаження пакета GitBucket.
• nginx Необов’язково, надає зворотний проксі до GitBucket
• systemd Керує запуском і зупинкою процесу GitBucket

Установка передумов

Для GitBucket на вашому сервері потрібна Java 8 або новіша версія. Якщо ви ще не встановили Java 8, спочатку оновіть локальні списки пакетів.

sudo apt update

Потім встановіть пакет середовища виконання Java 8.

sudo apt install openjdk-8-jre

Встановлення GitBucket

Створення непривілейованого користувача

Перш ніж йти далі, нам потрібно створити непривілейованого користувача для запуску GitBucket. Запуск GitBucket під непривілейованим користувачем обмежує нашу інсталяцію від запису за межі власного каталогу даних, посилюючи безпеку вашого сервера. Виконайте таку команду, щоб створити системного користувача під назвою gitbucket.

sudo adduser --system gitbucket

Оскільки ми створили системного користувача, оболонкою за замовчуванням є /bin/false, і ми будемо скинуті назад до нашої поточної оболонки, якщо ми не надамо додатковий аргумент оболонки під час запуску su. Увійдіть до новоствореного користувача.

sudo su - gitbucket -s /bin/bash

Підказка вашої оболонки має змінитися, і ви ввійдете в систему нового користувача.

Завантаження/оновлення GitBucket

Перейдіть на сторінку випусків GitBucket і знайдіть останню доступну версію. Скопіюйте URL-адресу gitbucket.warпакета, переконайтеся, що ви перебуваєте в домашньому каталозі нового користувача, і завантажте його за допомогою wget.

cd ~/
wget https://github.com/gitbucket/gitbucket/releases/download/4.18.0/gitbucket.war

Вам потрібно буде повторювати цей крок щоразу, коли ви хочете оновити пакет GitBucket.

Початкова конфігурація GitBucket

Після того, як пакет буде завантажено, нам потрібно буде запустити GitBucket вручну, щоб виконати початкову конфігурацію.

java -jar gitbucket.war --port 8080

Якщо порт 8080вже зайнятий іншим процесом, ви можете змінити порт, який GitBucket буде слухати зараз. У цьому посібнику передбачається, що GitBucket прослуховує порт8080 .

Це запустить GitBucket на загальнодоступному мережевому інтерфейсі вашого сервера, прослуховуючи вказаний порт. Через кілька хвилин ви повинні побачити таке повідомлення.

INFO:oejs.Server:main: Started @15891ms

Якщо ви використовуєте брандмауер Vultr , вам потрібно буде відкрити порт, який слухає GitBucket, оскільки брандмауер Vultr працює як білий список, відхиляючи трафік, щоб дозволити порти, якщо не вказано інше.

Тепер ваша інсталяція GitBucket має бути онлайн та доступна з Інтернету. За допомогою веб-браузера підключіться до публічної адреси вашого сервера (обов’язково вказавши порт, на якому працює GitBucket (тобто http://203.0.113.0:8080або http://example.com:8080), і ви потрапите на домашню сторінку GitBucket.

Однак пароль облікового запису адміністратора за замовчуванням необхідно змінити. Для цього увійдіть в обліковий запис адміністратора за допомогою Sign inкнопки у верхньому правому куті веб-інтерфейсу. Вхід за замовчуванням для облікового запису адміністратора призначений rootдля імені користувача, а потім rootзнову для пароля. Після входу кнопка буде замінена значком профілю та спадним меню. Розгорніть спадне меню та виберіть Account Settings, а потім установіть новий, більш безпечний пароль у майстрі налаштувань облікового запису.

Після того, як ви оновили облікові дані облікового запису адміністратора за замовчуванням і переконалися, що GitBucket запускається в цій мінімальній конфігурації, припиніть процес Java за допомогою " CTRL+C" і закрийте поточну оболонку за допомогою exit.

Створення служби Systemd

Наразі ми можемо запускати GitBucket, лише отримавши доступ до нашого сервера через SSH і запустивши процес з оболонки вручну. На щастя, Ubuntu поставляється з попередньо Systemdзапакованим , що дозволяє нам створити службу, за допомогою якої GitBucket буде автоматично запускатися та підтримуватися системою.

За допомогою nano, створіть новий файл модуля в /etc/systemd/systemкаталозі.

sudo nano /etc/systemd/system/gitbucket.service

Потім скопіюйте наступний вміст у файл.

[Unit]
Description=GitBucket
After=network.target
[Service]
ExecStart=/usr/bin/java -jar /home/gitbucket/gitbucket.war --port 8080
ExecStop=/bin/kill -SIGINT $MAINPID
Type=simple
User=gitbucket
[Install]
WantedBy=multi-user.target

Цей файл модуля визначає основну поведінку запуску та завершення роботи GitBucket, а також запускає службу під нашим непривілейованим користувачем системи на локальному мережевому інтерфейсі.

Якщо ви змінили номер порту, який GitBucket буде слухати, змініть --portаргумент для ExecStartкоманди.

Збережіть (" CTRL+O") новий файл блоку, а потім вийдіть з редактора (" CTRL+X"). Вам потрібно буде перезавантажити Systemd, щоб було виявлено новий файл модуля.

sudo systemctl daemon-reload

Після перезавантаження Systemd переконайтеся, що новий блок було виявлено та завантажено.

sudo systemctl status gitbucket

Ви повинні побачити наступний результат.

gitbucket.service - GitBucket
   Loaded: loaded (/etc/systemd/system/gitbucket.service; disabled; vendor preset: enabled)
   Active: inactive (dead)

Нарешті, увімкніть автоматичний запуск нового пристрою під час завантаження сервера, а потім запустіть службу вперше.

sudo systemctl enable gitbucket
sudo systemctl start gitbucket

Після запуску служби ви знову зможете отримати доступ до GitBucket зі свого браузера, використовуючи IP-адресу та номер порту.

Налаштування зворотного проксі Nginx

Хоча GitBucket можна надати безпосередньо через port 8080, ви можете підвищити продуктивність і налаштувати такі функції, як HTTP/2, шифрування TLS і правила кешування, відкриваючи GitBucket через Nginx.

Початкове налаштування Nginx

Якщо ви ще не встановили Nginx, оновіть свої списки пакетів.

sudo apt update

Потім встановіть пакет Nginx.

sudo apt install nginx

Після встановлення Nginx переконайтеся, що ви можете отримати доступ до веб-сервера через IP-адресу вашого сервера без номера порту (тобто http://203.0.113.0або http://example.com). У разі успіху ви побачите цільову сторінку Nginx за замовчуванням для Ubuntu.

Створення зворотного проксі

Ми будемо скопіювати конфігурацію сайту за замовчуванням /etc/nginx/sites-availableяк відправну точку для зворотного проксі.

sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/gitbucket

Відкрийте щойно створений файл конфігурації за допомогою nano.

sudo nano /etc/nginx/sites-available/gitbucket

Знайдіть існуючий location /блок у рядку 43.

location / {
  # First attempt to serve request as file, then
  # as directory, then fall back to displaying a 404.
  try_files $uri $uri/ =404;
}

Зараз Nginx намагатиметься повернути файли, /var/www/htmlякі відповідають вхідним HTTPзапитам. Нам потрібно змінити цю поведінку, налаштувавши зворотний проксі-сервер у цьому блоці, який замість цього надсилатиме всі HTTP-запити, зроблені на наш сервер Nginx, до екземпляра GitBucket. Оновіть location /блок, щоб він відповідав наступному.

location / {
    proxy_pass              http://localhost:8080; # The address GitBucket is listening on
    proxy_set_header        Host $host;
    proxy_set_header        X-Real-IP $remote_addr;
    proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_connect_timeout   150;
    proxy_send_timeout      100;
    proxy_read_timeout      100;
    proxy_buffers           4 32k;

    client_max_body_size    512m; # Needed for large Git operations over HTTP
    client_body_buffer_size 128k;
}

Якщо ви змінили номер порту, який буде слухати GitBucket, оновіть proxy_passпараметр, щоб відобразити це.

Щоб увімкнути нашу нову конфігурацію, вам потрібно буде вимкнути існуючу конфігурацію за замовчуванням у /etc/nginx/sites-enabled, а потім символізувати нашу нову конфігурацію за /etc/nginx/sites-enabledдопомогою наступного.

sudo rm /etc/nginx/sites-enabled/default
sudo ln -s /etc/nginx/sites-available/gitbucket /etc/nginx/sites-enabled/gitbucket

Після ввімкнення файлу конфігурації перевірте наявність синтаксичних помилок.

sudo nginx -t

Потім перезапустіть сервер Nginx, щоб увімкнути нашу нову конфігурацію сайту.

sudo systemctl restart nginx

Тепер ви зможете отримати доступ до вашої інсталяції GitBucket за публічною адресою вашого сервера без номера порту.

Захист процесу GitBucket від загальнодоступного Інтернету

Наразі наш екземпляр GitBucket прослуховує інтерфейс загальнодоступної мережі нашого сервера . Це дозволить користувачам обійти проксі-сервер Nginx, підключившись до адреси, яку GitBucket зараз слухає, що, ймовірно, небажано. Щоб вирішити цю проблему, нам потрібно змінити файл модуля, який ми створили раніше. Відкрийте файл блоку за допомогою nano.

sudo nano /etc/systemd/system/gitbucket.service

Додайте --host 127.0.0.1до ExecStartкоманди, наприклад.

...
ExecStart=/usr/bin/java -jar /home/gitbucket/gitbucket.war --port 8080 --host 127.0.0.1
...

Це змусить GitBucket приймати підключення лише до інтерфейсу локальної мережі нашого сервера. Ще раз збережіть (" CTRL+O") файл, закрийте (" CTRL+X") редактор, перезавантажте Systemd і перезапустіть наш модуль GitBucket.

sudo systemctl daemon-reload
sudo systemctl restart gitbucket

Якщо ви використовуєте брандмауер Vultr, вам також слід видалити всі правила порту, які ви додали для доступу до сервера GitBucket під час початкового налаштування.