Задачи миграции¶

Задачи миграции — конкретный запуск сценария миграции на выбранных устройствах и/или группах. Задача миграции хранит ссылку на сценарий Миграции, набор устройств и групп для миграции, статус, лог исполнения и состояние миграции по каждому устройству

Подсказка

Страница «Задачи миграции» доступна только при использовании локального сервера Управление конфигурациями (UEM)

Как это работает¶

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

Жизненный цикл задачи миграции¶

Задача создаётся в статусе Новая
По действию Запустить/продолжить миграцию сервер:
- публикует целевой образ ОС, если он ещё не опубликован, и снимает с публикации остальные образы
- запоминает, какой образ был фактически опубликован для этой задачи (поле Опубликованный образ)
- формирует состояния миграции для каждого устройства из выбранных Устройства / Группы / Динамические группы
- переводит задачу в статус Запущена и ставит в очередь этапы миграции на каждом устройстве
Важно

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

Примечание

Несколько задач миграции могут выполняться параллельно — ограничение действует только на уровне отдельного устройства, не на уровне задач
По мере прохождения устройством этапов (Сбор данных → Сброс загрузчика → Установка ОС → Восстановление → Готово) обновляется его Состояние миграции устройства
Когда все устройства завершают миграцию, задача переходит в статус:
- Выполнено — все устройства успешно завершили этап Готово
- Ошибка — хотя бы одно устройство завершилось с ошибкой

Важно

Готовность мигрированного устройства к работе определяется только по статусу Готово соответствующего состояния миграции. До этого момента не рекомендуется использовать устройство — на нём ещё могут выполняться этапы восстановления и задачи UEM после миграции

Продолжение миграции после ошибки¶

Если на одном из устройств этап миграции завершился с ошибкой (статус Ошибка на вкладке Состояния миграции устройств), задачу не нужно создавать заново — миграцию можно продолжить с того этапа, на котором она прервалась

Устранить причину ошибки (см. Лог исполнения и Открыть лог устройства для конкретного устройства). Например — заполнить учётные данные администратора домена в миграции, восстановить сетевой доступ к устройству, исправить параметры PXE/DHCP
Нажать Запустить/продолжить миграцию. Сервер заново выполнит только тот этап, на котором возникла ошибка, на устройствах со статусом Ошибка. Этапы, успешно завершённые ранее (Успешно), повторно не запускаются. Устройства в статусе Готово пропускаются

Примечание

Полная перезагрузка сценария с этапа Сбор данных для конкретного устройства выполняется только через Сбросить миграцию — см. Запустить/продолжить миграцию vs Сбросить миграцию

Примечание

После миграции запись устройства на странице Устройства не дублируется — сохраняется та же запись, у которой меняется платформа с Windows на Linux

Запустить/продолжить миграцию vs Сбросить миграцию¶

Запустить/продолжить миграцию — основное действие. Запускает миграцию, а после ошибки — повторяет именно тот этап, на котором возникла ошибка. Устройства и этапы, уже завершённые с результатом Успешно, повторно не запускаются. Используется для штатного восстановления после ошибок (например, после заполнения учётных данных администратора домена)
Сбросить миграцию — вспомогательное действие. Удаляет состояния всех устройств, которые на момент сброса находятся в статусе Ошибка или Выполняется, и переводит задачу в статус Ошибка. После сброса последующий Запустить/продолжить миграцию начнёт миграцию для этих устройств заново с этапа Сбор данных. Действие предназначено для повторного прохождения сценария с начала, а не для штатного восстановления после ошибки

Примечание

Состояния устройств в статусе Успешно действие Сбросить миграцию не удаляет — повторно мигрировать уже мигрированное устройство в той же задаче не нужно

Важно

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

Поведение при недоступности устройства¶

Если устройство временно недоступно (Offline), оркестратор повторяет запуск плейбука миграции до 10 раз с интервалом 30 секунд. Если за это время устройство не появилось в сети, состояние миграции переходит в Ошибка. После того как устройство станет доступно, миграцию можно продолжить действием Запустить/продолжить миграцию

Описание страницы¶

На странице Задачи миграции отображено:

Кнопка Добавить Задачу миграции
Поле поиска
Таблица с возможностью настройки отображаемых столбцов

Добавление задачи миграции¶

При нажатии на кнопку Добавить Задачу миграции открывается страница задачи миграции. Поля сгруппированы по вкладкам

Основная информация¶

Доступные поля:

Название — пользовательское название задачи миграции
Миграция — выбор сценария из справочника Миграции

Устройства и группы¶

Доступные поля:

