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

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
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.
    docker compose stop web   # ulangi di kedua server
    
  3. 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;
    
  4. Jalankan upgrade SEKALI SAJA, di salah satu server (karena DB shared, cukup 1x):
    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.
    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.