alibaba / funcraft

(have) Fun with Serverless(API Gateway & Function Compute)

全新的Serverless应用全生命周期管理工具：Serverless Devs

感谢您长期对Funcraft的关注和支持，随着时间的发展，我们逐渐的发现Funcraft在很多端到端的能力上以及可拓展性上面是比较差的，很难满足日后Serverless架构的飞速发展步伐。所以我们大胆尝试，勇敢创建，推出了全新的Serverless开发者工具：Serverless Devs，通过Serverless Devs你可以非常方便的进行应用的开发、部署、调试。

• 关于Serverless Devs下的FC组件支持的功能，可以参考命令文档
• 关于Funcraft和Serverless Devs的对比，可以参考对比文档
• 关于Funcraft如何快速迁移到Serverless，可以参考迁移方法

也感谢您对阿里云函数计算团队的关注，欢迎和我们一起快速开始Serverless Devs之旅

---

Funcraft

(have)Fun with Serverless

English

Fun 是一个用于支持 Serverless 应用部署的工具，能帮助您便捷地管理函数计算、API 网关、日志服务等资源。它通过一个资源配置文件（template.yml），协助您进行开发、构建、部署操作。

如果你想使用旧版本的语法，请参考.

开始使用

Fun 作为一个命令行工具，内置了多个子命令，比如 config、local、deploy 等。

其中，config 子命令可以用来配置 fun，local 子命令可以用来本地运行调试函数，deploy 子命令可以将资源发布到线上。

为了让您尽快上手，我们准备了一系列教程：

• 安装教程：介绍了如何在 Mac、Linux 或者 Windows 上安装 Fun。

• 快速开始：通过一个简单的示例介绍了 Fun 的基本用法。

• Fun 规范文档: 详细介绍了 Fun 规范文档的细节。

• Fun 基本功能介绍：

  • Fun Config 介绍: 介绍如何进行 Fun 工具的配置。
  • Fun Init 介绍: 介绍如何使用 fun init 命令快速创建函数计算应用。
  • Fun Local 介绍: 介绍如何使用 fun local 进行函数的本地运行、调试。
  • Fun Install 介绍: fun install 是 fun 工具的一个子命令，用于安装 pip 和 apt 依赖，提供了命令行接口和 Funfile 描述文件两种形式。
  • Fun Build 介绍: 介绍了如何使用 fun build 命令完成编译型 runtime 比如 java 函数的构建。
  • Fun Nas 介绍: 介绍如何通过 fun nas 管理 nas 服务上的文件以及上传本地文件到 nas 服务。
  • Fun Deploy 介绍: 介绍如何通过 fun deploy 命令部署函数。

• 深度集成 Fun 的工具：

  • Aliyun Serverless VSCode Extension
  • FC WebIDE
  • Cloud Toolkit

