Обсуждение участника:Nir: различия между версиями

имя

gpg --default-new-key-algo rsa4096 --gen-key

Ваше полное имя: Vasiliy Petrov
Адрес электронной почты: vasip@altlinux.org

$ gpg --output my-pubkey.asc --armor --export username@altlinux.org

$ gpg2 --import-options show-only ./my-pubkey.asc

# apt-get -y install seahorse

$ ssh-keygen -l -f ./id_ed25519.pub

# apt-get update
# apt-get dist-upgrade
# reboot

# apt-get -y install git \
	gear \
	hasher \
	hasher-priv \
	hasher-rich-chroot \
	hasher-rich-chroot-user-utils \
	rpm-utils \
	rpm-build \
	rpm-build-licenses \
	rpm-macros-cmake \
	rpm-macros-make \
	rpm-macros-generic-compat \
	apt-repo \
	apt-repo-tools \
    vim-plugin-spec_alt-ftplugin \
    kernel-build-tools \
    describe-specfile

# apt-get -y install gcc gcc-c++ cmake

$ git config --global user.name "Vasiliy Petrov"
$ git config --global user.email "vasip@altlinux.org"
$ git config --global user.signingkey <keyid> 

$ gpg --list-secret-keys --keyid-format=long

%packager Vasiliy Petrov <vasip@altlinux.org>
%_gpg_name vasip@altlinux.org

# Завершать сборку с ошибкой, если обнаружились незапакованные файлы
%define _unpackaged_files_terminate_build 1

# usermod -aG rpm <user>

usermod: не удалось заблокировать /etc/tcb/username/shadow; попробуйте ещё раз позже.

# gpasswd -a <username> rpm

# systemctl enable --now hasher-privd.service

# hasher-useradd <user>

hsh: /usr/libexec/hasher-priv/getconf.sh: cannot access getconf helper

$ mkdir ~/hasher
$ mkdir ~/.hasher

packager="`rpm --eval %packager`"
no_sisyphus_check="packager,buildhost,gpg"
allowed_mountpoints=/dev/pts,/proc,/dev/shm
lazy_cleanup=1
# share_ipc=1
# Необходимо в случае, когда требуется разрешить доступ в сеть из Hasher chroot.
# Данная опция не должна применяться без особой необходимости.
# share_network=1
# нужен для сборки с репозиториями отличающимися от системного:
# apt_config="$HOME/.hasher/apt.conf"

$ hsh --initroot-only ~/hasher

hasher-priv: master: time elapsed limit (600 seconds) exceeded

wlimit_time_elapsed=360000
wlimit_time_idle=360000

// Осуществлять попытку перекачать файлы при сбоях
APT::Acquire::Retries "3";
// Не вычитывать файл /etc/apt/sources.list
Dir::Etc::main "/dev/null";
Dir::Etc::Parts "/var/empty";
Dir::Etc::SourceParts "/var/empty";
Dir::Etc::SourceList "/var/empty";

Dir::Etc::SourceList "~/.hasher/sources.list";

# Sisyphus infrastructure
Host git.alt
  HostName gitery.altlinux.org
  User git_<username>
  Port 222
  IdentityFile ~/.ssh/id_rsa

Host girar
  HostName gyle.altlinux.org
  User git_<username>
  Port 222
  IdentityFile ~/.ssh/id_rsa

mkdir program
cd program
git init

mkdir -p .gear
touch .gear/rules

touch program.spec

merge -s ours <code_branch>

cfbb5bba7b9d811ca4734973f5b68296ae305424 v1.2

object 21c9b06871f49c57f770bce99ed4300df8ec7972
type commit
tag v1.2
tagger Jeremy White <jwhite@codeweavers.com> 1591374242 +0000

Tag for version 1.2

tar: .

tar: KITScenarist name=@name@-@version@

%name-%version.tar

copy: fastfix.patch

spec: .gear/nice-project.spec
tar: .

# Определяем макрос, который сигнализирует о том, что в случае обнаружения
# незапакованных файлов сборка должна упасть с ошибкой
%define _unpackaged_files_terminate_build 1

Name: cfengine
Version: 3.12.0
Release: alt1
# Epoch: 1

Summary: Configuration management system
License: %gpl2plus
Group: Other
Url:
BuildArch: x86-64

Requires: gcc

BuildRequires(pre): rpm-build-licenses
BuildRequires: gcc

Source0: %name-%version.tar

%description:
Configuration management system.

%prep
%setup -q

%install

%files

%changelog

AutoReqProv: no

Autoprov: no

ssh git.alt clone /gears/c/cfengine.git

ssh git.alt init-db cfengine

git clone git.alt:/people/имя/packages/cfengine.git

cd cfengine

gear-hsh --verbose --lazy-cleanup --commit -- --verbose

hsh-install <package_name>

git remote add git.alt git.alt:/people/имя/packages/cfengine.git

ssh girar task new --help

ssh girar task new sisyphus
ssh girar task new p10

ssh girar task add <task id> repo cfengine.git 3.12.2-alt1

ssh girar task run --test-only <task id>

ssh girar task run -m "Build_reason" --commit <task id>

ssh girar task run --commit <task id> -m -

ssh girar acl --list

ssh girar acl p10 @maint show

$ genbasedir [опции] {название подсистемы} {репозиторий 1} [репозиторий 2...]

/srv/repository/
|-- SRPMS
|-- SRPMS.security
|-- CoolVendor
| |-- MyCoolPropietaryProduct
| | |-- x86_64
| | | |-- RPMS
| | | |-- RPMS.local -> RPMS
| | | |-- RPMS.security
| | | |-- SRPMS.local -> ../../SRPMS
| | | |-- SRPMS.security -> ../../SRPMS.security
| | | |-- base
| | |-- noarch
| | | |-- RPMS
| | | |-- RPMS.local -> RPMS
| | | |-- SRPMS.local -> ../../SRPMS
| | | |-- base

