adt-run - Online di Cloud

PROGRAM:

NAMA

adt-run - uji paket biner yang diinstal menggunakan pengujian paket sumber

RINGKASAN

ad-run Pilihan... --- server-virt [virt-server-arg...]

DESKRIPSI

ad-run adalah program untuk menjalankan mesin pengujian paket autopkgtest.

autopkgtest adalah fasilitas untuk menguji paket biner Debian atau Click, seperti yang diinstal pada a
sistem (seperti sistem testbed). Tes adalah yang disediakan dalam paket sumber.

adt-run menjalankan setiap pengujian yang disediakan oleh paket tertentu dan melaporkan hasilnya. Dia
mendorong rezim virtualisasi yang ditentukan sebagaimana mestinya, dan mem-parsing deskripsi pengujian
metadata, dan mengatur agar data disalin ke dan dari testbed sesuai kebutuhan.

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

SPESIFIKASI UJI

Tindakan menentukan paket sumber dan biner untuk diuji, atau mengubah apa yang terjadi dengan
argumen paket:

--sumber Dsc
Jalankan tes dari paket sumber Debian Dsc. Secara default paket juga akan dibuat
dan biner yang dihasilkan akan digunakan untuk memenuhi dependensi pengujian; untuk menonaktifkan
itu, tentukan -B/--no-built-binary pilihan sebelumnya.

Urutannya signifikan: masing-masing --sumber opsi harus mendahului opsi yang
dependensi harus dipenuhi oleh binari yang dihasilkannya.

--tidak dibangun-pohon direktori
Menentukan bahwa pengujian dari pohon sumber Debian yang tidak dibangun direktori harus dijalankan.
Ini sangat mirip dengan menentukan --sumber kecuali bahwa pohon direktori (yang
harus murni) disediakan, bukan paket sumber.

--built-pohon direktori
Menentukan bahwa tes dari pohon sumber Debian yang dibangun direktori harus dijalankan.
Perhatikan bahwa semua dependensi pengujian kemudian dipenuhi oleh paket arsip, kecuali Anda
secara eksplisit menentukan .debs yang dibuat secara lokal dengan --biner.

--apt-sumber nama srcpkg
Download nama srcpkg dengan apt-get sumber di testbed dan menjalankan tesnya. Ini adalah
mirip dengan menentukan --sumber tetapi menghindari menyalin sumber dari host ke
ranjang percobaan. Kemungkinan binari yang dibangun akan tidak digunakan untuk memenuhi dependensi, sebagai
biasanya dalam mode ini Anda ingin menguji binari dari arsip nyata.

--git-sumber URL [nama cabang]
Menentukan bahwa tes dari pohon sumber Debian yang tidak dibangun dari git-cloning URL
harus dijalankan. Jika nama cabang diberikan, cabang ini akan diperiksa alih-alih
default (biasanya "master").

Ini sangat mirip dengan menentukan --tidak dibangun-pohon setelah kloning, yaitu ini
biasa digunakan dengan --no-built-binary. itu git paket akan diinstal jika
perlu.

--biner deb
Menentukan bahwa deb harus digunakan untuk pengujian semua paket sumber berikut. Oleh
default itu akan digunakan untuk memenuhi dependensi, baik selama pembangunan dan pengujian.

Urutannya signifikan, seperti untuk --sumber. Secara khusus, jika sumber berikutnya
paket akan membangun biner dengan nama yang sama, yang akan digunakan sejak saat itu, dan
deb akan diabaikan.

--perubahan perubahan
Menentukan bahwa deb dalam .changes yang diberikan harus digunakan untuk pengujian
paket sumber di .changes itu. Bertindak seolah-olah Anda telah menentukan .debs dan .dsc
dari file .changes sebagai argumen eksplisit.

--klik-sumber kliksrc
Jalur untuk mengklik pohon sumber untuk selanjutnya --klik paket.

--klik klikpkg
If klikpkg adalah file (*.click), instal paket klik yang diberikan ke testbed. Jika memang
nama klik (seperti "com.example.myapp"), anggap itu sudah diinstal di
testbed dan membaca manifes darinya.

