--- judul: SFA CMS — Deploy 2026-10-06 (Self Registration + Sync Odoo) proyek: SFA CMS terkait: Mito · Odoo 18 server: VPS MITO `/var/www/sfa_mito` (ip-172-31-21-236) kategori: Deploy & Setup status: Selesai sebagian — lihat §5 tipe: dokumen-internal tags: - sfa - cms - deploy - odoo - self-registration diperbarui: 2026-10-06 --- []() > Index: [[SFA — Index]] · Kategori: **Deploy & Setup** > > Log deploy pertama untuk [[SFA — Self Registration]], [[SFA CMS — Sync Master Product dari Odoo]], > dan [[SFA CMS — Sync Customer dari Odoo]] ke [[SFA CMS — Deployment VPS MITO|VPS MITO]]. > Server **belum production** (masih data uji). # Deploy 2026-10-06 ## 1. Yang Di-deploy Branch **`develop`** `sfa-cms` sampai commit `8d5f815`: | Commit | Isi | |---|---| | `af6a6e3` | Review & aktivasi Self Registration (migration, Filament, policy, `canAccessPanel`) | | `647dd0e` | `.gitignore` untuk `.env.*`, secret, dump database | | `8d5f815` | Sync master product & customer dari Odoo 18 + jadwal harian | > [!warning] Server mengikuti `main` menurut [[SFA CMS — Deployment VPS MITO]], perubahan ini ada di `develop` > Sebelum deploy berikutnya: merge `develop` → `main`, atau putuskan server memang ikut `develop`. --- ## 2. Langkah yang Dijalankan Semua perintah aplikasi dijalankan sebagai **`ubuntu`** (user PHP-FPM pool `sfa_mito`), bukan root — kalau artisan jalan sebagai root, file baru di `storage/` & `bootstrap/cache/` jadi milik root dan panel bisa error 500. ```bash cd /var/www/sfa_mito # 1. Backup (pertama kali ada backup DB sfa_mito) mysqldump -u sfa_mito -p --single-transaction --no-tablespaces --routines --triggers \ sfa_mito > ~/backup_sfa_mito_$(date +%F_%H%M).sql # → /root/backup_sfa_mito_2026-10-06_0433.sql (7.3 MB) # 2. .env: ODOO_URL, ODOO_DB, MITO_API_KEY (backup .env.bak_2026-10-06) # 3. Aplikasi sudo -u ubuntu composer install --no-dev --optimize-autoloader 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 sudo -u ubuntu php artisan shield:generate --resource=CustomerRegistrationResource --option=permissions --panel=admin sudo -u ubuntu php artisan config:clear sudo -u ubuntu php artisan filament:cache-components sudo -u ubuntu php artisan route:clear systemctl reload php8.3-fpm # 4. Cron (user ubuntu) crontab -u ubuntu -e # * * * * * cd /var/www/sfa_mito && php artisan schedule:run >> /dev/null 2>&1 ``` Verifikasi: tabel `customer_registration*` (3) dan kolom `users.user_type` → OK. `schedule:list` → `odoo:sync-products` 01:00 & `odoo:sync-customers` 01:15 (Asia/Jakarta). --- ## 3. Masalah & Penanganan ### 3.1 `php artisan migrate` gagal: `Table 'app_params' already exists` Tabel DB server dibuat dari dump, bukan migration, jadi tabel `migrations` tidak mencatat migration rekonstruksi `2025_10_20_000001`–`000009`. `migrate` biasa mencoba membuat ulang semua tabel dan gagal di langkah pertama (tidak ada yang berubah). **Penanganan:** jalankan migration yang dibutuhkan saja dengan `--path` (keduanya idempotent): `000008` (kolom `brand_name`, `product_classification`, `product_category` — dibutuhkan sync product) dan `2026_10_01_000001` (self registration). `000001`–`000007` & `000009` **jangan dijalankan** di server. > [!danger] Sampai diperbaiki, `php artisan migrate` biasa di server ini SELALU gagal > Fix permanen (belum dikerjakan): buat migration rekonstruksi melewati tabel yang sudah ada > (`hasTable`), commit, supaya semua server konsisten. Sementara itu selalu pakai `--path`. ### 3.2 Dry-run sync: semua data lama akan dihapus | | created | updated | deleted | |---|---|---|---| | `odoo:sync-products --dry-run` | 639 | 0 | **191** | | `odoo:sync-customers --dry-run` | 1259 | 0 | **836** | `updated=0` → tidak ada data server yang dikenali sebagai data Odoo (kunci `product_id` / `cust_code` masih kode CMS). Sync membuat baris **baru** lalu soft delete yang lama, sehingga transaksi (SO, jadwal kunjungan, `invent_trans`) tetap menunjuk ke baris lama. **Keputusan:** server belum production (data uji) → sync dijalankan apa adanya. Backup ada, penghapusan hanya soft delete. Customer Odoo tidak punya `ref`/`short_code`, jadi kalau nanti ada data sungguhan yang harus dipertahankan, pencocokan hanya bisa lewat nama/HP. Master baru yang ikut terbentuk: 15 kategori product, ±37 area/channel (SHOPEE, LAZADA, TOKOPEDIA, GT, SC, RESELLER, …), grade `D`. --- ## 4. Konfigurasi `.env` yang Ditambah ```env ODOO_URL=… ODOO_DB=… MITO_API_KEY=… # = System Parameter mito_base.api_key di Odoo # ODOO_TIMEOUT=60 ``` API Odoo jalan sebagai user di `mito_base.api_user_id` (**Administrator 12**, diisi pakai nama — rapuh kalau user di-rename; lebih aman pakai id/login). --- ## 5. Status & Sisa Pekerjaan | | Hal | Status | |---|---|---| | ✅ | Backup DB | `/root/backup_sfa_mito_2026-10-06_0433.sql` — **sekali saja, belum otomatis** | | ✅ | Migration product (`000008`) & self registration | | | ✅ | Permission Shield Customer Registration | | | ✅ | Cron `schedule:run` (user `ubuntu`) | | | ⬜ | Sync pertama manual (`odoo:sync-products`, `odoo:sync-customers`) | Belum dikonfirmasi — kalau dilewati, jalan otomatis 01:00/01:15 | | ⬜ | Cek log sync besok pagi | `storage/logs/odoo-sync-products.log`, `odoo-sync-customers.log` → `error=0` | | ⬜ | Permission role reviewer | Shield → Roles → Customer Registration | | ⬜ | Bersihkan transaksi uji yang menunjuk ke produk/customer lama | Sebelum go-live | | ⬜ | Node API `sfa_api_mito` | Merge `feature/self-registration` → `main`, pull, `filePath=/var/www/sfa_mito/storage/app/public/files`, `pm2 restart` | | ⬜ | Merge `develop` → `main` sfa-cms | Lihat §1 | | ⬜ | Fix migration rekonstruksi | Lihat §3.1 | | ✅ | Fix error `Class …SalesTrackingResource\Pages\Pages\ViewSalesTracking not found` | Commit `6ae2249`: namespace View Sales/Stock Tracking salah sejak `7159e53`, dilewati `--optimize-autoloader` | | ✅ | Skrip `sfa-cms` + deploy key | Lihat §6 | | ✅ | Jenkins job `SFA-CMS-DEV` + webhook Gitea | Lihat §7 — deploy otomatis tiap push `develop` | | ✅ | Hapus contoh `inspire` di `routes/console.php` | Commit `4da680a` (sekaligus uji webhook) | --- ## 6. Skrip `sfa-cms` & Deploy Key Commit `ddf8642` menambah `scripts/sfa-cms.sh`. Dipasang sekali: `sudo ln -sf /var/www/sfa_mito/scripts/sfa-cms.sh /usr/local/bin/sfa-cms`. | Perintah | Isi | |---|---| | `sfa-cms deploy` | `git pull --ff-only` branch aktif → `composer install --no-dev -o` → migration baru (konfirmasi, `2025_10_20_*` dilewati, per file `--path`) → clear/rebuild cache → reload PHP-FPM | | `sfa-cms restart` | Perbaiki owner `storage`/`bootstrap/cache`, clear cache, reload PHP-FPM (setelah ubah `.env`) | | `sfa-cms status` | Branch/commit, nginx/php-fpm/mysql, cron, `schedule:list` | | `sfa-cms logs` | `tail -f` `laravel.log` + log sync Odoo | **Akses git server (tanpa password):** | | | |---|---| | Git server | **Gitea** `repo.sinerka.id` (bukan GitLab) | | Deploy key | `/home/ubuntu/.ssh/sfa_cms_deploy` (ed25519, komentar `vps-mito-sfa-cms`), terdaftar di Gitea → sfa-cms → Settings → Deploy Keys, **read-only** | | SSH Gitea | Port **222** (port 22 `Connection refused`) — diatur di `/home/ubuntu/.ssh/config` | | Remote | `git@repo.sinerka.id:MITO/sfa-cms.git` | Hasil `sfa-cms deploy` pertama: `✔ Deploy selesai (develop @ ddf8642)`, tanpa warning PSR-4. --- ## 7. Jenkins — Job `SFA-CMS-DEV` Server ini adalah **server develop** (production MITO = 5 server, job `MITO_PRODUCTION`). Jenkins hanya SSH ke VPS lalu menjalankan `sfa-cms deploy --yes` (`--yes` = migration tanpa konfirmasi, **tanpa backup otomatis** — keputusan: belum production). | | | |---|---| | Job | `SFA-CMS-DEV` (Pipeline), workspace `/var/jenkins_home/workspace/SFA-CMS-DEV` | | Credential | ID `vps-mito-sfa-ssh` — *SSH Username with private key*, user `ubuntu` (key `jenkins-deploy-sfa-cms`, public key di `~ubuntu/.ssh/authorized_keys`, private key sudah dihapus dari server) | | Perintah | `ssh -o BatchMode=yes -o StrictHostKeyChecking=accept-new ubuntu@16.79.56.41 'sfa-cms deploy --yes'` | | Opsi | `disableConcurrentBuilds()`, `timeout 15 menit` | | Build pertama | ✅ `Deploy selesai (develop @ ddc96b2)` → `Finished: SUCCESS` | | Trigger | **Otomatis tiap push ke `develop`** (+ Build Now manual). Generic Webhook Trigger diatur lewat UI job (bukan blok `triggers` di script), token `sfa-cms-token` | | Webhook Gitea | sfa-cms → Settings → Webhooks: `http://108.137.153.186:8080/generic-webhook-trigger/invoke?token=sfa-cms-token`, POST `application/json`, Push Events, **Branch filter `develop`** | | Uji | Push `4da680a` → webhook → build otomatis ✅ | ```groovy pipeline { agent any options { disableConcurrentBuilds(); timeout(time: 15, unit: 'MINUTES') } stages { stage('Deploy SFA CMS (dev)') { steps { withCredentials([sshUserPrivateKey(credentialsId: 'vps-mito-sfa-ssh', keyFileVariable: 'SSH_KEY', usernameVariable: 'SSH_USER')]) { sh ''' ssh -i "$SSH_KEY" -o BatchMode=yes -o StrictHostKeyChecking=accept-new \ "$SSH_USER"@16.79.56.41 'sfa-cms deploy --yes' ''' } } } } } ``` > [!danger] `public/storage` di server = SYMLINK (`storage:link`), bukan folder seperti di lokal > Git melaporkan `D public/storage/.gitignore` karena itu. **Jangan `git checkout -- public/storage/.gitignore`** > — git mengganti symlink dengan folder kosong → error `DirectoryNotFoundException …/public/storage/backgrounds` > (terjadi 06-10-2026). Perbaikan: `rm -rf public/storage && php artisan storage:link` (sebagai `ubuntu`), lalu > `git update-index --skip-worktree public/storage/.gitignore` supaya git tidak melaporkannya lagi. Catatan server: `git config core.fileMode false` di `/var/www/sfa_mito` (perubahan permission `.gitignore` di `storage/` bukan perubahan kode); seluruh folder aplikasi milik `ubuntu:ubuntu`. > [!note] Catatan webhook > - **Test Delivery Gitea tidak bisa dipakai untuk menguji** webhook ber-branch filter: Gitea memakai > commit branch default (`main`), event dilewati, *Recent Deliveries* tetap kosong. Uji dengan push ke `develop`. > - Generic Webhook Trigger menjalankan **semua job dengan token yang sama** — tiap job wajib token > sendiri (jangan pakai `mito-develop-token` milik DEPLOY MITO-DEV). > - Filter branch di sisi Jenkins (Optional filter `$ref` ~ `^refs/heads/develop$`) belum dipasang; > yang menyaring hanya Gitea. Siapa pun yang tahu token bisa memicu deploy dev. > - Token `sfa-cms-token` & `mito-production-token` mudah ditebak dan dikirim lewat HTTP — untuk > production pakai token acak.