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

步骤一：安装Funcraft工具

您可通过以下三种方式安装Funcraft工具：

  • 通过npm包管理安装：适用于已经预装了npm的Windows、MacOS、Linux的操作系统。

    1. 在Windows、MacOS、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 --version
  • 通过下载二进制安装：适用于Windows、MacOS、Linux操作系统。流程如下：

    1. 打开Releases页面，在最新的版本中选择一个对应系统的Release压缩包链接，单击该链接即可直接下载。

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

    针对不同操作系统的具体步骤如下：

    • Windows操作系统
      1. 在Releases页面，找到最新的发布版本并下载fun-*-win.exe.zip文件， * 表示版本号，例如v3.6.20。
      2. 解压文件fun-v3.6.20-win.exe.zip得到fun-v3.6.20.win.exe文件，重命名为fun.exe。
      3. 将fun.exe文件增添到系统变量Path目录即可，例如C:\WINDOWS\System32。
      4. 打开命令终端，执行fun.exe --version，查看返回版本号以验证是否安装成功。
    • Linux操作系统
      1. 打开Release页面，在Release页面查看Funcraft工具的最新版本，例如Release 3.6.20，表示最新版本为v3.6.20。
      2. 打开终端，例如Bash或Zsh，执行以下命令下载Funcraft工具。
        注意 如果Funcraft工具的最新版本有变化，请把执行命令中http://funcruft-release.oss-accelerate.aliyuncs.com/fun/fun-v3.6.20-linux.zip的v3.6.20更替为最新版本。 
        curl -o fun-linux.zip http://funcruft-release.oss-accelerate.aliyuncs.com/fun/fun-v3.6.20-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
      3. 执行以下命令，解压ZIP文件。
        unzip fun-linux.zip
        预期输出：
        Archive:  fun-v3.6.20-linux.zip
  inflating: fun-v3.6.20-linux
      4. 执行以下命令，将Funcraft工具的路径增添到环境变量PATH目录中。
        注意 如果Funcraft工具的最新版本有变化，请把执行命令中的v3.6.20更替为最新版本。 
        mv fun-v3.6.20-linux /usr/local/bin/fun
      5. 执行以下命令，验证Funcraft工具是否安装成功。
        fun --version
        预期输出：
        3.6.20
    • MacOS操作系统
      1. 打开Release页面，在Release页面查看Funcraft工具的最新版本，例如Release 3.6.20，表示最新版本为v3.6.20。
      2. 打开终端，例如Bash或Zsh，执行以下命令下载Funcraft工具。
        注意 如果Funcraft工具的最新版本有变化，请把执行命令中http://funcruft-release.oss-accelerate.aliyuncs.com/fun/fun-v3.6.20-macos.zip的v3.6.20更替为最新版本。 
        curl -o fun-macos.zip http://funcruft-release.oss-accelerate.aliyuncs.com/fun/fun-v3.6.20-macos.zip
        预期输出：
        % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 47.8M  100 47.8M    0     0   724k      0  0:01:07  0:01:07 --:--:-- 3727k
      3. 执行以下命令，解压ZIP文件。
        unzip fun-macos.zip
        预期输出：
        Archive:  fun-macos.zip
  inflating: fun-v3.6.20-macos
      4. 执行以下命令，将Funcraft工具的路径增添到环境变量PATH目录中。
        注意 如果Funcraft工具的最新版本有变化，请把执行命令中的v3.6.20更替为最新版本。 
        mv fun-v3.6.20-macos /usr/local/bin/fun
      5. 执行以下命令，验证Funcraft工具是否安装成功。
        fun --version
        预期输出：
        3.6.20
  • 通过Homebrew包管理器安装：适用于MacOS操作系统，且更符合MacOS开发者习惯。

    执行以下命令安装Funcraft工具。

    brew tap vangie/formula
brew install fun

（可选）步骤二：安装Docker

如果您需要通过Funcraft工具进行依赖编译和安装、本地运行调试，因为这些操作涉及到fun install、fun build、fun local等命令的功能，所以您需在开发环境中安装Docker。

如果您需要在其他平台或体系结构上安装Docker，请参见Dockerhub。

（可选）步骤三：配置Docker镜像加速器

安装好Docker之后，就可以使用Docker下载镜像了。如果遇到网络问题，推荐配置阿里云镜像加速器。

后续步骤

配置Funcraft