Création d'une application

Découvrez comment créer des applications avec OCI Functions.

Dans OCI Functions, 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 pour que vous puissiez créer une fonction dans OCI Functions.

Pour plus d'informations sur les applications, reportez-vous à Applications.

    1. Vérifiez que vous avez effectué les étapes décrites dans les guides QuickStart Functions.
    2. Sur la page de liste Applications, sélectionnez le compartiment indiqué dans le contexte de l'interface de ligne de commande du projet Fn (reportez-vous à Création d'un contexte d'interface de ligne de commande de projet Fn pour la connexion à Oracle Cloud Infrastructure). Si vous avez besoin d'aide pour trouver la page de liste, reportez-vous à la section Liste des applications.
    3. Sélectionnez Créer une application et indiquez les détails suivants :

      • Nom : Nom de la nouvelle application (par exemple, acmeapp). Evitez de saisir des informations confidentielles.
      • Compartiment VCN : compartiment contenant le VCN (réseau cloud virtuel) dans lequel exécuter les fonctions.
      • VCN : VCN (réseau cloud virtuel) dans lequel exécuter des fonctions. Par exemple, un VCN appelé acme-vcn-01
      • Compartiment des sous-réseaux : compartiment contenant le ou les sous-réseaux dans lesquels exécuter des fonctions.
      • Sous-réseaux dans <compartment-name> : sous-réseau (ou sous-réseaux, jusqu'à trois) dans lequel exécuter les 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 comme meilleure pratique, sélectionnez-le pour faciliter l'implémentation du basculement entre les domaines de disponibilité. Si aucun sous-réseau régional n'a été défini et que vous devez répondre à des 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 indiqué dans le contexte de l'interface de ligne de commande du projet Fn. Pour plus d'informations, reportez-vous à Création d'un contexte d'interface de ligne de commande de projet Fn pour la connexion à Oracle Cloud Infrastructure.

        La spécification d'un sous-réseau privé pour une application n'empêche pas l'accès à partir d'Internet aux adresses d'appel des fonctions de l'application. Utilisez des stratégies d'identité pour contrôler l'accès aux adresses d'appel de fonction. Pour plus de détails, reportez-vous à Contrôle de l'accès à l'appel et à la gestion de 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 ayant 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 toujours que les fonctions de l'application s'exécutent sur des instances de calcul avec une architecture reposant 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 toujours que les fonctions de l'application s'exécutent sur des instances de calcul avec 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 soient exécutées sur des instances de calcul avec l'architecture de votre choix disposant d'une capacité suffisante. Dans ce cas, OCI Functions 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 pour l'architecture Arm et l'architecture x86 (dans une image à architecture multiple).

        Vous ne pouvez pas modifier la forme de l'application après l'avoir créée. Reportez-vous à Sélection d'une architecture unique ou d'une forme d'application à architecture multiple sur laquelle exécuter une fonction.

      • Balises :si vous disposez des droits d'accès nécessaires pour créer une ressource, vous disposez également de droits d'accès nécessaires pour lui appliquer des balises à format libre. Pour appliquer une balise defined, vous devez disposer des droits d'accès permettant d'utiliser l'espace de noms de balise. Pour plus d'informations sur le balisage, reportez-vous à Balises de ressource. Si vous n'êtes pas certain d'appliquer des balises, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des balises ultérieurement.
    4. Sélectionnez l'une des options suivantes :

      • Pour créer l'application maintenant, sélectionnez Créer. La nouvelle application apparaît dans la liste des applications.
      • Pour créer l'application ultérieurement à l'aide de Resource Manager et de Terraform, sélectionnez Enregistrer en tant que pile afin d'enregistrer la définition de ressource en tant que configuration Terraform. Pour plus d'informations sur l'enregistrement de piles à partir de définitions de ressource, reportez-vous à Création d'une pile à partir d'une page de création de ressource.
  • Utilisation de l'interface de ligne de commande du projet Fn

    Conseil

    De temps à temps, de nouvelles versions de l'interface de ligne de commande du projet Fn sont disponibles. Nous vous recommandons de vérifier régulièrement que la dernière version est installée. Pour plus d'informations, reportez-vous à Etapes de mise à niveau de l'interface de ligne de commande du projet Fn.

    Pour créer une application dans OCI Functions à l'aide de l'interface de ligne de commande du projet Fn, procédez comme suit :

    1. Connectez-vous à votre environnement de développement en tant que développeur de fonctions.

    2. Dans une fenêtre de terminal, créez une application en saisissant la commande suivante :

      fn create app <app-name> --annotation oracle.com/oci/subnetIds='["<subnet-ocid>"]'

      où :

      • <app-name> représente le nom de la nouvelle application. Evitez de saisir des informations confidentielles.
      • <subnet-ocid> représente l'OCID du sous-réseau (ou des sous-réseaux, jusqu'à trois) dans lequel exécuter les 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, il est recommandé de le sélectionner pour faciliter l'implémentation du basculement entre les domaines de disponibilité. Si aucun sous-réseau régional n'a été défini et que vous devez répondre à des exigences de haute disponibilité, indiquez plusieurs sous-réseaux (entourez chaque OCID de guillemets doubles, en les séparant par des virgules, au format '["<subnet-ocid>","<subnet-ocid>"]'). Oracle recommande que les sous-réseaux figurent dans la même région que le registre Docker indiqué dans le contexte de l'interface de commande du projet Fn (reportez-vous à Création d'un contexte d'interface de commande de projet Fn pour la connexion à Oracle Cloud Infrastructure).

        Notez que la spécification d'un sous-réseau privé pour une application n'empêche pas l'accès à partir d'Internet aux adresses d'appel des fonctions de l'application. Utilisez des stratégies d'identité pour contrôler l'accès aux adresses d'appel de fonction (reportez-vous à 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 OCI Functions, dans la location et la région indiquées implicitement par l'OCID de sous-réseau, et elle appartient au compartiment indiqué dans le fichier de contexte de l'interface de ligne de commande du projet Fn.

    3. Vérifiez que l'application a été créée en saisissant la commande suivante :

      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]

    Afin d'obtenir la liste complète des indicateurs et des options de variable pour les commandes d'interface de ligne de commande OCI, reportez-vous à Référence de ligne de commande.

  • Exécutez l'opération d'API CreateApplication pour créer une application.