Jalankan tes paket klik dari yang sebelumnya --klik-sumber. Jika sumber klik
direktori tidak ditentukan secara eksplisit, itu akan diunduh sesuai dengan
manifes x-sumber pintu masuk. Saat ini satu-satunya skema yang didukung adalah vcs-bzr.

nama file
Argumen nama file kosong diproses seolah-olah --built-pohon, --sumber, --tidak dibangun-pohon,
--apt-sumber, --biner, --perubahan, --klik-sumber, atau --klik ditentukan; NS
sifat argumen ditebak dari bentuk nama file. Dalam kasus
--built-pohon, opsi harus ditentukan, atau nama file harus diakhiri dengan a
memotong; dua garis miring di akhir dianggap --tidak dibangun-pohon. Jika diberikan
direktori memiliki subdirektori "klik", itu ditafsirkan sebagai --klik-sumber.

UJI PILIHAN

Kecuali dinyatakan lain, ini mempengaruhi semua argumen pengujian berikutnya.

-B | --no-built-binary
Semua binari yang dibangun dari selanjutnya --sumber or --tidak dibangun-pohon tes tidak akan
dibangun atau diabaikan, dan dependensi dipenuhi dengan paket dari arsip.
Perhatikan bahwa paket masih dapat dibuat jika pengujian memerlukan dibutuhkan.

--binari bawaan
Berikut --sumber or --tidak dibangun-pohon tes akan dibangun dan dependensinya
puas dengan binari yang dibangun. Ini adalah perilaku default, jadi Anda hanya
perlu ini untuk mengembalikan yang ditentukan sebelumnya --no-built-binary .

--override-kontrol=PATH
Baca metadata pengujian dari PATH alih-alih debian/tes/kontrol (untuk Debian
sumber) atau manifes Klik untuk pengujian berikut.

--namatest=UJI
Jalankan hanya nama pengujian yang diberikan (dari file kontrol pengujian) dalam pengujian berikut.

masuk PILIHAN

Jika Anda tidak menentukan opsi apa pun, ad-run hanya menulis output/hasilnya ke stderr.

-o dir | --keluaran-dir=dir
Menentukan artefak pengujian (stderr dan stdout dari pengujian, file log,
paket biner yang dibangun, dll.) harus ditempatkan di direktori yang diberikan. dir tidak harus
ada belum atau kosong, jika tidak ad-run akan menolak untuk menggunakannya.

-l file log | --file-log=file log
Menentukan bahwa log jejak harus ditulis ke file log bukannya ke keluaran-dir.

--ringkasan=ringkasan
Menentukan bahwa ringkasan hasil harus ditulis ke ringkasan. Acara
dalam ringkasan ditulis ke log dalam hal apapun.

-q | --diam
Jangan mengirim salinan ad-run's melacak logstream ke stderr. Opsi ini tidak
mempengaruhi salinan yang dikirim ke file log or keluaran-dir. Perhatikan bahwa tanpa jejak
logstream mungkin sangat sulit untuk mendiagnosis masalah.

UJI TEMPAT TIDUR SETUP PILIHAN

--perintah-penyiapan=perintah
Run perintah setelah membuka testbed. Ini dapat digunakan misalnya untuk mengaktifkan tambahan
sumber yang tepat, jalankan apt-get memperbarui atau serupa. Jika perintah adalah nama file yang ada,
perintah dibaca dari itu; jika tidak, itu adalah string dengan perintah yang sebenarnya
yang dijalankan apa adanya. Nama file tanpa direktori akan dicari di kedua
direktori saat ini dan di /usr/share/autopkgtest/setup-commands/ jadi tidak perlu
untuk memberikan jalur lengkap untuk skrip penyiapan yang dikirimkan dengan autopkgtest.

Opsi ini dapat ditentukan beberapa kali.

If --pengguna diberikan atau test bed memberikan disarankan-pengguna-normal kemampuan,
$ADT_NORMAL_USER variabel lingkungan akan diatur ke pengguna itu.

Jika perintah pengaturan memengaruhi apa pun di direktori boot (seperti / boot or
/lib/systemd/sistem) dan testbed mendukung reboot, testbed akan
reboot setelah perintah setup. Ini dapat ditekan dengan membuat file
/jalankan/autopkgtest_no_reboot.stamp.

