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

kubectl-apply-set-last-applied - تنظیم یادداشت last-applied-configuration روی یک شیء زنده برای تطابق با محتویات یک فایل

kubectl apply set-last-applied [OPTIONS]

تنظیم جدیدترین یادداشت‌های last-applied-configuration از طریق تطبیق دادن آن با محتویات یک فایل. این کار باعث می‌شود last-applied-configuration به‌گونه‌ای به‌روزرسانی شود که گویی دستور 'kubectl apply -f ' اجرا شده است، بدون اینکه بخش‌های دیگر شیء به‌روزرسانی شوند.

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

--create-annotation=false اگر اشیاء فعلی فاقد یادداشت 'last-applied-configuration' باشند، آن را ایجاد می‌کند

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

-f, --filename=[] نام فایل، دایرکتوری یا نشانی اینترنتی (URL) فایل‌هایی که حاوی یادداشت‌های last-applied-configuration هستند

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

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

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

--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.

--kuberc="" مسیر فایل kuberc برای استفاده در ترجیحات (preferences). این قابلیت می‌تواند با export کردن feature gate به صورت 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 برای احراز هویت در سرور API

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

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

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

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

# تنظیم last-applied-configuration یک منبع برای تطابق با محتویات یک فایل
kubectl apply set-last-applied -f deploy.yaml
# اجرای set-last-applied برای هر فایل پیکربندی موجود در یک دایرکتوری
kubectl apply set-last-applied -f path/
# تنظیم last-applied-configuration یک منبع برای تطابق با محتویات یک فایل؛ در صورتی که یادداشت از قبل وجود نداشته باشد، آن را ایجاد می‌کند
kubectl apply set-last-applied -f deploy.yaml --create-annotation=true

kubectl-apply(1),

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

Jan 2015 Eric Paris