نام (NAME)

HOME/.docker/config.json - فایل پیکربندی پیش‌فرض Docker

مقدمه (INTRODUCTION)

به‌طور پیش‌فرض، خط فرمان Docker فایل‌های پیکربندی خود را در دایرکتوری‌ای به نام .docker درون دایرکتوری $HOME شما ذخیره می‌کند. Docker بیشتر فایل‌های موجود در دایرکتوری پیکربندی را مدیریت می‌کند و نباید آن‌ها را تغییر دهید. با این حال، می‌توانید فایل config.json را تغییر دهید تا جنبه‌های خاصی از نحوه رفتار دستور docker را کنترل کنید.

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

فایل config.json کدگذاری JSON چندین ویژگی را ذخیره می‌کند:

• ویژگی HttpHeaders مجموعه‌ای از هدرها را برای گنجاندن در تمام پیام‌های ارسالی از کلاینت Docker به دیمن مشخص می‌کند. Docker تلاشی برای تفسیر یا درک این هدرها نمی‌کند؛ صرفاً آن‌ها را در پیام‌ها قرار می‌دهد. Docker اجازه نمی‌دهد این هدرها هیچ‌یک از هدرهایی را که خود تعیین کرده است تغییر دهند.
• ویژگی psFormat قالب پیش‌فرض را برای خروجی docker ps مشخص می‌کند. هنگامی که فلگ --format همراه با دستور docker ps ارائه نشود، کلاینت Docker از این ویژگی استفاده می‌کند. اگر این ویژگی تنظیم نشده باشد، کلاینت به قالب جدول پیش‌فرض بازمی‌گردد. برای مشاهده فهرستی از دستورالعمل‌های قالب‌بندی پشتیبانی‌شده، docker-ps(1) را ببینید.
• ویژگی detachKeys توالی کلید پیش‌فرضی را که کانتینر را جدا می‌کند مشخص می‌کند. هنگامی که فلگ --detach-keys همراه با دستورات docker attach، docker exec، docker run یا docker start ارائه نشود، کلاینت Docker از این ویژگی استفاده می‌کند. اگر این ویژگی تنظیم نشده باشد، کلاینت به توالی پیش‌فرض ctrl-p,ctrl-q بازمی‌گردد.
• ویژگی imagesFormat قالب پیش‌فرض را برای خروجی docker images مشخص می‌کند. هنگامی که فلگ --format همراه با دستور docker images ارائه نشود، کلاینت Docker از این ویژگی استفاده می‌کند. اگر این ویژگی تنظیم نشده باشد، کلاینت به قالب جدول پیش‌فرض بازمی‌گردد. برای مشاهده فهرستی از دستورالعمل‌های قالب‌بندی پشتیبانی‌شده، docker-images(1) را ببینید.

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

docker --config ~/testconfigs/ ps

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

مثال‌ها (EXAMPLES)

نمونه‌ای از یک فایل config.json در ادامه آمده است:

{
  "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"
}

تاریخچه (HISTORY)

ژانویه ۲۰۱۶، ایجاد شده توسط Moxiegirl mary@docker.com ⟨mailto:mary@docker.com⟩