Création d'une fonction
Découvrez comment créer des fonctions dans le serveur du service des fonctions pour OCI à partir d'une image Docker existante qui a déjà été poussée vers le registre Docker.
Pour les préalables et plus d'informations, voir Création de fonctions.
- Dans la page de liste Applications, sélectionnez l'application dans laquelle vous voulez créer la fonction. Si vous avez besoin d'aide pour trouver la page de liste ou l'application, voir Liste des applications.
-
Sélectionnez l'onglet Fonctions.
La page de liste Fonctions s'ouvre. Toutes les fonctions de l'application sélectionnée sont affichées dans un tableau.
- Sélectionnez Créer à partir d'une image existante et spécifiez les détails suivants :
- Nom : Un nom pour la nouvelle fonction. Évitez d'entrer des informations confidentielles.
- Compartiment du référentiel : Compartiment contenant le référentiel dans le registre de conteneurs OCI dans la région courante qui contient l'image.
- Référentiel : Référentiel du registre de conteneurs OCI dans la région courante qui contient l'image.
- Image : Image existante dans le référentiel du registre de conteneurs OCI dans la région courante. L'architecture d'image doit être compatible avec la forme de l'application (voir Spécification de l'architecture de calcul sur laquelle exécuter les fonctions).
- Mémoire (en Mo) : Quantité maximale de mémoire que la fonction peut utiliser lors de l'exécution.
- Temporisation (en secondes) : Durée maximale d'exécution de la fonction.
- Activer l'accès simultané provisionné : Vous pouvez réduire les délais initiaux lors de l'appel de la fonction en spécifiant un nombre minimal d'appels de fonction simultanée pour lesquels vous voulez que l'infrastructure d'exécution soit constamment disponible.
Si vous sélectionnez cette option, vous entrez une valeur pour Unités d'accès simultané provisionnées (PCU) afin de spécifier le nombre minimal d'appels de fonction simultanés. La valeur réelle des unités centrales que vous entrez doit être un multiple de 10. Si Mémoire est réglé à 256 Mo, la valeur des unités centrales doit être un multiple de 20; si Mémoire est réglé à 128 Mo, la valeur des unités centrales doit être un multiple de 40. Le nombre total d'UC disponibles dépend de la taille de la fonction, de la limite de la location et de l'activation ou non de la simultanéité provisionnée pour les autres fonctions de la location. Pour plus d'informations sur la simultanéité provisionnée, voir Réduction de la latence initiale à l'aide de la simultanéité provisionnée.
- Marqueurs : Si vous êtes autorisé à créer une ressource, vous disposez également des autorisations nécessaires pour appliquer des marqueurs à structure libre à cette ressource. Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur. Pour plus d'informations sur le marquage, voir Marqueurs de ressource. Si vous ne savez pas si vous devez appliquer des marqueurs, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des marqueurs plus tard.
-
Sélectionnez une des options suivantes :
- Pour créer la fonction dans le serveur du service des fonctions pour OCI maintenant, sélectionnez Créer. La nouvelle fonction est affichée dans la console, dans la liste des fonctions de l'application que vous avez sélectionnée.
- Pour créer la fonction plus tard à l'aide du gestionnaire de ressources et de Terraform, sélectionnez Enregistrer en tant que pile pour enregistrer la définition de ressource en tant que configuration Terraform. Pour plus d'informations sur l'enregistrement des piles à partir des définitions de ressource, voir Création d'une pile à partir d'une page de création de ressource.
À l'aide de l'interface de ligne de commande Fn Project
Conseil
De nouvelles versions de l'interface de ligne de commande Fn Project sont parfois disponibles. Nous vous recommandons de vérifier régulièrement que la dernière version est installée. Pour plus d'informations, voir Étapes de mise à niveau de l'interface de ligne de commande Fn Project.Pour utiliser l'interface de ligne de commande de Fn Project pour créer une fonction dans le serveur du service des fonctions pour OCI à partir d'une image Docker existante qui a déjà été poussée vers le registre Docker :
-
Connectez-vous à votre environnement de développement en tant que développeur de fonctions.
-
Dans une fenêtre de terminal, créez une fonction en entrant :
fn create function <app-name> <function-name> <image-name>
où :
<app-name>
est le nom d'une application existante dans laquelle créer la fonction.<function-name>
est le nom de la nouvelle fonction à créer. Évitez d'entrer des informations confidentielles.<image-name>
représente le nom de l'image existante dans le registre Docker sur laquelle baser la nouvelle fonction. L'architecture d'image doit être compatible avec la forme de l'application (voir Spécification de l'architecture de calcul sur laquelle exécuter les fonctions).
Par exemple :
fn create function acmeapp acme-func phx.ocir.io/ansh81vru1zp/acme-repo/acme-func:0.0.3
Une nouvelle fonction est créée dans le service des fonctions pour OCI, basée sur l'image existante et avec le nom que vous avez spécifié
-
Vérifiez que la nouvelle fonction a été créée en entrant :
fn list functions <app-name>
Par exemple :
$ fn list functions acme-app NAME IMAGE acme-func phx.ocir.io/ansh81vru1zp/acme-repo/acme-func:0.0.3
Utilisation de l'interface de ligne de commande OCI
Utilisez la commande oci fn function create et les paramètres requis pour créer une fonction :
oci fn function create --application-id <application-ocid> --display-name <function-name> --memory-in-mbs <memory> [OPTIONS]
Pour la liste complète des indicateurs et options de variable des commandes de l'interface de ligne de commande OCI, voir Informations de référence sur la ligne de commande.
-
Exécutez l'opération CreateFunction pour créer une fonction.