راهنما و واژه‌نامه

این پنل برای ساخت و مدیریت «مجموعه مدرسه» روی سرورهای جداست. اصطلاحات انگلیسی که در دکمه‌ها و لاگ کارها می‌بینید، اینجا توضیح داده شده‌اند.

مسیر پیشنهادی کار

1. سرور را در تب سرورها با آی‌پی و رمز SSH ثبت کنید؛ پنل کلید خودش را نصب و آماده‌سازی را شروع می‌کند.
2. رکورد دامنه را به آی‌پی همان سرور بزنید.
3. از جادوگر «ساخت مجموعه» مجموعه را بسازید و دیپلوی کنید.
4. پیشرفت و خطا را در تب «کارها» ببینید؛ وضعیت زنده و به‌روز بودن ایمیج را در «مجموعه‌ها».
5. بیلدهای جدید سی‌آی در تب «نسخه‌ها» می‌آیند؛ وقتی آمادهٔ مدارس شد، «بگذار منبع مدرسه» بزنید، بعد روی مجموعه «آپدیت» کنید.

نسخه‌ها و به‌روز بودن

1. سی‌آی بعد از بیلد، نسخه را به کاتالوگ گزارش می‌کند (تب نسخه‌ها)؛ تا وقتی «بگذار منبع مدرسه» نزنید، بیلد جدید به‌تنهایی مجموعه را قدیمی نمی‌کند.
2. تب نسخه‌ها دو بخش دارد: «پلتفرم هوش مصنوعی رایسا» برای ایمیج‌های سی‌آی، و «نرم‌افزار حضور غیاب رایسا» برای فایل نصبی دستگاه‌ها.
3. در جدول دستگاه‌های حضور غیاب، «اتصال» یعنی رسیدن ضربان ۳۰ثانیه‌ای یا باز بودن سوکت. «سلامت» (کابل، بی‌جوابی، آنتن، فن، دما) فقط با اتصالِ برقرار پر می‌شود. «خوانده‌شده» تعداد افراد یکتایی است که از آخرین شروع یا پاک‌سازی، کارت‌شان روی دستگاه خوانده شده. قطع در ساعت کارت‌خوانی آلارم قرمز است. «حذف» ردیف را تا اتصال بعدی برمی‌دارد؛ دستگاه مسدود نمی‌شود.
4. «علامت خوب» نسخه را از پاک‌سازی خودکار نگه می‌دارد (حداکثر ۳ تا برای هر سرویس).
5. «قفل» بعد از تأیید، نسخه را از پاک‌سازی خودکار کنار می‌گذارد. حذف یا باز کردن قفل فقط با رمز مالک ممکن است.
6. «بگذار منبع مدرسه» تگ شناور مدرسه را به همان نسخه اشاره می‌دهد؛ مجموعه‌های فعلی خودکار عوض نمی‌شوند.
7. ستون/نشان «قدیمی» یعنی ایمیج در حال اجرای مجموعه با منبع مدرسه یکی نیست — نه اینکه فقط بیلد جدید در سی‌آی آمده باشد.
8. «آپدیت» در عملیات مجموعه یا روی کارت سرویس، اول همان پاک‌سازی امن سرور را اجرا می‌کند تا فضای بی‌مصرف آزاد شود، بعد ایمیج منبع مدرسه را می‌کشد و سرویس را بالا می‌آورد؛ در پایان هم ایمیج‌های بلااستفادهٔ باقی‌مانده پاک می‌شوند.
9. «ثبت از رجیستری فعلی» یک‌بار وضعیت تگ شناور فعلی رجیستری را به‌عنوان ردیف seed در کاتالوگ می‌نویسد؛ برای استفادهٔ روزمره بعد از سی‌آی لازم نیست.
10. «حذف» در تب نسخه‌ها ردیف کاتالوگ و مانیفست رجیستری (غیرشناور) را برمی‌دارد و پاک‌سازی کامل سرور آزمایشگاه را صف می‌کند؛ منبع فعلی را نمی‌توان حذف کرد مگر اول منبع را عوض کنید. نسخهٔ قفل‌شده بدون رمز مالک حذف نمی‌شود.

واژه‌نامه

مجموعه مدرسه school set / stack

