plainbox-run - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

plainbox-run - запустити тестове завдання

СИНТАКСИС

plainbox run [-h] [--неінтерактивний] [-n] [--dont-suppress-output]
[-f ФОРМАТ] [-p ПАРАМЕРИ] [-o ФАЙЛ] [-t ТРАНСПОРТ]
[--transport-where ДЕ] [--transport-options ВАРІАНТИ]
[-T TEST-PLAN-ID] [-i ШАБЛОН] [-x ШАБЛОН] [-w БІЛИЙ СПИСОК]

ОПИС

Виконайте тестове завдання

Ця команда запускає нуль або більше завдань Plainbox як частину одного сеансу та зберігає
результати випробувань. Plainbox під час виконання буде дотримуватися наступного високорівневого алгоритму
цієї команди.

1. Проаналізуйте аргументи командного рядка та подивіться, чи є сеанс, який можна відновити (див
ВІДНОВЛЕННЯ нижче). Якщо так, запропонуйте користувачеві відновити цей сеанс. Якщо резюме
не вдалося перейти до наступної кваліфікаційної сесії. Нарешті запропонуйте створити новий
сесія

2. Якщо сеанс відновлюється, відтворіть ефекти виконання сеансу з
стан на диску. Це відтворює створені робочі місця та повторно вводить ті самі ресурси
стан сесії. Іншими словами, жодна робота, яка виконувалася в минулому, не виконується повторно.

Якщо відновлений сеанс мав виконати завдання, запропонуйте його пропустити. Це
дозволяє операторам тестування пропускати завдання, які в минулому призводили до збою системи
(наприклад, тести призупинення системи)

Якщо сеанс не відновлюється (було створено новий сеанс), встановіть параметр неповний
прапор

3. Використовуйте вибір роботи (див ВИБІР РОБОТА нижче), щоб отримати список виконання. Цей крок
передбачає розв’язання залежностей роботи та зміну порядку робіт, якщо потрібно.

4. Дотримуйтесь списку виконання, якщо можливо, виконуючи кожне завдання послідовно. Робота може бути загальмована
від виконання залежностями з невдачею або не вдалося (оцінка результату не відповідає дійсності)
вирази ресурсів.

Якщо в будь-який момент нова робота знову вводиться в систему (див ЗГОНОВЕНО РОБОТА
нижче), потім цикл припиняється, а керування повертається до кроку 3 для повторного вибору завдань.
Наявні результати не відкидаються, тому завдання, які вже мають певні результати, не відкидаються
страчений знову.

Перед і після виконання будь-якого завдання стан сеансу зберігається на диску, щоб дозволити його відновлення
із завдання, яке якимось чином виводить з ладу систему або сам Plainbox.

5. Видаліть неповний прапор

6. Експортуйте стан сеансу в потрібний формат (див ЕКСПОРТ РЕЗУЛЬТАТИ) і використовувати
потрібний транспорт для відправки результатів (див ТРАНСПОРТУВАННЯ РЕЗУЛЬТАТИ).

7. Встановіть представлений прапор

ВИБІР РОБОТА
Plainbox пропонує два механізми вибору завдань. Обидва можна використовувати одночасно, обидва
можна використовувати кілька разів.

вибирає роботи з моделі
Перший механізм розкривається через --include-шаблон ПАТЕРН параметр командного рядка.
Це вказує Plainbox вибрати будь-яка робота, повний ідентифікатор якої відповідає
регулярне вираження ПАТЕРН.

Вибрані таким чином роботи будуть, якщо можливо, впорядковані відповідно до порядку команди
рядкові аргументи. Наприклад, наявність наступного командного рядка запустить завдання Foo
перед виконанням завдання бар:
plainbox run -i '.*::foo' -i '.*::bar'

вибирає роботи з білі списки
Другий механізм - це --білий список БІЛИЙ СПИСОК параметр командного рядка. Білі списки (або
плани тестування, з якими дещо легше зв’язатися). Білі списки — це прості текстові файли
складається зі списку регулярних виразів, ідентичних тим, які можуть передаватися з
-i варіант.

На відміну від -i але існує два види білих списків. Окремі білі списки є
не пов’язаний з жодним постачальником Plainbox. Такі білі списки можна поширювати повністю
окремо від будь-якого іншого компонента і, таким чином, не мають зв'язку з будь-яким простором імен.

