Runbook naik taraf di premis sendiri
Pra-penerbangan
- Sahkan lesen sah untuk versi baharu:
curl gateway:8082/healthz. - Ruang cakera pada PVC sandaran ≥ 2× saiz DB.
- 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:
- Job pra-naik taraf:
pg_dump→ /backup - kemas kini bergolek gerbang/loggerd/admin (masa henti sifar dengan replika≥2)
- 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:
- Cermin migrasi —
migrations/danpkg/migrate/migrations/membawa set yang sama (percanggahan bermaksud binari migrasi kendiri akan tersasar daripada binari bersatu). - Sandaran pra-naik taraf — ENT-05
backup_all.sh(artifak RPO) dengan sha256. - Migrasi naik —
yabanin-migratedibina baharu daripada sumber; no-op pada skema yang sudah terkini, dan menggunakan file yang belum selesai jika tidak. - Pengaktifan lesen luar talian — pusingan penuh PKI (gen-root → issue-intermediate → issue → verify):
LICENSE VALIDmembuktikan 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.