Skip to content

Commit

Permalink
fix links
Browse files Browse the repository at this point in the history
Signed-off-by: JieDing <dingjwilliams@gmail.com>
  • Loading branch information
JieDing committed Nov 21, 2021
1 parent dd23d75 commit f68a957
Showing 1 changed file with 45 additions and 45 deletions.
90 changes: 45 additions & 45 deletions cloudevents/translated/zh-cn/spec_CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,15 +10,15 @@ CloudEvents 是一个用于定义事件格式的供应商中立规范。

## 目录

- [概览](#概览)
- [符号和术语](#符号和术语)
- [上下文属性](#上下文属性)
- [事件数据](#事件数据)
- [大小限制](#大小限制)
- [隐私与安全](#隐私与安全)
- [示例](#示例)
- [概览](#overview)
- [符号和术语](#notations-and-terminology)
- [上下文属性](#context-attributes)
- [事件数据](#event-data)
- [大小限制](#size-limits)
- [隐私与安全](#privacy-and-security)
- [示例](#exmaple)

## 概览
## Overview/概览

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

Expand All @@ -36,9 +36,9 @@ CloudEvents是一个以通用格式来描述事件数据的标准。它提供了
有关规范背后的历史、开发和设计原理等更多信息,
请参阅 CloudEvents [入门文档](primer_CN.md)

## 符号和术语
## Notations and Terminology/符号和术语

### 符号约定
### Notational Conventions/符号约定

本文档中的关键词
"MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD",
Expand All @@ -47,63 +47,63 @@ CloudEvents是一个以通用格式来描述事件数据的标准。它提供了

为清楚起见,
当一个功能被标记为“OPTIONAL”时,这意味着消息的
[生产者](#生产者)[消费者](#消费者) 都可以自行选择是否支持该功能。
[生产者](#producer)[消费者](#consumer) 都可以自行选择是否支持该功能。
换句话说,生产者可以在需要时在消息中包含该功能,消费者也可以在需要时选择支持该功能。
不支持该功能的消费者将默默地忽略该部分消息。
生产者需要做好消费者并没有启用该功能的准备。
[中间人](#中间人) 应当转发OPTIONAL属性。
[中间人](#intermediary) 应当转发OPTIONAL属性。

### 术语

本规范定义了下列术语

#### 发生
#### Occur/发生

“发生”是指在软件系统运行期间对事实状态的捕获。
这可能是由于系统发出了信号或系统观察到信号、状态更改、计时器超时
或任何其他值得注意的活动而发生的。
例如,设备可能会因为电池电量低或虚拟机即将执行计划的重启而进入警报状态。

#### 事件
#### Event/事件

“事件”是表示一条"发生"及其上下文的数据记录。
事件从事件生产者(源)路由到对它感兴趣的事件消费者。
事件中包含的信息帮助完成路由操作,但事件不会标识特定的路由目的地。
事件将包含两种类型的信息:表示"发生"的 [事件数据](#事件数据)
和提供有关事件的环境信息的[上下文](#上下文) 元数据。
事件将包含两种类型的信息:表示"发生"的 [事件数据](#event-data)
和提供有关事件的环境信息的[上下文](#context) 元数据。
一次"发生"可能导致多个事件的产生。

#### 生产者
#### Producer/生产者

“生产者”是一种特定的实例、进程或设备,它能够创建用来描述CloudEvent的数据结构。

####
#### Source/

"源"是事件发生的上下文环境。在分布式系统中,它可能由多个[生产者](#生产者)组成。
"源"是事件发生的上下文环境。在分布式系统中,它可能由多个[生产者](#producer)组成。
如果一个源无法查看到CloudEvents,那么一定有有外部的生产者在代替源来生产CloudEvent。

#### 消费者
#### Consumer/消费者

一个“消费者”会接收事件并根据事件采取一定的行为。
它使用上下文环境和事件数据来执行一些逻辑,这可能会导致新事件的发生。

#### 中间人
#### Intermediary/中间人

一个“中间人”会接收包含事件的消息,
并将其转发给下一个接收者,但该接收者可能是另一个中间人或事件[消费者](#消费者)
中间人的典型任务就是根据[上下文](#上下文)环境中的信息将事件路由到接收者。
并将其转发给下一个接收者,但该接收者可能是另一个中间人或事件[消费者](#consumer)
中间人的典型任务就是根据[上下文](#context)环境中的信息将事件路由到接收者。

#### 上下文
#### Context/上下文

上下文环境元数据被封装在[上下文-属性](#上下文属性)中。
上下文环境元数据被封装在[上下文-属性](#context-attributes)中。
工具和应用程序代码可以使用此信息来识别事件与系统方面或事件与其他事件的关系。

#### 数据
#### Data/数据

关于事件的特定域信息(即有效负载)。这可能包括有关事件的信息、有关已更改数据的详细信息等。
有关更多信息,请参阅[事件数据](#事件数据)部分。
有关更多信息,请参阅[事件数据](#event-data)部分。

#### 事件格式
#### Event Format/事件格式

一个事件格式会指定如何将 CloudEvent 序列化为字节序列。
独立事件格式(例如 [JSON 格式](../../formats/json-format.md))指定独立于任何协议或存储介质的序列化。
Expand All @@ -127,11 +127,11 @@ CloudEvents是一个以通用格式来描述事件数据的标准。它提供了

协议绑定描述了如何通过给定的协议发送和接收事件。

协议绑定可以选择使用[Event Format](#事件格式)
协议绑定可以选择使用[Event Format](#event-format)
将事件直接映射到传输包的正文,或者可以为包提供额外的格式和结构。
例如,可以使用结构化模式消息的包装器,或者可以将多个消息一起批处理到传输包正文中。

## 上下文属性
## Context Attributes/上下文属性

每个符合本规范的 CloudEvent 必须包括指定为 REQUIRED 的上下文属性,
可以包括一个或多个OPTIONAL上下文属性,
Expand All @@ -140,7 +140,7 @@ CloudEvents是一个以通用格式来描述事件数据的标准。它提供了
这些属性虽然描述了事件,但被设计为可以独立于事件数据进行序列化。
这允许在不反序列化事件数据的情况下,在目的检查这些上下文属性。

### 属性命名约定
### Attribute Naming Convention/属性命名约定

CloudEvents 规范定义了到各种协议和编码的映射,随附的 CloudEvents SDK 面向各种运行时和编程语言。
其中一些将元数据元素区分大小写,而另一些则不区分,
Expand All @@ -150,7 +150,7 @@ CloudEvents 规范定义了到各种协议和编码的映射,随附的 CloudEv
CloudEvents 属性名称必须由来自 ASCII 字符集的小写字母(“a”到“z”)或数字(“0”到“9”)组成。
属性名称应该是描述性的和简洁的,并且长度不应超过 20 个字符。

### 类型系统
### Type System/类型系统

以下抽象数据类型可用于属性。
这些类型中的每一种都可以由不同的事件格式和协议元数据字段以不同的方式表示。
Expand Down Expand Up @@ -275,7 +275,7 @@ CloudEvents 协议绑定或事件格式实现同样必须能够
- 描述: 该属性包含一个值,描述与原始事件相关的事件类型。
该属性通常用于路由、可观察性、策略实施等。其格式是生产者定义的,可能包括诸如 `type`版本之类的信息
-从
[入门文档-属性版本控制](primer_CN.md#属性版本控制) 中获得更多信息。
[入门文档-属性版本控制](primer_CN.md#versioning-of-cloudevents) 中获得更多信息。

- 约束条件:
- 必要的
Expand All @@ -288,7 +288,7 @@ CloudEvents 协议绑定或事件格式实现同样必须能够
### 可选属性

下列属性在 CloudEvents 中是可选的. 在
[符号约定](#符号约定) 中查看更多 OPTIONAL 定义的信息。
[符号约定](#notational-conventions) 中查看更多 OPTIONAL 定义的信息。


#### datacontenttype
Expand Down Expand Up @@ -326,7 +326,7 @@ CloudEvents 协议绑定或事件格式实现同样必须能够

- 类型: `URI`
- 描述: 标识 `data` 遵守的规范。 对模式的不兼容的更改应该由不同的 URI 体现。 在
[入门文档-属性版本控制](primer_CN.md#属性版本控制)
[入门文档-属性版本控制](primer_CN.md#versioning-of-cloudevents)
中查看更多信息。
- 约束条件:
- 可选的
Expand Down Expand Up @@ -371,11 +371,11 @@ CloudEvents 协议绑定或事件格式实现同样必须能够
- 若有则必须遵守
[RFC 3339](https://tools.ietf.org/html/rfc3339)

### 扩展上下文属性
### Extension Context Attributes/扩展上下文属性

CloudEvent 可以包含任意数量的具有不同名称的附加上下文属性,被称为"扩展属性"。
扩展属性必须遵循相同的[命名约定](#属性命名约定)并使用与标准属性相同的
[类型系统](#类型系统)
扩展属性必须遵循相同的[命名约定](#attribute-naming-convention)并使用与标准属性相同的
[类型系统](#type-system)
扩展属性在本规范中没有定义好的含义,
它们允许外部系统将元数据附加到事件,就像 HTTP 自定义头部一样。

Expand All @@ -387,7 +387,7 @@ CloudEvent 可以包含任意数量的具有不同名称的附加上下文属性
#### 定义扩展

[CloudEvent-属性扩展](primer_CN.md#CloudEvent属性扩展)
[CloudEvent-属性扩展](primer_CN.md#cloudevent-attribute-extensions)
查阅有关扩展使用和定义等相关信息。

扩展的定义应该完全定义属性的方方面面——例如 它的名称、类型、语义含义和可能的值。
Expand All @@ -408,9 +408,9 @@ CloudEvent 可以包含任意数量的具有不同名称的附加上下文属性
以便事件消费者可以轻松访问此信息,而无需解码和检查事件数据。
此类身份属性还可用于帮助中间网关确定如何路由事件。

## 事件数据
## Event Data/事件数据

正如[数据](#数据)所定义的那样,CloudEvents 可以包括有关事件的特定域的信息。
正如[数据](#data)所定义的那样,CloudEvents 可以包括有关事件的特定域的信息。
这些信息将被封装在`data`中。

- 描述: 事件负载。 本规范对该信息的类型不作任何限制。
Expand All @@ -420,7 +420,7 @@ CloudEvent 可以包含任意数量的具有不同名称的附加上下文属性
- 约束条件:
- 可选的

# 大小限制
# Size Limits/大小限制

在很多情况下,CloudEvents 将通过一个或多个通用中间人进行转发,
每个中间人都可能对转发事件的大小施加限制。
Expand All @@ -446,7 +446,7 @@ CloudEvents 也可能直接被路由到消费者,如嵌入式设备,
因为通过解析链接访问与事件相关的细节能实现差异化访问控制和选择性披露,
而不是将敏感详细数据直接嵌入到事件中。

# 隐私与安全
# Privacy and Security/隐私与安全

互操作性是本规范背后的主要驱动力,
实现此目标需要一些信息明确可用,这可能导致信息的泄漏。
Expand All @@ -461,13 +461,13 @@ CloudEvents 也可能直接被路由到消费者,如嵌入式设备,

- 数据

特定的[事件数据](#事件数据) 应该被加密以限制对受信任方的可见性。
特定的[事件数据](#event-data) 应该被加密以限制对受信任方的可见性。
用于这种加密的机制是生产者和消费者之间的协议,不在本规范的讨论范围内。

- 协议绑定
应该采用协议级别的安全性机制来确保 CloudEvents 完成可信和安全的交换。

# 示例
# Exmaple/示例


The following example shows a CloudEvent serialized as JSON:
Expand Down

0 comments on commit f68a957

Please sign in to comment.