Men-deploy ke Firebase

Halaman ini menjelaskan cara men-deploy aplikasi ke Firebase menggunakan Cloud Build. Jika Anda baru menggunakan Cloud Build, baca panduan memulai dan ringkasan konfigurasi build terlebih dahulu.

Sebelum memulai

  • Enable the Cloud Build, Firebase, and Resource Manager APIs.

    Enable the APIs

  • Untuk menjalankan perintah gcloud di halaman ini, instal Google Cloud CLI.

  • Simpan kode sumber aplikasi Anda termasuk firebase.json. Kode sumber Anda harus disimpan di repositori, seperti Cloud Source Repositories, GitHub, atau Bitbucket.

  • Jika belum memiliki project untuk di-deploy ke Firebase, Anda dapat membuat project default dengan menginstal dan melakukan inisialisasi Firebase.

Izin IAM yang diperlukan

  1. Buka halaman IAM di konsol Google Cloud:

    Buka halaman IAM

  2. Pilih project Anda lalu klik Buka.

  3. Di tabel izin, temukan email untuk akun layanan yang Anda gunakan untuk build, lalu klik ikon pensil.

  4. Tambahkan peran Cloud Build Service Account, Firebase Admin, dan API Keys Admin.

  5. Klik Simpan.

Menggunakan pembuat komunitas firebase

Cloud Build menyediakan image builder komunitas Firebase yang dapat Anda gunakan untuk memanggil perintah firebase di Cloud Build. Untuk menggunakan builder ini dalam file konfigurasi Cloud Build, Anda harus mem-build image terlebih dahulu dan mendorongnya ke Container Registry dalam project Anda.

Untuk mem-build dan mendorong pembuat komunitas firebase:

  1. Buka direktori utama project Anda.

  2. Clone repositori cloud-builders-community:

    git clone https://github.com/GoogleCloudPlatform/cloud-builders-community.git
    
  3. Buka image builder firebase:

    cd cloud-builders-community/firebase
    
  4. Kirim builder ke project Anda, dengan REGION adalah salah satu region build yang didukung:

    gcloud builds submit --region=REGION .
    
  5. Kembali ke direktori utama project Anda:

    cd ../..
    
  6. Hapus repositori dari direktori root Anda:

    rm -rf cloud-builders-community/
    

Mengonfigurasi deployment

Setelah mem-build builder komunitas firebase, Anda dapat menggunakan langkah build firebase di file konfigurasi build untuk men-deploy ke Firebase:

  1. Buat file konfigurasi build bernama cloudbuild.yaml atau cloudbuild.json dengan project-id sebagai project ID Google Cloud Anda dan firebase-project-id sebagai project ID Firebase Anda:

    YAML

          steps:
          - name: gcr.io/project-id/firebase
            args: ['deploy', '--project=firebase-project-id', '--only=hosting']
    

    JSON

    {
      "steps": [
       {
          "name": "gcr.io/project-id/firebase",
          "args": [
             "deploy",
             "--project",
             "firebase-project-id",
             "--only",
             "hosting"
           ]
      }
      ]
    }
    
  2. Mulai build menggunakan file konfigurasi build:

    gcloud builds submit --region=REGION --config config-file-path source-directory
    

    Dengan keterangan:

    • config-file-path adalah jalur ke file konfigurasi build.
    • source-directory adalah jalur atau URL ke kode sumber.
    • REGION adalah salah satu region build yang didukung.

Deployment berkelanjutan

Anda dapat mengotomatiskan deployment software ke Firebase dengan membuat pemicu Cloud Build. Anda dapat mengonfigurasi pemicu untuk mem-build dan men-deploy image setiap kali Anda mengupdate kode sumber.

Untuk mengotomatiskan deployment ke Firebase:

  1. Di repositori Anda, tambahkan file konfigurasi build dengan langkah-langkah untuk memanggil perintah firebase deploy dengan project-id sebagai project ID Google Cloud Anda:

    YAML

    steps:
          - name: gcr.io/project-id/firebase
            args: ['deploy', '--project=project-id', '--only=hosting']
    

    JSON

    {
      "steps": [
       {
          "name": "gcr.io/project-id/firebase",
          "args": [
             "deploy",
             "--project",
             "project-id",
             "--only",
             "hosting"
           ]
      }
      ]
    }
    
  2. Buat pemicu dengan file konfigurasi build yang dibuat di langkah sebelumnya:

    1. Buka halaman Pemicu di konsol Google Cloud:

      Buka halaman Pemicu

    2. Pilih project Anda dari menu drop-down pemilih project di bagian atas halaman.

    3. Klik Buka.

    4. Klik Create trigger.

      Di halaman Create trigger, masukkan setelan berikut:

      1. Masukkan nama untuk pemicu Anda.

      2. Pilih peristiwa repositori untuk memulai pemicu Anda.

      3. Pilih repositori yang berisi kode sumber dan file konfigurasi build Anda.

      4. Tentukan ekspresi reguler untuk nama cabang atau tag yang akan memulai pemicu Anda.

      5. Configuration: Pilih file konfigurasi build yang Anda buat sebelumnya.

    5. Klik Buat untuk menyimpan pemicu build Anda.

Setiap kali Anda melakukan push kode baru ke repositori, Anda akan otomatis memulai build dan deployment di Firebase.

Untuk informasi selengkapnya tentang cara membuat pemicu Cloud Build, lihat Membuat dan mengelola pemicu build.

Contoh kode

Untuk melihat contoh kode untuk di-deploy ke Firebase menggunakan Cloud Build, buka deploy-firebase-example.

Langkah selanjutnya