رابط خط فرمان (CLI)

رابط خط فرمان و یا همان CLI لیارا، این امکان را به شما می‌دهد که فقط با چند دستور ساده، اپلیکیشن خود را در بستر ابری ما مستقر کنید. اگر با محیط خط فرمان و ترمینال آشنایی ندارید، نگران نباشید. دستوراتی که برای کار با لیارا نیاز خواهید داشت، بسیار مختصر و کوتاه هستند و نیاز به دانش عمیقی ندارند.

نصب و راه‌اندازی

برای نصب، NodeJS و npm باید در کامپیوتر شما نصب شده‌باشند. پیشنهاد ما نسخه‌ی ۸ به بعد NodeJS است.
برای دانلود و نصب NodeJS می‌توانید از لینک مقابل استفاده کنید: وب‌سایت رسمی NodeJS

بعد از نصب NodeJS، با استفاده از دستور زیر، CLI بر روی کامپیوتر شما نصب می‌گردد:

npm install -g @liara/cli

ورود به حساب کاربری

برای این‌که بتوانید از CLI استفاده کنید، لازم است که در ابتدا، با استفاده از اطلاعات حساب کاربری‌تان در لیارا، وارد شوید:

liara login

بعد از وارد کردن دستور بالا، باید ایمیل و رمز عبور کاربری که با آن در لیارا ثبت نام کرده‌اید را وارد کنید.
اگر اطلاعات صحیح باشند، با موفقیت وارد خواهید شد و CLI قابل استفاده خواهد بود.
اگر هنوز ثبت نام نکرده‌اید، می‌توانید از لینک رو به رو اقدام کنید: ثبت نام در لیارا

فایل liara.json

برای این‌که CLI بتواند پروژه‌ی شما را با موفقیت در بستر لیارا مستقر کند، نیاز دارد که اطلاعاتی از پروژه‌ی‌تان داشته‌باشد. شما می‌توانید با ایجاد یک فایل با نام liara.json این اطلاعات را در اختیار CLI قرار بدهید.

نمونه‌ای از فایل liara.json:

{
  "platform": "node",
  "project": "my-project",
  "port": 3000
}

همان‌طور که مشاهده می‌کنید، فیلد project در این فایل، همان شناسه‌ی پروژه‌ای است که می‌خواهید روی آن دیپلوی کنید. در این نمونه، فرض شده‌است که پروژه با NodeJS نوشته شده‌است. به همین دلیل، برای اجرای این پروژه نیاز به پلتفرمnodeوجود دارد. در حال حاظر، پلتفرم‌های زیر قابل استفاده هستند:

  • node
  • laravel
  • react
  • vue
  • angular
  • static
  • wordpress
  • docker

نکته: برای هر پلتفرم، تنظیمات جداگانه‌ای وجود دارد که در بخش مربوط به هر کدام، می‌توانید مشاهده کنید.

مستقر کردن پروژه‌ها

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

$ cd projects/my-project
$ liara deploy

بدون تغییر دادن دایرکتوری فعلی هم می‌توانید با پاس دادن پارامتر--pathپروژه‌ی مورد نظرتان را روی سرورهای لیارا مستقر کنید.

$  liara deploy --path projects/my-project

بعد از این دستور، لیارا سعی می‌کند که نوع پروژه‌ی شما را تشخیص دهد تا بتواند بستر مناسب برای اجرای آن را فراهم کند. مثلا اگر پروژه‌ی شما با Laravel نوشته شده‌است، در ابتدا سعی می‌کند که تشخیص دهد پروژه‌ی شما یک پروژه‌ی لاراولی است و در مرحله‌ی بعد از طریق راه‌اندازی بستر مناسب برای اجرای لاراول مانند نصب کردن PHP و Apache پروژه‌ی شما را اجرا می‌کند.

عملیات استقرار بدون فایل liara.json:

ایجاد فایل liara.json الزامی نیست. شما می‌تونید از طریق پرامترهایی مثل--projectو یا--portپروژه و پورت مدنظرتان را مشخص کنید. در این صورت دیگر cli سوالی در این باره از شما نمی‌پرسد.

$ liara deploy --project my-project --port 5000

نمایش لاگ‌های پروژه بلافاصله بعد از اتمام استقرار

بعد از اجرای دستورliara deploy، اگر عملیات با موفقیت به اتمام برسد، لیارا لاگ‌های پروژه‌ی‌تان را بلافاصله بعد از اتمام استقرار نمایش می‌دهد. با مشاهده‌ی لاگ‌ها می‌توانید مطمئن شوید که پروژه‌ی‌تان به درستی مستقر شده. اگر نیازی به این قابلیت نمی‌بینید و یا این که دستور liara deploy را در محیط CI / CD اجرا می‌کنید، می‌توانید با پارامتر--no-project-logsاین قابلیت را غیر فعال کنید.

$ liara deploy --project my-blog --port 80 --no-project-logs