یک مدرسهٔ کامل روی یک سرور: سایت، پنل، ای‌پی‌آی، چت، دیتابیس و در صورت نیاز مدیا. همهٔ این سرویس‌ها با هم یک «استک» هستند و معمولاً با یک دامنه در دسترس‌اند.

مدیا سرور media standalone

فقط سرویس mediasoup با ضبط روی یک دامنهٔ جدا (ریشهٔ دامنه، نه مسیر /media). از همان جادوگر ساخت با نوع «مدیا سرور» ساخته می‌شود و در تب مدیا هم به‌عنوان استخر ثبت می‌گردد.

اسلاگ slug

شناسهٔ کوتاه لاتین برای مدرسه (مثلاً kamal). در نام پوشه، پروژهٔ داکر و بعضی متغیرها استفاده می‌شود؛ بعد از ساخت بهتر است عوض نشود.

کنترل‌پلین / پنل مالک control plane

همین پنل (مثلاً ops.raysaai.ir). از اینجا سرورها و مجموعه‌ها را مدیریت می‌کنید؛ خودِ سرویس مدرسه روی سرور مدرسه اجرا می‌شود، نه روی این پنل.

سرور میزبان host / VM

ماشین لینوکسی (معمولاً در آروان) که استک مدرسه روی آن نصب می‌شود. پنل با SSH و کلید خودش به این سرور وصل می‌شود. «حذف» در تب سرورها فقط رکورد پنل را برمی‌دارد؛ VM آروان پاک نمی‌شود. اگر مجموعه‌ای (فعال یا در سطل زباله) به سرور وصل باشد، حذف رد می‌شود.

تقسیم منابع

از ردیف «میزبان مشترک» در تب مجموعه‌ها، درصد CPU و RAM هر مجموعه از کل همان سرور تنظیم می‌شود. از عملیات مجموعه، سهم هر سرویس (مونگو، API، داشبورد، سایت، مدیا) از سهم همان مجموعه مشخص می‌شود. پنل درصد را به سقف داکر تبدیل می‌کند و بدون ری‌استارت کانتینر اعمال می‌کند. بعد از بوت یا تغییر تعداد هسته و رم، اگر عدد سقف عوض شده باشد دوباره اعمال می‌شود؛ اگر مصرف فعلی جا نشود، سقف موقتاً بالاتر می‌ماند.

آماده‌سازی prepare / host prep

نصب پیش‌نیازهای میزبان: داکر، انجین‌اکس، همگام‌سازی قالب‌ها و اسکریپت‌ها. قبل از اولین دیپلوی مجموعه باید سرور «آماده» باشد. با پروویژن فرق دارد.

پروویژن provisioning

نصب و راه‌اندازی خودِ مجموعه روی سرور آماده: ساخت فایل تنظیمات، ورود به رجیستری ایمیج، کشیدن ایمیج‌ها، بالا آوردن سرویس‌ها با داکر کامپوز، تنظیم انجین‌اکس و در صورت امکان گواهی TLS. در لاگ کارها معمولاً با عبارت Provisioning … شروع می‌شود.

دیپلوی deploy

در این پنل تقریباً همان پروویژن/نصب مجموعه است. دکمهٔ «دیپلوی» روی یک مجموعهٔ موجود، دوباره مراحل نصب/به‌روزرسانی را روی سرور اجرا می‌کند.

به‌روزرسانی / آپدیت update / pull

ایمیج‌ها را مطابق منبع مدرسه از رجیستری می‌کشد و کانتینر را دوباره بالا می‌آورد. می‌توان کل مجموعه را از منوی عملیات آپدیت کرد، یا فقط یک سرویس را از کارت همان سرویس. در هر دو حالت، قبل از pull همان پاک‌سازی امن سرور مدرسه اجرا می‌شود (ایمیج بلااستفاده، لاگ حجیم، کش و فایل موقت) تا جا برای ایمیج جدید باز شود. کانتینر در حال اجرا و ولوم داده حفظ می‌شوند. بعد قالب استک همگام می‌شود و nginx دوباره رندر و reload می‌شود. گواهی TLS دوباره صادر نمی‌شود. برای فقط nginx، بدون pull ایمیج و بدون ریستارت کانتینر، از «به‌روزرسانی nginx» در منوی عملیات همان مجموعه استفاده کنید. بعد از آپدیت موفق، ایمیج‌های بلااستفادهٔ باقی‌مانده روی همان سرور هدف پاک می‌شوند تا دیسک پر نشود.

