مستندات هاست آماده جاوااسکریپت

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

گام‌های راه اندازی پروژه جاوااسکریپت

گام ۱ :

ایجاد پروژه

بعد از ثبت‌نام یا ورود به لکسویا، از منوی سمت راست گزینه‌ی «پروژه‌ها» را انتخاب کنید. در صورتی که قبلاً پروژه‌ای اضافه کرده باشید، در این صفحه آن را مشاهده خواهید کرد. برای مشاهده جزئیات هر پروژه، روی پروژه‌ی مورد نظر کلیک کنید. همچنین، برای افزودن پروژه جدید، دکمه‌ی ایجاد را فشار دهید.

گام ۲ :

اتصال حساب گیت برای اولین بار (مرحله اول)

اگر قبلا حساب گیت خود را در لکسویا اضافه کردید، مستقیما به گام۴ بروید. برای اضافه کردن سرور گیت خود به لکسویا دکمه‌ی اضافه کردن حساب گیت را بزنید.

گام ۳ :

اتصال حساب گیت برای اولین بار (مرحله دوم)

در این گام، ورژن کنترلی که پروژه‌تان در آن قرار دارد را انتخاب کنید. با انتخاب هر گزینه، وارد سایت مربوطه خواهید شد و باید اجازه دهید تا حساب لکسویا به حساب گیت شما متصل شود. پس از انجام این مرحله، دوباره به لکسویا باز می‌گردید. اگر از گیت اختصاصی استفاده می‌کنید، گزینه‌ی self-hosted را انتخاب کنید. با انتخاب این گزینه، پنجره‌ای باز می‌شود که باید اطلاعات سرور گیت خود را وارد کنید. علاوه بر این، باید کلید دسترسی (SSH key) حساب گیت خود را نیز وارد کنید. در صورتی که حساب شما کلید دسترسی ندارد، باید یکی بسازید. پس از وارد کردن مشخصات، دوباره به سایت لکسویا باز خواهید گشت.

گام ۴ :

انتخاب حساب گیت پروژه

از میان حساب‌های گیت خود( قبلا اضافه کردید) آن حسابی که پروژه شما در آن است را انتخاب کرده و دکمه‌ی «بعدی» را بزنید.

گام ۵ :

انتخاب پروژه و برنچ

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

گام ۶ :

انتخاب زبان و ورژن پروژه

در این گام زبان یا فریم‌ورک و ورژن پروژه‌ی خود را انتخاب کنید و دکمه‌ی بعدی را بزنید. اگر از ورژن فریم‌ورک خود مطمئن نیستید می‌توانید بعد از ساخت پروژه آن را ویرایش کنید.

گام ۷ :

وارد کردن متغیرهای محلی (ENV):

یکی از استانداردهای رایج هنگام دیپلوی پروژه این است که متغیرهای محیطی (ENV) که در محیط‌های مختلف پروژه (مانند استیجینگ، پروداکشن و غیره) متفاوت هستند، به‌طور مستقیم در کد پروژه تنظیم نشوند. در عوض، این متغیرها باید به‌صورت متغیرهای محلی به پروژه معرفی شوند. برای مثال، تنظیمات مربوط به دیتابیس، درگاه بانکی، درگاه پیامکی و موارد مشابه باید به‌صورت متغیرهای محلی تعیین شوند. در این مرحله، متغیرهای محلی خود را وارد کرده و سپس دکمه‌ی ایجاد را بزنید.

گام ۸ :

ورود به پنل مدیریتی پروژه

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

گام ۹ (اختیاری) :

مشخصات بخش پایپلاین

