adt-run - Dalam talian di Awan

JADUAL:

NAMA

adt-run - menguji pakej binari yang dipasang menggunakan ujian pakej sumber

SINOPSIS

adt-run pilihan... --- virt-server [virt-server-arg...]

DESCRIPTION

adt-run ialah program untuk menggunakan jentera ujian pakej autokgtest.

autokgtest ialah kemudahan untuk menguji pakej Debian atau Klik binari, seperti yang dipasang pada a
sistem (seperti sistem testbed). Ujian adalah yang dibekalkan dalam pakej sumber.

adt-run menjalankan setiap ujian yang dibekalkan oleh pakej tertentu dan melaporkan hasilnya. Ia
memacu rejim virtualisasi yang ditentukan mengikut kesesuaian, dan menghuraikan perihalan ujian
metadata, dan mengatur agar data disalin ke dan dari katil ujian seperti yang diperlukan.

Lihat /usr/share/doc/autopkgtest/README.running-tests.rst.gz untuk pengenalan tentang cara
untuk menggunakan adt-run.

MENYERTAI UJIAN

Tindakan menentukan sumber dan pakej binari untuk diuji, atau menukar perkara yang berlaku
hujah pakej:

--sumber DSC
Jalankan ujian daripada pakej sumber Debian DSC. Secara lalai pakej juga akan dibina
dan binari yang terhasil akan digunakan untuk memenuhi kebergantungan ujian; untuk melumpuhkan
itu, nyatakan -B/--tiada-binari-binari pilihan sebelum ini.

Pesanan adalah penting: setiap satu --sumber pilihan harus mendahului pilihan yang
kebergantungan harus dipenuhi oleh binari yang dihasilkannya.

--pokok yang tidak dibina direktori
Menentukan ujian itu daripada pepohon sumber Debian yang belum dibina direktori harus dijalankan.
Ini sangat serupa dengan menentukan --sumber kecuali pokok direktori (yang
harus murni) dibekalkan, bukannya pakej sumber.

--pokok terbina direktori
Menentukan ujian itu daripada pepohon sumber Debian yang dibina direktori harus dijalankan.
Ambil perhatian bahawa semua kebergantungan ujian kemudiannya berpuas hati dengan pakej arkib, melainkan anda
nyatakan secara eksplisit binaan tempatan .debs dengan --perduaan.

--apt-source srcpkgname
Muat Turun srcpkgname bersama apt-get sumber dalam katil ujian dan jalankan ujiannya. Ini adalah
serupa dengan menyatakan --sumber tetapi mengelak menyalin sumber daripada hos ke
katil ujian. Binari berkemungkinan akan tidak digunakan untuk memenuhi tanggungan, sebagai
biasanya dalam mod ini anda ingin menguji binari dari arkib sebenar.

--git-source URL [nama cawangan]
Menentukan ujian itu daripada pokok sumber Debian yang belum dibina daripada pengklonan git URL
harus dijalankan. Jika nama cawangan diberikan, cawangan ini akan diperiksa dan bukannya
lalai (biasanya "tuan").

Ini sangat serupa dengan menentukan --pokok yang tidak dibina selepas pengklonan, iaitu ini
biasa digunakan dengan --tiada-binari-binari. Yang pergi pakej akan dipasang jika
perlu.

--perduaan deb
Menyatakan itu deb hendaklah digunakan untuk ujian semua pakej sumber berikut. Oleh
lalai ia akan digunakan untuk memenuhi kebergantungan, kedua-dua semasa membina dan ujian.

Pesanan adalah penting, bagi --sumber. Khususnya, jika sumber berikutnya
pakej akan membina binari dengan nama yang sama, yang akan digunakan sejak itu, dan
deb akan diabaikan.

--perubahan perubahan
Menentukan bahawa debs dalam .perubahan yang diberikan harus digunakan untuk ujian bagi
pakej sumber dalam .perubahan itu. Bertindak seolah-olah anda telah menentukan .debs dan .dsc
daripada fail .changes sebagai hujah eksplisit.

--klik-sumber clicksrc
Laluan untuk mengklik pokok sumber untuk seterusnya --klik pakej.

--klik clickpkg
If clickpkg ialah fail (*.click), pasang pakej klik yang diberikan ke dalam testbed. Jika ia adalah
nama klik (seperti "com.example.myapp"), anggap ia telah dipasang dalam
testbed dan baca manifes daripadanya.

