۲۹ مهر ۲۵۸۴ · 4 دقیقه مطالعه
فاینالایزرها در Kubernetes: چرا نیماسپیسها توی وضعیت Terminating گیر میکنن
مقدمه
میخوای یه نیماسپیس رو توی Kubernetes پاک کنی و میبینی انگار تا ابد توی وضعیت «Terminating» گیر کرده. این یکی از اعصابخردکنترین دردسرهاییه که توی کار DevOps مدام تکرار میشه. مقصر معمولاً فاینالایزرها هستن، یعنی فیلدهای خاصی توی متادیتا که تا کارهای پاکسازی تموم نشه، نمیذارن ریسورس پاک بشه.
فاینالایزرها در Kubernetes چی هستن؟
فاینالایزر برای کنترلرهای Kubernetes حکم یه «لیست کارهای مونده» رو داره. قبل از اینکه API Server یه آبجکت رو واقعاً از etcd (دیتابیس کلاستر) پاک کنه، لیست فاینالایزرهایی رو که به اون ریسورس وصله نگاه میکنه.
هر مورد توی این لیست مال یه کنترلره که باید اول کارهای پاکسازی رو انجام بده؛ تا اون موقع API اجازهی حذف واقعی رو نمیده.
چرا فاینالایزرها وجود دارن
فاینالایزرها پاکسازی ریسورسها رو امن و قابل پیشبینی میکنن، چون نمیذارن بعد از حذف، ریسورسهای یتیم باقی بمونن؛ چیزهایی مثل ولومهای پایدار، اینترفیسهای شبکه یا رولهای IAM.
کاربردهای رایج:
- درخواستهای ولوم پایدار (PVCs): مطمئن میشن ولومهای پایدار مربوط قبل از حذف جدا شده باشن
- نیماسپیسها: تضمین میکنن همهی ریسورسهای داخل نیماسپیس قبل از خودش پاک بشن
- تعریفهای ریسورس سفارشی (CRDs): به اپراتور فرصت میدن قبل از حذف هر نمونه، پاکسازی رو انجام بده
- کنترلرهای Service: اتصالهای کلاود که حذف لود بالانسر رو مدیریت میکنن
فاینالایزرها چطور کار میکنن
چرخهی کار این مراحل رو طی میکنه:
- دستور
kubectl deleteروی یه آبجکت اجرا میشه - خود Kubernetes یه
deletionTimestampبه آبجکت اضافه میکنه - کنترلرهایی که فاینالایزرها رو مدیریت میکنن، این برچسب زمانی رو میبینن و پاکسازی رو شروع میکنن
- وقتی پاکسازی تموم شد، هر کنترلر فاینالایزر خودش رو برمیداره
- وقتی لیست فاینالایزرها خالی شد، Kubernetes آبجکت رو پاک میکنه
وقتی کار خراب میشه
کنترلرها گاهی کرش میکنن، حذف میشن یا درست کار نمیکنن. اون وقت Kubernetes تا ابد منتظر پاکسازیای میمونه که هیچوقت انجام نمیشه، و ریسورسها توی وضعیت «Terminating» گیر میکنن.
علائم معمول:
- ریسورس توی وضعیت «Terminating» گیر کرده
- دستور
kubectl deleteهیچوقت تموم نمیشه - فاینالایزرها هنوز توی YAML آبجکت هستن
- لاگ کنترلر خطا یا ارجاعهای گمشده نشون میده
دیباگ یه نیماسپیس یا ریسورس گیرکرده
قدم اول: ریسورس رو بررسی کن
kubectl get ns my-namespace -o yaml
این دستور فیلد finalizers رو نشونت میده که جلوی حذف رو گرفته.
قدم دوم: فاینالایزر گیرکرده رو پیدا کن
لاگ کنترلرهای مربوط رو چک کن تا بفهمی کدوم فاینالایزر جلوی حذف رو گرفته و چرا پاکسازی جلو نمیره.
قدم سوم: فاینالایزر رو بردار
وقتی مطمئن شدی برداشتنش امنه، ریسورس رو patch کن:
kubectl patch ns my-namespace -p '{"metadata":{"finalizers":[]}}' --type=merge
راه دیگه اینه که مستقیم با kubectl edit ns my-namespace ویرایشش کنی و خطهای فاینالایزر رو پاک کنی.
هشدار جدی: فقط وقتی فاینالایزرها رو بردار که مطمئن شدی پاکسازی لازم نیست؛ وگرنه ممکنه ریسورسهای یتیم توی کلاود باقی بمونن.
یه مثال واقعی
یه نیماسپیس رو در نظر بگیر که AWS Load Balancer Controller مدیریتش میکنه. موقع حذف این رو میبینی:
metadata:
finalizers:
- service.kubernetes.io/load-balancer-cleanup
اگه کنترلر در دسترس نباشه یا دسترسیهای لازم رو نداشته باشه، نمیتونه فاینالایزر رو برداره و نیماسپیس تا ابد توی حالت حذفشدن میمونه.
راهحل: کنترلر رو ریاستارت کن یا دسترسیهاش رو درست کن. اگه جواب نداد و مطمئنی هیچ ریسورسی باقی نمونده، فاینالایزر رو دستی بردار.
بهترین روشها
- تا مجبور نشدی فاینالایزر رو دستی برندار؛ اول مشکل کنترلر رو حل کن
- لاگ کنترلرها رو بخون تا علت اصلی رو پیدا کنی
- یادت باشه بعضی فاینالایزرها پاکسازی حیاتیای انجام میدن که جلوی نشت ریسورس رو میگیره
- با اسکریپتهای پاکسازی خودکار محتاط باش و براشون محافظ بذار
- اگه CRD مینویسی، فاینالایزرها رو مسئولانه ثبت کن، پاکسازی رو توی منطق Reconcile انجام بده و بعد از موفقیت، فاینالایزر رو بردار
جمعبندی
فاینالایزرها سازوکاری ظریف ولی قدرتمند در Kubernetes هستن که پاکسازی امن ریسورسها رو تضمین میکنن. اونها بین کنترلرها و API Server یه «قرارداد پاکسازی» میبندن. وقتی کنترلرها خراب میشن، ریسورسها گیر میکنن؛ ولی اگه بدونی فاینالایزرها چطور کار میکنن، میتونی با اطمینان مشکل رو پیدا کنی و فاینالایزر رو امن برداری.