这是本节的多页打印视图。 点击此处打印.

返回本页常规视图.

快速开始

    以下命令在 Linux amd64 部署机的 Bash 中执行,使用 v1.6.0 客户端和完整部署包。准备使用 systemd、SSH 可达且部署用户有 sudo 权限的 Linux 节点;配置时间同步,核对 Kubernetes 的内核、cgroup 和磁盘要求。

    安装客户端

    1.6 发布标签中的旧安装脚本使用 oss.kubeclipper.io,该域名当前证书已过期。下面直接从 GitHub Release 下载客户端,不关闭证书校验。

    curl -fL -o kc-linux-amd64-v1.6.0.tar.gz \
      https://github.com/kubeclipper/kubeclipper/releases/download/v1.6.0/kc-linux-amd64.tar.gz
    mkdir -p kc-client-v1.6.0
    tar -xzf kc-linux-amd64-v1.6.0.tar.gz -C kc-client-v1.6.0
    sudo install -m 0755 kc-client-v1.6.0/kcctl /usr/local/bin/kcctl
    kcctl version
    

    其他客户端架构从 1.6 Release选择对应包。arm64 归档中的二进制位于架构子目录,先用 tar -tzf 查看路径。

    下载完整部署包并安装平台

    客户端归档不能替代完整部署包。下面使用项目的 OSS 原生域名,amd64 和 arm64 均有对应完整部署包。

    curl -fL -o kc-amd64-v1.6.0.tar.gz \
      https://kubeclipper.oss-ap-southeast-1.aliyuncs.com/release/v1.6.0/kc-amd64.tar.gz
    read -r -s -p '设置 admin 密码: ' KC_ADMIN_PASSWORD
    printf '\n'
    kcctl deploy --user root --pk-file "$HOME/.ssh/id_rsa" \
      --pkg "$PWD/kc-amd64-v1.6.0.tar.gz" \
      --initial-password "$KC_ADMIN_PASSWORD"
    unset KC_ADMIN_PASSWORD
    

    使用可登录目标节点的 SSH 私钥,密码设为 8–16 位并包含大写、小写字母和数字。多节点部署参数通过 kcctl deploy -h 核对。保持 API 与 NATS 的 TLS 配置开启。

    登录与创建集群

    将 Server 地址和节点 IP 替换为自己的值,命令会提示输入 admin 密码。控制台入口为 http://SERVER_IP,CLI 使用 HTTPS API。

    SERVER_IP=192.168.10.10
    kcctl login --host "https://${SERVER_IP}:8080" --username admin
    kcctl get node
    kcctl resource list
    

    先确认平台资源列表包含所需版本及节点架构,再创建单节点实验集群:

    NODE=192.168.10.10
    kcctl create cluster --name demo --master "$NODE" --untaint-master \
      --k8s-version v1.36.1 --cri containerd --cri-version 2.2.4 \
      --cni calico --cni-version v3.31.5
    kcctl operation list -c demo
    kcctl get cluster demo -o yaml
    

    安装完成后,从集群详情获取 kubeconfig,检查 kubectl get nodes -o wide、kubectl get pods -A 和 kubectl get --raw='/readyz?verbose'。操作排查见操作与日志。