tencent cloud

You can use a dependency manager (such as npm) to locally install the dependent library, package and upload it with the function code.

Note

Place the entry point file of the function in the root directory of the zip package. If you package and upload the entire folder as a zip package, the function creation will fail because the entry point file cannot be found in the unzipped root directory.

1. Run the mkdir test-package command on your local computer to create a directory to store the function code and the dependent library.
2. Run the following commands to install the lodash dependent library in the directory.

cd test-package
npm install lodash

3. Create the index.js entry point file of the function in the directory and import the lodash library in codes.

'use strict';
const _ = require('lodash');
exports.main_handler = async (event, context) => {
     console.log("Hello World")
     console.log(event)
     console.log(event["non-exist"])
     console.log(context)
     return event
};

4. Compress the function code and dependent library to a zip package. Upload the zip package and create a function via the SCF console.
   1. Log in to the SCF console and click Functions on the left sidebar.
   2. Choose a region at the top of the Functions page and click Create.
   3. Enter the basic information of the function on the Create page.
      
      • Creation method: Select From scratch.
      • Runtime environment: Choose Node.js12.16.
      • Submitting method: Choose Local ZIP file.
   4. Click Complete.

The Node.js runtime supports online dependency installation. You can install the dependent library online according to the configuration in package.json. For details, see Online Dependency Installation

The SCF online editor Serverless Web IDE supports Terminal capability that has a built-in npm package management tool.

Note

Serverless Web IDE has a delay in supporting newer versions of runtime environments. If the console does not open up the Serverless Web IDE for the corresponding runtime environment, package and upload the dependency library together with the code for dependency installation or install the dependency online.

1. Log in to the SCF console and click Functions on the left sidebar.
2. In the function list, click a function name to enter the function details page.
3. On the Function management page, select Function Code > Edit codes to view and edit the function.
4. Select Terminal > New Terminal on the topbar of the IDE to open the terminal window.
5. Run the following commands in the terminal window to install the lodash dependent library.
   

   cd src  # Install the dependent library in the same level of directory as the function’s entry point file, namely, enter the `src` directory and install it.
   npm install lodash # You can view the npm version through the terminal
   

6. After the installation is complete, check package.json and node_modules in the file tree on the left side of the IDE.
7. Click Deploy to package the dependency library and upload it to the cloud together with the function code.
   

You can use a dependency manager (such as pip) to locally install the dependent library, package and upload it with the function code.

Note

• Place the function’s entry point file in the root directory of the zip package. If you package and upload the entire folder as a zip package, the function creation will fail because the entry point file cannot be found in the unzipped root directory.
• Due to runtime environment differences, confirm that the installed dependency version is adapted to the function runtime environment.
• The function runtime environment is CentOS 7, and you need to install the dependencies in the same environment. If not, an error where the dependencies cannot be found may occur while running the function after upload.
• For dependencies requiring dynamic link library, you need to manually copy these dependencies to the installation directory, and then compress and upload them. You can install dependency with Docker or online IDE.

1. Run the mkdir test-package command on your local computer to create a directory to store the function code and the dependent library.
2. Run the following commands to install the numpy dependent library in the directory.
   

   cd test-package
   pip install numpy -t . # Check whether the pip version you are using is adapted to the function runtime environment
   

3. Create the index.py entry point file of the function in the directory and import the numpy library in codes.
   

   # -*- coding: utf8 -*-
   import json
   import numpy
   def main_handler(event, context):
        print("Received event: " + json.dumps(event, indent = 2)) 
        print("Received context: " + str(context))
        print("Hello world")
        return("Hello World")
   

4. Compress the function code and dependent library to a zip package. Upload the zip package and create a function via the SCF console.
   1. Log in to the SCF console and click Functions on the left sidebar.
   2. Choose a region at the top of the Functions page and click Create.
   3. Enter the basic information of the function on the Create page.
      
      • Creation method: Select From scratch.
      • Runtime environment: Select Python 3.6.
      • Submitting method: Choose Local ZIP file.
   4. Click Complete.

The SCF online editor Serverless Web IDE supports Terminal capability that has a built-in pip package management tool.

Note

Serverless Web IDE has a delay in supporting newer versions of runtime environments. If the console does not open up the Serverless Web IDE for the corresponding runtime environment, package and upload the dependency library together with the code for dependency installation or install the dependency online.

