15 KiB
| judul | proyek | terkait | server | kategori | status | tipe | tags | diperbarui | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Bug Report — Deploy SFA CMS Dev 2026-10-06 | SFA CMS · SFA API | Mito · Odoo 18 | VPS MITO dev `/var/www/sfa_mito` (16.79.56.41) | Bug | Sebagian besar solved — 1 workaround, 1 rotasi secret belum, temuan super_admin massal | dokumen-internal |
|
2026-10-06 |
Index: SFA — Index · Kategori: Bug · Konteks deploy: SFA CMS — Deploy 2026-10-06
Bug Report: Deploy SFA CMS Dev (Self Registration + Sync Odoo + CI)
Tanggal: 6 Oktober 2026
Server/Environment: VPS MITO — server develop SFA CMS (/var/www/sfa_mito, ip-172-31-21-236, PHP 8.3.26, Laravel 11.46.1), Gitea repo.sinerka.id, Jenkins 108.137.153.186:8080
Project: SFA CMS (MITO/sfa-cms) · SFA API (MITO/sfa-api)
Status: ⚠️ Sebagian Workaround — 10 dari 12 solved, migration pakai workaround, rotasi secret sfa-api belum
Ringkasan Masalah
Deploy pertama Self Registration dan sync Odoo ke server dev, lalu pemasangan deploy otomatis
(skrip sfa-cms, deploy key Gitea, Jenkins + webhook), memunculkan serangkaian error. Dua di
antaranya bug lama di kode yang baru terlihat di server karena composer --optimize-autoloader
dan perbedaan setup server vs lokal (public/storage symlink). Sisanya masalah operasional:
skema DB server tidak tercatat di tabel migrations, file milik root, akses git, dan webhook.
Satu bug ditemukan saat pengujian sebelum deploy (hash bcrypt Node ↔ PHP) dan satu temuan
keamanan (.env sfa-api di riwayat git).
Timeline & Error
Error 1: php artisan migrate gagal — tabel sudah ada
2025_10_20_000001_create_master_tables ....... 2.59ms FAIL
In Connection.php line 825:
SQLSTATE[42S01]: Base table or view already exists: 1050 Table 'app_params' already exists (Connection: mysql, SQL: create table `app_params` ...)
Penyebab: tabel DB server dibuat dari dump, bukan migration. Tabel migrations server tidak
mencatat migration rekonstruksi 2025_10_20_000001–000009, jadi migrate mencoba membuat ulang
semua tabel. Gagal di langkah pertama → tidak ada yang berubah.
Fix (workaround): jalankan hanya migration yang dibutuhkan dengan --path (keduanya idempotent):
sudo -u ubuntu php artisan migrate --force \
--path=database/migrations/2025_10_20_000008_add_denormalized_columns_to_product_table.php
sudo -u ubuntu php artisan migrate --force \
--path=database/migrations/2026_10_01_000001_create_customer_registration_tables.php
Skrip sfa-cms deploy sekarang otomatis melewati 2025_10_20_0000(01–07|09) dan menjalankan
migration baru per file dengan --path.
Status: ⚠️ Workaround — php artisan migrate biasa masih akan gagal di server ini.
Error 2: Class ...Pages\Pages\ViewSalesTracking not found
Peringatan saat composer install --no-dev --optimize-autoloader:
Class App\Filament\Resources\StockTrackingResource\Pages\Pages\ViewStockTracking located in ./app/Filament/Resources/StockTrackingResource/Pages/ViewStockTracking.php does not comply with psr-4 autoloading standard (rule: App\ => ./app). Skipping.
Class App\Filament\Resources\SalesTrackingResource\Pages\Pages\ViewSalesTracking located in ./app/Filament/Resources/SalesTrackingResource/Pages/ViewSalesTracking.php does not comply with psr-4 autoloading standard (rule: App\ => ./app). Skipping.
Lalu panel error (GET 16.79.56.41, app/Filament/Resources/SalesTrackingResource.php:247):
Class "App\Filament\Resources\SalesTrackingResource\Pages\Pages\ViewSalesTracking" not found
Penyebab: sejak commit 7159e53 ("split menu stock & sales tracking"), ViewSalesTracking.php dan
ViewStockTracking.php ber-namespace ...\Pages\Pages padahal file ada di folder Pages/, dan
getPages() merujuk Pages\Pages\View.... Autoloader teroptimasi (-o) melewati kelas yang tidak
sesuai PSR-4. Di lokal tidak kelihatan karena cache autoload lama.
Fix: commit 6ae2249 — namespace jadi ...\Pages, rujukan jadi Pages\View.... Di server:
git pull origin develop
sudo -u ubuntu composer dump-autoload --optimize
sudo -u ubuntu php artisan filament:cache-components
sudo -u ubuntu php artisan route:clear
systemctl reload php8.3-fpm
Status: ✅ Solved — warning PSR-4 hilang di deploy berikutnya.
Error 3: git pull sebagai ubuntu gagal — Permission denied
Updating ddf8642..f6de53d
error: unable to unlink old 'scripts/sfa-cms.sh': Permission denied
Penyebab: sebelumnya git pull dijalankan manual sebagai root, sehingga folder scripts/ dan
objek .git baru milik root. Skrip sfa-cms menjalankan git sebagai ubuntu (user PHP-FPM).
Fix:
sudo chown -R ubuntu:ubuntu /var/www/sfa_mito
sfa-cms deploy
Skrip (commit ddc96b2) sekarang mengecek owner seluruh folder aplikasi dan chown otomatis sebelum pull.
Status: ✅ Solved.
Error 4: git status kotor setelah chown — mode change & file "terhapus"
M bootstrap/cache/.gitignore
D public/storage/.gitignore
M storage/app/.gitignore
...
$ git diff --summary
mode change 100644 => 100755 bootstrap/cache/.gitignore
delete mode 100644 public/storage/.gitignore
Penyebab: permission folder storage/ di-chmod saat setup server (bukan perubahan isi);
public/storage di server adalah symlink (lihat Error 5).
Fix:
sudo -u ubuntu git config core.fileMode false
Status: ✅ Solved (mode change). Bagian public/storage/.gitignore → jangan di-checkout, lihat Error 5.
Error 5: DirectoryNotFoundException — public/storage/backgrounds hilang
Symfony\Component\Finder\Exception\DirectoryNotFoundException
The "/var/www/sfa_mito/public/storage/backgrounds" directory does not exist.
Penyebab: di server public/storage dibuat lewat php artisan storage:link → symlink ke
storage/app/public (di lokal public/storage folder biasa). Saran untuk merapikan Error 4 dengan
git checkout -- public/storage/.gitignore membuat git mengganti symlink dengan folder yang hanya
berisi .gitignore. Data tidak hilang (tetap di storage/app/public), hanya penunjuknya rusak.
Fix:
sudo -u ubuntu rm -rf public/storage
sudo -u ubuntu php artisan storage:link
ls -la public/ | grep storage
# storage -> /var/www/sfa_mito/storage/app/public
sudo -u ubuntu git update-index --skip-worktree public/storage/.gitignore
sudo -u ubuntu git status --short
Status: ✅ Solved. Downtime panel beberapa menit, tanpa kehilangan data.
Error 6: sfa-cms deploy minta username/password git
==> Pull origin/develop (fast-forward saja)
Username for 'https://repo.sinerka.id':
Penyebab: kredensial HTTPS tersimpan per user; pull manual tadi pakai root, skrip pakai ubuntu.
Fix: deploy key SSH read-only (Gitea → Deploy Keys):
sudo -u ubuntu ssh-keygen -t ed25519 -C "vps-mito-sfa-cms" -f /home/ubuntu/.ssh/sfa_cms_deploy -N ""
sudo -u ubuntu git -C /var/www/sfa_mito remote set-url origin git@repo.sinerka.id:MITO/sfa-cms.git
Status: ✅ Solved (bersama Error 7–8).
Error 7: Gitea menolak public key
Cannot verify your SSH key: extractTypeFromBase64Key: invalid key format: illegal base64 data at input byte 3
Penyebab: teks key tidak tersalin utuh (bagian base64 rusak/terpotong saat copy dari terminal).
Fix: cek dulu ssh-keygen -lf …pub (harus 256 … (ED25519), panjang isi key 68, awalan
AAAAC3NzaC1lZDI1NTE5), salin ulang satu baris utuh.
Status: ✅ Solved.
Error 8: SSH ke Gitea ditolak di port 22
ssh: connect to host repo.sinerka.id port 22: Connection refused
fatal: Could not read from remote repository.
Penyebab: SSH Gitea berjalan di port 222 (banner SSH-2.0-OpenSSH_9.3), bukan 22.
Fix:
sudo -u ubuntu sed -i '/^Host repo.sinerka.id$/a\ Port 222' /home/ubuntu/.ssh/config
sudo -u ubuntu git -C /var/www/sfa_mito fetch origin
Status: ✅ Solved.
Error 9: Push ke develop tidak memicu build Jenkins
Gejala: Recent Deliveries di Gitea kosong, job SFA-CMS-DEV tidak jalan.
Penyebab:
- Token beda: Jenkins
sfa-cms-token, URL webhook Giteasfa-cms-dev-de7f…(sempat diusulkan pakaimito-develop-token— itu token job Odoo dev, akan memicu job yang salah). - Test Delivery Gitea memakai branch default (
main) → dilewati oleh Branch filterdevelop, tidak tercatat sama sekali. Belum ada push sungguhan sejak webhook dibuat.
Fix: samakan token (sfa-cms-token di Jenkins & URL Gitea), cek endpoint langsung:
curl -sS -X POST -H 'Content-Type: application/json' -d '{"ref":"refs/heads/__probe__"}' \
'http://108.137.153.186:8080/generic-webhook-trigger/invoke?token=sfa-cms-token'
# {"jobs":{"SFA-CMS-DEV":{...,"triggered":true,...}},"message":"Triggered jobs."}
lalu uji dengan push sungguhan (commit 4da680a).
Status: ✅ Solved — build otomatis tiap push develop.
Error 10 (ditemukan saat tes, sebelum deploy): hash password Node tidak bisa dipakai login di Laravel
FAIL password lama ($2b$) bisa login
Penyebab: bcryptjs (sfa-api) menghasilkan prefix $2b$; PHP password_get_info() mengembalikan
algoName: unknown untuk $2b$, sehingga cast hashed Laravel meng-hash ulang hash itu saat
aktivasi → user tidak pernah bisa login. Percobaan fix pertama juga salah: preg_replace('/^\$2[ab]\$/', '$2y$', …)
— di PHP '$2y$' dibaca sebagai backreference $2, prefix jadi rusak.
Fix: Node menyimpan dengan prefix $2y$; CMS menormalkan dengan str_starts_with + substr
(CustomerRegistrationService::normalizeBcryptPrefix).
Status: ✅ Solved — 17/17 tes workflow lulus.
Error 11 (temuan keamanan): .env sfa-api ada di riwayat git
Commit 72bc654 "first commit" (12-08-2025) berisi .env lengkap (DB_PASSWORD, JWT_SECRET, SECRET_KEY).
Fix: riwayat di-rewrite (git filter-branch) & force-push main → 58e1831; .gitignore kedua repo
diperketat. Detail: SFA API — Pembersihan .env dari Riwayat Git.
Status: ⚠️ Riwayat bersih, rotasi secret belum.
Error 12: Tidak bisa login panel — akun admin tidak ada
These credentials do not match our records.
Penyebab: admin@sfa-mito.sinerka.id (yang tercatat di dokumen deployment) tidak ada di tabel users
server. Saat membuat ulang, percobaan pertama memakai getenv("S1n3rk4") — getenv() membaca nama
environment variable, hasilnya false → akun id 435 tersimpan dengan password kosong; percobaan kedua
Duplicate entry 'admin@sfa-mito.sinerka.id' for key 'users.users_email_unique'.
Fix: update password akun yang sudah ada, password diketik di prompt tersembunyi dua kali:
cd /var/www/sfa_mito
read -rsp "Password baru: " P1; echo
read -rsp "Ulangi password: " P2; echo
if [ -z "$P1" ] || [ "$P1" != "$P2" ]; then
echo "Password kosong / tidak sama — ulangi"
else
sudo -u ubuntu env NEWPASS="$P1" php artisan tinker --execute='
$u = App\Models\User::where("email","admin@sfa-mito.sinerka.id")->firstOrFail();
$u->password = getenv("NEWPASS");
$u->save();
echo "id ", $u->id, " | cek: ", Hash::check(getenv("NEWPASS"), $u->fresh()->password) ? "COCOK" : "GAGAL", PHP_EOL;'
fi
unset P1 P2
Status: ✅ Solved — login berhasil.
[!warning] 2026-10-12: password admin "hilang" lagi Login
admin@sfa-mito.sinerka.iddi server dev gagal ("These credentials do not match our records"). Akun ada, tapiHash::check= TIDAK. Penyebab: perintah reset versi 06-10 hanya sekali ketik di prompt tersembunyi — salah ketik ikut tersimpan, dan cek "COCOK" membandingkan nilai yang sama sehingga tidak pernah gagal. Nilai baru juga tidak dicatat di mana pun. Fix: reset ulang dengan konfirmasi dua kali (perintah di atas sudah diganti) + simpan di password manager tim.Catatan diagnosis: pesan Filament itu sama untuk 3 penyebab — user tidak ada, password salah, atau
canAccessPanel()false (user_type = EXTERNAL). Cek dulu dengan tinker sebelum menebak.
Temuan terkait: User::role("super_admin") di server berisi ±140 user, termasuk akun sales lapangan
→ semua bisa masuk panel dengan akses penuh. Belum diubah (lihat to-do Index).
Root Cause Summary
| # | Masalah | Penyebab | Fix |
|---|---|---|---|
| 1 | migrate gagal app_params already exists |
Skema server dari dump, migration rekonstruksi tidak tercatat | --path per file; skrip melewati 2025_10_20_* (workaround) |
| 2 | ViewSalesTracking / ViewStockTracking not found |
Namespace Pages\Pages sejak 7159e53, dilewati autoloader -o |
Commit 6ae2249 |
| 3 | unable to unlink … Permission denied |
git pull manual sebagai root |
chown -R ubuntu, skrip auto-chown (ddc96b2) |
| 4 | git status kotor (mode change) |
chmod storage saat setup |
core.fileMode false |
| 5 | public/storage/backgrounds not found |
git checkout mengganti symlink storage:link dengan folder |
storage:link ulang + skip-worktree |
| 6 | Pull minta password | Kredensial per user | Deploy key SSH |
| 7 | Gitea illegal base64 data |
Key tersalin tidak utuh | Salin ulang satu baris |
| 8 | SSH port 22 refused | SSH Gitea di port 222 | Port 222 di ~/.ssh/config |
| 9 | Webhook tidak memicu build | Token beda + Test Delivery terfilter branch | Samakan token, uji dengan push |
| 10 | Hash $2b$ di-hash ulang Laravel |
PHP tidak mengenali $2b$; backreference di preg_replace |
Simpan $2y$, normalisasi tanpa regex |
| 11 | .env di riwayat git sfa-api |
Ter-commit di commit pertama | Rewrite riwayat; rotasi secret belum |
| 12 | Login panel gagal, akun admin tidak ada | Akun di dokumen tidak pernah ada di DB server; getenv("<password>") salah pakai |
Buat/update akun lewat tinker + prompt tersembunyi |
Rekomendasi Jangka Panjang
- Fix permanen migration rekonstruksi: beri
hasTable/hasColumndi2025_10_20_*(atau catat sebagai sudah jalan lewat migration resmi), supayaphp artisan migratebiasa aman di semua server. - Jangan pernah jalankan
git/artisan/composersebagai root di server — selalusfa-cms …atausudo -u ubuntu. - Samakan setup
public/storagelokal & server, atau dokumentasikan perbedaannya (lokal: folder + symlink per subfolder; server:storage:link). - Tambah cek CI ringan sebelum deploy:
composer dump-autoload -o+ gagal kalau ada warning PSR-4. - Token webhook acak per job; pasang filter branch juga di sisi Jenkins.
- Rotasi
JWT_SECRET,SECRET_KEY, password DB sfa-api.
Warning / Catatan Tambahan
public/storage/.gitignoredi server di-skip-worktree— jangan di-checkout/restore.- Test Delivery Gitea tidak bisa dipakai menguji webhook yang ber-Branch filter; uji dengan push.
- Dry-run sync Odoo di server: product
deleted=191, customerdeleted=836— dijalankan karena server masih data uji (bukan bug, keputusan). Lihat SFA CMS — Deploy 2026-10-06 §3.2.