Jalankan ujian pakej klik dari sebelumnya --klik-sumber. Jika sumber klik
direktori tidak dinyatakan secara eksplisit, ia akan dimuat turun mengikut
manifes sumber x kemasukan. Pada masa ini satu-satunya skema yang disokong ialah vcs-bzr.

nama fail
Argumen nama fail kosong diproses seolah-olah --pokok terbina, --sumber, --pokok yang tidak dibina,
--apt-source, --perduaan, --perubahan, --klik-sumber, Atau --klik telah dinyatakan; yang
sifat hujah diteka dari bentuk nama fail. Dalam kes
--pokok terbina, sama ada pilihan mesti dinyatakan, atau nama fail mesti berakhir dengan a
tebas; dua garisan pada penghujungnya diambil maksudnya --pokok yang tidak dibina. Jika diberi
direktori mempunyai subdirektori "klik", ia ditafsirkan sebagai --klik-sumber.

UJIAN PILIHAN

Melainkan dinyatakan sebaliknya, ini menjejaskan semua hujah ujian berikutnya.

-B | --tiada-binari-binari
Semua binari binari daripada yang berikutnya --sumber or --pokok yang tidak dibina ujian tidak akan
dibina atau diabaikan, dan kebergantungan berpuas hati dengan pakej daripada arkib.
Ambil perhatian bahawa pakej masih dibina jika ujian memerlukan bina-diperlukan.

--binari-binari
Selepas --sumber or --pokok yang tidak dibina ujian akan dibina dan kebergantungannya
berpuas hati dengan binari binari. Ini ialah gelagat lalai, jadi anda sahaja
memerlukan ini untuk mengembalikan yang ditentukan sebelumnya --tiada-binari-binari pilihan.

--override-control=PATH
Baca metadata ujian daripada PATH bukan debian/ujian/kawalan (untuk Debian
sumber) atau manifes Klik untuk ujian berikut.

--testname=UJIAN
Jalankan hanya nama ujian yang diberikan (dari fail kawalan ujian) dalam ujian berikut.

MASUK PILIHAN

Jika anda tidak menyatakan sebarang pilihan, adt-run hanya menulis output/hasilnya kepada stderr.

-o dir | --output-dir=dir
Menentukan artifak ujian (stderr dan stdout daripada ujian, fail log,
pakej binari dan lain-lain) hendaklah diletakkan dalam direktori yang diberikan. dir bukan kemestian
masih wujud atau kosong, sebaliknya adt-run akan menolak untuk menggunakannya.

-l fail log | --fail-log=fail log
Menentukan bahawa log surih harus ditulis kepadanya fail log bukannya untuk output-dir.

--ringkasan=ringkasan
Menentukan bahawa ringkasan hasil harus ditulis kepada ringkasan. Peristiwa
dalam ringkasan ditulis pada log dalam apa jua keadaan.

-q | --senyap
Jangan hantar salinan adt-run's jejak logstream ke stderr. Pilihan ini tidak
menjejaskan salinan yang dihantar kepada fail log or output-dir. Perhatikan bahawa tanpa jejak
logstream ia boleh menjadi sangat sukar untuk mendiagnosis masalah.

UJIAN BED SETUP PILIHAN

--setup-commands=arahan
Main arahan selepas membuka katil ujian. Ini boleh digunakan cth untuk mendayakan tambahan
sumber yang sesuai, jalankan apt-get maklumat atau sama. Jika arahan ialah nama fail sedia ada,
arahan dibaca daripada itu; sebaliknya ia adalah rentetan dengan arahan sebenar
yang akan dijalankan seperti sedia ada. Nama fail tanpa direktori akan dicari dalam kedua-dua
direktori semasa dan dalam /usr/share/autopkgtest/setup-commands/ jadi anda tidak perlu
untuk memberikan laluan penuh untuk skrip persediaan yang dihantar dengan autokgtest.

Pilihan ini boleh ditentukan beberapa kali.

If --pengguna diberikan atau katil ujian menyediakan a cadangan-pengguna-biasa keupayaan, yang
$ADT_NORMAL_USER pembolehubah persekitaran akan ditetapkan kepada pengguna tersebut.

Jika arahan persediaan mempengaruhi apa-apa dalam direktori boot (seperti / boot or
/lib/systemd/system) dan katil ujian menyokong but semula, katil ujian akan menjadi
but semula selepas arahan persediaan. Ini boleh dihalang dengan mencipta fail
/run/autopkgtest_no_reboot.stamp.

