adt-virt-ssh: en línea en la nube

PROGRAMA:

NOMBRE

adt-virt-ssh: servidor de virtualización de autopkgtest usando SSH

SINOPSIS

adt-virt-ssh [opciones] [- Configure guión opciones ...]

DESCRIPCIÓN

adt-virt-ssh proporciona un servidor de virtualización de prueba automática mediante SSH.

Normalmente adt-virt-ssh será invocado por adt-ejecutar.

adt-virt-ssh

puede usar un objetivo ssh ya existente o llamar a un script de configuración para crear / configurar un banco de pruebas
y el servidor ssh.

¡ADVERTENCIA! adt-virt-ssh modificará el sistema de destino instalando paquetes y ejecutando
código de prueba arbitrario, por lo que que tú están responsable para Restablecimiento los banco de pruebas usted mismo especialmente
sin un script de configuración. Así que usa esto con cuidado.

REQUISITOS

adt-virt-ssh no asume nada con respecto al host de destino que no sea el dado
La conexión SSH (y la red) permanecen disponibles todo el tiempo. Puede proporcionar
credenciales en la línea de comando para hosts SSH que ya funcionan o utilice un script de configuración para
preparar el host para la conexión (ver CONFIGURACIÓN GUIÓN a continuación para obtener más información), para
ejemplo para crear una regla de reenvío para acceder a un host adb a través de ssh o iniciar una nube
ejemplo.

OPCIONES

-h|--ayuda
Muestre el mensaje de ayuda y salga

-d|--depurar
Habilitar la salida de depuración

-H hostname | --hostname =hostname
Se conecta e inicia sesión en el nombre de host o la dirección IP especificados

-l usuario | --login =usuario
Especifica el usuario para iniciar sesión como en la máquina remota.

-i identidad | --identidad =identidad
Selecciona un archivo del cual la identidad (clave privada) para la autenticación de clave pública
es leído. Normalmente debería ser ~ / .ssh / id_rsa, pero podría considerar usar una
clave para pruebas.

-P la contraseña | --password =la contraseña
Especifica la contraseña de sudo en el host remoto.

Puede ser la contraseña en texto sin cifrar o un archivo que contenga la contraseña. Esta
La contraseña se usará para configurar $ SUDO_ASKPASS en el caso de que sudo requiera una contraseña.
El corredor comprobará si el usuario tiene acceso a sudo con y sin contraseña. Si
la comprobación falla, la capacidad "root-on-testbed" no estará disponible. Si sudo
funciona, entonces las pruebas que se ejecutan como usuario tendrán $ SUDO_ASKPASS en su entorno, por lo que
que pueden correr sudo -A si es necesario.

-p Puerto | --port =Puerto
puerto ssh que se utilizará para conectarse al host

-o opciones | --options =opciones
Pasó palabra por palabra a ssh; ver man ssh_config

-r|--reiniciar
Indican que reiniciar se puede utilizar en el banco de pruebas. Esto es útil cuando se ejecuta
reiniciar las pruebas sin un script de configuración (que ya puede declarar capacidades).

-s configuración_script | --setup-script =configuración_script
Secuencia de comandos de configuración para preparar el banco de pruebas y la conexión ssh (consulte CONFIGURACIÓN GUIÓN a continuación para más
información). Los nombres de archivo se buscarán tanto en el directorio actual como en
/ usr / share / autopkgtest / ssh-setup / por lo que no es necesario dar la ruta completa para
scripts de configuración enviados con autopkgtest.

--timeout-ssh =segundos
Tiempo de espera para la conexión ssh, en segundos. El valor predeterminado es 300.

-- [configuración guión argumentos]
Todos los argumentos restantes siguientes -- se pasará literalmente a la configuración
script para configurar el host.

CONFIGURACIÓN ARCHIVOS

Si usa muchas opciones o hosts, puede poner partes o toda la línea de comando en
un archivo de texto, con una línea por opción. P.ej. puedes crear un archivo testhost.cfg con
contenidos como

-Htest.ejemplo.com
-ltestusuario
-Ps3kr1t

Y luego ejecutar

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

El contenido del archivo de configuración se expandirá en el lugar como si lo hubiera
dado su contenido en la línea de comando. Por favor, asegúrese de don't place Espacios entre
opciones cortas y sus valores, se convertirían en parte del valor del argumento.

