adt-run - Online nel cloud

PROGRAMMA:

NOME

adt-run - testa un pacchetto binario installato utilizzando i test del pacchetto sorgente

SINOSSI

adt-run Opzioni... --- server virtuale [virt-server-arg...]

DESCRIZIONE

adt-run è il programma per richiamare il macchinario di test dei pacchetti autopkgtest.

autopkgtest è una funzionalità per testare i pacchetti binari Debian o Click, installati su un
sistema (ad esempio un sistema di test). I test sono quelli forniti nel pacchetto sorgente.

adt-run esegue ogni test fornito da un particolare pacchetto e ne segnala i risultati.
guida il regime di virtualizzazione specificato come appropriato e analizza la descrizione del test
metadati e organizza la copia dei dati da e verso il testbed, secondo necessità.

Vedere /usr/share/doc/autopkgtest/README.running-tests.rst.gz per un'introduzione su come
per usare adt-run.

SPECIFICANDO PROVE

Le azioni specificano i pacchetti sorgente e binari da testare o modificano ciò che accade con
argomenti del pacchetto:

--fonte DSC
Esegui i test dal pacchetto sorgente Debian DSCPer impostazione predefinita, il pacchetto verrà anche compilato
e i binari risultanti saranno utilizzati per soddisfare le dipendenze di test; per disabilitare
che, specificare il -B/--nessun-binario-costruito opzione prima.

L'ordinamento è significativo: ogni --fonte l'opzione dovrebbe precedere le opzioni la cui
le dipendenze devono essere soddisfatte dai binari che produce.

--albero non costruito elenco
Specifica che i test provengono dall'albero sorgente Debian non compilato elenco dovrebbe essere eseguito.
Questo è molto simile alla specificazione --fonte tranne che un albero di directory (che
dovrebbe essere incontaminato) anziché un pacchetto sorgente.

--albero costruito elenco
Specifica che i test provengono dall'albero sorgente Debian compilato elenco dovrebbe essere eseguito.
Si noti che tutte le dipendenze di test vengono quindi soddisfatte dai pacchetti di archivio, a meno che non si
specificare esplicitamente i file .deb compilati localmente con --binario.

--apt-source nomesrcpkg
Download nomesrcpkg con apt-get source nel banco di prova ed eseguire i test. Questo è
simile alla specificazione --fonte ma evita di copiare la sorgente dall'host al
banco di prova. I binari eventualmente compilati saranno non è un essere utilizzato per soddisfare le dipendenze, come
di solito in questa modalità si vogliono testare i binari da un archivio reale.

--git-source URL [nome del ramo]
Specifica che i test dall'albero sorgente Debian non compilato da git-cloning URL
dovrebbe essere eseguito. Se nome del ramo è dato, questo ramo verrà estratto invece di
l'impostazione predefinita (solitamente "master").

Questo è molto simile alla specificazione --albero non costruito dopo la clonazione, cioè questo è
comunemente usato con --nessun-binario-costruito. git il pacchetto verrà installato se
necessario.

--binario debuttante
Specifica che debuttante dovrebbe essere utilizzato per i test di tutti i seguenti pacchetti sorgente. Da
di default verrà utilizzato per soddisfare le dipendenze, sia durante la compilazione che durante il test.

L'ordinamento è significativo, come per --fonteIn particolare, se una fonte successiva
il pacchetto creerà un binario con lo stesso nome, che verrà utilizzato da quel momento in poi, e
debuttante verrà ignorato.

--i cambiamenti i cambiamenti
Specifica che i deb nel file .changes specificato devono essere utilizzati per i test di
pacchetto sorgente in quel .changes. Funziona come se avessi specificato .debs e .dsc
da un file .changes come argomenti espliciti.

--click-source clicksrc
Percorso per fare clic sull'albero sorgente per i successivi --clic pacchetto.

--clic clickpkg
If clickpkg è un file (*.click), installa il pacchetto click fornito nel testbed. Se lo è
un nome cliccabile (come "com.example.myapp"), presumi che sia già installato nel
testbed e leggere il manifesto da esso.

