adt-virt-ssh - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

adt-virt-ssh - сервер віртуалізації autopkgtest за допомогою SSH

СИНТАКСИС

adt-virt-ssh [опції] [-- установка сценарій опції ...]

ОПИС

adt-virt-ssh надає сервер віртуалізації autopkgtest за допомогою SSH.

Зазвичай adt-virt-ssh буде викликано adt-run.

adt-virt-ssh

можна використовувати вже існуючий цільовий ssh ​​або викликати сценарій налаштування, щоб створити/налаштувати тестовий майданчик
і ssh-сервер.

УВАГА! adt-virt-ssh змінить цільову систему, встановивши та запустивши пакети
довільний тестовий код, так ви він має відповідальний та цінності скидання тестовий стенд себе особливо
без сценарію налаштування. Тому використовуйте це з обережністю.

ВИМОГИ

adt-virt-ssh не передбачає нічого щодо цільового хоста, крім зазначеного
ssh-з'єднання (і мережа) залишаються доступними весь час. Ви можете надати
облікові дані в командному рядку для вже працюючих хостів SSH або скористайтеся сценарієм налаштування для
підготувати хост до підключення (див НАСТРОЙКА SCRIPT нижче для додаткової інформації), для
приклад для створення правила пересилання для доступу до хосту adb через ssh або запуску хмари
екземпляр

ВАРІАНТИ

-h|--допомога
Покажіть довідкове повідомлення та вийдіть

-d|--відлагоджувати
Увімкнути вихід налагодження

-H ім'я хоста | --ім'я хоста=ім'я хоста
Підключається та входить до вказаного імені хоста або IP-адреси

-l користувач | --login=користувач
Вказує користувача для входу на віддалену машину.

-i особистість | --ідентичність=особистість
Вибирає файл, з якого здійснюється ідентифікація (закритий ключ) для автентифікації з відкритим ключем
читається. Зазвичай має бути ~/.ssh/id_rsa, але ви можете розглянути можливість використання іншого
ключ для тестів.

-P пароль | --пароль=пароль
Вказує пароль sudo на віддаленому хості.

Це може бути пароль відкритим текстом або файл, що містить пароль. Це
пароль буде використовуватися для налаштування $SUDO_ASKPASS у випадку, якщо для sudo потрібен пароль.
Ранер перевірить, чи має користувач доступ до sudo з паролем і без нього. Якщо
перевірка не вдається, можливість «root-on-testbed» буде недоступна. Якщо sudo
працює, тоді тести, які запускаються від імені користувача, матимуть $SUDO_ASKPASS у своєму середовищі
що вони можуть бігати Суду -A якщо це необхідно.

-p порт | --порт=порт
ssh порт для підключення до хоста

-o опції | --параметри=опції
Передано дослівно в ssh; див. man ssh_config

-r|--перезавантажити
Вкажіть це перезавантажувати можна використовувати в тестовому стенді. Це корисно під час бігу
перезавантаження тестів без сценарію налаштування (який вже може оголошувати можливості).

-s скрипт_налаштування | --setup-script=скрипт_налаштування
Сценарій налаштування для підготовки тестового стенду та з'єднання ssh (див НАСТРОЙКА SCRIPT нижче, щоб дізнатися більше
інформація). Назви файлів будуть шукатися як у поточному каталозі, так і в
/usr/share/autopkgtest/ssh-setup/ тому вам не потрібно вказувати повний шлях для
сценарії встановлення, що постачаються разом із autopkgtest.

--timeout-ssh=сухий
Тайм-аут очікування з’єднання ssh в секундах. За замовчуванням 300.

-- [налаштування сценарій аргументи]
Всі інші аргументи далі -- буде переданий дослівно до налаштування
скрипт для налаштування хоста.

КОНФІГУРАЦІЯ ФАЙЛИ

Якщо ви використовуєте багато параметрів або хостів, ви можете помістити частини командного рядка або весь командний рядок
текстовий файл з одним рядком для кожного параметра. наприклад ви можете створити файл testhost.cfg з
вміст, як

-Htest.example.com
-ltestuser
-Ps3kr1t

а потім бігати

adt-run [...] --- adt-virt-ssh @testhost.cfg

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

ВХІД, ВИХІД І EXIT СТАТУС

