angelalign/aws-lambda-sharp

镜像概述

该Docker镜像为AWS Lambda提供基于Node.js的基础运行环境，并预先集成了sharp高性能图像处理库。sharp库支持多种图片操作（如裁剪、缩放、格式转换、压缩等），本镜像旨在简化图像处理相关AWS Lambda函数的开发与部署流程，避免手动配置sharp的系统依赖（如libvips），可直接基于镜像构建Lambda函数包并部署。

核心功能与特性

基础环境支持

• Node.js运行时：提供与AWS Lambda兼容的Node.js基础环境，支持Node.js标准API及Lambda函数开发范式。
• AWS Lambda兼容性：遵循AWS Lambda容器镜像规范，可直接作为Lambda函数的运行时镜像使用。

图像处理能力

• sharp预装集成：内置sharp图像处理库，支持JPEG、PNG、WebP、AVIF等主流图片格式的读取与处理。
• 高性能处理：sharp基于libvips库实现，处理速度快、内存占用低，适合Lambda无服务器环境的资源限制场景。

开发效率优化

• 依赖预配置：已预装sharp及其系统依赖，避免手动安装libvips等底层库，减少开发环境配置时间。
• 轻量化设计：镜像体积经过优化，兼顾功能完整性与部署效率。

使用场景

• 实时图片处理：用户上传图片后（如S3事件触发），通过Lambda自动执行裁剪、压缩、格式转换（如WebP转JPEG）等操作。
• 批量图片处理：定期触发Lambda函数，对指定存储位置的图片进行批量优化（如降低分辨率、压缩文件大小）。
• 动态图片生成：根据请求参数（如尺寸、水印）实时生成定制化图片，适用于电商商品图、社交媒体素材等场景。

使用方法

拉取镜像

通过Docker Hub或AWS ECR拉取镜像（具体镜像仓库地址需根据实际发布源调整）：

bash
docker pull [镜像仓库地址]/aws-lambda-nodejs-sharp:latest

构建Lambda函数包

1. 准备函数代码

创建index.js作为Lambda处理程序，实现图片处理逻辑：

javascript
// index.js
const sharp = require('sharp');
const { S3Client, GetObjectCommand, PutObjectCommand } = require('@aws-sdk/client-s3');

const s3 = new S3Client();

/**
 * Lambda处理函数：从S3获取图片，压缩后上传至目标桶
 * @param {Object} event - Lambda触发事件（示例：包含源S3桶、文件名等参数）
 */
exports.handler = async (event) => {
  try {
    // 从S3获取原始图片
    const getParams = {
      Bucket: event.sourceBucket,
      Key: event.sourceKey
    };
    const { Body: rawImage } = await s3.send(new GetObjectCommand(getParams));

    // 使用sharp压缩图片（示例：调整尺寸并转换为WebP格式）
    const processedImage = await sharp(rawImage)
      .resize(1200, 800, { fit: 'inside', withoutEnlargement: true }) // 限制最大尺寸，不放大图片
      .webp({ quality: 80 }) // 转换为WebP格式，质量80%
      .toBuffer();

    // 上传处理后的图片到目标S3桶
    const putParams = {
      Bucket: event.targetBucket,
      Key: `processed/${event.sourceKey.replace(/\.\w+$/, '.webp')}`, // 重命名为WebP格式
      Body: processedImage,
      ContentType: 'image/webp'
    };
    await s3.send(new PutObjectCommand(putParams));

    return { 
      status: 'success', 
      processedKey: putParams.Key,
      size: processedImage.length
    };
  } catch (error) {
    console.error('Image processing failed:', error);
    throw error;
  }
};

2. 创建Dockerfile

通过Dockerfile构建包含函数代码的Lambda镜像：

dockerfile
# 基于本镜像作为基础镜像
FROM [镜像仓库地址]/aws-lambda-nodejs-sharp:latest

# 将Lambda函数代码复制到Lambda任务根目录
COPY index.js ${LAMBDA_TASK_ROOT}/

# 安装额外依赖（如AWS SDK for S3）
RUN npm install @aws-sdk/client-s3

# 设置Lambda入口处理程序（格式：[文件名].[函数名]）
CMD ["index.handler"]

3. 构建并推送镜像

bash
# 构建镜像（替换镜像名称和标签）
docker build -t my-lambda-image:v1 .

# 标记镜像为ECR仓库格式（需先创建ECR仓库）
docker tag my-lambda-image:v1 [AWS_ACCOUNT_ID].dkr.ecr.[REGION].amazonaws.com/my-lambda-image:v1

# 推送镜像到ECR
docker push [AWS_ACCOUNT_ID].dkr.ecr.[REGION].amazonaws.com/my-lambda-image:v1

在AWS Lambda中部署

1. 创建Lambda函数：在AWS Lambda控制台选择“容器镜像”部署选项，指定推送至ECR的镜像URI。
2. 配置触发方式：根据场景配置触发源（如S3对象创建事件、API Gateway、CloudWatch Events定时触发等）。
3. 设置执行角色：为Lambda函数分配必要权限（如S3读写权限、CloudWatch日志权限）。

环境变量与配置参数

注意事项

• 运行时兼容性：需确保镜像的Node.js版本与AWS Lambda支持的运行时版本匹配（参考AWS Lambda官方文档）。
• 资源配置：根据图片处理复杂度调整Lambda函数的内存和超时时间（建议处理大图片时分配≥1024MB内存）。
• 依赖管理：如需使用其他Node.js库，需在Dockerfile中通过npm install添加，并确保依赖与Node.js版本兼容。
• 镜像更新：定期更新镜像以获取sharp和Node.js的安全补丁及功能更新。