adt-run - En ligne dans le Cloud

PROGRAMME:

Nom

adt-run - teste un paquet binaire installé en utilisant les tests du paquet source

SYNOPSIS

adt-run Options --- serveur-virt [virt-serveur-arg...]

DESCRIPTION

adt-run est le programme pour invoquer la machine de test du paquet autopkgtest.

autopkgtest est une fonction pour tester les paquets binaires Debian ou Click, tels qu'installés sur un
système (comme un système de banc d'essai). Les tests sont ceux fournis dans le package source.

adt-run exécute chaque test fourni par un package particulier et rapporte les résultats. Ce
pilote le régime de virtualisation spécifié, le cas échéant, et analyse la description du test
métadonnées et organise la copie des données vers et depuis le banc d'essai, selon les besoins.

Voir /usr/share/doc/autopkgtest/README.running-tests.rst.gz pour une introduction sur comment
pour utiliser adt-run.

EN PRÉCISANT ESSAIS

Les actions spécifient la source et les packages binaires à tester, ou modifient ce qui se passe avec
arguments du package :

--la source dsc
Exécuter des tests à partir du paquet source Debian dsc. Par défaut, le package sera également construit
et les binaires résultants seront utilisés pour satisfaire les dépendances de test ; désactiver
que, précisez le -B/--pas de binaires construits option avant.

L'ordre est important : chaque --la source doit précéder les options dont
les dépendances doivent être satisfaites par les binaires qu'il produit.

--arbre-non construit annuaire
Spécifie que les tests de l'arborescence des sources Debian non construites annuaire devrait être exécuté.
Ceci est très similaire à la spécification --la source sauf qu'une arborescence de répertoires (qui
devrait être vierge) est fourni, au lieu d'un paquet source.

--arbre construit annuaire
Spécifie que les tests de l'arborescence des sources Debian construites annuaire devrait être exécuté.
Notez que toutes les dépendances de test sont alors satisfaites par les packages d'archive, sauf si vous
spécifiez explicitement les .debs construits localement avec --binaire.

--apt-source nom_srcpkg
Télécharger nom_srcpkg au apt-get source dans le banc d'essai et exécuter ses tests. C'est
similaire à la spécification --la source mais évite de copier la source de l'hôte vers le
banc d'essai. Les binaires éventuellement construits seront ne sauraient être utilisé pour satisfaire les dépendances, comme
généralement, dans ce mode, vous souhaitez tester les binaires à partir d'une véritable archive.

--git-source URL [Nom de la filiale]
Spécifie que les tests de l'arborescence des sources Debian non construites à partir de git-cloning URL
devrait être exécuté. Si Nom de la filiale est donné, cette branche sera extraite au lieu de
la valeur par défaut (généralement « maître »).

Ceci est très similaire à la spécification --arbre-non construit après clonage, c'est-à-dire
couramment utilisé avec --pas de binaires construitsL’ jet package sera installé si
nécessaire.

--binaire deb
Spécifie que deb doit être utilisé pour les tests de tous les packages source suivants. Par
par défaut, il sera utilisé pour satisfaire les dépendances, à la fois pendant la construction et les tests.

L'ordre est important, comme pour --la source. En particulier, si une source ultérieure
package va construire un binaire du même nom, qui sera utilisé à partir de là, et
deb Sera ignoré.

--changements change
Spécifie que les debs dans les .changes donnés doivent être utilisés pour les tests du
package source dans ce .changes. Agit comme si vous aviez spécifié les .debs et .dsc
à partir d'un fichier .changes en tant qu'arguments explicites.

--cliquez sur la source clicsrc
Chemin pour cliquer sur l'arborescence des sources pour la suite --Cliquez sur paquet.

--Cliquez sur clicpkg
If clicpkg est un fichier (*.click), installez le package de clic donné dans le banc d'essai. Si c'est
un nom de clic (comme "com.example.myapp"), supposons qu'il est déjà installé dans le
banc d'essai et lire le manifeste à partir de celui-ci.

