Check-unmets

{{DISPLAYTITLE:check-unmets}}

<tt>'''check-unmets'''</tt> — это пакет программ, призванных облегчить массовое обновление репозитория, содержащегося на базе [[girar]]. Такое массовое обновление может возникнуть, например, при портировании репозитория на другую аппаратную архитектуру. Пакет включает в себя средства для автоматического выявления проблем, информировании о выявленных проблемах через web-интерфейс и решения  выявленных проблем в автоматическом и полуавтоматическом режимах. В настоящее время пакет <tt>check-unmets</tt> используется в проекте [[Ports/arm]].

Инструментарий пакета можно разделить на две категории:

* инструменты, облегчающие обслуживание и реформирование репозитория;
* инструменты для анализа пакетных зависимостей и помощи в формировании сборочных заданий.

== Обслуживание репозитория ==

Подсистема обслуживания репозитория состоит из следующих компонентов:

* '''интерфейс пользователя''' — программа для вывода информации о заданиях и предлагаемых сценариев продолжения сборки;

* '''база данных заданий''' — подсистема для хранения информации о сборочных заданиях, ошибках сборки и предполагаемых путях их устранения;

* '''анализатор заданий''' — программа, актуализирующая информацию о задании на основании анализа его структурных элементов и журнала;

* '''резолвер''' — программа, призванная разрешать проблемы, связанные с неудовлетворёнными межпакетными зависимостями, возникающими при сборке.

=== Интерфейс пользователя ===

==== Описание страниц ====

[[Файл:Check-unmets-tasklist.png|200px|thumb|right|Пример заглавной страницы интерфейса пользователя]]
На страницы пользовательского интерфейса информация о сборочных заданиях выводится в табличной форме.
Помимо данных, непосредственно характеризующих задание, выводится информация о выявленных в процессе сборки ошибках, неудовлетворённых межпакетных зависимостях и найденных пакетах-кандидатах, предоставляющих недостающие компоненты. Эта информация сопровождается ссылками на те сборочные задания, в рамках которых предпринимались попытки собрать пакеты-кандидаты.

На заглавную страницу выводится информация о '''недавних сборочных заданиях''', начиная с самых новых. Вверху страницы выводится заголовок с пояснениями и сводка по общему числу проблемных заданий, заданий, рекомендуемых к перезапуску, пакетов, ожидающих портирования и пакетов, которые должны быть удалены. Сводка сопровождается ссылками на другие страницы интерфейса, на которые выводится информация о заданиях, соответствующих определённым дополнительным критериям и сценарии, рекомендующие к запуску новые задания.

На одну из дополнительных страниц выводится таблица с заданиями, которые система '''рекомендует к перезапуску'''. Отбираются не прошедшие сборку задания, для которых на данный момент удовлетворены зависимости на все те компоненты, которых ранее не хватало. Кроме табличной формы, может быть выведен готовый к запуску сценарий оболочки, позволяющий перезапустить задания. Для старых заданий, информация о которых сохранилась только в базе данных, вместо команд перезапуска выводятся команды, добавляющие в очередь новые задания, аналогичные старым. Для предотвращения многократного перезапуска одних и тех же заданий, из выборки можно исключить задания, запускавшиеся более заданного количества раз. Предусмотрены параметры для настройки сценариев под учётную запись определённого пользователя сборочной системы.

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

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

Некоторые пакеты могут иметь зависимости на несуществующие или недоступные компоненты. Такие пакеты должны быть либо обновлены, и тогда они рекомендуются к портированию, либо, в ряде случаев, удалены. Для этой цели существует дополнительная страница интерфейса, на которую выводится сценарий на '''удаление пакетов'''.

==== Методика работы ====

