This page explains how to deploy applications toFirebase usingCloud Build. If you're new to Cloud Build, read thequickstarts and theBuild configuration overview first.

Before you begin

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

  Roles required to enable APIs

  To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enable permission.Learn how to grant roles.

  Enable the APIs

• To run thegcloud commands on this page, install theGoogle Cloud CLI.

• Keep your application source code includingfirebase.json handy. Yoursource code needs to be stored in a repository, such asCloud Source Repositories, GitHub, or Bitbucket.

• If you don't already have a project to deploy to Firebase, you cancreate a default project byinstalling and initializing Firebase.

1. In the Google Cloud console, go to thesettings Cloud BuildPermissions page:

   Go toPermissions

2. Select the service account for your build.

3. Set the status of the following roles toEnabled:

   • Cloud Build Service Account | Allows the legacy Cloud Buildservice account to update builds, write build logs, and store buildartifacts.
   • Firebase Admin | Allows Cloud Build to access Firebase.
   • API Keys Viewer | Allows Cloud Build to access the currentFirebase Hosting configuration during build deployment.

Using thefirebase Docker image

Cloud Build provides a builder image that you can use to invokefirebase commands in Cloud Build. To use this builder in aCloud Build config file, you can use thefirebase build step todeploy to Firebase:

1. Create a build config file namedcloudbuild.yaml orcloudbuild.json wherePROJECT_ID is yourGoogle Cloud project ID andFIREBASE_PROJECT_ID isyour Firebase project ID:

   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.zargs:['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"]}]}

   You can choose a specific version offirebase-tools by using
   name: "us-docker.pkg.dev/firebase-cli/us/firebase":x.y.z

2. Start the build using the build config file:

   gcloudbuildssubmit--region=REGION--configCONFIG_FILE_PATHSOURCE_DIRECTORY

   Where:

   • REGION is one of thesupported build regions.
   • CONFIG_FILE_PATH is the path to the build config file.
   • SOURCE_DIRECTORY is the path or URL to the source code.

Continuous deployment

You can automate the deployment of your software to Firebase bycreating Cloud Build triggers. You can configure triggers to buildand deploy images whenever you update your source code.

To automate your deployment to Firebase:

1. In your repository, add a build config file with steps to invoke thefirebase deploy command wherePROJECT_IDis your Google Cloud project ID:

   YAML

   steps:-name:us-docker.pkg.dev/firebase-cli/us/firebaseargs:['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. Create a trigger with the build config file created in the previous step:

   1. Open theTriggers page in the Google Cloud console:

      Open Triggers page

   2. Select your project from the project selector drop-down menu at the top ofthe page.

   3. ClickOpen.

   4. ClickCreate trigger.

      On theCreate trigger page, enter the following settings:

      1. Enter a name for your trigger.

      2. Select the repository event to start your trigger.

      3. Select the repository that contains your source code and buildconfig file.

      4. Specify the regex for the branch or tag name that will start yourtrigger.

      5. Configuration: Choose the build config file you createdpreviously.

   5. ClickCreate to save your build trigger.

Anytime you push new code to your repository, you will automatically start abuild and deploy on Firebase.

For more information on creating Cloud Build triggers, seeCreating and managing build triggers.

Code example

To view a code sample for deploying to Firebase using Cloud Build, go todeploy-firebase-example.

What's next

• Learn how toperform blue/green deployments on Compute Engine
• Learn how todeploy on Cloud Run
• Learn how todeploy on GKE
• Learn how todeploy on Cloud Run functions
• Learn how todeploy on App Engine
• Learn how totroubleshoot build errors