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

kubectl-create-configmap - ایجاد یک configmap از یک فایل محلی، دایرکتوری یا مقدار متنی (literal)

kubectl create configmap [OPTIONS]

ایجاد یک کانفیگ‌مپ (configmap) بر اساس یک فایل، دایرکتوری یا مقدار صریح (literal) مشخص‌شده.

یک کانفیگ‌مپ منفرد می‌تواند یک یا چند جفت کلید/مقدار (key/value) را بسته‌بندی کند.

هنگام ایجاد یک کانفیگ‌مپ بر اساس یک فایل، کلید به طور پیش‌فرض نام پایه (basename) فایل و مقدار به طور پیش‌فرض محتوای فایل خواهد بود. اگر نام پایه یک کلید نامعتبر باشد، می‌توانید یک کلید جایگزین را مشخص کنید.

هنگام ایجاد یک کانفیگ‌مپ بر اساس یک دایرکتوری، هر فایلی که نام پایه آن یک کلید معتبر در دایرکتوری باشد درون کانفیگ‌مپ بسته‌بندی خواهد شد. هر ورودی دایرکتوری به جز فایل‌های معمولی نادیده گرفته می‌شود (مانند زیردایرکتوری‌ها، پیوندهای نمادین، دستگاه‌ها، پایپ‌ها و غیره).

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

--append-hash=false افزودن هش مربوط به configmap به انتهای نام آن.

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

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

--from-env-file=[] مسیر فایلی را مشخص می‌کند که سطرهای جفت کلید=مقدار (key=val) برای ایجاد یک configmap از آن خوانده می‌شوند.

--from-file=[] فایل کلید را می‌توان با استفاده از مسیر فایل آن مشخص کرد، که در این حالت نام پایه فایل به عنوان کلید configmap استفاده خواهد شد، یا به صورت اختیاری با یک کلید و مسیر فایل، که در این حالت کلید ارائه‌شده استفاده می‌شود. مشخص کردن یک دایرکتوری، در میان هر فایل نام‌گذاری‌شده در دایرکتوری که نام پایه آن یک کلید معتبر configmap باشد پیمایش خواهد کرد.

--from-literal=[] یک کلید و مقدار متنی (literal) را برای درج در configmap مشخص می‌کند (به عنوان مثال mykey=somevalue)

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

--save-config=false در صورت true بودن، پیکربندی شیء کنونی در annotation آن ذخیره خواهد شد. در غیر این صورت، annotation بدون تغییر باقی می‌ماند. این فلگ زمانی مفید است که بخواهید در آینده kubectl apply را روی این شیء اجرا کنید.

--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" هیچ اعتبارسنجی اسکیمایی انجام نداده و فیلدهای ناشناخته یا تکراری را بدون اعلام نادیده می‌گیرد.

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

# ایجاد یک کانفیگ‌مپ جدید به نام my-config بر اساس پوشه bar
kubectl create configmap my-config --from-file=path/to/bar
# ایجاد یک کانفیگ‌مپ جدید به نام my-config با کلیدهای مشخص‌شده به جای نام‌های پایه فایل روی دیسک
kubectl create configmap my-config --from-file=key1=/path/to/bar/file1.txt --from-file=key2=/path/to/bar/file2.txt
# ایجاد یک کانفیگ‌مپ جدید به نام my-config با کلیدهای key1=config1 و key2=config2
kubectl create configmap my-config --from-literal=key1=config1 --from-literal=key2=config2
# ایجاد یک کانفیگ‌مپ جدید به نام my-config با جفت‌های key=value از یک فایل محیطی (env)
kubectl create configmap my-config --from-env-file=path/to/bar.env

kubectl-create(1)

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

Jan 2015 Eric Paris