HOWTO: репозиторий Debian

Авторские права на этот документ, Debian Repository HOWTO, принадлежат (c) 2002-2003 Aaron Isotton. Разрешается копировать распространять и/или изменять этот документ согласно условиям GNU Free Documentation License, версия 1.1 или более поздней, опубликованной Фондом Свободного ПО (FSF); with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts.

Присылайте ваши добавления, комментарии и критику по электронной почте: <aaron@isotton.com>.

Структура каталогов автоматического репозитория с поддерживаемыми в Debian архитектурами и компонентами выглядит так:

(корневой каталог репозитория) 
| 
+-dists
  | 
  |-stable
  | |-main
  | | |-binary-alpha 
  | | |-binary-arm
  | | |-binary-...
  | | +-source 
  | |-contrib
  | | |-binary-alpha 
  | | |-binary-arm
  | | |-binary-...
  | | +-source 
  | +-non-free
  |   |-binary-alpha
  |   |-binary-arm
  |   |-binary-...
  |   +-source
  |
  |-testing 
  | |-main
  | | |-binary-alpha 
  | | |-binary-arm
  | | |-binary-...
  | | +-source 
  | |-contrib
  | | |-binary-alpha 
  | | |-binary-arm
  | | |-binary-...
  | | +-source 
  | +-non-free
  |   |-binary-alpha
  |   |-binary-arm
  |   |-binary-...
  |   +-source
  |
  +-unstable 
    |-main
    | |-binary-alpha 
    | |-binary-arm
    | |-binary-...
    | +-source 
    |-contrib
    | |-binary-alpha 
    | |-binary-arm
    | |-binary-...
    | +-source 
    +-non-free
      |-binary-alpha
      |-binary-arm
      |-binary-...
      +-source

Свободные пакеты лежат в каталоге main; несвободные в non-free, и свободные, зависящие от несвободных в contrib. В настоящий момент в Debian поддерживается 11 архитектур; большинство каталогов для них здесь для краткости не показаны.

В каждом каталоге binary-* содержится файл Packages.gz и необязательный файл Release ; в каждом каталоге source содержится файл Sources.gz и необязательный файл Release . Заметьте, что сами пакеты располагаются не в том же каталоге что и индексные файлы, так как индексные файлы содержат пути к каждому пакету; фактически пакеты могут располагаться где угодно в репозитории. Это делает возможным создание пулов.

Вы можете создавать любое число дистрибутивов и компонент и называть их как угодно; то, что показано в примере просто используется в Debian. Вы можете, например, создать дистрибутивы current и beta (вместо стабильный (stable), тестируемый (testing) и нестабильный (unstable)), и компоненты foo, bar, baz и qux (вместо main, contrib и non-free).

Хотя вы и можете использовать любые названия компонент, обычно лучше придерживаться стандартных названий Debian, так как их назначение уже понятно пользователям Debian.

Обычные репозитории состоят из корневого каталога и нескольких нужных вам подкаталогов. Так как пользователям нужно указывать путь к корневому каталогу репозитория и относительный путь между корневым и каталогом с индексным файлом, вы можете создавать каталоги как угодно (даже положить всё в один корневой каталог; просто относительный путь в этом случае будет «/»).

(корневой каталог репозитория)
|
|-binary
+-source

dpkg-scanpackages создаёт файл Packages , а dpkg-scansources файл Sources .

Результат обеих программ направляется в stdout (стандартный выходной поток); таким образом, для сжатия файлов вы можете использовать цепочку команд: dpkg-scanpackages аргументы | gzip -9c > Packages.gz.

Данные программы работают схожим образом; им передаётся два аргумента (на самом деле есть и другие, но они здесь не показаны; вы можете прочитать о них в страницах руководства); первым параметром указывается каталог с пакетами, а вторым файл override. Для простых репозиториев файл override не нужен, но всё равно этот аргумент является обязательным, поэтому мы просто передаём /dev/null.

dpkg-scanpackages сканирует .deb пакеты; dpkg-scansources сканирует .dsc файлы. Необходимо располагать файлы .orig.gz, .diff.gz и .dsc вместе. Файлы .changes необязательны.

Предположим, мы имеем обычный репозиторий, описанный в Пример 2, «Обычный репозиторий с двумя подкаталогами». Чтобы создать для него два индексных файла нужно ввести:

$ cd my-repository
$ dpkg-scanpackages binary /dev/null | gzip -9c > binary/Packages.gz
$ dpkg-scansources source /dev/null | gzip -9c > source/Sources.gz

Если у вас сложный репозиторий, подобный Пример 1, «Стандартный репозиторий Debian», то вам придётся писать несколько сценариев для автоматизации процесса.

Также, вы можете воспользоваться параметром pathprefix для упрощения синтаксиса; читателю самому предлагается проделать это в качестве упражнения. (Это описано в страницах руководства).

Если вы хотите позволить пользователям вашего репозитория использовать механизм Фиксации , то нужно создать файл Release в каждом каталоге, где есть индексный файл. (Подробные сведения о фиксации изложены в APT HOWTO).

Файлы Release являются простыми маленькими текстовыми файлами следующего вида:

Archive: архив
Component: компонент
Origin: название вашей организации
Label: Debian репозиторий моей организации
Architecture: архитектура

Очень важно указать правильные Archive и Architecture , так как они используются для фиксации. Остальные поля менее важны.

При использовании автоматических репозиториев раскидывание пакетов по разным каталогам быстро приводит к неприятностям. Это также влечёт за собой напрасные траты места и пропускной способности сети, так как многие пакеты (например пакеты с документацией) относятся сразу ко всем архитектурам.

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

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

Существуют различные инструменты для автоматизации и упрощения создания архивов Debian; здесь описаны наболее важные из них.

apt-ftparchive — используется для перемещения набора файлов пакетов Debian в надлежащую архивную иерархию, соответствующую официальному архиву Debian. Данная программа является частью пакета apt-utils .

apt-move — используется для перемещения набора файлов пакетов Debian в надлежащую архивную иерархию, соответствующую официальному архиву Debian.