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

Autorisations IAM requises

  1. Ouvrez la page "IAM" dans Cloud Console :

    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 la compilation à votre projet :

    gcloud builds submit .
    
  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 l'ID de votre projet Cloud et firebase-project-id de 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 --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.

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 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 Google Cloud Console :

      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.

Étape suivante