跳到主要内容

层管理

使用层管理命令可以创建、绑定、查看和删除云函数的文件层。

创建层

# 上传文件目录
tcb fn layer create <alias> -e <envId> --file ./content

# 上传 ZIP 文件
tcb fn layer create <alias> -e <envId> --file ./file.zip

参数说明:

参数说明必填
alias层别名
-e <envId>环境 Id
--file层内容路径(文件夹或 ZIP 文件)

使用示例:

# 创建名为 myLayer 的层,上传本地目录
tcb fn layer create myLayer -e dev-xxx --file ./my-dependencies

# 创建层并上传 ZIP 文件
tcb fn layer create commonLib -e dev-xxx --file ./libs.zip

绑定层到函数

tcb fn layer bind <functionName> -e <envId>

使用示例:

# 为 app 函数绑定层
tcb fn layer bind app -e dev-xxx

解绑层

tcb fn layer unbind <functionName> -e <envId>

使用示例:

# 解绑 app 函数的层
tcb fn layer unbind app -e dev-xxx

调整层顺序

tcb fn layer sort <functionName> -e <envId>

使用示例:

# 调整 app 函数绑定的层顺序
tcb fn layer sort app -e dev-xxx

下载层文件

tcb fn layer download -e <envId>

使用示例:

# 下载指定环境的层文件
tcb fn layer download -e dev-xxx

查看层信息

# 展示所有环境中的层
tcb fn layer list

# 展示指定环境中的层
tcb fn layer list -e <envId>

# 展示函数绑定的层
tcb fn layer list -e <envId> --name <functionName>

# 展示层的版本信息
tcb fn layer list -e <envId> --layer <layerName>

使用示例:

# 查看所有层
tcb fn layer list

# 查看指定环境的层
tcb fn layer list -e dev-xxx

# 查看 app 函数绑定的层
tcb fn layer list -e dev-xxx --name app

# 查看 myLayer 的版本信息
tcb fn layer list -e dev-xxx --layer myLayer

删除层

tcb fn layer delete -e <envId>

使用示例:

# 删除指定环境中的层
tcb fn layer delete -e dev-xxx

注意事项

  • 层名称由层别名和环境 Id 组成,是层的唯一标识
  • CLI 创建的层默认支持 Nodejs8.9Nodejs12.16Php7Java8 等运行时
  • 每次创建成功后会生成新的层版本,版本号从 1 开始自动递增
  • 层不能更新,只能发布新版本或删除已有版本
  • 只能删除指定环境中创建的层
  • 当层的所有版本都被删除时,该层将完全删除
  • 单个用户最多创建 20 个文件层
  • 每个函数最多可配置 5 个文件层
  • 建议层文件大小不超过 100MB