--apt-upgrade | -U
Run apt-get memperbarui dan apt-get dist-upgrade -y di testbed sebelum menjalankan
tes.

--apt-pocket=saku[=namapkg,src:srcnama,...]
Tambahkan sumber yang tepat untuk melepaskan-saku. Ini menemukan yang pertama deb antri
/ Etc / apt / sources.list yang belum menentukan saku dan menambahkan deb dan
deb-src dengan saku itu untuk /etc/apt/sources.list.d/saku.daftar. Ini juga
panggilan apt-get memperbarui untuk kantong baru (tetapi tidak untuk hal lain).

Jika daftar paket diberikan setelah =, atur penyematan apt untuk hanya menggunakan paket-paket itu
dari saku. Entri "src:srcname" diperluas ke semua paket biner yang dibuat olehnya
sumber. Ini dapat digunakan untuk meminimalkan dependensi yang diambil dari saku sehingga
pembaruan paket di saku itu dapat diuji secara independen satu sama lain untuk
isolasi yang lebih baik. Perhatian: Ini saat ini tidak menyelesaikan beberapa situasi di mana
dependensi dari paket yang diberikan hanya dapat diselesaikan di saku yang diberikan. Di dalam
bahwa pin yang tepat akan dihapus dan instalasi paket akan dicoba lagi
dengan keseluruhan saku.

--salin=HOSTPATH: TESTBEDPATH
Salin file atau direktori dari host ke testbed setelah dibuka. Ini terjadi sebelumnya
--setup-perintah dengan demikian Anda dapat menggunakan file-file ini dalam perintah pengaturan.

--env=VAR=nilai
Tetapkan variabel lingkungan arbitrer di build dan test. Dapat ditentukan beberapa
kali.

PENGGUNA/HAK ISTIMEWA PENANGANAN PILIHAN

-u pemakai | --pengguna=pemakai
Jalankan build dan tes sebagai pemakai di ranjang percobaan. Ini membutuhkan root pada testbed; jika
root pada testbed tidak tersedia kemudian build dan tes dijalankan sebagai pengguna apa pun
disediakan.

--mendapatkan-root=mendapatkan-root
Awalan debian/aturan biner dengan gain-root. Defaultnya adalah tidak menggunakan apa pun,
kecuali jika --pengguna disediakan atau root pada testbed tidak tersedia;
defaultnya adalah akar palsu.

DEBUGING PILIHAN

--debug|-d
Sertakan informasi debug tambahan di log pelacakan. setiap tambahan -d
meningkatkan tingkat debugging; maksimum saat ini adalah -dd. Jika Anda suka melihat
apa yang terjadi, -d or -DD is direkomendasikan.

--shell-gagal|-s
Jalankan shell interaktif di testbed setelah gagal membangun, menguji, atau ketergantungan
instalasi.

--kerang
Jalankan shell interaktif di testbed setelah setiap tes.

TIMEOUT PILIHAN

--waktu habis-yang=detik
Gunakan batas waktu yang berbeda untuk operasi pada atau dengan testbed. Ada lima
batas waktu dipengaruhi oleh lima nilai yang: pendek: operasi yang seharusnya singkat seperti
menyiapkan apt testbed dan memeriksa status (default: 100s); install:
instalasi paket termasuk dependensi (default: 3,000s); uji: uji coba
(default: 10,000 detik); salinan: menyalin file/direktori antara Host dan testbed (default:
300-an); dan membangun: build (default: 100,000 detik). Nilai harus ditentukan sebagai
bilangan bulat detik.

--timeout-faktor=dua kali lipat
Kalikan semua batas waktu default dengan faktor yang ditentukan (lihat --waktu habis-yang
di atas). Hanya default yang terpengaruh; pengaturan batas waktu eksplisit digunakan dengan tepat
seperti yang ditentukan.

LOKAL PILIHAN

--set-lang=langval
Saat menjalankan perintah pada testbed, setel BAHASA variabel lingkungan menjadi
langval. Default di ad-run adalah untuk mengaturnya ke C.UTF-8.