• 系列文章：

  • 语法校验：Fun 提供了比较强大的语法校验功能，并通过精准的报错信息，让用户可以方便的将其修正。
    • 开发函数计算的正确姿势 —— Fun validate 语法校验排错指南：介绍了根据报错信息修正 template.yml 中的错误语法描述。
  • 自定义模板：关于如何使用 fun init 快速构建项目的文章。
    • 开发函数计算的正确姿势 —— 使用 Fun Init 初始化项目：介绍了 fun init 的基本用法。
    • Fun Init 自定义模板：介绍了如何开发 fun init 模板。
    • 第三方模板: 第三方模板，可以直接通过 fun init [repo] 的方式快速初始化一个项目。
      • puppeteer 模板项目：基于 puppeteer 的部署在函数计算上的截图服务。
      • 函数计算 R 语言模板项目：R 语言的模板项目，可以直接使用。
      • 开发函数计算的正确姿势——支持 ES6 语法和 webpack 压缩：帮助快速搭建一个函数计算 nodejs 项目骨架，支持 es6 代码编译成 es5。
      • 函数计算实现 oss 上传较小 zip 压缩文件的自动解压：快速搭建 oss 上传较小 zip 压缩文件自动解压（简单法）的模板项目。
      • 函数计算实现 oss 上传较大 zip 压缩文件的自动解压：快速搭建 oss 上传超大 zip 压缩文件自动解压（流式法）的模板项目。
      • 函数计算 TensorFlow CharRNN 五言绝句古诗模板：介绍把一个 TensorFlow CharRNN 训练的自动写五言绝句古诗的模型部署到函数计算。
      • 函数计算 selenium chrome java 模板项目：一个使用 brotli 算法压缩的 selenium chrome java 模板项目。
      • 函数计算 couchbase 模板项目：该项目模板是一个在阿里云函数计算平台 nodejs8 环境下安装并配置 couchbase 的模板项目。
      • express 项目接入函数计算：通过该模板，可以快速将 express 项目接入函数计算。
      • nextjs 应用接入到函数计算：提供了一个 fun 模块，通过该模板，三分钟就可以让 next.js 应用在函数计算中运行起来。
      • es6 代码编译成 es5 项目模板：提供一个 fun 模板，通过 webpack 将 es6 代码编译成 es5，并且剪切打包压缩成一个 js 文件，然后将该 js 文件上传到函数计算中运行。
      • 函数计算狗和猫图像分类模版项目：轻松搭建一个可以实现狗和猫图像分类器的深度学习模版项目。
      • Serverless 微服务实践-移动应用包分发服务：提供一个基于函数计算 Serverless 架构的包分发服务模版项目。
  • 依赖安装：关于如何使用 fun install 快速安装函数依赖的文章。
    • 开发函数计算的正确姿势 —— 依赖安装方法一览：从用户需求的视角对安装依赖的方式进行简单分类，以便于用户可以根据自己的需求，寻找到正确的解决方法。
    • 开发函数计算的正确姿势——使用交互模式安装依赖：介绍了 Fun 使用交互模式安装依赖，除了支持交互模式，沿用了指定 runtime 启动 sbox，也实现了 fun 风格的指定函数启动 sbox，更加便利。
    • Funfile 功能介绍：介绍了使用 Funfile 构造函数计算的交付产物。Funfile 中包含了一系列的命令，Fun 会忠实地执行这些步骤，最终产出“交付产物”。
    • 开发函数计算的正确姿势 —— 安装第三方依赖：介绍了 fun install 的基本用法。
    • 函数运行环境系统动态链接库版本太低？函数计算 fun 神助力分忧解难：介绍了如何利用 fun install，升级系统动态链接库。
    • install 原理介绍：fun install 功能推出之前推荐的方法，现在更推荐优先使用 fun install。下面的文章，可以作为了解 install 的原理，以便更好的使用 fun install。
      • 函数计算安装依赖库方法小结：总结了各个语言依赖安装的方法。
      • 函数计算 Python 连接 SQL Server 小结：介绍了如何利用 fc-docker 安装 pymssql 库。该文章介绍的思路，与 fun install 的底层实现思路是类似的。
      • 手把手教您将 libreoffice 移植到函数计算平台：介绍了如何利用 fc-docker 将 libreoffice 移植到函数计算。
  • 源码编译：关于如何使用 fun build 编译 java 等编译型语言函数代码的文章。
    • 开发函数计算的正确姿势 —— 使用 Fun Build 构建函数：介绍了使用 Fun Build 实现从源码到交付产物的构建过程。
  • 本地运行与调试：关于如何本地运行、调试函数，以及介绍排查 bug 技巧的系列文章。
    • 开发函数计算的正确姿势 —— 使用 Fun Local 本地运行与调试：介绍了 Fun Local 基本用法。
    • 开发函数计算的正确姿势 —— Http Trigger 本地运行调试: 介绍了如何使用 Fun Local 在本地运行、单步调试配置了 Http Trigger 的函数。
    • 开发函数计算的正确姿势 —— 本地运行、调试、发布 NAS 函数: 介绍了如何在本地运行、单步调试配置了 NAS 服务的函数。
    • 开发函数计算的正确姿势 —— Api 本地运行调试: 介绍了如何在通过 API 在本地运行、单步调试函数。
  • 部署：关于如何快速部署云服务的文章。
    • Fun Package 功能介绍：介绍了如何使用 Fun Package 将代码、编译产物、静态资源等本地资源上传到 OSS。
    • 开发函数计算的正确姿势 —— 部署 API 网关：介绍了如何部署 API 网关 + 函数计算应用。
    • 开发函数计算的正确姿势 —— OSS 触发器：介绍了如何部署 OSS 触发器 + 函数计算应用。
    • 开发函数计算的正确姿势 —— CDN 触发器：介绍了如何部署 CDN 触发器 + 函数计算应用。
    • 开发函数计算的正确姿势 —— 使用 ROS 进行资源编排：介绍了如何将资源通过 ROS 的方式进行部署。
    • 开发函数计算的正确姿势 —— 使用 Fun NAS 管理 NAS 资源：介绍了如何使用 Fun NAS 管理 NAS 文件以及上传本地文件到 NAS。
    • 开发函数计算的正确姿势 —— Fun 自动化 NAS 配置：介绍了 Fun 自动化 NAS 配置, 可以极大的减少了用户配置 NAS 服务与函数计算的步骤。
  • 实战：关于如何利用 init、local、install、deploy 等命令，快速开发一款 Serverless 应用的文章。
    • 开发函数计算的正确姿势 —— 爬虫: 通过一个实战场景，介绍了如何利用 Fun 工具从头开始开发一个 Serverless 应用。
    • 开发函数计算的正确姿势 —— 排查超时问题: 从一个 bug 出发，介绍了各种排查问题的技巧。
    • 一元建站-基于函数计算 + wordpress 构建 serverless 网站: 本文旨在通过快速部署一个 wordpress 网站到阿里云函数计算平台，来展示 serverless web 新的开发模式。
    • 开发函数计算的正确姿势——网页截图服务：介绍了如何利用函数计算快速开发网页截图服务。
    • 五分钟教你如何用函数计算部署钉钉群发机器人：介绍了如何利用函数计算快速搭建钉钉群发机器人。
    • 五分钟上线——函数计算 Word 转 PDF 云服务：介绍了如何将 libreoffice 迁移到函数计算，并进行 word 到 pdf 的转换。
    • 用函数计算搭建微服务——云客服访客名片：介绍了如何利用函数计算搭建云客服访客名片微服务。
    • Serverless 实战 —— 快速开发一个分布式 Puppeteer 网页截图服务：介绍了如何在函数计算中使用 puppeteer。
    • 函数计算部署机器学习遇到的问题和解法：介绍了机器学习部署到函数计算时可能会遇到的一些问题以及相关问的解法。
    • 开发函数计算的正确姿势——借助 Ghostscript 将 PDF 转换成 JPG：介绍了使用函数计算并借助 Ghostscript 进行 word 到 pdf 的转换。

