iomesh / docs Goto Github PK

按照https://docs.iomesh.com 的文档部署iomesh成功
但是pod绑定pvc过程中csi-driver一直卡在mkfs /dev/sda
DESCRIBE POD出现错误信息：“mke2fs is apparently in use by the system will not make a filesystem here”
chart版本：iomesh-v0.10.1.tgz operator-v0.10.1.tgz csi-driver-2.1.1.tgz

可参考 openebs https://openebs.io/docs/faqs/general ，不过他们的总体比较乱，我们需要做 FAQ 分类

大部分 flavor 的 Markdown 语法中都会描述列表条目下的内容应如何缩进，举个栗子：

To add another element in a list while preserving the continuity of the list, indent the element four spaces or one tab.

https://www.markdownguide.org/basic-syntax/#adding-elements-in-lists

以 IOMesh 文档为例，截图中红色箭头所指处当前没有缩进：

添加缩进后（four spaces），在 Github Preview 的效果如下，在 Docusaurus 中会有类似效果：

Setup Open-ISCSI

1. Install open-iscsi:

   sudo yum install iscsi-initiator-utils -y

   sudo apt-get install open-iscsi -y

2. Edit /etc/iscsi/iscsid.conf by setting node.startup to manual:

   sudo sed -i 's/^node.startup = automatic$/node.startup = manual/' /etc/iscsi/iscsid.conf

3. Disable SELinux:

   sudo setenforce 0
   sudo sed -i 's/^SELINUX=enforcing$/SELINUX=permissive/' /etc/selinux/config

4. Start iscsid service:

   sudo systemctl enable --now iscsid

I hope this is of a little help. ;-)

增加对 Ubuntu，Centos8 等平台的支持。

relate: iomesh/zbs-operator#101

1. trigger ci when pull request
2. release to github page when merged

先 cachewithjournal，后 datastore

目前监控部分比较简略，需要补充如下内容：

需要罗列具体操作步骤

1. 如何部署到集群
2. 如何监控iomesh，怎么配置
3. 有哪些指标可监控
4. 在哪查看监控结果

现有文档大量的升级操作已过期

• csi version should be updated to 2.0
• add a new matrix for openshift 3.11 and openshift 4.5

文档中描述修改iomesh.yaml的version字段，但是yaml文件中没有version字段。需要重新写一下这块

v1.xxx 官方早已不推荐使用

IMPORTANT: this is the documentation of Docusaurus v1.
We now recommend using Docusaurus 2 instead!

https://docusaurus.io/docs/migration

目前的磁盘配置文档只有一些粗略的例子，对不熟悉 K8s Selector + Label 机制的用户会造成困惑导致无法灵活使用。

待改进
需要明确的让用户知道 IOMesh 磁盘挂载方式的原理，以及 selector 中配置的 label 应该是从 blockDevice 的 label 中查找。

目前只有 iomesh 升级文档，没有 operator 升级文档

将鉴权使用的 secret 和认证使用的 secret 做明显区分

iscsi-initiator-utils >= 6.2.0.874

低版本 open-iscsi 功能不齐全 IOMesh 无法正常运行，例如 6.2.0.873 缺少自动扫描相关皮质

需要补充：

• 磁盘规划
• 挂载详细指南
• 增加更多示例
• 全闪挂载

• meta pod: 0.6 Core / 2G RAM
• zookeeper pod: 0.4 Core / 2G RAM
• chunk pod: 3 Core / 5G RAM
• 其他 pod 合集：1 Core / 1G RAM

目前：iomesh.com/iscsi-lun-iqn-allow-list field is ""，
我以为是把值删除就可以，麻烦再强调一下要设置上引号，光删除后报错不会生效。

避免 30 天到期导致集群问题造成用户疑惑和 oncall 事项，官方应该建议用户安装完毕尽快申请 license

需要补充：

• 网络规划及拓扑
• 更多示例

helm install --namespace iomesh-system --create-namespace iomesh-system my-zbs-operator iomesh/zbs-operator --version 0.1.0
改为
helm install --namespace iomesh-system --create-namespace my-zbs-operator iomesh/zbs-operator --version 0.1.0
去掉 --create-namespace 后面的参数