�ݺ�ߣ

Делаем дистрибутивы
Почему, Зачем и Как?

Алексей Горобец
asgorobets

Обо мне
* Senior Drupal Developer @ Propeople
* 2 года в Drupal
* Трейнер
* Комьюнити лидер

O Propeople

http://wearepropeople.com

В зале у нас?
* Разработчики

* Сайт-билдеры

* Front-end разработчики

* Front-end разработчики
* Менеджеры проектов

На повестке дня
1. Что такое дистрибутив и зачем они
нужны?
2. В каких случаях стоит создавать свой
дистрибутив?
3. Как создать и поддерживать свой
дистрибутив

Немного фактов

По данным http://w3techs.com/

Чего же не хватает в Drupal?
* Листинг контента?
* WYSIWYG?
* Удобный интерфейс?
* Менеджемент медиа?
* Поле типа Date и Link?

Два типа пользователей

Все есть, только
надо настроить. Вот
тебе туториалы,
смотри как все
просто!

К черту ваш Drupal.
Неюзабельный и
сложный он!

Что такое дистрибутив?

Что такое дистрибутив?
Дистрибутивы предоставляют
упакованную версию ядра
Drupal с контриб модулями
предварительно настроенными
под определенный тип сайта.

Популярные дистрибутивы

Почему дистрибутивы
существуют?
Не изобретай колесо!

Почему дистрибутивы
существуют?
Наши услуги не всем по корману

Distribution vs Install Profile

Так вы хотите разработать
А стоит ли?
So You Guys Want to Build a Drupal Distribution
http://www.youtube.com/watch?v=ECrUuRGzuH0
http://prezi.com/k2d_x8eczfzu/so-you-want-to-build-a-drupal-distro/

Так вы хотите разработать

Может вам нужен Install Profile?
Distribution:

Install Profile:

* Брендированный продукт
* Решает определенный
юзкейс
* Является публичным
проектом и поддерживается
сообществом
* Фокус на конечного
пользователя (готов к
использованию)

* Предустанавливает модули
* Создает конфигурации
* Для внутреннего
использования
* Фокус на разработчика
(готов к началу разработки)

Или build base?

* У вас Continuous Integration?
* Распределенная команда разработчиков?
* Нужна стандартизация?
* Нужно автоматическое тестирование?
* Надоело повторяться?

С чего начать?
Install Profile
myprofile.info
myprofile.profile
myprofile.install

Install Profile
myprofile.info
name = My Profile
description = Description of what the profile does.
core = 7.x
dependencies[] = block
dependencies[] = color
dependencies[] = comment
dependencies[] = contextual
dependencies[] = dashboard
dependencies[] = help
dependencies[] = image
dependencies[] = list
dependencies[] = menu
dependencies[] = number
dependencies[] = options

Install Profile
myprofile.profile
То же что и .module для модулей. Здесь удобно
определять hook_install_tasks и подобные вещи
связанные с процессом инсталяции.

Install Profile
myprofile.install
<?php
/**
* Implement hook_install().
*
* Perform actions to set up the site for this profile.
*/
function profilename_install() {
include_once DRUPAL_ROOT . '/profiles/minimal/minimal.install';
minimal_install();
}
?>

Основные инструменты
Features

FAQ и подводные камни
* Как правильно упаковывать компоненты?
Не создавайте фичи по принципу общего типа
компонента. Гиганты вроде Acme Content Types,
или Acme Views зделают вашу систему сильнозависимой, их нельзя будет отключить, а
реорганизация покажется адом.
Организовывайте фичи по принципу независимого
функционала.
Например:
Blog, Gallery, Voting

* Как организовать фичи для реутилизации
полей
Нет необходимости дублировать поля общего
назначения. Создавайте общие поля указывая их
характеристики в имени поля.
Например:
field_file_single_public
Поле типа файл, принимающее единственное
значение, использует Public директорию.
field_link_single, field_content_ref,
field_body_no_summary

* Как избежать конфликтов с base fields
Все field_base полезно экспортировать в отдельную
фичу, а уже field_instance в фичу с контент тайпом.
Например:
Acme Base Fields - field_base:field_body
Acme Blog - field_instance:field_body
Acme Article - field_instance:field_body

* Как экспортить мои File Display в фичу если они
определяются в hook_default_COMPONENT?
Любую фичу можно переиспользовать экспортирую
только необходимые изменения с помошью
Features Override

* Как экспортить variables
Не волнуемся, на помошь приходит модуль
Strongarm

Features

Drush make

Простой Drush make
api = 2
; Core project
projects[drupal][version] = 7

; Modules
; -------projects[ctools][version] = 1.3
projects[ctools][type] = "module"
projects[libraries][version] = 2.1
projects[libraries][type] = "module"
projects[wysiwyg][version] = 2.2
projects[wysiwyg][type] = "module"
projects[views][version] = 3.7
projects[views][type] = "module"

Drush make для дистрибутива
Stub make
Подтягивает ядро Drupal и сам install profile.
Здесь есть одно преимущество - удобно подтягивать
несколько install profiles в вашем дистрибутиве.
Profile make
Подтягивает модули, темы, библиотеки, применяет
патчи

Stub make
distro.make
api = 2
core = 7.x

