adt-run - Интернет в облаке

ПРОГРАММА:

ИМЯ

adt-run - протестировать установленный бинарный пакет с помощью тестов исходного пакета

СИНТАКСИС

adt-run кредита... Напишите нам в чат или Email виртуальный сервер [виртуальный сервер-аргумент...]

ОПИСАНИЕ

adt-run это программа для вызова механизма тестирования пакетов autopkgtest.

autopkgtest - это средство для тестирования двоичных пакетов Debian или Click, установленных на
система (например, тестовая система). Тесты поставляются в исходном пакете.

adt-run запускает каждый тест, предоставленный конкретным пакетом, и сообщает результаты. Это
при необходимости управляет указанным режимом виртуализации и анализирует описание теста
метаданные и организует копирование данных на испытательный стенд и с него по мере необходимости.

См. /Usr/share/doc/autopkgtest/README.running-tests.rst.gz для ознакомления с тем, как
использовать adt-run.

УКАЗАНИЕ ИСПЫТАНИЯ

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

--источник ЦФК
Запускать тесты из исходного пакета Debian ЦФК. По умолчанию также будет собран пакет
и полученные двоичные файлы будут использоваться для удовлетворения тестовых зависимостей; отключить
что, укажите -B/--нет встроенных двоичных файлов вариант раньше.

Порядок важен: каждый --источник параметр должен предшествовать параметрам, чьи
зависимости должны удовлетворяться создаваемыми им двоичными файлами.

- ненастроенное дерево каталог
Указывает, что тесты из незавершенного дерева исходных кодов Debian каталог должен быть запущен.
Это очень похоже на указание --источник за исключением того, что дерево каталогов (которое
должен быть безупречным) вместо пакета с исходным кодом.

- построенное дерево каталог
Указывает, что тесты из построенного дерева исходных кодов Debian каталог должен быть запущен.
Обратите внимание, что все тестовые зависимости удовлетворяются архивными пакетами, если вы не
явно указать локально построенные .debs с - двоичный.

--apt-источник имя_источника_источника
Скачать имя_источника_источника APT-получить источник на стенде и запустите его тесты. Это
аналогично указанию --источник но избегает копирования источника с хоста на
стенд. Возможно построенные двоичные файлы будут использоваться для удовлетворения зависимостей, так как
обычно в этом режиме вы хотите протестировать двоичные файлы из реального архива.

--git-источник URL [название ветви]
Указывает, что тесты из незастроенного дерева исходных кодов Debian из git-cloning URL
должен быть запущен. Если название ветви дана, эта ветка будет извлечена вместо
значение по умолчанию (обычно «мастер»).

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

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

Порядок важен, так как --источник. В частности, если последующий источник
package создаст двоичный файл с тем же именем, который будет использоваться с этого момента, и
дебютантка будут проигнорированы.

--изменения изменения
Указывает, что debs в данных .changes должны использоваться для тестирования
исходный код в этом .changes. Действует так, как если бы вы указали .debs и .dsc
из файла .changes в качестве явных аргументов.

--click-источник кликиrc
Путь для щелчка по дереву источников для последующего - щелкнуть пакет.

- щелкнуть кликпакг
If кликпакг представляет собой файл (* .click), установите данный пакет щелчка на тестовую платформу. Если это
название клика (например, "com.example.myapp"), предположим, что оно уже установлено в
testbed и прочтите с него манифест.

Запустите тесты пакетов щелчков из предыдущего --click-источник. Если источник кликов
каталог не указан явно, он будет загружен в соответствии с
манифест x-источник Вход. В настоящее время единственная поддерживаемая схема: vcs-bzr.

имя файла
Аргументы только для имени файла обрабатываются, как если бы - построенное дерево, --источник, - ненастроенное дерево,
--apt-источник, - двоичный, --изменения, --click-источникили - щелкнуть было указано; в
суть аргумента определяется по форме имени файла. На случай, если
- построенное дерево, либо должна быть указана опция, либо имя файла должно заканчиваться на
слэш; две косые черты в конце означают - ненастроенное дерево. Если данный
в каталоге есть подкаталог "click", он интерпретируется как --click-источник.

ИСПЫТАНИЕ ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Если не указано иное, они влияют на все последующие аргументы теста.

-B | --нет встроенных двоичных файлов
Все встроенные двоичные файлы из последующих --источник or - ненастроенное дерево тестов не будет
встроены или игнорируются, а зависимости удовлетворяются пакетами из архива.
Обратите внимание, что пакеты по-прежнему собираются, если тест требует сборка.

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