$ genbasedir --topdir=/srv/repository CoolVendor/MyCoolProprietaryProduct/x86_64 local security

rpm file:/srv/repository CoolVendor/MyCoolProprietaryProduct/x86_64 local
rpm-src file:/srv/repository CoolVendor/MyCoolProprietaryProduct/x86_64 local
rpm file:/srv/repository CoolVendor/MyCoolProprietaryProduct/x86_64 security
rpm-src file:/srv/repository CoolVendor/MyCoolProprietaryProduct/x86_64 security

simple-key "краткое название ключа" {
        Fingerprint "GNUPG KEY FINGERPRINT";
        Name "GNUPG UID <user@email>";
}

simple-key "alt" {
        Fingerprint "BB1DD157A9722953847C5DB25B433A0EEAC91CA0";
        Name "ALT Security Team <security@altlinux.ru>";
}

rpm [alt] file:/srv/repository CoolVendor/MyCoolProprietaryProduct/x86_64 security
rpm-src [alt] file:/srv/repository CoolVendor/MyCoolProprietaryProduct/x86_64 security

$ genbasedir \
        --topdir=/srv/repository \
        --sign \
        --uid='Proprietary Vendor ID' \
        CoolVendor/MyCoolProprietaryProduct/x86_64 security

$ make DEBUG=1 ARCH=aarch64 BRANCH=p10 APTCONF=/etc/apt/apt.conf.aarch64 alt-server.iso

Dir::Etc::main "/dev/null";
Dir::Etc::parts "/ver/empty";
Dir::Etc::SourceParts "/var/empty";
Dir::Etc::sourcelist "/etc/apt/sources.list.d/alt-aarch64.list";
APT::Acquire::Retries "3";
APT::Cache-Limit 201326592;
//Acquire::http::AllowRedirect "true";

RPM 
{
        Allow-Duplicated {
                // Old-style kernels.
                "^(NVIDIA_)?(kernel|alsa)[0-9]*(-adv|-linus)?($|-up|-smp|-secure|-custom|-enterprise|-BOOT|-tape|-aureal)";
                // New-style kernels.
                "^kernel-(image|modules)-.*";
        };
        Hold {
                // Old-style kernels.
                "^(kernel|alsa)[0-9]+-source";
        };
};

rpm-dir file:/home/username/hasher/repo aarch64 hasher
rpm [alt] rsync://ftp.altlinux.org/ALTLinux p10/aarch64 classic
rpm [alt] rsync://ftp.altlinux.org/ALTLinux p10/noarch classic

prefix=/srv/tmp/image-build

apt-get install qemu-user-static-binfmt-aarch64 qemu-user-static-aarch64

for f in dev dev/pts sys proc run ; do mount --bind /$f /mnt/rootfs/$f ; done

chroot /mnt/rootfs

for f in dev/pts dev sys proc run ; do umount /mnt/rootfs/$f ; done

sudo cp /usr/bin/qemu-aarch64-static /mnt/rootfs
sudo chroot /mnt/rootfs ./qemu-aarch64-static /bin/bash

env ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- scripts/kconfig/merge_config.sh -m config config-aarch64 config-std ${EXTRACONFIGS}
env ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- make olddefconfig
env ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- make prepare
make -j $(($(nproc) + 1)) ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- LOCALVERSION="" 
make -j $(($(nproc) + 1)) ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- LOCALVERSION="" modules
make -j $(($(nproc) + 1)) ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- LOCALVERSION="" dtbs
sudo make -j $(($(nproc) + 1)) ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- INSTALL_MOD_STRIP=1 modules_install
sudo make -j $(($(nproc) + 1)) ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- install
sudo make -j $(($(nproc) + 1)) ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- INSTALL_PATH=/boot/dtb dtbs_install

[gear "specsubst"]
  kflavour = flavourname

 git config --local gear.specsubst.kflavour flavourname

 gear-update-tag -avc

gear-rpm -v --ba --commit --target=aarch64 --with cross_toolchain_aarch64

gear -v --commit --hasher -- hsh -v --target=aarch64 --build-args='--with cross_toolchain_aarch64' ~/hasher

BTF: .tmp_vmlinux.btf: pahole (pahole) is not available
Failed to generate BTF for vmlinux
Try to disable CONFIG_DEBUG_INFO_BTF

# apt-get install dwarves

macro: %def_disable check not found

Нет ответа.

usermod: не удалось заблокировать /etc/tcb/username/shadow; попробуйте ещё раз позже.

# gpasswd -a <username> rpm

hasher-priv: slave: chrootuid: execve: /.host/entry: Exec format error

hasher-priv: master: time elapsed limit (600 seconds) exceeded

wlimit_time_elapsed=360000
wlimit_time_idle=360000

%triggerin	Срабатывает после установки пакета.
%triggerun	Срабатывает перед удалением пакета, если цель триггера установлена в системе.
%triggerpostun	Данный триггер срабатывает в ситуации обновления пакета, после удаления предыдущей версии пакета. Не срабатывает при простом удалении пакета.

@@ Строка 1: / Строка 1: @@
+Данное руководство запланировано к переезду на https://gitflic.ru/project/nir-ginko/knowledge-base/blob?file=altlinux%2Fmaintainer%2Fwiki.md&branch=master в целях упрощения редактирования разметки и прикладывания полезных файлов.
 {{Stub}}
 == Руководство мейнтейнера ALT Linux ==
