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

.SH "نام (NAME)"
kubectl-label \- به‌روزرسانی برچسب‌ها (labels) روی یک منبع


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


.SH "توضیحات (DESCRIPTION)"
به‌روزرسانی برچسب‌ها (labels) روی یک منبع.
.IP \(bu 2
کلید و مقدار برچسب باید با یک حرف یا عدد شروع شوند و می‌توانند شامل حروف، اعداد، خط پیوند (hyphen)، نقطه و زیرخط (underscore) تا حداکثر ۶۳ کاراکتر باشند.
.IP \(bu 2
به صورت اختیاری، کلید می‌تواند با یک پیشوند زیردامنه DNS و یک کاراکتر '/' آغاز شود، مانند example.com/my-app.
.IP \(bu 2
اگر \fB\-\-overwrite\fP برابر با true باشد، برچسب‌های موجود می‌توانند رونویسی شوند، در غیر این صورت تلاش برای رونویسی یک برچسب منجر به خطا خواهد شد.
.IP \(bu 2
اگر \fB\-\-resource\-version\fP مشخص شده باشد، به‌روزرسانی‌ها از این نسخه منبع استفاده خواهند کرد، در غیر این صورت از نسخه کنونی منبع استفاده خواهد شد.


.SH "گزینه‌ها (OPTIONS)"
\fB--all\fP=false
	انتخاب تمام منابع در namespace مربوط به انواع منابع مشخص‌شده.

.PP
\fB-A\fP, \fB--all-namespaces\fP=false
	در صورت true بودن، بررسی عمل مشخص‌شده در تمام namespaceها.

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

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

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

.PP
\fB--field-selector\fP=""
	انتخاب‌گر (پرس‌وجوی فیلد) برای فیلتر کردن، از '='، '==' و '!=' پشتیبانی می‌کند (مانند ‎--field-selector key1=value1,key2=value2‎). سرور فقط از تعداد محدودی پرس‌وجوی فیلد به ازای هر نوع پشتیبانی می‌کند.

.PP
\fB-f\fP, \fB--filename\fP=[]
	نام فایل، دایرکتوری یا نشانی URL فایل‌هایی که منبع را برای به‌روزرسانی برچسب‌ها مشخص می‌کنند.

.PP
\fB-k\fP, \fB--kustomize\fP=""
	پردازش دایرکتوری kustomization. این فلگ نمی‌تواند همراه با \fB\-f\fP یا \fB\-R\fP استفاده شود.

.PP
\fB--list\fP=false
	در صورت true بودن، نمایش برچسب‌های مربوط به یک منبع مشخص.

.PP
\fB--local\fP=false
	در صورت true بودن، برچسب‌گذاری با api-server ارتباط برقرار نخواهد کرد بلکه به صورت محلی اجرا می‌شود.

.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--record\fP=false
	ثبت دستور فعلی kubectl در حاشیه‌نویسی منبع. در صورت تنظیم روی false، دستور ثبت نمی‌شود. در صورت تنظیم روی true، دستور ثبت می‌شود. در صورت عدم تنظیم، به طور پیش‌فرض مقدار حاشیه‌نویسی موجود تنها در صورتی به‌روزرسانی می‌شود که از قبل وجود داشته باشد.

.PP
\fB-R\fP, \fB--recursive\fP=false
	پردازش بازگشتی دایرکتوری استفاده‌شده در \fB\-f\fP، \fB\-\-filename\fP. زمانی کاربرد دارد که می‌خواهید مانیفست‌های مرتبط سازمان‌یافته در یک دایرکتوری یکسان را مدیریت کنید.

.PP
\fB--resource-version\fP=""
	در صورت خالی نبودن، به‌روزرسانی برچسب‌ها تنها زمانی موفق خواهد شد که این مقدار برابر با resource-version کنونی شیء باشد. فقط هنگام مشخص کردن یک منبع واحد معتبر است.

.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=""
	رشته الگو یا مسیر فایل الگو برای استفاده در زمان \fB\-o=go\-template\fP یا \fB\-o=go\-template\-file\fP. فرمت الگو از نوع الگوهای golang است [http://golang.org/pkg/text/template/#pkg-overview].


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

.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=""
	نام سرور برای اعتبارسنجی گواهی سرور. در صورت عدم ارائه، از hostname استفاده‌شده برای برقراری ارتباط با سرور استفاده می‌شود

.PP
\fB--token\fP=""
	توکن Bearer برای احراز هویت در سرور 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 "مثال‌ها (EXAMPLES)"
.EX
  # به‌روزرسانی پاد 'foo' با برچسب 'unhealthy' و مقدار 'true'
  kubectl label pods foo unhealthy=true

  # به‌روزرسانی پاد 'foo' با برچسب 'status' و مقدار 'unhealthy'، با رونویسی هر مقدار موجود
  kubectl label --overwrite pods foo status=unhealthy

  # به‌روزرسانی تمام پادها در namespace
  kubectl label pods --all status=unhealthy

  # به‌روزرسانی یک پاد شناسایی‌شده با نوع و نام در "pod.json"
  kubectl label -f pod.json status=unhealthy

  # به‌روزرسانی پاد 'foo' تنها در صورتی که منبع نسبت به نسخه 1 تغییر نکرده باشد
  kubectl label pods foo status=unhealthy --resource-version=1

  # به‌روزرسانی پاد 'foo' با حذف یک برچسب به نام 'bar' در صورت وجود
  # نیازی به فلگ --overwrite ندارد
  kubectl label pods foo bar-
.EE


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


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