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

kubeadm-init - اجرای این دستور جهت راه‌اندازی صفحه کنترل (control plane) کوبرنتیز

kubeadm init [OPTIONS]

این دستور را جهت راه‌اندازی صفحه کنترل (control plane) کوبرنتیز اجرا کنید.

دستور "init" فازهای زیر را اجرا می‌کند:

preflight                     اجرای بررسی‌های پیش‌پرواز (pre-flight)
certs                         تولید گواهی‌ها
  /ca                           تولید CA خودامضاشده کوبرنتیز برای ارائه هویت به سایر مؤلفه‌های کوبرنتیز
  /apiserver                    تولید گواهی برای سرویس‌دهی API کوبرنتیز
  /apiserver-kubelet-client     تولید گواهی برای اتصال سرور API به kubelet
  /front-proxy-ca               تولید CA خودامضاشده جهت ارائه هویت برای front proxy
  /front-proxy-client           تولید گواهی برای کلاینت front proxy
  /etcd-ca                      تولید CA خودامضاشده جهت ارائه هویت برای etcd
  /etcd-server                  تولید گواهی برای سرویس‌دهی etcd
  /etcd-peer                    تولید گواهی برای ارتباط گره‌های etcd با یکدیگر
  /etcd-healthcheck-client      تولید گواهی برای پروب‌های liveness جهت بررسی سلامت etcd
  /apiserver-etcd-client        تولید گواهی مورد استفاده apiserver برای دسترسی به etcd
  /sa                           تولید کلید خصوصی جهت امضای توکن‌های service account به همراه کلید عمومی آن
kubeconfig                    تولید تمام فایل‌های kubeconfig لازم برای برپایی صفحه کنترل و فایل kubeconfig مدیر
  /admin                        تولید فایل kubeconfig برای استفاده مدیر و خود kubeadm
  /super-admin                  تولید فایل kubeconfig برای super-admin
  /kubelet                      تولید فایل kubeconfig برای استفاده kubelet *صرفاً* جهت راه‌اندازی اولیه کلاستر
  /controller-manager           تولید فایل kubeconfig برای استفاده controller manager
  /scheduler                    تولید فایل kubeconfig برای استفاده scheduler
etcd                          تولید فایل مانیفست پاد استاتیک برای etcd محلی
  /local                        تولید فایل مانیفست پاد استاتیک برای یک نمونه etcd محلی تک‌گره‌ای
control-plane                 تولید تمام فایل‌های مانیفست پاد استاتیک لازم برای برپایی صفحه کنترل
  /apiserver                    تولید مانیفست پاد استاتیک kube-apiserver
  /controller-manager           تولید مانیفست پاد استاتیک kube-controller-manager
  /scheduler                    تولید مانیفست پاد استاتیک kube-scheduler
kubelet-start                 نوشتن تنظیمات kubelet و راه‌اندازی (مجدد) kubelet
wait-control-plane            انتظار برای شروع به کار صفحه کنترل
upload-config                 بارگذاری پیکربندی kubeadm و kubelet در یک ConfigMap
  /kubeadm                      بارگذاری ClusterConfiguration مربوط به kubeadm در یک ConfigMap
  /kubelet                      بارگذاری پیکربندی مؤلفه kubelet در یک ConfigMap
upload-certs                  بارگذاری گواهی‌ها در kubeadm-certs
mark-control-plane            علامت‌گذاری یک گره به عنوان control-plane
bootstrap-token               تولید توکن‌های راه‌اندازی اولیه (bootstrap) مورد استفاده برای پیوستن یک گره به کلاستر
kubelet-finalize              به‌روزرسانی تنظیمات مرتبط با kubelet پس از bootstrap مربوط به TLS
  /enable-client-cert-rotation  فعال‌سازی چرخش گواهی کلاینت kubelet
addon                         نصب افزونه‌های لازم جهت قبولی در آزمون‌های انطباق (conformance)
  /coredns                      نصب افزونه CoreDNS در یک کلاستر کوبرنتیز
  /kube-proxy                   نصب افزونه kube-proxy در یک کلاستر کوبرنتیز
show-join-command             نمایش دستور join برای گره‌های control-plane و worker

--apiserver-advertise-address="" آدرس IP که API Server اعلام می‌کند روی آن در حال گوش دادن است. اگر تنظیم نشود، از رابط شبکه پیش‌فرض استفاده خواهد شد.

--apiserver-bind-port=6443 پورتی که API Server به آن متصل (bind) می‌شود.

--apiserver-cert-extra-sans=[] نام‌های موضوعی جایگزین (SANها یا Subject Alternative Names) اختیاری اضافی برای استفاده در گواهی سرویس‌دهی API Server. این موارد می‌توانند هم آدرس‌های IP و هم نام‌های DNS باشند.

--cert-dir="/etc/kubernetes/pki" مسیری که گواهی‌ها در آن ذخیره و نگهداری می‌شوند.

