fx

fx

多语言支持的函数即服务快速部署工具

fx是一个开源的函数即服务(FaaS)部署工具,支持在Docker和Kubernetes环境中快速部署无状态函数。它简化了FaaS的实现过程,支持Go、Rust、Node、Python等多种编程语言。通过简单的命令行接口,fx能在几秒钟内将函数转化为服务,方便开发者进行部署、管理和测试。

FaaSDockerKubernetes开源项目多语言支持Github

fx

Poor man's function as a service. <br/> CI GitHub contributors CodeCov Go Report Card Go Doc visitors license Release

Table of Contents

Introduction

fx is a tool to help you do Function as a Service on your own server, fx can make your stateless function a service in seconds, both Docker host and Kubernetes cluster supported. The most exciting thing is that you can write your functions with most programming languages.

Feel free hacking fx to support the languages not listed. Welcome to tweet me @_metrue on Twitter, @metrue on Weibo.

LanguageStatusContributorExample
GoSupportedfx/examples/Golang
RustSupported@FrontMage/examples/Rust
NodeSupportedfx/examples/JavaScript
PythonSupportedfx/examples/Python
RubySupportedfx/examples/Ruby
JavaSupportedfx/examples/Java
PHPSupported@chlins/examples/PHP
JuliaSupported@matbesancon/examples/Julia
DSupported@andre2007/examples/D
PerlSupportedfx/examples/Perl
CrystalSupported@mvrilo/examples/Crystal
RWorking on need your help

Installation

Binaries are available for Windows, MacOS and Linux/Unix on x86. For other architectures and platforms, follow instructions to build fx from source.

  • MacOS
brew tap metrue/homebrew-fx
brew install metrue/fx/fx
  • Linux/Unix

via cURL

# Install to local directory curl -o- https://raw.githubusercontent.com/metrue/fx/master/scripts/install.sh | bash # Install to /usr/local/bin/ curl -o- https://raw.githubusercontent.com/metrue/fx/master/scripts/install.sh | sudo bash

fx will be installed into /usr/local/bin, sometimes you may need source ~/.zshrc or source ~/.bashrc to make fx available in $PATH.

  • Windows

You can go the release page to download fx manually;

Usage

NAME:
   fx - makes function as a service

USAGE:
   fx [global options] command [command options] [arguments...]

COMMANDS:
   up        deploy a function
   down      destroy a service
   list, ls  list deployed services
   image     manage image of service
   help, h   Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --help, -h     show help
   --version, -v  print the version

Deploy function

Local Docker environment

By default, function will be deployed on localhost, make sure Docker installed and running on your server first. then type fx -h on your terminal to check out basic help.

$ fx up --name hello ./examples/functions/JavaScript/func.js

+------------------------------------------------------------------+-----------+---------------+
|                                ID                                |   NAME    |   ENDPOINT    |
+------------------------------------------------------------------+-----------+---------------+
| 5b24d36608ee392c937a61a530805f74551ddec304aea3aca2ffa0fabcf98cf3 | /hello    | 0.0.0.0:58328 |
+------------------------------------------------------------------+-----------+---------------+

Remote host

Use --host to specify the target host for your function, or you can just set it to FX_HOST environment variable.

$ fx up --host roo@<your host> --name hello ./examples/functions/JavaScript/func.js +------------------------------------------------------------------+-----------+---------------+ | ID | NAME | ENDPOINT | +------------------------------------------------------------------+-----------+---------------+ | 5b24d36608ee392c937a61a530805f74551ddec304aea3aca2ffa0fabcf98cf3 | /hello | 0.0.0.0:58345 | +------------------------------------------------------------------+-----------+---------------+

Kubernetes

$ FX_KUBECONF=~/.kube/config fx up examples/functions/JavaScript/func.js --name hello

+-------------------------------+------+----------------+
| ID                     | NAME        |    ENDPOINT    |
+----+--------------------------+-----------------------+
|  5b24d36608ee392c937a  | hello-fx    | 10.0.242.75:80 |
+------------------------+-------------+----------------+

Test service

then you can test your service:

