virt-dib - Online di Cloud

PROGRAM:

NAMA

virt-dib - Jalankan elemen pembuat diskimage

RINGKASAN

virt-dib -B DIB-LIB [opsi] elemen...

DESKRIPSI

Virt-dib adalah alat untuk menggunakan elemen "diskimage-builder" untuk membuat disk baru
image, menghasilkan ramdisk baru, dll.

Virt-dib dimaksudkan sebagai pengganti yang aman untuk "diskimage-builder" dan nya
mode "ramdisk-image-create", lihat "PERBANDINGAN DENGAN DISKIMAGE-BUILDER" untuk cepat
perbandingan dengan penggunaan "diskimage-builder".

"diskimage-builder" adalah bagian dari proyek TripleO OpenStack:
https://wiki.openstack.org/wiki/TripleO.

CONTOH

Membangun sederhana gambar of distribusi
virt-dib \
-B /jalur/ke/diskimage-builder/lib \
-p /path/ke/diskimage-builder/elements \
--envvar DIB_RELEASE=jessie \
--nama debian-jessie \
debian vm

Ini membangun disk image Debian Jessie (8.x), cocok untuk dijalankan sebagai mesin virtual,
disimpan sebagai debian-jessie.qcow2.

Membangun ramdisk
virt-dib \
-B /jalur/ke/diskimage-builder/lib \
-p /path/ke/diskimage-builder/elements \
--ramdisk\
--nama ramdisk\
ubuntu menyebarkan-ironis

Ini membangun ramdisk untuk komponen Ironic OpenStack berdasarkan distribusi Ubuntu.

PILIHAN

--membantu
Tampilkan bantuan.

-B PATH
Setel jalur ke direktori perpustakaan "diskimage-builder". Ini biasanya lib
subdirektori di sumber dan saat diinstal, dan /usr/share/diskimage-builder/lib
saat dipasang di / usr.

Parameter ini adalah wajib, karena virt-dib perlu menyediakannya untuk elemen (seperti beberapa
dari mereka mungkin menggunakan skrip di dalamnya). Virt-dib sendiri tidak menggunakan perpustakaan
direktori.

--lengkungan ARSITEKTUR
Gunakan arsitektur yang ditentukan untuk gambar keluaran. Nilai defaultnya sama dengan
host menjalankan virt-dib.

Saat ini opsi ini tidak lebih dari mengatur variabel lingkungan "ARCH"
untuk elemen, dan terserah mereka untuk menghasilkan gambar untuk yang diminta
Arsitektur.

--debug TINGKAT
Setel tingkat debug ke "LEVEL", yang merupakan bilangan bulat non-negatif. Standarnya
adalah 0.

Level debug ini berbeda dari apa -x dan -v set, dan itu meningkatkan debugging
informasi yang dicetak. Secara khusus, ini menetapkan "DIB_DEBUG_TRACE", dan nilai apa pun
> 0 memungkinkan pelacakan dalam skrip yang dieksekusi.

--menyetir DISK
Tambahkan disk yang ditentukan untuk digunakan sebagai drive pembantu tempat menyimpan file cache
elemen, seperti gambar disk, paket distribusi, dll.

Lihat "KEMUDIAN PEMBANTUAN".

-p PATH
--elemen-jalur PATH
Tambahkan jalur baru dengan elemen. Jalur digunakan dalam urutan yang sama dengan -p parameter
muncul, jadi jalur yang ditentukan terlebih dahulu dilihat terlebih dahulu, dan seterusnya.

Jelas, disarankan untuk menambahkan jalur ke elemen sendiri
"diskimage-builder", karena sebagian besar elemen lain akan bergantung padanya.

--ekstra-paket KEMASAN,...
Instal paket tambahan di gambar yang sedang dibangun.

Ini bergantung pada biner "instal-paket" yang disediakan oleh manajemen paket
elemen.

Opsi ini dapat ditentukan beberapa kali, setiap kali dengan beberapa paket
dipisahkan dengan koma.

--envvar VARIABEL
--envvar VARIABEL = NILAI
Membawa atau mengatur variabel lingkungan untuk elemen.

Lihat "VARIABEL LINGKUNGAN" di bawah ini untuk informasi lebih lanjut tentang interaksi dan penggunaan
variabel lingkungan.

Opsi ini dapat digunakan dengan dua cara:

--envvar VARIABEL
Membawa variabel lingkungan "VARIABEL". Jika tidak disetel, tidak ada yang diekspor
ke elemen.

