| podman-machine-os-upgrade(1) | General Commands Manual | podman-machine-os-upgrade(1) |
نام (NAME)
podman-machine-os-upgrade - ارتقای سیستم‌عامل ماشین مجازی پادمن
خلاصه دستور (SYNOPSIS)
podman machine os upgrade [گزینه‌ها] [vm]
توضیحات (DESCRIPTION)
ارتقای سیستم‌عامل یک ماشین پادمن.
انجام خودکار ارتقای سیستم‌عامل ماشین پادمن بر اساس منطق زیر. برای اعمال یک ایمیج سفارشی یا ایمیجی با دایجست (digest) مشخص، به‌جای این دستور از podman machine os apply استفاده کنید.
نام پیش‌فرض ماشین podman-machine-default است. اگر نام ماشینی به عنوان آرگومان مشخص نشود، تغییرات سیستم‌عامل بر روی podman-machine-default اعمال خواهد شد.
برای اجرای این دستور، ماشین باید روشن باشد.
نکته: این دستور در ارائه‌دهنده ماشین WSL پشتیبانی نمی‌شود.
منطق ارتقا (UPGRADE LOGIC)
تابع ارتقا با استفاده از نسخه‌بندی معنایی (تنها بخش‌های اصلی.فرعی یا major.minor، با نادیده گرفتن سطح پچ)، نسخه کلاینت را با نسخه ماشین مقایسه می‌کند. هنگامی که نسخه‌ها یکسان باشند، رجیستری آنلاین را برای بررسی به‌روزرسانی‌های ایمیج استعلام می‌کند:
نسخه کلاینت قدیمی‌تر از نسخه ماشین باشد (دان‌گرید / تنزل نسخه): خطا بازمی‌گرداند. برای جلوگیری از ناسازگاری‌ها، تنزل نسخه پشتیبانی نمی‌شود. کلاینت پادمن خود را به‌روزرسانی کنید تا با نسخه ماشین همسان یا از آن بالاتر شود.
نسخه کلاینت با نسخه ماشین برابر باشد (به‌روزرسانی درون‌نسخه‌ای / in-band): با مقایسه دایجست ایمیج محلی سیستم‌عامل با دایجست موجود در رجیستری، به‌روزرسانی‌های همان استریم نسخه را بررسی می‌کند. این فرایند دو حالت را مدیریت می‌کند:
- به‌روزرسانی‌های نسخه پچ (مانند 6.0.1 ← 6.0.2)
- تازه‌سازی‌های ایمیج سیستم‌عامل با همان نسخه پادمن (مانند 6.0.1 ← ساخت جدیدتر سیستم‌عامل حاوی 6.0.1)
اگر به‌روزرسانی درون‌نسخه‌ای وجود داشته باشد، ماشین با استفاده از ارجاع دایجست آن به ایمیج جدید به‌روزرسانی می‌شود. اگر به‌روزرسانی در دسترسی نباشد، تابع گزارش می‌دهد که سیستم به‌روز است.
نسخه کلاینت جدیدتر از نسخه ماشین باشد (ارتقای اصلی/فرعی): سیستم‌عامل ماشین را ارتقا می‌دهد تا با نسخه major.minor کلاینت مطابقت پیدا کند. ارتقا، تگ نسخه جدیدی را هدف قرار می‌دهد که از شماره‌های نسخه اصلی و فرعی کلاینت ساخته شده است (برای مثال، ارتقا از 6.0.x به 6.1 وقتی که نسخه کلاینت 6.1.0 است).
گزینه‌ها (OPTIONS)
--dry-run, -n
تنها یک اجرای آزمایشی (dry-run) برای بررسی امکان ارتقا انجام می‌دهد. هیچ محتوایی دانلود یا اعمال نمی‌شود. این گزینه نمی‌تواند همراه با --restart استفاده شود.
--format, -f
تعیین یک قالب خروجی ساختاریافته. تنها مقدار معتبر برای آن json است. استفاده از این گزینه به معنای اجرای آزمایشی (dry-run) خواهد بود. این گزینه نمی‌تواند همراه با --restart استفاده شود.
--help
چاپ اعلان راهنمای استفاده.
--restart
راه‌اندازی مجدد ماشین مجازی پس از اعمال تغییرات.
مثال‌ها (EXAMPLES)
به‌روزرسانی ماشین پیش‌فرض پادمن به آخرین نسخه درون‌نسخه‌ای یا به‌روزرسانی ماشین برای انطباق با نسخه کلاینت پادمن:
$ podman machine os upgrade
همانند بالا اما با تعیین یک ماشین خاص:
$ podman machine os upgrade mymachine
بررسی موجود بودن به‌روزرسانی بدون دانلود یا اعمال ارتقا:
$ podman machine os upgrade -n
بررسی موجود بودن به‌روزرسانی با نمایش پاسخ در قالب JSON. توجه داشته باشید این گزینه یک فیلد بولی را نمایش می‌دهد که نشان می‌دهد آیا به‌روزرسانی موجود است یا خیر:
نکته: استفاده از گزینهٔ قالب، به منزلهٔ اجرای آزمایشی (dry-run) است.
$ podman machine os upgrade -f json
همچنین ببینید (SEE ALSO)
تاریخچه (HISTORY)
ژانویه ۲۰۲۶، در ابتدا توسط Brent Baude bbaude@redhat.com ⟨mailto:bbaude@redhat.com⟩ گردآوری شد.