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

.SH "نام (NAME)"
kubectl-taint \- به‌روزرسانی تینت‌ها روی یک یا چند گره


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


.SH "توضیحات (DESCRIPTION)"
به‌روزرسانی تینت‌ها (taints) روی یک یا چند گره.
.IP \(bu 2
یک تینت از یک کلید (key)، یک مقدار (value) و یک اثر (effect) تشکیل شده است. به عنوان یک آرگومان در اینجا، به صورت key=value:effect بیان می‌شود.
.IP \(bu 2
کلید باید با یک حرف یا عدد شروع شود و می‌تواند شامل حروف، اعداد، خط تیره، نقطه و زیرخط تا ۲۵۳ کاراکتر باشد.
.IP \(bu 2
به صورت اختیاری، کلید می‌تواند با یک پیشوند زیردامنهٔ DNS و یک '/' تکی آغاز شود، مانند example.com/my-app.
.IP \(bu 2
مقدار اختیاری است. در صورت ارائه، باید با یک حرف یا عدد شروع شود و می‌تواند شامل حروف، اعداد، خط تیره، نقطه و زیرخط تا ۶۳ کاراکتر باشد.
.IP \(bu 2
اثر (effect) باید NoSchedule، PreferNoSchedule یا NoExecute باشد.
.IP \(bu 2
در حال حاضر تینت فقط می‌تواند روی گره (node) اعمال شود.


.SH "گزینه‌ها (OPTIONS)"
\fB--all\fP=false
	انتخاب تمام گره‌ها در کلاستر

.PP
\fB--allow-missing-template-keys\fP=true
	در صورت true بودن، هرگونه خطای قالب در هنگام مفقود بودن یک فیلد یا کلید مپ در قالب نادیده گرفته می‌شود. تنها برای فرمت‌های خروجی golang و jsonpath اعمال می‌شود.

.PP
\fB--dry-run\fP="none"
	باید یکی از مقادیر "none"، "server" یا "client" باشد. اگر راهبرد client باشد، فقط شیئی را که ارسال خواهد شد چاپ می‌کند بدون اینکه آن را بفرستد. اگر راهبرد server باشد، درخواست سمت سرور را بدون پایدارسازی منبع ارسال می‌کند.

.PP
\fB--field-manager\fP="kubectl-taint"
	نام مدیر استفاده‌شده برای ردیابی مالکیت فیلد.

.PP
\fB-o\fP, \fB--output\fP=""
	فرمت خروجی. یکی از موارد: (json, yaml, kyaml, name, go-template, go-template-file, template, templatefile, jsonpath, jsonpath-as-json, jsonpath-file).

.PP
\fB--overwrite\fP=false
	در صورت true بودن، اجازه بازنویسی تینت‌ها داده می‌شود، در غیر این صورت به‌روزرسانی‌هایی که تینت‌های موجود را بازنویسی کنند رد می‌شوند.

.PP
\fB-l\fP, \fB--selector\fP=""
	انتخاب‌گر (پرس‌وجوی برچسب) برای فیلتر کردن، از '='، '=='، '!='، 'in' و 'notin' پشتیبانی می‌کند (مانند ‎-l key1=value1,key2=value2,key3 in (value3)‎). اشیاء منطبق باید تمام قیود برچسب مشخص‌شده را برآورده کنند.

.PP
\fB--show-managed-fields\fP=false
	در صورت true بودن، فیلدهای مدیریت‌شده (managedFields) هنگام چاپ اشیاء در قالب JSON یا YAML حفظ می‌شوند.

.PP
\fB--template\fP=""
	رشته قالب یا مسیر فایل قالب برای استفاده در هنگامی که -o=go-template یا -o=go-template-file است. فرمت قالب، قالب‌های گولنگ است [http://golang.org/pkg/text/template/#pkg-overview].

.PP
\fB--validate\fP="strict"
	باید یکی از موارد strict (یا true)، warn، ignore (یا false) باشد. مقدار "true" یا "strict" از یک طرح‌واره برای اعتبارسنجی ورودی استفاده کرده و در صورت نامعتبر بودن، درخواست را با خطا مواجه می‌کند. اگر ServerSideFieldValidation روی api-server فعال باشد اعتبارسنجی سمت سرور را انجام می‌دهد، اما در غیر این صورت به اعتبارسنجی کلاینت با قابلیت اطمینان کمتر بازمی‌گردد. مقدار "warn" درباره فیلدهای ناشناخته یا تکراری بدون مسدود کردن درخواست هشدار می‌دهد (در صورتی که اعتبارسنجی فیلد سمت سرور روی سرور API فعال باشد)، و در غیر این صورت مانند "ignore" رفتار می‌کند. مقدار "false" یا "ignore" هیچ اعتبارسنجی طرح‌واره‌ای انجام نمی‌دهد و فیلدهای ناشناخته یا تکراری را بدون خطا نادیده می‌گیرد.


.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--kubeconfig\fP=""
	مسیر فایل kubeconfig برای استفاده در درخواست‌های CLI.

.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 "مثال (EXAMPLE)"
.EX
  # به‌روزرسانی گره 'foo' با تینتی با کلید 'dedicated' و مقدار 'special-user' و اثر 'NoSchedule'
  # در صورتی که تینتی با آن کلید و اثر وجود داشته باشد، مقدار آن طبق موارد مشخص‌شده جایگزین می‌شود
  kubectl taint nodes foo dedicated=special-user:NoSchedule
  
  # حذف تینت با کلید 'dedicated' و اثر 'NoSchedule' از گره 'foo' در صورت وجود
  kubectl taint nodes foo dedicated:NoSchedule-
  
  # حذف تمام تینت‌ها با کلید 'dedicated' از گره 'foo'
  kubectl taint nodes foo dedicated-
  
  # افزودن تینت با کلید 'dedicated' روی گره‌های دارای برچسب myLabel=X
  kubectl taint node -l myLabel=X  dedicated=foo:PreferNoSchedule
  
  # افزودن یک تینت با کلید 'bar' و بدون مقدار به گره 'foo'
  kubectl taint nodes foo bar:NoSchedule
.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBkubectl(1)\fP


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