در قسمت پایپلاین می‌توانید پایپلاین‌های پروژه‌ی خود را مشاهده کنید. هر پایپلاین شامل این مشخصات است: وضعیت: پایپلاین در چه وضعیتی قرار دارد. پایپلاین یکی از وضعیت‌های زیر را می‌تواند داشته باشد: In progress: زمانی که پایپلاین در حال اجراست. Failed: زمانی که یکی از مراحل پایپلاین با خطا مواجه شده است و پایپلاین با خطا متوقف شده. Canceled: پایپلاین جدیدی ساخته شده است و این پایپلاین اجرا نشده. Successful: تمامی مراحل پایپلاین با موفقیت به اتمام رسیده است. کامیت: کامیتی که در گیت با آن پوش انجام شده را نشان می‌دهد. اجرا کننده: نشان می‌دهد چه کسی این پایپلاین را ساخته است. اجراکننده اغلب همان‌کسی است که کد جدید را پوش کرده است. البته گاهی بخاطر تغییر تنظیمات پایپلاین جدیدی ساخته می‌شود. مراحل: هر پایپلاین ۴ مرحله دارد: کلون (clone): در این مرحله کد جدید از گیت کلون می‌شود. بیلد (build): در این مرحله کد کلون شده بیلد می‌شود. این مرحله برای تکنولوژی‌های مختلف متفاوت است. در این مرحله پیش‌نیازهای پروژه‌ قبل از اجرای دستور بیلد گرفته می‌شوند. برای مثال برای پروژه‌های nodejs دستور npm run build ابتدا اجرا شده تا دپندنسی‌ها دانلود شوند و سپس دستور npm run build اجرا می‌شود تا پروژه‌ بیلد شود. پوش (push): در این مرحله خروجی ساخته شده در مرحله‌ی قبل به رجیستری پوش می‌شود. دیپلوی (deploy): در این مرحله نسخه‌ی جدید بیلد شده روی پلتفرم جایگزین نسخه‌ قبلی می‌شود. استراتژی دیپلوی پیش‌فرض rolling-release است. به این معنی که ابتدا نسخه‌ی جدید اجرا می‌شود و در صورت اجرای موفق جریان ترافیک درخواست‌ها از پروژه‌ی قدیم به پروژه‌ی جدید منتقل می‌شود. در صورت موفقیت آمیز بودن مراحل نسخه‌ی قدیم متوقف می‌شود. در این استراتژی در صورتی که نسخه‌ی جدید مشکلی داشته باشد و با موفق اجرا نشود نسخه‌ی قبلی در حال اجرا باقی خواهد ماند.

گام ۱۰ (اختیاری) :

مشاهده لاگ پروژه

در قسمت لاگ‌ها می‌توانید لاگ‌های پروژه‌ی خود را مشاهده کنید. بعد از اجرا شدن هر پایپلاین و استقرار نسخه‌ی جدید یا بعد از هر ری‌استارت لاگ‌ها ریست می‌شوند. برای اینکه لاگ همه‌ی نسخه‌ها را ذخیره کنید با از ابزارهای لاگ منیجمنت استفاده کنید

گام ۱۱ (اختیاری) :

اجرای دستور در بخش کنسول

در قسمت کنسول می‌توانید دستورات مورد نیاز را اجرا کنید. پروژه‌هایی مثل لاراول گاهی نیاز دارند که دستور php artisan اجرا کنند. کنسول امکان اجرای دستورات را فراهم می‌کند.

گام ۱۲ (اختیاری) :

مانیتورنیگ منابع مصرفی پروژه

در قسمت مانیتورینگ نمودار مصرف منابع CPU، RAM، دیسک و شبکه را در بازه‌های مختلف می‌توانید مشاهده کنید.

گام ۱۳ (اختیاری) :

افزودن دیسک و والیوم به پروژه

اگر پروژه‌ی شما نیاز به ذخیره‌سازی فایل‌ها دارد، می‌توانید از بخش دیسک‌ها یک دیسک ساخته و آن را در مسیر مورد نظر مونت (Mount) کنید. گزینه‌ی دیگر و پیشنهادی برای ذخیره‌سازی فایل‌ها، استفاده از سرویس S3 است. در صورتی که از S3 یا دیسک (Volume) استفاده نکنید، فایل‌هایی که کاربران آپلود می‌کنند در سرور ذخیره نخواهند شد و پس از هر ری‌استارت یا اجرای پایپلاین جدید (که منجر به استقرار نسخه‌ی جدید می‌شود)، این فایل‌ها پاک می‌شوند. برای افزودن دیسک: روی دکمه‌ی + اضافه کردن کلیک کنید. در دیالوگ باز شده، نام دیسک، اندازه‌ی آن و مسیری که باید در آن مونت شود را انتخاب کنید. دکمه‌ی ایجاد را بزنید. توجه: این عملیات باعث ری‌استارت شدن پروژه خواهد شد. برای اتصال دیسک موجود به پروژه: پس از کلیک روی دکمه‌ی + اضافه کردن، از بالای دیالوگ گزینه‌ی موجود را انتخاب کنید تا دیسک‌های موجود نمایش داده شوند. دیسک مورد نظر و مسیر مونت آن را انتخاب کرده و دکمه‌ی ایجاد را بزنید.

