Deploy ke Staging
Membuat tag rilis dan memeriksa hasil deploy aplikasi HMS di staging
Workflow
staging-build.yml
berjalan saat tag *-staging dikirim ke GitHub. Push ke branch dev saja tidak memulai deploy.
Workflow menerima tag dengan format <app>-v<major>.<minor>.<patch>-staging, dengan app salah
satu dari api, web, client, admin, atau docs.
Sebelum membuat tag
-
Pastikan perubahan yang akan dirilis sudah masuk ke branch
dev. -
Cek tag yang sudah ada untuk aplikasi tersebut. Contoh untuk API:
git ls-remote --tags origin 'api-v*-staging' -
Pilih versi yang belum dipakai. Jangan memindahkan atau menimpa tag rilis lama.
Kirim tag rilis
Contoh berikut merilis API. Ganti api-v1.2.3-staging dengan tag baru yang sesuai sebelum
menjalankan perintah.
git fetch origin dev
git tag api-v1.2.3-staging origin/dev
git push origin api-v1.2.3-stagingTag dibuat dari origin/dev, jadi tidak perlu pindah dari branch lokal saat ini. Untuk aplikasi
lain, ganti api pada tag menjadi web, client, admin, atau docs.
Yang dikerjakan workflow
- Build image dari Dockerfile aplikasi yang disebut dalam tag.
- Push image ke OCIR dengan tag versi dan
latest, misalnyahms-api-staging:v1.2.3danhms-api-staging:latest. - Hubungkan runner ke Headscale, lalu jalankan deploy melalui Tailscale SSH.
- Pull image dan jalankan ulang service aplikasi yang dipilih di staging.
Untuk API, workflow juga membuat image runtime-worker, menjalankan migrasi database sebelum API
diperbarui, lalu memperbarui worker, catalog-worker, dan runtime-worker. Tag aplikasi lain
tidak menjalankan langkah migrasi atau worker.
Periksa hasil
Lihat run terbaru di GitHub Actions atau dengan GitHub CLI:
gh run list --repo kehostingin/hms --workflow staging-build.yml --limit 5Pastikan job build dan deploy pada run tersebut sukses. Jika salah satunya gagal, sertakan
URL run dan tag rilis saat melaporkan masalah. Setelah workflow diubah, buat tag baru dari dev
yang sudah berisi perubahan tersebut. Menjalankan ulang run dari tag lama tetap memakai file
workflow pada commit tag lama.