Создание собственного репозитория

Примечание: Данная статья создана для организаций, которые хотят создать собственный репозиторий с ПО для ALT Linux, совместимый с APT-RPM, который используется в данной системе.

Примечание: Короткая ссылка сюда - https://www.altlinux.org/Ownrepo

Состав

Репозиторий ALT Linux состоит из трех компонентов:

индексов - где описаны все пакеты, ссылки на них и их версии
самих пакетов (в формате *.rpm)
подписи индексов

Структура

Базовый каталог

Базовый каталог html:

/var/www/html/

Создаем каталог для репозитория:

# mkdir -p /var/www/html/extra

Создаем каталог branch:

# mkdir -p /var/www/html/extra/branch/p11/
# chown apache:apache -R /var/www/html
# systemctl restart httpd2.service

Корневой каталог Apache2

Отредактируйте файл:

# mcedit /etc/httpd2/conf/httpd2.conf

Исправьте корневой каталог:

DocumentRoot /var/www/html

Конфигурационный файл сайта

Создайте файл, в котором, кроме прочего, будут описаны:

каталог сайта на диске
разрешение на отображение его содержимого по http
разрешение на открытый доступ по http

mcedit /etc/httpd2/conf/sites-available/apt-repo.conf

<VirtualHost *:80>
    ServerName your-server-domain
    DocumentRoot /var/www/html/extra
    
    <Directory /var/www/html/extra>
        Options Indexes FollowSymLinks
        AllowOverride None
        Require all granted
        IndexOptions FancyIndexing NameWidth=*
    </Directory>
    
    # Включение листинга каталогов
    IndexOptions FancyIndexing NameWidth=* DescriptionWidth=*
</VirtualHost>

Включаем конфиг:

# a2ensite apt-repo
# systemctl restart httpd2.service
# systemctl reload apache2

# chown -R apache:apache /var/www/html/extra
# chmod -R 755 /var/www/html/extra
# systemctl reload httpd2.service

Создание собственного репозитория

Задача: создать собственный репозиторий со своими пакетами.

Добавляем свой компонент

Новый компонент будет называться extra.

Репозиторий будет находится в каталоге /var/www/html/extra/branch/p11/. Создадим необходимую структуру для нового компонента:

# mkdir -p /var/www/html/extra/branch/p11/x86_64/RPMS.extra

где:

x86_64 — архитектура компонента;
extra — суффикс компонента.

Наполнение компонента и создание индексов

Установим apt-repo-tools:

# apt-get install apt-repo-tools

Скопируем пакеты RPM в каталог /var/www/html/extra/branch/p11/x86_64/RPMS.extra:

# cp -v *.rpm /var/www/html/extra/branch/p11/x86_64/RPMS.extra

Создание ключей GPG

Создаем пару ключей GPG:

# gpg --gen-key
Выберите тип ключа:
   (1) RSA и RSA (по умолчанию)
   (2) DSA и Elgamal
   (3) DSA (только для подписи)
   (4) RSA (только для подписи)
Ваш выбор?

// Пишем 1. Так как нам необходим тип ключа RSA и RSA

длина ключей RSA может быть от 1024 до 4096 бит.
Какой размер ключа Вам необходим? (2048)

// Пишем размер ключа 2048

Запрошенный размер ключа - 2048 бит
Выберите срок действия ключа.
         0 = без ограничения срока действия
      <n>  = срок действия - n дней
      <n>w = срок действия - n недель
      <n>m = срок действия - n месяцев
      <n>y = срок действия - n лет
Срок действия ключа? (0)

// Ставим 0 без ограничения срока действия.

Срок действия ключа не ограничен
Все верно? (y/N)

// Ставим y

Для идентификации Вашего ключа необходим ID пользователя. Программа создаст его
из Вашего имени, комментария и адреса электронной почты в виде:
    "Baba Yaga (pensioner) <yaga@deepforest.ru>"

Ваше настоящее имя: (Пишем наше настоящее имя)
Адрес электронной почты: (Пишем адрес электронной почты)
Комментарий: 
Вы выбрали следующий ID пользователя:
    "Repo Signer <admin@company.net>"

Сменить (N)Имя, (C)Комментарий, (E)адрес или (O)Принять/(Q)Выход?

// Пишем O (Принять)

Для защиты секретного ключа необходима фраза-пароль.

Далее, система предложит сгенерировать случайные числа. Для этого нужно следовать инструкции, которая будет написана в нашем терминале (движение мышкой, набор текста и т.д).

В конце, когда сформируется отпечаток ключа GPG, можно увидеть сформированный ID. Пример:

pub   2048R/AE3F8179 2022-04-20
      Отпечаток ключа = 5C1D 67E3 F163 EC94 A1BC  202B 68E6 302C AE3F 8179

где, AE3F8179 — ID GPG ключа

Создание индексов и подписи

Теперь необходимо применить наш ID GPG ключа для создания и подписи индексов:

# genbasedir --create --bloat --progress --sign --default-key=AE3F8179 --topdir=/var/www/repo/extra x86_64 extra

Внимание! Обратите внимание, что в поле --default-key нужно использовать наш ID (в данном случае AE3F8179).

