Complete Guide: Creating and Managing AWS Lambda Layers

Bhagyesh Rangole — Sat, 21 Jun 2025 18:13:23 +0000

What Are AWS Lambda Layers?

AWS Lambda layers are .zip archives that allow you to share libraries, custom runtimes, or other dependencies across multiple Lambda functions. Think of them as reusable code packages that can be attached to your Lambda functions without being included in your main function code.

Key Benefits:

Code Reusability: Share common dependencies across multiple functions
Easier Updates: Update shared libraries in one place instead of updating each function
Better Organization: Separate business logic from dependencies
Faster Deployments: Reuse existing layers instead of packaging dependencies with each function

Common Challenges: Why Do My Imports Fail?

This is the most common problem when working with layers. It happens because the dependencies were installed on your local machine (like Windows or macOS), but Lambda runs on a different operating system (Linux).
Many Python packages, like OpenCV (cv2), pandas, or NumPy, contain compiled code that is specific to the operating system they are installed on. When you try to use a macOS or Windows version of a package in Lambda's Linux environment, it fails to load, resulting in an ImportError.

Step-by-Step Process

Step 1: Create the Directory Structure

mkdir -p openai-layer/python

This creates a parent folder (openai-layer) with a python subdirectory. The python folder is crucial because Lambda expects dependencies to be in a python directory at the root of the layer.

Step 2: Install Dependencies with Platform-Specific Targeting

pip install \
    --platform manylinux2014_x86_64 \
    --target=openai-layer/python \
    --implementation cp \
    --python-version 3.10 \
    --only-binary=:all: --upgrade \
    openai exceptiongroup

Key Parameters Explained:

- platform manylinux2014_x86_64
This is the most important parameter for Lambda layers
Lambda runs on Amazon Linux 2, which uses the manylinux2014 platform. When you install packages on macOS or Windows, they contain platform-specific binaries that won't work on Lambda's Linux environment. This flag ensures all dependencies are compiled for the Linux environment that Lambda uses
Without this, your layer will fail with import errors when deployed

- target=openai-layer/python
Specifies where to install the packages
Must point to the python subdirectory we created

- implementation cp
Ensures we're using CPython (standard Python implementation)
Lambda uses CPython, so this ensures compatibility

- python-version 3.10
Matches your Lambda runtime version
Must match the runtime specified in your serverless.yaml

- only-binary=:all:
Forces pip to use pre-compiled wheels when available
Faster installation and ensures compatibility

- upgrade
Updates packages to their latest compatible versions

Step 3: Create the Layer Package

cd openai-layer
zip -r ../openai-layer.zip .

This creates a ZIP file containing all the dependencies. The structure should be:

openai-layer.zip
└── python/
    ├── openai/
    ├── exceptiongroup/
    └── [other dependencies]

Step 4: Upload to S3

aws s3 cp openai-layer.zip s3://your-bucket-name/openai-layer.zip

Replace your-bucket-name with your actual S3 bucket name.

Step 5: Create/Update Lambda Layer via AWS Console

1. Go to AWS Lambda Console

Navigate to AWS Lambda service
Click on "Layers" in the left sidebar

2. Create New Layer

Click "Create layer"
Enter layer name (e.g., openai-layer)
Upload the ZIP file or provide S3 link
Select compatible runtimes (Python 3.10)
Click "Create"

3. Update Existing Layer

Find your existing layer
Click "Create new version"
Upload the new ZIP file or upload from s3
The new version will be automatically created

4. Attach Layer to AWS Lambda

Open your Lambda function in the AWS Console.
Under the Layers section, click Add a layer.
Select your custom layer, specify the version, and attach it.

DEV Community: Bhagyesh Rangole