Устройства — конкретные устройства, на которые распространяется миграция
Группы — группы устройств, все участники которых будут включены в задачу
Динамические группы — динамические группы; принадлежность к ним вычисляется во время исполнения

Примечание

Кнопка Загрузить динамические группы обновляет состав динамических групп с учётом текущего окружения

Примечание

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

Важно

Перед запуском задачи миграции рекомендуется проверить:

в задаче заполнено хотя бы одно из полей Устройства, Группы или Динамические группы — иначе при старте задача завершится с ошибкой «В задаче не выбрано ни одного устройства»
в BIOS устройств включены Network Stack и PXE (см. Предварительные настройки устройства)
сетевые сервисы PXE/DHCP в локальной сети доступны и работают
в миграции заполнены учётные данные администратора домена — если на устройствах есть доменные пользователи. При отсутствии этих данных этап Восстановление завершится с ошибкой; в этом случае нужно дозаполнить миграцию и продолжить задачу действием Запустить/продолжить миграцию

Статус¶

Поля вкладки заполняются автоматически и доступны только для чтения

Статус — текущий статус задачи: Новая / Запущена / Выполнено / Ошибка
Запущено — дата и время старта задачи
Завершено — дата и время завершения задачи
Опубликованный образ — образ ОС, который был фактически опубликован при запуске данной задачи
Ошибка — текст последней ошибки задачи

Лог исполнения¶

Вкладка содержит онлайн-лог задачи миграции с группировкой сообщений по устройствам и этапам

В шапке лога устройства размещена ссылка Открыть лог устройства, переводящая на детальный журнал плейбуков для конкретного устройства. Сообщения с пометкой WARNING означают, что на этапе Сбор данных встретились предупреждения и миграция приостановлена — после анализа логов её можно продолжить или сбросить

Состояния миграции устройств¶

Вкладка отображает таблицу с одним рядом на каждое устройство задачи

Столбцы:

Устройство — исходная запись устройства до миграции
Стадия — этап, на котором сейчас находится устройство:
- Сбор данных
- Сброс загрузчика
- Установка ОС
- Восстановление
- Готово
Статус — статус выполнения текущего этапа: Ожидает / Выполняется / Успешно / Ошибка
Запущено / Завершено — временные метки этапа
Устройство после миграции — запись устройства, на которой выполняется этап Восстановление. В штатном сценарии указывает на ту же запись, что и Устройство. Заполняется автоматически после успешной установки Linux
UUID устройства — аппаратный UUID, считанный на стадии Сбор данных. Используется для сопоставления исходного устройства и устройства, которое отчиталось об окончании установки ОС
Местоположение данных — каталог на сервере RuDesktop, где хранятся собранные TAR-архивы и manifest.json для устройства
Ошибка — текст последней ошибки этапа

Меню действий¶

Меню действий расположено на всех вкладках страницы задачи миграции

Имеет следующие возможности:

Сохранить — сохраняет внесённые изменения и перенаправляет на страницу «Задачи миграции»
Сохранить и продолжить — сохраняет изменения и оставляет на странице редактирования
Удалить — удаляет задачу миграции
История изменений — показывает историю изменений задачи
Запустить/продолжить миграцию — запускает или возобновляет миграцию (см. Запустить/продолжить миграцию vs Сбросить миграцию)
Сбросить миграцию — сбрасывает состояния устройств в статусах Ошибка и Выполняется (см. Запустить/продолжить миграцию vs Сбросить миграцию). Доступно только когда задача в статусе Запущена или Ошибка

Поиск¶

В верхней части страницы доступно поле поиска. Поиск выполняется по названию задачи, названию миграции и названию целевого образа ОС

Для выполнения поиска необходимо ввести значение в поле и нажать на кнопку Найти

Таблица¶

Таблица разбита по столбцам:

Название — пользовательское название задачи миграции
Миграция — выбранный сценарий миграции
Статус — текущий статус: Новая / Запущена / Выполнено / Ошибка

Операции¶

При нажатии на кнопку с правого края таблицы открывается контекстное меню

Доступные действия:

Редактировать — откроет страницу задачи миграции
Удалить — удалит задачу миграции
История изменений — покажет историю изменений задачи
Запустить/продолжить миграцию — запустит или продолжит миграцию по выбранной задаче
Сбросить миграцию — сбросит состояния устройств в статусах Ошибка и Выполняется. Доступно только когда задача в статусе Запущена или Ошибка

Уведомления¶

Если для задачи миграции включены уведомления, сервер RuDesktop отправляет:

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

Уведомления отправляются по тем же каналам, что и остальные уведомления RuDesktop — Email, Telegram и т.п. Подробнее о настройке каналов и правил — на странице Уведомления