Данная статья предназначена для тех, кто искал подробное и понятное руководство о том, как установить Jira на Ubuntu Server.

Jira — это система отслеживания ошибок, предназначенная для организации взаимодействия с пользователями и для управления проектами.

В этом руководстве мы будем рассматривать тот случай, когда у вас уже есть сервер с установленной на нем операционной системой Ubuntu Server 18.04 LTS.

Подробно о том, как установить Ubuntu Server 18.04 LTS, вы можете прочитать в моем руководстве «Установка Ubuntu Server 18.04 LTS».

Любые антивирусные решения, установленные в вашей операционной системе, могут помешать процессу установки Jira. Возможно, вам придется временно отключить средство защиты для установки Jira.

Кроме того, на сервер должен быть установлен OpenSSH, а также открыт 22 порт, чтобы иметь возможность подключаться к серверу по протоколу SSH.

Для установки OpenSSH на сервер вы можете воспользоваться командой:

sudo apt-get install openssh-server

Если вы планируете подключиться к серверу, используя операционную систему Windows, то можете воспользоваться PuTTY — свободно распространяемым клиентом для различных протоколов удаленного доступа, включая SSH, Telnet, rlogin.

В данном руководстве рассматривается подключение к серверу при помощи терминального эмулятора iTerm2, установленного на операционную систему macOS.

Обратите внимание, вам потребуется открыть следующие порты TCP для доступа к вашему серверу:

  • 80 — для получения бесплатного криптографического сертификата через центр сертификации Let’s Encrypt.
  • 443 — для доступа к веб-интерфейсу Jira.
  • 8080 — для доступа к веб-интерфейсу Jira.

Подключаемся к серверу, на который планируется установить Jira.

В данном руководстве рассматривается получение бесплатного криптографического сертификата через центр сертификации Let’s Encrypt. Для получения и последующего обновления бесплатного SSL-сертификата мы будем использовать программный клиент Certbot, который призван максимально упростить получение и обновление сертификата через центр сертификации Let’s Encrypt.

Добавим репозиторий Certbot с помощью команды:

sudo add-apt-repository ppa:certbot/certbot

Нажимаем на кнопку «Enter», чтобы подтвердить добавление нового репозитория.

Теперь установим пакеты, необходимые для работы Jira, с помощью команды:

sudo apt-get install -y postgresql apache2 fontconfig certbot python-certbot-apache

Обратите внимание, в данном руководстве в качестве системы для управления базами данных будет использоваться PostgreSQL, а в качестве веб-сервера — Apache.

Настроим Apache для последующей работы с Jira.

Включаем модуль веб-сервера Apache под названием «proxy_http» с помощью команды:

sudo a2enmod proxy_http

Обратите внимание, модуль «proxy_http» выполняет функции прокси-сервера для протоколов HTTP и HTTPS.

Включаем модуль веб-сервера Apache под названием «rewrite» с помощью команды:

sudo a2enmod rewrite

Обратите внимание, модуль «rewrite» является одним из самых часто используемых модулей веб-сервера Apache и предоставляет гибкий и мощный способ манипулирования URL-адресами.

Теперь нужно создать два файла виртуальных хостов (в Nginx называется блок), с которыми в дальнейшем будет работать Jira.

Два файла виртуальных хостов потребуются для обеспечения доступа к Jira по HTTPS, а также для реализации возможности использования Jira по адресу https://jira.heyvaldemar.net, без указания порта 8080 в адресной строке браузера.

В данном руководстве для доступа к Jira из сети Интернет будет использоваться субдомен jira.heyvaldemar.net. Вам нужно будет указать ваш домен или субдомен, по которому ваша Jira будет доступна из сети Интернет.

Создадим первый файл виртуального хоста, воспользовавшись текстовым редактором, с помощью команды:

sudo vim /etc/apache2/sites-available/jira.heyvaldemar.net.conf

Нажимаем на кнопку «i», чтобы перейти в режим редактирования, затем вставляем следующую конфигурацию для работы веб-сервера:

В данном руководстве для доступа к Jira из сети Интернет будет использоваться субдомен Jira.heyvaldemar.net. Вам нужно будет указать ваш домен или субдомен, по которому ваша Jira будет доступна из сети Интернет.

Теперь нажмите на кнопку «Esc», чтобы выйти из режима редактирования, а затем введите «:x» и нажмите на кнопку «Enter», чтобы сохранить изменения и выйти из редактора.

