byub/serverless

AWS无服务器构建Docker镜像文档

镜像概述

本Docker镜像专为AWS无服务器应用的构建场景设计，集成了AWS CLI、kubectl和Node.js v12.16等核心工具，旨在提供一个标准化的容器环境，简化AWS无服务器应用（如Lambda、API Gateway等）的构建、打包与部署流程。通过容器化方式，确保构建环境的一致性，避免因本地环境差异导致的构建问题。

核心功能与特性

集成关键工具

• AWS CLI：用于与AWS服务交互，支持管理Lambda函数、S3存储桶、IAM角色等AWS资源，执行无服务器应用的部署与配置操作。
• kubectl：Kubernetes命令行工具，可用于与EKS（Amazon Elastic Kubernetes Service）集群交互，适用于结合Kubernetes的无服务器部署场景。
• Node.js v12.16：提供JavaScript运行环境，支持执行Node.js构建脚本（如使用npm/yarn管理依赖、打包无服务器应用代码等）。

环境标准化

• 基于轻量级基础镜像构建（具体基础镜像未指定，实际使用时需参考镜像完整定义），减少镜像体积，提升启动速度。
• 工具版本固定（AWS CLI、kubectl版本需参考镜像完整定义，Node.js固定为v12.16），确保构建过程可重复、结果可预期。

使用场景与适用范围

典型使用场景

1. 无服务器应用构建与部署：在容器内执行AWS Lambda函数代码打包、API Gateway配置更新、Serverless Framework部署等任务。
2. CI/CD流水线集成：作为CI/CD系统（如Jenkins、GitHub Actions、GitLab CI）中的构建步骤容器，提供统一的AWS无服务器构建环境。
3. 本地开发与测试：开发者可通过本镜像在本地模拟CI/CD环境，验证无服务器应用的构建流程，提前发现环境相关问题。

适用范围

• AWS无服务器架构（Serverless Architecture）相关的应用开发团队。
• 需要容器化构建环境的CI/CD流程设计人员。
• 需同时使用AWS CLI、Node.js及kubectl工具的开发或运维场景。

使用方法与配置说明

基本使用方式（docker run）

启动交互式容器

通过以下命令启动一个交互式容器，进入命令行环境执行构建操作：

bash
docker run -it --rm [镜像名称] /bin/sh

• -it：以交互式终端模式运行容器。
• --rm：容器退出后自动删除，避免残留容器实例。
• [镜像名称]：替换为实际的Docker镜像名称（如私有仓库地址或Docker Hub镜像名）。

挂载本地项目目录并执行构建

将本地无服务器项目目录挂载到容器内，执行构建脚本：

bash
docker run -it --rm \
  -v /本地项目路径:/app \  # 挂载本地项目目录到容器内/app目录
  -w /app \  # 设置工作目录为/app
  [镜像名称] \
  sh -c "npm install && zip -r function.zip . && aws lambda update-function-code --function-name my-lambda --zip-file fileb://function.zip"

上述命令示例中，容器挂载本地项目目录后，依次执行依赖安装（npm install）、代码打包（zip）及Lambda函数代码更新（aws lambda update-function-code）操作。

环境变量配置

AWS CLI认证配置

为使AWS CLI能正常访问AWS资源，需通过环境变量注入AWS凭证（建议仅在测试环境使用，生产环境优先使用IAM角色认证）：

bash
docker run -it --rm \
  -e AWS_ACCESS_KEY_ID=AKIAEXAMPLE \  # AWS访问密钥ID
  -e AWS_SECRET_ACCESS_KEY=secret \    # AWS密钥
  -e AWS_REGION=us-east-1 \            # AWS区域（如us-east-1、eu-west-1等）
  [镜像名称] \
  aws s3 ls  # 验证AWS CLI是否正常工作（列出S3存储桶）

docker-compose配置示例

若需在多容器环境中使用（如结合数据库容器进行构建前测试），可通过docker-compose.yml定义服务：

yaml
version: '3'
services:
  serverless-builder:
    image: [镜像名称]
    volumes:
      - ./local-project:/app
    working_dir: /app
    environment:
      - AWS_ACCESS_KEY_ID=AKIAEXAMPLE
      - AWS_SECRET_ACCESS_KEY=secret
      - AWS_REGION=us-east-1
    command: sh -c "npm install && serverless deploy"  # 执行Serverless Framework部署

通过docker-compose up命令启动服务，自动执行定义的构建与部署命令。

注意事项

1. 工具版本兼容性：Node.js版本固定为v12.16，若项目依赖更高版本Node.js，需评估兼容性或选择其他镜像。
2. 安全最佳实践：生产环境中避免通过环境变量传递AWS密钥，建议使用ECS/EKS任务IAM角色或CI/CD系统的密钥管理功能进行认证。
3. 镜像更新：定期检查镜像是否有更新，确保集成的工具（如AWS CLI）包含最新安全补丁和功能。