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

.SH "نام (NAME)"
kubectl-create-token \- درخواست یک توکن حساب خدمت (service account)


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


.SH "توضیحات (DESCRIPTION)"
درخواست یک توکن حساب خدمت (service account).


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

.PP
\fB--audience\fP=[]
	مخاطب (audience) توکن درخواست‌شده. در صورت عدم تنظیم، به طور پیش‌فرض توکنی برای استفاده با سرور Kubernetes API درخواست می‌شود. این گزینه می‌تواند برای درخواست توکنی که برای چندین مخاطب معتبر باشد تکرار شود.

.PP
\fB--bound-object-kind\fP=""
	نوع (Kind) شیئی که توکن به آن مقید (bind) می‌شود. نوع‌های پشتیبانی‌شده عبارتند از Node، Pod و Secret. در صورت تنظیم، گزینه \fB\-\-bound\-object\-name\fP نیز باید ارائه شود.

.PP
\fB--bound-object-name\fP=""
	نام شیئی که توکن به آن مقید می‌شود. با حذف شیء، اعتبار توکن منقضی خواهد شد. نیازمند \fB\-\-bound\-object\-kind\fP است.

.PP
\fB--bound-object-uid\fP=""
	شناسه یکتای (UID) شیئی که توکن به آن مقید می‌شود. نیازمند \fB\-\-bound\-object\-kind\fP و \fB\-\-bound\-object\-name\fP است. در صورت عدم تنظیم، از UID شیء موجود استفاده می‌شود.

.PP
\fB--duration\fP=0s
	مدت‌زمان اعتبار درخواست‌شده برای توکن صادرشده. در صورت عدم تنظیم یا تنظیم روی 0، طول عمر توکن به طور خودکار توسط سرور تعیین خواهد شد. سرور ممکن است توکنی با طول عمر طولانی‌تر یا کوتاه‌تر بازگرداند.

.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--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
  # درخواست یک توکن جهت احراز هویت در kube-apiserver به عنوان حساب خدمت "myapp" در namespace جاری
  kubectl create token myapp

  # درخواست توکن برای یک حساب خدمت در یک namespace سفارشی
  kubectl create token myapp --namespace myns

  # درخواست توکن با مدت انقضای سفارشی
  kubectl create token myapp --duration 10m

  # درخواست توکن با مخاطب (audience) سفارشی
  kubectl create token myapp --audience https://example.com

  # درخواست توکن مقیدشده به نمونه‌ای از یک شیء Secret
  kubectl create token myapp --bound-object-kind Secret --bound-object-name mysecret

  # درخواست توکن مقیدشده به نمونه‌ای از یک شیء Secret با UID مشخص
  kubectl create token myapp --bound-object-kind Secret --bound-object-name mysecret --bound-object-uid 0d4691ed-659b-4935-a832-355f77ee47cc
.EE


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


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