{{:config:warning.png?nolink&16x16|Внимание}}**Внимание:** данная страница **не** является частью официальной документации.

====== Создание своего RPM-пакета (на примере CentOS 5.4) ======

В корпоративном секторе установка программ вручную крайне нежелательна, вместо этого создают пакет для текущей системы и с его помощью уже устанавливают, обновляют и удаляют нужное ПО.

В данной статье [[user>ladserg|я]] приведу пример, как создать свой RPM-пакет для «ДокуВики», в котором определены все необходимые зависимости и начальные настройки. Задача пакета будет состоять в установке ПО, настройке веб-сервера Apache, настройке прав доступа, при желании можно добавить и базовые настройки «ДокуВики». Устанавливать «ДокуВики» по умолчанию будем в каталог ''/opt/dokuwiki''.

===== Отказ от ответственности =====

Предупрежу сразу, во-первых, я в данном вопросе новичок и если кому есть что-то поправить или добавить, то просто добавьте или поправьте. Во-вторых, информацию данной статьи вы используете на свой страх и риск, я не несу ответственность за любой ущерб или урон который вы причините себе и други следуя моим инструкция. --- //[[ladserg@mail.ru|ladserg]] 2010/05/12 05:50//

===== Установка и настройка rpm-build =====

Я не буду подробно описывать технологию создания RPM-пакетов, в сети есть немало руководств на данную тему, написанных умными людьми. Здесь я просто приведу шаги, которые достаточны для того, чтобы начать создавать свои пакеты.

Для начала установите пакет rpm-build, запустив в сеансе root’а команду:

  # yum install rpm-build

Зайдите в систему под своим постоянным пользователем, который не имеет привелегированных прав. Допустим его имя: ''user''.

Создадим нужные каталоги и поределим нужный макрос:

  $ mkdir -p ~/workspace/redhat/{RPMS,SRPMS,SPECS,SOURCES,BUILD}
  $ echo '%_topdir /home/user/workspace/redhat' > ~/.rpmmacros

Всё, теперь можно приступать созданию пакета.

===== Подготовка исходников =====

Подготовим исходники для нашего пакета, для этого сначала загрузим в каталог ресурсов:

  $ cd ~/workspace/redhat/SOURCES/
  $ wget -c http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2009-12-25c.tgz

Тут же создадим файл настройки каталога для сервера Apache, скажем ''~/workspace/redhat/SOURCES/dokuwiki.conf'', следующего содержания:

<file>
Alias /dokuwiki/ "/opt/dokuwiki/"

<Directory "/opt/dokuwiki/">
    AllowOverride None
    Order allow,deny
    Allow from all
    # Если кому не нужна настройка переопределения адресации,
    # то закоментируйте следующий блок
    <IfModule rewrite_module>
        RewriteEngine on
        RewriteBase /dokuwiki
        RewriteRule ^_media/(.*)              lib/exe/fetch.php?media=$1  [QSA,L]
        RewriteRule ^_detail/(.*)             lib/exe/detail.php?media=$1  [QSA,L]
        RewriteRule ^_export/([^/]+)/(.*)     doku.php?do=export_$1&id=$2  [QSA,L]
        RewriteRule ^$                        doku.php  [L]
        RewriteCond %{REQUEST_FILENAME}       !-f
        RewriteCond %{REQUEST_FILENAME}       !-d
        RewriteRule (.*)                      doku.php?id=$1  [QSA,L]
        RewriteRule ^index.php$               doku.php
    </IfModule>
</Directory>
</file>

На этом пока остановимся.

===== Подготовка SPEC-файла ===== 

В каталоге ''~/workspace/redhat/SPECS/'' создадим файл ''dokuwiki-2009-12-25c.spec'' со следующим содержанием:

<file>
Name:         dokuwiki
Version:      20091225c
Release:      1
Summary:      DokuWiki is a simple to use Wiki aimed at the documentation needs of a small company.
Summary(ru):  «ДокуВики» — это лёгкая в использовании вики, предназначенная для создания разного рода документации.
Group:        Applications/Editors
License:      GPL2
Source0:      http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2009-12-25c.tgz
Source1:      dokuwiki.conf
BuildArch:    noarch
BuildRoot:    %{_tmppath}/dokuwiki-root
URL:          http://www.dokuwiki.org/
Packager:     My name <my@email.dom>
Requires:     httpd php php-common php-gd php-xml php-xmlrpc
Autoreqprov:  no

%description
DokuWiki is a standards compliant, simple to use Wiki, mainly aimed at creating
documentation of any kind. It is targeted at developer teams, workgroups and
small companies. It has a simple but powerful syntax which makes sure the
datafiles remain readable outside the Wiki and eases the creation of structured
texts. All data is stored in plain text files – no database is required.