Таким чином, будьте кваліфікованими, кожен шаблон повинен включати як простір імен, так і
компоненти часткового ідентифікатора. Наприклад, це дійсний повний білий список:

2013.com.canonical.plainbox::stub/.*

Він однозначно вибере деякі вакансії зі спеціального внутрішнього постачальника StubBox
який вбудований у Plainbox. Його можна зберегти під будь-яким іменем файлу та зберігати в будь-якому
каталог, і він завжди вибиратиме той самий набір завдань.

Навпаки, білі списки, які пов’язані з певним постачальником, зберігаючись у них
кожного постачальника білі списки/ каталог, несуть неявний простір імен. Такі білі списки є
зазвичай пишеться без згадки про компонент простору імен.

Наприклад, той самий шаблон "stub/.*" можна скоротити до:

заглушка/.*

Зазвичай цей синтаксис використовується у всіх білих списках, специфічних для конкретного постачальника, за винятком випадків
супроводжувач постачальника явно хоче включити завдання з іншого простору імен (for
наприклад, одне з відомих визначень завдання Checkbox).

ЗГОНОВЕНО РОБОТА
Plainbox пропонує спосіб генерувати завдання під час виконання. Для цього є дві мотивації
функцію.

Створення екземплярів Випробування та цінності множинний прилади
Класичним прикладом є перевірка обладнання (наприклад, перерахування всього сховища
пристрої), а потім продублюйте кожен із певних тестів магазину, щоб усі пристрої були
тестується окремо.

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

Іншим обмеженням є те, що завдання не можуть замінити існуючі визначення.

створення Батько-дитина Асоціація
Відносно нішевою та застарілою особливістю створених завдань є друк дослівної копії
існуючі визначення посади з a місцевий визначення посади, назване відповідно до загальної теми тестування або
категорія. Наприклад, визначення завдання Прапорець __бездротовий__ відбитків, за допомогою
як (1), усі визначення завдань, визначені у файлі wireless.txt.

Ця поведінка має спеціальний регістр, щоб не викликати помилок перевизначення. Натомість існуючий
визначення отримують через атрибут, який пов’язує їх із завданням генератора. Ця функція є
використовується похідною програмою, наприклад Checkbox. Plainbox наразі не використовує його.

ВІДНОВЛЕННЯ
Plainbox пропонує функцію відновлення сеансу, тоді як сеанс, який був перерваний
(цілеспрямовано або через несправність) можна відновити та ефективно продовжувати
де це було зупинено.

Під час відновлення сеансу вам може бути надано можливість повторити, пройти, пропустити або пропустити
тестове завдання, яке виконувалося перед перервою сеансу. Це задумано
впоратися з обома звичайними ситуаціями, такими як "тест перезавантаження системи", де це ідеально
добре «пройти» тест без повторного виконання команди. Крім того, це можна використовувати для
обробляти аномальні випадки, коли машина поводиться неправильно, і повторний запуск того ж тесту
призвести до повторного виникнення проблеми на невизначений термін.

Недоліки
Ця функція не дозволяє переривати та відновлювати тестове завдання, яке вже виконується
виконано. Така робота буде перезапущена з нуля.

Plainbox намагається переконатися, що один сеанс узгоджується з припущеннями
на початку сесії зберігаються в кінці. З цією метою Plainbox спробує це зробити
переконайтеся, що визначення завдань не змінилися між двома окремими викликами, які спрацювали
з одним сеансом. Якщо така ситуація буде виявлена, сеанс не буде відновлено.

ЕКСПОРТ РЕЗУЛЬТАТИ
Plainbox пропонує спосіб експортувати внутрішній стан сеансу в більш корисний
формат для подальшої обробки.

вибирає Експортери
Експортер можна вибрати за допомогою --формат виведення ФОРМАТ параметр командного рядка. Лист
доступних експортерів (до яких можуть входити сторонні експортери) можна отримати шляхом проходження
--формат виведення ? варіант.

Деякі формати є більш корисними, ніж інші, оскільки вони здатні передавати більше
внутрішній стан. Залежно від вашої програми, ви можете вибрати найбільш загальний
формату (json) і обробити його далі за допомогою додаткових інструментів, вибрати найпростіший формат
(текст), щоб отримати простий підсумок результатів або вибрати один із двох
спеціалізовані формати (xml і html), які є специфічними для робочого процесу Checkbox.

З коробки підтримуються такі експортери:

