Documentation Oracle Cloud Infrastructure

Mise à jour d'une fonction

Découvrez comment mettre à jour des fonctions existantes dans le serveur OCI Functions.

Pour connaître les prérequis et obtenir plus d'informations, reportez-vous à Mise à jour des fonctions.

    1. Sur la page de liste Applications, sélectionnez l'application contenant la fonction que vous souhaitez utiliser. Si vous avez besoin d'aide pour rechercher la page de liste ou l'application, reportez-vous à Liste des applications.

    2. 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.

    3. Dans le menu Actions (trois points) de la fonction à mettre à jour, sélectionnez Modifier et mettez à jour certaines ou toutes les propriétés suivantes :
      • Compartiment de référentiel : compartiment contenant le référentiel dans OCI Container Registry dans la région en cours qui contient l'image.
      • Référentiel : référentiel dans OCI Container Registry dans la région en cours contenant l'image.
      • Image : image existante dans le référentiel OCI Container Registry de la région en cours. Si l'image possède le même nom et la même balise que l'image d'origine, reportez-vous à Remarques sur les condensés d'image.
      • Mémoire (en Mo) : quantité maximale de mémoire que la fonction peut utiliser lors de son exécution.
      • Délai d'expiration (en secondes) : durée maximale pendant laquelle la fonction peut s'exécuter.
      • Activer la simultanéité d'accès aux données provisionnée : vous pouvez réduire les retards initiaux lors de l'appel de la fonction en indiquant un nombre minimal d'appels de fonction simultanés pour lesquels l'infrastructure d'exécution doit être disponible en permanence.

        Si vous sélectionnez cette option, vous entrez une valeur pour Unités simultanées provisionnées afin d'indiquer le nombre minimal d'appels de fonction simultanés. La valeur PCU réelle que vous saisissez doit être un multiple de 10. Si la valeur Memory est définie sur 256 Mo, la valeur PCU doit être un multiple de 20 ; si la valeur Memory est définie sur 128 Mo, la valeur PCU doit être un multiple de 40. Le nombre total d'UC disponibles dépend de la taille de la fonction, de la limite de location et de l'activation ou non de la simultanéité d'accès aux données provisionnée pour d'autres fonctions de la location. Pour plus d'informations sur la simultanéité provisionnée, reportez-vous à Réduction de la latence initiale à l'aide de la simultanéité provisionnée.

    4. Sélectionnez Enregistrer les modifications pour mettre à jour la fonction dans le serveur OCI Functions.

  • 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 utiliser l'interface de ligne de commande du projet Fn afin de mettre à jour une fonction existante dans le serveur OCI Functions, 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, mettez à jour les propriétés d'une fonction existante en entrant la commande suivante :

      fn update function <app-name> <function-name> --image <image-name> --<property> <value>

      où :

      • <app-name> représente le nom d'une application existante contenant la fonction existante.
      • <function-name> représente le nom de la fonction existante à mettre à jour.
      • --image <image-name> (facultatif) représente le nom d'une image existante figurant dans le registre Docker, sur laquelle vous voulez maintenant baser la fonction, en remplacement de l'image précédemment indiquée. Si l'image possède le même nom et la même balise que l'image d'origine, reportez-vous à Remarques sur les condensés d'image.
      • --<property> <value> (facultatif) représente la propriété à mettre à jour et la nouvelle valeur souhaitée. Entrez fn update function --help pour afficher la liste des propriétés et des valeurs valides.

      Par exemple :

      fn update function acmeapp acme-func --image phx.ocir.io/ansh81vru1zp/acme-repo/acme-func:0.0.4 --timeout 60
      fn update function acmeapp acme-func --memory 256

      Les propriétés de la fonction existante sont mises à jour avec les valeurs indiquées.

    3. Vérifiez que la fonction a été mise à jour en saisissant la commande suivante :

      fn inspect function <app-name> <function-name>

      Par exemple :

      fn inspect function acme-app acme-func

      Sortie :

      {
    "annotations": {
        "fnproject.io/fn/invokeEndpoint": "https://fht7ns4mn2q.us-phoenix-1.functions.oci.oraclecloud.com/20181201/functions/ocid1.fnfunc.oc1.phx.aaaa____uxoa/actions/invoke",							
        "oracle.com/oci/compartmentId": "ocid1.compartment.oc1..aaaaaaaaw______nyq"
    },
    "app_id": "ocid1.fnapp.oc1.phx.aaaaaaaaaf______r3ca",
    "created_at": "2018-07-26T12:50:53.000Z",
    "format": "default",
    "id": "ocid1.fnfunc.oc1.phx.aaaa____uxoa",
    "image": "phx.ocir.io/ansh81vru1zp/acme-repo/acme-func:0.0.4",
    "memory": 256,
    "name": "acme-func",
    "timeout": 60,
    "updated_at": "2018-07-26T13:59:18.000Z"
}

    Utilisation de l'interface de ligne de commande OCI

    Utilisez la commande oci fn function update et les paramètres requis pour mettre à jour une fonction :

    oci fn function update --function-id <function-ocid> [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 UpdateFunction pour mettre à jour les fonctions.