nfs-server

.vuepress/components/HomePage.vue

@@ -70,6 +70,7 @@
           <li>Kubernetes 管理界面</li>
           <li>微服务参考架构</li>
           <li>无需手写 YAML</li>
+          <li><a href="/install/install-dashboard.html">安装Kuboard</a></li>
         </p>
       </el-card>
       <div class="intro_picture">

.vuepress/config.js

@@ -278,7 +278,7 @@ module.exports = {
                 'k8s-intermediate/persistent/volume',
                 'k8s-intermediate/persistent/pv',
                 'k8s-intermediate/persistent/storage-class',
-                // 'k8s-intermediate/persistent/nfs',
+                'k8s-intermediate/persistent/nfs',
               ]
             },
             {

guide/example/import.md

@@ -16,6 +16,10 @@ description: 通过Kuboard将一个预先定义好的SpringCloud微服务样例
 
 example中用到了存储卷声明，请在 Kuboard 中 [创建存储类](/guide/cluster/storage.html?id=创建存储类) ，否则不能完成 example 的导入操作。
 
+::: tip
+许多网友自己搭建 NFS 测试环境，再创建 NFS存储类，经常碰到 `access denied` 这类权限问题。为了帮助大家更快地完成 NFS 测试环境搭建，Kuboard提供了一篇NFS相关的简明文档，请参考 [搭建NFS Server](/learning/k8s-intermediate/persistent/nfs.html)
+:::
+
 ## 创建名称空间
 
 创建新的名称空间，用来导入 exmaple。可参考 [创建名称空间](/guide/cluster/namespace.html?id=创建名称空间)

guide/example/monitor.md

@@ -27,6 +27,10 @@ description: 使用Kuboard在Kubernetes上安装监控套件，并对example微
 
 ### 安装全局监控套件
 
+::: tip
+许多网友自己搭建 NFS 测试环境，再创建 NFS存储类，经常碰到 `access denied` 这类权限问题。为了帮助大家更快地完成 NFS 测试环境搭建，Kuboard提供了一篇NFS相关的简明文档，请参考 [搭建NFS Server](/learning/k8s-intermediate/persistent/nfs.html)
+:::
+
 * 在 master 节点执行
 
 ```bash

learning/k8s-intermediate/persistent/nfs.md

@@ -1,14 +1,106 @@
 ---
 vssueId: 91
 layout: LearningLayout
-description: Kubernetes教程_本文描述如何搭建NFS服务_并在Kubernetes中配置StorageClass使用该NFS服务作为存储
+description: Kubernetes教程_本文描述如何在CentOS上搭建NFS_server_并在Kubernetes中配置StorageClass使用该NFS服务作为存储
 meta:
   - name: keywords
-    content: Kubernetes教程,K8S教程,StorageClass
+    content: Kubernetes教程,K8S教程,StorageClass,docker nfs server
 ---
 
-# 搭建NFS服务
+# 搭建NFS Server
 
-本文描述如何搭建 NFS 服务，仅用于测试
+## 背景
 
-正在撰写...
+Kubernetes 对 Pod 进行调度时，以当时集群中各节点的可用资源作为主要依据，自动选择某一个可用的节点，并将 Pod 分配到该节点上。在这种情况下，Pod 中容器数据的持久化如果存储在所在节点的磁盘上，就会产生不可预知的问题，例如，当 Pod 出现故障，Kubernetes 重新调度之后，Pod 所在的新节点上，并不存在上一次 Pod 运行时所在节点上的数据。
+
+为了使 Pod 在任何节点上都能够使用同一份持久化存储数据，我们需要使用网络存储的解决方案为 Pod 提供 [数据卷](./volume.html)。常用的网络存储方案有：NFS/cephfs/glusterfs。
+
+本文介绍一种使用 centos 搭建 nfs 服务器的方法。此方法<font color="red">仅用于测试目的</font>，请根据您生产环境的实际情况，选择合适的 NFS 服务。
+
+## 配置要求
+
+* 两台 linux 服务器，centos 7
+  * 一台用作 nfs server
+  * 另一台用作 nfs 客户端
+
+## 配置NFS服务器
+
+::: tip
+本章节中所有命令都以 root 身份执行
+:::
+
+* 执行以下命令安装 nfs 服务器所需的软件包
+  ``` sh
+  yum install -y nfs-utils
+  ```
+* 执行命令 `vim /etc/exports`，创建 exports 文件，文件内容如下：
+  ```
+  /root/nfs_root/ *(insecure,rw,sync,no_root_squash)
+  ```
+* 执行以下命令，启动 nfs 服务
+  ```sh
+  systemctl enable rpcbind
+  systemctl enable nfs-server
+
+  systemctl start rpcbind
+  systemctl start nfs-server
+  exportfs -r
+  ```
+* 检查配置是否生效
+  ```sh
+  exportfs
+  # 输出结果如下所示
+  /home/nfs <world>
+  ```
+
+## 在客户端测试nfs
+
+::: tip
+本章节中所有命令都以 root 身份执行
+:::
+
+* 执行以下命令安装 nfs 客户端所需的软件包
+  ``` sh
+  yum install -y nfs-utils
+  ```
+
+* 执行以下命令检查 nfs 服务器端是否有设置共享目录
+  ``` sh
+  # showmount -e $(nfs服务器的IP)
+  showmount -e 172.17.216.82
+  # 输出结果如下所示
+  Export list for 172.17.216.82:
+  /root/nfs_root *
+  ```
+* 执行以下命令挂载 nfs 服务器上的共享目录到本机路径 `/root/nfsmount`
+  ``` sh
+  mkdir /root/nfsmount
+  # mount -t nfs $(nfs服务器的IP):/root/nfs_root /root/nfsmount
+  mount -t nfs 172.17.216.82:/root/nfs_root /root/nfsmount
+  # 写入一个测试文件
+  echo "hello nfs server" > /root/nfsmount/test.txt
+  ```
+* 在 nfs 服务器上执行以下命令，验证文件写入成功
+  ``` sh
+  cat /root/nfs_root/test.txt
+  ```
+
+## 在Kuboard中创建 NFS 存储类
+
+* 打开 Kuboard 的集群概览页面，点击 **创建存储类** 按钮，如下图所示
+  
+  填写表单输入表单
+
+  | 字段名称   | 填入内容       | 备注                              |
+  | ---------- | -------------- | --------------------------------- |
+  | 名称       | nfs-storage    | 请自定义名称                      |
+  | NFS Server | 172.17.216.82  | 请使用您自己的NFS服务的IP地址     |
+  | NFS Path   | /root/nfs_root | 请使用您自己的NFS服务所共享的路径 |
+  
+  ![Kubernetes教程_在Kuboard中创建NFS_StorageClass存储类](./nfs.assets/image-20191003183534076.png)
+
+* 在场景中使用存储类
+  
+  此时您可以在自己的场景中使用刚创建的存储类。Kuboard官网上，有以下几个地方可以用到NFS存储类：
+  * [导入 example 微服务](/guide/example/import.html)
+  * [安装监控套件](/guide/example/monitor.html#安装监控套件)

learning/k8s-intermediate/persistent/storage-class.md

@@ -28,6 +28,18 @@ Kuboard 支持的存储类的种类如下：
 * NFS <Badge text="Kuboard 已支持" type="success"/>
 * CephFS <Badge text="Kuboard 正在计划中" type="warn"/>
 
+::: tip 使用Kuboard “不支持”的存储类
+对于那些目前Kuboard不支持的存储类：
+* 使用yaml文件在kubectl中创建存储类
+* 在Kuboard中创建存储卷声明时，仍然可以引用这些存储类
+
+这里所说的Kuboard不支持的存储类，仅仅是说，Kuboard中不能直接创建和编辑这种类型的存储类。
+:::
+
+::: tip NFS权限问题
+许多网友自己搭建 NFS 测试环境，再创建 NFS存储类，经常碰到 `access denied` 这类权限问题。为了帮助大家更快地完成 NFS 测试环境搭建，Kuboard提供了一篇NFS相关的简明文档，请参考 [搭建NFS Server](/learning/k8s-intermediate/persistent/nfs.html)
+:::
+
 ## 存储类
 
 在 Kuboard 中查看存储类，如下图所示：