116 lines
3.6 KiB
Markdown
116 lines
3.6 KiB
Markdown
# چک‌لیست Deploy — برنچ ماژولار
|
||
|
||
> **ایمنی:** `php artisan migrate` دیگر `mysql-schema.sql` را auto-load نمی‌کند (DROP TABLE نمی‌زند).
|
||
> فایل schema فقط دستی: `database/schema/mysql-schema.sql.reference`
|
||
|
||
## قبل از شروع
|
||
|
||
- [ ] بکاپ DB
|
||
- [ ] کد + SQLهای جدید روی سرور (`baseline_migrations.sql` حتماً نسخه جدید — **۱۱ ردیف**)
|
||
- [ ] `database/migrations/` فقط ۸ فایل `2026_*`
|
||
- [ ] `php artisan config:clear`
|
||
|
||
---
|
||
|
||
## DB موجود — ترتیب
|
||
|
||
```bash
|
||
cd /opt/PROJECT/server
|
||
|
||
DB_HOST=$(grep ^DB_HOST= .env | cut -d= -f2- | tr -d '\r"')
|
||
DB_PORT=$(grep ^DB_PORT= .env | cut -d= -f2- | tr -d '\r"')
|
||
DB_DATABASE=$(grep ^DB_DATABASE= .env | cut -d= -f2- | tr -d '\r"')
|
||
DB_USERNAME=$(grep ^DB_USERNAME= .env | cut -d= -f2- | tr -d '\r"')
|
||
DB_PASSWORD=$(grep ^DB_PASSWORD= .env | cut -d= -f2- | tr -d '\r"')
|
||
|
||
# ۱ baseline
|
||
mysql -h "$DB_HOST" -P "$DB_PORT" -u "$DB_USERNAME" -p"$DB_PASSWORD" "$DB_DATABASE" \
|
||
< database/sql/baseline_migrations.sql
|
||
|
||
# باید ۱۱ ردیف چاپ شود (شامل 2019 و 2021)
|
||
|
||
# ۲ چک DB — اگر کمتر از ۲ بود baseline قدیمی است
|
||
mysql -h "$DB_HOST" -P "$DB_PORT" -u "$DB_USERNAME" -p"$DB_PASSWORD" "$DB_DATABASE" -N -e \
|
||
"SELECT COUNT(*) FROM migrations WHERE migration LIKE '2019%' OR migration LIKE '2021%';"
|
||
|
||
# باید: 2
|
||
|
||
# ۳ status — ۱۰ تا همه Yes
|
||
php artisan migrate:status
|
||
|
||
# ۴ migrate
|
||
php artisan migrate
|
||
|
||
# ۵ settings
|
||
mysql -h "$DB_HOST" -P "$DB_PORT" -u "$DB_USERNAME" -p"$DB_PASSWORD" "$DB_DATABASE" \
|
||
< database/sql/deploy_settings_const.sql
|
||
```
|
||
|
||
**یا:** `bash database/sql/run_deploy_existing_db.sh`
|
||
|
||
### چک بعد از مرحله ۲
|
||
|
||
| خروجی `migrate:status` | کار |
|
||
|------------------------|-----|
|
||
| ۱۰ تا همه **Yes** | ادامه مرحله ۴ |
|
||
| `2019`/`2021` هنوز **No** | `fake_package_migrations.sql` بزن → دوباره status |
|
||
|
||
```bash
|
||
mysql -h "$DB_HOST" -P "$DB_PORT" -u "$DB_USERNAME" -p"$DB_PASSWORD" "$DB_DATABASE" \
|
||
< database/sql/fake_package_migrations.sql
|
||
php artisan migrate:status
|
||
php artisan migrate
|
||
```
|
||
|
||
---
|
||
|
||
## soroushgold — الان (بعد از خطا)
|
||
|
||
```bash
|
||
cd /opt/soroushgold/server
|
||
|
||
mysql -h 127.0.0.1 -P 3030 -u root -p soroushgold \
|
||
< database/sql/fake_package_migrations.sql
|
||
|
||
php artisan migrate:status
|
||
php artisan migrate
|
||
|
||
mysql -h 127.0.0.1 -P 3030 -u root -p soroushgold \
|
||
< database/sql/deploy_settings_const.sql
|
||
```
|
||
|
||
---
|
||
|
||
## DB خالی
|
||
|
||
```bash
|
||
mysql ... < database/schema/mysql-schema.sql.reference
|
||
mysql ... < database/sql/baseline_migrations.sql
|
||
php artisan migrate
|
||
mysql ... < database/sql/deploy_settings_const.sql
|
||
```
|
||
|
||
---
|
||
|
||
## خطاها
|
||
|
||
| خطا | فیکس |
|
||
|-----|------|
|
||
| `Table already exists` | `fake_package_migrations.sql` → `migrate` |
|
||
| `Loading stored database schema` | کد قدیمی — `git pull` (دیگر رخ نمی‌دهد). اگر شد: restore بکاپ |
|
||
| `2019`/`2021` No بعد از baseline | baseline قدیمی → `fake_package_migrations.sql` |
|
||
| `Unknown host HOST` | از `.env` بخوان نه placeholder |
|
||
| `Unknown column 'is_exist'` | `git pull` + دوباره `deploy_settings_const.sql` (نسخه جدید ستون را اضافه می‌کند) |
|
||
|
||
---
|
||
|
||
## فایل‌ها
|
||
|
||
| فایل | کار |
|
||
|------|-----|
|
||
| `baseline_migrations.sql` | ۱۱ migration یکجا |
|
||
| `fake_package_migrations.sql` | فقط 2019 + 2021 |
|
||
| `deploy_settings_const.sql` | settings + const |
|
||
| `fix_migrations_after_failed_migrate.sql` | reset کامل migrations |
|
||
| `run_deploy_existing_db.sh` | اجرای خودکار + چک |
|