--override-control =PATH
Прочтите тестовые метаданные из PATH вместо debian / tests / control (для Debian
sources) или манифест Click для следующего теста.

--testname =ИСПЫТАНИЕ
Запустите в следующем тесте только заданное имя теста (из контрольного файла теста).

ВЕДЕНИЕ ЖУРНАЛА ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Если вы не укажете никакой опции, adt-run только записывает свой вывод / результаты в stderr.

-o директория | --output-dir =директория
Указывает, что тестовые артефакты (stderr и stdout из тестов, файл журнала,
встроенные бинарные пакеты и т. д.) должны быть помещены в указанный каталог. директория нельзя
существовать или быть пустым, иначе adt-run откажется использовать это.

-l журнальный файл | --log-файл =журнальный файл
Указывает, что журнал трассировки должен быть записан в журнальный файл вместо того, чтобы выходной каталог.

--summary =резюме
Указывает, что краткое изложение результата должно быть записано в резюме. События
в аннотации записываются в журнал в любом случае.

-q | --тихий
Не отправляйте копию adt-runпоток журнала трассировки на stderr. Этот вариант не
повлиять на копию, отправленную в журнальный файл or выходной каталог. Обратите внимание, что без следа
logstream может быть очень сложно диагностировать проблемы.

ИСПЫТАНИЕ BED УСТАНОВКА ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

--setup-commands =команды
Run команды после открытия стенда. Это можно использовать, например, для включения дополнительных
подходящие источники, запустите APT-получить обновление или похожие. Если команды это существующее имя файла,
оттуда читаются команды; в противном случае это строка с фактическими командами
который запускается как есть. Имена файлов без каталога будут найдены как в
текущий каталог и в / usr / share / autopkgtest / команды настройки / так что тебе не нужно
чтобы указать полный путь к сценариям установки, поставляемым с autopkgtest.

Этот параметр можно указывать несколько раз.

If --Пользователь предоставляется или испытательный стенд обеспечивает предложенный нормальный пользователь способность,
$ ADT_NORMAL_USER переменная окружения будет установлена ​​для этого пользователя.

Если команды установки влияют на что-либо в загрузочных каталогах (например, / загрузки or
/ lib / systemd / система) и стенд поддерживает перезагрузку, стенд будет
перезагружался после команд установки. Это можно предотвратить, создав файл
/run/autokgtest_no_reboot.stamp.

--apt-обновить | -U
Run APT-получить обновление и APT-получить Dist-Upgrade -y на стенде перед запуском
тесты.

--apt-pocket =pocket [= pkgname, src: srcname, ...]
Добавить подходящие источники для освободить-карман. Это находит первый дебютантка линии в
/ Etc / кв / sources.list который еще не указывает карман и добавляет deb и
deb-src с этим карманом, чтобы /etc/apt/sources.list.d/карман.список. Это также
призывы APT-получить обновление для нового кармана (но ни для чего другого).

Если после = указан список пакетов, настройте привязку к использованию только этих пакетов.
от карман. Запись "src: srcname" распространяется на все бинарные пакеты, созданные этим
источник. Это можно использовать для минимизации зависимостей, взятых из карман так что
обновления пакетов в этом кармане можно тестировать независимо друг от друга на предмет наличия
лучшая изоляция. Внимание: В настоящее время это не решает некоторых ситуаций, когда
зависимости данных пакетов могут быть разрешены только в данном кармане. В
в этом случае привязка apt будет удалена, и установка пакета будет повторена.
со всеми карман.

--copy =HOSTPATH: TESTBEDPATH
Скопируйте файл или каталог с хоста на тестовую площадку после открытия. Это происходит раньше
--setup-команды таким образом, вы можете использовать эти файлы в командах установки.

--env =VAR = значение
Установите произвольную переменную среды в сборке и тестировании. Можно указать несколько
раз.

ПОЛЬЗОВАТЕЛЬ / ПРИВИЛЕГИЯ ОБРАЩЕНИЕ ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

-u пользователь | --user =пользователь
Запускайте сборки и тесты как пользователь на стенде. Для этого нужен root на тестовой системе; если
root на стенде недоступен, тогда сборки и тесты запускаются от имени любого пользователя
при условии.

--gain-root =корень
Приставки debian / rules двоичный с усилением корня. По умолчанию ничего не использовать,
за исключением того, что если --Пользователь поставляется или root на тестовом стенде недоступен
по умолчанию подделка.

ОТЛАДКА ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

