mirror of https://github.com/easzlab/kubeasz.git
增加快速指南
jmgao
parent
712c01be5c
commit
c04fdde672
78
README.md
78
README.md
|
|
@ -2,11 +2,12 @@
|
|||
|
||||
  
|
||||
|
||||
本系列文档致力于提供快速部署高可用`k8s`集群的工具，并且也努力成为`k8s`实践、使用的参考书；基于二进制方式部署和利用`ansible-playbook`实现自动化：既提供一键安装脚本，也可以分步执行安装各个组件，同时讲解每一步主要参数配置和注意事项。**二进制方式部署优势：有助于理解系统各组件的交互原理和熟悉组件启动参数，有助于快速排查解决实际问题**
|
||||
本系列文档致力于提供快速部署高可用`k8s`集群的工具，并且也努力成为`k8s`实践、使用的参考书；基于二进制方式部署和利用`ansible-playbook`实现自动化：既提供一键安装脚本，也可以分步执行安装各个组件，同时讲解每一步主要参数配置和注意事项。
|
||||
|
||||
集群特性：`TLS` 双向认证、`RBAC` 授权、多`Master`高可用、支持`Network Policy`
|
||||
**集群特性：`TLS` 双向认证、`RBAC` 授权、多`Master`高可用、支持`Network Policy`**
|
||||
**二进制方式部署优势：有助于理解系统各组件的交互原理和熟悉组件启动参数，有助于快速排查解决实际问题**
|
||||
|
||||
文档基于`Ubuntu 16.04`，其他系统如`CentOS 7`需要读者自行替换部分命令；由于使用`ansible`经验有限和简化`ansible-playbook`脚本考虑，已经尽量避免高级特性和复杂逻辑。
|
||||
文档基于`Ubuntu 16.04`，其他系统如`CentOS 7`需要读者自行替换部分命令；由于使用经验有限和简化脚本考虑，已经尽量避免`ansible-playbook`的高级特性和复杂逻辑。
|
||||
|
||||
## 组件版本
|
||||
|
||||
|
|
@ -17,67 +18,24 @@
|
|||
|
||||
## 快速指南
|
||||
|
||||
以下为快速体验k8s集群的测试、开发环境--AllinOne部署，觉得比官方的minikube方便、简单很多。
|
||||
单机快速体验k8s集群的测试、开发环境--[AllinOne部署](docs/quickStart.md)；在国内的网络环境下要比官方的minikube方便、简单很多。
|
||||
|
||||
### 1.准备一台虚机(推荐内存3G，硬盘20G以上)，安装Ubuntu16.04，配置基础网络、更新源、SSH登陆等。
|
||||
### 2.安装python2/git/python-pip/ansible
|
||||
``` bash
|
||||
# 更新
|
||||
apt-get update && apt-get upgrade -y && apt-get dist-upgrade -y
|
||||
# 删除不要的默认安装
|
||||
apt-get purge ufw lxd lxd-client lxcfs lxc-common
|
||||
# 安装依赖工具
|
||||
apt-get install python2.7 git python-pip
|
||||
# 安装ansible
|
||||
pip install pip --upgrade
|
||||
pip install ansible
|
||||
# 国内加速
|
||||
pip install pip --upgrade -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com
|
||||
pip install --no-cache-dir ansible -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com
|
||||
# 配置ansible ssh密钥登陆
|
||||
ssh-keygen -t rsa -b 2048 回车 回车 回车
|
||||
ssh-copy-id $IP //$IP为本虚机地址
|
||||
```
|
||||
### 3.安装k8s
|
||||
``` bash
|
||||
git clone https://gitee.com/netmon/deploy-k8s-with-ansible.git
|
||||
mv deploy-k8s-with-ansible/ /etc/ansible
|
||||
cd /etc/ansible
|
||||
# 配置ansible
|
||||
cp example/ansible.cfg.example ansible.cfg
|
||||
# 配置集群hosts
|
||||
cp example/hosts.allinone.example hosts
|
||||
然后根据实际情况修改此hosts文件
|
||||
# 准备二进制安装包
|
||||
按照down/download.sh文件提示先手工下载各种tar包到 ./down目录
|
||||
sh down/download.sh
|
||||
# 开始安装(一步安装)
|
||||
ansible-playbook 90.setup.yml
|
||||
# 或者采用分步安装
|
||||
ansible-playbook 01.prepare.yml
|
||||
ansible-playbook 02.etcd.yml
|
||||
...
|
||||
```
|
||||
如果执行成功，k8s集群就安装好了
|
||||
## 详细步骤
|
||||
|
||||
### 4.验证安装
|
||||
``` bash
|
||||
kubectl version
|
||||
kubectl get componentstatus # 可以看到scheduler/controller-manager/etcd等组件 Healthy
|
||||
kubectl clusterinfo # 可以看到kubernetes master(apiserver)组件 running
|
||||
kubectl get node # 可以看到单 node Ready状态
|
||||
kubectl get pod --all-namespaces # 可以查看所有集群pod状态
|
||||
kubectl get svc --all-namespaces # 可以查看所有集群服务状态
|
||||
```
|
||||
|
||||
## 多节点指南(文档更新中...)
|
||||
1. 准备4台虚机(物理机也可，虚机实验更方便)，安装Ubuntu16.04(centos7理论上一样，不想ansible脚本太多条件判断)
|
||||
1. 准备一台部署机(可以复用上述4台虚机)，安装ansible，配置到4台目标机器ssh无密码登陆等
|
||||
1. 准备外部负载均衡，准备master节点的vip地址
|
||||
1. 规划集群节点，完成ansible inventory文件[参考](hosts)
|
||||
1. 其他安装步骤同单节点安装
|
||||
## 部署指南
|
||||
|
||||
## 补充阅读
|
||||
|
||||
1. 建议阅读 [feisky.gitbooks](https://feisky.gitbooks.io/kubernetes/) 原理和部署章节。
|
||||
1. 建议阅读 [opsnull教程](https://github.com/opsnull/follow-me-install-kubernetes-cluster) 二进制手工部署。
|
||||
1. 建议阅读 [ansible超快入门](http://weiweidefeng.blog.51cto.com/1957995/1895261)基本够用。
|
||||
|
||||
[ansible超快入门](http://weiweidefeng.blog.51cto.com/1957995/1895261)
|
||||
## 版权
|
||||
|
||||
Copyright 2017 gjmzj (jmgaozz@163.com)
|
||||
|
||||
Apache License 2.0，详情见 [LICENSE](LICENSE) 文件。
|
||||
|
||||
如果你觉得这份文档对你有帮助，请支付宝扫描下方的二维码进行捐赠，谢谢！
|
||||
|
||||
|
|
|
|||
|
|
@ -0,0 +1,55 @@
|
|||
## 快速指南
|
||||
|
||||
以下为快速体验k8s集群的测试、开发环境--AllinOne部署，觉得比官方的minikube方便、简单很多。
|
||||
|
||||
### 1.准备一台虚机(推荐内存3G，硬盘20G以上)，安装Ubuntu16.04，配置基础网络、更新源、SSH登陆等。
|
||||
### 2.安装python2/git/python-pip/ansible
|
||||
``` bash
|
||||
# 更新
|
||||
apt-get update && apt-get upgrade -y && apt-get dist-upgrade -y
|
||||
# 删除不要的默认安装
|
||||
apt-get purge ufw lxd lxd-client lxcfs lxc-common
|
||||
# 安装依赖工具
|
||||
apt-get install python2.7 git python-pip
|
||||
# 安装ansible
|
||||
pip install pip --upgrade
|
||||
pip install ansible
|
||||
# 国内加速
|
||||
pip install pip --upgrade -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com
|
||||
pip install --no-cache-dir ansible -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com
|
||||
# 配置ansible ssh密钥登陆
|
||||
ssh-keygen -t rsa -b 2048 回车 回车 回车
|
||||
ssh-copy-id $IP //$IP为本虚机地址
|
||||
```
|
||||
### 3.安装k8s
|
||||
``` bash
|
||||
git clone https://gitee.com/netmon/deploy-k8s-with-ansible.git
|
||||
mv deploy-k8s-with-ansible/ /etc/ansible
|
||||
cd /etc/ansible
|
||||
# 配置ansible
|
||||
cp example/ansible.cfg.example ansible.cfg
|
||||
# 配置集群hosts
|
||||
cp example/hosts.allinone.example hosts
|
||||
然后根据实际情况修改此hosts文件
|
||||
# 准备二进制安装包
|
||||
按照down/download.sh文件提示先手工下载各种tar包到 ./down目录
|
||||
sh down/download.sh
|
||||
# 开始安装(一步安装)
|
||||
ansible-playbook 90.setup.yml
|
||||
# 或者采用分步安装
|
||||
ansible-playbook 01.prepare.yml
|
||||
ansible-playbook 02.etcd.yml
|
||||
...
|
||||
```
|
||||
如果执行成功，k8s集群就安装好了
|
||||
|
||||
### 4.验证安装
|
||||
``` bash
|
||||
kubectl version
|
||||
kubectl get componentstatus # 可以看到scheduler/controller-manager/etcd等组件 Healthy
|
||||
kubectl clusterinfo # 可以看到kubernetes master(apiserver)组件 running
|
||||
kubectl get node # 可以看到单 node Ready状态
|
||||
kubectl get pod --all-namespaces # 可以查看所有集群pod状态
|
||||
kubectl get svc --all-namespaces # 可以查看所有集群服务状态
|
||||
```
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 36 KiB |
Loading…
Reference in New Issue