aligent/serverless 镜像文档

概述

aligent/serverless是一个用于运行serverless命令的Docker镜像，无需在本地安装Serverless CLI即可使用。该镜像已发布至Docker Hub，镜像地址为aligent/serverless。

核心功能

• 容器化运行Serverless CLI，避免本地环境配置冲突
• 支持AWS、Azure等云服务提供商的凭证挂载
• 可通过别名快速调用serverless命令
• 支持根据.nvmrc文件自动切换不同node版本的镜像

安装配置

基础别名配置

将以下内容添加到~/.bashrc或~/.zshrc文件中，以便快速运行镜像：

alias node-run='docker run --rm -it --volume ~/.aws:/home/node/.aws --volume ~/.azure:/home/node/.azure --volume ~/.npm:/home/node/.npm --volume "$PWD:/app" aligent/serverless'
alias serverless='node-run serverless'

添加后需重载配置文件，可运行. ~/.bashrc（或对应文件）或重启终端会话。

使用方法

基本使用

配置完成后，即可正常运行serverless命令。例如：

创建新项目：

serverless create --template aws-nodejs --path test-service

自动镜像切换

若需根据当前目录的.nvmrc文件自动切换不同node版本，可将以下函数添加到~/.bashrc或~/.zshrc中，并按如下更新node-run别名：

determine_serverless_image() {
    if [ -n "$ZSH_VERSION" ]; then 
        setopt local_options BASH_REMATCH # 用于ZSH兼容性
        setopt local_options KSH_ARRAYS # 用于ZSH兼容性
    fi

    DEFAULT_IMAGE='aligent/serverless:latest'
    NVM_RC=$(realpath .nvmrc)

    if [ -s "$NVM_RC" ]; then 
        NODE_VERSION=$(<"$NVM_RC")

        if [[ $NODE_VERSION =~ ^v?([0-9]+)(\.[0-9]+)?(\.[0-9]+)?$ ]]; then
            echo "aligent/serverless:latest-node${BASH_REMATCH[1]}"
            return 0
        fi
    fi

    echo $DEFAULT_IMAGE
    return 0
}

alias node-run='docker run --rm -it --volume ~/.aws:/home/node/.aws --volume ~/.azure:/home/node/.azure --volume ~/.npm:/home/node/.npm --volume $PWD:/app $(determine_serverless_image)'

使用场景

• 本地开发环境中快速使用Serverless CLI，避免版本冲突
• 团队协作时统一Serverless运行环境
• 需要在不同node版本间切换的Serverless项目开发