Esegui i test del pacchetto di clic dal precedente --click-sourceSe una fonte di clic
la directory non è specificata esplicitamente, verrà scaricata in base alla
manifesto x-source voce. Attualmente l'unico schema supportato è vcs-bzr.

Nome del file
Gli argomenti del nome del file nudo vengono elaborati come se --albero costruito, --fonte, --albero non costruito,
--apt-source, --binario, --i cambiamenti, --click-source, o --clic è stato specificato; il
la natura dell'argomento è intuibile dalla forma del nome del file. Nel caso di
--albero costruito, è necessario specificare l'opzione oppure il nome del file deve terminare con un
barra; due barre alla fine sono considerate --albero non costruitoSe un dato
la directory ha una sottodirectory "click", viene interpretata come --click-source.

TEST VERSIONI

Salvo diversa indicazione, questi influenzano tutti gli argomenti dei test successivi.

-B | --nessun-binario-costruito
Tutti i binari compilati da successivi --fonte or --albero non costruito i test non saranno
compilati o ignorati e le dipendenze sono soddisfatte con i pacchetti dall'archivio.
Si noti che i pacchetti vengono comunque compilati se un test lo richiede costruire-necessario.

--binari-costruiti
Successivo --fonte or --albero non costruito verranno creati i test e le relative dipendenze
essere soddisfatti dei binari compilati. Questo è il comportamento predefinito, quindi puoi solo
è necessario ripristinare una condizione precedentemente specificata --nessun-binario-costruito opzione.

--override-control=PERCORSO
Leggi i metadati del test da PERCORSO invece di debian/test/controllo (per Debian
fonti) o il manifesto Click per il seguente test.

--nometest=TEST
Esegui solo il nome del test specificato (dal file di controllo del test) nel test seguente.

REGISTRAZIONE VERSIONI

Se non specifichi alcuna opzione, adt-run scrive solo il suo output/risultati su stderr.

-o dir | --dir-uscita=dir
Specifica che gli artefatti di test (stderr e stdout dai test, il file di registro,
i pacchetti binari compilati ecc.) devono essere posizionati nella directory indicata. dir non deve
esistere ancora o essere vuoto, altrimenti adt-run rifiuterà di usarlo.

-l file di log | --file-log=file di log
Specifica che il registro di traccia deve essere scritto su file di log invece di dir-output.

--sommario=sommario
Specifica che un riepilogo del risultato dovrebbe essere scritto su sommario. Gli eventi
nel riepilogo vengono comunque scritti nel log.

-q | --silenzioso
Non inviare una copia di adt-runtraccia il flusso di log su stderr. Questa opzione non
influenzare la copia inviata a file di log or dir-outputNota che senza la traccia
logstream può essere molto difficile diagnosticare i problemi.

TEST LETTO IMPOSTARE VERSIONI

--comandi-di-configurazione=comandi
Correre comandi dopo aver aperto il banco di prova. Questo può essere utilizzato ad esempio per abilitare ulteriori
fonti appropriate, esegui apt-get update o simili. Se comandi è un nome di file esistente,
i comandi vengono letti da lì; altrimenti è una stringa con i comandi effettivi
che viene eseguito così com'è. I nomi dei file senza directory verranno cercati in entrambi i
directory corrente e in /usr/share/autopkgtest/comandi-di-configurazione/ quindi non hai bisogno
per fornire il percorso completo degli script di installazione forniti con autopkgtest.

Questa opzione può essere specificata più volte.

If --utente è dato o il banco di prova fornisce un utente normale suggerito capacità, il
$ADT_NORMAL_USER la variabile d'ambiente verrà impostata su quell'utente.

Se i comandi di installazione influenzano qualcosa nelle directory di avvio (come /avvio or
/ Lib / systemd / system) e il testbed supporta il riavvio, il testbed sarà
riavviato dopo i comandi di installazione. Questo può essere soppresso creando un file
/run/autopkgtest_no_reboot.stamp.