projects[drupal][type] = core
projects[drupal][version] = "7.23"
; This fixes multiple upload fields in gsb_media_center. http://drupal.org/node/1620030
projects[drupal][patch][1620030] = http://drupal.org/files/1620030-d7-2.patch
projects[drupal][patch][1702132] = http://drupal.org/files/drupal-7.14-ajax-showeffect-not-function1702132.patch
projects[drupal][patch][1783278] = https://drupal.org/files/schema-relative-1783278-7-D7-do-nottest.patch
projects[drupal][patch][1232416] = https://drupal.org/files/issues/autocomplete-1232416-17-7x.patch
; Add GSB Public Profile
projects[gsb_public][type] = profile
projects[gsb_public][download][type] = git
projects[gsb_public][download][url] = https://github.com/gsbitse/gsb_public.git
projects[gsb_public][download][branch] = 1.4

Profile make
profile.make
api = 2
core = 7.x
; Feature Flag
projects[feature_flag][type] = module
projects[feature_flag][download][type] = git
projects[feature_flag][download][url] = git@github.com:gsbitse/feature_flag.git
projects[feature_flag][download][tag] = 1.0
projects[feature_flag][subdir] = custom
; GSB Acquia Tokens
projects[gsb_acquia_tokens][type] = module
projects[gsb_acquia_tokens][download][type] = git
projects[gsb_acquia_tokens][download][url] = git@github.com:gsbitse/gsb_acquia_tokens.git
projects[gsb_acquia_tokens][download][tag] = 1.0
projects[gsb_acquia_tokens][subdir] = custom
etc...

Features

Drush make

Хуки

Обновления с hook_update_N()
/**
* Add a 'year' date format.
*/
function myprofile_update_7000() {
// Insert custom format: 2011
db_insert('date_formats')
->fields(array('format' => 'Y', 'type' => 'custom', 'locked' => 0))
->execute();
// Insert custom format: 2011
db_insert('date_format_type')
->fields(array('type' => 'year', 'title' => 'Year', 'locked' => 0))
->execute();
// Date Year Format
variable_set('date_format_year', 'Y');
}

Обновления с hook_update_N()
* Все обновления из hook_update_N также идут в
hook_install!
* Новые модули активируем в:
- dependencies (для первой инсталяции)
- hook_update_N при помощи module_enable

Билдим дистрибутив

drush make distro.make

Билдим дистрибутив

drush make distro.make

Drush make рекурсивно вызывает .make файлы из подтягиваемых
проектов! Таким образом запустив distro.make подтянются все
модули из profile.make и так далее.

Свой дистрибутив (варианты)
1. Начать с нуля
2. Использовать base distribution
3. Унаследовать дистрибутив

Подход “с нуля”
Преимущества
* Включай только то что нужно (гибкость)
Недостатки
* Изобретение велосипеда. Придется все
настраивать самим и экспортить в фичи, которые
потом поддерживать
* Дорого поддерживать контриб модули и следить
за их обновлениями

Подход “с базовой дистро”
* Готовые фичи из коробки
* Поддержка базовой дистрибутив сообществом
* Не все фичи нужны, что-то придется отключать, а
что-то переписыватьi
* Big Drupal, больше модулей, больше шансов что
всплывет баг

Представляем Panopoly

Дистро на базе Panopoly
Включить в profile.make фичи Panopoly:
projects[panopoly_core][version] = 1.0-rc5
projects[panopoly_core][subdir] = panopoly
projects[panopoly_core][patch][2087414] = https://drupal.org/files/issue-2087414.patch
projects[panopoly_images][version] = 1.0-rc5
projects[panopoly_images][subdir] = panopoly
projects[panopoly_theme][version] = 1.0-rc5
projects[panopoly_theme][subdir] = panopoly
projects[panopoly_magic][version] = 1.0-rc5
projects[panopoly_magic][subdir] = panopoly
projects[panopoly_widgets][version] = 1.0-rc5
projects[panopoly_widgets][subdir] = panopoly
projects[panopoly_admin][version] = 1.0-rc5
projects[panopoly_admin][subdir] = panopoly
projects[panopoly_users][version] = 1.0-rc5
projects[panopoly_users][subdir] = panopoly
; The Panopoly Toolset
projects[panopoly_pages][version] = 1.0-rc5
projects[panopoly_pages][subdir] = panopoly
projects[panopoly_wysiwyg][version] = 1.0-rc5
projects[panopoly_wysiwyg][subdir] = panopoly
projects[panopoly_search][version] = 1.0-rc5
projects[panopoly_search][subdir] = panopoly

Яркий пример

Попробуйте собрать свой GSB отсюда

Подход “наследование”
* Сканирует базовый инстал профайл на модули и
темы
* Возможность переписать родительский модуль
поместив этот же модуль в дочерний профайл
* Патчим ядро
* Пока никак нельзя унаследовать инсталл таски
родителя

Подход “наследование”
1. Ставим патч
Make install profiles inheritable
2. Указываем родителя в .info
base = BASE_PROFILE
3. Подробнее читаем
Inheriting your Drupal profile from an existing
distribution

К дальнейшему изучению?
* DrupalCon London 2011: BUILDING AND MAINTAINING A
DISTRIBUTION IN DRUPAL 7
* Kit specification
* Drush make
* Apps
Учимся по примеру:
https://github.com/Gizra/Garment-Box
https://github.com/gsbitse/gsb-distro

а также проекты на drupal.org

Создание дистрибутивов Drupal. Почему, зачем и как?

�ݺ�ߣ

Создание дистрибутивов Drupal. Почему, зачем и как?

Recommended

More Related Content

What's hot (17)

Viewers also liked (7)

Similar to Создание дистрибутивов Drupal. Почему, зачем и как? (20)

Создание дистрибутивов Drupal. Почему, зачем и как?