adt-run: en línea en la nube

PROGRAMA:

NOMBRE

adt-run: prueba un paquete binario instalado usando las pruebas del paquete fuente

SINOPSIS

adt-ejecutar opciones... . . . servidor virtual [virt-servidor-arg...]

DESCRIPCIÓN

adt-ejecutar es el programa para invocar la maquinaria de prueba de paquetes de autopkgtest.

autopkgtest es una función para probar paquetes binarios de Debian o Click, tal como se instala en un
sistema (como un sistema de banco de pruebas). Las pruebas son las suministradas en el paquete fuente.

adt-run ejecuta cada prueba proporcionada por un paquete en particular e informa los resultados. Eso
impulsa el régimen de virtualización especificado según corresponda y analiza la descripción de la prueba
metadatos y organiza la copia de datos hacia y desde el banco de pruebas según sea necesario.

Consulte /usr/share/doc/autopkgtest/README.running-tests.rst.gz para obtener una introducción sobre cómo
para utilizar adt-run.

ESPECIFICANDO TESTS

Las acciones especifican los paquetes fuente y binarios para probar, o cambiar lo que sucede con
argumentos del paquete:

--fuente Dsc
Ejecutar pruebas desde el paquete fuente de Debian Dsc. Por defecto, el paquete también se construirá.
y los binarios resultantes se utilizarán para satisfacer las dependencias de prueba; deshabilitar
eso, especifique el -B/- no binarios incorporados opción antes.

El orden es significativo: cada --fuente La opción debe preceder a las opciones cuyas
las dependencias deben ser satisfechas por los binarios que produce.

--árbol sin construir directorio
Especifica que las pruebas del árbol de fuentes de Debian no construido directorio debe ejecutarse.
Esto es muy similar a especificar --fuente excepto que un árbol de directorios (que
debe ser prístino), en lugar de un paquete fuente.

--árbol construido directorio
Especifica que las pruebas del árbol de fuentes de Debian construido directorio debe ejecutarse.
Tenga en cuenta que todos los paquetes de archivo satisfacen todas las dependencias de prueba, a menos que
especificar explícitamente .debs construidos localmente con --binario.

--apt-fuente nombresrcpkg
Descargas nombresrcpkg con apt-get fuente en el banco de pruebas y ejecutar sus pruebas. Este es
similar a especificar --fuente pero evita copiar la fuente del host al
banco de pruebas. Posiblemente los binarios construidos no ser utilizado para satisfacer dependencias, como
por lo general, en este modo desea probar binarios de un archivo real.

--git-fuente Enlance [nombre de rama]
Especifica que las pruebas del árbol de fuentes de Debian no compilado de git-cloning Enlance
debe ejecutarse. Si nombre de rama se da, esta rama se comprobará en lugar de
el predeterminado (generalmente "maestro").

Esto es muy similar a especificar --árbol sin construir después de la clonación, es decir, esto es
comúnmente usado con - no binarios incorporados. git el paquete se instalará si
necesario.

--binario debutante
Especifica que debutante debe usarse para las pruebas de todos los siguientes paquetes fuente. Por
por defecto, se utilizará para satisfacer las dependencias, tanto durante la construcción como durante las pruebas.

El orden es significativo, en cuanto a --fuente. En particular, si una fuente posterior
El paquete construirá un binario con el mismo nombre, que se utilizará a partir de ese momento, y
debutante será ignorado

--cambios cambios
Especifica que los debs en los .changes dados deben usarse para pruebas de
paquete fuente en ese .changes. Actúa como si hubiera especificado .debs y .dsc
desde un archivo .changes como argumentos explícitos.

- hacer clic en fuente clicsrc
Ruta para hacer clic en el árbol de origen para las siguientes --hacer clic Pack

--hacer clic paquete de clics
If paquete de clics es un archivo (* .click), instale el paquete de clic dado en el banco de pruebas. Si esto es
un nombre de clic (como "com.example.myapp"), suponga que ya está instalado en el
testbed y lea el manifiesto de él.

