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

  • Activer les API Cloud Build, Firebase, and Resource Manager.

    Activer les API

  • Pour exécuter les commandes gcloud sur cette page, installez la 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'e-mail se terminant par @cloudbuild.gserviceaccount.com, puis cliquez sur l'icône en forme de crayon. Il s'agit du compte de service Cloud Build.

  4. Ajoutez les rôles Cloud Build Service Account, Firebase Admin et API Keys Admin.

  5. Cliquez sur Save.

Utiliser le compilateur de la communauté firebase

Cloud Build fournit une image de compilateur Firebase générée par la communauté que vous pouvez utiliser pour appeler des commandes firebase dans Cloud Build. Pour utiliser ce compilateur dans un fichier de configuration Cloud Build, vous devez d'abord créer l'image et la transférer vers Container Registry dans votre projet.

Pour créer et déployer le compilateur de la communauté firebase, procédez comme suit :

  1. Accédez au répertoire racine de votre projet.

  2. Clonez le dépôt cloud-builders-community :

    git clone https://github.com/GoogleCloudPlatform/cloud-builders-community.git

  3. Accédez à l'image à l'aide du compilateur firebase :

    cd cloud-builders-community/firebase

  4. Envoyez le compilateur à votre projet, où REGION est l'une des régions de compilation compatibles:

    gcloud builds submit --region=REGION .

  5. Revenez au répertoire racine de votre projet :

    cd ../..

  6. Supprimez le dépôt de votre répertoire racine :

    rm -rf cloud-builders-community/

Configurer le déploiement

Après avoir créé le compilateur de la communauté firebase, vous pouvez utiliser l'étape de compilation firebase de votre fichier de configuration de compilation à déployer sur Firebase :

  1. Créez un fichier de configuration de compilation nommé cloudbuild.yaml ou cloudbuild.json, où project-id est votre ID de projet Google Cloud et firebase-project-id est votre ID de projet Firebase:

    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. Commencez la compilation à l'aide du fichier de configuration de compilation :

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

    Où :

    • 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.
    • REGION est l'une des régions de compilation compatibles.

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 contenant des étapes permettant d'appeler la commande firebase deploy, où project-id correspond à l'ID de votre projet Google Cloud:

    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. 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