mirror of https://github.com/easzlab/kubeasz.git
134 lines
4.8 KiB
Markdown
134 lines
4.8 KiB
Markdown
## 00-集群规划和基础参数设定
|
||
|
||
### HA architecture
|
||
|
||
|
||
|
||
- 注意1：确保各节点时区设置一致、时间同步。 如果你的环境没有提供NTP 时间同步，推荐集成安装[chrony](../guide/chrony.md)
|
||
- 注意2：确保在干净的系统上开始安装，不要使用曾经装过kubeadm或其他k8s发行版的环境
|
||
- 注意3：建议操作系统升级到新的稳定内核，请结合阅读[内核升级文档](../guide/kernel_upgrade.md)
|
||
- 注意4：在公有云上创建多主集群，请结合阅读[在公有云上部署 kubeasz](kubeasz_on_public_cloud.md)
|
||
|
||
## 高可用集群所需节点配置如下
|
||
|
||
|角色|数量|描述|
|
||
|:-|:-|:-|
|
||
|部署节点|1|运行ansible/ezctl命令，建议独立节点|
|
||
|etcd节点|3|注意etcd集群需要1,3,5,...奇数个节点，一般复用master节点|
|
||
|master节点|2|高可用集群至少2个master节点|
|
||
|node节点|3|运行应用负载的节点，可根据需要提升机器配置/增加节点数|
|
||
|
||
机器配置：
|
||
- master节点：4c/8g内存/50g硬盘
|
||
- worker节点：建议8c/32g内存/200g硬盘以上
|
||
|
||
注意：默认配置下容器/kubelet会占用/var的磁盘空间，如果磁盘分区特殊，可以设置config.yml中的容器/kubelet数据目录：`CONTAINERD_STORAGE_DIR` `DOCKER_STORAGE_DIR` `KUBELET_ROOT_DIR`
|
||
|
||
在 kubeasz 2x 版本，多节点高可用集群安装可以使用2种方式
|
||
|
||
- 1.先部署单节点集群 [AllinOne部署](quickStart.md)，然后通过 [节点添加](../op/op-index.md) 扩容成高可用集群
|
||
- 2.按照如下步骤先规划准备，在clusters/${cluster_name}/hosts 配置节点信息后，直接安装多节点高可用集群
|
||
|
||
## 部署步骤
|
||
|
||
以下示例创建一个4节点的多主高可用集群，文档中命令默认都需要root权限运行。
|
||
|
||
### 1.基础系统配置
|
||
|
||
+ 2c/4g内存/40g硬盘（该配置仅测试用）
|
||
+ 最小化安装`Ubuntu 16.04 server`或者`CentOS 7 Minimal`
|
||
+ 配置基础网络、更新源、SSH登录等
|
||
|
||
### 2.在每个节点安装依赖工具
|
||
|
||
Ubuntu 16.04 请执行以下脚本:
|
||
|
||
``` bash
|
||
apt-get update && apt-get upgrade -y && apt-get dist-upgrade -y
|
||
# 安装python2
|
||
apt-get install python2.7
|
||
# Ubuntu16.04可能需要配置以下软连接
|
||
ln -s /usr/bin/python2.7 /usr/bin/python
|
||
```
|
||
CentOS 7 请执行以下脚本：
|
||
|
||
``` bash
|
||
yum update
|
||
# 安装python
|
||
yum install python -y
|
||
```
|
||
|
||
### 3.在部署节点安装ansible及准备ssh免密登陆
|
||
|
||
- 3.1 安装ansible (也可以使用容器化运行kubeasz，已经预装好ansible)
|
||
|
||
``` bash
|
||
# 注意pip 21.0以后不再支持python2和python3.5，需要如下安装
|
||
# To install pip for Python 2.7 install it from https://bootstrap.pypa.io/2.7/ :
|
||
curl -O https://bootstrap.pypa.io/pip/2.7/get-pip.py
|
||
python get-pip.py
|
||
python -m pip install --upgrade "pip < 21.0"
|
||
|
||
# pip安装ansible(国内如果安装太慢可以直接用pip阿里云加速)
|
||
pip install ansible -i https://mirrors.aliyun.com/pypi/simple/
|
||
```
|
||
|
||
- 3.2 在ansible控制端配置免密码登录
|
||
|
||
``` bash
|
||
# 更安全 Ed25519 算法
|
||
ssh-keygen -t ed25519 -N '' -f ~/.ssh/id_ed25519
|
||
# 或者传统 RSA 算法
|
||
ssh-keygen -t rsa -b 2048 -N '' -f ~/.ssh/id_rsa
|
||
|
||
ssh-copy-id $IPs #$IPs为所有节点地址包括自身，按照提示输入yes 和root密码
|
||
|
||
# 为每个节点设置python软链接
|
||
ssh $IPs ln -s /usr/bin/python3 /usr/bin/python
|
||
```
|
||
|
||
### 4.在部署节点编排k8s安装
|
||
|
||
- 4.1 下载项目源码、二进制及离线镜像
|
||
|
||
``` bash
|
||
# 下载工具脚本ezdown，举例使用kubeasz版本3.0.0
|
||
export release=3.0.0
|
||
wget https://github.com/easzlab/kubeasz/releases/download/${release}/ezdown
|
||
chmod +x ./ezdown
|
||
# 使用工具脚本下载
|
||
./ezdown -D
|
||
```
|
||
|
||
上述脚本运行成功后，所有文件（kubeasz代码、二进制、离线镜像）均已整理好放入目录`/etc/kubeasz`
|
||
|
||
- 4.2 创建集群配置实例
|
||
|
||
``` bash
|
||
ezctl new k8s-01
|
||
2021-01-19 10:48:23 DEBUG generate custom cluster files in /etc/kubeasz/clusters/k8s-01
|
||
2021-01-19 10:48:23 DEBUG set version of common plugins
|
||
2021-01-19 10:48:23 DEBUG cluster k8s-01: files successfully created.
|
||
2021-01-19 10:48:23 INFO next steps 1: to config '/etc/kubeasz/clusters/k8s-01/hosts'
|
||
2021-01-19 10:48:23 INFO next steps 2: to config '/etc/kubeasz/clusters/k8s-01/config.yml'
|
||
```
|
||
然后根据提示配置'/etc/kubeasz/clusters/k8s-01/hosts' 和 '/etc/kubeasz/clusters/k8s-01/config.yml'：根据前面节点规划修改hosts 文件和其他集群层面的主要配置选项；其他集群组件等配置项可以在config.yml 文件中修改。
|
||
|
||
- 4.3 开始安装
|
||
如果你对集群安装流程不熟悉，请阅读项目首页 **安装步骤** 讲解后分步安装，并对 **每步都进行验证**
|
||
|
||
``` bash
|
||
# 一键安装
|
||
ezctl setup k8s-01 all
|
||
|
||
# 或者分步安装，具体使用 ezctl help setup 查看分步安装帮助信息
|
||
# ezctl setup k8s-01 01
|
||
# ezctl setup k8s-01 02
|
||
# ezctl setup k8s-01 03
|
||
# ezctl setup k8s-01 04
|
||
...
|
||
```
|
||
|
||
|
||
[后一篇](01-CA_and_prerequisite.md)
|