Ejecute pruebas de paquetes de clic de las anteriores - hacer clic en fuente. Si una fuente de clics
directorio no se especifica explícitamente, se descargará de acuerdo con el
manifiesto fuente x entrada. Actualmente, el único esquema admitido es vcs-bzr.

nombre de archivo
Los argumentos de nombre de archivo desnudos se procesan como si --árbol construido, --fuente, --árbol sin construir,
--apt-fuente, --binario, --cambios, - hacer clic en fuenteo --hacer clic fue especificado; los
la naturaleza del argumento se deduce de la forma del nombre del archivo. En el caso de
--árbol construido, se debe especificar la opción o el nombre del archivo debe terminar en un
barra oblicua; dos barras al final se toman para significar --árbol sin construir. Si un dado
directorio tiene un subdirectorio "clic", se interpreta como - hacer clic en fuente.

PROBAR OPCIONES

A menos que se indique lo contrario, estos afectan a todos los argumentos de prueba posteriores.

-B | - no binarios incorporados
Todos los binarios construidos a partir de --fuente or --árbol sin construir las pruebas no serán
construido o ignorado, y las dependencias se satisfacen con los paquetes del archivo.
Tenga en cuenta que los paquetes aún se compilan si una prueba requiere construcción necesaria.

--built-binarios
Posterior --fuente or --árbol sin construir Las pruebas se construirán y sus dependencias.
estar satisfecho con los binarios construidos. Este es el comportamiento predeterminado, por lo que solo
Necesito esto para revertir un especificado previamente - no binarios incorporados .

--override-control =TRAYECTORIA
Leer los metadatos de prueba de TRAYECTORIA en lugar de debian / tests / control (para Debian
sources) o el manifiesto de Click para la siguiente prueba.

--testname =PROBAR
Ejecute solo el nombre de prueba dado (del archivo de control de prueba) en la siguiente prueba.

REGISTRO OPCIONES

Si no especifica ninguna opción, adt-ejecutar solo escribe su salida / resultados en stderr.

-o dir | --output-dir =dir
Especifica que los artefactos de prueba (stderr y stdout de las pruebas, el archivo de registro,
paquetes binarios construidos, etc.) deben colocarse en el directorio dado. dir no debe
existir todavía o estar vacío, de lo contrario adt-ejecutar se negará a usarlo.

-l archivo de registro | --log-file =archivo de registro
Especifica que el registro de seguimiento debe escribirse en archivo de registro en lugar de dir-salida.

--summary =resumen
Especifica que se debe escribir un resumen del resultado resumen. Los eventos
en el resumen se escriben en el registro en cualquier caso.

-q | --tranquilo
No envíe una copia de adt-ejecutarTraza el flujo de registros a stderr. Esta opción no
afectar la copia enviada a archivo de registro or dir-salida. Tenga en cuenta que sin dejar rastro
logstream puede ser muy difícil diagnosticar problemas.

PROBAR CAMA CONFIGURACIÓN OPCIONES

--setup-commands =comandos
Ejecutar comandos después de abrir el banco de pruebas. Esto se puede utilizar, por ejemplo, para habilitar
apt sources, ejecutar apt-get actualización o similar. Si comandos es un nombre de archivo existente,
los comandos se leen de eso; de lo contrario, es una cadena con los comandos reales
que se ejecuta como está. Los nombres de archivo sin directorio se buscarán tanto en
directorio actual y en / usr / share / autopkgtest / setup-commands / entonces no necesitas
para proporcionar la ruta completa para los scripts de configuración enviados con autopkgtest.

Esta opción se puede especificar varias veces.

If --usuario se da o el banco de pruebas proporciona un sugerido-usuario-normal capacidad, la
$ ADT_NORMAL_USER La variable de entorno se establecerá para ese usuario.

