استقرار اولیه Kutt
راهاندازی اولیه سرویس
در این بخش می خواهیم آموزش نحوه استقرار اولیه Kutt را به شما آموزش دهیم. همانطور که در گیف زیر مشاهده میکنید،
ابتدا میبایست Kutt را در سرویس داکر راه اندازی کنیم. برای اینکار ابتدا به پنل کاربری مراجعه کرده و به قسمت ساخت
سرویس جدید > هاست ابری > Docker میرویم.
سپس در مرحله بعد یعنی پیکربندی سرویس، اسم Image را قرار داده و مراحل بعد را تا ساخت سرویس پیش میبریم.
kutt/kutt:v3.2.6
دقت کنید که Dockerfile این سرویس در قسمت مدیریت فایلها موجود است و در صورت نیاز میتوانید آن را ویرایش کنید.
روشهای استقرار برنامه
سرویسهای هاست ابری چابکان به روشهای مختلفی امکان استقرار را دارا هستند، این شما هستید که میتوانید انتخاب کنید کدام روش برای شما مناسبتر میباشد، برای آشنایی با هر کدام از روشهای استقرار میتوانید از لیست زیر اقدام به مطالعه بیشتر بفرمایید:
اگر سرویس خود را از طریق cli چابکان استقرار داده اید حتما صفحه تنظیمات مسیرهای دائمی را نیز مطالعه بفرمایید که هم با فرآیند deploy از طریق cli بیشتر آشنا شوید و هم مشکلی برایتان ایجاد نشود.
تعریف دیسک
اطلاعات برنامه Kutt در دیتابیس ذخیره میشوند اما برای شخصیسازی این برنامه باید مسیر /kutt/custom/ را به صورت **دیسک
** تعریف کنید.
تنظیم دیتابیس
برنامه Kutt برای اجرا به دیتابیس نیاز دارد که میبایست برای اتصال به آن تنظیمات زیر را انجام دهید:
SQLite
PostgreSQL
MariaDB
برای استفاده از دیتابیس SQLite نیاز به نصب ابزار خاصی در این سرویس نیست. Kutt به صورت پیشفرض از
دیتابیس SQLite پشتیبانی میکند. تنها میبایست مسیری را انتخاب کنید تا فایل sqlite در آن قرار بگیرد. برای سادگی
پیشنهاد
میکنیم که آدرس فایل sqlite را در مسیر /kutt/db انتخاب کنید. برای مثال در اینجا مسیر /kutt/db/kutt.db را انتخاب
میکنیم.
حتما مسیر انتخابشده یا مسیر والد آن را به صورت دیسک تعریف کنید تا با ریاستارت سرویس، اطلاعات دیتابیس از بین نروند.
اطلاعات دیتابیس را در قسمت متغیرهای محیطی تنظیمات سرویس وارد کنید:
DB_CLIENT=better-sqlite3
DB_FILENAME=/kutt/db/kutt.db
در هر لحظه میتوانید از دیتابیس ابری PostgreSQL چابکان استفاده کنید. برای راهاندازی دیتابیس ابری چابکان این مستند را مطالعه کنید.
اطلاعات دیتابیس را د ر قسمت متغیرهای محیطی تنظیمات سرویس وارد کنید:
DB_CLIENT=pg
DB_HOST=$HOST
DB_PORT=$PORT
DB_USER=$USERNAME
DB_NAME=$DB_NAME
در هر لحظه میتوانید از دیتابیس ابری MariaDB چابکان استفاده کنید. برای راهاندازی دیتابیس ابری چابکان این مستند را مطالعه کنید.
اطلاعات دیتابیس را در قسمت متغیرهای محیطی تنظیمات سرویس وارد کنید:
DB_CLIENT=mysql2
DB_HOST=$HOST
DB_PORT=$PORT
DB_USER=$USERNAME
DB_NAME=$DB_NAME
مقدارهای HOST، PORT، USERNAME, PASSWORD و DB_NAME را بر اساس اطلاعات دیتابیس خود در متغیرهای محیطی
جایگزین کنید.
حتما پس از وارد کردن متغیرهای محیطی روی دکمه ذخیره تغییرات کلیک کنید.
تنظیم متغیرهای محیطی
برای راهاندازی Kutt میبایست حتما متغیر محیطی زیر را تنظیم کنید:
DEFAULT_DOMAIN=your-domain.com
JWT_SECRET=your-secret-token-which-should-not-be-exposed-at-all
مقدار DEFAULT_DOMAIN را میتوانید با مراجعه به دامنهی خود در داشبورد سرویس مشاهده کنید و یا دامنهی اختصاصی خود
را بر روی سرویس تنظیم نمایید. (تنظیم دامنه)
تعریف پورت
برنامه Kutt روی پورت 3000 فعال میشود و باید آن را در قسمت پورتها مشخص کنیم تا برنامه در دسترس قرار بگیرد.
حال سرویس شما آماده استفاده است و میتوانید با مراجعه به دامنهی خود در داشبورد سرویس، خروجی را مشاهده کنید و یا دامنهی اختصاصی خود را بر روی سرویس تنظیم نمایید. (تنظیم دامنه)
ساخت حساب کاربری مدیر
پس از مراجعه به دامنه سرویس با دیدن این صفحه متوجه میشویم که Kutt با موفقیت راهاندازی شده است. حال میبایست یک حساب
کاربری برای مدیر تعریف کنید. سپس با مشخصات Email و Password میتوانید وارد برنامه شوید.
امکانات عمومی سرویس
اگر میخواهید با امکانات عمومی سرویسهای چابکان مثل بکاپ خودکار، گزارش مصرف، لاگها و تنظیمات سرویس آشنا شوید، مستند امکانات عمومی سرویسها را مطال عه کنید.
