billyrrr commented on a change in pull request #131: URL: https://github.com/apache/flink-statefun/pull/131#discussion_r481413440
########## File path: README.zh.md ########## @@ -0,0 +1,228 @@ +<img alt="有状态函数" src="docs/fig/stateful_functions_logo.png" width=350px/> + +有状态函数是一个[Apache Flink](https://flink.apache.org/)库， __可简化构建分布式有状态应用程序的过程__ 。它基于有着可持久化状态的函数，这些函数可以在强大的一致性保证下进行动态交互。 + +有状态函数使强大的状态管理和组合，与AWS Lambda之类的FaaS实现和Kubernetes之类的现代资源编排框架的弹性，快速缩放/零缩放和滚动升级功能相结合成为可能。通过这些特性，它解决了当今许多FaaS设置中[最常被引用的两个缺点](https://www2.eecs.berkeley.edu/Pubs/TechRpts/2019/EECS-2019-3.pdf) ：状态一致和函数之间的高效消息传递。 + +本自述文件旨在简要介绍核心概念以及如何进行设置 +以使您开始使用有状态函数。 + +有关详细文档，请访问[官方文档](https://ci.apache.org/projects/flink/flink-statefun-docs-master) 。 + +有关代码示例，请查看[示例](statefun-examples/) 。 + + [](https://travis-ci.org/apache/flink-statefun) + +## 目录 + +- [核心概念](#core-concepts) + * [抽象化](#abstraction) + * [函数模块和可扩展性](#modules) + * [运行时](#runtime) +- [入门](#getting-started) + * [运行一个完整的例子](#greeter) + * [新建项目](#project-setup) + * [构建项目](#build) + * [在IDE Harness中运行](#ide-harness) +- [部署应用](#deploying) + * [使用Docker映像进行部署](#docker) + * [部署为Flink作业](#flink) +- [贡献](#contributing) +- [开源软件许可](#license) + +## <a name="core-concepts"></a>核心概念 + +### <a name="abstraction"></a>抽象化 + +有状态函数应用程序由以下原语组成：有状态函数，入口(ingress)， +路由器(router)和出口(egress)。 + +<p align="center"> + <img src="docs/fig/stateful_functions_overview.png" width="650px"/> +</p> + +#### 有状态函数 + +* _有状态函数_是通过消息调用的一小段逻辑/代码。每个有状态函数 +都作为_函数类型_的唯一可调用_虚拟实例_存在。每个实例都通过其``type``以及type中的唯一``ID`` （字符串）来寻址。 + +* 有状态函数可以从ingress或任何其他有状态函数（包括其自身）中调用。 +调用者只需要知道目标函数的地址即可。 + +* 函数实例是_虚拟的_ ，因为它们不总是同时在内存中活跃。 +在任何时间点，只有一小部分函数及其状态作为实际对象存在。当 +虚拟实例接收到消息时，将配置一个对象并带着该虚拟实例的状态 +加载，然后处理该消息。与虚拟内存类似，许多函数的状态可能 +在任何时间点都被“交换出去”(swap out)。 + +* 函数的每个虚拟实例都有其自己的状态，可以通过局部变量访问。 +该状态是私有的，对于该实例是本地的(local)。 + +如果您知道Apache Flink的DataStream API，则可以将有状态函数考虑为轻量级的 +`KeyedProcessFunction` 。函数``type``等同于处理函数转换(process function transformation)，而`` ID ``是键(key)。不同之处 +在于，函数不是在定义数据流的有向非循环图（DAG）中组装（流拓扑）， Review comment: ```suggestion 在于，函数不是在定义数据流动（流的拓扑结构）的有向非循环图（DAG）中组装， ``` ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: [email protected]
