云函数 SCF 各个运行时已内置部分常用依赖库,您可前往各运行时代码开发中查询:Node.js、Python 、PHP。但仅有内置依赖库是不足以满足用户的代码运行诉求的,在此基础上,SCF 提供了丰富的依赖安装方式。我们将分为上下两篇进行讲解,本文将介绍对 Node.js 和 Python 运行时的依赖安装方法,下篇将为大家介绍 PHP、Java、Go 的依赖安装方法。
01. Node.js 运行时
Node.js 运行时支持以下三种依赖库安装方法:
1. 依赖库同代码一起打包上传
通过依赖管理工具,例如 npm,在本地安装依赖后同函数代码一同打包上传。
- 打包时函数入口文件需要在
zip
包的根目录下。如果打包整个文件夹并上传zip
包,则会因解压后无法在根目录找到入口文件而导致函数创建失败。
本文以安装 lodash
库为例:
在本地终端中执行
mkdir test-package
命令,创建一个目录用于存放函数代码和依赖库。执行以下命令,在该目录下安装
lodash
依赖库。cd test-package npm install lodash
在该目录下创建函数入口文件
index.js
并在代码中引用lodash
库。'use strict'; const _ = require('lodash'); ex = async (event, context) => { con("Hello World") con(event) con(event["non-exist"]) con(context) return event };
将函数代码及依赖库一同压缩为 zip 包,在 云函数控制台 中上传打包的 zip 包并创建一个新函数。操作步骤如下:
i. 登录 云函数控制台,单击左侧导航栏的【函数服务】。
ii. 在主界面上方选择期望创建函数的地域,并单击【新建】,进入函数创建流程。
iii. 在“新建函数”页面,填写函数基本信息。如下图所示:
- 创建方式:选择使用【自定义创建】来新建函数。
- 运行环境:选择【Node.j】。
- 提交方法:选择【本地上传zip包】。
单击【完成】即可创建函数。
2. 在线依赖安装 Node.js 运行时提供了在线依赖安装功能,启用了「在线安装依赖」后,在每次上传代码之后,云函数后台将检查代码包根目录的 文件,并根据
中的依赖,尝试使用 npm 工具安装依赖包。
以安装 lodash
库为例:
登录 云函数控制台,单击左侧导航栏的【函数服务】。
选择左侧导航栏【函数服务】,在“函数服务”列表页面选择需要在线安装依赖的函数或单击【新建】创建一个函数。
选择【函数代码】页签,根据您的实际需求修改函数代码并添加
文件。
内容以下文为例:
{ "dependencies": { "lodash": "4.17.15" } }
在 IDE 代码编辑窗口右上角中单击【 】,在下拉列表中选择【自动安装依赖:关闭】以开启自动安装依赖,如下图所示:
单击【部署】,云函数后台会根据
自动安装依赖。
? 在线依赖安装功能目前仅支持
Node.js
运行时,其他运行时敬请期待。
3. 使用 Serverless Web IDE
云函数在线编辑器 Serverless Web IDE 提供了终端功能,并在终端中内置了包管理工具 npm
。本文以在终端中安装 lodash
库为例:
登录 云函数控制台,在左侧选择【函数服务】。
在函数列表中,单击函数名,进入该函数的详情页面。
在“函数管理”页面中,选择【函数代码】>【代码编辑】,查看并编辑函数。
在 IDE 顶部的菜单栏【终端】中选择【新终端】,打开终端窗口。
在终端中执行如下命令,安装依赖库
lodash
:cd src # 依赖库需要安装在与函数入口文件同一级的目录下,即需要进入`src`目录后再执行依赖安装操作。 npm install lodash
安装完成后,在 IDE 左侧的文件树中查看
和
node_modules
。单击【部署】后依赖库即可与函数代码一同打包上传到云端。如下图所示:
02. Python 运行时
Python 运行时支持以下两种依赖库安装方法:
1. 依赖库同代码一起打包上传 通过依赖管理工具,例如 pip,在本地安装依赖后同函数代码一同打包上传。
- 打包时函数入口文件需要在
zip
包的根目录下。如果打包整个文件夹并上传zip
包,则会因解压后无法在根目录找到入口文件而导致函数创建失败。 - 由于运行环境不同,可自行将
pip
替换为pip3
或pip2
。 - 函数运行系统为 CentOS 7,您需要在相同环境下进行安装。若环境不一致,则可能导致上传后运行时出现无法找到依赖的错误。您可参考 云函数容器镜像 进行依赖安装或使用在线 IDE 进行安装。
- 若部分依赖涉及动态链接库,则需手动复制相关依赖包到依赖安装目录后再打包上传。详情请参见 使用 Docker 安装依赖 或使用在线 IDE 进行安装。
本文以安装 numpy
库为例:
在本地终端中执行
mkdir test-package
命令,创建一个目录用于存放函数代码和依赖库。执行以下命令,在该目录下安装
numpy
依赖库。cd test-package pip install numpy -t .
在该目录下创建函数入口文件
index.py
并在代码中引用numpy
库。# -*- coding: utf8 -*- import json import numpy def main_handler(event, context): print("Received event: " + j(event, indent = 2)) print("Received context: " + str(context)) print("Hello world") return("Hello World")
将函数代码及依赖库一同压缩为 zip 包,在 云函数控制台 中上传打包的 zip 包并创建一个新函数。操作步骤如下:
i. 登录 云函数控制台,单击左侧导航栏的【函数服务】。
ii. 在主界面上方选择期望创建函数的地域,并单击【新建】,进入函数创建流程。
iii. 在“新建函数”页面,填写函数基本信息。如下图所示:
- 创建方式:选择使用【自定义创建】来新建函数。
- 运行环境:选择【Python 3.6】。
- 提交方法:选择【本地上传zip包】。
单击【完成】即可创建函数。
2. 使用 Serverless Web IDE 云函数在线编辑器 Serverless Web IDE 提供了终端功能,并在终端中内置了包管理工具 pip
。本文以在终端中安装 numpy
库为例:
登录 云函数控制台,在左侧选择【函数服务】。
在函数列表中,单击函数名,进入该函数的详情页面。
在“函数管理”页面中,选择【函数代码】>【代码编辑】,查看并编辑函数。
在 IDE 顶部的菜单栏【终端】中选择【新终端】,打开终端窗口。
在终端中执行如下命令,安装依赖库
numpy
:cd src # 依赖库需要安装在与函数入口文件同一级的目录下,即需要进入`src`目录后再执行依赖安装操作。 pip3 install numpy -t .
安装完成后,在 IDE 左侧的文件树中查看已安装的依赖库。
单击【部署】后依赖库即可与函数代码一同打包上传到云端。
- 您可以使用
pip freeze > requiremen
生成本地环境下所有依赖的requiremen
文件。- 在 IDE 的终端中执行
pip3 install -r requiremen -t .
即可根据requiremen
的配置安装依赖包。
One More Thing
立即体验腾讯云 Serverless Demo,领取 Serverless 新用户礼包 腾讯云 Serverless 新手体验
欢迎访问:Serverless 中文网!