adt-run - Online w chmurze

PROGRAM:

IMIĘ

adt-run - przetestuj zainstalowany pakiet binarny, korzystając z testów pakietu źródłowego

STRESZCZENIE

bieg adt Opcje... --- serwer wirtualny [virt-server-arg...]

OPIS

bieg adt to program do wywoływania maszyny testującej pakiety autopkgtest.

autopkgtest to narzędzie do testowania binarnych pakietów Debiana lub Click, zainstalowanych na komputerze
systemu (takiego jak system stanowiska testowego). Testy są dostarczane w pakiecie źródłowym.

adt-run uruchamia każdy test dostarczony przez konkretny pakiet i raportuje wyniki. To
odpowiednio steruje określonym reżimem wirtualizacji i analizuje opis testu
metadane i organizuje kopiowanie danych do i ze stanowiska testowego, zgodnie z wymaganiami.

Zobacz /usr/share/doc/autopkgtest/README.running-tests.rst.gz, aby zapoznać się z wprowadzeniem na temat sposobu
aby użyć adt-run.

OKREŚLANIE TESTY

Akcje określają pakiety źródłowe i binarne do przetestowania lub zmieniają to, co się dzieje
argumenty pakietu:

--źródło DSC
Uruchom testy z pakietu źródłowego Debiana DSC. Domyślnie pakiet również zostanie zbudowany
a powstałe pliki binarne zostaną użyte w celu spełnienia zależności testowych; wyłączyć
to określ -B/--brak wbudowanych plików binarnych opcję wcześniej.

Kolejność jest istotna: każda --źródło opcja powinna poprzedzać opcje, których
zależności mają być spełnione przez tworzone pliki binarne.

--niezabudowane-drzewo katalog
Określa, że ​​przeprowadzane są testy z niezabudowanego drzewa źródłowego Debiana katalog należy uruchomić.
Jest to bardzo podobne do określania --źródło z tą różnicą, że drzewo katalogów (które
powinien być nieskazitelny) jest dostarczany zamiast pakietu źródłowego.

--zbudowane drzewo katalog
Określa, że ​​przeprowadzane są testy ze zbudowanego drzewa źródłowego Debiana katalog należy uruchomić.
Pamiętaj, że wszystkie zależności testowe są wówczas spełniane przez pakiety archiwalne, chyba że ty
jawnie określ lokalnie zbudowany plik .debs za pomocą --dwójkowy.

--apt-źródło nazwa_srcpkg
Pliki do Pobrania nazwa_srcpkg w apt-get źródło na stanowisku testowym i uruchom jego testy. To jest
podobne do określenia --źródło ale pozwala uniknąć kopiowania źródła z hosta do pliku
stanowisko testowe. Prawdopodobnie zbudowane pliki binarne tak zrobią nie być używane do spełnienia zależności, jak
zazwyczaj w tym trybie chcesz testować pliki binarne z prawdziwego archiwum.

--git-źródło URL [Nazwa oddziału]
Określa, że ​​przeprowadzane są testy z niezabudowanego drzewa źródłowego Debiana z klonowania git URL
należy uruchomić. Jeśli Nazwa oddziału zostanie podana, ta gałąź zostanie wypisana zamiast
domyślny (zwykle „master”).

Jest to bardzo podobne do określania --niezabudowane-drzewo po sklonowaniu, czyli tak
powszechnie używane z --brak wbudowanych plików binarnych, odrzutowiec pakiet zostanie zainstalowany, jeśli
niezbędny.

--dwójkowy deb
Określa, że deb powinien być używany do testów wszystkich następujących pakietów źródłowych. Przez
domyślnie będzie używany do spełnienia zależności, zarówno podczas budowania, jak i testowania.

Kolejność jest istotna, np --źródło. W szczególności, jeśli kolejne źródło
package zbuduje plik binarny o tej samej nazwie, który będzie używany od tej pory, oraz
deb zostaną zignorowane.

--zmiany zmiany
Określa, że ​​debs w podanych zmianach powinny być użyte do testów
pakiet źródłowy w tym pliku .changes. Działa tak, jakbyś podał pliki .debs i .dsc
z pliku .changes jako jawne argumenty.

--kliknij źródło kliknięciarc
Ścieżka do kliknięcia drzewa źródłowego w celu uzyskania dalszych informacji --Kliknij pakiet.

--Kliknij kliknijpkg
If kliknijpkg jest plikiem (*.click), zainstaluj dany pakiet kliknięcia w środowisku testowym. Jeśli to jest
nazwę kliknięcia (np. „com.example.myapp”), załóżmy, że jest ona już zainstalowana w
testbed i przeczytaj z niego manifest.

