Melakukan deployment ke saluran live & pratinjau melalui permintaan pull GitHub

Anda dapat mengintegrasikan deployment ke Firebase Hosting melalui GitHub Action. Berikut adalah kegunaan GitHub Action ini:

  • Membuat saluran pratinjau baru (dan URL pratinjau terkaitnya) untuk setiap permintaan pull yang ada di repositori GitHub.

  • Menambahkan komentar ke permintaan pull dengan URL pratinjau, sehingga Anda dan setiap peninjau dapat melihat dan menguji perubahan dalam permintaan pull dalam versi "pratinjau" aplikasi Anda.

    gambar komentar permintaan pull GitHub Action dengan URL pratinjau

  • Memperbarui URL pratinjau dengan perubahan dari setiap commit dengan otomatis melakukan deployment ke saluran pratinjau yang terkait. URL tidak berubah dengan setiap commit baru.

  • (Opsional) Men-deploy repo GitHub dalam statusnya saat ini ke saluran Anda saat permintaan pull digabungkan.

Pengingat: Saat menggunakan URL pratinjau, aplikasi Anda berinteraksi dengan resource backend sebenarnya dari project Firebase Anda.

Menyiapkan GitHub Action yang akan di-deploy ke Firebase Hosting

  1. Buat repositori GitHub (publik atau pribadi) atau gunakan repositori yang ada. Anda harus memiliki izin admin untuk repositori ini.

  2. Dalam versi lokal repo Anda, siapkan Firebase Hosting menggunakan perintah firebase init.

    • Jika TIDAK menyiapkan Hosting, jalankan perintah versi ini dari root direktori lokal Anda:

      firebase init hosting
    • Jika SUDAH menyiapkan Hosting, Anda hanya perlu menyiapkan bagian GitHub Action pada Hosting. Jalankan perintah versi ini dari root direktori lokal Anda:

      firebase init hosting:github
  3. Ikuti prompt CLI, dan perintah akan otomatis menangani penyiapan GitHub Action:

    • Membuat akun layanan di project Firebase Anda dengan izin untuk melakukan deployment ke Firebase Hosting.

    • Mengenkripsi kunci JSON akun layanan tersebut dan menguploadnya ke repositori GitHub yang ditentukan sebagai rahasia GitHub.

    • Menulis file konfigurasi yaml alur kerja GitHub yang mereferensikan rahasia yang baru dibuat tersebut. File ini mengonfigurasi GitHub Action yang akan di-deploy ke Firebase Hosting.

  4. Di GitHub, buat cabang baru dan commit file yaml alur kerja yang dibuat oleh CLI.

  5. Publikasikan cabang tersebut ke repositori GitHub Anda.

  6. Gabungkan cabang.

Selesai! Semua permintaan pull berikutnya dalam repo GitHub ini akan otomatis mendapatkan "URL pratinjau"-nya sendiri.

Pelajari GitHub Action lebih lanjut

  • Firebase mengelola GitHub Action "Deploy to Firebase Hosting" sebagai project open source. Lihat kode sumbernya.

  • GitHub Action "Deploy to Firebase Hosting" memungkinkan konfigurasi lebih lanjut, seperti menyesuaikan tanggal habis masa berlaku untuk saluran pratinjau atau menetapkan saluran non-live yang menjadi tujuan deployment saat permintaan pull digabungkan. Pelajari opsi konfigurasi yang tersedia.

  • Pelajari lebih lanjut GitHub Action secara umum.