Doc_chelvyn/Mito/Sfa/Deploy & Setup/SFA CMS — Deployment VPS MI...

361 lines
14 KiB
Markdown

---
judul: SFA CMS — Deployment VPS MITO
proyek: SFA CMS
terkait: Mito
stack: Laravel · Filament · PHP 8.3 · Nginx · MySQL
server: AWS EC2 16.79.56.41 (shared dengan 4 instance Odoo Docker)
kategori: Deploy & Setup
status: Instalasi baru jalan — belum ada domain, SSL, & backup
tipe: dokumen-internal
tags:
- sfa
- cms
- deployment
- vps
- laravel
- security
---
> Index: [[SFA — Index]] · Kategori: **Deploy & Setup**
>
> Setup production SFA-CMS untuk client MITO di VPS yang **sama dengan server Odoo**.
> Ditulis supaya orang yang belum pernah pegang server ini bisa langsung lanjut kerja.
> Untuk kerja di laptop: [[SFA CMS — Setup Development Lokal]]
# Dokumentasi Deployment SFA-CMS — VPS MITO
> Dokumen ini menjelaskan setup production SFA-CMS untuk client **MITO** di VPS
> yang sama dengan server Odoo. Ditulis supaya tech lain yang belum pernah
> pegang server ini bisa langsung paham konteks & lanjut kerja tanpa harus
> explore ulang dari nol.
---
## 1. Konteks Penting — Baca Ini Dulu
VPS ini **bukan server baru khusus CMS** — ini adalah VPS yang sudah lama
dipakai untuk menjalankan **4 instance Odoo (Docker)** untuk beberapa client,
dan ternyata juga sudah punya **instalasi SFA-CMS produksi lama** untuk client
MITO dan STEIN yang berjalan native (bukan Docker).
**Deployment baru yang dibuat di sesi ini SENGAJA dipasang terpisah** dari
instalasi lama, memakai path dan domain akses yang berbeda, karena instalasi
lama masih punya data produksi asli yang substansial (lihat [§5](#5-instalasi-lama-yang-masih-hidup---jangan-diganggu)).
**Jangan asumsikan salah satu adalah "yang lama" yang aman dihapus** tanpa
konfirmasi ke tim/senior dulu.
---
## 2. Spesifikasi Server
| Item | Value |
|---|---|
| Provider | AWS EC2 |
| Public IP | `16.79.56.41` |
| Hostname internal | `ip-172-31-21-236` |
| OS | Ubuntu (PHP 8.3.26, Nginx 1.24.0, MySQL Community Server) |
| Web server | Nginx (native, **bukan** di-container) |
| Database | MySQL native (native, terpisah dari Postgres yang dipakai Odoo) |
### Port yang sudah terpakai di server ini (cek sebelum pakai port baru!)
| Port | Dipakai oleh |
|---|---|
| 22 | SSH |
| 80, 443 | Nginx (multi-site: `cms.mito.co.id`, `cms.stein.co.id`, `devmito.sinerka.id`, dan default_server SFA-CMS baru) |
| 3306 | MySQL (⚠️ lihat catatan security [§8](#8-catatan-security-belum-dibereskan)) |
| 3000, 3001 | Node.js API pendamping CMS lama (MITO & STEIN, endpoint `/api/sfa`) |
| 8069 | Docker — Odoo utama |
| 8080 | Docker — Odoo instance "stein" |
| 8081 | Docker — Odoo instance "injeksi" |
| 8090 | Docker — Odoo instance "mitra" |
Cek cepat kalau butuh tahu port mana yang masih kosong:
```bash
ss -tlnp
docker ps --format 'table {{.Names}}\t{{.Ports}}'
```
---
## 3. Instalasi Baru (yang dibuat di sesi ini)
| Item | Value |
|---|---|
| Path | `/var/www/sfa_mito` |
| Git remote | `https://repo.sinerka.id/MITO/sfa-cms.git` (branch `main`) |
| Akses | `http://16.79.56.41` (port 80, **belum ada domain & SSL**) |
| Database | MySQL, db `sfa_mito`, user `sfa_mito` |
| Owner file | `ubuntu:ubuntu` |
| PHP-FPM pool | `sfa_mito` — socket `/run/php/php8.3-fpm-sfa_mito.sock`, jalan sebagai user `ubuntu` |
| Nginx config | `/etc/nginx/sites-available/sfa_mito.conf` — `listen 80 default_server;` (nangkep semua request yang gak match domain lain) |
| Admin login | `admin@sfa-mito.sinerka.id` (role `super_admin`). Akun ini **tidak ada** di DB server sampai 06-10-2026 → dibuat ulang (id 435) dengan password baru — password tidak dicatat di dokumen, tanya ke Chelvyn |
### Kenapa pakai `default_server` di port 80, bukan port custom?
Awalnya dicoba port custom (8080/8088/8067), tapi semuanya bentrok/gak bisa
diakses dari luar. Setelah ditelusuri:
- Port 8080/8081/8090 sudah dipakai Docker Odoo (lihat tabel port di atas).
- Port custom lain butuh buka Security Group AWS (di luar `ufw`) yang belum
tentu langsung bisa dikerjakan.
- Port 80 & 443 **sudah pasti terbuka** di Security Group (karena
`cms.mito.co.id` sudah lama jalan HTTPS di situ).
Solusinya: daftarkan site baru sebagai `default_server` di port 80 — ini
**tidak mengganggu** routing `cms.mito.co.id` / `cms.stein.co.id` (Nginx tetap
prioritaskan `server_name` yang cocok duluan), cuma nangkep request yang
Host header-nya gak cocok sama domain manapun (misal akses langsung via IP).
> [!warning] Update 2026-10-20 — `APP_URL` harus tanpa port
> `.env` server dev masih berisi `APP_URL=http://16.79.56.41:8088` (sisa percobaan port custom), padahal
> nginx hanya listen 80/443. Akibatnya semua link file `Storage::disk('public')->url()` (nota IMEI,
> dokumen registrasi) **timeout**. Diubah jadi `APP_URL=http://16.79.56.41` (backup `.env.bak_2026-10-20`)
> lalu `php artisan config:cache`. Samakan dengan `LARAVEL_BASE_URL` Node (`http://16.79.56.41/storage/`).
### Cara redeploy / update kode (pull perubahan terbaru)
> [!tip] Update 2026-10-06 — pakai `sfa-cms deploy`
> Skrip `scripts/sfa-cms.sh` (di repo, symlink `/usr/local/bin/sfa-cms`) menggantikan langkah
> manual di bawah: `sfa-cms deploy` (pull `--ff-only` branch aktif → composer → migration baru
> dengan konfirmasi, melewati `2025_10_20_*` → cache → reload PHP-FPM), `sfa-cms restart`,
> `sfa-cms status`, `sfa-cms logs`. Semua jalan sebagai `ubuntu`. Git server pakai **deploy key
> SSH** (Gitea, read-only) `~ubuntu/.ssh/sfa_cms_deploy`, SSH Gitea di **port 222** (port 22
> ditolak). Detail: [[SFA CMS — Deploy 2026-10-06#6. Skrip `sfa-cms` & Deploy Key\|§6]].
> [!danger] Update 2026-10-06 — `php artisan migrate --force` biasa GAGAL di server ini
> Error `Table 'app_params' already exists`: migration rekonstruksi `2025_10_20_*` tidak
> tercatat di tabel `migrations` server. Sampai diperbaiki, jalankan migration baru satu per
> satu dengan `--path=database/migrations/<file>.php`, dan jalankan artisan/composer sebagai
> `sudo -u ubuntu` (user PHP-FPM). Detail: [[SFA CMS — Deploy 2026-10-06]].
```bash
cd /var/www/sfa_mito
git pull origin main
composer install --no-dev --optimize-autoloader
php artisan migrate --force
php artisan config:clear
```
Kalau ada perubahan ke `app/Providers/Filament/AdminPanelProvider.php`, plugin,
atau apa pun yang mempengaruhi cache Filament, tambahkan:
```bash
php artisan filament:cache-components
php artisan route:clear
```
Kalau cuma ganti isi `.env` (tanpa ganti kode), cukup:
```bash
php artisan config:clear
```
### Cek status service
```bash
systemctl status nginx --no-pager
systemctl status php8.3-fpm --no-pager
systemctl status mysql --no-pager
```
Cek proses PHP-FPM pool `sfa_mito` beneran jalan (bukan cuma pool `www`
default):
```bash
systemctl status php8.3-fpm --no-pager | grep "pool sfa_mito"
```
### Cara restart service
```bash
# restart Nginx (dipakai kalau ubah/nambah file di sites-available)
nginx -t && systemctl reload nginx # reload = tanpa downtime, cukup buat perubahan config
systemctl restart nginx # restart = kalau reload gak cukup
# restart PHP-FPM (dipakai kalau ubah pool config, atau kalau app "nyangkut"/butuh clear opcache)
php-fpm8.3 -t && systemctl restart php8.3-fpm
# restart MySQL (jarang dibutuhkan, hati-hati — akan disconnect semua koneksi aktif)
systemctl restart mysql
```
**Selalu `nginx -t` / `php-fpm8.3 -t` dulu sebelum restart** — kalau ada
salah syntax di config dan langsung restart, service bisa gagal nyala lagi
dan situs down total (beda sama `reload` yang gagal tapi proses lama tetap
jalan).
### Cara lihat log
| Log | Perintah | Kapan dicek |
|---|---|---|
| Laravel (aplikasi) | `tail -f /var/www/sfa_mito/storage/logs/laravel.log` | Error 500, exception PHP, query gagal |
| Nginx access | `tail -f /var/log/nginx/access.log` | Mau tahu request apa yang masuk, status code, IP client |
| Nginx error | `tail -f /var/log/nginx/error.log` | 502/504, "Primary script unknown", masalah level web server |
| PHP-FPM | `journalctl -u php8.3-fpm -f` | FPM crash, pool gagal restart |
Catatan: Laravel **tidak selalu log semua exception** — HTTP exception
seperti 403/404/419 sengaja tidak di-log by default (dianggap alur normal,
bukan bug). Kalau curiga ada masalah otorisasi tapi log kosong, itu wajar,
bukan berarti gak ada request yang masuk — cek `nginx access.log` buat
konfirmasi status code-nya.
---
## 4. Masalah yang Ditemukan & Cara Fix-nya
Dicatat di sini supaya kalau ada masalah serupa di kemudian hari (misal
deploy ulang di server lain), gak perlu debug dari nol lagi.
### 4.1 `AppParams::first()` gagal saat container/artisan baru naik
**Gejala:** semua command `artisan` (termasuk `key:generate`) gagal karena
`AdminPanelProvider` query tabel `app_params` yang belum ada (belum migrate).
**Fix:** bungkus query itu dengan `try/catch` di
`app/Providers/Filament/AdminPanelProvider.php` (sudah di-commit, lihat
riwayat git — dulu perbaikan ini sempat cuma ada di lokal dan gak ke-push,
jadi kalau clone dari commit lama, masalah ini bisa muncul lagi).
### 4.2 Migration tabel domain & Policy belum pernah masuk git
Migration untuk tabel domain (`customer`, `product`, `sales`, `inventory`,
dst.) dan semua file di `app/Policies/` **sempat cuma ada di lokal**, gak
pernah ke-commit. Sudah diperbaiki dan di-push. Kalau clone repo ini dan
migration-nya cuma ada 10 (bukan 17), berarti ke-checkout di commit lama —
pastikan pull ke `main` terbaru.
### 4.3 `public/storage/backgrounds` kosong → error `array_rand()`
Plugin `swisnl/filament-backgrounds` butuh minimal 1 gambar di
`storage/app/public/backgrounds/`. Kalau fresh install dan folder ini kosong,
copy salah satu gambar bawaan package-nya:
```bash
php artisan storage:link
cp vendor/swisnl/filament-backgrounds/resources/images/curated-by-swis/01.jpg \
storage/app/public/backgrounds/default.jpg
```
### 4.4 403 Forbidden setelah login berhasil (paling makan waktu debug-nya)
**Gejala:** login sukses (redirect terjadi), tapi halaman dashboard langsung
403 — padahal role `super_admin` sudah benar dan punya semua 440 permission.
**Akar masalah:** `Filament\Http\Middleware\Authenticate` punya default
behavior:
```php
abort_if(
$user instanceof FilamentUser
? (! $user->canAccessPanel($panel))
: (config('app.env') !== 'local'),
403,
);
```
Karena model `App\Models\User` **tidak implement interface `FilamentUser`**,
Filament fallback ke aturan: *"boleh akses panel HANYA kalau `APP_ENV=local`"*.
Di production (`APP_ENV=production`), semua user — termasuk super_admin —
otomatis 403, terlepas dari permission apa pun.
**Fix (sudah di-commit):** `App\Models\User` implement `FilamentUser` +
method `canAccessPanel()`:
```php
use Filament\Models\Contracts\FilamentUser;
use Filament\Panel;
class User extends Authenticatable implements FilamentUser
{
// ...
public function canAccessPanel(Panel $panel): bool
{
return true;
}
}
```
Otorisasi per-resource/per-action tetap jalan normal lewat Policy (Shield),
`canAccessPanel()` cuma gerbang awal "boleh masuk panel atau tidak".
---
## 5. Instalasi Lama yang Masih Hidup — JANGAN DIGANGGU
Ditemukan saat proses deploy: ada instalasi SFA-CMS produksi lain yang sudah
lama jalan di server yang sama.
| Item | MITO (lama) | STEIN (lama) |
|---|---|---|
| Domain | `cms.mito.co.id` | `cms.stein.co.id` |
| Path | `/var/www/html/sfa-cms` | `/var/www/html/sfa-cms-stein` |
| Git remote | `gitlab.com/sinerka.id/product-internal/sfa-cms.git` | (kemungkinan sama, belum dicek) |
| Database | MySQL `sfacms` (user `glut0r`) | belum dicek |
| Node API pendamping | port 3000 (`/api/sfa`) | port 3001 (`/api/sfa`) |
| SSL | Certificate custom di `/home/ubuntu/ssl/MITO/` | `/home/ubuntu/ssl/Stein/` |
**Database `sfacms` (punya MITO lama) dicek isinya dan TERNYATA BUKAN data
kosong** — ada 1.496 customer, 499 employee, 94 product, dll. Sempat ada
rencana redirect domain `cms.mito.co.id` ke instalasi baru, tapi
**dibatalkan** karena risiko kehilangan akses ke data ini kalau ternyata
masih dipakai. **Keputusan final soal nasib instalasi lama ini (migrasi
data? tetap jalan paralel? deprecate resmi?) belum diambil** — perlu
dikoordinasikan dengan tim/client MITO sebelum ada tindakan lebih lanjut ke
`/var/www/html/sfa-cms` atau domain `cms.mito.co.id`.
File `/etc/nginx/sites-available/default` yang meng-handle kedua domain lama
ini **tidak pernah diubah** selama proses deploy instalasi baru — aman,
tidak ada backup yang perlu di-restore.
---
## 6. Struktur Skema Database (Instalasi Baru)
Migration tabel domain di repo `MITO/sfa-cms.git` **direkonstruksi dari kode**
(`app/Models`, Filament Resource, Importer/Exporter), bukan salinan struktur
database produksi asli. Tipe kolom, panjang string, dan presisi decimal bisa
saja berbeda dari database `sfacms` yang lama. Kalau suatu saat mau migrasi
data dari `sfacms` (lama) ke `sfa_mito` (baru), **bandingkan dulu skema
keduanya**, jangan asumsikan identik.
Konvensi tanda qty di tabel `invent_trans`:
| trans_type | qty | Arti |
|---|---|---|
| `RESERVE` | negatif | stok dikunci saat SO dikonfirmasi |
| `RELEASE` | positif | kunci dilepas saat packing dibuat |
| `ISSUE` | negatif | barang benar-benar keluar |
| `RECEIPT` | positif | barang masuk lewat journal yang di-post |
---
## 7. Development Lokal
Untuk kerja di laptop/lokal, project ini dijalankan **native PHP** (bukan
Docker) — lihat `SETUP.md` di root repo untuk detail lengkap (versi PHP,
cara jalanin `php artisan serve`, kredensial MySQL lokal, dll).
---
## 8. Catatan Security — Belum Dibereskan
Ditemukan saat setup, **belum ditindaklanjuti**, dicatat supaya gak
kelewat:
- **Port `3306` (MySQL) terbuka ke `0.0.0.0/0`** di `ufw` — seharusnya cuma
perlu diakses dari `localhost`. Sebelum ditutup, pastikan dulu tidak ada
sistem eksternal yang memang connect ke MySQL ini dari luar VPS.
- Port `8002`, `8003`, `4000`, `4001` juga kebuka di `ufw` — belum
diketahui dipakai untuk apa, perlu ditelusuri siapa yang butuh.
- Ada system update pending di Ubuntu ("System restart required") — gak
urgent, tapi sebaiknya dijadwalkan reboot kalau ada waktu maintenance.
---
## 9. To-Do Selanjutnya
- [ ] Siapkan domain/subdomain resmi untuk CMS baru ini (mis. lewat DNS
`sinerka.id`), lalu ganti `sfa_mito.conf` dari `default_server` jadi
`server_name` spesifik + pasang SSL (`certbot --nginx`).
- [ ] Ganti password admin default (`S1n3rk4`) setelah dokumen ini dibaca.
- [ ] Putuskan bareng tim/client soal nasib instalasi lama MITO
(`/var/www/html/sfa-cms` + database `sfacms`) — lihat [§5](#5-instalasi-lama-yang-masih-hidup---jangan-diganggu).
- [ ] Tutup port `3306` dari akses publik kalau memang tidak dibutuhkan.
- [ ] Setup backup rutin untuk database `sfa_mito` (belum ada sama sekali).