--envvar VARIABEL = NILAI
Setel variabel lingkungan "VARIABEL" dengan nilai "VALUE" untuk elemen,
terlepas dari apakah ada variabel lingkungan dengan nama yang sama.

Ini dapat berguna untuk meneruskan variabel lingkungan tanpa mengekspornya di
lingkungan tempat virt-dib berjalan.

--kecuali-elemen ELEMEN
Abaikan elemen yang ditentukan.

--kecualikan-skrip SCRIPT
Abaikan skrip elemen apa pun yang bernama "SCRIPT", di mana pun elemen itu berada.

Ini dapat berguna jika beberapa skrip tidak berjalan dengan baik dengan virt-dib, misalnya
ketika mereka benar-benar membutuhkan lingkungan "diskimage-builder".

--format FORMAT,...
Atur daftar format output, pisahkan dengan koma.

Format yang didukung adalah:

"qcow2" (diaktifkan secara default)
qcow2 QEMU.

"mentah"
Format disk mentah.

"ter"
Tarball yang tidak terkompresi.

"vhd"
Gambar disk "Hard Disk Virtual". Format keluaran ini memerlukan alat "vhd-util".

Harap dicatat bahwa versi alat "vhd-util" perlu ditambal untuk mendukung
subperintah "convert", dan dapat di-boot. Patchnya tersedia di sini:
https://github.com/emonty/vhd-util/blob/master/debian/patches/citrix.

--fs-tipe BERKAS SISTEM
Atur jenis sistem file yang akan digunakan untuk sistem file root. Standarnya adalah "ext4".

Lihat juga "guestfs_filesystem_available" di tamu(3).

--gambar-cache DIREKTORI
Setel jalur di host tempat cache sumber daya yang digunakan oleh elemen
fase "ekstra-data.d". Standarnya adalah ~/.cache/buat gambar.

Harap dicatat bahwa sebagian besar sumber daya yang diambil setelah "data tambahan" akan di-cache di
drive pembantu yang ditentukan dengan --menyetir; lihat juga "PENGEMUDI PEMBANTU".

--tipe-instal JENIS
Tentukan jenis instalasi default. Default ke "sumber".

Setel ke "paket" untuk menggunakan instalasi berbasis paket secara default.

--dapat dibaca oleh mesin
Opsi ini digunakan untuk membuat output lebih ramah mesin saat diurai oleh
program lainnya. Lihat "OUTPUT YANG DAPAT DIBACA MESIN" di bawah.

-m MB
--memukur MB
Ubah jumlah memori yang dialokasikan untuk alat. Tingkatkan ini jika Anda menemukannya
eksekusi virt-dib kehabisan memori.

Default dapat ditemukan dengan perintah ini:

get-memsize guestfish

--mkfs-opsi "STRING OPSI"
Tambahkan opsi yang ditentukan ke mkfs(1), untuk dapat menyempurnakan sistem file root
penciptaan. Perhatikan bahwa ini tidak mungkin untuk mengganti jenis sistem file.

Kamu harus menggunakan --mkfs-opsi paling banyak sekali. Untuk melewati beberapa opsi, pisahkan mereka
dengan ruang, misalnya:

virt-dib ... --mkfs-options '-O someopt -I foo'

--jaringan
--tidak ada jaringan
Mengaktifkan atau menonaktifkan akses jaringan dari tamu selama instalasi.

Diaktifkan adalah default. Menggunakan --tidak ada jaringan untuk menonaktifkan akses.

Jaringan hanya mengizinkan koneksi keluar dan memiliki batasan kecil lainnya. Lihat
"JARINGAN" di virt-penyelamatan(1).

Ini tidak mempengaruhi apakah tamu dapat mengakses jaringan setelah di-boot,
karena itu dikendalikan oleh hypervisor atau lingkungan cloud Anda dan tidak ada hubungannya
lakukan dengan virt-dib.

Jika Anda menggunakan --tidak ada jaringan, maka variabel lingkungan "DIB_OFFLINE" disetel ke 1,
menandakan elemen bahwa mereka harus menggunakan hanya sumber daya yang di-cache bila tersedia.
Perhatikan juga bahwa, tidak seperti "diskimage-builder" di mana elemen mungkin masih dapat
akses ke jaringan bahkan dengan "DIB_OFFLINE=", di bawah jaringan virt-dib akan sepenuhnya
tidak dapat diakses.

