- FunctionGraph是什么？
- 函数中如何读写文件？
- FunctionGraph函数是否支持扩展？
- IAM子帐号使用FunctionGraph需要设置哪些权限？
- 依赖包是什么？
- 什么场景下需要引入依赖？
- 使用依赖包时，有哪些注意事项？
- 函数支持引入的依赖库有哪些？
- 如何在FunctionGrap上使用第三方依赖？
- 如何制作函数依赖包？
- 如何在函数平台创建依赖包？
- 如何为函数添加依赖包？
- 如何通过域名访问专享版APIG中注册的接口？
- 函数工作流的常见使用场景？
- 函数工作流是否支持修改运行时语言?
- 已创建的函数是否支持修改函数名称?
- 如何获取上传的文件？
- 同步调用响应未收到的可能原因？
- os.system("command &")执行日志未采集，应如何处理？
- 自定义运行时，都能操作哪些目录？
- 用户想使用vpc功能，但不想配置VPC Administrator委托，应配置哪些授权项？
- 函数执行超时的可能原因有哪些？
- 如何获取函数代码？
- 是否有initializer的代码示例？
- 函数服务是否支持在函数中启动TCP的监听端口，通过EIP接收外部发送过来的TCP请求？
FunctionGraph是什么？
函数工作流（FunctionGraph）是一项基于事件驱动的函数托管计算服务。使用FunctionGraph函数，只需编写业务函数代码并设置运行的条件，无需配置和管理服务器等基础设施，函数以弹性、免运维、高可靠的方式运行。
函数中如何读写文件？
函数工作目录权限说明
函数可以读取代码目录下的文件，函数工作目录在入口文件的上一级，例如用户上传了文件夹backend，需要读取与入口文件同级目录的文件test.conf，可以用相对路径“code/backend/test.conf”，或者使用绝对路径（相关目录为RUNTIME_CODE_ROOT环境变量对应的值）。如果需要写文件（如创建新文件或者下载文件等），可以在/tmp目录下进行或者使用函数提供的挂载文件系统功能。
说明
若容器回收，文件的读写就会失效。
函数目前不支持持久化。
典型场景
- 需要对OBS上的文件进行处理，可以先把文件下载到/tmp目录。
- 函数运行过程中产生了一些数据想保存到OBS，可以先在/tmp目录下创建新文件，然后把这些数据写到里面，接下来上传该文件到OBS。
FunctionGraph函数是否支持扩展？
FunctionGraph目前已经集成了一些非标准库如：redis、http、obs_client等，开发函数时可以直接使用。
用户可以通过维护属于自己的依赖代码库，供所有函数使用。
IAM子帐号使用FunctionGraph需要设置哪些权限？
使用IAM子帐号登录、使用函数工作流服务，对函数和函数下的触发器进行增删改查，如果出现权限不足情况，需要主帐号对IAM子帐号所属的用户组设置相应的权限。同时，若您想通过函数调用其他云服务，如OBS服务时，需要您配置委托并根据实际业务需求配置服务相关权限。为保障服务的安全，请您按照最小权限原则配置权限。
依赖包是什么？
依赖包是程序包，可以理解为某软件包运行所需的依赖环境，软件包和依赖环境相互依赖，若无此依赖环境，则软件包无法正常使用。
什么场景下需要引入依赖？
当您安装了某个程序或开发了某段代码，需要依赖某个环境运行时，此时您需要引入依赖。
使用依赖包时，有哪些注意事项？
- 依赖包内文件名不能以~结尾。
- 依赖包当前文件限制数为30000。
- 在函数页面上传依赖包的ZIP包文件大小限制为10M，如超过10M，需通过OBS上传（依赖包大小限制为最大300M）。
- 如果函数配置了私有依赖包且依赖包很大，建议在函数详情页的“设置 > 常规设置”重新设置函数执行时间，在原基础上增加超时时间。
函数支持引入的依赖库有哪些？
支持的依赖库说明
FunctionGraph支持引入标准库及第三方依赖库。
- 标准库
对于标准库，无论是在线编辑或是线下开发打包上传至FunctionGraph，均可以直接在代码中引入，使用其功能。
- FunctionGraph支持的非标准库
FunctionGraph内置一些三方件，如下所示。像标准库一样，在编写代码时直接引入，使用其功能。
Node.js Runtime集成的三方件
| 名称 | 功能 | 版本号 |
|---|---|---|
| q | 异步方法封装 | 1.5.1 |
| co | 异步流程控制 | 4.6.0 |
| lodash | 常用工具方法库 | 4.17.10 |
| esdk-obs-nodejs | OBS sdk | 2.1.5 |
| express | 极简web开发框架 | 4.16.4 |
| fgs-express | 在FunctionGraph和API Gateway之上使用现有的Node.js应用程序框架运行无服务器应用程序和REST API 。提供的示例允许您使用Express框架轻松构建无服务器Web应用程序/服务和RESTful API 。 | 1.0.1 |
| request | 简化http调用，支持HTTPS并默认遵循重定向 | 2.88.0 |
Python Runtime支持的非标准库
| 模块 | 功能 | 版本号 |
|---|---|---|
| dateutil | 日期/时间处理 | 2.6.0 |
| requests | http库 | 2.7.0 |
| httplib2 | httpclient | 0.10.3 |
| numpy | 数学计算 | 1.13.1 |
| redis | redis客户端 | 2.10.5 |
| obsclient | OBS客户端 | - |
| smnsdk | 访问云smn服务 | 1.0.1 |
- 其他第三方库（除了上面表格列举的非标准三方库，FunctionGraph没有内置别的非标准三方库）
将依赖的第三方库打包，上传至OBS桶或在函数界面上传，在函数代码中即可使用其功能。
如何在FunctionGrap上使用第三方依赖？
- 将依赖的第三方库打包成zip包。
- 在函数平台，完成依赖包创建。
- 进入待配置依赖包的函数配置详情页，在“代码”页签下，添加制作成功的私有依赖包。在函数代码中即可使用其功能。
如何制作函数依赖包？
制作函数依赖包推荐在EulerOS环境中进行。 使用其他系统打包可能会因为底层依赖库的原因，运行出问题，比如找不到动态链接库。
说明如果安装的依赖模块需要添加依赖库，请将依赖库归档到zip依赖包文件中，例如，添加.dll、.so、.a等依赖库。
为Python函数制作依赖包
打包环境中的Python版本要和对应函数的运行时版本相同，如Python2.7建议使用2.7.12及以上版本，Python3.6建议使用3.6.3以上版本。
为Python 2.7安装PyMySQL依赖包，并指定此依赖包的安装路径为本地的/tmp/pymysql下，可以执行如下命令。
pip install PyMySQL --root /tmp/pymysql
执行成功后，执行以下命令。
cd /tmp/pymysql/
进入子目录直到site-packages路径下（一般路径为usr/lib64/python2.7/site-packages/），接下来执行以下命令。
zip -rq pymysql.zip *
所生成的包即为最终需要的依赖包。
说明如果需要安装存放在的本地wheel安装包，直接输入：
pip install piexif-1.1.0b0-py2.py3-none-any.whl --root /tmp/piexif
//安装包名称以piexif-1.1.0b0-py2.py3-none-any.whl为例，请以实际安装包名称为准
为Nodejs函数制作依赖包
需要先保证环境中已经安装了对应版本的Nodejs。
为Nodejs 8.10安装MySQL依赖包，可以执行如下命令。
npm install mysql --save
可以看到当前目录下会生成一个node_modules文件夹。
- Linux系统
Linux系统下可以使用以下命令生成zip包。
zip -rq mysql-node8.10.zip node_modules
即可生成最终需要的依赖包。
- windows系统
用压缩软件将node_modules目录压缩成zip文件即可。
如果需要安装多个依赖包，也可以先新建一个package.json文件，例如在package.json中填入如下内容后，执行如下命令。
{
"name": "test",
"version": "1.0.0",
"dependencies": {
"redis": "~2.8.0",
"mysql": "~2.17.1"
}
}
npm install --save
不要使用CNPM命令制作nodejs依赖包。
然后将node_modules打包成zip即可生成一个既包含MySQL也包含redis的依赖包。
Nodejs其他版本制作依赖包过程与上述相同。
为Java函数制作依赖包
使用Java编译型语言开发函数时，依赖包需要在本地编译。
如何在函数平台创建依赖包？
- 登录FunctionGraph控制台，在左侧导航栏选择“函数 > 依赖包管理”，进入“依赖包管理”界面。
- 单击的“创建依赖包”，弹出“创建依赖包”对话框。
- 设置以下信息。
依赖包配置参数说明
| 参数 | 说明 |
|---|---|
| 依赖包名称 | 自定义的依赖包名称，用于识别不同的依赖包。 |
| 代码上传方式 | 分为上传ZIP文件和从OBS上传文件。 |
| 上传ZIP文件：需单击“添加文件”，上传ZIP文件。 | - |
| OBS链接URL：需填写“OBS链接URL”。 | - |
| 运行时语言 | 选择运行时语言。 |
| 描述 | 对于依赖包的描述信息，可以不填。 |
- 单击“确定”，完成依赖包的创建。默认首次创建的依赖包版本为“1”。
- 单击列表中的依赖包名称，进入版本历史界面，可以查看当前依赖包下的所有版本和版本相关信息。当前支持针对同一依赖包，进行不同版本的系统化管理。单击“创建版本”，填写相关信息，可以创建新的依赖包版本。单击具体的版本号，可以查看版本地址。单击版本号所在行的删除，可以删除该版本。
如何为函数添加依赖包？
- 进入函数详情页面，在“代码”页签，单击“依赖代码包”所在行的“添加依赖包”。
公共依赖包：此处的依赖包为函数平台提供，您可以直接添加使用。
私有依赖包：此处的依赖包为用户自行制作上传的依赖包。
- 完成后单击“保存”，完成依赖包的添加。
如何通过域名访问专享版APIG中注册的接口？
以域名www.test.com为例 ，具体请参考如下步骤。
- 登录API网关控制台，在左侧导航栏选择“专享版”，单击实例名称，进入“实例概览”页面，在“入口地址”区域查看“弹性IP地址”，获取APIG的访问地址（ip格式）。
- 在DNS控制台，配置用户域名www.test.com解析到apig地址的ipv4规则。
- 最后在函数服务配置该域名的解析配置，这样就能在函数中通过域名(www.test.com)访问专享版APIG中注册的接口了。
函数工作流的常见使用场景？
- Web类应用：比如小程序、网页/App、聊天机器人、BFF等。
- 事件驱动类应用：文件处理、图片处理、视频直播/转码、实时数据流处理、IoT规则/事件处理等。
- AI类应用：三方服务集成、AI推理、车牌识别。
函数工作流是否支持修改运行时语言?
不支持。函数一旦创建完成，就不能修改运行时语言。
已创建的函数是否支持修改函数名称?
不支持，函数一旦创建完成，就不能修改函数名称。
如何获取上传的文件？
以Python语言为例，如果用户用os.getcwd()查看当前目录的话，会发现当前目录是/opt/function，但实际代码是传到/opt/function/code里的。
有2种方法可以获取到上传的文件：
- 函数里使用cd命令切换路径到**/opt/function/code**
- 使用全路径（相关目录为RUNTIME_CODE_ROOT环境变量对应的值）
同步调用响应未收到的可能原因？
如果函数执行端到端时延超过90s，建议使用异步不使用同步，否则会因为网关限制，超过90s后无法收到同步响应。
os.system("command &")执行日志未采集，应如何处理？
不建议使用os.system("command &")后台运行命令，其产生的输出函数不进行采集。如果要得到后台运行命令的输出，建议使用subprocess.Popen的方式获取其输出。
自定义运行时，都能操作哪些目录？
目前默认只能操作/tmp目录，在/tmp下可以写文件（如创建新文件或者下载文件等）。
用户想使用vpc功能，但不想配置VPC Administrator委托，应配置哪些授权项？
用户若不想配置VPC Administrator委托，可授予最小权限，如下表所示。
授权项配置
| 权限 | 授权项 |
|---|---|
| 删除端口 | vpc:ports:delete |
| 查询端口 | vpc:ports:get |
| 创建端口 | vpc:ports:create |
| 查询VPC | vpc:vpcs:get |
| 查询子网 | vpc:subnets:get |
函数执行超时的可能原因有哪些？
- 自身代码执行逻辑超时，建议优化代码或增加超时时间。
- 网路请求超时，建议增加超时时间。
函数进行冷启动时，Java加载类时间过长，建议增加超时时间或增加内存。
如何获取函数代码？
- 登录函数工作流控制台，单击函数名称进入函数详情页，单击右上方操作栏下的“导出函数”，继续单击“导出函数代码”。
- 通过导出函数API接口获取函数代码。
是否有initializer的代码示例？
有，请参考如下示例。
-
Node.js
exports.initializer = function(context, callback) { callback(null, ''); }; -
Python
def my_initializer(context):
print("hello world!")
- Java
public void my_initializer(Context context)
{
RuntimeLogger log = context.getLogger();
log.log(String.format("ak:%s", context.getAccessKey()));
}
- PHP
函数服务是否支持在函数中启动TCP的监听端口，通过EIP接收外部发送过来的TCP请求？
目前函数暂不支持这种方式。函数的理念是无服务器计算，计算资源只会在运行期分配，这种自定义监听端口的场景并不适合。
