Jira Automation · Cloud

Перенос Jira Automation между Cloud-сайтами: проверяем правило до включения

Как перенести правило через JSON, сопоставить проекты, поля и исполнителя, провести пилот и остановить неудачное изменение.

Применимость: Cloud. Названия пунктов и доступность функций зависят от версии, плана и типа проекта. Проверяйте изменения на тестовом окружении. Описанные рабочие процедуры — предлагаемый подход, а не гарантии поставщика.

Задача и границы применения

Команда переносит одно рабочее правило Jira Automation на другой Cloud-сайт. Например, после изменения приоритета задача должна получить служебную метку. Простое копирование настроек недостаточно: одинаковые названия проектов и полей не означают одинаковые идентификаторы. Цель пилота — получить одно ожидаемое изменение в выбранном проекте, не затронув остальные задачи. Это учебный сценарий, а не описание выполненной миграции клиента.

Руководство относится к Jira Cloud, где сервис обновляется без фиксированной устанавливаемой версии. Названия Automation flows и Automation rules могут различаться в интерфейсе. Для Data Center проверяйте документацию своей версии отдельно. JSON не следует считать полной резервной копией сайта или универсальным инструментом объединения нескольких инсталляций: процедура экспорта и импорта не поддерживает схемы миграции один ко многим и многие к одному.

Подготовьте доступ и контрольный сценарий

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

Составьте таблицу соответствий: исходный проект — целевой проект; исходное поле — целевое поле; статус — статус; тип задачи — тип задачи; исполнитель — исполнитель. Для каждого действия укажите необходимое право. Если правило отправляет веб-запросы или уведомления, заранее предусмотрите тестовый получатель и безопасный адрес. Экспорт храните в закрытом каталоге: в конфигурации могут быть внутренние адреса и сведения о бизнес-процессах.

Экспортируйте и импортируйте выбранное правило

На исходном сайте откройте Jira settings, затем System и Automation flows. В меню дополнительных действий выберите Export flows. Сохраните JSON и отдельный список правил, которые действительно нужны для переноса. Не публикуйте экспорт в открытом репозитории. Импортируемый файл должен быть не больше 5 МБ; для большого набора используйте документированное разбиение экспорта, а не произвольное обрезание JSON.

На целевом сайте откройте тот же раздел и выберите Import flows. Загрузите файл, отметьте только пилотное правило и назначьте узкую область действия. При переносе владельцев проверьте наличие соответствующих пользователей. Если перенос владельцев не выбран, владельцем станет импортирующий пользователь. Импортированные правила изначально выключены. Сохраните это состояние до проверки настроек. При совпадении имени Jira добавляет префикс Copy of; он не означает, что старая версия была заменена.

Исправьте зависимости до запуска

Откройте импортированное правило и последовательно проверьте триггер, условия, ветки и действия. Повторно выберите целевой проект, поле и статус в интерфейсе. Просмотрите JQL, ссылки на доски, идентификаторы пользователей и внешние адреса. Не заменяйте все числа в JSON глобальным поиском: одно и то же число может иметь разное назначение. Если настройка недоступна, выясните её смысл на исходном сайте и только затем подберите соответствие.

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

Проведите пилот с положительной и отрицательной проверкой

Временно ограничьте условие ключом тестовой задачи. Включите только пилотное правило и выполните событие, предусмотренное его триггером. Откройте журнал исполнения и историю задачи. Сопоставьте время, исполнителя и изменение поля. Ожидаемый результат: журнал содержит нужное действие, а в истории появилась только согласованная метка. Запишите фактический результат; описанные проверки являются рекомендацией, здесь они не выполнялись в пользовательской Jira.

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

Разберите типовые ошибки

Если правило не включается с ошибкой недоступного проекта, повторно выберите проект и проверьте право просмотра у исполнителя. Для ошибки доступа к доске проверьте саму доску и доступность её фильтра. Если действие не меняет поле, проверьте контекст поля и права исполнителя на целевой задаче. Исправление одного идентификатора не заменяет повторную проверку всех компонентов: зависимость может встречаться в нескольких ветках.

Если число экспортированных правил меньше ожидаемого, сначала проверьте системные правила Jira Service Management. Некоторые встроенные правила не экспортируются; Atlassian рекомендует искать их по метке System rule. Зафиксируйте такие исключения в реестре переноса. Не создавайте вручную копию встроенного поведения без проверки: это может привести к повторным действиям рядом с системным правилом. Сверяйте не только количество, но и назначение каждой перенесённой автоматизации.

Откат и передача в сопровождение

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

Исходное рабочее правило сохраняйте до завершения приёмки, при этом не допускайте двух параллельных исполнителей одного внешнего процесса. В реестре укажите владельца, область действия, сопоставления, результат пилота и способ остановки. Экспорт можно использовать как материал для сравнения конфигурации, но он не восстанавливает автоматически права, подключения и данные. Завершайте перенос только после подтверждения фактического поведения и согласования дальнейшего сопровождения.

Официальная документация

Применить это к вашей системе

Обсудим контекст, ограничения и безопасный порядок изменений.

Обсудить задачу