LAIN PILIHAN

--tanpa-kontrol-otomatis
Nonaktifkan pembuatan tes otomatis dengan autodep8, meskipun sudah diinstal. Karena
kasus, paket tanpa tes akan keluar dengan kode 8 ("Tidak ada tes dalam paket ini")
seperti tanpa autodep8.

--membangun-paralelN
set paralel=N DEB_BUILD_OPTION untuk membangun paket. Secara default ini adalah
jumlah prosesor yang tersedia. Ini sebagian besar berguna dalam wadah di mana Anda bisa
membatasi RAM yang tersedia, tetapi tidak membatasi jumlah CPU.

-h|--membantu
Tampilkan bantuan baris perintah dan keluar.

VIRTUALISASI SERVER

--- server-virt virt-server-arg...
Menentukan server rezim virtualisasi, sebagai perintah dan argumen untuk dipanggil.
server-virt harus menjadi server virtualisasi autopkgtest yang ada seperti iklan-virt-
bajingan or adt-virt-qemu. Anda dapat meninggalkan iklan-virt- awalan dan tentukan saja
bagian terakhir, misalnya bajingan.

Semua argumen dan opsi yang tersisa setelahnya --- diteruskan ke virtualisasi
program server. Lihat halaman manual masing-masing server untuk cara menggunakannya.

KELUARAN FORMAT

Selama uji coba normal, satu baris dicetak untuk setiap pengujian. Ini terdiri dari pendek
string yang mengidentifikasi tes, beberapa spasi horizontal, dan keduanya LULUS or GAGAL alasan atau
MELEWATKAN alasan di mana indikasi lulus/gagal dipisahkan oleh alasan apa pun oleh beberapa horizontal
spasi.

String untuk mengidentifikasi tes terdiri dari string alfanumerik pendek yang ditemukan oleh ad-
menjalankan untuk membedakan argumen baris perintah yang berbeda, dingin, diikuti oleh tanda hubung dan
nama tes.

Terkadang a MELEWATKAN akan dilaporkan ketika nama tes tidak diketahui atau tidak
berlaku: misalnya, ketika tidak ada tes dalam paket, atau ada tes
bait yang berisi fitur yang tidak dipahami oleh versi ini ad-run. Pada kasus ini *
akan muncul di mana nama tes seharusnya.

If ad-run mendeteksi bahwa paket yang salah terlibat, itu akan mencetak dua baris
menyalahkan: hal yang dipersalahkan... dan burukpkg: pesan. Di sini masing-masing dipisahkan spasi hal yang dipersalahkan
adalah salah satu argumen:argumen (mewakili nama path yang ditemukan dalam argumen baris perintah),
dsc:paket (nama paket sumber), hutang:paket (nama paket biner) atau mungkin lainnya
string yang akan ditentukan. Ini menunjukkan argumen dan/atau paket mana yang mungkin dimiliki
berkontribusi pada masalah; yang diproses paling baru dan yang
oleh karena itu kemungkinan besar menjadi penyebab masalah terdaftar terakhir.

KONFIGURASI FILE

Jika Anda menggunakan banyak opsi atau argumen server virt nontrivial, Anda dapat menempatkan bagian mana pun dari
baris perintah menjadi file teks, dengan satu baris per opsi. E.g. Anda dapat membuat file
sid.cfg dengan konten seperti

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

lalu jalankan

adt-jalankan foo_1_amd64.changes @sid.cfg

Isi file konfigurasi akan diperluas di tempat seolah-olah Anda akan melakukannya
diberikan isinya pada baris perintah. Harap pastikan bahwa Anda tidak tempat spasi antara
opsi pendek dan nilainya, mereka akan menjadi bagian dari nilai argumen.

EXIT STATUS

0 semua tes lulus
2 setidaknya satu tes dilewati
4 setidaknya satu tes gagal
6 setidaknya satu tes gagal dan setidaknya satu tes dilewati
8 tidak ada tes dalam paket ini
12 paket yang salah
16 kegagalan testbed
20 kegagalan tak terduga lainnya termasuk penggunaan yang buruk

Gunakan adt-run online menggunakan layanan onworks.net