andreyryabin/sprint.migration

bitrix migration module

Installs: 10 213

Dependents: 1

Suggesters: 0

Stars: 46

Watchers: 9

Forks: 17

Open Issues: 1

Type:bitrix-module


README

Помогает синхронизировать изменения между нескольким копиями базы данных

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

Работать можно как через консоль, так и через админку.

Установка через composer

Пример вашего composer.json с установкой модуля в local/modules/

{
  "extra": {
    "installer-paths": {
      "local/modules/{$name}/": ["type:bitrix-module"]
    }
  },
  "require": {
    "andreyryabin/sprint.migration": "dev-master"
  },
}

Консоль

Для работы через консоль используется скрипт /bitrix/modules/sprint.migration/tools/migrate.php

Можно запускать его напрямую или сделать алиас, создав файл в корне проекта, bin/migrate и прописав в нем:

#!/usr/bin/env php
<?php

$_SERVER['DOCUMENT_ROOT'] = dirname(__DIR__);
require_once $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/sprint.migration/tools/migrate.php';

Примеры команд

  • php bin/migrate add (создать новую миграцию)
  • php bin/migrate ls (показать список миграций )
  • php bin/migrate up (накатить все миграции)
  • php bin/migrate up [version] (накатить выбранную миграцию)
  • php bin/migrate down (откатить все миграции)
  • php bin/migrate down [version] (откатить выбранную миграцию)

Все команды: https://github.com/andreyryabin/sprint.migration/blob/master/commands.txt

Тегирование миграций

При установке новых миграций их можно пометить произвольным тегом: php bin/migrate up --add-tag=release001

Это бывает удобно в случае отката релиза, когда требуется вернуть его в начальное состояние, при условии что написан код отката

Откат миграций по тегу: php bin/migrate down --tag=release001

Скриншоты

админка