--nama NAMA
Tetapkan nama file gambar keluaran. Standarnya adalah "gambar".

Menurut nama yang dipilih, akan ada yang berikut di direktori saat ini:

$NAME.ext
Untuk setiap format output, gambar disk dinamai gambar keluar dengan
ekstensi tergantung pada format; Misalnya: $NAME.qcow2, $NAME.mentah, Dll

Tidak berlaku dalam mode ramdisk, lihat "RAMDISK BUILDING".

$NAMA.d
Direktori yang berisi file apa pun yang dibuat oleh elemen, misalnya dib-
manifes direktori (dibuat oleh elemen "manifests"), ramdisk dan kernel di
mode ramdisk, dan sebagainya.

--tidak-hapus-jika-gagal
Jangan hapus file output pada kegagalan untuk membangun. Anda dapat menggunakan ini untuk men-debug kegagalan
untuk menjalankan skrip.

Standarnya adalah menghapus file output jika virt-dib gagal (atau, misalnya, beberapa
skrip yang dijalankan gagal).

-q
--diam
Jangan mencetak pesan kemajuan biasa.

--qemu-img-opsi pilihan[,pilihan,...]
Lulus --qemu-img-opsi pilihan untuk qemu-img(1) perintah untuk menyempurnakan output
format. Pilihan yang tersedia tergantung pada format output (lihat --format) Dan
versi terinstal dari program qemu-img.

Kamu harus menggunakan --qemu-img-opsi paling banyak sekali. Untuk melewati beberapa opsi, pisahkan
mereka dengan koma, misalnya:

virt-dib ... --qemu-img-options cluster_size=512,preallocation=metadata ...

--ramdisk
Atur mode pembuatan ramdisk.

Lihat "BANGUNAN RAMDISK".

--ramdisk-elemen NAMA
Tetapkan nama untuk elemen tambahan yang ditambahkan dalam mode pembuatan ramdisk. Standarnya
adalah "ramdisk".

Lihat "BANGUNAN RAMDISK".

--label-root LABEL
Atur label untuk sistem file root pada gambar yang dibuat.

Harap dicatat bahwa beberapa sistem file memiliki batasan yang berbeda pada panjangnya
label; misalnya, pada sistem file "ext2/3/4" label tidak boleh lebih dari 16
karakter, sedangkan pada "xfs" mereka memiliki paling banyak 12 karakter.

Standarnya tergantung pada sistem file yang sebenarnya untuk partisi root (lihat --fs-tipe):
pada "xfs" adalah "img-rootfs", sedangkan "cloudimg-rootfs" pada sistem file lain.

--ukuran UKURAN
Pilih ukuran disk keluaran, di mana ukurannya dapat ditentukan menggunakan nama umum
seperti "32G" (32 gigabyte) dll. Ukuran defaultnya adalah "5G".

Untuk menentukan ukuran dalam byte, nomor harus diikuti dengan huruf kecil b, misalnya:
"--ukuran 10737418240b".

Lihat juga virt-mengubah ukuran(1) untuk mengubah ukuran partisi dari gambar disk yang ada.

--lewati-dasar
Lewati penyertaan elemen "dasar".

--smp N
Aktifkan N 2 CPU virtual untuk skrip yang akan digunakan.

-u Jangan kompres gambar qcow2 yang dihasilkan. Standarnya adalah mengompresnya.

-v
--bertele-tele
Aktifkan pesan debug.

-V
--Versi: kapan
Tampilkan nomor versi dan keluar.

-x Aktifkan pelacakan panggilan API libguestfs.

LINGKUNGAN VARIABEL

Berbeda dengan "diskimage-builder", lingkungan host adalah tidak diwariskan dalam
alat saat menjalankan sebagian besar elemen (yaitu semua yang berbeda dari
"data tambahan.d").

Untuk mengatur lingkungan untuk elemen yang sedang dijalankan, perlu memberi tahu virt-dib untuk menggunakan
mereka, dengan opsi --envvar. Opsi tersebut memungkinkan untuk mengekspor lingkungan secara selektif
variabel saat menjalankan elemen, dan itu adalah cara yang lebih disukai untuk melewati lingkungan
variabel ke elemen.

Untuk rekap: jika Anda ingin variabel lingkungan "MYVAR" (dan kontennya) tersedia
ke elemen, Anda dapat melakukan keduanya

ekspor MYVAR # mana pun nilainya
virt-dib ... --envvar MYVAR ...

