6.6 KiB
6.6 KiB
| proyek | modul | odoo | kategori | status | sumber | tags | ||||
|---|---|---|---|---|---|---|---|---|---|---|
| Mito | mito_odoo | 18.0 | Rilis & Deploy | Aktif — playbook wajib | snk_mito/config/upgrade_playbook_mito.md |
|
Index: Mito — Index · Kategori: Rilis & Deploy
Prosedur wajib tiap upgrade module di production Mito (RDS Postgres shared + 2 app server Docker). Lahir dari 3 insiden nyata — tabel insidennya ada di bagian pertama dokumen.
Upgrade Playbook — Mito Odoo Production
Infra: RDS Postgres (shared) + 2 Odoo app server (Docker). Setiap upgrade module WAJIB ikut playbook ini. Jangan upgrade lewat tombol UI di production.
Insiden yang melatari playbook ini
| Tanggal | Server | Case | Root cause |
|---|---|---|---|
| 2026-06-16/17 | odoo.mito.co.id | WrongObjectType: ALTER ADD COLUMN ... not supported for views pada snk_financial_report |
Model diubah dari _auto=False (VIEW) ke _auto=True (TABLE) tanpa migration script. Fix sudah ada di branch cj/salesperson (manifest version 18.0.1.0.1 + migrations/18.0.1.0.1/pre-migrate.py) tapi belum di-deploy. |
| 2026-06-17 | odoo.stein.co.id | FeatureNotSupported: FOR UPDATE is not allowed with aggregate functions pada jobsheet.operation._generate_reference() |
Bug logic SQL (COUNT(*) ... FOR UPDATE), bukan masalah schema. Fix sudah di-commit (87c5540, ec175cb) tapi server belum di-restart dengan code baru. |
| Sebelumnya | 2 server share 1 RDS | Upgrade cuma di 1 server, server lain nggak di-restart → drift: server lama masih nulis/baca dengan asumsi schema lama, bikin admin hapus manual table di production berkali-kali | Multi-server upgrade nggak dilakukan serempak. |
Kesimpulan: sumber masalah selalu sama — code/fix yang sudah benar di repo tertahan, belum sampai ke production, dan upgrade dipaksa jalan di kondisi server yang nggak konsisten satu sama lain.
A. Klasifikasi perubahan — tentukan jalur sebelum deploy
Apakah ada perubahan _auto, _name, hapus field/model, atau rename kolom?
├── YA → "Structural change" → wajib migration script + downtime kedua server (Bagian C)
└── TIDAK → "Code-only fix" (bug logic, query, validasi) → cukup redeploy + restart (Bagian B)
Jangan asumsikan sendiri — kalau ragu, treat sebagai structural change (lebih aman, lebih lambat dikit nggak masalah).
B. Code-only fix (contoh: bug FOR UPDATE di jobsheet)
- Pastikan fix sudah committed di branch yang akan dideploy.
- Build image baru / pull code terbaru ke kedua server.
- Restart container Odoo di kedua server (Python module di-cache di memori proses — tanpa restart, fix nggak akan terpakai walau file sudah berubah).
- Tidak perlu
-u module, tidak perlu migration, tidak perlu downtime serempak — karena schema DB tidak berubah, urutan restart antar server tidak kritis. - Verifikasi: ulangi aksi yang sebelumnya error (misal klik Confirm di jobsheet) di kedua server.
C. Structural change (contoh: snk_financial_report VIEW → TABLE)
Checklist sebelum mulai
versiondi__manifest__.pysudah dinaikkan dan commit.- Folder
migrations/<version>/namanya persis sama dengan version manifest. - Migration script idempotent (
IF EXISTS, defensive check table_type, dst). - Sudah ditest di staging (restore snapshot RDS → instance staging, jalankan upgrade di sana dulu).
- Snapshot manual RDS production sudah dibuat (selain automated backup).
Urutan eksekusi (WAJIB urut, jangan skip)
- Beri tahu user / jadwalkan maintenance window. Structural change = downtime.
- Stop KEDUA container Odoo (atau scale ke 0 / matikan service). Jangan ada proses yang masih hidup nyentuh DB.
docker compose stop web # ulangi di kedua server - Cek dulu lock aktif di RDS sebelum mulai (pastikan nggak ada query nyangkut):
SELECT pid, now() - query_start AS dur, query FROM pg_stat_activity WHERE state != 'idle' ORDER BY dur DESC; - Jalankan upgrade SEKALI SAJA, di salah satu server (karena DB shared, cukup 1x):
Baca log sampai selesai. Pastikan ada barisdocker exec -it <salah-satu-container> odoo -u <module> -d <db_name> --stop-after-init --no-http[MIGRATION] ...dari script kamu, dan tidak ada traceback. - Kalau gagal di tengah jalan → JANGAN langsung hapus table manual. Baca traceback, perbaiki migration script, ulangi dari langkah 4 (migration harus idempotent supaya aman diulang).
- Setelah sukses, start ulang KEDUA server dengan image/code yang sama.
docker compose up -d web # di kedua server - Verifikasi fungsional: buka model yang diubah, generate report/transaksi terkait, cek nggak ada error di log kedua server.
Larangan keras selama proses ini
- ❌ Jalankan upgrade lewat tombol "Upgrade" di Apps UI pada production.
- ❌
DELETE/DROPmanual di psql production sebagai workaround cepat — kalau ada server lain yang masih hidup, data akan numpuk lagi dan masalah berulang. - ❌ Restart cuma 1 dari 2 server lalu dibiarkan lama — server yang ketinggalan akan terus generate error karena registry-nya beda dengan schema yang sudah berubah.
- ❌ Skip staging test untuk structural change yang menyentuh table volume tinggi (
sale.order,account.move,jobsheet.operation, dst).
D. Kalau sudah terjadi error di production (mirip case sekarang)
- Identifikasi dulu: ini code-only bug atau structural change? (lihat traceback —
WrongObjectType/FeatureNotSupporteddi level SQL biasanya structural;AttributeError/ValidationErrorbiasanya logic bug). - Cek apakah fix sudah ada di repo (
git log -- <file>) sebelum nulis fix baru — kemungkinan sudah pernah diperbaiki tapi belum dideploy (ini yang terjadi di 2 case terakhir). - Cek konsistensi kedua server —
git log/image version di masing-masing server harus sama sebelum upgrade ulang. - Ikuti Bagian B atau C sesuai klasifikasi, jangan langsung fix manual di DB.
- Setelah selesai, update tabel insiden di atas (Bagian "Insiden yang melatari playbook ini") biar next time ketauan pola yang berulang.
E. RDS-specific notes
- RDS nggak punya akses superuser OS-level — kalau migration butuh extension/
ALTER SYSTEM, cek dulu apakah didukung RDS (banyak yang nggak). - Tuning Postgres (
shared_buffers,work_mem, dst) di RDS lewat Parameter Group AWS, bukan command flag di docker-compose seperti di environment lokal. - Snapshot RDS manual sebelum structural change = rollback point. Restore snapshot → instance baru untuk staging test, jangan test langsung di production clone yang sama dengan endpoint live.