virt-dib - آنلاین در ابر

برنامه:

نام

virt-dib - عناصر diskimage-builder را اجرا کنید

خلاصه

عناصر virt-dib -B DIB-LIB [گزینه‌ها]...

شرح

Virt-dib ابزاری برای استفاده از عناصر "diskimage-builder" برای ساخت یک دیسک جدید است.
تصویر، ایجاد ramdisk های جدید و غیره

Virt-dib به عنوان جایگزین ایمن برای "diskimage-builder" و آن در نظر گرفته شده است
حالت "ramdisk-image-create"، برای اطلاعات سریع به "CompariSON WITH DISKIMAGE-BUILDER" مراجعه کنید.
مقایسه با استفاده از "diskimage-builder".

"diskimage-builder" بخشی از پروژه TripleO OpenStack است:
https://wiki.openstack.org/wiki/TripleO.

مثال ها

ساختن ساده تصاویر of توزیع
virt-dib \
-B /path/to/diskimage-builder/lib \
-p /path/to/diskimage-builder/elements \
--envvar DIB_RELEASE=jessie \
--نام دبیان-جسی \
دبیان وی ام

این یک تصویر دیسک Debian Jessie (8.x) می سازد که برای اجرا به عنوان ماشین مجازی مناسب است.
ذخیره شده به عنوان debian-jessie.qcow2.

ساختن ramdisks
virt-dib \
-B /path/to/diskimage-builder/lib \
-p /path/to/diskimage-builder/elements \
--ramdisk \
--نام ramdisk \
ubuntu deploy-ironic

این یک ramdisk برای مؤلفه Ironic OpenStack بر اساس توزیع اوبونتو می‌سازد.

OPTIONS

--کمک
نمایش راهنما

-B PATH
مسیر دایرکتوری کتابخانه "diskimage-builder" را تنظیم کنید. این معمولا لوب
زیر شاخه در منابع و هنگام نصب، و /usr/share/diskimage-builder/lib
هنگام نصب در / usr.

این پارامتر است اجباری، زیرا virt-dib باید آن را برای عناصر (همانطور که برخی
از آنها ممکن است از اسکریپت در آن استفاده کنند). Virt-dib خود از کتابخانه استفاده نمی کند
دایرکتوری.

-- قوس معماری
از معماری مشخص شده برای تصویر خروجی استفاده کنید. مقدار پیش فرض همان است
میزبان در حال اجرا virt-dib.

در حال حاضر این گزینه کاری جز تنظیم متغیر محیطی "ARCH" انجام نمی دهد
برای عناصر، و این به آنها بستگی دارد که یک تصویر برای درخواست شده تولید کنند
معماری.

- رفع اشکال سطح
سطح اشکال زدایی را روی "LEVEL" تنظیم کنید که یک عدد صحیح غیر منفی است. پیشفرض
0 است

این سطح اشکال زدایی با آنچه که است متفاوت است -x و -v تنظیم می شود و اشکال زدایی را افزایش می دهد
اطلاعات چاپ شده به طور خاص، "DIB_DEBUG_TRACE" و هر مقداری را تنظیم می کند
> 0 ردیابی را در اسکریپت های اجرا شده فعال می کند.

--راندن خطر
دیسک مشخص شده را اضافه کنید تا به‌عنوان درایو کمکی در جایی که فایل‌های حافظه پنهان را ذخیره کنید، استفاده کنید
عناصری مانند تصاویر دیسک، بسته های توزیع و غیره.

به "HELPER DRIVE" مراجعه کنید.

-p PATH
- مسیر عنصر PATH
یک مسیر جدید با عناصر اضافه کنید. مسیرها به همان ترتیب استفاده می شوند -p پارامترهای
ظاهر می شود، بنابراین مسیری که ابتدا مشخص شده است، ابتدا نگاه می شود و غیره.

بدیهی است که توصیه می شود مسیر را به عناصر خود اضافه کنید
از آنجایی که بسیاری از عناصر دیگر بر آنها تکیه می کنند، "محافظه ساز" هستند.

-- بسته های اضافی پکیج،...
بسته های اضافی را در تصویر در حال ساخت نصب کنید.

