11 KiB
| judul | proyek | terkait | server | kategori | status | tipe | tags | diperbarui | |||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| SFA CMS — Deploy 2026-10-06 (Self Registration + Sync Odoo) | SFA CMS | Mito · Odoo 18 | VPS MITO `/var/www/sfa_mito` (ip-172-31-21-236) | Deploy & Setup | Selesai sebagian — lihat §5 | dokumen-internal |
|
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. 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
mainmenurut SFA CMS — Deployment VPS MITO, perubahan ini ada didevelopSebelum deploy berikutnya: mergedevelop→main, atau putuskan server memang ikutdevelop.
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.
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 migratebiasa 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
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 ✅ |
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/storagedi server = SYMLINK (storage:link), bukan folder seperti di lokal Git melaporkanD public/storage/.gitignorekarena itu. Jangangit checkout -- public/storage/.gitignore— git mengganti symlink dengan folder kosong → errorDirectoryNotFoundException …/public/storage/backgrounds(terjadi 06-10-2026). Perbaikan:rm -rf public/storage && php artisan storage:link(sebagaiubuntu), lalugit update-index --skip-worktree public/storage/.gitignoresupaya 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 kedevelop.- Generic Webhook Trigger menjalankan semua job dengan token yang sama — tiap job wajib token sendiri (jangan pakai
mito-develop-tokenmilik 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-tokenmudah ditebak dan dikirim lewat HTTP — untuk production pakai token acak.