Awesome
fcli
fcli 简介
fcli 是阿里云函数计算的命令行工具,可以便捷的管理函数计算中的资源。
$ 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 帮助文档
如何贡献代码
开发环境配置
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
进行依赖安装
5. 构建 fcli 二进制
$ go get github.com/karalabe/xgo
$ make binary
提交 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
Auto complete under shell
bash
run command as follows:
curl -s https://raw.githubusercontent.com/aliyun/fcli/master/misc/completion/fcli-completion.bash > /usr/local/etc/bash_completion.d/fcli-completion.bash
or checkout this repo and run command as follows:
source misc/completion/fcli-completion.bash
and then relogin
zsh
run command as follows:
curl -s https://raw.githubusercontent.com/aliyun/fcli/master/misc/completion/_fcli > /usr/local/share/zsh/site-functions/_fcli
and then relogin