--apt-aggiornamento | -U
Correre apt-get update e apt-get dist-upgrade -y nel banco di prova prima di eseguire il
test.

--apt-pocket=pocket[=nomepacchetto,src:nomesrc,...]
Aggiungi fonti appropriate per rilasciare-tasca. Questo trova il primo debuttante linea in
/ Etc / apt / sources.list che non specifica già una tasca e aggiunge un deb e
linea deb-src con quella tasca a /etc/apt/sources.list.d/tasca.elenco. Anche questo
chiamate apt-get update per la nuova tasca (ma non per altro).

Se dopo = viene fornito un elenco di pacchetti, impostare apt pinning per utilizzare solo quei pacchetti
da tascaUna voce "src:srcname" si espande a tutti i pacchetti binari creati da quella
fonte. Questo può essere utilizzato per ridurre al minimo le dipendenze prese da tasca affinché
gli aggiornamenti dei pacchetti in quella tasca possono essere testati indipendentemente l'uno dall'altro per
migliore isolamento. Nota: Questo al momento non risolve alcune situazioni in cui
le dipendenze dei pacchetti dati possono essere risolte solo nella tasca data. In
in tal caso l'apt pinning verrà rimosso e l'installazione del pacchetto verrà ripetuta
con l'interezza di tasca.

--copia=PERCORSO HOST:PERCORSO DI TEST
Copia il file o la directory dall'host al testbed dopo l'apertura. Questo accade prima
--comandi-di-impostazione in questo modo è possibile utilizzare questi file nei comandi di installazione.

--env=VAR=valore
Imposta una variabile d'ambiente arbitraria nella build e nel test. Può essere specificata più volte
volte.

UTENTE/PRIVILEGIO TRATTAMENTO VERSIONI

-u Utente | --utente=Utente
Esegui build e test come Utente sul banco di prova. Questo richiede root sul banco di prova; se
root sul testbed non è disponibile, quindi le build e i test vengono eseguiti come qualsiasi utente
fornito.

--guadagno-radice=guadagno-radice
Prefissi debian/regole binario con radice di guadagno. L'impostazione predefinita è non utilizzare nulla,
tranne che se --utente è fornito o la radice sul testbed non è disponibile
l'impostazione predefinita è falsa radice.

DEBUG VERSIONI

- debug|-d
Includere ulteriori informazioni di debug nel registro di traccia. Ogni ulteriore -d
aumenta il livello di debug; il massimo attuale è -ddSe ti piace vedere
cosa sta succedendo, -d or -DD is raccomandato.

--shell-fallimento|-s
Eseguire una shell interattiva nel testbed dopo una build, un test o una dipendenza non riusciti
installazione.

--conchiglia
Dopo ogni test, eseguire una shell interattiva nel testbed.

TIMEOUT VERSIONI

--tempo scaduto-quale=secondo
Utilizzare un timeout diverso per le operazioni sul o con il testbed. Ci sono cinque
timeout influenzati da cinque valori di quale: corto: operazioni presumibilmente brevi come
impostazione dell'apt del testbed e controllo dello stato (predefinito: 100s); install:
installazione di pacchetti, comprese le dipendenze (predefinito: 3,000 s); test: test eseguiti
(predefinito: 10,000 s); copia: copia file/directory tra host e testbed (predefinito:
300); e costruire: build (predefinito: 100,000). Il valore deve essere specificato come
numero intero di secondi.

--fattore-timeout=doppio
Moltiplicare tutti i timeout predefiniti per il fattore specificato (vedere --tempo scaduto-quale
sopra). Sono interessati solo i valori predefiniti; le impostazioni di timeout esplicite vengono utilizzate esattamente
come specificato.

LOCALE VERSIONI

--set-lang=langval
Quando si eseguono comandi sul banco di prova, imposta il LUNGO variabile d'ambiente a
langval. L'impostazione predefinita in adt-run è impostarlo su C.UTF-8.

