نام (NAME)

virt-builder-repository - ساخت آسان مخزن منبع برای virt-builder

خلاصه دستور (SYNOPSIS)

virt-builder-repository /path/to/repository
   [-i|--interactive] [--gpg-key KEYID]

توضیحات (DESCRIPTION)

ابزار virt-builder ابزاری برای ساخت سریع ماشین‌های مجازی جدید است. این ابزار می‌تواند برای استفاده از مخازن الگو پیکربندی شود. با این حال، ایجاد و نگهداری یک مخزن شامل وظایف متعددی است که می‌توانند خودکار شوند. دستور virt-builder-repository ابزاری برای کمک به مدیریت این مخازن است.

دستور virt-builder-repository روی فایل‌های موجود در دایرکتوری مشخص‌شده به عنوان آرگومان پیمایش کرده، فایل‌هایی با نام منتهی به "qcow2"، "raw"، "img" یا بدون پسوند را فشرده می‌کند، داده‌ها را از آن‌ها استخراج کرده و فایل "index" را ایجاد یا به‌روزرسانی می‌کند.

بخشی از داده‌های مرتبط با ایمیج که برای فایل index مورد نیاز است، از طریق خود فایل ایمیج قابل محاسبه نیستند. virt-builder-repository ابتدا تلاش می‌کند آن‌ها را در فایل index موجود بیابد. اگر داده‌ها پس از این مرحله همچنان مفقود باشند، در حالت تعاملی (interactive) از کاربر درخواست می‌شوند، در غیر این صورت خطایی رخ خواهد داد.

اگر یک "KEYID" ارائه شود، فایل index تولیدشده با این کلید GPG امضا خواهد شد..SH "مثال‌ها (EXAMPLES)"

virt-builder-repository --gpg-key "joe@hacker.org" -i /path/to/folder

[template_id]
file=template_filename.qcow.xz

virt-builder-repository --gpg-key "joe@hacker.org" -i /path/to/folder

گزینه‌ها (OPTIONS)

--help

نمایش راهنما.

--gpg GPG

مشخص کردن یک باینری جایگزین برای gpg(1) (GNU Privacy Guard). همچنین می‌توانید از این گزینه برای افزودن پارامترهای gpg استفاده کنید؛ برای مثال جهت تعیین یک دایرکتوری خانگی جایگزین:

virt-builder-repository --gpg "gpg --homedir /tmp" [...]

همچنین می‌توان از این گزینه برای جلوگیری از درخواست عبارت عبور (passphrase) کلید توسط gpg استفاده کرد:

virt-builder-repository --gpg "gpg --passphrase-file /tmp/pass --batch" [...]

-K KEYID

--gpg-key KEYID

مشخص کردن کلید GPG مورد استفاده برای امضای فایل نمایهٔ مخزن. اگر مشخص نشود، نمایه بدون امضا باقی می‌ماند. "KEYID" برای شناسایی کلید GPG مورد نظر به کار می‌رود. این مقدار به گزینهٔ --default-key در gpg فرستاده می‌شود و بنابراین می‌تواند یک نشانی رایانامه یا یک اثرانگشت (fingerprint) باشد.

یادداشت: به‌طور پیش‌فرض، virt-builder-repository کلید را در جاکلیدی (keyring) کلیدهای GPG کاربر جستجو می‌کند.

-i

--interactive

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

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

--no-compression

عدم فشرده‌سازی ایمیج‌های الگو.

--machine-readable

--machine-readable=format

این گزینه برای ماشین‌پسندتر کردن خروجی هنگام پردازش و تجزیه توسط برنامه‌های دیگر به کار می‌رود. بخش «MACHINE READABLE OUTPUT» را در ادامه ببینید.

--colors

--colours

استفاده از توالی‌های رنگی ANSI برای رنگی کردن پیام‌ها. این حالت پیش‌فرض هنگامی است که خروجی یک tty باشد. اگر خروجی برنامه به یک فایل هدایت شود، توالی‌های رنگی ANSI غیرفعال خواهند شد مگر اینکه از این گزینه استفاده کنید.

-q

--quiet

عدم چاپ پیام‌های پیشرفت عادی.

-v

--verbose

فعال‌سازی پیام‌های اشکال‌زدایی (debug) و/یا تولید خروجی پرجزئیات.

هنگام گزارش باگ‌ها، از این گزینه استفاده کرده و خروجی کامل را به گزارش خود پیوست کنید.

-V

--version

نمایش شمارهٔ نسخه و خروج.

--wrap

شکستن خطوط (wrap) پیام‌های خطا، هشدار و اطلاعاتی. این حالت پیش‌فرض هنگامی است که خروجی یک tty باشد. اگر خروجی برنامه به یک فایل هدایت شود، شکستن خطوط غیرفعال می‌شود مگر اینکه از این گزینه استفاده کنید.

-x

فعال‌سازی ردگیری (tracing) فراخوانی‌های API کتابخانهٔ libguestfs..SH "خروجی ماشین‌خوان (MACHINE READABLE OUTPUT)" گزینهٔ --machine-readable می‌تواند برای ماشین‌خوان‌تر کردن خروجی استفاده شود، که هنگام فراخوانی virt-builder-repository از دیگر برنامه‌ها، رابط‌های گرافیکی (GUI) و غیره کاربردی است.

از این گزینه به تنهایی برای بررسی قابلیت‌های باینری virt-builder-repository استفاده کنید. یک خروجی معمول به این صورت است:

$ virt-builder-repository --machine-readable
virt-builder-repository

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

امکان تعیین یک رشتهٔ قالب‌بندی برای کنترل خروجی وجود دارد؛ «ADVANCED MACHINE READABLE OUTPUT» را در guestfs(3) ببینید.

وضعیت خروج (EXIT STATUS)

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

همچنین ببینید (SEE ALSO)

virt-builder(1) http://libguestfs.org

نویسندگان (AUTHORS)

Cédric Bosdonnat mailto:cbosdonnat@suse.com

کپی‌رایت و تکثیر (COPYRIGHT)

Copyright (C) 2016-2025 SUSE Inc.

مجوز (LICENSE)

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد (Free Software Foundation) منتشر شده است، چه نسخهٔ 2 مجوز یا (به انتخاب خودتان) هر نسخهٔ بالاتری بازتوزیع کرده و/یا تغییر دهید.

این برنامه با این امید توزیع می‌شود که مفید باشد، اما بدون هرگونه ضمانت؛ حتی ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.

شما باید همراه با این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به آدرس زیر مکاتبه کنید: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

گزارش باگ‌ها (BUGS)

برای دریافت فهرستی از باگ‌های libguestfs، از این پیوند استفاده کنید: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

برای گزارش یک باگ جدید در libguestfs، از این پیوند استفاده کنید: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

هنگام گزارش یک باگ، لطفاً موارد زیر را ارائه دهید:

• نسخهٔ libguestfs.
• جایی که libguestfs را از آن دریافت کرده‌اید (برای مثال کدام توزیع لینوکس، کامپایل‌شده از سورس، و غیره)
• باگ را به‌طور دقیق توضیح داده و روشی برای بازتولید آن ارائه دهید.
• دستور libguestfs-test-tool(1) را اجرا کرده و خروجی کامل و ویرایش‌نشده را در گزارش باگ قرار دهید.