| vmexec-run(1) | General Commands Manual | vmexec-run(1) |
نام (NAME)
vmexec-run - اجرای یک دستور در یک ماشین مجازی جدید
خلاصه دستور (SYNOPSIS)
vmexec run [-d|--detach] [--rm] [--vmid] [--disable-kvm] [-m|--memory] [-e|--env] [-w|--workdir] [-v|--volume] [--pmem] [-p|--publish] [-s|--ssh-timeout] [-i|--interactive] [-t|--tty] [--show-vm-window] [--pull] [-h|--help] <IMAGE_SOURCE> [ARGS]
توضیحات (DESCRIPTION)
یک دستور را در یک ماشین مجازی جدید اجرا می‌کند.
گزینه‌ها (OPTIONS)
- -d, --detach
- اجرای ماشین مجازی در پس‌زمینه و چاپ شناسه ماشین مجازی.
- --rm
- حذف داده‌های زمان اجرای ماشین مجازی پس از خروج.
- --vmid <VMID>
- شناسه
ماشین
مجازی.
اگر مشخص نشود، یک شناسه تصادفی تولید خواهد شد.
- --disable-kvm
- اجرای
ماشین
مجازی با TCG
به‌جای KVM.
این گزینه بیشتر در محیط‌هایی که KVM در دسترس نیست مفید خواهد بود. بسیار کندتر خواهد بود اما ممکن است در برخی زمینه‌ها قابل قبول باشد.
- -m, --memory <MEMORY>
- محدودیت
حافظه برای
ماشین
مجازی بر
حسب
گیگابایت.
باید یک عدد صحیح با حداقل مقدار ۱ باشد.
اگر مشخص نشود، تمام حافظه در دسترس میزبان استفاده می‌شود.
- -e, --env <ENV>
- تنظیم
متغیرهای
محیطی برای
فرایند
درون ماشین
مجازی.
می‌تواند چندین بار مشخص شود.
قالب مورد انتظار: KEY=VALUE
- -w, --workdir <WORKDIR>
- دایرکتوری
کاری درون
ماشین
مجازی.
دایرکتوری کاری پیش‌فرض برای اجرای برنامه‌ها درون ماشین مجازی به ایمیج بستگی دارد. در بیشتر موارد، /root خواهد بود.
- -v, --volume <VOLUMES>
- سوار کردن
اتصالی (bind mount)
یک حجم در
ماشین
مجازی.
می‌تواند چندین بار مشخص شود.
قالب مورد انتظار: source:dest[:ro]
عبارت `ro` می‌تواند به‌صورت اختیاری برای مشخص کردن اتصال فقط‌خواندنی ارائه شود.
مثال: $PWD/src:/mnt:ro
- --pmem <PMEMS>
- سوار کردن
یک فایل
دستگاه virtio-pmem
در ماشین
مجازی.
ممکن است بخواهید این کار را برای دور زدن حافظه موقت صفحات (page cache) مهمان انجام دهید. این مورد زمانی مهم است که بیش از ظرفیت به میزبان منابع تخصیص می‌دهید (overprovisioning؛ یعنی اختصاص مجموع حافظه بیشتر به ماشین‌های مجازی نسبت به آنچه میزبان در واقعیت دارد) و بار کاریِ نوشتنِ سنگینی دارید. برای اطلاعات بیشتر، ببینید: https://www.qemu.org/docs/master/system/devices/virtio-pmem.html
می‌تواند چندین بار مشخص شود.
اندازه بر حسب گیگابایت است.
قالب مورد انتظار: dest:<size>
مثال: /var/lib:20
- -p, --publish <PUBLISHED_PORTS>
- انتشار یک
درگاه از
ماشین
مجازی به
میزبان.
می‌تواند چندین بار مشخص شود.
قالب مورد انتظار: [[hostip:][hostport]:]vmport
مقدار `hostip` اختیاری است و اگر مشخص نشود، درگاه روی تمام IPهای میزبان متصل (bind) خواهد شد.
مقدار `hostport` اختیاری است و اگر ارائه نشود، همان مقدار `vmport` برای پورت میزبان استفاده خواهد شد.
در حال حاضر فقط IPv4 برای `hostip` پشتیبانی می‌شود.
- -s, --ssh-timeout <SSH_TIMEOUT> [پیش‌فرض: 20]
- مهلت زمانی
اتصال SSH.
تلاش برای این مدت زمان (به ثانیه) جهت اتصال به کارساز SSH ماشین مجازی.
- -i, --interactive <INTERACTIVE> [پیش‌فرض: auto]
- در دسترس
قرار دادن STDIN
برای
فرایند
ماشین
مجازی.
اگر 'auto' باشد، در صورت در دسترس بودن تلاش می‌کند از stdin بخواند و در صورت عدم دسترسی کاری انجام نمی‌دهد. اگر 'always' باشد، تلاش می‌کند از stdin بخواند و در صورت در دسترس نبودن stdin متوقف می‌شود.
مقادیر ممکن:
- always
- never
- auto
- -t, --tty <TTY> [پیش‌فرض: auto]
- تخصیص یک pseudo-TTY
برای ماشین
مجازی.
اگر 'auto' باشد، در صورتی که vmexec از یک ترمینال تعاملی اجرا شود فعال خواهد شد.
مقادیر ممکن:
- always
- never
- auto
- --show-vm-window
- نمایش یک
پنجره که
ماشین
مجازی در
حال اجرا را
نشان
می‌دهد.
این گزینه بیشتر برای رفع اشکال خطاهای راه‌اندازی (بوت) مفید است.
- --pull <PULL> [پیش‌فرض: missing]
- زمان
دریافت (pull)
ایمیج جدید.
مقادیر ممکن:
- missing
- never
- newer
- -h, --help
- چاپ راهنما (مشاهده خلاصه با '-h').
- <IMAGE_SOURCE>
- یک
سیستم‌عامل
(مانند archlinux) یا
مسیری به یک
ایمیج.
انواع سیستم‌عامل ممکن: archlinux
- [ARGS]
- آرگومان‌ها برای اجرا درون ماشین مجازی.
| run |