kubeasz/docs/quickStart.md

102 lines
3.9 KiB
Markdown
Raw Normal View History

2017-11-26 18:46:02 +08:00
## 快速指南
2017-12-18 22:56:59 +08:00
以下为基于Ubuntu 16.04/CentOS 7.4 快速体验k8s集群的测试、开发环境--AllinOne部署觉得比官方的minikube方便、简单很多。
### 1.基础系统配置
+ 推荐内存2G/硬盘20G以上
+ 最小化安装`Ubuntu 16.04 server`或者`CentOS 7 Minimal`
+ 配置基础网络、更新源、SSH登陆等
### 2.安装依赖工具
Ubuntu 16.04 请执行以下脚本:
2017-11-26 18:46:02 +08:00
``` bash
2017-11-28 21:13:21 +08:00
# 文档中脚本默认均以root用户执行
2017-11-26 18:46:02 +08:00
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
2017-11-28 21:13:21 +08:00
# Ubuntu16.04可能需要配置以下软连接
ln -s /usr/bin/python2.7 /usr/bin/python
2017-12-18 22:56:59 +08:00
```
CentOS 7 请执行以下脚本:
``` bash
# 文档中脚本默认均以root用户执行
# 安装 epel 源并更新
yum install epel-release -y
yum update
# 删除不要的默认安装
yum erase firewalld firewalld-filesystem python-firewall -y
# 安装依赖工具
yum install git python python-pip -y
```
### 3.ansible安装及准备
``` bash
2017-11-28 21:13:21 +08:00
# 安装ansible (国内如果安装太慢可以直接用pip阿里云加速)
#pip install pip --upgrade
#pip install ansible
2017-11-26 18:46:02 +08:00
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 回车 回车 回车
2017-11-28 21:13:21 +08:00
ssh-copy-id $IP #$IP为本虚机地址按照提示输入yes 和root密码
2017-11-26 18:46:02 +08:00
```
2017-12-18 22:56:59 +08:00
### 4.安装kubernetes集群
2017-11-26 18:46:02 +08:00
``` bash
2017-11-28 21:13:21 +08:00
git clone https://github.com/gjmzj/kubeasz.git
mv kubeasz /etc/ansible
2017-11-28 21:20:48 +08:00
# 下载已打包好的binaries并且解压缩到/etc/ansible/bin目录
2017-12-21 19:24:39 +08:00
# 国内请从分享的百度云链接下载 https://pan.baidu.com/s/1c4RFaA
2017-11-28 21:13:21 +08:00
# 如果你有合适网络环境也可以按照/down/download.sh自行从官网下载各种tar包到 ./down目录并执行download.sh
2018-01-07 22:32:14 +08:00
tar zxvf k8s.191.tar.gz
2017-11-28 21:13:21 +08:00
mv bin/* /etc/ansible/bin
2017-11-28 21:20:48 +08:00
# 配置ansible的hosts文件
2017-11-28 21:13:21 +08:00
cd /etc/ansible
2017-11-26 18:46:02 +08:00
cp example/hosts.allinone.example hosts
2017-11-28 21:13:21 +08:00
然后根据实际情况修改此hosts文件所有节点都是本虚机IP
2017-11-30 13:42:42 +08:00
# 采用一步安装或者分步安装
ansible-playbook 90.setup.yml # 一步安装
#ansible-playbook 01.prepare.yml
#ansible-playbook 02.etcd.yml
#ansible-playbook 03.kubectl.yml
#ansible-playbook 04.docker.yml
2018-01-05 13:04:49 +08:00
#ansible-playbook 05.kube-master.yml
#ansible-playbook 06.kube-node.yml
# 网络只可选择calico flannel一种安装
#ansible-playbook 07.calico.yml
#ansible-playbook 07.flannel.yml
2017-11-26 18:46:02 +08:00
```
2017-12-18 22:56:59 +08:00
如果执行成功k8s集群就安装好了。详细分步讲解请查看项目目录 `/docs` 下相关文档
2017-11-26 18:46:02 +08:00
2017-12-18 22:56:59 +08:00
### 5.验证安装
2017-11-26 18:46:02 +08:00
``` bash
2017-11-28 21:13:21 +08:00
# 如果提示kubectl: command not found退出重新ssh登陆一下环境变量生效即可
2017-11-26 18:46:02 +08:00
kubectl version
kubectl get componentstatus # 可以看到scheduler/controller-manager/etcd等组件 Healthy
2017-12-02 22:30:34 +08:00
kubectl cluster-info # 可以看到kubernetes master(apiserver)组件 running
2017-11-26 18:46:02 +08:00
kubectl get node # 可以看到单 node Ready状态
kubectl get pod --all-namespaces # 可以查看所有集群pod状态
kubectl get svc --all-namespaces # 可以查看所有集群服务状态
```
2017-12-18 22:56:59 +08:00
### 6.安装主要组件
2017-11-28 21:13:21 +08:00
``` bash
# 安装kubedns
2017-12-18 17:12:03 +08:00
kubectl create -f /etc/ansible/manifests/kubedns
2017-11-28 21:13:21 +08:00
# 安装heapster
2017-12-18 17:12:03 +08:00
kubectl create -f /etc/ansible/manifests/heapster
2017-11-28 21:13:21 +08:00
# 安装dashboard
2017-12-18 17:12:03 +08:00
kubectl create -f /etc/ansible/manifests/dashboard
2017-11-28 21:13:21 +08:00
```
2017-12-26 15:52:35 +08:00
+ 更新后`dashboard`已经默认关闭非安全端口访问,请使用`https://xx.xx.xx.xx:6443/api/v1/namespaces/kube-system/services/kubernetes-dashboard/proxy`访问,并用默认用户 `admin:test1234` 登陆,更多内容请查阅[dashboard文档](guide/dashboard.md)
2017-12-18 22:56:59 +08:00
### 7.清理集群
以上步骤创建的K8S开发测试环境请尽情折腾碰到错误尽量通过查看日志、上网搜索、提交`issues`等方式解决;当然如果是彻底奔溃了,可以清理集群后重新创建。
一步清理:`ansible-playbook 99.clean.yml`