منبع مدرسه school source

نسخه‌ای که عمداً برای مدارس انتخاب کرده‌اید (تگ شناور مثل :school یا :panel). نشان «قدیمی/به‌روز» مجموعه‌ها نسبت به همین منبع است، نه نسبت به آخرین بیلد خام سی‌آی.

ثبت از رجیستری فعلی seed from registry

دکمهٔ تب نسخه‌ها برای مالک: وضعیت فعلی تگ‌های شناور رجیستری را یک‌بار به‌عنوان ردیف‌های seed در کاتالوگ می‌نویسد. جایگزین گزارش خودکار سی‌آی نیست؛ معمولاً برای راه‌اندازی اولیهٔ فهرست خالی یا هم‌تراز کردن دستی با رجیستری است. استک‌های مدرسه را آپدیت نمی‌کند و منبع مدرسه را عوض نمی‌کند مگر بعداً خودتان «بگذار منبع مدرسه» بزنید.

مرجع مدرسه در رجیستری

نوار بالای تب مجموعه‌ها: دیاجست فعلی منبع مدرسه برای هر سرویس. اگر با دیاجست در حال اجرای کارت سرویس یکی نباشد، آن سرویس «قدیمی» است.

ناقص degraded

در وضعیت زنده یعنی بعضی سرویس‌ها بالا/سالم‌اند و بعضی نه یا «نامشخص»اند (مثلاً ۵ از ۷). به قدیمی بودن ایمیج ربط مستقیم ندارد.

گواهی آزمایشگاه

تب سرورها گواهی هر نامی که nginx آزمایشگاه سرو می‌کند را نشان می‌دهد. اگر کمتر از ۳۰ روز مانده باشد خودش تمدید می‌کند. اگر نشود، سه بار هر نیم‌ساعت، بعد سه بار هر یک ساعت، بعد سه بار هر شش ساعت دوباره تلاش می‌کند. خطا در زنگوله می‌آید و با «گرفتن دوباره گواهی» همان لحظه صادر می‌شود.

پاک‌سازی آزمایشگاه

در تب سرورها: پاک کردن ایمیج‌های محلی بلااستفاده (حتی main / panel)، کش بیلد، لاگ حجیم، کش npm/pip در root، آرشیو لاگ سیستم، تگ‌های git-* قدیمی رجیستری و garbage-collect روی خود سرور آزمایشگاه. کانتینرهای در حال اجرا و ایمیج‌های پایه حفظ می‌شوند؛ تگ‌ها در رجیستری می‌مانند. ولوم مونگو/رجیستری دست نمی‌خورد.

پاک‌سازی فضای بی‌مصرف

از منوی عملیات مجموعه یا تب سرورها: پاک کردن امن چیزهای بلااستفاده (لاگ حجیم، بکاپ اضافه، ایمیج یتیم و …) بدون دست زدن به مونگو، ولوم داده و کانتینرهای در حال اجرا. پیش‌نمایش حجم معمولاً کمتر از «کل فضای قابل آزادسازی داکر» است چون ایمیج‌های تگ‌دار قدیمی را عمداً حذف نمی‌کند. آپدیت، قبل از pull همان پاک‌سازی امن سرور را اجرا می‌کند و آن ایمیج‌های بلااستفاده را برمی‌دارد؛ بعد از بالا آمدن سرویس هم باقی‌مانده پاک می‌شود.

رجیستری ایمیج container registry

انبار ایمیج‌های داکر رایسا (مثلاً registry.raysaai.ir). سرور مدرسه هنگام پروویژن باید با نام کاربری/رمز رجیستری لاگین کند تا بتواند ایمیج‌ها را بکشد.

ایمیج Docker image

بستهٔ آمادهٔ یک سرویس (ای‌پی‌آی، پنل، چت، مونگو و …) که روی سرور مدرسه اجرا می‌شود.

کلید SSH / کلید عمومی پنل

