KubeOne(1) KubeOne(1)

kubeone-migrate-to-ccm-csi - مهاجرت کلاستر به افزونه‌های خارجی CCM و CSI در KubeOne

kubeone migrate to-ccm-csi [flags]

به دنبال منسوخ شدن ارائه‌دهنده ابری داخلی (درون‌درختی یا in-tree) در کوبرنتیز (http://kep.k8s.io/2395)، این دستور به مهاجرت کلاسترهای موجود از ارائه‌دهنده ابری داخلی به مدیر کنترلر ابری خارجی (CCM) و افزونه CSI کمک می‌کند.

نکته: اگر کلاستر شما با فعال بودن گزینه .cloudProvider.external ایجاد شده باشد، نیازی به مهاجرت CCM/CSI نیست، زیرا کلاستر از قبل از CCM خارجی استفاده می‌کند.

مهاجرت در حال حاضر برای OpenStack و vSphere در دسترس است. سایر ارائه‌دهندگان در نسخه‌های آینده KubeOne اضافه خواهند شد.

این مهاجرت در دو فاز انجام می‌شود:

•
فاز ۱: استقرار CCM خارجی و افزونه CSI، در حالی که ارائه‌دهنده ابری داخلی همچنان فعال است. سرور API کوبرنتیز و kube-controller-manager به گونه‌ای پیکربندی می‌شوند که:
  • به جای ارائه‌دهنده ابری داخلی، از کنترلرهای یکپارچه‌شده در CCM خارجی برای تمامی عملیات مرتبط با ابر استفاده کنند
  • تمامی عملیات مرتبط با دیسک‌ها و حجم‌های ذخیره‌سازی را به افزونه CSI هدایت کنند نودهای ورکر فعلی به استفاده از ارائه‌دهنده داخلی ادامه خواهند داد (به همین دلیل همچنان فعال نگه داشته شده است)، بنابراین، تمام نودهای ورکر مدیریت‌شده توسط machine-controller باید پس از تکمیل فاز ۱ مجدداً مستقر (roll out) شوند.
•
فاز ۲: تکمیل مهاجرت CCM/CSI با غیرفعال‌سازی کامل ارائه‌دهنده داخلی. برای اجرای فاز ۲، کاربران باید دستور "kubeone migrate to-ccm-csi" را همراه با گزینه "--complete" اجرا کنند. این کار باید پس از استقرار مجدد تمام نودهای ورکر مدیریت‌شده توسط machine-controller انجام شود.

حتماً با بررسی مستندات زیر، با پیش‌نیازهای مهاجرت CCM/CSI آشنا شوید: https://docs.kubermatic.com/kubeone/main/guides/ccm-csi-migration

-y, --auto-approve[=false] تایید خودکار برنامه تغییرات (plan)

--complete[=false] تکمیل مهاجرت ccm/csi

-h, --help[=false] راهنمای دستور to-ccm-csi

-c, --credentials="" فایل منبع اطلاعات هویتی و اسرار (secrets)

-d, --debug[=false] خروجی خطایابی همراه با گزارش ردیابی پشته (stacktrace)

-l, --log-format="text" قالب ثبت گزارش‌ها (لاگ‌ها)

-m, --manifest="./kubeone.yaml" مسیر فایل پیکربندی KubeOne

-t, --tfjson="" منبع خروجی ترافورم در قالب JSON - جهت خواندن از ورودی استاندارد (stdin). اگر مسیر یک فایل باشد، محتوای آن استفاده خواهد شد. اگر مسیر یک دایرکتوری باشد، دستور terraform output -json در آن مسیر اجرا می‌شود

-v, --verbose[=false] خروجی با جزئیات کامل

kubeone-migrate(1)

8-Feb-2026 تولید شده به صورت خودکار توسط spf13/cobra

Feb 2026 تولید شده توسط spf13/cobra