Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Chinese Version Spec V1.0 #898

Closed
wants to merge 61 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
61 commits
Select commit Hold shift + click to select a range
8bfb2f4
Update README.md
JieDing Nov 6, 2021
86b7128
Update primer.md
JieDing Nov 6, 2021
216791a
update contents
JieDing Nov 6, 2021
b97d552
Update primer.md
JieDing Nov 7, 2021
f3cf546
Update primer.md
JieDing Nov 8, 2021
15ff45d
Update primer.md
JieDing Nov 8, 2021
32efae8
Update primer.md
JieDing Nov 8, 2021
2aad82c
Update spec.md
JieDing Nov 9, 2021
62bc327
Update primer.md
JieDing Nov 9, 2021
56aaf93
Update README.md
JieDing Nov 9, 2021
b70872a
Update README.md
JieDing Nov 9, 2021
3f26afc
Update primer.md
JieDing Nov 9, 2021
c74546e
Update spec.md
JieDing Nov 9, 2021
28811a0
Create README_CN.md
JieDing Nov 9, 2021
46657ad
Update README_CN.md
JieDing Nov 9, 2021
8c7db53
Update README_CN.md
JieDing Nov 9, 2021
b17185d
Update README.md
JieDing Nov 9, 2021
4560ffb
Create primer_CN.md
JieDing Nov 9, 2021
f326630
Update primer.md
JieDing Nov 9, 2021
0408dd0
Create spec_CN.md
JieDing Nov 9, 2021
660ab95
Update spec.md
JieDing Nov 9, 2021
21905a2
Update README_CN.md
JieDing Nov 9, 2021
d221c0a
Update primer_CN.md
JieDing Nov 9, 2021
73308d3
Update spec_CN.md
JieDing Nov 9, 2021
10fba3e
Create README_CN.md
JieDing Nov 9, 2021
40f281d
Delete README_CN.md
JieDing Nov 9, 2021
fc3bb0f
Create primer_CN.md
JieDing Nov 9, 2021
dfd81a4
Delete primer_CN.md
JieDing Nov 9, 2021
4e40b53
Create spec_CN.md
JieDing Nov 9, 2021
4b29684
Delete spec_CN.md
JieDing Nov 9, 2021
79ae60a
Update README.md
JieDing Nov 6, 2021
772e4f8
Update primer.md
JieDing Nov 6, 2021
1af1e30
update contents
JieDing Nov 6, 2021
de6adfe
Update primer.md
JieDing Nov 7, 2021
a9baebe
Update primer.md
JieDing Nov 8, 2021
d0a93aa
Update primer.md
JieDing Nov 8, 2021
9ab0c3d
Update primer.md
JieDing Nov 8, 2021
783c814
Update spec.md
JieDing Nov 9, 2021
8fa3995
Update primer.md
JieDing Nov 9, 2021
f47f3ed
Update README.md
JieDing Nov 9, 2021
4ce4d10
Update README.md
JieDing Nov 9, 2021
18900be
Update primer.md
JieDing Nov 9, 2021
cfdb705
Update spec.md
JieDing Nov 9, 2021
5f39210
Create README_CN.md
JieDing Nov 9, 2021
0e11f12
Update README_CN.md
JieDing Nov 9, 2021
09b87d1
Update README_CN.md
JieDing Nov 9, 2021
affe7df
Update README.md
JieDing Nov 9, 2021
8a50729
Create primer_CN.md
JieDing Nov 9, 2021
c7ec4eb
Update primer.md
JieDing Nov 9, 2021
4cc626f
Create spec_CN.md
JieDing Nov 9, 2021
f4c9030
Update spec.md
JieDing Nov 9, 2021
bf8a1be
Update README_CN.md
JieDing Nov 9, 2021
10fd719
Update primer_CN.md
JieDing Nov 9, 2021
39a1356
Update spec_CN.md
JieDing Nov 9, 2021
3133851
Create README_CN.md
JieDing Nov 9, 2021
68cab31
Delete README_CN.md
JieDing Nov 9, 2021
3764eff
Create primer_CN.md
JieDing Nov 9, 2021
1c830b2
Delete primer_CN.md
JieDing Nov 9, 2021
9e8dd6f
Create spec_CN.md
JieDing Nov 9, 2021
9c3d525
Delete spec_CN.md
JieDing Nov 9, 2021
6e90fcd
Merge branch 'v1.0_CN' of https://github.com/JieDing/spec into v1.0_CN
JieDing Nov 9, 2021
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
132 changes: 132 additions & 0 deletions Chinese Manual/README_CN.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,132 @@
# CloudEvents 中文手册

