Doc_chelvyn/Mito/Rilis & Deploy/Mito — Upgrade Playbook Pro...

115 lines
6.6 KiB
Markdown
Raw Permalink Normal View History

---
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/<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)
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 <salah-satu-container> odoo -u <module> -d <db_name> --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 -- <file>`) 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.