.nh
.TH KUBERNETES 1 "Jan 2015" "Eric Paris" "راهنمای کاربر kubernetes"

.SH "نام (NAME)"
kubectl-config \- ویرایش و تغییر فایل‌های kubeconfig


.SH "خلاصه دستور (SYNOPSIS)"
\fBkubectl config\fP [OPTIONS]


.SH "توضیحات (DESCRIPTION)"
فایل‌های kubeconfig را با استفاده از زیردستورهایی مانند «kubectl config set current-context my-context» ویرایش می‌کند.

.PP
ترتیب بارگذاری از این قوانین پیروی می‌کند:
.IP "  1." 5
اگر فلگ \fB\-\-kubeconfig\fP تنظیم شده باشد، فقط همان فایل بارگذاری می‌شود. این فلگ فقط یک‌بار می‌تواند تنظیم شود و هیچ ادغامی صورت نمی‌گیرد.
.IP "  2." 5
اگر متغیر محیطی $KUBECONFIG تنظیم شده باشد، به عنوان فهرستی از مسیرها (مطابق با قوانین معمول جداسازی مسیرها در سیستم شما) استفاده می‌شود. این مسیرها با یکدیگر ادغام می‌شوند. هنگامی که مقداری تغییر داده می‌شود، در فایلی که آن بخش (stanza) را تعریف کرده تغییر می‌یابد. هنگامی که مقداری ایجاد می‌شود، در نخستین فایل موجود ایجاد می‌گردد. اگر هیچ فایلی در زنجیره وجود نداشته باشد، آخرین فایل در فهرست ایجاد می‌شود.
.IP "  3." 5
در غیر این صورت، از مسیر ${HOME}/.kube/config استفاده می‌شود و هیچ ادغامی صورت نمی‌گیرد.


.SH "گزینه‌ها (OPTIONS)"
\fB--kubeconfig\fP=""
	استفاده از یک فایل خاص kubeconfig


.SH "گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
\fB--as\fP=""
	نام کاربری برای جعل هویت (impersonate) در این عملیات. کاربر می‌تواند یک کاربر معمولی یا یک حساب خدمت (service account) در یک فضای نام باشد.

.PP
\fB--as-group\fP=[]
	گروه برای جعل هویت در این عملیات؛ این فلگ می‌تواند برای تعیین چندین گروه تکرار شود.

.PP
\fB--as-uid\fP=""
	شناسه UID برای جعل هویت در این عملیات.

.PP
\fB--as-user-extra\fP=[]
	اطلاعات اضافی کاربر برای جعل هویت در این عملیات؛ این فلگ می‌تواند برای مشخص کردن چندین مقدار برای یک کلید یکسان تکرار شود.

.PP
\fB--cache-dir\fP="/home/username/.kube/cache"
	دایرکتوری پیش‌فرض کش

.PP
\fB--certificate-authority\fP=""
	مسیر فایل گواهی برای مرجع صدور گواهی (certificate authority)

.PP
\fB--client-certificate\fP=""
	مسیر فایل گواهی کلاینت برای TLS

.PP
\fB--client-key\fP=""
	مسیر فایل کلید کلاینت برای TLS

.PP
\fB--cluster\fP=""
	نام کلاستر kubeconfig برای استفاده

.PP
\fB--context\fP=""
	نام کانتکست kubeconfig برای استفاده

.PP
\fB--disable-compression\fP=false
	در صورت true بودن، انصراف از فشرده‌سازی پاسخ‌ها برای تمام درخواست‌ها به سرور

.PP
\fB--insecure-skip-tls-verify\fP=false
	در صورت true بودن، اعتبار گواهی سرور بررسی نخواهد شد. این کار اتصالات HTTPS شما را ناامن می‌کند

.PP
\fB--kuberc\fP=""
	مسیر فایل kuberc برای استفاده در ترجیحات (preferences). این قابلیت می‌تواند با export کردن feature gate به صورت KUBECTL_KUBERC=false یا خاموش کردن ویژگی با KUBERC=off غیرفعال شود.

.PP
\fB--match-server-version\fP=false
	الزام به تطابق نسخه سرور با نسخه کلاینت

.PP
\fB-n\fP, \fB--namespace\fP=""
	در صورت وجود، دامنهٔ فضای نام (namespace) برای این درخواست CLI

.PP
\fB--password\fP=""
	رمز عبور برای احراز هویت پایه (basic authentication) در سرور API

.PP
\fB--profile\fP="none"
	نام پروفایل برای ثبت. یکی از موارد (none|cpu|heap|goroutine|threadcreate|block|mutex|trace)

.PP
\fB--profile-output\fP="profile.pprof"
	نام فایلی که پروفایل در آن نوشته می‌شود

.PP
\fB--request-timeout\fP="0"
	مدت زمان انتظار پیش از انصراف از یک درخواست به سرور. مقادیر غیر صفر باید شامل واحد زمانی متناظر باشند (مانند 1s، 2m، 3h). مقدار صفر یعنی درخواست‌ها هرگز دچار وقفه زمانی (timeout) نشوند.

.PP
\fB-s\fP, \fB--server\fP=""
	آدرس و پورت سرور Kubernetes API

.PP
\fB--tls-server-name\fP=""
	نام سرور برای استفاده در اعتبارسنجی گواهی سرور. در صورت عدم ارائه، از نام هاست مورد استفاده برای برقراری ارتباط با سرور استفاده می‌شود

.PP
\fB--token\fP=""
	توکن حامل (Bearer token) برای احراز هویت در سرور API

.PP
\fB--user\fP=""
	نام کاربر kubeconfig برای استفاده

.PP
\fB--username\fP=""
	نام کاربری برای احراز هویت پایه در سرور API

.PP
\fB--version\fP=false
	گزینه \fB\-\-version\fP یا \fB\-\-version=raw\fP اطلاعات نسخه را چاپ کرده و خارج می‌شود؛ \fB\-\-version=vX.Y.Z...\fP نسخه گزارش‌شده را تنظیم می‌کند

.PP
\fB--warnings-as-errors\fP=false
	در نظر گرفتن هشدارهای دریافتی از سرور به عنوان خطا و خروج با کد وضعیت غیر صفر


.SH "همچنین ببینید (SEE ALSO)"
\fBkubectl(1)\fP, \fBkubectl-config-current-context(1)\fP, \fBkubectl-config-delete-cluster(1)\fP, \fBkubectl-config-delete-context(1)\fP, \fBkubectl-config-delete-user(1)\fP, \fBkubectl-config-get-clusters(1)\fP, \fBkubectl-config-get-contexts(1)\fP, \fBkubectl-config-get-users(1)\fP, \fBkubectl-config-rename-context(1)\fP, \fBkubectl-config-set(1)\fP, \fBkubectl-config-set-cluster(1)\fP, \fBkubectl-config-set-context(1)\fP, \fBkubectl-config-set-credentials(1)\fP, \fBkubectl-config-unset(1)\fP, \fBkubectl-config-use-context(1)\fP, \fBkubectl-config-view(1)\fP,


.SH "تاریخچه (HISTORY)"
ژانویه ۲۰۱۵، در ابتدا توسط Eric Paris (eparis at redhat dot com) بر پایه محتوای منبع kubernetes گردآوری شد، اما امید است که از آن زمان به بعد به طور خودکار تولید شده باشند!