![CloudEvents logo](https://github.com/cncf/artwork/blob/master/projects/cloudevents/horizontal/color/cloudevents-horizontal-color.png)

Declaration: This manual aims to provide a fast and brief introduction of CloudEvents
in Chinese for people who are new to CloudEvents.
Most of the content is translated from the original English version.
It is strongly recommended to read the English version if you find anything lost in translation.

事件(Events)在现代系统中无处不在。但不同的事件生产者往往用不同的规范来描述自己的事件。

对事件的统一描述的匮乏意味着开发者必须不断重新学习如何消费不同定义的事件。它同样限制了那些用来帮助事件数据完成
跨环境传输的库(如SDKs),工具(如事件路由器)和基础设施(如事件追踪系统)的发展。总体来看,这种匮乏严重阻碍了事件数据的
可移植性和生产力。

CloudEvents是一个以通用格式来描述事件数据的标准。它提供了事件在服务、平台和系统中的互操作性。

CloudEvents 收获了从主流云厂商到SaaS公司的广泛关注。CloudEvents被[云原生计算基金会](https://cncf.io) (CNCF)持有,
在[2018/05/15](https://docs.google.com/presentation/d/1KNSv70fyTfSqUerCnccV7eEC_ynhLsm9A_kjnlmU_t0/edit#slide=id.g37acf52904_1_41)
被选为云原生沙箱级项目。

## CloudEvents 文件

现有文件如下:

| | 最新版本 | 工作草稿 |
| :---------------------------- | :----------------------------------------------------------------------------: | :---------------------------------------------------------------------------------: |
| **核心标准:** |
| CloudEvents | [v1.0](https://github.com/cloudevents/spec/blob/v1.0/spec.md) | [master](https://github.com/cloudevents/spec/blob/master/spec.md) |
| |
| **可选标准:** |
| AMQP Protocol Binding | [v1.0](https://github.com/cloudevents/spec/blob/v1.0/amqp-protocol-binding.md) | [master](https://github.com/cloudevents/spec/blob/master/amqp-protocol-binding.md) |
| AVRO Event Format | [v1.0](https://github.com/cloudevents/spec/blob/v1.0/avro-format.md) | [master](https://github.com/cloudevents/spec/blob/master/avro-format.md) |
| HTTP Protocol Binding | [v1.0](https://github.com/cloudevents/spec/blob/v1.0/http-protocol-binding.md) | [master](https://github.com/cloudevents/spec/blob/master/http-protocol-binding.md) |
| JSON Event Format | [v1.0](https://github.com/cloudevents/spec/blob/v1.0/json-format.md) | [master](https://github.com/cloudevents/spec/blob/master/json-format.md) |
| Kafka Protocol Binding | [v1.0](https://github.com/cloudevents/spec/blob/v1.0/kafka-protocol-binding.md) | [master](https://github.com/cloudevents/spec/blob/master/kafka-protocol-binding.md) |
| MQTT Protocol Binding | [v1.0](https://github.com/cloudevents/spec/blob/v1.0/mqtt-protocol-binding.md) | [master](https://github.com/cloudevents/spec/blob/master/mqtt-protocol-binding.md) |
| NATS Protocol Binding | [v1.0](https://github.com/cloudevents/spec/blob/v1.0/nats-protocol-binding.md) | [master](https://github.com/cloudevents/spec/blob/master/nats-protocol-binding.md) |
| Web hook | [v1.0](https://github.com/cloudevents/spec/blob/v1.0/http-webhook.md) | [master](https://github.com/cloudevents/spec/blob/master/http-webhook.md) |
| |
| **附加文件:** |
| CloudEvents Adapters | - | [master](https://github.com/cloudevents/spec/blob/master/adapters.md) |
| CloudEvents SDK Requirements | - | [master](https://github.com/cloudevents/spec/blob/master/SDK.md) |
| Documented Extensions | - | [master](https://github.com/cloudevents/spec/blob/master/documented-extensions.md) |
| Primer | [v1.0](https://github.com/cloudevents/spec/blob/v1.0/primer.md) | [master](https://github.com/cloudevents/spec/blob/master/primer.md) |
| Proprietary Specifications | - | [master](https://github.com/cloudevents/spec/blob/master/proprietary-specs.md) |

对于初次接触CloudEvents的同学,可以通过阅读[入门文档](primer_CN.md)增加对CloudEvents规范的目标和设计理念
的总体理解,
希望在最短时间内使用CloudEvents 规范的同学,可以直接阅读[核心规范](spec_CN.md)。

由于并非所有事件生产者都默认生产符合CloudEvents规范的事件,因此可以用[CloudEvents适配器](https://github.com/cloudevents/spec/blob/master/adapters.md)
来将现有的事件与CloudEvents做适配。

## SDKs

除了上述文档,我们还提供了[SDK 提议](SDK.md)以及一些编程语言的SDK:

- [CSharp](https://github.com/cloudevents/sdk-csharp)
- [Go](https://github.com/cloudevents/sdk-go)
- [Java](https://github.com/cloudevents/sdk-java)
- [Javascript](https://github.com/cloudevents/sdk-javascript)
- [Python](https://github.com/cloudevents/sdk-python)

## 社区

在社区里,你可以了解到更多致力于搭建一个动态、云原生的生态系统的成员和组织。
他们不断尝试提升现有系统和CloudEvents间的互操作性和兼容性。

- [贡献者](community/contributors.md):
是指那些帮助我们制定规范或是积极活跃在CloudEvents规范相关工作的成员和组织。
- 即将推出: [demos & open source](community/README.md) --
如果你希望向我们分享关于你对CloudEvents的使用,请通过提交PR让我们看到。

## 步骤

CloudEvents项目 [旨在](primer_CN.md#设计目标)制定一个能够提升不同事件系统(如生产者和消费者)之间互操作性和兼容性
的[标准](spec_CN.md)。

为了完成这个目标,这个项目必须描述:

- 一系列能够提升互操作性的用来描述事件的属性
- 一个或多个通用架构,这些架构必须是当下活跃的或是正在计划被完成的
- 事件是如何在一种或多种协议下从生产者传输到消费者的
- 识别并解决任何能提升互操作性的问题
## 联系方式

邮件联系方式如下:

- 发送EMail至: [cncf-cloudevents](mailto:cncf-cloudevents@lists.cncf.io)
- 订阅地址: https://lists.cncf.io/g/cncf-cloudevents
- 存档地址: https://lists.cncf.io/g/cncf-cloudevents/topics

## 会议时间

会议日期请查看 [CNCF 公开活动日历](https://www.cncf.io/community/calendar/).
CloudEvents规范由
[CNCF Serverless 工作组](https://github.com/cncf/wg-serverless) 开发完成。
这个工作组每周四的上午9点(美国-太平洋时间)通过Zoom开展视频会议。
通过 PC, Mac, Linux, iOS or Android来参加活动: https://zoom.us/my/cncfserverlesswg

或者通过 iPhone one-tap :

US: +16465588656,,3361029682# or +16699006833,,3361029682#

或者电话接入:

Dial:
US: +1 646 558 8656 (US Toll) or +1 669 900 6833 (US Toll)
or +1 855 880 1246 (Toll Free) or +1 877 369 0926 (Toll Free)

会议 ID: 336 102 9682

国际号码接入:
https://zoom.us/zoomconference?m=QpOqQYfTzY_Gbj9_8jPtsplp1pnVUKDr

世界时区转化器:
http://www.thetimezoneconverter.com/?t=9:00%20am&tz=San%20Francisco&

## 会议记录

历史会议记录在
[这里](https://docs.google.com/document/d/1OVF68rpuPK5shIHILK9JOqlZBbfe91RNzQ7u_P7YCDE/edit#)
查看。

历史会议录像在
[这里](https://www.youtube.com/playlist?list=PLj6h78yzYM2Ph7YoBIgsZNW_RGJvNlFOt)
查看。

工作组会定期举办与主流会议一致的线下会议。查看[这里](https://docs.google.com/document/d/1OVF68rpuPK5shIHILK9JOqlZBbfe91RNzQ7u_P7YCDE/edit#)
了解更多未来计划。

Loading