Создание промежуточных серверных сред для JIRA

Создание промежуточных серверных сред для JIRA

В этом документе описаны наилучшие методы настройки корпоративной среды для JIRA:

• Рекомендации по лучшей практике для процедурного управления при развертывании изменений
• Рекомендации для архитектуры разработки / постановки / производства
• Технические шаги по развертыванию непроизводственных серверов

Предположения:

• Для этого документа мы предполагаем, что в качестве администратора вы предпочтете сценарий изменений. Поэтому мы опустили изменения на основе UI (пользовательского интерфейса) или отдельных инструментов, таких как инструмент настройки базы данных, в целях указания местоположений файловой системы.

Обратите внимание:

• Процедуры, описанные в этом документе, будут работать с JIRA версии 4.0 и более поздними.
• Пожалуйста, прочитайте весь документ перед тем, как приступить к промежуточному серверу. Существуют риски, связанные с подключением к производственным экземплярам, требующим внимания, которые вызываются в документе.

1. Стратегия архитектуры

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

Определения

Для целей настоящего документа мы примем следующие определения:

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

Рекомендация

Если продукты Atlassian являются критическими системами, мы рекомендуем эту трехуровневую стратегию разработки, постановки и производства.

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

2. Стратегия управления

В дополнение к архитектуре мы также рекомендуем разработать стратегию управления изменениями. Это может включать:

• Создайте стратегию для развертывания и тестирования запросов (requests) установки плагина. Обратите внимание, что некоторые плагины, которые чрезвычайно полезны в некоторых средах, не подходят для критически важных систем большого объема.
• Опубликуйте график (временную шкалу) для обновления среды разработки, чтобы пользователи знали, когда нужно удалить их изменения.
• Настройте репозиторий управления версиями для изменения любых файловых систем, чтобы вы могли отслеживать, когда были сделаны изменения и кем, исторически. Если у вас нет одного уже установленного, Bitbucket - является вариантом. В дополнение к настройкам файловой системы запишите свои процедуры для обновлений, промежуточного обновления (см. ниже) и любых других сценариев изменений в вашем исходном элементе управления.

Совет. JIRA имеет инструмент для управления любыми изменениями в вашей установке. Проверьте страницу «Сведения о системе» в пользовательском интерфейсе для «измененных файлов». Это скажет вам, какие файлы были настроены в вашем каталоге установки.

• Для таких изменений, как создание новых рабочих процессов (для которых требуется административный доступ), у вас есть два варианта:

1. Создайте административного пользователя, который имеет временный доступ к административным функциям по запросу (per-request ). Добавьте этого пользователя в соответствующие группы, чтобы они могли выполнять необходимые административные функции. Когда пользователь выполнит свои административные функции, удалите пользователя из этих групп.
2. Держите сервер разработки без производственных данных и предоставляйте дополнительные административные привилегии на этом сервере. Требуйте от конечных пользователей документировать определенные рабочие процессы или схемы, а затем повторять эти шаги в процессе производства.
3. Как обновить промежуточный сервер

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

3.1 Создание полной резервной копии

1. Создайте резервную копию своего домашнего каталога. См. Раздел «Настройка домашнего каталога JIRA для местоположения домашнего каталога вашей продукции».

(предупреждение) Создайте резервные копии ваших производственных вложений и каталогов индексов, если они находятся вне вашего каталога JIRA Home. Если вы не знаете, где они хранятся, обратитесь к разделу «Настройка вложений файлов» и «Индексирование поиска», чтобы определить эти местоположения.

(info) Обратитесь к резервному копированию данных для получения дополнительной информации о резервном копировании вложений в JIRA.

2. Создайте резервную копию своего каталога установки. «Каталог установки JIRA» - это каталог, в который были загружены файлы и библиотеки приложений JIRA при установке JIRA.
3. Создайте резервную копию своей производственной базы данных. Используйте собственные средства резервного копирования, чтобы сделать снимок вашей производственной базы данных.

3.2 Скопируйте полную  резервную копию производства в промежуточную среду

1. Выключите свой промежуточный сервер.
2. Восстановите свои установочные и домашние каталоги на промежуточном сервере.
3. Направьте вновь восстановленный каталог установки на вновь восстановленный каталог JIRA Home.
   • Отредактируйте файл jira-application.properties, расположенный в подкаталоге <jira-application-dir> / WEB-INF / classes вашего нового каталога установки каталога JIRA.
   • Обновите свойство jira.home в этом файле на пути к новому каталогу JIRA Home Directory на путь вашего скопированного каталога JIRA Home.
   • Сохраните обновленный файл jira-application.properties.