Сборочные задания на портирование пакетов добавляются обычным образом, через командный интерфейс сборочной системы. Результат обработки заданий оценивается по таблице на заглавной странице интерфейса. Следует периодически просматривать информацию о сборках, обращая особое внимание на отмеченные красным цветом неудачные сборки, имеющие статус «failed». Если для сборки были выявлены неудовлетворённые зависимости на определённые компоненты системы, следует дождаться когда эта информация будет обработана резолвером. После этого, выявленные резолвером недостающие исходные пакеты следует добавить в очередь сборки, если это не было сделано ранее. Для этого можно воспользоваться готовым сценарием на дополнительной странице. Если анализ показал, что все компоненты, которые ранее отсутствовали в репозитории, к настоящему моменту уже предоставляются одним или более пакетами, то сборочное задание следует перезапустить, для чего можно воспользоваться готовым сценарием на дополнительной странице. Следует периодически просматривать сценарий удаления пакетов и вводить в систему указанные там команды, очищая репозиторий от ошибочных сборок и старых пакетов, блокирующих сборку новых. Проблемы, не связанные с неудовлетворёнными зависимостями требуют непосредственного анализа журнальных файлов.

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

==== Ограничения ====

* Программа поддерживает только СУБД MySQL.
* Доступ к БД производится по жёстко закодированным реквизитам.

=== База данных заданий ===

==== Таблицы ====

* <code>'''tasks'''</code> — Общие данные о сборочном задании:
** <code>id</code> — номер задания в сборочной системе;
** <code>try</code> — порядковый номер попытки;
** <code>owner</code> — имя пользователя, добавившего задание в очередь;
** <code>status</code> — статус задания;
** <code>failed</code> — наименование этапа на котором сборка завершилась с ошибкой;
** <code>details</code> — набор кратких цитат из журнала сборки, предположительно связанных с неудачей;
** <code>modify</code> — верменно́й штамп.
* <code>'''gears'''</code> — Данные о подзадании, обрабатываемом в рамках задания:
** <code>task</code> — номер задания в сборочной системе (соответствует полю <code>id</code> таблицы <code>tasks</code>);
** <code>type</code> — тип подзадания (сборка из <code>[[gear]]</code>-репозитория, сборка из SRPM, удаление пакета);
** <code>name</code> — имя репозитория или пакета;
** <code>tagname</code> — имя тега (для сборок из <code>gear</code>);
** <code>status</code> — статус обработки подзадания;
** <code>package</code> — имя пакета без версии;
** <code>version</code> — версия пакета.
* <code>'''task_missing'''</code> — Данные о недостающем для выполнения задания компоненте:
** <code>task_id</code> — номер задания в сборочной системе (соответствует полю <code>id</code> таблицы <code>tasks</code>);
** <code>type</code> — тип зависимости (непосредственная — <code>m</code>, опосредованная — <code>u</code>);
** <code>requisite</code> — выражение, определяющее имя и границы версии компонента;
** <code>consumer</code> — имя и версия пакета, непосредственно требующего компонент.
* <code>'''resolve'''</code> — Данные о найденных пакетах-кандидатах, предоставляющих определённый компонент:
** <code>requisite</code> — выражение, определяющее имя и границы версии компонента (соответствует одноимённому полю таблицы <code>task_missing</code>);
** <code>package</code> — имя пакета без версии;
** <code>version</code> — версия пакета;
** <code>type</code> — тип разрешения зависимости (локальный — <code>L</code> или удалённый — <code>R</code>).
* <code>'''actions'''</code> — Очередь операций:
** <code>time</code> — верменно́й штамп;
** <code>package</code> — имя пакета без версии;
** <code>version</code> — версия пакета;
** <code>action</code> — код операции (<code>r</code> — удаление с последующей пересборкой, <code>d</code> — удаление).

=== Анализатор заданий ===

Программа '''<code>update-tasks'''</code> используется для добавление в БД заданий информации о задании и последующего её обновления (актуализации).

==== Функциональные блоки ====

'''Анализ структурных элементов задания''' включает в себя анализ файлов и поддиректорий в директории соответствующей номеру задания, без анализа журнальных файлов. В результате анализа определяется номер задания, его статус и параметры составляющих его подзаданий. На основании успешно собранных исходных пакетов актуализируется информация об имени и версии каждого из них. Данная процедура полезна по той причине, что до фактической сборки исходного пакета, в качестве его имени и версии используется наименование <code>gear</code>-репозитория и имя сборочного тега.

На основании полученных данных заполняются записи в таблицах <code>tasks</code> и <code>gears</code>.

