lambci/yumda

yumda – Lambda专属的yum工具

这是一个针对AWS Lambda环境重新编译的软件包Linux发行版，附带yum配置以安装这些包（需Docker环境支持）。

目录

• 快速开始
• AWS SAM示例
• Serverless Framework示例
• 请求添加包
• 构建/托管自定义包

快速开始

使用命令：

console
docker run docker.xuanyuan.run/lambci/yumda:<version> yum <yum参数>

• 针对Amazon Linux 2运行时（如nodejs10.x/12.x、python3.8等）：使用lambci/yumda:2
• 其他运行时：使用lambci/yumda:1

示例：查看Amazon Linux 2可用包

console
$ docker run --rm lambci/yumda:2 yum list available

安装依赖到本地目录（可打包为Lambda层）：

console
$ mkdir -p gs-layer
$ docker run --rm -v "$PWD"/gs-layer:/lambda/opt lambci/yumda:2 yum install -y ghostscript
$ cd gs-layer && zip -yr ../gs-layer.zip .
$ aws lambda publish-layer-version --layer-name gs-layer --zip-file fileb://gs-layer.zip --description "Ghostscript Layer"

AWS SAM完整示例

创建一个需Git克隆+图片处理的Lambda函数：

1. 初始化SAM应用：

console
sam init --runtime nodejs10.x --name yumda-example && cd yumda-example

2. 编辑hello-world/app.js：

js
const { execSync } = require('child_process')
const shell = cmd => execSync(cmd, { cwd: '/tmp', encoding: 'utf8', stdio: 'inherit' })
exports.lambdaHandler = async () => {
  shell('git clone --depth 1 https://github.com/lambci/yumda')
  shell('gm convert ./yumda/examples/sam_squirrel.jpg -negate -contrast -resize 100x100 thumbnail.jpg')
  shell('jp2a --width=69 thumbnail.jpg')
}

3. 安装依赖：

console
mkdir -p dependencies && docker run --rm -v "$PWD"/dependencies:/lambda/opt lambci/yumda:2 yum install -y git GraphicsMagick jp2a

4. 修改template.yaml添加层：

yaml
Resources:
  HelloWorldFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: hello-world/
      Handler: app.lambdaHandler
      Runtime: nodejs10.x
      Layers: [ !Ref DependenciesLayer ]
  DependenciesLayer:
    Type: AWS::Serverless::LayerVersion
    Properties:
      ContentUri: dependencies.zip # 需先打包dependencies目录为zip

5. 本地测试与部署：

console
sam local invoke --no-event
sam package --output-template packaged.yaml --s3-bucket <你的S3桶>
sam deploy --template-file packaged.yaml --stack-name yumda-example --capabilities CAPABILITY_IAM

Serverless Framework示例

配置serverless.yaml：

yaml
service: yumda-example  
provider: { name: aws, runtime: nodejs10.x }  
package: { individually: true, exclude: ["./**"] }  
functions:
 hello-world:
   handler: hello-world/app.lambdaHandler
   package: { include: ["hello-world/**"] }
   layers: [ {Ref: DependenciesLambdaLayer} ]
layers:
 dependencies:
   path: dependencies
   package: { artifact: dependencies.zip }

安装依赖与部署：

console
docker run --rm -v "$PWD"/dependencies:/lambda/opt docker.xuanyuan.run/lambci/yumda:2 yum install -y git GraphicsMagick jp2a
cd dependencies && zip -yr ../dependencies.zip . && cd ..
sls deploy

请求添加包

在GitHub提交Issue并添加package suggestion标签，仅支持Amazon Linux核心仓库或amazon-linux-extras中的包。

构建/托管自定义包

参考https://github.com/lambci/yumda/tree/master/amazon-linux-2/build/specs/lambda2%E7%9B%AE%E5%BD%95%E7%9A%84.spec%E6%96%87%E4%BB%B6%EF%BC%8C%E4%BF%AE%E6%94%B9%E4%BB%A5%E9%80%82%E9%85%8DLambda%E7%8E%AF%E5%A2%83%E3%80%82%E6%9E%84%E5%BB%BA%E9%95%9C%E5%83%8F%E4%BD%BF%E7%94%A8https://github.com/lambci/yumda/blob/master/amazon-linux-2/build/rpmmacros%E7%A1%AE%E4%BF%9D%E7%BC%96%E8%AF%91%E4%B8%BA%60/opt%60%E7%8E%AF%E5%A2%83%E3%80%82