Создадим второй файл виртуального хоста, воспользовавшись текстовым редактором, с помощью команды:

sudo vim /etc/apache2/sites-available/jira.heyvaldemar.net-ssl.conf

Нажимаем на кнопку «i», чтобы перейти в режим редактирования, затем вставляем следующую конфигурацию для работы веб-сервера:

В данном руководстве для доступа к Jira из сети Интернет будет использоваться субдомен jira.heyvaldemar.net. Вам нужно будет указать ваш домен или субдомен, по которому ваша Jira будет доступна из сети Интернет.

Теперь нажмите на кнопку «Esc», чтобы выйти из режима редактирования, а затем введите «:x» и нажмите на кнопку «Enter», чтобы сохранить изменения и выйти из редактора.

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

sudo a2ensite jira.heyvaldemar.net.conf

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

sudo a2ensite jira.heyvaldemar.net-ssl.conf

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

sudo a2dissite 000-default.conf

Убедимся, что в синтаксисе нового конфигурационного файла Apache нет ошибок, с помощью команды:

sudo apache2ctl configtest

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

sudo systemctl restart apache2

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

sudo systemctl status apache2

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

Для получения и последующего обновления бесплатного SSL-сертификата мы будем использовать центр сертификации Let’s Encrypt, а также программный клиент Certbot, который призван максимально упростить получение и обновление сертификата через центр сертификации Let’s Encrypt.

В данном руководстве для доступа к Jira из сети Интернет будет использоваться субдомен jira.heyvaldemar.net. Вам нужно будет указать ваш домен или субдомен, по которому ваша Jira будет доступна из сети Интернет.

Запросим криптографический сертификат с помощью команды:

sudo certbot --apache -d jira.heyvaldemar.net

Далее указываем адрес электронной почты, на который Let’s Encrypt будет присылать уведомления об истечении срока криптографического сертификата, и нажимаем на кнопку «Enter».

На следующем этапе необходимо прочитать и принять условия использования предоставляемых сервисов.

Нажимаем на кнопку «a», затем «Enter», если вы согласны с условиями использования предоставляемых сервисов.

На следующем этапе необходимо выбрать: хотите ли вы поделиться указанным ранее адресом электронной почты с Electronic Frontier Foundation для получения информационных рассылок.

Нажимаем на кнопку «n», затем «Enter».

На следующем этапе необходимо выбрать: хотите ли вы, чтобы в конфигурационный файл Apache были автоматически добавлены параметры для автоматического перенаправления HTTP-трафика на HTTPS.

Нажимаем на кнопку «2», затем «Enter».

Обратите внимание, криптографические сертификаты, полученные через центр сертификации Let’s Encrypt, действительны в течение девяноста дней. Certbot автоматически добавляет скрипт для обновления сертификата в планировщик задач, и скрипт запускается два раза в день, автоматически обновляя любой криптографический сертификат, срок действия которого истекает в течение тридцати дней.

Проверить работоспособность процесса обновления криптографического сертификата можно с помощью команды:

sudo certbot renew --dry-run

Теперь необходимо создать базу данных, которую в дальнейшем будет использовать Jira, а также пользователя с необходимыми правами в этой базе данных.

Переключаемся на пользователя «postgres», который обладает правами администратора в PostgreSQL, с помощью команды:

sudo su - postgres

Далее переключаемся на командную строку PostgreSQL с помощью команды:

psql

Создаем нового пользователя с помощью команды:

CREATE USER jiradbuser WITH PASSWORD 'bX^JR]v$56DW%$c+M';

В данном руководстве в качестве имени пользователя будет использоваться «jiradbuser», с паролем «bX^JR]v$56DW%$c+M».

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

CREATE DATABASE jiradb WITH OWNER "jiradbuser" ENCODING 'UNICODE' LC_COLLATE 'C' LC_CTYPE 'C' TEMPLATE template0;

В данном руководстве в качестве имени для базы данных будет использоваться «jiradb».

Выходим из командной строки «PostgreSQL» с помощью команды:

\q

Выходим из-под пользователя «postgres» с помощью команды:

exit

Теперь необходимо загрузить установщик Jira с помощью команды:

wget https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-core-8.8.0-x64.bin

Обратите внимание, актуальную версию Jira можно найти на официальном сайте Atlassian https://www.atlassian.com/software/jira/core/download

