kubeasz/docs/setup/docker_kubeasz.md

68 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 容器化运行 kubeasz
## TL;DR;
- 1.本机安装 docker (略)
- 2.配置 ssh 密钥登陆集群节点
``` bash
ssh-keygen -t rsa -b 2048 回车 回车 回车
ssh-copy-id $IP # $IP 为所有节点地址包括自身,按照提示输入 yes 和 root 密码
```
- 3.下载 kubeasz docker 镜像并运行 (可能需较长时间下载镜像jmgao1983/kubeasz)
``` bash
curl -sfL https://github.com/easzlab/kubeasz/releases/download/1.0.0/kubeasz-docker-1.0.0 | bash -
```
- 4.在 kubeasz 容器中创建 k8s 集群,步骤与非容器方式创建类似,快速创建单节点集群如下
``` bash
docker exec -it kubeasz easzctl start-aio
```
## 验证
使用容器化安装成功后,可以在 **容器内** 或者 **宿主机** 上执行 kubectl 命令验证集群状态。
## kubeasz 镜像介绍
镜像描述文件 dockerfiles/kubeasz/Dockerfile它基于 ansible 镜像dockerfiles/ansible/Dockerfile主要包含 kubeasz 项目代码和 k8s 集群安装所需二进制文件。
- 在本地创建 kubeasz 镜像,由于镜像较大,可以按以下步骤在本地创建
``` bash
cd /etc/ansible/dockerfiles/kubeasz
# 克隆代码
git clone --depth=1 https://github.com/easzlab/kubeasz.git
# 手动下载二进制文件放入上述 git clone 完成目录 kubeasz/bin
docker build -t kubeasz:$TAG .
```
## 容器运行讲解
容器启动脚本详见文件 tools/kubeasz_docker
``` bash
docker run --detach \
--name kubeasz \
--restart always \
--env HOST_IP=$host_ip \
--volume /etc/ansible:/etc/ansible \
--volume /root/.kube:/root/.kube \
--volume /root/.ssh/id_rsa:/root/.ssh/id_rsa:ro \
--volume /root/.ssh/id_rsa.pub:/root/.ssh/id_rsa.pub:ro \
--volume /root/.ssh/known_hosts:/root/.ssh/known_hosts:ro \
$KUBEASZ_DOCKER_VER
```
- --env HOST_IP=$host_ip 传递这个参数是为了快速在本机安装aio集群
- --volume /etc/ansible:/etc/ansible 挂载本地目录,这样可以在宿主机上修改集群配置,然后在容器内执行 ansible 安装
- --volume /root/.kube:/root/.kube 容器内与主机共享 kubeconfig这样都可以执行 kubectl 命令
- --volume /root/.ssh/id_rsa:/root/.ssh/id_rsa:ro 等三个 volume 挂载保证:如果宿主机配置了免密码登陆所有集群节点,那么容器内也可以免密码登陆所有节点
## 参考
- ansible 容器镜像制作: https://github.com/William-Yeh/docker-ansible