14 KiB
| judul | proyek | terkait | stack | server | kategori | status | tipe | tags | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| SFA CMS — Deployment VPS MITO | SFA CMS | Mito | Laravel · Filament · PHP 8.3 · Nginx · MySQL | AWS EC2 16.79.56.41 (shared dengan 4 instance Odoo Docker) | Deploy & Setup | Instalasi baru jalan — belum ada domain, SSL, & backup | dokumen-internal |
|
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). 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) |
| 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:
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.idsudah 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_URLharus tanpa port.envserver dev masih berisiAPP_URL=http://16.79.56.41:8088(sisa percobaan port custom), padahal nginx hanya listen 80/443. Akibatnya semua link fileStorage::disk('public')->url()(nota IMEI, dokumen registrasi) timeout. Diubah jadiAPP_URL=http://16.79.56.41(backup.env.bak_2026-10-20) laluphp artisan config:cache. Samakan denganLARAVEL_BASE_URLNode (http://16.79.56.41/storage/).
Cara redeploy / update kode (pull perubahan terbaru)
[!tip] Update 2026-10-06 — pakai
sfa-cms deploySkripscripts/sfa-cms.sh(di repo, symlink/usr/local/bin/sfa-cms) menggantikan langkah manual di bawah:sfa-cms deploy(pull--ff-onlybranch aktif → composer → migration baru dengan konfirmasi, melewati2025_10_20_*→ cache → reload PHP-FPM),sfa-cms restart,sfa-cms status,sfa-cms logs. Semua jalan sebagaiubuntu. 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. Skripsfa-cms& Deploy Key|§6]].
[!danger] Update 2026-10-06 —
php artisan migrate --forcebiasa GAGAL di server ini ErrorTable 'app_params' already exists: migration rekonstruksi2025_10_20_*tidak tercatat di tabelmigrationsserver. Sampai diperbaiki, jalankan migration baru satu per satu dengan--path=database/migrations/<file>.php, dan jalankan artisan/composer sebagaisudo -u ubuntu(user PHP-FPM). Detail: SFA CMS — Deploy 2026-10-06.
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:
php artisan filament:cache-components
php artisan route:clear
Kalau cuma ganti isi .env (tanpa ganti kode), cukup:
php artisan config:clear
Cek status service
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):
systemctl status php8.3-fpm --no-pager | grep "pool sfa_mito"
Cara restart service
# 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:
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:
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():
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 ke0.0.0.0/0diufw— seharusnya cuma perlu diakses darilocalhost. Sebelum ditutup, pastikan dulu tidak ada sistem eksternal yang memang connect ke MySQL ini dari luar VPS. - Port
8002,8003,4000,4001juga kebuka diufw— 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 gantisfa_mito.confdaridefault_serverjadiserver_namespesifik + 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+ databasesfacms) — lihat §5. - Tutup port
3306dari akses publik kalau memang tidak dibutuhkan. - Setup backup rutin untuk database
sfa_mito(belum ada sama sekali).