Инструкция
ВАЖНО! Перед обновлением на v5.8.x необходимо иметь версию Swarmica не ниже v5.7.x
Обновления важно выполнять последовательно: если версия Swarmica ниже v5.5.x, например, v5.3.x, то сначала нужно обновиться до v5.4.x, затем до v5.5.x, и так далее.
Подготовка
1. Для обновления проверьте, что в конфигурационном файле .env поставлена версия:
~# grep VERSION .env
SW_FRONTEND_VERSION=v5.8.0
SW_BACKEND_VERSION=v5.8.0
SW_HELPCENTER_VERSION=v5.8.0
2. Ознакомьтесь со статьей про фича-флаги и убедитесь, что вы заменили старые значения на новые или добавили отсутствующие в /root/swarmica/.env в переменной FEATURES:
| Старое значение (до 5.8.0) | Новое значение (начиная с 5.8.0) | Комментарий |
|---|---|---|
| article_comments | __article_comments | Стал нелицензируемым |
| csat_anytime | __csat_anytime | Стал нелицензируемым |
| sensitive_data | __sensitive_data | Стал нелицензируемым |
| __external_tickets | external_tickets | Стал лицензируемым |
| __automations | automations, automations_outgoing_emails,automations_outgoing_webhooks,automations_macros,automations_scripts | Стал лицензируемым + добавились отдельные флаги для каждого из видов автоматизаций |
| НЕ БЫЛО | api_keys | Теперь возможность создавать апи токены проверяется лицензией. Добавьте этот флаг, если используются интеграции с использованием API токенов |
| НЕ БЫЛО | issue_tracker | Теперь возможность подключать трекеры задач проверяется лицензией. Добавьте этот флаг, если используются интеграции с трекерами задач |
| НЕ БЫЛО | max | Появилась возможность интеграции с мессенджером MAX |
| webhooks | НЕ НУЖНО | Теперь при использовании интеграции с Mango Office или Beeline PBX не требуется отдельно прописывать флаг webhools. Его нужно удалить |
3. Ознакомьтесь с инструкцией подключения мессенджера MAX, если вы планируете подключить эту интеграцию
Обновление
Будет прерывание сервиса на несколько минут, рекомендуется выполнять обновление в часы, когда использование системы минимально
Выполните обновление с перезагрузкой системы:
docker compose pull
docker compose down
docker compose up -d
После обновления
После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:
1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:
docker exec --env-file .env -it swarmica-django-1 python manage.py post_start
Эта команда может занять долгое время, в зависимости от количества данных в системе.
2. Запустите команду, которая установит свойство locale для всех имеющихся тикетов в системе:
docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_ticket_locale
3. Запустите команду, чтобы установить порядок разделов базы знаний по умолчанию:
docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_articlecategory_order
4. Запустите команду, которая установит порядок продуктов на формах и в базе знаний по умолчанию:
docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_product_order
5. Запустите команду, которая сделает связь тикетов двусторонней:
docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_related_tickets
6. Запустите команду, которая подготовит данные событий для использования в автоматизациях:
docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_event_value_data
7. Запустите очистку неиспользуемых данных:
docker system prune -a
ВАЖНО! Убедитесь, что все контейнеры успешно запустились, перед запуском этой команды
✨ Основные улучшения
💬 🅿️ Добавили возможность подключать мессенджер MAX как канал
💅 Добавили визуальный конструктор для макросов
👨🔧 Упростили создание сложных автоматизаций
🤌 Сделали клонирование правил автоназначения, чтобы экономить время на создании похожих правил
🪢 Сделали двустороннюю прозрачную связь заявок
🌎 Добавили возможность менять язык, на котором идет общение в заявке
🧩 Теперь можно задавать произвольный порядок для разделов базы знаний и продуктов
💆♀️ Добавили информации о запусках периодических задач и визуальный редактор условий
📊 Расширили и углубили возможности для создания произвольных отчетов
🔧 Исправленные ошибки
🎨 Исправлены проблемы с видео в статьях, копированием кода, таблицами, курсором и dropdown’ами.
📊 Починено отображение локалей, дат, кастомных полей в сводных отчетах. Улучшена производительность страницы отчётов.
🧾 Исправлены ошибки создания SLA, работы относительных дат в QA и массового редактирования. Корректно отображаются логические значения в событиях.
💬 Исправлена обработка CSAT в мессенджерах. Предотвращено создание пустых комментариев.
🧑💼 Исправлены ошибки с локалями и параллельным сохранением кастомных полей. Уточнены ограничения ролей.
⚙️ Улучшена работа кэша, логирования SLA и автоматизаций. Обновлены зависимости и закрыты потенциальные уязвимости.
🧩 Исправлено отображение CSAT, вложений и навигации в чатах.