این به باینری «نصب بسته‌ها» وابسته است که توسط مدیریت بسته ارائه شده است
عناصر.

این گزینه را می توان چندین بار و هر بار با چندین بسته مشخص کرد
با کاما از هم جدا می شوند.

-- envvar متغیر
-- envvar VARIABLE=VALUE
یک متغیر محیطی را برای عناصر حمل یا تنظیم کنید.

برای اطلاعات بیشتر در مورد تعامل و استفاده از "متغیرهای محیط" زیر را ببینید
متغیرهای محیطی.

این گزینه به دو صورت قابل استفاده است:

-- envvar متغیر
متغیر محیطی "VARIABLE" را حمل کنید. اگر تنظیم نشود، چیزی صادر نمی شود
به عناصر

-- envvar VARIABLE=VALUE
متغیر محیطی "VARIABLE" را با مقدار "VALUE" برای عناصر تنظیم کنید،
صرف نظر از اینکه متغیر محیطی با همین نام وجود دارد یا خیر.

این می تواند برای ارسال متغیرهای محیطی بدون صادرات آنها در آن مفید باشد
محیطی که virt-dib در آن اجرا می شود.

--exclude-element عنصر
عنصر مشخص شده را نادیده بگیرید.

--exclude-script اسکریپت
هر اسکریپت عنصری به نام "SCRIPT" را نادیده بگیرید، هر عنصری که در آن باشد.

برای مثال در مواردی که برخی از اسکریپت ها با virt-dib به خوبی اجرا نمی شوند، این می تواند مفید باشد
زمانی که آنها واقعاً به محیط "diskimage-builder" نیاز دارند.

--فرمت ها فرمت،...
لیست فرمت های خروجی را تنظیم کنید، آنها را با کاما از هم جدا کنید.

فرمت های پشتیبانی شده عبارتند از:

"qcow2" (به طور پیش فرض فعال است)
QEMU's qcow2.

"خام"
فرمت دیسک خام

"قطر"
یک تاربول فشرده نشده.

"vhd"
تصویر دیسک "دیسک سخت مجازی". این فرمت خروجی به ابزار "vhd-util" نیاز دارد.

لطفاً توجه داشته باشید که نسخه ابزار "vhd-util" برای پشتیبانی باید وصله شود
دستور فرعی "تبدیل" و قابل بوت شدن باشد. پچ در اینجا موجود است:
https://github.com/emonty/vhd-util/blob/master/debian/patches/citrix.

--fs-type FILESYSTEM
نوع فایل سیستم را برای استفاده برای فایل سیستم ریشه تنظیم کنید. پیش فرض "ext4" است.

همچنین به "guestfs_filesystem_available" در اینجا مراجعه کنید مهمانان(3).

--image-cache دایرکتوری
مسیری را در میزبان تنظیم کنید که در آن منابع استفاده شده توسط عناصر موجود در حافظه پنهان ذخیره شود
فاز "extra-data.d". پیش فرض است ~/.cache/image-create.

لطفاً توجه داشته باشید که بیشتر منابعی که پس از «داده‌های اضافی» واکشی می‌شوند، در حافظه پنهان ذخیره می‌شوند
درایو کمکی مشخص شده با --راندن; همچنین به "HELPER DRIVE" مراجعه کنید.

- نوع نصب TYPE
نوع نصب پیش فرض را مشخص کنید. به طور پیش فرض به "منبع".

برای استفاده از نصب های مبتنی بر بسته به طور پیش فرض روی "package" تنظیم کنید.

-- قابل خواندن توسط ماشین
از این گزینه برای سازگاری بیشتر خروجی با ماشین هنگام تجزیه توسط استفاده می شود
برنامه های دیگر «خروجی قابل خواندن با ماشین» را در زیر ببینید.

-m MB
--Memsize MB
مقدار حافظه اختصاص داده شده به دستگاه را تغییر دهید. اگر آن را پیدا کردید این را افزایش دهید
حافظه اجرای virt-dib تمام می شود.

پیش فرض را می توان با این دستور پیدا کرد:

guestfish get-memsize