--certificate-key="" کلید مورد استفاده برای رمزنگاری گواهی‌های صفحه کنترل در Secret با نام kubeadm-certs. این کلید گواهی یک رشته با کدگذاری هگزادسیمال (hex encoded) است که یک کلید AES با اندازه ۳۲ بایت می‌باشد.

--config="" مسیر فایل پیکربندی kubeadm.

--control-plane-endpoint="" مشخص کردن یک آدرس IP یا نام DNS پایدار برای صفحه کنترل.

--cri-socket="" مسیر سوکت CRI برای اتصال. در صورت خالی بودن، kubeadm تلاش می‌کند این مقدار را به صورت خودکار شناسایی کند؛ از این گزینه تنها در صورتی استفاده کنید که بیش از یک CRI نصب شده باشد یا از سوکت غیراستاندارد CRI استفاده می‌کنید.

--dry-run=false هیچ تغییری را اعمال نکن؛ صرفاً آنچه را که انجام خواهد شد نمایش بده.

--feature-gates="" مجموعه‌ای از جفت‌های کلید=مقدار (key=value) که درگاه‌های قابلیت (feature gates) را برای قابلیت‌های مختلف شرح می‌دهد. گزینه‌ها عبارتند از: NodeLocalCRISocket=true|false (پیش‌فرض=true) PublicKeysECDSA=true|false (منسوخ‌شده - پیش‌فرض=false) RootlessControlPlane=true|false (آلفا - پیش‌فرض=false)

--ignore-preflight-errors=[] فهرستی از بررسی‌هایی که خطاهای آن‌ها به عنوان هشدار نمایش داده خواهد شد. مثال: 'IsPrivilegedUser,Swap'. مقدار 'all' خطاهای ناشی از تمام بررسی‌ها را نادیده می‌گیرد.

--image-repository="registry.k8s.io" انتخاب یک رجیستری کانتینر برای دریافت (pull) ایمیج‌های صفحه کنترل از آن.

--kubernetes-version="stable-1" انتخاب نسخه خاصی از کوبرنتیز برای صفحه کنترل.

--node-name="" مشخص کردن نام گره (node).

--patches="" مسیر دایرکتوری حاوی فایل‌هایی با الگوی نام‌گذاری "target[suffix][+patchtype].extension". برای نمونه، "kube-apiserver0+merge.yaml" یا صرفاً "etcd.json". مقدار "target" می‌تواند یکی از موارد "kube-apiserver"، "kube-controller-manager"، "kube-scheduler"، "etcd"، "kubeletconfiguration" یا "corednsdeployment" باشد. مقدار "patchtype" می‌تواند یکی از قالب‌های "strategic"، "merge" یا "json" باشد که مطابق با قالب‌های وصله (patch) پشتیبانی‌شده توسط kubectl هستند. مقدار پیش‌فرض "patchtype" برابر با "strategic" است. مقدار "extension" باید "json" یا "yaml" باشد. مقدار "suffix" یک رشته اختیاری است که می‌توان از آن برای تعیین ترتیب الفبایی-عددی اعمال وصله‌ها استفاده کرد.

--pod-network-cidr="" مشخص کردن محدوده آدرس‌های IP برای شبکه پاد (pod network). در صورت تنظیم، صفحه کنترل به طور خودکار CIDRها را برای هر گره تخصیص می‌دهد.

--service-cidr="10.96.0.0/12" استفاده از محدوده جایگزین آدرس IP برای VIPهای سرویس.

--service-dns-domain="cluster.local" استفاده از دامنه جایگزین برای سرویس‌ها، مانند "myorg.internal".

--skip-certificate-key-print=false عدم چاپ کلید مورد استفاده برای رمزنگاری گواهی‌های صفحه کنترل.

--skip-phases=[] فهرستی از فازهایی که باید نادیده گرفته و رد شوند.

--skip-token-print=false رد کردن چاپ توکن راه‌اندازی اولیه (bootstrap token) پیش‌فرض تولیدشده توسط 'kubeadm init'.

--token="" توکن مورد استفاده برای برقراری اعتماد دوطرفه میان گره‌ها و گره‌های صفحه کنترل. قالب آن به صورت [a-z0-9]{6}.[a-z0-9]{16} است - مانند abcdef.0123456789abcdef

--token-ttl=24h0m0s مدت زمان پیش از حذف خودکار توکن (مانند 1s، 2m، 3h). در صورت تنظیم روی '0'، توکن هرگز منقضی نخواهد شد.

--upload-certs=false بارگذاری گواهی‌های صفحه کنترل در Secret با نام kubeadm-certs.

--rootfs="" مسیر به سیستم‌فایل ریشه «واقعی» میزبان. این گزینه باعث می‌شود kubeadm در مسیر ارائه‌شده chroot کند.

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

kubeadm(1), kubeadm-init-phase(1)

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

Jan 2015 Eric Paris