fun init
作为Funcraft的子命令用于指定应用模板,您可以使用函数计算提供的常用模板,也可以进行自定义应用模板,快速创建函数计算应用。本文介绍如何通过fun init
快速体验和开发函数计算的应用。
关于如何将函数计算的相关资源从Funcraft迁移到Serverless Devs进行管理的详细操作,请参见从Funcraft迁移到Serverless Devs。
关于Serverless Devs的详细信息,请参见什么是Serverless Devs。
由此带来的不便,敬请谅解!
功能介绍
fun init
的功能介绍。fun init --help
返回结果如下:Usage: fun init [options] [template]
Initialize a new project based on a template. A template can be a folder containing template metadata and boilerplate files, a name of a pre-built template, or a url that resolves to a template. You can find more information about template at https://yq.aliyun.com/articles/674364.
Options:
-o, --output-dir [path] Where to output the initialized app into (default: ".")
-n, --name [name] The name of your project to be generated as a folder (default: "")
-m, --merge [merge] Merge into the template.[yml|yaml] file if it already exist (default: false)
--no-input Disable prompting and accept default values defined template config
-V, --var [vars] Template variable
-h, --help display help for command
Examples:
$ fun init
$ fun init event-nodejs8
$ fun init foo/bar
$ fun init gh:foo/bar
$ fun init gl:foo/bar
$ fun init bb:foo/bar
$ fun init github:foo/bar
$ fun init gitlab:foo/bar
$ fun init bitbucket:foo/bar
$ fun init git+ssh://git@github.com/foo/bar.git
$ fun init hg+ssh://hg@bitbucket.org/bar/foo
$ fun init git@github.com:foo/bar.git
$ fun init https://github.com/foo/bar.git
$ fun init /path/foo/bar
$ fun init -n fun-app -V foo=bar /path/foo/bar
命令参数说明
参数 | 默认值 | 是否必填 | 描述 | 示例 |
---|---|---|---|---|
-o, --output-dir | . | 否 | 初始化的应用程序的输出目录。 |
|
-n, --name | fun-app | 否 | 应用程序所在文件夹的名称。 |
|
-m, --merge | false | 否 | 合并当前内容到YAML文件中。 |
|
--no-input | 无 | 否 | 禁用提示并接受默认值定义模板配置。
如果您不想被提示输入模板变量,您可以通过该选项跳过输入提示,直接使用模板变量的默认值。 |
|
-V, --var | 无 | 否 | 模板变量。模板中可能会有很多模板变量,在初始化模板的过程中,如果需要您填写某些模板的变量值,会提示您进行设置,您可以通过以下方式进行设置:
说明 选项格式:以等号分隔的键值对,键只能包含字母、数字和下划线(_),值可以是任意字符。
|
|
-h, --help | 无 | 否 | 打印使用说明。 |
|
获取应用模板
- 函数计算官方模板,包括:
- 离线模板:内嵌在Funcraft工具中的模板。
- 在线模板:通过模板名称来指定模板位置,在Funcraft内部会将其转换为GitHub地址。
- Git或Mercurial仓库模板:从相应仓库中获取应用模板。
- 本地文件系统路径模板:从本地获取应用模板。
- 自定义模板:从GitHub上获取已上传的自定义模板。
获取函数计算官方离线模板
获取函数计算官方在线模板
函数计算官方在线模板存放在GitHub中。
执行fun init <templates name>
即可获取在线应用模板。
获取Git或Mercurial仓库模板
user/repo
。您可以使用以下模板:
fun init foo/bar
fun init fun init gh:foo/bar/bar
fun init fun init gl:foo/barfoo/bar
fun init fun init bb:foo/bar/bar
fun fun init github:foo/barfoo/bar
fun fun init gitlab:foo/barfoo/bar
fun fun init bitbucket:foo/barfoo/bar
fun ifun init git+ssh://git@github.com/foo/bar.gitnit foo/bar
fun init hg+ssh://hg@bitbucket.org/bar/foo
fun init git@github.com:foo/bar.git
fun init https://github.com/foo/bar.git
fun init /path/foo/bar
fun init -n fun-app -V foo=bar /path/foo/bar
获取本地模板
获取自定义模板
如果现有的模板不能满足您的需求,您可以自定义模板,然后将模板上传到GitHub上。当您或其他人需要使用该模板时,可以从GitHub中获取该模板。