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

kubectl-kuberc-set - تنظیم مقادیر در پیکربندی kuberc

kubectl kuberc set [OPTIONS]

تنظیم مقادیر در فایل پیکربندی kuberc.

برای مشخص کردن تنظیم مقادیر پیش‌فرض (defaults) یا نام‌های مستعار (aliases)، از --section استفاده کنید.

برای مقادیر پیش‌فرض (defaults): مقادیر پیش‌فرض فلگ‌ها را برای دستورات kubectl تنظیم می‌کند. فلگ --command فقط باید دستور را مشخص کند (مانند "get"، "create"، "set env")، نه منابع را.

برای نام‌های مستعار (aliases): نام‌های مستعار دستورات را با مقادیر پیش‌فرض فلگ‌ها و آرگومان‌های اختیاری ایجاد می‌کند. برای گنجاندن منابع یا آرگومان‌های دیگر از --prependarg و --appendarg استفاده کنید.

--allowlist-entry=[] مدخل فهرست مجاز (allowlist) به قالب field=value (می‌تواند چندین بار مشخص شود)

--appendarg=[] آرگومان برای الحاق به انتهای دستور (می‌تواند چندین بار مشخص شود، فقط برای نام‌های مستعار)

--command="" دستور جهت پیکربندی (مانند 'get'، 'create'، 'set env')

--kuberc="" مسیر فایل kuberc برای استفاده در ترجیحات (preferences). این قابلیت می‌تواند با export کردن feature gate به صورت KUBECTL_KUBERC=false یا خاموش کردن ویژگی با KUBERC=off غیرفعال شود.

--name="" نام مستعار (برای --section=aliases الزامی است)

--option=[] گزینه فلگ به قالب flag=value (می‌تواند چندین بار مشخص شود)

--overwrite=false مجاز بودن بازنویسی مدخل‌های موجود

--policy="" خط‌مشی افزونه برای استفاده در پلاگین‌های اعتبارسنجی اجرایی (exec credential plugins)؛ باید یکی از 'AllowAll'، 'DenyAll' یا 'Allowlist' باشد

--prependarg=[] آرگومان برای درج در ابتدای دستور (می‌تواند چندین بار مشخص شود، فقط برای نام‌های مستعار)

--section="" بخش مورد نظر برای ویرایش: 'defaults'، 'aliases' یا 'credentialplugin'

--as="" نام کاربری برای جعل هویت (impersonate) در این عملیات. کاربر می‌تواند یک کاربر معمولی یا یک حساب خدمت (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.

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

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

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

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

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

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

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

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

# تنظیم قالب خروجی پیش‌فرض برای دستور 'get'
kubectl kuberc set --section defaults --command get --option output=wide
# تنظیم قالب خروجی پیش‌فرض برای یک زیردستور
kubectl kuberc set --section defaults --command "set env" --option output=yaml
# ایجاد نام مستعار 'getn' برای دستور 'get' همراه با درج منبع 'nodes' در ابتدا
kubectl kuberc set --section aliases --name getn --command get --prependarg nodes --option output=wide
# ایجاد نام مستعار 'runx' برای دستور 'run' همراه با الحاق آرگومان‌ها به انتها
kubectl kuberc set --section aliases --name runx --command run --option image=nginx --appendarg "--" --appendarg custom-arg1
# بازنویسی یک مقدار پیش‌فرض موجود
kubectl kuberc set --section defaults --command get --option output=json --overwrite
# تنظیم خط‌مشی و فهرست مجاز افزونه اعتبارنامه
kubectl kuberc set --section credentialplugin --policy Allowlist --allowlist-entry command=cloud-credential-helper

kubectl-kuberc(1)

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

Jan 2015 Eric Paris