or

virt-dib ... --envvar MYVAR=nilai_dari_itu ...

PEMBANTU MENGEMUDI

Virt-dib menjalankan sebagian besar elemen di alatnya sendiri, dan dengan demikian tidak pada host. Karena
dari ini, tidak ada kemungkinan elemen untuk men-cache sumber daya secara langsung di host.

Untuk mengatasi masalah ini, virt-dib memungkinkan penggunaan drive pembantu tempat menyimpan cache
sumber daya, seperti gambar disk, paket distribusi, dll. Sementara ini berarti ada a
ruang yang lebih kecil tersedia untuk caching, setidaknya memungkinkan untuk membatasi ruang pada host untuk
cache, tanpa mengasumsikan bahwa elemen akan melakukannya sendiri.

Saat ini disk ini diperlukan untuk memiliki satu partisi di dalamnya, atau yang pertama
partisi di atasnya akan digunakan. Disk dengan konfigurasi terakhir dapat dengan mudah dibuat
dengan ikan tamu(1) seperti berikut ini:

guestfish -N nama file.img=fs:ext4:10G

Di atas akan membuat gambar disk yang disebut nama file.img, 10G besar, dengan satu partisi
bertipe ext4; lihat "GAMBAR DISK YANG DIPERSIAPKAN" di ikan tamu(1).

Direkomendasikan untuk menjadi 10G atau bahkan lebih, karena elemen akan menyimpan gambar disk,
paket distribusi, dll. Seperti halnya gambar disk, disk pembantu dapat dengan mudah diubah ukurannya
menggunakan virt-mengubah ukuran(1) jika lebih banyak ruang di dalamnya diperlukan.

Drive dapat diakses seperti gambar disk lainnya, misalnya menggunakan alat lain dari
libguestfs seperti ikan tamu(1):

guestfish -nama file.img -m /dev/sda1

Jika tidak ada drive pembantu yang ditentukan dengan --menyetir, semua sumber daya di-cache selama virt-dib
lari akan dibuang.

SUMBER DAYA INSIDE THE MENGEMUDI
Di dalam drive pembantu, dimungkinkan untuk menemukan sumber daya berikut:

/ Home
Direktori ini ditetapkan sebagai variabel lingkungan "HOME" selama proses build. Itu mengandung
sebagian besar cache gambar (disimpan sebagai /home/.cache/image-create), dan yang lainnya
sumber daya di-cache di direktori home pengguna yang menjalankan berbagai alat.

/virt-dib-*.log
Ini adalah log dari elemen yang dijalankan di dalam alat libguestfs, yang
berarti semua kait kecuali "extra-data.d".

RAMDISK BANGUNAN

Virt-dib juga dapat meniru "ramdisk-image-create", yang merupakan mode operasi sekunder dari
"pembuat diskimage". Alih-alih menjadi nama alat yang berbeda, virt-dib menyediakan kemudahan
akses ke mode ini menggunakan --ramdisk saklar.

Dalam mode ini:

· ada elemen ramdisk tambahan yang ditambahkan (lihat --ramdisk-elemen)

· tidak ada gambar yang dihasilkan (jadi --format diabaikan)

· $NAMA.d (Lihat --nama) akan berisi initrd, kernel, dll

SEMENTARA DIREKTORI

Virt-dib menggunakan direktori sementara standar yang digunakan oleh libguestfs, lihat "LINGKUNGAN
VARIABEL" dalam tamu(3).

Secara default lokasi ini adalah / Tmp (nilai default untuk "TMPDIR"), yang pada beberapa sistem mungkin
berada di sistem file tmpfs, dan dengan demikian default ke ukuran maksimum setengah dari RAM fisik.
Jika virt-dib melebihi ini, mungkin hang atau keluar lebih awal dengan kesalahan. Solusinya adalah
arahkan "TMPDIR" ke lokasi permanen yang digunakan sebagai lokasi sementara, misalnya:

mkdir lokal-tmp
env TMPDIR=$PWD/local-tmp virt-dib ...
rm -rf lokal-tmp

EXTRA KETERGANTUNGAN

Karena virt-dib menjalankan sebagian besar elemen di alatnya sendiri, semua alat dan
perpustakaan yang digunakan oleh elemen yang berjalan di luar tamu (biasanya "root.d",
"block-device.d", dan "cleanup.d") harus ada di alat juga. Dalam hal
mereka tidak, skrip akan gagal sebagian besar dengan kesalahan "perintah tidak ditemukan".

