渠成命令行qcadmin(简称: q)是一个开源的、简单易用的、运维效能工具。它可以帮你部署k3s集群&渠成平台(禅道全家桶)。

目前核心功能

• 部署k3s集群cluster
• 部署渠成平台quickon

本次主要介绍cluster部分, 目前支持

• clean clean cluster
• delete delete node(s)
• init init cluster
• join join cluster
• precheck Precheck system
• status status cluster
  目前仅支持amd64, 虽然也提供arm64，但是部分服务还没有提供相关架构镜像

安装

安装方式也比较多哈，咱就是灵活哈，不过我个人推荐还是从github或者软件源安装，因为这样可以方便的更新到最新版本

官网安装

版本会滞后一些，但是可以保证稳定性

curl https://pkg.qucheng.com/qucheng/cli/stable/v2/get.sh | sh -

github安装

版本随时更新, 但是可以保证成功

curl -L --fail --remote-name-all https://ghproxy.com/https://github.com/easysoft/quickon_cli/releases/latest/download/{qcadmin_linux_amd64,checksums.txt}
sha256sum -c <(grep qcadmin_linux_amd64 checksums.txt)
chmod +x qcadmin_linux_amd64
install qcadmin_linux_amd64 /usr/bin/qcadmin

软件源安装

同github哈, 目前只提供deb&rpm包哈

echo "deb [trusted=yes] https://repo.qucheng.com/quickon/apt/ /" | tee /etc/apt/sources.list.d/quickon.list
apt update
apt search qcadmin
apt install qcadmin

源码安装

要求go1.20哈

mkdir -p $GOPATH/src/github.com/easysoft
cd $GOPATH/src/github.com/easysoft
git clone https://github.com/easysoft/quickon_cli.git
# git checkout 最近的tag
# 查看最新操作指南
make help

推荐配置

• Debian11(amd64) 真的很稳定, 绝大多数开发测试基于Debian
• 内核版本至少6.0吧, (我自己基本6.1或者6.2)

硬件推荐

如果仅仅是跑k3s, 那么1核1G内存也能跑, 但是如果你想跑渠成平台, 那么推荐最低配置如下:

• 2 核虚拟 CPU
• 4 GB 内存
• 40 GB 储存空间

部署k3s集群

因为做的足够简单，所以没啥好写的

懒人版本

q cluster init

--cni string            k8s networking plugin, support flannel, wireguard, custom (default "flannel")
      --data-dir string       cluster & quickon data dir (default "/opt/quickon")
  -h, --help                  help for init
      --master stringArray    master ip list, e.g: 192.168.0.1:22
  -p, --password string       ssh password
      --pkfile string         ssh private key, if not set, will use password
      --pkpass string         ssh private key password
      --pod-cidr string       k8s cluster pod cidr (default "10.42.0.0/16")
      --service-cidr string   k8s cluster service cidr (default "10.43.0.0/16")
  -u, --username string       ssh user (default "root")
      --worker stringArray    worker ip list, e.g: 192.168.0.1:22

高级使用

q cluster init --master 10.10.16.22 --worker 10.10.16.35 --worker 10.10.16.39 --pkfile /root/.ssh/id_rsa

q cluster join --master 10.10.16.23 --worker 10.10.16.34

q cluster delete --ips 10.10.16.23 --ips 10.10.16.34

q cluster precheck

q cluster status nodes
q status nodes

q cluster clean