$ curl -v 0.0.0.0:58328 GET / HTTP/1.1 Accept: */* Accept-Encoding: gzip, deflate Connection: keep-alive Host: 0.0.0.0:10001 User-Agent: HTTPie/1.0.2 HTTP/1.1 200 OK Connection: keep-alive Content-Length: 11 Content-Type: text/plain; charset=utf-8 Date: Sat, 10 Aug 2019 05:28:03 GMT hello world

Use Public Cloud Kubernetes Service as infrastructure to run your functions

  • Azure Kubernetes Service (AKS)

You should create a Kubernetes cluster if you don't have one on AKS, detail document can found here.

$ az group create --name <myResourceGroup> --location eastus $ az aks create --resource-group <myResourceGroup> --name myAKSCluster --node-count <count> $ az aks get-credentials --resource-group <myResourceGroup> --name <myAKSCluster>

Then you can verify it with kubectl,

$ kubectl get nodes NAME STATUS ROLES AGE VERSION aks-nodepool1-31718369-0 Ready agent 6m44s v1.12.8

Since AKS's config will be merged into ~/.kube/config and set to be current context after you run az aks get-credentials command, so you can just set KUBECONFIG to default config also,

$ export FX_KUBECONF=~/.kube/config # then fx will take the config to deloy function

But we would suggest you run kubectl config current-context to check if the current context is what you want.

  • Amazon Elastic Kubernetes Service (EKS) TODO

  • Google Kubernetes Engine (GKE)

First you should create a Kubernetes cluster in your GKE, then make sure your KUBECONFIG is ready in ~/.kube/config, if not, you can run following commands,

$ gcloud auth login $ gcloud container clusters get-credentials <your cluster> --zone <zone> --project <project>

Then make sure you current context is GKE cluster, you can check it with command,

$ kubectl config current-context

Then you can deploy your function onto GKE cluster with,

$ FX_KUBECONF=~/.kube/config fx up examples/functions/JavaScript/func.js --name hellojs
  • Setup your own Kubernetes cluster
fx infra create --type k3s --name fx-cluster-1 --master root@123.11.2.3 --agents 'root@1.1.1.1,root@2.2.2.2'

Contributors

Thank you to all the people who already contributed to fx!

<table> <tbody> <tr> <a href="https://github.com/metrue" target="_blank"> <img alt="metrue" src="https://avatars2.githubusercontent.com/u/1001246?v=4&s=50" width="50"> </a> <a href="https://github.com/muka" target="_blank"> <img alt="muka" src="https://avatars2.githubusercontent.com/u/1021269?v=4&s=50" width="50"> </a> <a href="https://github.com/pplam" target="_blank"> <img alt="pplam" src="https://avatars2.githubusercontent.com/u/12783579?v=4&s=50" width="50"> </a> <a href="https://github.com/matbesancon" target="_blank"> <img alt="mbesancon" src="https://avatars2.githubusercontent.com/u/7623090?s=60&v=4" width="50"> </a> <a href="https://github.com/chlins" target="_blank"> <img alt="chlins" src="https://avatars2.githubusercontent.com/u/31262637?v=4&s=50" width="50"> </a> <a href="https://github.com/xwjdsh" target="_blank"> <img alt="xwjdsh" src="https://avatars2.githubusercontent.com/u/11025519?v=4&s=50" width="50"> </a> <a href="https://github.com/DaidoujiChen" target="_blank"> <img alt="DaidoujiChen" src="https://avatars0.githubusercontent.com/u/670441?v=4&s=50" width="50"> </a> <a href="https://github.com/avelino" target="_blank"> <img alt="avelino" src="https://avatars2.githubusercontent.com/u/31996?v=4&s=50" width="50"> </a> <a href="https://github.com/andre2007" target="_blank"> <img alt="andre2007" src="https://avatars1.githubusercontent.com/u/1451047?s=50&v=4" width="50"> </a> <a href="https://github.com/polyrabbit" target="_blank"> <img alt="polyrabbit" src="https://avatars0.githubusercontent.com/u/2657334?s=60&v=4" width="50"> </a> <a href="https://github.com/johnlunney" target="_blank"> <img alt="johnlunney" src="https://avatars3.githubusercontent.com/u/536947?s=60&v=4" width="50"> </a> <a href="https://github.com/tbrand" target="_blank"> <img alt="tbrand" src="https://avatars0.githubusercontent.com/u/3483230?s=60&v=4" width="50"> </a> <a href="https://github.com/steventhanna" target="_blank"> <img alt="andre2007" src="https://avatars1.githubusercontent.com/u/2541678?s=50&v=4" width="50"> </a> <a href="https://github.com/border-radius" target="_blank"> <img alt="border-radius" src="https://avatars0.githubusercontent.com/u/3204785?s=60&v=4" width="50"> </a> <a href="https://github.com/Russtopia" target="_blank"> <img alt="Russtopia" src="https://avatars1.githubusercontent.com/u/2966177?s=60&v=4<Paste>" width="50"> </a> <a href="https://github.com/FrontMage" target="_blank"> <img alt="FrontMage" src="https://avatars2.githubusercontent.com/u/17007026?s=60&v=4" width="50"> </a> <a href="https://github.com/DropNib" target="_blank"> <img alt="DropNib" src="https://avatars0.githubusercontent.com/u/32019589?s=60&v=4" width="50"> </a> </tr>

编辑推荐精选

Vora

Vora

免费创建高清无水印Sora视频

Vora是一个免费创建高清无水印Sora视频的AI工具

Refly.AI

Refly.AI

最适合小白的AI自动化工作流平台

无需编码,轻松生成可复用、可变现的AI自动化工作流

酷表ChatExcel

酷表ChatExcel

大模型驱动的Excel数据处理工具

基于大模型交互的表格处理系统,允许用户通过对话方式完成数据整理和可视化分析。系统采用机器学习算法解析用户指令,自动执行排序、公式计算和数据透视等操作,支持多种文件格式导入导出。数据处理响应速度保持在0.8秒以内,支持超过100万行数据的即时分析。

AI工具使用教程AI营销产品酷表ChatExcelAI智能客服
TRAE编程

TRAE编程

AI辅助编程,代码自动修复

Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。

热门AI工具生产力协作转型TraeAI IDE
AIWritePaper论文写作

AIWritePaper论文写作

AI论文写作指导平台

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

数据安全AI助手热门AI工具AI辅助写作AI论文工具论文写作智能生成大纲
博思AIPPT

博思AIPPT

AI一键生成PPT,就用博思AIPPT!

博思AIPPT,新一代的AI生成PPT平台,支持智能生成PPT、AI美化PPT、文本&链接生成PPT、导入Word/PDF/Markdown文档生成PPT等,内置海量精美PPT模板,涵盖商务、教育、科技等不同风格,同时针对每个页面提供多种版式,一键自适应切换,完美适配各种办公场景。

热门AI工具AI办公办公工具智能排版AI生成PPT博思AIPPT海量精品模板AI创作
潮际好麦

潮际好麦

AI赋能电商视觉革命,一站式智能商拍平台

潮际好麦深耕服装行业,是国内AI试衣效果最好的软件。使用先进AIGC能力为电商卖家批量提供优质的、低成本的商拍图。合作品牌有Shein、Lazada、安踏、百丽等65个国内外头部品牌,以及国内10万+淘宝、天猫、京东等主流平台的品牌商家,为卖家节省将近85%的出图成本,提升约3倍出图效率,让品牌能够快速上架。

iTerms

iTerms

企业专属的AI法律顾问

iTerms是法大大集团旗下法律子品牌,基于最先进的大语言模型(LLM)、专业的法律知识库和强大的智能体架构,帮助企业扫清合规障碍,筑牢风控防线,成为您企业专属的AI法律顾问。

SimilarWeb流量提升

SimilarWeb流量提升

稳定高效的流量提升解决方案,助力品牌曝光

稳定高效的流量提升解决方案,助力品牌曝光

Sora2视频免费生成

Sora2视频免费生成

最新版Sora2模型免费使用,一键生成无水印视频

最新版Sora2模型免费使用,一键生成无水印视频

下拉加载更多