kubeasz/docs/setup/easzctl_cmd.md

2.3 KiB
Raw Blame History

easzctl 命令行介绍

为什么使用 easzctl

作为 kubeasz 项目的推荐命令行脚本easzctl 十分轻量、简单;目前它主要包含两类功能:(后续会不断完善补充)

  • 命令集 1集群层面操作
    • 切换/创建集群 context
    • 删除当前集群
    • 显示所有集群
    • 创建集群
    • 创建单机集群(类似 minikube
  • 命令集 2集群内部操作
    • 增加工作节点
    • 增加主节点
    • 增加 etcd 节点
    • 删除 etcd 节点
    • 删除任意节点

集群 context 由 ansible hosts 配置、roles 配置等组成,用以区分不同的 k8s 集群,从而实现多集群的创建和管理;当然 easzctl 命令行不是必须的,你仍旧可以使用之前熟悉的方式安装/管理集群。

典型 easzctl 创建管理的集群拓扑如下:

+----------------+               +-----------------+
|easzctl 1.1.1.1 |               |cluster-aio:     |
+--+---+---+-----+               |deploy 4.4.4.4   |
   |   |   |                     |master 4.4.4.4   |
   |   |   +-------------------->+etcd   4.4.4.4   |
   |   |                         |node   4.4.4.4   |
   |   +--------------+          +-----------------+
   |                  |
   v                  v
+--+------------+ +---+----------------------------+
| cluster-1:    | | cluster-2:                     |
| deploy 2.2.2.1| | deploy 3.3.3.1                 |
| master 2.2.2.1| | master 3.3.3.1/3.3.3.2         |
| etcd   2.2.2.2| | etcd   3.3.3.1/3.3.3.2/3.3.3.3 |
| node   2.2.2.3| | node   3.3.3.4/3.3.3.5/3.3.3.6 |
+---------------+ +--------------------------------+

使用 easzctl 举例

  • 随时运行 easzctl help 获取命令行提示信息

  • 1.创建 context准备集群名称例如test-cluster1运行 easzctl checkout test-cluster1

    • 如果 context: test-cluster1 不存在,那么会根据 default 配置创建它;如果存在则切换当前 context 为 test-cluster1
  • 2.准备 context 以后,根据你的需要配置 ansible hosts 文件和其他配置,然后运行 easzctl setup

  • 3.安装成功后,运行 easzctl list 显示当前所有集群信息

  • 4.重复步骤 1/2 可以创建多个集群

  • 5.切换到某个集群 easzctl checkout xxxx,然后执行增加/删除节点操作

That's it! 赶紧动手测试吧,欢迎通过 Issues 和 PRs 反馈您的意见和建议!