Далее, вводим фразу-пароль для доступа к секретному ключу пользователя.

Добавляем свой ключ, использованный для подписанного репозитория:

Создаем файл:

# nano /etc/apt/vendors.list.d/own.list

И в этом файле (own.list) прописываем отпечаток ключа (fingerprint) и имя:

simple-key "own" {
       Fingerprint "5C1D67E3F163EC94A1BC202B68E6302CAE3F8179";
       Name "Ваше имя <ваша электронная почта>";
}

Внимание! Не забудьте поставить ; после поля Fingerprint и name.

Внимание! Отпечаток (Fingerprint) необходимо указать без пробелов.

Создание собственного репозитория подписанного ключами вендоров

В октябре 2025 года в Сизиф был отправлен пакет apt-gpgkeys-pki.

Исходный код компонента опубликован на altlinux.space - https://altlinux.space/ALTLinux/apt-gpgkeys-pki.

Утилита пакета

В пакете имеется утилита apt-gpgkeys, у которой имеется две команды:

list
update

Технические тонкости

Источники ключей располагаются в каталоге /usr/lib/alt-gpgkeys/, к которому доимпортируются ключи из /usr/share/pki/apt-gpg/sources/ и /etc/pki/apt-gpg/sources.

Принцип реализации аналогичен ca-trust.

Будущий функционал

Обработка каталогов blacklist заложено, но пока не реализовано.

Как теперь "распространять" свой репозиторий

Теперь, опубликовав и подписав свой репозиторий с пакетами, провайдер может "упаковать конфиги в пакет":

/etc/apt/sources.list.d/ИМЯ.list
публичную часть ключа в /usr/share/pki/apt-gpg/sources/
fingerprint ключа в /etc/apt/vendors.list.d/ИМЯ.list

Необходимый триггер выполняется apt при установке пакета автоматически.

Пример репозитория

list-файл

Путь: /apt/sources.list.d/max.list

rpm [max] https://download.max.ru/linux/alt/ x86_64 max

Публичная часть

Путь: /etc/apt/vendors.list.d/max.list

simple-key "max" {
        Fingerprint "0C3FC2C2020604050F7D3692982759A166E39A11";
        Name "MAX Linux Repo <help@max.ru>";
}

Открытый ключ

Путь: /etc/pki/apt-gpg/sources/max.asc

Создание пакета с репозиторием

По статье Сборка пакетов start:

Генерируем ключи
Устанавливаем и настраиваем пакеты для сборки
Делаем вариант "пакет с нуля" с некоторыми аспектами

Структура

home
└── apt-conf-max
    |  ├── apt-conf-max.spec
    |  ├── max.asc
    |  ├── max.list
    |  └── max-vendors.list
    ├── .gear
    │   └── rules
    └── .git

Файл gear/rules

tar: .

Файл спека

Name: apt-conf-max
Summary: Official repository of MAX
Version: 1.0
Release: alt1

License: Public-Domain
Group: System/Base
URL: https://www.max.ru/

ExclusiveArch: x86_64

Source: %name-%version.tar

Requires: apt-https
Requires: apt-gpgkeys-pki

%description
%{summary}.

%prep
%setup

%install
install -Dpm0644 max.list %buildroot%_sysconfdir/apt/sources.list.d/max.list
install -Dpm0644 max-vendors.list %buildroot%_sysconfdir/apt/vendors.list.d/max.list
install -Dpm0644 max.asc %buildroot%_datadir/pki/apt-gpg/sources/max.asc

%files
%config(noreplace) %_sysconfdir/apt/sources.list.d/max.list
%_sysconfdir/apt/vendors.list.d/max.list
%_datadir/pki/apt-gpg/sources/max.asc

%changelog
* Tue Jan 27 2026 Andrey Cherepanov <cas@altlinux.org> 1.0-alt1
- Initial build for Sisyphus.

Как упаковать конфигурацию репозитория

Конфигурацию репозитория можно, как и любой файл, упаковать в пакет и предоставить пользователю, вместо скачивания ключей, правки конфигов и пр.

В данном разделе мы рассмотрим создание такого пакета.

НО,

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

Итак, вы более-менее знаете, как собирать пакеты.

Рассмотрим, как должен выглядеть gear-репозиторий, спек и пр. у пакета с репозиторием.

Смотрим спек:

Имя, описание, версия, релиз, исходники — все как обычно.
Лицензия — Public Domain
Группа — System/Base
Ссылка — как обычно
ExclusiveArch — архитектура, для которой предназначены файлы репозитория
В качестве зависимости указано apt-https — т.к.используется https

Примеры пакетов

Ссылка на ваш репозиторий может быть опакечена в основной репозиторий любым маинтейнером.

Вариант по последней версии инструкции: https://git.altlinux.org/people/cas/packages/apt-conf-max.git
Только ссылка на репозиторий: https://git.altlinux.org/gears/a/akvis-repo.git
Ссылка с GPG-подписью: https://git.altlinux.org/gears/a/angie-pro-repo.git
Ещё вариант с GPG: https://git.altlinux.org/gears/a/ascon-repo.git