.nh
.TH "CONFIG.JSON" "5" "JANUARY 2016" "Docker Community" "Docker User Manuals"

.SH "نام (NAME)"
HOME/.docker/config.json \- فایل پیکربندی پیش‌فرض Docker


.SH "مقدمه (INTRODUCTION)"
به‌طور پیش‌فرض، خط فرمان Docker فایل‌های پیکربندی خود را در دایرکتوری‌ای به نام
\fB\&.docker\fR
درون دایرکتوری
\fB$HOME\fR
شما ذخیره می‌کند. Docker بیشتر فایل‌های موجود در دایرکتوری پیکربندی را مدیریت می‌کند و نباید آن‌ها را تغییر دهید.
با این حال،
\fIمی‌توانید\fP
فایل
\fBconfig.json\fR
را تغییر دهید تا جنبه‌های خاصی از نحوه رفتار دستور
\fBdocker\fR
را کنترل کنید.

.PP
در حال حاضر، می‌توانید رفتار دستور
\fBdocker\fR
را با استفاده از متغیرهای محیطی یا گزینه‌های خط فرمان تغییر دهید. همچنین می‌توانید از گزینه‌های درون
\fBconfig.json\fR
برای تغییر برخی از همین رفتارها استفاده کنید. هنگام استفاده از این سازوکارها، باید ترتیب اولویت میان آن‌ها را در نظر داشته باشید. گزینه‌های خط فرمان اولویت بالاتری نسبت به متغیرهای محیطی دارند و متغیرهای محیطی نیز ویژگی‌هایی را که در فایل
\fBconfig.json\fR
مشخص می‌کنید بازنویسی می‌کنند.

.PP
فایل
\fBconfig.json\fR
کدگذاری JSON چندین ویژگی را ذخیره می‌کند:
.IP \(bu 2
ویژگی
\fBHttpHeaders\fR
مجموعه‌ای از هدرها را برای گنجاندن در تمام پیام‌های ارسالی از کلاینت Docker به دیمن مشخص می‌کند. Docker تلاشی برای تفسیر یا درک این هدرها نمی‌کند؛ صرفاً آن‌ها را در پیام‌ها قرار می‌دهد. Docker اجازه نمی‌دهد این هدرها هیچ‌یک از هدرهایی را که خود تعیین کرده است تغییر دهند.
.IP \(bu 2
ویژگی
\fBpsFormat\fR
قالب پیش‌فرض را برای خروجی
\fBdocker ps\fR
مشخص می‌کند. هنگامی که فلگ
\fB--format\fR
همراه با دستور
\fBdocker ps\fR
ارائه نشود، کلاینت Docker از این ویژگی استفاده می‌کند. اگر این ویژگی تنظیم نشده باشد، کلاینت به قالب جدول پیش‌فرض بازمی‌گردد. برای مشاهده فهرستی از دستورالعمل‌های قالب‌بندی پشتیبانی‌شده،
\fBdocker-ps(1)\fP
را ببینید.
.IP \(bu 2
ویژگی
\fBdetachKeys\fR
توالی کلید پیش‌فرضی را که کانتینر را جدا می‌کند مشخص می‌کند. هنگامی که فلگ
\fB--detach-keys\fR
همراه با دستورات
\fBdocker attach\fR،
\fBdocker exec\fR،
\fBdocker run\fR
یا
\fBdocker start\fR
ارائه نشود، کلاینت Docker از این ویژگی استفاده می‌کند. اگر این ویژگی تنظیم نشده باشد، کلاینت به توالی پیش‌فرض
\fBctrl-p,ctrl-q\fR
بازمی‌گردد.
.IP \(bu 2
ویژگی
\fBimagesFormat\fR
قالب پیش‌فرض را برای خروجی
\fBdocker images\fR
مشخص می‌کند. هنگامی که فلگ
\fB--format\fR
همراه با دستور
\fBdocker images\fR
ارائه نشود، کلاینت Docker از این ویژگی استفاده می‌کند. اگر این ویژگی تنظیم نشده باشد، کلاینت به قالب جدول پیش‌فرض بازمی‌گردد. برای مشاهده فهرستی از دستورالعمل‌های قالب‌بندی پشتیبانی‌شده،
\fBdocker-images(1)\fP
را ببینید.

.PP
می‌توانید با استفاده از متغیر محیطی
\fBDOCKER_CONFIG\fR
یا گزینه خط فرمان
\fB--config\fR
مکان دیگری را برای فایل‌های پیکربندی مشخص کنید. اگر هر دو مشخص شده باشند، گزینه
\fB--config\fR
بر متغیر محیطی
\fBDOCKER_CONFIG\fR
اولویت دارد:

.EX
docker --config ~/testconfigs/ ps
.EE

.PP
این دستور به Docker راهنمایی می‌کند که هنگام اجرای دستور
\fBps\fR
از فایل‌های پیکربندی موجود در دایرکتوری
\fB~/testconfigs/\fR
استفاده کند.

.SH "مثال‌ها (EXAMPLES)"
نمونه‌ای از یک فایل
\fBconfig.json\fR
در ادامه آمده است:

.EX
{
  "HttpHeaders": {
    "MyHeader": "MyValue"
  },
  "psFormat": "table {{.ID}}\\\\t{{.Image}}\\\\t{{.Command}}\\\\t{{.Labels}}",
  "imagesFormat": "table {{.ID}}\\\\t{{.Repository}}\\\\t{{.Tag}}\\\\t{{.CreatedAt}}",
  "detachKeys": "ctrl-e,e"
}
.EE


.SH "تاریخچه (HISTORY)"
ژانویه ۲۰۱۶، ایجاد شده توسط Moxiegirl mary@docker.com
\[la]mailto:mary@docker.com\[ra]