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

update cn master class #286

Merged
merged 2 commits into from
Mar 14, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
15 changes: 3 additions & 12 deletions docs/.vuepress/config.js
Original file line number Diff line number Diff line change
Expand Up @@ -79,10 +79,6 @@ module.exports = {
text: 'Operation',
link: '/operation/'
},
{
text: 'Incubation Center',
link: '/incubation/'
},
{
text: 'Master',
link: '/master/'
Expand Down Expand Up @@ -169,7 +165,7 @@ module.exports = {
],
'/master/': [
{
title: 'Master',
title: 'Master Course',
collapsable: false,
children: [
['', 'Overview'],
Expand Down Expand Up @@ -206,10 +202,6 @@ module.exports = {
text: '运维',
link: '/zh/operation/'
},
{
text: '孵化器',
link: '/zh/incubation/'
},
{
text: 'Master',
link: '/zh/master/'
Expand Down Expand Up @@ -301,11 +293,10 @@ module.exports = {
],
'/zh/master/': [
{
title: 'Master',
title: '大师课',
collapsable: false,
children: [
['', '概述'],
['Course_introduction.md', '大师课程'],
['', '目录'],
['Intro_to_Venus.md', 'Venus概要'],
['Chain_service_construction.md', '部署链服务'],
['Daily_op_and_maintenance.md', '节点日常运维'],
Expand Down
17 changes: 11 additions & 6 deletions docs/zh/master/Chain_service_construction.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,11 @@
# Venus的链服务搭建

便于集群的横向扩展是Venus的设计初衷,Venus团队致力于用户更加简单的运维自己的集群。
Venus系统的实现采用了微服务架构,将各部分重复的功能解耦出来,形成不同的组件。根据部署方式和功能的不同,划分为链服务组件和独立组件。
在Veuus的实现中,一套链服务可以服务多个集群,链服务可以由服务商或多个存储提供者联合搭建,每个接入链服务的存储提供者仅需将精力放在独立组件上,即算力的增长与维持。

在Venus系统中,链服务层的正常运行显得尤为重要,一旦服务异常就可能导致多个集群故障。此文档就如何搭建链服务进行介绍。
Venus系统的实现采用了微服务架构,将各部分重复的功能解耦出来,形成不同的组件。根据部署方式和功能的不同,划分为链服务组件和本地组件。
在Veuus的实现中,一套链服务可以服务多个集群,链服务可以由服务商或多个存储提供者联合搭建,每个接入链服务的存储提供者仅需将精力放在本地组件上,即算力的增长与维持。

</br>
在Venus系统中,链服务层的正常运行显得尤为重要,一旦服务异常就可能导致多个集群故障。此文档就如何搭建链服务进行介绍。

## 硬件要求

Expand All @@ -19,8 +18,6 @@ Venus系统的链服务负责链的区块同步、各集群消息打包、出块

在通常情况下,一套链服务可服务于多个集群,因为需要预防单点故障,所以链服务的每个组件都至少有主备或负载均衡。

</br>

## 软件环境

Ubuntu:
Expand Down Expand Up @@ -410,3 +407,11 @@ $ ./venus-miner address update
}
]
```

## 使用链服务

请学习参见[这个](/guide/Using-venus-Shared-Modules.html)文档。

## 接收存储订单

请学习参见[这个](https://github.com/filecoin-project/venus/discussions/4735)文档。
20 changes: 12 additions & 8 deletions docs/zh/master/Intro_to_Venus.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,29 @@
## Venus 矿池架构
## Venus架构

&ensp;&ensp;Venus架构设计中包括 *[‘venus](https://github.com/filecoin-project/venus)、[venus-auth](https://github.com/filecoin-project/venus-auth)、[venus-miner](https://github.com/filecoin-project/venus-miner)、[venus-messager](https://github.com/filecoin-project/venus-messager)、[venus-gateway](https://github.com/ipfs-force-community/venus-gateway)、[venus-wallet](https://github.com/filecoin-project/venus-wallet)、[venus-sealer](https://github.com/filecoin-project/venus-sealer)* ,以及 *[‘venus-market](https://github.com/filecoin-project/venus-market)*。以功能划分纬度,将所有组件分为**共享组件(链服务)和独立组件**,这样在很大程度上解放了存储提供者的一些精力,不再被消息无法上链、区块同步错误等问题纠缠,而拥有技术实力及硬件资源的服务商可以搭建共享组件给分布在全球各地的存储提供者提供服务,从中获取一定的服务费用等。当然,如果存储提供者自身拥有多个集群并有一定技术能力,完全可以自行搭建链服务。
Venus架构设计中包括 [venus](https://github.com/filecoin-project/venus)、[venus-auth](https://github.com/filecoin-project/venus-auth)、[venus-miner](https://github.com/filecoin-project/venus-miner)、[venus-messager](https://github.com/filecoin-project/venus-messager)、[venus-gateway](https://github.com/ipfs-force-community/venus-gateway)、[venus-wallet](https://github.com/filecoin-project/venus-wallet)、[venus-sealer](https://github.com/filecoin-project/venus-sealer)(未来将被`venus-cluster`代替),[venus-cluster](https://github.com/ipfs-force-community/venus-cluster),以及 [venus-market](https://github.com/filecoin-project/venus-market)。以功能划分纬度,将所有组件分为**链服务组件和本地组件**,这样在很大程度上解放了存储提供者的一些精力,不再被消息无法上链、区块同步错误等问题纠缠,而拥有技术实力及硬件资源的服务商可以搭建共享组件给分布在全球各地的存储提供者提供服务,从中获取一定的服务费用等。当然,如果存储提供者自身拥有多个集群并有一定技术能力,完全可以自行搭建链服务。

&ensp;&ensp;下图是设想中的一个典型的应用场景,在此场景中一套独立组件(venus-sealer、venus-worker、venus-wallet)负责一个集群的算力增长与维持,而这样的集群是很方便横向扩展的。
下图是设想中的一个典型的应用场景,在此场景中一套独立组件(venus-sealer/venus-cluster、venus-worker、venus-wallet)负责一个集群的算力增长与维持,而这样的集群是很方便横向扩展的。

![](../../.vuepress/public/venus-cluster.png)

> 现阶段venus-market仅服务于单个集群,在不久的将来,将会成为服务组件的一部分,即一个venus-market可以服务多个集群。
:::tip

venus-market v2不仅可以服务于单个集群,还能作为链服务组件的一部分部署,即一个venus-market可以服务多个集群。

:::

Venus与Lotus组件间的对应关系如下所示,在实现了Lotus功能的基础上均有所扩展:
`Venus`与`Lotus`组件间的对应关系如下所示,在实现了Lotus功能的基础上均有所扩展:

* venus daemon --> lotus daemon
* venus-auth --> token authentication service extend lotus jwt
* venus-miner --> lotus-miner block produce part & multi miner
* venus-messager --> lotus mpool
* venus-wallet -> lotus wallet part
* venus-sealer --> lotus-miner sealer scheduler part/wd
* venus-market --> lotus-miner market part
* venus-sealer/venus-cluster --> lotus-miner sealer scheduler part/wd
* venus-market --> lotus-market node
* venus-worker --> lotus-worker


## Venus 如何工作

&ensp;&ensp;有关每个venus组件如何工作的更多信息,请阅读此文档 [here](https://venus.filecoin.io/zh/guide/#venus如何工作).
有关每个venus组件如何工作的更多信息,请阅读此文档 [here](https://venus.filecoin.io/zh/guide/#venus如何工作).
6 changes: 2 additions & 4 deletions docs/zh/master/Q&A.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,11 @@
# 答疑篇

用户在接入[Filecoin存储提供者孵化中心](https://venus.filecoin.io/zh/incubation/Rules.html)的过程或集群日常运维中,会遇到各种各样的问题,为了快速定位、高效解决问题,对已经遇到过的问题
用户在接入[Filecoin存储提供者孵化中心](https://venushub.io/incubator)的过程或集群日常运维中,会遇到各种各样的问题,为了快速定位、高效解决问题,对已经遇到过的问题
记录在案是必要的。根据功能模块的不同,我们将问题归为两类:

- 链服务的问题
- 独立组件的问题

</br>

## 链服务的问题

**1、** Venus共享组件报错`ERROR: must set url or token`,或者提示
Expand Down Expand Up @@ -160,4 +158,4 @@ INFO storageminer storage/wdpost_run.go:863 Submitted window post: 06df4a21-a0b7

### venus-cluster

> 目前正在测试中,预计在一个月后发布源码及使用文档
`venus-cluster`相关问题,请在 [#fil-venus-cn](https://filecoinproject.slack.com/archives/C028PCH8L31) 阅览相关聊天记录。特别是 [@dtynn大神](https://filecoinproject.slack.com/team/UMK2CF76W) 关于cluster的相关发言
37 changes: 7 additions & 30 deletions docs/zh/master/README.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,13 @@
## Venus Masters奖励计划第1阶段介绍
### 目录

“[Filecoin存储提供者孵化中心](https://venus.filecoin.io/zh/incubation/Rules.html)”汇集了Filecoin基金会和Venus团队的资源,为中小型存储提供者提供资金和技术支持。这样做的目的是通过降低准入门槛,让小型存储提供者加入网络变得更为简单方便,其有两种参与方式(两个子项目):“孵化中心”、“Venus
Masters”。
1. [Venus的分布式存储池介绍](Intro_to_Venus.md)

“孵化中心”第1阶段已有来自欧洲、亚洲、北美洲的数个节点正在稳定运行,在第二阶段启动前我们将先启动”Venus Masters”第1阶段的准备工作,以便Venus Masters可以在“孵化中心”第2阶段启动时顺利开始工作。
2. [部署/加入链服务](Chain_service_construction.md)

要成为Venus Master,参与者必须凭借对Filecoin代码和存储服务的经验不断为Filecoin网络的发展做出贡献。选定的Master将为“孵化中心”的参与者提供咨询服务和技术支持,以帮助存储提供者能够成功运行并继续扩大存储服务。
3. [节点日常运维](Daily_op_and_maintenance.md)

## Venus Masters的工作
4. [答疑](Q&A.md)

1、为孵化中心的存储提供者(预计五名)提供服务:包括帮助他们使用Venus独立组件(venus-sealer、venus-wallet)连接到孵化中心的分布式存储池,以提供更多存储资源。
5. [节点迁出指南](Incubation_exit_guide.md)

2、至少在本项目的一个完整的阶段提供服务。

3、在调试或版本升级过程中与服务的参与者同步情况,在接到通知后做好必要的准备工作。

4、与Venus开发团队协调测试,以验证版本升级期间的服务质量。

5、就他们使用的工具/实施提供反馈,以确保持续改进Venus存储提供者的经验。

6、提供生产力和负载均衡方面的反馈和建议,如能源消耗、成本效率等。

## 回馈

“Filecoin存储提供者孵化中心”为多个阶段所有Masters提供了1000+FIL的奖励池,这些FIL将根据服务的长度和质量进行分配。在每个阶段结束时,Masters可以选择通过申请继续加入下一阶段,继续他们的工作。

## 如何成为Venus Masters

申请加入Venus Masters奖励计划,请尽可能详细的填写此[申请表](http://venusteam.mikecrm.com/KWWYu0F)。

第1阶段的申请周期为9月20日至10月10日。除了目前已经发布的Venus使用文档,我们将在接下来发布一系列文档以帮助Venus Masters更好的工作。通过审核的Master可以在10月31之前完成文档的学习,并在Venus团队提供的测试网络完成测试工作。

通过学习及测试工作,最终将选定3名Master,在11月初开始工作,工作周期与孵化中心第二阶段一致。

如果有任何疑问,可以通过电子邮件(venus@ipfsforce.com)或Filecoin Slack:[fil-venus](https://filecoinproject.slack.com/archives/CEHHJNJS3)联系Venus团队。
如有更多疑问,请通过[Slack](https://filecoinproject.slack.com/archives/C028PCH8L31)联系我们,或发送邮件至[venus@ipfsforce.com](mailto:venus@ipfsforce.com)。