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

.SH "نام (NAME)"
kubectl-get \- نمایش یک یا چند منبع


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


.SH "توضیحات (DESCRIPTION)"
نمایش یک یا چند منبع.

.PP
جدولی از مهم‌ترین اطلاعات دربارهٔ منابع مشخص‌شده را چاپ می‌کند. می‌توانید با استفاده از سلکتور برچسب و فلگ --selector فهرست را فیلتر کنید. اگر نوع منبع مورد نظر دارای فضای نام (namespaced) باشد و هیچ فضای نامی را مشخص نکنید، تنها نتایج درون فضای نام فعلی را مشاهده خواهید کرد.

.PP
با مشخص کردن خروجی به عنوان 'template' و ارائه یک الگوی Go به عنوان مقدار فلگ --template، می‌توانید ویژگی‌های منابع دریافتی را فیلتر کنید.

.PP
برای مشاهده فهرست کاملی از منابع پشتیبانی‌شده از "kubectl api-resources" استفاده کنید.


.SH "گزینه‌ها (OPTIONS)"
\fB-A\fP, \fB--all-namespaces\fP=false
	در صورت وجود، شیء یا اشیاء درخواستی را در تمام فضاهای نام فهرست می‌کند. فضای نام در کانتکست فعلی نادیده گرفته می‌شود حتی اگر با --namespace مشخص شده باشد.

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

.PP
\fB--chunk-size\fP=500
	بازگرداندن فهرست‌های بزرگ به صورت تکه‌ای (chunk) به جای دریافت یک‌باره. برای غیرفعال کردن مقدار 0 را ارسال کنید.

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

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

.PP
\fB--ignore-not-found\fP=false
	در صورت تنظیم روی true، خطای NotFound برای اشیاء مشخصی که وجود ندارند نادیده گرفته می‌شود. استفاده از این فلگ همراه با دستوراتی که مجموعه‌ای از منابع را پرس‌وجو می‌کنند، در صورت پیدا نشدن منبع هیچ تاثیری ندارد.

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

.PP
\fB-L\fP, \fB--label-columns\fP=[]
	فهرستی از برچسب‌های جداشده با کاما را می‌پذیرد که به صورت ستون نمایش داده خواهند شد. نام‌ها به حروف بزرگ و کوچک حساس هستند. همچنین می‌توانید از چندین فلگ مانند -L label1 -L label2... استفاده کنید.

.PP
\fB--no-headers\fP=false
	هنگام استفاده از قالب خروجی پیش‌فرض یا ستون‌های سفارشی (custom-column)، سرصفحه‌ها چاپ نشوند (پیش‌فرض چاپ سرصفحه‌ها است).

.PP
\fB-o\fP, \fB--output\fP=""
	قالب خروجی. یکی از: (json, yaml, kyaml, name, go-template, go-template-file, template, templatefile, jsonpath, jsonpath-as-json, jsonpath-file, custom-columns, custom-columns-file, wide). به بخش ستون‌های سفارشی [https://kubernetes.io/docs/reference/kubectl/#custom-columns]، الگوی golang [http://golang.org/pkg/text/template/#pkg-overview] و الگوی jsonpath [https://kubernetes.io/docs/reference/kubectl/jsonpath] مراجعه کنید.

.PP
\fB--output-watch-events\fP=false
	خروجی دادن اشیاء رویداد پایش (watch event) هنگام استفاده از --watch یا --watch-only. اشیاء موجود به عنوان رویدادهای اولیهٔ ADDED خروجی داده می‌شوند.

.PP
\fB--raw\fP=""
	نشانی URI خام برای درخواست از سرور. از انتقال مشخص‌شده توسط فایل kubeconfig استفاده می‌کند.

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

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

.PP
\fB--server-print\fP=true
	در صورت true بودن، سرور خروجی جدول مناسب را برمی‌گرداند. از APIهای توسعه‌یافته و CRDها پشتیبانی می‌کند.

.PP
\fB--show-kind\fP=false
	در صورت وجود، نوع منبع را برای شیء یا اشیاء درخواستی فهرست می‌کند.

.PP
\fB--show-labels\fP=false
	هنگام چاپ، تمام برچسب‌ها را به عنوان آخرین ستون نمایش می‌دهد (پیش‌فرض پنهان کردن ستون برچسب‌ها است).

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

.PP
\fB--sort-by\fP=""
	در صورت غیرخالی بودن، انواع فهرست را با استفاده از مشخصات این فیلد مرتب می‌کند. مشخصات فیلد به صورت یک عبارت JSONPath بیان می‌شود (مانند '{.metadata.name}'). فیلد مشخص‌شده با این عبارت JSONPath در منبع API باید عدد صحیح یا رشته باشد.

.PP
\fB--subresource\fP=""
	در صورت مشخص شدن، زیرمنبع (subresource) شیء درخواستی را دریافت می‌کند.

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

.PP
\fB-w\fP, \fB--watch\fP=false
	پس از فهرست کردن/دریافت شیء درخواستی، تغییرات آن را پایش می‌کند (watch).

.PP
\fB--watch-only\fP=false
	پایش تغییرات شیء یا اشیاء درخواستی، بدون فهرست کردن/دریافت اولیه.


.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 "مثال (EXAMPLE)"
.EX
  # فهرست کردن تمام پادها در قالب خروجی ps
  kubectl get pods
  
  # فهرست کردن تمام پادها در قالب خروجی ps با اطلاعات بیشتر (مانند نام گره)
  kubectl get pods -o wide
  
  # فهرست کردن یک replication controller تکی با نام مشخص‌شده در قالب خروجی ps
  kubectl get replicationcontroller web
  
  # فهرست کردن استقرارها در قالب خروجی JSON، در نسخه "v1" از گروه API به نام "apps"
  kubectl get deployments.v1.apps -o json
  
  # فهرست کردن یک پاد تکی در قالب خروجی JSON
  kubectl get -o json pod web-pod-13je7
  
  # فهرست کردن یک پاد شناسایی‌شده با نوع و نام تعیین‌شده در "pod.yaml" در قالب خروجی JSON
  kubectl get -f pod.yaml -o json
  
  # فهرست کردن منابع از یک دایرکتوری حاوی kustomization.yaml - مانند dir/kustomization.yaml
  kubectl get -k dir/
  
  # بازگرداندن تنها مقدار phase از پاد مشخص‌شده
  kubectl get -o template pod/web-pod-13je7 --template={{.status.phase}}
  
  # فهرست کردن اطلاعات منبع در ستون‌های سفارشی
  kubectl get pod test-pod -o custom-columns=CONTAINER:.spec.containers[0].name,IMAGE:.spec.containers[0].image
  
  # فهرست کردن تمام کنترلرهای تکثیر و سرویس‌ها با هم در قالب خروجی ps
  kubectl get rc,services
  
  # فهرست کردن یک یا چند منبع بر اساس نوع و نام آن‌ها
  kubectl get rc/web service/frontend pods/web-pod-13je7
  
  # فهرست کردن زیرمنبع 'status' برای یک پاد تکی
  kubectl get pod web-pod-13je7 --subresource status
  
  # فهرست کردن تمام استقرارها در فضای نام 'backend'
  kubectl get deployments.apps --namespace backend
  
  # فهرست کردن تمام پادهای موجود در تمام فضاهای نام
  kubectl get pods --all-namespaces
.EE


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


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