Kubit logoکوبیت

شروع کار با Pack

Pack یک منبع سفارشی کوبرنتیز برای تعریف و مدیریت نصب یک چارت هلم است. بیشتر کاربران Pack را در پنل کوبچی می‌بینند؛ اما همان نصب را می‌توان با مانیفست YAML، گیت‌آپس یا kubit-cli نیز بررسی و مدیریت کرد.

این صفحه جای هر جزء را در چرخه نصب روشن می‌کند و مسیر مناسب مطالعه را نشان می‌دهد. برای ساخت مستقیم مانیفست، به مرجع Pack بروید.

نقش Pack، اپراتور، هلم و کوبچی

جزءنقش
Packوضعیت مطلوب نصب را نگه می‌دارد: مخزن، نام و نسخهٔ چارت، vars و values
Pack Operatorمنبع Pack را می‌بیند و نصب یا ارتقای Helm Release را با آن هماهنگ می‌کند
kubit-cliخروجی هلم، تفاوت‌ها، migration، exports و عملیات تخصصی Pack را از خط فرمان در دسترس می‌گذارد
Helmچارت و مقادیر را به مانیفست‌های کوبرنتیز تبدیل و Helm Release را مدیریت می‌کند
Helm Chartبستهٔ نسخه‌پذیر شامل templateها، values.yaml و فرادادهٔ اپلیکیشن است
کوبچیرابط پنلی و کاتالوگ اپلیکیشن‌ها برای ساخت، پیکربندی و مشاهدهٔ Pack است

Pack جایگزین Helm Chart نیست. چارت ساختار اپلیکیشن را تعریف می‌کند و Pack مشخص می‌کند کدام نسخه از آن چارت با چه مقادیری در پروژه نصب شود. Pack Operator نیز این تعریف را با استفاده از Helm اعمال می‌کند.

چرخه نصب یک Pack

  1. کاربر در کوبچی یک اپلیکیشن انتخاب می‌کند یا مانیفست Pack را مستقیم می‌نویسد.
  2. تعریف نصب به‌صورت یک منبع Pack در فضای نام پروژه ثبت می‌شود.
  3. Pack Operator منبع را اعتبارسنجی و چارت و نسخهٔ مورد نظر را پیدا می‌کند.
  4. اپراتور vars و values را رندر می‌کند و چارت را به Helm می‌دهد.
  5. Helm منابع کوبرنتیز را به‌عنوان یک Helm Release نصب یا ارتقا می‌دهد.
  6. Pack Operator وضعیت، خطا و خروجی‌ها را روی منبع Pack ثبت می‌کند؛ کوبچی همین نتیجه را در پنل نمایش می‌دهد.

کوبچی کجای این چرخه است؟

کوبچی مسیر اصلی کار روزمره با Pack در پنل کوبیت است. وقتی از کاتالوگ کوبچی اپلیکیشنی نصب یا پیکربندی می‌کنید، کوبچی تعریف Pack را برای پروژه می‌سازد یا تغییر می‌دهد؛ اجرای واقعی نصب همچنان بر عهده Pack Operator و Helm است.

اگر فقط می‌خواهید یک اپلیکیشن آماده نصب کنید، از نصب Pack در کوبچی شروع کنید. برای تغییر مقادیر از پنل نیز پیکربندی اپلیکیشن در کوبچی را بخوانید.

مستندات فنی Pack زمانی لازم می‌شوند که بخواهید مانیفست YAML بنویسید، تغییرها را با گیت‌آپس نگه دارید، خروجی هلم را بررسی کنید، خطای اپراتور را تحلیل کنید یا چارت سازگار با Pack بسازید.

مسیر پیشنهادی مطالعه

  1. مرجع Pack و ساخت مانیفست برای نسخه، values، vars، Vault و چرخهٔ زندگی
  2. Pack Operator و چرخهٔ همگام‌سازی برای درک اعمال، ارتقا و وضعیت
  3. مرجع kubit-cli برای template، diff، exports، migration و عملیات Pack
  4. هلم و Helm Chart برای مفاهیم بسته، مقادیر و Helm Release
  5. قابلیت‌های Pack در چارت برای نویسندگان چارت
  6. نوشتن Pack Migration برای تغییرهای ناسازگار میان نسخه‌های چارت

دو مورد آخر مباحث پیشرفتهٔ نویسندگی چارت هستند. برای نصب و مدیریت معمول Pack لازم نیست از آن‌ها شروع کنید.

انتخاب مسیر بر اساس کار

اگر می‌خواهیداز این صفحه شروع کنید
اپلیکیشن آماده را از پنل نصب کنیدنصب Pack در کوبچی
Pack را با YAML یا گیت‌آپس مدیریت کنیدمرجع Pack
رفتار نصب و ارتقا را عیب‌یابی کنیدPack Operator
خروجی Helm را پیش از اعمال ببینیدفرمان‌های Helm در kubit-cli
مفاهیم Helm و چارت را یاد بگیریدهلم و Helm Chart
برای چارت exports یا migration بنویسیدقابلیت‌های سطح چارت
پک (Pack) | مستندات | کوبیت