Uruchom testy pakietu kliknięć z poprzedniego --kliknij źródło. Jeśli klikniesz źródło
katalog nie jest określony jawnie, zostanie pobrany zgodnie z plikiem
manifest źródło x wejście. Obecnie jedynym obsługiwanym schematem jest vcs-bzr.

filename
Argumenty samej nazwy pliku są przetwarzane tak, jak gdyby --zbudowane drzewo, --źródło, --niezabudowane-drzewo,
--apt-źródło, --dwójkowy, --zmiany, --kliknij źródłolub --Kliknij został określony; the
charakter argumentu można odgadnąć na podstawie formy nazwy pliku. W przypadku
--zbudowane drzewo, należy określić opcję lub nazwa pliku musi kończyć się na a
ciąć; oznaczają dwa ukośniki na końcu --niezabudowane-drzewo. Jeśli dane
katalog zawiera podkatalog „kliknij”, jest on interpretowany jako --kliknij źródło.

TESTOWANIE OPCJE

O ile nie zaznaczono inaczej, mają one wpływ na wszystkie kolejne argumenty testowe.

-B | --brak wbudowanych plików binarnych
Wszystkie zbudowane pliki binarne z kolejnych --źródło or --niezabudowane-drzewo testów nie będzie
zbudowane lub zignorowane, a zależności są zadowalające z pakietami z archiwum.
Należy pamiętać, że pakiety są nadal budowane, jeśli wymaga tego test potrzebna kompilacja.

--wbudowane pliki binarne
Kolejny --źródło or --niezabudowane-drzewo zostaną zbudowane testy i ich zależności
być zadowolonym ze zbudowanych plików binarnych. Jest to zachowanie domyślne, więc tylko Ty
potrzebuję tego, aby przywrócić wcześniej określony --brak wbudowanych plików binarnych opcja.

--override-control=PATH
Przeczytaj metadane testowe z PATH zamiast debian/testy/kontrola (dla Debiana
źródła) lub manifest kliknięcia dla następującego testu.

--nazwa testu=TESTOWANIE
W następnym teście uruchom tylko podaną nazwę testu (z pliku kontrolnego testu).

LOGOWANIE OPCJE

Jeśli nie określisz żadnej opcji, bieg adt zapisuje tylko swoje dane wyjściowe/wyniki na stderr.

-o reż | --katalog-wyj=reż
Określa, że ​​artefakty testowania (stderr i stdout z testów, plik dziennika,
zbudowane pakiety binarne itp.) należy umieścić w podanym katalogu. reż nie możesz
jeszcze istnieć lub być pustym, w przeciwnym razie bieg adt odmówi korzystania z niego.

-l logfile | --plik-log=logfile
Określa, w którym powinien być zapisywany dziennik śledzenia logfile zamiast do katalog wyjściowy.

--podsumowanie=streszczenie
Określa, że ​​należy zapisać podsumowanie wyniku streszczenie. Wydarzenia
w podsumowaniu są w każdym przypadku zapisywane w dzienniku.

-q | --cichy
Nie wysyłaj kopii bieg adtstrumień dziennika śledzenia do stderr. Ta opcja nie
mieć wpływ na kopię wysłaną do logfile or katalog wyjściowy. Pamiętaj, że bez śladu
logstream zdiagnozowanie problemów może być bardzo trudne.

TESTOWANIE BED USTAWIAĆ OPCJE

--polecenia-setup=Polecenia
Uruchom Polecenia po otwarciu stanowiska testowego. Można to wykorzystać np. do włączenia dodatkowych
trafne źródła, uruchom apt-get aktualizacja lub podobne. Jeśli Polecenia to istniejąca nazwa pliku,
z tego odczytywane są polecenia; w przeciwnym razie jest to ciąg znaków zawierający rzeczywiste polecenia
to będzie działać tak jak jest. Nazwy plików bez katalogu będą wyszukiwane zarówno w formacie
bieżący katalog i w /usr/share/autopkgtest/setup-commands/ więc nie potrzebujesz
aby podać pełną ścieżkę dla skryptów instalacyjnych dostarczanych z autopkgtest.

Tę opcję można określić wielokrotnie.

If --użytkownik jest podana lub stanowisko testowe zapewnia a sugerowany-zwykły-użytkownik zdolności,
$ADT_NORMAL_USER zmienna środowiskowa zostanie ustawiona na tego użytkownika.

