文档

为函数安装第三方依赖

更新时间:

函数计算运行环境中已内置常用的依赖,供您直接在函数中引用。同时,函数计算支持使用第三方依赖。本文介绍如何为函数安装第三方依赖。

背景信息

您可以在以下文档的内置模块章节,查看函数计算内置的常用依赖。

通过层安装依赖

函数计算已经发布了部分依赖库,您可以直接使用。更多信息,请参见在函数中配置官方公共层。如您想获取更多的公开层,请参见awesome-layers

关于如何使用层来解决各种依赖库的问题,请参见如何使用层解决依赖包问题?

直接使用官方公共层安装依赖

  • 官方公共层

    创建函数后,在函数详情页面,单击函数配置页签,在区域,单击编辑,然后在编辑函数层面板选择+添加层 > 添加官方公共层。具体操作,请参见在函数中配置官方公共层

  • 非官方公共层

    awesome-layers找到目标层,获取层ARN。在函数详情页面,单击函数配置页签,在区域,单击编辑,然后在编辑函数层面板选择+添加层 > 通过 ARN 添加层

构建自定义层安装依赖

  • 通过控制台在线构建层

    登录函数计算控制台,在左侧导航栏,选择高级功能 > 层管理。具体操作,请参见创建自定义层

    说明
    • 此方式仅支持Node.js和Python运行环境。

    • 此方式不支持包含系统动态链接库(.so)的依赖,例如Node.js的依赖库Puppeteer。如果依赖包含动态链接库(.so),推荐使用Dockerfile文件构建层。

  • 本地构建层

    您可以在本地构建直接构建自定义层。具体操作,请参见构建层的ZIP包。使用此方式需要确保本地的操作系统和处理器架构与函数计算运行时环境完全一致,即架构为x86-64的Linux系统,或者安装的依赖库不依赖底层环境和处理器架构。否则,推荐您使用控制台在线构建层或者使用Dockerfile方式构建层。

    例如,Python的科学计算库numpy对底层环境有依赖,如果使用M1芯片的Mac系统,不能使用本地构建方式安装依赖。

  • 使用Dockerfile文件构建层

    如果依赖包含底层动态链接库,或者在本地安装依赖失败,可以使用Dockerfile的方式安装。具体操作,请参见如何基于Dockerfile构建层

通过函数计算控制台安装依赖

通过打包依赖并上传到控制台

  1. 将第三方依赖与代码文件打包。

    重要
    • 您需要进入代码目录,打包所有文件。打包完成后,入口函数文件需要位于包内的根目录。

    • 不同系统下打包方式不同,请您根据实际情况选择合适的打包方式。

  2. 登录函数计算控制台,通过上传 ZIP 包上传文件夹通过 OSS 上传的方式上传代码包,部署函数。

通过控制台Web IDE终端安装依赖

  1. 登录函数计算控制台,找到目标函数。

  2. 在函数详情页面,单击函数代码页签,然后在Web IDE界面,选择Terminal > New Terminal,在终端窗口,执行安装依赖的命令。

    以Python为例,执行以下命令安装依赖。更多信息,请参见部署代码包

    pip install -t . <PackageName>      # PackageName为依赖包的名称 
  3. 安装成功后,您的Web IDE目录结构如下图所示。install-rely

使用Serverless Devs安装依赖

通过函数计算的Serverless Devs,创建并部署函数。具体操作,请参见Serverless Devs操作命令

关于函数计算安装第三方依赖的总结,请参见函数计算安装依赖库方法小结