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

注意 本文介绍的内容后期将不再维护。如果您的函数计算资源是使用Funcraft管理的,建议您将资源迁移至Serverless Devs管理。

关于如何将函数计算的相关资源从Funcraft迁移到Serverless Devs进行管理的详细操作,请参见从Funcraft迁移到Serverless Devs

关于Serverless Devs的详细信息,请参见什么是Serverless Devs

关于如何安装Serverless Devs,请参见安装Serverless Devs

由此带来的不便,敬请谅解!

步骤一:安装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.npmmirror.com install @alicloud/fun -g
    2. 安装完成之后,执行以下命令查看版本信息。

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

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

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

    • Windows操作系统
      1. Releases页面,找到最新的发布版本并下载fun-*-win.exe.zip文件, * 表示版本号,例如v3.6.24。
      2. 解压文件fun-v3.6.24-win.exe.zip得到fun-v3.6.24.win.exe文件,重命名为fun.exe
      3. fun.exe文件增添到系统变量Path目录即可,例如C:\WINDOWS\System32
      4. 打开命令终端,执行fun.exe --version,查看返回版本号以验证是否安装成功。
    • Linux操作系统
      1. 打开Release页面,在Release页面查看Funcraft的最新版本,例如Release 3.6.24,表示最新版本为v3.6.24。
      2. 打开终端,例如Bash或Zsh,执行以下命令下载Funcraft。
        注意 如果Funcraft的最新版本有变化,请把执行命令中https://funcraft-release.oss-cn-hangzhou.aliyuncs.com/fun/fun-v3.6.24-linux.zipv3.6.24更替为最新版本。
        curl -o fun-linux.zip https://funcraft-release.oss-cn-hangzhou.aliyuncs.com/fun/fun-v3.6.24-linux.zip
        预期输出:
        % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                         Dload  Upload   Total   Spent    Left  Speed
        100 51.2M  100 51.2M    0     0  17.0M      0  0:00:03  0:00:03 --:--:-- 14.3M
      3. 执行以下命令,解压ZIP文件。
        unzip fun-linux.zip
        预期输出:
        Archive:  fun-linux.zip
          inflating: fun-v3.6.24-linux
      4. 执行以下命令,将Funcraft的路径增添到环境变量PATH目录中。
        注意 如果Funcraft的最新版本有变化,请把执行命令中的v3.6.24更替为最新版本。
        mv fun-v3.6.24-linux /usr/local/bin/fun
      5. 执行以下命令,验证Funcraft是否安装成功。
        fun --version
        预期输出:
        3.6.24
    • macOS操作系统
      1. 打开Release页面,在Release页面查看Funcraft的最新版本,例如Release 3.6.24,表示最新版本为v3.6.24。
      2. 打开终端,例如Bash或Zsh,执行以下命令下载Funcraft。
        注意 如果Funcraft的最新版本有变化,请把执行命令中https://funcraft-release.oss-cn-hangzhou.aliyuncs.com/fun/fun-v3.6.24-macos.zipv3.6.24更替为最新版本。
        curl -o fun-macos.zip https://funcraft-release.oss-cn-hangzhou.aliyuncs.com/fun/fun-v3.6.24-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.24-macos
      4. 执行以下命令,将Funcraft的路径增添到环境变量PATH目录中。
        注意 如果Funcraft的最新版本有变化,请把执行命令中的v3.6.24更替为最新版本。
        mv fun-v3.6.24-macos /usr/local/bin/fun
      5. 执行以下命令,验证Funcraft是否安装成功。
        fun --version
        预期输出:
        3.6.24

(可选)步骤二:安装Docker

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

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

(可选)步骤三:配置Docker镜像加速器

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

后续步骤

配置Funcraft