گام ۱۴ (اختیاری) :

ویرایش نام پروژه

در قسمت تنظیمات امکان تغییر نام پروژه را دارید. برای این کار، نام جدید را وارد کرده و دکمه‌ی تغییر را بزنید.

گام ۱۵ (اختیاری) :

افزودن دامنه به پروژه

در قسمت تنظیمات امکان تنظیم کردن دامنه برای پروژه را دارید. برای این کار در قسمت URL دامنه‌ی مورد نظر خود را بدون http‌ و / وارد کنید و سپس دکمه‌ی ذخیره را بزنید. توجه داشته باشید پس از انجام این مرحله نیاز است که تنظیمات مربوط به nameserver خود را هم انجام دهید تا ترافیک این دامنه به این پروژه هدایت شود.

گام ۱۶ (اختیاری) :

افزودن یا ویرایش متغیرهای محلی(ENV)

در قسمت تنظیمات امکان اضافه کردن و تغییر متغیرهای محلی (Env) وجود دارد. بعد از اضافه کردن یا تغییر متغیر دکمه‌ی «تغییر دادن Env» را بزنید. در صورتی که اعمال تغییرات جدید نیازمند ری‌استارت باشد، پروژه با زدن این دکمه ری‌استارت می‌شود

گام ۱۷ (اختیاری) :

تغییر مکان بیلد پروژه

در قسمت تنظیمات امکان تغییر مکان بیلد پروژه وجود دارد. برای این کار از منوی مکان بیلد یکی از گزینه‌های «Iran» یا «Germany» را انتخاب کرده سپس دکمه‌ی ذخیره را بزنید. در صورتی که پروژه‌ی شما در آلمان است از مکان بیلد آلمان استفاده کنید. ولی در صورتی که پروژه‌ی شما در ایران است می‌توانید از یکی از این دو مکان بیلد استفاده کنید. در صورتی که بیلد پروژه‌ی ایران شما بخاطر تحریم با خطا مواجه می‌شود مکان بیلد را به آلمان تغییر دهید.

گام ۱۸ (اختیاری) :

ویرایش نسخه پروژه

در قسمت تنظیمات امکان تغییر نسخه تکنولوژی پروژه وجود دارد. برای این کار از منوی نسخه، نسخه مورد نظر خود را انتخاب کرده و دکمه‌ی ذخیره را بزنید. با تغییر ورژن، پایپلاین جدید ساخته خواهد شد و بعد از اتمام پروژه شما با نسخه‌ی تکنولوژی‌ جدید مستقر شده است. سعی کنید همیشه از بروزترین نسخه‌ی موجود تکنولوژی برای پروژه‌ی خود استفاده کنید.

گام ۱۹ (اختیاری) :

اختیاری کردن دیپلوی (CD) پروژه

در قسمت تنظیمات امکان فعال کردن CD دستی برای پروژه وجود دارد. با فعال کردن این گزینه، استقرار اتوماتیک برای پروژه‌ی شما غیرفعال می‌شود و فقط مراحل بیلد پروژه (CI) برای پروژه‌ انجام می‌شود و مرحله‌ی استقرار (CD) به صورت اتوماتیک انجام نمی‌شود. در صورت نیاز به دیپلوی (استقرار) این نسخه، شما باید به صورت دستی دکمه دیپلوی را در قسمت پایپلاین بزنید. این فیچر برای مواقعی که دیپلوی اتوماتیک باعث اختلال در عملکرد برنامه‌ی شما می‌شود مفید است (گاهی ورکرها نباید بصورت اتوماتیک دیپلوی شوند).

گام ۲۰ (اختیاری) :

وارد کردن هدر

شما می‌توانید به راحتی هدر کورس‌های مورد نیاز را در فیلد‌های مربوطه قرار دهید.

گام ۲۱ (اختیاری) :

راه‌اندازی مجدد پروژه

برای ری‌استارت پروژه، از قسمت عملیات (بالا سمت چپ صفحه) دکمه‌ی ری‌استار رو بزنید. با زدن این دکمه ابتدا نسخه‌ی جدیدی از پروژه ساخته شده و بعد از آن نسخه قبلی حذف می‌شود. زدن این دکمه باعث قطع پروژه نمی‌شود. در صورتی که پروژه چند رپلیکا داشته باشد این روند برای همه‌ی رپلیکاها به ترتیب انجام می‌شود.

