KUBERNETES(1) راهنمای کاربر kubernetes KUBERNETES(1)

kubectl-plugin - فراهم کردن ابزارهایی برای تعامل با افزونه‌ها

kubectl plugin [OPTIONS]

ابزارهایی را برای تعامل با افزونه‌ها فراهم می‌کند.

افزونه‌ها قابلیت‌های گسترش‌یافته‌ای را ارائه می‌دهند که بخشی از توزیع اصلی خط فرمان نیست. لطفاً برای کسب اطلاعات بیشتر درباره نحوه نوشتن افزونه‌های اختصاصی خود، به مستندات و مثال‌ها مراجعه کنید.

ساده‌ترین راه برای کشف و نصب افزونه‌ها، از طریق زیرپروژه کوبرنتیز krew است: [krew.sigs.k8s.io]. برای نصب krew، به نشانی https://krew.sigs.k8s.io/docs/user-guide/setup/install مراجعه کنید

--as="" نام کاربری برای جعل هویت در این عملیات. کاربر می‌تواند یک کاربر معمولی یا یک حساب خدمت (service account) در یک namespace باشد.

--as-group=[] گروه برای جعل هویت در این عملیات؛ این فلگ می‌تواند برای تعیین چندین گروه تکرار شود.

--as-uid="" شناسه UID برای جعل هویت در این عملیات.

--as-user-extra=[] اطلاعات تکمیلی کاربر برای جعل هویت در این عملیات؛ این فلگ می‌تواند برای تعیین چندین مقدار برای یک کلید یکسان تکرار شود.

--cache-dir="/home/username/.kube/cache" دایرکتوری پیش‌فرض کش

--certificate-authority="" مسیر فایل گواهی برای مرجع صدور گواهی (certificate authority)

--client-certificate="" مسیر فایل گواهی کلاینت برای TLS

--client-key="" مسیر فایل کلید کلاینت برای TLS

--cluster="" نام کلاستر kubeconfig برای استفاده

--context="" نام کانتکست kubeconfig برای استفاده

--disable-compression=false در صورت true بودن، انصراف از فشرده‌سازی پاسخ‌ها برای تمامی درخواست‌ها به سرور

--insecure-skip-tls-verify=false در صورت true بودن، اعتبار گواهی سرور بررسی نخواهد شد. این کار اتصالات HTTPS شما را ناامن می‌کند

--kubeconfig="" مسیر فایل kubeconfig برای استفاده در درخواست‌های CLI.

--kuberc="" مسیر فایل kuberc برای استفاده در تنظیمات برگزیده. این قابلیت می‌تواند با export کردن ویژگی KUBECTL_KUBERC=false یا خاموش کردن ویژگی با KUBERC=off غیرفعال شود.

--match-server-version=false الزام به تطابق نسخه سرور با نسخه کلاینت

-n, --namespace="" در صورت وجود، حوزه namespace برای این درخواست CLI

--password="" رمز عبور برای احراز هویت پایه در سرور API

--profile="none" نام پروفایل برای ثبت. یکی از (none|cpu|heap|goroutine|threadcreate|block|mutex|trace)

--profile-output="profile.pprof" نام فایلی که پروفایل در آن نوشته می‌شود

--request-timeout="0" مدت زمان انتظار پیش از انصراف از یک درخواست واحد به سرور. مقادیر غیر صفر باید شامل یک واحد زمانی متناظر باشند (مانند 1s، 2m، 3h). مقدار صفر یعنی درخواست‌ها هیچ‌گاه با وقفه زمانی (timeout) مواجه نشوند.

-s, --server="" آدرس و پورت سرور Kubernetes API

--tls-server-name="" نام سرور برای اعتبارسنجی گواهی سرور. در صورت عدم ارائه، از نام هاست استفاده‌شده برای اتصال به سرور استفاده می‌شود

--token="" توکن Bearer برای احراز هویت در سرور API

--user="" نام کاربر kubeconfig برای استفاده

--username="" نام کاربری برای احراز هویت پایه در سرور API

--version=false گزینه --version یا --version=raw اطلاعات نسخه را چاپ کرده و خارج می‌شود؛ --version=vX.Y.Z... نسخه گزارش‌شده را تنظیم می‌کند

--warnings-as-errors=false در نظر گرفتن هشدارهای دریافتی از سرور به عنوان خطا و خروج با کد وضعیت غیر صفر

# فهرست کردن تمام افزونه‌های موجود
kubectl plugin list
# فقط فهرست کردن نام باینری افزونه‌های موجود بدون مسیرها
kubectl plugin list --name-only

kubectl(1), kubectl-plugin-list(1)

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

Jan 2015 Eric Paris