Deployment

Alur pipelineCopy Anchor Link

Deploy memakai GitLab CI (.gitlab-ci.yml). Cabang menentukan target server.

Superadmin (ESCHOOL_INDUK)Copy Anchor Link

Runner memakai tag laravel dengan PHP 8.3.

API-SekolahCopy Anchor Link

Urutan job deploy productionCopy Anchor Link

Alur antar branch:

Aturan .envCopy Anchor Link

• File .env tidak ikut ter-rsync dan tidak di-track git.
• Setiap server (dev, staging, production) punya .env sendiri dan dibuat manual.
• Setiap server punya database central sendiri.
• Jangan tinggalkan file seperti .env.production di folder deploy.

Perbaikan jika itu terjadi:

php artisan optimize:clear
php artisan config:cache
php artisan route:cache
php artisan view:cache

Struktur folder di serverCopy Anchor Link

/www/wwwroot/<domain>/
├── Eschool-Superadmin/   # kode aplikasi (hasil deploy)
└── storage/              # storage permanen, di-symlink ke aplikasi

Health checkCopy Anchor Link

API-Sekolah menyediakan endpoint:

GET /api/health/db

Koneksi mysql_test hanya dicek di luar staging dan production. Jika has_errors muncul karena mysql_test di staging atau production, itu wajar.

Checklist sebelum deployCopy Anchor Link

• Test lulus
• Migration dicek (tidak merusak data)
• .env di server sudah benar
• Backup database sudah dibuat

Cron dan queueCopy Anchor Link

* * * * * cd /www/wwwroot/<domain>/Eschool-Superadmin && php artisan schedule:run >> /dev/null 2>&1

Untuk API-Sekolah, cache dan queue memakai Redis (CACHE_DRIVER=redis, QUEUE_CONNECTION=redis) sedangkan SESSION_DRIVER=file. Setelah deploy, restart worker:

php artisan queue:restart

RollbackCopy Anchor Link

git checkout <commit-sebelumnya>
php artisan migrate:rollback --step=1
php artisan config:cache