Exécuter les tests de package de clics du précédent --cliquez sur la source. Si une source de clic
répertoire n'est pas spécifié explicitement, il sera téléchargé selon le
manifeste x-source entrée. Actuellement, le seul schéma pris en charge est vcs-bzr.

nom de fichier
Les arguments de nom de fichier nu sont traités comme si --arbre construit, --la source, --arbre-non construit,
--apt-source, --binaire, --changements, --cliquez sur la source, ou --Cliquez sur a été spécifié ; les
la nature de l'argument est devinée à partir de la forme du nom de fichier. Dans le cas d
--arbre construit, soit l'option doit être spécifiée, soit le nom de fichier doit se terminer par un
sabrer; deux barres obliques à la fin signifient --arbre-non construit. Si une donnée
répertoire a un sous-répertoire "click", il est interprété comme --cliquez sur la source.

TEST OPTIONS

Sauf indication contraire, ceux-ci affectent tous les arguments de test ultérieurs.

-B | --pas de binaires construits
Tous les binaires construits à partir des --la source or --arbre-non construit les tests ne seront pas
construit ou ignoré, et les dépendances sont satisfaites des packages de l'archive.
Notez que les packages sont toujours construits si un test nécessite besoin de construction.

--build-binaires
Subséquent --la source or --arbre-non construit les tests seront construits et leurs dépendances
être satisfait des binaires construits. C'est le comportement par défaut, donc vous
besoin de cela pour revenir à un précédemment spécifié --pas de binaires construits option.

--override-control=PATH
Lire les métadonnées de test de PATH au lieu de debian/tests/contrôle (pour Debian
sources) ou le manifeste Click pour le test suivant.

--nom du test=TEST
Exécutez uniquement le nom de test donné (à partir du fichier de contrôle de test) dans le test suivant.

Journalisation OPTIONS

Si vous ne spécifiez aucune option, adt-run écrit uniquement ses sorties/résultats dans stderr.

-o dir | --rép-sortie=dir
Spécifie que les artefacts de test (stderr et stdout des tests, le fichier journal,
packages binaires construits, etc.) doivent être placés dans le répertoire donné. dir ne doit pas
exister encore ou être vide, sinon adt-run refusera de l'utiliser.

-l fichier journal | --log-file=fichier journal
Spécifie que le journal de suivi doit être écrit dans fichier journal au lieu de rép_sortie.

--résumé=Sommaire
Spécifie qu'un résumé du résultat doit être écrit à Sommaire. Les événements
dans le résumé sont écrits dans le journal dans tous les cas.

-q | --silencieux
N'envoyez pas de copie de adt-runLogstream de trace vers stderr. Cette option ne
affecter la copie envoyée à fichier journal or rép_sortie. Notez que sans la trace
logstream, il peut être très difficile de diagnostiquer les problèmes.

TEST LIT SETUP OPTIONS

--setup-commandes=commandes
Courir commandes après avoir ouvert le banc d'essai. Cela peut être utilisé par exemple pour activer des
apt sources, exécutez apt-get Mise à jour ou similaire. Si commandes est un nom de fichier existant,
les commandes sont lues à partir de cela ; sinon c'est une chaîne avec les commandes réelles
qui est exécuté tel quel. Les noms de fichiers sans répertoire seront recherchés dans les deux
répertoire courant et dans /usr/share/autopkgtest/setup-commands/ donc tu n'as pas besoin
pour donner le chemin complet des scripts de configuration fournis avec autopkgtest.

Cette option peut être spécifiée plusieurs fois.

If --utilisateur est donné ou le banc d'essai fournit un utilisateur-normal-suggéré capacité, la
$ADT_NORMAL_USER La variable d'environnement sera définie sur cet utilisateur.

Si les commandes de configuration affectent quoi que ce soit dans les répertoires de démarrage (comme / boot or
/ lib / systemd / system) et le banc d'essai prend en charge le redémarrage, le banc d'essai sera
redémarré après les commandes de configuration. Cela peut être supprimé en créant un fichier
/run/autopkgtest_no_reboot.stamp.

