My App

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

  1. Pastikan perubahan yang akan dirilis sudah masuk ke branch dev.

  2. Cek tag yang sudah ada untuk aplikasi tersebut. Contoh untuk API:

    git ls-remote --tags origin 'api-v*-staging'
  3. 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-staging

Tag 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

  1. Build image dari Dockerfile aplikasi yang disebut dalam tag.
  2. Push image ke OCIR dengan tag versi dan latest, misalnya hms-api-staging:v1.2.3 dan hms-api-staging:latest.
  3. Hubungkan runner ke Headscale, lalu jalankan deploy melalui Tailscale SSH.
  4. 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 5

Pastikan 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.

On this page