.nh
.TH podman-machine-os-upgrade 1
.SH "نام (NAME)"
podman-machine-os-upgrade \- ارتقای سیستم‌عامل ماشین مجازی پادمن

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman machine os upgrade\fP [\fIگزینه‌ها\fP] [vm]

.SH "توضیحات (DESCRIPTION)"
ارتقای سیستم‌عامل یک ماشین پادمن.

.PP
انجام خودکار ارتقای سیستم‌عامل ماشین پادمن بر اساس منطق زیر.
برای اعمال یک ایمیج سفارشی یا ایمیجی با دایجست (digest) مشخص، به‌جای این دستور از \fBpodman machine os apply\fP استفاده کنید.

.PP
نام پیش‌فرض ماشین \fBpodman-machine-default\fR\& است. اگر نام ماشینی به عنوان آرگومان مشخص نشود،
تغییرات سیستم‌عامل بر روی \fBpodman-machine-default\fR\& اعمال خواهد شد.

.PP
برای اجرای این دستور، ماشین باید روشن باشد.

.PP
نکته: این دستور در ارائه‌دهنده ماشین WSL پشتیبانی نمی‌شود.

.SS "منطق ارتقا (UPGRADE LOGIC)"
تابع ارتقا با استفاده از نسخه‌بندی معنایی (تنها بخش‌های اصلی.فرعی یا major.minor، با نادیده گرفتن سطح پچ)،
نسخه کلاینت را با نسخه ماشین مقایسه می‌کند. هنگامی که نسخه‌ها یکسان باشند، رجیستری آنلاین را برای بررسی به‌روزرسانی‌های ایمیج استعلام می‌کند:

.PP
\fBنسخه کلاینت قدیمی‌تر از نسخه ماشین باشد (دان‌گرید / تنزل نسخه):\fP
خطا بازمی‌گرداند. برای جلوگیری از ناسازگاری‌ها، تنزل نسخه پشتیبانی نمی‌شود. کلاینت پادمن خود را به‌روزرسانی کنید تا با نسخه ماشین همسان یا از آن بالاتر شود.

.PP
\fBنسخه کلاینت با نسخه ماشین برابر باشد (به‌روزرسانی درون‌نسخه‌ای / in-band):\fP
با مقایسه دایجست ایمیج محلی سیستم‌عامل با دایجست موجود در رجیستری، به‌روزرسانی‌های همان استریم نسخه را بررسی می‌کند. این فرایند دو حالت را مدیریت می‌کند:
.IP \(bu 2
به‌روزرسانی‌های نسخه پچ (مانند 6.0.1 ← 6.0.2)
.IP \(bu 2
تازه‌سازی‌های ایمیج سیستم‌عامل با همان نسخه پادمن (مانند 6.0.1 ← ساخت جدیدتر سیستم‌عامل حاوی 6.0.1)

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

.PP
\fBنسخه کلاینت جدیدتر از نسخه ماشین باشد (ارتقای اصلی/فرعی):\fP
سیستم‌عامل ماشین را ارتقا می‌دهد تا با نسخه major.minor کلاینت مطابقت پیدا کند. ارتقا، تگ نسخه جدیدی را هدف قرار می‌دهد که از شماره‌های نسخه اصلی و فرعی کلاینت ساخته شده است (برای مثال، ارتقا از 6.0.x به 6.1 وقتی که نسخه کلاینت 6.1.0 است).

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--dry-run\fP, \fB-n\fP
تنها یک اجرای آزمایشی (dry-run) برای بررسی امکان ارتقا انجام می‌دهد. هیچ محتوایی دانلود یا اعمال نمی‌شود. این گزینه نمی‌تواند همراه با \fB--restart\fR استفاده شود.

.SS \fB--format\fP, \fB-f\fP
تعیین یک قالب خروجی ساختاریافته. تنها مقدار معتبر برای آن \fBjson\fR\& است. استفاده از این گزینه به معنای اجرای آزمایشی (dry-run) خواهد بود. این گزینه نمی‌تواند همراه با \fB--restart\fR استفاده شود.

.SS \fB--help\fP
چاپ اعلان راهنمای استفاده.

.SS \fB--restart\fP
راه‌اندازی مجدد ماشین مجازی پس از اعمال تغییرات.

.SH "مثال‌ها (EXAMPLES)"
به‌روزرسانی ماشین پیش‌فرض پادمن به آخرین نسخه درون‌نسخه‌ای یا به‌روزرسانی ماشین برای انطباق با نسخه کلاینت پادمن:

.EX
$ podman machine os upgrade
.EE

.PP
همانند بالا اما با تعیین یک ماشین خاص:

.EX
$ podman machine os upgrade mymachine
.EE

.PP
بررسی موجود بودن به‌روزرسانی بدون دانلود یا اعمال ارتقا:

.EX
$ podman machine os upgrade -n
.EE

.PP
بررسی موجود بودن به‌روزرسانی با نمایش پاسخ در قالب JSON. توجه داشته باشید این گزینه یک فیلد بولی را نمایش می‌دهد که نشان می‌دهد آیا به‌روزرسانی موجود است یا خیر:

.PP
نکته: استفاده از گزینهٔ قالب، به منزلهٔ اجرای آزمایشی (dry-run) است.

.EX
$ podman machine os upgrade -f json
.EE

.SH "همچنین ببینید (SEE ALSO)"
\fBpodman(1)\fP, \fBpodman-machine(1)\fP, \fBpodman-machine-os(1)\fP

.SH "تاریخچه (HISTORY)"
ژانویه ۲۰۲۶، در ابتدا توسط Brent Baude bbaude@redhat.com
\[la]mailto:bbaude@redhat.com\[ra]
گردآوری شد.