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

kubectl-auth-reconcile - تطبیق قوانین برای اشیاء role، role binding، cluster role و cluster role binding در RBAC

kubectl auth reconcile [OPTIONS]

قوانین مربوط به اشیاء نقش (role)، انتساب نقش (role binding)، نقش کلاستر (cluster role) و انتساب نقش کلاستر (cluster role binding) در سامانه کنترل دسترسی بر مبنای نقش (RBAC) را تطبیق و هماهنگ می‌کند.

اشیاء ناموجود ایجاد می‌شوند، و در صورت نیاز برای اشیاء دارای دامنه فضای نام (namespaced)، فضای نام دربرگیرنده آن‌ها نیز ایجاد می‌گردد.

نقش‌های موجود به‌روزرسانی می‌شوند تا شامل مجوزهای موجود در اشیاء ورودی شوند، و در صورت تعیین گزینه --remove-extra-permissions، مجوزهای اضافی حذف می‌گردند.

انتساب‌های موجود به‌روزرسانی می‌شوند تا شامل سوژه‌ها (subjects) در اشیاء ورودی شوند، و در صورت تعیین گزینه --remove-extra-subjects، سوژه‌های اضافی حذف می‌گردند.

استفاده از این دستور نسبت به دستور 'apply' برای منابع RBAC ارجحیت دارد تا ادغام قواعد و سوژه‌ها با آگاهی از ساختار و مفاهیم معنایی (semantically-aware) انجام پذیرد.

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

--dry-run="none" باید یکی از مقادیر "none"، "server" یا "client" باشد. اگر راهبرد client باشد، تنها شیئی که ارسال خواهد شد چاپ می‌شود بدون آنکه واقعاً ارسال گردد. اگر راهبرد server باشد، درخواست به سمت سرور ارسال می‌شود بدون آنکه منبع پایدار و ماندگار شود.

-f, --filename=[] نام فایل، دایرکتوری یا نشانی URL به فایل‌هایی که منابع مورد نظر برای تطبیق را مشخص می‌کنند.

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

-o, --output="" فرمت خروجی. یکی از موارد: (json, yaml, kyaml, name, go-template, go-template-file, template, templatefile, jsonpath, jsonpath-as-json, jsonpath-file).

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

--remove-extra-permissions=false در صورت true بودن، مجوزهای اضافی اضافه‌شده به نقش‌ها (roles) را حذف می‌کند.

--remove-extra-subjects=false در صورت true بودن، سوژه‌های اضافی اضافه‌شده به rolebindingها را حذف می‌کند.

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

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

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

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

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

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

--cache-dir="/home/username/.kube/cache" دایرکتوری پیش‌فرض کش (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="" رمز عبور برای احراز هویت پایه (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 token) برای احراز هویت در سرور API

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

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

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

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

# تطبیق منابع RBAC از روی یک فایل
kubectl auth reconcile -f my-rbac-rules.yaml

kubectl-auth(1)

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

Jan 2015 Eric Paris