Установка Bugzilla на Debian 11

TL;DR

Bugzilla — свободная система трекинга ошибок на Perl с бэкендом MySQL/MariaDB. В этой инструкции показано, как установить Bugzilla 5.0.6 на Debian 11: установить зависимости, настроить MariaDB и Apache, распаковать Bugzilla, выполнить checksetup.pl и открыть веб-интерфейс. В конце — чек-листы, рекомендации по безопасности и устранению проблем.

Общий вид Bugzilla — логотип и интерфейс

Зачем эта инструкция

Bugzilla помогает отслеживать баги, запросы на изменение и сотрудничать между командами. Здесь вы получите пошаговую инструкцию, которую можно повторить на чистой установке Debian 11.

Что нужно перед началом

Сервер с Debian 11.
Домен с A-записью, указывающей на IP сервера.
Пароль root (или доступ через sudo).

Краткий план действий

Обновить систему.
Установить системные зависимости и Perl-модули.
Установить Apache и MariaDB.
Создать базу данных для Bugzilla.
Скачать и распаковать Bugzilla.
Настроить localconfig и запустить ./checksetup.pl.
Настроить виртуальный хост Apache и, при необходимости, HTTPS.

Установка зависимостей

Обновите индексы пакетов:

apt-get update -y

Установите все необходимые Perl-модули и утилиты (команда может быть длинной):

apt-get install build-essential libdatetime-timezone-perl libappconfig-perl libdate-calc-perl libtemplate-perl libmime-tools-perl libdatetime-perl libemail-sender-perl libemail-mime-perl libemail-mime-perl libdbi-perl libdbd-mysql-perl libcgi-pm-perl libmath-random-isaac-perl libmath-random-isaac-xs-perl libapache2-mod-perl2 libapache2-mod-perl2-dev libchart-perl libxml-perl libxml-twig-perl perlmagick libgd-graph-perl libtemplate-plugin-gd-perl libsoap-lite-perl libhtml-scrubber-perl libjson-rpc-perl libdaemon-generic-perl libtheschwartz-perl libtest-taint-perl libauthen-radius-perl libhtml-formattext-withlinks-perl libgd-dev graphviz sphinx-common rst2pdf libemail-address-perl libemail-reply-perl libfile-slurp-perl libencode-detect-perl libmodule-build-perl libnet-ldap-perl libfile-which-perl libauthen-sasl-perl libfile-mimeinfo-perl -y

Примечание: список берёт всё из оригинального руководства. Если вы хотите минимальную установку, можно ставить только необходимые модули, которые checksetup.pl укажет при запуске.

Установка Apache и MariaDB

apt-get install apache2 mariadb-server mariadb-client -y

Запустите сервисы:

systemctl start apache2
systemctl start mariadb

Проверьте статус, если нужно:

systemctl status apache2
systemctl status mariadb

Настройка MariaDB для Bugzilla

Войдите в консоль MariaDB:

mysql

Выполните команды для создания базы и пользователя (замените password на надёжный пароль):

MariaDB [(none)]> CREATE DATABASE bugzilla;
MariaDB [(none)]> CREATE USER 'buguser'@'localhost' IDENTIFIED BY 'password';
MariaDB [(none)]> GRANT ALL PRIVILEGES ON bugzilla.* TO 'buguser'@'localhost';
MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> EXIT;

Отредактируйте конфигурацию MariaDB, чтобы убедиться в достаточных лимитах и полнотекстовом поиске:

nano /etc/mysql/mariadb.conf.d/50-server.cnf

Добавьте внутри секции [mysqld]:

max_allowed_packet=16M
ft_min_word_len=2

Сохраните и перезапустите сервис:

systemctl restart mariadb

Важно: для production-серверов используйте надёжные пароли и, при возможности, отдельный сервер базы данных.

Скачивание и установка Bugzilla

Скачайте указанный релиз Bugzilla:

wget https://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-5.0.6.tar.gz

Создайте директорию и распакуйте архив:

mkdir /var/www/html/bugzilla
tar xf bugzilla-5.0.6.tar.gz -C /var/www/html/bugzilla --strip-components=1

Перейдите в каталог и отредактируйте localconfig:

cd /var/www/html/bugzilla
nano localconfig

Измените или добавьте следующие параметры (пример):

$create_htaccess = 1;
$webservergroup = 'www-data';
$use_suexec = 1;
$db_driver = 'mysql';
$db_host = 'localhost';
$db_name = 'bugzilla';
$db_user = 'buguser';
$db_pass = 'password';

Сохраните изменения и запустите первоначальную настройку:

./checksetup.pl

В процессе вы введёте адрес администратора, реальное имя и пароль. Пример интерактивного вывода:

Enter the e-mail address of the administrator: [email protected]
Enter the real name of the administrator: Hitesh Jethva
Enter a password for the administrator account:
Please retype the password to verify:
[email protected] is now set up as an administrator.
Creating initial dummy product 'TestProduct'...

Now that you have installed Bugzilla, you should visit the 'Parameters'
page (linked in the footer of the Administrator account) to ensure it
is set up as you wish - this includes setting the 'urlbase' option to
the correct URL.
checksetup.pl complete.

Далее установите недостающие Perl-модули (если checksetup.pl их перечислил):