В данном руководстве рассматривается установка Jira 8.8.0.

Разрешим исполнение файла «atlassian-jira-core-8.8.0-x64.bin» с помощью команды:

sudo chmod a+x atlassian-jira-core-8.8.0-x64.bin

Запустим установку Jira с помощью команды:

sudo ./atlassian-jira-core-8.8.0-x64.bin

Обратите внимание, ваша команда будет отличаться от указанной в этой статье, так как вы будете устанавливать актуальную на момент прочтения версию Jira.

На первом этапе установщик предупредит о том, что на ваш сервер будет установлен Jira.

Нажимаем на кнопку «Enter».

Далее выбираем «Custom Install (recommended for advanced users)».

Нажимаем на кнопку «Enter».

На следующем шаге можно выбрать, куда установить Jira.

В данном руководстве рассматривается установка Jira в «/opt/atlassian/jira».

Нажимаем на кнопку «Enter».

Далее можно выбрать, где хранить данные Jira.

В данном руководстве рассматривается установка Jira в «/var/atlassian/application-data/jira».

Нажимаем на кнопку «Enter».

Теперь можно выбрать порты, которые будет использовать Jira.

В данном руководстве рассматривается установка Jira с использованием порта 8080 для HTTP и порта 8005 для Control.

Нажимаем на кнопку «Enter».

Далее будет предложена возможность установить Jira, как сервис.

Нажимаем на кнопку «Enter».

Нажимаем на кнопку «Enter», чтобы начать установку Jira.

Установка Jira успешно завершена.

Обратите внимание, запускать Jira не нужно.

Указываем «n» и нажимаем на кнопку «Enter».

Теперь необходимо внести изменения в конфигурационный файл Jira, открыв его в текстовом редакторе, с помощью команды:

sudo vim /opt/atlassian/jira/conf/server.xml

Нажимаем на кнопку «i», чтобы перейти в режим редактирования, находим раздел «DEFAULT — Direct connector with no proxy for unproxied access to Jira» и закомментируем его, поставив <!-- на строке выше параметров раздела и --> ниже параметров раздела, которые требуется закомментировать.

Далее находим раздел «HTTPS — Proxying Jira via Apache or Nginx over HTTPS» и раскомментируем его, удалив знак <!-- на строке выше параметров раздела и --> ниже параметров раздела, которые требуется раскомментировать.

Затем указываем для параметра «proxyName» значение «jira.heyvaldemar.net».

В данном руководстве для доступа к Jira из сети Интернет будет использоваться субдомен jira.heyvaldemar.net. Вам нужно будет указать ваш домен или субдомен, по которому ваша Jira будет доступна из сети Интернет.

Теперь нажмите на кнопку «Esc», чтобы выйти из режима редактирования, а затем введите «:x» и нажмите на кнопку «Enter», чтобы сохранить изменения и выйти из редактора.

Запускаем Jira с помощью команды:

sudo /etc/init.d/jira start

Открываем лог Jira, чтобы проверить корректность запуска Jira, с помощью команды:

sudo less /opt/atlassian/jira/logs/catalina.out

На клавиатуре нажимаем сочетание клавиш «Shift» и «f», чтобы начать следить за изменениями в логе Jira в реальном времени.

На клавиатуре нажимаем сочетание клавиш «Ctrl» и «c», затем «q», чтобы закрыть лог Jira.

Для продолжения процесса установки Jira необходимо с рабочей станции перейти по ссылке https://jira.heyvaldemar.net, где jira.heyvaldemar.net — имя моего сервера. Соответственно, вам необходимо указать имя или IP-адрес вашего сервера Jira.

В данном руководстве рассматривается установка Jira для продуктивной среды.

Выбираем «I’ll set it up myself» и нажимаем на кнопку «Next».

Теперь необходимо указать систему для управления базами данных и ранее созданную базу данных, которая будет использоваться для работы Jira.

В поле «Database Type» выбираем «PostgreSQL».

В данном руководстве база данных для работы Jira находится на одном сервере с Jira.

В поле «Hostname» указываем «localhost».

В поле «Port» указываем значение «5432».

В данном руководстве в качестве имени базы данных для работы Jira используется «jiradb».

В поле «Database» указываем «jiradb».

В данном руководстве в качестве имени пользователя, обладающего правами на базу данных для работы Jira, используется «jiradbuser».

В поле «Username» указываем «jiradbuser».