گام ۲۱ (اختیاری) :

افزایش یا کاهش رپلیکا پروژه

برای افزایش رپلیکاهای پروژه، از قسمت عملیات (بالا سمت چپ صفحه) دکمه‌ی رپلیکا رو بزنید و تعداد رپلیکای مورد نظر را انتخاب و دکمه‌ی تغییر را بزنید. رپلیکا تعداد اجراهای پروژه را نشان می‌دهد. در صورتی که رپلیکای پروژه ۲ باشد دو نسخه از پروژه اجرا شده و درخواست‌ها بین این دو تقسیم (لودبالانس) می‌شوند. اصطلاحاً به این نوع افزایش پروژه Horizontal Scaling می‌گویند. این مورد برای رسیدن به HA جزو ملزومات است. زمانی که پروژه به حداکثر تعداد درخواست‌های ممکنش برسد با افزایش رپلیکا و استفاده از فیچر تقسیم بار (لودبالانسینگ) می‌توانید ظرفیت پردازش درخواست‌های پروژه را چند برابر کنید. منابع CPU و RAM همه‌ی رپلیکاها برابر می‌باشد. در صورتی که تعداد رپلیکا رو به صفر تغییر دهید پروژه متوقف خواهد شد.

گام ۲۲ (اختیاری) :

تغییر منابع پروژه

برای افزایش منابع پروژه، از قسمت عملیات (بالا سمت چپ صفحه) دکمه‌ی افزایش منابع رو بزنید و منابع را تغییر دهید و دکمه‌ی تغییر را بزنید. در صورتی که منابع پروژه شما از ۸۰ درصد بیشتر شده از منابع پروژه خود را افزایش دهید. بهترین عملکرد پروژه زمانی‌ست که منابع آن کمتر از ۸۰ درصد باشد. توجه داشته باشید که در صورتی که پروژه‌ی شما چند رپلیکا داشته باشد و منابع آن را افزایش دهید، منابع همه رپلیکاها به مقداری که تغییر دادید، افزایش می‌یابد. به این نوع افزایش پروژه اصطلاحاً Vertical Scaling می‌گویند.

گام ۲۳ (اختیاری) :

قفل کردن پروژه

برای قفل کردن پروژه، از قسمت عملیات (بالا سمت چپ صفحه) دکمه‌ی قفل رو بزنید تا پروژه قفل بشه. قفل کردن پروژه از حذف پروژه جلوگیری می‌کنه. اگه نیاز به حذف داشتید باید ابتدا قفل پروژه رو باز کنید.

گام ۲۴ (اختیاری) :

حذف پروژه

در صورتی که نیاز به حذف پروژه داشتید، از قسمت عملیات (بالا سمت چپ صفحه) دکمه‌ی حذف رو بزنید. با زدن این دکمه پروژه شما با همه دیسک‌های اون برای همیشه پاک میشه. خیلی دقت کنید موقع زدن این دکمه. در صورتی که پروژه قفل باشه این گزینه کار نمی‌کنه و نیازه که اول قفل پروژه رو باز کنید بعدش حذف رو بزنید.

سوالات متداول

تکنولوژی پروژه من تو لیست تکنولوژی‌های لکسویا نیست. چیکار کنم؟

برای هر تکنولوژی که تو لیست ما نیست می‌تونید از نوع Docker استفاده کنید. لازمه که توی پروژه‌تون Dockerfile برای پروژه نوشته باشید و موقع ساخت این فایل رو انتخاب کنید تا توسط اون پروژه‌تون بیلد و دیپلوی بشه.

امکان افزودن و اتصال چند دامنه به یک پروژه وجود دارد؟

درحال حاضر امکان چنین کاری نیست.

امکان تغییر شاخه (branch) پروژه وجود داره؟

خیر. هر پروژه فقط به یک برنچ تخصیص یافته است. بنابراین برای هر برنچ باید یک پروژه بسازید.

آیا از پروژه من بکاپ گرفته می‌شود؟

در لکسویا هر شب از دیسک‌های متصل به پروژه بکاپ گرفته می‌شود که شما می‌توانید در بخش بکاپ سایت آن را مشاهده کنید. سایر بخش‌های پروژه هم نیازی به بکاپ ندارند.