1. Log in to the SCF console and click Functions on the left sidebar.
2. In the function list, click a function name to enter the function details page.
3. On the Function management page, select Function Code > Edit codes to view and edit the function.
4. Select Terminal > New Terminal on the topbar of the IDE to open the terminal window.
5. Run the following commands in the terminal to install the numpy dependent library.
   

   cd src  # Install the dependent library in the same level of directory as the function’s entry point file, namely, enter the `src` directory and install it.
   pip install numpy -t . # You can view the pip version through the terminal to check whether it is adapted to the function runtime environment
   

6. After the installation is complete, check the installed dependent library in the file tree on the left side of the IDE.
7. Click Deploy to package and upload the dependent library with function codes to the cloud.
   

   Note

   • Use the pip freeze > requirements.txt command to generate a requirements.txt file that contains all dependencies of the local environment.
   • Run the pip install -r requirements.txt -t . command in the IDE Terminal to install the dependency package according to the requirements.txt configurations.

You can use a dependency manager (such as “composer”) to locally install the dependent library, package and upload it with the function code.

Note

Place the entry point file of the function in the root directory of the zip package. If you package and upload the entire folder as a zip package, the function creation will fail because the entry point file cannot be found in the unzipped root directory.

1. Run the mkdir test-package command on your local computer to create a directory to store the function code and the dependent library.

2. Create Composer.json under test-package and specify the dependency library and version to be installed.
   

   {
   "require": {
    "requests": ">=1.0"
       }
   }
   

3. Run the following command to install the requests dependency library in this directory.
   

   cd test-package
   composer install
   

4. Create the function entry file index.php in this directory and import the requests library in the code.
   

   <?php
   require 'vendor/autoload.php';
   function main_handler($event, $context) {
       return "hello world";
   }
   ?> 
   

5. Compress the function code and dependent library to a zip package. Upload the zip package and create a function via the SCF console.

   1. Log in to the SCF console and click Functions on the left sidebar.
   2. Choose a region at the top of the Functions page and click Create.
   3. Enter the basic information of the function on the Create page.
      
   • Creation method: Select From scratch.
   • Runtime environment: Select Php7.2.
   • Submitting method: Choose Local ZIP file.
   4. Click Complete.

Create the extension folder php_extension in a directory at the same level as the function entry file, add the custom extension file .so and configuration file php.ini, and package and upload them together with the function code.
This document uses installing the custom extension swoole.so for PHP 7.2 as an example.

1. Run the mkdir test-package command on your local computer to create a directory to store the function code and the dependent library.
2. Run the following command to create the folder php_extension in test-package and place the configuration file php.ini and extension file .so corresponding to the extension in this directory. The directory structure is as follows:
   

   Note

   • The extension folder php_extension and configuration file php.ini are given fixed names. If other names are used, the extension may fail to load.
   • The extension folder php_extension, the configuration file php.ini, and the custom extension file .so need to have executable permissions.

   
   

   |____php_extension
   | |____php.ini
   | |____swoole.so
   |____index.php  
   

3. Custom extensions can be loaded from the code or layers. If an extension is uploaded as a layer, please make sure that the unzipped directory structure of the uploaded zip file is as follows:
   

   |____php_extension
   | |____swoole.so
   

4. php.ini writing method:

• Set in the code directory:
  

  extension=/var/user/php_extension/swoole.so
       
  

• This extension is in the layer directory:
  

  extension=/opt/php_extension/swoole.so
    
  

5. Create the function entry file index.php in this directory. Check whether the extension is loaded successfully through the extension_loaded( ) function, and if so, true will be returned; otherwise, false will be returned.
   

   <?php
   function main_handler($event, $context) {
         var_dump(extension_loaded('swoole'));
       return "hello world";
   }
   ?> 
   

6. Compress the function code and dependent library to a zip package. Upload the zip package and create a function via the SCF console.

• Log in to the SCF console and click Functions on the left sidebar.
• Choose a region at the top of the Functions page and click Create.
• Enter the basic information of the function on the Create page.
  
  • Creation method: Select From scratch.
  • Runtime environment: Select Php7.2.
  • Submitting method: Choose Local ZIP file.
• Click Complete.