HTML
Цей експортер створює статичну HTML-сторінку зі звітом тестування, доступним для читання. Це корисно
для спілкування з іншими людьми і оскільки він є повністю автономним і автономним
можна надіслати електронною поштою або заархівувати.

json
Цей експортер створює документ JSON із внутрішнім представленням сеансу
держава. Це найбільш універсальний експортер, корисний і простий для подальшої обробки.
Він не особливо зрозумілий людині, але може бути досить корисним для налагодження високого рівня
без необхідності використовувати pdb і знати внутрішні елементи Plainbox.

rfc822
Цей експортер створює документи квазі-RFC822. Він досить обмежений і використовується мало.
Тим не менш, це може бути корисним за деяких обставин.

текст
Це експортер за замовчуванням. Він просто друкує зрозуміле для людини представлення тесту
результати без особливих деталей. Однак він відкидає майже весь внутрішній стан.

XLSX
Цей експортер створює окремий файл .xlsx (формат XML для Microsoft Excel).
містить звіт про випробування, зрозумілий людині. Він не схожий на звіт HTML, але це так
легше редагувати. Це корисно для спілкування з іншими людьми, і тому цілком
автономний та автономний його можна надіслати електронною поштою або заархівувати.

Це залежить від пакета python3-xlsxwriter

hexr
Цей експортер створює XML-документ із досить незрозумілими назвами, застосовний лише для внутрішнього
Робочий процес Canonical Hardware Certification Team.

Це не загальне XML-подання результатів тесту, а натомість воно містить досить багато
застарілі конструкції, які зберігаються лише для сумісності з іншими внутрішніми інструментами. Якщо
замість цього ви хочете шукати загальну обробку для JSON.

вибирає Експортер Опції
Деякі експортери пропонують набір параметрів, які можуть додатково налаштувати експортовані дані. А
Повний список опцій, доступних для кожного експортера, можна отримати, перейшовши
--параметри-виведення ? параметр командного рядка.

Параметри можуть бути вказані у вигляді списку, розділеного комами. Деякі параметри діють як прості прапорці,
інші варіанти можуть сперечатися з параметр=значення синтаксис

Відомі варіанти експортера документовані нижче:

json
with-io-log:
Експортовані дані включатимуть журнал введення/виведення, пов’язаний з кожним результатом завдання.
Дані включаються у вихідну форму з трьох кортежів, якщо тільки один із них не є squash-io-log
or вирівняти-іо-лог також використовуються опції.

Журнали введення-виведення – це представлення даних, створених процесом, створеним з
команду оболонки, пов'язану з деякими завданнями.

squash-io-log:
При використанні разом з with-io-log параметр, він змушує Plainbox відкидати потік
ім'я та позначку часу та просто включити список двійкових рядків, закодованих base64. Це
Опція більш корисна для відновлення простих "файлів журналів"

flatten-io-log:
При використанні разом з with-io-log опція, вона змушує Plainbox об’єднати всі
окремі записи, закодовані base64, в один великий двійковий рядок, закодований base64
представляє всю комунікацію, яка мала місце.

зі списком виконання:
Експортовані дані включатимуть список виконання (послідовність завдань, обчислена з бажаного
список вакансій).

зі списком вакансій:
Експортовані дані включатимуть повний список вакансій, відомих системі

with-resource-map:
Експортовані дані включатимуть повну карту ресурсів. Ресурси – це записи про
набори ключ-значення, пов’язані з кожним результатом завдання для завдань, які мають плагін
тип ресурс. Очікується, що вони будуть надруковані до stdout такими ресурс роботи та
аналізуються та зберігаються Plainbox.

with-job-defs:
Експортовані дані включатимуть деякі властивості кожного визначення роботи. Наразі
цей набір містить такі поля: підключати, Вимагається, залежить, команда та
description.

з додатками:
Експортовані дані включатимуть вкладення. Вкладення створюються з stdout потік
кожного завдання, що має тип плагіна прихильність. Фактичні вкладення є
закодований base64.

з коментарями:
Експортовані дані включатимуть коментарі, додані оператором тестування до кожного результату завдання
що їх має.

with-job-via:
Експортовані дані будуть включати через атрибут поряд з кожним результатом роботи. Через
атрибут містить контрольну суму визначення завдання, яке створило певну
визначення посади. Це корисно для відстеження завдань, створених за допомогою плагіна
тип місцевий.

