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

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
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). 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.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.

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 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.
  • Tutup port 3306 dari akses publik kalau memang tidak dibutuhkan.
  • Setup backup rutin untuk database sfa_mito (belum ada sama sekali).