Si los comandos de configuración afectan algo en los directorios de arranque (como /bota or
/ lib / systemd / system) y el banco de pruebas admite el reinicio, el banco de pruebas se
reiniciado después de los comandos de configuración. Esto se puede suprimir creando un archivo
/ejecutar/autopkgtest_no_reboot.sello.

--apt-actualización | -U
Ejecutar apt-get actualización y apt-get dist-upgrade -y en el banco de pruebas antes de ejecutar el
pruebas.

--apt-pocket =bolsillo [= pkgname, src: srcname, ...]
Agrega fuentes aptas para ,-bolsillo. Esto encuentra el primero debutante en linea
/etc/apt/sources.list que aún no especifica un bolsillo y agrega un deb y
línea deb-src con ese bolsillo para /etc/apt/sources.list.d/bolsillo.lista. Esto también
llamadas apt-get actualización para el nuevo bolsillo (pero no para nada más).

Si se proporciona una lista de paquetes después de =, configure apt pinning para usar solo esos paquetes
obtenidos de bolsillo. Una entrada "src: srcname" se expande a todos los paquetes binarios creados por ese
fuente. Esto se puede utilizar para minimizar las dependencias tomadas de bolsillo para que
Las actualizaciones de paquetes en ese bolsillo se pueden probar de forma independiente entre sí para
mejor aislamiento. Atención: Actualmente, esto no resuelve algunas situaciones en las que
las dependencias de los paquetes dados solo se pueden resolver en el bolsillo dado. En
en ese caso, se eliminará la fijación de apt y se reintentará la instalación del paquete
con la totalidad de bolsillo.

--copy =HOSTPATH: TESTBEDPATH
Copie el archivo o directorio del host al banco de pruebas después de abrirlo. Esto pasa antes
--comandos de configuración por lo tanto, puede utilizar estos archivos en los comandos de configuración.

--env =VAR = valor
Establezca una variable de entorno arbitraria en la compilación y la prueba. Puede especificarse múltiples
veces.

USUARIO / PRIVILEGIO MANEJO OPCIONES

-u usuario | --user =usuario
Ejecute compilaciones y pruebas como usuario en el banco de pruebas. Esto necesita root en el banco de pruebas; si
root en el banco de pruebas no está disponible, luego las compilaciones y las pruebas se ejecutan como cualquier usuario
previsto.

--gain-root =raíz de ganancia
Prefijos debian / reglas binario con raíz de ganancia. El valor predeterminado es no usar nada,
excepto que si --usuario se suministra o la raíz en el banco de pruebas no está disponible el
por defecto es raíz falsa.

DEPURACIÓN OPCIONES

--depurar|-d
Incluya información de depuración adicional en el registro de seguimiento. Cada adicional -d
aumenta el nivel de depuración; el máximo actual es -dddd. Si te gusta ver
qué está pasando, -d or -dd is recomendado.

--fallo de shell|-s
Ejecute un shell interactivo en el banco de pruebas después de una compilación, prueba o dependencia fallida
instalación.

--cáscara
Ejecute un shell interactivo en el banco de pruebas después de cada prueba.

TIMEOUT OPCIONES

--se acabó el tiempo-lo cual=segundos
Utilice un tiempo de espera diferente para las operaciones en o con el banco de pruebas. Hay cinco
tiempos de espera afectados por cinco valores de lo cual: short: operaciones supuestamente cortas como
configurar el apto del banco de pruebas y verificar el estado (predeterminado: 100); instalar:
instalación de paquetes que incluyen dependencias (predeterminado: 3,000); test: prueba se ejecuta
(predeterminado: 10,000 s); copia: copia archivos / directorios entre el host y el banco de pruebas (predeterminado:
300); y construimos: compila (predeterminado: 100,000 s). El valor debe especificarse como
número entero de segundos.

- factor de tiempo de espera=doble
Multiplique todos los tiempos de espera predeterminados por el factor especificado (consulte --se acabó el tiempo-lo cual
encima). Solo se ven afectados los valores predeterminados; la configuración de tiempo de espera explícita se utiliza exactamente
Como se especificó.

