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

.SH "نام (NAME)"
kubectl-port-forward \- فوروارد کردن یک یا چند پورت محلی به یک پاد


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


.SH "توضیحات (DESCRIPTION)"
فوروارد کردن یک یا چند پورت محلی به یک پاد.

.PP
برای انتخاب پاد، از نوع/نام منبع مانند deployment/mydeployment استفاده کنید. در صورت حذف، نوع منبع به صورت پیش‌فرض 'pod' در نظر گرفته می‌شود.

.PP
اگر چندین پاد با معیارها مطابقت داشته باشند، یک پاد به طور خودکار انتخاب خواهد شد. نشست فوروارد کردن با پایان یافتن پاد انتخابی خاتمه می‌یابد و برای از سرگیری فوروارد، نیاز به اجرای مجدد دستور است.


.SH "گزینه‌ها (OPTIONS)"
\fB--address\fP=[localhost]
	آدرس‌هایی برای شنود (جداشده با کاما). تنها آدرس‌های IP یا localhost را به عنوان مقدار می‌پذیرد. هنگامی که localhost مشخص شود، kubectl تلاش خواهد کرد تا هم به 127.0.0.1 و هم به ::1 متصل (bind) شود و در صورتی که هیچ‌یک از این آدرس‌ها برای اتصال در دسترس نباشند با شکست مواجه می‌شود.

.PP
\fB--pod-running-timeout\fP=1m0s
	مدت زمان انتظار (مانند 5s، 2m یا 3h، بزرگ‌تر از صفر) تا زمانی که دست‌کم یک پاد در حال اجرا باشد


.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=[]
	اطلاعات تکمیلی کاربر (user extras) برای جعل هویت در این عملیات؛ این گزینه می‌تواند برای مشخص کردن چندین مقدار برای یک کلید یکسان تکرار شود.

.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
  # شنود روی پورت‌های 5000 و 6000 به صورت محلی، فوروارد داده‌ها به/از پورت‌های 5000 و 6000 در پاد
  kubectl port-forward pod/mypod 5000 6000
  
  # شنود روی پورت‌های 5000 و 6000 محلی، فوروارد داده به/از پورت‌های 5000 و 6000 در پاد انتخاب‌شده توسط استقرار (deployment)
  kubectl port-forward deployment/mydeployment 5000 6000
  
  # شنود روی پورت 8443 محلی، فوروارد به targetPort پورت با نام "https" از سرویس در پاد انتخاب‌شده توسط سرویس
  kubectl port-forward service/myservice 8443:https
  
  # شنود روی پورت 8888 محلی، فوروارد به 5000 در پاد
  kubectl port-forward pod/mypod 8888:5000
  
  # شنود روی پورت 8888 روی همه آدرس‌ها، فوروارد به 5000 در پاد
  kubectl port-forward --address 0.0.0.0 pod/mypod 8888:5000
  
  # شنود روی پورت 8888 روی localhost و IP انتخابی، فوروارد به 5000 در پاد
  kubectl port-forward --address localhost,10.19.21.23 pod/mypod 8888:5000
  
  # شنود روی یک پورت تصادفی محلی، فوروارد به 5000 در پاد
  kubectl port-forward pod/mypod :5000
.EE


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


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