.nh
.TH "KubeOne" "1" "Feb 2026" "تولید شده توسط spf13/cobra" ""

.SH "نام (NAME)"
kubeone-migrate-to-ccm-csi \- مهاجرت کلاستر به افزونه‌های خارجی CCM و CSI در KubeOne


.SH "خلاصه دستور (SYNOPSIS)"
\fBkubeone migrate to-ccm-csi [flags]\fP


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

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

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

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

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


.SH "گزینه‌ها (OPTIONS)"
\fB-y\fP, \fB--auto-approve\fP[=false]
	تایید خودکار برنامه تغییرات (plan)

.PP
\fB--complete\fP[=false]
	تکمیل مهاجرت ccm/csi

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


.SH "گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
\fB-c\fP, \fB--credentials\fP=""
	فایل منبع اطلاعات هویتی و اسرار (secrets)

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

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

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

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

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


.SH "همچنین ببینید (SEE ALSO)"
\fBkubeone-migrate(1)\fP


.SH "تاریخچه (HISTORY)"
8-Feb-2026 تولید شده به صورت خودکار توسط spf13/cobra