diff options
Diffstat (limited to 'documentation/content/ru/books/porters-handbook/testing/_index.adoc')
| -rw-r--r-- | documentation/content/ru/books/porters-handbook/testing/_index.adoc | 459 |
1 files changed, 433 insertions, 26 deletions
diff --git a/documentation/content/ru/books/porters-handbook/testing/_index.adoc b/documentation/content/ru/books/porters-handbook/testing/_index.adoc index 908d299ab0..73b8cdff1f 100644 --- a/documentation/content/ru/books/porters-handbook/testing/_index.adoc +++ b/documentation/content/ru/books/porters-handbook/testing/_index.adoc @@ -1,21 +1,24 @@ --- -title: Глава 9. Тестирование вашего порта -prev: books/porters-handbook/pkg-files +description: 'Тестирование порта FreeBSD' next: books/porters-handbook/upgrading +params: + path: /books/porters-handbook/testing/ +prev: books/porters-handbook/pkg-files showBookMenu: true -weight: 9 -path: "/books/porters-handbook/" +tags: ["testing", "port", "Portclippy", "Portfmt", "Portlint", "poudriere", "sets"] +title: 'Глава 10. Тестирование вашего порта' +weight: 10 --- [[testing]] -= Тестирование вашего порта += Тестирование порта :doctype: book :toc: macro :toclevels: 1 :icons: font :sectnums: :sectnumlevels: 6 -:sectnumoffset: 9 +:sectnumoffset: 10 :partnums: :source-highlighter: rouge :experimental: @@ -57,7 +60,37 @@ endif::[] Если `make describe` выдаёт строчку, а не ошибку, то для вас это пройдёт безболезненно. Обратитесь к файлу [.filename]#bsd.port.mk#, чтобы выяснить значение выдаваемых строк. -Заметьте также, что запуск последней версии `portlint` (как указано в следующем разделе) приведёт к автоматическому запуску команды `make describe`. +Также обратите внимание, что запуск актуальной версии `portlint` (как указано в следующем разделе) приведёт к автоматическому выполнению `make describe`. + +[[make-test]] +== Запуск `make test` + +Даже если порт успешно собирается, рекомендуется убедиться, что программа корректно выполняет свои функции. Если исходный проект предоставляет тесты вместе с программным обеспечением, рекомендуется их запустить и проверить, что всё работает, как ожидается. + +Порт может автоматически включить тесты, используя переменную `TEST_TARGET`. Когда эта переменная установлена, она содержит имя цели тестирования порта. Обычно это просто `test`, но другие варианты включают `tests`, `check` или, в специфических случаях, такие значения, как `run_tests.py`. + +В дополнение к переменной `TEST_TARGET` фреймворк предоставляет следующие переменные для управления выполнением тестов: + +* `TEST_WRKSRC` — это каталог для выполнения тестов. +* `TEST_ENV` содержит дополнительные переменные, которые передаются на этап тестирования. +* `TEST_ARGS` содержит любые дополнительные аргументы, переданные на этапе тестирования. + +Примеры использования этих переменных можно найти в package:cad/xyce[], package:www/libjwt[] и других. + +[NOTE] +==== +Убедитесь, что тесты не ломаются при обновлении порта. +==== + + +[[testing-portclippy]] +== Portclippy / Portfmt + +Эти инструменты поставляются из пакета:ports-mgmt/portfmt[]. + +Portclippy — это линтер, проверяющий, расположены ли переменные в файле [.filename]#Makefile# в правильном порядке согласно crossref:order[porting-order,Порядку переменных в Makefile портов]. + +Portfmt — это инструмент для автоматического форматирования [.filename]#Makefile#. [[testing-portlint]] == Portlint @@ -67,13 +100,13 @@ endif::[] Так как для обнаружения ошибок `portlint` использует эвристические методы, то им могут выдаваться и ошибочные предупреждения. Кроме того, время от времени нечто, отмечаемое как некорректность, из-за ограничений механизма создания портов не может быть сделано никак иначе. Если вы сомневаетесь, то лучше всего спросить в {freebsd-ports}. [[testing-porttools]] -== Port Tools +== Инструменты для работы с портами Программа package:ports-mgmt/porttools[] входит в состав Коллекции Портов. -`port` является сценарием переднего плана, который может упростить вам задачу тестирования. Если вы хотите проверить новый порт или обновить существующий, то вы можете использовать `port test` для проверки вашего порта, включая проверку <<testing-portlint,`portlint`>>. Эта команда также находит и отображает любые файлы, которые невключенные в [.filename]#pkg-plist#. Смотрите следующий пример: +`port` является сценарием переднего плана, который может упростить вам задачу тестирования. Если вы хотите проверить новый порт или обновить существующий, то вы можете использовать `port test` для проверки вашего порта, включая проверку crossref:testing[testing-portlint,`portlint`]. Эта команда также находит и отображает любые файлы, которые невключенные в [.filename]#pkg-plist#. Смотрите следующий пример: -[source,shell] +[source, shell] .... # port test /usr/ports/net/csup .... @@ -91,43 +124,417 @@ endif::[] Проверьте, что ваше приложение не устанавливает чего-либо в каталог [.filename]#/usr/local# вместо `PREFIX`. Наличие явно указанных путей можно быстро проверить следующим образом: -[source,shell] +[source, shell] .... -# make clean; make package PREFIX=/var/tmp/`make -V PORTNAME` +% make clean; make package PREFIX=/var/tmp/`make -V PORTNAME` .... Если что-то было установлено за пределами `PREFIX`, то процесс создания пакета сообщит об отсутствии файлов. Это также стоит проверить с использованием поддержки каталога сборки (смотрите crossref:special[staging, Staging]): -[source,shell] +[source, shell] .... -# make stage && make check-orphans && make package +% make stage && make check-plist && make stage-qa && make package .... -Эти проверки не найдут явно указанных путей внутри файлов порта и не проверят корректность использования `LOCALBASE` в качестве ссылки на файлы из других портов. Порт, временно установленный в [.filename]#/var/tmp/`make -V PORTNAME`#, следует проверять на работоспособность, чтобы убедиться в отсутствии проблем с путями. +* `check-plist` проверяет отсутствующие в plist файлы и файлы в plist, которые не установлены портом. +* `stage-qa` проверяет наличие распространённых проблем, таких как неправильный шебанг (интерпретаторная строка в первой строке скрипта), символьные ссылки, указывающие за пределы stage-директории,файлы с setuid битом и библиотеки с отладочной информацией... -Переменная `PREFIX` не должна задаваться явно в файле [.filename]#Makefile# порта. Пользователи при установке порта могут задать в `PREFIX` свое собственное место, и порт должен учитывать это значение. +Эти тесты не обнаружат жёстко заданные пути в файлах порта, а также не проверят, что `LOCALBASE` используется корректно для ссылок на файлы из других портов. Временно установленный порт в [.filename]#/var/tmp/`make -V PORTNAME`# должен быть протестирован на корректную работу, чтобы убедиться в отсутствии проблем с путями. -Обратитесь к программам/файлам из других портов с переменными, перечисленными выше, без указания явных маршрутов. Например, если ваш порт требует, чтобы макрос `PAGER` являлся полным путем утилиты `less`, не используйте строковый путь [.filename]#/usr/local/bin/less#. Вместо этого используйте `${LOCALBASE}`: +`PREFIX` не должен быть явно установлен в [.filename]#Makefile# порта. Пользователи, устанавливающие порт, могут задать `PREFIX` в другом месте, и порт должен учитывать эту настройку. + +Обращайтесь к программам и файлам из других портов с помощью упомянутых выше переменных, а не явных путей. Например, если порт требует, чтобы макрос `PAGER` содержал полный путь к `less`, не используйте явный путь [.filename]#/usr/local/bin/less#. Вместо этого используйте `${LOCALBASE}`: [.programlisting] .... -DPAGER=\"${LOCALBASE}/bin/less\" .... -Путь с использованием `LOCALBASE` имеет больше шансов оставаться работоспособным, если системный администратор переместил всё дерево [.filename]#/usr/local# куда-то в другое место. +Путь с `LOCALBASE` с большей вероятностью продолжит работать, если системный администратор переместил всё дерево [.filename]#/usr/local# в другое место. -[[testing-tinderbox]] -== Tinderbox +[TIP] +==== +Все эти тесты выполняются автоматически при запуске `poudriere testport` или `poudriere bulk -t`. Настоятельно рекомендуется каждому участнику разработки портов устанавливать и тестировать свои порты с помощью этого инструмента. Дополнительную информацию можно найти в crossref:testing[testing-poudriere, poudriere]. +==== -Если вы алчный контрибутор портов, то вы можете захотеть взглянуть на Tinderbox. Это мощная система построения и тестирования портов. Tinderbox можно установить, используя порт package:ports-mgmt/tinderbox[]. Обязательно прочитайте поставляемую документацию, поскольку конфигурация не является тривиальной. +[[testing-poudriere]] +== poudriere -Для получения подробностей посетите http://tinderbox.marcuscom.com/[вебсайт Tinderbox]. +Для контрибьютора портов poudriere является одним из самых важных и полезных инструментов для тестирования и сборки. Его основные возможности включают: -[[testing-poudriere]] -== Poudriere +* Массовая сборка всего дерева портов, определенных подмножеств дерева портов или отдельного порта с его зависимостями +* Автоматическая упаковка результатов сборки +* Генерация файлов журнала сборки для каждого порта +* Предоставление подписанного репозитория man:pkg[8] +* Тестирование сборки портов перед отправкой патча в трекер ошибок FreeBSD или внесением изменений в дерево портов +* Тестирование успешных сборок портов с использованием различных параметров + +Поскольку poudriere выполняет сборку в чистой среде man:jail[8] и использует возможности man:zfs[8], он имеет несколько преимуществ по сравнению с традиционным тестированием на основной системе: + +* Отсутствие загрязнения основной среды: никаких оставшихся файлов, случайных удалений или изменений существующих конфигурационных файлов. +* Проверяет [.filename]#pkg-plist# на наличие отсутствующих или лишних записей +* Коммиттеры портов иногда запрашивают журнал poudriere вместе с отправкой патча, чтобы оценить, готов ли патч для интеграции в дерево портов + +Также его настройка и использование довольно просты, он не имеет зависимостей и будет работать в любой поддерживаемой версии FreeBSD. В этом разделе показано, как установить, настроить и запустить poudriere в рамках обычного рабочего процесса разработчика портов. + +Примеры в этом разделе показывают стандартную структуру файлов, принятую в FreeBSD. Внесите соответствующие изменения, если у вас используются другие настройки. Дерево портов, обозначаемое как `${PORTSDIR}`, находится в [.filename]#/usr/ports#. По умолчанию `${LOCALBASE}` и `${PREFIX}` указывают на [.filename]#/usr/local#. + +[[testing-poudriere-installing]] +=== Установка poudriere + +poudriere доступен в дереве портов в пакете package:ports-mgmt/poudriere[]. Его можно установить с помощью man:pkg[8] или из портов: + +[source, shell] +.... +# pkg install poudriere +.... + +или + +[source, shell] +.... +# make -C /usr/ports/ports-mgmt/poudriere install clean +.... + +Также существует версия poudriere в разработке, которая в конечном итоге станет следующим релизом. Она доступна в пакете:ports-mgmt/poudriere-devel[]. Эта версия используется для официальных сборок пакетов FreeBSD, поэтому она хорошо протестирована. В ней часто появляются новые интересные функции. Коммиттер портов захочет использовать версию в разработке, так как именно она используется в продакшене и содержит все новые функции, которые гарантируют, что всё будет работать идеально. Контрибьютору не обязательно нужны эти функции, так как наиболее важные исправления переносятся в выпущенную версию. Основная причина использования версии в разработке для сборки официальных пакетов заключается в её скорости — она позволяет сократить время полной сборки с 18 до 17 часов при использовании высокопроизводительного сервера с 32 CPU и 128 ГБ оперативной памяти. Эти оптимизации не будут столь значимы при сборке портов на настольном компьютере. + +[[testing-poudriere-setup]] +=== Настройка poudriere + +Порт устанавливает файл конфигурации по умолчанию, [.filename]#/usr/local/etc/poudriere.conf#. Каждый параметр описан в этом файле конфигурации. + +Вот минимальный пример конфигурационного файла: + +[.programlisting] +.... +ZPOOL=zroot +BASEFS=/usr/local/poudriere +DISTFILES_CACHE=/usr/ports/distfiles +RESOLV_CONF=/etc/resolv.conf +.... + +`ZPOOL`:: +Имя пула хранения ZFS, который будет использовать poudriere. Должно быть указано в выводе команды `zpool status`. + +`BASEFS`:: +Корневая точка монтирования файловых систем poudriere. Эта запись приведет к тому, что poudriere смонтирует `tank/poudriere` в `/poudriere`. + +`DISTFILES_CACHE`:: +Определяет, где хранятся distfiles. В этом примере poudriere и хост используют общий каталог для хранения distfiles. Это позволяет избежать загрузки tарболов, которые уже присутствуют в системе. Пожалуйста, создайте этот каталог, если он ещё не существует, чтобы poudriere мог его найти. + +`RESOLV_CONF`:: +Используйте файл [.filename]#/etc/resolv.conf# хоста внутри клеток для DNS. Это необходимо, чтобы клетки могли разрешать URL-адреса distfiles при загрузке. Это не требуется при использовании прокси. Обратитесь к файлу конфигурации по умолчанию для настройки прокси. + +[[testing-poudriere-create-jails]] +=== Создание клеток poudriere + +Создайте базовые клетки, которые poudriere будет использовать для сборки: + +[source, shell] +.... +# poudriere jail -c -j 131Ramd64 -v 13.1-RELEASE -a amd64 +.... + +Загрузите `13.1-RELEASE` для `amd64` с FTP-сервера, указанного в `FREEBSD_HOST` в [.filename]#poudriere.conf#, создайте ZFS-файловую систему `tank/poudriere/jails/131Ramd64`, смонтируйте её в [.filename]#/poudriere/jails/131Ramd64# и распакуйте тарболлы `13.1-RELEASE` в эту файловую систему. + +[source, shell] +.... +# poudriere jail -c -j 12i386 -v stable/12 -a i386 -m git+https +.... + +Создайте `tank/poudriere/jails/12i386`, смонтируйте его на [.filename]#/poudriere/jails/12i386#, затем извлеките верхушку ветки Git `FreeBSD-12-STABLE` из `GIT_HOST` в [.filename]#poudriere.conf# или по умолчанию `git.freebsd.org` в [.filename]#/poudriere/jails/12i386/usr/src#, после чего выполните `buildworld` и установите его в [.filename]#/poudriere/jails/12i386#. + +[NOTE] +==== +Хотя возможно собрать более новую версию FreeBSD на старой версии, в большинстве случаев она не запустится. Например, если требуется клетка на `stable/13`, то хост также должен работать на `stable/13`. Запуск `13.1-RELEASE` недостаточен. +==== + +[NOTE] +==== +Для создания клетки poudriere для `14.0-CURRENT`: + +[source, shell] +.... +# poudriere jail -c -j 14amd64 -v main -a amd64 -m git+https +.... + +Для запуска клетки `14.0-CURRENT` poudriere хостовая система должна работать под управлением `14.0-CURRENT`. В общем случае, более новые ядра могут собирать и запускать более старые клетки. Например, ядро `14.0-CURRENT` может собирать и запускать клетку `12.4-STABLE`, если параметр ядра `COMPAT_FREEBSD12` был скомпилирован (включен по умолчанию в конфигурации ядра [.filename]#GENERIC# `14.0-CURRENT`). +==== + +Список клеток, известных poudriere, можно вывести с помощью команды `poudriere jail -l`: + +[source, shell] +.... +# poudriere jail -l +JAILNAME VERSION ARCH METHOD +131Ramd64 13.1-RELEASE amd64 ftp +12i386 12.4-STABLE i386 git+https +.... + +[[testing-poudriere-maintaining-jails]] +=== Обновление клеток poudriere + +Управление обновлениями очень простое. Команда: + +[source, shell] +.... +# poudriere jail -u -j JAILNAME +.... + +обновляет указанную клетку до последней доступной версии. Для релизов FreeBSD обновление до последнего уровня исправлений с помощью man:freebsd-update[8]. Для версий FreeBSD, собранных из исходников, обновление до последней ревизии git в ветке. + +[TIP] +==== +Для клеток, использующих метод `git+*`, полезно добавить `-J _КоличествоПараллельныхСборок_` для ускорения сборки за счёт увеличения количества параллельных задач компиляции. Например, если на машине для сборки 6 CPU, используйте: + +[source, shell] +.... +# poudriere jail -u -J 6 -j JAILNAME +.... + +==== + +[[testing-poudriere-ports-tree]] +=== Настройка деревьев портов для использования с poudriere + +Существует несколько способов использования деревьев портов в poudriere. Наиболее простой способ — позволить poudriere создать для себя дерево портов по умолчанию, используя link:{handbook}mirrors/#git[Git]: + +[source, shell] +.... +# poudriere ports -c -m git+https -B main +.... + +Эти команды создают `tank/poudriere/ports/default`, монтируют его в [.filename]#/poudriere/ports/default# и заполняют с помощью Git. После этого он включается в список известных деревьев портов: + +[source, shell] +.... +# poudriere ports -l +PORTSTREE METHOD TIMESTAMP PATH +default git+https 2020-07-20 04:23:56 /poudriere/ports/default +.... + +[NOTE] +==== +Обратите внимание, что дерево портов "default" является особым. Каждая из команд сборки, объяснённых далее, будет неявно использовать это дерево портов, если явно не указано иное. Чтобы использовать другое дерево, добавьте `-p _treename_` к командам. +==== + +Лучший способ работы с локальными изменениями для разработчика портов — использовать link:{handbook}mirrors/#git[Git]. Как и при создании клеток, можно использовать другой метод для создания дерева портов. Чтобы добавить дополнительное дерево портов для тестирования локальных изменений и разработки портов, предпочтительно использовать клонирование дерева через git (как описано выше). + +[[testing-poudriere-ports-tree-manual]] +=== Использование управляемых вручную деревьев портов с помощью poudriere + +В зависимости от рабочего процесса может быть крайне полезно использовать деревья портов, которые поддерживаются вручную. Например, если существует локальная копия дерева портов в [.filename]#/work/ports#, укажите poudriere на это расположение: -Если вы контрибутор портов, подумайте об установке poudriere. Это мощная система для построения и тестирования портов. Poudriere можно установить из package:ports-mgmt/poudriere[]. +[source, shell] +.... +# poudriere ports -c -m null -M /work/ports -p development +.... + +Это будет указано в таблице известных деревьев: + +[source, shell] +.... +# poudriere ports -l +PORTSTREE METHOD TIMESTAMP PATH +development null 2020-07-20 05:06:33 /work/ports +.... + +[NOTE] +==== +Тире или `null` в колонке `METHOD` означает, что poudriere никогда не будет обновлять или изменять это дерево портов. Полностью на пользователе лежит ответственность за поддержку этого дерева, включая все локальные изменения, которые могут использоваться для тестирования новых портов и отправки исправлений. +==== + +[[testing-poudriere-ports-tree-updating]] +=== Обновление деревьев портов poudriere + +Так же просто, как с клетками, описанными ранее: + +[source, shell] +.... +# poudriere ports -u -p PORTSTREE +.... + +Обновит указанное _PORTSTREE_, дерево, указанное в выводе команды `poudriere -l`, до последней доступной ревизии на официальных серверах. + +[NOTE] +==== +Деревья портов без метода, см. crossref:testing[testing-poudriere-ports-tree-manual, Использование вручную управляемых деревьев портов с помощью poudriere], не могут быть обновлены таким образом и должны обновляться вручную сопровождающим портов. +==== + +[[testing-poudriere-testing-ports]] +=== Тестирование портов + +После настройки клеток и деревьев портов можно проверить результат изменений, внесенных участником в дерево портов. + +Например, локальные изменения в порте package:www/firefox[], расположенном в [.filename]#/work/ports/www/firefox#, можно протестировать в ранее созданной клетке 13.1-RELEASE: + +[source, shell] +.... +# poudriere testport -j 131Ramd64 -p development -o www/firefox +.... + +Это соберет все зависимости Firefox. Если зависимость уже была собрана ранее и остается актуальной, будет установлен готовый пакет. Если для зависимости нет актуального пакета, он будет собран с параметрами по умолчанию в клетке. Затем будет собран сам Firefox. + +Полная сборка каждого порта записывается в [.filename]#/poudriere/data/logs/bulk/131Ri386-development/build-time/logs#. + +Имя каталога `131Ri386-development` формируется из аргументов `-j` и `-p` соответственно. Для удобства также поддерживается символическая ссылка [.filename]#/poudriere/data/logs/bulk/131Ri386-development/latest#. Эта ссылка указывает на последний каталог _времени сборки_. Также в этом каталоге находится файл [.filename]#index.html#, который позволяет наблюдать за процессом сборки через веб-браузер. + +По умолчанию poudriere очищает клетки и оставляет файлы журналов в указанных выше каталогах. Для упрощения анализа клетки можно оставить запущенными после сборки, добавив `-i` к `testport`: + +[source, shell] +.... +# poudriere testport -j 131Ramd64 -p development -i -o www/firefox +.... + +После завершения сборки, независимо от того, была ли она успешной, в клетке предоставляется оболочка. Эта оболочка используется для дальнейшего исследования. Можно указать poudriere оставить клетку запущенной после завершения сборки с помощью `-I`. poudriere покажет команду для выполнения, когда клетка больше не нужна. Затем можно использовать man:jexec[8] для входа в неё: + +[source, shell] +.... +# poudriere testport -j 131Ramd64 -p development -I -o www/firefox +[...] +====>> Installing local Pkg repository to /usr/local/etc/pkg/repos +====>> Leaving jail 131Ramd64-development-n running, mounted at /poudriere/data/.m/131Ramd64-development/ref for interactive run testing +====>> To enter jail: jexec 131Ramd64-development-n env -i TERM=$TERM /usr/bin/login -fp root +====>> To stop jail: poudriere jail -k -j 131Ramd64 -p development +# jexec 131Ramd64-development-n env -i TERM=$TERM /usr/bin/login -fp root +# [do some stuff in the jail] +# exit +# poudriere jail -k -j 131Ramd64 -p development +====>> Umounting file systems +.... + +Неотъемлемой частью инфраструктуры сборки портов FreeBSD является возможность настройки портов под личные предпочтения с помощью опций. Их также можно тестировать с помощью poudriere. Добавление опции `-c`: + +[source, shell] +.... +# poudriere testport -j 131Ramd64 -c -o www/firefox +.... + +Представляет диалог настройки порта перед его сборкой. Порты, указанные после `-o` в формате `_категория_/_имя_порта_`, будут использовать указанные опции, все зависимости будут использовать опции по умолчанию. Тестирование зависимых портов с нестандартными опциями может быть выполнено с использованием наборов, см. crossref:testing[testing-poudriere-sets, Использование наборов]. + +[TIP] +==== +При тестировании портов, где файл [.filename]#pkg-plist# изменяется во время сборки в зависимости от выбранных опций, рекомендуется выполнить тестовый запуск со всеми выбранными опциями _и_ один без выбранных опций. +==== + +[[testing-poudriere-sets]] +=== Использование наборов + +Для всех действий, связанных со сборкой, можно указать так называемый _набор_ с помощью `-z _имя_набора_`. Набор относится к полностью независимой сборке. Это позволяет, например, использовать `testport` с нестандартными параметрами для зависимых портов. + +Для использования наборов poudriere ожидает, что будет использована структура каталогов, аналогичная `PORT_DBDIR`, по умолчанию [.filename]#/var/db/ports#, в его конфигурационной директории. Этот каталог затем монтируется с помощью man:nullfs[5] в клетки, где собираются порты и их зависимости. Обычно подходящую начальную точку можно получить, рекурсивно скопировав существующий `PORT_DBDIR` в [.filename]#/usr/local/etc/poudriere.d/jailname-portname-setname-options#. Это подробно описано в man:poudriere[8]. Например, для тестирования package:www/firefox[] в определённом наборе с именем `devset`, добавьте параметр `-z devset` к команде `testport`: + +[source, shell] +.... +# poudriere testport -j 131Ramd64 -p development -z devset -o www/firefox +.... + +Это проверит наличие этих каталогов в следующем порядке: + +* [.filename]#/usr/local/etc/poudriere.d/131Ramd64-development-devset-options# +* [.filename]#/usr/local/etc/poudriere.d/131Ramd64-devset-options# +* [.filename]#/usr/local/etc/poudriere.d/131Ramd64-development-options# +* [.filename]#/usr/local/etc/poudriere.d/devset-options# +* [.filename]#/usr/local/etc/poudriere.d/development-options# +* [.filename]#/usr/local/etc/poudriere.d/131Ramd64-options# +* [.filename]#/usr/local/etc/poudriere.d/options# + +Из этого списка poudriere man:nullfs[5] монтирует _первое существующее_ дерево каталогов в директорию [.filename]#/var/db/ports# сборных клеток. Таким образом, все пользовательские настройки используются для всех портов во время этого запуска `testport`. + +После предоставления структуры каталогов для набора можно изменить параметры для конкретного порта. Например: + +[source, shell] +.... +# poudriere options -c www/firefox -z devset +.... + +Отображается диалог настройки package:www/firefox[], где можно редактировать параметры. Выбранные параметры сохраняются в набор `devset`. + +[NOTE] +==== +poudriere очень гибок в настройке опций. poudriere можно настроить для конкретных клеток, деревьев портов и для нескольких портов одной командой. Подробности см. в man:poudriere[8]. +==== + +[[testing-poudriere-make-conf]] +=== Предоставление пользовательского файла [.filename]#make.conf# + +Подобно использованию наборов, poudriere также использует пользовательский [.filename]#make.conf#, если он предоставлен. Для этого не требуется специального аргумента командной строки. Вместо этого poudriere ищет существующие файлы, соответствующие схеме именования, производной от командной строки. Например: + +[source, shell] +.... +# poudriere testport -j 131Ramd64 -p development -z devset -o www/firefox +.... + +заставляет poudriere проверять наличие этих файлов в следующем порядке: + +* [.filename]#/usr/local/etc/poudriere.d/make.conf# +* [.filename]#/usr/local/etc/poudriere.d/devset-make.conf# +* [.filename]#/usr/local/etc/poudriere.d/development-make.conf# +* [.filename]#/usr/local/etc/poudriere.d/131Ramd64-make.conf# +* [.filename]#/usr/local/etc/poudriere.d/131Ramd64-development-make.conf# +* [.filename]#/usr/local/etc/poudriere.d/131Ramd64-devset-make.conf# +* [.filename]#/usr/local/etc/poudriere.d/131Ramd64-development-devset-make.conf# + +В отличие от наборов, все найденные файлы будут добавлены, _в указанном порядке_, в один [.filename]#make.conf# внутри клеток сборки. Таким образом, можно задать общие переменные make, предназначенные для влияния на все сборки, в файле [.filename]#/usr/local/etc/poudriere.d/make.conf#. Специальные переменные, предназначенные только для определённых клеток или наборов, можно задать в специализированных файлах [.filename]#make.conf#, например, в [.filename]#/usr/local/etc/poudriere.d/131Ramd64-development-devset-make.conf#. + +[[testing-poudriere-sets-perl]] +.Использование [.filename]#make.conf# для изменения Perl по умолчанию +[example] +==== + +Для сборки набора с нестандартной версией Perl, например, `5.20`, используя набор с именем `perl5-20`, создайте файл [.filename]#perl5-20-make.conf# со следующей строкой: + +[.programlisting] +.... +DEFAULT_VERSIONS+= perl=5.20 +.... +[NOTE] +**** +Обратите внимание на использование `+=`, чтобы содержимое переменной не было перезаписано, если она уже установлена в стандартном [.filename]#make.conf#. +**** + +==== + +[[testing-poudriere-pruning-distfiles]] +=== Удаление ненужных файлов дистрибутива + +poudriere имеет встроенный механизм для удаления устаревших файлов дистрибутива, которые больше не используются ни одним портом данного дерева. Команда + +[source, shell] +.... +# poudriere distclean -p portstree +.... + +будет сканировать папку файлов дистрибутива, `DISTFILES_CACHE` в [.filename]#poudriere.conf#, сравнивая ее с деревом портов, указанным аргументом `-p _portstree_`, и запрашивать подтверждение на удаление этих файлов дистрибутива. Чтобы пропустить запрос и удалить все неиспользуемые файлы без подтверждения, можно добавить аргумент `-y`: + +[source, shell] +.... +# poudriere distclean -p portstree -y +.... + +[[testing-debugging-ports]] +== Отладка портов + +Иногда что-то идёт не так, и порт не работает во время выполнения. Фреймворк предоставляет некоторые средства для отладки портов. Эти вспомогательные инструменты ограничены, поскольку способ отладки порта во многом зависит от используемой технологии. Следующие переменные помогают в отладке портов: + +* `WITH_DEBUG`. Если установлено, порты собираются с отладочными символами. +* `WITH_DEBUG_PORTS`. Указывает список портов, которые должны собираться с установленным `WITH_DEBUG`. +* `DEBUG_FLAGS`. Используется для указания дополнительных флагов для `CFLAGS`. По умолчанию `-g`. + +Когда `WITH_DEBUG` установлен, глобально или для списка портов, результирующие бинарные файлы не лишаются символов. + +Эти переменные могут быть указаны в [.filename]#make.conf# или в командной строке: + +[source, shell] +.... +# cd category/port && make -DWITH_DEBUG DEBUG_FLAGSS="-g -O0" +.... + +[NOTE] +==== +Если порт собирается с использованием package:ports-mgmt/poudriere[], отладочные переменные должны быть указаны в [.filename]#make.conf# poudriere, а не в [.filename]#/etc/make.conf#. Подробности см. в документации package:ports-mgmt/poudriere[]. +==== -Для получения подробной информации посетите http://fossil.etoilebsd.net/poudriere[вебсайт Poudriere]. +Пожалуйста, обратитесь к отладочной информации в extref:{developers-handbook}tools[Руководстве разработчика, отладка] для получения более подробной информации о доступных инструментах отладки. |