with-job-hash:
Експортовані дані будуть включати мішанина атрибут поряд з кожним результатом роботи. Хеш
атрибут є контрольною сумою даних визначення завдання. Це може бути корисним поряд
з з-робота-через.

машина-json:
Згенерований документ JSON буде мінімальним (без будь-яких необов’язкових пробілів).
Цей параметр найкраще використовувати, якщо результат не призначений для зчитування людьми
оскільки це економить місце.

rfc822
Усі варіанти мають те ж значення, що й для json експортер: with-io-log,
squash-io-log, вирівняти-іо-лог, зі списком виконання, зі списком вакансій, з картою ресурсу,
with-job-defs, з додатками, з коментарями, з-робота-через, with-job-hash. Єдиний
винятком є машина-json параметр, який не існує для цього експортера.

текст
Так само, як і з rfc822.

XLSX
with-sys-info:
Експортована електронна таблиця включатиме робочу таблицю з детальною інформацією про апаратні пристрої
на lspci, lsusb, udev тощо.

з підсумком:
Експортована електронна таблиця міститиме тестові цифри. Сюди входить відсоток
тести, які пройшли, пройшли, були пропущені та загальний підрахунок.

з описом роботи:
Експортована електронна таблиця міститиме описи посад на окремому аркуші

з текстовими вкладеннями:
Експортована електронна таблиця міститиме текстові вкладення на окремому аркуші

XML
ім'я клієнта:
Ця опція дозволяє клієнтам замінити назву програми, яка генерує файл
XML-документ. За замовчуванням це ім’я звичайна коробка. Щоб скористатися цією опцією, перейдіть
--параметри-виведення ім'я клієнта=інше ім'я параметр командного рядка.

ТРАНСПОРТУВАННЯ РЕЗУЛЬТАТИ
Експортовані результати можна або зберегти у файл (це найпростіший транспорт за замовчуванням)
або можуть бути передані в одну з транспортних систем для подальшої обробки. Ідея така
спеціалізовані користувачі можуть надати власні транспортні системи (часто разом із специфічними
експортер), щоб перемістити результати тестування з системи, що тестується, до результату центрального тестування
сховище

Транспорт можна вибрати за допомогою --транспорт варіант. Знову, як і з експортерами, список
відомі транспорти можна отримати, пройшовши --транспорт ? варіант. Для транспорту потрібен а
цільова URL-адреса, яку можна вказати за допомогою --transport-where= варіант. Синтаксис
URL-адреса залежить від типу транспорту.

Plainbox оснащений такими транспортними засобами:

LaunchPad
Цей транспорт може надсилати результати, експортовані за допомогою XML експортер на апаратне забезпечення Launchpad
База даних. Це маловідома функція, яку пропонує https://launchpad.net/ .

сертифікація
Цей транспорт може надсилати результати, експортовані за допомогою XML експортер у Canonical
Сертифікаційний веб-сайт (https://certification.canonical.com).

Цей транспорт мало корисний нікому, крім команди сертифікації обладнання Canonical
який також підтримує Plainbox і Checkbox, але згадується тут для повноти.

ВАРІАНТИ

опціональний аргументи:

--неінтерактивні
пропускати тести, які потребують інтерактивності

-n, --сушить
насправді не виконують більшість робіт

--dont-suppress-output
не пригнічувати вихід певних типів плагінів завдань

-f, --формат виведення
зберегти результати тесту у зазначеному ФОРМАті (продати ? для списку варіантів)

-p, --параметри-виведення
розділений комами список параметрів для механізму експорту (передайте ? для списку
вибір)

-o, -- вихідний файл
зберегти результати тесту у вказаний ФАЙЛ (або в стандартний вихід, якщо FILE -)

-t, --транспорт
використовуйте TRANSPORT, щоб надіслати результати кудись (пройдіть ? для списку варіантів)

Можливі варіанти: ?

--транспорт-куди
куди надсилати дані за допомогою вибраного транспорту

--опції транспорту
розділений комами список параметрів ключ-значення (k=v), які потрібно передати транспорту

-T, --тест-план
завантажте вказаний план тестування

-i, --include-шаблон
включити завдання, що відповідають заданому регулярному виразу

-x, --exclude-шаблон
виключити завдання, що відповідають заданому регулярному виразу

-w, --білий список
завантажити білий список, що містить шаблони виконання

Використовуйте Plainbox-Run онлайн за допомогою служб onworks.net