--apt-upgrade | -U
Courir apt-get Mise à jour et apt-get dist-upgrade -y dans le banc d'essai avant d'exécuter le
Des tests.

--apt-poche=pocket[=nompaquet,src:nomsrc,...]
Ajouter des sources appropriées pour libérer-poche. Cela trouve le premier deb faire la queue
/etc/apt/sources.list qui ne spécifie pas déjà une poche et ajoute un deb et
ligne deb-src avec cette poche pour /etc/apt/sources.list.d/poche.liste. Ça aussi
en cours apt-get Mise à jour pour la nouvelle poche (mais pas pour autre chose).

Si une liste de packages est donnée après =, configurez l'épinglage apt pour n'utiliser que ces packages
poche. Une entrée "src:srcname" s'étend à tous les packages binaires construits par cela
la source. Cela peut être utilisé pour minimiser les dépendances tirées de poche de sorte que
les mises à jour de paquet dans cette poche peuvent être testées indépendamment les unes des autres pour
meilleur isolement. Attention : Cela ne résout pas actuellement certaines situations où
les dépendances des packages donnés ne peuvent être résolues que dans la poche donnée. Dans
dans ce cas, l'épinglage apt sera supprimé et l'installation du package sera retentée
avec l'intégralité de poche.

--copie=CHEMIN HOTE:CHEMIN TESTBEDP
Copiez le fichier ou le répertoire de l'hôte dans le banc d'essai après ouverture. Cela arrive avant
--setup-commandes vous pouvez donc utiliser ces fichiers dans les commandes de configuration.

--env=VAR=valeur
Définissez une variable d'environnement arbitraire dans le build et le test. Peut être spécifié plusieurs
fois.

UTILISATEUR/PRIVILÈGE MANIPULATION OPTIONS

-u utilisateur | --utilisateur=utilisateur
Exécutez les builds et les tests en tant que utilisateur sur le banc d'essai. Cela nécessite une racine sur le banc d'essai ; si
root sur le banc d'essai n'est pas disponible, puis les builds et les tests s'exécutent quel que soit l'utilisateur
à condition de.

--gain-root=gain-racine
Préfixes debian/règles binaire avec gain-racine. La valeur par défaut est de ne rien utiliser,
sauf que si --utilisateur est fourni ou root sur le banc d'essai n'est pas disponible le
la valeur par défaut est fausse racine.

DÉBOGAGE OPTIONS

--déboguer|-d
Incluez des informations de débogage supplémentaires dans le journal de suivi. Chaque supplémentaires -d
augmente le niveau de débogage ; le maximum actuel est -ddd. Si vous aimez voir
que se passe-t-il, -d or -jj is recommandé.

--shell-fail|-s
Exécuter un shell interactif dans le banc de test après l'échec d'une génération, d'un test ou d'une dépendance
installation.

--coquille
Exécutez un shell interactif dans le banc de test après chaque test.

TIMEOUT OPTIONS

--temps libre-qui=secondes
Utilisez un délai d'attente différent pour les opérations sur ou avec le banc d'essai. Ils sont cinq
timeouts affectés par cinq valeurs de qui: court: opérations prétendument courtes comme
configuration de l'apt du banc d'essai et vérification de l'état (par défaut : 100 s) ; installer:
installation de packages incluant les dépendances (par défaut : 3,000 XNUMX s) ; tester: tests
(par défaut : 10,000 XNUMX s) ; copier: copie des fichiers/répertoires entre l'hôte et le banc d'essai (par défaut :
300 s); et construire: builds (par défaut : 100,000 XNUMX s). La valeur doit être spécifiée en tant que
nombre entier de secondes.

--timeout-facteur=double
Multipliez tous les délais d'attente par défaut par le facteur spécifié (voir --temps libre-qui
dessus). Seules les valeurs par défaut sont affectées ; les paramètres de délai d'attente explicites sont utilisés exactement
comme spécifié.

LIEU OPTIONS

--set-lang=langue
Lors de l'exécution de commandes sur le banc d'essai, définit le LANGUE variable d'environnement à
langue. La valeur par défaut dans adt-run est de le régler sur C.UTF-8.