• 常见问题与解答: 使用 Fun 时的常见问题与解答。

• 更多示例

反馈

如您在使用中遇到问题，可以在这里反馈 https://github.com/aliyun/fun/issues

参考

• 以函数计算作为 API 网关后端服务
• 函数计算
• API Gateway
• Fun 发布 2.0 新版本啦
• 函数计算工具链新成员 —— Fun Local 发布啦
• 三十分钟快速搭建 serverless 网盘服务
• Fc Docker

开源许可

The MIT License

funcraft's Issues

环境变量用 fun deploy 后会丢失

通过文档的方法，增加了 .env 保存了环境变量，但是fun deploy 后没有生效

fun deploy failed, but no error message

There was a problem, but no error was reported

希望可以在 faas.yml 中可以设置API网关的认证方式

希望可以在 faas.yml 中可以设置API网关的认证方式，

1. 比如设置为 OpenID Connect
2. 并设置 OpenID Connect下的两种类型（认证API，业务API）
3. 设置 OpenID Connect模式 下的 token

https://github.com/aliyun/fun/blob/5b3f14a62273c7ce30b2dc6c56a02141b8a01f77/lib/commands/deploy.js#L193

InactiveError问题

只是试一下hello world例子 API Gateway 设置却失败 到底是什么问题？