--apt-upgrade | -U
Main apt-get maklumat and apt-get menaik taraf -y dalam katil ujian sebelum menjalankan
ujian.

--apt-pocket=poket[=pkgname,src:srcname,...]
Tambahkan sumber yang sesuai untuk melepaskan-poket. Ini mencari yang pertama deb beratur dalam
/ Etc / apt / sources.list yang belum menyatakan poket dan menambah deb dan
deb-src dengan poket itu ke /etc/apt/sources.list.d/poketsenarai. Ini juga
panggilan apt-get maklumat untuk poket baru (tetapi bukan untuk apa-apa lagi).

Jika senarai pakej diberikan selepas =, sediakan apt pinning untuk menggunakan pakej tersebut sahaja
dari poket. Entri "src:srcname" berkembang kepada semua pakej binari yang dibina oleh itu
sumber. Ini boleh digunakan untuk meminimumkan kebergantungan yang diambil daripada poket supaya
kemas kini pakej dalam poket itu boleh diuji secara bebas antara satu sama lain untuk
pengasingan yang lebih baik. Perhatian: Pada masa ini, ini tidak menyelesaikan beberapa situasi di mana
kebergantungan pakej yang diberikan hanya boleh diselesaikan dalam poket yang diberikan. Dalam
dalam kes itu, penyematan apt akan dialih keluar dan pemasangan pakej akan dicuba semula
dengan keseluruhan poket.

--copy=HOSTPATH:TESTBEDPATH
Salin fail atau direktori daripada hos ke dalam testbed selepas dibuka. Ini berlaku sebelum ini
--setup-commands oleh itu anda boleh menggunakan fail ini dalam arahan persediaan.

--env=VAR=nilai
Tetapkan pembolehubah persekitaran arbitrari dalam binaan dan ujian. Boleh ditentukan berbilang
kali.

PENGGUNA/KEISTIMEWAAN PENGENDALIAN PILIHAN

-u pengguna | --pengguna=pengguna
Jalankan binaan dan ujian sebagai pengguna di atas katil ujian. Ini memerlukan akar pada katil ujian; jika
root pada testbed tidak tersedia kemudian bina dan ujian dijalankan seperti mana pun pengguna
disediakan.

--gain-root=keuntungan-akar
Awalan debian/peraturan perduaan dengan akar keuntungan. Lalainya ialah tidak menggunakan apa-apa,
kecuali jika --pengguna dibekalkan atau root pada testbed tidak tersedia
lalai adalah fakeroot.

MENGHILANGKAN PILIHAN

--nyahpepijat|-d
Sertakan maklumat penyahpepijatan tambahan dalam log surih. Setiap tambahan -d
meningkatkan tahap penyahpepijatan; maksimum semasa ialah -ddd. Jika anda suka melihat
apa yang berlaku, -d or -dd is disyorkan.

--cangkang-gagal|-s
Jalankan cangkerang interaktif dalam katil ujian selepas binaan, ujian atau pergantungan yang gagal
pemasangan.

- cengkaman
Jalankan cengkerang interaktif di tempat ujian selepas setiap ujian.

MASA TAMAT PILIHAN

--masa tamat-yang=saat
Gunakan tamat masa yang berbeza untuk operasi pada atau dengan katil ujian. Ada lima
tamat masa dipengaruhi oleh lima nilai yang: pendek: kononnya operasi pendek seperti
menyediakan kesesuaian katil ujian dan menyemak keadaan (lalai: 100s); memasang:
pemasangan pakej termasuk kebergantungan (lalai: 3,000s); ujian: ujian berjalan
(lalai: 10,000s); salinan: salin fail/direktori antara hos dan testbed (lalai:
300s); dan membina: binaan (lalai: 100,000s). Nilai mesti dinyatakan sebagai
nombor integer saat.

--faktor tamat masa=dua kali ganda
Darabkan semua tamat masa lalai dengan faktor yang ditentukan (lihat --masa tamat-yang
di atas). Hanya lalai terjejas; tetapan tamat masa eksplisit digunakan dengan tepat
seperti yang dinyatakan.

TEMPAT PILIHAN

--set-lang=langval
Apabila menjalankan arahan pada katil ujian, tetapkan BAHASA pemboleh ubah persekitaran ke
langval. lalai dalam adt-run adalah untuk menetapkannya C.UTF-8.