LOCAL OPCIONES

--set-lang =idioma
Al ejecutar comandos en el banco de pruebas, establece el IDIOMA variable de entorno a
idioma. El predeterminado en adt-ejecutar es ponerlo en C.UTF-8.

OTROS OPCIONES

--sin control automático
Desactive la generación automática de pruebas con autodep8, incluso si está instalado. En eso
caso, los paquetes sin pruebas se cerrarán con el código 8 ("No hay pruebas en este paquete")
al igual que sin autodep8.

--build-paraleloN
Set paralelo = N DEB_BUILD_OPTION para crear paquetes. Por defecto, este es el
número de procesadores disponibles. Esto es principalmente útil en contenedores donde puede
Restrinja la RAM disponible, pero no restrinja el número de CPU.

-h|--ayuda
Muestre la ayuda de la línea de comando y salga.

VIRTUALIZACIÓN SERVIDOR

. . . servidor virtual virt-servidor-arg...
Especifica el régimen de virtualización del servidor, como comando y argumentos a invocar.
servidor virtual debe ser un servidor de virtualización de autopkgtest existente, como adt-virt-
Chatarra or adt-virt-qemu. Puede omitir el adt-virt- prefijo y solo especifique
la última parte, p. ej. Chatarra.

Todos los argumentos y opciones restantes después . . . se pasan a la virtualización
programa de servidor. Consulte las páginas de manual de los servidores individuales para saber cómo utilizarlos.

SALIDA FORMATO

Durante una ejecución de prueba normal, se imprime una línea para cada prueba. Consiste en un breve
cadena que identifica la prueba, algunos espacios en blanco horizontales y PASS or FALLO razón o
OMITIR Razón en la que la indicación de aprobado / reprobado está separada por cualquier motivo por algún
espacio en blanco.

La cadena para identificar la prueba consiste en una cadena alfanumérica corta inventada por adt-
run para distinguir diferentes argumentos de la línea de comandos, el árido, seguido de un guión y
el nombre de la prueba.

A veces un OMITIR se informará cuando se desconozca o no el nombre de la prueba
aplicable: por ejemplo, cuando no hay pruebas en el paquete, o hay una prueba
estrofa que contiene características no comprendidas por esta versión de adt-ejecutar. En este caso *
aparecerá donde debería estar el nombre de la prueba.

If adt-ejecutar detecta que hay paquetes erróneos involucrados, imprimirá las dos líneas
culpar: cosa culpable... y paquete malo: mensaje. Aquí cada espacio en blanco separado cosa culpable
es uno de los argumento:argumento (que representa un nombre de ruta que se encuentra en un argumento de línea de comando),
dsc:PARA DOS (un nombre de paquete fuente), debutante:PARA DOS (un nombre de paquete binario) o posiblemente otro
cadenas por determinar. Esto indica qué argumentos y / o paquetes pueden tener
contribuido al problema; los que se procesaron más recientemente y que son
por lo tanto, la causa más probable de un problema se enumera en último lugar.

CONFIGURACIÓN ARCHIVOS

Si usa muchas opciones o argumentos de servidor virt no triviales, puede poner cualquier parte de
la línea de comando en un archivo de texto, con una línea por opción. P.ej. puedes crear un archivo
sid.cfg con contenidos como

-s
--output-dir = / tmp / testout
--apt-actualización
. . .
Chatarra
sid

Y luego ejecutar

adt-run foo_1_amd64.changes @ sid.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.

SALIR ESTADO

0 todas las pruebas pasaron
2 al menos una prueba omitida
4 al menos una prueba falló
6 al menos una prueba falló y al menos una prueba omitida
8 no hay pruebas en este paquete
12 paquete erróneo
16 falla del banco de pruebas
20 otros fallos inesperados, incluido el mal uso

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