APORTE, SALIDA Y SALIR ESTADO

El comportamiento de adt-virt-ssh es como lo describe la virtualización de AutomatedTesting
especificación del régimen.

NOTAS

adt-ejecutar no corre apt-get actualización al comienzo de la compilación de un paquete, lo que puede provocar una
error de compilación si está utilizando una plantilla de serie de desarrollo. Necesitarás correr apt-get
actualización en la plantilla usted mismo (p. ej., utilizando --comandos de configuración).

CONFIGURACIÓN GUIÓN

adt-virt-ssh acepta un script de configuración como argumento para preparar el banco de pruebas y el ssh
conexión. Un script de configuración es un ejecutable que se llama con un comando como primer
argumento y opciones adicionales para ese comando.

mando: abierto
Cuando se llama con "abrir", el script tiene que crear un banco de pruebas (si es necesario), configurar ssh,
copie la clave ssh en él, configure sudo, etc.

Luego devuelve la siguiente información sobre la salida estándar con el formulario clave = valor, un experto
línea por par. En su mayoría, reflejan las opciones de la línea de comandos cuando no se usa un script.

Campos requeridos:

* login: nombre de usuario

* nombre de host: nombre de host o dirección IP

Campos opcionales:

* identidad: ruta a la clave privada

* contraseña: sudo contraseña para que el nombre de usuario adquiera privilegios de root. Si no se da,
y sudo sin contraseña no funciona, el banco de pruebas no tendrá privilegios de root.

* puerto: puerto SSH en el nombre de host, si es diferente de 22

* capacidades: capacidades adicionales del banco de pruebas, como "máquina de aislamiento" o "revertir", consulte
README.servidor-virtualización.rst

Si el banco de pruebas se puede reiniciar manteniendo el estado, el script debería anunciar
"reiniciar".

* opciones: pasa palabra por palabra a ssh, ver man ssh_config

* extraopts: pasa literalmente a otros comandos; esto permite un estado adicional (como
nombres de directorios temporales, identificadores de VM, etc.) que se pasarán a la limpieza

mando: limpieza
Llamado al cerrar el banco de pruebas; debería revertir / eliminar las cosas instaladas en abierto tanto como
posible si el banco de pruebas no es efímero. Esto se llama con todas las opciones que se abren.
me llamaron con, más extraopta.

mando: revertir
Si hay una forma de restablecer el banco de pruebas a su estado original (como usar instantáneas de VM
o reconstruir bancos de pruebas efímeros), el script debe poner "revert" (y si corresponde,
"revert-full-system") en las capacidades e implementar este comando. Esto puede
opcionalmente generar algunas o todas las claves de configuración ssh desde open () para actualizar el
configuración, en caso de que cambie el nombre de host / IP.

mando: esperar-reiniciar
Esto se puede implementar si las capacidades anuncian "reiniciar" y necesitas hacer algo
más elaborado que simplemente esperar a que el puerto ssh baje y vuelva a subir después
llamando "reiniciar". Esto debe esperar a que el banco de pruebas se apague, inicie y vuelva a preparar el
banco de pruebas para inicio de sesión ssh.

mando: error de depuración
Esto se llama cuando la secuencia de comandos de instalación falla con un valor distinto de cero o cuando se agota el tiempo de espera de ssh o
reiniciar. Si está disponible, esto debería generar información de depuración, como el registro de inicio
desde la consola serie. Implementar esto es opcional.

Incluido guiones
autopkgtest proporciona scripts de configuración para tipos comunes de bancos de pruebas en
/ usr / share / autopkgtest / ssh-setup /. Consulte los comentarios en estos scripts para saber cómo
usalos, usalos a ellos. Además, considere usar / usr / share / autopkgtest / ssh-setup / SKELETON como base
por escribir el tuyo.

EJEMPLOS

Ejecute las pruebas del paquete fuente libpng en un "mytesthost" existente:

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

Ejecute las pruebas de un paquete de clic en un teléfono Ubuntu con una conexión ssh a través de ADB, usando
la secuencia de comandos de configuración, con la especificación de una opción para la secuencia de comandos de configuración para elegir un
ID de serie:

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

Utilice adt-virt-ssh en línea utilizando los servicios de onworks.net