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

kubectl-apply-edit-last-applied - ویرایش آخرین حاشیه‌نویسی‌های last-applied-configuration یک منبع/شیء

kubectl apply edit-last-applied [OPTIONS]

ویرایش جدیدترین حاشیه‌نویسی‌های last-applied-configuration منابع از طریق ویرایشگر پیش‌فرض.

دستور edit-last-applied به شما امکان می‌دهد تا هر منبع API را که می‌توانید از طریق ابزارهای خط فرمان بازیابی کنید، مستقیماً ویرایش نمایید. این دستور ویرایشگر تعریف‌شده توسط متغیرهای محیطی KUBE_EDITOR یا EDITOR را باز می‌کند، یا در لینوکس به 'vi' و در ویندوز به 'notepad' بازمی‌گردد. شما می‌توانید چندین شیء را ویرایش کنید، هرچند تغییرات یکی‌یکی اعمال می‌شوند. این دستور نام فایل‌ها و همچنین آرگومان‌های خط فرمان را می‌پذیرد، اگرچه فایل‌هایی که به آن‌ها اشاره می‌کنید باید نسخه‌های از قبل ذخیره‌شده از منابع باشند.

فرمت پیش‌فرض YAML است. برای ویرایش در قالب JSON، مقدار -o json را مشخص کنید.

فلگ --windows-line-endings می‌تواند برای اجبار به استفاده از پایان خط‌های ویندوز (Windows line endings) به کار رود، در غیر این صورت از مقدار پیش‌فرض سیستم‌عامل شما استفاده خواهد شد.

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

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

--field-manager="kubectl-client-side-apply" نام مدیری که برای ردیابی مالکیت فیلدها استفاده می‌شود.

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

--record=false ثبت دستور فعلی kubectl در annotation منبع. اگر روی false تنظیم شود، دستور ثبت نمی‌شود. اگر روی true تنظیم شود، دستور ثبت می‌شود. اگر تنظیم نشود، به طور پیش‌فرض مقدار annotation موجود را فقط در صورتی به‌روزرسانی می‌کند که از قبل وجود داشته باشد.

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

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

--validate="strict" باید یکی از موارد strict (یا true)، warn یا ignore (یا false) باشد. مقدار "true" یا "strict" از یک اسکیما برای اعتبارسنجی ورودی استفاده کرده و در صورت نامعتبر بودن، درخواست را با شکست مواجه می‌کند. اگر ServerSideFieldValidation روی api-server فعال باشد، اعتبارسنجی سمت سرور را انجام می‌دهد، اما در غیر این صورت به اعتبارسنجی با قابلیت اطمینان کمتر در سمت کلاینت بازمی‌گردد. مقدار "warn" در صورتی که اعتبارسنجی سمت سرور روی API server فعال باشد، در مورد فیلدهای ناشناخته یا تکراری بدون مسدود کردن درخواست هشدار می‌دهد، و در غیر این صورت مانند "ignore" رفتار می‌کند. مقدار "false" یا "ignore" هیچ اعتبارسنجی اسکیمایی انجام نداده و فیلدهای ناشناخته یا تکراری را بدون اعلام نادیده می‌گیرد.

--windows-line-endings=false به طور پیش‌فرض از پایان خط بومی پلتفرم شما استفاده می‌کند.

--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 بر اساس نوع/نام در قالب YAML
kubectl apply edit-last-applied deployment/nginx
# ویرایش حاشیه‌نویسی‌های last-applied-configuration بر اساس فایل در قالب JSON
kubectl apply edit-last-applied -f deploy.yaml -o json

kubectl-apply(1)

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

Jan 2015 Eric Paris