集群安装相关文档更新

pull/644/head
gjmzj 2019-07-19 09:47:58 +08:00
parent d4948172c5
commit c148c085f4
4 changed files with 35 additions and 58 deletions

View File

@ -89,11 +89,12 @@ ssh-copy-id $IPs #$IPs为所有节点地址包括自身按照提示输入yes
推荐使用 easzup 脚本下载 4.0/4.1/4.2 所需文件运行成功后所有文件kubeasz代码、二进制、离线镜像均已整理好放入目录`/etc/ansilbe`
``` bash
# 下载工具脚本easzup
$ curl -C- -fLO --retry 3 https://github.com/easzlab/kubeasz/releases/download/${release}/easzup
$ chmod +x ./easzup
# 下载工具脚本easzup举例使用kubeasz版本2.0.2
export release=2.0.2
curl -C- -fLO --retry 3 https://github.com/easzlab/kubeasz/releases/download/${release}/easzup
chmod +x ./easzup
# 使用工具脚本下载
$ ./easzup -D
./easzup -D
```
- 4.3 配置集群参数

View File

@ -1,31 +1,5 @@
# 容器化运行 kubeasz
## TL;DR;
- 1.准备一台全新虚机作为管理节点ansible控制端
```
$ wget https://github.com/easzlab/kubeasz/releases/download/1.3.0/easzup
$ chmod +x ./easzup
$ ./easzup -D
```
- 2.配置 ssh 密钥登陆集群节点
``` bash
ssh-keygen -t rsa -b 2048 回车 回车 回车
ssh-copy-id $IP # $IP 为所有节点地址包括自身,按照提示输入 yes 和 root 密码
```
- 3.容器化运行 kubeasz然后执行安装 k8s 集群举例aio集群
``` bash
$ ./easzup -S
$ docker exec -it kubeasz easzctl start-aio
# 若需要自定义集群创建,如下进入容器,然后配置/etc/ansible/hosts执行创建即可
# docker exec -it kubeasz sh
```
## 验证
使用容器化安装成功后,可以在 **容器内** 或者 **宿主机** 上执行 kubectl 命令验证集群状态。
## easzup 工具介绍
初始化工具 tools/easzup 主要用于:
@ -37,7 +11,7 @@ $ docker exec -it kubeasz easzctl start-aio
### 容器化运行 kubeasz
容器启动脚本详见文件 tools/easzup 中函数`start_kubeasz_docker`
kubeasz 容器启动脚本详见文件 tools/easzup 中函数`start_kubeasz_docker`
``` bash
docker run --detach \
@ -57,6 +31,14 @@ $ docker exec -it kubeasz easzctl start-aio
- --volume /root/.kube:/root/.kube 容器内与主机共享 kubeconfig这样都可以执行 kubectl 命令
- --volume /root/.ssh/id_rsa:/root/.ssh/id_rsa:ro 等三个 volume 挂载保证:如果宿主机配置了免密码登陆所有集群节点,那么容器内也可以免密码登陆所有节点
## 容器化安装集群
项目[快速指南](quickStart.md),就是利用 kubeasz 容器快速安装单节点k8s集群的例子。
## 验证
使用容器化安装成功后,可以在 **容器内** 或者 **宿主机** 上执行 kubectl 命令验证集群状态。
## 清理
登陆管理节点,按照如下步骤清理(清理后可以重新安装测试)

View File

@ -1,16 +1,18 @@
# 离线安装集群
kubeasz 2.0.1 开始支持完全离线安装,目前已测试 Ubuntu16.04/Ubuntu18.04/CentOS7 系统。
kubeasz 2.0.1 开始支持**完全离线安装**,目前已测试 `Ubuntu1604|1804` `CentOS7` `Debian9|10` 系统。
## 离线文件准备
在一台能够访问互联网的服务器上执行:
```
$ curl -C- -fLO --retry 3 https://github.com/easzlab/kubeasz/releases/download/2.0.1/easzup
$ chmod +x ./easzup
# 下载工具脚本easzup举例使用kubeasz版本2.0.2
export release=2.0.2
curl -C- -fLO --retry 3 https://github.com/easzlab/kubeasz/releases/download/${release}/easzup
chmod +x ./easzup
# 使用工具脚本下载
$ ./easzup -D
./easzup -D
```
执行成功后,所有文件均已整理好放入目录`/etc/ansilbe`,只要把该目录整体复制到任何离线的机器上,即可开始安装集群,离线文件包括:

View File

@ -1,6 +1,6 @@
## 快速指南
以下为快速体验k8s集群的测试、开发环境--allinone部署国内环境下比官方的minikube方便、简单很多。
以下为快速体验k8s集群的测试、开发环境--单节点部署(aio)国内环境下比官方的minikube方便、简单很多。
### 1.基础系统配置
@ -11,11 +11,12 @@
### 2.下载文件
``` bash
# 下载工具脚本easzup
$ curl -C- -fLO --retry 3 https://github.com/easzlab/kubeasz/releases/download/${release}/easzup
$ chmod +x ./easzup
# 下载工具脚本easzup举例使用kubeasz版本2.0.2
export release=2.0.2
curl -C- -fLO --retry 3 https://github.com/easzlab/kubeasz/releases/download/${release}/easzup
chmod +x ./easzup
# 使用工具脚本下载
$ ./easzup -D
./easzup -D
```
上述脚本运行成功后所有文件kubeasz代码、二进制、离线镜像均已整理好放入目录`/etc/ansilbe`
@ -23,11 +24,12 @@ $ ./easzup -D
- `/etc/ansible` 包含 kubeasz 版本为 ${release} 的发布代码
- `/etc/ansible/bin` 包含 k8s/etcd/docker/cni 等二进制文件
- `/etc/ansible/down` 包含集群安装时需要的离线容器镜像
- `/etc/ansible/down/packages` 包含集群安装时需要的系统基础软件
### 3.配置 ssh 免密登陆
``` bash
ssh-keygen -t rsa -b 2048 回车 回车 回车
ssh-keygen -t rsa -b 2048 -N '' -f ~/.ssh/id_rsa
ssh-copy-id $IP # $IP 为所有节点地址包括自身,按照提示输入 yes 和 root 密码
```
@ -36,22 +38,13 @@ ssh-copy-id $IP # $IP 为所有节点地址包括自身,按照提示输入 ye
- 4.1 容器化运行 kubeasz详见[文档](docker_kubeasz.md)
```
$ ./easzup -S
./easzup -S
```
- 4.2 使用默认配置安装 aio 集群
```
$ docker exec -it kubeasz easzctl start-aio
```
- 4.3 若需要自定义安装,详见 [配置指南](config_guide.md)
``` bash
# 进入容器,自定义配置
$ docker exec -it kubeasz sh
# 执行安装
/ # ansible-playbook /etc/ansible/90.setup.yml
docker exec -it kubeasz easzctl start-aio
```
### 5.验证安装
@ -73,12 +66,12 @@ $ kubectl get svc --all-namespaces # 验证集群服务状态
在宿主机上,按照如下步骤清理
- 1.清理集群 `$ docker exec -it kubeasz easzctl destroy`
- 1.清理集群 `docker exec -it kubeasz easzctl destroy``docker exec -it kubeasz ansible-playbook /etc/ansible/99.clean.yml`
- 2.清理管理节点
- 清理运行的容器 `$ easzup -C`
- 清理容器镜像 `$ docker system prune -a`
- 停止docker服务 `$ systemctl stop docker`
- 删除下载文件 `$ rm -rf /etc/ansible /etc/docker /opt/kube`
- 清理运行的容器 `easzup -C`
- 清理容器镜像 `docker system prune -a`
- 停止docker服务 `systemctl stop docker`
- 删除下载文件 `rm -rf /etc/ansible /etc/docker /opt/kube`
- 删除docker文件
```
$ umount /var/run/docker/netns/default
@ -87,4 +80,3 @@ $ rm -rf /var/lib/docker /var/run/docker
```
上述清理脚本执行成功后,建议重启节点,以确保清理残留的虚拟网卡、路由等信息。