入门教程

learning/k8s-basics/deploy-app.md

@@ -18,7 +18,8 @@ meta:
 假设您已经
 
 * 完成 Kubernetes 集群的安装，请参考文档 [安装 Kubernetes 单Master节点](/install/install-k8s.html)
-* 完成 Kuboard 的安装，请参考文档 [安装 Kuboard](/install/install-dashboard.html)
+* 完成 Kuboard 的安装，请参考文档 [安装 Kuboard](/install/v3/install.html) 
+  * 版本不低于 `v3.1.1.0`
 
 ### 目标
 
@@ -61,7 +62,7 @@ Deployment 处于 master 节点上，通过发布 Deployment，master 节点会
 
 <b-card>
 <b-tabs content-class="mt-3">
-  <b-tab title="使用kubectl" active>
+  <b-tab title="使用kubectl">
 
 **创建 YAML 文件**
 
@@ -138,21 +139,25 @@ kubectl get pods
 ```
 
   </b-tab>
-  <b-tab title="使用Kuboard">
+  <b-tab title="使用Kuboard" active>
 
-**打开 Kuboard 集群概览界面**，如下图所示：
+**打开 Kuboard 首页**，如下图所示：
 
-![Kubernetes教程：部署第一个应用程序-Kuboard集群概览页](./deploy-app.assets/image-20200429234145358.png)
+![Kubernetes教程：Kuboard首页](./deploy-app.assets/image-20210403181224179.png)
+
+假设您已经完成了集群的导入，点击一个 ***已就绪*** 的集群，如下图所示：
+
+![Kuboard首页-选择名称空间](./deploy-app.assets/image-20210403190603062.png)
+
+选择 ***使用 ServiceAccount kuboard-admin*** 并  ***点击 default 名称空间*** 将切换到 ***default*** 名称空间首页，如下所示：
+
+![Kuboard-名称空间首页](./deploy-app.assets/image-20210403201814079.png)
 
 
 
-**点击 default 名称空间**
+点击左侧菜单的 ***创建工作负载*** ，将打开工作负载编辑器，如下图所示：
 
-![Kubernetes教程：部署第一个应用程序-Kuboard名称空间页](./deploy-app.assets/image-20200429234212468.png)
-
-
-
-点击 **创建工作负载**
+![Kuboard-创建工作负载](./deploy-app.assets/image-20210403201918399.png)
 
 ​	并填写表单如下：
 
@@ -161,17 +166,21 @@ kubectl get pods
 | 服务类型 | Deployment  |                                                         |
 | 服务分层 | 展现层      | Kuboard使用这个字段确定将部署显示在微服务架构的哪个分层 |
 | 服务名称 | nginx       | 服务分层的前缀 + 服务名 组成最终的 K8S Deployment name  |
-| 服务描述 | Nginx部署   | 显示在微服务分层架构图中便于识别的名字，可以是中文      |
-| 副本数量 | 1           | replicas                                                |
+| 副本数   | 1           | replicas                                                |
+
+点击 ***容器信息*** Tab 页，在 ***容器信息*** Tab 页中点击 ***添加工作容器*** 按钮，如下图所示：
+
+![Kuboard-编辑容器信息](./deploy-app.assets/image-20210403202106052.png)
+
+并填写表单如下：
+
+| 字段名   | 填写内容    | 备注                                                    |
+| -------- | ----------- | ------------------------------------------------------- |
 | 容器名称 | nginx       |                                                         |
 | 镜像     | nginx:1.7.9 |                                                         |
 | 抓取策略 | Always      | 每次创建 Pod 都尝试抓取镜像                             |
 | Ports    | TCP : 80    | 该容器组监听 TCP 80 端口                                |
 
-![Kubernetes教程：部署第一个应用程序-在Kuboard中创建工作负载](./deploy-app.assets/image-20200429234711586.png)
-
-
-
 点击 ***保存***
 
 点击 ***应用***
@@ -180,13 +189,13 @@ kubectl get pods
 
 此时可查看到该应用的部署结果，如下图所示：
 
-![Kubernetes入门教程](./deploy-app.assets/image-20200429235118699.png)
+![Kuboard-工作负载查看](./deploy-app.assets/image-20210403202337158.png)
 
-点击上图中的 ***代理*** 按钮，可以直接测试部署结果。更多细节请参考 [Kuboard Proxy](/guide/proxy)， 此功能要求 Kuboard 版本不低于 `v1.0.9.4`。
+点击上图中的 ***代理*** 按钮，可以直接测试部署结果。更多细节请参考 [Kuboard Proxy](/guide/proxy)。
 
 通过代理访问已部署的 nginx 服务时，默认显示结果如下所示：
 
-![Kubernetes入门教程](./deploy-app.assets/image-20200226122026369.png)
+![Nginx](./deploy-app.assets/image-20210403193943512.png)
 
   </b-tab>
 </b-tabs>

learning/k8s-basics/explore.md

@@ -64,7 +64,7 @@ Pod（容器组）总是在 **Node（节点）** 上运行。Node（节点）是
 
 <b-card>
 <b-tabs content-class="mt-3">
-  <b-tab title="使用kubectl" active>
+  <b-tab title="使用kubectl">
 
 在[部署第一个应用程序](./deploy-app.html) 中，我们使用了 kubectl 命令行界面部署了 nginx 并且查看了 Deployment 和 Pod。kubectl 还有如下四个常用命令，在我们排查问题时可以提供帮助：
 
@@ -129,16 +129,19 @@ Pod（容器组）总是在 **Node（节点）** 上运行。Node（节点）是
 请尝试在您的集群中执行一下上述的几个命令，了解如何通过 kubectl 操作 kubernetes 集群中的 Node、Pod、Container。
 
   </b-tab>
-  <b-tab title="使用Kuboard">
+  <b-tab title="使用Kuboard" active>
 
 **在名称空间中查看部署**
 
-![Kubernetes教程：查看 Pods/Nodes](./explore.assets/image-20190822172329141.png)
+Kuboard 中的名称空间首页如下图所示，在右上角的 ***自定义名称空间布局*** 按钮，可以调整名称空间的布局结构。
+
+左侧 ***工作负载*** 菜单，可以按列表的形式展示 ***Deployment***、***StatefulSet***、***DaemonSet*** 等工作负载。
+
+![Kuboard-Namespace-Overview](./explore.assets/image-20210403202748257.png)
 
 **查看部署及其容器组**
 
-![Kubernetes教程：查看 Pods/Nodes](./explore.assets/image-20190822172457417.png)
-
+![Kuboard-查看 Pod](./explore.assets/image-20210403203009581.png)
 
   </b-tab>
 </b-tabs>

learning/k8s-basics/expose.md

@@ -81,7 +81,7 @@ Labels（标签）可以在创建 Kubernetes 对象时附加上去，也可以
 
 <b-card>
 <b-tabs content-class="mt-3">
-<b-tab title="使用kubectl" active>
+<b-tab title="使用kubectl">
 
 创建nginx的Deployment中定义了Labels，如下：
 
@@ -168,31 +168,31 @@ curl <任意节点的 IP>:32600
 > 如果您的集群在云上，您可能通过云服务商的安全组开放 32600 端口的访问
 
 </b-tab>
-<b-tab title="使用Kuboard">
+<b-tab title="使用Kuboard" active>
 
-* 在 default 名称空间 点击 ***展现层 --> Nginx部署***
+* 在上一个步骤中创建的工作负载查看界面点击 ***编辑*** 按钮，该按钮的位置如下图所示：
 
-* 点击 ***编辑*** 按钮
+  ![Kuboard-工作负载-编辑](./expose.assets/image-20210403203205997.png)
 
-* 填写表单如下：
+* 在工作负载编辑页切换到 ***服务/应用路由*** 标签，如下图所示：
 
-​		访问方式 Service 选择 ***NodePort（VPC内访问）***
+  ![Kuboard-Service](./expose.assets/image-20210403203348389.png)
 
-​		填写一条记录：
+​		填写表单如下：
 
-| 协议 | 服务端口 | 节点端口 | 容器端口 |
-| ---- | -------- | -------- | -------- |
-| TCP  | 80       | 32601    | 80       |
+​		服务类型： **NodePort**
+
+| 协议 | 服务端口（port） | 节点端口（nodePort） | 容器端口（targetPort） |
+| ---- | ---------------- | -------------------- | ---------------------- |
+| TCP  | 80               | 32601                | 80                     |
 
-如下图所示：
 
-![Kubernetes教程：公布应用程序](./expose.assets/image-20190822211807469.png)
 
 * 点击 **保存**
 
 * **访问服务**
 
-  在浏览器打开 `http://<任意节点的 IP>:32601
+  在浏览器打开 `http://<任意节点的 IP>:32601`
 
 </b-tab>
 </b-tabs>

