.nh
.TH "DOCKER" "1" "Aug 2026" "Docker Community" "Docker User Manuals"

.SH "نام (NAME)"
docker-container-update \- به‌روزرسانی پیکربندی یک یا چند کانتینر


.SH "خلاصه دستور (SYNOPSIS)"
\fBdocker container update [OPTIONS] CONTAINER [CONTAINER...]\fP


.SH "شرح (DESCRIPTION)"
دستور \fBdocker container update\fP پیکربندی کانتینر را به‌صورت پویا به‌روزرسانی می‌کند.
می‌توانید از این دستور برای جلوگیری از مصرف بیش از حد منابع میزبان داکر توسط کانتینرها استفاده کنید.
با یک دستور واحد، می‌توانید محدودیت‌هایی را روی یک کانتینر یا چند کانتینر اعمال کنید.
برای مشخص کردن بیش از یک کانتینر، فهرستی از نام‌ها یا شناسه‌های کانتینرها را که با فاصله از هم جدا شده‌اند وارد کنید.


.SH "گزینه‌ها (OPTIONS)"
.SS memory
محدودیت حافظه (قالب: \fB<number>[<unit>]\fR، که در آن واحد می‌تواند b، k، m یا g باشد)

.PP
توجه داشته باشید که حافظه باید کوچک‌تر از محدودیت حافظه swap از قبل تعیین‌شده باشد.
اگر می‌خواهید محدودیت حافظه‌ای بزرگ‌تر از محدودیت swap تعیین‌شده تنظیم کنید،
باید محدودیت حافظه swap را نیز به‌طور هم‌زمان به‌روزرسانی نمایید. اگر در هنگام docker create/run
محدودیت حافظه swap تعیین نشده باشد و تنها محدودیت حافظه تعیین شده باشد، مقدار حافظه swap
دو برابر محدودیت حافظه خواهد بود.


.SH "مثال‌ها (EXAMPLES)"
بخش‌های زیر روش‌های استفاده از این دستور را نشان می‌دهند.

.SS "به‌روزرسانی cpu-shares یک کانتینر"
برای محدود کردن cpu-shares یک کانتینر به ۵۱۲، ابتدا نام یا شناسه کانتینر را مشخص کنید.
می‌توانید از \fBdocker ps\fP برای یافتن این مقادیر استفاده کنید. همچنین می‌توانید
از شناسه بازگردانده‌شده توسط دستور \fBdocker run\fP استفاده نمایید. سپس، دستور زیر را اجرا کنید:

.EX
$ docker container update --cpu-shares 512 abebf7571666
.EE

.SS "به‌روزرسانی یک کانتینر با cpu-shares و حافظه"
برای به‌روزرسانی چندین پیکربندی منبع برای چند کانتینر:

.EX
$ docker container update --cpu-shares 512 -m 300M abebf7571666 hopeful_morse
.EE

.SS "به‌روزرسانی سیاست راه‌اندازی مجدد (restart policy) کانتینر"
می‌توانید سیاست راه‌اندازی مجدد یک کانتینر را روی یک کانتینر در حال اجرا تغییر دهید. سیاست جدید
راه‌اندازی مجدد، بلافاصله پس از اجرای \fBdocker container update\fR روی کانتینر اعمال می‌شود.

.PP
برای به‌روزرسانی سیاست راه‌اندازی مجدد برای یک یا چند کانتینر:

.EX
$ docker container update --restart=on-failure:3 abebf7571666 hopeful_morse
.EE

.PP
توجه داشته باشید که اگر کانتینر با فلگ "--rm" راه‌اندازی شده باشد، نمی‌توانید سیاست راه‌اندازی
مجدد آن را به‌روزرسانی کنید. گزینه‌های \fBAutoRemove\fR و \fBRestartPolicy\fR برای کانتینر با یکدیگر ناسازگارند.


.SH "گزینه‌ها (OPTIONS)"
\fB--blkio-weight\fP=0
	ورودی/خروجی بلوکی (وزن نسبی)، بین ۱۰ تا ۱۰۰۰، یا ۰ برای غیرفعال‌سازی (پیش‌فرض ۰)

.PP
\fB--cpu-period\fP=0
	محدود کردن دوره زمان‌بند کاملاً منصفانه (CFS) سی‌پی‌یو

.PP
\fB--cpu-quota\fP=0
	محدود کردن سهمیه زمان‌بند کاملاً منصفانه (CFS) سی‌پی‌یو

.PP
\fB--cpu-rt-period\fP=0
	محدود کردن دوره بی‌درنگ (real-time) سی‌پی‌یو بر حسب میکروثانیه

.PP
\fB--cpu-rt-runtime\fP=0
	محدود کردن زمان اجرای بی‌درنگ (real-time) سی‌پی‌یو بر حسب میکروثانیه

.PP
\fB-c\fP, \fB--cpu-shares\fP=0
	سهم‌های پردازنده (وزن نسبی)

.PP
\fB--cpus\fP=
	تعداد پردازنده‌ها

.PP
\fB--cpuset-cpus\fP=""
	پردازنده‌های مجاز برای اجرا (0-3, 0,1)

.PP
\fB--cpuset-mems\fP=""
	حافظه‌های مجاز برای اجرا (0-3, 0,1)

.PP
\fB-m\fP, \fB--memory\fP=0
	محدودیت حافظه

.PP
\fB--memory-reservation\fP=0
	محدودیت نرم حافظه

.PP
\fB--memory-swap\fP=0
	محدودیت حافظه swap برابر با حافظه به‌علاوه swap: مقدار -1 برای فعال کردن swap نامحدود

.PP
\fB--pids-limit\fP=0
	تنظیم محدودیت تعداد شناسه‌های پردازه (PID) کانتینر (مقدار -1 برای نامحدود)

.PP
\fB--restart\fP=""
	سیاست راه‌اندازی مجدد هنگام خروج کانتینر


.SH "ببینید (SEE ALSO)"
\fBdocker-container(1)\fP