'''Анализ журналов сборки''' включает в себя:
;scan_fails :выявление этапов сборки, завершившихся неудачно;
;scan_missing :поиск информации о недостающих компонентах системы, необходимых для выполнения сборочного задания;
;scan_unmets :поиск информации о недостающих компонентах системы, выявленных в процессе установки пакетов;
;scan_makerrs :выявление целей <tt>Makefile</tt>, завершившихся неудачно;
;scan_chkerrs :выявление проверок <tt>Sisyphus-check</tt>, завершившихся неудачно.
Анализ производится преимущественно регулярными выражениями.

На основании полученных данных дополняется запись в таблице <code>tasks</code> и таблица <code>task_missing</code>.

==== Точки вызова ====

Следует настроить сборочную систему так, чтобы программа <code>update-tasks</code> вызывалась как минимум, при:
* постановке задания в очередь (пример модификации сценария [http://git.altlinux.org/people/manowar/packages/?p=girar.git;a=patch;h=311de20524534a85ef6e24390026aa2e4e3247c3 <code>girar-task-run</code>]);
* при выборе сборочного задания для обработки (пример модификации сценария [http://git.altlinux.org/people/manowar/packages/?p=girar-builder.git;a=patch;h=861b75ddb210ebc97f936065e17a9d13de880dd0 <code>gb-select-task</code>]);
* после обработки сборочного задания (пример модификации сценария [http://git.altlinux.org/people/manowar/packages/?p=girar-builder.git;a=patch;h=07b004ec2b362c84b1db9bd5efda9866c111208a <code>gb-run-task</code>]).

В настоящее время инструментарий не предусматривает специальной программы для удаления записи о задании из БД, однако это может быть сравнительно просто достигнуто несколькими вызовами утилиты <code>mysql</code>. Пример модификации сценария [http://git.altlinux.org/people/manowar/packages/?p=girar.git;a=patch;h=d012fe298f8790e86faefb6ec1c3e3bbfb74d69e <code>girar-task-rm</code>] для удаления связанных с заданием записей при его явном удалении из очереди.

==== Ограничения ====

* Программа поддерживает только СУБД MySQL.
* По причине неразвитого интерфейса командной строки доступ к БД производится по жёстко закодированным реквизитам.

=== Резолвер ===

Программа <code>check-unmets</code> имеет несколько режимов работы, и один из них — запуск программы <code>apt-resolve-db</code>, фиксирующей в БД информацию о возможных путях разрешения неудовлетворённых межпакетных зависимостей, полученную посредством использования функциональных средств библиотечного модуля <code>[[AptResolve.pm]]</code>.

Исходными данными для запуска программы являются конфигурационные файлы подсистемы <code>apt</code> для исходного и целевого репозиториев, и база данных заданий.

==== Алгоритм разрешения зависимостей ====

* Из таблицы <code>resolve</code> удаляются все записи, связанные с последними известными неудачными попытками сборки пакетов — эта информация должна быть актуализирована.
* Последовательно обрабатываются все записи таблицы <code>task_missing</code> не имеющие соответствий в таблице <code>resolve</code>.
** Прежде всего, каждая зависимость проверяется на действительность и актуализируется: за время, прошедшее с момента фиксации зависимости она могла измениться или пакет мог вовсе утратить её в результате пересборки.
*** Если актуальная зависимость не обнаружена, то она фиктивно разрешается сама на себя;
*** иначе данные о зависимости актуализируются, что, в частности, может привести к уточнению требуемой версии компонента;
** Далее производится поиск пакетов, удовлетворяющих данную зависимость в целевом (локальном) репозитории.
*** Если пакет-кандидат, предоставляющий компонент, был найден, то зависимость разрешается на этот пакет с указанием типа (<code>l</code>).
** Затем поиск пакета-кандидата производится в исходном (удалённом) репозитории.
*** Если пакет-кандидат был обнаружен там, то зависимость разрешается на этот пакет с указанием типа (<code>r</code>).
** Если ни один пакет-кандидат так и не был найден, но известен пакет, непосредственно требующий недостающий компонент, то выполняется проверка наличия данной неудовлетворённой зависимости в исходном репозитории.
*** Если в исходном репозитории аналогичный пакет не имеет данной зависимости, то делается вывод о том, что данный пакет в целевом репозитории либо устарел, либо был некорректно собран.
**** При наличии в исходном репозитории более старшей версии пакета по сравнению с целевым репозиторием, исходные данные о неодовлетворённой зависимости подменяются зависимостью на более новую версию пакета, что должно вызвать рекомендацию данной версии пакета к портированию.
**** При равенстве версий пакетов в исходном и целевом репозиториях, делается вывод о том, что пакет в целевом репозитории был некорректно собран, должен быть удалён и собран вновь. Данные о соответствующей операции добавляются в таблицу операций.
*** Если неудовлетворённая зависимость имеет место быть и в исходном репозитории, то на этот счёт делается веское предупреждение.
*** В том случае, если в исходном репозитории аналогичный пакет попросту отсутствует, то делается вывод о том, что пакет должен быть удалён и из целевого репозитория. Данные о соответствующей операции добавляются в таблицу операций.
** В случае, если пакет, непосредственно требующий недостающий компонент, отсутствует в целевом репозитории (очевидно, был удалён), то запись о неудовлетворённой зависимости удаляется.

==== Точки вызова ====

Следует настроить сборочную систему так, чтобы резолвер запускался в тех случаях, когда известно, что состояние репозитория изменилось. Например, после того, как некоторый пакет был успешно собран и добавлен в репозиторий. Видимо, следует ограничить количество таких запусков в единицу времени, поскольку работа резолвера требует достаточно больших вычислительных ресурсов. Пример модификации сценария [http://git.altlinux.org/people/manowar/packages/?p=girar-builder.git;a=patch;h=9ee2a59f378e1aea0e4e5885518bbc0f325257c7 <code>gb-run-task</code>] для запуска резолвера в случае успешной сборки задания, но не чаще одного раза в час.

== Базовый инструментарий ==

Пакет содержит ряд программ, основанных на [[AptResolve.pm]], для поддержки исследования межпакетных зависимостей и портирования пакетов.

=== Поиск пакетов ===

;apt-resolve :Выполняет поиск информации о бинарных или исходных пакетах по различным критериям. Поиск может выполняться по имени бинарного пакета, имени файла из пакета, имени предоставляемого символа. Поиск может быть ограничен по версии пакета или символа.
;apt-resolve-db :Специфичная программа для разрешения неудовлетворённых зависимостей в БД заданий (см. п. [[#Резолвер|Резолвер]]).
;apt-depends :Проверяет наличие у указанного пакета указанной зависимости и возвращает уточнённую зависимость.
;check-unmets :Является полезной обёрткой для вызова <tt>apt-resolve</tt> и <tt>apt-resolve-db</tt>, подготавливающей независимые конфигурации для подсистемы <tt>apt</tt> на основании файлов <tt>apt.conf</tt> посредством утилиты <tt>[[mkaptbox]]</tt>.

=== Анализ межпакетных зависимостей ===

;apt-env :Программа для расчёта набора бинарных пакетов (окружения), необходимого для установки в чистую систему одного указанного или нескольких, порождаемых определённым исходным пакетом, бинарных пакетов или сборки исходного пакета. Программа может работать с парой репозиториев «исходный-целевой», указывая какие пакеты присутствуют только в исходном репозитории и, видимо, должны быть портированы. Есть возможность специальной обработки зависимостей на символы <tt>glibc</tt>, которые, как известно, могут иметь различные представления на различных архитектурах.

=== Помощь при портировании пакетов ===

;plan-girar-task :Программа для расчёта набора сборочных заданий, необходимых для портирования указанного исходного пакета. При расчёте выявляются нециклические и циклические сборочные и установочные зависимости. Кроме основного вывода, программа может записывать фиктивный сборочный журнал задания, в который помещаются сообщения о неудовлетворённых нециклических зависимостях. Такой журнал позволяет избежать лишней сборочной итерации и предоставляет информацию о недостающих компонентах системе обслуживания репозитория. Для полностью архитектурно-независимых пакетов существует возможность избежать анализа сборочных зависимостей. Такие пакеты программа рекомендует к копированию.
;pkgreport :Программа выполняет поиск бинарных или исходных пакетов в указанном репозитории по списку бинарных пакетов, выводя таблицу несоответствий. Применяется для ответа на вопрос о возможности сборки дистрибутива, определённого данным профилем на данном репозитории.

== Исходный код ==

* [http://git.altlinux.org/people/manowar/packages/?p=check-unmets.git check-unmets]

== Лицензия ==

* GPL версии 2 и выше.

[[Категория:Sisyphus]]
[[Категория:git.alt]]