Gérer les configurations de projet avec le fichier manifeste des extensions

Un manifeste d'extensions est une liste d'instances d'extension et de leurs configurations. Le fichier manifeste vous permet :

Partager la configuration de vos extensions avec d'autres utilisateurs
Copier la configuration de vos extensions entre différents projets (par exemple, de votre projet intermédiaire vers votre projet de production)
Déployer toutes vos extensions en même temps
Testez le fonctionnement de vos extensions avec votre application à l'aide de Firebase Local Emulator Suite.
Valider la configuration de vos extensions dans le contrôle de source
Inclure des extensions dans votre pipeline CI/CD

Un fichier manifeste d'extension comporte deux parties :

La section extensions de votre firebase.json, qui est une carte de référence de l'ID d'instance à la version de l'extension. Exemple :

{
 "extensions": {
   "my-bigquery-extension": "firebase/firestore-bigquery-export@^0.1.18",
   "my-image-resizer": "firebase/storage-resize-images@^0.1.22",
 }
}

Fichiers .env contenant la configuration de chacune de vos instances d'extension, dans le sous-répertoire extensions/ du répertoire de votre projet Firebase. Par exemple, une instance de storage-resize-images peut avoir un fichier .env comme suit :
```
IMAGE_TYPE=jpeg
LOCATION=us-central1
IMG_BUCKET=${param:PROJECT_ID}.firebasestorage.app
IMG_SIZES=100x100
DELETE_ORIGINAL_FILE=false
```

Si vous ne souhaitez pas enregistrer les données de configuration pour chaque instance d'extension, vous pouvez modifier le fichier firebase.json et supprimer les entrées inutiles de la section extensions.

Créer un fichier manifeste d'extensions

Il existe trois façons de créer un fichier manifeste d'extension :

Gérer le fichier manifeste de vos extensions avec la CLI Firebase
Exporter la configuration des extensions d'un projet
Modifier manuellement les fichiers manifestes

Les deux premières méthodes sont expliquées ci-dessous.

Gérer le fichier manifeste de vos extensions avec la CLI Firebase

Vous pouvez exécuter la plupart des commandes ext: de la CLI Firebase avec l'option --local pour mettre à jour le fichier manifeste des extensions sans modifier la configuration actuelle du projet.

Exemple :

firebase ext:install --local firebase/firestore-bigquery-export

L'exécution de la commande ci-dessus vous invite à configurer la dernière version de l'extension firebase/firestore-bigquery-export et à enregistrer la configuration dans le fichier manifeste, mais elle ne déploie pas la configuration dans votre projet.

Voici d'autres exemples de commandes qui modifient le fichier manifeste des extensions :

# ext:configure changes the params for an extension instance in your extensions manifest
$ firebase ext:configure my-bigquery-extension --local

# ext:update --local updates an instance in your extensions manifest
# to the latest version of that extension
$ firebase ext:update my-bigquery-extension --local

# You can also specify a version if you don't want to update to the latest version
$ firebase ext:update my-bigquery-extension firebase/firestore-bigquery-export@0.1.10 --local 

# ext:uninstall --local removes an instance from your extensions manifest
$ firebase ext:uninstall my-bigquery-extension --local

Exporter la configuration des extensions d'un projet

Pour enregistrer la configuration actuelle des extensions d'un projet dans le fichier manifeste, procédez comme suit :

Si vous ne l'avez pas déjà fait, configurez la CLI Firebase.
À partir d'une invite de shell, accédez au répertoire du projet. (Le répertoire de votre projet contient le fichier firebase.json.)
Exécutez la commande ext:export :
```
firebase ext:export
```

La commande ext:export ajoute une section extensions au fichier firebase.json. De plus, la commande ext:export crée un répertoire extensions contenant un fichier .env pour chaque instance d'extension que vous avez installée. Ces fichiers contiennent les paramètres de configuration de chaque instance.

Tester la configuration d'une extension avec Firebase Local Emulator Suite

Une fois que vous avez ajouté des instances d'extension au fichier manifeste de vos extensions, vous pouvez les tester à l'aide de Local Emulator Suite.

Installez et configurez Local Emulator Suite.
Démarrez le Local Emulator Suite :
- Pour exécuter la suite d'émulateurs de manière interactive, exécutez : firebase emulators:start
- Pour exécuter la suite d'émulateurs et un script de test, exécutez la commande suivante : firebase emulators:exec my-test.sh

Désormais, si des instances d'extension sont listées dans votre fichier manifeste, Local Emulator Suite téléchargera le code source de ces extensions dans ~/.cache/firebase/extensions. Une fois téléchargées, les Local Emulator Suite démarrent et vous pouvez déclencher n'importe quelle fonction déclenchée en arrière-plan des extensions et connecter votre application à la suite Emulator pour tester leur intégration à votre application.

Déployer une configuration d'extensions dans un projet

Une fois que vous avez ajouté des instances d'extension à votre fichier manifeste d'extension, vous pouvez le déployer dans un projet à l'aide de la CLI Firebase. Lorsque vous déployez avec un fichier manifeste d'extensions, vous installez, mettez à jour et configurez toutes les instances d'extension du fichier manifeste dans un projet à la fois.

Pour déployer un fichier manifeste d'extensions :

À partir d'une invite de commande, accédez au répertoire contenant la configuration des extensions enregistrées. (Il s'agit du répertoire contenant firebase.json. Si vous venez d'exécuter ext:export, vous êtes déjà dans le bon répertoire.)
Exécutez la commande deploy. Si vous souhaitez déployer les extensions dans un projet autre que celui en cours, spécifiez également --project= :
```
firebase deploy --only extensions –-project=YOUR_PROJECT_ID
```

La commande deploy validera la configuration de chaque instance, vous demandera si vous souhaitez supprimer des instances d'extension de votre projet de destination qui ne sont pas listées dans firebase.json, puis déploiera toutes vos instances d'extension.

Configurations d'extension spécifiques au projet

Les configurations d'extensions enregistrées peuvent être utilisées pour déployer des extensions dans plusieurs projets différents (par exemple, un projet de préproduction et un projet de production). Dans ce cas, il est possible que certaines valeurs de paramètres doivent être différentes pour chaque projet. Les fichiers .env spécifiques au projet permettent de le faire :

Placez les valeurs de paramètre qui diffèrent entre les projets dans extensions/EXTENSION_INSTANCE_ID.env.YOUR_PROJECT_ID.
Placez les valeurs des paramètres partagés dans extensions/EXTENSION_INSTANCE_ID.env.

Il peut arriver que vous souhaitiez utiliser une valeur de paramètre différente lorsque vous émulez vos extensions. Par exemple, vous pouvez fournir une clé API de test au lieu d'une clé de production. Placez ces paramètres dans un fichier .local :

Placez les paramètres non secrets que vous souhaitez utiliser lors de l'émulation dans extensions/EXTENSION_INSTANCE_ID.env.local.
Placez les valeurs des paramètres secrets dans extensions/EXTENSION_INSTANCE_ID.secret.local.