Skip to main content

Runbook naik taraf di premis sendiri

Pra-penerbangan​

  1. Sahkan lesen sah untuk versi baharu: curl gateway:8082/healthz.
  2. Ruang cakera pada PVC sandaran ≥ 2× saiz DB.
  3. Maklumkan pengguna tentang tetingkap penyelenggaraan.

Naik taraf​

helm upgrade yabanin deploy/helm/yabanin-onprem \
-f deploy/helm/yabanin-onprem/values-airgap.yaml \
--set image.tag=1.1.0

Carta berjalan secara automatik:

  1. Job pra-naik taraf: pg_dump → /backup
  2. kemas kini bergolek gerbang/loggerd/admin (masa henti sifar dengan replika≥2)
  3. Job pasca-naik taraf: YABANIN_REGION=onprem yabanin-migrate

Gulung balik (jika migrasi gagal)​

helm rollback yabanin

Job pasca-gulung balik memulihkan longgokan /backup terkini.

Disiplin migrasi​

  • Lajur baharu mesti boleh nol atau mempunyai nilai lalai (serasi ke belakang semasa kemas kini bergolek).
  • Perubahan yang memusnah dibalut IF EXISTS / IF NOT EXISTS.
  • Jangan sekali-kali namakan semula lajur dalam satu langkah; tambah yang baharu, tulis secara dwi, isi semula, kemudian gugurkan yang lama.

Latih tubi pra-naik taraf automatik (ENT-06)​

Sebelum menyentuh pelaksanaan sebenar, jalankan latih tubi luar talian:

bash scripts/airgap/upgrade_drill.sh \
"postgres://yabanin:…@localhost:5432/yabanin?sslmode=disable" /tmp/upgrade-drill

Ia membuktikan, tanpa menyentuh aplikasi:

  1. Cermin migrasi — migrations/ dan pkg/migrate/migrations/ membawa set yang sama (percanggahan bermaksud binari migrasi kendiri akan tersasar daripada binari bersatu).
  2. Sandaran pra-naik taraf — ENT-05 backup_all.sh (artifak RPO) dengan sha256.
  3. Migrasi naik — yabanin-migrate dibina baharu daripada sumber; no-op pada skema yang sudah terkini, dan menggunakan file yang belum selesai jika tidak.
  4. Pengaktifan lesen luar talian — pusingan penuh PKI (gen-root → issue-intermediate → issue → verify): LICENSE VALID membuktikan pengaktifan jurang udara tanpa sebarang rangkaian.

Bukti tempatan terkini (2026-09-13): keempat-empat langkah hijau, sandaran 152,416 B, migrasi no-op, rantai lesen disahkan.

Mod kegagalan diketahui: binari migrasi lapuk​

Binari yabanin-migrate yang dibina daripada pokok pra-squash membenamkan katalog 37 file yang lama dan menulis rekod palsu schema_migrations (37, dirty) (diperhatikan dalam latih tubi 2026-09-13). Oleh itu latih tubi membina binari migrasi daripada sumber semasa ke dalam direktori kerja. Pembaikan jadual penjejakan yang rosak: bawa skema ke set yang benar-benar digunakan, kemudian UPDATE schema_migrations SET version=<head>, dirty=false.

Mod kegagalan diketahui: migrasi psql manual​

Pangkalan data yang dimigrasikan dengan menyalurkan file .sql secara manual tidak mempunyai baris schema_migrations — pelari kemudian menganggapnya belum dimigrasikan dan gagal pada objek pertama. Sentiasa migrasikan melalui yabanin-migrate.