Transmission de paramètres de configuration personnalisés aux fonctions
Découvrez comment transmettre des paramètres de configuration personnalisés aux fonctions exécutées avec le service des fonctions pour OCI.
Le code indiqué dans les fonctions que vous déployez dans le service des fonctions pour OCI nécessite généralement des valeurs pour différents paramètres. Certains paramètres prédéfinis sont disponibles pour vos fonctions en tant que variables d'environnement (voir Variables d'environnement alimentées par le service des fonctions pour OCI). Toutefois, vous voudrez souvent que vos fonctions utilisent des paramètres que vous avez définis vous-même. Par exemple, vous pouvez créer une fonction qui lit depuis et écrit dans une base de données. La fonction nécessitera une chaîne de connexion à la base de données, comprenant le nom d'utilisateur, le mot de passe et le nom d'hôte. Vous voudrez probablement définir le nom d'utilisateur, le mot de passe et le nom d'hôte en tant que paramètres transmis à la fonction lors de l'appel.
Pour transmettre des paramètres définis par l'utilisateur à une fonction déployée dans le service des fonctions pour OCI, vous créez des paires clé-valeur appelées paramètres de configuration personnalisés. Vous pouvez créer des paramètres de configuration personnalisés :
- À l'échelle de l'application, ce qui signifie qu'ils sont transmis à chaque fonction d'une application.
- Propres à la fonction, ce qui signifie qu'ils sont transmis à une fonction particulière pour laquelle ils sont définis (les paramètres propres à la fonction remplacent les paramètres portant le même nom à l'échelle de l'application).
Les paramètres de configuration personnalisés que vous créez sont également définis en tant que variables d'environnement.
Pour créer des paramètres de configuration personnalisés, vous pouvez utiliser :
- La section
config:
du fichier func.yaml d'une fonction pour définir des paramètres de configuration personnalisés propres à la fonction. - La Console et l'interface de ligne de commande Fn Project pour définir à la fois des paramètres de configuration personnalisés à l'échelle de l'application et propres à la fonction.
Le service des fonctions pour OCI combine tous les paramètres de configuration personnalisés (à l'échelle de l'application et propres à la fonction) dans l'application en un seul objet de configuration encodé en série dont la taille maximale autorisée est de 4 Ko.
Notez que si vous modifiez par la suite la valeur d'un paramètre de configuration personnalisé, la modification est appliquée presque immédiatement, mais elle ne prend effet que lorsque la fonction est appelée par la suite.
Vous pouvez spécifier des paramètres de configuration personnalisés à transmettre aux fonctions à l'aide de la console, de l'interface de ligne de commande Fn Project et de l'API. Voir Spécification des paramètres de configuration personnalisés à transmettre aux fonctions.