mgid/serverless

Serverless框架Docker镜像文档

镜像概述

本Docker镜像预安装了Serverless框架（Serverless Framework），旨在为无服务器（Serverless）应用开发提供便捷、隔离且一致的运行环境。通过该镜像，开发者可避免本地环境配置繁琐、版本冲突等问题，快速开展无服务器应用的开发、测试与部署工作。

核心功能与特性

• 预配置环境：已集成最新稳定版Serverless框架及常用插件（如serverless-offline、serverless-python-requirements等），开箱即可使用。
• 环境隔离：通过容器化技术隔离应用开发环境，避免与本地系统依赖冲突。
• 跨平台一致性：确保在不同操作系统（Windows/macOS/Linux）及开发设备上提供一致的Serverless命令执行结果。
• 多云支持：原生支持AWS、Azure、Google Cloud、阿里云等主流云服务提供商的无服务器服务部署。
• 灵活定制：支持通过环境变量、挂载配置文件或自定义Dockerfile扩展功能，满足个性化需求。

使用场景

• 本地开发测试：开发者无需在本地安装Node.js及Serverless框架，直接通过容器运行serverless命令进行应用构建与调试。
• CI/CD集成：在持续集成/持续部署流程中作为执行环境，自动化运行serverless deploy等部署命令，确保部署环境一致性。
• 团队协作：统一团队开发环境，避免因本地配置差异导致的"在我电脑上能运行"问题。
• 快速原型验证：通过容器快速启动Serverless环境，验证无服务器架构原型或测试云服务集成逻辑。

使用方法与配置说明

获取镜像

默认情况下，可通过Docker Hub拉取官方或社区维护的镜像（具体镜像名称需根据实际仓库调整）：

bash
docker pull serverless/serverless:latest

提示：建议指定具体版本标签（如v3.38.0）以确保环境稳定性，避免因框架版本更新导致兼容性问题。

基本使用

1. 运行Serverless命令

通过docker run启动容器并执行Serverless命令，例如查看框架版本：

bash
docker run --rm serverless/serverless:latest --version

• --rm：容器退出后自动删除，避免残留临时容器。

2. 挂载本地项目目录

将本地无服务器应用项目目录挂载到容器中，以操作本地代码：

bash
docker run --rm -v $(pwd):/app -w /app serverless/serverless:latest deploy

• -v $(pwd):/app：将当前目录（本地项目）挂载到容器内/app目录。
• -w /app：设置容器工作目录为/app，即项目根目录。
• deploy：执行Serverless部署命令。

3. 配置云服务凭证

Serverless框架需云服务提供商凭证（如AWS Access Key）以操作云资源，可通过以下方式注入：

方式一：环境变量注入

bash
docker run --rm -v $(pwd):/app -w /app \
  -e AWS_ACCESS_KEY_ID=your_aws_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_aws_secret_key \
  serverless/serverless:latest deploy

方式二：挂载凭证配置文件

将本地云服务凭证配置文件（如AWS的~/.aws/credentials）挂载到容器对应目录：

bash
docker run --rm -v $(pwd):/app -w /app \
  -v ~/.aws/credentials:/root/.aws/credentials \
  serverless/serverless:latest deploy

高级配置

自定义插件安装

如需添加额外Serverless插件，可通过自定义Dockerfile扩展基础镜像：

dockerfile
FROM serverless/serverless:latest
RUN npm install -g serverless-plugin-cloudformation-cross-stack-references

构建并使用自定义镜像：

bash
docker build -t my-custom-serverless .
docker run --rm my-custom-serverless --version

持久化容器配置

对于频繁使用场景，可创建命名容器并保留配置：

bash
docker run -it --name serverless-dev -v $(pwd):/app -w /app serverless/serverless:latest /bin/sh

后续可通过docker start -ai serverless-dev重新进入容器。

注意事项

• 凭证安全：避免将云服务凭证直接嵌入镜像或提交到版本控制系统，建议通过环境变量或挂载文件动态注入。
• 版本兼容性：确保项目serverless.yml中指定的框架版本与镜像中安装的版本兼容。
• 资源限制：根据项目复杂度调整容器资源（如--memory、--cpus参数），避免因资源不足导致部署失败。