مستندات هاست آماده جانگو

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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