--- proyek: Mito modul: mito_odoo odoo: "18.0" kategori: Rilis & Deploy status: Aktif — playbook wajib sumber: snk_mito/config/upgrade_playbook_mito.md tags: - mito - deploy - migration - playbook --- > 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) 1. Pastikan fix sudah **committed** di branch yang akan dideploy. 2. Build image baru / pull code terbaru ke **kedua server**. 3. Restart container Odoo di **kedua server** (Python module di-cache di memori proses — tanpa restart, fix nggak akan terpakai walau file sudah berubah). 4. **Tidak perlu** `-u module`, **tidak perlu** migration, **tidak perlu** downtime serempak — karena schema DB tidak berubah, urutan restart antar server tidak kritis. 5. 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 - [ ] `version` di `__manifest__.py` sudah dinaikkan dan **commit**. - [ ] Folder `migrations//` 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) 1. **Beri tahu user / jadwalkan maintenance window.** Structural change = downtime. 2. **Stop KEDUA container Odoo** (atau scale ke 0 / matikan service). Jangan ada proses yang masih hidup nyentuh DB. ```bash docker compose stop web # ulangi di kedua server ``` 3. **Cek dulu lock aktif** di RDS sebelum mulai (pastikan nggak ada query nyangkut): ```sql SELECT pid, now() - query_start AS dur, query FROM pg_stat_activity WHERE state != 'idle' ORDER BY dur DESC; ``` 4. **Jalankan upgrade SEKALI SAJA**, di salah satu server (karena DB shared, cukup 1x): ```bash docker exec -it odoo -u -d --stop-after-init --no-http ``` Baca log sampai selesai. Pastikan ada baris `[MIGRATION] ...` dari script kamu, dan **tidak ada traceback**. 5. 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). 6. Setelah sukses, **start ulang KEDUA server** dengan image/code yang sama. ```bash docker compose up -d web # di kedua server ``` 7. 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`/`DROP` manual 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) 1. **Identifikasi dulu**: ini code-only bug atau structural change? (lihat traceback — `WrongObjectType`/`FeatureNotSupported` di level SQL biasanya structural; `AttributeError`/`ValidationError` biasanya logic bug). 2. **Cek apakah fix sudah ada di repo** (`git log -- `) sebelum nulis fix baru — kemungkinan sudah pernah diperbaiki tapi belum dideploy (ini yang terjadi di 2 case terakhir). 3. **Cek konsistensi kedua server** — `git log`/image version di masing-masing server harus sama sebelum upgrade ulang. 4. Ikuti Bagian B atau C sesuai klasifikasi, jangan langsung fix manual di DB. 5. 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.