learning/k8s-basics/scale.md

@@ -48,7 +48,7 @@ spec:
 
 <b-card>
 <b-tabs content-class="mt-3">
-<b-tab title="使用kubectl" active>
+<b-tab title="使用kubectl">
 
 **修改 nginx-deployment.yaml 文件**
 
@@ -91,23 +91,15 @@ watch kubectl get pods -o wide
 ```
 
 </b-tab>
-<b-tab title="使用Kuboard">
+<b-tab title="使用Kuboard" active>
 
 * 在 default 名称空间 点击 ***展现层 --> Nginx部署***
 
-* 点击 ***伸缩*** 按钮
+* 点击下图中红色箭头按钮，可以执行伸缩操作，没点击一次，副本数加 `1`；
 
-  填写表单
+  该页面中还可以观察到工作负载伸缩的过程。
 
-  副本数： 4
-
-![Kubernetes教程：伸缩应用-Scaling](./scale.assets/image-20190822213532132.png)
-
-* 点击 ***确定*** 按钮
-
-  等待新增的容器组完成初始化，如下图所示：
-
-![Kubernetes教程：伸缩应用-Scaling](./scale.assets/image-20190822213709967.png)
+  ![Kubernetes教程：伸缩应用-Scaling](./scale.assets/image-20210403203909667.png)
 
 </b-tab>
 </b-tabs>

learning/k8s-basics/update.md

@@ -57,7 +57,7 @@ meta:
 
 <b-card>
 <b-tabs content-class="mt-3">
-<b-tab title="使用kubectl" active>
+<b-tab title="使用kubectl">
 
 **修改 nginx-deployment.yaml 文件**
 
@@ -101,20 +101,16 @@ watch kubectl get pods -l app=nginx
 ```
 
 </b-tab>
-<b-tab title="使用Kuboard">
+<b-tab title="使用Kuboard" active>
 
-* **进入 default 名称空间**
-
-* 点击 ***调整镜像版本***
-
-  勾选展现层，并刷新，可找到 ***Nginx部署***
+* 点击左侧菜单中的 ***调整镜像版本*** 按钮
 
 * 针对 ***Nginx部署*** 点击修改
 
   填写新的 nginx 版本号： 1.8， 如下图所示：
-
-![Kubernetes教程：执行滚动更新](./update.assets/image-20190822214324429.png)
-
+  
+  ![Kubernetes教程：执行滚动更新](./update.assets/image-20210403204908592.png)
+  
 * 点击 ***变更***
 
 * 点击 ***应用***
@@ -123,7 +119,7 @@ watch kubectl get pods -l app=nginx
 
   可观察到 Kubernetes 对 ***Nginx部署*** 执行滚动更新的过程，如下图所示
 
-![Kubernetes教程：执行滚动更新-过程](./update.assets/image-20190822214503847.png)
+  ![Kubernetes教程：执行滚动更新-过程](./update.assets/image-20210403205053379.png)
 
 </b-tab>
 </b-tabs>