Doc_chelvyn/Mito/Sfa/Bug/2026-10-06_deploy-sfa-cms-d...

15 KiB
Raw Permalink Blame History

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
sfa
cms
bug
deploy
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:

  1. Token beda: Jenkins sfa-cms-token, URL webhook Gitea sfa-cms-dev-de7f… (sempat diusulkan pakai mito-develop-token — itu token job Odoo dev, akan memicu job yang salah).
  2. Test Delivery Gitea memakai branch default (main) → dilewati oleh Branch filter develop, 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.id di server dev gagal ("These credentials do not match our records"). Akun ada, tapi Hash::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/hasColumn di 2025_10_20_* (atau catat sebagai sudah jalan lewat migration resmi), supaya php artisan migrate biasa aman di semua server.
  • Jangan pernah jalankan git/artisan/composer sebagai root di server — selalu sfa-cms … atau sudo -u ubuntu.
  • Samakan setup public/storage lokal & 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/.gitignore di 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, customer deleted=836 — dijalankan karena server masih data uji (bukan bug, keputusan). Lihat SFA CMS — Deploy 2026-10-06 §3.2.