/usr/bin/perl install-module.pl --all

Установите права на файлы Bugzilla:

chown -R www-data:www-data /var/www/html/bugzilla/

Проверка снова

./checksetup.pl

Если всё в порядке, вы увидите рекомендации по Apache-модулям и сообщение о успешной проверке.

Настройка Apache для Bugzilla

Создайте виртуальный хост:

nano /etc/apache2/sites-available/bugzilla.conf

Вставьте конфигурацию (замените ServerName на ваш домен):


ServerName bugzilla.example.com
DocumentRoot /var/www/html/bugzilla/


AddHandler cgi-script .cgi
Options +Indexes +ExecCGI
DirectoryIndex index.cgi
AllowOverride Limit FileInfo Indexes Options AuthConfig


ErrorLog /var/log/apache2/bugzilla.error_log
CustomLog /var/log/apache2/bugzilla.access_log common

Активируйте сайт и модули:

a2ensite bugzilla.conf
a2enmod headers env rewrite expires cgi
systemctl restart apache2

Проверьте статус Apache:

systemctl status apache2

Примечание: для production-сайта обязательно включите SSL. Ниже приведено краткое руководство по HTTPS.

Включение HTTPS (рекомендация)

Для публичного доступа используйте Let’s Encrypt и certbot:

apt-get install certbot python3-certbot-apache -y
certbot --apache -d bugzilla.example.com

Certbot обновит виртуальный хост и настроит автоматическое обновление сертификатов.

Доступ к веб-интерфейсу

Откройте в браузере http://bugzilla.example.com или https://ваш-домен при включённом HTTPS. Должны появиться страницы входа и дашборда.

Экран приветствия Bugzilla

Экран входа в Bugzilla (Login)

Панель управления Bugzilla — дашборд

Критерии приёмки

Веб-интерфейс доступен по указанному домену.
Администратор создан и может войти в систему.
./checksetup.pl не выдаёт критических ошибок.
База данных Bugzilla создана и доступна пользователю buguser.

Быстрый чек-лист перед вводом в эксплуатацию

Поменять временные пароли на надёжные.
Настроить HTTPS.
Отключить или ограничить доступ к MariaDB по сети (разрешить только localhost).
Создать резервную стратегию для /var/www/html/bugzilla и базы данных.
Настроить регулярное обновление пакетов и Perl-модулей.

Роли и обязанности (кто за что отвечает)

Системный администратор: установка пакетов, SSL, бэкапы, обновления ОС.
DBA/инженер БД: настройка MariaDB, бэкапы базы, мониторинг производительности.
Администратор Bugzilla: настройка параметров в веб-интерфейсе, управление пользователями и продуктами.

Безопасность и жёсткая конфигурация

Запретите прямой доступ к MySQL/MariaDB извне.
Ограничьте права файлов для /var/www/html/bugzilla (владелец www-data).
Включите автоматические обновления безопасности или настройте регулярные проверки обновлений.
Подумайте о двухфакторной аутентификации для админов (в Bugzilla можно реализовать через внешнюю аутентификацию).

Устранение проблем (три частых ошибки)

Apache возвращает 500 при обращении к Bugzilla: проверьте владельца файлов и права на .cgi, убедитесь, что mod_cgi/mod_cgid включён.
Ошибки подключения к базе: проверьте правильность $db_user/$db_pass в localconfig и права в MariaDB.
Недостающие Perl-модули: запустите /usr/bin/perl install-module.pl –all и посмотрите вывод checksetup.pl для списка.

Мини-методология внедрения (3 шага)

Тестовая среда: установите Bugzilla в изолированном окружении и настройте поток работы багов.
Процесс миграции: настройте продукты/компоненты и опробуйте импорт тестовых данных.
Продакшн: перенесите конфигурации, включите HTTPS и настройте бэкапы.

Тесты приёмки (короткие)

Успешный логин администратора.
Создание и закрытие баг-репорта.
Отправка уведомления по e-mail (если настроено).
Резервное восстановление из бэкапа (тестовое восстановление).

Короткое объявление для команды (100–200 слов)

Мы установили Bugzilla 5.0.6 на сервер с Debian 11. Система готова для тестовой эксплуатации: создан администратор, настроена база данных MariaDB и веб-сервер Apache. Перед переводом в продуктивные условия необходимо включить HTTPS (рекомендуем Let’s Encrypt), настроить бэкапы и проверить отправку уведомлений по e-mail. Попросите руководителей команд протестировать поток создания и закрытия багов, чтобы подтвердить требования процессов. Если нужны права администратора или перенос исторических данных из другой системы, свяжитесь с командой инфраструктуры.

Краткая справка (глоссарий)

Bugzilla — система трекинга ошибок на Perl.
localconfig — файл конфигурации Bugzilla с настройками БД и веб-сервера.
checksetup.pl — основной скрипт проверки и установки зависимостей Bugzilla.

Заключение

Вы успешно установили Bugzilla на Debian 11. Проверьте параметры в веб-интерфейсе (Раздел «Parameters») и настройте urlbase на правильный домен. Если потребуется помощь с миграцией данных, автоматизацией бэкапов или интеграцией с CI, задайте вопросы — я помогу.