Création d'applications
Découvrez comment créer des applications avec le service des fonctions pour OCI.
Dans le service des fonctions OCI, une application est un regroupement logique de fonctions. Les propriétés que vous spécifiez pour une application déterminent l'allocation et la configuration des ressources pour toutes les fonctions de cette application. Vous devez créer une fonction dans une application, de sorte qu'au moins une application doit exister avant de pouvoir créer une fonction dans le service des fonctions pour OCI.
Pour plus d'informations sur les applications, voir Applications.
- Confirmez que vous avez terminé les étapes dans les guides du service des fonctions QuickStart.
- Dans la page de liste Applications, sélectionnez le compartiment spécifié dans le contexte de l'interface de ligne de commande Fn Project (voir Création d'un contexte d'interface de ligne de commande Fn Project pour se connecter à Oracle Cloud Infrastructure). Si vous avez besoin d'aide pour trouver la page de liste, voir Liste des applications.
-
Sélectionnez Créer une application et spécifiez les détails suivants :
- Nom : Un nom pour la nouvelle application (par exemple, acmeapp). Évitez d'entrer des informations confidentielles.
- Compartiment du VCN : Compartiment contenant le VCN (réseau en nuage virtuel) dans lequel exécuter des fonctions.
- VCN : VCN (réseau en nuage virtuel) dans lequel exécuter des fonctions. Par exemple, un VCN appelé acme-vcn-01
- Compartiment des sous-réseaux : Compartiment contenant le sous-réseau (ou les sous-réseaux) dans lequel exécuter des fonctions.
- Sous-réseaux dans <compartment-name> : Sous-réseau (ou sous-réseaux, trois au maximum) dans lequel exécuter des fonctions. Par exemple, un sous-réseau public appelé Sous-réseau public IHsY:US-PHOENIX-AD-1).
Un sous-réseau public nécessite une passerelle Internet dans le VCN et un sous-réseau privé nécessite une passerelle de service dans le VCN. Si un sous-réseau régional a été défini, il est recommandé de le sélectionner pour faciliter la mise en oeuvre du basculement entre les domaines de disponibilité. Si aucun sous-réseau régional n'est défini et que vous devez répondre aux exigences de haute disponibilité, sélectionnez plusieurs sous-réseaux. Nous recommandons que les sous-réseaux se trouvent dans la même région que le registre Docker spécifié dans le contexte de l'interface de ligne de commande Fn Project. Pour plus d'informations, voir Création d'un contexte d'interface de ligne de commande Fn Project pour se connecter à Oracle Cloud Infrastructure.
La spécification d'un sous-réseau privé pour une application n'empêche pas l'accès d'Internet aux points d'extrémité d'appel des fonctions de l'application. Utilisez des politiques d'identité pour contrôler l'accès aux points d'extrémité d'appel de fonction. Pour plus de détails, voir Configuration de l'accès pour appeler et gérer des fonctions.
-
Forme : Architecture de processeur des instances de calcul sur lesquelles déployer et exécuter des fonctions dans l'application. Toutes les fonctions de l'application sont déployées et exécutées sur des instances de calcul de la même architecture. L'image de la fonction doit contenir les dépendances nécessaires pour l'architecture que vous sélectionnez, comme suit :
- Sélectionnez la forme Generic_ARM si vous voulez que les fonctions de l'application s'exécutent toujours sur des instances de calcul dotées d'une architecture basée sur ARM. Si vous sélectionnez cette forme d'architecture unique pour l'application, l'image de la fonction doit contenir les dépendances nécessaires pour l'architecture Arm (dans une seule image d'architecture ou une image multiarchitecture).
- Sélectionnez la forme Generic_X86 si vous voulez que les fonctions de l'application s'exécutent toujours sur des instances de calcul dotées d'une architecture basée sur x86. Si vous sélectionnez cette forme d'architecture unique pour l'application, l'image de la fonction doit contenir les dépendances nécessaires pour l'architecture x86 (dans une seule image d'architecture ou une image multiarchitecture).
- Sélectionnez la forme Generic_X86_ARM si vous voulez que les fonctions s'exécutent sur des instances de calcul avec une architecture de capacité suffisante. Dans ce cas, le service des fonctions pour OCI sélectionne l'architecture sur laquelle exécuter les fonctions en fonction de la capacité disponible. Si vous sélectionnez cette forme à architecture multiple pour l'application, l'image de chaque fonction doit contenir les dépendances nécessaires à la fois pour l'architecture ARM et pour l'architecture x86 (dans une image à architecture multiple).
Notez que vous ne pouvez pas modifier la forme de l'application après avoir créé celle-ci. Voir Sélection d'une architecture unique ou d'une forme d'application multiarchitecture sur laquelle exécuter une fonction.
- 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 l'application maintenant, sélectionnez Créer. La nouvelle application s'affiche dans la liste des applications.
- Pour créer l'application 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 créer une application dans le service des fonctions pour OCI à l'aide de l'interface de ligne de commande Fn Project :
-
Connectez-vous à votre environnement de développement en tant que développeur de fonctions.
-
Dans une fenêtre de terminal, créez une application en entrant :
fn create app <app-name> --annotation oracle.com/oci/subnetIds='["<subnet-ocid>"]'
où :
<app-name>
est le nom de la nouvelle application. Évitez d'entrer des informations confidentielles.<subnet-ocid>
est l'OCID du sous-réseau (ou des sous-réseaux, trois au maximum) dans lequel exécuter des fonctions. Notez qu'un sous-réseau public nécessite une passerelle Internet dans le VCN et qu'un sous-réseau privé nécessite une passerelle de service dans le VCN. Si un sous-réseau régional a été défini, la meilleure pratique consiste à sélectionner ce sous-réseau pour effectuer un basculement sur tous les domaines de disponibilité, ce qui est plus simple à mettre en oeuvre. Si aucun sous-réseau régional n'a été défini et que vous devez respecter les exigences de haute disponibilité, spécifiez plusieurs sous-réseaux (encadrez chaque OCID par des guillemets doubles, séparé par des virgules, dans le format'["<subnet-ocid>","<subnet-ocid>"]'
). Oracle recommande que les sous-réseaux se trouvent dans la même région que le registre Docker spécifié dans le contexte d'interface de ligne de commande Fn Project (voir Création d'un contexte d'interface de ligne de commande Fn Project pour se connecter à Oracle Cloud Infrastructure).Notez que la spécification d'un sous-réseau privé pour une application n'empêche pas l'accès d'Internet aux points d'extrémité d'appel des fonctions de l'application. Utilisez des politiques d'identité pour contrôler l'accès aux points d'extrémité d'appel de fonction (voir Contrôle de l'accès pour appeler et gérer des fonctions).
Par exemple :
fn create app acmeapp --annotation oracle.com/oci/subnetIds='["ocid1.subnet.oc1.phx.aaaaaaaacnh..."]'
Une application est créée dans le service des fonctions pour OCI, dans la location et la région indiquées par l'OCID du sous-réseau et appartenant au compartiment spécifié dans le fichier de contexte de l'interface de ligne de commande Fn Project.
-
Vérifiez que la nouvelle application a été créée en entrant :
fn list apps
Par exemple :
$ fn list apps acmeapp
Utilisation de l'interface de ligne de commande OCI
Utilisez la commande oci fn application create et les paramètres requis pour créer une application :
oci fn application create --compartment-id <compartment-ocid> --display-name <app-name> --subnet-ids <subnet-ocids> [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 d'API CreateApplication pour créer une application.