Перенос Keitaro 11

Начните с общего порядка переноса: он описывает подключение по SFTP, подтверждение сводки и перевод доменов. Здесь — особенности физической копии Keitaro 11.

Какая копия нужна

Мастер принимает полную завершённую физическую копию kctl backups от Keitaro 11.8.3 или 11.10.0, упакованную в один .tar или .tar.gz. Проверенные физические версии хранилищ: MariaDB 11.4.8 и ClickHouse 25.1.2.3. Другие схемы не считаются совместимыми только по номеру «11».

В корне архива должны находиться applied.env, маркер завершения .finished и каталоги копии:

• mariadb/var/lib/mysql/ — настройки и сущности;
• clickhouse/var/lib/clickhouse/ — история;
• tracker-admin/var/www/keitaro/var/sites/ — локальные страницы. Пустой каталог допустим, если локальных страниц действительно нет.

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

sudo tar -C /полный/путь/к/завершённой/копии -czf /root/keitaro11-full.tar.gz .
sudo chmod 600 /root/keitaro11-full.tar.gz

Архив содержит данные посетителей, страницы, настройки и секреты интеграций. Храните его в закрытом каталоге и передавайте на свой новый сервер по SSH/SFTP. Не публикуйте его по HTTP. Отдельный SQL-дамп, папка незавершённой копии и выгрузка старого формата kctl transfers dump не заменяют полную физическую копию Keitaro 11.

Перенос в мастере

1. Установите комплект с поддержкой Keitaro 11 на новый сервер. Укажите домены панели и трекинга; продолжайте настройку по HTTPS.
2. На шаге создания владельца откройте перенос из Keitaro. Укажите локальный путь к архиву либо скачайте его с вашего сервера через SFTP. При SFTP проверьте отпечаток ключа сервера.
3. Дождитесь подготовки. Micator создаёт отдельные копии баз, извлекает настройки и историю и проверяет их совместимость. Большая история может обрабатываться несколько часов; вкладку можно закрыть.
4. Выберите кампании с трафиком за 30, 60, 90 или 180 дней. Период отсчитывается от даты исходной копии. Мастер показывает число кампаний, страниц, объём и причины остановки отдельных потоков.
5. Укажите, как обрабатывать неподдерживаемое условие корпоративных сетей, разрешать ли PHP-офферам интернет и откуда Keitaro брал реферер. Не выбирайте ответ о реферере наугад: это меняет маршрутизацию трафика.
6. Проверьте сводку, введите «ПЕРЕНЕСТИ», задайте владельца Micator и завершите установку.
7. Дождитесь публикации конфигурации и проверки страниц. История за 90 суток UTC загружается отдельным фоновым заданием; её готовность проверяется отдельно от открытия панели. Выбранные выше 30–180 дней определяют набор кампаний, а не срок фоновой истории.

Для подготовки требуется Linux amd64 с Docker, минимум 12 ГиБ свободного места до начала. Это нижняя граница, а не оценка для любой копии: дополнительно нужны место под распакованные базы, промежуточную историю и страницы. Перед подтверждением мастер проверяет место под выбранные страницы и одну последующую резервную копию. Контейнеры временных баз ограничены 1 и 2 ГиБ памяти; контейнер подготовки истории — 2500 МиБ. Выбирайте сервер с запасом для обычных служб Micator.

Что сохраняется

• Кампании, потоки, источники, сети, домены, офферы и лендинги проходят те же проверки плана и совместимости страниц, что в переносе Keitaro 10.
• У клика сохраняются исходный subid, время, расход, привязки и поддерживаемые измерения. Переходы с лендинга учитываются отдельно.
• Конверсии сохраняют tid, время, выплату, сырой тип и собственные привязки к офферу, потоку и лендингу. Если конверсия относится к другому офферу, её доход не приписывается автоматически офферу исходного клика.
• Флаги типов Keitaro «учитывать конверсию» и «учитывать доход» действуют для импортированной истории независимо от канонического статуса Micator. Поэтому учитываемый Keitaro отклонённый тип не исчезает из количества конверсий, а учитываемый доход лида не обнуляется.
• Для поздних постбеков старых кликов сохраняется политика переходов исходных типов и направление изменения лимита оффера. Повтор того же события не создаёт вторую транзакцию или повторную отправку.
• Новые клики после переключения обрабатываются текущими правилами Micator. Политика исходного снимка относится к перенесённым кликам; её не следует считать глобальной настройкой нового трекера.

Загрузка истории не отправляет старые S2S/CAPI и не создаёт очередь их отправки. Проверка и повтор загрузки не должны добавлять дубли. Поздние настоящие постбеки обрабатываются отдельно после приёма и проверок.

Типы конверсий и ограничения

Автоматическое сопоставление системных типов:

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

Неизвестные пользовательские типы требуют явной политики сопоставления при предварительной подготовке; мастер не угадывает её. Конфликт с существующими алиасами или флагами Micator останавливает применение до записи конфигурации. Для первого переноса предпочтительна пустая установка.

Текущий путь принимает историю, где базовая валюта и переносимые денежные величины выражены в USD. Он не придумывает исторические курсы валют и отказывается от сумм, которые нельзя без изменения записать в формат Micator. Неизвестные типы, коллизии идентификаторов, неподдерживаемая схема или превышение защитных пределов означают отказ, а не частичный успешный перенос. Проверка ссылок и типов ограничена памятью; очень большие истории могут потребовать отдельной подготовки.

Не все функции Keitaro имеют эквивалент. Отсутствующая страница, неподдерживаемое условие или необходимость IP2Proxy показываются в сводке. До переключения DNS проверьте поток, лендинг, переход на оффер, формы и тестовый постбек. Код страниц исполняется в песочнице Micator; доступ к внутренней сети и данным трекера не выдаётся.

Отмена, повтор и диагностика

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

После загрузки история имеет отдельные состояния подготовки, загрузки и проверки. Повторить фоновую загрузку можно штатной командой:

sudo micatorctl keitaro-import --step status
sudo micatorctl keitaro-import --step tail

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