361 lines
14 KiB
Markdown
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).
|