В поле «Password» указываем пароль, присвоенный пользователю «jiradbuser».

Нажимаем на кнопку «Test connection».

Сообщение «The database connection test was successful.» означает, что все данные были указаны корректно.

Нажимаем на кнопку «Next».

На следующем шаге можно указать разрешения.

Private — только администраторы могут регистрировать новых пользователей в Jira.

Public — любой может зарегистрироваться и создавать задачи в Jira.

В данном руководстве Jira будет использоваться для внутренних задач организации.

В разделе «Mode» выбираем «Private».

В поле «Base URL» должен быть указан домен или субдомен, по которому ваша Jira доступна из сети Интернет.

В данном руководстве для доступа к Jira из сети Интернет будет использоваться субдомен jira.heyvaldemar.net. Вам нужно будет указать ваш домен или субдомен, по которому ваша Jira будет доступна из сети Интернет.

Нажимаем на кнопку «Next».

Теперь необходимо указать лицензионный ключ для Jira.

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

В данном руководстве рассматривается установка Jira с временным лицензионным ключом.

Нажимаем на «generate a Jira trial license».

Далее нажимаем на кнопку «Sign up for an account», если у вас еще нет учетной записи Atlassian.

На следующем шаге необходимо указать: адрес электронной почты, имя, фамилию и пароль для создания учетной Atlassian.

Нажимаем на кнопку «Sign up».

Обратите внимание, вы получите письмо на указанный при регистрации адрес электронной почты. В письме вы найдете ссылку для завершения регистрации.

Если у вас уже есть учетная запись Atlassian, то в поле «Enter email» указываем адрес электронной почты, привязанной к учетной записи Atlassian, и нажимаем на кнопку «Continue».

Указываем пароль от учетной записи Atlassian и нажимаем на кнопку «Log in».

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

Нажимаем на кнопку «Generate License» для генерации временного лицензионного ключа для Jira.

Далее нужно подтвердить, что временный лицензионный ключ для Jira будет установлен на ваш сервер.

Нажимаем на кнопку «Yes».

В поле «Your License Key» вставляем ранее полученный временный лицензионный ключ и нажимаем на кнопку «Next».

На следующем шаге необходимо указать: имя, адрес электронной почты, логин и пароль для создания учетной записи администратора Jira.

Нажимаем на кнопку «Next».

На следующем шаге можно настроить отправку уведомлений.

В данном руководстве рассматривается установка Jira без настройки уведомлений.

Выбираем «Later» и нажимаем на кнопку «Finish».

Далее выбираем язык, на котором вы планируете использовать Jira, и нажимаем на кнопку “Next”.

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

Нажимаем на кнопку «Next».

На следующем шаге будет возможность выбрать из нескольких вариантов: загрузить демонстрационный проект, создать новый проект или импортировать данные из другой системы.

В данном руководстве рассматривается установка Jira без импорта каких-либо данных.

Нажимаем на кнопку «Create new project».

Выбираем желаемый тип проекта и нажимаем на кнопку «Next».

На следующем шаге будет показан workflow (графическое представление потока задач) для проекта.

Нажимаем на кнопку «Select».

В поле «Name» указываем имя проекта и нажимаем на кнопку «Submit».

Проект успешно создан.

Теперь можно зарегистрировать новую задачу в рамках этого проекта.

В поле «New Task» указываем краткое описание задачи и нажимаем на кнопку «Open in dialog».

В поле «Summary» указываем краткое описание задачи.

В поле «Reporter» указываем пользователя, который поставил задачу.

В поле «Due Date» можно указать крайний срок выполнения задачи.

В поле «Description» нужно указать полное описание задачи.

В поле «Assignee» можно указать специалиста ответсвенного за выполнение задачи.

В поле «Priority» можно указать приоритет задачи.

Нажимаем на кнопку «Create», чтобы создать задачу.

Задача успешно создана.

Автор

Привет, я Владимир Михалев, но друзья зовут меня Вальдемарыч. Я обладаю практическим опытом проектирования и сопровождения различных информационных систем. На моем веб-сайте ты найдешь подробные и понятные руководства по настройке ИТ-решений. Окунись в океан, полный позитива и технологий! По вопросам сотрудничества: callvaldemar@gmail.com

Добавить комментарий

Этот сайт использует Akismet для борьбы со спамом. Узнайте как обрабатываются ваши данные комментариев.