欢迎访问我的GitHub
https://github.com/zq2599/blog_demos
内容:所有原创文章分类和汇总,及配套源码,涉及Java、Docker、Kubernetes、DevOPS等;
本篇概览
- 本文是《OpenFaaS实战》系列的第四篇,经历了前三篇快节奏操作,咱们对OpenFaaS有了基本了解,至少部署和开发是轻车熟路,现在要放慢脚步夯实基本功,扫除知识盲点;
- 本篇目标是掌握template(模板)有关知识,包括以下内容:
- 基本命令
- 使用第三方模板
- 自己制作模板仓库
- 注意事项
- 从上面的概览可见,本篇内容不多但很基础很重要,接下来打开终端动手练习吧;
关于简化命令
如下所示,faas其实就是faas-cli的链接,因此,平时输入命令用faas更简单:
[root@node1 template]# ls -l /usr/local/bin/faaslrwxrwxrwx. 1 root root 23 11月 19 11:06 /usr/local/bin/faas -> /usr/local/bin/faas-cli
基本命令
- 获取所有官方模板:
faas template pull
执行完毕后,当前目录下出现名为template的文件夹,里面是所有官方模板
[root@node1 21]# lstemplate[root@node1 21]# cd template/[root@node1 template]# lscsharp dockerfile go java11 java11-vert-x node node12 php7 python python3 python3-debian ruby[root@node1 template]# cd ..[root@node1 21]# tree template/template/├── csharp│ ├── Dockerfile│ ├── function│ │ ├── Function.csproj│ │ └── FunctionHandler.cs│ ├── Program.cs│ ├── root.csproj│ └── template.yml├── dockerfile│ ├── function│ │ └── Dockerfile│ └── template.yml...
- 查看官方模板列表:
faas template store list
返回信息如下(太多了,省略部分):
NAME SOURCE DESCRIPTIONcsharp openfaas Classic C# templatedockerfile openfaas Classic Dockerfile templatego openfaas Classic Golang templatejava8 openfaas Java 8 templatejava11 openfaas Java 11 templaterust-http openfaas-incubator Rust HTTP templatebash-streaming openfaas-incubator Bash Streaming template...
- 查看当前目录下可用的模板:
faas new --list
终端显示:
[root@node1 21]# faas new --listLanguages available as templates:- csharp- dockerfile- go- java11- java11-vert-x- node- node12- php7- python- python3- python3-debian- ruby
- 有了模板,就能创建函数,如下命令创建名为java-function的函数:
faas-cli new --lang java11 java-function
成功后,修改此文件添加业务代码:./src/main/Handler.java
- 前面执行faas template store list查看的时候,注意每个模板的SOURCE字段,如果是openfaas-incubator,例如rust-http这个模板,要使用以下命令来下载(多了个前缀openfaas-incubator):
faas-cli template store pull openfaas-incubator/rust-http
以上是模板的基本操作,此刻您可能有疑问:那些都是官方模板,第三方的模板怎么获取?另外如果我想自己做模板给别人用,又该如何操作?这些问题,接下来逐个解答;
使用第三方模板
- 我在GitHub上做了个第三方模板仓库,来看如何使用,使用其他人的第三方模板都是这个套路;
- 所谓模板仓库,其本质还是普通的GitHub仓库,只是里面的内容要符合OpenFaaS的要求;
- 我的模板仓库地址是:https://github.com/zq2599/openfaas-templates ,如下图:
![bd6dfeb3b41e72e475c9fb541639bd43.png](https://i-blog.csdnimg.cn/blog_migrate/a7c51f738de783bba895daa0c252684e.jpeg)
- 下载上述模板仓库的命令(注意,找个干净的文件夹执行命令):
faas template pull https://github.com/zq2599/openfaas-templates
可见就是把仓库地址作为参数放在整个命令的末尾
- 控制台操作如下,可见下载了一个template目录,里面有两个模板:dockerfile和java11extend:
[root@node1 333]# faas template pull https://github.com/zq2599/openfaas-templatesFetch templates from repository: https://github.com/zq2599/openfaas-templates at master2020/11/22 11:19:53 Attempting to expand templates from https://github.com/zq2599/openfaas-templates2020/11/22 11:19:58 Fetched 2 template(s) : [dockerfile java11extend] from https://github.com/zq2599/openfaas-templates[root@node1 333]# lstemplate[root@node1 333]# tree template/template/├── dockerfile│ ├── function│ │ └── Dockerfile│ └── template.yml└── java11extend ├── build.gradle ├── Dockerfile ├── function │ ├── build.gradle │ ├── gradle │ │ └── wrapper │ │ ├── gradle-wrapper.jar │ │ └── gradle-wrapper.properties │ ├── gradlew │ ├── gradlew.bat │ ├── settings.gradle │ └── src │ ├── main │ │ └── java │ │ └── com │ │ └── openfaas │ │ └── function │ │ └── Handler.java │ └── test │ └── java │ └── HandlerTest.java ├── gradle │ └── wrapper │ ├── gradle-wrapper.jar │ └── gradle-wrapper.properties ├── README.md ├── settings.gradle └── template.yml16 directories, 17 files
- 执行faas new --list看有哪些模板,果然是GitHub仓库中的两个:
[root@node1 333]# faas new --listLanguages available as templates:- dockerfile- java11extend
- 使用模板创建函数:
faas-cli new java11extend-function --lang java11extend -p bolingcavalry
- 制作镜像:
faas-cli build -f ./java11extend-function.yml
控制台输出以下信息,提示镜像制作成功:
Step 29/30 : HEALTHCHECK --interval=5s CMD [ -e /tmp/.lock ] || exit 1 ---> Running in 6b68ca763980Removing intermediate container 6b68ca763980 ---> 50cea9002e9cStep 30/30 : CMD ["fwatchdog"] ---> Running in c2f87a87c8f4Removing intermediate container c2f87a87c8f4 ---> 8094a5064a20Successfully built 8094a5064a20Successfully tagged bolingcavalry/java11extend-function:latestImage: bolingcavalry/java11extend-function:latest built.[0] < Building java11extend-function done in 81.75s.[0] Worker done.Total build time: 81.76s
- 接下来将镜像推送到镜像仓库、部署函数、验证等操作请参考前文《OpenFaaS实战之二:函数入门 》,里面有详细的步骤,就不在本文中展开了,下面的图片证明此模板做出的函数可以正常部署和运行:
![daaa14c07b79837936ea22b909f74ba2.png](https://i-blog.csdnimg.cn/blog_migrate/dae88afa07920bc2652103d5c5f5fc2a.jpeg)
自己制作模板仓库
经历了前面的实战,对于如何制作模板仓库,相信您心中已经有了答案,这里简单小结一下需要遵守的原则:
- 在GitHub上有个公共仓库;
- 所有内容必须放在master分支;
- 仓库内要有名为template的文件夹;
- template文件夹里面,是每个模板自己的文件夹,如下图,是两个模板:
![e51e2b8073536b2da0febc190178d49d.png](https://i-blog.csdnimg.cn/blog_migrate/631f5d6081aa022651380823c15caaf9.jpeg)
- 至于每个模板的文件夹里的内容,这就涉及到模板开发了,相关内容太多,就不在本篇展开了,只说一下重点:template.yml是函数描述文件,必须要有,然后是Dockerfile,这是用来构建镜像用的,至于其他内容和各种模板自身特点有关,在制作镜像时会用到,以java11为例,含有gradle、java相关的文件,这都是构建java工程时会用到,而java工程的构建结果又会被放入docker镜像中,阅读Dockerfile的内容可以详细的看到这一切;
- 当下为了快速做出模板,可以把官方模板的内容复制过来,改改就能用,地址:https://github.com/openfaas/templates
- 仓库准备好之后,任何人都可以通过类似以下命令来下载仓库使用了:
faas template pull https://github.com/zq2599/openfaas-templates
注意点
最后有两处温馨提醒,请注意:
- 现在GitHub上新增的仓库,默认分支已经不是master了,而是mian,但fass-cli命令认准的是master分支,所以请您确保自己的仓库文件内容都在master分支,而不是main
- 执行命令查看官方模板时,可以看到java8的模板,如下图红框,原以为这是java开发者的福音:
![036c9ab0094b07c1bf3b7878eceb9e3f.png](https://i-blog.csdnimg.cn/blog_migrate/20ff839b5d4be840f6dcc1faddf8063d.jpeg)
- 尽管在列表中可以看到java8,但是OpenFaaS的官方文档宣布java8模板已经废弃,不建议使用,如下图红框,文档地址:https://docs.openfaas.com/cli/templates/#java
![296784b66d5455aebed720147542c6f6.png](https://i-blog.csdnimg.cn/blog_migrate/7be0502155db980ba08e16a18ce154da.jpeg)
- 以上就是模板相关的操作了,本篇作为基础还是挺重要的,建议您多动手熟悉相关命令,为后面的深入学习打好基础;
欢迎关注我的公众号:程序员欣宸
![f6bddf66f8fecbbf2a006fbafc70bd65.png](https://i-blog.csdnimg.cn/blog_migrate/bbcaeb58b985a03c5e60af791c308a19.jpeg)