پرش به مطلب اصلی

نصب module

ماژول K3Core یک هسته مرکزی برای مدیریت موجودیت‌های کانتینری است که به صورت ماژول نود طراحی شده و می‌تواند در پروژه‌های دیگر استفاده شود. این ماژول دارای زیرسیستم‌های کوچکتری است که وظایف مختلفی مانند مدیریت کانتینر، شبکه، ایمیج و حجم (volume) را انجام می‌دهند.

۱. کلون کردن ریپازیتوری​

git clone https://github.com/KamanAiCo/K3.git
cd K3

۲. کامپایل پروژه اصلی​

sudo make install

اگر قبلاً پروژه را نصب کرده‌اید، ابتدا دستور زیر را اجرا کنید تا نسخه قبلی پاک شود:

sudo make clean

سپس دوباره دستور نصب را وارد کنید.

۳. 📂 ساختار داخلی​

ماژول K3Core شامل چهار بخش اصلی است:

نام زیرماژولوظیفه اصلیمستندات
containerCoreمدیریت کانتینرها (ساخت، حذف، لیست، جزئیات و...)
networkCoreمدیریت شبکه‌ها برای کانتینرها
imageCoreمدیریت ایمیج‌های کانتینری
volumeCoreمدیریت حجم‌ها (Volumes) برای ذخیره داده

۴. 📦 نصب و استفاده​

cd /opt/k3/src/core
sudo npm link

نکته: این بخش به صورت پیش فرض در زمان نصب انجام خواهد شد. در پروژه مقصد:

npm link k3-core

استفاده در کد:​

const K3Core = require('k3-core');

(async () => {
  const k3 = new K3Core();
  const containers = await k3.containerCore.listContainers();
  console.log(containers);
})();

۵. 🚫 مدیریت خطا​

تمام توابع به صورت Promise طراحی شده‌اند و از try/catch برای مدیریت خطا استفاده شود:

try {
  const images = await k3.imageCore.listImages();
} catch (err) {
  console.error("خطا در دریافت ایمیج‌ها:", err.message);
}

✅ اکنون پروژه آماده‌ی اجرا است.