Подготовка сайта к обновлению до Drupal 8

Перед обновлением сайта Drupal 6 или Drupal 7 до Drupal 8 рекомендуется предпринять несколько шагов, чтобы убедиться, что процесс будет гладким и даст желаемые результаты.

В отличие от предыдущих основных обновлений ядра Drupal, процесс обновления Drupal 8 не обновляет исходный сайт на месте. Вместо этого объекты конфигурации и контента переносятся с исходного сайта на чистый сайт Drupal 8. Обратитесь к странице Обновление с Drupal 6 или 7 до Drupal 8 для обзора процесса и основных отличий.

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

Модуль инвентаризации исходного сайта

Важно понять, как строится ваш существующий сайт Drupal 6 или Drupal 7, прежде чем вы начнете обновление до Drupal 8.

Определите основные и дополнительные модули, которые включены на исходном сайте Drupal 6/7. Для этого вы можете просмотреть перечисленные модули на странице администрирования модулей («Администрирование»> «Создание сайта»> «Модули») или воспользоваться страницей «Доступные обновления» по адресу admin/reports/updates.

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

• Мне все еще нужен этот модуль на Drupal 8?
• Переведенный модуль перенесён в ядро Drupal 8? Например, Views теперь является частью ядра Drupal 8.
• Имеется ли в этом модуле версия для Drupal 8? Если нет, мне все еще нужно это? Есть ли другие модули, которые я мог бы использовать для достижения той же функциональности?
• Обратите внимание, что модули Drupal 6/7 не обязательно отображают один в один на модули Drupal 8. Например, модуль Block в Drupal 6 и 7 был разделен на модули Block и Custom Block в Drupal 8.

Веб-интерфейс обновления Drupal 8 показывает, какие модули могут быть обновлены автоматически, а какие нет. Обратитесь к Обновлению, используя страницу веб-браузера для получения дополнительной информации об этом анализе. Вы также можете попробовать модуль проверки обновления, который использует внешнюю службу, чтобы дать вам оценку времени для обновления.

Проверьте страницу известных проблем

Путь обновления с Drupal 6/7 до Drupal 8 все еще является экспериментальным, и некоторые основные модули могут не иметь полного пути обновления. При подготовке к обновлению рекомендуется прочитать страницу Известные проблемы.

Обновите свой сайт Drupal 6/7, чтобы использовать последние версии основных и добавленных модулей.

Процесс обновления предполагает, что вы сначала обновите свой старый сайт до последней минорной версии. Если ваш сайт работает, например, с ядром Drupal 6.35, вам необходимо сначала обновить его до 6.38.

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

Используйте страницу Доступные обновления вашего сайта Drupal 6/7 по адресу admin/reports/updates, чтобы узнать, есть ли доступные обновления.

Предварительные условия для перехода с Drupal 6/7 на Drupal 8

• Новая установка Drupal 8 с включенными основными модулями «Migrate» и «Migrate Drupal». Если вы переходите на Drupal 8 с помощью пользовательского интерфейса браузера, вам также необходимо включить основной модуль «Migrate Drupal UI»
• Для всех миграций перевода из модуля интернационализации Drupal 6 и Drupal 7 (i18n) потребуется, чтобы на сайте Drupal 8 был установлен многоязычный модуль Migrate Drupal (migrate_drupal_multilingual)
• Доступ к базе данных Drupal 6 или 7 с хоста, на котором находится ваш новый сайт Drupal 8.
• Доступ к файлам исходного сайта.

                         - Если используются только общедоступные файлы, они будут доступны через адрес сайта.
                         - Если нужно перенести личные файлы, каталог файлов должен быть напрямую доступен для нового сайта Drupal 8, и вы должны настроить путь file_private_path Drupal 8 в settings.php перед запуском обновления.

• Если вы переходите на Drupal 8 с использованием Drush, вам также понадобятся Drush 8 или Drush 9 и три дополнительных модуля.

                         - Инструкции по установке для Drush приведены на странице, указанной выше.
                         - Установить Migrate Tools
                         - Установить Migrate Upgrade
                         - Установить Migrate Plus
                         - Для получения дополнительной информации о модулях, перечисленных выше, пожалуйста, обратитесь к списку модулей обновления.
                         - ВАЖНО: Обратите особое внимание на совместимость версий модулей и используемой версии ядра Drupal 8. На страницах трех вышеперечисленных модулей четко указано, какую версию использовать.

Включение необходимых основных и вспомогательных модулей в Drupal 8

Процесс миграции не устанавливает автоматически модули на целевой сайт Drupal 8. Будут выполняться только миграции, относящиеся к модулям, установленным как на исходном, так и на целевом сайте. Поэтому сначала необходимо включить все основные и дополнительные модули на сайте Drupal 8, для которых вы хотите перенести конфигурацию и контент с исходного сайта.

Пара примеров:

• Если у вас включен модуль Addressfield на вашем исходном сайте Drupal 7 и вы хотите перенести адресные данные, вы должны включить модуль Address на своем сайте Drupal 8, прежде чем начинать процесс обновления. Это хороший пример, когда модули не отображают 1: 1 между Drupal 7 и Drupal 8. Однако модуль адреса D8 предоставляет плагины переноса, необходимые для переноса данных из поля адреса Drupal 7.
• Если на исходном сайте включен основной модуль форума Drupal 7, вы должны включить основной модуль форума на своем сайте Drupal 8, прежде чем начинать процесс обновления.

Не настраивайте сайт Drupal 8

Имейте в виду, что процесс обновления перезапишет конфигурацию на сайте Drupal 8, поэтому не выполняйте никаких настроек сайта Drupal 8 до тех пор, пока процесс обновления не будет завершен. Это означает, что вам не нужно создавать все типы контента и поля вручную перед запуском этого обновления. Модуль Migrate создаст их как часть процесса миграции. Фактически, наиболее распространенной практикой является установка Drupal 8 с использованием минимального профиля установки, поскольку стандартный профиль представляет собственную конфигурацию, которую вы, возможно, не захотите использовать. Это отличается от способа работы Migrate в Drupal 7 и более ранних версиях, где нужно было подготовить и подготовить все типы контента и поля перед запуском Migrate.

Не создавайте контент на сайте Drupal 8

Процесс обновления поддерживает уникальные идентификаторы с исходного сайта. Например, если учетная запись пользователя имела уникальный идентификатор 2 на исходном сайте (таким образом, находилась на относительном URI/user/2), после обновления та же учетная запись пользователя будет находиться в /user/2 на сайте Drupal 8. Если вы создадите учетную запись пользователя на сайте Drupal 8 за пределами учетной записи администратора по умолчанию, ей будет присвоен идентификатор пользователя 2 - тогда при запуске процесса обновления учетная запись с исходного сайта с идентификатором пользователя 2 перезапишет ее. Это относится к учетным записям пользователей, терминам таксономии и содержимому узла, а также практически ко всем другим видам контента с числовыми идентификаторами с исходного сайта.

Чтобы избежать потери данных, не создавайте вручную что-либо на сайте Drupal 8, пока весь исходный контент не будет полностью импортирован.

Выполнение обновления

У вас есть два варианта выполнения миграции:

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