Funcraft 是函数计算提供的一种命令行工具,通过该工具,您可以便捷地管理函数计算、API 网关、日志服务等资源。通过一个资源配置文件 template.yml,Funcraft 即可协助您进行开发、构建、部署操作。本文提供安装 Funcraft 的三种方式。

步骤一:安装 Funcraft

您可通过以下三种方式安装 Funcraft:

  • 通过 npm 包管理安装:适用于已经预装了 npm 的 Windows、Mac、Linux 平台。
    1. 在 Windows、Mac、Linux 平台执行以下命令安装 Funcraft。

      $npm install @alicloud/fun -g
      说明
      • 如果在 Linux 或 MacOS 下执行该命令报错且报错信息为 Error: EACCES: permission denied,请执行命令 sudo npm install @alicloud/fun -g
      • 如果安装过程较慢,可以考虑使用淘宝 npm 源,安装命令为 npm --registry=https://registry.npm.taobao.org install @alicloud/fun -g
    2. 安装完成之后,在控制终端执行 fun 命令查看版本信息。

      $fun --version
  • 通过下载二进制安装:适用于 Windows、Mac、Linux 平台。流程如下:
    1. 打开 releases 页面,在最新的版本中选择一个对应平台的 release 压缩包链接,单击该链接即可直接下载。

    2. 下载到本地后,解压后,即可直接使用。

    针对不同平台的具体步骤如下:

    • Windows 平台
      1. 找到一个最新的发布版本(Release)下载 fun-*-win.exe.zip 文件(其中 * 表示版本号,如 v3.6.1)。
      2. 解压文件 fun-*-win.exe.zip 得到 fun-*.win.exe 文件,重命名为 fun.exe
      3. fun.exe 文件拷贝到系统 PATH 目录即可,例如 C:\WINDOWS\System32
      4. 打开命令终端,执行 fun.exe --version,查看返回版本号以验证是否安装成功。
    • Linux 平台

      打开 Terminal,在 Bash 或 Zsh 中依次执行以下命令。

      # 设置版本,请把版本更新为 https://github.com/aliyun/fun/releases 页面的最新版本
      $ FUN_VERISON="v3.6.1"
      
      # 下载到本地
      $ curl -o fun-linux.zip https://gosspublic.alicdn.com/fun/fun-$FUN_VERSION-linux.zip
        % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                       Dload  Upload   Total   Spent    Left  Speed
      100 32.2M  100 32.2M    0     0  2606k      0  0:00:12  0:00:12 --:--:-- 2376k
      
      # 解压 .zip 文件
      $ unzip fun-linux.zip
      Archive:  fun-v3.6.1-linux.zip
        inflating: fun-v3.6.1-linux
      
      # 移到 PATH 目录
      $ mv fun-*-linux /usr/local/bin/fun
      
      # 验证版本
      $ fun --version
      3.6.1       
    • MacOS 平台

      打开 Terminal,在 Bash 或 Zsh 中依次执行以下命令。

      # 设置版本,请把版本更新为 https://github.com/aliyun/fun/releases 页面的最新版本
      $ FUN_VERISON="v3.6.1"
      
      # 下载到本地
      $ curl -o fun-macos.zip https://gosspublic.alicdn.com/fun/fun-$FUN_VERSION-macos.zip
        % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                       Dload  Upload   Total   Spent    Left  Speed
      100 32.2M  100 32.2M    0     0  2606k      0  0:00:12  0:00:12 --:--:-- 2376k
      
      # 解压 zip 文件
      $ unzip fun-macos.zip
      Archive:  fun-v3.6.1-macos.zip
        inflating: fun-v3.6.1-macos
      
      # 移到 PATH 目录
      $ mv fun-*-macos /usr/local/bin/fun
      
      # 验证版本
      $ fun --version
      3.6.1          
  • 通过 Homebrew 包管理器安装:适用于 Mac 平台,且更符合 MacOS 开发者习惯。

    执行以下命令安装 Funcraft。

    brew tap vangie/formula
    brew install fun            

(可选)步骤二:安装 Docker

如果您需要通过 Funcraft 进行依赖编译和安装、本地运行调试,这些操作涉及到 fun installfun buildfun local 等命令的功能,那您需在开发环境中安装 Docker。

如何在其他平台上安装 Docker,请参见 Dockerhub

后续步骤

配置 Funcraft