tencent cloud

Overview

This document describes how to quickly create and use a web function in the SCF console.

Prerequisites

Before using SCF, you need to sign up for a Tencent Cloud account and complete identity verification first.

Directions

Creating function from template

1. Log in to the SCF console and click Function Service on the left sidebar.
2. Select the region where to create a function at the top of the page and click Create to enter the function creation process.
3. Select Template for Creation Method, enter WebFunc in the search box to filter all web function templates, select the one you want to use, and click Next as shown below:
   
4. On the Configuration page, you can view and modify the specific configuration information of the template project.
5. Click Complete.
   After creating the web function, you can view its basic information on the Function Management page and access it at the access path URL generated by API Gateway.

Creating custom function

1. Log in to the SCF console and click Function Service on the left sidebar.
2. Select the region where to create a function at the top of the page and click Create to enter the function creation process.
3. Select Custom Creation for Creation Method and enter the basic function information as shown below:
   
   • Function Type: select Web function.
   • Function Name: enter the name of your function.
   • Region: enter your function deployment region.
   • Deployment Method: select Code deployment.
   • Runtime Environment: select Nodejs 12.16 since Node.js is used as an example here.
4. In Advanced Configuration, view other required configuration items.
   • Namespace: the default namespace is used by default. You can select another namespace for deployment.
   • Bootstrap Command: for web functions, you must configure the scf_bootstrap bootstrap file for your project to ensure that the web server can be started properly in the function environment. You can select the default framework template provided by SCF or use a custom template to write your own start command. For more information, please see Bootstrap File Description.
5. In Trigger Configuration, only API Gateway trigger is supported currently, and a trigger will be created automatically based on the default configuration.
   
6. Click Complete.
   After creating the web function, you can view its basic information on the Function Management page and access it at the access path URL generated by API Gateway.

Cloud test

Viewing log

For web functions, the returned body information of each request will not be automatically reported to the log. You can customize the reporting in the code through statements such as console.log() or print() in your programming language.

For PHP, as all inputs are automatically used as the body, you need to run the following command to output the log to stdout and complete log reporting:

<?php
  $stdout = fopen("php://stderr","w"); 
  fwrite($stdout,"123\n");
?>

On the details page of a created function, select Log Query to view its detailed logs. For more information, please see Viewing Execution Logs.

View monitoring data

On the details page of a created function, select Monitoring Information to view metrics such as function invocations and execution duration. For more information, please see Monitoring Metric Descriptions.

Note：

The minimal granularity of monitoring statistics collection is 1 minute. You need to wait for 1 minute before you can view the current monitoring record.

Common Error Codes and Solutions

Common errors are divided into two types: user errors and platform errors.

• User errors: the execution failure is caused by improper user operations; for example, the sent request does not meet the standard, the commands in the bootstrap file are incorrect, the correct port is not listened on, or the internal business code is incorrectly written. The returned error code is 4xx.
• Platform errors: the execution failure is caused by internal errors of the SCF platform. The returned error code is 500.

The table below describes the possible scenarios of request errors and function errors, so that you can quickly troubleshoot problems. For more information on error codes, please see Function Status Code.

2xx status codes

4xx status codes

5xx status codes

Notes on local debugging

When debugging in a local container, in order to ensure consistency with the standard container environment in the cloud, you need to pay attention to the limits of readable and writable files in the local environment. The local container startup command is as follows:

docker run -ti  --read-only -w /var/user \
   -v /usr/local/cloudfunction/runtime:/var/runtime:ro \
   -v ${PWD}:/var/user:ro \
   -v /tmp:/tmp \
   -v /usr/local/cloudfunction/runtime:/var/runtime:ro \
   -v /usr/local/cloudfunction/lang:/var/lang:ro \
   ccr.ccs.tencentyun.com/cloudfunc/qcloud-func bash