创建自定义层

Python Runtime

1. 执行以下命令创建工作目录。

   mkdir my-layer-code

2. 进入已创建的工作目录。

   cd my-layer-code

3. 执行以下命令安装依赖库到my-layer-code/python。

   pip install --target ./python ${PackageName}

   ${PackageName}是您要安装的依赖包的名称，pip install命令的详细使用方法，请参见pip install。

   代码示例如下：

   pip install --target ./python numpy

   安装完成后，目录结构如下：

   my-layer-code
   └── python
       ├── bin
       ├── numpy
       ├── numpy-1.22.4.dist-info
       └── numpy.libs

4. 在my-layer-code目录，执行以下命令打包依赖。

   zip -r my-layer-code.zip python

Node.js Runtime

1. 执行以下命令创建工作目录。

   mkdir my-layer-code

2. 进入已创建的工作目录。

   cd my-layer-code

3. 执行以下命令安装依赖库到my-layer-code/nodejs。

   npm install --prefix ./nodejs --save ${PackageName}

   ${PackageName}是您要安装的依赖包的名称，npm install命令的详细使用方法，请参见npm-install。

   代码示例如下：

   npm install --prefix ./nodejs --save uuid

   安装完成后，目录结构如下：

   my-layer-code
   └── nodejs
       ├── node_modules
       │ └── uuid
       ├── package-lock.json
       └── package.json

4. 在my-layer-code中执行以下命令打包依赖。

   zip -r my-layer-code.zip nodejs

Java Runtime

1. 执行以下命令创建工作目录。

   mkdir my-layer-code/java

2. 进入已创建的工作目录。

   cd my-layer-code/java

3. 通过Maven安装依赖。

   1. 在my-layer-code/java目录下创建一个pom.xml文件。

      示例如下：

      <?xml version="1.0" encoding="UTF-8"?>
      <project xmlns="http://maven.apache.org/POM/4.0.0"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
          <modelVersion>4.0.0</modelVersion>
          <groupId>maven.util</groupId>
          <artifactId>install-layer</artifactId>
          <version>1.0</version>
          <!-- 要下载的maven依赖 -->
          <dependencies>
              <!-- https://mvnrepository.com/artifact/org.apache.commons/commons-lang3 -->
              <dependency>
                  <groupId>org.apache.commons</groupId>
                  <artifactId>commons-lang3</artifactId>
                  <version>3.12.0</version>
              </dependency>
          </dependencies>
          <build>
              <plugins>
                  <!-- maven相关下载插件 -->
                  <plugin>
                      <artifactId>maven-dependency-plugin</artifactId>
                      <configuration>
                          <!-- 是否排除间接依赖。默认false，不排除 -->
                          <excludeTransitive>false</excludeTransitive>
                          <!-- 是否消除依赖jar包后缀的版本信息。默认是false，不取消版本信息 -->
                          <stripVersion>false</stripVersion>
                          <!-- 输出文件路径 -->
                          <outputDirectory>./lib</outputDirectory>
                      </configuration>
                  </plugin>
              </plugins>
          </build>
      </project>

      示例解析如下：

      • 要安装的依赖包为org.apache.commons.lang3。

      • 使用maven-dependency-plugin将需要安装的依赖包拷贝到/java/lib目录下。

   2. 在my-layer-code/java目录下执行以下命令安装依赖。

      mvn dependency:copy-dependencies

   安装完成后，目录结构如下：

   my-layer-code
   └── java
       └── lib
           └── commons-lang3-3.12.0.jar

4. 在my-layer-code目录，执行以下命令打包依赖。

   zip -r my-layer-code.zip java

PHP Runtime

1. 执行以下命令创建工作目录。

   mkdir -p my-layer-code/php

2. 进入已创建的工作目录。

   cd my-layer-code/php

3. 通过Composer安装依赖。

   1. 在my-layer-code/php目录下，创建一个composer.json文件。

      示例如下：

      {
        "require": {
          "aliyunfc/fc-php-sdk": "~1.2",
          "alibabacloud/fnf": "^1.7"
        }
      }

   2. 执行以下命令安装依赖。

      composer install

   安装完成后，目录结构如下：

   my-layer-code
    └─php
      ├──composer.json
      ├──composer.lock
      └──vendor

4. 在my-layer-code目录，执行以下命令打包依赖。

   zip -r my-layer-code.zip php

通过控制台创建自定义层

前提条件

已完成函数的创建，具体操作请参见创建函数。

操作步骤

1. 登录函数计算控制台，在左侧导航栏，选择函数管理 > 层管理。

2. 在顶部菜单栏，选择地域，然后在层管理页面，单击创建层。

3. 在创建层页面，设置相关参数，然后单击创建。

   参数	描述
   名称	设置层的名称，支持自定义。
   描述	设置层的描述信息，便于区分各层。
   兼容运行时	选择与该层兼容的运行时环境。
   层上传方式	按需选择上传层依赖的方式。包含以下几种上传方式： 通过 ZIP 包上传层 选择或直接上传已构建的层的ZIP文件。上传的ZIP文件不能超过500 MB。 通过文件夹上传层 选择或上传已构建层的ZIP文件所在的文件夹。上传的文件夹压缩后不能超过500 MB。 通过 OSS 上传层 选择上传构建层的ZIP文件的Bucket 名称和文件名称。选择的OSS中的文件不能超过500 MB。 在线构建依赖层 如果您的函数应用是基于Python和Node.js语言开发，或需要安装部分轻量级系统库，可以选择在线构建依赖层，并在下方输入框输入构建层的依赖文件package.json或requirements.txt的内容，提交创建层后系统会自动安装这些语言级别的依赖包和系统库，简化层依赖管理过程。
   构建环境	当您选择在线构建依赖层时，需设置此参数选择构建依赖层所使用的运行环境。 说明 目前仅Python和Node.js运行时支持在线构建依赖层。
   apt 命令	当您选择在线构建依赖层，且需要安装部分软件包到层中，可以在apt install后面的输入框直接输入依赖的名称在线安装。

   层创建成功后，将自动生成层的版本，版本号从1开始递增。

4. 创建新版本。

   说明

   已创建的层或相关层版本暂不支持修改，如果您需要修改层的相关配置，可以创建新的层或创建新版本。需要注意的是，如果引用的层版本已删除，在更新层配置时，必须先删除该引用。

   1. 在层管理页面，单击目标层名称。

   2. 在版本管理区域，单击创建版本。

   3. 在创建新的版本页面，选择运行环境并上传新的层代码，然后单击创建。

通过Serverless Devs创建自定义层