%description -l ru
«ДокуВики» — это совместимая со стандартами и лёгкая в использовании вики, предназначенная в первую очередь для создания разного рода документации. Она
ориентирована на команды разработчиков, рабочие группы и небольшие компании.
Все данные хранятся в простых текстовых файлах, поэтому дя работы не требуется
СУБД. Простой, но мощный синтаксис облегчает создание структурированных
текстов и позволяет при необходимости читать файлы данных даже за пределами
вики.


%prep
#%setup -q -n %{name}-%{version}
%setup -q -T -b 0 -n %{name}-2009-12-25

%build
mv .htaccess.dist .htaccess

%install
mkdir -p $RPM_BUILD_ROOT/opt/dokuwiki
cp -r . $RPM_BUILD_ROOT/opt/dokuwiki

mkdir -p $RPM_BUILD_ROOT/etc/httpd/conf.d
cp %SOURCE1 $RPM_BUILD_ROOT/etc/httpd/conf.d/

%files
%defattr(-,apache,apache)
/opt/dokuwiki
%config(noreplace) /etc/httpd/conf.d/dokuwiki.conf

%clean
rm -rf $RPM_BUILD_ROOT
</file>

Обратите внимание на кострукции «''Summary(ru)''» и «''%description -l ru''», аналогичным образом вы можете определить краткое и полное описание для других языков.

