Function Compute:Create a custom layer

Python Runtime

1. Run the following command to create a working directory:

   mkdir my-layer-code

2. Go to the working directory.

   cd my-layer-code

3. Run the following command to install the dependency library in my-layer-code/python:

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

   ${PackageName} indicates the name of the dependency library that you want to install. For more information about the pip install command, see pip install.

   Sample code:

   pip install --target ./python numpy

   After the dependency library is installed, check whether your directory complies with the following structure:

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

4. Run the following command in the my-layer-code directory to package the dependencies:

   zip -r my-layer-code.zip python

Node.js Runtime

1. Run the following command to create a working directory:

   mkdir my-layer-code

2. Go to the working directory.

   cd my-layer-code

3. Run the following command to install the dependency library in my-layer-code/nodejs:

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

   Replace ${PackageName} with the name of the dependency library that you want to install. For more information about the npm install command, see npm-install.

   Sample code:

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

   After the dependency library is installed, check whether your directory complies with the following structure:

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

4. Run the following command in my-layer-code to package the dependencies:

   zip -r my-layer-code.zip nodejs

Java Runtime

1. Run the following command to create a working directory:

   mkdir my-layer-code/java

2. Go to the working directory.

   cd my-layer-code/java

3. Install dependencies by using Maven.

   1. Create the pom.xml file in the my-layer-code/java directory.

      Sample code:

      <?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 dependency that you want to download -->
          <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-related download plug-ins -->
                  <plugin>
                      <artifactId>maven-dependency-plugin</artifactId>
                      <configuration>
                          <!-- Specify whether to exclude indirect dependencies. Default value: false. -->
                          <excludeTransitive>false</excludeTransitive>
                          <!-- Specify whether to remove the version information in the suffix of the dependency JAR package. Default value: false. -->
                          <stripVersion>false</stripVersion>
                          <!-- File output path-->
                          <outputDirectory>./lib</outputDirectory>
                      </configuration>
                  </plugin>
              </plugins>
          </build>
      </project>

      Description

      • The dependency fie that you want to install is org.apache.commons.lang3.

      • Use maven-dependency-plugin to copy the dependency file to the /java/lib directory.

   2. Run the following command in the my-layer-code/java directory to install dependencies:

      mvn dependency:copy-dependencies

   After the dependency library is installed, check whether your directory complies with the following structure:

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

4. Run the following command in the my-layer-code directory to package the dependencies:

   zip -r my-layer-code.zip java

PHP Runtime

1. Run the following command to create a working directory:

   mkdir -p my-layer-code/php

2. Go to the working directory.

   cd my-layer-code/php

3. Use Composer to install the dependencies.

   1. In the my-layer-code/php directory, create the composer.json file.

      Sample code:

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

   2. Run the following command to install dependencies:

      composer install

   After the installation, check whether your directory complies with the following structure:

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

4. Run the following command in the my-layer-code directory to package the dependencies:

   zip -r my-layer-code.zip php

Create a custom layer in the Function Compute console

Prerequisites

A function is created. For more information, see Create a function.

Procedure

1. Log on to the Function Compute console. In the left-side navigation pane, choose Advanced Features > Layers.

2. In the top navigation bar, select a region. On the Layers page, click Create Layer.

3. On the Create Layer page, configure parameters and click Create. The following table describes the parameters.

   Parameter	Description
   Name	Enter a name for the layer that you want to create.
   Description	Enter a description that distinguishes the layer from others.
   Compatible Runtime	Specify the compatible runtimes.
   Layer Upload Method	Select a method to upload layer dependencies. You can use one of the following methods to upload layer dependencies: Upload Layer in ZIP Package Select and upload the layer ZIP file. The ZIP file to upload cannot exceed 500 MB. Upload Layer in Folder Select and upload the folder that contains the layer ZIP file. The size of a folder cannot exceed 500 MB after it is compressed. Upload Layer Using OSS Specify Bucket Name and Object Name to upload the layer ZIP file from Object Storage Service (OSS). The size of the selected object in OSS cannot exceed 500 MB. Build Dependency Layer Online If your application is developed based on Python or Node.js, or you need to install some lightweight system libraries, you can select Build Dependency Layer Online and enter the content of the dependency file package.json or requirements.txt in the editor below. After the settings are submitted, the system automatically installs these language-level dependency packages and system libraries to simplify layer dependency management.
   Build Environment	If you select Build Dependency Layer Online, you must specify the runtime in which you want to build the dependency layer. Note Only Python and Node.js runtimes support building dependency layers online.
   apt Command	If you select Build Dependency Layer Online and need to install some software packages to the layer, you can directly enter the name of the dependency in the apt install input box.

   After the layer is created, the system generates a layer version that starts from 1 in ascending order.

4. Create a new version.

   Note

   You cannot modify a created layer or the versions of a created layer. If you want to update the configurations of a layer, you can create a new layer or a new version. If a referenced layer version is deleted, the reference must be deleted before you update the layer configurations.

   1. On the Layers page, find the desired layer and click the name of the layer.

   2. In the Versions section of the page that appears, click Create Version.

   3. On the page for creating a layer version, specify runtimes, upload the new layer code, and then click Create.

Create a custom layer by using Serverless Devs