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

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

در این سند​

این راهنما مراحل راه‌اندازی پروژه به صورت محلی با استفاده از Docker را به صورت گام‌به‌گام توضیح می‌دهد. قبل از شروع، مطمئن شوید که Docker را نصب کرده‌اید.

نمای کلی راه‌اندازی پروژه​

کلون کردن پروژه​

ابتدا مخزن پروژه را کلون کرده و وارد مسیر آن شوید:

کلون کردن مخزن
git clone https://github.com/BemoBit/planet-project.git
cd /your-path/project
هشدار

مسیر /your-path/project را با مسیر واقعی موردنظر خود جایگزین کنید.

تنظیم فایل محیط (Environment)​

فایل نمونه .env را کپی کنید تا فایل تنظیمات خود را بسازید:

ایجاد فایل محیط
cp .env.example .env
نکته

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

ساخت و اجرای کانتینرهای Docker​

از دستورات زیر برای ساخت و اجرای کانتینرها استفاده کنید:

ساخت و اجرای کانتینرها
docker compose build
docker compose up -d

مطمئن شوید همه سرویس‌ها به درستی اجرا می‌شوند:

بررسی وضعیت کانتینرها
docker compose ps  # بررسی وضعیت سرویس‌ها
خروجی مورد انتظار

باید همه سرویس‌ها را در حالت "running" مشاهده کنید.

NAME                COMMAND                  SERVICE             STATUS              PORTS
lsp_app             "docker-php-entrypoi…"   app                 running             0.0.0.0:8080->80/tcp
lsp_mysql           "docker-entrypoint.s…"   mysql               running             0.0.0.0:3306->3306/tcp
lsp_redis           "docker-entrypoint.s…"   redis               running             0.0.0.0:6379->6379/tcp

نصب وابستگی‌های PHP​

دستور زیر را داخل کانتینر lsp_app اجرا کنید تا وابستگی‌های PHP نصب شوند:

نصب وابستگی‌های PHP
docker exec -it -u root lsp_app composer install
یادداشت

در صورت درخواست GitHub token، توکن خود را وارد کنید. برای نصب برخی وابستگی‌ها نیاز به توکن است.

نصب وابستگی‌های Node.js​

وابستگی‌های مورد نیاز فرانت‌اند را نصب کنید:

نصب وابستگی‌های Node.js
docker exec -it -u root lsp_app npm install

اجرای مایگریشن‌ها​

برای ساختاردهی دیتابیس، مایگریشن‌ها را اجرا کنید:

اجرای مایگریشن دیتابیس
docker exec -it -u root lsp_app php artisan migrate
گزینه‌های مایگریشن

اگر نیاز به ریفرش دیتابیس (حذف همه جداول و اجرای مجدد مایگریشن‌ها) داشتید:

docker exec -it -u root lsp_app php artisan migrate:fresh

برای seed کردن دیتابیس با داده نمونه:

docker exec -it -u root lsp_app php artisan db:seed

برای ریفرش و seed همزمان:

docker exec -it -u root lsp_app php artisan migrate:fresh --seed

تولید کلید برنامه​

کلید رمزنگاری برنامه را تولید کنید:

تولید کلید برنامه
docker exec -it -u root lsp_app php artisan key:generate

لینک کردن پوشه ذخیره‌سازی​

پوشه ذخیره‌سازی فایل‌ها را لینک کنید:

لینک کردن پوشه storage
docker exec -it -u root lsp_app php artisan storage:link

کامپایل دارایی‌های فرانت‌اند​

برای توسعه، دارایی‌ها را کامپایل کنید:

کامپایل دارایی‌ها برای توسعه
docker exec -it -u root lsp_app npm run dev
آخرین به روز رسانی در تاریخ توسط Behnam Moradi