希望增加一个在 faas.yml 中给API网关设置了请求入参信息，后端服务参数，常量参数，自定义系统参数等信息的示例

希望增加一个在 faas.yml 中给API网关设置了请求入参信息，后端服务参数，常量参数，自定义系统参数等信息的示例

看现在应该是支持的，但是不知道具体格式是啥

https://github.com/aliyun/fun/blob/5b3f14a62273c7ce30b2dc6c56a02141b8a01f77/lib/commands/deploy.js#L201-L204

上传code的zip包的时候一直提示tomeout(10000)

RequestTimeoutError: PUT http://1634907079716801.cn-shanghai.fc.aliyuncs.com/2016-08-15/services/demo/functions/helloworld2 timeout(10000).
 PUT http://1634907079716801.cn-shanghai.fc.aliyuncs.com/2016-08-15/services/demo/functions/helloworld2 failed.
    at Timeout.setTimeout [as _onTimeout] (/Users/niko/workspace/prac-aliyun/func/node_modules/httpx/lib/index.js:110:17)
    at ontimeout (timers.js:469:11)
    at tryOnTimeout (timers.js:304:5)
    at Timer.listOnTimeout (timers.js:264:5)
npm ERR! code ELIFECYCLE
npm ERR! errno 255
npm ERR! func@1.0.0 deploy.test: `DEBUG=* fun deploy TEST`
npm ERR! Exit status 255
npm ERR! 
npm ERR! Failed at the func@1.0.0 deploy.test script.
npm ERR! This is probably not a problem with npm. There is likely additional logging output above.

npm ERR! A complete log of this run can be found in:

package.json

{
  "name": "func",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "deploy.test": "DEBUG=* fun deploy TEST"
  },
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "@alicloud/fun": "^1.4.0"
  },
  "dependencies": {
    "tablestore": "^4.0.10"
  }
}

如果不上传zip，把dependencies去掉，是可以deploy成功的。

哪里出了问题？

支持定义多个table store的表格

如果像下面这样同时声明多个table，fun的语法检查会报错。

  my-table-store:
    Type: 'Aliyun::Serverless::TableStore'
    Properties:
      ClusterType: HYBRID
      Description: dingtalk events
    bpm_raw:
      Type: 'Aliyun::Serverless::TableStore::Table'
      Properties:
        PrimaryKeyList:
          - Name: processInstanceId
            Type: STRING
    approvals:
      Type: 'Aliyun::Serverless::TableStore::Table'
      Properties:
      PrimaryKeyList:
        - Name: createdTime
          Type: LONG
        - Name: userId
          Type: STRING
        - Name: processInstanceId
          Type: STRING

api 网关的配置需要考虑用户大小写配置的情况

比如如果用户使用了 RequestProtocol 而不是 requestProtocol，配置的值无效（会使用默认的 http）

fun deploy失败率超高

最近运行fun deploy的时候经常在第一个函数打包的时候就停止退出，偶尔会成功。
不知道是怎么回事，请问哪里可以看到具体的log信息？

mymbp:capi sense$ fun deploy
Waiting for service capiFunctions to be deployed...
	Waiting for function refreshAccessToken to be deployed...
		Waiting for packaging function refreshAccessToken code...

希望可以在 faas.yml 中把API网关设置为 PRIVATE

希望可以在 faas.yml 中把API网关设置为 PRIVATE，看代码目前是写死的
https://github.com/aliyun/fun/blob/5b3f14a62273c7ce30b2dc6c56a02141b8a01f77/lib/commands/deploy.js#L192

工具时而报错时而成功

faas.yml 目前还不支持添加日志服务权限吗？

https://github.com/aliyun/fun/blob/5b3f14a62273c7ce30b2dc6c56a02141b8a01f77/lib/commands/deploy.js#L98-L150

看了下代码，涉及到 ram 的就这一段，看起来像是只为 api gateway固定写的。

另外问一下，https://github.com/aliyun/serverless-aliyun-function-compute 这个是另外一个组在维护吗？这个也尝试过，和 fun 功能上有交集，但内容更丰富些，当然也有很多地方不完善的。。头疼