ALTRO VERSIONI

--nessun controllo automatico
Disabilitare la generazione automatica dei test con autodep8, anche se è installato. In questo
caso, i pacchetti senza test usciranno con il codice 8 ("Nessun test in questo pacchetto")
proprio come senza autodep8.

--build-parallelN
Impostato parallelo=N DEB_BUILD_OPTION per la creazione di pacchetti. Per impostazione predefinita, questa è la
numero di processori disponibili. Questo è particolarmente utile nei contenitori in cui è possibile
limitare la RAM disponibile, ma non limitare il numero di CPU.

-h|--Aiuto
Mostra la guida della riga di comando ed esci.

VIRTUALIZZAZIONE SERVER

--- server virtuale virt-server-arg...
Specifica il server del regime di virtualizzazione, come comando e argomenti da richiamare.
server virtuale deve essere un server di virtualizzazione autopkgtest esistente come adt-virt-
Rottame or adt-virt-qemuPuoi omettere il adt-virt- prefisso e basta specificare
l'ultima parte, ad esempio Rottame.

Tutti gli argomenti e le opzioni rimanenti dopo --- vengono passati alla virtualizzazione
programma server. Consultare le pagine man dei singoli server per sapere come utilizzarli.

USCITA FORMATO

Durante un normale test, viene stampata una riga per ogni test. Questa consiste in un breve
stringa che identifica il test, alcuni spazi orizzontali e uno dei due PASSAGGIO or FAIL ragione o
SALTA motivo per cui l'indicazione di superamento/fallimento è separata da un motivo orizzontale
spazio bianco.

La stringa per identificare il test è costituita da una breve stringa alfanumerica inventata da adt-
eseguire il per distinguere diversi argomenti della riga di comando, il argido, seguito da un trattino e
il nome del test.

A volte a SALTA verrà segnalato quando il nome del test non è noto o non
applicabile: ad esempio, quando non ci sono test nel pacchetto, o c'è un test
strofa che contiene caratteristiche non comprese da questa versione di adt-run. In questo caso *
apparirà dove dovrebbe esserci il nome del test.

If adt-run rileva che sono coinvolti pacchetti errati, stamperà le due righe
colpa: cosa incolpata... e pacchetto errato: messaggio. Qui ogni spazio vuoto è separato cosa incolpata
è uno dei argomento:argomento (che rappresenta un percorso trovato in un argomento della riga di comando),
dsc:pacchetto (un nome di pacchetto sorgente), come:pacchetto (un nome di pacchetto binario) o eventualmente altro
stringhe da determinare. Questo indica quali argomenti e/o pacchetti potrebbero avere
hanno contribuito al problema; quelli che sono stati elaborati più di recente e che sono
pertanto quelli che hanno maggiori probabilità di essere la causa di un problema sono elencati per ultimi.

CONFIGURAZIONE FILE

Se si utilizzano molte opzioni o argomenti non banali del server virt, è possibile inserire qualsiasi parte di
la riga di comando in un file di testo, con una riga per opzione. Ad esempio, puoi creare un file
sid.cfg con contenuti come

-s
--output-dir=/tmp/testout
--apt-aggiornamento
---
Rottame
sid

e poi corri

adt-run foo_1_amd64.changes @sid.cfg

Il contenuto del file di configurazione verrà espanso sul posto come se lo avresti fatto tu
dato il suo contenuto sulla riga di comando. Per favore assicurati di non posto spazi fra
opzioni brevi e i loro valori, diventerebbero parte del valore dell'argomento.

EXIT STATUS

0 tutti i test superati
2 almeno un test saltato
4 almeno un test fallito
6 almeno un test è fallito e almeno un test è stato saltato
8 nessun test in questo pacchetto
12 pacchetti errati
16 fallimento del banco di prova
Altri 20 guasti imprevisti, incluso un cattivo utilizzo

Utilizzare adt-run online utilizzando i servizi onworks.net