Миграция сайта с одной CMS на другую

Миграция сайта с одной CMS на другую

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

Типичные пути миграции

Инструменты экспорта

WordPress — встроенный XML Export или WP-CLI:

wp export --post_type=post,page,product --dir=/tmp/wp-export/

Drupal — Migrate API или CSV-экспорт:

drush migrate-import --all

Contentful — CMA SDK:

contentful space export --space-id $SPACE_ID --export-dir ./backup

Ghost — Ghost Admin → Settings → Export → Export your content (JSON).

Strapi — кастомный скрипт через REST API.

Трансформационный скрипт

Паттерн ETL (Extract → Transform → Load):

// scripts/cms-migration.ts
interface MigrationConfig {
  source: 'wordpress' | 'contentful' | 'ghost';
  target: 'strapi' | 'contentful' | 'sanity';
  contentTypes: ContentTypeMapping[];
}

async function migrate(config: MigrationConfig) {
  const extractor = getExtractor(config.source);
  const transformer = getTransformer(config.source, config.target);
  const loader = getLoader(config.target);

  for (const mapping of config.contentTypes) {
    console.log(`Migrating: ${mapping.sourceName} → ${mapping.targetName}`);

    // Extract
    const items = await extractor.extract(mapping.sourceName);

    // Transform
    const transformed = items.map(item => transformer.transform(item, mapping));

    // Load (с батчингом)
    for (const batch of chunk(transformed, 50)) {
      await loader.load(mapping.targetName, batch);
      await delay(500);
    }
  }
}

Миграция Rich Text

Самая сложная часть — трансформация форматов Rich Text:

// WordPress HTML → Portable Text (Sanity)
import { htmlToPortableText } from '@portabletext/html';

function transformWpContent(html: string) {
  return htmlToPortableText(html, {
    rules: [
      {
        deserialize(el, next, block) {
          if (el.tagName === 'IMG') {
            return block({
              _type: 'image',
              _key: Math.random().toString(36).slice(2),
              src: el.getAttribute('src'),
              alt: el.getAttribute('alt'),
            });
          }
        },
      },
    ],
  });
}

URL Redirect Mapping

После миграции обязательно настраиваем 301-редиректы:

// Генерируем маппинг старых → новых URL
const redirects = oldPosts.map(old => ({
  source:      old.url,
  destination: newPosts.find(n => n.slug === old.slug)?.url ?? '/blog',
  permanent:   true,
}));

// next.config.ts
async redirects() {
  return redirects;
},

Миграция между двумя headless CMS (1000–5000 записей) — 2–4 недели.