--mkfs-گزینه ها "OPTION STRING"
گزینه های مشخص شده را به آن اضافه کنید mkfs(1)، برای اینکه بتوانید فایل سیستم ریشه را به خوبی تنظیم کنید
ایجاد. توجه داشته باشید که این امکان برای لغو نوع فایل سیستم وجود ندارد.

شما باید استفاده کنید --mkfs-گزینه ها حداکثر یک بار برای عبور چندین گزینه، آنها را از هم جدا کنید
با فضا، به عنوان مثال:

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

--شبکه
--بدون شبکه
در حین نصب، دسترسی به شبکه از مهمان را فعال یا غیرفعال کنید.

Enabled پیش فرض است. استفاده کنید --بدون شبکه برای غیرفعال کردن دسترسی

این شبکه فقط امکان اتصالات خروجی را می دهد و محدودیت های جزئی دیگری نیز دارد. دیدن
"NETWORK" در فضیلت نجات(1).

این تأثیری ندارد که مهمان بتواند به شبکه پس از راه‌اندازی دسترسی داشته باشد.
زیرا توسط هایپروایزر یا محیط ابری شما کنترل می شود و هیچ ارتباطی ندارد
با virt-dib انجام دهید.

در صورت استفاده از --بدون شبکه، سپس متغیر محیطی "DIB_OFFLINE" روی 1 تنظیم می شود،
به عناصر نشان می دهد که در صورت وجود باید فقط از منابع ذخیره شده در حافظه پنهان استفاده کنند.
همچنین توجه داشته باشید که بر خلاف «diskimage-builder» که در آن عناصر ممکن است همچنان بتوانند
دسترسی به شبکه حتی با "DIB_OFFLINE="، تحت شبکه virt-dib به طور کامل خواهد بود
غیر قابل دسترس

--نام نام
نام فایل تصویر خروجی را تنظیم کنید. پیش فرض "تصویر" است.

با توجه به نام انتخاب شده، موارد زیر در دایرکتوری فعلی وجود خواهد داشت:

$NAME.ext
برای هر فرمت خروجی، یک تصویر دیسک به نام تصویر خروجی با
پسوند بسته به فرمت؛ مثلا: $NAME.qcow2, $NAME.raw، و غیره

در حالت ramdisk قابل استفاده نیست، به "RAMDISK BUILDING" مراجعه کنید.

$NAME.d
برای مثال، دایرکتوری حاوی هر فایلی که توسط عناصر ایجاد شده است دیب-
تجلی می یابد دایرکتوری (ایجاد شده توسط عنصر "manifests")، ramdisks و هسته ها در
حالت ramdisk و غیره.

--بدون حذف در صورت شکست
فایل های خروجی را در صورت شکست در ساخت حذف نکنید. می توانید از این برای رفع اشکالات استفاده کنید
برای اجرای اسکریپت ها

پیش‌فرض حذف فایل خروجی در صورت عدم موفقیت در virt-dib است (یا مثلاً برخی
اسکریپتی که اجرا می کند با شکست مواجه می شود).

-q
--ساکت
پیام های پیشرفت معمولی را چاپ نکنید.

--qemu-img-options گزینه[,گزینه،...]
عبور --qemu-img-options گزینه(های) به qemu-img(1) فرمان برای تنظیم دقیق خروجی
قالب گزینه های موجود به فرمت خروجی بستگی دارد (نگاه کنید به --فرمت ها) و
نسخه نصب شده برنامه qemu-img.

شما باید استفاده کنید --qemu-img-options حداکثر یک بار برای عبور چندین گزینه، آن را جدا کنید
آنها را با کاما، به عنوان مثال:

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

--ramdisk
حالت ساخت ramdisk را تنظیم کنید.

به "ساختمان RAMDISK" مراجعه کنید.

--ramdisk-element نام
نام عنصر اضافی اضافه شده در حالت ساخت ramdisk را تنظیم کنید. پیشفرض
"ramdisk" است.

به "ساختمان RAMDISK" مراجعه کنید.

--ریشه-برچسب LABEL
برچسب را برای فایل سیستم ریشه در تصویر ایجاد شده تنظیم کنید.