Поведінка adt-virt-ssh відповідає віртуалізації AutomatedTesting
специфікація режиму.

ПРИМІТКИ

adt-run не працює apt-get оновлення на початку збірки пакета, що може спричинити a
помилка збірки, якщо ви використовуєте шаблон серії розробки. Вам потрібно буде бігти apt-get
оновлення у шаблоні самостійно (наприклад, використовуючи --налаштування-команди).

НАСТРОЙКА SCRIPT

adt-virt-ssh приймає сценарій налаштування як аргумент для підготовки тестової платформи та ssh
підключення. Сценарій встановлення - це виконуваний файл, який спочатку викликається з командою
аргумент і додаткові параметри для цієї команди.

команда: відкрити
При виклику з "open", скрипт повинен створити тестовий стенд (якщо необхідно), налаштувати ssh,
скопіюйте в нього ключ ssh, налаштуйте sudo тощо.

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

Обов'язкові поля:

* Логін: Ім'я користувача

* ім'я хоста: ім'я хоста або IP-адреса

Додаткові поля:

* identity: шлях до приватного ключа

* пароль: sudo пароль для імені користувача для отримання привілеїв root. Якщо не дано,
і sudo без пароля не працює, тестова панель не матиме привілеїв root.

* порт: порт SSH для імені хоста, якщо він відрізняється від 22

* можливості: додаткові можливості тестового стенду, такі як "ізоляційна машина" або "повернення", див.
README.virtualisation-server.rst

Якщо тестову платформу можна перезавантажити із збереженням стану, сценарій має оголосити
«перезавантаження».

* параметри: передано дослівно в ssh, див. man ssh_config

* extraopts: дослівно передається іншим командам; це дозволяє додатковий стан (наприклад
тимчасові імена каталогів, ідентифікатори ВМ тощо), які будуть передані очищенню

команда: прибирати
Викликається при закритті тестового стенду; слід повернути/видалити речі, встановлені у відкритому доступі, як
можливо, якщо тестовий стенд не ефемерний. Це викликається з усіма відкритими параметрами
зателефонували з плюсом екстраопти.

команда: повернути
Якщо є спосіб скинути тестовий стенд до його первинного стану (наприклад, за допомогою знімків віртуальної машини
або перебудову ефемерних тестових стендів, сценарій має поставити "повернутися" (і, якщо доречно,
"revert-full-system") у можливості та реалізуйте цю команду. Це може
за бажанням виведіть деякі або всі ключі конфігурації ssh з open() для оновлення
конфігурації, у разі зміни імені хоста/IP.

команда: чекати-перезавантажувати
Це можна реалізувати, якщо можливості рекламують «перезавантаження» і вам потрібно щось зробити
більш складно, ніж просто чекати, поки порт ssh знизиться і повернеться після цього
виклик «перезавантаження». Для цього потрібно дочекатися вимкнення тестового стенду, завантаження та повторної підготовки
тестова панель для входу по ssh.

команда: налагодження-збій
Це викликається, коли сценарій встановлення дає збій з відмінним від нуля або через тайм-аути очікування ssh або
перезавантажити. Якщо доступно, це має вивести деяку інформацію про налагодження, наприклад журнал завантаження
з послідовної консолі. Реалізація цього необов’язкова.

включені scripts
autopkgtest надає сценарії налаштування для поширених типів тестових стендів
/usr/share/autopkgtest/ssh-setup/. Будь ласка, перегляньте коментарі до цих сценаріїв, щоб дізнатися, як це зробити
використовувати їх. Також подумайте про використання /usr/share/autopkgtest/ssh-setup/SKELETON як основа
за написання власного.

ПРИКЛАДИ

Запустіть тести вихідного пакета libpng на існуючому «mytesthost»:

adt-run libpng --- ssh -H mytesthost -l joe -P /tmp/joe_password

Запустіть тестування пакета клацання на телефоні Ubuntu із з’єднанням ssh через ADB, використовуючи
сценарій встановлення із зазначенням параметра для сценарію встановлення для вибору конкретного
серійний ідентифікатор:

adt-run ./ubuntu-calculator-app ./com.ubuntu.calculator_1.3.283_all.click \
--- ssh -s /usr/share/autopkgtest/ssh-setup/adb -- -s 0123456789abcdef

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