最佳实践

诚邀爱技术、爱分享的你,成为文档内容共建者> HOT

操作场景

本文介绍如何通过云函数(SCF)控制台创建、绑定并使用层,同时提供示例。您可参考本文开始使用层。

操作步骤

创建层

  1. 登录 SCF 控制台,选择左侧导航栏中的 ,进入“层”列表页面。
  2. 在页面上方选择需使用层的地域,并单击新建
  3. 在“新建层”页面,根据实际需求设置层信息。如下图所示:
    • 层名称:输入自定义层名称。
    • 描述:层的描述信息,根据实际情况填写。
    • 提交方法:支持本地上传zip包本地上传文件夹通过cos上传zip包,结合实际情况选择层文件提交方式。
      确定提交方法后单击上传,选择需要上传的文件并单击确定
    • 添加运行环境:该层的兼容运行环境,最多可设置5个。
  4. 单击确定即可成功创建。

云函数绑定层

  1. 登录 SCF 控制台,选择左侧导航栏中的 函数服务,进入“函数服务”列表页面。
  2. 选择需进行层管理的函数 ID,进入函数管理页面。
  3. 选择层管理页签,并单击绑定。如下图所示:
  4. 在弹出的“绑定层”窗口中,选择对应层名称层版本。如下图所示:
  5. 单击确定即可完成绑定。

使用层

层中的文件均在/opt/目录下,可以在函数代码中通过绝对路径进行访问。除此之外,各运行时内置的环境变量中也包含了层路径,可以按照环境变量中层文件的路径上传文件,即可在代码中通过相对路径进行引用。

Python、Java、Node.js 环境变量见下表:

相关环境变量 路径
PYTHONPATH /var/user:/opt
CLASSPATH /var/runtime/java8:/var/runtime/java8/lib/*:/opt
NODE_PATH /var/user:/var/user/node_modules:/var/lang/node6/lib/node_modules:/opt:/opt/node_modules

以 Node.js 运行环境,在代码中引用层中的 node_modules 中的 cos-nodejs-sdk-v5 依赖为例:

  1. 参考 创建层 步骤将 node_modules 上传生成层。本地函数目录结构如下图所示:
  2. 参考 部署函数 将本地函数代码打包上传,打包时执行以下命令排除 node_modules 文件夹。
    zip -r 包名.zip . -x "node_modules/*"
    如下图所示:
  3. 参考 绑定云函数 步骤,将已创建的层绑定至部署好的函数。
  4. 完成上述步骤后,即可开始在函数中引用层中的文件。
    'use strict'
    var COS = require('cos-nodejs-sdk-v5')
    注意:

    • 由于 NODE_PATH 环境变量包含 /opt/node_modules 路径,所以无需指定依赖的绝对路径,SCF 运行时会按照环境变量中指定的路径加载文件。
    • 如层中文件路径和环境变量包含路径不一致,请在文件引用时使用绝对路径。

以 Python 运行环境,在代码中引用层中的 cos-python-sdk-v5 依赖为例:

  1. 参考 创建层 步骤将 cos-python-sdk-v5上传生成层。
  2. 参考 部署函数 将本地函数代码打包上传,已经上传到层中的文件无需跟随函数代码再次进行上传。
  3. 参考 绑定云函数 步骤,将已创建的层绑定至部署好的函数。
  4. 完成上述步骤后,即可开始在函数中引用层中的文件。
    # -*- coding: utf8 -*-
    import cos-python-sdk-v5
    注意:

    • 由于 PYTHONPATH 环境变量包含 /opt 路径,所以无需指定依赖的绝对路径,SCF 运行时会按照环境变量中指定的路径加载文件。
    • 如层中文件路径和环境变量包含路径不一致,请在文件引用时使用绝对路径。

示例

使用层并测试函数

  1. 前往 scf_layer_demo,选择Clone or download > Download ZIP下载示例到本地并解压。
  2. 请按照 创建层 步骤完成层创建。参数设置如下图所示:
    • 层名称:自定义,本文以 demo 为例。
    • 提交方法:选择“本地上传文件夹”,并选择上传 步骤1 中已获取文件夹中的 layer 文件夹。
    • 运行环境:选择 “Nodejs12.16”。
  3. 前往 “函数服务” 页面,单击新建进入“新建函数”页面。
  4. 在“新建函数”页面的“基本信息”步骤中,设置函数基本信息,并单击下一步。如下图所示:
    • 函数名称:自定义,本文以 layerDemo 为例。
    • 运行环境:选择 “Nodejs 12.16”。
    • 创建方式:选择自定义创建
  5. 在“函数配置”步骤中,“提交方法”选择“本地上传文件夹”并选择上传 步骤1 中已获取文件夹中的 function 文件夹。如下图所示:
  6. 单击高级设置,并在“层配置”中添加函数层。如下图所示:
    • 层名称:选择 步骤2 中已创建的层 demo
    • 层版本:选择版本1。
  7. 单击页面下方的完成完成函数创建。
  8. 在“函数管理”页面选择函数代码页面,单击页面下方的测试即可查看结果。如下图所示:
目录