لطفاً توجه داشته باشید که برخی از سیستم‌های فایل محدودیت‌های متفاوتی در طول زمان خود دارند
برچسب ها؛ برای مثال، برچسب‌های سیستم فایل «ext2/3/4» نمی‌توانند بیشتر از 16 باشند
کاراکترها، در حالی که در "xfs" حداکثر 12 کاراکتر دارند.

پیش فرض بستگی به سیستم فایل واقعی برای پارتیشن ریشه دارد (نگاه کنید به --fs-type):
در "xfs" "img-rootfs" است، در حالی که "cloudimg-rootfs" در هر فایل سیستم دیگری است.

--اندازه اندازه
اندازه دیسک خروجی را انتخاب کنید، جایی که می توان اندازه را با استفاده از نام های رایج مشخص کرد
مانند "32G" (32 گیگابایت) و غیره. اندازه پیش فرض "5G" است.

برای تعیین اندازه بر حسب بایت، عدد باید با حروف کوچک همراه شود b، به عنوان مثال:
"--اندازه 10737418240b".

همچنین مشاهده کنید virt-Resize(1) برای تغییر اندازه پارتیشن های یک تصویر دیسک موجود.

-- skip-base
از گنجاندن عنصر "پایه" صرفنظر کنید.

--smp N
N ≥ 2 CPU مجازی را برای استفاده از اسکریپت ها فعال کنید.

-u تصاویر حاصل از qcow2 را فشرده نکنید. پیش فرض این است که آنها را فشرده کنید.

-v
-- پرحرف
پیام های اشکال زدایی را فعال کنید.

-V
- نسخه
نمایش شماره نسخه و خروج

-x ردیابی تماس های API libguestfs را فعال کنید.

محیط زیست متغیرها

بر خلاف "diskimage-builder"، محیط میزبان است نه به ارث رسیده در
دستگاه هنگام اجرای اکثر عناصر (یعنی همه آنهایی که متفاوت از
"extra-data.d").

برای تنظیم محیط برای عناصر در حال اجرا، باید به virt-dib بگویید که از آن استفاده کند
آنها، با گزینه -- envvar. چنین گزینه ای اجازه می دهد تا به طور انتخابی محیط را صادر کنید
متغیرها هنگام اجرای عناصر، و این روش ترجیحی برای عبور از محیط است
متغیرهای عناصر

برای جمع بندی: اگر می خواهید متغیر محیطی "MYVAR" (و محتوای آن) در دسترس باشد
به عناصر، می توانید هر دو را انجام دهید

MYVAR # هر کدام ارزش آن را صادر کنید
virt-dib ... --envvar MYVAR ...

or

virt-dib ... --envvar MYVAR=ارزش_آن ...

یاور راندن

Virt-dib بیشتر عنصر را در دستگاه خود اجرا می کند، و بنابراین روی هاست اجرا نمی شود. زیرا
از این رو، هیچ امکانی برای عناصر وجود ندارد که منابع را مستقیماً روی میزبان ذخیره کنند.

برای حل این مشکل، virt-dib اجازه می دهد تا از یک درایو کمکی در جایی که حافظه پنهان ذخیره شود، استفاده کنید
منابع، مانند تصاویر دیسک، بسته های توزیع، و غیره. در حالی که این بدان معنی است که وجود دارد
فضای کوچکتر موجود برای ذخیره، حداقل اجازه می دهد تا فضای میزبان را محدود کنید
حافظه پنهان، بدون فرض اینکه عناصر به تنهایی این کار را انجام می دهند.

در حال حاضر این دیسک یا نیاز به داشتن یک پارتیشن منفرد یا پارتیشن اول دارد
پارتیشن روی آن استفاده خواهد شد. دیسکی با پیکربندی اخیر را می توان به راحتی ایجاد کرد
با ماهی مهمان(1) مانند موارد زیر:

guestfish -N filename.img=fs:ext4:10G

در بالا یک تصویر دیسک به نام ایجاد می شود filename.img10G بزرگ با یک پارتیشن
از نوع ext4; به "تصاویر آماده شده دیسک" مراجعه کنید ماهی مهمان(1).

توصیه می شود که ≥ 10G یا حتی بیشتر باشد، زیرا عناصر تصاویر دیسک را ذخیره می کنند.
بسته های توزیع، و غیره. مانند هر تصویر دیسک، دیسک کمکی به راحتی قابل تغییر است
با استفاده از virt-Resize(1) اگر فضای بیشتری در آن مورد نیاز است.