Jeśli polecenia instalacyjne wpływają na cokolwiek w katalogach rozruchowych (np /bagażnik or
/lib/systemd/system), a stanowisko testowe obsługuje ponowne uruchamianie, stanowisko testowe będzie
uruchomiony ponownie po wydaniu poleceń instalacyjnych. Można to wyeliminować, tworząc plik
/run/autopkgtest_no_reboot.stamp.

--apt-aktualizacja | -U
Uruchom apt-get aktualizacja i apt-get dist-upgrade -y na stanowisku testowym przed uruchomieniem
testów.

--apt-pocket=kieszeń[=nazwapakietu,src:nazwaźródła,...]
Dodaj odpowiednie źródła dla zwolnić-kieszeń. To znajduje pierwsze deb wyrysować
/ Etc / apt / sources.list który nie określa już kieszeni i dodaje deb i
deb-src linia z tą kieszenią do /etc/apt/sources.list.d/kieszeń.lista. To także
Połączenia apt-get aktualizacja na nową kieszeń (ale nie na nic innego).

Jeśli lista pakietów jest podana po =, skonfiguruj apt pinning tak, aby używał tylko tych pakietów
od kieszeń. Wpis „src:srcname” rozszerza się na wszystkie zbudowane przez niego pakiety binarne
źródło. Można tego użyć do minimalizacji zależności pobranych z kieszeń tak, że
aktualizacje pakietów w tej kieszeni można testować niezależnie od siebie
lepsza izolacja. Uwaga: Nie rozwiązuje to obecnie niektórych sytuacji, w których
zależności danych pakietów można rozwiązać tylko w danej kieszeni. W
w takim przypadku przypinanie apt zostanie usunięte i ponowiona zostanie próba instalacji pakietu
z całością kieszeń.

--kopia=ŚCIEŻKA HOSTA: ŚCIEŻKA ŚCIEŻKI TESTOWEJ
Po otwarciu skopiuj plik lub katalog z hosta do środowiska testowego. To zdarza się wcześniej
--polecenia-konfiguracji dzięki temu możesz używać tych plików w poleceniach instalacyjnych.

--środowisko=WAR=wartość
Ustaw dowolną zmienną środowiskową w kompilacji i teście. Można określić wiele
razy.

UŻYTKOWNIK/PRZYWILEJE OBSŁUGA OPCJE

-u użytkownik | --użytkownik=użytkownik
Uruchom kompilacje i testy jako użytkownik na stanowisku testowym. Wymaga to rootowania na platformie testowej; Jeśli
root na platformie testowej nie jest dostępny, wówczas kompilacje i testy są uruchamiane jako dowolny użytkownik
opatrzony.

--gain-root=zysk-korzeń
prefiksy debian/zasady dwójkowy z rootem zysku. Domyślnie nie należy niczego używać,
z wyjątkiem tego, że jeśli --użytkownik jest dostarczony lub root na platformie testowej jest niedostępny
wartość domyślna to fałszywy korzeń.

DEBUGOWANIE OPCJE

--odpluskwić|-d
Dołącz dodatkowe informacje dotyczące debugowania w dzienniku śledzenia. Każda dodatkowa -d
zwiększa poziom debugowania; obecne maksimum wynosi -ddd. Jeśli chcesz zobaczyć
co się dzieje, -d or -dd is zalecane.

--powłoka-awaria|-s
Uruchom interaktywną powłokę w środowisku testowym po nieudanej kompilacji, teście lub zależności
instalacja.

--powłoka
Po każdym teście uruchamiaj interaktywną powłokę w środowisku testowym.

TIMEOUT OPCJE

--koniec czasu-który=sekund
Użyj innego limitu czasu dla operacji na stole testowym lub z nim. Jest ich pięć
limity czasu, na które wpływa pięć wartości który: krótki: rzekomo krótkie operacje, takie jak
ustawienie apt platformy testowej i sprawdzenie stanu (domyślnie: 100s); zainstalować:
instalacja pakietów zawierających zależności (domyślnie: 3,000s); test: uruchomienia testowe
(domyślnie: 10,000 XNUMX); kopia: kopiuje pliki/katalogi pomiędzy hostem a środowiskiem testowym (domyślnie:
300.); I budować: kompilacje (domyślnie: 100,000 XNUMX). Wartość musi być określona jako
całkowita liczba sekund.

--współczynnik przekroczenia limitu czasu=Podwójna
Pomnóż wszystkie domyślne limity czasu przez określony współczynnik (patrz --koniec czasu-który
powyżej). Dotyczy to tylko ustawień domyślnych; jawne ustawienia limitu czasu są używane dokładnie
jak określono.

LOCAL OPCJE

--set-lang=Langval
Podczas uruchamiania poleceń na platformie testowej ustawia JĘZYK zmienna środowiskowa do
Langval. Domyślnie w bieg adt jest ustawienie tego C.UTF-8.

