Metabase External Database

برنامه Metabase-external-database نسخه پردازشی و فاقد پایگاه‌داده داخلی این ابزار هوش تجاری (BI) است. در این معماری، پلتفرم ابری پارس‌پک تنها کانتینر اصلی metabase را مستقر می‌کند. این سرویس جهت ذخیره‌سازی داده‌های ساختاری خود (فراداده‌ها، تنظیمات داشبوردها و مشخصات کاربران) باید به‌صورت مستقیم به یک پایگاه‌داده خارجی در شبکه‌ای دیگر (مانند کلاسترهای ابری مجزا شامل MySQL، MariaDB یا PostgreSQL) متصل شود.

مراحل استقرار

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

پیش‌نیازها و استقرار برنامه

در استقرار کانتینری Metabase با دیتابیس خارجی، معماری سیستم دارای الزامات و حساسیت‌های زیر است که باید در زمان دیپلوی به آن‌ها توجه کنید:

  • عملکرد بدون وضعیت (Stateless): این کانتینر فاقد دیسک محلی برای ذخیره تنظیمات است و وابستگی قطعی به در دسترس بودن دیتابیس خارجی شما دارد. هرگونه قطعی در ارتباط شبکه یا افتادن سرور مقصد، منجر به از کار افتادن فوری داشبوردهای متابیس خواهد شد.

  • سطح دسترسی سیستمی: کانتینر برنامه جهت رعایت الزامات امنیتی پلتفرم، با سطح دسترسی کاربر عادی (Non-Root) اجرا می‌شود و امکان تغییرات در لایه سیستم‌عامل کانتینر وجود ندارد.

  • مسئولیت بکاپ‌گیری داده‌ها: فعال‌سازی قابلیت بکاپ خودکار در این سرویس، تنها از فایل‌های سیستمی و موقت کانتینر پشتیبان می‌گیرد. وظیفه بکاپ‌گیری از فراداده‌ها، نمودارها و تنظیمات داشبوردها تماماً بر عهده سرور دیتابیس خارجی شماست و پلتفرم پارس‌پک دسترسی به لایه داده‌های آن ندارد.

  • تخصیص منابع پردازشی: پلن پایه این ابزار تحلیلی از ۳ گیگابایت رم شروع می‌شود. با افزایش تعداد کوئری‌ها و حجم نمودارهای داشبورد، ارتقای منابع رم و پردازنده از طریق اسلایدرهای شخصی‌سازی منابع الزامی است.

پارامترهای اتصال (Connection Parameters)

در این نسخه، علاوه بر تعیین نام پروژه، نام اپلیکیشن و نام دامنه (Sub-domain)، باید متغیرهای اتصال (Connection Parameters) زیر را دقیقا مطابق با سرور مقصد تنظیم کنید:

نام پارامتر توضیح دقیق مثال
metabase external database host آدرس سروری که دیتابیس روی آن نصب شده است. می‌توانید آن را بدون protocol (فقط نام میزبان یا IP) وارد کنید، زیرا متابیس خودش از طریق اتصال TCP با دیتابیس ارتباط می‌گیرد. app-mariadb-p94j5.com
metabase external database name نام دیتابیسی که می‌خواهید metadata مانند اطلاعات داشبورد و غیره روی آن ذخیره شود parspack-metabase-demo
metabase external database password رمز عبور مربوط به کاربر دیتابیس. این رمز در متابیس به‌صورت رمزنگاری‌شده ذخیره می‌شود. test-password
metabase external database username نام کاربر دیتابیس که می‌خواهید metadata مانند اطلاعات داشبورد و غیره روی آن ذخیره شود user
metabase external database port پورتی که دیتابیس روی آن در حال گوش‌دادن (listening) است. مقدار پیش‌فرض معمولاً به نوع دیتابیس بستگی دارد PostgreSQL → 5432
MySQL/MariaDB → 3306
External database for metabase using ssl اگر دیتابیس شما نیاز به اتصال امن دارد، این گزینه را فعال کنید تا ارتباط با رمزنگاری SSL برقرار شود. True
metabase external database type نوع دیتابیس مقصد Mariadb
Mysql
postgres
نکته: در صورتی که تمایل دارید متغیرهای محیطی پیشرفته دیگری را به صورت شخصی‌سازی‌شده به این کانتینر اضافه کنید، به مستندات متغیرهای محیطی مراجعه نمایید.

تنظیمات دامنه

کانتینر متابیس برای لود کردن کامل المان‌های وب و برقراری ارتباط با کلاینت‌ها نیاز به یک آدرس معتبر دارد. پس از اتمام استقرار، حتما دامنه یا ساب‌دامین اختصاصی خود را به این سرویس متصل کنید. جهت انجام این کار به راهنمای تنظیمات دامنه و IP مراجعه نمایید.

راه‌اندازی و ورود اولیه

پس از ۱۰۰٪ شدن نوار پیشرفت بیلد، کانتینر تلاش می‌کند با متغیرهای واردشده به دیتابیس شما متصل شود. در صورت صحت اطلاعات، مراحل زیر را طی کنید:

  1. آدرس دامنه اختصاصی خود را در مرورگر باز کنید.
  2. در صورت اتصال درست به دیتابیس خارجی، صفحه خوش‌آمدگویی متابیس لود شده و دکمه Let’s get started نمایش داده می‌شود.
    • نکته: اگر صفحه باز نشد، ابتدا لاگ‌های کانتینر را از نظر خطای Network Connection یا اشتباه بودن رمز دیتابیس بررسی کنید.

  3. در گام‌های بعد، اطلاعات فردی و یک رمز عبور قدرتمند برای ساخت اکانت ادمین تعیین کنید. این اکانت کلید ورود دائم شما به داشبورد خواهد بود.
  4. پس از اتمام راه‌اندازی، وارد پیشخوان اصلی شده و می‌توانید ساخت ابزارهای هوش تجاری خود را آغاز کنید.