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

  • Aktifkan Cloud Build, Firebase, dan Resource Manager API.

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

    Aktifkan API

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

  • Siapkan 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 menginisialisasi Firebase.

Izin IAM yang diperlukan

  1. Di Google Cloud konsol, buka halaman Permissions Cloud Build:

    Buka Permissions

  2. Pilih akun layanan untuk build Anda.

  3. Tetapkan status peran berikut ke Enabled:

    • Cloud Build Service Account | Mengizinkan akun layanan Cloud Build lama untuk mengupdate build, menulis log build, dan menyimpan artefak build.
    • Firebase Admin | Mengizinkan Cloud Build mengakses Firebase.
    • API Keys Viewer | Mengizinkan Cloud Build mengakses konfigurasi Firebase Hosting saat ini selama deployment build.

Menggunakan image Docker firebase

Cloud Build menyediakan image builder yang dapat Anda gunakan untuk memanggil perintah firebase di Cloud Build. Untuk menggunakan builder ini dalam file konfigurasi Cloud Build, Anda dapat menggunakan langkah build firebase untuk men-deploy ke Firebase:

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

    YAML 

    steps:
- name: "us-docker.pkg.dev/firebase-cli/us/firebase"
   args: ['deploy', '--project=FIREBASE_PROJECT_ID', '--only=hosting']
## Or, target a specific version of firebase-tools
- name: "us-docker.pkg.dev/firebase-cli/us/firebase":x.y.z
   args: ['deploy', '--project=FIREBASE_PROJECT_ID', '--only=hosting']

    JSON 

    {
  "steps": [
   {
      "name": "us-docker.pkg.dev/firebase-cli/us/firebase",
      "args": [
         "deploy",
         "--project",
         "FIREBASE_PROJECT_ID",
         "--only",
         "hosting"
       ]
  }
  ]
}

    Anda dapat memilih versi firebase-tools tertentu menggunakan
    name: "us-docker.pkg.dev/firebase-cli/us/firebase":x.y.z

  2. Mulai build menggunakan file konfigurasi build:

    gcloud builds submit --region=REGION --config CONFIG_FILE_PATH SOURCE_DIRECTORY

    Dengan:

    • REGION adalah salah satu wilayah build yang didukung.
    • CONFIG_FILE_PATH adalah jalur ke file konfigurasi build.
    • SOURCE_DIRECTORY adalah jalur atau URL ke kode sumber.

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 memperbarui 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 Anda: Google Cloud

    YAML

    steps:
      - name: us-docker.pkg.dev/firebase-cli/us/firebase
        args: ['deploy', '--project=PROJECT_ID', '--only=hosting']

    JSON 

    {
  "steps": [
   {
      "name": "us-docker.pkg.dev/firebase-cli/us/firebase",
      "args": [
         "deploy",
         "--project",
         "PROJECT_ID",
         "--only",
         "hosting"
       ]
  }
  ]
}

  2. Buat pemicu dengan file konfigurasi build yang dibuat pada langkah sebelumnya:

    1. Buka halaman Triggers di Google Cloud konsol:

      Buka halaman Triggers

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

    3. Klik Open.

    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 regex untuk nama cabang atau tag yang akan memulai pemicu Anda.

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

    5. Klik Create untuk menyimpan pemicu build Anda.

Setiap kali Anda mengirim kode baru ke repositori, Anda akan otomatis memulai build dan men-deploy di Firebase.

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

Contoh kode

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

Langkah berikutnya