spec文档完善Api/tablestore详细配置说明

Api网关在spec文档过于简单，很多配置项没有列出，只能靠已有示例猜测。

另外function可以指定超时（比如10s），而gateway默认超时是3s，如果不能指定为比function超时配置更长的时间显然是不合理的。但是spec没有文档描述相关属性如何设置。

OTS表名定义需要支持_字符前缀

OTS原始API中支持表名_字符前缀，但是FUN的SAM配置文件中不支持，导致老项目迁移到FUN上部署失败。修改方法建议：node_modules/@alicloud/fun/lib/validate/schema/ots-resource.js文件中类似如下修改。

希望，template文件里可以配置 网关的自定义系统参数

测试fun deploy但始终报错 TypeError: Data must be a string or a buffer

hi all,

在参照官方文档执行 fun deploy 时遇到以下错误

bogon:fun_test senseluo$ fun deploy
Function compute(cn-shanghai):
  service fc ok.
TypeError: Data must be a string or a buffer
    at Hash.update (crypto.js:99:16)
    at Object.md5 (/Users/senseluo/.nvm/versions/node/v8.10.0/lib/node_modules/@alicloud/fun/node_modules/kitx/lib/index.js:49:12)
    at buildDeps (/Users/senseluo/.nvm/versions/node/v8.10.0/lib/node_modules/@alicloud/fun/lib/deps.js:225:23)
    at <anonymous>
    at process._tickCallback (internal/process/next_tick.js:188:7)

不知道是不是一个bug，我的代码在 https://github.com/senseluo/aliyun_fun_demo
（其中的faas中id/key/secret已替换成假的）

谢谢~

Event事件源是否支持指定Api gateway

在spec文档中，事件源类型清单中并没有Api网关，也没有详细用法。

但在如下图的地方又说支持指定Api，

是否Event支持指定Api网关？是的话，可否在事件源清单中补充上详细用法？

在实际使用中，我发现如果指定了Event是Http，即使定义了Api网关，网关转发请求的时候会报如下错误。

exception: http invoke FC error,requestId=9EE0020F-980D-4EB1-B5F4-2119CDC4CDE9,result={"ErrorCode":"InvalidArgument","ErrorMessage":"Function with http trigger(name: http-test) can only be invoked with http trigger URL"}java.lang.Exception

弃坑了。

增加HTTPS的支持

目前API网关的网络协议好像是写死的，希望增加支持，比如可以配置HTTPS
https://github.com/aliyun/fun/blob/5b3f14a62273c7ce30b2dc6c56a02141b8a01f77/lib/commands/deploy.js#L196

能否设置部署后的node版本

目前默认部署后使用的是node6.0，导致不能使用async/await

example 运行报错

根据 README 配置上 credentials 和 role， fun deploy 报错

fun local invoke支持HTTP触发器调试

使用 fun local invoke 时，无法对 HTTP 触发器进行调试

当使用CodeUri指定代码目录的时候，能否排除一些文件/文件夹

开发的时候会有一些本地运行相关的文件，不希望打包上传，能否指定规则排除呢？

Can't deploy function

Trying to deploy function, but have error. What can be problem?

-> fun deploy
using region: ap-southeast-1
using accountId: *****
using accessKeyId: *****
using timeout: 15

Waiting for service video-transcoding-wrapper to be deployed...
FCAccessDeniedError: GET /services/video-transcoding-wrapper failed with 403. requestid: c39a5ca9-c896-ac44-fe6a-230ab01bfc87, message: The service or function doesn't belong to you..
at Client.request (/Users/*****/aliyun-nodejs/node_modules/@alicloud/fc2/lib/client.js:156:19)
at process._tickCallback (internal/process/next_tick.js:68:7)

希望fun的swagger语法与阿里云API网关的swagger语法保持一致

问题描述：目前fun的swagger语法与阿里云API网关的swagger语法不一致，使用不方便。
期望结果：希望能用统一语法格式

参考信息：阿里云网关Swagger的语法：https://help.aliyun.com/document_detail/88956.html

