Skip to main content

Layer Management

Use layer management commands to create, bind, view, and delete file layers for cloud functions.

Create Layer

# Upload file directory
tcb fn layer create <alias> -e <envId> --file ./content

# Upload ZIP file
tcb fn layer create <alias> -e <envId> --file ./file.zip

Parameter Description:

ParameterDescriptionRequired
aliasLayer aliasYes
-e <envId>Environment IDYes
--fileLayer content path (folder or ZIP file)Yes

Usage Examples:

# Create layer named myLayer, upload local directory
tcb fn layer create myLayer -e dev-xxx --file ./my-dependencies

# Create layer and upload ZIP file
tcb fn layer create commonLib -e dev-xxx --file ./libs.zip

Bind Layer to Function

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

Usage Example:

# Bind layer to app function
tcb fn layer bind app -e dev-xxx

Unbind Layer

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

Usage Example:

# Unbind layer from app function
tcb fn layer unbind app -e dev-xxx

Adjust Layer Order

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

Usage Example:

# Adjust layer order for app function
tcb fn layer sort app -e dev-xxx

Download Layer Files

tcb fn layer download -e <envId>

Usage Example:

# Download layer files for specified environment
tcb fn layer download -e dev-xxx

View Layer Information

# Display layers in all environments
tcb fn layer list

# Display layers in specified environment
tcb fn layer list -e <envId>

# Display layers bound to function
tcb fn layer list -e <envId> --name <functionName>

# Display version information for layer
tcb fn layer list -e <envId> --layer <layerName>

Usage Examples:

# View all layers
tcb fn layer list

# View layers in specified environment
tcb fn layer list -e dev-xxx

# View layers bound to app function
tcb fn layer list -e dev-xxx --name app

# View version information for myLayer
tcb fn layer list -e dev-xxx --layer myLayer

Delete Layer

tcb fn layer delete -e <envId>

Usage Example:

# Delete layer in specified environment
tcb fn layer delete -e dev-xxx

Important Notes

  • Layer name consists of layer alias and environment ID, is the unique identifier for the layer
  • Layers created by CLI default support Nodejs8.9, Nodejs12.16, Php7, Java8 and other runtimes
  • Each successful creation generates a new layer version, version numbers start from 1 and auto-increment
  • Layers cannot be updated, can only publish new versions or delete existing versions
  • Can only delete layers created in specified environment
  • When all versions of a layer are deleted, the layer will be completely deleted
  • Single user can create up to 20 file layers
  • Each function can configure up to 5 file layers
  • Recommended layer file size not exceeding 100MB