Доклад Ивана Климчука на MODX Meetup Minsk 19 декабря 2015 года. Оригинальные слайды доступны по ссылке: http://alroniks.github.io/pres-mmm-gitify/

1. Gitify – швейцарский
нож для MODX-воина
Вооруженный до зубов Иван Климчук
1

2. Как делаются проекты на MODX?
• Х*к-х*к и в продакшн!
• Разработка в команде: waterfall, scrum, canban и тд.
• Длительная поддержка и развитие
2

3. 3

4. Решения
• Teleport
• Teleport
• SE Manager (умер)
• ElementHelper
• Cast (похоже тоже умер)
• и другие
4

5. Code review
5

6. Code review
• дешевый поиск ошибок
• сохранность качества кода
• непрерывный процесс обучения
• коммуникация внутри команды
6

7. 7
Git и GitHub

8. 8

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

10. 10

11. Историческая справка
• Первый коммит 1 июня 2014 года
• Анонс на MODX Weekend в сентябре 2014
• Документация на русском летом 2015
• 11 минорных версий, стабильная 1.0 на подходе
11

12. gitify init
Установка
Для начала нужно установить Composer – менеджер пакетов для PHP.
git clone https://github.com/modmore/Gitify.git gitify
cd gitify
compser install
chmod +x Gitify
Можно настроить alias в .bashrc или .bash_profile
01.
02.
03.
04.
05.
12

13. Настройка и конфигурация
Вся конфигурация сайта хранится в файле .gitify в формате YAML.
data_directory: _data/
data:
templates:
class: modTemplate
primary: templatename
extension: .html
01.
02.
03.
04.
05.
06.
13

14. Что может: build/extract
gitify extract
gitify build
gitify build --force
gitify build --skip-clear-cache
gitify build --force --no-backup
01.
02.
03.
04.
05.
14

15. Что может: backup/restore
gitify backup
gitify backup name
gitify restore
gitify restore name
gitify restore last
01.
02.
03.
04.
05.
15

16. Что может: modx:install и
modx:upgrade
gitify modx:install
gitify modx:install 2.4.2-pl
gitify modx:install latest
gitify modx:install --download
gitify modx:upgrade
gitify modx:upgrade --download
01.
02.
03.
04.
05.
06.
16

17. Что может: package:install
gitify package:install packagename
gitify package:install --all
gitify package:install --all --interactive
01.
02.
03.
17

18. Как быть с одинаковыми ID?
Объект, ID которого уже существует, временно сохраняется в памяти.
После полного завершения остальной сборки, включая очистку, gitify
пытается разрешить конфликт. В случае перемещения или
переименования объекта, после очистки "старый" объект будет удален,
а новый будет вставлен правильно. Если же конфликт на самом деле
есть, сохраненный в памяти объект будет вставлен с новым ID и для
него будет запущена команда gitify extract .
18

19. Автоочистка
Удаляются все ресурсы, которым на найдено соответствие в файлах.
Очистку в момент сборки можно отключить передав параметр --no-
cleanup .
19

20. Где применять?
• Работа над проектом из IDE + code review
• Работа над проектом в команде: N*dev, M*stage, production
• Установка и обновление MODX
• Установка и обновление пакетов
• Создание резервных копий через backup/restore или через git
20

21. 21
bit.ly/gitifydocs

22. 22
Demo

23. Планы по развитию
• Доработать управление пакетами: установка локальных, добавить
параметр --save, добавить сохранение в конфигурацию уже
установленных пакетов
• Доработать существующие функции и исправить баги
• Добавить работу со схемами БД для более аккуратной работы с
данными
• Улучшить документацию
23

24. Контакты
• iklimchuk – Twitter
• Alroniks – GitHub
• klimchuk.com
• ivan@klimchuk.com
alroniks
24

25. 25

26. 26
Вопросы?

27. Презентация
на GitHub