functions/prometheus

Functions as a Service (FaaS)

FaaS 是一个使用 Docker 构建无服务器函数的框架，原生支持指标收集。任何进程都可以打包为函数，使您能够处理各种 Web 事件，无需重复编写样板代码。

核心功能与特性

• 易用性：通过 UI 门户和一键安装实现简单操作
• 多语言支持：可使用任何语言（Linux 或 Windows）编写函数，并打包为 Docker/OCI 镜像格式
• 可移植性：运行于现有硬件或公有/私有云环境，支持 Kubernetes 或 Docker Swarm
• CLI 工具：提供 CLI 工具，支持 YAML 格式的函数模板定义与管理
• 自动扩展：根据需求自动扩展函数实例数量

核心组件

Function Watchdog

• 通过添加 Function Watchdog（一个轻量级 Golang HTTP 服务器），可将任何 Docker 镜像转换为无服务器函数
• Function Watchdog 作为入口点，将 HTTP 请求通过 STDIN 转发到目标进程，应用通过 STDOUT 输出响应并返回给调用者

Gateway

• API 网关提供函数的外部访问路由，并通过 Prometheus 收集云原生指标
• 网关会根据需求通过 Docker Swarm 或 Kubernetes API 调整服务副本数量，实现函数自动扩展
• 内置 UI，允许在浏览器中调用函数和创建新函数

CLI

任何容器或 Docker 容器中的进程都可作为 FaaS 中的无服务器函数。使用 http://github.com/alexellis/faas-cli 可部署函数或从 Node.js、Python 等模板快速创建新函数。

使用示例

CLI 操作流程

以下示例展示 url_ping 函数（用 Python 编写），该函数连接远程 Web 服务器并返回响应的 HTTP 状态码。

函数代码

python
import requests

def handle(req):
    r = requests.get(req, timeout=1)
    print(req + " => " + str(r.status_code))

handler.py

安装 CLI

bash
$ curl -sSL https://cli.openfaas.com | sudo sh

也可通过 brew 安装 faas-cli

准备函数模板与示例

bash
$ git clone https://github.com/alexellis/faas-cli
$ cd faas-cli

定义函数（YAML 配置）

yaml
provider:
  name: faas
  gateway: http://localhost:8080

functions:
  url_ping:
    lang: python
    handler: ./sample/url_ping
    image: alexellis2/faas-urlping

示例 YAML 文件 - urlping.yaml

构建函数镜像

bash
$ faas-cli -action build -f ./urlping.yaml

使用 ./sample/url_ping 中的 Python 处理器构建 Docker 镜像

部署函数

bash
$ faas-cli -action deploy -f ./urlping.yaml

将新镜像部署到 YAML 文件中定义的网关

若网关位于远程或多主机 Swarm 中，可使用 faas-cli -action push 将镜像推送到远程仓库或 Docker Hub

测试函数

bash
$ curl -d "https://cli.openfaas.com" http://localhost:8080/function/url_ping/
https://cli.openfaas.com => 200

测试 URL https://cli.openfaas.com，返回状态码 200

https://github.com/alexellis/faas/tree/master/sample-functions 提供多种编程语言实现，可在 GitHub 仓库中查看。

快速开始

Dockercon 2017 闭幕主题演讲

FaaS 曾获 Dockercon 2017 "Cool Hacks" 竞赛奖项。

• 观看 Dockercon 2017 FaaS 主题演讲

演示中使用的函数可在 https://github.com/alexellis/faas-dockercon/ 仓库中找到。

背景故事

FaaS 最初于 1 月在博客中发布：Functions as a Service 博客文章

测试驱动

提供一键脚本帮助快速上手。可在 Docker Swarm 上通过 https://github.com/alexellis/faas/blob/master/docker-compose.yml 文件测试 FaaS 及示例函数。若使用 Kubernetes 集群，可从 https://github.com/alexellis/faas-netes 开始。

可在本地或免费社区 Docker 环境（play-with-docker.com）中使用：

https://github.com/alexellis/faas/blob/master/TestDrive.md

API 网关门户截图（设计注重易用性）：

!Portal

社区

若您撰写了关于 FaaS 的博客，可通过 Pull Request 更新社区页面：

• https://github.com/alexellis/faas/blob/master/community.md

如需加入 FaaS 社区 Slack 频道与贡献者交流或获取帮助，可发送推文至 @alexellisuk 或在 GitHub 提交 issue。

路线图与贡献

FaaS 使用 Golang 编写，采用 MIT 许可证。欢迎提供反馈、测试功能或参与开发。可查看 https://github.com/alexellis/faas/blob/master/ROADMAP.md 或 https://github.com/alexellis/faas/issues%E3%80%82

最新进展

• 新增：通过 https://github.com/alexellis/faas-netes 插件支持 Kubernetes
• 新增：FaaS CLI 及通过 curl 和 brew 的便捷安装
• 新增：Windows 函数支持
• 开发中：通过 NATS Streaming 实现异步/长运行 FaaS 函数 https://gist.github.com/alexellis/62dad83b***ba49042afe258bb1

Grafana 仪表板示例（展示 FaaS 自动扩展实时效果）：

![]([***]

仪表板 JSON 文件可在 https://github.com/alexellis/faas/blob/master/contrib/grafana.json 获取。