kubeasz 0.2.1 release

qwzhou89 · Jun 29, 2018 · e23975d · e23975d
1 parent 369cc18
commit e23975d
Show file tree

Hide file tree

Showing 4 changed files with 49 additions and 9 deletions.
diff --git a/docs/00-集群规划和基础参数设定.md b/docs/00-集群规划和基础参数设定.md
@@ -94,6 +94,7 @@ ssh-copy-id $IPs #$IPs为所有节点地址包括自身，按照提示输入yes
 ### 4.在deploy节点编排k8s安装
 
 - 4.1 下载项目源码
+
 ``` bash
 # 方式一：使用git clone
 git clone https://github.com/gjmzj/kubeasz.git
@@ -102,17 +103,20 @@ mv kubeasz/* /etc/ansible
 # 方式二：从发布页面 https://github.com/gjmzj/kubeasz/releases 下载源码解压到同样目录
 ```
 - 4.2a 下载二进制文件
-请从分享的百度云链接下载 https://pan.baidu.com/s/1c4RFaA，解压到/etc/ansible/bin目录，如果你有合适网络环境也可以按照/down/download.sh自行从官网下载各种tar包
+请从分享的[百度云链接](https://pan.baidu.com/s/1c4RFaA)，下载解压到/etc/ansible/bin目录，如果你有合适网络环境也可以按照/down/download.sh自行从官网下载各种tar包
+
 ``` bash
 tar zxvf k8s.1-9-8.tar.gz       # 以安装k8s v1.9.8为例
 mv bin/* /etc/ansible/bin
 ```
 - 4.2b [可选]下载离线docker镜像
 服务器使用内部yum源/apt源，但是无法访问公网情况下，请下载离线docker镜像完成集群安装；从百度云盘把`basic_images_kubeasz_x.y.tar.gz` 下载解压到`/etc/ansible/down` 目录
+
 ``` bash
 tar zxvf basic_images_kubeasz_0.2.tar.gz -C /etc/ansible/down
 ```
 - 4.3 配置集群参数
+
 ``` bash
 cd /etc/ansible
 cp example/hosts.m-masters.example hosts
@@ -122,6 +126,7 @@ ansible all -m ping
 ```
 - 4.4 开始安装
 如果你对集群安装流程不熟悉，请阅读项目首页 **安装步骤** 讲解后分步安装，并对 **每步都进行验证**  
+
 ``` bash
 # 分步安装
 ansible-playbook 01.prepare.yml

diff --git a/docs/op/del_one_node.md b/docs/op/del_one_node.md
@@ -25,6 +25,7 @@ $ ansible-playbook /etc/ansible/tools/clean_one_node.yml
 ## Debug
 
 如果出现清理失败，类似报错：`... Device or resource busy: '/var/run/docker/netns/xxxxxxxxxx'`，需要手动umount该目录后重新清理  
+
 ``` bash
 $ umount /var/run/docker/netns/xxxxxxxxxx
 $ ansible-playbook /etc/ansible/tools/clean_one_node.yml

diff --git a/docs/quickStart.md b/docs/quickStart.md
@@ -65,7 +65,8 @@ if __name__ == '__main__':
 
 ### 4.安装kubernetes集群
 
-- 4.1 下载项目源码  
+- 4.1 下载项目源码
+
 ``` bash
 # 方式一：使用git clone
 git clone https://github.com/gjmzj/kubeasz.git
@@ -74,26 +75,30 @@ mv kubeasz/* /etc/ansible
 # 方式二：从发布页面 https://github.com/gjmzj/kubeasz/releases 下载源码解压到同样目录
 ```
 - 4.2a 下载二进制文件  
-请从分享的百度云链接下载 https://pan.baidu.com/s/1c4RFaA，解压到/etc/ansible/bin目录，如果你有合适网络环境也可以按照/down/download.sh自行从官网下载各种tar包  
+请从分享的[百度云链接](https://pan.baidu.com/s/1c4RFaA)，下载解压到/etc/ansible/bin目录，如果你有合适网络环境也可以按照/down/download.sh自行从官网下载各种tar包
+
 ``` bash
 tar zxvf k8s.1-9-8.tar.gz	# 以安装k8s v1.9.8为例
 mv bin/* /etc/ansible/bin
 ```
 - 4.2b [可选]下载离线docker镜像  
-服务器使用内部yum源/apt源，但是无法访问公网情况下，请下载离线docker镜像完成集群安装；从百度云盘把`basic_images_kubeasz_x.y.tar.gz` 下载解压到`/etc/ansible/down` 目录  
+服务器使用内部yum源/apt源，但是无法访问公网情况下，请下载离线docker镜像完成集群安装；从百度云盘把`basic_images_kubeasz_x.y.tar.gz` 下载解压到`/etc/ansible/down` 目录
+
 ``` bash
 tar zxvf basic_images_kubeasz_0.2.tar.gz -C /etc/ansible/down
 ```
-- 4.3 配置集群参数  
+- 4.3 配置集群参数
+
 ``` bash
 cd /etc/ansible
 cp example/hosts.allinone.example hosts
 vim hosts			# 根据实际情况修改此hosts文件，所有节点改成本机IP
 # 验证ansible安装，正常能看到每个节点返回 SUCCESS
 ansible all -m ping
 ```
-- 4.4 开始安装  
-如果你对集群安装流程不熟悉，请阅读项目首页 **安装步骤** 讲解后分步安装，并对 **每步都进行验证**  
+- 4.4 开始安装
+如果你对集群安装流程不熟悉，请阅读项目首页 **安装步骤** 讲解后分步安装，并对 **每步都进行验证**
+
 ``` bash
 # 分步安装
 ansible-playbook 01.prepare.yml
@@ -110,7 +115,8 @@ ansible-playbook 07.cluster-addon.yml
 + [可选]对集群节点进行操作系统层面的安全加固 `ansible-playbook roles/os-harden/os-harden.yml`，详情请参考[os-harden项目](https://github.com/dev-sec/ansible-os-hardening)
 
 ### 5.验证安装
-如果提示kubectl: command not found，退出重新ssh登陆一下，环境变量生效即可  
+如果提示kubectl: command not found，退出重新ssh登陆一下，环境变量生效即可
+
 ``` bash
 kubectl version
 kubectl get componentstatus # 可以看到scheduler/controller-manager/etcd等组件 Healthy
@@ -120,6 +126,7 @@ kubectl get pod --all-namespaces # 可以查看所有集群pod状态，默认已
 kubectl get svc --all-namespaces # 可以查看所有集群服务状态
 ```
 ### 6.安装主要组件
+
 ``` bash
 # 安装kubedns，默认已集成安装
 #kubectl create -f /etc/ansible/manifests/kubedns
@@ -132,4 +139,13 @@ kubectl get svc --all-namespaces # 可以查看所有集群服务状态
 
 以上步骤创建的K8S开发测试环境请尽情折腾，碰到错误尽量通过查看日志、上网搜索、提交`issues`等方式解决；当然如果是彻底奔溃了，可以清理集群后重新创建。
 
-一步清理：`ansible-playbook 99.clean.yml`
+``` bash
+ansible-playbook 99.clean.yml
+```
+
+如果出现清理失败，类似报错：`... Device or resource busy: '/var/run/docker/netns/xxxxxxxxxx'`，需要手动umount该目录后重新清理
+
+``` bash
+$ umount /var/run/docker/netns/xxxxxxxxxx
+$ ansible-playbook /etc/ansible/tools/clean_one_node.yml
+```
diff --git a/docs/release-notes/kubeasz-0.2.1.md b/docs/release-notes/kubeasz-0.2.1.md
@@ -0,0 +1,18 @@
+## kubeasz-0.2.1 发布说明
+
+CHANGELOG:
+如果服务器能够使用内部yum源/apt源，但是无法访问公网情况下，请下载离线docker镜像完成集群安装：从百度云盘把`basic_images_kubeasz_x.y.tar.gz` 下载解压到项目`down`目录即可
+- 组件更新：
+  - 更新 coredns版本1.1.3  
+- 功能更新：
+  - 集成网络插件（可选）使用离线docker镜像安装 
+  - 集成其他插件（可选）使用离线docker镜像安装
+  - 增加切换集群网络插件的脚本
+- 文档更新：
+  - [快速指南](https://github.com/gjmzj/kubeasz/blob/master/docs/quickStart.md)
+  - [安装规划](https://github.com/gjmzj/kubeasz/blob/master/docs/00-%E9%9B%86%E7%BE%A4%E8%A7%84%E5%88%92%E5%92%8C%E5%9F%BA%E7%A1%80%E5%8F%82%E6%95%B0%E8%AE%BE%E5%AE%9A.md)
+  - [切换网络](https://github.com/gjmzj/kubeasz/blob/master/docs/op/clean_k8s_network.md)
+- 其他：
+  - Bug fix: 清理集群时可能出现`Device or resource busy: '/var/run/docker/netns/xxxxxxx'`的错误，可手动umount后重新清理集群
+  - Bug fix: #239 harbor调整安装解压工具, 适配多系统 (#240)
+