Les paramètres sont le mécanisme par lequel un utilisateur personnalise chaque instance installée d'une extension. Les paramètres sont comme les variables d'environnement d'une extension. Les valeurs des paramètres peuvent être renseignées automatiquement (fournies par Firebase après l'installation) ou configurées par l'utilisateur (spécifiées par l'utilisateur lors de l'installation).
Vous pouvez référencer ces paramètres dans le code source des fonctions de votre extension, dans votre fichier extension.yaml et dans votre fichier POSTINSTALL.md. Voici la syntaxe permettant de référencer un paramètre nommé PARAMETER_NAME :
Dans le code source de vos fonctions, utilisez le module
params(par exemple,params.defineInt("PARAMETER_NAME")) ouprocess.env.PARAMETER_NAME.Dans
extension.yamletPOSTINSTALL.md, utilisez${param:PARAMETER_NAME}.Après l'installation, la console Firebase affiche le contenu du fichier
POSTINSTALL.mdet remplace toutes les références de paramètres par les valeurs réelles de l'instance installée.
Paramètres renseignés automatiquement
Chaque instance installée d'une extension a automatiquement accès à plusieurs paramètres par défaut renseignés automatiquement par Firebase (voir le tableau ci-dessous). Ces valeurs de paramètre sont soit les valeurs par défaut du projet Firebase (comme le bucket Storage par défaut), soit des valeurs spécifiques à l'extension (comme l'ID d'instance de l'extension).
Toutes les valeurs de paramètres renseignées automatiquement sont immuables. Elles sont définies au moment de la création du projet ou de l'installation de l'extension.
Même si Firebase remplit automatiquement ces valeurs de paramètre pour l'extension, Firebase ne provisionne pas automatiquement les produits associés pour l'utilisateur lors de l'installation. L'utilisateur qui installe l'extension doit activer les produits associés et applicables dans son projet avant l'installation. Par exemple, si votre extension implique Cloud Firestore, l'utilisateur doit configurer Cloud Firestore dans son projet. Nous vous recommandons d'informer vos utilisateurs de ces exigences dans le fichier PREINSTALL.md.
| Référence pour le paramètre renseigné automatiquement | Description | Valeur du paramètre (fournie par Firebase) |
|---|---|---|
| Paramètres avec des valeurs par défaut du projet Firebase | ||
PROJECT_ID |
Identifiant unique du projet Firebase dans lequel l'extension est installée. |
Format généralisé :
Exemple de valeur : |
DATABASE_URL |
URL de l'instance Realtime Database par défaut du projet Firebase |
Format généralisé :
Exemple de valeur : |
DATABASE_INSTANCE |
Nom de l'instance Realtime Database par défaut du projet Firebase En règle générale, cette valeur est identique à l'ID du projet ou se termine par |
Format généralisé :
Exemple de valeur : |
STORAGE_BUCKET |
Nom du bucket Cloud Storage par défaut du projet Firebase |
Format généralisé :
Exemple de valeur : |
| Paramètre avec la valeur par défaut de l'installation de l'extension | ||
EXT_INSTANCE_ID |
Identifiant unique de l'instance d'extension installée Cette valeur est générée à partir du champ |
Format généralisé pour la première instance installée (attribué automatiquement par Firebase ; ne peut pas être modifié par l'utilisateur lors de l'installation) :
Exemple de valeur : Format généralisé pour la deuxième instance installée et les suivantes (attribué automatiquement par Firebase ; peut être modifié par l'utilisateur lors de l'installation) :
Exemple de valeur : |
Paramètres configurés par l'utilisateur
Pour permettre à un utilisateur de personnaliser chaque instance installée d'une extension, vous pouvez lui demander de spécifier des valeurs de paramètres lors de l'installation. Pour demander ces valeurs, vous devez configurer les invites dans la section params de votre fichier extension.yaml.
Voici un exemple de section params, suivi d'un tableau décrivant tous les champs de paramètres disponibles.
# extension.yaml
...
# Parameters (environment variables) for which the user specifies values during installation
params:
- param: DB_PATH
label: Realtime Database path
description: >-
What is the Realtime Database path where you will write new text
for sentiment analysis?
type: string
validationRegex: ^\S+$
validationErrorMessage: Realtime Database path cannot contain spaces.
example: path/to/posts
required: true
- param: TEXT_KEY
label: Key for text
description: What is the name of the key that will contain text to be analyzed?
type: string
default: textToAnalyze
required: true
Dans la section params de votre fichier extension.yaml, utilisez les champs suivants pour définir un paramètre configuré par l'utilisateur :
| Champ | Type | Description | ||||
|---|---|---|---|---|---|---|
param(obligatoire) |
chaîne | Nom du paramètre | ||||
label(obligatoire) |
chaîne |
Brève description du paramètre S'affiche lorsque l'utilisateur est invité à saisir la valeur du paramètre. |
||||
description(facultatif) |
chaîne |
Description détaillée du paramètre S'affiche lorsque l'utilisateur est invité à saisir la valeur du paramètre. Compatible avec Markdown | ||||
type(facultatif) |
chaîne |
Mécanisme de saisie permettant à l'utilisateur de définir la valeur du paramètre (par exemple, saisir du texte directement ou sélectionner une valeur dans une liste déroulante) Les valeurs valides sont les suivantes:
Si ce champ est omis, le paramètre est défini par défaut sur |
||||
options(obligatoire si le paramètre type
est select ou multiSelect)
|
list |
Liste des valeurs parmi lesquelles l'utilisateur peut choisir Incluez les champs
Le champ |
||||
resourceType(obligatoire si le paramètre type est défini sur selectResource)
|
chaîne |
Type de ressource Firebase que l'utilisateur doit sélectionner. Actuellement, seuls les buckets Cloud Storage sont compatibles avec les sélecteurs de ressources :
Les valeurs |
||||
example(facultatif) |
chaîne |
Exemple de valeur pour le paramètre |
||||
validationRegex(facultatif) (applicable uniquement lorsque le paramètre type est string)
|
chaîne |
Chaîne d'expression régulière pour la validation de la valeur du paramètre configurée par l'utilisateur L'expression régulière est compilée à l'aide de la bibliothèque Go : RE2. Pour en savoir plus sur la validation, consultez la section Validation et messages d'erreur ci-dessous. |
||||
validationErrorMessage(facultatif) |
chaîne |
Message d'erreur à afficher en cas d'échec de Pour en savoir plus sur les messages d'erreur, consultez la section Validation et messages d'erreur ci-dessous. |
||||
default(facultatif) |
chaîne |
Valeur par défaut du paramètre si l'utilisateur laisse la valeur du paramètre vide Le cas échéant, vous pouvez spécifier une valeur de paramètre préremplie pour la valeur |
||||
required(facultatif) |
booléen |
Indique si l'utilisateur peut envoyer une chaîne vide lorsqu'il est invité à saisir la valeur du paramètre. Si |
||||
immutable(facultatif) |
booléen |
Indique si l'utilisateur peut modifier la valeur du paramètre après l'installation (par exemple, s'il reconfigure l'extension). Si
Remarque : Si vous définissez un paramètre "location" pour les fonctions déployées de votre extension, vous devez inclure ce champ |
Validation et messages d'erreur pour les valeurs configurées par l'utilisateur
Lorsque vous configurez un paramètre avec le type de string, vous devez définir une validation d'expression régulière appropriée via le champ validationRegex du paramètre.
De plus, pour de nombreuses extensions, une valeur de paramètre couramment demandée est un chemin d'accès à la base de données ou un bucket Cloud Storage. Sachez que lors de l'installation, de la reconfiguration ou de la mise à jour, le service Extensions ne valide pas les éléments suivants au moment de la saisie de la valeur de paramètre :
- Si la base de données ou le bucket Cloud Storage spécifiés sont configurés dans le projet Firebase de l'utilisateur
- Indique si le chemin d'accès à la base de données spécifié existe dans la base de données de l'utilisateur.
Toutefois, lorsque l'extension déploie ses ressources, la console Firebase ou la CLI Firebase affiche un message d'erreur si la base de données ou le bucket Cloud Storage référencé n'est pas encore configuré dans le projet.
Nous vous recommandons vivement d'informer les utilisateurs de ces exigences dans le fichier PREINSTALL afin que l'extension s'installe correctement et fonctionne comme prévu.
Paramètres système
Les paramètres système contrôlent la configuration de base des ressources d'une extension. Comme elles sont destinées à contrôler la configuration des ressources, elles ne sont pas accessibles en tant que variables d'environnement depuis le code de votre fonction.
Normalement, vous n'avez rien à déclarer pour ces paramètres dans extension.yaml.
Ils sont automatiquement définis pour chaque instance d'extension, et les utilisateurs peuvent définir des valeurs personnalisées lorsqu'ils installent votre extension.
Toutefois, si votre extension présente des exigences particulières en termes de ressources, vous pouvez définir des valeurs spécifiques par ressource dans extension.yaml.
Ces paramètres de configuration par ressource remplaceront les paramètres de l'instance d'extension de l'utilisateur.
Exemple :
resources:
- name: high_memory_function
type: firebaseextensions.v1beta.function
description: >-
This function needs at least 1GB of memory!
properties:
httpsTrigger: {}
runtime: nodejs18
availableMemoryMb: 1024
- name: normal_function
type: firebaseextensions.v1beta.function
description: >-
This function has no special memory requirements. It will use the
default value, or the value of `firebaseextension.v1beta.function/memory`
properties:
httpsTrigger: {}
runtime: nodejs18
Les paramètres système disponibles sont les suivants :
| Nom | Libellé (lisible par l'utilisateur) | Champ correspondant dans properties |
Description |
|---|---|---|---|
| firebaseextensions.v1beta.function/location | Emplacement | location |
Dans quelle région Cloud Functions doit-il être déployé ? |
| firebaseextensions.v1beta.function/memory | Mémoire de la fonction | memory |
Combien de mégaoctets de mémoire doivent être alloués à chaque fonction ? |
| firebaseextensions.v1beta.function/timeoutSeconds | Délai avant expiration de la fonction | timeout |
Combien de secondes les fonctions doivent-elles s'exécuter avant d'expirer ? |
| firebaseextensions.v1beta.function/vpcConnectorEgressSettings | Sortie du connecteur VPC | vpcConnectorEgressSettings |
Contrôle le trafic sortant lorsqu'un connecteur VPC est configuré |
| firebaseextensions.v1beta.function/vpcConnector | Connecteur VPC | vpcConnector |
Connecte Cloud Functions au connecteur VPC spécifié. |
| firebaseextensions.v1beta.function/minInstances | Nombre minimal d'instances de fonction | minInstances |
Nombre minimal d'instances de cette fonction à exécuter simultanément |
| firebaseextensions.v1beta.function/maxInstances | Nombre maximum d'instances de fonction | maxInstances |
Nombre maximal d'instances de cette fonction à exécuter simultanément |
| firebaseextensions.v1beta.function/ingressSettings | Paramètres d'entrée | ingressSettings |
Contrôle d'où provient le trafic entrant accepté |
| firebaseextensions.v1beta.function/labels | Étiquettes | labels |
Étiquettes à appliquer à toutes les ressources de l'extension |