Merge pull request #347 from swordqiu/automated-cherry-pick-of-#346-u…

…pstream-release-3.11 Automated cherry pick of #346: fix: add nfs storage docs
yunionio · Aug 1, 2024 · f744b03 · f744b03
2 parents 7fefe95 + 794030e
commit f744b03
Show file tree

Hide file tree

Showing 2 changed files with 38 additions and 9 deletions.
diff --git a/docs/guides/onpremise/storage/blockstorage/index.mdx b/docs/guides/onpremise/storage/blockstorage/index.mdx
@@ -14,19 +14,19 @@ sidebar_position: 1
 
 * 自定义接口：文件接口和快接口都是Linux操作系统的标准接口，除此之外，平台支持的访问虚拟磁盘的接口为Ceph RBD，是Ceph自定义的访问其分布式块设备的接口。
 
-从存储的部署架构，分为如下几类：
+根据存储的部署架构分为如下几类：
 
 * 本地访问：虚拟机磁盘存储在宿主机本地挂载的存储上，例如本地的SATA, SAS或NVME块设备
 * 网络访问：虚拟机磁盘存储在宿主机网络挂载的集中式存储上，例如NFS，GPFS，OCFS2等
 * 分布式访问：虚拟机磁盘不存储在本地或网络上的具体存储节点上，而是分布式在多个节点上，例如Ceph。
 
-因此，块存储从访问接口和部署架构，分为如下几类。
+因此，块存储从访问接口和部署架构两个维度，分为如下几类。
 
-| 访问接口\部署架构        |  本地访问           | 集中式网络访问       | 去中心分布式访问 |
-|----------------|-------------------|--------------------|----------------|
-| 文件接口        | 本地存储            | NAS                |                |
-| 块接口          | 本地LVM            | cLVM               |                |
-| 自定义接口       |                   |                    | Ceph RBD       |
+| 访问接口\部署架构 |  本地访问      | 集中式网络访问 | 去中心分布式访问 |
+|----------------|-------------------|--------------|----------------|
+| 文件接口       | 本地存储          | NAS          |                |
+| 块接口         | 本地LVM           | LVMLockd     |                |
+| 自定义接口     |                   |              | Ceph RBD       |
 
 ## 支持存储类型
 
@@ -40,16 +40,20 @@ NAS存储使用网络挂载的文件系统存储虚拟机的磁盘文件。目
 
 #### NFS
 
-NFS类型的块存储特指通过NFS协议挂载的网络共享文件系统。这一类存储需要指定共享的服务器IP和共享目录。将宿主机和存储关联后，host服务会自动以NFS协议挂载该存储到宿主机的指定目录，无需提前手动挂载。
+NFS类型的块存储特指通过NFS协议挂载的网络共享文件系统。这一类存储需要指定共享的服务器IP和共享目录。将宿主机和存储关联后，host服务会自动以NFS协议挂载该存储到宿主机的指定目录，无需提前手动挂载。具体配置和使用方法参考 [NFS](./nfs)。
 
-#### GPFS
+#### GPFS(NAS)
 
 GPFS用于指定用户已经手动提前挂载到宿主机的任意网络共享文件系统，并不仅限于GPFS，还包括OCFS2，GlusterFS等网络文件系统。创建一个GPFS类型的块存储的意义更多是用于将存储的配置信息提供给平台，便于后续使用。跟NFS存储不同，将该存储挂载到宿主机的操作，其作用仅是告知平台该存储在宿主机的访问路径，平台并不会自动执行挂载。只要是用户自己执行挂载的网络文件系统，都可以注册为GPFS类型的块存储。
 
 ### 本地LVM
 
 本地LVM是使用宿主机本机的LVM VG分配逻辑卷给虚拟机作为虚拟磁盘的块存储。具体配置和使用方法参考 [本机LVM存储](./lvm-storage)。
 
+### 共享LVM
+
+共享LVM是将共享网络块设备挂载到多台宿主机上，并将该共享块设备加入共享LVM VG，从共享VG上分配LV给虚拟机使用。具体配置和使用方法参考 [LvmLockd](./lvmlockd)。
+
 ### Ceph
 
 Ceph是使用Ceph RBD块设备作为虚拟机的虚拟磁盘。具体配置和使用方法参考 [Ceph](./ceph)

diff --git a/docs/guides/onpremise/storage/blockstorage/nfs.md b/docs/guides/onpremise/storage/blockstorage/nfs.md
@@ -0,0 +1,25 @@
+---
+sidebar_position: 5
+---
+
+# NFS 存储
+
+本文介绍如何配置和使用NFS存储。
+
+NFS存储是一种NAS存储，跟其他NAS存储的区别是：平台配置了NFS并关联宿主机后，会自动将NFS目录挂载到宿主机的指定目录上，不需要用户提前挂载。因此要求宿主机上安装了NFS客户端的软件（一般是nfs-utils）。
+
+## 指定挂载NFS存储的参数
+
+宿主机使用如下命令挂载NFS存储，无法传入额外的NFS存储挂载参数，但可能存在默认NFS挂载参数不适合该NFS存储的情况。
+
+```
+mount -t nfs 192.168.2.1:/export/nfsdata /opt/cloud/workspace/nfsdisks
+```
+
+如果用户需要指定NFS的挂载参数，可以修改改宿主机的 /etc/nfsmount.conf 来指定nfs挂载参数，例如：
+
+```
+# cat /etc/nfsmount.conf |grep -v '#'
+[ NFSMount_Global_Options ]
+nolock=True
+```