Transmission de paramètres de configuration personnalisés à des fonctions

Découvrez comment transmettre des paramètres de configuration personnalisés à des fonctions en cours d'exécution avec OCI Functions.

Le code des fonctions déployées vers OCI Functions requiert généralement des valeurs pour différents paramètres. Certains paramètres prédéfinis sont disponibles pour les fonctions en tant que variables d'environnement (reportez-vous à Variables d'environnement alimentées par les fonctions OCI). Vous aurez toutefois fréquemment besoin de définir vous-même les paramètres utilisés par vos fonctions. Par exemple, vous pouvez créer une fonction qui lit et écrit des données dans une base de données. Cette fonction nécessite une chaîne de connexion à la base de données, composée d'un nom utilisateur, d'un mot de passe et d'un nom d'hôte. Définissez le nom utilisateur, le mot de passe et le nom d'hôte en tant que paramètres transmis à la fonction lors de son appel.

Pour transmettre des paramètres définis par l'utilisateur à une fonction déployée dans OCI Functions, 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 de deux types :

  • De niveau application, ce qui signifie qu'ils sont transmis à chaque fonction d'une application
  • Propres à une fonction, ce qui signifie qu'ils sont transmis à la fonction pour laquelle ils sont définis (les paramètres propres à une fonction remplacent les paramètres de niveau application portant le même nom)

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 les moyens suivants :

  • La section config: du fichier func.yaml d'une fonction, pour définir des paramètres de configuration personnalisés propres à une fonction
  • La console et l'interface de ligne de commande du projet Fn, pour définir des paramètres de configuration personnalisés propres aux fonctions et de niveau application

OCI Functions combine tous les paramètres de configuration personnalisés (propres à la fonction et de niveau application) dans l'application en un objet de configuration unique et codé en série avec une taille maximale autorisée 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 qu'après le prochain appel de la fonction.

Vous pouvez indiquer des paramètres de configuration personnalisés à transmettre aux fonctions à l'aide de la console, de l'interface de ligne de commande du projet Fn et de l'API. Reportez-vous à Spécification des paramètres de configuration personnalisés à transmettre aux fonctions.