INNE OPCJE

--brak automatycznej kontroli
Wyłącz automatyczne generowanie testów za pomocą autodep8, nawet jeśli jest zainstalowany. W tym
w tym przypadku pakiety bez testów zostaną zakończone z kodem 8 („Brak testów w tym pakiecie”)
tak jak bez autodep8.

--kompilacja równoległaN
Zestaw równoległy=N DEB_BUILD_OPTION do budowania pakietów. Domyślnie jest to
liczba dostępnych procesorów. Jest to przydatne głównie w kontenerach, gdzie jest to możliwe
ogranicz dostępną pamięć RAM, ale nie ograniczaj liczby procesorów.

-h|--help
Pokaż pomoc wiersza poleceń i zakończ.

WIRTUALIZACJA SERVER

--- serwer wirtualny virt-server-arg...
Określa serwer reżimu wirtualizacji jako polecenie i argumenty do wywołania.
serwer wirtualny musi być istniejącym serwerem wirtualizacji autopkgtest, takim jak adt-virt-
złom or adt-virt-qemu. Możesz pominąć adt-virt- prefiks i po prostu określ
ostatnia część, np złom.

Wszystkie pozostałe argumenty i opcje po --- są przekazywane do wirtualizacji
program serwerowy. Zobacz strony podręcznika poszczególnych serwerów, aby dowiedzieć się, jak z nich korzystać.

WYDAJNOŚĆ FORMAT

Podczas normalnego przebiegu testu dla każdego testu drukowana jest jedna linia. Składa się z krótkiego
ciąg znaków identyfikujący test, trochę poziomych białych znaków i jedno i drugie PASS or FAIL powód lub
POMINĄĆ powód, dla którego wskazanie pozytywnego/negatywnego wyniku jest z dowolnego powodu oddzielone poziomą linią
Biała przestrzeń.

Ciąg identyfikujący test składa się z krótkiego ciągu alfanumerycznego wymyślonego przez dodatek-
biegać aby rozróżnić różne argumenty wiersza poleceń, twardy, po którym następuje łącznik i
nazwa testu.

Czasami POMINĄĆ zostaną zgłoszone, jeśli nazwa testu nie będzie znana lub nie
ma zastosowanie: np. gdy w pakiecie nie ma testów lub jest test
zwrotka zawierająca funkcje niezrozumiałe dla tej wersji bieg adt. W tym przypadku *
pojawi się w miejscu, w którym powinna znajdować się nazwa testu.

If bieg adt wykryje, że w grę wchodzą błędne pakiety, wydrukuje dwie linie
winić: obwiniana rzecz... i badpkg: wiadomość. Tutaj każdy z nich jest oddzielony spacjami obwiniana rzecz
Jest to jeden z argument:argument (reprezentujący nazwę ścieżki znalezioną w argumencie wiersza poleceń),
dsc:pakiet (nazwa pakietu źródłowego), dłużnik:pakiet (nazwa pakietu binarnego) lub ewentualnie inny
stringi do ustalenia. Wskazuje, jakie argumenty i/lub pakiety mogą mieć
przyczynił się do problemu; te, które były przetwarzane ostatnio i które są
dlatego te, które najprawdopodobniej są przyczyną problemu, są wymienione na końcu.

KONFIGURACJA AKTA

Jeśli używasz wielu opcji lub nietrywialnych argumentów serwera virt, możesz umieścić dowolną część
wiersz poleceń do pliku tekstowego, z jednym wierszem na opcję. Np. możesz utworzyć plik
sid.cfg z zawartością np

-s
--output-dir=/tmp/testout
--apt-aktualizacja
---
złom
sid

a następnie uciekać

adt-run foo_1_amd64.changes @sid.cfg

Zawartość pliku konfiguracyjnego zostanie rozszerzona w miejscu, tak jakbyś to zrobił
podając jego zawartość w wierszu poleceń. Proszę upewnić się, że ty nie miejsce obowiązuje pomiędzy
krótkie opcje i ich wartości, staną się częścią wartości argumentu.

EXIT STATUS

0 wszystkie testy zaliczone
2 co najmniej jeden test został pominięty
4 co najmniej jeden test nie powiódł się
6 co najmniej jeden test nie powiódł się i co najmniej jeden test został pominięty
8 brak testów w tym pakiecie
12 błędnych pakietów
16 awarii stanowiska testowego
20 innych nieoczekiwanych awarii, w tym nieprawidłowe użytkowanie

Skorzystaj z usługi adt-run online, korzystając z usług onworks.net