create-database-migration

Create a database migration to add a table, add columns to an existing table, add a setting, or otherwise change the schema of Ghost's MySQL database.

1. Przejdź do katalogu Ghost i utwórz nowy plik migracji za pomocą komendy cd ghost/core && yarn migrate:create <nazwa-w-kebab-case>. Nazwa musi być w formacie kebab-case, np. add-column-to-posts. Ważne: nigdy nie twórz pliku ręcznie — zawsze użyj tego skryptu, który automatycznie utworzy plik w odpowiedniej lokalizacji i zaktualizuje wersje pakietów.
2. Otwórz wygenerowany plik migracji i dodaj zmiany schematu, które chcesz wprowadzić. Kieruj się istniejącymi wzorcami w kodzie i używaj funkcji pomocniczych dostępnych w ghost/core/core/server/data/migrations/utils/*.
3. Zaktualizuj plik definicji schematu w ghost/core/core/server/data/schema/schema.js, upewniając się, że odzwierciedla najnowsze zmiany z migracji.
4. Przetestuj migrację ręcznie poleceniem yarn knex-migrator migrate --v {numer-wersji} --force, aby upewnić się, że działa poprawnie.
5. Jeśli dodajesz lub usuwasz tabelę, zaktualizuj plik ghost/core/core/server/data/exporter/table-lists.js zgodnie z potrzebami.
6. Uruchom test integralności schematu komendą yarn test:single test/unit/server/data/schema/integrity.test.js i zaktualizuj hash, a następnie wykonaj testy jednostkowe całego Ghost core poleceniem cd ghost/core && yarn test:unit, iterując aż do uzyskania pozytywnych wyników.