Updating a Function

• Console
• CLI
• API

• 1. On the Applications list page, select the application that contains the function that you want to work with. If you need help finding the list page or the application, see Listing Applications.

  2. Under Resources, select Functions.

     The Functions list page opens. All functions in the selected application are displayed in a table.

  3. From the Actions menu () for the function that you want to update, select Edit and update some or all the following properties:
     • Repository: The repository in the OCI Container Registry in the current region that contains the image.
     • Image: The existing image in the OCI Container Registry repository in the current region. If the image has the same name and tag as the image on which the function was originally based, see Notes About Image Digests.
     • Memory: The maximum amount of memory that the function can use while running.
     • Timeout: The maximum amount of time that the function can run for.
     • Enable provisioned concurrency: You can minimize any initial delays when invoking the function by specifying a minimum number of concurrent function invocations for which you want to have execution infrastructure constantly available.

       If you select this option, you enter a value for Provisioned concurrency units (PCUs) to specify the minimum number of concurrent function invocations. The actual PCUs value you enter must be a multiple of 10. If Memory is set to 256 MB, the PCUs value must be a multiple of 20; if Memory is set to 128 MB, the PCUs value must be a multiple of 40. The total number of PCUs available depends on the size of the function, the tenancy limit, and whether provisioned concurrency has been enabled for other functions in the tenancy. For more information about provisioned concurrency, see Reducing Initial Latency Using Provisioned Concurrency.

  4. Select Save changes to update the function in the OCI Functions server.

• Using the Fn Project CLI

  Tip
  
  From time to time, new versions of the Fn Project CLI are released. We recommend you regularly check that the latest version is installed. For more information, see Steps to upgrade the Fn Project CLI.

  To use the Fn Project CLI to update an existing function in the OCI Functions server:

  1. Log in to your development environment as a functions developer.

  2. In a terminal window, update properties of an existing function by entering:

     Command

     CopyTry It

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

     where:

     • <app-name> is the name of an existing application containing the existing function.
     • <function-name> is the name of the existing function you want to update.
     • --image <image-name> (optionally) is the name of an existing image in the Docker registry that you now want to base the function on, instead of the previously specified image. If the image has the same name and tag as the image on which the function was originally based, see Notes About Image Digests.
     • --<property> <value> (optionally) is the property you want to update, and the new value you want it to have. Enter fn update function --help to see a list of properties and valid values.

     For example:

     Command

     CopyTry It

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

     Command

     CopyTry It

     fn update function acmeapp acme-func --memory 256

     The properties of the existing function are updated with the values you specified.

  3. Verify that the function has been updated by entering:

     Command

     CopyTry It

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

     For example:

     Command

     CopyTry It

     fn inspect function acme-app acme-func

     Output:

     {
         "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"
     }

  Using the OCI CLI

  Use the oci fn function update command and required parameters to update a function:

  Command

  CopyTry It

  oci fn function update --function-id <function-ocid> [OPTIONS]

  For a complete list of flags and variable options for OCI CLI commands, see the Command Line Reference.

• Run the UpdateFunction API operation to update functions.