Déployer sur Firebase

Cette page explique comment déployer des applications sur Firebase à l'aide de Cloud Build. Si vous débutez avec Cloud Build, commencez par lire les Guides de démarrage rapide et la Présentation de la configuration des compilations.

Avant de commencer

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

    Enable the APIs

  • Pour exécuter les commandes gcloud sur cette page, installez Google Cloud CLI.

  • Gardez à portée de main le code source de votre application ainsi que le fichier firebase.json. Votre code source doit être stocké dans un dépôt, tel que Cloud Source Repositories, GitHub ou Bitbucket.

  • Si vous n'avez pas encore de projet à déployer sur Firebase, vous pouvez créer un projet par défaut en installant et en initialisant Firebase.

Autorisations IAM requises

  1. Ouvrez la page IAM dans la console Google Cloud  :

    Ouvrir la page IAM

  2. Sélectionnez votre projet et cliquez sur Ouvrir.

  3. Dans le tableau des autorisations, recherchez l'adresse e-mail du compte de service que vous utilisez pour la compilation, puis cliquez sur l'icône en forme de crayon.

  4. Ajoutez les rôles Cloud Build Service Account(roles/cloudbuild.builds.builder), Firebase Admin (roles/firebase.admin) et API Keys Admin (roles/serviceusage.apiKeysAdmin) au compte de service.

  5. Cliquez sur Enregistrer.

Utiliser l'image Docker firebase

Cloud Build fournit une image de compilateur que vous pouvez utiliser pour appeler des commandes firebase dans Cloud Build. Pour utiliser ce compilateur dans un fichier de configuration Cloud Build, vous pouvez utiliser l'étape de compilation firebase pour effectuer un déploiement sur Firebase :

  1. Créez un fichier de configuration de compilation nommé cloudbuild.yaml ou cloudbuild.json, où PROJECT_ID correspond à l'ID de votre projetGoogle Cloud et FIREBASE_PROJECT_ID à votre ID de projet Firebase :

    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"
       ]
  }
  ]
}

    Vous pouvez choisir une version spécifique de firebase-tools en utilisant
    name: "us-docker.pkg.dev/firebase-cli/us/firebase":x.y.z

  2. Lancez la compilation à l'aide du fichier de configuration de compilation :

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

    Où :

    • REGION désigne l'une des régions de compilation compatibles.
    • CONFIG_FILE_PATH est le chemin d'accès du fichier de configuration de compilation
    • SOURCE_DIRECTORY est le chemin d'accès ou l'URL du code source.

Déploiement continu

Vous pouvez automatiser le déploiement de votre logiciel dans Firebase en créant des déclencheurs Cloud Build. Vous pouvez configurer des déclencheurs pour créer et déployer des images chaque fois que vous mettez à jour votre code source.

Pour automatiser votre déploiement sur Firebase :

  1. Dans votre dépôt, ajoutez un fichier de configuration de compilation avec des étapes pour appeler la commande firebase deploy, où PROJECT_ID correspond à l'ID de votre projet 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. Créez un déclencheur avec le fichier de configuration de compilation créé à l'étape précédente :

    1. Ouvrez la page Déclencheurs dans la console Google Cloud  :

      Ouvrir la page Déclencheurs

    2. Sélectionnez votre projet dans le menu déroulant du sélecteur de projet, en haut de la page.

    3. Cliquez sur Ouvrir.

    4. Cliquez sur Créer un déclencheur.

      Sur la page Créer un déclencheur, saisissez les paramètres suivants :

      1. Nommez votre déclencheur.

      2. Sélectionnez l'événement de dépôt pour démarrer le déclencheur.

      3. Sélectionnez le dépôt contenant le code source et le fichier de configuration de compilation.

      4. Indiquez l'expression régulière correspondant au nom de la branche ou du tag qui démarrera votre déclencheur.

      5. Configuration : sélectionnez le fichier de configuration de compilation créé précédemment.

    5. Cliquez sur Créer pour enregistrer le déclencheur de compilation.

Chaque fois que vous transmettez du nouveau code dans votre dépôt, vous lancez automatiquement une compilation et un déploiement dans Firebase.

Pour en savoir plus sur la création de déclencheurs Cloud Build, consultez la page Créer et gérer des déclencheurs de compilation.

Exemple de code

Pour afficher un exemple de code pour le déploiement sur Firebase à l'aide de Cloud Build, accédez à deploy-firebase-example.

Étapes suivantes