本文介绍如何在macOS、Linux和Windows操作系统内安装Serverless Devs。

安装Serverless Devs

说明 函数计算支持通过命令行工具安装Serverless Devs。
  1. 按需选择安装Serverless Devs的方式。
    • 通过包管理器安装
      按需选择以下方式安装Serverless Devs。
      • 通过npm包管理器安装。适用于已经预装npm的Windows、macOS和Linux操作系统。
        执行以下命令安装Serverless Devs。
        npm install @serverless-devs/s -g
        说明 Node.js需为10.X及以上版本。安装完成后,您可以执行node --version命令查看Node.js的版本。
      • 通过yarn包管理器安装。适用于已经预装yarn的Windows、macOS和Linux操作系统。
        执行以下命令安装Serverless Devs。
        yarn global add @serverless-devs/s
    • 通过脚本安装。适用于macOS、Linux操作系统。
      执行以下命令,安装Serverless Devs。
      curl -o- -L http://cli.so/install.sh | bash
  2. 执行以下命令,验证是否安装成功。
    s -v
    成功安装后的执行结果示例如下。
    @serverless-devs/s: 2.0.83, linux-x64, node-v14.17.4

(可选)安装Docker

如果您需要通过Serverless Devs的FC组件进行构建、本地运行调试函数和端云联调等操作,例如,执行s builds locals proxied等相关命令,需要在您的开发环境内安装Docker。安装Docker后,在需要使用Docker的场景下,Serverless Devs会自动新建Docker的容器并进行调试,您无需手动操作。

根据实际情况选择安装方式。

常见问题

当您出现以下类似问题时,按需选择以下方式解决:
  • 当Serverless Devs的版本比较低时,怎么升级Serverless Devs?

    您可以再次执行安装命令完成升级操作。具体信息,请参见安装Serverless Devs

  • 如果安装过程比较慢,您可以使用以下npm源进行安装,命令示例如下所示。
    npm --registry=https://registry.npmmirror.com install @serverless-devs/s -g
  • 当您在查看Serverless Devs版本时未及时生效,您可以按需选择以下方式解决:
    • 执行以下命令,设置环境变量。
      export PATH=$HOME/.s/node-v14.19.3-linux-x64/bin:$PATH
      说明 本命令中node-v14.19.3中版本号仅为示例,不同操作系统对应的该版本号可能不同,请以实际系统提示为准。
    • 打开一个新的终端。
  • 如果在Linux或macOS操作系统内安装Serverless Devs时报错,且报错信息为Error: EACCES: permission denied,按需选择解决方案:
    • 通过包管理器安装时出现此类报错,请执行以下命令。
      sudo npm install @serverless-devs/s -g
    • 通过脚本安装时出现此类报错,请执行以下命令。
      sudo curl -o- -L http://cli.so/install.sh | sudo bash
  • 在Linux或macOS操作系统内执行完安装命令后,如果执行Serverless Devs的相关命令时报错且报错信息为Command not found,按需选择解决方案:
    • 通过npm包管理器或脚本安装的Serverless Devs在使用相关命令出现此类报错时,需执行以下命令。
      ln -s $(npm root -g)/@serverless-devs/s/bin/s /usr/local/bin/s
    • 通过yarn包管理器安装的Serverless Devs在使用相关命令出现此类报错时,需执行以下命令。
      ln -s $(yarn global dir)/node_modules/@serverless-devs/s /usr/local/bin/