В круглых скобках приведены алиасы, в квадратных – необязательные параметры
Основные команды:
local_install (install) [PROJECT=name]
устанавливает все необходимые для ядра и текущего проекта порты (включает в себя выполнение local_build)
core_update (cup) [REV=revision]
обновляет исходные тексты ядра из репозитория
core_install (cin)
устанавливает рабочую копию ядра
project_update (pup) [PROJECT=name] [REV=revision]
обновляет исходные тексты текущего проекта из репозитория
project_install (pin) [PROJECT=name]
устанавливает рабочую копию текущего проекта, создает необходимые директории var/name/*
plugins_install (plin) [PROJECT=name]
устанавливает рабочие копии плагинов описанных параметром PLUGINS текущего проекта
project_rsync (prs) [PROJECT=name]
выкатывает статику (картинки, css, и т.д.) непосредственно на frontend посредством rsync.
требует:
установленного rsync (возможно из портов Contenido)
проектных переменных: RSYNC_SERVERS и RSYNC_DIRS (относительно RSYNC_ROOT=MASON_COMP)
настроенного rsyncd на RSYNC_SERVERS
plugins_commit (plci) [PROJECT=name] [PLUGIN=name]
коммитит исходные тексты плагинов текущего проекта (либо конкретного плагина)
plugins_status (plst) [PROJECT=name] [PLUGIN=name]
статус исходных тексты плагинов текущего проекта (либо конкретного плагина) относительно репозитория
plugins_update (plup) [PROJECT=name] [PLUGIN=name]
обновляет исходные тексты плагинов текущего проекта (либо конкретного плагина)
project_deinstall (pdi) [PROJECT=name]
останавливает текущий проект, удаляет рабочую копию текущего проекта, удаляет директории var/name/*
plugins_deinstall (pldi) [PROJECT=name]
удаляет рабочие копии плагинов описанных параметром PLUGINS текущего проекта
project_conf (conf) [PROJECT=name]
устанавливает рабочие конфиги для текущего проекта
создает State.pm для плагинов описанных параметром PLUGINS текущего проекта
генерит статику для текущего проекта (см. Генерация статики ).
инсталлирует crontab для данного хоста (хост определяется как результат `hostname`)
project_start (start) [PROJECT=name]
запускает рабочую копию текущего проекта
project_stop (stop) [PROJECT=name]
останавливает рабочую копию текущего проекта
project_reload (reload) [PROJECT=name]
последовательно выполняет операции:
project_stop, очистка кеша и скомпилированных компонент масона, project_update, project_install, plugins_update, plugins_install, project_conf, project_start
(предназначена для быстрой выкатки заведомо рабочей копии проекта из репозитория в рабочую копию)
project_refresh (refresh) [PROJECT=name]
последовательно выполняет операции:
project_stop, очистка кеша и скомпилированных компонент масона, project_start
project_create (create) [NAME=name]
создает шаблон нового проекта
Обратите внимание, используется параметр NAME, а не PROJECT
project_switch (switch, swi) [NAME=name]
переключает текущий проект на уже установленный проект name
plugin_create () [NAME=name]
создает шаблон нового плагина
pgsql_psql (psql) [PROJECT=name]
консоль psql с базой проекта (открывает psql shell к базе проекта (очень удобно чтобы не запоминать host/port/dbname/dbuser))
user [PROJECT=name]
интерактивно задает вопросы и создает пользователей редакторского интерфейса
Команды работы с git:
По умолчанию фреймворк настроен на работу с subversion. Для переключения на работу с git-репозитариями необходимо в конфиге проекта выставить параметр:
VCS_TYPE = git
Часть команд, используемых для работы с subversion, переключаются на работу с git. Также добавляются новые команды, специфические для организации gitflow. Вот полный список make-команд:
core_status (cst)
git status для файлов ядра.
core_update (cup)
git pull для файлов ядра.
core_commit (cci)
git commit -a для файлов ядра.
core_checkout (cco) BRANCH=branch_name
Переключение ядра на другую ветку (git checkout ${BRANCH}).
core_branch (cbranch) [NAME=branch_name] [DELETE=1] [FROM=from_branch]
Команда для работы с ветками ядра. При указании только NAME создает новую ветку (git checkout -b ${NAME}) на основе текущей и переключается на нее. При добавлении DELETE=1 удаляет ветку с название NAME=branch_name (git branch -d ${NAME}). При указании FROM=from_branch создает ветку на основе ветки FROM и переключается на нее (git checkout -b ${NAME} ${FROM}).
Без параметров показывает информацию о текущей ветке ядра (git branch -v)
core_merge (cmerge) BRANCH=branch_name
Слияние текущей ветви ядра с веткой BRANCH (git merge --no-ff ${BRANCH}).
core_push (cpush, cush)
git push для файлов ядра.
core_pull (cpull, cull)
git pull для файлов ядра.
project_status (pst)
git status для файлов проекта.
project_update (pup)
git pull для файлов проекта.
project_commit (pci)
git commit -a для файлов проекта.
project_checkout (pco) BRANCH=branch_name
Переключение проекта на другую ветку (git checkout ${BRANCH}).
project_branch (pbranch, branch) [NAME=branch_name] [DELETE=1] [FROM=from_branch]
Команда для работы с ветками проекта. При указании только NAME создает новую ветку (git checkout -b ${NAME}) на основе текущей и переключается на нее. При добавлении DELETE=1 удаляет ветку с название NAME=branch_name (git branch -d ${NAME}). При указании FROM=from_branch создает ветку на основе ветки FROM и переключается на нее (git checkout -b ${NAME} ${FROM}).
Без параметров показывает информацию о текущей ветке проекта (git branch -v)
project_merge (pmerge, merge) BRANCH=branch_name
Слияние текущей ветви проекта с веткой BRANCH (git merge --no-ff ${BRANCH}).
project_push (ppush, push)
git push для файлов проекта.
project_pull (ppull, pull)
git pull для файлов проекта.
plugins_commit (plci) [PLUGIN=plugin_name]
git commit -a для файлов всех плагинов. Выполняется последовательно для всех установленных плагинов или для конкретного плагина.
plugins_status (plst) [PLUGIN=plugin_name]
git status для файлов всех плагинов. Выполняется последовательно для всех установленных плагинов или для конкретного плагина.
plugins_update (plup) [PLUGIN=plugin_name]
git pull для файлов всех плагинов. Выполняется последовательно для всех установленных плагинов или для конкретного плагина.
plugins_checkout (plco) PLUGIN=plugin_name BRANCH=branch_name
Переключение плагина на другую ветку (git checkout ${BRANCH}).
plugins_branch (plbranch) PLUGIN=plugin_name [NAME=branch_name] [DELETE=1] [FROM=from_branch]
Команда для работы с ветками плагинов. При указании только NAME создает новую ветку (git checkout -b ${NAME}) на основе текущей и переключается на нее. При добавлении DELETE=1 удаляет ветку с название NAME=branch_name (git branch -d ${NAME}). При указании FROM=from_branch создает ветку на основе ветки FROM и переключается на нее (git checkout -b ${NAME} ${FROM}).
Без параметров показывает информацию о текущей ветке плагина (git branch -v)
plugins_merge (plmerge) PLUGIN=plugin_name BRANCH=branch_name
Слияние текущей ветви плагина с веткой BRANCH (git merge --no-ff ${BRANCH}).
plugins_push (plpush, plush) PLUGIN=plugin_name
git push для файлов плагина.
plugins_pull (plpull, plull) PLUGIN=plugin_name
git pull для файлов плагина.
Сервисные команды (при типовом использовании не требуются):
local_build (build)
собирает все необходимые для ядра и текущего проекта порты
apache_start [PROJECT=name]
запускает apache для текущего проекта
apache_stop [PROJECT=name]
останавливает apache для текущего проекта
apache_access_log (alog) [PROJECT=name]
делает tail -f access_log для текущего проекта
apache_pager_access_log (palog) [PROJECT=name]
делает less access_log для текущего проекта
apache_error_log (elog) [PROJECT=name]
делает tail -f error_log для текущего проекта
apache_pager_error_log (pelog) [PROJECT=name]
делает less error_log для текущего проекта
pgsql_start
запускает локальную базу данных (DB_TYPE=SINGLE)
pgsql_stop
останавливает локальную базу данных (DB_TYPE=SINGLE)
pgsql_init
создает новый кластер локальной базы данных (DB_TYPE=SINGLE)
pgsql_create [PROJECT=name]
создает новую локальную базу (DB_TYPE=SINGLE)
pgsql_template [PROJECT=name]
инициализирует новую стандартную локальную базу (DB_TYPE=SINGLE) (включает в себя выполнение pgsql_create)
pgsql_dump (dump) [PROJECT=name]
создает дамп базы данных текущего проекта (в var/projects/PROJECT/)
pgsql_dumpz (dumpz) [PROJECT=name]
создает архив (gz) дампа базы данных текущего проекта (в var/projects/PROJECT/)
core_status (cst)
сравнивает локальные исходные тексты ядра с состоянием репозитория
core_commit (cci)
коммитит локальные исходные тексты ядра в репозиторий
project_status (pst) [PROJECT=name]
сравнивает локальные исходные тексты текущего проекта с состоянием репозитория
project_commit (pci) [PROJECT=name]
коммитит локальные исходные тексты текущего проекта в репозиторий
project_backup (backup) [PROJECT=name]
создает архив (tgz) исходны текстов текущего проекта (в var/projects/PROJECT/)
Команды портов (при типовом использовании не требуются):
ports_*
команды портов
ports_* PORT=name
команды конкретного порта (команды порта)