LAIN PILIHAN

--tiada-auto-kawalan
Lumpuhkan penjanaan ujian automatik dengan autodep8, walaupun ia dipasang. Dalam itu
kes, pakej tanpa ujian akan keluar dengan kod 8 ("Tiada ujian dalam pakej ini")
sama seperti tanpa autodep8.

--bina-selariN
Tetapkan selari=N DEB_BUILD_OPTION untuk membina pakej. Secara lalai ini ialah
bilangan pemproses yang tersedia. Ini kebanyakannya berguna dalam bekas di mana anda boleh
menyekat RAM yang tersedia, tetapi tidak menyekat bilangan CPU.

-h|- membantu
Tunjukkan bantuan baris arahan dan keluar.

VIRTUALISASI SERVER

--- virt-server virt-server-arg...
Menentukan pelayan rejim virtualisasi, sebagai arahan dan hujah untuk digunakan.
virt-server mestilah pelayan virtualisasi autokgtest sedia ada seperti adt-virt-
anak buah or adt-virt-qemu. Anda boleh meninggalkan adt-virt- awalan dan tentukan sahaja
bahagian terakhir, cth anak buah.

Semua hujah dan pilihan yang tinggal selepas --- dihantar ke virtualisasi
program pelayan. Lihat halaman manual pelayan individu untuk cara menggunakannya.

OUTPUT FORMAT

Semasa ujian biasa dijalankan, satu baris dicetak untuk setiap ujian. Ini terdiri daripada pendek
rentetan yang mengenal pasti ujian, beberapa ruang putih mendatar, dan sama ada PAS or GAGAL sebab atau
SKIP sebab di mana petunjuk lulus/gagal dipisahkan oleh sebarang sebab oleh beberapa mendatar
ruang kosong.

Rentetan untuk mengenal pasti ujian terdiri daripada rentetan alfanumerik pendek yang dicipta oleh adt-
menjalankan untuk membezakan hujah baris arahan yang berbeza, the argid, diikuti dengan tanda sempang dan
nama ujian.

Kadang kala a SKIP akan dilaporkan apabila nama ujian tidak diketahui atau tidak
berkenaan: sebagai contoh, apabila tiada ujian dalam pakej, atau terdapat ujian
rangkap yang mengandungi ciri yang tidak difahami oleh versi ini adt-run. Dalam kes ini *
akan muncul di mana nama ujian sepatutnya.

If adt-run mengesan bahawa pakej yang salah terlibat, ia akan mencetak dua baris
salahkan: perkara yang dipersalahkan... and badpkg: mesej. Di sini setiap ruang putih dipisahkan perkara yang dipersalahkan
adalah salah satu arg:hujah (mewakili nama laluan yang terdapat dalam hujah baris arahan),
dsc:pakej (nama pakej sumber), sebagai:pakej (nama pakej binari) atau mungkin lain
rentetan yang akan ditentukan. Ini menunjukkan argumen dan/atau pakej yang mungkin ada
menyumbang kepada masalah; yang paling baru diproses dan yang mana
oleh itu kemungkinan besar menjadi punca masalah disenaraikan terakhir.

CONFIGURATION FILES

Jika anda menggunakan banyak pilihan atau hujah pelayan bukan remeh, anda boleh meletakkan mana-mana bahagian
baris arahan ke dalam fail teks, dengan satu baris setiap pilihan. E. g. anda boleh membuat fail
sid.cfg dengan kandungan seperti

-s
--output-dir=/tmp/testout
--apt-upgrade
---
anak buah
sid

dan kemudian lari

adt-run foo_1_amd64.changes @sid.cfg

Kandungan fail konfigurasi akan dikembangkan di tempat seolah-olah anda akan mempunyai
memandangkan kandungannya pada baris arahan. Sila pastikan anda tidak tempat ruang antara
pilihan pendek dan nilainya, ia akan menjadi sebahagian daripada nilai hujah.

EXIT STATUS

0 semua ujian lulus
2 sekurang-kurangnya satu ujian dilangkau
4 sekurang-kurangnya satu ujian gagal
6 sekurang-kurangnya satu ujian gagal dan sekurang-kurangnya satu ujian dilangkau
8 tiada ujian dalam pakej ini
12 pakej yang salah
16 kegagalan ujian
20 kegagalan lain yang tidak dijangka termasuk penggunaan buruk

Gunakan adt-run dalam talian menggunakan perkhidmatan onworks.net