@@ Строка 39: / Строка 41: @@
 * [http://lists.altlinux.org lists.altlinux.org] - списки рассылки проекта;
 * [http://forum.altlinux.org forum.altlinux.org] - форум сообщества.
-* [irc://irc.freenode.net/altlinux #altlinux] и [irc://irc.freenode.net/altlinux-devel #altlinux-devel] - IRC каналы;
 ===Процедура Join===
@@ Строка 53: / Строка 54: @@
 * '''публичный''' GPG-ASCIIARMOR ключ для подписи коммитов;
 * указать никнейм ментора из команды;
-* указать желаемый почтовый адрес вида <nickname>@altlinux.org. Посмотреть, занят ли выбранный адрес можно на странице http://git.altlinux.org/people/
+* указать желаемый почтовый адрес вида <nickname>@altlinux.org. Ник должен быть длиннее трёх символов. Посмотреть, занят ли выбранный адрес можно на странице http://git.altlinux.org/people/
 В качестве теста на членство в команде принимается работа в виде Gear-репозитория новой программы или возрождение выпавшей из сборок.
@@ Строка 64: / Строка 65: @@
 * [[User:MichaelShigorin|mike@]]
 * [[User:IvanMelnikov|iv@]] - только оффлайн менторинг
-* [[User:Nir|nir@]] - только оффлайн менторинг
-==== Проверка ключа ====
+==== Создание GPG ключа====
+GPG ключ нужен для подписывания Git тегов, отправляемых в репозиторий сборочницы
- ssh-keygen -l -f ./id_ed25519.pub
+Создание ключа выполняется командой:
-Почта должна при этом совпадать с alias, выбранным для почты @altlinux.org.
+<pre>
+gpg --default-new-key-algo rsa4096 --gen-key
+</pre>
+Вам не надо указывать какие либо дополнительные комментарии. Просто укажите имя, фамилию и почту в латинской транскрипции. Выглядеть это будет примерно так:
+<pre>
+Ваше полное имя: Vasiliy Petrov
+Адрес электронной почты: vasip@altlinux.org
+</pre>
+Срок действия ключа зачастую оставляют пустым, делая его бессрочным.
+Экспорт публичного ключа выполняется так:
+<pre>
+$ gpg --output my-pubkey.asc --armor --export username@altlinux.org
+</pre>
+Проверить корректность ключа можно так:
- gpg2 --import-options show-only ./pubring.pub
+<pre>
+$ gpg2 --import-options show-only ./my-pubkey.asc
+</pre>
 Почта должна совпадать с alias на altlinux.org. Также, и имя и почта должны совпадать с тем, что будет установлено в настройках Git.
+Если вы испытываете трудности с созданием ключа и его проверкой (и пониманием того, что выдаёт утилита <code>gpg</code>) - вы можете установить из репозитория пакет <code>seahorse</code>:
+<pre>
+# apt-get -y install seahorse
+</pre>
+и создать-проверить ключ в графическом интерфейсе.
+==== Создание SSH ключа ====
+SSH ключ нужен для обеспечения возможности отправки Git репозиториев в сборочницу и работы с её шеллом.
+Проверить корректность ключа можно так:
+<pre>
+$ ssh-keygen -l -f ./id_ed25519.pub
+</pre>
+Почта должна при этом совпадать с alias, выбранным для почты @altlinux.org.
 ===Работа с пакетной базой===
@@ Строка 122: / Строка 165: @@
 <pre>
-# apt-get install git \
+# apt-get -y install git \
 	gear \
 	hasher \
@@ Строка 135: / Строка 178: @@
 	rpm-macros-generic-compat \
 	apt-repo \
-	apt-repo-tools
+	apt-repo-tools \
+    vim-plugin-spec_alt-ftplugin \
+    kernel-build-tools \
+    describe-specfile
+</pre>
+В общем случае назначение данных пакетов таково:
+* '''git''' - Общий рабочий инструмент для любого разработчика
+* '''gear''' - Инструмент запуска <code>hasher</code>
+* '''hasher''' - Инструмент создания сборочного chroot и установки туда пакетов
+* '''hasher-priv''' - Вспомогательный демон, который запускает сборочные программы
+* '''hasher-rich-chroot''' - ?
+* '''hasher-rich-chroot-user-utils''' - ?
+* '''rpm-utils''' - ?
+* '''rpm-build''' - ?
+* '''rpm-build-licenses''' - набор макросов RPM, которые выполняют подстановку корректного названия той или иной лицензии. Полезно для унификации и исключения ошибок.
+* '''rpm-macros-cmake''' - набор макросов для запуска сборки с помощью <code>cmake</code>
+* '''rpm-macros-make''' - набор макросов для запуска сборки с помощью <code>make</code>
+* '''rpm-macros-generic-compat''' - ?
+* '''apt-repo''' - утилита управления источниками установки пакетов - файлами <code>sources.list</code>
+* '''apt-repo-tools''' - ?
+* '''vim-plugin-spec_alt-ftplugin''' - плагин Vim для обеспечения подсветки специфичных для ALT конструкций RPM specfile.
+* '''kernel-build-tools''' - утилиты для работы со spec файлами для сборки ядра ALT.
+* '''describe-specfile''' - зависимость для <code>kernel-build-tools</code>
+Также могут понадобиться инструменты разработчика:
+<pre>
+# apt-get -y install gcc gcc-c++ cmake
 </pre>
 =====Настройка Git=====
-Начальная настройка Git выполняется тремя командами:
+Начальная настройка Git (файла <code>.gitconfig</code>) выполняется тремя командами:
 <pre>
@@ Строка 148: / Строка 220: @@
 </pre>
-keyid стоит указывать тот, который был сгенерирован для Join.
+keyid стоит указывать тот, который был сгенерирован для Join. Посмотреть его можно командой:
+<pre>
+$ gpg --list-secret-keys --keyid-format=long
+</pre>
 =====Настройка RPM=====
@@ Строка 169: / Строка 245: @@
 <pre>
 # usermod -aG rpm <user>
+</pre>
+Если же вы навешиваете группу на доменного пользователя, а не на локального, то вышеуказанная команда у вас работать не будет и упадёт с ошибкой типа:
+<pre>
+usermod: не удалось заблокировать /etc/tcb/username/shadow; попробуйте ещё раз позже.
+</pre>
+Для решения задачи добавления группы в этом случае используйте команду:
+<pre>
+# gpasswd -a <username> rpm
+</pre>
+Далее необходимо включить демон <code>hasher-priv</code> для корректной работы сервиса командой (этот шаг необходим, если вы используете Sisyphus, в остальных случаях этот шаг нужно пропустить):
+<pre>
+# systemctl enable --now hasher-privd.service
 </pre>
@@ Строка 190: / Строка 283: @@
 </pre>
-Далее создайте файл `~/.hasher/config` примерно следующего содержания:
+Далее создайте файл <code>~/.hasher/config</code> примерно следующего содержания:
   packager="`rpm --eval %packager`"
@@ Строка 198: / Строка 291: @@
   # share_ipc=1
   # Необходимо в случае, когда требуется разрешить доступ в сеть из Hasher chroot.
-  # Данная опция не должна приеняться без особой необходимости.
+  # Данная опция не должна применяться без особой необходимости.
   # share_network=1
   # нужен для сборки с репозиториями отличающимися от системного:
@@ Строка 212: / Строка 305: @@
 Создавать сборочное окружение каждый раз не обязательно -- оно будет создано автоматически при сборке пакета.
+Также, для сборки больших пакетов может потребоваться много времени. Внутренняя утилита <code>hasher-priv</code> имеет установленный по умолчанию таймаут бездействия в 600 секунд (10 минут). Это частая проблема, сообщение о которой может выглядеть так:
+ hasher-priv: master: time elapsed limit (600 seconds) exceeded
+Чтобы избежать этой проблемы, на сборочной машине предлагается отредактировать файл <code>/etc/hasher-priv/system</code> и добавить следующие настройки:
+<pre>
+wlimit_time_elapsed=360000
+wlimit_time_idle=360000
+</pre>
+Достаточно большой таймаут позволит вам ждать окончания сборки до победы.
+===== Настройка APT =====
+В рамках локальной сборочной инфраструктуры создаётся так называемый <code>aptbox</code>, который хранит собственную базу пакетов. Сделано это для того, чтобы пакеты, собираемые <code>hasher</code> не зависели от системных репозиториев. И наоборот - чтобы системная база пакетов не включала в себя специфичные сборочные пакеты.
+Чтобы APT при сборке использовал исключительно требуемую пакетную базу необходимо отключить поиск файлов <code>sources.list</code> в системных директориях и указать собственные источники пакетов. Сделать это можно с помощью файла конфигурации APT для <code>hasher</code>: <code>~/.hasher/apt.conf</code>:
+ // Осуществлять попытку перекачать файлы при сбоях
+ APT::Acquire::Retries "3";
+ // Не вычитывать файл /etc/apt/sources.list
+ Dir::Etc::main "/dev/null";
+ Dir::Etc::Parts "/var/empty";
+ Dir::Etc::SourceParts "/var/empty";
+ Dir::Etc::SourceList "/var/empty";
+ Dir::Etc::SourceList "~/.hasher/sources.list";
 ===== Настройка SSH =====
@@ Строка 299: / Строка 421: @@
   tar: KITScenarist name=@name@-@version@
-указывает запаковать директорию KITScenarist из проекта. По умолчанию архив будет иметь имя директории: <source>KITScenarist-1.0.0.tar</source>. В то же время в specfile прописано имя:
+указывает запаковать директорию KITScenarist из проекта. По умолчанию архив будет иметь имя директории: {{path|KITScenarist-1.0.0.tar}}. В то же время в specfile прописано имя:
   %name-%version.tar
@@ Строка 310: / Строка 432: @@
 Она необходима для прикладывания патчей из репозитория в архив. Директивы выполняются в порядке их чтения сверху вниз, потому она должна находиться перед директивой <code>tar</code>. Применяется в случаях, когда код надо запатчить быстро, а апстрим проекта тянет с применением изменений.
+Ещё одна интересная директива - <code>spec</code>. Она указывает расположение specfile в том случае, если он находится в нестандартном месте (не в корне репозитория проекта). На текущий момент предлагается размещать specfile в директории <code>.gear</code> и отправлять файлы в виде pull request в апстрим проектов. Таким образом можно будет сделать сборку не чем-то обособленным, а вполне себе публичной деятельностью. Файл <code>rules</code> при этом будет выглядеть примерно так:
+ spec: .gear/nice-project.spec
+ tar: .
 ======specfile======
@@ Строка 327: / Строка 454: @@
   Summary: Configuration management system
-  License:
+  License: %gpl2plus
   Group: Other
   Url:
@@ Строка 334: / Строка 461: @@
   Requires: gcc
+ BuildRequires(pre): rpm-build-licenses
   BuildRequires: gcc
@@ Строка 389: / Строка 517: @@
 | BuildRequires
 | Сборочные зависимости пакета. Дополнительные зависимости, которые нужны только для сборки.
+|-
+| BuildRequires(pre)
+| Сборочные зависимости пакета, которые будут установлены до разбора specfile. Зачастую в этой секции производится установка пакетов с RPM макросами.
 |-
 | Source0
@@ Строка 408: / Строка 539: @@
 |
 |}
+====== Директивы макропроцессора ======
+<code>%define _unpackaged_files_terminate_build 1</code> - включает выход с кодом ошибки в случае, если в buildroot обнаружены файлы, не принадлежащие ни одному пакету. Это позволяет мейнтейнеру всегда быть предупреждённым о том, что появились новые файлы, на присутствие которых надо среагировать.
+<code>%define _allow_root_build 1</code> - установка данного макроса позволяет разрешить rpm-build работу от пользователя root. В общем случае данный макрос не нужен. Использовать его целесообразно при bootstrap на новых архитектурах, когда нативно собирается первая итерация пакетов, прямо на целевой rootfs. В таких случаях кроме root других пользователей может не быть и данная опция будет полезна.
+<code>%define __find_requires %{nil}</code> - установка данного макроса отключает скрипты для автоматического поиска зависимостей. Может быть полезно при бутстрапе. Не рекомендуется устанавливать данное значение в <code>/bin/true</code>, так как <code>/bin/true</code> может и не быть там, где данный макрос понадобился. Также данный макрос можно заменить директивой:
+<pre>
+AutoReqProv: no
+</pre>
+<code>%define __find_provides %{nil}</code> - установка данного макроса, по аналогии с предыдущим, выключает скрипты для автоматического формирования <code>Provides</code>. Можно заменить директивой:
+<pre>
+Autoprov: no
+</pre>
 ======Триггеры======
@@ Строка 457: / Строка 606: @@
 И выполните команду:
-  gear-hsh
+  gear-hsh --verbose --lazy-cleanup --commit -- --verbose
 Процесс может занять некоторое время, так как будут произведены следующие шаги:
@@ Строка 464: / Строка 613: @@
 * будут скачаны и установлены пакеты сборочных зависимостей (указаны в spec файле в качестве '''BuildRequires''' директивы);
 * будет запущен процесс распаковки тарбола с кодом, его сборки, тестирования и упаковки в RPM.
+В случае проблем при сборке пакета в chroot иногда бывает необходимо доустановить пакеты, при том apt отсутствует внутри chroot. Сделать это можно командой:
+ hsh-install <package_name>
 В случае, если нам необходимо добавить Git remote (например, '''git.alt''') к существующему репозиторию, стоит воспользоваться следующей командой:
@@ Строка 486: / Строка 639: @@
 Чтобы начать собирать пакеты необходимо создать сборочную "задачу" (которая станет карманом):
-  ssh girar task new p9
+  ssh girar task new sisyphus
+ ssh girar task new p10
-Далее необходимо добавить репозитории для сборки. Отправить на сборку можно репозиторий, который находится в песональном подкаталоге '''packages''' на '''git.altlinux.org''' командой:
+Чтобы попасть в стабильную ветку, пакет сначала должен пройти сборку в репозиторий Sisyphus, поэтому мы создаём две задачи.
+Далее необходимо добавить репозитории для сборки. Отправить на сборку можно репозиторий, который находится в персональном подкаталоге '''packages''' на '''git.altlinux.org''' командой:
   ssh girar task add <task id> repo cfengine.git 3.12.2-alt1
@@ Строка 499: / Строка 655: @@
   ssh girar task run -m "Build_reason" --commit <task id>
+или (для подробного сообщения с пробелами):
+ ssh girar task run --commit <task id> -m -
 Где "build_reason" - сообщение о причинах отправки на сборку, без пробелов.
+====Команды сборочницы====
+Просмотр списка веток:
+ ssh girar acl --list
+Просмотр списка членов группы:
+ ssh girar acl p10 @maint show
 ====Развёртывание локальной сборочницы====
+Сборочница состоит из контрольных машин, которые управляют заданиями и сборочных нод.
 ====Создание собственного репозитория====
-Для решения задачи предоставления собственного специфичного репозитория, например, в ситуации, когда производитель проприетарного ПО хочет также поставлять свои пакеты для дистрибутива, существует команда <code>genbasedir</code>. Данная программа анализирует директорию с пакетами RPM и генерирует файлы метаданных.
+<!--
+Данный кусок частично скопирован с https://docs.altlinux.org/ru-RU/archive/2.2/html-single/master/admin-html/ch03.html
+-->
+Для решения задачи предоставления собственного специфичного репозитория, например, в ситуации, когда производитель проприетарного ПО хочет также поставлять свои пакеты для дистрибутива, существует команда <code>genbasedir</code>. Данная программа анализирует директорию с пакетами RPM и генерирует файлы метаданных. Для этого необходимо создать структуру каталогов, подобную описанной выше. Вы можете выбирать из следующих компонентов:
+* <b>CoolVendor/MyCoolProprietaryProduct</b> - название подсистемы. Например, продукта или производителя. Может состоять из произвольной вложенности набора директорий. Этот уровень в дереве может отсутствовать (то есть, каталоги RPMS и base могут идти сразу следом за архитектурой);
+* <b>x86_64</b> - архитектура, под которую собраны пакет (совпадает с таковой в имени бинарных RPM-пакетов);
+* <b>RPMS</b> - каталог, в котором размещены бинарные пакеты;
+* <b>SRPMS</b> - каталог, в котором размещены пакеты с исходными текстами программ;
+* <b>RPMS.sisyphus</b> - ссылка на каталог RPMS. При этом sisyphus заменяется на собственное название репозитория, например, local;
+* <b>base</b> - служебный каталог, в котором размещается база данных APT;
+Следующий шаг в создании своего репозитория заключается в помещении бинарных пакетов в каталог RPMS, а пакетов с исходными текстами — в каталог <b>SRPMS</b> и в генерации служебной информации для APT при помощи команды <code>genbasedir</code>; ее формат:
+<pre>
+$ genbasedir [опции] {название подсистемы} {репозиторий 1} [репозиторий 2...]
+</pre>
+Из опций, список которых можно увидеть при запуске genbasedir без параметров, наиболее важной является опция --topdir, позволяющая указать путь к репозиторию. Все остальные параметры задаются относительно этого пути. Выглядит это следующим образом. Допустим, что наше дерево каталогов выглядит так:
+<pre>
+/srv/repository/
+|-- SRPMS
+|-- SRPMS.security
+|-- CoolVendor
+| |-- MyCoolPropietaryProduct
+| | |-- x86_64
+| | | |-- RPMS
+| | | |-- RPMS.local -> RPMS
+| | | |-- RPMS.security
+| | | |-- SRPMS.local -> ../../SRPMS
+| | | |-- SRPMS.security -> ../../SRPMS.security
+| | | |-- base
+| | |-- noarch
+| | | |-- RPMS
+| | | |-- RPMS.local -> RPMS
+| | | |-- SRPMS.local -> ../../SRPMS
+| | | |-- base
+</pre>
+Тогда строка запуска genbasedir будет выглядеть так:
+<pre>
+$ genbasedir --topdir=/srv/repository CoolVendor/MyCoolProprietaryProduct/x86_64 local security
+</pre>
+Этой командой мы создадим информацию для APT в двух репозиториях — <b>local</b> и <b>security</b>. Для того, чтобы воспользоваться этой информацией, необходимо прописать доступ к репозиториям в <code>/etc/apt/sources.list</code>:
+<pre>
+rpm file:/srv/repository CoolVendor/MyCoolProprietaryProduct/x86_64 local
+rpm-src file:/srv/repository CoolVendor/MyCoolProprietaryProduct/x86_64 local
+rpm file:/srv/repository CoolVendor/MyCoolProprietaryProduct/x86_64 security
+rpm-src file:/srv/repository CoolVendor/MyCoolProprietaryProduct/x86_64 security
+</pre>
+Репозиторий MyCoolProprietaryProduct.security, хранящий пакеты с исправлениями ошибок в системе безопасности, имеет смысл подписывать PGP-ключом, чтобы при установке пакета можно было проверить подлинность репозитория и хранящихся в нем пакетов. Для этого необходимо создать соответствующий PGP-ключ, используя программу GnuPG (gpg2) и запомнить его отпечаток (fingerprint) на клиентских машинах в файле /etc/apt/vendors.list в формате:
+<pre>
+simple-key "краткое название ключа" {
+        Fingerprint "GNUPG KEY FINGERPRINT";
+        Name "GNUPG UID <user@email>";
+}
+</pre>
+Примером может служить ключ службы безопасности ALT Linux Team, которым подписаны пакеты репозитория Sisyphus и обновления безопасности для различных дистрибутивов ALTLinux:
+<pre>
+simple-key "alt" {
+        Fingerprint "BB1DD157A9722953847C5DB25B433A0EEAC91CA0";
+        Name "ALT Security Team <security@altlinux.ru>";
+}
+</pre>
+Для того, чтобы APT проверял подлинность подписи, необходимо указать, что соответствующий репозиторий подписан PGP-ключом в <code>/etc/apt/sources.list</code>:
+<pre>
+rpm [alt] file:/srv/repository CoolVendor/MyCoolProprietaryProduct/x86_64 security
+rpm-src [alt] file:/srv/repository CoolVendor/MyCoolProprietaryProduct/x86_64 security
+</pre>
+Необходимо также сгенерировать информацию для APT в репозитории с указанием опции <code>--sign</code> команды <code>genbasedir</code>. Дополнительно, можно указать идентификатор ключа, если он отличается от ключа по умолчанию, используя опцию <code>--uid=идентификатор</code>. Значением этой опции является идентификатор ключа в том виде, как он передается программе GnuPG в опции <code>--default-key</code>:
+<pre>
+$ genbasedir \
+        --topdir=/srv/repository \
+        --sign \
+        --uid='Proprietary Vendor ID' \
+        CoolVendor/MyCoolProprietaryProduct/x86_64 security
+</pre>
+Операцию создания служебной информации для APT необходимо производить каждый раз, когда в репозиторий вносятся изменения. Результирующий репозиторий возможно отдать во внешний мир с помощью HTTP сервера.
+Пакеты подписываются с помощью команды <code>rpmsign</code>. Репозитории подписываются с помощью опции <code>-s</code> утилиты <code>genbasedir</code>. Для импорта публичного ключа в RPM keyring есть команда <code>rpm --import</code>.
+=== Сборка образов с помощью mkimage-profiles ===
+https://git.altlinux.org/people/antohami/packages/?p=mkimage-profiles.git;a=summary
+Используйте ветку <code>master</code>.
+Перед началом работы стоит отметить следующие положения касательно сборки образов с помощью <code>mkimage-profiles</code>:
+* <code>mkimage-profiles</code> не подхватывает собственный (локальный) репозиторий <code>hasher</code> по умолчанию. Для его использования, или для использования иным образом локально собранных пакетов, необходимо прописать директорию с пакетами в <code>sources.list</code> соответствующим образом.
+* Ветка <code>sisyphus</code> нужна только для сборки пакета. Бранчевание для разработки новых функций стоит проводить от ветки <code>master</code>.
+Для работы процесса сборки для другой архитектуры (например, <code>aarch64</code>) стоит доустановить пакет <code>qemu-user-static-binfmt-aarch64</code>.
+Пример команды сборки образа:
+<pre>
+$ make DEBUG=1 ARCH=aarch64 BRANCH=p10 APTCONF=/etc/apt/apt.conf.aarch64 alt-server.iso
+</pre>
+Содержимое <code>apt.conf</code> может выглядеть так:
+<pre>
+Dir::Etc::main "/dev/null";
+Dir::Etc::parts "/ver/empty";
+Dir::Etc::SourceParts "/var/empty";
+Dir::Etc::sourcelist "/etc/apt/sources.list.d/alt-aarch64.list";
+APT::Acquire::Retries "3";
+APT::Cache-Limit 201326592;
+//Acquire::http::AllowRedirect "true";
+RPM
+{
+        Allow-Duplicated {
+                // Old-style kernels.
+                "^(NVIDIA_)?(kernel|alsa)[0-9]*(-adv|-linus)?($|-up|-smp|-secure|-custom|-enterprise|-BOOT|-tape|-aureal)";
+                // New-style kernels.
+                "^kernel-(image|modules)-.*";
+        };
+        Hold {
+                // Old-style kernels.
+                "^(kernel|alsa)[0-9]+-source";
+        };
+};
+</pre>
+и главное тут - указатель на файл с <code>sources.list</code> для требуемой архитектуры (<code>/etc/apt/sources.list.d/alt-aarch64.list</code>). Например, вот такого содержания:
+<pre>
+rpm-dir file:/home/username/hasher/repo aarch64 hasher
+rpm [alt] rsync://ftp.altlinux.org/ALTLinux p10/aarch64 classic
+rpm [alt] rsync://ftp.altlinux.org/ALTLinux p10/noarch classic
+</pre>
+Сборка образов может занимать большой объём дискового пространства (например, порядка 100 Гб). Чтобы преодолеть проблему расхода дискового пространства возможно использовать системный файл настроек утилиты <code>hasher-priv</code> - <code>/etc/hasher-priv/system</code>:
+ prefix=/srv/tmp/image-build
+Опция <code>prefix</code> отвечает за локацию, где <code>mkimage-profiles</code> будет проводить сборку образа.
+=== Сборка rootfs для целевой платформы ===
+Конфигурирование целевой rootfs
+Установка QEMU-USER
+ apt-get install qemu-user-static-binfmt-aarch64 qemu-user-static-aarch64
+Монтирование системных файловых систем в rootfs
+ for f in dev dev/pts sys proc run ; do mount --bind /$f /mnt/rootfs/$f ; done
+Переключение в целевую rootfs
+ chroot /mnt/rootfs
+Отключение системных ФС
+ for f in dev/pts dev sys proc run ; do umount /mnt/rootfs/$f ; done
+Если вы хотите переключиться в целевой <code>chroot</code> и поработать, это можно сделать следующим способом:
+ sudo cp /usr/bin/qemu-aarch64-static /mnt/rootfs
+ sudo chroot /mnt/rootfs ./qemu-aarch64-static /bin/bash
+Это позволит на текущей машине запустить шелл rootfs целевой архитеры.
+=== Сборка ядра для целевой платформы ===
+Количество потоков для сборки ядра рекомендуется устанавливать как nproc+1 или даже nproc+2 .
+Для каждой команды необходимо устанавливать две переменных: ARCH и CROSS_COMPILE . В таком случае процедура будет выглядеть примерно так:
+ env ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- scripts/kconfig/merge_config.sh -m config config-aarch64 config-std ${EXTRACONFIGS}
+ env ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- make olddefconfig
+ env ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- make prepare
+ make -j $(($(nproc) + 1)) ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- LOCALVERSION=""
+ make -j $(($(nproc) + 1)) ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- LOCALVERSION="" modules
+ make -j $(($(nproc) + 1)) ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- LOCALVERSION="" dtbs
+ sudo make -j $(($(nproc) + 1)) ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- INSTALL_MOD_STRIP=1 modules_install
+ sudo make -j $(($(nproc) + 1)) ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- install
+ sudo make -j $(($(nproc) + 1)) ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- INSTALL_PATH=/boot/dtb dtbs_install
+make olddefconfig неинтерактивно устанавливает в умолчальные значения пропущенные опции в файле .config .
+==== Опакечивание ядра ====
+Для работы со .spec файлом ядра, в котором много сложных макросов и подстановок, необходимо установить пакет <code>kernel-build-tools</code> и <code>describe-specfile</code> (подпакет <code>gear</code>).
+Предварительно в файл <code>.git/config</code> необходимо добавить секцию:
+ [gear "specsubst"]
+   kflavour = flavourname
+Сделать это можно с помощью команды:
+  git config --local gear.specsubst.kflavour flavourname
+Чтобы сборка началась, необходимо добавить метаданные тега (git тега, который присутствует в репозитории в выводе команды <code>git tag</code> и имеет общую историю с текущим коммитом, где производятся изменения), относительно которого ведётся сборка. Сделать это можно командой:
+  gear-update-tag -avc
+Сборка может производиться в текущем окружении:
+ gear-rpm -v --ba --commit --target=aarch64 --with cross_toolchain_aarch64
+А также может производиться в Hasher chroot:
+ gear -v --commit --hasher -- hsh -v --target=aarch64 --build-args='--with cross_toolchain_aarch64' ~/hasher
+==== Проблемы ====
+Q :
+ BTF: .tmp_vmlinux.btf: pahole (pahole) is not available
+ Failed to generate BTF for vmlinux
+ Try to disable CONFIG_DEBUG_INFO_BTF
+A :
+ # apt-get install dwarves
+Q:
+ macro: %def_disable check not found
+A:
+ Нет ответа.
+Q:
+ usermod: не удалось заблокировать /etc/tcb/username/shadow; попробуйте ещё раз позже.
+A:
+Пользователь не является локальным, а доменным. <code>usermod</code> с таким работать не умеет. Воспользуйтесь утилитой <code>gpasswd</code>:
+<pre>
+# gpasswd -a <username> rpm
+</pre>
+Q:
+ hasher-priv: slave: chrootuid: execve: /.host/entry: Exec format error
+A:
+Если вы собираете пакет под другую архитектуру, то вам требуется доустановить соответствующий пакет с QEMU.
+Q:
+<pre>
+hasher-priv: master: time elapsed limit (600 seconds) exceeded
+</pre>
+A:
+У <code>hasher</code> есть таймаут работы. Чтобы избежать этой проблемы, на сборочной машине предлагается отредактировать файл /etc/hasher-priv/system и добавить следующие настройки:
+<pre>
+wlimit_time_elapsed=360000
+wlimit_time_idle=360000
+</pre>
+Достаточно большой таймаут позволит вам ждать окончания сборки до победы.
+=== ALT RPM Internals ===
+RPM управляет базой данный пакетов и выполняет разрешение зависимостей при установке пакетов.
+RPM не знает, что оно может быть получено путём кросс-компиляции.
+В вот человек выполнял bootstrap для Fedora:
+* https://fedoraproject.org/wiki/Architectures/RISC-V/Bootstrapping
+* https://github.com/rwmjones/fedora-riscv-bootstrap
+=== ALT APT-RPM Internals ===
+APT-RPM управляет получением пакетов из различных источников и впоследствии передаёт пакеты в RPM для дальнейшей обработки. За работу по передаче данных с использованием различных протоколов отвечают подпрограммы-модули, называемые <code>methods</code>.
+=== Развёртывание сборочницы ===
+=== ПО на Join ===
+* https://www.tarsnap.com/open-source.html - Не сам проприетарный Tarsnap, а некоторые его запчасти.
+* https://github.com/Librum-Reader/Librum - Приложение для создания библиотеки, написано с использованием CMake, Qt5 и QML.
+* https://github.com/KDAB/hotspot - Инструмент для анализа производительности построенный поверх perf, похож на flamegraph но на qt.
+* https://github.com/KDAB/GammaRay - Утилита для анализа свойств Qt объектов в запущенном приложении, может дополнять отладчик, упрощая поиск проблем.
+* https://github.com/dhendrix/flashmap - выдирает layout из дампов firmware.
+* https://github.com/PabloCastellano/extract-dtb - выдирает DTB (FDT) из дампов firmware.
+* https://gitlab.com/DavidGriffith/minipro/ - flasher для программатора TL866.
+* https://github.com/sikthehedgehog/mdtools - утилиты для работы с блобами SEGA Mega Drive. Включает утилиту для "добивания нулями" бинарных блобов.
+* https://github.com/flashrom/flashrom - В master репозитория flashrom появились функции для чтения статуса "Write Protect".
+* https://github.com/YosysHQ - опенсорсный тулчейн для синтеза FPGA bitstream.
+* https://github.com/SymbiFlow - опенсорсный тулчейн для работы с FPGA (прошивки, в частности, Lattice iCE40).
+* https://github.com/cpb-/spi-tools - наши уже протухли, надо обновлять.
+* https://github.com/mwelling/spi-test
+* https://github.com/gschorcht/spi-ch341-usb - драйвер для цепляния SPI устройств через чип CH341A
+* https://github.com/blacksphere/blackmagic - Управлящиее ПО и firmware для JTAG отладчика Black Magic Probe
+* https://github.com/VUnit/vunit - фреймворк для Unit-тестов для Verilog.
+* https://github.com/openhab - ПО для работы с хабами ZigBee
+* https://github.com/rdiez/JtagDue - программный JTAG, который делает из Arduino Due эмуляцию Bus Pirate для совместимости с OpenOCD.
+* https://github.com/ProgHQ/open-tl866 - Опенсорсная фирмварь для программаторов TL866.
+* https://github.com/fritzing/fritzing-app - протухла в репозитории.
+* https://github.com/ponyatov/matiec - transpiler для ПЛК.
+* https://github.com/PaulStoffregen/SerialFlash - обвязочка для SPI bit-bang
+* https://github.com/adrian-thurston/ragel - в репозитории версия 6.10, уже есть версия 7.0.4.
+* https://github.com/dimkanovikov/KITScenarist - для написания сценариев, GUI
+* https://github.com/nyousefi/Fountain - почти пром. стандарт для сценариев, CLI
+* https://www.klayout.de/ - супер нужная штука для работы с форматами GDS/GDSII (маски чипов)
+* https://github.com/LibreCAD/libdxfrw - нужна свежая версия для LibreCAD 3.
+* https://github.com/LibreCAD/LibreCAD_3 - сабж.
 [[Категория:Сборка_пакетов]]

%define
Name	Имя пакета. Регистрозависимо. Принято именовать пакеты в нижнем регистре не смотря на названия программ.
Version	Версия программы.
Release
Epoch	Обычно не используется. Вводится в новых сборках пакетов при необходимости даунгрейда пакета (например, когда в новой версии обнаружилась регрессия и надо обновить пакет на старую версию).
Summary	Краткое описание пакета.
License	Краткое название лицензии. Зачастую указывается в виде макроса из пакета `rpm-build-licenses`
Group	Группа пакетов
Url	Ссылка на сайт проекта.
BuildArch	Архитектура, для которой пакет предназначен или `noarch`, если пакет платформо-независимый (например, документация или картинки).
Requires	Зависимости пакета от других пакетов. Рекомендуется указывать по одной зависимости в строчке, так как их изменения удобно отслеживать в истории коммитов.
BuildRequires	Сборочные зависимости пакета. Дополнительные зависимости, которые нужны только для сборки.
BuildRequires(pre)	Сборочные зависимости пакета, которые будут установлены до разбора specfile. Зачастую в этой секции производится установка пакетов с RPM макросами.
Source0	Обычно выглядит как `%name-%version.tar` и представляет из себя название архива с исходниками, который будет распакован в сборочную директорию.
%description
%prep
%install
%files
%changelog

Текущая версия от 15:14, 6 июня 2023

Руководство мейнтейнера ALT Linux

Введение

Кто такой мейнтейнер

Что такое ALT Linux Team

Как стать членом ALT Linux Team

Процедура Join

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

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

Работа с пакетной базой

Введение в Gear-репозитории

Нюансы сборки пакетов

Подготовка локального сборочного окружения

Установка пакетов для разработки

Настройка Git

Настройка RPM

Настройка Hasher

Настройка APT

Настройка SSH

Создание Gear-репозитория из исходных кодов

Файл .gear/tags/list

Файл .gear/rules

specfile

Директивы макропроцессора

Триггеры

Доработка существующего пакета

Процесс работы над Gears

Процесс работы над SRPMS

Отправка пакета в сборочницу

Команды сборочницы

Развёртывание локальной сборочницы

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

Сборка образов с помощью mkimage-profiles

Сборка rootfs для целевой платформы

Сборка ядра для целевой платформы

Опакечивание ядра

Проблемы

ALT RPM Internals

ALT APT-RPM Internals

Развёртывание сборочницы

ПО на Join