Содействие миграции

8-ядерный модуль «Migrate Drupal» в Drupal обеспечивает поддержку API для миграции с Drupal на Drupal, а «Migrate Drupal UI» предлагает простой пользовательский интерфейс для обновления со старых версий Drupal.

Обновления с Drupal 6 до Drupal 8 и Drupal 7 до Drupal 8 стабильны для одноязычных сайтов. Путь обновления для многоязычных сайтов еще не завершен. Обратитесь к разделу Обновление многоязычного Drupal 6 до Drupal 8 для получения краткой информации о многоязычных обновлениях Drupal 6 - Drupal 8 и мета-проблеме многоязычных миграций для получения списка многоязычных проблем миграции. Существует несколько способов обеспечения стабильности путей обновления D6-D8 и D7-D8.

Тщательно протестируйте обновление вашего сайта и сообщите о своих выводах

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

• Сначала проверьте, указана ли проблема в разделе Известные проблемы при обновлении с Drupal 6 или 7 до Drupal 8
• Если вашей проблемы нет в списке, найдите открытые проблемы миграции Drupal 6 - Drupal 8 или проблемы миграции Drupal 7 - Drupal 8.
• Если вы не нашли существующую проблему для проблемы, с которой сталкиваетесь, пожалуйста, создайте новую проблему в очереди проблем основной системы миграции. Сообщение о новой ошибке миграции уже является очень ценным вкладом и помогает обеспечить стабильность миграции!

При сообщении о новых проблемах они переходят на компонент «миграционная система». Чрезвычайно важно, чтобы вы предоставили как можно больше и как можно больше подробной информации.

• Пожалуйста, предоставьте скриншоты до (из Drupal 6/7) и после (Drupal 8), где это применимо.
• Опишите проблему как можно более конкретно.
• Укажите на своем сайте дополнительную информацию, которая, по вашему мнению, может иметь отношение к этой проблеме.
• Пример хорошего отчета о проблеме: https://www.drupal.org/node/2853872

                           - Краткое описание, скриншот и обозначения под скриншотом были созданы в оригинальном отчете о проблеме.
                           - Резюме проблемы было позже обновлено несколько раз, поскольку все больше и больше информации было найдено во время анализа.
                          - Обновление резюме проблемы является чрезвычайно важной частью процесса исправления. Иногда перенос ошибок может быть очень сложным, и обеспечение актуальности сводок по проблеме значительно поможет в миграции сопровождающих и других участников!
                          - Не стесняйтесь - мы постараемся написать как можно более подробный отчет об ошибках!

Помогите в тестировании patches

Если вы хотите помочь в тестировании миграционных исправлений, вам нужно настроить тестовую среду. Всегда применяйте патчи к последней версии Drupal 8 dev.

• Информацию об использовании git для применения исправлений см. В руководстве для разработчиков git patch.
• Для получения более общей информации о патчах см. Раздел «Патчи» Руководства по началу работы.

Помогите найти коренные причины проблем миграции

Если у вас есть немного больше опыта работы с Drupal и его моделью данных, вы, скорее всего, сможете помочь понять основные причины ошибок миграции. Поскольку мы говорим о миграции данных, самое главное, чтобы понять,

• Откуда берутся исходные данные в Drupal 6/7
• И где он должен идти в Drupal 8

Некоторые инструменты, которые помогут вам понять, откуда поступают данные

• Модуль Devel - отличный инструмент для проверки исходных данных в Drupal 6/7.
• phpMyAdmin или другой браузер базы данных помогут вам найти источник данных в Drupal 6/7.
• Если вы можете определить форму Drupal 6/7, в которой хранятся данные, но не можете найти данные из базы данных, вы всегда можете следовать указаниям, прочитав API. Откройте форму Drupal 6/7, в которой хранятся данные, скопируйте, вставьте поле и выполните поиск в Google

site:api.drupal.org <введите здесь то, что вы хотите найти>

Конфигурации миграции можно прочитать в Drupal 8 следующим образом

• admin/config/development/configuration/single/export
• Выберите «миграция» в качестве «Тип конфигурации»
• Выберите миграцию, которую вы хотите проверить

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

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

Миграции необходимо протестировать, чтобы тестовый бот действительно выполнял миграцию. При написании тестов для ваших миграций ядра с D6/D7 на D8 в качестве исходных данных используются фиксаторы базы данных, включенные в ядро ​​Drupal 8:

• core/modules/migrate_drupal/tests/fixtures/drupal6.php
• core/modules/migrate_drupal/tests/fixtures/drupal7.php
• Узнайте больше о перенастройке базы данных миграции

Фактические тесты обычно определяются в тестах ядра соответствующего модуля, например, в core/modules/comment/tests/src/Kernel/Migrate/d7