(галочка) Вы также можете установить местоположение вашего домашнего каталога JIRA, указав переменную среды JIRA_HOME. Это значение этой переменной имеет приоритет над значением свойства jira.home в файле jira-application.properties в каталоге установки JIRA. Подробнее см. В разделе «Настройка домашнего каталога JIRA».

4. Восстановите базу данных в промежуточной базе данных.

(предупреждение) Если вы используете базу данных (названную, jiradb, например) с вашей существующей установкой JIRA, а база данных для вашей новой установки JIRA работает на том же компьютере или сервере базы данных, создайте новую базу данных с другим именем (например, что-то интуитивно понятное как jiradb_440 для JIRA 4.4.0). Oracle не поддерживает имена схем с периодами или символами подчеркивания. Убедитесь, что новая база данных имеет одинаковые права доступа к старой базе данных JIRA.

3.3. Изменение промежуточной среды для уникальных конфигураций

1. Настройте соединение с базой данных, чтобы указать на свою промежуточную базу данных. Отредактируйте файл dbconfig.xml в корневом каталоге вашего домашнего каталога JIRA или источник данных в <jira-install> /conf/server.xml для более старых версий.

(предупреждение) Это очень важно! Убедитесь, что ваша промежуточная среда не указывает на вашу производственную базу данных.

2. Существует два способа обработки электронной почты:
   • Отключите почту на промежуточном сервере. Если вам нужно выполнить некоторые начальные тесты на вашей новой установке JIRA, вы можете отключить его доступ к электронной почте, чтобы предотвратить отправку непреднамеренных писем. Вы можете оставить электронные письма, если хотите проверить функциональность электронной почты. Если вы решите активировать электронную почту, посмотрите, в частности, на:
     • Создавайте или комментируйте обработчики, которые могут извлекать почту с ваших рабочих почтовых серверов. Вы можете отключить их из «Администрирование»> «Дополнительно»> «Службы» (Administration > Advanced > Services) или удалить их из таблицы «serviceconfig» в базе данных.
     • Отфильтруйте подписки, так как ваши пользователи получат уведомления об фильтрах, на которые они подписаны. Удалите подписки на фильтрацию из таблицы «filtersubscription» в базе данных.
     • Уведомления о обновленных билетах. Для этого отделите любые схемы уведомлений на проекты, которые вы хотите протестировать без уведомлений по электронной почте.
   • Держите электронную почту включенной и настройте ваш промежуточный экземпляр для проверки электронной почты:

См. Руководство здесь: Как подготовить конфигурацию почты сервера разработки

3.4. Перезагрузите ваш промежуточный сервер.

Теперь вы готовы перезагрузить сервер. После перезапуска выполните следующие проверки, чтобы убедиться, что вы сделали эти шаги безопасно:

1. Убедитесь, что база данных не указывает на производство. Чтобы проверить это, см. Просмотр информации о вашей системе. Проверьте «URL-адрес базы данных», чтобы убедиться, что он указывает на нужное место.
2. Убедитесь, что сообщения электронной почты отключены или настроены для dev-сервера. Также при просмотре вашей системной информации проверьте «Аргументы ввода JVM» для строки «atlassian.mail.senddisabled». Если вы настроили адрес электронной почты для сервера dev, как описано выше, этой строки не будет.

3.5 Изменения после запуска

1. Измените цвета сайта. См. «Настройка внешнего вида и дизайна». Это хорошая практика для пользователей,которые могут определить что они находятся на промежуточном сервере.
2. Измените URL-адрес базы сайта. См. Раздел «Настройка параметров JIRA» и изменение URL-адреса сайта на промежуточном URL-адресе.
3. Рассмотрим белый список URL. Возможно, вы захотите изменить некоторые из утвержденных URL-адресов. См. Настройка белого списка.
4. Примените лицензию на разработку. Ознакомьтесь с нашим часто задаваемым вопросом о лицензировании, чтобы создать лицензию для промежуточного сервера. Обратитесь к разделу Обновление сведений о лицензии JIRA чтобы его применить.
5. Переконфигурируйте приложения. Если вы подключаетесь к другим серверам с помощью приложений, вам необходимо изменить идентификатор сервера для этих экземпляров.

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

• Confluence: как изменить идентификатор сервера Confluence
• JIRA: изменение идентификатора сервера для тестовых установок

6. Отключите интеграцию HipChat. Если у вас есть интеграция, которая уведомляет HipChat о любом из ваших рабочих процессов JIRA, вам необходимо удалить токен из конфигурации интеграции HipChat в Administration> Mail> HipChat Configuration, чтобы предотвратить отправку уведомлений HipChat из промежуточной среды.