В кратце о том, что делает RPM-пакет, определённый данным SPEC-файлом: создаёт каталог ''/opt/dokuwiki'', копирует туда содержимое официального архива, где файл ''.htaccess.dist'' уже переименован в ''.htaccess''. Так же подбросит веб-серверу Apache файл с настройками каталога нашей вики (в CentOS по умолчанию Apache добавляет к конфигурации все файлы ''/etc/httpd/conf.d/*.conf'', если вы отключили эту возможность или настроили виртуальные домены, то вам придётся изменить и этот пункт подключения каталога).

Обратите внимание на аргумент ''noreplace'' у макроса ''%config'', он означает, что данный конфигурационный файл не будет перезаписываться, если он существует.

===== Генерация RPM-пакета =====

Просто выполните команду:

  $ rpmbuild -ba ~/workspace/redhat/SPECS/dokuwiki-2009-12-25c.spec

Если нигде нет никаких ошибок, то в каталоге ''~/workspace/redhat/SRPMS/'' обнаружите файл ''dokuwiki-20091225c-1.src.rpm'', а в каталоге ''~/workspace/redhat/RPMS/noarch/'' будет находиться наш RPM-пакет ''dokuwiki-20091225c-1.noarch.rpm'', в котором уже определены минимально нужные зависимости.

===== RPM-пакет с предопределёнными настройками «ДокуВики» =====

Лень --- двигатель прогресса, чтобы не запускать постоянно ''install.php'', я определил начальные установки для «ДокуВики» и включил их в свой RPM-файл. Начальные настройки у меня таковы: 

  имя суперпользователя:           admin
  пароль суперпользователя:        admin
  стартовая страница:              index.html
  название вики:                   Wiki
  Язык:                            ru
  лицензия содержимого:            GNU Free Documentation License 1.2
  уровень доступа:                 Зарегистрированным - правка, незарегестрированным - только чтение.
  Заблокировать операции «ДокуВики»: Зарегистрироваться
  Удобочитаемые адреса (URL):      .htaccess
  Использовать слэш:               true

И т. д. по мелочи то, что можно в дальнейшем переопределить.

Далее я в каталог ''~/workspace/redhat/SOURCES/'' добавил следующие файлы:

''acl.auth.php'':
<file>
*               @ALL          1
*               @user         8
</file>

''local.php'':
<file>
<?php
$conf['title'] = 'Wiki';
$conf['start'] = 'index.html';
$conf['lang'] = 'ru';
$conf['license'] = 'gnufdl';
$conf['camelcase'] = 1;
$conf['useacl'] = 1;
$conf['superuser'] = '@admin';
$conf['disableactions'] = 'register';
$conf['sneaky_index'] = 1;
$conf['xmlrpc'] = 1;
$conf['subscribers'] = 1;
$conf['updatecheck'] = 0;
$conf['userewrite'] = '1';
$conf['useslash'] = 1;
$conf['gzip_output'] = 1;
$conf['compression'] = 'bz2';
</file>

''users.auth.php'':
<file>
admin:$1$22b1d2a6$IB1a/6hAXJlKAORCDX7hV0:Admin User:postmaster@localhost:admin,user
</file>

В SPEC-файле в секции глобальных переменных определил:
<file>
Source2:      acl.auth.php
Source3:      local.php
Source4:      users.auth.php
</file>

В секции ''%build'' добавил следующее:
<file>
rm -f install.php

mkdir -p $RPM_BUILD_ROOT/opt/dokuwiki/conf
cp %SOURCE2 $RPM_BUILD_ROOT/opt/dokuwiki/conf/
cp %SOURCE3 $RPM_BUILD_ROOT/opt/dokuwiki/conf/
cp %SOURCE4 $RPM_BUILD_ROOT/opt/dokuwiki/conf/
</file>

В секции ''%files'':
<file>
%config(noreplace) /opt/dokuwiki/conf/acl.auth.php
%config(noreplace) /opt/dokuwiki/conf/local.php
%config(noreplace) /opt/dokuwiki/conf/users.auth.php
</file>

И пересобрал пакет:

  rpmbuild -ba /home/slad/workspace/redhat/SPECS/dokuwiki-2009-12-25c.spec

===== Добавление страниц вики в RPM-пакет ===== 

Вики с нуля --- это всегда грустно, желающим добавить в RPM-пакет страницу по умолчанию, свои статьи, или просто более подробную документацию по «ДокуВики» достаточно создать нужные страницы с форматированием «ДокуВики» в виде файлов с расширением «txt» и настроить SPEC-файл на копирование данных файлов в соответсвующие подкаталоги каталога ''/opt/dokuwiki/data/pages/''.

Приведу пример добавления свой страницы по умолчанию (у меня это ''index.html''). Итак, в каталоге ''~/workspace/redhat/SOURCES'' создадим файл ''index.html.txt'', с нужным вам содержанием, например:
<file>
Welcome to [[wiki:dokuwiki|DokuWiki]].
</file>

В SPEC-файле определим глобальную переменную:
<file>
Source5:      index.html.txt
</file>

В секцию ''%build'' добавим создание нужного каталога и копирование туда файла:

<file>
mkdir -p $RPM_BUILD_ROOT/opt/dokuwiki/data/pages/
cp %SOURCE5 $RPM_BUILD_ROOT/opt/dokuwiki/data/pages/
</file>

И определим наш файл в секции ''%files'':
<file>
%config(noreplace) /opt/dokuwiki/data/pages/index.html.txt
</file>

И пересоберём наш пакет:

  $ rpmbuild -ba /home/slad/workspace/redhat/SPECS/dokuwiki-2009-12-25c.spec

Главное, при добавлении своих страниц в пакет указать, что они не должны перезаписываться, вы же не желаете восстанавливать при каждом обновлении стартовую страницу?

===== Добавление медиафайлов вики (картинок, звуков, видео) в RPM-пакет =====

Здесь всё тоже очень просто, всё абсолютно как в разделе [[#Добавление страниц вики в RPM-пакет]], только целевой каталог другой: ''/opt/dokuwiki/data/media/''.

===== Пример RPM-пакета с плагином для «ДокуВики» =====

Ну раз вы установили «ДокуВики» из RPM-пакета, то не марать же теперь руки ручной установкой плагинов к «ДокуВики», приведу пример SPEC-файла для плагина [[https://www.dokuwiki.org/plugin:include|include]], который я создавал для себя и на базе которого вы сможете создать свой RPM-пакет.

''dokuwiki-include-20091127.spec'':
<file>
%define       pluginname     include
Name:         dokuwiki-%{pluginname}
Version:      20091127
Release:      1
Summary:      Include another wiki page into the current one. (previous authors: Esther Brunner)
Group:        Applications/Editors
License:      GPL2
Source0:      http://cloud.github.com/downloads/dokufreaks/plugin-include/plugin-include.tgz
Source1:      include.txt
BuildArch:    noarch
BuildRoot:    %{_tmppath}/dokuwiki-%{pluginname}-root
URL:          http://www.dokuwiki.org/plugin:%{pluginname}
Packager:     Serg Alex Lad <ladserg@mail.ru>
Requires:     dokuwiki
Autoreqprov:  no

%description
This is a handy plugin with which you can include another wiki page into the current one.

%prep
#%setup -q -n %{name}-%{version}
%setup -q -T -b 0 -n %{pluginname}

%build

%install
find ./ -type d -exec chmod 0775 \{\} +
find ./ -type f -exec chmod 0664 \{\} +

mkdir -p $RPM_BUILD_ROOT/opt/dokuwiki/lib/plugins/%{pluginname}
cp -r . $RPM_BUILD_ROOT/opt/dokuwiki/lib/plugins/%{pluginname}

mkdir -p $RPM_BUILD_ROOT/opt/dokuwiki/data/pages/wiki/plugin
cp %SOURCE1 $RPM_BUILD_ROOT/opt/dokuwiki/data/pages/wiki/plugin/


%files
%defattr(-,apache,apache)
/opt/dokuwiki/lib/plugins/%{pluginname}
%config(noreplace) /opt/dokuwiki/data/pages/wiki/plugin/include.txt


%clean
rm -rf $RPM_BUILD_ROOT
</file>

В файл ''include.txt'' я просто скопировал описание с синтаксисом плагина на его страничке, если вам этого не надо, можете просто это удалить.

Как видите, создать RPM-пакет для плагина - не трудно. Скопировать исходник в соответствующий каталог, скопировать текст из SPEC-файла другого плагина, изменить значение переменной ''pluginname'', версию плагина, описание, ну, и по мелочи (не забудьте удалить или изменить описание добавления справки по плагину).