Untuk alat dan pustaka yang dikemas oleh distribusi, solusi mudahnya adalah memberi tahu
libguestfs untuk menyertakan paket tambahan dalam alat. Ini bisa dilakukan dengan mis
membuat file baru dengan paket tambahan:

# echo wget > /usr/lib64/guestfs/supermin.d/dib-my-extra

Jalan sebenarnya menuju supermin.d direktori tergantung pada distribusi; file tambahan
dapat membuat daftar lebih banyak paket, masing-masing dalam barisnya sendiri.

PERBANDINGAN DENGAN DISKIMAGE-BUILDER

Virt-dib dimaksudkan sebagai pengganti yang aman untuk "diskimage-builder" dan nya
mode "ramdisk-image-create"; perbedaan yang menonjol bagi pengguna terdiri dari:

· argumen baris perintah; beberapa argumen sama dengan yang tersedia di
"diskimage-builder", sementara beberapa memiliki nama yang berbeda:

disk-image-buat virt-dib
------------------ --------
-sebuah ARCH --lengkungan ARCH
--ukuran-gambar UKURAN --size UKURAN
--max-online-resize SIZE dapat dilakukan menggunakan --mkfs-options
-n --lewati-dasar
-o IMAGENAME --nama IMAGENAME
-p PAKET(S) --paket ekstra PAKET(S)
-t FORMAT(S) --format FORMAT(S)
-x --debug N

· lokasi file keluaran non-gambar (seperti ramdisk dan kernel)

· cara beberapa sumber daya yang disimpan dalam cache: menggunakan drive pembantu, tidak langsung aktif
disk tempat virt-dib dijalankan

· kebutuhan untuk menentukan ukuran target untuk disk keluaran, sebagai lawan dari
"diskimage-builder" menghitung yang optimal

· penanganan variabel lingkungan, lihat "VARIABEL LINGKUNGAN".

Selanjutnya, selain variabel lingkungan libguestfs sendiri (lihat "LINGKUNGAN
VARIABEL" dalam tamu(3)), virt-dib tidak membaca variabel lingkungan lainnya: this
berarti bahwa semua opsi dan perubahan perilaku ditentukan hanya menggunakan perintah
argumen garis

· Skrip "extra-data.d" dijalankan di lingkungan host, sebelum skrip lainnya (bahkan
"root.d"); ini berarti bahwa, tergantung pada konfigurasi elemen, beberapa dari
mereka mungkin gagal karena konten yang hilang (biasanya direktori) di "TMP_HOOKS_PATH".

Solusi untuk ini dapat berupa:

· perbaiki skrip "extra-data.d" untuk membuat direktori yang hilang

· buat (dan gunakan) elemen sederhana dengan skrip "extra-data.d" bernama mis
00-buat-direktori yang hilang untuk membuat direktori yang hilang

· alat tambahan yang diperlukan pada beberapa fase out-of-chroot harus tersedia di alat,
lihat "DEPENDENSI TAMBAHAN".

Elemen sendiri seharusnya tidak melihat perbedaan dalam cara mereka dijalankan; perilaku
perbedaan mungkin karena asumsi yang salah dalam elemen, atau emulasi virt-dib yang tidak benar.

Masalah yang diketahui saat ini:

· (tidak ada)

MESIN DIBACA KELUARAN

The --dapat dibaca oleh mesin opsi dapat digunakan untuk membuat output lebih ramah mesin, yang
berguna saat memanggil virt-dib dari program lain, GUI, dll.

Gunakan opsi itu sendiri untuk menanyakan kemampuan biner virt-dib. Khas
keluaran terlihat seperti ini:

$virt-dib --dapat dibaca mesin
virt-dib
keluaran: qcow2
keluaran: tar
keluaran: mentah
keluaran: vhd

Daftar fitur dicetak, satu per baris, dan program keluar dengan status 0.

PENGUJIAN

Virt-dib telah diuji dengan "diskimage-builder" (dan elemennya) 0.1.43; dari waktu
ke waktu juga dengan "elemen tiga gambar" dan "elemen gambar-sahara".

Versi sebelumnya mungkin berfungsi, tetapi tidak dijamin.

EXIT STATUS

Program ini mengembalikan 0 jika berhasil, atau bukan nol jika ada kesalahan.

Gunakan virt-dib online menggunakan layanan onworks.net