درایو را می توان مانند هر تصویر دیسک دیگری، به عنوان مثال با استفاده از ابزارهای دیگر، دسترسی داشت
libguestf هایی مانند ماهی مهمان(1):

guestfish -a filename.img -m /dev/sda1

اگر هیچ درایو کمکی با مشخص نشده باشد --راندن، تمام منابع ذخیره شده در طول یک virt-dib
اجرا کنار گذاشته خواهد شد.

منابع داخل L' راندن
در داخل درایو کمکی، می توان منابع زیر را پیدا کرد:

/ صفحه اصلی
این دایرکتوری در حین ساخت به عنوان متغیر محیطی "HOME" تنظیم می شود. آن شامل
بیشتر حافظه پنهان تصویر (ذخیره شده به عنوان /home/.cache/image-create) و هر کدام دیگر
منبع در دایرکتوری اصلی کاربر که ابزارهای مختلف را اجرا می کند، ذخیره می شود.

/virt-dib-*.log
اینها گزارش‌های عناصری هستند که در دستگاه libguestfs اجرا می‌شوند، که
به معنای تمام قلاب ها به جز "extra-data.d".

رامدیسک BUILDING

Virt-dib همچنین می تواند "ramdisk-image-create" را که یک حالت عملیات ثانویه است، شبیه سازی کند.
"تحریک کننده". به جای اینکه یک نام ابزار متفاوت باشد، virt-dib آسان را فراهم می کند
دسترسی به این حالت با استفاده از --ramdisk سوئیچ.

در این حالت:

· یک عنصر ramdisk اضافی اضافه شده است (نگاه کنید به --ramdisk-element)

· هیچ تصویری تولید نمی شود (بنابراین --فرمت ها نادیده گرفته می شود)

· $NAME.d (نگاه کنید به --نام) شامل initrd، kernel و غیره خواهد بود

موقت دایرکتوری

Virt-dib از دایرکتوری موقت استاندارد استفاده شده توسط libguestfs استفاده می کند، به "محیط زیست" مراجعه کنید.
متغیرها" در مهمانان(3).

به طور پیش فرض این مکان است دایرکتوری / tmp (مقدار پیش فرض برای "TMPDIR")، که در برخی از سیستم ها ممکن است
روی یک فایل سیستم tmpfs باشد، و بنابراین حداکثر اندازه را پیش‌فرض می‌کند نیم رم فیزیکی
اگر virt-dib بیش از این مقدار باشد، ممکن است با یک خطا هنگ کند یا زودتر از آن خارج شود. راه حل این است که
نقطه "TMPDIR" را به یک مکان دائمی که به عنوان مکان موقت استفاده می شود، به عنوان مثال:

mkdir local-tmp
env TMPDIR=$PWD/local-tmp virt-dib ...
rm -rf محلی-tmp

EXTRA وابستگی ها

از آنجایی که virt-dib اکثر عناصر را در دستگاه خود اجرا می کند، تمام ابزارها و
کتابخانه های مورد استفاده توسط عناصری که خارج از مهمان اجرا می شوند (معمولاً "root.d"،
"block-device.d" و "cleanup.d") باید در دستگاه نیز وجود داشته باشد. در صورت
آنها اینطور نیستند، اسکریپت ها عمدتاً با خطای "فرمان یافت نشد" خراب می شوند.

برای ابزارها و کتابخانه های بسته بندی شده توسط توزیع، راه حل آسان این است که بگویید
libguestfs برای اضافه کردن بسته های اضافی در دستگاه. این به عنوان مثال قابل انجام است
ایجاد یک فایل جدید با بسته های اضافی:

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

مسیر واقعی به supermin.d دایرکتوری بستگی به توزیع دارد. فایل های اضافی
می تواند بسته های بیشتری را لیست کند، هر کدام در خط خاص خود.

مقایسه با DISKIMAGE-BUILDER

Virt-dib به عنوان جایگزین ایمن برای "diskimage-builder" و آن در نظر گرفته شده است
حالت "ramdisk-image-create"؛ تفاوت های قابل توجه کاربر عبارتند از:

· آرگومان های خط فرمان. برخی از استدلال ها همان استدلال های موجود در هستند
"diskimage-builder"، در حالی که برخی از آنها نام های مختلفی دارند:

دیسک-تصویر-ایجاد virt-dib
-------------------------
-a ARCH - arch ARCH
-اندازه تصویر SIZE -اندازه SIZE
--max-online-size SIZE با استفاده از --mkfs-Options قابل انجام است
-n --skip-base
-o IMAGENAME --نام IMAGENAME
-p بسته(های) --بسته های اضافی بسته(های)
-t FORMAT(S) --formats FORMAT(S)
-x --debug N

· محل فایل های خروجی غیر تصویری (مانند رام دیسک ها و کرنل ها)

· روش ذخیره برخی از منابع ذخیره شده در حافظه پنهان: استفاده از یک درایو کمکی، نه مستقیماً روی آن
دیسکی که virt-dib در آن اجرا می شود

· نیاز به تعیین اندازه هدف برای دیسک خروجی، بر خلاف
"diskimage-builder" در حال محاسبه یک بهینه

· مدیریت متغیرهای محیطی، به "متغیرهای محیطی" مراجعه کنید.

علاوه بر این، به غیر از متغیرهای محیطی خود libguestfs (به "محیط زیست" مراجعه کنید
متغیرها" در مهمانان(3))، virt-dib هیچ متغیر محیطی دیگری را نمی خواند: این
به این معنی که تمام گزینه ها و تغییرات رفتاری تنها با استفاده از دستور مشخص می شوند
آرگومان های خطی

· اسکریپت های "extra-data.d" در محیط میزبان، قبل از همه اسکریپت های دیگر اجرا می شوند (حتی
"root.d")؛ این بدان معناست که بسته به پیکربندی برای عناصر، برخی از
آنها ممکن است به دلیل محتوای گم شده (معمولاً دایرکتوری ها) در "TMP_HOOKS_PATH" شکست بخورند.

راه حل برای این ممکن است یکی از این موارد باشد:

اسکریپت های "extra-data.d" را برای ایجاد دایرکتوری های از دست رفته اصلاح کنید

· ایجاد (و استفاده از) یک عنصر ساده با یک اسکریپت "extra-data.d" به نام eg
00-create-missing-dirs برای ایجاد دایرکتوری های از دست رفته

· ابزار اضافی مورد نیاز در برخی از مراحل خارج از کروت باید در دستگاه موجود باشد،
به "وابستگی های اضافی" مراجعه کنید.

خود عناصر نباید تفاوتی در نحوه اجرایشان ببینند. رفتار - اخلاق
تفاوت ها ممکن است به دلیل فرضیات اشتباه در عناصر، یا عدم درستی شبیه سازی virt-dib باشد.

مسائل شناخته شده در حال حاضر:

· (هیچ یک)

دستگاه قابل خواندن OUTPUT

La -- قابل خواندن توسط ماشین می توان از گزینه برای سازگاری بیشتر خروجی با ماشین استفاده کرد، که
هنگام فراخوانی virt-dib از برنامه های دیگر، رابط کاربری گرافیکی و غیره مفید است.

از این گزینه به تنهایی برای پرس و جو از قابلیت های باینری virt-dib استفاده کنید. معمول
خروجی به شکل زیر است:

$ virt-dib --machine-readable
virt-dib
خروجی: qcow2
خروجی: تار
خروجی: خام
خروجی: vhd

لیستی از ویژگی ها چاپ می شود، یکی در هر خط، و برنامه با وضعیت 0 خارج می شود.

TESTING

Virt-dib با "diskimage-builder" (و عناصر آن) ≥ 0.1.43 تست شده است. از زمان
به زمان نیز با «عناصر-تصویر سه گانه» و «عناصر-تصویر صحرا».

نسخه های قبلی ممکن است کار کنند، اما تضمین نمی شود.

خروج وضعیت

این برنامه در صورت موفقیت آمیز بودن 0 یا در صورت وجود خطا، عدد غیر صفر را برمی گرداند.

با استفاده از خدمات onworks.net از virt-dib آنلاین استفاده کنید