:Quick start

Overview

To develop a serverless application by using Fun, follow these steps:

1. Create an application. Run the fun init command to create an application based on a specific template file.
2. Test the application. Run a specific command, for example, fun edge invoke, to call and test the application.
3. Deploy the application. Run the fun deploy command to deploy the application to Function Compute. Then you can use the application in the same way as using other applications in Link IoT Edge.

Prerequisites

Fun is installed and configured. For more information, see Install and configure Fun.

Procedure

1. Create a serverless application.
   Create a project directory in any position on your computer, and then run the fun init command in the directory to create a serverless application.

   Important Currently, Link IoT Edge can only run serverless applications in Node.js 8 and Python 3.

   $ mkdir helloworld
   $ cd helloworld/
   $ fun init
   ? Select a template to init helloworld-nodejs8
   Start rendering template...
   + /private/tmp/helloworld
   + /private/tmp/helloworld/index.js
   + /private/tmp/helloworld/template.yml
   finish rendering template.

   In the preceding information, the template.yml file defines a serverless application model. Key parameters in the template.yml file are as follows:

   ROSTemplateFormatVersion: '2015-09-01'
   Transform: 'Aliyun::Serverless-2018-04-03'
   Resources:
     helloworld:                            # The service name.
       Type: 'Aliyun::Serverless::Service'
       Properties:
         Description: 'helloworld'
       helloworld:                        # The function name.
         Type: 'Aliyun::Serverless::Function'
         Properties:
           Handler: index.handler                        # The event processing function.
           Runtime: nodejs8                # The runtime environment of the function. Link IoT Edge only supports Python 3 and Node.js 8.
           CodeUri: 'index.js'                       # The source code of the function, which will be deployed to Function Compute.

   For more information about the template.yml file, see Serverless Application Model.

2. Test the application on your computer.
   To test the created serverless application, follow these steps:
   1. Run the following command to start the local mock Link IoT Edge environment on your computer. The local mock Link IoT Edge environment uses the same port as Link IoT Edge that is officially released. Therefore, make sure that Link IoT Edge is not running before you start the local mock Link IoT Edge environment.

      fun edge start

      Note During the startup, enter certificate information about the gateway device as prompted.
   2. Go to the directory where the template.yml file is located and run the following command to call the helloworld function:

      fun edge invoke helloworld

      By default, the invoke command reads event content from the standard input and then calls the specific function. You can directly enter the event content on the command line, press Enter, and then press Ctrl+D to end the input.

      You can also use the -e parameter to specify the event file to read. If the function is called successfully, the return value of the function is displayed.

      $ echo "{}" > event.json
      $ fun edge invoke -e event.json hellworld/helloworld
      Using template file at /private/tmp/helloworld/template.yml.
      Invoking function helloworld (nodejs8).
      hello world

3. Deploy the application to Function Compute.
   If the application passes the test, go to the directory where the template.yml file is located and run the following command to deploy the application to Function Compute:

   fun deploy