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

kubectl-scale - تنظیم اندازه جدید برای یک deployment، replica set، replication controller یا stateful set

kubectl scale [OPTIONS]

تنظیم اندازه جدید برای یک deployment، replica set، replication controller یا stateful set.

دستور Scale همچنین به کاربران اجازه می‌دهد یک یا چند پیش‌شرط را برای عملیات مقیاس‌بندی تعیین کنند.

اگر --current-replicas یا --resource-version مشخص شده باشد، پیش از اقدام به مقیاس‌بندی اعتبارسنجی می‌شود و تضمین می‌گردد که پیش‌شرط هنگام ارسال درخواست مقیاس‌بندی به سرور برقرار است.

--all=false انتخاب تمام منابع در فضای نام (namespace) از انواع منابع مشخص‌شده.

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

--current-replicas=-1 پیش‌شرط برای اندازه کنونی. برای مقیاس‌بندی لازم است که اندازه کنونی منبع با این مقدار مطابقت داشته باشد. مقدار 1- (پیش‌فرض) به معنای بدون شرط است.

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

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

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

--replicas=0 تعداد رپلیکاهای (replicas) جدید مورد نظر. الزامی است.

--resource-version="" پیش‌شرط برای نسخه منبع (resource version). برای مقیاس‌بندی لازم است نسخه کنونی منبع با این مقدار مطابقت داشته باشد.

-l, --selector="" انتخاب‌گر (پرس‌وجوی برچسب) برای فیلتر کردن، از '='، '=='، '!='، 'in' و 'notin' پشتیبانی می‌کند (مانند ‎-l key1=value1,key2=value2,key3 in (value3)‎). اشیاء منطبق باید تمام قیود برچسب مشخص‌شده را برآورده کنند.

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

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

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

--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 در نظر گرفتن هشدارهای دریافتی از سرور به عنوان خطا و خروج با کد وضعیت غیر صفر

# مقیاس‌بندی replica set با نام 'foo' به ۳
kubectl scale --replicas=3 rs/foo
# مقیاس‌بندی یک منبع مشخص‌شده با نوع و نام در "foo.yaml" به ۳
kubectl scale --replicas=3 -f foo.yaml
# در صورتی که اندازه کنونی deployment به نام mysql برابر ۲ باشد، مقیاس‌بندی mysql به ۳
kubectl scale --current-replicas=2 --replicas=3 deployment/mysql
# مقیاس‌بندی چندین replication controller
kubectl scale --replicas=5 rc/example1 rc/example2 rc/example3
# مقیاس‌بندی stateful set با نام 'web' به ۳
kubectl scale --replicas=3 statefulset/web

kubectl(1)

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

Jan 2015 Eric Paris