Feature: spec支持指定tablestore以及table属性

创建tablestore的时候可以指定绑定的vpc以及网络类型，希望spec支持。

https://help.aliyun.com/document_detail/55213.html?spm=a2c4g.11186623.6.566.316c4002ViYQ4N

tablestore创建table的时候支持指定文档中的属性，希望通过spec可以指定。

https://help.aliyun.com/document_detail/89939.html?spm=a2c4g.11186623.2.11.316c4002ViYQ4N#concept-z5t-jmj-bfb

请允许设置API 网关的 入参请求模式

我们没必要把所有的入参都配置好，这是项可选的工作，配置了能自动生成文档，没配置请至少 允许我们使用 入参透传模式，而不是入参映射，目前我没找到类似的设置。我起初纳闷为什么我的参数被吃了，折腾了一会才发现是入参映射造成的，而且每次 deploy 都会重置为 入参映射。

是否有办法设置为入参透传，哪怕是临时的解决方案也行，不想自己去读代码并修改它、

私有仓库的构建支持。

当用户有自己私有模块仓库时，如何在远端环境进行 dependencies build。

请问怎么在template.yml文件中制定函数版本？

fun undeploy

This is more a feature request. It would be nice to have a command like fun undeploy that basically does the opposite of fun deploy. Is a feature like that in plan?

java8 local fun debug

use example got

FC Invoke Start RequestId: 3db83578-38ae-4eb1-9b70-17f3e30ba375
handle user request is example.App::handleRequest
cache is null!
2018-12-10 14:35:00.241 [ERROR] {
"errorMessage" : "Cannot find the class example.App in your zip file and please make sure it is in the right path 'example/App'",
"errorType" : "java.lang.ClassNotFoundException",
"errorCause" : "example.App",
"stackTrace" : [ "java.net.URLClassLoader.findClass(URLClassLoader.java:381)", "java.lang.ClassLoader.loadClass(ClassLoader.java:424)", "java.lang.ClassLoader.loadClass(ClassLoader.java:357)", "java.lang.Class.forName0(Native Method)", "java.lang.Class.forName(Class.java:348)" ]
}
{
"errorMessage" : "Cannot find the class example.App in your zip file and please make sure it is in the right path 'example/App'",
"errorType" : "java.lang.ClassNotFoundException",
"errorCause" : "example.App",
"stackTrace" : [ "java.net.URLClassLoader.findClass(URLClassLoader.java:381)", "java.lang.ClassLoader.loadClass(ClassLoader.java:424)", "java.lang.ClassLoader.loadClass(ClassLoader.java:ng.ClassLoader.loadClass(ClassLoader.java:357)", "java.lang.Class.forName0(Native Method)", "java.lang.Class.forName(Class.java:348)" ]
}FC Invoke End RequestId: 3db83578-38ae-4eb1-9b70-17f3e30ba375

RequestId: 3db83578-38ae-4eb1-9b70-17f3e30ba375 Billed Duration: 1849 ms Memory Size: 1980 MB Max Memory Used: 41 MB

PS D:\Aliyun\fun\examples\local> D:\Aliyun\fun-v2.7.0-win-x64.exe\fun local invoke -d 3000 java8
skip pulling image aliyunfc/runtime-java8:1.1.0...

FC Invoke Start RequestId: fc2dd22b-d035-4bc0-9fa3-c18e908a455e
handle user request is example.App::handleRequest
cache is null!
2018-12-10 14:42:22.219 [ERROR] {
"errorMessage" : "Cannot find the class example.App in your zip file and please make sure it is in the right path 'example/App'",
"errorType" : "java.lang.ClassNotFoundException",
"errorCause" : "example.App",
"stackTrace" : [ "java.net.URLClassLoader.findClass(URLClassLoader.java:381)", "java.lang.ClassLoader.loadClass(ClassLoader.java:424)", "java.lang.ClassLoader.loadClass(ClassLoader.java:357)", "java.lang.Class.forName0(Native Method)", "java.lang.Class.forName(Class.java:348)" ]
}
{
"errorMessage" : "Cannot find the class example.App in your zip file and please make sure it is in the right path 'example/App'",
"errorType" : "java.lang.ClassNotFoundException",
"errorCause" : "example.App",
"stackTrace" : [ "java.net.URLClassLoader.findClass(URLClassLoader.java:381)", "java.lang.ClassLoader.loadClass(ClassLoader.java:424)", "java.lang.ClassLoader.loadClass(ClassLoader.java:357)", "java.lang.Class.forName0(Native Method)", "java.lang.Class.forName(Class.java:348)" ]
}FC Invoke End RequestId: fc2dd22b-d035-4bc0-9fa3-c18e908a455e