برای اتصال بدون رمز از کنترل‌پلین به سرور مدرسه. «کلید عمومی پنل» باید در authorized_keys سرور مدرسه باشد؛ کلید خصوصی فقط روی کنترل‌پلین می‌ماند. هنگام ثبت سرور، پنل با رمز SSH یک بار وارد می‌شود و این کلید را خودش نصب می‌کند؛ رمز ذخیره نمی‌شود.

چرخه عمر lifecycle status

وضعیت ثبت‌شده در کاتالوگ پنل (مثلاً در حال ساخت، آماده، خطا). این مقدار از دیتابیس پنل می‌آید و لزوماً یعنی سرویس‌ها الان سالم‌اند نیست.

وضعیت زنده runtime

نتیجهٔ پروب لحظه‌ای از سرور مدرسه: آیا SSH برقرار است و کانتینرهای داکر کامپوز بالا هستند یا نه. با دکمهٔ «بروزرسانی وضعیت» تازه می‌شود.

پروب probe

پرس‌وجوی کوتاه از میزبان برای خواندن وضعیت سرویس‌ها (معمولاً docker compose ps).

مصرف سرور / تاریخچه متریک

نمایش تقریبی سی‌پی‌یو، رم و دیسک سرور میزبان؛ در جزئیات مجموعه نمودار تاریخچه هم هست. پر بودن دیسک می‌تواند باعث ناپایداری یا وضعیت «نامشخص» بعضی سرویس‌ها شود.

بکاپ / بازگردانی مونگو

بکاپ مونگو روی دیسک همان سرور و در فضای ابری ذخیره می‌شود. بازگردانی معمولی فقط وقتی سرور روشن است کار می‌کند. اگر سرور دیگر بالا نیاید، «بازیابی روی سرور جدید» مجموعه را روی یک سرور آماده‌ی دیگر می‌سازد و دیتابیس را از بکاپ ابری برمی‌گرداند. ضبط‌های مدیا که فقط روی دیسک سرور قبلی بودند در این بکاپ نیستند. زمان‌بند سراسری در تنظیمات مالک است.

به‌روزرسانی دیتابیس

کالکشن‌های مشترک در تب «کالکشن‌ها» ذخیره می‌شوند. روی هر مجموعه دکمهٔ «به‌روزرسانی دیتابیس» همان فهرست را نشان می‌دهد. هیچ‌کدام پیش‌فرض انتخاب نشده‌اند. با «ثبت»، کالکشن‌های انتخاب‌شده در آن مدرسه پاک و از نو با نسخهٔ ذخیره‌شده ساخته می‌شوند. بقیهٔ دیتابیس دست نمی‌خورد و در این مدت API مدرسه برای مدت کوتاهی متوقف می‌شود. از دکمهٔ «به‌روزرسانی گروهی دیتابیس» بالای فهرست مجموعه‌ها می‌توانید چند مدرسه و چند کالکشن را یک‌جا انتخاب کنید؛ کار روی کنترل‌پنل یکی‌یکی جلو می‌رود.

اطلاع‌رسانی دامنه

صفحهٔ موقت روی دامنهٔ مدرسه (مثلاً در حال به‌روزرسانی یا آفلاین) بدون خاموش کردن کل استک از دید پنل.

انتقال مجموعه migrate

جابه‌جایی استک به سرور میزبان دیگر، وقتی سرور فعلی هنوز روشن است. بعد از موفقیت باید DNS را به آی‌پی جدید بزنید. اگر سرور مرده و فقط بکاپ ابری مانده، از «بازیابی روی سرور جدید» استفاده کنید.

سطل زباله trash

حذف نرم از فهرست پنل (حدود ۳۰ روز). استک روی سرور مدرسه خاموش یا پاک نمی‌شود؛ فقط از دید پنل کنار می‌رود و قابل بازیابی است. پاک‌سازی نهایی فقط رکورد پنل را حذف می‌کند.

کارها jobs

عملیات پس‌زمینه مثل آماده‌سازی سرور، پروویژن، آپدیت، بکاپ یا پاک‌سازی. لاگ کامل (از جمله docker pull و prune) اینجاست.

مدیا / مدیای محلی

سرویس فایل و رسانه. اگر «مدیای محلی داخل استک» روشن باشد، مدیا روی همان سرور مدرسه بالا می‌آید؛ وگرنه می‌توانید سرور مدیای جدا در تب مدیا تعریف کنید.