AUTRES OPTIONS

--pas de contrôle automatique
Désactivez la génération automatique de tests avec autodep8, même s'il est installé. Dans ce
cas, les packages sans tests se termineront avec le code 8 ("Pas de tests dans ce package")
comme sans autodep8.

--build-parallèleN
Ensemble parallèle=N DEB_BUILD_OPTION pour la création de packages. Par défaut c'est le
nombre de processeurs disponibles. Ceci est surtout utile dans les conteneurs où vous pouvez
restreindre la RAM disponible, mais pas le nombre de processeurs.

-h|--Aidez-moi
Afficher l'aide de la ligne de commande et quitter.

VIRTUALISATION SERVEUR

--- serveur-virt virt-serveur-arg
Spécifie le serveur du régime de virtualisation, en tant que commande et arguments à appeler.
serveur-virt doit être un serveur de virtualisation autopkgtest existant tel que adt-virt-
Abandonner or adt-virt-qemu. Vous pouvez laisser de côté le adt-virt- préfixe et spécifiez simplement
la dernière partie, par exemple Abandonner.

Tous les arguments et options restants après --- sont passés à la virtualisation
programme serveur. Consultez les pages de manuel des serveurs individuels pour savoir comment les utiliser.

SORTIE Format

Au cours d'un test normal, une ligne est imprimée pour chaque test. Celui-ci consiste en une courte
chaîne identifiant le test, quelques espaces horizontaux, et soit PASS or FAIL raison ou
SKIP raison pour laquelle l'indication de réussite/échec est séparée par une raison quelconque par une
espace.

La chaîne pour identifier le test consiste en une courte chaîne alphanumérique inventée par adt-
courir pour distinguer différents arguments de ligne de commande, le argide, suivi d'un tiret et
le nom de l'épreuve.

Parfois, un SKIP sera signalé lorsque le nom du test n'est pas connu ou non
applicable : par exemple, lorsqu'il n'y a pas de tests dans le package, ou qu'il y a un test
strophe qui contient des fonctionnalités non comprises par cette version de adt-run. Dans ce cas, *
apparaîtra là où le nom du test devrait être.

If adt-run détecte que des paquets erronés sont impliqués, il imprimera les deux lignes
faire des reproches: blâmé-chose et mauvais paquet : message. Ici, chaque espace est séparé blâmé-chose
fait partie de argument :argument (représentant un chemin trouvé dans un argument de ligne de commande),
dsc :paquet (un nom de package source), deb :paquet (un nom de package binaire) ou éventuellement un autre
chaînes à déterminer. Ceci indique quels arguments et/ou packages peuvent avoir
contribué au problème; ceux qui ont été traités le plus récemment et qui sont
par conséquent, les plus susceptibles d'être la cause d'un problème sont répertoriés en dernier.

CONFIGURATION DES DOSSIERS

Si vous utilisez beaucoup d'options ou d'arguments de serveur virt non triviaux, vous pouvez mettre n'importe quelle partie de
la ligne de commande dans un fichier texte, avec une ligne par option. Par exemple. tu peux créer un fichier
sid.cfg avec des contenus comme

-s
--output-dir=/tmp/testout
--apt-upgrade
---
Abandonner
sid

puis courir

adt-run foo_1_amd64.changes @sid.cfg

Le contenu du fichier de configuration sera développé sur place comme si vous aviez
étant donné son contenu sur la ligne de commande. Veuillez vous assurer que vous ne le font pas endroit surpeuplés jusqu'à XNUMX fois
options courtes et leurs valeurs, elles deviendraient une partie de la valeur de l'argument.

EXIT STATUT

0 tous les tests réussis
2 au moins un test sauté
4 au moins un test a échoué
6 au moins un test a échoué et au moins un test a été ignoré
8 pas de tests dans ce package
12 paquet erroné
16 échec du banc d'essai
20 autres échecs inattendus, y compris une mauvaise utilisation

Utilisez adt-run en ligne à l'aide des services onworks.net