fcli 是 阿里云函数计算 的命令行工具,可以便捷的管理函数计算中的资源。目前 fcli 已经在 Github 上开源,诚挚的欢迎各位开源爱好者来为函数计算工具 fcli 贡献代码,使函数计算工具 fcli 更加强大,为用户带来更加友好的体验。
Github 地址:https://github.com/aliyun/fcli
fcli 使用指南
想要使用 fcli,只需要在 aliyun/fcli Releases 中下载对应操作系统的版本并解压安装,在命令行中使用即可。凭借 fcli 可以很方便的在本地管理函数计算中的资源或 invoke function,快速看到效果。
$ fcli
fcli: function compute command line tools
Usage:
fcli [flags]
fcli [command]
Available Commands:
alias alias related operation
config Configure the fcli
function function related operation
help Help about any command
service service related operation
shell interactive shell
sls sls related operation
trigger trigger related operation
version fcli version information
Flags:
-h, --help help for fcli
Use "fcli [command] --help" for more information about a command.
$ fcli service
service related operation
Usage:
fcli service [flags]
fcli service [command]
Aliases:
service, s
Available Commands:
create create service
delete Delete service
get Get the information of service
list List services of the current account
update update service
version service version related operation
Flags:
--help Print Usage (default true)
Use "fcli service [command] --help" for more information about a command.
通过 fcli 的 shell
子命令,可以进入交互模式
$ fcli shell
Welcome to the function compute world. Have fun!
>>> ls
demo
>>>
更加详细的使用方法,请见 函数计算工具 fcli 帮助文档
如何贡献代码
开发环境配置
1. 安装并配置 Golang 开发环境
根据 官方文档 安装并设置环境变量,主要是设置好 $GOPATH
环境变量。
2. Fork Repository
- 在 aliyun/fcli 项目中,点击
fork
,将项目 fork 到个人仓库 - 在本地
$GOPATH/src
目录下,创建github.com/aliyun
目录 cd ${GOPATH}/src/github.com/aliyun
git clone https://github.com/个人账号/fcli.git
3. 安装 glide 包管理器
$ go get github.com/Masterminds/glide
$ go install github.com/Masterminds/glide
4. 安装依赖
在项目根目录下,执行 glide i -v
进行依赖安装
提交 pull request
1. 将修改 push 到个人账号里的本地仓库
2. 发起 pull request 请求
在 pull request 请求的 comment 中,写明此次修改的内容,并添加此次修改的命令交互示例。
假设此次修改设置到 service list 子命令
- fcli service
$ fcli service
service related operation
Usage:
fcli service [flags]
fcli service [command]
Aliases:
service, s
Available Commands:
create create service
delete Delete service
get Get the information of service
list List services of the current account
update update service
version service version related operation
Flags:
--help Print Usage (default true)
Use "fcli service [command] --help" for more information about a command.
- fcli service list --help
william:fcli zechen$ go run main.go service list --help
List services of the current account
Usage:
fcli service list [option] [flags]
Aliases:
list, l
Flags:
--help list functions
-l, --limit int32 the max number of the returned services (default 100)
--name-only display service name only (default true)
-t, --next-token string continue listing the functions from the previous point
-p, --prefix string list the services whose names contain the specified prefix
-k, --start-key string start key is where you want to start listing from
- fcli service list
$ fcli service list
{
"Services": [
"demo"
],
"NextToken": null
}
我们鼓励将此次修改涉及的命令交互,展现的越详细越好。(还可以测试此次修改影响到的命令的各种参数)
版本号说明
fcli 在开源后使用 主版本号.次版本号.修订号
的版本格式
关于版本格式,可以参考 Semantic Versioning