Env: windows 64 fun 2.7

请问最新版是1.6.3吗？无法运行fun config和fun deploy

最新的文档中没有提及faas.yml，只有template.yml
所以没有搞懂是文档没更新还是代码没更新~~

$ fun deploy
Current folder not a Faas project
The folder must contains faas.yml or faas.yaml

增加 keyId 和 公钥的设置

https://github.com/aliyun/fun/blob/22cce613ea1a7c21e1ba47bb306392496319dedf/lib/commands/deploy.js#L237

这个地方最好可以设置 keyId 和 公钥：
https://help.aliyun.com/document_detail/48295.html

不然每次用 fun deploy 之后，还要手动去添加 keyId 和公钥。

如何在yaml里设置VPC？How to configure VPC in yaml?

如何在yaml里设置VPC？How to configure VPC in yaml?

需要支持API网关的常量参数配置

fun工具需求在yml文件中支持API网关这个参数配置

具体修改方法参考：fun/lib/deploy/deploy-support.js文件 makeApi函数

需要在yml文件中支持x-aliyun-apigateway-constant-paramters参数配置。
API网关的接口文档不正确，截图的参数是看线上ajax请求查到的实际参数。

能否提供一个openid connect配置公钥的模版？

想要的效果是，本地随机生成 keyid 和用 ssh-keygen 生成 RSA 公私钥，直接在 template.yml 中配置好就能一块儿上传并且生效，也就是如何在 template.yml 中配置获取授权API。

我看了 swagger 的文档，其中也没看到具体的说明。在本项目的examples/openid_connect中只有配置业务接口的示例。

文档步骤与完整示例不符

文档步骤中使用的faas.yaml，完整示例中使用template.yml，且语法不太一致。建议统一。

默认透传后端Content-Type

https://github.com/aliyun/fun/blob/22cce613ea1a7c21e1ba47bb306392496319dedf/lib/commands/deploy.js#L230

这里的 'TEXT'， 希望改成： 'PASSTHROUGH'， 表示默认透传后端Content-Type。

API和函数部署之后，能够使用，但在控制台里看不到

hello world 这个例子，部署成功（没有报错），也能够用浏览器和curl访问
但在控制台的API网关和函数计算里，找不到函数和API

template.yml如何定义api开启https或WEBSOCKET？

类似

   DefinitionBody:
        '/': # request path
          get: # http method
            x-aliyun-apigateway-api-name: hello_get # api name
            x-aliyun-apigateway-fc:
              arn: acs:fc:::services/${capi.Arn}/functions/${helloworld.Arn}/
            x-aliyun-apigateway-visibility: PUBLIC

能给一个更多参数的示例吗？
谢谢~

用 fun deploy 打包的二进制可执行文件会提示 Permission denied

template.yml 格式的打包已经在 spec_for_ros 分支修复了，faas.yml 依然存在。请修复一下 master 上的这个打包权限问题。还是目录也会存在权限问题，请一并修复。

重点关注

https://github.com/aliyun/fun/blob/spec_for_ros/lib/zip.js#L78
https://github.com/aliyun/fun/blob/spec_for_ros/lib/zip.js#L86

关于java example的问题

在demoREADME中给的配置文件例子是fass.yml，而示例代码只有template.yml。

这两种配置的关系是什么？工具fun推荐使用哪种配置？fass.yml推荐使用的话，哪里可以查看官方文档？

当 endpoint 设置成内网的时候，fun deploy 时报 api gateway 出错

