Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
globe

GitHub Action

Deploy to Firebase Hosting

v0.2-alpha Pre-release

Deploy to Firebase Hosting

globe

Deploy to Firebase Hosting

A GitHub Action to deploy to Firebase Hosting

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Deploy to Firebase Hosting

uses: FirebaseExtended/action-hosting-deploy@v0.2-alpha

Learn more about this action in FirebaseExtended/action-hosting-deploy

Choose a version

Firebase Hosting GitHub Action

Usage

Deploy a to a new preview channel for every PR

Add a workflow (.github/workflows/deploy-preview.yml):

name: Deploy Preview

on:
  pull_request:
    # Optionally configure to run only for specific files. For example:
    # paths:
    # - "website/**"

jobs:
  build_and_preview:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      # Add any build steps here. For example:
      # - run: npm run build
      - uses: FirebaseExtended/action-hosting-deploy@v1
        with:
          repoToken: "${{ secrets.GITHUB_TOKEN }}"
          firebaseServiceAccount: "${{ secrets.FIREBASE_SERVICE_ACCOUNT }}"
          expires: 30d
          projectId: your-Firebase-project-ID
        env:
          FIREBASE_CLI_PREVIEWS: hostingchannels

Deploy to your live site on merge

Add a workflow (.github/workflows/deploy-prod.yml):

name: Deploy Production Site

on:
  push:
    branches:
      - master
    # Optionally configure to run only for specific files. For example:
    # paths:
    # - "website/**"

jobs:
  build_and_preview:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      # Add any build steps here. For example:
      # - run: npm run build
      - uses: FirebaseExtended/action-hosting-deploy@v1
        with:
          repoToken: "${{ secrets.GITHUB_TOKEN }}"
          firebaseServiceAccount: "${{ secrets.FIREBASE_SERVICE_ACCOUNT }}"
          expires: 30d
          projectId: your-Firebase-project-ID
          channelId: live

Options

firebaseServiceAccount {string} (required)

This is a service account JSON key.

It's important to store this token as an encrypted secret to prevent unintended access your Firebase project. Set it in the "Secrets" area of your repository settings and add it as FIREBASE_SERVICE_ACCOUNT: https://github.com/USERNAME/REPOSITORY/settings/secrets

repoToken {string}

Adding repoToken: "${{secrets.GITHUB_TOKEN}}" lets the action comment on PRs with the link to the deploy preview. You don't need to set this secret yourself - github will set it automatically.

If you omit this option, you'll need to find the preview URL in the action's build log.

expires {string}

⚠️ This option isn't supported yet. If you set it, it will be ignored. See issue #7 for context.

The length of time the channel should live. Default is 7 days.

projectId {string}

The project to deploy to. If you leave this blank, be sure to check in a .firebaserc file so the CLI knows what project to deploy to.

channelId {string}

The channel to deploy to. If you don't set it, a new channel will be created per-PR or per-branch. If you set it to live, the action will deploy to your production Hosting site.

You usually want to leave this blank so that each PR gets its own channel, unless you know you want to deploy a certain branch to a long-lived channel (for example, you may want to deploy every commit from your next branch to a preprod channel)

entryPoint {string}

The location of your firebase.json file. Defaults to . (the root of your repo).


This GitHub Action is not an officially supported Google product