--отлаживать|-d
Включите дополнительную отладочную информацию в журнал трассировки. Каждый дополнительный -d
увеличивает уровень отладки; текущий максимум -ддд. Если ты хочешь увидеть
что происходит, -d or -дд is рекомендуется.

--shell-сбой|-s
Запуск интерактивной оболочки на стенде после неудачной сборки, теста или зависимости
установка.

--оболочка
После каждого теста запускайте интерактивную оболочку на стенде.

TIMEOUT ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

- тайм-аут-, которые=секунды
Используйте другой тайм-аут для операций на стенде или с ним. Есть пять
таймауты, на которые влияют пять значений , которые: короткие: предположительно короткие операции вроде
настройка тестовой системы и проверка состояния (по умолчанию: 100 с); устанавливать:
установка пакетов, включая зависимости (по умолчанию: 3,000); тестXNUMX: тестовые прогоны
(по умолчанию: 10,000 XNUMX с); копия: копировать файлы / каталоги между хостом и тестовой системой (по умолчанию:
300 с); а также строить: builds (по умолчанию: 100,000 XNUMX сек). Значение должно быть указано как
целое число секунд.

- коэффициент тайм-аута=двойной
Умножьте все тайм-ауты по умолчанию на указанный коэффициент (см. - тайм-аут-, которые
выше). Затронуты только значения по умолчанию; явные настройки тайм-аута используются точно
как указано.

МЕСТО ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

--set-lang =Langval
При запуске команд на стенде устанавливает ДЛИННЫЙ переменная среды для
Langval. По умолчанию в adt-run это установить на C.UTF-8.

ДРУГИЕ ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

--неавтоматическое управление
Отключите автоматическое создание тестов с помощью autodep8, даже если он установлен. В этом
В этом случае пакеты без тестов будут завершены с кодом 8 («В этом пакете нет тестов»)
все как без autodep8.

- построить-параллельноN
Поставьте parallel = N DEB_BUILD_OPTION для сборки пакетов. По умолчанию это
количество доступных процессоров. Это в основном полезно в контейнерах, где вы можете
ограничивать доступную оперативную память, но не ограничивать количество процессоров.

-h|--Помогите
Показать справку командной строки и выйти.

Виртуализация SERVER

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

Все остальные аргументы и варианты после Напишите нам в чат или Email передаются на виртуализацию
серверная программа. См. Руководства по отдельным серверам, чтобы узнать, как их использовать.

ВЫВОД ФОРМАТ

Во время обычного тестового прогона для каждого теста печатается одна строка. Он состоит из короткого
строка, идентифицирующая тест, некоторые горизонтальные пробелы и либо ПАСС or FAIL причина или
ПРОПУСКАТЬ причина, по которой индикация пройден / не пройден, разделена по любой причине некоторой горизонтальной
пробел.

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

Иногда ПРОПУСКАТЬ будет сообщено, когда название теста неизвестно или нет
применимо: например, когда в пакете нет тестов, или есть тест
строфа, которая содержит функции, не понимаемые этой версией adt-run. В этом случае *
появится там, где должно быть название теста.

If adt-run обнаруживает, что задействованы ошибочные пакеты, он напечатает две строки
обвинять: обвиняемая вещь... и плохой пакет: сообщение. Здесь каждый пробел разделен обвиняемая вещь
один из аргумент:аргумент (представляющий путь, найденный в аргументе командной строки),
ДСК:пакет (имя исходного пакета), деб:пакет (имя двоичного пакета) или, возможно, другое
строки будут определены позднее. Это указывает, какие аргументы и / или пакеты могут иметь
способствовал возникновению проблемы; те, которые обрабатывались совсем недавно и которые
поэтому наиболее вероятные причины проблемы перечислены в последнюю очередь.

КОНФИГУРАЦИЯ FILES

Если вы используете множество опций или нетривиальные аргументы виртуального сервера, вы можете поместить любую часть
командную строку в текстовый файл, по одной строке на каждый параметр. E. g. вы можете создать файл
сид.cfg с содержанием вроде

-s
--output-dir = / tmp / testout
--apt-обновить
Напишите нам в чат или Email
шрот
SID

а затем запустить

adt-run foo_1_amd64.changes @ sid.cfg

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

ВЫХОД статус

0 все тесты пройдены
2 хотя бы один тест пропущен
4 по крайней мере один тест не пройден
6 хотя бы один тест не пройден и хотя бы один тест пропущен
8 нет тестов в этом пакете
12 ошибочная упаковка
16 отказ стенда
20 других неожиданных сбоев, включая неправильное использование

Используйте adt-run онлайн с помощью сервисов onworks.net