> fun deploy
Waiting for service fc to be deployed...
	Waiting for function users to be deployed...
	function users deploy success
service fc deploy success

Waiting for api gateway HelloworldGroup to be deployed...
Error: getaddrinfo ENOTFOUND apigateway.cn-hangzhou-internal.aliyuncs.com apigateway.cn-hangzhou-internal.aliyuncs.com:80
    at errnoException (dns.js:50:10)
    at GetAddrInfoReqWrap.onlookup [as oncomplete] (dns.js:92:26)

fun help是提示命令吗？

请问如何做到上传到函数计算的同时自动安装打包依赖模块 我这里没有实现这个效果，如何将整个文件夹进行上传呢？

[需求]希望后续可以支持对单个资源的部署，如 fun deploy resourceName

hi all,

后续是否可以针对单个资源进行发布？

例如

fun deploy resourceName

目前执行fun deploy会把所有template.yml中的资源进行发布，
特别是当项目停滞一段时间后再继续开发，每次执行部署时内心略紧张，有点担心会搞坏现有的资源。

谢谢！

当依赖特别多的时候显示超时无法正常上传

RequestTimeoutError: PUT http://1925300965708640.cn-beijing.fc.aliyuncs.com/2016-08-15/services/fc/functions/helloworld timeout(60000).
PUT http://1925300965708640.cn-beijing.fc.aliyuncs.com/2016-08-15/services/fc/functions/helloworld failed.
at Timeout.setTimeout [as _onTimeout] (/usr/local/nodejs/node-v8.9.4-linux-x64/lib/node_modules/@alicloud/fun/node_modules/_httpx@2.1.2@httpx/lib/index.js:110:17)
at ontimeout (timers.js:475:11)
at tryOnTimeout (timers.js:310:5)
at Timer.listOnTimeout (timers.js:270:5)

Feature: 支持自动创建SLS project以及logstore

template.yml中定义的api gateway以及table store实例和table，fun可以自动创建。

而函数的logconfig中指定的SLS project和log store必须用户手动创建及授权。

希望fun可以自动根据配置创建SLS project和log store（如果没有的话）。当role是自动创建的时候，为其添加SLS读写权限。

运行脚本不能成功创建函数计算服务

当我是一个新用户时，运行脚本不能成功创建函数计算服务，显示“Account is inactive to this service”错误的信息。但是输入的账号ID、Access Key Id、Access Key Secret都是正确的。

脚本如下：
ROSTemplateFormatVersion: '2015-09-01' Transform: 'Aliyun::Serverless-2018-04-03' Resources: ygwww1-fc-local: Type: 'Aliyun::Serverless::Service' Properties: Description: 'youngget' LogConfig: Project: ygwww1-log Logstore: ygwww1-logstore-local ygwww1-fc-local: Type: 'Aliyun::Serverless::Function' Properties: Handler: index.handler Runtime: nodejs8 MemorySize: 128 CodeUri: './dist/target.zip' Timeout: 10

custom vars

Is there way to use custom vars like

custom:
  dataSetBucket: 'images-roaddamage' 
  listBucket: 'dataset-list'
  listKey: 'hk.json'
  resultBucket: 'hk-result'
  frontendBucket: 'hk-frontend'

?

FUN创建OTS表失败

对应的YAML文件示例为：
ROSTemplateFormatVersion: '2015-09-01'
Transform: 'Aliyun::Serverless-2018-04-03'
Resources:  
  xxxxxxx:
    Type: 'Aliyun::Serverless::TableStore'
    Properties:
      ClusterType: SSD
      Description: 'xxxxxx'
    __session__:
      Type: 'Aliyun::Serverless::TableStore::Table'
      Properties:
          PrimaryKeyList:
            - Name: id
              Type: STRING
    __user__:
      Type: 'Aliyun::Serverless::TableStore::Table'
      Properties:
          PrimaryKeyList:
            - Name: id
              Type: STRING
    __cache__:
      Type: 'Aliyun::Serverless::TableStore::Table'
      Properties:
          PrimaryKeyList:
            - Name: id
              Type: STRING