快速开始

    • 方式一：使用all-in-one方式运行
    • 方式二：使用docker-compose运行
    • 方式三：编译打包部署

    1. 编译

    1.1 编译全部模块 备注：如果您是在linux环境或者不需要对单个模块进行编译，只需要运行1.1的命令即可

    1.2 为其它平台交叉编译：

    1.3 只编译某一个模块：

    1. $ make WHAT=./pkg/controller

    用法

    1. $ scripts/build-image.sh -h
    2. Usage: scripts/build-image.sh [OPTIONS]
    3.   -h  --help      帮助
    4.   -m= --module=   模块名称
    5.   -i= --image=    镜像名称
    6.   -t= --tag=      镜像标签
    7.   -e= --env=      部署环境（镜像仓库配置）

    打包all-in-one镜像，其中会包含controller组件、 funclet组件、 stubs组件。需要注意的runtime目前不开源，直接拉取镜像即可，执行脚本打包：

    1. $ scripts/build-image.sh -m=one -i=easyfaas -t=dev

    REGISTRY地址可以在 中免费申请体验

    3. 上传镜像

    如果在本机，否则需要上传镜像

    1. docker push [OPTIONS] NAME[:TAG]
    2. 如：
    3. docker push registry.baidubce.com/<your_namespace>/<your_image_name>:<your_image_tag>
    1. export faasPath=/<your_path_prefix>/easyfaas/faas
    3. #runner-runtime请直接下载镜像
    4. docker run -td -e WITHRUNNER=1 -e WITHNODEJS10=1  -e WITHNODEJS12=1 -e WITHPYTHON3=1 --name runner-runtime -v ${faasPath}/runtime:/var/faas/runtime -v ${faasPath}/runner:/var/faas/runner registry.baidubce.com/easyfaas-public/runner-runtime:demo1.0
    6. # 启动all-in-one服务
    7. docker run -td --privileged -v ${faasPath}/runner:/var/faas/runner -v ${faasPath}/runtime:/var/faas/runtime -v ${faasPath}/data:/var/faas/runner-data --name easyfaas registry.baidubce.com/easyfaas-public/all-in-one:demo1.0

    5. 操作运行

    安装运行完成后，执行如下命令进入到容器内：

    1. $ docker exec -it easyfaas bash

    使用stub组件构建本地代码仓库其创建函数接口API详见接口API文档, 可以使用curl或者其他工具如Paw发起创建函数请求。

    1.1 编写函数代码

    首先编写一个简单的nodejs10的hello world 函数代码,代码存储在index.js文件中 备注： 您也可以直接跳过此步骤，直接运行1.1和1.2，直接运行1.3

    1. $ cat index.js 
    2. exports.handler = (event, context, callback) => {
    3. };

    1.2 打包函数代码并获得其base64编码

    1.3 调用func-registry创建函数接口创建函数

    1. $ curl -X POST "http://127.0.0.1:8002/v1/functions/testHelloWorld" -d '{"Version":"1","Description":"stubs create","Runtime":"nodejs10","Timeout":5,"MemorySize":128,"Handler":"index.handler","PodConcurrentQuota":10,"Code":"UEsDBBQAAAAAAHCjX00AAAAAAAAAAAAAAAAJABUAX19NQUNPU1gvVVgIALSf2Vu0n9lbVVQFAAG0n9lbUEsDBBQACAAIAAyjX00AAAAAAAAAAAAAAAATABUAX19NQUNPU1gvLl9pbmRleC5qc1VYCACwn9lb+J7ZW1VUBQAB+J7ZW2JgFWNnYGJg8E1MVvAPVohQgAKQGAMnAwODEQMDQx0DA5i/gYEo4BgSEgRlgnQsYGBgEEBTwogQl0rOz9VLLCjISdXLSSwuKS1OTUlJLElVDggGKXw772Y0iO5J8tAH0YAAAAD//1BLBwgOCcksZgAAALAAAABQSwMEFAAIAAgAAAAAAAAAAAAAAAAAAAAAAAgAAABpbmRleC5qc0qtKMgvKinWy0jMS8lJLVKwVdBILUvNK9FRSM7PK0mtADESc3KSEpOzNRVs7RSquRQUFOBCGnmlOTk6CkoeqTk5+Qrl+UU5KYpKmtZctdaAAAAA//9QSwcILzRMjVUAAABYAAAAUEsBAhQDFAAAAAAAcKNfTQAAAAAAAAAAAAAAAAkAFQAAAAAAAAAAQP1BAAAAAF9fTUFDT1NYL1VYCAC0n9lbtJ/ZW1VUBQABtJ/ZW1BLAQIUAxQACAAIAAyjX00OCcksZgAAALAAAAATABUAAAAAAAAAAECkgTwAAABfX01BQ09TWC8uX2luZGV4LmpzVVgIALCf2Vv4ntlbVVQFAAH4ntlbUEsBAhQAFAAIAAgAAAAAAC80TI1VAAAAWAAAAAgAAAAAAAAAAAAAAAAA+AAAAGluZGV4LmpzUEsFBgAAAAADAAMA2AAAAIMBAAAAAA=="}' -H 'X-easyfaas-Account-Id: df391b08c64c426a81645468c75163a5'   -H 'Content-Type: application/json; charset=utf-8'
    2. 请求示例
    3. POST /v1/functions/testHelloWorld HTTP/1.1
    4. Content-Type: application/json; charset=utf-8
    5. Host: 172.22.170.33:8002
    6. Connection: close
    7. User-Agent: Paw/3.1.10 (Macintosh; OS X/10.15.4) GCDHTTPRequest
    8. Content-Length: 990
    10. {"Version":"1","Description":"stubs create","Runtime":"nodejs10","Timeout":5,"MemorySize":128,"Handler":"index.handler","PodConcurrentQuota":10,"Code":"UEsDBBQAAAAAAHCjX00AAAAAAAAAAAAAAAAJABUAX19NQUNPU1gvVVgIALSf2Vu0n9lbVVQFAAG0n9lbUEsDBBQACAAIAAyjX00AAAAAAAAAAAAAAAATABUAX19NQUNPU1gvLl9pbmRleC5qc1VYCACwn9lb+J7ZW1VUBQAB+J7ZW2JgFWNnYGJg8E1MVvAPVohQgAKQGAMnAwODEQMDQx0DA5i/gYEo4BgSEgRlgnQsYGBgEEBTwogQl0rOz9VLLCjISdXLSSwuKS1OTUlJLElVDggGKXw772Y0iO5J8tAH0YAAAAD//1BLBwgOCcksZgAAALAAAABQSwMEFAAIAAgAAAAAAAAAAAAAAAAAAAAAAAgAAABpbmRleC5qc0qtKMgvKinWy0jMS8lJLVKwVdBILUvNK9FRSM7PK0mtADESc3KSEpOzNRVs7RSquRQUFOBCGnmlOTk6CkoeqTk5+Qrl+UU5KYpKmtZctdaAAAAA//9QSwcILzRMjVUAAABYAAAAUEsBAhQDFAAAAAAAcKNfTQAAAAAAAAAAAAAAAAkAFQAAAAAAAAAAQP1BAAAAAF9fTUFDT1NYL1VYCAC0n9lbtJ/ZW1VUBQABtJ/ZW1BLAQIUAxQACAAIAAyjX00OCcksZgAAALAAAAATABUAAAAAAAAAAECkgTwAAABfX01BQ09TWC8uX2luZGV4LmpzVVgIALCf2Vv4ntlbVVQFAAH4ntlbUEsBAhQAFAAIAAgAAAAAAC80TI1VAAAAWAAAAAgAAAAAAAAAAAAAAAAA+AAAAGluZGV4LmpzUEsFBgAAAAADAAMA2AAAAIMBAAAAAA=="}
    12. 响应结果:
    13. HTTP/1.1 200 OK
    14. Server: fasthttp
    15. Date: Fri, 11 Dec 2020 03:07:50 GMT
    16. Content-Length: 0
    17. Connection: close

    请求示例

    1. $ curl -X GET "http://127.0.0.1:8002/v1/functions/brn:cloud:faas:bj:8f6e5a28c663957ea04522547a66d08f:function:testHelloWorld:1" -H 'X-easyfaas-Account-Id: df391b08c64c426a81645468c75163a5'   -H 'Content-Type: application/json; charset=utf-8' 
    3. GET /v1/functions/testHelloWorld HTTP/1.1
    4. Host: 127.0.0.1:8002
    5. Connection: close

    响应结果

    1. {
    2.   "Code": {
    3.     "_": {},
    4.     "Location": "/var/faas/funcData/brn:cloud:faas:bj:8f6e5a28c663957ea04522547a66d08f:function:testHelloWorld:1/code.zip",
    5.     "RepositoryType": "filesystem",
    6.     "LogType": ""
    7.   },
    8.   "Concurrency": {
    9.     "_": {},
    10.     "ReservedConcurrentExecutions": null,
    11.     "AccountReservedSum": 0
    12.   },
    13.   "Configuration": {
    14.     "_": {},
    15.     "CodeSha256": "VoLwl2uaH/cF0hsvKQMkLbbd7JKtGgG5MNExk8whT+M=",
    16.     "CodeSize": 625,
    17.     "DeadLetterConfig": null,
    18.     "Environment": {
    19.       "_": {},
    20.       "Error": null,
    21.       "Variables": null
    22.     },
    24.     "FunctionName": "testHelloWorld",
    25.     "Handler": "index.handler",
    26.     "KMSKeyArn": null,
    27.     "LastModified": "2021-02-28T11:11:07Z",
    28.     "Layers": null,
    29.     "MasterArn": null,
    30.     "MemorySize": 128,
    31.     "RevisionId": null,
    32.     "Role": null,
    33.     "Runtime": "nodejs10",
    34.     "Timeout": 5,
    35.     "TracingConfig": null,
    36.     "Version": "1",
    37.     "VpcConfig": null,
    38.     "CommitId": "349dd8a4-db7d-4fc3-a4cd-8c8b482e00c3",
    39.     "Uid": "df391b08c64c426a81645468c75163a5",
    40.     "PodConcurrentQuota": 10
    41.   },
    42.   "LogConfig": {
    43.     "LogType": "",
    44.     "BosDir": "",
    45.     "Params": ""
    46.   },
    47.   "Tags": {}
    48. }

    向controller发起函数调用请求

    1. $ curl -X "POST" "http://127.0.0.1:8001/v1/functions/brn:cloud:faas:bj:8f6e5a28c663957ea04522547a66d08f:function:testHelloWorld:1/invocations"   -H 'X-easyfaas-Account-Id: df391b08c64c426a81645468c75163a5'      -H 'Content-Type: application/json; charset=utf-8'      -d $'{}'
    2. 请求示例
    3. POST /v1/functions/brn:bce:cfc:bj:cd64f99c69d7c404b61de0a4f1865834:function:testHSF2:1/invocations HTTP/1.1
    4. Content-Type: application/json; charset=utf-8
    5. X-easyfaas-Account-Id: df391b08c64c426a81645468c75163a5
    6. Host: 127.0.0.1:8001
    7. Connection: close
    9. 响应示例：

    运行步骤

    方式三：编译打包部署