قالب سایت website template

نوع ظاهر/سایت عمومی مدرسه (مثلاً آکادمیا، جوانه یا سرو). روی ایمیج وبسایت و تنظیمات اولیه اثر دارد.

دامنهٔ عمومی / دامنهٔ مدیا DNS

آدرسی که کاربر مدرسه با آن وارد می‌شود. رکورد A باید به آی‌پی سرور میزبان اشاره کند؛ وگرنه سایت و گواهی TLS درست کار نمی‌کند.

گواهی TLS / اچ‌تی‌تی‌پی‌اس auto / manual

حالت خودکار: certbot روی سرور مدرسه (نیاز به DNS و پورت ۸۰). اگر صدور اولیه شکست خورد، دکمهٔ «گواهی از اول» دوباره از HTTP شروع می‌کند، در صورت نیاز گواهی قبلی را حذف می‌کند، certbot را اجرا می‌کند و nginx را HTTPS می‌کند. حالت دستی: آپلود فایل‌های fullchain.pem و privkey.pem از پنل؛ فایل‌ها در /etc/raysa/certs/<slug>/ قرار می‌گیرند و nginx TLS رندر می‌شود.

ایمیج وبسایت مدرسه

از منبع مدرسه / تگ قالب می‌آید (مثلاً آکادمیا، جوانه یا سرو در رجیستری). آپدیت مجموعه همان مرجعی را می‌کشد که در تب نسخه‌ها برای وبسایت تنظیم شده است.

داکر کامپوز Docker Compose

ابزاری که چند کانتینر استک مدرسه را با هم تعریف و اجرا می‌کند (pull، up، stop).

انجین‌اکس nginx

پروکسی جلوی استک روی سرور مدرسه: مسیرهایی مثل سایت، /api و نشانک قدیمی /chat را به سرویس درست می‌فرستد.

مالک / اپراتور

مالک همهٔ دسترسی‌ها را دارد و می‌تواند کاربر بسازد. اپراتور با حساب ساخته‌شده توسط مالک وارد می‌شود و کارهای روزمره را انجام می‌دهد؛ ثبت‌نام عمومی وجود ندارد.

نشان زنده / قطع WebSocket

اتصال لحظه‌ای مرورگر به پنل برای به‌روز شدن لاگ کارها بدون رفرش صفحه. «زنده» یعنی این کانال وصل است؛ به سلامت سرور مدرسه ربط مستقیم ندارد.

آروان Arvan Cloud

ارائه‌دهندهٔ ماشین مجازی که معمولاً سرور مدرسه آنجا ساخته می‌شود. حذف مجموعه از پنل، VM آروان را پاک نمی‌کند.

تفاوت‌های مهم

• آماده‌سازی = آماده کردن سرور خالی · پروویژن/دیپلوی = نصب مجموعه روی آن سرور
• چرخه عمر = وضعیت در پنل · وضعیت زنده = وضعیت واقعی کانتینرها روی سرور
• بیلد جدید سی‌آی = فقط در تب نسخه‌ها دیده می‌شود · منبع مدرسه = چیزی که مدارس باید به آن برسند
• تعویض منبع مدرسه = اشارهٔ رجیستری عوض می‌شود · آپدیت مجموعه = کانتینر روی سرور واقعاً عوض می‌شود
• آپدیت کل مجموعه = همهٔ سرویس‌ها · آپدیت روی کارت سرویس = فقط همان سرویس
• ناقص = بعضی سرویس‌ها بالا نیستند · قدیمی = ایمیج با منبع مدرسه یکی نیست
• ثبت از رجیستری فعلی = seed دستی کاتالوگ · گزارش سی‌آی = ثبت خودکار بعد از بیلد
• آپدیت / توقف / دیپلوی / ریستارت / به‌روزرسانی nginx = قبل از اجرا تأیید «مطمئن هستید؟» می‌خواهند
• به‌روزرسانی nginx = قالب فعلی کنترل‌پنل روی همان مدرسه رندر می‌شود · دامنه، گواهی و کانتینرها عوض نمی‌شوند · اگر تست nginx خطا بدهد پیکربندی قبلی برمی‌گردد
• سطل زباله = حذف از فهرست پنل · نه پاک کردن VM و نه خاموش کردن استک مدرسه